@theokit/agents 0.46.0 → 0.47.0

package/dist/bridge.js

@@ -47,7 +47,7 @@ import {
   translateSdkEvent,
   validateUniqueRoutes,
   walkAgentMetadata
-} from "./chunk-YBNKD5UM.js";
+} from "./chunk-FEH7JFH7.js";
 import "./chunk-NERDIS45.js";
 import "./chunk-7QVYU63E.js";
 export {

package/dist/{chunk-YBNKD5UM.js → chunk-FEH7JFH7.js}

@@ -27,6 +27,142 @@ import {
   __name
 } from "./chunk-7QVYU63E.js";
 
+// 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
+    } : {},
+    // 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.
+    ...compileHooksAndPlugins(def),
+    // 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 compileHooksAndPlugins(def) {
+  const map = def.hooks;
+  const entries = Object.entries(map ?? {}).filter(([, h]) => typeof h === "function");
+  const explicit = def.plugins ?? [];
+  if (entries.length === 0) {
+    return def.plugins !== void 0 ? {
+      plugins: def.plugins
+    } : {};
+  }
+  const plugin = {
+    name: "theokit-builder-hooks",
+    version: "1.0.0",
+    kind: "general",
+    register(ctx) {
+      for (const [hookName, handler] of entries) {
+        ctx.on(hookName, handler);
+      }
+    }
+  };
+  return {
+    plugins: [
+      ...explicit,
+      plugin
+    ]
+  };
+}
+__name(compileHooksAndPlugins, "compileHooksAndPlugins");
+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/agent-execution-context.ts
 function createAgentExecutionContext(base, agent2, run, toolCall) {
   return {
@@ -506,142 +642,6 @@ 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
-    } : {},
-    // 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.
-    ...compileHooksAndPlugins(def),
-    // 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 compileHooksAndPlugins(def) {
-  const map = def.hooks;
-  const entries = Object.entries(map ?? {}).filter(([, h]) => typeof h === "function");
-  const explicit = def.plugins ?? [];
-  if (entries.length === 0) {
-    return def.plugins !== void 0 ? {
-      plugins: def.plugins
-    } : {};
-  }
-  const plugin = {
-    name: "theokit-builder-hooks",
-    version: "1.0.0",
-    kind: "general",
-    register(ctx) {
-      for (const [hookName, handler] of entries) {
-        ctx.on(hookName, handler);
-      }
-    }
-  };
-  return {
-    plugins: [
-      ...explicit,
-      plugin
-    ]
-  };
-}
-__name(compileHooksAndPlugins, "compileHooksAndPlugins");
-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;
@@ -1904,6 +1904,125 @@ var UIMessageStreamPresenter = class {
     return out;
   }
 };
+var ANSI = {
+  text: "",
+  reasoning: "\x1B[2m",
+  tool: "\x1B[36m",
+  "tool-result": "\x1B[2m",
+  "tool-error": "\x1B[31m",
+  error: "\x1B[31m",
+  status: "\x1B[35m",
+  finish: "\x1B[2m"
+};
+var RESET = "\x1B[0m";
+function preview(value, max) {
+  const raw = typeof value === "string" ? value : safeJson(value);
+  const flat = raw.replace(/\s+/g, " ").trim();
+  return flat.length > max ? `${flat.slice(0, max - 1)}\u2026` : flat;
+}
+__name(preview, "preview");
+__name2(preview, "preview");
+function safeJson(value) {
+  if (value === void 0 || value === null) return "";
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return typeof value === "bigint" ? value.toString() : "";
+  }
+}
+__name(safeJson, "safeJson");
+__name2(safeJson, "safeJson");
+function suffix(open, value, close) {
+  return value === void 0 ? "" : open + value + close;
+}
+__name(suffix, "suffix");
+__name2(suffix, "suffix");
+var TerminalPresenter = class {
+  static {
+    __name(this, "TerminalPresenter");
+  }
+  static {
+    __name2(this, "TerminalPresenter");
+  }
+  surface = "terminal";
+  #ansi;
+  #max;
+  constructor(options = {}) {
+    this.#ansi = options.ansi ?? false;
+    this.#max = options.maxPreview ?? 88;
+  }
+  present(event) {
+    switch (event.type) {
+      case "text":
+        return event.text.length > 0 ? [
+          this.#row("text", event.text)
+        ] : [];
+      case "reasoning":
+        return event.text.length > 0 ? [
+          this.#row("reasoning", `\xB7 ${event.text}`)
+        ] : [];
+      case "tool-call":
+        return [
+          this.#row("tool", `\u23FA ${event.name}(${preview(event.input, this.#max)})`)
+        ];
+      case "tool-result":
+        return [
+          this.#toolResult(event.isError === true, preview(event.result, this.#max))
+        ];
+      case "error":
+        return [
+          this.#row("error", `\u2716 ${event.message}${suffix(" (", event.code, ")")}`)
+        ];
+      case "status":
+        return [
+          this.#row("status", `\u25CF ${event.status}${suffix(" \u2014 ", event.detail, "")}`)
+        ];
+      case "finish":
+        return [
+          this.#row("finish", this.#finishText(event.reason, event.usage?.totalTokens))
+        ];
+      // `partial-tool-call` streams incremental args — the committed `tool-call` renders them.
+      default:
+        return [];
+    }
+  }
+  #toolResult(isError2, body) {
+    return this.#row(isError2 ? "tool-error" : "tool-result", `  \u23BF ${body}`);
+  }
+  #finishText(reason, tokens) {
+    const r = suffix(" ", reason, "");
+    const t = tokens === void 0 ? "" : ` \xB7 ${tokens} tokens`;
+    return `<<${r}${t} >>`;
+  }
+  #row(kind, text) {
+    return {
+      kind,
+      text: this.#ansi && ANSI[kind] !== "" ? `${ANSI[kind]}${text}${RESET}` : text
+    };
+  }
+};
+var JsonPresenter = class {
+  static {
+    __name(this, "JsonPresenter");
+  }
+  static {
+    __name2(this, "JsonPresenter");
+  }
+  surface = "json";
+  #ns;
+  constructor(options = {}) {
+    this.#ns = options.namespace ?? "agent.";
+  }
+  present(event) {
+    const { type, ...payload } = event;
+    return [
+      {
+        type: `${this.#ns}${type}`,
+        ...payload
+      }
+    ];
+  }
+};
 
 // src/bridge/present-ui-message-stream.ts
 function toAgentOutputEvent(e) {
@@ -3403,6 +3522,10 @@ function matchRoute(routes, method, pathname) {
 __name(matchRoute, "matchRoute");
 
 export {
+  AGENT_BRAND,
+  isAgentDefinition,
+  compileAgentDefinition,
+  compileSkillsSelection,
   createAgentExecutionContext,
   isAgentContext,
   compileContextWindow,
@@ -3423,9 +3546,6 @@ export {
   isError,
   isApprovalRequired,
   generateAgentRoutes,
-  AGENT_BRAND,
-  isAgentDefinition,
-  compileAgentDefinition,
   translateSdkEvent,
   buildModelSelection,
   createThinkTagExtractor,
@@ -3475,4 +3595,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-YBNKD5UM.js.map
+//# sourceMappingURL=chunk-FEH7JFH7.js.map