@theokit/agents 0.21.1 → 0.22.0

package/dist/{bridge-entry-CEnpN6oR.d.ts → bridge-entry-CHodDWs0.d.ts}

@@ -1,6 +1,6 @@
 import { ExecutionContext } from '@theokit/http';
-import { A as AgentOptions, T as ToolOptions, g as MainLoopMeta, a as ApprovalOptions, B as BudgetOptions, f as GatewayOptions, l as MemoryOptions, s as SkillsOptions, e as ContextWindowOptions, q as ProjectContextOptions, j as McpServersMap, b as CompactionDecoratorConfig } from './skills-CO7vBqHz.js';
-import { SystemPromptResolver, SkillsSettings, ContextSettings, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition, BudgetTracker, ConversationStorageAdapter, CustomTool } from '@theokit/sdk';
+import { A as AgentOptions, T as ToolOptions, g as MainLoopMeta, a as ApprovalOptions, B as BudgetOptions, f as GatewayOptions, l as MemoryOptions, t as SkillsOptions, e as ContextWindowOptions, q as ProjectContextOptions, j as McpServersMap, b as CompactionDecoratorConfig, R as ReasoningEffort } from './skills-BzEzl0YN.js';
+import { SystemPromptResolver, SkillsSettings, ContextSettings, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition, BudgetTracker, ConversationStorageAdapter, CustomTool, ModelSelection } from '@theokit/sdk';
 import { RetryOptions } from '@theokit/sdk/retry';
 import { z } from 'zod';
 
