@theokit/agents 0.35.1 → 0.36.0

package/dist/{bridge-entry-B3_Vw4qc.d.ts → bridge-entry-DYXCEzdJ.d.ts}

@@ -1,6 +1,6 @@
 import { ExecutionContext } from '@theokit/http';
 import { A as AgentOptions, g as ToolOptions, M as MainLoopMeta, a as ApprovalOptions, B as BudgetOptions, H as HumanInTheLoopOptions, t as GatewayOptions, z as MemoryOptions, O as SkillsOptions, r as ContextWindowOptions, K as ProjectContextOptions, x as McpServersMap, G as Guardrail, o as CompactionDecoratorConfig, j as CheckpointOptions, R as ReasoningEffort } from './types-DVA4LQsA.js';
-import { SystemPromptResolver, SkillsSettings, ContextSettings, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ConversationStorageAdapter, CustomTool, ModelSelection } from '@theokit/sdk';
+import { SystemPromptResolver, ConversationStorageAdapter, SkillsSettings, ContextSettings, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, CustomTool, ModelSelection } from '@theokit/sdk';
 import { UIMessageChunk } from 'ai';
 import { z } from 'zod';
 import { RetryOptions } from '@theokit/sdk/retry';
@@ -184,6 +184,14 @@ interface CompiledAgentOptions {
     recoverLeakedToolCalls?: boolean;
     /** Static prompt OR a per-request {@link SystemPromptResolver} (V4-L.1, Axis-B). */
     systemPrompt?: string | SystemPromptResolver;
+    /**
+     * Agent-level conversation memory: the `ConversationStorageAdapter` the SDK persists turns to
+     * (`Agent.getOrCreate({ conversationStorage })`). Populated by `defineAgent({ conversationStorage })`
+     * / `.conversationStorage(adapter)`. A per-run override (`RuntimeOverrides.conversationStorage`)
+     * wins over this; absent ⇒ the SDK default store is chosen lazily. Distinct from `@Checkpoint`,
+     * which only toggles filesystem-vs-memory for the built-in default.
+     */
+    conversationStorage?: ConversationStorageAdapter;
     tools: CompiledTool[];
     agents: Record<string, CompiledSubAgent>;
     memory?: MemoryOptions;
@@ -721,6 +729,13 @@ interface DefineAgentConfig<TInput extends z.ZodType = z.ZodType> {
      * request path against the run-context). Absent ⇒ the SDK enables every discovered skill.
      */
     skills?: SkillsSelection;
+    /**
+     * Conversation memory: the `ConversationStorageAdapter` the agent persists its turns to. Swap it to
+     * control WHERE memory lives — `InMemoryConversationStorage` (ephemeral, great for tests) vs
+     * `FileSystemConversationStorage` (durable) vs a custom adapter. Absent ⇒ the SDK picks its default
+     * store. A per-run override still wins over this agent-level default.
+     */
+    conversationStorage?: ConversationStorageAdapter;
 }
 /**
  * A branded agent definition — the value {@link defineAgent} returns.
@@ -842,6 +857,11 @@ interface AgentBuilder<TInput extends z.ZodType | UnsetMarker = UnsetMarker, TMo
     approvals(map: Record<string, HumanInTheLoopOptions>): AgentBuilder<TInput, TModel, TContext, TTools>;
     /** M13 — select skills: a static list OR a per-request resolver `(ctx) => string[]`. */
     skills(selection: SkillsSelection): AgentBuilder<TInput, TModel, TContext, TTools>;
