[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_493":-7,"_494":-5,"_495":-5,"_496":-5,"_497":18,"_498":16,"_499":500,"_501":502,"_503":18,"_504":505,"_506":507,"_19":20,"_21":16},"routes/_auth",{"_471":-5,"_472":473,"_474":475,"_476":477,"_478":479,"_54":18,"_480":18,"_481":18,"_482":18,"_483":18,"_484":18,"_485":-7,"_486":487,"_488":489,"_490":491,"_492":18,"_19":20,"_21":16},"routes/_auth.cipes.$cipeId",{"_22":23,"_24":18,"_25":-5,"_26":27,"_28":29,"_30":-5,"_31":32,"_33":18,"_34":16,"_35":18,"_36":-5,"_37":38,"_39":18,"_40":41,"_42":-7,"_43":16,"_44":18,"_45":16,"_46":47,"_48":49,"_50":51,"_52":53,"_54":18,"_55":16,"_56":18,"_57":18,"_58":18,"_59":60,"_61":62,"_63":18,"_64":-5,"_19":20,"_21":16,"_65":66},"routes/_auth.cipes.$cipeId.timeline",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":16},"timelineUrl","/cipes/6a799afde5ad9227f9141f0a/timeline/refresh?runGroup=30030466438-2","isWorkspaceUsingNxAgents",true,"canUnsetIoSnapshot",false,"result","success","ok","workspace",{"_73":301,"_425":99,"_75":248,"_426":-5,"_427":428,"_110":429,"_430":431,"_432":431,"_433":18,"_434":435,"_436":-5,"_77":437,"_79":438,"_439":440,"_441":16,"_442":443,"_444":18,"_445":16,"_446":447,"_448":449,"_450":451,"_452":453,"_454":455,"_456":457,"_458":-7},"isAdmin","membership","ciPipelineExecution",{"_73":299,"_300":301,"_302":210,"_303":304,"_77":305,"_79":306,"_213":307,"_308":309,"_310":311,"_215":216,"_312":18,"_313":-5,"_314":315,"_316":317,"_318":319,"_320":321,"_322":-5,"_323":16,"_324":325,"_326":-5,"_327":-5,"_328":329,"_330":-5,"_331":-5},"runGroup",{"_208":209,"_28":210,"_77":211,"_79":212,"_213":214,"_215":216,"_217":-5,"_218":16,"_219":-5,"_220":-5,"_221":-5,"_222":223,"_224":16,"_225":226,"_227":18,"_228":229,"_230":231,"_232":233,"_234":-5,"_235":236,"_237":238,"_239":240,"_241":-5,"_242":243},"cancellationTriggeringUserName","organization",{"_75":76,"_77":78,"_79":80,"_71":16,"_81":16,"_82":83,"_84":85,"_86":18,"_87":88,"_89":18,"_90":16,"_91":92,"_93":94,"_95":16,"_96":97,"_98":99,"_73":99,"_100":101,"_102":-7,"_103":18,"_104":18,"_105":18,"_106":18,"_107":18,"_108":109,"_110":111,"_112":-5,"_113":-5,"_114":-7},"shouldCompleteAccessControlSetup","isWorkspaceClaimed","isCurrentUserOrganizationMember","aiFix","mostRecentCipeForBranch",{"_73":74},"supersededOnBranch","attempts",[],"guideMilestoneStatus","multipleFailuresWithoutFixes","isResourceUsageAvailable","isCipeExecutionTimelineEnabled","cappedCiPipelineExecutionCount",10,"currentUsagePercentage",100,"contributorsCount",109,"nxCloudAppUrl","https://cloud.nx.app","isPrivateCloud","isSandboxingToggleEnabled","isUltracacheUiEnabled","isSandboxingPreviewEligible","isResourceUsagePreviewEligible","organizationActor",{"_70":71,"_72":18},"settingsDestinations",[],"managedCiNavigation","pipelinePreview","managedContext",{"_67":68,"_69":-5},"loadedAt",1792602740245,"managed","access","public","isInternalAdmin","_id","6a87cbcee3dca085938dae75","name","TanStack","createdAt",["D",1678953117327],"updatedAt",["D",1791581852888],"enabled","plan","OSS","planActivationDate",["D",1681913269035],"isEligibleForProTrial","planLimits",{"_138":139,"_140":141,"_142":143,"_144":145,"_146":145,"_147":148,"_149":150,"_151":150,"_152":153},"isAiBringYourOwnKey","isAiEnabled","privateAccess","MEMBERS_ONLY","planTransitions",[],"allowPrivilegedAgentCapabilities","resourceUsageViewedAt",["D",1785439427946],"id","6412ca9d1c251d000efa21ba","memberships",[120,121,122,123,124,125,126],"privateCloudInstallationId","hasBillingInformation","hasLicense","isUnclaimed","isOnTrial","isHighPriority","vcsProfileLink","https://github.com/organizations/TanStack/settings/profile","vcsConfiguration",{"_115":116,"_117":118,"_119":76},"lastMembersSyncedAt","enterpriseTrial","disabledReasonMessage","provider","GITHUB","vcsOrganizationId","72518640","vcsOrganizationName",{"_127":137,"_129":130},{"_127":136,"_129":130},{"_127":135,"_129":130},{"_127":134,"_129":130},{"_127":133,"_129":132},{"_127":131,"_129":132},{"_127":128,"_129":130},"userId","62aa1f8a86f3d10005571913","role","admin","67996bb7ff879c45f678c044","member","64f0c3871ce17678e1f2ba5a","65bd71e6aefbc8e5daf93e52","64456449119e68000d2e957d","641b03afeead08000e27f2c1","612011eac3430200057bde33","baseIncludedCredits",300000,"additionalCredits",{},"discountedCreditsMaximum",0,"contributorLimit",70,"concurrentConnectionLimit","runsLimit",1000000,"adminUserLimit",9999,"workspaceLimit","modifiers",[154,155,156,157,158,159,160,161,162,163],{"_164":165,"_166":205,"_168":169,"_170":206,"_172":207,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":202,"_168":169,"_170":203,"_172":204,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":199,"_168":169,"_170":200,"_172":201,"_174":175,"_176":192,"_178":16},{"_164":165,"_166":196,"_168":169,"_170":197,"_172":198,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":193,"_168":169,"_170":194,"_172":195,"_174":175,"_176":177,"_178":16},{"_164":165,"_166":189,"_168":169,"_170":190,"_172":191,"_174":175,"_176":192,"_178":16},{"_164":165,"_166":186,"_168":169,"_170":187,"_172":188,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":183,"_168":169,"_170":184,"_172":185,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":179,"_168":169,"_170":180,"_172":181,"_174":175,"_176":182,"_178":16},{"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":16},"displayName","Achievement credit reward","description","Invite 2 team members and receive 30,000 credits after they log in.","appliesTo","ALL_CREDITS","appliedAt",["D",1788209088720],"expiresAt",["D",1790812800000],"validationPeriod","BILLING_CYCLE","value",30000,"active","Right-size agents and track CPU and memory stats. Included with Enterprise or available as an add-on.",["D",1785439427976],["D",1788220800000],10000,"Earn 10,000 credits by securing your workspace with caching strategies and CI tokens.",["D",1785439421422],["D",1788220800000],"Authenticate the Nx CLI with `nx login` so your runs can read and write the shared cache under your own identity.",["D",1785439383610],["D",1788220800000],"Let Nx Cloud propose a fix when CI fails and apply it to get the pipeline green.",["D",1785439383535],["D",1788220800000],20000,"Run CI with Nx Cloud connected and restore at least one task from the remote cache after claiming your workspace.",["D",1785439383535],["D",1788220800000],"Create a CI access token and remove read-write default access so cache reads and writes are protected.",["D",1785439383535],["D",1788220800000],"Run CI with distributed task execution so work is spread across agents to cut wall-clock time.",["D",1785439383535],["D",1788220800000],"Let Nx Cloud surface tasks that pass and fail without input changes so you can stabilize them.",["D",1785439383535],["D",1788220800000],"Connect your workspace to a Git provider so Nx Cloud can attach runs to commits and pull requests.",["D",1785439383483],["D",1788220800000],"ciExecutionEnv","","30030466438-2",["D",1786354429075],["D",1786355187163],"completedAt",["D",1786355187163],"status","SUCCEEDED","agentCount","stopAgentsOnFailure","criticalErrorMessage","commandCount","stopAgentsAfter","agents",[],"closed","completedBy","HEARTBEAT","requireExplicitCompletion","linkedWorkflows",[],"activeAgents",[],"assignmentRules",[],"schedulingConstraintsInput","agentsMetadata",{},"agentInstances",{},"stopAgentsAfterConditions",{},"continuousAssignment","config",{"_244":245,"_208":-5},"sources",{"_246":247,"_248":249,"_250":251,"_252":253},"lifecycle",{"_288":289,"_290":291,"_292":293},"ai",{"_280":281,"_282":283},"dte",{"_260":261,"_262":263,"_232":264,"_265":266},"nxAgents",{"_254":255},"withEnvVars",[256],{"_257":258,"_176":259,"_208":-5},"kind","LEGACY",[],"enabledByDefault",[279],"distributeOn",[],[274],"schedulingConstraints",[267],{"_257":268,"_176":269,"_208":-5},"DEFAULT",{"_270":271,"_272":273},"_t","io.nrwl.models.SchedulingConstraintsInput.Inline","constraints",[],{"_257":268,"_176":275,"_208":-5},{"_270":276,"_277":278},"io.nrwl.models.AssignmentRulesInput.Inline","rules",[],{"_257":268,"_176":16,"_208":-5},"fixTasksPatterns",[286],"autoApplyPatterns",[284],{"_257":268,"_176":285,"_208":-5},[],{"_257":268,"_176":287,"_208":-5},[],"failAfter",[297],"heartbeat",[296],"stopAfter",[294],{"_257":258,"_176":295,"_208":-5},[],{"_257":258,"_176":16,"_208":-5},{"_257":258,"_176":298,"_208":-5},1,"6a799afde5ad9227f9141f0a","workspaceId","6928ccd60a2e27ab22f38ad0","ciExecutionId","branch","941",["D",1786354429075],["D",1786355187225],["D",1786355187163],"runGroups",[422],"vcsContext",{"_303":399,"_400":399,"_401":402,"_403":404,"_405":-5,"_406":407,"_408":409,"_410":411,"_412":413,"_414":415,"_416":417,"_418":419,"_420":-5,"_421":-5},"cancellationRequested","affectedProjectRatio","touchedProjects",[],"affectedProjects",[348,349,350,351,352,353,354,355,356,357,358,359,360,361,362,363,364,365,366,367,368,369,370,371,372,373,374,375,376,377,378,379,380,381,382,383,384,385,386,387,388,389,390,391,392,393,394,395,396,397,398,5],"criticalWorkflowErrors",[],"projectGraphSha","d45e4360ae41b7c000d4049f536facb4a06cc8167e6fe9325b8f41e435d73d90","fileMapSha","cacheEnabled","hashScope","338891836","fixTasks","autoApplyFixes","selfHealing",{"_332":333,"_334":335,"_336":18},"selfHealingSkipInfo","cancellation","cliOverrides",{"_326":-5,"_327":-5},"workspaceConfigSnapshot",{"_81":18,"_337":16,"_338":18,"_339":16,"_340":16,"_341":-5,"_342":-5,"_343":-5,"_344":-5,"_345":-5,"_346":-5,"_347":-5},"isLongLivedBranch","commentNotificationEnabled","allowAnonymousExternalCommand","enableFlakyRerunsAutomatically","allowDraftPullRequests","protectedBranchPatterns","selfHealingCISetupCompletedAt","fixPatterns","neverFixPatterns","autoApplyIncludePatterns","autoApplyExcludePatterns","formatCommand","@tanstack/ai-code-mode-models-eval","@tanstack/ai-sandbox-local-process","@tanstack/ai-isolate-cloudflare","@tanstack/ai-sandbox-cloudflare","@tanstack/ai-code-mode-skills","@tanstack/ai-isolate-quickjs","@tanstack/ai-sandbox-daytona","@tanstack/ai-sandbox-sprites","@tanstack/preact-ai-devtools","@tanstack/ai-durable-stream","@tanstack/ai-sandbox-docker","@tanstack/ai-sandbox-vercel","@tanstack/react-ai-devtools","@tanstack/solid-ai-devtools","@tanstack/ai-event-client","@tanstack/ai-isolate-node","@tanstack/ai-claude-code","@tanstack/ai-elevenlabs","@tanstack/ai-grok-build","@tanstack/ai-openrouter","@tanstack/ai-anthropic","@tanstack/ai-code-mode","@tanstack/ai-devtools-core","@tanstack/ai-opencode","@tanstack/ai-react-ui","@tanstack/ai-solid-ui","@tanstack/openai-base","@tanstack/ai-angular","@tanstack/ai-bedrock","@tanstack/ai-mistral","@tanstack/ai-sandbox","@tanstack/ai-client","@tanstack/ai-gemini","@tanstack/ai-memory","@tanstack/ai-ollama","@tanstack/ai-openai","@tanstack/ai-preact","@tanstack/ai-svelte","@tanstack/ai-vue-ui","@tanstack/ai-codex","@tanstack/ai-react","@tanstack/ai-solid","@tanstack/ai-utils","@tanstack/ai-grok","@tanstack/ai-groq","@tanstack/ai-acp","@tanstack/ai-fal","@tanstack/ai-mcp","@tanstack/ai-vue","@tanstack/ai","@tanstack/ai-codemods","feat/openrouter-run-finished-metadata","ref","title","feat(ai, ai-memory): server-side memory middleware with pluggable adapters (#541)\n\n* feat(ai): add memory types\n\n* feat(ai): add memory helper functions\n\n* feat(ai): expose @tanstack/ai/memory subpath\n\n* test(ai): add failing memory middleware tests\n\n* feat(ai): add memoryMiddleware\n\n* fix(ai): tighten memory middleware test types for noUncheckedIndexedAccess\n\n* feat(ai-event-client): add memory devtools events\n\n* feat(ai): emit memory devtools events from middleware\n\n* feat(ai-memory): scaffold new package\n\n* test(ai-memory): add shared adapter contract suite\n\n* feat(ai-memory): add inMemoryMemoryAdapter\n\n* fix(ai-memory): tighten in-memory adapter lint compliance\n\n* feat(ai-memory): add redisMemoryAdapter\n\n* docs(ai): add tanstack-ai-memory skill\n\n* docs(ai-memory): add in-memory adapter skill\n\n* docs(ai-memory): add redis adapter skill\n\n* docs: add memory middleware concept and quickstart pages\n\n* chore: changeset for memory middleware\n\n* chore: final formatting\n\n* fix(ai, ai-memory): clean up lint and knip findings\n\n* fix(ai, ai-memory): address whole-feature audit findings\n\n- WeakMap-keyed per-request state to prevent cross-request leak\n when memoryMiddleware is reused (matches otel middleware pattern)\n- scopeMatches treats empty scope as 'no match' to prevent\n clear({}) / search({scope:{}}) cross-tenant wipes\n- Wrap deferred persist + tool-result writes so strict-mode failures\n surface via Promise.allSettled instead of being silently swallowed\n- applyOps applies ops in array order; updates after adds in the\n same batch now find the inserted record\n- shouldRemember gates the entire turn (including extractMemories)\n matching its documented JSDoc\n- Add empty-scope safety tests to the shared adapter contract suite\n\n* ci: apply automated fixes\n\n* fix(ai): address CR Round 1 core middleware findings\n\n- getMessageText reads ContentPart.content (not .text); structured user\n messages now feed retrieval and persistence correctly\n- extractMemories strict-mode failure no longer double-emits\n memory:error or drops base user/assistant records\n- defaultScoreHit threads its 'now' parameter through to recencyScore\n so callers can score deterministically\n- Default importance contribution drops from 0.5 to 0 so a recent record\n with zero lexical/semantic match no longer clears the default\n minScore=0.15 floor\n- MemoryAdapter.clear/search/list JSDoc fixed: empty scope matches\n NOTHING (matches scopeMatches and the contract suite)\n\n* fix(ai-memory): redis adapter scope semantics\n\n- search/list/clear with a partial scope now traverse all matching\n index buckets via SCAN instead of just the exact-match bucket\n- delete srem now keys off record scope (not caller scope) so\n ids in narrower index buckets are properly cleaned up\n- add upsert removes the id from the old scope's index when the\n scope of an existing record changes\n- skill troubleshooting drops the false SerializationError claim;\n malformed rows now log once per process via console.warn\n- Contract suite gains 5 partial-scope tests covering search, list,\n clear, delete, and upsert; in-memory and redis must both pass them\n\n* feat(ai-memory): nodeRedisAsRedisLike helper for node-redis v4+\n\nThe RedisLike interface is lowercase to match ioredis directly. node-redis\nv4+ uses camelCase by default, which previously required users to enable\nlegacyMode to wire it up. The new nodeRedisAsRedisLike(client) helper\ntranslates camelCase to the RedisLike shape so users can wire node-redis\nv4+ default-mode clients with a one-line wrapper.\n\nSkill and quickstart docs updated with separate ioredis vs node-redis\nwiring examples. ioredis added as a parallel optional peer dep alongside\nredis. New unit test for the helper.\n\n* test(ai, ai-memory): tighten flaky and vacuous CR assertions\n\n- recencyScore half-life test passes 'now' explicitly so it does\n not race the internal Date.now() call (Group A added the param)\n- Pagination contract test now asserts every record is visible\n across pages (catches adapters that drop or duplicate)\n- Upsert contract test now verifies updatedAt strictly advances\n on the second add, not merely that updatedAt >= createdAt\n- Tightened 'every(...)' assertions in the contract suite with\n preceding non-empty length checks so they cannot silently pass\n on an empty result set\n\n* chore(ai-memory): set initial version to 0.0.0 for first publish\n\nChangesets bumps from the package.json version, so a minor entry on\n0.1.0 would publish 0.2.0 (skipping 0.1.0). Setting the baseline to\n0.0.0 makes the same minor changeset land at 0.1.0 on first release.\n\n* fix(ai, ai-memory): address CR Round 2 bucket-a findings\n\n- Redis SCAN MATCH patterns now escape glob metacharacters in scope\n values (*, ?, [, ], \\) so a scope like tenantId='t*' cannot cross-\n match other tenants' buckets\n- onToolResult deferred persistence now flows through the same\n observability pipeline as finish-turn persist: emits\n memory:persist:started/completed, fires events.onPersistStart/End,\n and calls afterPersist with the newly-added tool-result records\n- Skill and docs examples replaced with self-contained snippets so\n copy-pasters don't hit ReferenceError on undeclared 'body' or an\n infinite-recursion 'embed' shadow\n- nodeRedisAsRedisLike scan now passes cursor through unchanged\n (no Number() coercion) so node-redis v5 string cursors past\n MAX_SAFE_INTEGER round-trip correctly; COUNT now validated >0\n\n* fix(ai): close error-path observability gaps in memory middleware\n\nConvergence-audit response to Round 2 (onToolResult) + Round 3\n(embedder failure) findings sharing the same root-cause class:\nerror paths that did not emit memory:error.\n\n- persistTurn assistant-side embedder failure now emits memory:error\n (phase: persist) and continues with embedding: undefined in\n non-strict mode (matches retrieval-side embedder handling)\n- onAfterToolCall tool-args JSON parse failure now emits memory:error\n (phase: extract) before falling back to {}\n- All catch blocks in middleware.ts now uniformly do safeEmit +\n events.onError + strict-rethrow before exiting\n- types.ts onError JSDoc updated to document which sub-cases each\n phase covers\n\n* fix(ai, ai-memory): close remaining scope-value-validation gaps\n\nRound 4 convergence-audit fixes for scope as a tenant-isolation boundary:\n\n- redis.ts scopeKey now escapes : and \\ in scope values so a tenant\n whose value contains a colon cannot collide with a multi-key scope\n that produces the same delimiter pattern (analogous to the Group F\n glob-metacharacter escape, applied to the EXACT-MATCH path)\n- scopeMatches treats empty-string scope values as undefined; a query\n with all-empty-string keys matches nothing (same safety guarantee as\n the {} empty-scope guard)\n- applyOps now overrides the scope on records returned by\n extractMemories/onToolResult to the resolved scope before\n persisting; a buggy or hostile callback cannot write into another\n tenant's bucket\n\nContract suite gains scope-value safety tests for both adapters; the\nmiddleware test suite gains a regression for the extract-scope override.\n\n* fix(ai-memory): escape _ in scope values to prevent placeholder collision\n\nRound 5 convergence fix completing the scope-value-validation class\nclosed in Group H. The Redis adapter uses literal '_' as the\nplaceholder for an UNSET scope key, but Group H's escapeScopeValue\nonly escaped ':' and '\\'. A user-supplied scope value of literal\n'_' (e.g., userId: '_') would have produced the same index key as\n'userId unset', creating a cross-leak surface on clear().\n\nNow '_' is also escaped, so {tenantId: 't1', userId: '_'} indexes\ndistinctly from {tenantId: 't1'}.\n\nContract suite gains 2 tests verifying isolation under literal\nunderscore scope values (run against both adapters).\n\n* chore: refresh pnpm-lock.yaml for ai-memory ioredis peer dep\n\nCI was failing with ERR_PNPM_OUTDATED_LOCKFILE because Group C added\nioredis as an optional peer dependency without regenerating the lockfile.\n\n* ci: apply automated fixes\n\n* docs: consolidate memory pages into a top-level Memory section\n\n- Move docs/middlewares/memory.md -> docs/memory/overview.md (rename frontmatter title to 'Overview')\n- Move docs/guides/memory-quickstart.md -> docs/memory/quickstart.md\n- Add docs/memory/custom-adapter.md authoring guide covering the 8-member contract, the three isolation invariants, the shared contract suite, common pitfalls (delimiter escaping, atomicity, partial-scope cascade), and packaging conventions\n- Replace single-child 'Middlewares' and 'Guides' sidebar sections with a unified 'Memory' section\n- Rewire internal cross-links between the three pages\n\n* fix(ai, ai-memory): address CodeRabbit code review feedback\n\n- middleware.ts: preview-cap memory:retrieve:started query payload\n (was emitting full lastUserText, breaking the documented 200-char\n preview contract for devtools events)\n- helpers.ts: JSON-stringify memory text in defaultRenderMemory so\n newline-or-instruction-shaped persisted memory cannot break out of\n the list structure and steer subsequent turns at system priority\n- middleware.ts: shouldRemember now gates tool-result memories from\n onToolResult; buffered ops flush inside persistTurn after the gate\n passes, matching the documented 'short-circuits the entire persist\n path for the current turn' contract. Persist events now fire once\n per turn (covers base + extracted + tool-result records together)\n- redis.ts: malformed JSON rows in loadAllForScope are now swept from\n the index and record key (was warned-and-skipped, leaving the bad\n payload to be reparsed on every subsequent read)\n- redis.ts and in-memory.ts: snapshot now once per search and thread\n through defaultScoreHit so recency ranking is stable across same-\n pass candidates\n\n* docs, chore: address CodeRabbit polish feedback\n\n- custom-adapter.md: fix pgvector SQL example to use partial-scope\n semantics (($N IS NULL OR col = $N)) instead of IS NOT DISTINCT\n FROM, which had the wrong matching semantics for partial scopes\n- custom-adapter.md: soften contract suite coverage claim - the\n shared suite does not exercise middleware-level extractMemories\n resolved-scope override\n- quickstart.md: drop blank line in adapter blockquote (MD028);\n replace placeholder skill link with direct doc + repo SKILL.md link\n- redis SKILL.md: add 'text' language tag to storage model fence (MD040)\n- ai-memory package.json: add /adapters/in-memory and /adapters/redis\n subpath exports per repo convention\n- ai-memory tsconfig.json: drop **/*.config.ts exclude so vite.config.ts\n (which is in include) actually gets type-checked\n- in-memory.test.ts: reorder imports to satisfy import/order\n- memory.test.ts: tighten the re-inject regression test with\n expect(iter1).toBeGreaterThan(0) so the assertion catches the\n case where injection is fully disabled in both iterations\n\n* fix(ai, ai-memory): address memory-middleware review findings\n\nPortable record ids\n- middleware.ts mints ids via crypto.randomUUID(), which is NOT a bare global\n on the declared Node 18 floor (Web Crypto became unflagged only in Node 19+)\n and threw ReferenceError there — silently dropping the whole turn's memory in\n non-strict mode. Add newRecordId() (real UUID when available, portable\n Date.now()+Math.random() fallback via try/catch).\n\nClose silent-failure gaps in the error plumbing\n- Wrap the scope resolver + shouldRetrieve (onConfig), the scope resolver\n (onAfterToolCall, onFinish), and shouldRemember (persistTurn) so a throwing\n user callback emits memory:error/onError and honours strict instead of\n escaping the hook and breaking chat in non-strict mode.\n- Make emitError defensive (like safeEmit) so a throwing onError handler can't\n break chat or mask the original failure.\n\nHonest strict-mode docs\n- Persistence runs via ctx.defer; the engine awaits deferred work with\n Promise.allSettled and discards results, so a strict-mode rethrow on the\n persist path does NOT abort the run. Correct the comments that claimed\n otherwise; memory:error is the observable signal in both modes.\n\nRedis: stop silently deleting malformed rows\n- loadAllForScope routed malformed JSON through the expired-sweep, permanently\n deleting possibly-recoverable rows behind a one-shot console.warn. Leave the\n row in place and skip it; warn per-distinct-id (bounded) so ongoing\n corruption keeps surfacing without spamming. Skill doc updated.\n\nDocs\n- Fix the memory overview's broken ../advanced/observability link (page moved\n on main) -> ../getting-started/devtools.\n\nTests (+4)\n- Cross-turn persist->retrieve round trip (the feature's headline behaviour).\n- Throwing scope resolver / throwing shouldRemember don't break chat + emit\n memory:error.\n- Redis malformed row is skipped on read but NOT deleted.\n\nGates: @tanstack/ai 1186 tests, @tanstack/ai-memory 72 tests, test:types,\ntest:eslint (0 errors), knip, sherif, test:docs all green.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) \n\n* docs(memory): fix kiira doc-snippet type errors\n\nThe memory docs failed `kiira check` (89 errors) — the doc code-snippet\ntype-checker in CI's Test job. Fixes:\n\n- quickstart: inline `messages` instead of an undeclared var; self-contain\n the embedder example (adapter + scope) and guard the possibly-undefined\n embedding vector; `ignore` the ioredis swap (ioredis's `Redis` type is\n structurally broader than the minimal `RedisLike` contract) and the\n server-side scope-derivation pattern (app-defined context).\n- overview: drop the `MemoryScope` import that conflicted with the local\n type illustration; `ignore` the scope-derivation pattern block.\n- custom-adapter: drop the `MemoryAdapter` import that conflicted with the\n local interface illustration; `ignore` the pgvector scaffold, the method-\n body fragments, the contract-test file, and the wire-in snippet — all\n depend on the `pg` peer dep, elided bodies, or relative modules.\n\nNo behavior change; docs-only. `test:kiira` and `test:docs` pass locally.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) \n\n* refactor(memory): recall/save adapter contract, consolidate into @tanstack/ai-memory\n\nReplace the CRUD MemoryAdapter contract with a single recall/save contract —\nthe shape every memory backend naturally exposes — and move the middleware,\ncontract, and helpers out of @tanstack/ai into @tanstack/ai-memory. Core no\nlonger carries any memory code (the unreleased @tanstack/ai/memory subpath is\nremoved).\n\n- Contract: MemoryAdapter = { id, recall(scope, query), save(scope, turn),\n inspect?, listFacts? } over a session-centric MemoryScope. recall returns a\n rendered systemPrompt plus optional fragments and LLM tools/toolGuidance;\n save persists a { user, assistant } turn. Extraction/ranking/rendering live\n in the adapter, not the middleware.\n- Thin memoryMiddleware: recall-on-init injects prompt + tools, deferred\n save-on-finish, memory:* devtools events, onRecall/onSave callbacks, and a\n save-only role. composeMemoryMiddleware stacks adapters.\n- Adapters on flat subpaths: inMemory(), redis() (BYO client, preserves the\n malformed-row + delimiter-escaping hardening), and vendor adapters\n hindsight(), mem0(), honcho() with lazily-loaded optional-peer SDKs.\n- Shared recall/save contract-test suite; redis hardening tests kept; new\n middleware unit test; a memory scenario added to the e2e middleware harness.\n- Docs rewritten (overview, quickstart, adapters, custom-adapter) with every\n option documented and an example of each; skills moved/rewritten; changeset,\n knip, and event payloads updated.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) \n\n* ci: apply automated fixes\n\n* refactor(memory): nest in-memory/redis under providers, add provider tests\n\nMove the built-in inMemory()/redis() adapters into src/providers/ so all\nadapters share one layout, and mirror that structure under tests/providers/.\nPublic subpaths (@tanstack/ai-memory/in-memory, /redis) are unchanged — only\ninternal file locations moved (package.json exports + vite entries updated).\n\nAdd non-networked unit tests for the vendor providers: hindsight (fake\nruntime driving makeHindsightTools), mem0 (stubbed fetch), and honcho\n(mocked SDK + pure representation parser).\n\nDrop composeMemoryMiddleware — the recall/save contract + save-only role\ncover multi-backend use without a dedicated combinator.\n\nCo-Authored-By: Claude Opus 4.8 \n\n* feat(panel): add in-memory Memory demo page\n\nAdds a `/memory` route to testing/panel that wires memoryMiddleware with\nthe in-memory adapter into a chat and shows what's stored, letting you watch\nrecall/save work end-to-end.\n\n- Shared inMemory() singleton (src/lib/memory-store.ts) so the chat route\n (writes via middleware) and the inspect route (reads via inspect/listFacts)\n hit the same process-local store.\n- api.memory-chat.ts: chat with memoryMiddleware, scope keyed on a client\n sessionId; onRecall records the injected recall for display.\n- api.memory-inspect.ts: GET returning { snapshot, facts, lastRecall }.\n- memory.tsx: two-pane UI — chat on the left, live memory inspector on the\n right (last recalled prompt, stored records, listFacts), sessionId persisted\n in localStorage with New session / Refresh controls.\n- Header nav link.\n\nCo-Authored-By: Claude Opus 4.8 \n\n* feat(devtools): surface memory state in the AI DevTools\n\nAdd a Memory tab to the TanStack AI DevTools for chat hooks wired with\n`memoryMiddleware`. Per session scope it shows an operations timeline\n(each turn's recall — query, fragment count, injected prompt size,\ntools, duration) and the current stored records/facts when the adapter\nimplements `inspect`/`listFacts`. The tab is chat-only (hidden for\ngeneration hooks).\n\nServer-side memory never reaches the browser event bus, so the\nmiddleware transports its state over the chat stream as a `memory:state`\nCUSTOM event (recall metrics + a start-of-turn snapshot). The chat\nclient routes that event through its `onCustomEvent` handler — the\ndesignated path for CUSTOM stream events — to a first-class\n`ClientDevtoolsBridge.recordMemoryState`, which re-emits the browser\n`memory:*` events (mirroring how generation results reach the panel).\nThe bridge caches the last state and replays it on\n`devtools:request-state`, so opening the panel mid-conversation isn't\nempty.\n\n- ai-event-client: add the `memory:snapshot` event.\n- ai-memory: inject the `memory:state` CUSTOM chunk from `onChunk`;\n export `MEMORY_STATE_EVENT` / `MemoryStateEventValue`.\n- ai-client: `recordMemoryState` bridge method (+ no-op parity), wired\n from `onCustomEvent`; replay on request-state.\n- ai-devtools-core: Memory tab + per-scope memory store slice.\n- testing/panel: mount `` so the panel exposes the\n DevTools (and the /memory demo hook is named).\n- e2e: devtools-memory route + spec covering the full browser flow.\n\nCo-Authored-By: Claude Opus 4.8 \n\n* docs(memory): polish memory guides and rename node-redis wrapper\n\nDocs pass over docs/memory: lead each page with the reader's problem,\ndrop em dashes, and un-ignore the Redis code samples so they typecheck.\nAdd an Operating page and point its devtools section at the Memory\nInspector. Rename the node-redis wrapper nodeRedisAsRedisLike ->\nfromNodeRedis across source, tests, skill, changeset, and docs, and add\nioredis to the kiira dependency resolver so the un-ignored samples check.\n\nCo-Authored-By: Claude Opus 4.8 \n\n* ci: apply automated fixes\n\n---------\n\nCo-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>\nCo-authored-by: Tom Beckenham <34339192+tombeckenham@users.noreply.github.com>\nCo-authored-by: Claude Opus 4.8 (1M context) \nCo-authored-by: Jack Herrington ","headSha","e4df6249bea032156d2fde4221e3c29dc4a1c7a5","baseSha","commitLink","https://github.com/TanStack/ai/pull/941","author","Alem Tuzlak","authorEmail","t.zlak@hotmail.com","authorUrl","https://github.com/trevorWieland","authorAvatarUrl","https://github.com/trevorWieland.png","repositoryUrl","https://github.com/TanStack/ai","platformName","GITHUB_ACTIONS","isFork","isDraft",{"_208":209,"_28":210,"_77":211,"_79":212,"_213":214,"_215":216,"_217":-5,"_218":16,"_219":-5,"_220":-5,"_221":-5,"_222":223,"_224":16,"_225":226,"_227":18,"_228":423,"_230":231,"_232":233,"_234":-5,"_235":236,"_237":424,"_239":240,"_241":-5,"_242":243},[],{},"orgId","templatePreset","installationSource","vcs-repository",{"_465":466,"_467":468,"_469":470,"_115":116},"idAccessLevel","READ_ONLY","patAccessLevel","showDteTerminalOutput","workspaceProfile","FULL_FEATURED","nxInitDate",["D",1764281558914],["D",1764281558914],"claimedAt",["D",1764281558914],"retryFlakyTasks","flakyTaskConfiguration",{"_461":462,"_463":464},"showVcsStatusChecks","enableWorkspaceDataCaching","defaultBranch","main","aiTaskFixingConfiguration",{"_81":18,"_337":16,"_338":18},"remoteSourceIntegrationType","GITHUB_EVENTLESS","visibility","ALLOW_UNAUTHENTICATED","cacheIsolation","STRICT","resourceUsageConfiguration",{"_459":18,"_460":16},"launchTemplate","nonDteEnabled","dteEnabled","threshold","AGGRESSIVE","samplePeriodDays",28,"repositoryFullName","TanStack/ai","repositoryVisibility","PUBLIC","repositoryId","1072429861","currentUser","currentHostname","cloud.nx.app","incident",["P",475],"notifications",["P",477],"showWorkersRenameNotice",["P",479],"isSystemAdmin","isSingleTenant","isPATExpiryAfterLoginEnabled","isOrganizationAccessEnabled","isExecutiveReportDisabled","loginas","repositoryAccessProvidersToOffer",[],"redirectTo","/cipes/6a799afde5ad9227f9141f0a/timeline?runGroup=30030466438-2","deferredUserOrganizations",["P",491],"sidebarCollapsed","toast","currentUserId","currentUserEmail","signedInUser","isImpersonating","isBotRequest","ENV",{"_567":16,"_54":18,"_568":16,"_569":16,"_570":16,"_571":572,"_573":574,"_575":18,"_576":577,"_578":579,"_504":580},"posthogBootstrap",{"_535":536,"_537":538},"ultracacheUiEnabled","pylon",{"_527":528,"_529":530,"_75":531,"_532":-7,"_533":534},"requestInfo",{"_508":509,"_510":53,"_511":512,"_513":514,"_515":516},"hints",{"_520":523,"_525":526},"origin","path","/cipes/6a799afde5ad9227f9141f0a/timeline","url","https://cloud.nx.app/cipes/6a799afde5ad9227f9141f0a/timeline","userPreferences",{"_517":518},"theme",{"_75":519,"_520":521,"_522":523,"_524":523},"default","variant","system","resolvedVariant","light","clientColorScheme","timeZone","UTC","appId","a1074fe2-8172-4ebd-9889-879f8308a0a2","email","c13e18e4-ceee-49fe-99ad-d950416ea865@nxcloud.invalid","Anonymous Nx Cloud Visitor","avatarUrl","emailHash","0375850e3aba9053d2b3a4f36e1e173d5e6f7d87f404fee89e7ae7ffb92dd200","distinctID","c13e18e4-ceee-49fe-99ad-d950416ea865","featureFlags",{"_539":540,"_541":18,"_542":16,"_543":16,"_544":16,"_545":18,"_546":18,"_547":16,"_548":18,"_549":16,"_550":16,"_551":16,"_552":16,"_553":554,"_555":16,"_556":81,"_557":18,"_558":18,"_559":16,"_560":81,"_561":16,"_562":16,"_563":16,"_564":16,"_565":566},"one_page_connect_workspace_manual","test","feature_activation_guide","teams_minimum_spend","survey-targeting-8e88152ae4-custom","workspace_sandboxing_toggle","workspace_continuous_assignment_toggle","workspace_packing_budgets_toggle","demo-mode","new_layout","pylon_chat","show_setup_self_healing_ci_alert","resource_addon_default","resource_usage_toggle","welcome_view_cnw_experiment","variant-2","automated_add_ons","one_page_connect_workspace_github","cipe_execution_timeline","run_details_polling","new_access_control","one_page_connect_workspace_gitlab","config_yaml","workspace_rewind","workspace_badges","non_dte_resource_usage","cnw_empty_workspace_position","treatment","isProduction","isAnalyticsEnabled","isPosthogEnabled","isPylonEnabled","privateCloud",{"_599":590,"_52":53},"auth0",{"_593":594,"_595":596,"_597":598},"e2eTestMode","rollbar",{"_585":586,"_587":588,"_81":16,"_589":590,"_591":16,"_592":16},"posthog",{"_581":582,"_583":584},{"_527":528},"apiKey","phc_eTmACxF0EKeNRjAZbfpdszbHYumyKhWqsIpMU4Wi53c","apiHost","https://pha-prx.ops.cloud.nx.app","accessToken","d0e4070ed1d54ed29429808f497ffbab3e77f1c74c2a9427fa5c5e418eea62ca96294bc716a7e8210acf93f0d37b6d29","environment","production","codeVersion","2610.20.0023","captureUncaught","captureUnhandledRejections","domain","auth.nx.app","clientId","Ron6k221B4IaH0QK9hmHuCneTovLLPpX","audience","https://api.nrwl.io/","containerVersionTimestamp"]