@theokit/agents 0.1.0-alpha.0

package/dist/chunk-YK76AQNU.js

@@ -0,0 +1,461 @@
+import {
+  AGENT_CONFIG,
+  AGENT_MAIN_LOOP,
+  Audit,
+  RequiresApproval,
+  TOOLBOX_CONFIG,
+  TOOL_CONFIG,
+  TOOL_METHODS,
+  Trace,
+  __name,
+  getAgentConfig,
+  getGatewayConfig,
+  getMcpConfig,
+  getMemoryConfig,
+  getMeta,
+  getMixins,
+  getSkillsConfig,
+  getSubAgents
+} from "./chunk-3LCIXX3T.js";
+
+// src/bridge/agent-execution-context.ts
+function createAgentExecutionContext(base, agent, run, toolCall) {
+  return {
+    getRequest: /* @__PURE__ */ __name(() => base.getRequest(), "getRequest"),
+    getUrl: /* @__PURE__ */ __name(() => base.getUrl(), "getUrl"),
+    getClass: /* @__PURE__ */ __name(() => base.getClass(), "getClass"),
+    getMethodName: /* @__PURE__ */ __name(() => base.getMethodName(), "getMethodName"),
+    getAgent: /* @__PURE__ */ __name(() => agent, "getAgent"),
+    getRun: /* @__PURE__ */ __name(() => run, "getRun"),
+    getToolCall: /* @__PURE__ */ __name(() => toolCall ?? null, "getToolCall"),
+    isAgentContext: /* @__PURE__ */ __name(() => true, "isAgentContext")
+  };
+}
+__name(createAgentExecutionContext, "createAgentExecutionContext");
+function isAgentContext(ctx) {
+  return "isAgentContext" in ctx && ctx.isAgentContext();
+}
+__name(isAgentContext, "isAgentContext");
+
+// src/bridge/walk-agent-metadata.ts
+import "reflect-metadata";
+import { Reflector } from "@theokit/http-decorators";
+var reflectorInstance = new Reflector();
+var USE_GUARDS = /* @__PURE__ */ Symbol.for("theokit:http-decorators:use-guards");
+var USE_INTERCEPTORS = /* @__PURE__ */ Symbol.for("theokit:http-decorators:use-interceptors");
+var USE_FILTERS = /* @__PURE__ */ Symbol.for("theokit:http-decorators:use-filters");
+function walkToolbox(ToolboxClass) {
+  const config = getMeta(TOOLBOX_CONFIG, ToolboxClass) ?? {};
+  const methods = getMeta(TOOL_METHODS, ToolboxClass) ?? [];
+  const classGuards = getMeta(USE_GUARDS, ToolboxClass) ?? [];
+  const tools = methods.map((propertyKey) => {
+    const toolConfig = getMeta(TOOL_CONFIG, ToolboxClass, propertyKey);
+    if (!toolConfig) {
+      throw new Error(`[@theokit/agents] Toolbox ${ToolboxClass.name}: method '${String(propertyKey)}' is in TOOL_METHODS but has no @Tool() config.`);
+    }
+    const methodGuards = getMeta(USE_GUARDS, ToolboxClass, propertyKey) ?? [];
+    const ref = reflectorInstance;
+    const approvalVal = ref.get(RequiresApproval, ToolboxClass, propertyKey);
+    const traceVal = ref.get(Trace, ToolboxClass, propertyKey);
+    const auditVal = ref.get(Audit, ToolboxClass, propertyKey);
+    return {
+      propertyKey,
+      config: toolConfig,
+      guards: [
+        ...classGuards,
+        ...methodGuards
+      ],
+      approval: approvalVal && typeof approvalVal === "object" && "reason" in approvalVal ? approvalVal : void 0,
+      capabilities: void 0,
+      budget: void 0,
+      trace: traceVal ?? false,
+      audit: auditVal ?? false
+    };
+  });
+  return {
+    class: ToolboxClass,
+    namespace: config.namespace ?? "",
+    tools,
+    guards: classGuards
+  };
+}
+__name(walkToolbox, "walkToolbox");
+var agentWalkCache = /* @__PURE__ */ new WeakMap();
+function walkAgentMetadata(AgentClass, toolboxClasses = []) {
+  if (toolboxClasses.length === 0) {
+    const cached = agentWalkCache.get(AgentClass);
+    if (cached) return cached;
+  }
+  const agentConfig = getMeta(AGENT_CONFIG, AgentClass);
+  if (!agentConfig) {
+    throw new Error(`[@theokit/agents] Class ${AgentClass.name} is missing @Agent() decorator.`);
+  }
+  const mainLoop = getMeta(AGENT_MAIN_LOOP, AgentClass);
+  if (!mainLoop) {
+    throw new Error(`[@theokit/agents] Agent ${AgentClass.name} is missing @MainLoop() decorator. Decorate exactly one method with @MainLoop().`);
+  }
+  const guards = getMeta(USE_GUARDS, AgentClass) ?? [];
+  const interceptors = getMeta(USE_INTERCEPTORS, AgentClass) ?? [];
+  const filters = getMeta(USE_FILTERS, AgentClass) ?? [];
+  const toolboxes = toolboxClasses.map(walkToolbox);
+  const gateway = getGatewayConfig(AgentClass);
+  const subAgentClasses = getSubAgents(AgentClass);
+  const memory = getMemoryConfig(AgentClass);
+  const skills = getSkillsConfig(AgentClass);
+  const mcpServers = getMcpConfig(AgentClass);
+  const result = {
+    agentConfig,
+    mainLoop,
+    toolboxes,
+    guards,
+    interceptors,
+    filters,
+    route: agentConfig.route,
+    gateway,
+    subAgentClasses,
+    memory,
+    skills,
+    mcpServers
+  };
+  if (toolboxClasses.length === 0) {
+    agentWalkCache.set(AgentClass, result);
+  }
+  return result;
+}
+__name(walkAgentMetadata, "walkAgentMetadata");
+function validateUniqueRoutes(results) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    const existing = seen.get(r.route);
+    if (existing) {
+      throw new Error(`[@theokit/agents] Duplicate agent route '${r.route}': both '${existing}' and '${r.agentConfig.name}' declare it.`);
+    }
+    seen.set(r.route, r.agentConfig.name);
+  }
+}
+__name(validateUniqueRoutes, "validateUniqueRoutes");
+
+// src/bridge/agent-compiler.ts
+function compileTools(toolboxes, toolboxInstances) {
+  const tools = [];
+  for (const tb of toolboxes) {
+    const instance = toolboxInstances.get(tb.class);
+    if (!instance) {
+      throw new Error(`[@theokit/agents] Toolbox ${tb.class.name} not instantiated \u2014 add to providers or pass instances.`);
+    }
+    for (const tool of tb.tools) {
+      const handler = instance[tool.propertyKey];
+      if (typeof handler !== "function") {
+        throw new Error(`[@theokit/agents] Toolbox ${tb.class.name}: '${String(tool.propertyKey)}' is not a function.`);
+      }
+      const name = tb.namespace ? `${tb.namespace}.${tool.config.name}` : tool.config.name;
+      tools.push({
+        name,
+        description: tool.config.description,
+        inputSchema: tool.config.input,
+        handler: /* @__PURE__ */ __name((input) => handler.call(instance, input), "handler")
+      });
+    }
+  }
+  return tools;
+}
+__name(compileTools, "compileTools");
+function compileSubAgents(subAgentClasses) {
+  const agents = {};
+  for (const cls of subAgentClasses) {
+    const config = getAgentConfig(cls);
+    if (!config) continue;
+    agents[config.name] = {
+      model: config.model,
+      systemPrompt: config.systemPrompt
+    };
+  }
+  return agents;
+}
+__name(compileSubAgents, "compileSubAgents");
+function compileAgent(walkResult, toolboxInstances = /* @__PURE__ */ new Map()) {
+  const tools = compileTools(walkResult.toolboxes, toolboxInstances);
+  const agents = compileSubAgents(walkResult.subAgentClasses);
+  return {
+    model: walkResult.agentConfig.model,
+    systemPrompt: walkResult.agentConfig.systemPrompt,
+    tools,
+    agents,
+    memory: walkResult.memory,
+    skills: walkResult.skills,
+    mcpServers: walkResult.mcpServers,
+    maxIterations: walkResult.mainLoop.maxIterations ?? walkResult.agentConfig.maxIterations,
+    timeoutMs: walkResult.mainLoop.timeoutMs ?? walkResult.agentConfig.timeoutMs,
+    stream: walkResult.agentConfig.stream ?? true
+  };
+}
+__name(compileAgent, "compileAgent");
+
+// src/bridge/agent-sse-handler.ts
+var encoder = new TextEncoder();
+function streamAgentResponse(eventStream) {
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const event of eventStream) {
+          const data = JSON.stringify(event);
+          const frame = `event: ${event.type}
+data: ${data}
+
+`;
+          controller.enqueue(encoder.encode(frame));
+        }
+      } catch (err) {
+        const errorEvent = {
+          type: "error",
+          error: {
+            message: err instanceof Error ? err.message : "Internal agent error"
+          }
+        };
+        const frame = `event: error
+data: ${JSON.stringify(errorEvent)}
+
+`;
+        controller.enqueue(encoder.encode(frame));
+      } finally {
+        controller.close();
+      }
+    }
+  });
+  return new Response(stream, {
+    status: 200,
+    headers: {
+      "content-type": "text/event-stream",
+      "cache-control": "no-cache",
+      "connection": "keep-alive"
+    }
+  });
+}
+__name(streamAgentResponse, "streamAgentResponse");
+
+// src/bridge/agent-stream-events.ts
+function isTextDelta(e) {
+  return e.type === "text_delta";
+}
+__name(isTextDelta, "isTextDelta");
+function isToolCall(e) {
+  return e.type === "tool_call";
+}
+__name(isToolCall, "isToolCall");
+function isToolResult(e) {
+  return e.type === "tool_result";
+}
+__name(isToolResult, "isToolResult");
+function isDone(e) {
+  return e.type === "done";
+}
+__name(isDone, "isDone");
+function isError(e) {
+  return e.type === "error";
+}
+__name(isError, "isError");
+function isApprovalRequired(e) {
+  return e.type === "approval_required";
+}
+__name(isApprovalRequired, "isApprovalRequired");
+
+// src/bridge/agent-route-generator.ts
+function generateAgentRoutes(ctx) {
+  const { walkResult, createRun, getRun } = ctx;
+  const basePath = walkResult.route.replace(/\/$/, "");
+  const routes = [];
+  routes.push({
+    method: "POST",
+    path: `${basePath}/chat`,
+    handler: /* @__PURE__ */ __name(async (request) => {
+      let body = null;
+      try {
+        body = await request.json();
+      } catch {
+      }
+      const message = body?.message;
+      if (typeof message !== "string" || message.length === 0) {
+        return new Response(JSON.stringify({
+          error: {
+            code: "BAD_REQUEST",
+            message: "message field required"
+          }
+        }), {
+          status: 400,
+          headers: {
+            "content-type": "application/json"
+          }
+        });
+      }
+      const sessionId = body?.sessionId ?? `session-${Date.now()}`;
+      return streamAgentResponse(createRun(message, sessionId));
+    }, "handler")
+  });
+  if (getRun) {
+    routes.push({
+      method: "GET",
+      path: `${basePath}/runs/:runId`,
+      handler: /* @__PURE__ */ __name(async (request) => {
+        const url = new URL(request.url);
+        const runId = url.pathname.split("/").pop() ?? "";
+        const run = await getRun(runId);
+        if (!run) {
+          return new Response(JSON.stringify({
+            error: {
+              code: "NOT_FOUND",
+              message: `Run ${runId} not found`
+            }
+          }), {
+            status: 404,
+            headers: {
+              "content-type": "application/json"
+            }
+          });
+        }
+        return new Response(JSON.stringify(run), {
+          status: 200,
+          headers: {
+            "content-type": "application/json"
+          }
+        });
+      }, "handler")
+    });
+  }
+  return routes;
+}
+__name(generateAgentRoutes, "generateAgentRoutes");
+
+// src/manifest/agent-manifest.ts
+function generateAgentManifest(walkResults) {
+  return {
+    version: "1.0",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    agents: walkResults.map((r) => ({
+      name: r.agentConfig.name,
+      route: r.route,
+      model: r.agentConfig.model,
+      stream: r.agentConfig.stream ?? true,
+      mainLoop: {
+        method: String(r.mainLoop.propertyKey),
+        strategy: r.mainLoop.strategy
+      },
+      guards: r.guards.map((g) => g.name),
+      interceptors: r.interceptors.map((i) => i.name),
+      tools: r.toolboxes.flatMap((tb) => tb.tools.map((t) => ({
+        name: tb.namespace ? `${tb.namespace}.${t.config.name}` : t.config.name,
+        description: t.config.description,
+        risk: t.config.risk,
+        approval: t.approval !== void 0,
+        capabilities: t.capabilities,
+        trace: t.trace,
+        audit: t.audit
+      }))),
+      gateway: r.gateway ? {
+        platforms: r.gateway.platforms,
+        sessionStrategy: r.gateway.sessionStrategy ?? "per-user"
+      } : void 0,
+      subAgents: r.subAgentClasses.map((cls) => cls.name),
+      memory: r.memory ? {
+        provider: r.memory.provider ?? "built-in",
+        embeddings: r.memory.embeddings ?? false,
+        fts: r.memory.fts ?? false,
+        scope: r.memory.scope ?? "per-user"
+      } : void 0,
+      skills: r.skills?.include,
+      mcpServers: r.mcpServers ? Object.keys(r.mcpServers) : void 0
+    }))
+  };
+}
+__name(generateAgentManifest, "generateAgentManifest");
+
+// src/theokit-plugin.ts
+import "reflect-metadata";
+function agentsPlugin(opts) {
+  let routes = null;
+  return {
+    name: "@theokit/agents",
+    register(app) {
+      app.addHook("onRequest", async (pluginCtx) => {
+        if (!routes) routes = initRoutes(opts);
+        const request = pluginCtx.request;
+        const url = new URL(request.url);
+        const method = request.method.toUpperCase();
+        const matched = matchRoute(routes, method, url.pathname);
+        if (!matched) return;
+        return matched.handler(request);
+      });
+    }
+  };
+}
+__name(agentsPlugin, "agentsPlugin");
+function initRoutes(opts) {
+  const allRoutes = [];
+  const walkResults = [];
+  for (const AgentClass of opts.agents) {
+    const mixins = getMixins(AgentClass);
+    const toolboxes = [
+      ...opts.toolboxes ?? [],
+      ...mixins
+    ];
+    const walkResult = walkAgentMetadata(AgentClass, toolboxes);
+    walkResults.push(walkResult);
+    const compiled = compileAgent(walkResult, /* @__PURE__ */ new Map());
+    const createRun = opts.createRunFactory ? opts.createRunFactory(compiled, walkResult) : defaultCreateRun(compiled);
+    const agentRoutes = generateAgentRoutes({
+      walkResult,
+      compiledOptions: compiled,
+      createRun
+    });
+    allRoutes.push(...agentRoutes);
+  }
+  validateUniqueRoutes(walkResults);
+  return allRoutes;
+}
+__name(initRoutes, "initRoutes");
+function defaultCreateRun(compiled) {
+  return async function* (_message, _sessionId) {
+    yield {
+      type: "run_started",
+      runId: `run-${Date.now()}`,
+      agentName: compiled.model ?? "unknown"
+    };
+    yield {
+      type: "error",
+      code: "SDK_NOT_WIRED",
+      message: "No createRunFactory provided \u2014 wire @theokit/sdk Agent.create() to enable real agent execution.",
+      retryable: false
+    };
+  };
+}
+__name(defaultCreateRun, "defaultCreateRun");
+function matchRoute(routes, method, pathname) {
+  return routes.find((r) => {
+    if (r.method !== method) return false;
+    if (r.path.includes(":")) {
+      const pattern = r.path.replace(/:[^/]+/g, "[^/]+");
+      return new RegExp(`^${pattern}$`).test(pathname);
+    }
+    return r.path === pathname;
+  });
+}
+__name(matchRoute, "matchRoute");
+
+export {
+  createAgentExecutionContext,
+  isAgentContext,
+  walkAgentMetadata,
+  validateUniqueRoutes,
+  compileTools,
+  compileAgent,
+  streamAgentResponse,
+  isTextDelta,
+  isToolCall,
+  isToolResult,
+  isDone,
+  isError,
+  isApprovalRequired,
+  generateAgentRoutes,
+  generateAgentManifest,
+  agentsPlugin
+};
+//# sourceMappingURL=chunk-YK76AQNU.js.map

