@elevasis/sdk 1.37.0 → 1.39.0

package/dist/cli.cjs

@@ -40054,6 +40054,7 @@ function getLeadGenStageCatalog(model) {
       );
       const recordEntity = entry.recordEntity === "company" || entry.recordEntity === "contact" ? entry.recordEntity : void 0;
       const recordStageKey = stringValue(entry.recordStageKey);
+      const readinessTarget = entry.readinessTarget === true ? true : void 0;
       results[entryId] = {
         key: entryId,
         label: stringValue(entry.label) ?? entryId,
@@ -40062,7 +40063,8 @@ function getLeadGenStageCatalog(model) {
         entity,
         ...additionalEntities.length > 0 ? { additionalEntities } : {},
         ...recordEntity ? { recordEntity } : {},
-        ...recordStageKey ? { recordStageKey } : {}
+        ...recordStageKey ? { recordStageKey } : {},
+        ...readinessTarget ? { readinessTarget } : {}
       };
     }
   }
@@ -45848,7 +45850,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.37.0",
+  version: "1.39.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -5062,6 +5062,18 @@ interface LeadGenStageCatalogEntry {
     recordEntity?: 'company' | 'contact';
     /** Stage key to read from recordEntity.processing_state for Records views. */
     recordStageKey?: string;
+    /**
+     * Marks this stage as the pipeline objective ("ready" target).
+     *
+     * When declared, the platform UI uses the preceding stage (derived from
+     * `order`) as the backlog source and this stage as the drain, producing a
+     * "contacts ready for <next step>" count without hardcoding tenant-specific
+     * stage keys. Only one stage per catalog should set this to `true`.
+     *
+     * Absent (undefined) when not declared — no tenant authoring is required;
+     * the UI falls back to a generic last-incomplete-stage backlog.
+     */
+    readinessTarget?: boolean;
 }
 
 declare const ProcessingStageStatusSchema: z.ZodEnum<{
@@ -11227,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)
@@ -11234,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/index.js

@@ -1144,6 +1144,7 @@ function getLeadGenStageCatalog(model) {
       );
       const recordEntity = entry.recordEntity === "company" || entry.recordEntity === "contact" ? entry.recordEntity : void 0;
       const recordStageKey = stringValue(entry.recordStageKey);
+      const readinessTarget = entry.readinessTarget === true ? true : void 0;
       results[entryId] = {
         key: entryId,
         label: stringValue(entry.label) ?? entryId,
@@ -1152,7 +1153,8 @@ function getLeadGenStageCatalog(model) {
         entity,
         ...additionalEntities.length > 0 ? { additionalEntities } : {},
         ...recordEntity ? { recordEntity } : {},
-        ...recordStageKey ? { recordStageKey } : {}
+        ...recordStageKey ? { recordStageKey } : {},
+        ...readinessTarget ? { readinessTarget } : {}
       };
     }
   }

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,
@@ -8953,6 +8985,7 @@ function getLeadGenStageCatalog(model) {
       );
       const recordEntity = entry.recordEntity === "company" || entry.recordEntity === "contact" ? entry.recordEntity : void 0;
       const recordStageKey = stringValue(entry.recordStageKey);
+      const readinessTarget = entry.readinessTarget === true ? true : void 0;
       results[entryId] = {
         key: entryId,
         label: stringValue(entry.label) ?? entryId,
@@ -8961,7 +8994,8 @@ function getLeadGenStageCatalog(model) {
         entity,
         ...additionalEntities.length > 0 ? { additionalEntities } : {},
         ...recordEntity ? { recordEntity } : {},
-        ...recordStageKey ? { recordStageKey } : {}
+        ...recordStageKey ? { recordStageKey } : {},
+        ...readinessTarget ? { readinessTarget } : {}
       };
     }
   }
@@ -10252,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,
@@ -10358,6 +10393,8 @@ function startWorker(org) {
         organizationName,
         sessionId,
         sessionTurnNumber,
+        sessionMemory,
+        conversationHistory,
         parentExecutionId,
         executionDepth
       } = msg;
@@ -10403,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 ?? "",
@@ -10411,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.37.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/core": "0.53.0",
-    "@repo/eslint-config": "0.0.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",