theokit 0.25.0 → 0.27.0

package/dist/{agent-GXJNFW6N.js → agent-I5QEOMCN.js}

@@ -3,7 +3,7 @@ import "tsx/esm";
 import {
   agentCommand,
   createAgentSsrLoader
-} from "./chunk-LVGDYTU2.js";
+} from "./chunk-Y4TOVMNC.js";
 import "./chunk-M6NMS5LR.js";
 import "./chunk-GDN3PXFH.js";
 import "./chunk-TERFLG67.js";
@@ -12,4 +12,4 @@ export {
   agentCommand,
   createAgentSsrLoader
 };
-//# sourceMappingURL=agent-GXJNFW6N.js.map
+//# sourceMappingURL=agent-I5QEOMCN.js.map

package/dist/{agents-typed-client-RIJVHSX4.js → agents-typed-client-5DCGDWFZ.js}

@@ -48,13 +48,19 @@ ${entries.join("\n")}
   return `${FILE_HEADER}
 declare module '@theo/agents' {
   import type { InferAgentInput, InferAgentToolNames } from '@theokit/agents'
-  import type { UseAgentReturn } from 'theokit/client'
+  import type { UseAgentReturn, AgentTransport } from 'theokit/client'
 ${importBlock}
   export interface AppAgents ${body}
 
+  // Web (and any HTTP surface): bind by agent name \u2014 \`send\` is typed to the agent's \`input\` schema.
   export function useAgent<K extends keyof AppAgents>(
     name: K,
   ): UseAgentReturn<AppAgents[K]['input'], AppAgents[K]['tools']>
+  // M41 (ADR-0050) \u2014 terminal/desktop (and advanced): bind by an explicit AgentTransport
+  // (e.g. InProcessTransport). The SAME hook, one consumption shape across every surface.
+  export function useAgent<TInput = unknown>(
+    transport: AgentTransport,
+  ): UseAgentReturn<TInput>
 }
 `;
 }
@@ -145,4 +151,4 @@ export {
   agentsTypedClientPlugin,
   generateAgentsDts
 };
-//# sourceMappingURL=agents-typed-client-RIJVHSX4.js.map
+//# sourceMappingURL=agents-typed-client-5DCGDWFZ.js.map

