@sean.holung/minicode 0.3.9 → 0.3.11

package/dist/tests/workspace-changes.test.js

@@ -0,0 +1,82 @@
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, test } from "node:test";
+import { collectWorkspaceChanges, writeWorkspaceDiff, } from "../src/benchmark/workspace-changes.js";
+const tempDirs = [];
+afterEach(async () => {
+    await Promise.all(tempDirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+});
+async function createGitWorkspace() {
+    const workspaceRoot = await mkdtemp(path.join(os.tmpdir(), "minicode-workspace-changes-"));
+    tempDirs.push(workspaceRoot);
+    execFileSync("git", ["init"], { cwd: workspaceRoot, stdio: "ignore" });
+    execFileSync("git", ["config", "user.name", "Codex"], { cwd: workspaceRoot, stdio: "ignore" });
+    execFileSync("git", ["config", "user.email", "codex@example.com"], { cwd: workspaceRoot, stdio: "ignore" });
+    await mkdir(path.join(workspaceRoot, "src"), { recursive: true });
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 1;\n", "utf8");
+    execFileSync("git", ["add", "."], { cwd: workspaceRoot, stdio: "ignore" });
+    execFileSync("git", ["commit", "-m", "init"], { cwd: workspaceRoot, stdio: "ignore" });
+    return workspaceRoot;
+}
+async function createNestedGitWorkspace() {
+    const repoRoot = await mkdtemp(path.join(os.tmpdir(), "minicode-workspace-changes-nested-"));
+    tempDirs.push(repoRoot);
+    execFileSync("git", ["init"], { cwd: repoRoot, stdio: "ignore" });
+    execFileSync("git", ["config", "user.name", "Codex"], { cwd: repoRoot, stdio: "ignore" });
+    execFileSync("git", ["config", "user.email", "codex@example.com"], { cwd: repoRoot, stdio: "ignore" });
+    const workspaceRoot = path.join(repoRoot, "packages", "app");
+    await mkdir(path.join(workspaceRoot, "src"), { recursive: true });
+    await mkdir(path.join(repoRoot, "packages", "other"), { recursive: true });
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 1;\n", "utf8");
+    await writeFile(path.join(repoRoot, "packages", "other", "sibling.ts"), "export const sibling = 1;\n", "utf8");
+    execFileSync("git", ["add", "."], { cwd: repoRoot, stdio: "ignore" });
+    execFileSync("git", ["commit", "-m", "init"], { cwd: repoRoot, stdio: "ignore" });
+    return { repoRoot, workspaceRoot };
+}
+test("collectWorkspaceChanges returns changed files for tracked and untracked edits", async () => {
+    const workspaceRoot = await createGitWorkspace();
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 2;\n", "utf8");
+    await writeFile(path.join(workspaceRoot, "README.md"), "# test\n", "utf8");
+    const changes = await collectWorkspaceChanges(workspaceRoot);
+    assert.equal(changes.isGitRepo, true);
+    assert.deepEqual(changes.changedFiles.sort(), ["README.md", "src/app.ts"]);
+});
+test("writeWorkspaceDiff writes a patch artifact for tracked and untracked changes", async () => {
+    const workspaceRoot = await createGitWorkspace();
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 2;\n", "utf8");
+    await writeFile(path.join(workspaceRoot, "README.md"), "# test\n", "utf8");
+    const diffPath = path.join(workspaceRoot, "artifacts", "result.patch");
+    const wrote = await writeWorkspaceDiff(workspaceRoot, diffPath);
+    const diff = await readFile(diffPath, "utf8");
+    assert.equal(wrote, true);
+    assert.match(diff, /diff --git a\/src\/app\.ts b\/src\/app\.ts/);
+    assert.match(diff, /diff --git a\/README\.md b\/README\.md/);
+});
+test("workspace change collection is scoped to the selected workspace subtree", async () => {
+    const { repoRoot, workspaceRoot } = await createNestedGitWorkspace();
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 2;\n", "utf8");
+    await writeFile(path.join(workspaceRoot, "README.md"), "# app\n", "utf8");
+    await writeFile(path.join(repoRoot, "packages", "other", "sibling.ts"), "export const sibling = 2;\n", "utf8");
+    await writeFile(path.join(repoRoot, "ROOT.md"), "# root\n", "utf8");
+    const changes = await collectWorkspaceChanges(workspaceRoot);
+    assert.equal(changes.isGitRepo, true);
+    assert.deepEqual(changes.changedFiles.sort(), ["README.md", "src/app.ts"]);
+});
+test("workspace diff only includes files inside the selected workspace subtree", async () => {
+    const { repoRoot, workspaceRoot } = await createNestedGitWorkspace();
+    await writeFile(path.join(workspaceRoot, "src", "app.ts"), "export const value = 2;\n", "utf8");
+    await writeFile(path.join(workspaceRoot, "README.md"), "# app\n", "utf8");
+    await writeFile(path.join(repoRoot, "packages", "other", "sibling.ts"), "export const sibling = 2;\n", "utf8");
+    await writeFile(path.join(repoRoot, "ROOT.md"), "# root\n", "utf8");
+    const diffPath = path.join(workspaceRoot, "artifacts", "scoped.patch");
+    const wrote = await writeWorkspaceDiff(workspaceRoot, diffPath);
+    const diff = await readFile(diffPath, "utf8");
+    assert.equal(wrote, true);
+    assert.match(diff, /diff --git a\/src\/app\.ts b\/src\/app\.ts/);
+    assert.match(diff, /diff --git a\/README\.md b\/README\.md/);
+    assert.doesNotMatch(diff, /sibling\.ts/);
+    assert.doesNotMatch(diff, /ROOT\.md/);
+});

package/node_modules/@minicode/agent-sdk/README.md

@@ -1,21 +1,21 @@
-# @minicode/agent-sdk
-
-Reusable agent runtime SDK extracted from minicode. Provides everything needed to build an AI coding agent: model clients, tool registry, session management, safety guardrails, and a turn-based agent loop.
-
-## Installation
-
-This package currently lives as a private workspace package inside the minicode repo:
-
-```bash
-git clone https://github.com/sean1588/minicode.git
-cd minicode
-npm install
-npm run build --workspace=packages/agent-sdk
-```
-
-> **Note:** `packages/agent-sdk/package.json` is currently marked `private`, so treat this README as documentation for the in-repo SDK surface rather than a published npm package.
->
-> **Requires:** Node.js >= 22.0.0
+# @minicode/agent-sdk
+
+Reusable agent runtime SDK extracted from minicode. Provides everything needed to build an AI coding agent: model clients, tool registry, session management, safety guardrails, and a turn-based agent loop.
+
+## Installation
+
+This package currently lives as a private workspace package inside the minicode repo:
+
+```bash
+git clone https://github.com/sean1588/minicode.git
+cd minicode
+npm install
+npm run build --workspace=packages/agent-sdk
+```
+
+> **Note:** `packages/agent-sdk/package.json` is currently marked `private`, so treat this README as documentation for the in-repo SDK surface rather than a published npm package.
+>
+> **Requires:** Node.js >= 22.0.0
 
 ## Quick Start
 
@@ -30,26 +30,26 @@ import {
 import type { AgentConfig } from "@minicode/agent-sdk";
 
 // 1. Define your agent configuration
-const config: AgentConfig = {
-  modelProvider: "anthropic",
-  model: "claude-sonnet-4-20250514",
-  maxSteps: 20,
-  maxTokens: 4096,
-  maxContextTokens: 32_000,
-  workspaceRoot: process.cwd(),
-  commandTimeoutMs: 30_000,
-  maxFileSizeBytes: 1_000_000,
-  commandDenylist: [/rm\s+-rf\s+\//],
-  confirmDestructive: true,
-  keepRecentMessages: 12,
-  loopDetectionWindow: 6,
-  maxToolOutputChars: 8_000,
-  openAiBaseUrl: "",
-  enableFileReadDedup: true,
-  enableAdaptiveKeepRecent: true,
-  enableToolOutputTruncation: true,
-  compactionThreshold: 0.8,
-};
+const config: AgentConfig = {
+  modelProvider: "anthropic",
+  model: "claude-sonnet-4-20250514",
+  maxSteps: 20,
+  maxTokens: 4096,
+  maxContextTokens: 32_000,
+  workspaceRoot: process.cwd(),
+  commandTimeoutMs: 30_000,
+  maxFileSizeBytes: 1_000_000,
+  commandDenylist: [/rm\s+-rf\s+\//],
+  confirmDestructive: true,
+  keepRecentMessages: 12,
+  loopDetectionWindow: 6,
+  maxToolOutputChars: 8_000,
+  openAiBaseUrl: "",
+  enableFileReadDedup: true,
+  enableAdaptiveKeepRecent: true,
+  enableToolOutputTruncation: true,
+  compactionThreshold: 0.8,
+};
 
 // 2. Create the model client, tool registry, and agent
 const modelClient = new AnthropicModelClient(); // reads ANTHROPIC_API_KEY from env
@@ -149,19 +149,19 @@ const agent = new CodingAgent({
 
 Register your own tools alongside or instead of the built-in ones:
 
-```typescript
-import {
-  ToolRegistry,
-  createReadFileTool,
-  createWriteFileTool,
-  createEditFileTool,
-  createSearchTool,
-  createListFilesTool,
-  createRunCommandTool,
-} from "@minicode/agent-sdk";
-import type { ToolDefinition } from "@minicode/agent-sdk";
-
-const myTool: ToolDefinition = {
+```typescript
+import {
+  ToolRegistry,
+  createReadFileTool,
+  createWriteFileTool,
+  createEditFileTool,
+  createSearchTool,
+  createListFilesTool,
+  createRunCommandTool,
+} from "@minicode/agent-sdk";
+import type { ToolDefinition } from "@minicode/agent-sdk";
+
+const myTool: ToolDefinition = {
   name: "get_weather",
   description: "Get the current weather for a city.",
   inputSchema: {
@@ -178,47 +178,61 @@ const myTool: ToolDefinition = {
   },
 };
 
-// Option A: Only custom tools
-const registry = new ToolRegistry([myTool]);
-
-// Option B: Built-in tools + custom tools
-const combined = new ToolRegistry([
-  createReadFileTool(config),
-  createWriteFileTool(config),
-  createEditFileTool(config),
-  createSearchTool(config),
-  createListFilesTool(config),
-  createRunCommandTool(config),
-  myTool,
-]);
-```
-
-In practice, the simplest pattern is usually to create the built-in registry and wrap or extend it in your own application code. The SDK does not currently expose a public "appendTool" helper.
-
-## Tool Hooks (Indexer Integration)
-
-When integrating with a project indexer, use `CoreToolHooks` to get notified after file writes/edits:
+// Option A: Only custom tools
+const registry = new ToolRegistry([myTool]);
+
+// Option B: Built-in tools + custom tools
+const combined = new ToolRegistry([
+  createReadFileTool(config),
+  createWriteFileTool(config),
+  createEditFileTool(config),
+  createSearchTool(config),
+  createListFilesTool(config),
+  createRunCommandTool(config),
+  myTool,
+]);
+```
+
+In practice, the simplest pattern is usually to create the built-in registry and wrap or extend it in your own application code. The SDK does not currently expose a public "appendTool" helper.
+
+Each `createXTool` factory also accepts a narrow per-tool options interface
+(`ReadFileToolOptions`, `WriteFileToolOptions`, `EditFileToolOptions`,
+`ListFilesToolOptions`, `SearchToolOptions`, `RunCommandToolOptions`) so you
+can wire individual tools without constructing a full `AgentConfig`.
+`AgentConfig` satisfies all of them structurally, so passing the full config
+keeps working.
+
+```typescript
+const readTool = createReadFileTool({
+  workspaceRoot: "/path/to/repo",
+  maxFileSizeBytes: 1_000_000,
+});
+```
+
+## Tool Hooks (Indexer Integration)
+
+When integrating with a project indexer, use `CoreToolHooks` to get notified after file writes/edits:
 
 ```typescript
 import { ToolRegistry } from "@minicode/agent-sdk";
 
-const toolRegistry = ToolRegistry.createDefault(config, {
-  afterWrite: (relativePath, content) => {
+const toolRegistry = ToolRegistry.createDefault(config, {
+  afterWrite: async (relativePath, content) => {
     // Re-index the file after it's written
-    projectIndex.reindexFile(relativePath, content);
+    await projectIndex.reindexFile(relativePath, content);
   },
-  afterEdit: (relativePath, content) => {
+  afterEdit: async (relativePath, content) => {
     // Re-index the file after it's edited
-    projectIndex.reindexFile(relativePath, content);
+    await projectIndex.reindexFile(relativePath, content);
   },
-});
-```
-
-## Indexer boundary
-
-The SDK exports indexer and plugin _types_ such as `LanguagePlugin`, `IndexedSymbol`, and `DependencyEdge`, but it does not currently ship the full project indexer implementation that the minicode CLI uses for its TypeScript/JavaScript graph tools. In the current repo layout, the richer indexer lives in the top-level `src/indexer/` directory.
-
-## Safety Guardrails
+});
+```
+
+## Indexer boundary
+
+The SDK exports indexer and plugin _types_ such as `LanguagePlugin`, `IndexedSymbol`, and `DependencyEdge`, but it does not currently ship the full project indexer implementation that the minicode CLI uses for its TypeScript/JavaScript graph tools. In the current repo layout, the richer indexer lives in the top-level `src/indexer/` directory.
+
+## Safety Guardrails
 
 The SDK includes built-in safety features:
 
@@ -256,14 +270,45 @@ Generate a system prompt tailored to the workspace and available tools:
 ```typescript
 import { buildSystemPrompt } from "@minicode/agent-sdk";
 
-const toolSchemas = toolRegistry.getToolSchemas();
-const systemPrompt = buildSystemPrompt(config, toolSchemas);
+const tools = toolRegistry.getToolSchemas();
+const systemPrompt = buildSystemPrompt({ config, tools });
 
 // Optionally include a code map for symbol-aware navigation
-const systemPromptWithCodeMap = buildSystemPrompt(config, toolSchemas, {
-  text: "src/index.ts: main(), startServer()\nsrc/db.ts: connect(), query()",
-  totalCount: 50,
-  shownCount: 2,
+const systemPromptWithCodeMap = buildSystemPrompt({
+  config,
+  tools,
+  codeMap: {
+    text: "src/index.ts: main(), startServer()\nsrc/db.ts: connect(), query()",
+    totalCount: 50,
+    shownCount: 2,
+  },
+});
+```
+
+### Overriding the system prompt
+
+`CodingAgent` accepts an optional `buildSystemPrompt` builder. Return a string
+(or `Promise<string>`) to fully replace the default prompt — handy for review
+bots, RAG assistants, or other non-coding use cases. Import the default
+builder and call it from your override to extend rather than replace it.
+
+```typescript
+import {
+  buildSystemPrompt,
+  CodingAgent,
+  type SystemPromptBuilder,
+} from "@minicode/agent-sdk";
+
+const myBuilder: SystemPromptBuilder = async ({ config, tools, codeMap }) => {
+  const base = buildSystemPrompt({ config, tools, codeMap });
+  return `${base}\n\nAdditional house rules: be terse.`;
+};
+
+const agent = new CodingAgent({
+  config,
+  modelClient,
+  toolRegistry,
+  buildSystemPrompt: myBuilder,
 });
 ```
 
@@ -303,6 +348,157 @@ const systemPromptWithCodeMap = buildSystemPrompt(config, toolSchemas, {
 | `list_files` | List files and directories with pagination |
 | `run_command` | Execute shell commands with timeout and safety checks |
 
+## External MCP Servers
+
+Connect to one or more MCP (Model Context Protocol) servers and pull
+their tools into the agent's `ToolRegistry` alongside the built-in
+ones. The SDK ships the entire MCP client stack — no extra dependency
+is required — and supports the three common transports: `stdio`
+(subprocess), `http` (Streamable-HTTP), and `sse` (legacy SSE).
+
+```typescript
+import {
+  CodingAgent,
+  ToolRegistry,
+  createMcpTools,
+  createReadFileTool,
+} from "@minicode/agent-sdk";
+
+const mcp = await createMcpTools({
+  servers: [
+    {
+      name: "github",
+      transport: "stdio",
+      command: "npx",
+      args: ["-y", "@modelcontextprotocol/server-github"],
+      env: { GITHUB_PERSONAL_ACCESS_TOKEN: process.env.GH_TOKEN! },
+    },
+    {
+      name: "fs",
+      transport: "stdio",
+      command: "npx",
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
+    },
+  ],
+});
+
+const registry = new ToolRegistry([
+  createReadFileTool({ workspaceRoot, maxFileSizeBytes: 1_000_000 }),
+  ...mcp.tools,
+]);
+
+const agent = new CodingAgent({ config, modelClient, toolRegistry: registry });
+
+// On shutdown:
+await mcp.close();
+```
+
+### Behavior notes
+
+- **Namespacing.** Tool names are prefixed with `<server>__` by default
+  (e.g. `github__create_issue`) so two servers can both expose
+  `read_file` without collisions. Pass `{ namespace: false }` to opt out
+  when you control the server set.
+- **Name sanitization.** Anthropic and OpenAI-compatible providers
+  restrict tool names to `[a-zA-Z0-9_-]{1,64}`. Server and tool names
+  outside that pattern (e.g. `github mcp`, `repo.create_issue`) get
+  invalid characters replaced with `_` and the result truncated to 64
+  chars before exposure. The original MCP tool name is preserved for
+  `callTool` dispatch — sanitization only changes what the model sees.
+- **Failure isolation.** A server that fails to start or list its tools
+  is skipped with a warning; other servers keep working. Pass `onError`
+  to override the default `console.warn`.
+- **Permission gate.** MCP tools flow through the existing
+  `beforeToolCall` hook unchanged — hosts can gate them by tool name
+  the same way they gate built-in tools.
+- **Result formatting.** Text content blocks are concatenated into
+  the tool's string output. Image, audio, and binary resource blocks
+  are replaced with bracketed placeholders for now.
+- **Lifecycle.** Connections open at `createMcpTools()` time and stay
+  open until `bundle.close()`. There is no auto-reconnect in v1; if a
+  server crashes mid-session, the next call returns an error and the
+  model can react.
+
+For advanced use cases (custom transport, in-process server, BYO
+`Client`), use the `wrapMcpClients(servers, options)` lower-level
+entry point instead — it takes pre-connected clients and produces the
+same `McpToolBundle`.
+
+## Structured Output
+
+Ask a turn to return validated, schema-conformant JSON instead of free-form
+text. Useful for extraction, classification, and any "agent that thinks via
+tools, then commits to a structured answer" workflow.
+
+Under the hood: when you pass an `outputSchema`, the SDK appends a synthetic
+tool with that input shape to the model's tool list. The model decides to
+"call" it the same way it'd call any other tool; the SDK intercepts the call,
+validates the arguments against your schema, and returns them as
+`result.output`. Real tools and the synthetic tool coexist — the model can
+gather data via real tool calls and then deliver the structured answer.
+
+```typescript
+import {
+  CodingAgent,
+  ToolRegistry,
+  createMcpTools,
+  type OutputSchema,
+} from "@minicode/agent-sdk";
+
+const InvoiceSchema: OutputSchema = {
+  name: "Invoice",
+  description: "Call this with the extracted invoice once you've finished reading the file.",
+  schema: {
+    type: "object",
+    properties: {
+      vendor: { type: "string" },
+      total: { type: "number" },
+      items: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            description: { type: "string" },
+            quantity: { type: "number" },
+            price: { type: "number" },
+          },
+          required: ["description", "quantity", "price"],
+        },
+      },
+    },
+    required: ["vendor", "total", "items"],
+  },
+};
+
+const result = await agent.runTurn(invoiceText, {
+  outputSchema: InvoiceSchema,
+});
+
+// result.output is { vendor: "...", total: 1234, items: [...] }, validated.
+// result.text is the free-form text the model produced (often empty when the
+// model "spoke" entirely via the synthetic tool call).
+```
+
+### Behavior notes
+
+- **Schema mismatch throws.** When the model produces arguments that don't
+  match `outputSchema.schema`, the call rejects with `OutputValidationError`
+  carrying the raw value and ajv's error path list. Catch and retry, or
+  surface diagnostics — silent fallback isn't supported by design.
+- **Loop termination.** A turn with `outputSchema` exits as soon as the
+  model calls the synthetic tool. If real-tool calls and the synthetic call
+  arrive in the same step, the structured answer wins and side-effect calls
+  in that step are ignored.
+- **No output → `result.output === undefined`.** If the model returns plain
+  text and never calls the synthetic tool, you get the same shape as a
+  normal `runTurn` — `result.text` carries the answer. This is rare in
+  practice but worth catching defensively.
+- **Tool-name collisions.** `outputSchema.name` must not match any tool
+  registered with the agent's `ToolRegistry`; the model client throws at
+  call time if it does.
+- **Provider-agnostic.** The same code works against Anthropic and any
+  OpenAI-compatible backend. No provider-specific switches.
+
 ## Development
 
 ```bash

package/node_modules/@minicode/agent-sdk/dist/src/agent/agent.d.ts

@@ -1,8 +1,9 @@
+import { type SystemPromptBuilder } from "../prompt/system-prompt.js";
 import type { CodeMapResult } from "../indexer/types.js";
 import { Session } from "../session/session.js";
 import type { CompactionResult } from "../session/session.js";
 import { ToolRegistry } from "../tools/registry.js";
-import type { AgentConfig, ModelClient } from "./types.js";
+import type { AgentConfig, BeforeToolCallHook, ModelClient, OutputSchema } from "./types.js";
 export type UiUpdateThinking = {
     type: "thinking";
     content: string;
@@ -44,6 +45,8 @@ export declare class CodingAgent {
     private readonly onUiUpdate;
     private readonly onVerbose;
     private readonly getSystemPromptSuffix;
+    private readonly buildSystemPrompt;
+    private readonly beforeToolCall;
     /**
      * Tracks symbol names the user/agent has been working with.
      * Persists across turns so the code map stays focused on the
@@ -69,6 +72,26 @@ export declare class CodingAgent {
         onUiUpdate?: (event: UiUpdate) => void;
         onVerbose?: (message: string) => void;
         getSystemPromptSuffix?: () => string | undefined;
+        /**
+         * Replace the default system-prompt builder. Receives the agent's
+         * config, the active tools, and the current code-map snippet (when
+         * available). Return a string or a Promise<string>. When omitted,
+         * minicode's default coding-agent prompt is used.
+         *
+         * Use this to point the agent at a different domain (review bot,
+         * RAG assistant, non-coding use case) without rewriting the rest
+         * of the SDK. Import `buildSystemPrompt` from `@minicode/agent-sdk`
+         * and call it from your builder to extend the default rather than
+         * replace it.
+         */
+        buildSystemPrompt?: SystemPromptBuilder;
+        /**
+         * Called before each tool call. Return `{outcome: "deny", reason}` to
+         * skip execution; the reason is fed back to the model as the tool's
+         * result. Hosts use this to implement permission prompts (web UI
+         * modal, CLI confirmation, etc.).
+         */
+        beforeToolCall?: BeforeToolCallHook;
     });
     private verboseLog;
     getSession(): Session;
@@ -79,9 +102,12 @@ export declare class CodingAgent {
     };
     setReasoningEffort(effort: AgentConfig["reasoningEffort"]): void;
     /**
-     * Manually compact the conversation context.
-     * Uses LLM-based summarization when compactionModel is configured,
-     * otherwise falls back to mechanical compaction.
+     * Manually compact the conversation context. Uses LLM-based
+     * summarization with `config.compactionModel` if set, otherwise the
+     * agent's primary model (`config.model`). Mechanical compaction is
+     * the internal fallback inside `compactWithLlm` when the LLM call
+     * fails — the result's `method` field tells you which strategy
+     * actually ran.
      */
     compactContext(): Promise<CompactionResult | null>;
     private getFocusSet;
@@ -92,13 +118,23 @@ export declare class CodingAgent {
      * path and hasn't been replaced with a summary stub.
      */
     private isFileReadStillInContext;
+    /**
+     * Run a tool call, gated through `beforeToolCall` if a hook was provided.
+     * A `deny` decision short-circuits execution and feeds the hook's reason
+     * back to the model as the tool's result, so the model sees the rejection
+     * in-band and can choose how to respond.
+     */
+    private executeToolCall;
     runTurn(userMessage: string, options?: {
         signal?: AbortSignal;
+        outputSchema?: OutputSchema;
     }): Promise<{
         text: string;
+        output?: unknown;
         usage?: {
             inputTokens: number;
             outputTokens: number;
+            cachedInputTokens?: number;
         };
         streamed?: boolean;
     }>;

package/node_modules/@minicode/agent-sdk/dist/src/agent/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agent/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAY,MAAM,YAAY,CAAC;AAgGrE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAClF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AACF,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,sBAAsB,GACtB,YAAY,GACZ,qBAAqB,GACrB,mBAAmB,GACnB,qBAAqB,CAAC;AA+B1B,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0E;IACrG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyC;IAE/E;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE,kEAAkE;IAClE,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE;QAClB,MAAM,EAAE,WAAW,CAAC;QACpB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,YAAY,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,aAAa,GAAG,SAAS,CAAC;QACvE,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACvC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACtC,qBAAqB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;KAClD;IAaD,OAAO,CAAC,UAAU;IASlB,UAAU,IAAI,OAAO;IAIrB,kBAAkB,IAAI,WAAW,CAAC,iBAAiB,CAAC;IAIpD,gBAAgB,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAOvE,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAMhE;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAQxD,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAe1B,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CAuTH"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agent/agent.ts"],"names":[],"mappings":"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"}