theokit 0.18.0 → 0.19.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 usetheo.dev
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/{actions-virtual-module-G4BANOLW.js → actions-virtual-module-HD3D75C2.js}

@@ -2,11 +2,11 @@
 import "tsx/esm";
 import "./chunk-KXA37ONC.js";
 import "./chunk-WR4F4EEZ.js";
-import "./chunk-NXTF5PPW.js";
+import "./chunk-TIZBKEDV.js";
 import "./chunk-34YQOXGM.js";
 import {
   scanServerActionsEnriched
-} from "./chunk-GBXLKYIA.js";
+} from "./chunk-FRUEDJFX.js";
 import "./chunk-P37RZRFV.js";
 import "./chunk-HGZL5EOI.js";
 
@@ -211,4 +211,4 @@ export const actions = manifest
 export {
   actionsVirtualModule
 };
-//# sourceMappingURL=actions-virtual-module-G4BANOLW.js.map
+//# sourceMappingURL=actions-virtual-module-HD3D75C2.js.map

package/dist/{actions-virtual-module-RM7JRY5N.js → actions-virtual-module-J3XSNY6L.js}

@@ -5,7 +5,7 @@ import "./chunk-VMEWD57H.js";
 import "./chunk-JQSKBMXP.js";
 import {
   scanServerActionsEnriched
-} from "./chunk-2J7XU3PW.js";
+} from "./chunk-AKTGTUU5.js";
 import "./chunk-WSJKACWB.js";
 import "./chunk-JBCHWRKF.js";
 import "./chunk-C3ZZ56YZ.js";
@@ -221,4 +221,4 @@ export const actions = manifest
 export {
   actionsVirtualModule
 };
-//# sourceMappingURL=actions-virtual-module-RM7JRY5N.js.map
+//# sourceMappingURL=actions-virtual-module-J3XSNY6L.js.map

package/dist/agent-5UMCZYY4.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import "tsx/esm";
+import {
+  agentCommand,
+  createAgentSsrLoader
+} from "./chunk-5VNZ5EG3.js";
+import "./chunk-M6NMS5LR.js";
+import "./chunk-GDN3PXFH.js";
+import "./chunk-34YQOXGM.js";
+import "./chunk-P37RZRFV.js";
+export {
+  agentCommand,
+  createAgentSsrLoader
+};
+//# sourceMappingURL=agent-5UMCZYY4.js.map

package/dist/{app-typed-client-5VQE6DNF.js → app-typed-client-OTXG3VZB.js}

@@ -5,7 +5,7 @@ import "./chunk-VMEWD57H.js";
 import "./chunk-JQSKBMXP.js";
 import {
   generateManifest
-} from "./chunk-2J7XU3PW.js";
+} from "./chunk-AKTGTUU5.js";
 import {
   HTTP_METHODS
 } from "./chunk-WSJKACWB.js";
@@ -296,4 +296,4 @@ export {
   emitClientDts,
   generateClientDts
 };
-//# sourceMappingURL=app-typed-client-5VQE6DNF.js.map
+//# sourceMappingURL=app-typed-client-OTXG3VZB.js.map

package/dist/{app-typed-client-Z6BHD4MF.js → app-typed-client-X6WKTFX2.js}

@@ -4,11 +4,11 @@ import "./chunk-KXA37ONC.js";
 import "./chunk-WR4F4EEZ.js";
 import {
   generateManifest
-} from "./chunk-NXTF5PPW.js";
+} from "./chunk-TIZBKEDV.js";
 import "./chunk-34YQOXGM.js";
 import {
   HTTP_METHODS
-} from "./chunk-GBXLKYIA.js";
+} from "./chunk-FRUEDJFX.js";
 import "./chunk-P37RZRFV.js";
 import "./chunk-HGZL5EOI.js";
 
@@ -286,4 +286,4 @@ export {
   emitClientDts,
   generateClientDts
 };
-//# sourceMappingURL=app-typed-client-Z6BHD4MF.js.map
+//# sourceMappingURL=app-typed-client-X6WKTFX2.js.map

package/dist/{build-5PSDDMFB.js → build-QGHSA7FT.js}

@@ -25,9 +25,9 @@ import {
 import {
   generateManifest,
   writeManifest as writeManifest2
-} from "./chunk-NXTF5PPW.js";
+} from "./chunk-TIZBKEDV.js";
 import "./chunk-34YQOXGM.js";
-import "./chunk-GBXLKYIA.js";
+import "./chunk-FRUEDJFX.js";
 import {
   walkSourceFiles
 } from "./chunk-P37RZRFV.js";