package/dist/agents-typed-client-5DCGDWFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin/agents-typed-client.ts"],"sourcesContent":["/* eslint-disable security/detect-non-literal-fs-filename --\n * Codegen-time fs ops: all paths derive from `opts.projectRoot` / `opts.distDir`\n * (vite plugin opts — trusted, set by the framework's CLI). Never serves HTTP input.\n */\n/**\n * M2 (theokit-ai-first) — end-to-end typed binding for the `agents/*.ts` convention.\n *\n * Sibling of `app-typed-client.ts` (kept separate so the `@theo/client` output stays\n * byte-unchanged). Two parts:\n *\n * 1. `generateAgentsDts({ manifest, dtsOutPath, projectRoot })` — pure function emitting\n *    `.theokit/agents.d.ts` (the virtual `@theo/agents` module) with `AppAgents` mapping\n *    each scanned agent to `InferAgentInput` of its `defineAgent({ input })` schema, plus a\n *    typed `useAgent` signature — so the client binds to `/api/agents/<name>` with the right\n *    request type and ZERO manual wiring (DoD line 2).\n * 2. `agentsTypedClientPlugin(opts)` — Vite plugin that emits (1), rewrites on `agents/*`\n *    changes, and serves the virtual `@theo/agents` runtime (`useAgent` from `theokit/client`).\n */\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'\nimport { dirname, posix } from 'node:path'\n\nimport type { Plugin, ViteDevServer } from 'vite'\n\nimport type { TheoManifest } from '../server/internal-api.js'\n\nconst FILE_HEADER = `// AUTO-GENERATED by theokit — do not edit.\n// Source: theokit/packages/theo/src/vite-plugin/agents-typed-client.ts (M2).\n// To refresh: \\`pnpm dev\\` or \\`pnpm build\\` regenerates this on every agents/ change.\n\n/* eslint-disable */\n`\n\n/** A safe TS identifier alias for an agent (name may contain path separators). */\nfunction aliasFor(name: string): string {\n  return `_agent_${name.replace(/[^\\w$]/g, '_')}`\n}\n\n/** Relative `import type` path from the .d.ts dir to the agent source (extension stripped). */\nfunction importPath(dtsOutPath: string, projectRoot: string, filePath: string): string {\n  const fromDir = dirname(dtsOutPath).replace(/\\\\/g, '/')\n  const abs = posix.join(projectRoot.replace(/\\\\/g, '/'), filePath.replace(/\\\\/g, '/'))\n  const noExt = abs.replace(/\\.[jt]sx?$/, '')\n  let rel = posix.relative(fromDir, noExt)\n  if (!rel.startsWith('.')) rel = `./${rel}`\n  return rel\n}\n\nexport interface GenerateAgentsDtsOptions {\n  manifest: TheoManifest\n  /** Absolute path to the .d.ts that will be emitted (drives the import paths). */\n  dtsOutPath: string\n  /** Absolute project root — agents live at `<projectRoot>/agents`. */\n  projectRoot: string\n}\n\nexport function generateAgentsDts({\n  manifest,\n  dtsOutPath,\n  projectRoot,\n}: GenerateAgentsDtsOptions): string {\n  const agents = manifest.agents ?? []\n  const imports: string[] = []\n  const entries: string[] = []\n  for (const agent of agents) {\n    const alias = aliasFor(agent.name)\n    imports.push(\n      `  import type ${alias} from '${importPath(dtsOutPath, projectRoot, agent.filePath)}'`,\n    )\n    entries.push(\n      `    '${agent.name}': { input: InferAgentInput<${alias}>; tools: InferAgentToolNames<${alias}> }`,\n    )\n  }\n\n  const body =\n    entries.length > 0\n      ? `{\\n${entries.join('\\n')}\\n  }`\n      : `{\\n    // No agents detected — add \\`agents/*.ts\\` to populate this binding.\\n  }`\n\n  const importBlock = imports.length > 0 ? `${imports.join('\\n')}\\n` : ''\n\n  return `${FILE_HEADER}\ndeclare module '@theo/agents' {\n  import type { InferAgentInput, InferAgentToolNames } from '@theokit/agents'\n  import type { UseAgentReturn, AgentTransport } from 'theokit/client'\n${importBlock}\n  export interface AppAgents ${body}\n\n  // Web (and any HTTP surface): bind by agent name — \\`send\\` is typed to the agent's \\`input\\` schema.\n  export function useAgent<K extends keyof AppAgents>(\n    name: K,\n  ): UseAgentReturn<AppAgents[K]['input'], AppAgents[K]['tools']>\n  // M41 (ADR-0050) — terminal/desktop (and advanced): bind by an explicit AgentTransport\n  // (e.g. InProcessTransport). The SAME hook, one consumption shape across every surface.\n  export function useAgent<TInput = unknown>(\n    transport: AgentTransport,\n  ): UseAgentReturn<TInput>\n}\n`\n}\n\n// ─── Vite plugin ─────────────────────────────────────────────────────────────\n\nconst VIRTUAL_AGENTS_ID = '@theo/agents'\nconst RESOLVED_AGENTS_ID = '\\0@theo/agents'\n\nexport interface AgentsTypedClientPluginOptions {\n  /** Absolute project root (agents live at `<projectRoot>/<agentsDir>`). */\n  projectRoot: string\n  /** Agents dir name (config `agentsDir`, default \"agents\"), relative to projectRoot — the watch glob. */\n  agentsDir?: string\n  /** Absolute `.theokit/` output dir (where `agents.d.ts` lands). */\n  distDir: string\n  /** Injects the scanned agents; returns the current manifest-shaped agent list. */\n  scanManifest: (projectRoot: string) => TheoManifest\n}\n\n/** Atomic write via tmp + rename; skips when content is unchanged. */\nfunction writeIfChanged(filePath: string, content: string): void {\n  if (existsSync(filePath)) {\n    try {\n      if (readFileSync(filePath, 'utf-8') === content) return\n    } catch {\n      /* fall through to write */\n    }\n  }\n  mkdirSync(dirname(filePath), { recursive: true })\n  const tmp = `${filePath}.${process.pid}.tmp`\n  writeFileSync(tmp, content)\n  renameSync(tmp, filePath)\n}\n\nfunction emitAgentsDts(opts: AgentsTypedClientPluginOptions): string {\n  const dtsOutPath = posix.join(opts.distDir.replace(/\\\\/g, '/'), 'agents.d.ts')\n  const content = generateAgentsDts({\n    manifest: opts.scanManifest(opts.projectRoot),\n    dtsOutPath,\n    projectRoot: opts.projectRoot,\n  })\n  writeIfChanged(dtsOutPath, content)\n  return dtsOutPath\n}\n\nexport function agentsTypedClientPlugin(opts: AgentsTypedClientPluginOptions): Plugin {\n  let debounce: NodeJS.Timeout | undefined\n  let viteServer: ViteDevServer | undefined\n\n  const scheduleEmit = (): void => {\n    if (debounce) clearTimeout(debounce)\n    debounce = setTimeout(() => {\n      try {\n        emitAgentsDts(opts)\n        if (viteServer) {\n          const mod = viteServer.moduleGraph.getModuleById(RESOLVED_AGENTS_ID)\n          if (mod) viteServer.moduleGraph.invalidateModule(mod)\n        }\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] codegen error:', err)\n      }\n    }, 100)\n  }\n\n  return {\n    name: 'theokit:agents-typed-client',\n    enforce: 'post',\n    configResolved() {\n      try {\n        emitAgentsDts(opts)\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] initial codegen error:', err)\n      }\n    },\n    buildEnd() {\n      try {\n        emitAgentsDts(opts)\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] buildEnd codegen error:', err)\n      }\n    },\n    configureServer(server) {\n      viteServer = server\n      const agentsGlob = posix.join(\n        opts.projectRoot.replace(/\\\\/g, '/'),\n        opts.agentsDir ?? 'agents',\n      )\n      const onFile = (file: string): void => {\n        if (file.replace(/\\\\/g, '/').startsWith(agentsGlob)) scheduleEmit()\n      }\n      server.watcher.on('add', onFile)\n      server.watcher.on('change', onFile)\n      server.watcher.on('unlink', onFile)\n    },\n    resolveId(id) {\n      return id === VIRTUAL_AGENTS_ID ? RESOLVED_AGENTS_ID : null\n    },\n    load(id) {\n      if (id === RESOLVED_AGENTS_ID) {\n        return `export { useAgent } from 'theokit/client'\\n`\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{agents-typed-client-DCPSXUU5.js → agents-typed-client-MAAILRI6.js}

