@theokit/agents 0.35.2 → 0.37.0

package/dist/{bridge-entry-B3_Vw4qc.d.ts → bridge-entry-C20NAna5.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 { InlineSkill, 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';
@@ -112,17 +112,23 @@ declare function validateUniqueRoutes(results: AgentWalkResult[]): void;
  * different users. A selection is either a static list or a function of the request context (the M7
  * run-context). Discovery + injection stay in the SDK; this only CHOOSES the enabled set per call.
  */
+
 /** The request context handed to a skills resolver (the M7 run-context — opaque per-request data). */
 type SkillsRequestContext = Record<string, unknown>;
 /**
- * How the enabled skill set is chosen:
- * - `string[]`  — a static list (same shape `skills.enabled` accepts today).
- * - a function  — resolved per request from the {@link SkillsRequestContext} (sync or async).
+ * How the skill set is chosen:
+ * - a static array of `string` (filesystem skill NAMES → `skills.enabled`) and/or `InlineSkill`
+ *   objects from `createSkill` (code-defined skills → `skills.inline`, injected into the `<skills>`
+ *   block). A mixed list is split at compile time.
+ * - a function — resolved per request from the {@link SkillsRequestContext} (sync or async). The
+ *   resolver returns filesystem skill NAMES (inline skills are static — declared on the agent).
  */
-type SkillsSelection = readonly string[] | ((ctx: SkillsRequestContext) => readonly string[] | Promise<readonly string[]>);
+type SkillsSelection = readonly (string | InlineSkill)[] | ((ctx: SkillsRequestContext) => readonly string[] | Promise<readonly string[]>);
 /**
  * Resolve the enabled skill names for a request. Returns `undefined` when no selection is given (the
- * SDK then enables every discovered skill). Fails fast if a resolver returns a non-array.
+ * SDK then enables every discovered skill). Fails fast if a resolver returns a non-array. The static
+ * array is compiled ahead of time (see `compileSkillsSelection`), so this is exercised for the
+ * resolver form; a static array is defensively narrowed to its string (name) members.
  */
 declare function resolveEnabledSkills(selection: SkillsSelection | undefined, ctx: SkillsRequestContext): Promise<string[] | undefined>;
 
@@ -184,6 +190,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 +735,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 +863,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-C20NAna5.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-7IGNIY3B.js";
+} from "./chunk-AG4WA4I4.js";
 import "./chunk-B24BAVE6.js";
 import "./chunk-7QVYU63E.js";
 export {

package/dist/{chunk-7IGNIY3B.js → chunk-AG4WA4I4.js}

@@ -1180,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()}`;
@@ -1491,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");
@@ -1500,12 +1505,19 @@ function compileSkillsSelection(skills) {
   if (typeof skills === "function") return {
     skillsResolver: skills
   };
+  const enabled = [];
+  const inline = [];
+  for (const entry of skills) {
+    if (typeof entry === "string") enabled.push(entry);
+    else inline.push(entry);
+  }
   return {
     skills: {
-      enabled: [
-        ...skills
-      ],
-      autoInject: true
+      enabled,
+      autoInject: true,
+      ...inline.length > 0 ? {
+        inline
+      } : {}
     }
   };
 }
@@ -1585,6 +1597,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")
   };
@@ -2960,4 +2976,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-7IGNIY3B.js.map
+//# sourceMappingURL=chunk-AG4WA4I4.js.map