@@ -531,7 +531,7 @@ async function buildCommand(options) {
 `);
 }
 async function runAdapterBuild(target, config, cwd) {
-  const { theoPluginAsync } = await import("./vite-plugin-DBS2USI4.js");
+  const { theoPluginAsync } = await import("./vite-plugin-QOCVYPFI.js");
   const { default: react } = await import("@vitejs/plugin-react");
   const ctx = {
     // `react()` may return Plugin or Plugin[] depending on version; spread the
@@ -606,4 +606,4 @@ function relativize3(absPath, root) {
 export {
   buildCommand
 };
-//# sourceMappingURL=build-5PSDDMFB.js.map
+//# sourceMappingURL=build-QGHSA7FT.js.map

package/dist/{agent-TZ5JZUJ7.js → chunk-5VNZ5EG3.js}

@@ -10,7 +10,6 @@ import {
 import {
   scanAgents
 } from "./chunk-34YQOXGM.js";
-import "./chunk-P37RZRFV.js";
 
 // src/server/agent/run-terminal-agent.ts
 import {
@@ -178,7 +177,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-DBS2USI4.js");
+  const { theoPluginAsync } = await import("./vite-plugin-QOCVYPFI.js");
   const { loadConfig } = await import("./load-config-JKYO5RFK.js");
   const config = await loadConfig(projectRoot);
   const theoPlugins = await theoPluginAsync({
@@ -203,7 +202,9 @@ async function createAgentSsrLoader(projectRoot) {
     }
   };
 }
+
 export {
-  agentCommand
+  agentCommand,
+  createAgentSsrLoader
 };
-//# sourceMappingURL=agent-TZ5JZUJ7.js.map
+//# sourceMappingURL=chunk-5VNZ5EG3.js.map

package/dist/{agent-TZ5JZUJ7.js.map → chunk-5VNZ5EG3.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/agent/run-terminal-agent.ts","../src/server/agent/render-terminal.ts","../src/cli/commands/agent.ts"],"sourcesContent":["/**\n * M5 (theokit-ai-first) — run a compiled agent in the terminal, reusing the M4 harness.\n *\n * The web `mountAgent` renders `streamAgentUIMessages` to an HTTP `Response` and resolves HITL\n * approvals via the approve route. This is its terminal sibling: SAME `compileAgentModule` + SAME\n * `streamAgentUIMessages` + SAME in-process approval registry — only the render surface (stdout) and\n * the approval input (a readline prompt) differ (ADR 0039 D2). In a single-process CLI the stream's\n * `awaitApproval` (→ `registry.register`) and the terminal prompt (→ `registry.resolve`) share the one\n * in-process registry — the M4 singleton's exact fit. No new runtime, no LLM call, no tool dispatch.\n */\nimport {\n  compileAgentModule,\n  streamAgentUIMessages,\n  type HumanInTheLoopOptions,\n} from '@theokit/agents'\n\nimport { getApprovalRegistry, type ApprovalRegistry } from './approval-registry.js'\nimport {\n  promptTerminalApproval,\n  renderAgentStreamToTerminal,\n  type TerminalOut,\n} from './render-terminal.js'\n\nexport interface RunTerminalAgentInput {\n  message: string\n  /** Resume key; a fresh id per run when omitted. */\n  sessionId?: string\n  /** Injectable sink (defaults to `process.stdout` at the CLI entry). */\n  stdout?: TerminalOut\n  /** Injectable shared registry (defaults to the process singleton). */\n  registry?: ApprovalRegistry\n  /** Injectable approval prompt (defaults to the readline prompt over the process streams). */\n  promptApproval?: (req: { toolName: string; timeoutMs?: number }) => Promise<boolean>\n  /** Labels a fail-fast `AgentDefinitionError` (the file path). */\n  source?: string\n}\n\n/**\n * Compile the module (M4, gathers `@Mixin` toolboxes), stream it, and render to the terminal. When the\n * agent has `@HumanInTheLoop`-gated tools, the terminal prompts and resolves the shared registry —\n * approve runs the tool, deny/timeout/non-TTY denies and the run continues.\n */\nexport async function runAgentInTerminal(\n  mod: unknown,\n  apiKey: string,\n  input: RunTerminalAgentInput,\n): Promise<{ sawError: boolean }> {\n  const compiled = compileAgentModule(mod, input.source)\n  const stdout = input.stdout ?? process.stdout\n  const registry = input.registry ?? getApprovalRegistry()\n  const sessionId = input.sessionId ?? crypto.randomUUID()\n  const promptApproval =\n    input.promptApproval ??\n    ((req: { toolName: string; timeoutMs?: number }) =>\n      promptTerminalApproval(req, { input: process.stdin, output: process.stdout }, req.timeoutMs))\n\n  // Mirror mount-agent's HITL wiring; absent ⇒ the non-HITL stream path (M2), unchanged.\n  const gated = compiled.hitl\n  const hitl =\n    gated && gated.size > 0\n      ? {\n          gated,\n          awaitApproval: (approvalId: string, opts: HumanInTheLoopOptions) =>\n            registry.register(approvalId, {\n              timeoutMs: opts.timeout ?? 300_000,\n              onTimeout: opts.onTimeout ?? 'abort',\n            }),\n        }\n      : undefined\n\n  const chunks = streamAgentUIMessages(compiled, apiKey, {\n    message: input.message,\n    sessionId,\n    hitl,\n  })\n  return renderAgentStreamToTerminal(chunks, {\n    stdout,\n    onApproval: async ({ approvalId, toolName }) => {\n      // The renderer paused here (the SDK run is paused in its awaited pre_tool_call hook); prompt,\n      // then resolve the SAME registry the stream registered into — the run resumes with the decision.\n      // The prompt shares the gated tool's timeout so it can never outlive the registry-settled run.\n      const timeoutMs = gated?.get(toolName)?.timeout ?? 300_000\n      const approved = await promptApproval({ toolName, timeoutMs })\n      registry.resolve(approvalId, approved)\n    },\n  })\n}\n","/**\n * M5 (theokit-ai-first) — the terminal render surface for the M4 agent harness.\n *\n * Consumes the M4 `UIMessageChunk` stream (`streamAgentUIMessages`) and writes it to the terminal:\n * streaming text, a dim reasoning line, `▸ tool(input)` / result cards, a checkpoint notice, errors.\n * On a HITL `tool-approval-request` it delegates to the injected `onApproval` (the entry wires that to\n * a readline prompt + the approval registry). This is the ONLY new code M5 adds — no runtime, no LLM\n * call, no tool dispatch (ADR 0039 D2). I/O is INJECTED (`stdout`, prompt streams) so the whole\n * surface is deterministically testable without a TTY (ADR 0039 D4 / ADR-M5a).\n */\nimport { createInterface } from 'node:readline'\nimport type { Readable, Writable } from 'node:stream'\n\nimport type { UIMessageChunk } from 'ai'\n\n/** ANSI helpers — applied only on a TTY so a captured (non-TTY) sink stays plain-text for tests. */\nconst ANSI = {\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  cyan: '\\x1b[36m',\n  green: '\\x1b[32m',\n  reset: '\\x1b[0m',\n}\nfunction paint(text: string, color: keyof typeof ANSI, tty: boolean | undefined): string {\n  return tty ? `${ANSI[color]}${text}${ANSI.reset}` : text\n}\n\n/** A stdout-like sink; `isTTY` gates color (Node's `process.stdout` carries it, a test sink does not). */\nexport type TerminalOut = Writable & { isTTY?: boolean }\n\nexport interface TerminalRenderOptions {\n  stdout: TerminalOut\n  /** Resolve a HITL approval (the entry prompts + resolves the registry). */\n  onApproval: (req: { approvalId: string; toolName: string }) => Promise<void>\n}\n\n/** Render an `unknown` tool output/input for display (string as-is; other JSON-ish values stringified). */\nfunction display(value: unknown): string {\n  return typeof value === 'string' ? value : JSON.stringify(value ?? {})\n}\n\n/**\n * Map a single (non-approval) `UIMessageChunk` to its terminal line(s), or `''` for chunks that render\n * nothing (`start`/`text-start`/`reasoning-start`/…). Pure — the async loop owns approval + I/O.\n * Narrows the `ai` discriminated union directly on `chunk.type` (no cast; G3).\n */\nfunction renderChunkLine(chunk: UIMessageChunk, tty: boolean | undefined): string {\n  switch (chunk.type) {\n    case 'text-delta':\n      return chunk.delta\n    case 'text-end':\n    case 'finish':\n      return '\\n'\n    case 'reasoning-delta':\n      return paint(chunk.delta, 'dim', tty)\n    case 'reasoning-end':\n      return '\\n'\n    case 'tool-input-available':\n      return paint(`\\n▸ ${chunk.toolName}(${display(chunk.input)})\\n`, 'cyan', tty)\n    case 'tool-output-available':\n      return paint(`  ✓ ${display(chunk.output)}\\n`, 'green', tty)\n    case 'tool-output-error':\n      return paint(`  ✗ ${chunk.errorText}\\n`, 'red', tty)\n    case 'error':\n      return paint(`\\n✗ ${chunk.errorText}\\n`, 'red', tty)\n    default:\n      // ai-sdk `data-*` transient parts (e.g. the M4 `data-checkpoint` resume handle).\n      return chunk.type === 'data-checkpoint'\n        ? paint('\\n⎇ checkpoint saved — resume with the same session id\\n', 'dim', tty)\n        : ''\n  }\n}\n\n/**\n * Render the `UIMessageChunk` stream to `stdout`. Sequential: one chunk → its line(s). The SDK run is\n * already paused inside the awaited `pre_tool_call` hook when a `tool-approval-request` arrives, so a\n * blocking `await onApproval(...)` here is correct — no frame buffer, no concurrency. Returns whether\n * an `error` chunk was seen so the caller can signal a non-zero exit (fail-loud, not silent exit 0).\n */\nexport async function renderAgentStreamToTerminal(\n  chunks: AsyncIterable<UIMessageChunk>,\n  opts: TerminalRenderOptions,\n): Promise<{ sawError: boolean }> {\n  const tty = opts.stdout.isTTY\n  const write = (s: string): void => {\n    if (s) opts.stdout.write(s)\n  }\n  // toolCallId → toolName, so the approval prompt (whose chunk carries only ids) can name the tool.\n  const toolNames = new Map<string, string>()\n  let sawError = false\n\n  for await (const chunk of chunks) {\n    if (chunk.type === 'tool-approval-request') {\n      const toolName = toolNames.get(chunk.toolCallId)\n      await opts.onApproval({ approvalId: chunk.approvalId, toolName: toolName ?? 'tool' })\n      continue\n    }\n    if (chunk.type === 'tool-input-available' && chunk.toolCallId) {\n      toolNames.set(chunk.toolCallId, chunk.toolName)\n    }\n    if (chunk.type === 'error') sawError = true\n    write(renderChunkLine(chunk, tty))\n  }\n  return { sawError }\n}\n\n/** Injectable I/O for the approval prompt (defaults to the process streams at the CLI entry). */\nexport interface PromptIO {\n  input: Readable & { isTTY?: boolean }\n  output: Writable & { isTTY?: boolean }\n}\n\n/**\n * Prompt `Approve <tool>? (y/N)` and resolve to the decision. A non-interactive environment (piped /\n * CI — either stream is not a TTY) AUTO-DENIES without prompting (ADR-M5b fail-safe: a decision that\n * cannot be obtained is a deny, never an auto-approve; mirrors HITL `onTimeout: 'abort'`).\n *\n * `timeoutMs` (the gated tool's `@HumanInTheLoop` timeout) auto-denies + closes the prompt when the\n * human walks away — WITHOUT it the readline question would outlive the SDK run (the registry settles\n * the run at its own timeout but readline has no timer), hanging the CLI on a now-irrelevant prompt.\n */\nexport function promptTerminalApproval(\n  req: { toolName: string },\n  io: PromptIO,\n  timeoutMs?: number,\n): Promise<boolean> {\n  if (!io.input.isTTY || !io.output.isTTY) {\n    io.output.write(`\\n⚠ Non-interactive terminal — auto-denying approval for '${req.toolName}'.\\n`)\n    return Promise.resolve(false)\n  }\n  return new Promise<boolean>((resolve) => {\n    const rl = createInterface({ input: io.input, output: io.output })\n    let timer: ReturnType<typeof setTimeout> | undefined\n    const settle = (approved: boolean): void => {\n      if (timer) clearTimeout(timer)\n      rl.close()\n      resolve(approved)\n    }\n    if (timeoutMs !== undefined && timeoutMs > 0) {\n      timer = setTimeout(() => {\n        io.output.write(`\\n⚠ Approval timed out — denying '${req.toolName}'.\\n`)\n        settle(false)\n      }, timeoutMs)\n    }\n    rl.question(`\\n❔ Approve ${req.toolName}? (y/N) `, (answer) => {\n      const a = answer.trim().toLowerCase()\n      settle(a === 'y' || a === 'yes')\n    })\n  })\n}\n","/**\n * M5 (theokit-ai-first) — `theokit agent <name> [message]`: run a scanned agent in the terminal.\n *\n * Scans the top-level `agents/` directory (M2), loads the matched `agents/<name>.ts` through the\n * framework's OWN Vite pipeline (the SAME transpile `theokit dev` uses — legacy `@Agent`/`@Tool`\n * decorators need it; Node's native loader can't transpile TS), resolves the provider apiKey, and\n * runs it in the terminal via the M4 harness (`runAgentInTerminal`). A dev-time surface (ADR 0039 D1),\n * not a CLI product. `deps` is injectable so the fail-fast branches are tested without Vite/an LLM.\n */\nimport { loadEnv } from '../../config/load-env.js'\nimport { resolveProvider } from '../../server/agent/provider-resolver.js'\nimport { runAgentInTerminal } from '../../server/agent/run-terminal-agent.js'\nimport { scanAgents } from '../../server/scan/agent-scan.js'\n\nexport interface AgentCommandDeps {\n  projectRoot?: string\n  /** Load a TS agent module; defaults to a fresh minimal Vite SSR server (framework transpile). */\n  loadModule?: (filePath: string) => Promise<Record<string, unknown>>\n  runAgent?: typeof runAgentInTerminal\n  resolveApiKey?: () => string\n}\n\nexport async function agentCommand(\n  name: string,\n  message: string | undefined,\n  deps: AgentCommandDeps = {},\n): Promise<{ sawError: boolean }> {\n  if (!message || message.trim().length === 0) {\n    throw new Error('theokit agent: a message is required. Usage: theokit agent <name> \"<message>\"')\n  }\n  const projectRoot = deps.projectRoot ?? process.cwd()\n  const agents = scanAgents(projectRoot)\n  const agent = agents.find((a) => a.name === name)\n  if (!agent) {\n    const names = agents.map((a) => a.name).join(', ') || '(none found in agents/)'\n    throw new Error(`theokit agent: '${name}' not found. Available agents: ${names}`)\n  }\n\n  const runAgent = deps.runAgent ?? runAgentInTerminal\n  // Load .env into process.env BEFORE resolving the provider key — parity with `theokit dev`\n  // (dev.ts loadEnv), so an app with OPENROUTER_API_KEY in .env works here too (review H1). Skipped\n  // when the key is injected (tests) — a temp project has no .env anyway.\n  const apiKey =\n    deps.resolveApiKey?.() ??\n    (() => {\n      loadEnv({ cwd: projectRoot, mode: 'development' })\n      return resolveProvider().apiKey\n    })()\n\n  let loadModule = deps.loadModule\n  let dispose: (() => Promise<void>) | undefined\n  if (!loadModule) {\n    const loader = await createAgentSsrLoader(projectRoot)\n    loadModule = loader.load\n    dispose = loader.dispose\n  }\n\n  try {\n    const mod = await loadModule(agent.filePath)\n    return await runAgent(mod, apiKey, { message, source: agent.filePath })\n  } finally {\n    if (dispose) await dispose()\n  }\n}\n\n/**\n * A minimal middleware-mode Vite server built from the SAME `theoPluginAsync` plugin set `theokit dev`\n * uses (`cli/commands/dev.ts`) — so a class-decorated `agents/<name>.ts` transpiles identically. No\n * HTTP listen, no service orchestration, silent — just `ssrLoadModule`. Caller MUST `dispose()`.\n */\nasync function createAgentSsrLoader(projectRoot: string): Promise<{\n  load: (p: string) => Promise<Record<string, unknown>>\n  dispose: () => Promise<void>\n}> {\n  const { createServer } = await import('vite')\n  const react = (await import('@vitejs/plugin-react')).default\n  const { theoPluginAsync } = await import('../../vite-plugin/index.js')\n  const { loadConfig } = await import('../../config/load-config.js')\n  // Pass the project's ssr/services/optimizeDeps config through, exactly as dev.ts does — so an app\n  // that customizes ssr.noExternal transpiles here identically to `theokit dev` (review L1).\n  const config = await loadConfig(projectRoot)\n  const theoPlugins = await theoPluginAsync({\n    root: projectRoot,\n    ssr: config.ssr,\n    services: config.services,\n    viteOptimizeDeps: config.viteOptimizeDeps,\n  })\n  const server = await createServer({\n    root: projectRoot,\n    plugins: [react(), ...theoPlugins],\n    server: { middlewareMode: true },\n    appType: 'custom',\n    logLevel: 'silent',\n  })\n  return {\n    load: (p) => server.ssrLoadModule(p) as Promise<Record<string, unknown>>,\n    dispose: async () => {\n      // Surface a cleanup failure instead of swallowing it (error-handling.md) — non-fatal, the run\n      // already finished, so warn rather than throw past the CLI boundary.\n      await server.close().catch((err: unknown) => {\n        console.warn('[theokit agent] Vite server cleanup error:', err)\n      })\n    },\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/server/agent/run-terminal-agent.ts","../src/server/agent/render-terminal.ts","../src/cli/commands/agent.ts"],"sourcesContent":["/**\n * M5 (theokit-ai-first) — run a compiled agent in the terminal, reusing the M4 harness.\n *\n * The web `mountAgent` renders `streamAgentUIMessages` to an HTTP `Response` and resolves HITL\n * approvals via the approve route. This is its terminal sibling: SAME `compileAgentModule` + SAME\n * `streamAgentUIMessages` + SAME in-process approval registry — only the render surface (stdout) and\n * the approval input (a readline prompt) differ (ADR 0039 D2). In a single-process CLI the stream's\n * `awaitApproval` (→ `registry.register`) and the terminal prompt (→ `registry.resolve`) share the one\n * in-process registry — the M4 singleton's exact fit. No new runtime, no LLM call, no tool dispatch.\n */\nimport {\n  compileAgentModule,\n  streamAgentUIMessages,\n  type HumanInTheLoopOptions,\n} from '@theokit/agents'\n\nimport { getApprovalRegistry, type ApprovalRegistry } from './approval-registry.js'\nimport {\n  promptTerminalApproval,\n  renderAgentStreamToTerminal,\n  type TerminalOut,\n} from './render-terminal.js'\n\nexport interface RunTerminalAgentInput {\n  message: string\n  /** Resume key; a fresh id per run when omitted. */\n  sessionId?: string\n  /** Injectable sink (defaults to `process.stdout` at the CLI entry). */\n  stdout?: TerminalOut\n  /** Injectable shared registry (defaults to the process singleton). */\n  registry?: ApprovalRegistry\n  /** Injectable approval prompt (defaults to the readline prompt over the process streams). */\n  promptApproval?: (req: { toolName: string; timeoutMs?: number }) => Promise<boolean>\n  /** Labels a fail-fast `AgentDefinitionError` (the file path). */\n  source?: string\n}\n\n/**\n * Compile the module (M4, gathers `@Mixin` toolboxes), stream it, and render to the terminal. When the\n * agent has `@HumanInTheLoop`-gated tools, the terminal prompts and resolves the shared registry —\n * approve runs the tool, deny/timeout/non-TTY denies and the run continues.\n */\nexport async function runAgentInTerminal(\n  mod: unknown,\n  apiKey: string,\n  input: RunTerminalAgentInput,\n): Promise<{ sawError: boolean }> {\n  const compiled = compileAgentModule(mod, input.source)\n  const stdout = input.stdout ?? process.stdout\n  const registry = input.registry ?? getApprovalRegistry()\n  const sessionId = input.sessionId ?? crypto.randomUUID()\n  const promptApproval =\n    input.promptApproval ??\n    ((req: { toolName: string; timeoutMs?: number }) =>\n      promptTerminalApproval(req, { input: process.stdin, output: process.stdout }, req.timeoutMs))\n\n  // Mirror mount-agent's HITL wiring; absent ⇒ the non-HITL stream path (M2), unchanged.\n  const gated = compiled.hitl\n  const hitl =\n    gated && gated.size > 0\n      ? {\n          gated,\n          awaitApproval: (approvalId: string, opts: HumanInTheLoopOptions) =>\n            registry.register(approvalId, {\n              timeoutMs: opts.timeout ?? 300_000,\n              onTimeout: opts.onTimeout ?? 'abort',\n            }),\n        }\n      : undefined\n\n  const chunks = streamAgentUIMessages(compiled, apiKey, {\n    message: input.message,\n    sessionId,\n    hitl,\n  })\n  return renderAgentStreamToTerminal(chunks, {\n    stdout,\n    onApproval: async ({ approvalId, toolName }) => {\n      // The renderer paused here (the SDK run is paused in its awaited pre_tool_call hook); prompt,\n      // then resolve the SAME registry the stream registered into — the run resumes with the decision.\n      // The prompt shares the gated tool's timeout so it can never outlive the registry-settled run.\n      const timeoutMs = gated?.get(toolName)?.timeout ?? 300_000\n      const approved = await promptApproval({ toolName, timeoutMs })\n      registry.resolve(approvalId, approved)\n    },\n  })\n}\n","/**\n * M5 (theokit-ai-first) — the terminal render surface for the M4 agent harness.\n *\n * Consumes the M4 `UIMessageChunk` stream (`streamAgentUIMessages`) and writes it to the terminal:\n * streaming text, a dim reasoning line, `▸ tool(input)` / result cards, a checkpoint notice, errors.\n * On a HITL `tool-approval-request` it delegates to the injected `onApproval` (the entry wires that to\n * a readline prompt + the approval registry). This is the ONLY new code M5 adds — no runtime, no LLM\n * call, no tool dispatch (ADR 0039 D2). I/O is INJECTED (`stdout`, prompt streams) so the whole\n * surface is deterministically testable without a TTY (ADR 0039 D4 / ADR-M5a).\n */\nimport { createInterface } from 'node:readline'\nimport type { Readable, Writable } from 'node:stream'\n\nimport type { UIMessageChunk } from 'ai'\n\n/** ANSI helpers — applied only on a TTY so a captured (non-TTY) sink stays plain-text for tests. */\nconst ANSI = {\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  cyan: '\\x1b[36m',\n  green: '\\x1b[32m',\n  reset: '\\x1b[0m',\n}\nfunction paint(text: string, color: keyof typeof ANSI, tty: boolean | undefined): string {\n  return tty ? `${ANSI[color]}${text}${ANSI.reset}` : text\n}\n\n/** A stdout-like sink; `isTTY` gates color (Node's `process.stdout` carries it, a test sink does not). */\nexport type TerminalOut = Writable & { isTTY?: boolean }\n\nexport interface TerminalRenderOptions {\n  stdout: TerminalOut\n  /** Resolve a HITL approval (the entry prompts + resolves the registry). */\n  onApproval: (req: { approvalId: string; toolName: string }) => Promise<void>\n}\n\n/** Render an `unknown` tool output/input for display (string as-is; other JSON-ish values stringified). */\nfunction display(value: unknown): string {\n  return typeof value === 'string' ? value : JSON.stringify(value ?? {})\n}\n\n/**\n * Map a single (non-approval) `UIMessageChunk` to its terminal line(s), or `''` for chunks that render\n * nothing (`start`/`text-start`/`reasoning-start`/…). Pure — the async loop owns approval + I/O.\n * Narrows the `ai` discriminated union directly on `chunk.type` (no cast; G3).\n */\nfunction renderChunkLine(chunk: UIMessageChunk, tty: boolean | undefined): string {\n  switch (chunk.type) {\n    case 'text-delta':\n      return chunk.delta\n    case 'text-end':\n    case 'finish':\n      return '\\n'\n    case 'reasoning-delta':\n      return paint(chunk.delta, 'dim', tty)\n    case 'reasoning-end':\n      return '\\n'\n    case 'tool-input-available':\n      return paint(`\\n▸ ${chunk.toolName}(${display(chunk.input)})\\n`, 'cyan', tty)\n    case 'tool-output-available':\n      return paint(`  ✓ ${display(chunk.output)}\\n`, 'green', tty)\n    case 'tool-output-error':\n      return paint(`  ✗ ${chunk.errorText}\\n`, 'red', tty)\n    case 'error':\n      return paint(`\\n✗ ${chunk.errorText}\\n`, 'red', tty)\n    default:\n      // ai-sdk `data-*` transient parts (e.g. the M4 `data-checkpoint` resume handle).\n      return chunk.type === 'data-checkpoint'\n        ? paint('\\n⎇ checkpoint saved — resume with the same session id\\n', 'dim', tty)\n        : ''\n  }\n}\n\n/**\n * Render the `UIMessageChunk` stream to `stdout`. Sequential: one chunk → its line(s). The SDK run is\n * already paused inside the awaited `pre_tool_call` hook when a `tool-approval-request` arrives, so a\n * blocking `await onApproval(...)` here is correct — no frame buffer, no concurrency. Returns whether\n * an `error` chunk was seen so the caller can signal a non-zero exit (fail-loud, not silent exit 0).\n */\nexport async function renderAgentStreamToTerminal(\n  chunks: AsyncIterable<UIMessageChunk>,\n  opts: TerminalRenderOptions,\n): Promise<{ sawError: boolean }> {\n  const tty = opts.stdout.isTTY\n  const write = (s: string): void => {\n    if (s) opts.stdout.write(s)\n  }\n  // toolCallId → toolName, so the approval prompt (whose chunk carries only ids) can name the tool.\n  const toolNames = new Map<string, string>()\n  let sawError = false\n\n  for await (const chunk of chunks) {\n    if (chunk.type === 'tool-approval-request') {\n      const toolName = toolNames.get(chunk.toolCallId)\n      await opts.onApproval({ approvalId: chunk.approvalId, toolName: toolName ?? 'tool' })\n      continue\n    }\n    if (chunk.type === 'tool-input-available' && chunk.toolCallId) {\n      toolNames.set(chunk.toolCallId, chunk.toolName)\n    }\n    if (chunk.type === 'error') sawError = true\n    write(renderChunkLine(chunk, tty))\n  }\n  return { sawError }\n}\n\n/** Injectable I/O for the approval prompt (defaults to the process streams at the CLI entry). */\nexport interface PromptIO {\n  input: Readable & { isTTY?: boolean }\n  output: Writable & { isTTY?: boolean }\n}\n\n/**\n * Prompt `Approve <tool>? (y/N)` and resolve to the decision. A non-interactive environment (piped /\n * CI — either stream is not a TTY) AUTO-DENIES without prompting (ADR-M5b fail-safe: a decision that\n * cannot be obtained is a deny, never an auto-approve; mirrors HITL `onTimeout: 'abort'`).\n *\n * `timeoutMs` (the gated tool's `@HumanInTheLoop` timeout) auto-denies + closes the prompt when the\n * human walks away — WITHOUT it the readline question would outlive the SDK run (the registry settles\n * the run at its own timeout but readline has no timer), hanging the CLI on a now-irrelevant prompt.\n */\nexport function promptTerminalApproval(\n  req: { toolName: string },\n  io: PromptIO,\n  timeoutMs?: number,\n): Promise<boolean> {\n  if (!io.input.isTTY || !io.output.isTTY) {\n    io.output.write(`\\n⚠ Non-interactive terminal — auto-denying approval for '${req.toolName}'.\\n`)\n    return Promise.resolve(false)\n  }\n  return new Promise<boolean>((resolve) => {\n    const rl = createInterface({ input: io.input, output: io.output })\n    let timer: ReturnType<typeof setTimeout> | undefined\n    const settle = (approved: boolean): void => {\n      if (timer) clearTimeout(timer)\n      rl.close()\n      resolve(approved)\n    }\n    if (timeoutMs !== undefined && timeoutMs > 0) {\n      timer = setTimeout(() => {\n        io.output.write(`\\n⚠ Approval timed out — denying '${req.toolName}'.\\n`)\n        settle(false)\n      }, timeoutMs)\n    }\n    rl.question(`\\n❔ Approve ${req.toolName}? (y/N) `, (answer) => {\n      const a = answer.trim().toLowerCase()\n      settle(a === 'y' || a === 'yes')\n    })\n  })\n}\n","/**\n * M5 (theokit-ai-first) — `theokit agent <name> [message]`: run a scanned agent in the terminal.\n *\n * Scans the top-level `agents/` directory (M2), loads the matched `agents/<name>.ts` through the\n * framework's OWN Vite pipeline (the SAME transpile `theokit dev` uses — legacy `@Agent`/`@Tool`\n * decorators need it; Node's native loader can't transpile TS), resolves the provider apiKey, and\n * runs it in the terminal via the M4 harness (`runAgentInTerminal`). A dev-time surface (ADR 0039 D1),\n * not a CLI product. `deps` is injectable so the fail-fast branches are tested without Vite/an LLM.\n */\nimport { loadEnv } from '../../config/load-env.js'\nimport { resolveProvider } from '../../server/agent/provider-resolver.js'\nimport { runAgentInTerminal } from '../../server/agent/run-terminal-agent.js'\nimport { scanAgents } from '../../server/scan/agent-scan.js'\n\nexport interface AgentCommandDeps {\n  projectRoot?: string\n  /** Load a TS agent module; defaults to a fresh minimal Vite SSR server (framework transpile). */\n  loadModule?: (filePath: string) => Promise<Record<string, unknown>>\n  runAgent?: typeof runAgentInTerminal\n  resolveApiKey?: () => string\n}\n\nexport async function agentCommand(\n  name: string,\n  message: string | undefined,\n  deps: AgentCommandDeps = {},\n): Promise<{ sawError: boolean }> {\n  if (!message || message.trim().length === 0) {\n    throw new Error('theokit agent: a message is required. Usage: theokit agent <name> \"<message>\"')\n  }\n  const projectRoot = deps.projectRoot ?? process.cwd()\n  const agents = scanAgents(projectRoot)\n  const agent = agents.find((a) => a.name === name)\n  if (!agent) {\n    const names = agents.map((a) => a.name).join(', ') || '(none found in agents/)'\n    throw new Error(`theokit agent: '${name}' not found. Available agents: ${names}`)\n  }\n\n  const runAgent = deps.runAgent ?? runAgentInTerminal\n  // Load .env into process.env BEFORE resolving the provider key — parity with `theokit dev`\n  // (dev.ts loadEnv), so an app with OPENROUTER_API_KEY in .env works here too (review H1). Skipped\n  // when the key is injected (tests) — a temp project has no .env anyway.\n  const apiKey =\n    deps.resolveApiKey?.() ??\n    (() => {\n      loadEnv({ cwd: projectRoot, mode: 'development' })\n      return resolveProvider().apiKey\n    })()\n\n  let loadModule = deps.loadModule\n  let dispose: (() => Promise<void>) | undefined\n  if (!loadModule) {\n    const loader = await createAgentSsrLoader(projectRoot)\n    loadModule = loader.load\n    dispose = loader.dispose\n  }\n\n  try {\n    const mod = await loadModule(agent.filePath)\n    return await runAgent(mod, apiKey, { message, source: agent.filePath })\n  } finally {\n    if (dispose) await dispose()\n  }\n}\n\n/**\n * A minimal middleware-mode Vite server built from the SAME `theoPluginAsync` plugin set `theokit dev`\n * uses (`cli/commands/dev.ts`) — so a class-decorated `agents/<name>.ts` transpiles identically. No\n * HTTP listen, no service orchestration, silent — just `ssrLoadModule`. Caller MUST `dispose()`.\n */\nexport async function createAgentSsrLoader(projectRoot: string): Promise<{\n  load: (p: string) => Promise<Record<string, unknown>>\n  dispose: () => Promise<void>\n}> {\n  const { createServer } = await import('vite')\n  const react = (await import('@vitejs/plugin-react')).default\n  const { theoPluginAsync } = await import('../../vite-plugin/index.js')\n  const { loadConfig } = await import('../../config/load-config.js')\n  // Pass the project's ssr/services/optimizeDeps config through, exactly as dev.ts does — so an app\n  // that customizes ssr.noExternal transpiles here identically to `theokit dev` (review L1).\n  const config = await loadConfig(projectRoot)\n  const theoPlugins = await theoPluginAsync({\n    root: projectRoot,\n    ssr: config.ssr,\n    services: config.services,\n    viteOptimizeDeps: config.viteOptimizeDeps,\n  })\n  const server = await createServer({\n    root: projectRoot,\n    plugins: [react(), ...theoPlugins],\n    server: { middlewareMode: true },\n    appType: 'custom',\n    logLevel: 'silent',\n  })\n  return {\n    load: (p) => server.ssrLoadModule(p) as Promise<Record<string, unknown>>,\n    dispose: async () => {\n      // Surface a cleanup failure instead of swallowing it (error-handling.md) — non-fatal, the run\n      // already finished, so warn rather than throw past the CLI boundary.\n      await server.close().catch((err: unknown) => {\n        console.warn('[theokit agent] Vite server cleanup error:', err)\n      })\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2J7XU3PW.js → chunk-AKTGTUU5.js}

@@ -507,4 +507,4 @@ export {
   writeManifest,
   loadManifest
 };
-//# sourceMappingURL=chunk-2J7XU3PW.js.map
+//# sourceMappingURL=chunk-AKTGTUU5.js.map