@@ -47,13 +47,19 @@ ${entries.join("\n")}
   return `${FILE_HEADER}
 declare module '@theo/agents' {
   import type { InferAgentInput, InferAgentToolNames } from '@theokit/agents'
-  import type { UseAgentReturn } from 'theokit/client'
+  import type { UseAgentReturn, AgentTransport } from 'theokit/client'
 ${importBlock}
   export interface AppAgents ${body}
 
+  // Web (and any HTTP surface): bind by agent name \u2014 \`send\` is typed to the agent's \`input\` schema.
   export function useAgent<K extends keyof AppAgents>(
     name: K,
   ): UseAgentReturn<AppAgents[K]['input'], AppAgents[K]['tools']>
+  // M41 (ADR-0050) \u2014 terminal/desktop (and advanced): bind by an explicit AgentTransport
+  // (e.g. InProcessTransport). The SAME hook, one consumption shape across every surface.
+  export function useAgent<TInput = unknown>(
+    transport: AgentTransport,
+  ): UseAgentReturn<TInput>
 }
 `;
 }
@@ -144,4 +150,4 @@ export {
   agentsTypedClientPlugin,
   generateAgentsDts
 };
-//# sourceMappingURL=agents-typed-client-DCPSXUU5.js.map
+//# sourceMappingURL=agents-typed-client-MAAILRI6.js.map

