theokit 0.39.0 → 0.39.1

package/dist/{agent-NDHBKRAV.js → agent-ST6GB3VX.js}

@@ -3,7 +3,7 @@ import "tsx/esm";
 import {
   agentCommand,
   createAgentSsrLoader
-} from "./chunk-CL3HJTWQ.js";
+} from "./chunk-YMS6KMKA.js";
 import "./chunk-GDN3PXFH.js";
 import "./chunk-M6NMS5LR.js";
 import "./chunk-L4GCEMNW.js";
@@ -12,4 +12,4 @@ export {
   agentCommand,
   createAgentSsrLoader
 };
-//# sourceMappingURL=agent-NDHBKRAV.js.map
+//# sourceMappingURL=agent-ST6GB3VX.js.map

package/dist/{agents-typed-client-HSZKZY2P.js → agents-typed-client-CHMVW7MK.js}

@@ -77,6 +77,14 @@ ${importBlock}
 ${handleBlock}}
 `;
 }
+function generateAgentsRuntimeModule(agentNames) {
+  const handleLines = agentNames.map(
+    (name) => `export const ${name} = agentHandle('/api/agents/${name}')`
+  );
+  return `import { agentHandle } from 'theokit/client'
+export { useAgent } from 'theokit/client'
+` + (handleLines.length > 0 ? handleLines.join("\n") + "\n" : "");
+}
 var VIRTUAL_AGENTS_ID = "@theo/agents";
 var RESOLVED_AGENTS_ID = "\0@theo/agents";
 function writeIfChanged(filePath, content) {
@@ -154,11 +162,7 @@ function agentsTypedClientPlugin(opts) {
     load(id) {
       if (id === RESOLVED_AGENTS_ID) {
         const agents = opts.scanManifest(opts.projectRoot).agents ?? [];
-        const handleLines = agents.map(
-          (a) => `export const ${a.name} = agentHandle('/api/agents/${a.name}')`
-        );
-        return `export { useAgent, agentHandle } from 'theokit/client'
-` + (handleLines.length > 0 ? handleLines.join("\n") + "\n" : "");
+        return generateAgentsRuntimeModule(agents.map((a) => a.name));
       }
       return null;
     }
@@ -166,6 +170,7 @@ function agentsTypedClientPlugin(opts) {
 }
 export {
   agentsTypedClientPlugin,
-  generateAgentsDts
+  generateAgentsDts,
+  generateAgentsRuntimeModule
 };
-//# sourceMappingURL=agents-typed-client-HSZKZY2P.js.map
+//# sourceMappingURL=agents-typed-client-CHMVW7MK.js.map

package/dist/{agents-typed-client-WFK7M5A7.js.map → agents-typed-client-CHMVW7MK.js.map}

@@ -1 +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  const handles: 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    // M47 — a named, client-safe handle per agent: `import { chat } from '@theo/agents'; useAgent(chat)`.\n    // cmd-click on the generated const hops to the agent source via the type-only import above.\n    handles.push(\n      `  export const ${agent.name}: AgentHandle<InferAgentInput<${alias}>, InferAgentToolNames<${alias}>>`,\n    )\n  }\n  const handleBlock = handles.length > 0 ? `\\n${handles.join('\\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, AgentHandle } 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  // M47 — bind by a typed handle: \\`import { chat } from '@theo/agents'; useAgent(chat)\\`. No magic\n  // string (the path lives on the handle) and no duplicated input type (inferred from the handle).\n  export function useAgent<TInput, TTools extends string>(\n    handle: AgentHandle<TInput, TTools>,\n  ): UseAgentReturn<TInput, TTools>\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  // M47 — one client-safe handle per agent (runtime value = { path }; types are phantom).\n${handleBlock}}\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        // M47 — the runtime module re-exports `useAgent` AND emits one handle value per agent\n        // (`export const chat = agentHandle('/api/agents/chat')`), so `import { chat } from '@theo/agents'`\n        // resolves at runtime. Types come from the sibling `agents.d.ts` module augmentation.\n        const agents = opts.scanManifest(opts.projectRoot).agents ?? []\n        const handleLines = agents.map(\n          (a) => `export const ${a.name} = agentHandle('/api/agents/${a.name}')`,\n        )\n        return (\n          `export { useAgent, agentHandle } from 'theokit/client'\\n` +\n          (handleLines.length > 0 ? handleLines.join('\\n') + '\\n' : '')\n        )\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}
+{"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  const handles: 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    // M47 — a named, client-safe handle per agent: `import { chat } from '@theo/agents'; useAgent(chat)`.\n    // cmd-click on the generated const hops to the agent source via the type-only import above.\n    handles.push(\n      `  export const ${agent.name}: AgentHandle<InferAgentInput<${alias}>, InferAgentToolNames<${alias}>>`,\n    )\n  }\n  const handleBlock = handles.length > 0 ? `\\n${handles.join('\\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, AgentHandle } 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  // M47 — bind by a typed handle: \\`import { chat } from '@theo/agents'; useAgent(chat)\\`. No magic\n  // string (the path lives on the handle) and no duplicated input type (inferred from the handle).\n  export function useAgent<TInput, TTools extends string>(\n    handle: AgentHandle<TInput, TTools>,\n  ): UseAgentReturn<TInput, TTools>\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  // M47 — one client-safe handle per agent (runtime value = { path }; types are phantom).\n${handleBlock}}\n`\n}\n\n/**\n * M47 — the RUNTIME body of the virtual `@theo/agents` module: it re-exports `useAgent` and emits one\n * handle value per agent (`export const chat = agentHandle('/api/agents/chat')`), so\n * `import { chat } from '@theo/agents'` resolves at runtime.\n *\n * `agentHandle` MUST be `import`ed (a local binding), NOT re-exported — `export { agentHandle } from '…'`\n * re-exports the name but does NOT bind it locally, so `agentHandle(…)` below would throw\n * `ReferenceError: agentHandle is not defined` in the browser (caught by the real-browser dogfood, missed\n * by curl + the .d.ts-only unit test).\n */\nexport function generateAgentsRuntimeModule(agentNames: string[]): string {\n  const handleLines = agentNames.map(\n    (name) => `export const ${name} = agentHandle('/api/agents/${name}')`,\n  )\n  return (\n    `import { agentHandle } from 'theokit/client'\\n` +\n    `export { useAgent } from 'theokit/client'\\n` +\n    (handleLines.length > 0 ? handleLines.join('\\n') + '\\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        const agents = opts.scanManifest(opts.projectRoot).agents ?? []\n        return generateAgentsRuntimeModule(agents.map((a) => a.name))\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{agents-typed-client-WFK7M5A7.js → agents-typed-client-NJ73Z6XY.js}

@@ -78,6 +78,14 @@ ${importBlock}
 ${handleBlock}}
 `;
 }
+function generateAgentsRuntimeModule(agentNames) {
+  const handleLines = agentNames.map(
+    (name) => `export const ${name} = agentHandle('/api/agents/${name}')`
+  );
+  return `import { agentHandle } from 'theokit/client'
+export { useAgent } from 'theokit/client'
+` + (handleLines.length > 0 ? handleLines.join("\n") + "\n" : "");
+}
 var VIRTUAL_AGENTS_ID = "@theo/agents";
 var RESOLVED_AGENTS_ID = "\0@theo/agents";
 function writeIfChanged(filePath, content) {
@@ -155,11 +163,7 @@ function agentsTypedClientPlugin(opts) {
     load(id) {
       if (id === RESOLVED_AGENTS_ID) {
         const agents = opts.scanManifest(opts.projectRoot).agents ?? [];
-        const handleLines = agents.map(
-          (a) => `export const ${a.name} = agentHandle('/api/agents/${a.name}')`
-        );
-        return `export { useAgent, agentHandle } from 'theokit/client'
-` + (handleLines.length > 0 ? handleLines.join("\n") + "\n" : "");
+        return generateAgentsRuntimeModule(agents.map((a) => a.name));
       }
       return null;
     }
@@ -167,6 +171,7 @@ function agentsTypedClientPlugin(opts) {
 }
 export {
   agentsTypedClientPlugin,
-  generateAgentsDts
+  generateAgentsDts,
+  generateAgentsRuntimeModule
 };
-//# sourceMappingURL=agents-typed-client-WFK7M5A7.js.map
+//# sourceMappingURL=agents-typed-client-NJ73Z6XY.js.map

package/dist/{agents-typed-client-HSZKZY2P.js.map → agents-typed-client-NJ73Z6XY.js.map}

@@ -1 +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  const handles: 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    // M47 — a named, client-safe handle per agent: `import { chat } from '@theo/agents'; useAgent(chat)`.\n    // cmd-click on the generated const hops to the agent source via the type-only import above.\n    handles.push(\n      `  export const ${agent.name}: AgentHandle<InferAgentInput<${alias}>, InferAgentToolNames<${alias}>>`,\n    )\n  }\n  const handleBlock = handles.length > 0 ? `\\n${handles.join('\\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, AgentHandle } 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  // M47 — bind by a typed handle: \\`import { chat } from '@theo/agents'; useAgent(chat)\\`. No magic\n  // string (the path lives on the handle) and no duplicated input type (inferred from the handle).\n  export function useAgent<TInput, TTools extends string>(\n    handle: AgentHandle<TInput, TTools>,\n  ): UseAgentReturn<TInput, TTools>\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  // M47 — one client-safe handle per agent (runtime value = { path }; types are phantom).\n${handleBlock}}\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        // M47 — the runtime module re-exports `useAgent` AND emits one handle value per agent\n        // (`export const chat = agentHandle('/api/agents/chat')`), so `import { chat } from '@theo/agents'`\n        // resolves at runtime. Types come from the sibling `agents.d.ts` module augmentation.\n        const agents = opts.scanManifest(opts.projectRoot).agents ?? []\n        const handleLines = agents.map(\n          (a) => `export const ${a.name} = agentHandle('/api/agents/${a.name}')`,\n        )\n        return (\n          `export { useAgent, agentHandle } from 'theokit/client'\\n` +\n          (handleLines.length > 0 ? handleLines.join('\\n') + '\\n' : '')\n        )\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}
+{"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  const handles: 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    // M47 — a named, client-safe handle per agent: `import { chat } from '@theo/agents'; useAgent(chat)`.\n    // cmd-click on the generated const hops to the agent source via the type-only import above.\n    handles.push(\n      `  export const ${agent.name}: AgentHandle<InferAgentInput<${alias}>, InferAgentToolNames<${alias}>>`,\n    )\n  }\n  const handleBlock = handles.length > 0 ? `\\n${handles.join('\\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, AgentHandle } 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  // M47 — bind by a typed handle: \\`import { chat } from '@theo/agents'; useAgent(chat)\\`. No magic\n  // string (the path lives on the handle) and no duplicated input type (inferred from the handle).\n  export function useAgent<TInput, TTools extends string>(\n    handle: AgentHandle<TInput, TTools>,\n  ): UseAgentReturn<TInput, TTools>\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  // M47 — one client-safe handle per agent (runtime value = { path }; types are phantom).\n${handleBlock}}\n`\n}\n\n/**\n * M47 — the RUNTIME body of the virtual `@theo/agents` module: it re-exports `useAgent` and emits one\n * handle value per agent (`export const chat = agentHandle('/api/agents/chat')`), so\n * `import { chat } from '@theo/agents'` resolves at runtime.\n *\n * `agentHandle` MUST be `import`ed (a local binding), NOT re-exported — `export { agentHandle } from '…'`\n * re-exports the name but does NOT bind it locally, so `agentHandle(…)` below would throw\n * `ReferenceError: agentHandle is not defined` in the browser (caught by the real-browser dogfood, missed\n * by curl + the .d.ts-only unit test).\n */\nexport function generateAgentsRuntimeModule(agentNames: string[]): string {\n  const handleLines = agentNames.map(\n    (name) => `export const ${name} = agentHandle('/api/agents/${name}')`,\n  )\n  return (\n    `import { agentHandle } from 'theokit/client'\\n` +\n    `export { useAgent } from 'theokit/client'\\n` +\n    (handleLines.length > 0 ? handleLines.join('\\n') + '\\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        const agents = opts.scanManifest(opts.projectRoot).agents ?? []\n        return generateAgentsRuntimeModule(agents.map((a) => a.name))\n      }\n      return null\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{build-PF65J7N6.js → build-VAR5EFOU.js}

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

package/dist/{chunk-I4BTOOZ2.js → chunk-L4CYLM2V.js}

@@ -3088,7 +3088,7 @@ async function theoPluginAsync(rootOrOptions) {
     serverDir: serverDirAbs,
     distDir: resolve10(projectRoot, ".theokit")
   });
-  const { agentsTypedClientPlugin } = await import("./agents-typed-client-HSZKZY2P.js");
+  const { agentsTypedClientPlugin } = await import("./agents-typed-client-CHMVW7MK.js");
   const { generateManifest } = await import("./internal-api-MRTUTAM7.js");
   const agentsClientPlugin = agentsTypedClientPlugin({
     projectRoot,
@@ -3278,4 +3278,4 @@ export {
   theoPluginAsync,
   theoPlugin
 };
-//# sourceMappingURL=chunk-I4BTOOZ2.js.map
+//# sourceMappingURL=chunk-L4CYLM2V.js.map

package/dist/{chunk-ELRVWUOZ.js → chunk-MYDS52BG.js}

@@ -1980,7 +1980,7 @@ async function theoPluginAsync(rootOrOptions) {
     serverDir: serverDirAbs,
     distDir: resolve8(projectRoot, ".theokit")
   });
-  const { agentsTypedClientPlugin } = await import("./agents-typed-client-WFK7M5A7.js");
+  const { agentsTypedClientPlugin } = await import("./agents-typed-client-NJ73Z6XY.js");
   const { generateManifest } = await import("./internal-api-ORXPQTEI.js");
   const agentsClientPlugin = agentsTypedClientPlugin({
     projectRoot,
@@ -2162,4 +2162,4 @@ export {
   theoPluginAsync,
   theoPlugin
 };
-//# sourceMappingURL=chunk-ELRVWUOZ.js.map
+//# sourceMappingURL=chunk-MYDS52BG.js.map

package/dist/{chunk-CL3HJTWQ.js → chunk-YMS6KMKA.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-42TH3C64.js");
+  const { theoPluginAsync } = await import("./vite-plugin-WB57H4AT.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-CL3HJTWQ.js.map
+//# sourceMappingURL=chunk-YMS6KMKA.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-YP2QH576.js");
+  const { devCommand } = await import("../dev-VAIYPLV6.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-PF65J7N6.js");
+    const { buildCommand } = await import("../build-VAR5EFOU.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-NDHBKRAV.js");
+    const { agentCommand } = await import("../agent-ST6GB3VX.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-FWJE2QXV.js");
+    const { mcpCommand } = await import("../mcp-SMDPAW7T.js");
     await mcpCommand(agent);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);

package/dist/{dev-YP2QH576.js → dev-VAIYPLV6.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-GEQJAFSV.js";
 import {
   theoPluginAsync
-} from "./chunk-ELRVWUOZ.js";
+} from "./chunk-MYDS52BG.js";
 import "./chunk-BEQQ6WCK.js";
 import "./chunk-2CVV6CNN.js";
 import "./chunk-IEES3CHD.js";
@@ -111,4 +111,4 @@ export {
   devCommand,
   startDevServer
 };
-//# sourceMappingURL=dev-YP2QH576.js.map
+//# sourceMappingURL=dev-VAIYPLV6.js.map

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   scanRoutes,
   theoConfigSchema,
   theoPlugin
-} from "./chunk-I4BTOOZ2.js";
+} from "./chunk-L4CYLM2V.js";
 import "./chunk-D7ZH7DTG.js";
 import "./chunk-7BIM27LV.js";
 import "./chunk-KLFCJQXU.js";

package/dist/{mcp-FWJE2QXV.js → mcp-SMDPAW7T.js}

@@ -2,7 +2,7 @@
 import "tsx/esm";
 import {
   createAgentSsrLoader
-} from "./chunk-CL3HJTWQ.js";
+} from "./chunk-YMS6KMKA.js";
 import {
   extractAppResources,
   handleMcpJsonRpc
@@ -75,4 +75,4 @@ async function mcpCommand(name, deps = {}) {
 export {
   mcpCommand
 };
-//# sourceMappingURL=mcp-FWJE2QXV.js.map
+//# sourceMappingURL=mcp-SMDPAW7T.js.map

package/dist/vite-plugin/index.js

@@ -5,7 +5,7 @@ import {
   defineTheoIntegration,
   theoPlugin,
   theoPluginAsync
-} from "../chunk-I4BTOOZ2.js";
+} from "../chunk-L4CYLM2V.js";
 import "../chunk-D7ZH7DTG.js";
 import "../chunk-7BIM27LV.js";
 import "../chunk-KLFCJQXU.js";

package/dist/{vite-plugin-42TH3C64.js → vite-plugin-WB57H4AT.js}

@@ -7,7 +7,7 @@ import {
   defineTheoIntegration,
   theoPlugin,
   theoPluginAsync
-} from "./chunk-ELRVWUOZ.js";
+} from "./chunk-MYDS52BG.js";
 import "./chunk-BEQQ6WCK.js";
 import "./chunk-2CVV6CNN.js";
 import "./chunk-IEES3CHD.js";
@@ -32,4 +32,4 @@ export {
   theoPlugin,
   theoPluginAsync
 };
-//# sourceMappingURL=vite-plugin-42TH3C64.js.map
+//# sourceMappingURL=vite-plugin-WB57H4AT.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theokit",
-  "version": "0.39.0",
+  "version": "0.39.1",
   "type": "module",
   "sideEffects": false,
   "license": "Apache-2.0",
@@ -171,7 +171,6 @@
     "unstorage": "^1.17.5"
   },
   "publishConfig": {
-    "provenance": false,
     "access": "public"
   },
   "engines": {