@elevasis/sdk 1.38.0 → 1.39.0

package/dist/cli.cjs

@@ -45850,7 +45850,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.38.0",
+  version: "1.39.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -11239,6 +11239,17 @@ type MessageEvent = {
     result?: unknown;
     error?: string;
 };
+/**
+ * A message from an earlier turn of this session.
+ *
+ * Deliberately lean (no ids, timestamps, or event metadata): this crosses the
+ * parent -> worker payload boundary and is replayed verbatim into the model's message
+ * array, so it carries only what the model needs to read the conversation.
+ */
+interface ConversationMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
 /**
  * Execution context for all resources
  * Unified callback replaces SessionTurnMessages (removed)
@@ -11246,6 +11257,15 @@ type MessageEvent = {
 interface ExecutionContext extends ExecutionMetadata {
     logger: IExecutionLogger;
     signal?: AbortSignal;
+    /**
+     * This session's earlier turns, oldest first, as actually said.
+     *
+     * A session agent is handed its own conversation: these are replayed into the model's
+     * message array as real user/assistant turns. Absent for one-off (non-session)
+     * executions. The session layer bounds this before it is sent -- see
+     * `selectConversationHistory`.
+     */
+    conversationHistory?: ConversationMessage[];
     onMessageEvent?: (event: MessageEvent) => Promise<void>;
     /** Called per iteration to write heartbeat + check stall status. Non-fatal if it throws. */
     onHeartbeat?: () => Promise<void>;

package/dist/node/index.d.ts

@@ -2760,6 +2760,17 @@ type MessageEvent = {
     result?: unknown;
     error?: string;
 };
+/**
+ * A message from an earlier turn of this session.
+ *
+ * Deliberately lean (no ids, timestamps, or event metadata): this crosses the
+ * parent -> worker payload boundary and is replayed verbatim into the model's message
+ * array, so it carries only what the model needs to read the conversation.
+ */
+interface ConversationMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
 /**
  * Execution context for all resources
  * Unified callback replaces SessionTurnMessages (removed)
@@ -2767,6 +2778,15 @@ type MessageEvent = {
 interface ExecutionContext extends ExecutionMetadata {
     logger: IExecutionLogger;
     signal?: AbortSignal;
+    /**
+     * This session's earlier turns, oldest first, as actually said.
+     *
+     * A session agent is handed its own conversation: these are replayed into the model's
+     * message array as real user/assistant turns. Absent for one-off (non-session)
+     * executions. The session layer bounds this before it is sent -- see
+     * `selectConversationHistory`.
+     */
+    conversationHistory?: ConversationMessage[];
     onMessageEvent?: (event: MessageEvent) => Promise<void>;
     /** Called per iteration to write heartbeat + check stall status. Non-fatal if it throws. */
     onHeartbeat?: () => Promise<void>;

package/dist/test-utils/index.d.ts

@@ -10313,6 +10313,17 @@ type MessageEvent = {
     result?: unknown;
     error?: string;
 };
+/**
+ * A message from an earlier turn of this session.
+ *
+ * Deliberately lean (no ids, timestamps, or event metadata): this crosses the
+ * parent -> worker payload boundary and is replayed verbatim into the model's message
+ * array, so it carries only what the model needs to read the conversation.
+ */
+interface ConversationMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
 /**
  * Execution context for all resources
  * Unified callback replaces SessionTurnMessages (removed)
@@ -10320,6 +10331,15 @@ type MessageEvent = {
 interface ExecutionContext extends ExecutionMetadata {
     logger: IExecutionLogger;
     signal?: AbortSignal;
+    /**
+     * This session's earlier turns, oldest first, as actually said.
+     *
+     * A session agent is handed its own conversation: these are replayed into the model's
+     * message array as real user/assistant turns. Absent for one-off (non-session)
+     * executions. The session layer bounds this before it is sent -- see
+     * `selectConversationHistory`.
+     */
+    conversationHistory?: ConversationMessage[];
     onMessageEvent?: (event: MessageEvent) => Promise<void>;
     /** Called per iteration to write heartbeat + check stall status. Non-fatal if it throws. */
     onHeartbeat?: () => Promise<void>;