package/dist/agents-typed-client-MAAILRI6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin/agents-typed-client.ts"],"sourcesContent":["/* eslint-disable security/detect-non-literal-fs-filename --\n * Codegen-time fs ops: all paths derive from `opts.projectRoot` / `opts.distDir`\n * (vite plugin opts — trusted, set by the framework's CLI). Never serves HTTP input.\n */\n/**\n * M2 (theokit-ai-first) — end-to-end typed binding for the `agents/*.ts` convention.\n *\n * Sibling of `app-typed-client.ts` (kept separate so the `@theo/client` output stays\n * byte-unchanged). Two parts:\n *\n * 1. `generateAgentsDts({ manifest, dtsOutPath, projectRoot })` — pure function emitting\n *    `.theokit/agents.d.ts` (the virtual `@theo/agents` module) with `AppAgents` mapping\n *    each scanned agent to `InferAgentInput` of its `defineAgent({ input })` schema, plus a\n *    typed `useAgent` signature — so the client binds to `/api/agents/<name>` with the right\n *    request type and ZERO manual wiring (DoD line 2).\n * 2. `agentsTypedClientPlugin(opts)` — Vite plugin that emits (1), rewrites on `agents/*`\n *    changes, and serves the virtual `@theo/agents` runtime (`useAgent` from `theokit/client`).\n */\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'\nimport { dirname, posix } from 'node:path'\n\nimport type { Plugin, ViteDevServer } from 'vite'\n\nimport type { TheoManifest } from '../server/internal-api.js'\n\nconst FILE_HEADER = `// AUTO-GENERATED by theokit — do not edit.\n// Source: theokit/packages/theo/src/vite-plugin/agents-typed-client.ts (M2).\n// To refresh: \\`pnpm dev\\` or \\`pnpm build\\` regenerates this on every agents/ change.\n\n/* eslint-disable */\n`\n\n/** A safe TS identifier alias for an agent (name may contain path separators). */\nfunction aliasFor(name: string): string {\n  return `_agent_${name.replace(/[^\\w$]/g, '_')}`\n}\n\n/** Relative `import type` path from the .d.ts dir to the agent source (extension stripped). */\nfunction importPath(dtsOutPath: string, projectRoot: string, filePath: string): string {\n  const fromDir = dirname(dtsOutPath).replace(/\\\\/g, '/')\n  const abs = posix.join(projectRoot.replace(/\\\\/g, '/'), filePath.replace(/\\\\/g, '/'))\n  const noExt = abs.replace(/\\.[jt]sx?$/, '')\n  let rel = posix.relative(fromDir, noExt)\n  if (!rel.startsWith('.')) rel = `./${rel}`\n  return rel\n}\n\nexport interface GenerateAgentsDtsOptions {\n  manifest: TheoManifest\n  /** Absolute path to the .d.ts that will be emitted (drives the import paths). */\n  dtsOutPath: string\n  /** Absolute project root — agents live at `<projectRoot>/agents`. */\n  projectRoot: string\n}\n\nexport function generateAgentsDts({\n  manifest,\n  dtsOutPath,\n  projectRoot,\n}: GenerateAgentsDtsOptions): string {\n  const agents = manifest.agents ?? []\n  const imports: string[] = []\n  const entries: string[] = []\n  for (const agent of agents) {\n    const alias = aliasFor(agent.name)\n    imports.push(\n      `  import type ${alias} from '${importPath(dtsOutPath, projectRoot, agent.filePath)}'`,\n    )\n    entries.push(\n      `    '${agent.name}': { input: InferAgentInput<${alias}>; tools: InferAgentToolNames<${alias}> }`,\n    )\n  }\n\n  const body =\n    entries.length > 0\n      ? `{\\n${entries.join('\\n')}\\n  }`\n      : `{\\n    // No agents detected — add \\`agents/*.ts\\` to populate this binding.\\n  }`\n\n  const importBlock = imports.length > 0 ? `${imports.join('\\n')}\\n` : ''\n\n  return `${FILE_HEADER}\ndeclare module '@theo/agents' {\n  import type { InferAgentInput, InferAgentToolNames } from '@theokit/agents'\n  import type { UseAgentReturn, AgentTransport } from 'theokit/client'\n${importBlock}\n  export interface AppAgents ${body}\n\n  // Web (and any HTTP surface): bind by agent name — \\`send\\` is typed to the agent's \\`input\\` schema.\n  export function useAgent<K extends keyof AppAgents>(\n    name: K,\n  ): UseAgentReturn<AppAgents[K]['input'], AppAgents[K]['tools']>\n  // M41 (ADR-0050) — terminal/desktop (and advanced): bind by an explicit AgentTransport\n  // (e.g. InProcessTransport). The SAME hook, one consumption shape across every surface.\n  export function useAgent<TInput = unknown>(\n    transport: AgentTransport,\n  ): UseAgentReturn<TInput>\n}\n`\n}\n\n// ─── Vite plugin ─────────────────────────────────────────────────────────────\n\nconst VIRTUAL_AGENTS_ID = '@theo/agents'\nconst RESOLVED_AGENTS_ID = '\\0@theo/agents'\n\nexport interface AgentsTypedClientPluginOptions {\n  /** Absolute project root (agents live at `<projectRoot>/<agentsDir>`). */\n  projectRoot: string\n  /** Agents dir name (config `agentsDir`, default \"agents\"), relative to projectRoot — the watch glob. */\n  agentsDir?: string\n  /** Absolute `.theokit/` output dir (where `agents.d.ts` lands). */\n  distDir: string\n  /** Injects the scanned agents; returns the current manifest-shaped agent list. */\n  scanManifest: (projectRoot: string) => TheoManifest\n}\n\n/** Atomic write via tmp + rename; skips when content is unchanged. */\nfunction writeIfChanged(filePath: string, content: string): void {\n  if (existsSync(filePath)) {\n    try {\n      if (readFileSync(filePath, 'utf-8') === content) return\n    } catch {\n      /* fall through to write */\n    }\n  }\n  mkdirSync(dirname(filePath), { recursive: true })\n  const tmp = `${filePath}.${process.pid}.tmp`\n  writeFileSync(tmp, content)\n  renameSync(tmp, filePath)\n}\n\nfunction emitAgentsDts(opts: AgentsTypedClientPluginOptions): string {\n  const dtsOutPath = posix.join(opts.distDir.replace(/\\\\/g, '/'), 'agents.d.ts')\n  const content = generateAgentsDts({\n    manifest: opts.scanManifest(opts.projectRoot),\n    dtsOutPath,\n    projectRoot: opts.projectRoot,\n  })\n  writeIfChanged(dtsOutPath, content)\n  return dtsOutPath\n}\n\nexport function agentsTypedClientPlugin(opts: AgentsTypedClientPluginOptions): Plugin {\n  let debounce: NodeJS.Timeout | undefined\n  let viteServer: ViteDevServer | undefined\n\n  const scheduleEmit = (): void => {\n    if (debounce) clearTimeout(debounce)\n    debounce = setTimeout(() => {\n      try {\n        emitAgentsDts(opts)\n        if (viteServer) {\n          const mod = viteServer.moduleGraph.getModuleById(RESOLVED_AGENTS_ID)\n          if (mod) viteServer.moduleGraph.invalidateModule(mod)\n        }\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] codegen error:', err)\n      }\n    }, 100)\n  }\n\n  return {\n    name: 'theokit:agents-typed-client',\n    enforce: 'post',\n    configResolved() {\n      try {\n        emitAgentsDts(opts)\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] initial codegen error:', err)\n      }\n    },\n    buildEnd() {\n      try {\n        emitAgentsDts(opts)\n      } catch (err) {\n        console.error('[theokit:agents-typed-client] buildEnd codegen error:', err)\n      }\n    },\n    configureServer(server) {\n      viteServer = server\n      const agentsGlob = posix.join(\n        opts.projectRoot.replace(/\\\\/g, '/'),\n        opts.agentsDir ?? 'agents',\n      )\n      const onFile = (file: string): void => {\n        if (file.replace(/\\\\/g, '/').startsWith(agentsGlob)) scheduleEmit()\n      }\n      server.watcher.on('add', onFile)\n      server.watcher.on('change', onFile)\n      server.watcher.on('unlink', onFile)\n    },\n    resolveId(id) {\n      return id === VIRTUAL_AGENTS_ID ? RESOLVED_AGENTS_ID : null\n    },\n    load(id) {\n      if (id === RESOLVED_AGENTS_ID) {\n        return `export { useAgent } from 'theokit/client'\\n`\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{build-WD2PT5TA.js → build-V2QEBE7I.js}