package/dist/chunk-YK76AQNU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge/agent-execution-context.ts","../src/bridge/walk-agent-metadata.ts","../src/bridge/agent-compiler.ts","../src/bridge/agent-sse-handler.ts","../src/bridge/agent-stream-events.ts","../src/bridge/agent-route-generator.ts","../src/manifest/agent-manifest.ts","../src/theokit-plugin.ts"],"sourcesContent":["/**\n * AgentExecutionContext — extends http-decorators' ExecutionContext with agent-specific methods.\n *\n * Per ADR D2 (LSP): any guard that accepts ExecutionContext works unchanged with\n * AgentExecutionContext. Agent-specific guards can narrow via isAgentContext().\n */\nimport type { ExecutionContext } from '@theokit/http-decorators'\n\nimport type { AgentOptions, ToolOptions } from '../types.js'\n\nexport interface AgentRunInfo {\n  id: string\n  startedAt: Date\n}\n\nexport interface AgentExecutionContext extends ExecutionContext {\n  /** The agent's configuration from @Agent() decorator. */\n  getAgent(): AgentOptions\n  /** The current run information. */\n  getRun(): AgentRunInfo\n  /** The tool being called, or null if in the main agent handler. */\n  getToolCall(): ToolOptions | null\n  /** Type guard — always true for AgentExecutionContext. */\n  isAgentContext(): true\n}\n\n/** Create an AgentExecutionContext from a base ExecutionContext + agent state. */\nexport function createAgentExecutionContext(\n  base: ExecutionContext,\n  agent: AgentOptions,\n  run: AgentRunInfo,\n  toolCall?: ToolOptions,\n): AgentExecutionContext {\n  return {\n    getRequest: () => base.getRequest(),\n    getUrl: () => base.getUrl(),\n    getClass: () => base.getClass(),\n    getMethodName: () => base.getMethodName(),\n    getAgent: () => agent,\n    getRun: () => run,\n    getToolCall: () => toolCall ?? null,\n    isAgentContext: () => true as const,\n  }\n}\n\n/** Narrow an ExecutionContext to AgentExecutionContext if it is one. */\nexport function isAgentContext(ctx: ExecutionContext): ctx is AgentExecutionContext {\n  return 'isAgentContext' in ctx && (ctx as AgentExecutionContext).isAgentContext()\n}\n","/**\n * Walk decorator metadata on agent + toolbox classes.\n * Mirrors http-decorators' walkControllerMetadata() pattern.\n *\n * EC-1: throws if @Agent class is missing @MainLoop.\n * EC-4: throws on duplicate routes across agents.\n */\nimport 'reflect-metadata'\nimport type { GatewayOptions } from '../decorators/gateway.js'\nimport { getGatewayConfig } from '../decorators/gateway.js'\nimport { RequiresApproval } from '../decorators/policies.js'\nimport { Trace, Audit } from '../decorators/observability.js'\nimport { Reflector } from '@theokit/http-decorators'\n\nconst reflectorInstance = new Reflector()\nimport { getMcpConfig } from '../decorators/mcp.js'\nimport type { McpServersMap } from '../decorators/mcp.js'\nimport { getMemoryConfig } from '../decorators/memory.js'\nimport type { MemoryOptions } from '../decorators/memory.js'\nimport { getSkillsConfig } from '../decorators/skills.js'\nimport type { SkillsOptions } from '../decorators/skills.js'\nimport { getSubAgents } from '../decorators/sub-agents.js'\nimport { getMeta } from '../metadata/index.js'\nimport { AGENT_CONFIG, AGENT_MAIN_LOOP, TOOLBOX_CONFIG, TOOL_CONFIG, TOOL_METHODS } from '../metadata/keys.js'\nimport type {\n  AgentOptions,\n  MainLoopMeta,\n  ToolboxOptions,\n  ToolOptions,\n  ApprovalOptions,\n  BudgetOptions,\n} from '../types.js'\n\n// http-decorators metadata keys for pipeline reuse\nconst USE_GUARDS = Symbol.for('theokit:http-decorators:use-guards')\nconst USE_INTERCEPTORS = Symbol.for('theokit:http-decorators:use-interceptors')\nconst USE_FILTERS = Symbol.for('theokit:http-decorators:use-filters')\n\nexport interface AgentWalkResult {\n  agentConfig: AgentOptions\n  mainLoop: MainLoopMeta\n  toolboxes: ToolboxWalkResult[]\n  guards: Function[]\n  interceptors: Function[]\n  filters: Function[]\n  route: string\n  gateway?: GatewayOptions\n  subAgentClasses: Function[]\n  memory?: MemoryOptions\n  skills?: SkillsOptions\n  mcpServers?: McpServersMap\n}\n\nexport interface ToolboxWalkResult {\n  class: Function\n  namespace: string\n  tools: ToolWalkResult[]\n  guards: Function[]\n}\n\nexport interface ToolWalkResult {\n  propertyKey: string | symbol\n  config: ToolOptions\n  guards: Function[]\n  approval?: ApprovalOptions\n  capabilities?: string[]\n  budget?: BudgetOptions\n  trace: boolean\n  audit: boolean\n}\n\n/** Read a createDecorator-style metadata value by searching for its Symbol key. */\nfunction readTypedMeta<T>(target: Function, propertyKey?: string | symbol): T | undefined {\n  // createDecorator uses Symbol.for(`theokit:custom:${counter}`)\n  // We read via Reflect.getMetadataKeys and filter\n  const keys = propertyKey !== undefined\n    ? Reflect.getMetadataKeys(target, propertyKey)\n    : Reflect.getMetadataKeys(target)\n\n  for (const key of keys) {\n    if (typeof key === 'symbol') {\n      const desc = Symbol.keyFor(key)\n      if (desc?.startsWith('theokit:custom:')) {\n        const value = propertyKey !== undefined\n          ? Reflect.getMetadata(key, target, propertyKey)\n          : Reflect.getMetadata(key, target)\n        if (value !== undefined) return value as T\n      }\n    }\n  }\n  return undefined\n}\n\nfunction walkToolbox(ToolboxClass: Function): ToolboxWalkResult {\n  const config = getMeta<ToolboxOptions>(TOOLBOX_CONFIG, ToolboxClass) ?? {}\n  const methods = getMeta<(string | symbol)[]>(TOOL_METHODS, ToolboxClass) ?? []\n  const classGuards = getMeta<Function[]>(USE_GUARDS, ToolboxClass) ?? []\n\n  const tools: ToolWalkResult[] = methods.map((propertyKey) => {\n    const toolConfig = getMeta<ToolOptions>(TOOL_CONFIG, ToolboxClass, propertyKey)\n    if (!toolConfig) {\n      throw new Error(\n        `[@theokit/agents] Toolbox ${ToolboxClass.name}: method '${String(propertyKey)}' is in TOOL_METHODS but has no @Tool() config.`,\n      )\n    }\n\n    const methodGuards = getMeta<Function[]>(USE_GUARDS, ToolboxClass, propertyKey) ?? []\n\n    // Read typed decorator metadata via Reflector (not generic readTypedMeta)\n    const ref = reflectorInstance\n\n    const approvalVal = ref.get(RequiresApproval, ToolboxClass, propertyKey)\n    const traceVal = ref.get(Trace, ToolboxClass, propertyKey)\n    const auditVal = ref.get(Audit, ToolboxClass, propertyKey)\n\n    return {\n      propertyKey,\n      config: toolConfig,\n      guards: [...classGuards, ...methodGuards],\n      approval: approvalVal && typeof approvalVal === 'object' && 'reason' in approvalVal ? approvalVal : undefined,\n      capabilities: undefined, // read via RequiresCapability when needed\n      budget: undefined, // read via Budget when needed\n      trace: traceVal ?? false,\n      audit: auditVal ?? false,\n    }\n  })\n\n  return {\n    class: ToolboxClass,\n    namespace: config.namespace ?? '',\n    tools,\n    guards: classGuards,\n  }\n}\n\n/** WeakMap cache — metadata is immutable; walk once per class. */\nconst agentWalkCache = new WeakMap<Function, AgentWalkResult>()\n\n/**\n * Walk all metadata on an agent class and its toolboxes.\n * Memoized per AgentClass via WeakMap.\n *\n * @throws Error if @Agent is missing @MainLoop (EC-1)\n */\nexport function walkAgentMetadata(\n  AgentClass: Function,\n  toolboxClasses: Function[] = [],\n): AgentWalkResult {\n  // Cache key is AgentClass only (toolboxes are typically stable per agent)\n  if (toolboxClasses.length === 0) {\n    const cached = agentWalkCache.get(AgentClass)\n    if (cached) return cached\n  }\n  const agentConfig = getMeta<AgentOptions>(AGENT_CONFIG, AgentClass)\n  if (!agentConfig) {\n    throw new Error(\n      `[@theokit/agents] Class ${AgentClass.name} is missing @Agent() decorator.`,\n    )\n  }\n\n  const mainLoop = getMeta<MainLoopMeta>(AGENT_MAIN_LOOP, AgentClass)\n  if (!mainLoop) {\n    throw new Error(\n      `[@theokit/agents] Agent ${AgentClass.name} is missing @MainLoop() decorator. ` +\n        `Decorate exactly one method with @MainLoop().`,\n    )\n  }\n\n  const guards = getMeta<Function[]>(USE_GUARDS, AgentClass) ?? []\n  const interceptors = getMeta<Function[]>(USE_INTERCEPTORS, AgentClass) ?? []\n  const filters = getMeta<Function[]>(USE_FILTERS, AgentClass) ?? []\n\n  const toolboxes = toolboxClasses.map(walkToolbox)\n  const gateway = getGatewayConfig(AgentClass)\n  const subAgentClasses = getSubAgents(AgentClass)\n  const memory = getMemoryConfig(AgentClass)\n  const skills = getSkillsConfig(AgentClass)\n  const mcpServers = getMcpConfig(AgentClass)\n\n  const result: AgentWalkResult = {\n    agentConfig,\n    mainLoop,\n    toolboxes,\n    guards,\n    interceptors,\n    filters,\n    route: agentConfig.route,\n    gateway,\n    subAgentClasses,\n    memory,\n    skills,\n    mcpServers,\n  }\n\n  if (toolboxClasses.length === 0) {\n    agentWalkCache.set(AgentClass, result)\n  }\n  return result\n}\n\n/**\n * Validate that no two agents share the same route prefix.\n *\n * @throws Error on duplicate routes (EC-4)\n */\nexport function validateUniqueRoutes(results: AgentWalkResult[]): void {\n  const seen = new Map<string, string>()\n  for (const r of results) {\n    const existing = seen.get(r.route)\n    if (existing) {\n      throw new Error(\n        `[@theokit/agents] Duplicate agent route '${r.route}': ` +\n          `both '${existing}' and '${r.agentConfig.name}' declare it.`,\n      )\n    }\n    seen.set(r.route, r.agentConfig.name)\n  }\n}\n","/**\n * Agent compiler — transforms decorator metadata into SDK calls.\n *\n * Per ADR D1: @Agent is a macro over Agent.create().\n * Per ADR D3: @Tool compiles to defineTool().\n *\n * EC-3: throws if toolbox instance is missing from the instances map.\n */\nimport { getAgentConfig } from '../decorators/agent.js'\nimport type { McpServersMap } from '../decorators/mcp.js'\nimport type { MemoryOptions } from '../decorators/memory.js'\nimport type { SkillsOptions } from '../decorators/skills.js'\n\nimport type { ToolboxWalkResult, AgentWalkResult } from './walk-agent-metadata.js'\n\n/** Minimal interface matching defineTool() result shape. */\nexport interface CompiledTool {\n  name: string\n  description: string\n  inputSchema: unknown\n  handler: (input: unknown) => string | Promise<string>\n}\n\n/**\n * Compile @Tool metadata into tool definitions.\n *\n * @param toolboxes - Walked toolbox metadata\n * @param toolboxInstances - Map of Toolbox class → instantiated object (for `this` binding)\n */\nexport function compileTools(\n  toolboxes: ToolboxWalkResult[],\n  toolboxInstances: Map<Function, object>,\n): CompiledTool[] {\n  const tools: CompiledTool[] = []\n\n  for (const tb of toolboxes) {\n    // EC-3: guard against missing toolbox instance\n    const instance = toolboxInstances.get(tb.class)\n    if (!instance) {\n      throw new Error(\n        `[@theokit/agents] Toolbox ${tb.class.name} not instantiated — add to providers or pass instances.`,\n      )\n    }\n\n    for (const tool of tb.tools) {\n      const handler = (instance as Record<string | symbol, Function>)[tool.propertyKey]\n      if (typeof handler !== 'function') {\n        throw new Error(\n          `[@theokit/agents] Toolbox ${tb.class.name}: '${String(tool.propertyKey)}' is not a function.`,\n        )\n      }\n\n      const name = tb.namespace\n        ? `${tb.namespace}.${tool.config.name}`\n        : tool.config.name\n\n      tools.push({\n        name,\n        description: tool.config.description,\n        inputSchema: tool.config.input,\n        handler: (input: unknown) => handler.call(instance, input) as string | Promise<string>,\n      })\n    }\n  }\n\n  return tools\n}\n\n/** Compiled sub-agent definition matching SDK AgentDefinition shape. */\nexport interface CompiledSubAgent {\n  model?: string\n  systemPrompt?: string\n}\n\n/** Compiled agent options ready for SDK Agent.create(). */\nexport interface CompiledAgentOptions {\n  model?: string\n  systemPrompt?: string\n  tools: CompiledTool[]\n  agents: Record<string, CompiledSubAgent>\n  memory?: MemoryOptions\n  skills?: SkillsOptions\n  mcpServers?: McpServersMap\n  maxIterations?: number\n  timeoutMs?: number\n  stream: boolean\n}\n\n/**\n * Compile @SubAgents references into SDK agents map.\n * Each sub-agent class must have @Agent() metadata.\n */\nexport function compileSubAgents(subAgentClasses: Function[]): Record<string, CompiledSubAgent> {\n  const agents: Record<string, CompiledSubAgent> = {}\n  for (const cls of subAgentClasses) {\n    const config = getAgentConfig(cls)\n    if (!config) continue // validated at decoration time\n    agents[config.name] = {\n      model: config.model,\n      systemPrompt: config.systemPrompt,\n    }\n  }\n  return agents\n}\n\n/**\n * Compile @Agent metadata into SDK-compatible options.\n *\n * EC-7: agents without toolboxes produce tools: [].\n */\nexport function compileAgent(\n  walkResult: AgentWalkResult,\n  toolboxInstances = new Map<Function, object>(),\n): CompiledAgentOptions {\n  const tools = compileTools(walkResult.toolboxes, toolboxInstances)\n  const agents = compileSubAgents(walkResult.subAgentClasses)\n\n  return {\n    model: walkResult.agentConfig.model,\n    systemPrompt: walkResult.agentConfig.systemPrompt,\n    tools,\n    agents,\n    memory: walkResult.memory,\n    skills: walkResult.skills,\n    mcpServers: walkResult.mcpServers,\n    maxIterations: walkResult.mainLoop.maxIterations ?? walkResult.agentConfig.maxIterations,\n    timeoutMs: walkResult.mainLoop.timeoutMs ?? walkResult.agentConfig.timeoutMs,\n    stream: walkResult.agentConfig.stream ?? true,\n  }\n}\n","/**\n * SSE streaming handler — Web Standard Response with ReadableStream.\n *\n * Per ADR D4: SSE is the v1 transport.\n * Per EC-2: uses ReadableStream with controller.enqueue() instead of res.write().\n * Works natively on Node, Bun, Deno, CF Workers.\n */\n\n/** Minimal event shape matching SDK's SDKMessage discriminated union. */\nexport interface StreamEvent {\n  type: string\n  [key: string]: unknown\n}\n\nconst encoder = new TextEncoder()\n\n/**\n * Create a Web Standard Response that streams SSE events.\n * Each event becomes: `event: {type}\\ndata: {json}\\n\\n`\n */\nexport function streamAgentResponse(\n  eventStream: AsyncIterable<StreamEvent>,\n): Response {\n  const stream = new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const event of eventStream) {\n          const data = JSON.stringify(event)\n          const frame = `event: ${event.type}\\ndata: ${data}\\n\\n`\n          controller.enqueue(encoder.encode(frame))\n        }\n      } catch (err) {\n        const errorEvent = {\n          type: 'error',\n          error: { message: err instanceof Error ? err.message : 'Internal agent error' },\n        }\n        const frame = `event: error\\ndata: ${JSON.stringify(errorEvent)}\\n\\n`\n        controller.enqueue(encoder.encode(frame))\n      } finally {\n        controller.close()\n      }\n    },\n  })\n\n  return new Response(stream, {\n    status: 200,\n    headers: {\n      'content-type': 'text/event-stream',\n      'cache-control': 'no-cache',\n      'connection': 'keep-alive',\n    },\n  })\n}\n","/**\n * Typed discriminated union for agent SSE stream events.\n *\n * Every event has a `type` field for discrimination.\n * Clients narrow via `if (event.type === 'text_delta') event.content`.\n */\n\n/** Partial text content from the LLM. */\nexport interface TextDeltaEvent {\n  type: 'text_delta'\n  content: string\n}\n\n/** Agent started a tool call. */\nexport interface ToolCallEvent {\n  type: 'tool_call'\n  callId: string\n  toolName: string\n  input: unknown\n}\n\n/** Tool execution completed. */\nexport interface ToolResultEvent {\n  type: 'tool_result'\n  callId: string\n  toolName: string\n  output: string\n  durationMs: number\n  isError: boolean\n}\n\n/** Extended thinking / reasoning (when model supports it). */\nexport interface ThinkingEvent {\n  type: 'thinking'\n  content: string\n}\n\n/** Agent loop iteration. */\nexport interface IterationEvent {\n  type: 'iteration'\n  step: number\n  totalSteps: number | null\n}\n\n/** Human approval required before proceeding. */\nexport interface ApprovalRequiredEvent {\n  type: 'approval_required'\n  callId: string\n  toolName: string\n  question: string\n  input?: unknown\n  callbackUrl: string\n  timeoutMs: number\n}\n\n/** Agent encountered an error. */\nexport interface ErrorEvent {\n  type: 'error'\n  code: string\n  message: string\n  retryable: boolean\n}\n\n/** Agent completed with a final result. */\nexport interface DoneEvent {\n  type: 'done'\n  result: string\n  usage: {\n    inputTokens: number\n    outputTokens: number\n    totalTokens: number\n  }\n  durationMs: number\n}\n\n/** Agent run started. */\nexport interface RunStartedEvent {\n  type: 'run_started'\n  runId: string\n  agentName: string\n  model?: string\n}\n\n/** Artifact generation started (code, document, diagram). */\nexport interface ArtifactStartEvent {\n  type: 'artifact_start'\n  artifactId: string\n  mimeType: string\n  filename?: string\n  metadata?: Record<string, unknown>\n}\n\n/** Artifact content chunk (streamable artifacts). */\nexport interface ArtifactChunkEvent {\n  type: 'artifact_chunk'\n  artifactId: string\n  chunk: string\n  isLast: boolean\n}\n\n/** Real-time state update from @Observable channels. */\nexport interface StateUpdateEvent {\n  type: 'state_update'\n  channel: string\n  data: unknown\n}\n\n/** Checkpoint saved (resumable agents). */\nexport interface CheckpointSavedEvent {\n  type: 'checkpoint_saved'\n  checkpointId: string\n  step: number\n  resumeToken: string\n}\n\n/** File edit produced by a code assistant tool. */\nexport interface FileEditEvent {\n  type: 'file_edit'\n  file: string\n  format: 'search-replace' | 'unified-diff' | 'full-file' | 'line-range'\n  search?: string\n  replace?: string\n  content?: string\n  diff?: string\n  startLine?: number\n  endLine?: number\n}\n\n/** Discriminated union of all agent stream events. */\nexport type AgentStreamEvent =\n  | RunStartedEvent\n  | TextDeltaEvent\n  | ToolCallEvent\n  | ToolResultEvent\n  | ThinkingEvent\n  | IterationEvent\n  | ApprovalRequiredEvent\n  | ArtifactStartEvent\n  | ArtifactChunkEvent\n  | StateUpdateEvent\n  | CheckpointSavedEvent\n  | FileEditEvent\n  | ErrorEvent\n  | DoneEvent\n\n/** Type guard helpers. */\nexport function isTextDelta(e: AgentStreamEvent): e is TextDeltaEvent { return e.type === 'text_delta' }\nexport function isToolCall(e: AgentStreamEvent): e is ToolCallEvent { return e.type === 'tool_call' }\nexport function isToolResult(e: AgentStreamEvent): e is ToolResultEvent { return e.type === 'tool_result' }\nexport function isDone(e: AgentStreamEvent): e is DoneEvent { return e.type === 'done' }\nexport function isError(e: AgentStreamEvent): e is ErrorEvent { return e.type === 'error' }\nexport function isApprovalRequired(e: AgentStreamEvent): e is ApprovalRequiredEvent { return e.type === 'approval_required' }\n","/**\n * Auto-generate HTTP routes from @Agent metadata — Web Standard.\n *\n * Per ADR D5: @Agent({ route }) auto-generates two endpoints:\n * - POST {route}/chat  — send message, receive SSE stream\n * - GET  {route}/runs/:runId — get run status/result\n *\n * Routes are convention-based, generated at registration time.\n */\nimport type { CompiledAgentOptions } from './agent-compiler.js'\nimport { streamAgentResponse, type StreamEvent } from './agent-sse-handler.js'\nimport type { AgentWalkResult } from './walk-agent-metadata.js'\n\nexport interface AgentRoute {\n  method: 'POST' | 'GET'\n  path: string\n  handler: (request: Request) => Promise<Response>\n}\n\nexport interface AgentRouteContext {\n  walkResult: AgentWalkResult\n  compiledOptions: CompiledAgentOptions\n  createRun: (message: string, sessionId: string) => AsyncIterable<StreamEvent>\n  getRun?: (runId: string) => Promise<{ id: string; status: string; result?: string } | null>\n}\n\n/** Generate HTTP routes for a single agent. Returns Web Standard handlers. */\nexport function generateAgentRoutes(ctx: AgentRouteContext): AgentRoute[] {\n  const { walkResult, createRun, getRun } = ctx\n  const basePath = walkResult.route.replace(/\\/$/, '')\n  const routes: AgentRoute[] = []\n\n  routes.push({\n    method: 'POST',\n    path: `${basePath}/chat`,\n    handler: async (request) => {\n      let body: Record<string, unknown> | null = null\n      try { body = await request.json() as Record<string, unknown> } catch { /* empty */ }\n\n      const message = body?.message\n      if (typeof message !== 'string' || message.length === 0) {\n        return new Response(\n          JSON.stringify({ error: { code: 'BAD_REQUEST', message: 'message field required' } }),\n          { status: 400, headers: { 'content-type': 'application/json' } },\n        )\n      }\n\n      const sessionId = (body?.sessionId as string) ?? `session-${Date.now()}`\n      return streamAgentResponse(createRun(message, sessionId))\n    },\n  })\n\n  if (getRun) {\n    routes.push({\n      method: 'GET',\n      path: `${basePath}/runs/:runId`,\n      handler: async (request) => {\n        const url = new URL(request.url)\n        const runId = url.pathname.split('/').pop() ?? ''\n        const run = await getRun(runId)\n        if (!run) {\n          return new Response(\n            JSON.stringify({ error: { code: 'NOT_FOUND', message: `Run ${runId} not found` } }),\n            { status: 404, headers: { 'content-type': 'application/json' } },\n          )\n        }\n        return new Response(JSON.stringify(run), { status: 200, headers: { 'content-type': 'application/json' } })\n      },\n    })\n  }\n\n  return routes\n}\n","/**\n * Agent manifest generator — build-time JSON describing all agents, tools, guards, policies.\n *\n * Feeds: theokit agents list/inspect, TheoCloud deploy, UI agent consoles.\n */\nimport type { AgentWalkResult } from '../bridge/walk-agent-metadata.js'\n\nexport interface AgentManifest {\n  version: '1.0'\n  generatedAt: string\n  agents: AgentManifestEntry[]\n}\n\nexport interface AgentManifestEntry {\n  name: string\n  route: string\n  model?: string\n  stream: boolean\n  mainLoop: {\n    method: string\n    strategy: string\n  }\n  guards: string[]\n  interceptors: string[]\n  tools: AgentManifestTool[]\n  gateway?: {\n    platforms: string[]\n    sessionStrategy: string\n  }\n  subAgents: string[]\n  memory?: { provider: string; embeddings: boolean; fts: boolean; scope: string }\n  skills?: string[]\n  mcpServers?: string[]\n}\n\nexport interface AgentManifestTool {\n  name: string\n  description: string\n  risk?: string\n  approval: boolean\n  capabilities?: string[]\n  trace: boolean\n  audit: boolean\n}\n\n/**\n * Generate a serializable agent manifest from walked metadata.\n * All Function references are converted to string names for JSON safety.\n */\nexport function generateAgentManifest(walkResults: AgentWalkResult[]): AgentManifest {\n  return {\n    version: '1.0',\n    generatedAt: new Date().toISOString(),\n    agents: walkResults.map((r) => ({\n      name: r.agentConfig.name,\n      route: r.route,\n      model: r.agentConfig.model,\n      stream: r.agentConfig.stream ?? true,\n      mainLoop: {\n        method: String(r.mainLoop.propertyKey),\n        strategy: r.mainLoop.strategy,\n      },\n      guards: r.guards.map((g) => g.name),\n      interceptors: r.interceptors.map((i) => i.name),\n      tools: r.toolboxes.flatMap((tb) =>\n        tb.tools.map((t) => ({\n          name: tb.namespace ? `${tb.namespace}.${t.config.name}` : t.config.name,\n          description: t.config.description,\n          risk: t.config.risk,\n          approval: t.approval !== undefined,\n          capabilities: t.capabilities,\n          trace: t.trace,\n          audit: t.audit,\n        })),\n      ),\n      gateway: r.gateway\n        ? { platforms: r.gateway.platforms, sessionStrategy: r.gateway.sessionStrategy ?? 'per-user' }\n        : undefined,\n      subAgents: r.subAgentClasses.map((cls) => cls.name),\n      memory: r.memory\n        ? {\n            provider: r.memory.provider ?? 'built-in',\n            embeddings: r.memory.embeddings ?? false,\n            fts: r.memory.fts ?? false,\n            scope: r.memory.scope ?? 'per-user',\n          }\n        : undefined,\n      skills: r.skills?.include,\n      mcpServers: r.mcpServers ? Object.keys(r.mcpServers) : undefined,\n    })),\n  }\n}\n","/**\n * agentsPlugin() — TheoKit dev-server plugin for agent routes.\n *\n * Mirrors httpDecoratorsPlugin() pattern. Registers agent HTTP endpoints\n * (POST /chat, GET /runs/:id) via the TheoKit plugin hook system.\n *\n * Per ADR D6: structural { name, register } shape (no compile-time theokit dep).\n */\nimport 'reflect-metadata'\n\nimport { compileAgent, type CompiledAgentOptions } from './bridge/agent-compiler.js'\nimport { generateAgentRoutes, type AgentRoute } from './bridge/agent-route-generator.js'\nimport type { StreamEvent } from './bridge/agent-sse-handler.js'\nimport { walkAgentMetadata, validateUniqueRoutes, type AgentWalkResult } from './bridge/walk-agent-metadata.js'\nimport { getMixins } from './decorators/mixin.js'\n\nexport interface AgentsPluginOptions {\n  /** Agent classes decorated with @Agent(). */\n  agents: Function[]\n  /** Toolbox classes (or use @Mixin on agents). */\n  toolboxes?: Function[]\n  /** Factory that creates agent runs — bridges to SDK Agent.create() + agent.send(). */\n  createRunFactory?: (compiled: CompiledAgentOptions, walkResult: AgentWalkResult) =>\n    (message: string, sessionId: string) => AsyncIterable<StreamEvent>\n}\n\ninterface PluginApp {\n  addHook(name: string, fn: (ctx: { request: Request }) => Promise<Response | void>): void\n}\n\n/**\n * Create a TheoKit plugin that mounts agent routes.\n * Web Standard Request/Response — runtime-agnostic.\n */\nexport function agentsPlugin(opts: AgentsPluginOptions) {\n  let routes: AgentRoute[] | null = null\n\n  return {\n    name: '@theokit/agents',\n\n    register(app: PluginApp) {\n      app.addHook('onRequest', async (pluginCtx) => {\n        if (!routes) routes = initRoutes(opts)\n\n        const request = pluginCtx.request\n        const url = new URL(request.url)\n        const method = request.method.toUpperCase()\n\n        const matched = matchRoute(routes, method, url.pathname)\n        if (!matched) return // fall through\n\n        return matched.handler(request)\n      })\n    },\n  }\n}\n\n/** Initialize routes from agent metadata (once). */\nfunction initRoutes(opts: AgentsPluginOptions): AgentRoute[] {\n  const allRoutes: AgentRoute[] = []\n  const walkResults: AgentWalkResult[] = []\n\n  for (const AgentClass of opts.agents) {\n    // Resolve toolboxes: explicit + @Mixin\n    const mixins = getMixins(AgentClass)\n    const toolboxes = [...(opts.toolboxes ?? []), ...mixins]\n\n    const walkResult = walkAgentMetadata(AgentClass, toolboxes)\n    walkResults.push(walkResult)\n\n    const compiled = compileAgent(walkResult, new Map())\n    const createRun = opts.createRunFactory\n      ? opts.createRunFactory(compiled, walkResult)\n      : defaultCreateRun(compiled)\n\n    const agentRoutes = generateAgentRoutes({\n      walkResult,\n      compiledOptions: compiled,\n      createRun,\n    })\n\n    allRoutes.push(...agentRoutes)\n  }\n\n  validateUniqueRoutes(walkResults)\n  return allRoutes\n}\n\n/** Default run factory — returns a mock stream when SDK not wired. */\nfunction defaultCreateRun(compiled: CompiledAgentOptions) {\n  return async function* (_message: string, _sessionId: string): AsyncGenerator<StreamEvent> {\n    yield {\n      type: 'run_started',\n      runId: `run-${Date.now()}`,\n      agentName: compiled.model ?? 'unknown',\n    }\n    yield {\n      type: 'error',\n      code: 'SDK_NOT_WIRED',\n      message: 'No createRunFactory provided — wire @theokit/sdk Agent.create() to enable real agent execution.',\n      retryable: false,\n    }\n  }\n}\n\n/** Simple route matcher — checks method + path prefix. */\nfunction matchRoute(routes: AgentRoute[], method: string, pathname: string): AgentRoute | undefined {\n  return routes.find((r) => {\n    if (r.method !== method) return false\n    // Handle :param patterns\n    if (r.path.includes(':')) {\n      const pattern = r.path.replace(/:[^/]+/g, '[^/]+')\n      return new RegExp(`^${pattern}$`).test(pathname)\n    }\n    return r.path === pathname\n  })\n}\n"],"mappings":"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","names":["createAgentExecutionContext","base","agent","run","toolCall","getRequest","getUrl","getClass","getMethodName","getAgent","getRun","getToolCall","isAgentContext","ctx","Reflector","reflectorInstance","Reflector","USE_GUARDS","Symbol","for","USE_INTERCEPTORS","USE_FILTERS","walkToolbox","ToolboxClass","config","getMeta","TOOLBOX_CONFIG","methods","TOOL_METHODS","classGuards","USE_GUARDS","tools","map","propertyKey","toolConfig","TOOL_CONFIG","Error","name","String","methodGuards","ref","reflectorInstance","approvalVal","get","RequiresApproval","traceVal","Trace","auditVal","Audit","guards","approval","undefined","capabilities","budget","trace","audit","class","namespace","agentWalkCache","WeakMap","walkAgentMetadata","AgentClass","toolboxClasses","length","cached","agentConfig","AGENT_CONFIG","mainLoop","AGENT_MAIN_LOOP","interceptors","USE_INTERCEPTORS","filters","USE_FILTERS","toolboxes","gateway","getGatewayConfig","subAgentClasses","getSubAgents","memory","getMemoryConfig","skills","getSkillsConfig","mcpServers","getMcpConfig","result","route","set","validateUniqueRoutes","results","seen","Map","r","existing","compileTools","toolboxes","toolboxInstances","tools","tb","instance","get","class","Error","name","tool","handler","propertyKey","String","namespace","config","push","description","inputSchema","input","call","compileSubAgents","subAgentClasses","agents","cls","getAgentConfig","model","systemPrompt","compileAgent","walkResult","Map","agentConfig","memory","skills","mcpServers","maxIterations","mainLoop","timeoutMs","stream","encoder","TextEncoder","streamAgentResponse","eventStream","stream","ReadableStream","start","controller","event","data","JSON","stringify","frame","type","enqueue","encode","err","errorEvent","error","message","Error","close","Response","status","headers","isTextDelta","e","type","isToolCall","isToolResult","isDone","isError","isApprovalRequired","generateAgentRoutes","ctx","walkResult","createRun","getRun","basePath","route","replace","routes","push","method","path","handler","request","body","json","message","length","Response","JSON","stringify","error","code","status","headers","sessionId","Date","now","streamAgentResponse","url","URL","runId","pathname","split","pop","run","generateAgentManifest","walkResults","version","generatedAt","Date","toISOString","agents","map","r","name","agentConfig","route","model","stream","mainLoop","method","String","propertyKey","strategy","guards","g","interceptors","i","tools","toolboxes","flatMap","tb","t","namespace","config","description","risk","approval","undefined","capabilities","trace","audit","gateway","platforms","sessionStrategy","subAgents","subAgentClasses","cls","memory","provider","embeddings","fts","scope","skills","include","mcpServers","Object","keys","agentsPlugin","opts","routes","name","register","app","addHook","pluginCtx","initRoutes","request","url","URL","method","toUpperCase","matched","matchRoute","pathname","handler","allRoutes","walkResults","AgentClass","agents","mixins","getMixins","toolboxes","walkResult","walkAgentMetadata","push","compiled","compileAgent","Map","createRun","createRunFactory","defaultCreateRun","agentRoutes","generateAgentRoutes","compiledOptions","validateUniqueRoutes","_message","_sessionId","type","runId","Date","now","agentName","model","code","message","retryable","find","r","path","includes","pattern","replace","RegExp","test"]}