+    /**
+     * Set the agent's conversation memory — the `ConversationStorageAdapter` the SDK persists turns to.
+     * Swap in-memory ⇄ filesystem ⇄ custom without touching the runtime. A per-run override still wins.
+     */
+    conversationStorage(adapter: ConversationStorageAdapter): AgentBuilder<TInput, TModel, TContext, TTools>;
     /**
      * Apply a reusable partial chain (Spring-Boot-style composition). `preset` receives the current
      * builder and returns an advanced one; its accumulated type-state flows through.

package/dist/bridge.d.ts

@@ -1,4 +1,4 @@
-export { c as AGENT_BRAND, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinition, g as AgentDefinitionError, h as AgentExecutionContext, i as AgentManifest, A as AgentManifestEntry, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentStreamEvent, o as AgentWalkResult, p as AgentWarningCode, q as AgentsPluginOptions, r as ApiErrorContext, s as ApiErrorDecision, t as ApiErrorPolicy, u as ApprovalRequiredEvent, v as ArtifactChunkEvent, w as ArtifactStartEvent, B as BackgroundDelegation, x as BeforeToolCallContext, y as BudgetExceededError, z as CheckpointSavedEvent, C as CompiledAgentOptions, E as CompiledContextWindow, a as CompiledTool, F as ContextualTool, H as DefineAgentConfig, I as DelegateFn, J as DelegateOptions, K as DelegationError, D as DelegationResult, M as DoneEvent, N as ErrorEvent, O as FileEditEvent, Q as InferAgentInput, T as InferAgentToolNames, U as IterationEvent, V as LLMCallContext, Z as McpApprovalSpec, _ as McpRegistryConfig, $ as McpRequestContext, a0 as McpSelection, a1 as PartialToolCallEvent, a2 as ProcessInputContext, a6 as RunStartedEvent, a7 as ScoreVerdict, a8 as ScoredDelegation, a9 as Scorer, aa as SdkMessage, ab as Segment, ae as StateUpdateEvent, S as StreamEvent, af as TextDeltaEvent, ag as ThinkingEvent, ah as ToolCallEvent, ai as ToolCallVeto, aj as ToolHooks, ak as ToolHooksPlugin, al as ToolResultEvent, am as ToolWalkResult, an as ToolboxWalkResult, ao as agent, ap as agentsPlugin, aq as buildModelSelection, ar as compileAgent, as as compileAgentDefinition, at as compileAgentModule, au as compileContextWindow, av as compileProjectContext, aw as compileSkills, ax as compileTools, ay as contextualTool, az as createAgentExecutionContext, aA as createApiErrorHandler, aB as createSdkAgentStream, aC as createThinkTagExtractor, aD as createToolHooksPlugin, aE as delegate, aF as delegateBackground, aG as delegateWithScoring, aH as extractThinkTagStream, aI as generateAgentManifest, aJ as generateAgentRoutes, aK as isAgentContext, aL as isAgentDefinition, aM as isApprovalRequired, aN as isDone, aO as isError, aP as isPartialToolCall, aQ as isTextDelta, aR as isToolCall, aS as isToolResult, aV as mcpRegistry, aW as mcpToolApprovals, aY as projectContextMetadataOnlyKnobs, b0 as resolveMcpServers, b1 as runWithApiErrorHandling, b2 as streamAgentResponse, b3 as streamAgentUIMessages, b4 as translateSdkEvent, b5 as translateToUIMessageStream, b6 as validateUniqueRoutes, b7 as walkAgentMetadata } from './bridge-entry-B3_Vw4qc.js';
+export { c as AGENT_BRAND, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinition, g as AgentDefinitionError, h as AgentExecutionContext, i as AgentManifest, A as AgentManifestEntry, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentStreamEvent, o as AgentWalkResult, p as AgentWarningCode, q as AgentsPluginOptions, r as ApiErrorContext, s as ApiErrorDecision, t as ApiErrorPolicy, u as ApprovalRequiredEvent, v as ArtifactChunkEvent, w as ArtifactStartEvent, B as BackgroundDelegation, x as BeforeToolCallContext, y as BudgetExceededError, z as CheckpointSavedEvent, C as CompiledAgentOptions, E as CompiledContextWindow, a as CompiledTool, F as ContextualTool, H as DefineAgentConfig, I as DelegateFn, J as DelegateOptions, K as DelegationError, D as DelegationResult, M as DoneEvent, N as ErrorEvent, O as FileEditEvent, Q as InferAgentInput, T as InferAgentToolNames, U as IterationEvent, V as LLMCallContext, Z as McpApprovalSpec, _ as McpRegistryConfig, $ as McpRequestContext, a0 as McpSelection, a1 as PartialToolCallEvent, a2 as ProcessInputContext, a6 as RunStartedEvent, a7 as ScoreVerdict, a8 as ScoredDelegation, a9 as Scorer, aa as SdkMessage, ab as Segment, ae as StateUpdateEvent, S as StreamEvent, af as TextDeltaEvent, ag as ThinkingEvent, ah as ToolCallEvent, ai as ToolCallVeto, aj as ToolHooks, ak as ToolHooksPlugin, al as ToolResultEvent, am as ToolWalkResult, an as ToolboxWalkResult, ao as agent, ap as agentsPlugin, aq as buildModelSelection, ar as compileAgent, as as compileAgentDefinition, at as compileAgentModule, au as compileContextWindow, av as compileProjectContext, aw as compileSkills, ax as compileTools, ay as contextualTool, az as createAgentExecutionContext, aA as createApiErrorHandler, aB as createSdkAgentStream, aC as createThinkTagExtractor, aD as createToolHooksPlugin, aE as delegate, aF as delegateBackground, aG as delegateWithScoring, aH as extractThinkTagStream, aI as generateAgentManifest, aJ as generateAgentRoutes, aK as isAgentContext, aL as isAgentDefinition, aM as isApprovalRequired, aN as isDone, aO as isError, aP as isPartialToolCall, aQ as isTextDelta, aR as isToolCall, aS as isToolResult, aV as mcpRegistry, aW as mcpToolApprovals, aY as projectContextMetadataOnlyKnobs, b0 as resolveMcpServers, b1 as runWithApiErrorHandling, b2 as streamAgentResponse, b3 as streamAgentUIMessages, b4 as translateSdkEvent, b5 as translateToUIMessageStream, b6 as validateUniqueRoutes, b7 as walkAgentMetadata } from './bridge-entry-DYXCEzdJ.js';
 import '@theokit/http';
 import './types-DVA4LQsA.js';
 import '@theokit/sdk';

package/dist/bridge.js

@@ -46,7 +46,7 @@ import {
   translateToUIMessageStream,
   validateUniqueRoutes,
   walkAgentMetadata
-} from "./chunk-IAE4FWBV.js";
+} from "./chunk-RJTRE6BD.js";
 import "./chunk-B24BAVE6.js";
 import "./chunk-7QVYU63E.js";
 export {

package/dist/{chunk-IAE4FWBV.js → chunk-RJTRE6BD.js}

@@ -804,6 +804,15 @@ async function* extractThinkTagStream(source) {
 }
 __name(extractThinkTagStream, "extractThinkTagStream");
 
+// src/debug-log.ts
+function debugLog(marker, data) {
+  const flag = process.env.THEOKIT_DEBUG;
+  if (flag !== void 0 && flag !== "" && flag !== "0" && flag !== "false") {
+    console.debug(marker, data);
+  }
+}
+__name(debugLog, "debugLog");
+
 // src/bridge/sdk-adapter-create-options.ts
 function assembleM8CreateOptions(compiled) {
   const options = {};
@@ -1171,7 +1180,7 @@ function createSdkAgentStream(compiled, compiledTools, apiKey, overrides = {}) {
   const reasoningEffort = overrides.reasoningEffort ?? compiled.reasoningEffort;
   const { parseThinkTags, stripToolDialect } = resolveTextTransformFlags(compiled, overrides);
   const runContext = overrides.runContext ?? compiled.runContext;
-  let storage = overrides.conversationStorage;
+  let storage = overrides.conversationStorage ?? compiled.conversationStorage;
   return (message, sessionId, factoryOpts) => ({
     async *[Symbol.asyncIterator]() {
       const runId = `run-${Date.now()}`;
@@ -1196,7 +1205,7 @@ function createSdkAgentStream(compiled, compiledTools, apiKey, overrides = {}) {
       } else {
         runContextSource = "none";
       }
-      console.debug("[THEO_AGENT_M7_RUN_CONTEXT]", {
+      debugLog("[THEO_AGENT_M7_RUN_CONTEXT]", {
         source: runContextSource,
         keys: runContext !== void 0 ? Object.keys(runContext) : []
       });
@@ -1237,7 +1246,7 @@ async function* streamSdkAgent(rt, compiled, sdkTools, storage, opts) {
   };
   const extra = buildExtraCreateOptions(overrides, compiled);
   if (applied.length > 0) {
-    console.debug("[THEO_AGENT_M8_RUNTIME_APPLIED]", {
+    debugLog("[THEO_AGENT_M8_RUNTIME_APPLIED]", {
       skills: applied.includes("skills"),
       contextWindow: applied.includes("context"),
       projectContext: applied.includes("projectContext")
@@ -1482,7 +1491,12 @@ function compileAgentDefinition(def) {
       hitl: compileApprovals(def)
     } : {},
     // M13 — skills: a static list → SDK skills.enabled; a resolver → carried for the request path.
-    ...compileSkillsSelection(def.skills)
+    ...compileSkillsSelection(def.skills),
+    // Conversation memory: the declared adapter flows to the run path, which hands it to
+    // `Agent.getOrCreate({ conversationStorage })`; absent ⇒ the SDK default is chosen lazily.
+    ...def.conversationStorage !== void 0 ? {
+      conversationStorage: def.conversationStorage
+    } : {}
   };
 }
 __name(compileAgentDefinition, "compileAgentDefinition");
@@ -1576,6 +1590,10 @@ function makeBuilder(config) {
       ...config,
       skills: selection
     }), "skills"),
+    conversationStorage: /* @__PURE__ */ __name((adapter) => makeBuilder({
+      ...config,
+      conversationStorage: adapter
+    }), "conversationStorage"),
     use: /* @__PURE__ */ __name((preset) => preset(runtime), "use"),
     build: /* @__PURE__ */ __name(() => defineAgent(config), "build")
   };
@@ -2152,7 +2170,7 @@ __name(accumulateUsage, "accumulateUsage");
 function finalize(acc, round, reason, strategyName) {
   acc.rounds = round;
   acc.finishReason = reason;
-  console.debug(MAINLOOP_METRIC, {
+  debugLog(MAINLOOP_METRIC, {
     strategy: strategyName,
     rounds: round,
     terminal: reason
@@ -2951,4 +2969,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-IAE4FWBV.js.map
+//# sourceMappingURL=chunk-RJTRE6BD.js.map