@theokit/agents 0.6.0 → 0.8.0

package/dist/chunk-KTYBQ7HY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bridge/agent-execution-context.ts","../src/bridge/compile-context-window.ts","../src/bridge/compile-project-context.ts","../src/bridge/walk-agent-metadata.ts","../src/bridge/compile-skills.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/bridge/event-translator.ts","../src/bridge/sdk-adapter.ts","../src/loop/loop-strategy.ts","../src/loop/reflection-strategy.ts","../src/bridge/delegation-types.ts","../src/loop/run-reflective-loop.ts","../src/loop/agent-runner.ts","../src/bridge/agent-orchestrator.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'\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 * M8-1 — compile `@ContextWindow` metadata into the SDK's `ContextSettings`.\n *\n * Per sdk-runtime.md, the SDK owns session/transcript storage + compaction.\n * The bridge therefore maps the one knob the SDK natively exposes as a budget —\n * `maxTokens` → `ContextSettings.maxTokens` — and reports the strategy knobs that\n * have NO native `AgentOptions` equivalent (`compactionStrategy`, `preserveLastN`,\n * `preserveToolResults`, `preserveSystemPrompt`). Those are surfaced as\n * `metadataOnlyKnobs` so the walk can emit an honest `metadata-only` warning\n * (ADR D2) instead of silently dropping them (G10 — honest enforcement).\n */\nimport type { ContextSettings } from '@theokit/sdk'\n\nimport type { ContextWindowOptions } from '../decorators/context-window.js'\n\n/** `@ContextWindow` knobs with no native SDK `AgentOptions` mapping. */\nconst STRATEGY_KNOBS = [\n  'compactionStrategy',\n  'preserveLastN',\n  'preserveToolResults',\n  'preserveSystemPrompt',\n] as const\n\nexport interface CompiledContextWindow {\n  /** SDK-shaped context budget passed to `Agent.create({ context })`. */\n  context: ContextSettings\n  /** Declared knobs the SDK does not expose — reported, never silently dropped. */\n  metadataOnlyKnobs: string[]\n}\n\nexport function compileContextWindow(options: ContextWindowOptions): CompiledContextWindow {\n  const context: ContextSettings = {}\n  if (typeof options.maxTokens === 'number') {\n    context.maxTokens = options.maxTokens\n  }\n\n  const opts = options as Record<string, unknown>\n  const metadataOnlyKnobs = STRATEGY_KNOBS.filter((knob) => opts[knob] !== undefined)\n\n  return { context, metadataOnlyKnobs }\n}\n","/**\n * M8-2 — compile `@ProjectContext` metadata into an SDK `SystemPromptResolver`.\n *\n * There is no native `AgentOptions` field that carries a repo map, so the bridge\n * composes the documented `systemPrompt` seam (`string | SystemPromptResolver`):\n * the resolver prepends `buildEnvContext` + `buildRepoMap` (`@theokit/sdk-tools`)\n * and the nearest `THEO.md` (`@theokit/sdk/project#readProjectInstructions`) to\n * the agent's base prompt (ADR D3). The SDK primitives are dynamically imported\n * so `@theokit/sdk-tools` stays an OPTIONAL peer — only loaded when a `@ProjectContext`\n * agent actually sends.\n *\n * Knobs with no primitive mapping (`indexStrategy`, `relevanceStrategy`,\n * `maxFilesInContext`, `includeExtensions`, `rootMarkers`) are reported via\n * {@link projectContextMetadataOnlyKnobs} so the walk warns honestly (G10).\n * Only `ignorePatterns` is forwarded (to `buildRepoMap`).\n */\nimport type { SystemPromptResolver } from '@theokit/sdk'\n\nimport type { ProjectContextOptions } from '../decorators/project-context.js'\n\n/** `@ProjectContext` knobs with no primitive mapping (reported, not executed). */\nconst UNMAPPED_KNOBS = [\n  'indexStrategy',\n  'relevanceStrategy',\n  'maxFilesInContext',\n  'includeExtensions',\n  'rootMarkers',\n] as const\n\nexport function projectContextMetadataOnlyKnobs(options: ProjectContextOptions): string[] {\n  const opts = options as Record<string, unknown>\n  return UNMAPPED_KNOBS.filter((knob) => opts[knob] !== undefined)\n}\n\n/**\n * Build a `SystemPromptResolver` that prepends env + repo map + project\n * instructions to `base`. When the SDK provides no `cwd`, the resolver returns\n * `base` unchanged (no filesystem guess — keeps `packages/agents/src` free of\n * direct Node `process` access per G8; the repo map needs a real cwd).\n */\nexport function compileProjectContext(\n  options: ProjectContextOptions,\n  base?: string,\n): SystemPromptResolver {\n  return async (promptCtx) => {\n    const cwd = promptCtx.cwd\n    if (!cwd) {\n      return base ?? ''\n    }\n\n    const { buildEnvContext, buildRepoMap } = await import('@theokit/sdk-tools')\n    const { readProjectInstructions } = await import('@theokit/sdk/project')\n\n    const env = buildEnvContext(cwd)\n    const repoMap = buildRepoMap(cwd, { ignore: options.ignorePatterns })\n\n    let instructions = ''\n    try {\n      instructions = (await readProjectInstructions(cwd)).content ?? ''\n    } catch {\n      // readProjectInstructions is best-effort: a missing/unreadable THEO.md must\n      // never break a send. buildEnvContext/buildRepoMap are never-throw by contract.\n      instructions = ''\n    }\n\n    return [env, repoMap, instructions, base].filter(Boolean).join('\\n\\n')\n  }\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'\n\nimport { Reflector } from '@theokit/http'\n\nimport { getContextWindowConfig } from '../decorators/context-window.js'\nimport type { ContextWindowOptions } from '../decorators/context-window.js'\nimport type { GatewayOptions } from '../decorators/gateway.js'\nimport { getGatewayConfig } from '../decorators/gateway.js'\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 { Trace, Audit } from '../decorators/observability.js'\nimport { RequiresApproval, Budget } from '../decorators/policies.js'\nimport type { ProjectContextOptions } from '../decorators/project-context.js'\nimport { getProjectContextConfig } from '../decorators/project-context.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 {\n  AGENT_CONFIG,\n  AGENT_MAIN_LOOP,\n  TOOLBOX_CONFIG,\n  TOOL_CONFIG,\n  TOOL_METHODS,\n} from '../metadata/keys.js'\nimport type {\n  AgentOptions,\n  MainLoopMeta,\n  ToolboxOptions,\n  ToolOptions,\n  ApprovalOptions,\n  BudgetOptions,\n} from '../types.js'\n\nimport { compileContextWindow } from './compile-context-window.js'\nimport { projectContextMetadataOnlyKnobs } from './compile-project-context.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\n/**\n * Stable warning codes for agent pipeline metadata-only decorators.\n * Test by code, not by message string. Document in agent support matrix.\n */\nexport const AgentWarningCode = {\n  INTERCEPTOR_METADATA_ONLY: 'THEO_AGENT_INTERCEPTOR_METADATA_ONLY',\n  FILTER_METADATA_ONLY: 'THEO_AGENT_FILTER_METADATA_ONLY',\n  BUDGET_TOP_LEVEL_METADATA_ONLY: 'THEO_AGENT_BUDGET_TOP_LEVEL_METADATA_ONLY',\n  CONTEXT_STRATEGY_METADATA_ONLY: 'THEO_AGENT_CONTEXT_STRATEGY_METADATA_ONLY',\n  PROJECT_CONTEXT_KNOB_METADATA_ONLY: 'THEO_AGENT_PROJECT_CONTEXT_KNOB_METADATA_ONLY',\n} as const\n\nconst reflectorInstance = new Reflector()\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  contextWindow?: ContextWindowOptions\n  projectContext?: ProjectContextOptions\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\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:\n        approvalVal && typeof approvalVal === 'object' && 'reason' in approvalVal\n          ? approvalVal\n          : 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/**\n * Emit one `metadata-only` warning per M8 decorator whose declared knobs have no\n * native SDK mapping. Extracted from {@link walkAgentMetadata} to keep its\n * cyclomatic complexity within budget (G6).\n */\nfunction warnUnmappedDecoratorKnobs(\n  agentName: string,\n  contextWindow: ContextWindowOptions | undefined,\n  projectContext: ProjectContextOptions | undefined,\n): void {\n  if (contextWindow) {\n    const { metadataOnlyKnobs } = compileContextWindow(contextWindow)\n    if (metadataOnlyKnobs.length > 0) {\n      console.warn(\n        `[${AgentWarningCode.CONTEXT_STRATEGY_METADATA_ONLY}] Agent ${agentName}: ` +\n          `@ContextWindow knob(s) ${metadataOnlyKnobs.join(', ')} are metadata-only — ` +\n          `the SDK manages transcript compaction internally. Only maxTokens is forwarded ` +\n          `to Agent.create({ context }).`,\n      )\n    }\n  }\n\n  if (projectContext) {\n    const unmapped = projectContextMetadataOnlyKnobs(projectContext)\n    if (unmapped.length > 0) {\n      console.warn(\n        `[${AgentWarningCode.PROJECT_CONTEXT_KNOB_METADATA_ONLY}] Agent ${agentName}: ` +\n          `@ProjectContext knob(s) ${unmapped.join(', ')} are metadata-only — ` +\n          `the repo map is composed via buildRepoMap/buildEnvContext/readProjectInstructions; ` +\n          `only ignorePatterns is forwarded.`,\n      )\n    }\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(`[@theokit/agents] Class ${AgentClass.name} is missing @Agent() decorator.`)\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\n  // Interceptors and filters are read but NOT enforced in agent pipeline.\n  // Agent pipeline only shares guards with HTTP; interceptors/filters have\n  // different lifecycle semantics (HTTP wraps a single handler; agents run\n  // a multi-step loop with tool calls, streaming, checkpoints).\n  // Warn explicitly so developers don't expect enforcement silently.\n  const interceptors = getMeta<Function[]>(USE_INTERCEPTORS, AgentClass) ?? []\n  if (interceptors.length > 0) {\n    console.warn(\n      `[${AgentWarningCode.INTERCEPTOR_METADATA_ONLY}] Agent ${AgentClass.name}: ` +\n        `@UseInterceptors is metadata-only on agents and will not execute. ` +\n        `Agent pipeline shares guards with HTTP but uses a distinct execution model. ` +\n        `Interceptors are reserved for future agent-specific lifecycle hooks.`,\n    )\n  }\n\n  const filters = getMeta<Function[]>(USE_FILTERS, AgentClass) ?? []\n  if (filters.length > 0) {\n    console.warn(\n      `[${AgentWarningCode.FILTER_METADATA_ONLY}] Agent ${AgentClass.name}: ` +\n        `@UseFilters is metadata-only on agents and will not catch agent runtime errors. ` +\n        `Agent errors flow through SSE error events, not HTTP exception filters. ` +\n        `Filters are reserved for future agent-specific error handling.`,\n    )\n  }\n\n  // @Budget on agent class: metadata-only for top-level agents.\n  // Budget enforcement is active only in delegate() (sub-agent calls) where\n  // the orchestrator clamps cost mid-stream. Top-level agent budget depends\n  // on the SDK's cost reporting in DoneEvent.\n  const agentBudget = reflectorInstance.get(Budget, AgentClass)\n  if (agentBudget) {\n    console.warn(\n      `[${AgentWarningCode.BUDGET_TOP_LEVEL_METADATA_ONLY}] Agent ${AgentClass.name}: ` +\n        `@Budget on top-level agents is metadata-only in this version. ` +\n        `Budget enforcement currently applies to delegate() calls only. ` +\n        `Top-level run enforcement will be wired through SDK cost tracking in a future release.`,\n    )\n  }\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  // M8: @ContextWindow + @ProjectContext have native SDK mappings for only a\n  // subset of their knobs; warn once for the rest (honest enforcement, G10).\n  const contextWindow = getContextWindowConfig(AgentClass)\n  const projectContext = getProjectContextConfig(AgentClass)\n  warnUnmappedDecoratorKnobs(AgentClass.name, contextWindow, projectContext)\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    contextWindow,\n    projectContext,\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 * M8-3 — compile `@Skills` metadata into the SDK's `SkillsSettings`.\n *\n * Per sdk-runtime.md: the bridge COMPILES decorator metadata into a format the\n * SDK accepts; the SDK is the runtime. `Agent.create({ skills })` natively\n * discovers `.theokit/skills/<name>/SKILL.md` files and injects the `<skills>`\n * block — so giving `@Skills` runtime is a pure shape translation, not a\n * reimplementation of discovery.\n *\n * Mapping (ADR D4):\n * - `{ include }`            → `{ enabled: include, autoInject: true }`\n * - `{ autoDiscover: true }` → `{ autoInject: true }` (enabled omitted ⇒ the SDK\n *                              enables every discovered skill)\n */\nimport type { SkillsSettings } from '@theokit/sdk'\n\nimport type { SkillsOptions } from '../decorators/skills.js'\n\nexport function compileSkills(options: SkillsOptions): SkillsSettings {\n  if (options.autoDiscover) {\n    return { autoInject: true }\n  }\n  return { enabled: options.include, autoInject: true }\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 type { ContextSettings, SkillsSettings } from '@theokit/sdk'\n\nimport { getAgentConfig } from '../decorators/agent.js'\nimport type { McpServersMap } from '../decorators/mcp.js'\nimport type { MemoryOptions } from '../decorators/memory.js'\nimport type { ProjectContextOptions } from '../decorators/project-context.js'\n\nimport { compileContextWindow } from './compile-context-window.js'\nimport { compileSkills } from './compile-skills.js'\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 ? `${tb.namespace}.${tool.config.name}` : 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?: SkillsSettings\n  context?: ContextSettings\n  /** Raw @ProjectContext config; the adapter builds the (async) systemPrompt resolver from it. */\n  projectContext?: ProjectContextOptions\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 ? compileSkills(walkResult.skills) : undefined,\n    context: walkResult.contextWindow\n      ? compileContextWindow(walkResult.contextWindow).context\n      : undefined,\n    projectContext: walkResult.projectContext,\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      let closed = false\n      const safeEnqueue = (chunk: Uint8Array) => {\n        if (closed) return\n        try { controller.enqueue(chunk) } catch { closed = true }\n      }\n      try {\n        for await (const event of eventStream) {\n          if (closed) break // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- mutated by safeEnqueue catch\n          const data = JSON.stringify(event)\n          const frame = `event: ${event.type}\\ndata: ${data}\\n\\n`\n          safeEnqueue(encoder.encode(frame))\n        }\n      } catch (err) {\n        if (!closed) { // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- mutated by safeEnqueue catch\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          safeEnqueue(encoder.encode(frame))\n        }\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  /** Total cost in USD for this agent run (EC-2: added for budget tracking). */\n  cost?: 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 {\n        body = (await request.json()) as Record<string, unknown>\n      } catch {\n        /* empty */\n      }\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 rawSessionId = body?.sessionId\n      const sessionId = typeof rawSessionId === 'string' ? rawSessionId : `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), {\n          status: 200,\n          headers: { 'content-type': 'application/json' },\n        })\n      },\n    })\n  }\n\n  return routes\n}\n","/**\n * Translates @theokit/sdk SDKMessage events → TheoKit AgentStreamEvent.\n *\n * The SDK yields SDKMessage (system/assistant/tool_call/thinking/status).\n * TheoKit devtools + SSE handler expect AgentStreamEvent (run_started/text_delta/tool_call/done).\n * This module bridges the two — Adapter pattern (per sdk-integration-blueprint ADR-D2).\n */\nimport type { StreamEvent } from './agent-sse-handler.js'\n\n/** Minimal SDK message shape — duck-typed to avoid hard import of @theokit/sdk types. */\nexport interface SdkMessage {\n  type: string\n  [key: string]: unknown\n}\n\n/** Safely coerce unknown value to string. */\nfunction asString(value: unknown, fallback: string): string {\n  if (typeof value === 'string') return value\n  return fallback\n}\n\nfunction translateSystemEvent(msg: SdkMessage, runId: string): StreamEvent[] {\n  return [\n    {\n      type: 'run_started',\n      runId,\n      agentName: asString(msg.agent_id, 'agent'),\n      model: asString(msg.model, 'unknown'),\n    },\n  ]\n}\n\nfunction translateAssistantEvent(msg: SdkMessage): StreamEvent[] {\n  const events: StreamEvent[] = []\n  // Real SDKAssistantMessage (messages.ts:58): content lives at msg.message.content.\n  const message = msg.message as { content?: unknown } | undefined\n  const content = message?.content\n  if (!Array.isArray(content)) return events\n\n  for (const block of content) {\n    const b = block as { type: string; text?: string; name?: string; input?: unknown; id?: string }\n    if (b.type === 'text' && b.text) {\n      events.push({ type: 'text_delta', content: b.text })\n    }\n    if (b.type === 'tool_use') {\n      events.push({\n        type: 'tool_call',\n        callId: b.id ?? `tc-${Date.now()}`,\n        toolName: b.name ?? 'unknown',\n        input: b.input ?? {},\n      })\n    }\n  }\n  return events\n}\n\nfunction translateToolCallEvent(msg: SdkMessage): StreamEvent[] {\n  // Real SDKToolUseMessage (messages.ts:89): call_id (not id), status running|completed|error,\n  // tool output in `result` (no separate `error` field).\n  const status = msg.status as string\n  const callId = asString(msg.call_id, `tc-${Date.now()}`)\n  const toolName = asString(msg.name, 'unknown')\n  if (status === 'completed') {\n    return [\n      {\n        type: 'tool_result',\n        callId,\n        toolName,\n        output: asString(msg.result, ''),\n        durationMs: 0,\n        isError: false,\n      },\n    ]\n  }\n  if (status === 'error') {\n    return [\n      {\n        type: 'tool_result',\n        callId,\n        toolName,\n        output: asString(msg.result, 'Tool failed'),\n        durationMs: 0,\n        isError: true,\n      },\n    ]\n  }\n  return [] // 'running' status → no event (in progress)\n}\n\nfunction translateStatusEvent(msg: SdkMessage): StreamEvent[] {\n  // Real SDKStatusMessage (messages.ts:106): status is UPPERCASE cloud-run lifecycle;\n  // error text (when present) is in `msg.message`. FINISHED/CANCELLED are terminal-clean;\n  // ERROR/EXPIRED are terminal-failure (must surface — fail-loud, Unbreakable Rule 8);\n  // CREATING/RUNNING are in-progress.\n  const s = msg.status as string\n  if (s === 'FINISHED' || s === 'CANCELLED') {\n    return [\n      {\n        type: 'done',\n        result: '',\n        usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },\n        durationMs: 0,\n        cost: 0,\n      },\n    ]\n  }\n  if (s === 'ERROR' || s === 'EXPIRED') {\n    return [\n      {\n        type: 'error',\n        code: 'AGENT_ERROR',\n        message: asString(msg.message, 'Agent error'),\n        retryable: false,\n      },\n    ]\n  }\n  return []\n}\n\n/**\n * Translate a single SDK message to zero or more TheoKit stream events.\n * Returns an array because one SDK message may map to multiple TheoKit events.\n */\nexport function translateSdkEvent(msg: SdkMessage, runId: string): StreamEvent[] {\n  switch (msg.type) {\n    case 'system':\n      return translateSystemEvent(msg, runId)\n    case 'assistant':\n      return translateAssistantEvent(msg)\n    case 'tool_call':\n      return translateToolCallEvent(msg)\n    case 'thinking':\n      // Real SDKThinkingMessage (messages.ts:73): reasoning text is in msg.text.\n      return [{ type: 'thinking', content: asString(msg.text, '') }]\n    case 'status':\n      return translateStatusEvent(msg)\n    default:\n      return [] // Unknown message types silently ignored\n  }\n}\n","/**\n * SDK Adapter — bridges @theokit/agents decorators → @theokit/sdk runtime.\n *\n * Per rule sdk-runtime.md (INQUEBRÁVEL): @theokit/sdk is the ONLY agent runtime.\n * This adapter replaces llm-runner.ts (which called OpenRouter API directly).\n *\n * Flow: @Agent decorator → compileAgent() → createSdkAgentStream() → SDK Agent.create() → Run.stream()\n */\nimport type { ContextSettings, SkillsSettings, SystemPromptResolver } from '@theokit/sdk'\n\nimport type { CompiledAgentOptions, CompiledTool } from './agent-compiler.js'\nimport type { StreamEvent } from './agent-sse-handler.js'\nimport { compileProjectContext } from './compile-project-context.js'\nimport { translateSdkEvent, type SdkMessage } from './event-translator.js'\n\n/** Extra `Agent.create()` options compiled from the M8 declarative decorators. */\ninterface M8CreateOptions {\n  skills?: SkillsSettings\n  context?: ContextSettings\n  systemPrompt?: string | SystemPromptResolver\n  /** Settings source so the SDK can discover SKILL.md files (EC-1). */\n  local?: { settingSources: string[] }\n}\n\n/**\n * Project the M8 fields from `CompiledAgentOptions` (the single compile site is\n * `agent-compiler.ts`, per sdk-runtime.md) into `Agent.create()` arguments. Only\n * the async `@ProjectContext` resolver is built here (it does I/O, so the compiler\n * keeps it raw). `applied` lists which decorators contributed, for the\n * observability log (wiring triad — runtime metric).\n */\nfunction assembleM8CreateOptions(compiled: CompiledAgentOptions): {\n  options: M8CreateOptions\n  applied: string[]\n} {\n  const options: M8CreateOptions = {}\n  const applied: string[] = []\n  const base = compiled.systemPrompt\n\n  if (compiled.skills) {\n    options.skills = compiled.skills\n    options.local = { settingSources: ['project'] }\n    applied.push('skills')\n  }\n  if (compiled.context) {\n    options.context = compiled.context\n    applied.push('context')\n  }\n  if (compiled.projectContext) {\n    options.systemPrompt = compileProjectContext(compiled.projectContext, base)\n    applied.push('projectContext')\n  } else if (base !== undefined) {\n    options.systemPrompt = base\n  }\n\n  return { options, applied }\n}\n\n/**\n * Creates an agent stream factory using @theokit/sdk as the runtime.\n *\n * Returns a function that, given a message + sessionId, yields TheoKit\n * AgentStreamEvent via the SDK's Agent.create() + Run.stream() pipeline.\n */\nexport function createSdkAgentStream(\n  compiled: CompiledAgentOptions,\n  compiledTools: CompiledTool[],\n  apiKey: string,\n  envModel?: string,\n) {\n  const model = envModel ?? compiled.model ?? 'openai/gpt-4o-mini'\n\n  return (message: string, _sessionId: string): AsyncIterable<StreamEvent> => ({\n    async *[Symbol.asyncIterator]() {\n      const runId = `run-${Date.now()}`\n      const t0 = Date.now()\n\n      // Dynamic import — @theokit/sdk is optional peer dep\n      let Agent: {\n        create: (opts: Record<string, unknown>) => Promise<{\n          send: (msg: string) => Promise<{ stream: () => AsyncGenerator<SdkMessage> }>\n          dispose: () => Promise<void>\n        }>\n      }\n      let defineTool: (spec: {\n        name: string\n        description: string\n        inputSchema: unknown\n        handler: (input: unknown) => string | Promise<string>\n      }) => unknown\n\n      try {\n        const sdk = await import('@theokit/sdk')\n        Agent = sdk.Agent as typeof Agent\n        defineTool = sdk.defineTool as typeof defineTool\n      } catch {\n        yield {\n          type: 'error',\n          code: 'SDK_NOT_INSTALLED',\n          message: 'Install @theokit/sdk: pnpm add @theokit/sdk',\n          retryable: false,\n        }\n        return\n      }\n\n      // Convert compiled tools → SDK defineTool format\n      const sdkTools = compiledTools.map((t) =>\n        defineTool({\n          name: t.name,\n          description: t.description,\n          inputSchema: t.inputSchema,\n          handler: t.handler,\n        }),\n      )\n\n      try {\n        // Project the compiled M8 decorator fields into native Agent.create args.\n        const { options: m8, applied } = assembleM8CreateOptions(compiled)\n        if (applied.length > 0) {\n          // Wiring triad — runtime metric: observable proof the decorators fired.\n          console.debug('[THEO_AGENT_M8_RUNTIME_APPLIED]', {\n            skills: applied.includes('skills'),\n            context: applied.includes('context'),\n            projectContext: applied.includes('projectContext'),\n          })\n        }\n\n        // Create SDK agent (M8 fields spread; absent decorators add no keys)\n        const agent = await Agent.create({\n          apiKey,\n          model: { id: model },\n          tools: sdkTools,\n          ...m8,\n        })\n\n        // Send message + stream response\n        const run = await agent.send(message)\n\n        let sawTerminal = false\n        for await (const sdkEvent of run.stream()) {\n          const translated = translateSdkEvent(sdkEvent, runId)\n          for (const event of translated) {\n            if (event.type === 'done' || event.type === 'error') sawTerminal = true\n            yield event\n          }\n        }\n\n        // Fallback terminal: only when the SDK stream did NOT already yield one\n        // (a real run ends in a `status: FINISHED`/`ERROR` message → translated to\n        // done/error). The loop's B1 guarantee relies on a terminal existing; this\n        // keeps exactly-one-terminal without double-emitting to SSE consumers.\n        if (!sawTerminal) {\n          yield {\n            type: 'done',\n            result: '',\n            usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },\n            durationMs: Date.now() - t0,\n            cost: 0,\n          }\n        }\n\n        await agent.dispose()\n      } catch (err) {\n        yield {\n          type: 'error',\n          code: 'SDK_ERROR',\n          message: err instanceof Error ? err.message : 'SDK agent error',\n          retryable: false,\n        }\n      }\n    },\n  })\n}\n","/**\n * LoopStrategy — the per-round terminal-decision contract that gives runtime to\n * `@MainLoop({ strategy })`.\n *\n * V4-A proved `@MainLoop`'s `strategy` field was metadata-only (declared +\n * compiled, never executed). This module is the foundation Phase 2's\n * `runReflectiveLoop` branches on. Modeled on Mastra's `agentic-loop`/`stopWhen`\n * (inverted) + `maxSteps` ceiling — NOT Spring's per-call Advisor (plan ADR D1).\n * Config is Zod-validated so an invalid `maxIterations` fails fast at resolve\n * time, never as a silent infinite loop at runtime (plan ADR D3).\n *\n * referencia: knowledge-base/references/mastra agentic-loop/index.ts (stopWhen + maxSteps).\n */\nimport { z } from 'zod'\n\nimport type { MainLoopMeta } from '../types.js'\n\n/** Why a single round ended. Derived in the bridge from the SDK stream events. */\nexport type LoopFinishReason = 'tool-calls' | 'stop' | 'length' | 'error'\n\n/** Value object describing one round's result. */\nexport interface LoopOutcome {\n  /** Why the round ended (the continuation signal). */\n  readonly finishReason: LoopFinishReason\n  /** 1-indexed round number that just completed. */\n  readonly round: number\n  /** Tool calls executed during the round. */\n  readonly toolCalls: readonly { name: string; input: unknown; output: string }[]\n  /** Accumulated assistant text for the round. */\n  readonly responseText: string\n}\n\n/** The terminal-decision contract. `shouldContinue` is the inverted `stopWhen`. */\nexport interface LoopStrategy {\n  /** The originating `@MainLoop` strategy name. */\n  readonly name: MainLoopMeta['strategy']\n  /** Hard ceiling on rounds — guarantees termination. */\n  readonly maxIterations: number\n  /** True ⇒ re-enter for another round; false ⇒ terminate. Never true forever. */\n  shouldContinue(outcome: LoopOutcome): boolean\n}\n\n/** Default round ceiling when `@MainLoop` declares no `maxIterations` (EC-3: finite, never Infinity). */\nexport const DEFAULT_MAX_ITERATIONS = 8\n\n/** Serializable config for a LoopStrategy. SSoT per type-safety.md (ADR D3). */\nexport const loopStrategyConfigSchema = z.object({\n  name: z.enum(['simple-chat', 'plan-act-reflect', 'react']),\n  maxIterations: z.number().int().min(1),\n})\n\nexport type LoopStrategyConfig = z.infer<typeof loopStrategyConfigSchema>\n\n/**\n * Map a `@MainLoop` strategy + ceiling to a concrete {@link LoopStrategy}.\n *\n * - `simple-chat` ⇒ exactly one round (`shouldContinue` always false).\n * - `plan-act-reflect` / `react` ⇒ continue while the round ended on `tool-calls`\n *   AND the ceiling has not been reached (`round < maxIterations`).\n *\n * Throws (Zod) when `maxIterations < 1` — fail fast, never a silent infinite loop.\n */\nexport function resolveLoopStrategy(\n  strategy: MainLoopMeta['strategy'],\n  maxIterations: number = DEFAULT_MAX_ITERATIONS,\n): LoopStrategy {\n  const cfg = loopStrategyConfigSchema.parse({ name: strategy, maxIterations })\n\n  if (cfg.name === 'simple-chat') {\n    return { name: cfg.name, maxIterations: cfg.maxIterations, shouldContinue: () => false }\n  }\n\n  return {\n    name: cfg.name,\n    maxIterations: cfg.maxIterations,\n    shouldContinue: (outcome: LoopOutcome): boolean =>\n      outcome.finishReason === 'tool-calls' && outcome.round < cfg.maxIterations,\n  }\n}\n","/**\n * ReflectionStrategy — composes INTO the loop between rounds (the loop calls\n * `reflect()` then `LoopStrategy.shouldContinue()`).\n *\n * `'plan-act-reflect'` resolves to the `'ladder'` default shipped here; a custom\n * strategy may be supplied (OCP — plan Drawback #2). `reflect()` is pure (no\n * I/O, no LLM) — it inspects the round's outcome and returns feedback to inject\n * into the next round's prompt plus a `continue` hint. The hard round ceiling\n * lives in `LoopStrategy.shouldContinue` (maxIterations), NOT here.\n *\n * referencia: knowledge-base/references/mastra agentic-loop/index.ts (onIterationComplete → { feedback, continue }).\n */\nimport { z } from 'zod'\n\nimport type { LoopOutcome } from './loop-strategy.js'\n\n/** Result of reflecting on a completed round. */\nexport interface ReflectionResult {\n  /** Optional text prepended to the next round's prompt. */\n  readonly feedback?: string\n  /** Hint: should the loop reflect-and-continue? (the ceiling still bounds it) */\n  readonly continue: boolean\n}\n\n/** Pluggable between-round reflection. Pure — never performs I/O. */\nexport interface ReflectionStrategy {\n  /** Strategy identifier (e.g. `'ladder'`). */\n  readonly name: string\n  /** Inspect the round outcome; return feedback + continue hint. */\n  reflect(outcome: LoopOutcome): ReflectionResult\n}\n\n/** Serializable config for a ReflectionStrategy. SSoT per type-safety.md (ADR D3). */\nexport const reflectionStrategyConfigSchema = z.object({\n  name: z.string().min(1),\n})\n\nexport type ReflectionStrategyConfig = z.infer<typeof reflectionStrategyConfigSchema>\n\n/**\n * The default `'ladder'` reflection (what `'plan-act-reflect'` resolves to).\n *\n * Continues with bounded templated feedback while the round ended on\n * `tool-calls`; terminates on any terminal `finishReason` (`stop`/`error`/\n * `length`). The feedback is a short fixed template (bounded — EC-5; context\n * growth is the SDK's responsibility, not the loop's).\n */\nexport const ladderReflectionStrategy: ReflectionStrategy = {\n  name: 'ladder',\n  reflect(outcome: LoopOutcome): ReflectionResult {\n    if (outcome.finishReason === 'tool-calls') {\n      return {\n        feedback: `Tool results received (round ${outcome.round}). Reflect on whether the goal is met; if not, refine the approach and continue.`,\n        continue: true,\n      }\n    }\n    return { continue: false }\n  },\n}\n\n/**\n * No-op reflection for `'react'` (multi-round WITHOUT reflection feedback).\n *\n * Returns `{ continue: true }` (no feedback) so the round-continuation decision\n * is delegated entirely to `LoopStrategy.shouldContinue` (i.e. `react` loops\n * while `finishReason === 'tool-calls'` under the ceiling). NOTE: the plan's\n * pseudo-code (Files-to-edit) sketched `{ continue: false }`, which would make\n * `react` single-shot — that contradicts the plan's own Deep Dives (\"`react`\n * still multi-rounds while finishReason==='tool-calls'\"); `continue: true` is\n * the behavior the resolved react LoopStrategy requires.\n */\nexport const noopReflectionStrategy: ReflectionStrategy = {\n  name: 'noop',\n  reflect(): ReflectionResult {\n    return { continue: true }\n  },\n}\n","/**\n * Shared delegation value types + typed errors.\n *\n * Extracted from `agent-orchestrator.ts` so BOTH the orchestrator (`delegate`)\n * and the loop driver (`loop/run-reflective-loop.ts`) can import them WITHOUT a\n * cycle (orchestrator → loop → delegation-types; orchestrator → delegation-types;\n * delegation-types depends on nothing — Acyclic Dependencies Principle, G1).\n * `agent-orchestrator.ts` re-exports these for backward compatibility.\n */\n\nexport interface DelegationResult {\n  response: string\n  toolCalls: { name: string; input: unknown; output: string }[]\n  cost: number\n  tokens: number\n  /** Rounds the reflective loop ran (set by `runReflectiveLoop`; absent for the single-shot path). */\n  rounds?: number\n}\n\nexport class BudgetExceededError extends Error {\n  constructor(\n    public readonly agentName: string,\n    public readonly actualCost: number,\n    public readonly budgetLimit: number,\n  ) {\n    super(\n      `Agent \"${agentName}\" exceeded budget: $${actualCost.toFixed(4)} > $${budgetLimit.toFixed(4)}`,\n    )\n    this.name = 'BudgetExceededError'\n  }\n}\n\nexport class DelegationError extends Error {\n  constructor(\n    public readonly agentName: string,\n    public readonly cause: unknown,\n  ) {\n    super(\n      `Delegation to agent \"${agentName}\" failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n    )\n    this.name = 'DelegationError'\n  }\n}\n","/**\n * runReflectiveLoop — the multi-round reflective driver that gives `@MainLoop`\n * its runtime (closes the metadata-only gap, V4-A / plan ADR D2).\n *\n * Per round it consumes ONE SDK stream turn (the model call stays in the SDK —\n * the factory is `createSdkAgentStream(...)`, injected for testability), derives\n * a {@link LoopOutcome}, asks the {@link ReflectionStrategy} for feedback, then\n * the {@link LoopStrategy} whether to continue. Bounded by `maxIterations`\n * (forced terminal at the ceiling — never an infinite loop). The bridge owns the\n * loop; the SDK owns the model call (sdk-runtime.md / ADR 0031 — no second runtime).\n *\n * `runReflectiveLoop` is INTERNAL (not re-exported from the package barrel,\n * Drawback #4) — consumed by `delegate()` (T2.2) and `AgentRunner` (T3.1).\n *\n * referencia: knowledge-base/references/mastra agent.ts (re-enter the loop with feedback).\n */\nimport {\n  BudgetExceededError,\n  type DelegationResult,\n  DelegationError,\n} from '../bridge/delegation-types.js'\n\nimport type { LoopFinishReason, LoopOutcome, LoopStrategy } from './loop-strategy.js'\nimport type { ReflectionStrategy } from './reflection-strategy.js'\n\n/** One SDK stream turn: `createSdkAgentStream(...)` returns this shape. */\nexport type RoundStreamFactory = (\n  message: string,\n  sessionId: string,\n) => AsyncIterable<{ type: string; [key: string]: unknown }>\n\n/** Strategies + options for {@link runReflectiveLoop}. */\nexport interface RunReflectiveLoopConfig {\n  /** The terminal-decision strategy (resolved from `@MainLoop.strategy`). */\n  readonly loop: LoopStrategy\n  /** Between-round reflection (default `'ladder'` for `'plan-act-reflect'`). */\n  readonly reflection: ReflectionStrategy\n  /** Cumulative USD budget across ALL rounds (EC-4). Exceeding throws BudgetExceededError. */\n  readonly budget?: number\n  /** Cancellation — when aborted, the loop stops re-entering and advancing the in-flight stream. */\n  readonly signal?: AbortSignal\n  /** Name surfaced in typed errors. */\n  readonly agentName?: string\n}\n\nfunction asString(value: unknown, fallback: string): string {\n  return typeof value === 'string' ? value : fallback\n}\n\nfunction asNumber(value: unknown, fallback: number): number {\n  return typeof value === 'number' ? value : fallback\n}\n\n/** One round's accumulated facts + the signals needed to derive `finishReason`. */\ninterface RoundResult {\n  responseText: string\n  toolCalls: { name: string; input: unknown; output: string }[]\n  cost: number\n  tokens: number\n  finishReason: LoopFinishReason\n  errorMessage: string\n}\n\n/**\n * Derive the round's terminal signal from the events seen this round.\n *\n * Precedence (B1 — the load-bearing fix):\n *  1. error event           ⇒ 'error'\n *  2. explicit done.finishReason==='tool-calls' ⇒ 'tool-calls' (if a future SDK adapter sets it)\n *  3. ANY tool_result seen  ⇒ 'tool-calls' — the turn USED TOOLS (\"still working\"), so the\n *     outer reflective loop should reflect + re-prompt. The real `@theokit/sdk` adapter ALWAYS\n *     appends a terminal `done` WITHOUT finishReason after a turn (sdk-adapter.ts / event-translator.ts);\n *     letting that `done` short-circuit a tool-using turn to 'stop' is exactly what made the loop\n *     dead in production (single-round). tool_result therefore OUTRANKS the bare done. Bounded by\n *     `maxIterations` so it can never spin.\n *  4. otherwise (pure-answer `done`, text-only, or empty round) ⇒ 'stop' (terminal). EC-1: a\n *     degenerate/empty round defaults to 'stop', NEVER 'tool-calls'.\n *\n * This is an honest heuristic: the SDK runs the inner tool loop to completion per turn, so the\n * outer loop treats a tool-using turn as \"continue/reflect\" and a pure-text answer as \"done\".\n */\nfunction deriveFinishReason(signals: {\n  sawError: boolean\n  sawDone: boolean\n  doneFinishReason: string\n  sawToolResult: boolean\n}): LoopFinishReason {\n  if (signals.sawError) return 'error'\n  if (signals.sawDone && signals.doneFinishReason === 'tool-calls') return 'tool-calls'\n  if (signals.sawToolResult) return 'tool-calls'\n  return 'stop'\n}\n\n/** Consume exactly one SDK stream turn and derive its {@link LoopFinishReason}. */\nasync function consumeOneRound(\n  factory: RoundStreamFactory,\n  prompt: string,\n  sessionId: string,\n  signal: AbortSignal | undefined,\n): Promise<RoundResult> {\n  const r: RoundResult = {\n    responseText: '',\n    toolCalls: [],\n    cost: 0,\n    tokens: 0,\n    finishReason: 'stop',\n    errorMessage: '',\n  }\n  const signals = { sawError: false, sawDone: false, doneFinishReason: '', sawToolResult: false }\n\n  for await (const event of factory(prompt, sessionId)) {\n    if (signal?.aborted) break // cancellation: stop advancing the iterator\n    if (event.type === 'text_delta' && typeof event.content === 'string') {\n      r.responseText += event.content\n    } else if (event.type === 'tool_result') {\n      signals.sawToolResult = true\n      r.toolCalls.push({\n        name: asString(event.toolName, 'unknown'),\n        input: event.input ?? {},\n        output: asString(event.output, ''),\n      })\n    } else if (event.type === 'done') {\n      signals.sawDone = true\n      signals.doneFinishReason = asString(event.finishReason, '')\n      r.cost = asNumber(event.cost, 0)\n      r.tokens = (event.usage as { totalTokens?: number } | undefined)?.totalTokens ?? 0\n    } else if (event.type === 'error') {\n      signals.sawError = true\n      r.errorMessage = asString((event as { message?: unknown }).message, 'Unknown agent error')\n    }\n  }\n\n  r.finishReason = deriveFinishReason(signals)\n  return r\n}\n\n/**\n * Drive the reflective loop to a terminal {@link DelegationResult}.\n *\n * Terminates when: the reflection/strategy says stop, the `maxIterations` ceiling\n * is reached (via `loop.shouldContinue`), the signal aborts, or a degenerate round\n * resolves to `stop`. Throws `DelegationError` on a mid-round error event\n * (fail-fast, typed) and `BudgetExceededError` when cumulative cost crosses `budget`.\n */\nexport async function runReflectiveLoop(\n  factory: RoundStreamFactory,\n  message: string,\n  sessionId: string,\n  config: RunReflectiveLoopConfig,\n): Promise<DelegationResult> {\n  const {\n    loop,\n    reflection,\n    budget = Number.POSITIVE_INFINITY,\n    signal,\n    agentName = loop.name,\n  } = config\n  const acc: DelegationResult = { response: '', toolCalls: [], cost: 0, tokens: 0, rounds: 0 }\n  let round = 1\n  let feedback: string | undefined\n\n  while (!signal?.aborted) {\n    // L2: only append the [reflection] block when there is actual feedback (react's\n    // noop reflection returns no feedback — avoid polluting its prompt with an empty marker).\n    const prompt = round === 1 || !feedback ? message : `${message}\\n\\n[reflection] ${feedback}`\n    // M2: wrap the round so a RAW stream/iterator exception (not an `error` event — e.g. the\n    // SDK dynamic import rejecting) surfaces as a typed DelegationError, matching the single-shot path.\n    let r: RoundResult\n    try {\n      r = await consumeOneRound(factory, prompt, sessionId, signal)\n    } catch (err) {\n      if (err instanceof BudgetExceededError || err instanceof DelegationError) throw err\n      throw new DelegationError(agentName, err)\n    }\n\n    acc.response += r.responseText\n    acc.toolCalls.push(...r.toolCalls)\n    acc.cost += r.cost\n    acc.tokens += r.tokens\n\n    if (r.finishReason === 'error') throw new DelegationError(agentName, r.errorMessage)\n    if (Number.isFinite(budget) && acc.cost > budget) {\n      throw new BudgetExceededError(agentName, acc.cost, budget)\n    }\n\n    const outcome: LoopOutcome = {\n      finishReason: r.finishReason,\n      round,\n      toolCalls: r.toolCalls,\n      responseText: r.responseText,\n    }\n    const reflectionResult = reflection.reflect(outcome)\n    if (!(reflectionResult.continue && loop.shouldContinue(outcome))) {\n      acc.rounds = round\n      // Wiring triad — runtime metric (G10): observable proof the loop ran, with round count.\n      // Fires for BOTH on-ramps (delegate + AgentRunner) since both share this driver.\n      console.debug('[THEO_AGENT_MAINLOOP_RUNTIME_APPLIED]', { strategy: loop.name, rounds: round })\n      return acc\n    }\n\n    feedback = reflectionResult.feedback\n    round += 1\n  }\n\n  // Aborted before (re-)entering a round. L1: record the rounds that DID run\n  // (round is 1-indexed and points at the next round, so `round - 1` ran).\n  acc.rounds = round - 1\n  return acc\n}\n","/**\n * AgentRunner — the imperative twin of `@MainLoop` (plan ADR D4, V4-B).\n *\n * `AgentRunner.builder(AgentClass).reflection().stream().build()` walks +\n * compiles the agent and resolves the SAME `{ compiled, loopStrategy }` that\n * `delegate()` resolves for the decorator path (two on-ramps, one runtime).\n * `build()` is the compile boundary (no I/O, no IoC — standalone, mirrors\n * Spring's `ChatClient.builder(...).build()`); `run()` does the I/O via\n * `runReflectiveLoop` (the SAME loop `delegate()` uses — DRY, ADR 0031).\n *\n * referencia: knowledge-base/references/spring-ai DefaultChatClientBuilder.java (build() returns standalone).\n */\nimport { type CompiledAgentOptions, compileAgent } from '../bridge/agent-compiler.js'\nimport type { DelegationResult } from '../bridge/delegation-types.js'\nimport { createSdkAgentStream } from '../bridge/sdk-adapter.js'\nimport { walkAgentMetadata } from '../bridge/walk-agent-metadata.js'\n\nimport { type LoopStrategy, resolveLoopStrategy } from './loop-strategy.js'\nimport {\n  ladderReflectionStrategy,\n  noopReflectionStrategy,\n  type ReflectionStrategy,\n} from './reflection-strategy.js'\nimport { runReflectiveLoop } from './run-reflective-loop.js'\n\n/** Options for {@link AgentRunner.run}. */\nexport interface AgentRunnerRunOptions {\n  /** LLM API key. */\n  readonly apiKey: string\n  /** Session id override (default: a fresh isolated id). */\n  readonly sessionId?: string\n  /** Cumulative USD budget across rounds. */\n  readonly budget?: number\n  /** Cancellation — aborts stop the reflective loop from re-entering. */\n  readonly signal?: AbortSignal\n}\n\n/**\n * A built, runnable agent. Construct via {@link AgentRunner.builder} — the\n * constructor takes already-resolved state and is an internal detail.\n */\nexport class AgentRunner {\n  constructor(\n    private readonly compiled: CompiledAgentOptions,\n    private readonly agentName: string,\n    /** The resolved terminal-decision strategy (parity with `delegate()`). */\n    readonly loopStrategy: LoopStrategy,\n    /** The resolved between-round reflection (default or `.reflection(custom)` override). */\n    readonly reflectionStrategy: ReflectionStrategy,\n    /**\n     * Recorded streaming preference. The reflective loop currently always\n     * streams via the SDK `Run.stream()`; a non-streaming collect mode is future\n     * work — the flag is captured + exposed here, not yet branched on (honest\n     * per G10: documented, not a silent no-op).\n     */\n    readonly streamEnabled: boolean,\n  ) {}\n\n  /** Start a fluent builder for `AgentClass`. */\n  static builder(AgentClass: Function): AgentRunnerBuilder {\n    return new AgentRunnerBuilder(AgentClass)\n  }\n\n  /** Run the agent to a terminal result via the shared reflective loop. */\n  run(message: string, opts: AgentRunnerRunOptions): Promise<DelegationResult> {\n    const streamFactory = createSdkAgentStream(\n      this.compiled,\n      this.compiled.tools,\n      opts.apiKey,\n      this.compiled.model,\n    )\n    const sessionId = opts.sessionId ?? `runner-${crypto.randomUUID()}`\n    return runReflectiveLoop(streamFactory, message, sessionId, {\n      loop: this.loopStrategy,\n      reflection: this.reflectionStrategy,\n      budget: opts.budget,\n      agentName: this.agentName,\n      signal: opts.signal,\n    })\n  }\n}\n\n/** Fluent builder — accumulates config; `build()` is the compile boundary. */\nexport class AgentRunnerBuilder {\n  private reflectionOverride?: ReflectionStrategy\n  private streamEnabled = true\n\n  constructor(private readonly AgentClass: Function) {}\n\n  /** Override the default reflection strategy (OCP — plan Drawback #2). No arg ⇒ keep default. */\n  reflection(strategy?: ReflectionStrategy): this {\n    if (strategy) this.reflectionOverride = strategy\n    return this\n  }\n\n  /** Record the streaming preference (see {@link AgentRunner.streamEnabled}). */\n  stream(enabled = true): this {\n    this.streamEnabled = enabled\n    return this\n  }\n\n  /** Walk + compile + resolve strategies — the compile→execute boundary (no I/O). */\n  build(): AgentRunner {\n    const walk = walkAgentMetadata(this.AgentClass, [])\n    const toolboxInstances = new Map(\n      walk.toolboxes.map((tb) => [tb.class, new (tb.class as new () => object)()]),\n    )\n    const compiled = compileAgent(walk, toolboxInstances)\n    const loopStrategy = resolveLoopStrategy(walk.mainLoop.strategy, walk.mainLoop.maxIterations)\n    const reflectionStrategy =\n      this.reflectionOverride ??\n      (walk.mainLoop.strategy === 'plan-act-reflect'\n        ? ladderReflectionStrategy\n        : noopReflectionStrategy)\n    return new AgentRunner(\n      compiled,\n      walk.agentConfig.name,\n      loopStrategy,\n      reflectionStrategy,\n      this.streamEnabled,\n    )\n  }\n}\n","/**\n * Multi-agent orchestration runtime.\n *\n * Provides `delegate()` — a function that lets a parent agent invoke a\n * sub-agent and receive its result. Handles budget clamping (D4), tool sharing,\n * toolbox auto-instantiation (EC-1), and routes the resolved `@MainLoop` strategy\n * through `runReflectiveLoop` — the SAME driver `AgentRunner.run()` uses, so both\n * on-ramps are one runtime (ADR D4). `simple-chat` ⇒ `shouldContinue:()=>false`\n * ⇒ exactly one round; `react`/`plan-act-reflect` ⇒ multi-round reflective loop.\n */\nimport {\n  ladderReflectionStrategy,\n  noopReflectionStrategy,\n  resolveLoopStrategy,\n} from '../loop/index.js'\nimport { runReflectiveLoop } from '../loop/run-reflective-loop.js'\n\nimport { compileAgent, type CompiledTool } from './agent-compiler.js'\nimport { type DelegationResult, DelegationError } from './delegation-types.js'\nimport { createSdkAgentStream } from './sdk-adapter.js'\nimport { walkAgentMetadata } from './walk-agent-metadata.js'\n\n// Re-export the delegation value types for backward compatibility — they moved\n// to delegation-types.js to break the orchestrator↔loop import cycle (G1).\nexport { BudgetExceededError, type DelegationResult, DelegationError } from './delegation-types.js'\n\nexport interface DelegateOptions {\n  /** Max USD for this sub-agent call. */\n  budget?: number\n  /** Parent's remaining budget (for clamping). */\n  parentBudgetRemaining?: number\n  /** Parent's tools (for sharing — sub-agent inherits these). */\n  parentTools?: CompiledTool[]\n  /** LLM API key (inherited from parent). */\n  apiKey?: string\n  /** Session ID override (default: crypto.randomUUID for isolation). */\n  sessionId?: string\n  /** Cancellation — aborts stop the reflective loop from re-entering. */\n  signal?: AbortSignal\n}\n\n/** Validate API key and throw DelegationError if missing. */\nfunction requireApiKey(opts: DelegateOptions, agentName: string): string {\n  const apiKey = opts.apiKey ?? ''\n  if (!apiKey) {\n    throw new DelegationError(agentName, 'No API key provided. Pass apiKey in DelegateOptions.')\n  }\n  return apiKey\n}\n\n/** Merge parent tools with sub-agent tools (sub wins on collision). */\nfunction mergeTools(parentTools: CompiledTool[], subTools: CompiledTool[]): CompiledTool[] {\n  const subToolNames = new Set(subTools.map((t) => t.name))\n  const inherited = parentTools.filter((t) => !subToolNames.has(t.name))\n  return [...inherited, ...subTools]\n}\n\n/**\n * Delegate a task to a sub-agent and collect its result.\n *\n * - Budget clamping: `min(parentBudgetRemaining, budget)` (D4)\n * - Tool sharing: parent tools merged with sub-agent tools (sub wins on collision)\n * - Toolbox auto-instantiation: sub-agent toolboxes instantiated without DI (EC-1)\n * - Session isolation: each delegation gets a unique session ID (EC-4)\n * - `@MainLoop` strategy runtime: routes through `runReflectiveLoop` (the same loop\n *   `AgentRunner.run` uses — one runtime for both on-ramps, ADR D4). The runtime\n *   metric (`THEO_AGENT_MAINLOOP_RUNTIME_APPLIED`) + typed-error + cumulative budget\n *   all live in the shared driver, so they fire identically on both paths.\n */\nexport async function delegate(\n  SubAgentClass: Function,\n  message: string,\n  opts: DelegateOptions = {},\n): Promise<DelegationResult> {\n  const apiKey = requireApiKey(opts, SubAgentClass.name)\n\n  // 1. Walk + compile sub-agent (EC-1: auto-instantiate toolboxes)\n  const walk = walkAgentMetadata(SubAgentClass, [])\n  const toolboxInstances = new Map(\n    walk.toolboxes.map((tb) => [tb.class, new (tb.class as new () => object)()]),\n  )\n  const compiled = compileAgent(walk, toolboxInstances)\n\n  // 2. Merge parent tools + clamp budget (D4)\n  const allTools = mergeTools(opts.parentTools ?? [], compiled.tools)\n  const budget = Math.min(opts.budget ?? Infinity, opts.parentBudgetRemaining ?? Infinity)\n\n  // 3. Build the stream factory (the model call stays in the SDK — ADR 0031) + session\n  const streamFactory = createSdkAgentStream(compiled, allTools, apiKey, walk.agentConfig.model)\n  const sessionId = opts.sessionId ?? `sub-${crypto.randomUUID()}`\n\n  // 4. Resolve the @MainLoop strategy + reflection, then run the shared reflective loop.\n  const loopStrategy = resolveLoopStrategy(walk.mainLoop.strategy, walk.mainLoop.maxIterations)\n  const reflection =\n    loopStrategy.name === 'plan-act-reflect' ? ladderReflectionStrategy : noopReflectionStrategy\n  return runReflectiveLoop(streamFactory, message, sessionId, {\n    loop: loopStrategy,\n    reflection,\n    budget,\n    agentName: SubAgentClass.name,\n    signal: opts.signal,\n  })\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 {\n  walkAgentMetadata,\n  validateUniqueRoutes,\n  type AgentWalkResult,\n} 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?: (\n    compiled: CompiledAgentOptions,\n    walkResult: AgentWalkResult,\n  ) => (message: string, sessionId: string) => AsyncIterable<StreamEvent>\n}\n\ninterface PluginApp {\n  addHook(name: string, fn: (ctx: { request: Request }) => Promise<Response | undefined>): 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: CompiledRoute[] | null = null\n\n  return {\n    name: '@theokit/agents',\n\n    register(app: PluginApp) {\n      app.addHook('onRequest', async (pluginCtx) => {\n        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): CompiledRoute[] {\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 compileRoutePatterns(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    await Promise.resolve() // yield to event loop for async contract\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:\n        'No createRunFactory provided — wire @theokit/sdk Agent.create() to enable real agent execution.',\n      retryable: false,\n    }\n  }\n}\n\ninterface CompiledRoute extends AgentRoute {\n  regex?: RegExp\n}\n\n/** Pre-compile route patterns for efficient matching. */\nfunction compileRoutePatterns(routes: AgentRoute[]): CompiledRoute[] {\n  return routes.map((r) => {\n    if (!r.path.includes(':')) return r\n    const regexSource = r.path.replace(/:[^/]+/g, '[^/]+')\n    return { ...r, regex: RegExp(`^${regexSource}$`) }\n  })\n}\n\n/** Simple route matcher — checks method + path prefix. */\nfunction matchRoute(\n  routes: CompiledRoute[],\n  method: string,\n  pathname: string,\n): CompiledRoute | undefined {\n  return routes.find((r) => {\n    if (r.method !== method) return false\n    if (r.regex) return r.regex.test(pathname)\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","STRATEGY_KNOBS","compileContextWindow","options","context","maxTokens","opts","metadataOnlyKnobs","filter","knob","undefined","UNMAPPED_KNOBS","projectContextMetadataOnlyKnobs","options","opts","filter","knob","undefined","compileProjectContext","base","promptCtx","cwd","buildEnvContext","buildRepoMap","readProjectInstructions","env","repoMap","ignore","ignorePatterns","instructions","content","Boolean","join","Reflector","USE_GUARDS","Symbol","for","USE_INTERCEPTORS","USE_FILTERS","AgentWarningCode","INTERCEPTOR_METADATA_ONLY","FILTER_METADATA_ONLY","BUDGET_TOP_LEVEL_METADATA_ONLY","CONTEXT_STRATEGY_METADATA_ONLY","PROJECT_CONTEXT_KNOB_METADATA_ONLY","reflectorInstance","Reflector","walkToolbox","ToolboxClass","config","getMeta","TOOLBOX_CONFIG","methods","TOOL_METHODS","classGuards","tools","map","propertyKey","toolConfig","TOOL_CONFIG","Error","name","String","methodGuards","ref","approvalVal","get","RequiresApproval","traceVal","Trace","auditVal","Audit","guards","approval","undefined","capabilities","budget","trace","audit","class","namespace","warnUnmappedDecoratorKnobs","agentName","contextWindow","projectContext","metadataOnlyKnobs","compileContextWindow","length","console","warn","join","unmapped","projectContextMetadataOnlyKnobs","agentWalkCache","WeakMap","walkAgentMetadata","AgentClass","toolboxClasses","cached","agentConfig","AGENT_CONFIG","mainLoop","AGENT_MAIN_LOOP","interceptors","filters","agentBudget","Budget","toolboxes","gateway","getGatewayConfig","subAgentClasses","getSubAgents","memory","getMemoryConfig","skills","getSkillsConfig","mcpServers","getMcpConfig","getContextWindowConfig","getProjectContextConfig","result","route","set","validateUniqueRoutes","results","seen","Map","r","existing","compileSkills","options","autoDiscover","autoInject","enabled","include","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","compileSkills","undefined","context","contextWindow","compileContextWindow","projectContext","mcpServers","maxIterations","mainLoop","timeoutMs","stream","encoder","TextEncoder","streamAgentResponse","eventStream","stream","ReadableStream","start","controller","closed","safeEnqueue","chunk","enqueue","event","data","JSON","stringify","frame","type","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","rawSessionId","sessionId","Date","now","streamAgentResponse","url","URL","runId","pathname","split","pop","run","asString","value","fallback","translateSystemEvent","msg","runId","type","agentName","agent_id","model","translateAssistantEvent","events","message","content","Array","isArray","block","b","text","push","callId","id","Date","now","toolName","name","input","translateToolCallEvent","status","call_id","output","result","durationMs","isError","translateStatusEvent","s","usage","inputTokens","outputTokens","totalTokens","cost","code","retryable","translateSdkEvent","assembleM8CreateOptions","compiled","options","applied","base","systemPrompt","skills","local","settingSources","push","context","projectContext","compileProjectContext","undefined","createSdkAgentStream","compiledTools","apiKey","envModel","model","message","_sessionId","Symbol","asyncIterator","runId","Date","now","t0","Agent","defineTool","sdk","type","code","retryable","sdkTools","map","t","name","description","inputSchema","handler","m8","length","console","debug","includes","agent","create","id","tools","run","send","sawTerminal","sdkEvent","stream","translated","translateSdkEvent","event","result","usage","inputTokens","outputTokens","totalTokens","durationMs","cost","dispose","err","Error","z","DEFAULT_MAX_ITERATIONS","loopStrategyConfigSchema","z","object","name","enum","maxIterations","number","int","min","resolveLoopStrategy","strategy","cfg","parse","shouldContinue","outcome","finishReason","round","z","reflectionStrategyConfigSchema","object","name","string","min","ladderReflectionStrategy","reflect","outcome","finishReason","feedback","round","continue","noopReflectionStrategy","BudgetExceededError","Error","agentName","actualCost","budgetLimit","toFixed","name","DelegationError","cause","message","String","asString","value","fallback","asNumber","deriveFinishReason","signals","sawError","sawDone","doneFinishReason","sawToolResult","consumeOneRound","factory","prompt","sessionId","signal","r","responseText","toolCalls","cost","tokens","finishReason","errorMessage","event","aborted","type","content","push","name","toolName","input","output","usage","totalTokens","message","runReflectiveLoop","config","loop","reflection","budget","Number","POSITIVE_INFINITY","agentName","acc","response","rounds","round","feedback","err","BudgetExceededError","DelegationError","isFinite","outcome","reflectionResult","reflect","continue","shouldContinue","console","debug","strategy","AgentRunner","compiled","agentName","loopStrategy","reflectionStrategy","streamEnabled","builder","AgentClass","AgentRunnerBuilder","run","message","opts","streamFactory","createSdkAgentStream","tools","apiKey","model","sessionId","crypto","randomUUID","runReflectiveLoop","loop","reflection","budget","signal","reflectionOverride","strategy","stream","enabled","build","walk","walkAgentMetadata","toolboxInstances","Map","toolboxes","map","tb","class","compileAgent","resolveLoopStrategy","mainLoop","maxIterations","ladderReflectionStrategy","noopReflectionStrategy","agentConfig","name","requireApiKey","opts","agentName","apiKey","DelegationError","mergeTools","parentTools","subTools","subToolNames","Set","map","t","name","inherited","filter","has","delegate","SubAgentClass","message","walk","walkAgentMetadata","toolboxInstances","Map","toolboxes","tb","class","compiled","compileAgent","allTools","tools","budget","Math","min","Infinity","parentBudgetRemaining","streamFactory","createSdkAgentStream","agentConfig","model","sessionId","crypto","randomUUID","loopStrategy","resolveLoopStrategy","mainLoop","strategy","maxIterations","reflection","ladderReflectionStrategy","noopReflectionStrategy","runReflectiveLoop","loop","signal","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","compileRoutePatterns","_message","_sessionId","Promise","resolve","type","runId","Date","now","agentName","model","code","message","retryable","map","r","path","includes","regexSource","replace","regex","RegExp","find","test"]}

package/dist/chunk-MVEY7HEY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/metadata/index.ts","../src/metadata/keys.ts","../src/decorators/agent.ts","../src/decorators/policies.ts","../src/decorators/observability.ts","../src/decorators/gateway.ts","../src/decorators/sub-agents.ts","../src/decorators/memory.ts","../src/decorators/skills.ts","../src/decorators/mcp.ts","../src/decorators/context-window.ts","../src/decorators/project-context.ts","../src/decorators/mixin.ts"],"sourcesContent":["// Re-export setMeta/getMeta from http-decorators (DRY — single metadata engine)\n// Relative path for workspace-local usage; vitest resolves via alias\nexport { setMeta, getMeta } from '@theokit/http'\n\nexport * from './keys.js'\n","/** Symbol.for metadata keys for agent decorators — cross-module safe with SWC loader. */\n\nexport const AGENT_CONFIG = Symbol.for('theokit:agents:config')\nexport const AGENT_MAIN_LOOP = Symbol.for('theokit:agents:main-loop')\nexport const TOOLBOX_CONFIG = Symbol.for('theokit:agents:toolbox')\nexport const TOOL_CONFIG = Symbol.for('theokit:agents:tool')\nexport const TOOL_METHODS = Symbol.for('theokit:agents:tool-methods')\n","/**\n * @Agent() — marks a class as an AI agent controller.\n *\n * Convention over configuration:\n *   @Agent()                    → name + route inferred from class name\n *   @Agent({ model: '...' })   → name + route inferred, model explicit\n *   @Agent({ name, route, model }) → fully explicit\n *\n * @example\n * ```ts\n * // Convention: SupportAgent → name: 'support', route: '/api/agents/support'\n * @Agent()\n * class SupportAgent { ... }\n *\n * // Partial: infer name + route, set model\n * @Agent({ model: 'claude-sonnet-4-5-20250929' })\n * class SupportAgent { ... }\n *\n * // Explicit: full control\n * @Agent({ name: 'support-agent', route: '/api/agents/support', model: '...' })\n * class SupportAgent { ... }\n * ```\n */\nimport { setMeta, getMeta, AGENT_CONFIG } from '../metadata/index.js'\nimport type { AgentOptions } from '../types.js'\n\n/**\n * Infer agent name and route from class name (Rails-style convention).\n *\n * SupportAgent     → name: 'support',      route: '/api/agents/support'\n * ResearchAgent    → name: 'research',     route: '/api/agents/research'\n * CodeReviewAgent  → name: 'code-review',  route: '/api/agents/code-review'\n */\nfunction inferAgentMeta(className: string): { name: string; route: string } {\n  const stripped = className.replace(/Agent$/, '')\n  const kebab = stripped\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase()\n  return { name: kebab, route: `/api/agents/${kebab}` }\n}\n\nexport function Agent(options?: Partial<AgentOptions>): ClassDecorator {\n  return (target: Function) => {\n    const inferred = inferAgentMeta(target.name)\n    setMeta(AGENT_CONFIG, target, {\n      stream: true,\n      name: inferred.name,\n      route: inferred.route,\n      ...options, // explicit values override inferred\n    })\n  }\n}\n\nexport function getAgentConfig(target: Function): AgentOptions | undefined {\n  return getMeta<AgentOptions>(AGENT_CONFIG, target)\n}\n","/**\n * Agent-native policy decorators — built on http-decorators' createDecorator<T>().\n *\n * These decorators work with Reflector.getAllAndOverride() for hierarchical\n * resolution: tool → toolbox → agent (method-level overrides class-level).\n */\nimport { createDecorator } from '@theokit/http'\n\nimport type { ApprovalOptions, BudgetOptions, PolicyHandler } from '../types.js'\n\n/** Mark a tool as requiring human approval before execution. */\nexport const RequiresApproval = createDecorator<ApprovalOptions>()\n\n/** Require specific capabilities (permissions) to execute a tool. */\nexport const RequiresCapability = createDecorator<string[]>()\n\n/** Set a cost budget for an agent or tool scope. */\nexport const Budget = createDecorator<BudgetOptions>()\n\n/** Attach policy handler functions (CASL-style authorization). */\nexport const Policy = createDecorator<PolicyHandler[]>()\n","/**\n * Observability decorators for agent tracing and auditing.\n */\nimport { createDecorator } from '@theokit/http'\n\n/** Enable distributed tracing for a tool/toolbox/agent. */\nexport const Trace = createDecorator<boolean>()\n\n/** Enable audit logging for a tool/toolbox/agent. */\nexport const Audit = createDecorator<boolean>()\n","/**\n * @Gateway() — declares which platform adapters an agent supports.\n *\n * Stores gateway configuration metadata on the agent class.\n * The GatewayRunner reads this to auto-wire adapters without manual plumbing.\n *\n * @example\n * ```ts\n * @Agent({ name: 'support', route: '/api/agents/support' })\n * @Gateway({\n *   platforms: ['telegram', 'discord', 'slack'],\n *   sessionStrategy: 'per-user',\n * })\n * @UseGuards(AuthGuard)\n * class SupportAgent {\n *   @MainLoop()\n *   async run(ctx: AgentContext) { ... }\n * }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst GATEWAY_CONFIG = Symbol.for('theokit:agents:gateway')\n\nexport type PlatformName =\n  | 'telegram'\n  | 'discord'\n  | 'slack'\n  | 'whatsapp'\n  | 'teams'\n  | 'email'\n  | 'sms'\n  | 'mattermost'\n  | 'line'\n  | 'matrix'\n\nexport type SessionStrategy =\n  | 'per-user'       // telegram-dm-{userId}\n  | 'per-channel'    // telegram-grp-{channelId}\n  | 'per-thread'     // telegram-tpc-{channelId}-{topicId}\n\nexport interface GatewayOptions {\n  /** Platform adapters this agent supports. */\n  platforms: PlatformName[]\n  /** How to resolve agentId from inbound events (default: 'per-user'). */\n  sessionStrategy?: SessionStrategy\n  /** Auto-start typing indicator while agent processes (default: true). */\n  typing?: boolean\n}\n\nexport function Gateway(options: GatewayOptions): ClassDecorator {\n  return (target: Function) => {\n    setMeta(GATEWAY_CONFIG, target, { typing: true, sessionStrategy: 'per-user', ...options })\n  }\n}\n\nexport function getGatewayConfig(target: Function): GatewayOptions | undefined {\n  return getMeta<GatewayOptions>(GATEWAY_CONFIG, target)\n}\n\n/**\n * Resolve a stable agentId from a platform event based on the session strategy.\n *\n * Mirrors @theokit/gateway SessionRouter.defaultStrategy() but is configurable\n * via the @Gateway decorator.\n */\nexport function resolveSessionId(\n  strategy: SessionStrategy,\n  platform: string,\n  sender: { id: string },\n  channel: { id: string; type: 'dm' | 'group' | 'thread'; topicId?: string },\n): string {\n  switch (strategy) {\n    case 'per-user':\n      return `${platform}-dm-${sender.id}`\n    case 'per-channel':\n      return `${platform}-grp-${channel.id}`\n    case 'per-thread':\n      return `${platform}-tpc-${channel.id}-${channel.topicId ?? 'main'}`\n  }\n}\n","/**\n * @SubAgents() — declares child agents that a parent agent can handoff to.\n *\n * Compiles to the SDK's `AgentOptions.agents` map. The parent agent\n * can delegate work to sub-agents via the built-in Agent tool.\n *\n * @example\n * ```ts\n * @Agent({ name: 'orchestrator', route: '/api/agents/orchestrator' })\n * @SubAgents([ResearchAgent, CoderAgent, ReviewerAgent])\n * class OrchestratorAgent {\n *   @MainLoop({ strategy: 'plan-act-reflect' })\n *   async run(ctx: AgentContext) { ... }\n * }\n * ```\n *\n * Each referenced class MUST be decorated with @Agent().\n * The compiler reads their metadata to build the SDK agents map.\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nimport { getAgentConfig } from './agent.js'\n\nconst SUB_AGENTS = Symbol.for('theokit:agents:sub-agents')\n\nexport function SubAgents(agentClasses: Function[]): ClassDecorator {\n  return (target: Function) => {\n    // Validate at decoration time: all classes must have @Agent\n    for (const cls of agentClasses) {\n      const config = getAgentConfig(cls)\n      if (!config) {\n        throw new Error(\n          `[@theokit/agents] @SubAgents on ${target.name}: class ${cls.name} is missing @Agent() decorator.`,\n        )\n      }\n    }\n    setMeta(SUB_AGENTS, target, agentClasses)\n  }\n}\n\nexport function getSubAgents(target: Function): Function[] {\n  return getMeta<Function[]>(SUB_AGENTS, target) ?? []\n}\n","/**\n * @Memory() — declares persistent memory configuration for an agent.\n *\n * Compiles to SDK's MemorySettings in Agent.create({ memory }).\n * Memory is per-agent, scoped by session strategy.\n *\n * @example\n * ```ts\n * @Agent({ name: 'support', route: '/api/agents/support' })\n * @Memory({ provider: 'built-in', embeddings: true, fts: true, scope: 'per-user' })\n * class SupportAgent { ... }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst MEMORY_CONFIG = Symbol.for('theokit:agents:memory')\n\nexport type MemoryProvider = 'built-in' | 'honcho' | 'supermemory' | 'mem0'\nexport type MemoryScope = 'per-user' | 'per-agent' | 'per-tenant' | 'global'\n\nexport interface MemoryOptions {\n  /** Memory provider backend. */\n  provider?: MemoryProvider\n  /** Enable semantic search via embeddings. */\n  embeddings?: boolean\n  /** Enable full-text search (FTS5). */\n  fts?: boolean\n  /** Memory isolation scope (default: 'per-user'). */\n  scope?: MemoryScope\n  /** Maximum facts to retain per scope (0 = unlimited). */\n  maxFacts?: number\n}\n\nexport function Memory(options: MemoryOptions = {}): ClassDecorator {\n  return (target: Function) => {\n    setMeta(MEMORY_CONFIG, target, {\n      provider: 'built-in',\n      embeddings: false,\n      fts: false,\n      scope: 'per-user',\n      ...options,\n    })\n  }\n}\n\nexport function getMemoryConfig(target: Function): MemoryOptions | undefined {\n  return getMeta<MemoryOptions>(MEMORY_CONFIG, target)\n}\n","/**\n * @Skills() — declares markdown skill files injected into the agent's system prompt.\n *\n * Compiles to SDK's SkillsSettings in Agent.create({ skills }).\n * Skills are .theokit/skills/<name>/SKILL.md files discovered at agent creation.\n *\n * @example\n * ```ts\n * @Agent({ name: 'support', route: '/api/agents/support' })\n * @Skills(['customer-service', 'refund-policy', 'escalation-protocol'])\n * class SupportAgent { ... }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst SKILLS_CONFIG = Symbol.for('theokit:agents:skills')\n\nexport interface SkillsOptions {\n  /** Skill names to include (resolved from .theokit/skills/<name>/SKILL.md). */\n  include: string[]\n  /** Auto-discover all skills in .theokit/skills/ (default: false). */\n  autoDiscover?: boolean\n}\n\nexport function Skills(namesOrOptions: string[] | SkillsOptions): ClassDecorator {\n  return (target: Function) => {\n    const options: SkillsOptions = Array.isArray(namesOrOptions)\n      ? { include: namesOrOptions, autoDiscover: false }\n      : namesOrOptions\n    setMeta(SKILLS_CONFIG, target, options)\n  }\n}\n\nexport function getSkillsConfig(target: Function): SkillsOptions | undefined {\n  return getMeta<SkillsOptions>(SKILLS_CONFIG, target)\n}\n","/**\n * @MCP() — declares Model Context Protocol servers available to an agent.\n *\n * Compiles to SDK's mcpServers in Agent.create({ mcpServers }).\n * Each key is a server name; the value is the server configuration.\n *\n * @example\n * ```ts\n * @Agent({ name: 'dev', route: '/api/agents/dev' })\n * @MCP({\n *   github: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-github'] },\n *   filesystem: { command: 'npx', args: ['-y', '@mcp/server-filesystem', '/workspace'] },\n * })\n * class DevAgent { ... }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst MCP_CONFIG = Symbol.for('theokit:agents:mcp')\n\nexport interface McpServerConfig {\n  /** Command to start the MCP server. */\n  command: string\n  /** Arguments passed to the command. */\n  args?: string[]\n  /** Environment variables for the server process. */\n  env?: Record<string, string>\n  /** Working directory for the server process. */\n  cwd?: string\n}\n\nexport type McpServersMap = Record<string, McpServerConfig>\n\nexport function MCP(servers: McpServersMap): ClassDecorator {\n  return (target: Function) => {\n    setMeta(MCP_CONFIG, target, servers)\n  }\n}\n\nexport function getMcpConfig(target: Function): McpServersMap | undefined {\n  return getMeta<McpServersMap>(MCP_CONFIG, target)\n}\n","/**\n * @ContextWindow() — declares context window management strategy.\n *\n * Controls how the agent handles context when conversation history grows\n * beyond the LLM's context window. Mirrors Claude Code's PreCompact behavior.\n *\n * @example\n * ```ts\n * @Agent({ name: 'research', route: '/research' })\n * @ContextWindow({\n *   maxTokens: 100_000,\n *   compactionStrategy: 'summarize-oldest',\n *   preserveSystemPrompt: true,\n *   preserveLastN: 10,\n * })\n * class ResearchAgent { ... }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst CONTEXT_WINDOW_CONFIG = Symbol.for('theokit:agents:context-window')\n\nexport type ContextCompactionStrategy =\n  | 'truncate-oldest'      // Drop oldest messages beyond limit\n  | 'summarize-oldest'     // LLM-summarize oldest messages into a single message\n  | 'sliding-window'       // Keep last N messages only\n  | 'priority-based'       // Keep tool results + recent; summarize reasoning\n\nexport interface ContextWindowOptions {\n  /** Maximum tokens before compaction triggers. */\n  maxTokens?: number\n  /** How to compact when maxTokens is exceeded. */\n  compactionStrategy?: ContextCompactionStrategy\n  /** Always preserve the system prompt during compaction (default: true). */\n  preserveSystemPrompt?: boolean\n  /** Number of recent messages to always keep intact (default: 10). */\n  preserveLastN?: number\n  /** Keep all tool results even during compaction (default: true). */\n  preserveToolResults?: boolean\n}\n\nexport function ContextWindow(options: ContextWindowOptions = {}): ClassDecorator {\n  return (target: Function) => {\n    setMeta(CONTEXT_WINDOW_CONFIG, target, {\n      maxTokens: 100_000,\n      compactionStrategy: 'summarize-oldest',\n      preserveSystemPrompt: true,\n      preserveLastN: 10,\n      preserveToolResults: true,\n      ...options,\n    })\n  }\n}\n\nexport function getContextWindowConfig(target: Function): ContextWindowOptions | undefined {\n  return getMeta<ContextWindowOptions>(CONTEXT_WINDOW_CONFIG, target)\n}\n","/**\n * @ProjectContext() — declares how the agent understands the codebase.\n *\n * A code assistant needs to know: what's the project root, which files\n * are relevant, how to parse code structure, what to ignore. This\n * metadata feeds the context window management and file discovery.\n *\n * @example\n * ```ts\n * @Agent({ name: 'coder', route: '/agents/coder' })\n * @ProjectContext({\n *   rootMarkers: ['package.json', 'tsconfig.json'],\n *   indexStrategy: 'tree-sitter',\n *   maxFilesInContext: 20,\n *   relevanceStrategy: 'git-history',\n *   ignorePatterns: ['node_modules', 'dist', '.git'],\n * })\n * class CoderAgent { ... }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst PROJECT_CONTEXT_CONFIG = Symbol.for('theokit:agents:project-context')\n\nexport type IndexStrategy =\n  | 'tree-sitter'    // Parse AST for structural understanding\n  | 'regex'          // Simple regex-based symbol extraction\n  | 'none'           // No indexing — rely on grep/glob only\n\nexport type RelevanceStrategy =\n  | 'git-history'     // Prioritize recently-edited files\n  | 'import-graph'    // Follow import chains from entry points\n  | 'semantic'        // Embedding-based similarity search\n  | 'manual'          // Only files explicitly provided\n\nexport interface ProjectContextOptions {\n  /** Files that mark the project root (searched upward from cwd). */\n  rootMarkers?: string[]\n  /** How to index the codebase for structural understanding. */\n  indexStrategy?: IndexStrategy\n  /** Maximum files to include in context per request. */\n  maxFilesInContext?: number\n  /** How to rank file relevance when selecting context. */\n  relevanceStrategy?: RelevanceStrategy\n  /** Glob patterns to exclude from indexing and context. */\n  ignorePatterns?: string[]\n  /** File extensions to include in indexing (default: all text files). */\n  includeExtensions?: string[]\n}\n\nexport function ProjectContext(options: ProjectContextOptions = {}): ClassDecorator {\n  return (target: Function) => {\n    setMeta(PROJECT_CONTEXT_CONFIG, target, {\n      rootMarkers: ['package.json', 'tsconfig.json', 'go.mod', 'Cargo.toml', 'pyproject.toml'],\n      indexStrategy: 'regex',\n      maxFilesInContext: 20,\n      relevanceStrategy: 'git-history',\n      ignorePatterns: ['node_modules', 'dist', 'build', '.git', 'coverage', '__pycache__'],\n      ...options,\n    })\n  }\n}\n\nexport function getProjectContextConfig(target: Function): ProjectContextOptions | undefined {\n  return getMeta<ProjectContextOptions>(PROJECT_CONTEXT_CONFIG, target)\n}\n","/**\n * @Mixin() — compose reusable capability classes into an agent.\n *\n * Mixins are classes with @Tool methods that can be shared across agents.\n * @Mixin copies tool metadata from mixin classes to the decorated agent,\n * making those tools available without inheritance.\n *\n * @example\n * ```ts\n * // Define reusable capabilities\n * class WithSearchCapability {\n *   @Tool({ name: 'web_search', description: 'Search', input: z.object({...}) })\n *   async webSearch(input) { ... }\n * }\n *\n * class WithFileSystem {\n *   @Tool({ name: 'read_file', description: 'Read', input: z.object({...}) })\n *   async readFile(input) { ... }\n * }\n *\n * // Compose into agent\n * @Agent({ name: 'research', route: '/research' })\n * @Mixin(WithSearchCapability, WithFileSystem)\n * class ResearchAgent {\n *   @MainLoop()\n *   async run() {}\n * }\n * ```\n */\nimport { setMeta, getMeta } from '../metadata/index.js'\n\nconst MIXIN_CLASSES = Symbol.for('theokit:agents:mixins')\n\nexport function Mixin(...mixinClasses: Function[]): ClassDecorator {\n  return (target: Function) => {\n    const existing = getMeta<Function[]>(MIXIN_CLASSES, target) ?? []\n    setMeta(MIXIN_CLASSES, target, [...existing, ...mixinClasses])\n  }\n}\n\nexport function getMixins(target: Function): Function[] {\n  return getMeta<Function[]>(MIXIN_CLASSES, target) ?? []\n}\n"],"mappings":"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","names":["setMeta","getMeta","AGENT_CONFIG","Symbol","for","AGENT_MAIN_LOOP","TOOLBOX_CONFIG","TOOL_CONFIG","TOOL_METHODS","inferAgentMeta","className","stripped","replace","kebab","toLowerCase","name","route","Agent","options","target","inferred","setMeta","AGENT_CONFIG","stream","getAgentConfig","getMeta","createDecorator","RequiresApproval","RequiresCapability","Budget","Policy","createDecorator","Trace","Audit","GATEWAY_CONFIG","Symbol","for","Gateway","options","target","setMeta","typing","sessionStrategy","getGatewayConfig","getMeta","resolveSessionId","strategy","platform","sender","channel","id","topicId","SUB_AGENTS","Symbol","for","SubAgents","agentClasses","target","cls","config","getAgentConfig","Error","name","setMeta","getSubAgents","getMeta","MEMORY_CONFIG","Symbol","for","Memory","options","target","setMeta","provider","embeddings","fts","scope","getMemoryConfig","getMeta","SKILLS_CONFIG","Symbol","for","Skills","namesOrOptions","target","options","Array","isArray","include","autoDiscover","setMeta","getSkillsConfig","getMeta","MCP_CONFIG","Symbol","for","MCP","servers","target","setMeta","getMcpConfig","getMeta","CONTEXT_WINDOW_CONFIG","Symbol","for","ContextWindow","options","target","setMeta","maxTokens","compactionStrategy","preserveSystemPrompt","preserveLastN","preserveToolResults","getContextWindowConfig","getMeta","PROJECT_CONTEXT_CONFIG","Symbol","for","ProjectContext","options","target","setMeta","rootMarkers","indexStrategy","maxFilesInContext","relevanceStrategy","ignorePatterns","getProjectContextConfig","getMeta","MIXIN_CLASSES","Symbol","for","Mixin","mixinClasses","target","existing","getMeta","setMeta","getMixins"]}