@@ -10793,7 +10813,8 @@ type TypedAdapter<TMap extends ToolMethodMap$1> = {
  *                         humanCheckpoints?: [...], relationships?: {...} }
  *
  *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName?,
- *                         sessionId?, sessionTurnNumber?, parentExecutionId?, executionDepth }
+ *                         sessionId?, sessionTurnNumber?, sessionMemory?, conversationHistory?,
+ *                         parentExecutionId?, executionDepth }
  *   Worker -> Parent:  { type: 'result', status, output?, memorySnapshot?, error?, logs, metrics: { durationMs } }
  *
  *   Parent -> Worker:  { type: 'abort' }                               (graceful abort before terminate)

package/dist/test-utils/index.js

@@ -4768,6 +4768,8 @@ function buildReasoningRequest(iterationContext) {
       iterationContext.iteration,
       iterationContext.executionContext.sessionTurnNumber
     ),
+    // A session agent gets its own conversation. Non-session executions have none.
+    conversationHistory: iterationContext.executionContext.conversationHistory ?? [],
     includeMessageAction: isSessionCapable,
     includeNavigateKnowledge: hasKnowledgeMap,
     includeMemoryOps
@@ -5214,12 +5216,16 @@ function validateTokenConfiguration(model, maxOutputTokens) {
     );
   }
 }
