@theokit/agents 0.44.4 → 0.44.6

package/dist/{bridge-entry-BtFJdaCe.d.ts → bridge-entry-D2u56i8T.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 { InlineSkill, SystemPromptResolver, SettingSource, SkillsSettings, ContextSettings, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection } from '@theokit/sdk';
+import { InlineSkill, SystemPromptResolver, SettingSource, MemorySettings, SkillsSettings, ContextSettings, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection } from '@theokit/sdk';
 import { z } from 'zod';
 import { UIMessageChunk } from 'ai';
 import { RetryOptions } from '@theokit/sdk/retry';
@@ -200,7 +200,7 @@ interface CompiledAgentOptions {
     plugins?: readonly unknown[];
     tools: CompiledTool[];
     agents: Record<string, CompiledSubAgent>;
-    memory?: MemoryOptions;
+    memory?: MemoryOptions | MemorySettings;
     skills?: SkillsSettings;
     context?: ContextSettings;
     /**
@@ -587,6 +587,13 @@ interface DefineAgentConfig<TInput extends z.ZodType = z.ZodType> {
      * + execution (G2 / ADR-0040); theokit only wires this into `Agent.create({ local.settingSources })`.
      */
     settingSources?: readonly SettingSource[];
+    /**
+     * M49 — durable memory (the SDK's `.theokit/memory/` subsystem: `Remember:` capture, MEMORY.md
+     * store, auto-injected `<memory>` block, `memory_search`/`memory_get` tools). The shape is the
+     * SDK's own `MemorySettings` — the canonical runtime contract. Projected into
+     * `Agent.create({ memory })` by `assembleM8CreateOptions`.
+     */
+    memory?: MemorySettings;
     /**
      * Code `Plugin` objects forwarded to `Agent.create({ plugins })` — EXTENSION units (tools,
      * commands, model providers, memory adapters). For lifecycle interception use {@link hooks}.
@@ -648,9 +655,25 @@ declare function compileAgentDefinition(def: AgentDefinition): CompiledAgentOpti
  * one object (rather than positional params) so the per-request surface can grow without
  * a parameter explosion. Each field is Axis-A SWAP — a value the app holds at call time.
  */
+/**
+ * A multimodal image for a send turn — the SDK's `SDKImage` shape, typed locally because `@theokit/sdk`
+ * is an optional peer (dynamic import). Either a URL or inline base64 `{ data, mimeType }`.
+ */
+type BridgeImage = {
+    url: string;
+} | {
+    data: string;
+    mimeType: string;
+};
 interface RuntimeOverrides {
     /** Overrides the model for this call (`?? compiled.model ?? default`). */
     model?: string;
+    /**
+     * M35 (multimodal) — images to send alongside the text. When present, the SDK send switches from the
+     * plain-string form to the structured `{ text, images }` form (`SDKUserMessage`). Absent ⇒ the
+     * string path is byte-unchanged (back-compat).
+     */
+    images?: readonly BridgeImage[];
     /**
      * Per-run extended-thinking effort (`?? compiled.reasoningEffort`). Mapped to the SDK
      * `ModelSelection.params` so the provider produces reasoning (surfaced as `thinking` StreamEvents).
@@ -940,6 +963,12 @@ interface AgentBuilder<TInput extends z.ZodType | UnsetMarker = UnsetMarker, TMo
      * shell-executing hooks from `.theokit/hooks.json` — opt-in because `.theokit/` is your own repo.
      */
     settingSources(sources: readonly SettingSource[]): AgentBuilder<TInput, TModel, TContext, TTools>;
+    /**
+     * M49 — enable the SDK's durable memory for this agent (`.theokit/memory/` in the run cwd:
+     * `Remember:` capture with secret redaction, auto-injected recall, memory tools). Takes the SDK's
+     * `MemorySettings` verbatim — `{ enabled: true }` is the minimal opt-in.
+     */
+    memory(settings: MemorySettings): AgentBuilder<TInput, TModel, TContext, TTools>;
     /**
      * Attach LIFECYCLE HOOKS in code, keyed by `HookName` — the builder-chain seam for intercepting
      * the agent loop. `pre_tool_call` may VETO a tool by returning `{ block: true, message }` before
@@ -1070,6 +1099,8 @@ interface StreamHitlOptions {
 interface StreamAgentOptions {
     message: string;
     sessionId: string;
+    /** M35 (multimodal) — images to send alongside the text. Absent ⇒ the string send path is unchanged. */
+    images?: RuntimeOverrides['images'];
     /** Enable human-in-the-loop tool approval (M4). Absent ⇒ the M2 non-HITL path, byte-unchanged. */
     hitl?: StreamHitlOptions;
     /**

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 AgentTurnMetadata, p as AgentWalkResult, q as AgentWarningCode, r as AgentsPluginOptions, s as ApiErrorContext, t as ApiErrorDecision, u as ApiErrorPolicy, v as ApprovalRequiredEvent, w as ArtifactChunkEvent, x as ArtifactStartEvent, B as BackgroundDelegation, y as BeforeToolCallContext, z as BudgetExceededError, E as CheckpointSavedEvent, C as CompiledAgentOptions, F as CompiledContextWindow, a as CompiledTool, G as ContextualTool, I as DefineAgentConfig, J as DelegateFn, K as DelegateOptions, M as DelegationError, D as DelegationResult, N as DoneEvent, O as ErrorEvent, P as FileEditEvent, T as InferAgentInput, U as InferAgentToolNames, V as IterationEvent, W as LLMCallContext, _ as McpApprovalSpec, $ as McpRegistryConfig, a0 as McpRequestContext, a1 as McpSelection, a2 as PartialToolCallEvent, a3 as ProcessInputContext, a7 as RunStartedEvent, a8 as ScoreVerdict, a9 as ScoredDelegation, aa as Scorer, ab as SdkAgentHandle, ac as SdkMessage, ad as Segment, ag as StateUpdateEvent, S as StreamEvent, ah as TextDeltaEvent, ai as ThinkingEvent, aj as ToolCallEvent, ak as ToolCallVeto, al as ToolHooks, am as ToolHooksPlugin, an as ToolResultEvent, ao as ToolWalkResult, ap as ToolboxWalkResult, aq as agent, ar as agentsPlugin, as as buildModelSelection, at as compileAgent, au as compileAgentDefinition, av as compileAgentModule, aw as compileContextWindow, ax as compileProjectContext, ay as compileSkills, az as compileTools, aA as contextualTool, aB as createAgentExecutionContext, aC as createApiErrorHandler, aD as createSdkAgentStream, aE as createThinkTagExtractor, aF as createToolHooksPlugin, aG as delegate, aH as delegateBackground, aI as delegateWithScoring, aJ as extractThinkTagStream, aK as generateAgentManifest, aL as generateAgentRoutes, aM as isAgentContext, aN as isAgentDefinition, aO as isApprovalRequired, aP as isDone, aQ as isError, aR as isPartialToolCall, aS as isTextDelta, aT as isToolCall, aU as isToolResult, aX as mcpRegistry, aY as mcpToolApprovals, a_ as projectContextMetadataOnlyKnobs, b2 as resolveMcpServers, b3 as runWithApiErrorHandling, b4 as streamAgentResponse, b5 as streamAgentUIMessages, b6 as toAgentFactory, b7 as translateSdkEvent, b8 as translateToUIMessageStream, b9 as validateUniqueRoutes, ba as walkAgentMetadata } from './bridge-entry-BtFJdaCe.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 AgentTurnMetadata, p as AgentWalkResult, q as AgentWarningCode, r as AgentsPluginOptions, s as ApiErrorContext, t as ApiErrorDecision, u as ApiErrorPolicy, v as ApprovalRequiredEvent, w as ArtifactChunkEvent, x as ArtifactStartEvent, B as BackgroundDelegation, y as BeforeToolCallContext, z as BudgetExceededError, E as CheckpointSavedEvent, C as CompiledAgentOptions, F as CompiledContextWindow, a as CompiledTool, G as ContextualTool, I as DefineAgentConfig, J as DelegateFn, K as DelegateOptions, M as DelegationError, D as DelegationResult, N as DoneEvent, O as ErrorEvent, P as FileEditEvent, T as InferAgentInput, U as InferAgentToolNames, V as IterationEvent, W as LLMCallContext, _ as McpApprovalSpec, $ as McpRegistryConfig, a0 as McpRequestContext, a1 as McpSelection, a2 as PartialToolCallEvent, a3 as ProcessInputContext, a7 as RunStartedEvent, a8 as ScoreVerdict, a9 as ScoredDelegation, aa as Scorer, ab as SdkAgentHandle, ac as SdkMessage, ad as Segment, ag as StateUpdateEvent, S as StreamEvent, ah as TextDeltaEvent, ai as ThinkingEvent, aj as ToolCallEvent, ak as ToolCallVeto, al as ToolHooks, am as ToolHooksPlugin, an as ToolResultEvent, ao as ToolWalkResult, ap as ToolboxWalkResult, aq as agent, ar as agentsPlugin, as as buildModelSelection, at as compileAgent, au as compileAgentDefinition, av as compileAgentModule, aw as compileContextWindow, ax as compileProjectContext, ay as compileSkills, az as compileTools, aA as contextualTool, aB as createAgentExecutionContext, aC as createApiErrorHandler, aD as createSdkAgentStream, aE as createThinkTagExtractor, aF as createToolHooksPlugin, aG as delegate, aH as delegateBackground, aI as delegateWithScoring, aJ as extractThinkTagStream, aK as generateAgentManifest, aL as generateAgentRoutes, aM as isAgentContext, aN as isAgentDefinition, aO as isApprovalRequired, aP as isDone, aQ as isError, aR as isPartialToolCall, aS as isTextDelta, aT as isToolCall, aU as isToolResult, aX as mcpRegistry, aY as mcpToolApprovals, a_ as projectContextMetadataOnlyKnobs, b2 as resolveMcpServers, b3 as runWithApiErrorHandling, b4 as streamAgentResponse, b5 as streamAgentUIMessages, b6 as toAgentFactory, b7 as translateSdkEvent, b8 as translateToUIMessageStream, b9 as validateUniqueRoutes, ba as walkAgentMetadata } from './bridge-entry-D2u56i8T.js';
 import '@theokit/http';
 import './types-DVA4LQsA.js';
 import '@theokit/sdk';

package/dist/bridge.js

@@ -47,7 +47,7 @@ import {
   translateToUIMessageStream,
   validateUniqueRoutes,
   walkAgentMetadata
-} from "./chunk-TFGN3AJV.js";
+} from "./chunk-K74V6J3S.js";
 import "./chunk-NERDIS45.js";
 import "./chunk-7QVYU63E.js";
 export {

package/dist/{chunk-TFGN3AJV.js → chunk-K74V6J3S.js}

@@ -562,6 +562,10 @@ function compileAgentDefinition(def) {
     ...def.settingSources !== void 0 ? {
       settingSources: def.settingSources
     } : {},
+    // M49 — memory flows to the projection layer; `assembleM8CreateOptions` forwards it to Agent.create.
+    ...def.memory !== void 0 ? {
+      memory: def.memory
+    } : {},
     // Hooks are converted here — the layer EVERY path converges on — rather than on the builder, so
     // `defineAgent({ hooks })` cannot type-check and silently no-op. A lifecycle hook that is
     // declared but never registered is a security gate that does not gate.
@@ -980,6 +984,12 @@ function assembleM8CreateOptions(compiled) {
     options.mcpServers = compiled.mcpServers;
     applied.push("mcpServers");
   }
+  if (compiled.memory !== void 0) {
+    options.memory = "enabled" in compiled.memory ? compiled.memory : {
+      enabled: true
+    };
+    applied.push("memory");
+  }
   return {
     options,
     applied
@@ -1425,7 +1435,11 @@ async function* streamSdkAgent(rt, compiled, sdkTools, opts) {
       onDelta
     };
     if (factoryOpts?.disableTools === true) sendOptions.toolChoice = "none";
-    const sendPromise = agent2.send(message, sendOptions);
+    const sendInput = overrides.images && overrides.images.length > 0 ? {
+      text: message,
+      images: overrides.images
+    } : message;
+    const sendPromise = agent2.send(sendInput, sendOptions);
     const openStream = /* @__PURE__ */ __name(async () => (await sendPromise).stream(), "openStream");
     const merged = mergeDeltaStream(queue, openStream, runId, state);
     for await (const event of applyTextTransforms(merged, {
@@ -1729,6 +1743,10 @@ function makeBuilder(config) {
       ...config,
       settingSources: sources
     }), "settingSources"),
+    memory: /* @__PURE__ */ __name((settings) => makeBuilder({
+      ...config,
+      memory: settings
+    }), "memory"),
     hooks: /* @__PURE__ */ __name((map) => makeBuilder({
       ...config,
       hooks: map
@@ -1894,6 +1912,7 @@ function streamAgentUIMessages(compiled, apiKey, input) {
   const overrides = {};
   if (input.cwd !== void 0) overrides.cwd = input.cwd;
   if (input.baseDir !== void 0) overrides.baseDir = input.baseDir;
+  if (input.images !== void 0) overrides.images = input.images;
   let source;
   if (!input.hitl || input.hitl.gated.size === 0) {
     const events2 = createSdkAgentStream(compiled, compiled.tools, apiKey, overrides)(input.message, input.sessionId);
@@ -3117,4 +3136,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-TFGN3AJV.js.map
+//# sourceMappingURL=chunk-K74V6J3S.js.map