@theokit/agents 0.42.0 → 0.44.0

package/dist/{chunk-OFPS2N3U.js → chunk-6WOLHCZB.js}

@@ -506,6 +506,107 @@ function generateAgentRoutes(ctx) {
 }
 __name(generateAgentRoutes, "generateAgentRoutes");
 
+// src/bridge/define-agent.ts
+var AGENT_BRAND = /* @__PURE__ */ Symbol.for("theokit.agent.definition");
+function defineAgent(config) {
+  return {
+    ...config,
+    [AGENT_BRAND]: true
+  };
+}
+__name(defineAgent, "defineAgent");
+function isAgentDefinition(value) {
+  return typeof value === "object" && value !== null && value[AGENT_BRAND] === true;
+}
+__name(isAgentDefinition, "isAgentDefinition");
+function toCompiledTool(tool) {
+  const handler = tool.handler;
+  const compiled = {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    handler: /* @__PURE__ */ __name((input, ctx) => handler(input, ctx), "handler")
+  };
+  for (const sym of Object.getOwnPropertySymbols(tool)) {
+    ;
+    compiled[sym] = tool[sym];
+  }
+  return compiled;
+}
+__name(toCompiledTool, "toCompiledTool");
+function compileAgentDefinition(def) {
+  return {
+    model: def.model,
+    reasoningEffort: def.reasoningEffort,
+    systemPrompt: def.system,
+    tools: (def.tools ?? []).map(toCompiledTool),
+    agents: {},
+    stream: true,
+    // M7 — run-context flows to CompiledAgentOptions.runContext (distinct from the
+    // context-window `context` field the decorator path uses); absent ⇒ no key.
+    ...def.context !== void 0 ? {
+      runContext: def.context
+    } : {},
+    // M9 — guardrails flow through unchanged; the runner applies them at the input boundary.
+    ...def.guardrails !== void 0 ? {
+      guardrails: def.guardrails
+    } : {},
+    // M14 — HITL approvals compile into the same `hitl` map the decorator path produces.
+    ...def.approvals !== void 0 ? {
+      hitl: compileApprovals(def)
+    } : {},
+    // M13 — skills: a static list → SDK skills.enabled; a resolver → carried for the request path.
+    ...compileSkillsSelection(def.skills),
+    // theokit-file-based-config — the declared `.theokit/` sources flow to the run path, which
+    // projects them into `Agent.create({ local.settingSources })`; absent ⇒ inline config only.
+    ...def.settingSources !== void 0 ? {
+      settingSources: def.settingSources
+    } : {},
+    // MCP — builder/`defineAgent` servers converge on the same `mcpServers` field the `@MCP`
+    // decorator path populates; the SDK adapter forwards it to `Agent.create({ mcpServers })`.
+    ...def.mcpServers !== void 0 ? {
+      mcpServers: def.mcpServers
+    } : {}
+  };
+}
+__name(compileAgentDefinition, "compileAgentDefinition");
+function compileSkillsSelection(skills) {
+  if (skills === void 0) return {};
+  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,
+      autoInject: true,
+      ...inline.length > 0 ? {
+        inline
+      } : {}
+    }
+  };
+}
+__name(compileSkillsSelection, "compileSkillsSelection");
+function compileApprovals(def) {
+  const toolNames = new Set((def.tools ?? []).map((t) => t.name));
+  const gates = /* @__PURE__ */ new Map();
+  for (const [toolName, options] of Object.entries(def.approvals ?? {})) {
+    if (!toolNames.has(toolName)) {
+      throw new Error(`[@theokit/agents] defineAgent approval references unknown tool "${toolName}". Declared tools: ${[
+        ...toolNames
+      ].join(", ") || "(none)"}.`);
+    }
+    gates.set(toolName, options);
+  }
+  return gates;
+}
+__name(compileApprovals, "compileApprovals");
+
 // src/bridge/event-translator.ts
 function asString(value, fallback) {
   if (typeof value === "string") return value;
@@ -1301,6 +1402,43 @@ async function* streamSdkAgent(rt, compiled, sdkTools, opts) {
   }
 }
 __name(streamSdkAgent, "streamSdkAgent");