+function buildAgentMessages(systemPrompt, memoryContext, conversationHistory = []) {
+  return [
+    { role: "system", content: systemPrompt },
+    ...conversationHistory.map(({ role, content }) => ({ role, content })),
+    { role: "user", content: memoryContext }
+  ];
+}
 async function callLLMForAgentIteration(adapter, request) {
   validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
-  const messages = [
-    { role: "system", content: request.systemPrompt },
-    { role: "user", content: request.memoryContext }
-  ];
+  const messages = buildAgentMessages(request.systemPrompt, request.memoryContext, request.conversationHistory);
   const response = await adapter.generate({
     messages,
     responseSchema: buildIterationResponseSchema(
@@ -5248,10 +5254,7 @@ async function callLLMForAgentIteration(adapter, request) {
 async function callLLMForAgentCompletion(adapter, request) {
   validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
   const response = await adapter.generate({
-    messages: [
-      { role: "system", content: request.systemPrompt },
-      { role: "user", content: request.memoryContext }
-    ],
+    messages: buildAgentMessages(request.systemPrompt, request.memoryContext, request.conversationHistory),
     responseSchema: request.outputSchema,
     // Use output schema directly
     temperature: request.constraints.temperature || 0.3,
@@ -5385,6 +5388,7 @@ async function processReasoning(iterationContext) {
   const { reasoning, memoryOps, nextActions } = await callLLMForAgentIteration(adapter, {
     systemPrompt: request.systemPrompt,
     memoryContext: request.memoryContext,
+    conversationHistory: request.conversationHistory,
     tools: request.tools,
     constraints: request.constraints,
     model: iterationContext.modelConfig.model,
@@ -6257,11 +6261,10 @@ var MemoryManager = class {
    */
   toContext(currentIteration, currentTurn) {
     const status = this.getStatus();
-    const currentContext = this.memory.history.filter(
-      (entry) => (!currentTurn || entry.turnNumber === currentTurn || entry.turnNumber === void 0) && entry.iterationNumber === currentIteration
-    ).reverse();
+    const inTurnScope = (entry) => !currentTurn || entry.turnNumber === currentTurn || entry.turnNumber == null;
+    const currentContext = this.memory.history.filter((entry) => inTurnScope(entry) && entry.iterationNumber === currentIteration).reverse();
     const earlierContext = this.memory.history.filter(
-      (entry) => (!currentTurn || entry.turnNumber === currentTurn || entry.turnNumber === void 0) && entry.iterationNumber !== null && entry.iterationNumber < currentIteration
+      (entry) => inTurnScope(entry) && entry.iterationNumber !== null && entry.iterationNumber < currentIteration
     );
     const formatEntry = (entry) => {
       const label = `[${entry.type.toUpperCase()}]`;
@@ -6338,6 +6341,9 @@ function initializeKnowledgeMap(knowledgeMap) {
     nodes: Object.fromEntries(Object.entries(knowledgeMap.nodes).map(([id, node]) => [id, { ...node }]))
   };
 }
+function hasMemoryContent(memory) {
+  return Object.keys(memory.sessionMemory).length > 0 || memory.history.length > 0;
+}
 var Agent = class {
   // Base properties from definition
   config;
@@ -6347,6 +6353,7 @@ var Agent = class {
   knowledgeMap;
   definition;
   adapterFactory;
+  initialMemory;
   // Derived properties (computed from definition)
   shouldGenerateOutput;
   // Runtime state (initialized during execution)
@@ -6361,10 +6368,12 @@ var Agent = class {
    *
    * @param definition - Agent definition with config, contract, tools, and optional preloadMemory
    * @param adapterFactory - Factory for creating LLM adapters (decouples engine from provider SDKs)
+   * @param options - Per-execution options (e.g. restored session memory)
    */
-  constructor(definition, adapterFactory) {
+  constructor(definition, adapterFactory, options = {}) {
     this.definition = definition;
     this.adapterFactory = adapterFactory;
+    this.initialMemory = options.initialMemory;
     this.config = definition.config;
     this.contract = definition.contract;
     this.modelConfig = definition.modelConfig;
@@ -6458,25 +6467,9 @@ var Agent = class {
    * @returns Initialized MemoryManager instance
    */
   async initializeMemoryManager(validatedInput, context) {
-    let memory;
-    if (this.definition.preloadMemory) {
-      const preloadStartTime = Date.now();
-      memory = await this.definition.preloadMemory(context);
-      const preloadEndTime = Date.now();
-      this.logger.action(
-        "memory-preload",
-        `Preloaded ${Object.keys(memory.sessionMemory).length} session memory entries`,
-        0,
-        preloadStartTime,
-        preloadEndTime,
-        preloadEndTime - preloadStartTime
-      );
+    const memory = await this.resolveInitialMemory(context);
+    if (hasMemoryContent(memory)) {
       await this.reloadKnowledgeMapTools(memory, context);
-    } else {
-      memory = {
-        sessionMemory: {},
-        history: []
-      };
     }
     const inputStartTime = Date.now();
     memory.history.push({
@@ -6497,6 +6490,44 @@ var Agent = class {
     );
     return new MemoryManager(memory, this.config.constraints, this.logger);
   }
+  /**
+   * Resolve the memory this execution starts from.
+   *
+   * Precedence: caller-supplied `initialMemory` (session restore) > the definition's
+   * `preloadMemory` author hook > empty. Returns a detached copy in the restore case so
+   * the agent's mutations cannot corrupt the caller's snapshot.
+   */
+  async resolveInitialMemory(context) {
+    if (this.initialMemory) {
+      const restoreStartTime = Date.now();
+      const memory = structuredClone(this.initialMemory);
+      const restoreEndTime = Date.now();
+      this.logger.action(
+        "memory-restore",
+        `Restored ${Object.keys(memory.sessionMemory).length} session memory entries`,
+        0,
+        restoreStartTime,
+        restoreEndTime,
+        restoreEndTime - restoreStartTime
+      );
+      return memory;
+    }
+    if (this.definition.preloadMemory) {
+      const preloadStartTime = Date.now();
+      const memory = await this.definition.preloadMemory(context);
+      const preloadEndTime = Date.now();
+      this.logger.action(
+        "memory-preload",
+        `Preloaded ${Object.keys(memory.sessionMemory).length} session memory entries`,
+        0,
+        preloadStartTime,
+        preloadEndTime,
+        preloadEndTime - preloadStartTime
+      );
+      return memory;
+    }
+    return { sessionMemory: {}, history: [] };
+  }
   /**
    * Reload tools from knowledge map state (cross-turn persistence)
    *
@@ -6776,6 +6807,7 @@ var Agent = class {
       const structuredOutput = await callLLMForAgentCompletion(adapter, {
         systemPrompt,
         memoryContext: this.memoryManager.toContext(this.iterationNumber, this.executionContext?.sessionTurnNumber),
+        conversationHistory: this.executionContext?.conversationHistory,
         outputSchema,
         constraints: {
           maxOutputTokens: this.modelConfig.maxOutputTokens,
@@ -10254,6 +10286,7 @@ function buildWorkerExecutionContext(params) {
     resourceId: params.resourceId,
     sessionId: params.sessionId,
     sessionTurnNumber: params.sessionTurnNumber,
+    conversationHistory: params.conversationHistory,
     parentExecutionId: params.parentExecutionId,
     executionDepth: params.executionDepth,
     signal: params.signal,
@@ -10360,6 +10393,8 @@ function startWorker(org) {
         organizationName,
         sessionId,
         sessionTurnNumber,
+        sessionMemory,
+        conversationHistory,
         parentExecutionId,
         executionDepth
       } = msg;
@@ -10405,7 +10440,9 @@ function startWorker(org) {
         try {
           console.log(`[SDK-WORKER] Running agent '${resourceId}' (${agentDef.tools.length} tools)`);
           const adapterFactory = createPostMessageAdapterFactory();
-          const agentInstance = new Agent(agentDef, adapterFactory);
+          const agentInstance = new Agent(agentDef, adapterFactory, {
+            initialMemory: sessionMemory
+          });
           const context = buildWorkerExecutionContext({
             executionId,
             organizationId: organizationId ?? "",
@@ -10413,6 +10450,7 @@ function startWorker(org) {
             resourceId,
             sessionId,
             sessionTurnNumber,
+            conversationHistory,
             parentExecutionId,
             executionDepth: executionDepth ?? 0,
             signal: localAbortController.signal

package/dist/types/worker/index.d.ts

@@ -11,7 +11,8 @@
  *                         humanCheckpoints?: [...], relationships?: {...} }
  *
  *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName?,
- *                         sessionId?, sessionTurnNumber?, parentExecutionId?, executionDepth }
+ *                         sessionId?, sessionTurnNumber?, sessionMemory?, conversationHistory?,
+ *                         parentExecutionId?, executionDepth }
  *   Worker -> Parent:  { type: 'result', status, output?, memorySnapshot?, error?, logs, metrics: { durationMs } }
  *
  *   Parent -> Worker:  { type: 'abort' }                               (graceful abort before terminate)

package/dist/worker/index.js

@@ -2890,6 +2890,8 @@ function buildReasoningRequest(iterationContext) {
       iterationContext.iteration,
       iterationContext.executionContext.sessionTurnNumber
     ),
+    // A session agent gets its own conversation. Non-session executions have none.
+    conversationHistory: iterationContext.executionContext.conversationHistory ?? [],
     includeMessageAction: isSessionCapable,
     includeNavigateKnowledge: hasKnowledgeMap,
     includeMemoryOps
@@ -3306,12 +3308,16 @@ function validateTokenConfiguration(model, maxOutputTokens) {
     );
   }
 }
+function buildAgentMessages(systemPrompt, memoryContext, conversationHistory = []) {
+  return [
+    { role: "system", content: systemPrompt },
+    ...conversationHistory.map(({ role, content }) => ({ role, content })),
+    { role: "user", content: memoryContext }
+  ];
+}
 async function callLLMForAgentIteration(adapter, request) {
   validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
-  const messages = [
-    { role: "system", content: request.systemPrompt },
-    { role: "user", content: request.memoryContext }
-  ];
+  const messages = buildAgentMessages(request.systemPrompt, request.memoryContext, request.conversationHistory);
   const response = await adapter.generate({
     messages,
     responseSchema: buildIterationResponseSchema(
@@ -3340,10 +3346,7 @@ async function callLLMForAgentIteration(adapter, request) {
 async function callLLMForAgentCompletion(adapter, request) {
   validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
   const response = await adapter.generate({
-    messages: [
-      { role: "system", content: request.systemPrompt },
-      { role: "user", content: request.memoryContext }
-    ],
+    messages: buildAgentMessages(request.systemPrompt, request.memoryContext, request.conversationHistory),
     responseSchema: request.outputSchema,
     // Use output schema directly
     temperature: request.constraints.temperature || 0.3,
@@ -3477,6 +3480,7 @@ async function processReasoning(iterationContext) {
   const { reasoning, memoryOps, nextActions } = await callLLMForAgentIteration(adapter, {
     systemPrompt: request.systemPrompt,
     memoryContext: request.memoryContext,
+    conversationHistory: request.conversationHistory,
     tools: request.tools,
     constraints: request.constraints,
     model: iterationContext.modelConfig.model,
@@ -4349,11 +4353,10 @@ var MemoryManager = class {
    */
   toContext(currentIteration, currentTurn) {
     const status = this.getStatus();
-    const currentContext = this.memory.history.filter(
-      (entry) => (!currentTurn || entry.turnNumber === currentTurn || entry.turnNumber === void 0) && entry.iterationNumber === currentIteration
-    ).reverse();
+    const inTurnScope = (entry) => !currentTurn || entry.turnNumber === currentTurn || entry.turnNumber == null;
+    const currentContext = this.memory.history.filter((entry) => inTurnScope(entry) && entry.iterationNumber === currentIteration).reverse();
     const earlierContext = this.memory.history.filter(
-      (entry) => (!currentTurn || entry.turnNumber === currentTurn || entry.turnNumber === void 0) && entry.iterationNumber !== null && entry.iterationNumber < currentIteration
+      (entry) => inTurnScope(entry) && entry.iterationNumber !== null && entry.iterationNumber < currentIteration
     );
     const formatEntry = (entry) => {
       const label = `[${entry.type.toUpperCase()}]`;
@@ -4430,6 +4433,9 @@ function initializeKnowledgeMap(knowledgeMap) {
     nodes: Object.fromEntries(Object.entries(knowledgeMap.nodes).map(([id, node]) => [id, { ...node }]))
   };
 }
+function hasMemoryContent(memory) {
+  return Object.keys(memory.sessionMemory).length > 0 || memory.history.length > 0;
+}
 var Agent = class {
   // Base properties from definition
   config;
@@ -4439,6 +4445,7 @@ var Agent = class {
   knowledgeMap;
   definition;
   adapterFactory;
+  initialMemory;
   // Derived properties (computed from definition)
   shouldGenerateOutput;
   // Runtime state (initialized during execution)
@@ -4453,10 +4460,12 @@ var Agent = class {
    *
    * @param definition - Agent definition with config, contract, tools, and optional preloadMemory
    * @param adapterFactory - Factory for creating LLM adapters (decouples engine from provider SDKs)
+   * @param options - Per-execution options (e.g. restored session memory)
    */
-  constructor(definition, adapterFactory) {
+  constructor(definition, adapterFactory, options = {}) {
     this.definition = definition;
     this.adapterFactory = adapterFactory;
+    this.initialMemory = options.initialMemory;
     this.config = definition.config;
     this.contract = definition.contract;
     this.modelConfig = definition.modelConfig;
@@ -4550,25 +4559,9 @@ var Agent = class {
    * @returns Initialized MemoryManager instance
    */
   async initializeMemoryManager(validatedInput, context) {
-    let memory;
-    if (this.definition.preloadMemory) {
-      const preloadStartTime = Date.now();
-      memory = await this.definition.preloadMemory(context);
-      const preloadEndTime = Date.now();
-      this.logger.action(
-        "memory-preload",
-        `Preloaded ${Object.keys(memory.sessionMemory).length} session memory entries`,
-        0,
-        preloadStartTime,
-        preloadEndTime,
-        preloadEndTime - preloadStartTime
-      );
+    const memory = await this.resolveInitialMemory(context);
+    if (hasMemoryContent(memory)) {
       await this.reloadKnowledgeMapTools(memory, context);
-    } else {
-      memory = {
-        sessionMemory: {},
-        history: []
-      };
     }
     const inputStartTime = Date.now();
     memory.history.push({
@@ -4589,6 +4582,44 @@ var Agent = class {
     );
     return new MemoryManager(memory, this.config.constraints, this.logger);
   }
+  /**
+   * Resolve the memory this execution starts from.
+   *
+   * Precedence: caller-supplied `initialMemory` (session restore) > the definition's
+   * `preloadMemory` author hook > empty. Returns a detached copy in the restore case so
+   * the agent's mutations cannot corrupt the caller's snapshot.
+   */
+  async resolveInitialMemory(context) {
+    if (this.initialMemory) {
+      const restoreStartTime = Date.now();
+      const memory = structuredClone(this.initialMemory);
+      const restoreEndTime = Date.now();
+      this.logger.action(
+        "memory-restore",
+        `Restored ${Object.keys(memory.sessionMemory).length} session memory entries`,
+        0,
+        restoreStartTime,
+        restoreEndTime,
+        restoreEndTime - restoreStartTime
+      );
+      return memory;
+    }
+    if (this.definition.preloadMemory) {
+      const preloadStartTime = Date.now();
+      const memory = await this.definition.preloadMemory(context);
+      const preloadEndTime = Date.now();
+      this.logger.action(
+        "memory-preload",
+        `Preloaded ${Object.keys(memory.sessionMemory).length} session memory entries`,
+        0,
+        preloadStartTime,
+        preloadEndTime,
+        preloadEndTime - preloadStartTime
+      );
+      return memory;
+    }
+    return { sessionMemory: {}, history: [] };
+  }
   /**
    * Reload tools from knowledge map state (cross-turn persistence)
    *
@@ -4868,6 +4899,7 @@ var Agent = class {
       const structuredOutput = await callLLMForAgentCompletion(adapter, {
         systemPrompt,
         memoryContext: this.memoryManager.toContext(this.iterationNumber, this.executionContext?.sessionTurnNumber),
+        conversationHistory: this.executionContext?.conversationHistory,
         outputSchema,
         constraints: {
           maxOutputTokens: this.modelConfig.maxOutputTokens,
@@ -6883,6 +6915,7 @@ function buildWorkerExecutionContext(params) {
     resourceId: params.resourceId,
     sessionId: params.sessionId,
     sessionTurnNumber: params.sessionTurnNumber,
+    conversationHistory: params.conversationHistory,
     parentExecutionId: params.parentExecutionId,
     executionDepth: params.executionDepth,
     signal: params.signal,
@@ -6989,6 +7022,8 @@ function startWorker(org) {
         organizationName,
         sessionId,
         sessionTurnNumber,
+        sessionMemory,
+        conversationHistory,
         parentExecutionId,
         executionDepth
       } = msg;
@@ -7034,7 +7069,9 @@ function startWorker(org) {
         try {
           console.log(`[SDK-WORKER] Running agent '${resourceId}' (${agentDef.tools.length} tools)`);
           const adapterFactory = createPostMessageAdapterFactory();
-          const agentInstance = new Agent(agentDef, adapterFactory);
+          const agentInstance = new Agent(agentDef, adapterFactory, {
+            initialMemory: sessionMemory
+          });
           const context = buildWorkerExecutionContext({
             executionId,
             organizationId: organizationId ?? "",
@@ -7042,6 +7079,7 @@ function startWorker(org) {
             resourceId,
             sessionId,
             sessionTurnNumber,
+            conversationHistory,
             parentExecutionId,
             executionDepth: executionDepth ?? 0,
             signal: localAbortController.signal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.38.0",
+  "version": "1.39.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -58,9 +58,9 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/core": "0.54.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/core": "0.55.0",
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "scripts": {
     "lint": "eslint src --max-warnings 0",

package/reference/claude-config/sync-notes/2026-07-23-agent-session-memory.md

@@ -0,0 +1,49 @@
+# Session-capable agents now remember earlier turns
+
+## Why this note exists
+
+Any agent with `sessionCapable: true` was silently forgetting everything from earlier in the same
+conversation. Two things were broken:
+
+- **Its saved memory was never loaded back in.** The agent wrote memory at the end of a turn; the
+  next turn started from an empty memory instead of restoring it.
+- **The earlier messages were never given to the model.** The conversation was stored for display
+  but the execution path never read it, so turn N could not see turns 1..N-1.
+
+Both are now fixed, and both are **on by default** for session-capable agents. Turn N is handed the
+agent's restored memory plus the earlier user/assistant messages (token-budgeted), so it can actually
+continue the conversation. The fix is entirely platform-side — no agent definition changes are
+required to get it.
+
+## Applies to
+
+- **Every agent with `sessionCapable: true`.** The behavior arrives with the `@elevasis/sdk` and
+  `@elevasis/core` dependency baselines this train propagates.
+- **Especially agents whose memory strategy was written around the old broken behavior.** For
+  example, a voice/interview agent told _"never store the full transcript in memory — the transcript
+  is the source of truth"_ only worked if the transcript was actually replayed to the model. It
+  wasn't, so those agents deliberately declined to remember the one thing they needed. That guidance
+  is now correct: the earlier messages are given to the model.
+
+## Required actions
+
+1. **Take the `@elevasis/core` and `@elevasis/sdk` baseline bumps** this train propagates, then
+   reinstall in `operations/` so the new worker bundle is present.
+2. **Redeploy your operations bundle.** The worker is baked into the deployed bundle at build time,
+   so an existing deployment stays amnesiac until it is redeployed. `pnpm -C operations exec
+elevasis-sdk deploy --prod` (or your project's deploy command).
+3. **Revisit any `memoryPreferences` you wrote around the old behavior.** If you told an agent not to
+   store something because "the conversation is the source of truth," confirm that still matches what
+   you want now that the conversation is actually available to the model.
+
+## Verification
+
+- Hard recall probe: plant an unguessable token in turn 1, then in turn 2 ask for it back verbatim
+  **without restating it**. A fixed agent returns it; a broken one says the session is empty.
+- `turnInputTokens` grows turn over turn as the conversation accumulates, instead of staying flat at
+  system-prompt-plus-current-message size.
+
+## Not handled by /git-sync
+
+- **The redeploy.** `/git-sync` commits and pushes the propagated dependency baseline, but it does
+  not redeploy your operations bundle. The fix does not go live until you redeploy (action 2 above).

package/reference/claude-config/sync-notes/2026-07-23-workos-org-marker.md

@@ -0,0 +1,50 @@
+# WorkOS single-org binding moves to the `.elevasis` marker
+
+## Why this note exists
+
+**This is a correctness fix for a live data-exposure class of bug. Read it before your next deploy.**
+
+Single-org apps used to bind to their WorkOS organization through `VITE_WORKOS_ORG_ID`, a build-time env var. That variable lived only in a gitignored `ui/.env`, so it was absent from any clean build — CI, a fresh clone, a new hosting project. When it was absent the org guard in `__root.tsx` silently **no-opped**, and the app inherited whatever organization the WorkOS session happened to be using. It failed **open**.
+
+That is not hypothetical. `app.contemplativerecords.com` served a different tenant's data because its production build had no `VITE_WORKOS_ORG_ID` set.
+
+The binding now lives in the project's committed `.elevasis` marker:
+
+```yaml
+projectSlug: your-project
+templateVersion: "1.0"
+appMode: client-centric
+workosOrgId: org_01ABCDEFGHIJKLMNOPQRSTUVWX
+```
+
+The shared `elevasisVite()` plugin (from `@elevasis/ui/vite`, already wired into your `ui/vite.config.ts`) walks up from `ui/`, reads the marker, and injects the value as the build-time constant `__ELEVASIS_WORKOS_ORG_ID__`. The org guard, the `login.tsx` `signIn()` calls, and the dev-centric topbar switcher gate all read that constant.
+
+**A WorkOS `org_` id is a public identifier, not a secret** — it appears in URLs. Committing it is correct. Treating it as a secret is what put it in a gitignored file and caused the failure.
+
+`VITE_WORKOS_ORG_ID` is removed with **no fallback**. There is no transition period and no back-compat read. If you leave the env var set and do not seed the marker, your org guard stops binding.
+
+## Applies to
+
+- **Every template-derived project.** The plugin change arrives with the `@elevasis/ui` dependency baseline this train propagates.
+- **`client-centric` projects — action required.** `/external verify` now fails closed: a `client-centric` project whose `.elevasis` lacks a non-empty `org_`-prefixed `workosOrgId` fails the gate. This is deliberate. A loud failure is the point; the old silent no-op is what shipped the bug.
+- **`dev-centric` projects — optional.** The field may be absent or empty. If present and non-empty it must still be `org_`-prefixed.
+
+## Required actions
+
+1. **Add `workosOrgId` to your `.elevasis`.** Sync will not do this for you — see "Not handled by /git-sync" below. Find your org id in Command Center, or in the `organizations` table as `workos_org_id`.
+2. **Take the `@elevasis/ui` baseline bump** this train propagates, then reinstall in `ui/` so the plugin that injects the constant is actually present.
+3. **Remove `VITE_WORKOS_ORG_ID` from every environment you set it in** — `ui/.env`, `ui/.env.local`, and your hosting provider's env settings (for Vercel: Project → Settings → Environment Variables). Leaving it set does nothing, but it will mislead the next person who reads it.
+4. **Redeploy.** The constant is injected at build time, so an existing deployment keeps its old behavior until it is rebuilt.
+
+## Verification
+
+- `pnpm external:verify` passes, and your project's `marker` category reports `.elevasis workosOrgId is set for client-centric project`.
+- `grep -rn "VITE_WORKOS_ORG_ID" ui/ .env* 2>/dev/null` returns nothing.
+- In a built bundle, your org id is present: `grep -o "org_[A-Za-z0-9]*" ui/dist/assets/*.js | head`. If this returns nothing for a `client-centric` project, the marker was not read — check that `.elevasis` sits at your project root, one level above `ui/`.
+- After deploying, log in and confirm the app lands in the correct organization.
+
+## Not handled by /git-sync
+
+- **Your `.elevasis` marker is project-owned and `never-touch`.** The sync engine will never write it, which means it will never seed `workosOrgId` for you and never overwrite the value once you set it. Step 1 above is a manual, per-project edit. A `client-centric` project that skips it will fail `/external verify` until it is done.
+- **A diverged `__root.tsx` will not auto-merge.** `__root.tsx` is merge-managed with `critical-manual-merge` severity. If your shell has diverged from the template, sync preserves your copy and the `useOrgGuard` swap from `import.meta.env.VITE_WORKOS_ORG_ID` to `__ELEVASIS_WORKOS_ORG_ID__` is a manual edit. When you make it, do **not** remove the structural contract substrings `ElevasisAuthenticatedShell`, `from '@elevasis/ui/app'`, or `SYSTEM_MANIFESTS` — dropping them makes `sync-apply` mis-escalate your project to `catch-up-required`.
+- **A diverged `ui/vite.config.ts` needs reconciliation, not overwrite.** It is `replace-all` managed, so a blind sync would clobber local divergence. Confirm `...elevasisVite()` survives in your plugins array — without it the constant is never defined and the guard reads `undefined`.