@@ -134,6 +134,8 @@ interface CompiledSubAgent {
 /** Compiled agent options ready for SDK Agent.create(). */
 interface CompiledAgentOptions {
     model?: string;
+    /** Extended-thinking effort declared via `@Agent({ reasoningEffort })`; mapped to SDK ModelSelection.params. */
+    reasoningEffort?: ReasoningEffort;
     /** Static prompt OR a per-request {@link SystemPromptResolver} (V4-L.1, Axis-B). */
     systemPrompt?: string | SystemPromptResolver;
     tools: CompiledTool[];
@@ -413,6 +415,11 @@ declare function generateAgentRoutes(ctx: AgentRouteContext): AgentRoute[];
 interface RuntimeOverrides {
     /** Overrides the model for this call (`?? compiled.model ?? default`). */
     model?: string;
+    /**
+     * Per-run extended-thinking effort (`?? compiled.reasoningEffort`). Mapped to the SDK
+     * `ModelSelection.params` so the provider produces reasoning (surfaced as `thinking` StreamEvents).
+     */
+    reasoningEffort?: ReasoningEffort;
     /** Per-run cwd → `Agent.create({ local: { cwd } })` → `SystemPromptContext.cwd`. */
     cwd?: string;
     /**
@@ -449,6 +456,20 @@ interface RuntimeOverrides {
  */
 declare function createSdkAgentStream(compiled: CompiledAgentOptions, compiledTools: CompiledTool[], apiKey: string, overrides?: RuntimeOverrides): (message: string, sessionId: string) => AsyncIterable<StreamEvent>;
 
+/**
+ * Model-selection mapping (M1 reasoning-visibility) — the single site that turns a
+ * provider-agnostic `ReasoningEffort` into the SDK `ModelSelection`. Kept in its own small module
+ * (not inside `sdk-adapter.ts`) so the adapter stays under the G6 500-LoC budget and the helper has
+ * a focused home (per the plan's T1.1 "or a small sibling").
+ */
+
+/**
+ * Build the SDK `ModelSelection` for a model id + optional reasoning effort. With no (or empty)
+ * effort it returns the bare `{ id }` — byte-identical to the prior behavior (backward-compat). With
+ * an effort it adds the canonical reasoning param `{ id: 'thinking', value: effort }`. Pure.
+ */
+declare function buildModelSelection(modelId: string, effort?: ReasoningEffort): ModelSelection;
+
 /**
  * Translates @theokit/sdk SDKMessage events → TheoKit AgentStreamEvent.
  *
@@ -798,4 +819,4 @@ declare function agentsPlugin(opts: AgentsPluginOptions): {
     register(app: PluginApp): void;
 };
 
-export { delegate as $, type AgentExecutionContext as A, BudgetExceededError as B, type CompiledAgentOptions as C, type DelegationResult as D, type ErrorEvent as E, type FileEditEvent as F, type RunStartedEvent as G, type SdkMessage as H, type IterationEvent as I, type StateUpdateEvent as J, type ThinkingEvent as K, type LoopStrategy as L, type ToolCallEvent as M, type ToolResultEvent as N, type ToolWalkResult as O, type ToolboxWalkResult as P, agentsPlugin as Q, type ReflectionStrategy as R, type StreamEvent as S, type TextDeltaEvent as T, compileAgent as U, compileContextWindow as V, compileProjectContext as W, compileSkills as X, compileTools as Y, createAgentExecutionContext as Z, createSdkAgentStream as _, type CompiledTool as a, generateAgentManifest as a0, generateAgentRoutes as a1, isAgentContext as a2, isApprovalRequired as a3, isDone as a4, isError as a5, isTextDelta as a6, isToolCall as a7, isToolResult as a8, ladderReflectionStrategy as a9, loopStrategyConfigSchema as aa, noopReflectionStrategy as ab, projectContextMetadataOnlyKnobs as ac, reflectionStrategyConfigSchema as ad, resolveLoopStrategy as ae, streamAgentResponse as af, translateSdkEvent as ag, validateUniqueRoutes as ah, walkAgentMetadata as ai, type AgentManifest as b, type AgentManifestEntry as c, type AgentManifestTool as d, type AgentRoute as e, type AgentRouteContext as f, type AgentRunInfo as g, type AgentStreamEvent as h, type AgentWalkResult as i, AgentWarningCode as j, type AgentsPluginOptions as k, type ApprovalRequiredEvent as l, type ArtifactChunkEvent as m, type ArtifactStartEvent as n, type CheckpointSavedEvent as o, type CompiledContextWindow as p, DEFAULT_MAX_ITERATIONS as q, type DelegateOptions as r, DelegationError as s, type DoneEvent as t, type LoopFinishReason as u, type LoopOutcome as v, type LoopStrategyConfig as w, type ReflectionContext as x, type ReflectionResult as y, type ReflectionStrategyConfig as z };
+export { createSdkAgentStream as $, type AgentExecutionContext as A, BudgetExceededError as B, type CompiledAgentOptions as C, type DelegationResult as D, type ErrorEvent as E, type FileEditEvent as F, type RunStartedEvent as G, type SdkMessage as H, type IterationEvent as I, type StateUpdateEvent as J, type ThinkingEvent as K, type LoopStrategy as L, type ToolCallEvent as M, type ToolResultEvent as N, type ToolWalkResult as O, type ToolboxWalkResult as P, agentsPlugin as Q, type ReflectionStrategy as R, type StreamEvent as S, type TextDeltaEvent as T, buildModelSelection as U, compileAgent as V, compileContextWindow as W, compileProjectContext as X, compileSkills as Y, compileTools as Z, createAgentExecutionContext as _, type CompiledTool as a, delegate as a0, generateAgentManifest as a1, generateAgentRoutes as a2, isAgentContext as a3, isApprovalRequired as a4, isDone as a5, isError as a6, isTextDelta as a7, isToolCall as a8, isToolResult as a9, ladderReflectionStrategy as aa, loopStrategyConfigSchema as ab, noopReflectionStrategy as ac, projectContextMetadataOnlyKnobs as ad, reflectionStrategyConfigSchema as ae, resolveLoopStrategy as af, streamAgentResponse as ag, translateSdkEvent as ah, validateUniqueRoutes as ai, walkAgentMetadata as aj, type AgentManifest as b, type AgentManifestEntry as c, type AgentManifestTool as d, type AgentRoute as e, type AgentRouteContext as f, type AgentRunInfo as g, type AgentStreamEvent as h, type AgentWalkResult as i, AgentWarningCode as j, type AgentsPluginOptions as k, type ApprovalRequiredEvent as l, type ArtifactChunkEvent as m, type ArtifactStartEvent as n, type CheckpointSavedEvent as o, type CompiledContextWindow as p, DEFAULT_MAX_ITERATIONS as q, type DelegateOptions as r, DelegationError as s, type DoneEvent as t, type LoopFinishReason as u, type LoopOutcome as v, type LoopStrategyConfig as w, type ReflectionContext as x, type ReflectionResult as y, type ReflectionStrategyConfig as z };

package/dist/bridge.d.ts

@@ -1,6 +1,6 @@
-export { A as AgentExecutionContext, b as AgentManifest, c as AgentManifestEntry, d as AgentManifestTool, e as AgentRoute, f as AgentRouteContext, g as AgentRunInfo, h as AgentStreamEvent, i as AgentWalkResult, j as AgentWarningCode, k as AgentsPluginOptions, l as ApprovalRequiredEvent, m as ArtifactChunkEvent, n as ArtifactStartEvent, B as BudgetExceededError, o as CheckpointSavedEvent, C as CompiledAgentOptions, p as CompiledContextWindow, a as CompiledTool, r as DelegateOptions, s as DelegationError, D as DelegationResult, t as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, G as RunStartedEvent, H as SdkMessage, J as StateUpdateEvent, S as StreamEvent, T as TextDeltaEvent, K as ThinkingEvent, M as ToolCallEvent, N as ToolResultEvent, O as ToolWalkResult, P as ToolboxWalkResult, Q as agentsPlugin, U as compileAgent, V as compileContextWindow, W as compileProjectContext, X as compileSkills, Y as compileTools, Z as createAgentExecutionContext, _ as createSdkAgentStream, $ as delegate, a0 as generateAgentManifest, a1 as generateAgentRoutes, a2 as isAgentContext, a3 as isApprovalRequired, a4 as isDone, a5 as isError, a6 as isTextDelta, a7 as isToolCall, a8 as isToolResult, ac as projectContextMetadataOnlyKnobs, af as streamAgentResponse, ag as translateSdkEvent, ah as validateUniqueRoutes, ai as walkAgentMetadata } from './bridge-entry-CEnpN6oR.js';
+export { A as AgentExecutionContext, b as AgentManifest, c as AgentManifestEntry, d as AgentManifestTool, e as AgentRoute, f as AgentRouteContext, g as AgentRunInfo, h as AgentStreamEvent, i as AgentWalkResult, j as AgentWarningCode, k as AgentsPluginOptions, l as ApprovalRequiredEvent, m as ArtifactChunkEvent, n as ArtifactStartEvent, B as BudgetExceededError, o as CheckpointSavedEvent, C as CompiledAgentOptions, p as CompiledContextWindow, a as CompiledTool, r as DelegateOptions, s as DelegationError, D as DelegationResult, t as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, G as RunStartedEvent, H as SdkMessage, J as StateUpdateEvent, S as StreamEvent, T as TextDeltaEvent, K as ThinkingEvent, M as ToolCallEvent, N as ToolResultEvent, O as ToolWalkResult, P as ToolboxWalkResult, Q as agentsPlugin, U as buildModelSelection, V as compileAgent, W as compileContextWindow, X as compileProjectContext, Y as compileSkills, Z as compileTools, _ as createAgentExecutionContext, $ as createSdkAgentStream, a0 as delegate, a1 as generateAgentManifest, a2 as generateAgentRoutes, a3 as isAgentContext, a4 as isApprovalRequired, a5 as isDone, a6 as isError, a7 as isTextDelta, a8 as isToolCall, a9 as isToolResult, ad as projectContextMetadataOnlyKnobs, ag as streamAgentResponse, ah as translateSdkEvent, ai as validateUniqueRoutes, aj as walkAgentMetadata } from './bridge-entry-CHodDWs0.js';
 import '@theokit/http';
-import './skills-CO7vBqHz.js';
+import './skills-BzEzl0YN.js';
 import '@theokit/sdk';
 import 'zod';
 import '@theokit/sdk/retry';

package/dist/bridge.js

@@ -3,6 +3,7 @@ import {
   BudgetExceededError,
   DelegationError,
   agentsPlugin,
+  buildModelSelection,
   compileAgent,
   compileContextWindow,
   compileProjectContext,
@@ -25,7 +26,7 @@ import {
   translateSdkEvent,
   validateUniqueRoutes,
   walkAgentMetadata
-} from "./chunk-FN5HVN6P.js";
+} from "./chunk-ITKVE65Q.js";
 import "./chunk-GVPUUKKE.js";
 import "./chunk-7QVYU63E.js";
 export {
@@ -33,6 +34,7 @@ export {
   BudgetExceededError,
   DelegationError,
   agentsPlugin,
+  buildModelSelection,
   compileAgent,
   compileContextWindow,
   compileProjectContext,

package/dist/{chunk-FN5HVN6P.js → chunk-ITKVE65Q.js}

@@ -300,6 +300,7 @@ function compileAgent(walkResult, toolboxInstances = /* @__PURE__ */ new Map())
   const agents = compileSubAgents(walkResult.subAgentClasses);
   return {
     model: walkResult.agentConfig.model,
+    reasoningEffort: walkResult.agentConfig.reasoningEffort,
     systemPrompt: walkResult.agentConfig.systemPrompt,
     tools,
     agents,
@@ -607,6 +608,64 @@ function translateSdkEvent(msg, runId) {
   }
 }
 __name(translateSdkEvent, "translateSdkEvent");
+function translateInteractionUpdate(update) {
+  switch (update.type) {
+    case "text-delta":
+      return update.text ? [
+        {
+          type: "text_delta",
+          content: update.text
+        }
+      ] : [];
+    case "thinking-delta":
+      return update.text ? [
+        {
+          type: "thinking",
+          content: update.text
+        }
+      ] : [];
+    case "tool-call-started":
+      return [
+        {
+          type: "tool_call",
+          callId: update.callId,
+          toolName: update.toolCall.name,
+          input: update.toolCall.args ?? {}
+        }
+      ];
+    case "tool-call-completed":
+      return [
+        {
+          type: "tool_result",
+          callId: update.callId,
+          toolName: update.toolCall.name,
+          output: serializeToolOutput(update.toolCall.result, ""),
+          durationMs: 0,
+          isError: false
+        }
+      ];
+    default:
+      return [];
+  }
+}
+__name(translateInteractionUpdate, "translateInteractionUpdate");
+
+// src/bridge/model-selection.ts
+function buildModelSelection(modelId, effort) {
+  if (!effort) return {
+    id: modelId
+  };
+  return {
+    id: modelId,
+    params: [
+      {
+        id: "thinking",
+        value: effort
+      }
+    ]
+  };
+}
+__name(buildModelSelection, "buildModelSelection");
 
 // src/bridge/sdk-adapter.ts
 function assembleM8CreateOptions(compiled) {
@@ -703,9 +762,29 @@ function createAsyncQueue() {
   };
 }
 __name(createAsyncQueue, "createAsyncQueue");
-async function* mergeDeltaStream(stream, queue, runId, state) {
+function streamCallId(ev) {
+  return typeof ev.callId === "string" ? ev.callId : "";
+}
+__name(streamCallId, "streamCallId");
+function isDuplicatedByDelta(ev, state) {
+  if (ev.type === "text_delta") return state.sawTextDelta;
+  if (ev.type === "thinking") return state.sawThinkingDelta;
+  if (ev.type === "tool_call") {
+    const id = streamCallId(ev);
+    return id !== "" && state.emittedToolCallIds.has(id);
+  }
+  if (ev.type === "tool_result") {
+    const id = streamCallId(ev);
+    return id !== "" && state.emittedToolResultIds.has(id);
+  }
+  return false;
+}
+__name(isDuplicatedByDelta, "isDuplicatedByDelta");
+async function* mergeDeltaStream(queue, openStream, runId, state) {
+  let pumpError;
   const pump = (async () => {
     try {
+      const stream = await openStream();
       for await (const msg of stream) queue.push({
         kind: "sdk",
         msg
@@ -713,7 +792,11 @@ async function* mergeDeltaStream(stream, queue, runId, state) {
     } finally {
       queue.close();
     }
-  })();
+  })().catch((thrown) => {
+    pumpError = {
+      thrown
+    };
+  });
   for await (const item of queue) {
     if (item.kind === "delta") {
       yield item.event;
@@ -721,16 +804,49 @@ async function* mergeDeltaStream(stream, queue, runId, state) {
     }
     for (const out of translateSdkEvent(item.msg, runId)) {
       if (out.type === "done") continue;
-      if (out.type === "text_delta" && state.sawDelta) continue;
+      if (isDuplicatedByDelta(out, state)) continue;
       if (out.type === "error") state.sawError = true;
       yield out;
     }
   }
   await pump;
+  if (pumpError) throw pumpError.thrown;
 }
 __name(mergeDeltaStream, "mergeDeltaStream");
+function createDeltaSink(queue) {
+  const state = {
+    sawTextDelta: false,
+    sawThinkingDelta: false,
+    emittedToolCallIds: /* @__PURE__ */ new Set(),
+    emittedToolResultIds: /* @__PURE__ */ new Set(),
+    sawError: false
+  };
+  const onDelta = /* @__PURE__ */ __name((d) => {
+    for (const event of translateInteractionUpdate(d.update)) {
+      if (event.type === "text_delta") state.sawTextDelta = true;
+      else if (event.type === "thinking") state.sawThinkingDelta = true;
+      else if (event.type === "tool_call") {
+        const id = streamCallId(event);
+        if (id !== "") state.emittedToolCallIds.add(id);
+      } else if (event.type === "tool_result") {
+        const id = streamCallId(event);
+        if (id !== "") state.emittedToolResultIds.add(id);
+      }
+      queue.push({
+        kind: "delta",
+        event
+      });
+    }
+  }, "onDelta");
+  return {
+    state,
+    onDelta
+  };
+}
+__name(createDeltaSink, "createDeltaSink");
 function createSdkAgentStream(compiled, compiledTools, apiKey, overrides = {}) {
   const model = overrides.model ?? compiled.model ?? "openai/gpt-4o-mini";
+  const reasoningEffort = overrides.reasoningEffort ?? compiled.reasoningEffort;
   let storage = overrides.conversationStorage;
   return (message, sessionId) => ({
     async *[Symbol.asyncIterator]() {
@@ -780,39 +896,23 @@ function createSdkAgentStream(compiled, compiledTools, apiKey, overrides = {}) {
         }
         agent = await Agent.getOrCreate(sessionId, {
           apiKey,
-          model: {
-            id: model
-          },
+          model: buildModelSelection(model, reasoningEffort),
           tools: sdkTools,
           ...m8,
           ...extra,
           conversationStorage: storage
         });
         const queue = createAsyncQueue();
-        const state = {
-          sawDelta: false,
-          sawError: false
-        };
-        const onDelta = /* @__PURE__ */ __name((d) => {
-          if (d.update.type === "text-delta" && d.update.text) {
-            state.sawDelta = true;
-            queue.push({
-              kind: "delta",
-              event: {
-                type: "text_delta",
-                content: d.update.text
-              }
-            });
-          }
-        }, "onDelta");
-        const run = await agent.send(message, {
+        const { state, onDelta } = createDeltaSink(queue);
+        const sendPromise = agent.send(message, {
           onDelta
         });
-        for await (const event of mergeDeltaStream(run.stream(), queue, runId, state)) {
+        const openStream = /* @__PURE__ */ __name(async () => (await sendPromise).stream(), "openStream");
+        for await (const event of mergeDeltaStream(queue, openStream, runId, state)) {
           yield event;
         }
         if (!state.sawError) {
-          yield realUsageDone(await run.wait(), t0);
+          yield realUsageDone(await (await sendPromise).wait(), t0);
         }
       } catch (err) {
         yield {
@@ -1251,6 +1351,7 @@ var AgentRunner = class {
     const loop = opts.maxIterations != null ? resolveLoopStrategy(this.loopStrategy.name, opts.maxIterations) : this.loopStrategy;
     const streamFactory = opts.streamFactory ?? createSdkAgentStream(this.compiled, tools, opts.apiKey, {
       model: opts.model,
+      reasoningEffort: opts.reasoningEffort,
       cwd: opts.cwd,
       plugins: opts.plugins,
       providers: opts.providers,
@@ -1532,6 +1633,7 @@ export {
   isApprovalRequired,
   generateAgentRoutes,
   translateSdkEvent,
+  buildModelSelection,
   createSdkAgentStream,
   DEFAULT_KEEP_TOKENS,
   compactionStrategyConfigSchema,
@@ -1551,4 +1653,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-FN5HVN6P.js.map
+//# sourceMappingURL=chunk-ITKVE65Q.js.map