Repository navigation
DOC-7121 Consolidate agent-memory Python/TypeScript SDK quickstarts into one TCE page - #4149
Open
andy-stark-redis wants to merge 7 commits into
Open
andy-stark-redis wants to merge 7 commits into
andy-stark-redis wants to merge 7 commits into
Conversation
…nto one TCE page
The Python and TypeScript agent-memory quickstarts were near-duplicate prose
with only the code fences differing. Merged them into one page
(sdk-quickstart.md) using the clients-example tabbed system, with two new
pseudo-client keys ("Agent Memory (Python)"/"Agent Memory (TypeScript)")
instead of reusing the real Python/Node.js client keys, so the tabs don't
misattribute to redis-py/node-redis.
Two build-script gaps surfaced adding the TypeScript source file:
build/local_examples.py's EXTENSION_TO_LANGUAGE had no .ts entry at all, and
build/components/example.py's PREFIXES dict had no 'typescript' comment style
either — no .ts file has ever existed under local_examples/ before this.
Both needed fixing together or the .ts source silently fails (first as an
"unknown extension" skip, then as a None-content crash further down the
pipeline once the language is recognized but has no comment prefix).
Modeled the footer-hiding on langcache_sdk's page, but its show_footer="false"
parameter turned out to be dead code — clients-example.html only ever checks
footer="hide" (confirmed back to the commit that introduced it). langcache's
live page is therefore not hiding what it thinks it's hiding. Used the
parameter that actually works here; did not fix langcache's page (out of
scope for this ticket).
The tab's visible title is literally the config.toml client key string (only
"Node.js"/"ioredis" get a hardcoded display-name override), so the new keys
had to be chosen to read well as tab labels directly, not as short internal
IDs.
Each clients-example step had to become a fully self-contained snippet
(imports + client construction repeated per step) rather than the "keep
editing one growing file" narrative the original two pages used, because the
shortcode slices only the exact STEP_START/STEP_END range with nothing
prepended.
Learned: .ts support needs EXTENSION_TO_LANGUAGE and PREFIXES kept in sync; langcache_sdk's show_footer param is dead code
Constraint: a clients-example tab's display name is its config.toml key verbatim (no Node.js/ioredis-style override exists for new keys)
Rejected: show_footer="false" | dead parameter in clients-example.html, only footer="hide" is read
Directive: don't add another .ts-based local example without confirming EXTENSION_TO_LANGUAGE (build/local_examples.py) and PREFIXES (build/components/example.py) both still list it
Gaps: agent_memory_sdk.py/.ts are hand-written, not harness-verified — no confirmed access to a running Agent Memory backend
Ticket: DOC-7121
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
Contributor
Contributor
Collaborator
|
Hi Andy thanks for working on this, Andrew has a draft PR that also include curl here: #4001 if you can take a look at it as well, we should combine your additions with his. |
This was referenced Oct 9, 2026
abrookins
changed the base branch from
main
to
docs/MOD-18775-session-listing
October 21, 2026 19:23
This was referenced Oct 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Combine the Python and TypeScript SDK quickstarts into one page using the standard tabbed example system. Dedicated Agent Memory client identities keep these tabs distinct from redis-py and node-redis.
Published instructions install
redis-agent-memoryand@redis-iris/agent-memoryfrom the default stable channels and use store-scoped health. All links affected by the old SDK page removals point to the combined page; old URLs redirect. The shared tab template now respectsfooter="hide"instead of converting false back to its default true.Based on #4145. Merge sequence: #4025 → #4145 → #4149 → #4001. This PR establishes the SDK example system; #4001 uses it for the final single quickstart with Python, TypeScript, and a static curl tab, while moving deeper examples into the feature guides.
Validation: all eight Python and eight TypeScript examples ran with the published beta packages against schema-checked HTTP fixtures; strict TypeScript checks passed. Hugo 0.143.1 rendered the section with no warnings. Browser checks verified all eight language selectors, correct client identities, hidden footers, and no Redis runner. Redirect files were checked. No deployed-service extraction test was performed. CI completed on
1530cb228: 102 successful checks, 1 skipped, no failures.