@@ -531,7 +531,7 @@ async function buildCommand(options) {
 `);
 }
 async function runAdapterBuild(target, config, cwd) {
-  const { theoPluginAsync } = await import("./vite-plugin-ST4JZQRJ.js");
+  const { theoPluginAsync } = await import("./vite-plugin-BNI7YLCD.js");
   const { default: react } = await import("@vitejs/plugin-react");
   const ctx = {
     // `react()` may return Plugin or Plugin[] depending on version; spread the
@@ -616,4 +616,4 @@ function relativize3(absPath, root) {
 export {
   buildCommand
 };
-//# sourceMappingURL=build-WD2PT5TA.js.map
+//# sourceMappingURL=build-V2QEBE7I.js.map

package/dist/{chunk-2JNG3P4Y.js → chunk-R4VVXLKZ.js}

@@ -3353,7 +3353,7 @@ async function theoPluginAsync(rootOrOptions) {
     serverDir: serverDirAbs,
     distDir: resolve9(projectRoot, ".theokit")
   });
-  const { agentsTypedClientPlugin } = await import("./agents-typed-client-DCPSXUU5.js");
+  const { agentsTypedClientPlugin } = await import("./agents-typed-client-MAAILRI6.js");
   const { generateManifest } = await import("./internal-api-KPULK7ZK.js");
   const agentsClientPlugin = agentsTypedClientPlugin({
     projectRoot,
@@ -3537,4 +3537,4 @@ export {
   theoPluginAsync,
   theoPlugin
 };
-//# sourceMappingURL=chunk-2JNG3P4Y.js.map
+//# sourceMappingURL=chunk-R4VVXLKZ.js.map

package/dist/{chunk-GG6H76GC.js → chunk-VRVNM3QL.js}

@@ -1928,7 +1928,7 @@ async function theoPluginAsync(rootOrOptions) {
     serverDir: serverDirAbs,
     distDir: resolve7(projectRoot, ".theokit")
   });
-  const { agentsTypedClientPlugin } = await import("./agents-typed-client-RIJVHSX4.js");
+  const { agentsTypedClientPlugin } = await import("./agents-typed-client-5DCGDWFZ.js");
   const { generateManifest } = await import("./internal-api-Y5REPVUS.js");
   const agentsClientPlugin = agentsTypedClientPlugin({
     projectRoot,
@@ -2104,4 +2104,4 @@ export {
   theoPluginAsync,
   theoPlugin
 };
-//# sourceMappingURL=chunk-GG6H76GC.js.map
+//# sourceMappingURL=chunk-VRVNM3QL.js.map

package/dist/{chunk-LVGDYTU2.js → chunk-Y4TOVMNC.js}

@@ -178,7 +178,7 @@ async function agentCommand(name, message, deps = {}) {
 async function createAgentSsrLoader(projectRoot) {
   const { createServer } = await import("vite");
   const react = (await import("@vitejs/plugin-react")).default;
-  const { theoPluginAsync } = await import("./vite-plugin-ST4JZQRJ.js");
+  const { theoPluginAsync } = await import("./vite-plugin-BNI7YLCD.js");
   const { loadConfig } = await import("./load-config-3EAQTXPH.js");
   const config = await loadConfig(projectRoot);
   const theoPlugins = await theoPluginAsync({
@@ -212,4 +212,4 @@ export {
   agentCommand,
   createAgentSsrLoader
 };
-//# sourceMappingURL=chunk-LVGDYTU2.js.map
+//# sourceMappingURL=chunk-Y4TOVMNC.js.map

package/dist/cli/index.js

@@ -5,12 +5,12 @@ import "tsx/esm";
 import cac from "cac";
 var cli = cac("theokit");
 cli.command("dev", "Start development server").option("--port <port>", "Port number").action(async (options) => {
-  const { devCommand } = await import("../dev-63UNEUF6.js");
+  const { devCommand } = await import("../dev-5ZQMWVFC.js");
   await devCommand({ port: options.port ? Number(options.port) : void 0 });
 });
 cli.command("build", "Build for production").option("--target <target>", "Deploy target (node, vercel, cloudflare)").action(async (options) => {
   try {
-    const { buildCommand } = await import("../build-WD2PT5TA.js");
+    const { buildCommand } = await import("../build-V2QEBE7I.js");
     await buildCommand({ target: options.target });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -52,7 +52,7 @@ cli.command(
   "Run an agent in the terminal (stream + tool calls + approval)"
 ).action(async (name, message) => {
   try {
-    const { agentCommand } = await import("../agent-GXJNFW6N.js");
+    const { agentCommand } = await import("../agent-I5QEOMCN.js");
     const { sawError } = await agentCommand(name, message);
     if (sawError) process.exit(1);
   } catch (err) {
@@ -65,7 +65,7 @@ cli.command(
 });
 cli.command("mcp <agent>", "Serve an agent as an MCP server over stdio (for desktop MCP clients)").action(async (agent) => {
   try {
-    const { mcpCommand } = await import("../mcp-MIZFVNCL.js");
+    const { mcpCommand } = await import("../mcp-VMKWB2BY.js");
     await mcpCommand(agent);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { T as TheoErrorEnvelope } from '../error-envelope-BsNzzAV5.js';
 export { FetchOptionsLike, Fetcher, QueryKey, UseTheoQueryConfig, buildUseTheoQueryConfig, stableQueryKey } from '../react-query/index.js';
-import { UIMessage } from 'ai';
+import { UIMessageChunk, UIMessage, ChatTransport } from 'ai';
 import * as react from 'react';
 import { LinkProps as LinkProps$1 } from 'react-router';
 
@@ -130,20 +130,85 @@ declare function createBatcher(options: BatcherOptions): Batcher;
  * assistant message, so a caller (the `useAgent` hook) can render streaming updates.
  */
 declare function consumeUIMessageStream(response: Response, onMessage: (message: UIMessage) => void): Promise<void>;
+/**
+ * M41 (ADR-0050 D3) — the reusable middle piece: a UIMessageStream SSE `Response` →
+ * `ReadableStream<UIMessageChunk>`, reusing `ai`'s own `parseJsonEventStream` (the exact primitive
+ * `useChat` runs). This is precisely what a `ChatTransport.sendMessages` returns, so `HttpTransport`
+ * builds on it directly (no reinvented wire parser — Rule 9). A body-less response yields an empty stream.
+ */
+declare function responseToChunkStream(response: Response): Promise<ReadableStream<UIMessageChunk>>;
+/**
+ * M41 (ADR-0050 D6) — read a `ReadableStream<UIMessageChunk>` into reconstructed assistant
+ * `UIMessage`s via `ai`'s `readUIMessageStream`. Shared by `consumeUIMessageStream` (Response path)
+ * and the framework-agnostic `AgentClient` store (transport path). `onMessage` fires on every
+ * reconstruction step so a caller can render streaming updates.
+ */
+declare function consumeChunkStream(stream: ReadableStream<UIMessageChunk>, onMessage: (message: UIMessage) => void): Promise<void>;
 
 /**
- * M2 (theokit-ai-first) — `useAgent`, the typed client hook for the `agents/*.ts` convention.
+ * M41 (ADR-0050 D2) — a HITL approval decision sent to settle a paused gated-tool call. Mirrors the
+ * `POST /api/agents/<name>/approve/<id>` wire body (`approve-agent.ts` `parseApprovalBody`). Defined
+ * on the client side (not imported from `server/`) as the client's view of the boundary contract.
+ */
+interface ApprovalDecision {
+    /** Whether the paused gated tool may proceed. */
+    approved: boolean;
+    /** Optional reason surfaced to the model on denial. */
+    reason?: string;
+    /** Optional small structured note (edited args, a reviewer comment) — capped server-side at 16 KiB. */
+    payload?: unknown;
+}
+/**
+ * M41 (ADR-0050 D1/D2) — the client transport seam.
  *
- * A thin React hook over `consumeUIMessageStream` (which reuses `ai`'s own UIMessageStream
- * reader). `useAgent('support')` binds to `POST /api/agents/support`; the generated
- * `@theo/agents` module (`.theokit/agents.d.ts`) types `send` to the agent's `input` schema,
- * so the request shape is inferred end-to-end from the server `defineAgent({ input })` with
- * ZERO manual wiring (DoD line 2).
+ * It IS `ai`'s `ChatTransport<UIMessage>` (the adopted SOTA interface — we do NOT invent a parallel
+ * one) plus ONE optional method, `approve`, for TheoKit's OUT-OF-BAND HITL (the server pauses the run;
+ * the client settles it via a separate call). `ai`'s `ChatTransport` has no `approve` because its HITL
+ * is in-band (a re-sent message part); ours is out-of-band, and the settle route differs per transport
+ * (HTTP `POST /approve/<id>` vs an inline callback), so it belongs on the transport. `approve` is
+ * optional — agents without gated tools never settle an approval.
  *
- * Transport: fetch + ReadableStream (POST needs a body; EventSource is GET-only). `ai` is
- * loaded lazily by `consumeUIMessageStream` so non-agent apps never pay for it.
+ * `HttpTransport` (web) and `InProcessTransport` (TUI/desktop) implement this; `useAgent` drives it.
  */
+type AgentTransport = ChatTransport<UIMessage> & {
+    approve?(approvalId: string, decision: ApprovalDecision): Promise<void>;
+};
+
 type UseAgentStatus = 'idle' | 'streaming' | 'done' | 'error';
+/** The observable state the store exposes (stable reference between emits — `useSyncExternalStore` contract). */
+interface AgentClientState {
+    messages: UIMessage[];
+    status: UseAgentStatus;
+    error: Error | undefined;
+}
+/**
+ * M41 (ADR-0050 D6) — the framework-agnostic agent client store.
+ *
+ * Holds `messages`/`status`/`error`, drives an {@link AgentTransport}, and notifies subscribers on
+ * change. It is the SINGLE consolidation point: web (`HttpTransport`) and terminal/desktop
+ * (`InProcessTransport`) run the SAME store. `useAgent` is a thin React binding over it via
+ * `useSyncExternalStore`; a standalone (no-React) client (M44) can subscribe directly. Being
+ * framework-agnostic, it is unit-tested without a DOM.
+ */
+declare class AgentClient<TInput = unknown> {
+    #private;
+    constructor(transport: AgentTransport);
+    /** Subscribe to state changes; returns an unsubscribe fn. */
+    subscribe: (listener: () => void) => (() => void);
+    /** The current immutable snapshot (stable reference until the next emit). */
+    getSnapshot: () => AgentClientState;
+    /** Send a typed input; opens a fresh stream (replaces prior messages). */
+    send: (input: TInput) => void;
+    /** Resume an interrupted stream via the transport's `reconnectToStream` (no-op when unavailable). */
+    reconnect: () => void;
+    /** Abort an in-flight stream (not an error — leaves messages as-is). */
+    abort: () => void;
+    /** Clear messages + error, back to idle. */
+    reset: () => void;
+    /** Settle a paused HITL approval via the transport's HITL path (HTTP POST or inline callback). */
+    approve: (approvalId: string, decision: ApprovalDecision) => Promise<void>;
+}
+
 interface UseAgentReturn<TInput = unknown, TToolNames extends string = string> {
     /** Reconstructed assistant messages so far (ai `UIMessage[]`). */
     messages: UIMessage[];
@@ -156,25 +221,118 @@ interface UseAgentReturn<TInput = unknown, TToolNames extends string = string> {
     abort: () => void;
     /** Clear messages + error, back to idle. */
     reset: () => void;
+    /** Settle a paused HITL approval (HTTP `POST /approve/<id>` for web; the inline callback in-process). */
+    approve: (approvalId: string, decision: ApprovalDecision) => Promise<void>;
+    /** Resume an interrupted stream (M37 durable transport for web; a no-op in-process). */
+    reconnect: () => void;
     /**
-     * The union of tool names this agent can emit (M8), carried end-to-end from the `agent()`
-     * builder's accumulated tool-name type through the generated `@theo/agents` client. Type-only
-     * witness (never populated at runtime) — narrow a streamed `tool-<name>` part against it. Resolves
-     * to the literal union for builder agents (`'read_file' | 'count_lines'`), `string` otherwise.
+     * The union of tool names this agent can emit (M8), carried end-to-end from the `agent()` builder's
+     * accumulated tool-name type through the generated `@theo/agents` client. Type-only witness (never
+     * populated at runtime). Resolves to the literal union for builder agents, `string` otherwise.
      */
     readonly __toolNames?: TToolNames;
 }
 interface UseAgentOptions {
-    /** Extra request headers (e.g., auth). */
+    /**
+     * Extra request headers (e.g., auth) — applied when a string path builds an `HttpTransport`. Read on
+     * EVERY request, so a value that changes across renders (a rotating JWT) is never sent stale.
+     */
     headers?: Record<string, string>;
-    /** Override fetch (primarily for tests). */
+    /** Override fetch (primarily for tests) — captured when a string path builds an `HttpTransport`. */
     fetch?: typeof fetch;
 }
 /**
- * Bind to the agent endpoint at `path` (`/api/agents/<name>`). Prefer the generated
- * `useAgent` from `@theo/agents` (typed by agent name); this base accepts an explicit path.
+ * Bind to an agent by endpoint path (`/api/agents/<name>`) or by an explicit {@link AgentTransport}.
+ * Prefer the generated `useAgent` from `@theo/agents` (typed by agent name); this base accepts a path
+ * or a transport. The store is created once per binding identity — memoize a transport before passing it.
+ */
+declare function useAgent<TInput = unknown>(pathOrTransport: string | AgentTransport, options?: UseAgentOptions): UseAgentReturn<TInput>;
+
+/** Extra request headers — a static record OR a resolver called per request (for dynamic auth). */
+type HeadersResolver = Record<string, string> | (() => Record<string, string> | undefined);
+interface HttpTransportOptions {
+    /** Agent endpoint path or URL, e.g. `/api/agents/support`. */
+    api: string;
+    /**
+     * Extra request headers (e.g. auth). Static record OR a resolver evaluated on EVERY request — pass a
+     * resolver when the value is dynamic (a rotating JWT), so a stale header is never sent. Merged UNDER
+     * per-request headers.
+     */
+    headers?: HeadersResolver;
+    /** Override fetch (primarily for tests / non-browser hosts) — static; resolved once at construction. */
+    fetch?: typeof fetch;
+}
+/**
+ * M41 (ADR-0050 D3) — `ChatTransport` over the web agent path.
+ *
+ * - `sendMessages`: `POST <api>` with the UIMessageStream `accept` + the `X-Theo-Action` CSRF header
+ *   (HTTP method + headers are identical to the pre-M41 `useAgent` fetch; the body shape is a superset —
+ *   `{ ...input, messages: [UIMessage] }` — which the server's dual-path parser accepts, so no
+ *   regression), captures the server-minted `x-theokit-run-id`, and returns `ReadableStream<UIMessageChunk>`
+ *   via `ai`'s own SSE parser (`responseToChunkStream`).
+ * - `reconnectToStream`: `GET <api>/runs/<runId>/stream` (M37 durable transport); 404 → `null` (the run
+ *   completed / was evicted). A caller may pass a `Last-Event-ID` header to resume only the tail; by
+ *   default the server replays the run from the start and the client upserts by message id (idempotent).
+ * - `approve`: `POST <api>/approve/<id>` (out-of-band HITL settle).
+ *
+ * Implemented directly (not by subclassing `DefaultChatTransport`) because reconnect keys on our
+ * server-minted `runId` captured from a response header, which the base class does not expose — see
+ * ADR-0050 D3.
+ */
+declare class HttpTransport implements AgentTransport {
+    #private;
+    constructor(options: HttpTransportOptions);
+    sendMessages(options: Parameters<ChatTransport<UIMessage>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+    reconnectToStream(options: Parameters<ChatTransport<UIMessage>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
+    approve(approvalId: string, decision: ApprovalDecision): Promise<void>;
+}
+
+/** An inline approval request handed to the transport's resolver (structural — no server import). */
+interface InProcessApprovalRequestLike {
+    approvalId: string;
+    toolName: string;
+    opts: unknown;
+}
+/** Resolve one gated-tool approval inline (mirrors the SDK's `boolean | HitlDecision` return). */
+type InProcessAwaitApproval = (req: InProcessApprovalRequestLike) => Promise<boolean | ApprovalDecision>;
+/** The input the injected runner receives (structurally compatible with `StreamAgentTurnInProcessInput`). */
+interface InProcessRunInput {
+    message: string;
+    sessionId?: string;
+    signal?: AbortSignal;
+    awaitApproval?: InProcessAwaitApproval;
+}
+/**
+ * The in-process turn runner. The consumer binds `streamAgentTurnInProcess(mod, apiKey, …)`:
+ * `new InProcessTransport({ run: (input) => streamAgentTurnInProcess(mod, apiKey, input) })`.
+ * Injecting it keeps this client module decoupled from `server/` and makes the transport testable.
  */
-declare function useAgent<TInput = unknown>(path: string, options?: UseAgentOptions): UseAgentReturn<TInput>;
+type InProcessRunner = (input: InProcessRunInput) => AsyncGenerator<UIMessageChunk>;
+interface InProcessTransportOptions {
+    run: InProcessRunner;
+}
+/**
+ * M41 (ADR-0050 D4) — `ChatTransport` over the in-process seam (`streamAgentTurnInProcess`), for the
+ * terminal/desktop surfaces that run client + server in ONE process (no HTTP loopback).
+ *
+ * - `sendMessages`: bridge the injected runner's `AsyncGenerator<UIMessageChunk>` into a
+ *   `ReadableStream<UIMessageChunk>` (honoring `abortSignal`, which the runner forwards to the SDK).
+ * - `reconnectToStream`: always `null` — a single process has no dropped server-side stream to resume
+ *   (mirrors `ai`'s `DirectChatTransport`).
+ * - `approve`: resolve the pending inline approval by id (the run parks on `awaitApproval`). An unknown
+ *   id rejects (fail-fast, Rule 8 — never a silent resolve).
+ *
+ * Error asymmetry vs `HttpTransport` (by design, matching the `ChatTransport` contract): a runner that
+ * throws SYNCHRONOUSLY surfaces the error when the stream is READ (via `controller.error`), not from the
+ * `sendMessages` promise — whereas `HttpTransport` throws from `sendMessages` on a non-2xx response.
+ */
+declare class InProcessTransport implements AgentTransport {
+    #private;
+    constructor(options: InProcessTransportOptions);
+    sendMessages(options: Parameters<ChatTransport<UIMessage>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+    reconnectToStream(): Promise<ReadableStream<UIMessageChunk> | null>;
+    approve(approvalId: string, decision: ApprovalDecision): Promise<void>;
+}
 
 type PrefetchBehavior = 'none' | 'intent' | 'viewport';
 interface LinkProps extends LinkProps$1 {
@@ -323,4 +481,4 @@ declare function mountMcpApp(container: HTMLElement, resource: {
     html: string;
 }, opts: McpAppHostOptions): McpAppHandle;
 
-export { type BatchRequest, type BatchResponse, type BatchTransport, type Batcher, type BatcherOptions, type CreateAppClientOptions, type GuestMessage, Image, type ImageProps, type InferBody, type InferQuery, type InferResponse, Link, type LinkProps, MCP_APP_SANDBOX, type McpAppHandle, type McpAppHostOptions, Metadata, type MetadataProps, type PrefetchBehavior, TheoFetchError, type TheoFetchOptions, type UseAgentOptions, type UseAgentReturn, type UseAgentStatus, consumeUIMessageStream, createAppClient, createBatcher, createGuestMessageHandler, mountMcpApp, theoFetch, useAgent };
+export { AgentClient, type AgentClientState, type AgentTransport, type ApprovalDecision, type BatchRequest, type BatchResponse, type BatchTransport, type Batcher, type BatcherOptions, type CreateAppClientOptions, type GuestMessage, HttpTransport, type HttpTransportOptions, Image, type ImageProps, type InProcessApprovalRequestLike, type InProcessAwaitApproval, type InProcessRunInput, type InProcessRunner, InProcessTransport, type InProcessTransportOptions, type InferBody, type InferQuery, type InferResponse, Link, type LinkProps, MCP_APP_SANDBOX, type McpAppHandle, type McpAppHostOptions, Metadata, type MetadataProps, type PrefetchBehavior, TheoFetchError, type TheoFetchOptions, type UseAgentOptions, type UseAgentReturn, type UseAgentStatus, consumeChunkStream, consumeUIMessageStream, createAppClient, createBatcher, createGuestMessageHandler, mountMcpApp, responseToChunkStream, theoFetch, useAgent };