+function toAgentFactory(def, opts) {
+  const compiled = compileAgentDefinition(def);
+  const overrides = opts.overrides ?? {};
+  const model = overrides.model ?? compiled.model ?? "openai/gpt-4o-mini";
+  const reasoningEffort = overrides.reasoningEffort ?? compiled.reasoningEffort;
+  const runContext = overrides.runContext ?? compiled.runContext;
+  return async (sessionId) => {
+    const rt = await loadSdkRuntime();
+    if (!rt) {
+      throw new Error("[@theokit/agents] @theokit/sdk is not installed \u2014 run: pnpm add @theokit/sdk");
+    }
+    const sdkTools = buildSdkTools(compiled.tools, rt.defineTool, overrides.sdkTools, runContext);
+    const inlineSkills = compiled.skills?.inline;
+    if (inlineSkills !== void 0 && inlineSkills.length > 0 && rt.defineSkillReadTool !== void 0 && !compiled.tools.some((t) => t.name === "skill_read")) {
+      sdkTools.push(rt.defineSkillReadTool(inlineSkills));
+    }
+    const { options: m8 } = assembleM8CreateOptions(compiled);
+    if (overrides.cwd !== void 0) m8.local = {
+      ...m8.local,
+      cwd: overrides.cwd
+    };
+    if (overrides.baseDir !== void 0) m8.local = {
+      ...m8.local,
+      baseDir: overrides.baseDir
+    };
+    const extra = buildExtraCreateOptions(overrides, compiled);
+    const agent2 = await rt.Agent.getOrCreate(sessionId, {
+      apiKey: opts.apiKey,
+      model: buildModelSelection(model, reasoningEffort),
+      tools: sdkTools,
+      ...m8,
+      ...extra
+    });
+    return agent2;
+  };
+}
+__name(toAgentFactory, "toAgentFactory");
 
 // src/bridge/ui-message-stream-translator.ts
 function* closeOpenBlock(state, textId) {
@@ -1319,6 +1457,41 @@ function* closeOpenBlock(state, textId) {
   state.reasoningId = null;
 }
 __name(closeOpenBlock, "closeOpenBlock");
+function* emitTextDelta(state, textId, content) {
+  if (state.openBlock !== "text") {
+    yield* closeOpenBlock(state, textId);
+    yield {
+      type: "text-start",
+      id: textId
+    };
+    state.openBlock = "text";
+  }
+  yield {
+    type: "text-delta",
+    id: textId,
+    delta: content
+  };
+}
+__name(emitTextDelta, "emitTextDelta");
+function* emitReasoningDelta(state, textId, content) {
+  let reasoningId = state.openBlock === "reasoning" ? state.reasoningId : null;
+  if (reasoningId === null) {
+    yield* closeOpenBlock(state, textId);
+    reasoningId = crypto.randomUUID();
+    state.reasoningId = reasoningId;
+    yield {
+      type: "reasoning-start",
+      id: reasoningId
+    };
+    state.openBlock = "reasoning";
+  }
+  yield {
+    type: "reasoning-delta",
+    id: reasoningId,
+    delta: content
+  };
+}
+__name(emitReasoningDelta, "emitReasoningDelta");
 function* emitToolCall(event, seen) {
   seen.add(event.callId);
   yield {
@@ -1395,39 +1568,13 @@ async function* translateToUIMessageStream(events, opts) {
     reasoningId: null
   };
   const seenToolCallIds = /* @__PURE__ */ new Set();
+  let turnMetadata;
   try {
     for await (const event of events) {
       if (event.type === "text_delta") {
-        if (state.openBlock !== "text") {
-          yield* closeOpenBlock(state, opts.textId);
-          yield {
-            type: "text-start",
-            id: opts.textId
-          };
-          state.openBlock = "text";
-        }
-        yield {
-          type: "text-delta",
-          id: opts.textId,
-          delta: event.content
-        };
+        yield* emitTextDelta(state, opts.textId, event.content);
       } else if (event.type === "thinking") {
-        let reasoningId = state.openBlock === "reasoning" ? state.reasoningId : null;
-        if (reasoningId === null) {
-          yield* closeOpenBlock(state, opts.textId);
-          reasoningId = crypto.randomUUID();
-          state.reasoningId = reasoningId;
-          yield {
-            type: "reasoning-start",
-            id: reasoningId
-          };
-          state.openBlock = "reasoning";
-        }
-        yield {
-          type: "reasoning-delta",
-          id: reasoningId,
-          delta: event.content
-        };
+        yield* emitReasoningDelta(state, opts.textId, event.content);
       } else if (event.type === "tool_call") {
         yield* closeOpenBlock(state, opts.textId);
         yield* emitToolCall(event, seenToolCallIds);
@@ -1447,6 +1594,7 @@ async function* translateToUIMessageStream(events, opts) {
         };
         break;
       } else if (event.type === "done") {
+        turnMetadata = doneToMetadata(event);
         break;
       }
     }
@@ -1457,102 +1605,25 @@ async function* translateToUIMessageStream(events, opts) {
     };
   }
   yield* closeOpenBlock(state, opts.textId);
-  yield {
+  yield turnMetadata ? {
+    type: "finish",
+    messageMetadata: turnMetadata
+  } : {
     type: "finish"
   };
 }
 __name(translateToUIMessageStream, "translateToUIMessageStream");
-
-// src/bridge/define-agent.ts
-var AGENT_BRAND = /* @__PURE__ */ Symbol.for("theokit.agent.definition");
-function defineAgent(config) {
-  return {
-    ...config,
-    [AGENT_BRAND]: true
-  };
-}
-__name(defineAgent, "defineAgent");
-function isAgentDefinition(value) {
-  return typeof value === "object" && value !== null && value[AGENT_BRAND] === true;
-}
-__name(isAgentDefinition, "isAgentDefinition");
-function toCompiledTool(tool) {
-  const handler = tool.handler;
-  return {
-    name: tool.name,
-    description: tool.description,
-    inputSchema: tool.inputSchema,
-    handler: /* @__PURE__ */ __name((input, ctx) => handler(input, ctx), "handler")
-  };
-}
-__name(toCompiledTool, "toCompiledTool");
-function compileAgentDefinition(def) {
-  return {
-    model: def.model,
-    reasoningEffort: def.reasoningEffort,
-    systemPrompt: def.system,
-    tools: (def.tools ?? []).map(toCompiledTool),
-    agents: {},
-    stream: true,
-    // M7 — run-context flows to CompiledAgentOptions.runContext (distinct from the
-    // context-window `context` field the decorator path uses); absent ⇒ no key.
-    ...def.context !== void 0 ? {
-      runContext: def.context
-    } : {},
-    // M9 — guardrails flow through unchanged; the runner applies them at the input boundary.
-    ...def.guardrails !== void 0 ? {
-      guardrails: def.guardrails
-    } : {},
-    // M14 — HITL approvals compile into the same `hitl` map the decorator path produces.
-    ...def.approvals !== void 0 ? {
-      hitl: compileApprovals(def)
-    } : {},
-    // M13 — skills: a static list → SDK skills.enabled; a resolver → carried for the request path.
-    ...compileSkillsSelection(def.skills),
-    // theokit-file-based-config — the declared `.theokit/` sources flow to the run path, which
-    // projects them into `Agent.create({ local.settingSources })`; absent ⇒ inline config only.
-    ...def.settingSources !== void 0 ? {
-      settingSources: def.settingSources
-    } : {}
-  };
-}
-__name(compileAgentDefinition, "compileAgentDefinition");
-function compileSkillsSelection(skills) {
-  if (skills === void 0) return {};
-  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,
-      autoInject: true,
-      ...inline.length > 0 ? {
-        inline
-      } : {}
-    }
+function doneToMetadata(event) {
+  return event.cost === void 0 ? {
+    usage: event.usage,
+    durationMs: event.durationMs
+  } : {
+    usage: event.usage,
+    durationMs: event.durationMs,
+    cost: event.cost
   };
 }
-__name(compileSkillsSelection, "compileSkillsSelection");
-function compileApprovals(def) {
-  const toolNames = new Set((def.tools ?? []).map((t) => t.name));
-  const gates = /* @__PURE__ */ new Map();
-  for (const [toolName, options] of Object.entries(def.approvals ?? {})) {
-    if (!toolNames.has(toolName)) {
-      throw new Error(`[@theokit/agents] defineAgent approval references unknown tool "${toolName}". Declared tools: ${[
-        ...toolNames
-      ].join(", ") || "(none)"}.`);
-    }
-    gates.set(toolName, options);
-  }
-  return gates;
-}
-__name(compileApprovals, "compileApprovals");
+__name(doneToMetadata, "doneToMetadata");
 
 // src/bridge/agent-builder.ts
 function contextualTool(tool, _requiredContext) {
@@ -1618,6 +1689,10 @@ function makeBuilder(config) {
       ...config,
       settingSources: sources
     }), "settingSources"),
+    mcp: /* @__PURE__ */ __name((servers) => makeBuilder({
+      ...config,
+      mcpServers: servers
+    }), "mcp"),
     use: /* @__PURE__ */ __name((preset) => preset(runtime), "use"),
     build: /* @__PURE__ */ __name(() => defineAgent(config), "build")
   };
@@ -2942,15 +3017,16 @@ export {
   isError,
   isApprovalRequired,
   generateAgentRoutes,
+  AGENT_BRAND,
+  isAgentDefinition,
+  compileAgentDefinition,
   translateSdkEvent,
   buildModelSelection,
   createThinkTagExtractor,
   extractThinkTagStream,
   createSdkAgentStream,
+  toAgentFactory,
   translateToUIMessageStream,
-  AGENT_BRAND,
-  isAgentDefinition,
-  compileAgentDefinition,
   contextualTool,
   agent,
   AgentDefinitionError,
@@ -2993,4 +3069,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-OFPS2N3U.js.map
+//# sourceMappingURL=chunk-6WOLHCZB.js.map