@sean.holung/minicode 0.3.9 → 0.3.10

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

@@ -3,6 +3,28 @@ export interface ToolCall {
     name: string;
     input: Record<string, unknown>;
 }
+/**
+ * Decision returned from a `beforeToolCall` hook. `allow` proceeds with
+ * normal execution; `deny` short-circuits the tool call and feeds the
+ * `reason` back to the model as the tool's result so it can react
+ * (e.g. explain instead of edit).
+ */
+export type ToolPermissionDecision = {
+    outcome: "allow";
+} | {
+    outcome: "deny";
+    reason: string;
+};
+/**
+ * Hook invoked before each tool call. Implementations can prompt the user,
+ * consult a config flag, or apply any other policy. Returning `allow`
+ * proceeds with normal execution; `deny` skips the tool entirely and
+ * feeds `reason` back to the model.
+ */
+export type BeforeToolCallHook = (toolCall: {
+    name: string;
+    input: Record<string, unknown>;
+}) => Promise<ToolPermissionDecision>;
 export interface UserMessage {
     role: "user";
     content: string;
@@ -46,11 +68,17 @@ export interface AgentConfig {
     enableToolOutputTruncation?: boolean;
     /** Context fullness ratio (0-1) at which compaction triggers. Default: undefined (no auto-compaction) */
     compactionThreshold?: number;
-    /** Model to use for LLM-based compaction. When set, compaction uses an LLM to summarize instead of mechanical truncation. */
+    /**
+     * Override the model used for LLM-based compaction. Compaction always
+     * uses an LLM by default (with `model` as the implicit choice); set this
+     * to use a different, typically cheaper or faster, model for the
+     * summarization call. Mechanical compaction is the internal fallback
+     * if the LLM call fails.
+     */
     compactionModel?: string;
     /** Reasoning effort level for models that support reasoning tokens. When unset, no reasoning parameters are sent. */
     reasoningEffort?: ReasoningEffort;
-    /** Rebuild the system prompt (including code map) every agent step. Disabling improves KV cache hit rates for local models. Default: true */
+    /** Rebuild the system prompt (including code map) every agent step. Disabling improves KV cache hit rates for local models. Default: false */
     enableDynamicPrompt?: boolean;
 }
 export interface ToolSchema {
@@ -68,11 +96,62 @@ export interface ModelResponse {
     text: string;
     toolCalls: ToolCall[];
     stopReason: "end_turn" | "tool_use" | "max_tokens";
+    /**
+     * Set when the caller supplied an `outputSchema` and the model
+     * called the synthetic respond tool with arguments matching the
+     * schema. The synthetic tool call is stripped from `toolCalls` so
+     * the agent loop does not try to dispatch it.
+     */
+    output?: unknown;
     usage: {
         inputTokens: number;
         outputTokens: number;
+        /**
+         * Tokens served from the provider's prompt cache, when reported.
+         * Anthropic exposes `cache_read_input_tokens`; OpenAI / OpenRouter /
+         * DeepSeek / Gemini expose `prompt_tokens_details.cached_tokens`.
+         * Both clients normalise to this field. Useful for surfacing cache
+         * effectiveness in the UI without callers needing to know the
+         * provider-specific shape.
+         */
+        cachedInputTokens?: number;
     };
 }
+/**
+ * Schema for structured-output turns. When passed to `runTurn` or
+ * `ModelClient.chat`, the SDK registers a synthetic tool with this
+ * shape; the model "calling" it delivers a structured answer that the
+ * SDK validates and returns as `ModelResponse.output` /
+ * `runTurn().output`.
+ */
+export interface OutputSchema {
+    /**
+     * Tool-facing name. Must match `^[a-zA-Z0-9_-]{1,64}$` (the tool-name
+     * pattern both providers accept). Pick a descriptive name —
+     * the model sees it.
+     */
+    name: string;
+    /** JSON Schema (draft 2020-12 subset) describing the desired output. */
+    schema: Record<string, unknown>;
+    /** Description shown to the model on the synthetic tool. */
+    description?: string;
+}
+/**
+ * Thrown when the model's structured-output call fails JSON Schema
+ * validation. Carries the raw arguments and the validator's error
+ * list so consumers can log, retry, or surface diagnostics.
+ */
+export declare class OutputValidationError extends Error {
+    readonly raw: unknown;
+    readonly errors: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>;
+    constructor(message: string, raw: unknown, errors: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>);
+}
 /** Describes a model available from the provider. */
 export interface ModelInfo {
     id: string;
@@ -88,6 +167,22 @@ export interface ModelClient {
         reasoningEffort?: ReasoningEffort;
         onStream?: (chunk: string) => void;
         signal?: AbortSignal;
+        /**
+         * When true (default), the client tells the provider to cache the
+         * stable prefix of the request (system prompt + tools). Set to false
+         * when the system prompt is rebuilt on every step (e.g. with
+         * `enableDynamicPrompt: true`) so the cache isn't constantly
+         * invalidated and re-written. Tools are always cacheable separately.
+         */
+        cacheableSystem?: boolean;
+        /**
+         * When supplied, the client appends a synthetic tool with this
+         * schema to the request. If the model calls that tool, the
+         * arguments are validated against the schema and surfaced via
+         * `ModelResponse.output`; the synthetic call is stripped from
+         * `toolCalls`. A schema mismatch throws `OutputValidationError`.
+         */
+        outputSchema?: OutputSchema;
     }): Promise<ModelResponse>;
     /** List models available from the provider. Returns empty array on failure. */
     listModels?(): Promise<ModelInfo[]>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":"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"}

package/node_modules/@minicode/agent-sdk/dist/src/agent/types.js

@@ -1,2 +1,16 @@
-export {};
+/**
+ * Thrown when the model's structured-output call fails JSON Schema
+ * validation. Carries the raw arguments and the validator's error
+ * list so consumers can log, retry, or surface diagnostics.
+ */
+export class OutputValidationError extends Error {
+    raw;
+    errors;
+    constructor(message, raw, errors) {
+        super(message);
+        this.name = "OutputValidationError";
+        this.raw = raw;
+        this.errors = errors;
+    }
+}
 //# sourceMappingURL=types.js.map

package/node_modules/@minicode/agent-sdk/dist/src/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":"AAoJA;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,GAAG,CAAU;IACb,MAAM,CAAmD;IAElE,YACE,OAAe,EACf,GAAY,EACZ,MAAwD;QAExD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

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

@@ -1,17 +1,19 @@
-export type { AgentConfig, AssistantMessage, ModelClient, ModelInfo, ModelResponse, ReasoningEffort, SessionMessage, ToolCall, ToolDefinition, ToolResultMessage, ToolSchema, UserMessage, } from "./agent/types.js";
+export type { AgentConfig, AssistantMessage, BeforeToolCallHook, ModelClient, ModelInfo, ModelResponse, OutputSchema, ReasoningEffort, SessionMessage, ToolCall, ToolDefinition, ToolPermissionDecision, ToolResultMessage, ToolSchema, UserMessage, } from "./agent/types.js";
+export { OutputValidationError } from "./agent/types.js";
 export { CodingAgent, type UiUpdate, type UiUpdateThinking, type UiUpdateStreamingChunk, type UiUpdateStep, type UiUpdateToolCallStart, type UiUpdateToolCallEnd, type UiUpdateContextStatus, } from "./agent/agent.js";
 export { Session, type SessionSnapshot, type CompactionResult } from "./session/session.js";
 export { AnthropicModelClient, OpenAICompatibleModelClient, createModelClient, } from "./model/client.js";
 export { ToolRegistry, type CoreToolHooks } from "./tools/registry.js";
-export { createReadFileTool } from "./tools/read-file.js";
-export { createWriteFileTool, type WriteFileHooks } from "./tools/write-file.js";
-export { createEditFileTool, type EditFileHooks } from "./tools/edit-file.js";
-export { createSearchTool } from "./tools/search.js";
-export { createListFilesTool } from "./tools/list-files.js";
-export { createRunCommandTool, type RunCommandHooks } from "./tools/run-command.js";
+export { createReadFileTool, type ReadFileToolOptions, } from "./tools/read-file.js";
+export { createWriteFileTool, type WriteFileHooks, type WriteFileToolOptions, } from "./tools/write-file.js";
+export { createEditFileTool, type EditFileHooks, type EditFileToolOptions, } from "./tools/edit-file.js";
+export { createSearchTool, type SearchToolOptions, } from "./tools/search.js";
+export { createListFilesTool, type ListFilesToolOptions, } from "./tools/list-files.js";
+export { createRunCommandTool, type RunCommandHooks, type RunCommandToolOptions, } from "./tools/run-command.js";
 export { expectNonEmptyString, expectOptionalBoolean, expectOptionalNumber, formatWithLineNumbers, toJson, } from "./tools/helpers.js";
 export { ensureStepWithinLimit, isDestructiveCommand, isWithinWorkspacePath, normalizeWorkspaceRoot, resolveWorkspacePath, validateCommand, validateFileReadSize, validatePath, } from "./safety/guardrails.js";
-export { buildSystemPrompt, } from "./prompt/system-prompt.js";
+export { buildSystemPrompt, type SystemPromptBuilder, type SystemPromptContext, } from "./prompt/system-prompt.js";
 export { FocusTracker } from "./indexer/focus-tracker.js";
 export type { CodeMapResult, DependencyEdge, DependencyEdgeKind, IndexedSymbol, LanguagePlugin, ProjectIndex, SymbolKind, } from "./indexer/types.js";
+export { createMcpTools, formatMcpResult, wrapMcpClients, type CreateMcpToolsOptions, type McpServerConfig, type McpToolBundle, } from "./mcp/client-registry.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGpF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EACL,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC"}

package/node_modules/@minicode/agent-sdk/dist/src/index.js

@@ -1,3 +1,5 @@
+// Structured output
+export { OutputValidationError } from "./agent/types.js";
 // Agent runtime
 export { CodingAgent, } from "./agent/agent.js";
 // Session
@@ -7,12 +9,12 @@ export { AnthropicModelClient, OpenAICompatibleModelClient, createModelClient, }
 // Tool registry
 export { ToolRegistry } from "./tools/registry.js";
 // Individual tool factories
-export { createReadFileTool } from "./tools/read-file.js";
-export { createWriteFileTool } from "./tools/write-file.js";
-export { createEditFileTool } from "./tools/edit-file.js";
-export { createSearchTool } from "./tools/search.js";
-export { createListFilesTool } from "./tools/list-files.js";
-export { createRunCommandTool } from "./tools/run-command.js";
+export { createReadFileTool, } from "./tools/read-file.js";
+export { createWriteFileTool, } from "./tools/write-file.js";
+export { createEditFileTool, } from "./tools/edit-file.js";
+export { createSearchTool, } from "./tools/search.js";
+export { createListFilesTool, } from "./tools/list-files.js";
+export { createRunCommandTool, } from "./tools/run-command.js";
 // Tool helpers
 export { expectNonEmptyString, expectOptionalBoolean, expectOptionalNumber, formatWithLineNumbers, toJson, } from "./tools/helpers.js";
 // Safety / guardrails
@@ -21,4 +23,6 @@ export { ensureStepWithinLimit, isDestructiveCommand, isWithinWorkspacePath, nor
 export { buildSystemPrompt, } from "./prompt/system-prompt.js";
 // Focus tracker
 export { FocusTracker } from "./indexer/focus-tracker.js";
+// MCP client integration
+export { createMcpTools, formatMcpResult, wrapMcpClients, } from "./mcp/client-registry.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@minicode/agent-sdk/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAgBA,gBAAgB;AAChB,OAAO,EACL,WAAW,GAQZ,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,OAAO,EAA+C,MAAM,sBAAsB,CAAC;AAE5F,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAEvE,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAuB,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAsB,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAwB,MAAM,wBAAwB,CAAC;AAEpF,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,gBAAgB;AAChB,OAAO,EACL,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAmBA,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,gBAAgB;AAChB,OAAO,EACL,WAAW,GAQZ,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,OAAO,EAA+C,MAAM,sBAAsB,CAAC;AAE5F,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAEvE,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,GAGpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,gBAAgB;AAChB,OAAO,EACL,iBAAiB,GAGlB,MAAM,2BAA2B,CAAC;AAEnC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAa1D,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,GAIf,MAAM,0BAA0B,CAAC"}

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

@@ -35,13 +35,18 @@ export interface DependencyEdge {
 }
 /**
  * Contract for language-specific indexer plugins.
+ *
+ * `indexFile` and `resolveDependencies` may return either a value or a Promise;
+ * the host awaits the result, so plugins backed by async sources (LSP, network,
+ * WASM parsers with async init) can return promises while sync plugins continue
+ * to return arrays directly.
  */
 export interface LanguagePlugin {
     name: string;
     extensions: string[];
     canIndex(filePath: string): boolean;
-    indexFile(filePath: string, content: string): IndexedSymbol[];
-    resolveDependencies?(symbols: IndexedSymbol[], projectFiles: Map<string, string>): DependencyEdge[];
+    indexFile(filePath: string, content: string): IndexedSymbol[] | Promise<IndexedSymbol[]>;
+    resolveDependencies?(symbols: IndexedSymbol[], projectFiles: Map<string, string>): DependencyEdge[] | Promise<DependencyEdge[]>;
 }
 /**
  * Result of code map generation.
@@ -71,7 +76,7 @@ export interface ProjectIndex {
     /** Trace a symbol back to its entry point(s) — symbols with no inbound edges. Returns paths from the symbol to each reachable entry point. */
     findPathToEntryPoint(symbolName: string, maxDepth?: number): IndexedSymbol[][];
     /** Re-index a file after it has been modified. Updates symbols and dependency edges. */
-    reindexFile(filePath: string, content: string): void;
+    reindexFile(filePath: string, content: string): Promise<void>;
     /** Re-scan the workspace from disk and rebuild indexed files, symbols, and dependency edges in place. */
     refreshFromWorkspace(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/indexer/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/indexer/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,109 @@
+/**
+ * MCP (Model Context Protocol) client integration for the Agent SDK.
+ *
+ * Connects to one or more external MCP servers, lists their tools, and
+ * wraps each as a `ToolDefinition` ready to drop into a `ToolRegistry`.
+ * Consumers get the entire MCP ecosystem (filesystem, github, sqlite,
+ * puppeteer, ...) without hand-wrapping every tool.
+ *
+ * Symmetric to `src/serve/mcp-server.ts` (which exposes minicode's
+ * tools as an MCP *server*); this is the *client* side.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { ToolDefinition } from "../agent/types.js";
+/**
+ * Configuration for a single MCP server. Three transports are
+ * supported: spawn a subprocess (`stdio`, the most common shape),
+ * connect to a hosted Streamable-HTTP endpoint (`http`), or connect
+ * to a legacy SSE endpoint (`sse`).
+ */
+export type McpServerConfig = {
+    name: string;
+    transport: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+} | {
+    name: string;
+    transport: "http";
+    url: string;
+    headers?: Record<string, string>;
+} | {
+    name: string;
+    transport: "sse";
+    url: string;
+    headers?: Record<string, string>;
+};
+export interface CreateMcpToolsOptions {
+    servers: McpServerConfig[];
+    /**
+     * Prefix tool names with `<server>__` to avoid collisions across
+     * servers that happen to expose the same tool name (e.g. multiple
+     * servers exposing `read_file`). Default: true.
+     */
+    namespace?: boolean;
+    /**
+     * Called when a server fails to connect or list its tools. The
+     * agent continues with the rest of the servers — a flaky GitHub
+     * MCP shouldn't break filesystem MCP. Default: `console.warn`.
+     */
+    onError?: (server: string, error: unknown) => void;
+}
+export interface McpToolBundle {
+    /** Tools ready to drop into a `ToolRegistry`. */
+    tools: ToolDefinition[];
+    /** Disconnect every connected client. Call on agent shutdown. */
+    close: () => Promise<void>;
+}
+interface McpContentBlock {
+    type: string;
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    resource?: {
+        uri: string;
+        text?: string;
+        blob?: string;
+        mimeType?: string;
+    };
+    uri?: string;
+    name?: string;
+}
+/**
+ * Render an MCP tool result into a string the model can read.
+ * Concatenates text blocks; non-text blocks become bracketed
+ * placeholders so the model knows something was returned without
+ * us having to support binary content end-to-end (out of scope for
+ * v1 — see #168).
+ */
+export declare function formatMcpResult(content: ReadonlyArray<McpContentBlock>): string;
+/**
+ * Discover tools on a list of already-connected MCP clients and wrap
+ * each as a `ToolDefinition`. The advanced entry point — most
+ * consumers want `createMcpTools` instead, which also handles
+ * spawning / connecting the underlying transport. Useful when the
+ * caller wants to bring its own `Client` (e.g. a custom transport or
+ * an in-memory test server).
+ *
+ * Ownership: the returned bundle takes ownership of every client
+ * passed in. `bundle.close()` closes successful clients; any client
+ * whose `listTools()` throws is also closed before `onError` fires,
+ * so callers don't have to worry about leaked transports.
+ */
+export declare function wrapMcpClients(servers: Array<{
+    name: string;
+    client: Client;
+}>, options?: {
+    namespace?: boolean;
+    onError?: CreateMcpToolsOptions["onError"];
+}): Promise<McpToolBundle>;
+/**
+ * Connect to each configured MCP server, discover its tools, and
+ * return them as `ToolDefinition`s ready to register. Servers that
+ * fail to connect or list their tools are skipped (with a warning);
+ * the bundle still includes tools from the servers that succeeded.
+ */
+export declare function createMcpTools(options: CreateMcpToolsOptions): Promise<McpToolBundle>;
+export {};
+//# sourceMappingURL=client-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-registry.d.ts","sourceRoot":"","sources":["../../../src/mcp/client-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,iEAAiE;IACjE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA0CD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GACtC,MAAM,CA8CR;AA8ED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAA;CAAE,GAC5E,OAAO,CAAC,aAAa,CAAC,CAkExB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/node_modules/@minicode/agent-sdk/dist/src/mcp/client-registry.js

@@ -0,0 +1,237 @@
+/**
+ * MCP (Model Context Protocol) client integration for the Agent SDK.
+ *
+ * Connects to one or more external MCP servers, lists their tools, and
+ * wraps each as a `ToolDefinition` ready to drop into a `ToolRegistry`.
+ * Consumers get the entire MCP ecosystem (filesystem, github, sqlite,
+ * puppeteer, ...) without hand-wrapping every tool.
+ *
+ * Symmetric to `src/serve/mcp-server.ts` (which exposes minicode's
+ * tools as an MCP *server*); this is the *client* side.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+function createTransport(config) {
+    switch (config.transport) {
+        case "stdio": {
+            const params = {
+                command: config.command,
+                args: config.args ?? [],
+            };
+            if (config.env)
+                params.env = config.env;
+            if (config.cwd)
+                params.cwd = config.cwd;
+            return new StdioClientTransport(params);
+        }
+        case "http": {
+            const opts = config.headers
+                ? { requestInit: { headers: config.headers } }
+                : undefined;
+            return new StreamableHTTPClientTransport(new URL(config.url), opts);
+        }
+        case "sse": {
+            const opts = config.headers
+                ? { requestInit: { headers: config.headers } }
+                : undefined;
+            return new SSEClientTransport(new URL(config.url), opts);
+        }
+    }
+}
+/**
+ * Render an MCP tool result into a string the model can read.
+ * Concatenates text blocks; non-text blocks become bracketed
+ * placeholders so the model knows something was returned without
+ * us having to support binary content end-to-end (out of scope for
+ * v1 — see #168).
+ */
+export function formatMcpResult(content) {
+    if (content.length === 0) {
+        return "(empty result)";
+    }
+    const parts = [];
+    for (const block of content) {
+        switch (block.type) {
+            case "text":
+                if (typeof block.text === "string") {
+                    parts.push(block.text);
+                }
+                break;
+            case "image":
+                parts.push(`[image content omitted (${block.mimeType ?? "unknown type"})]`);
+                break;
+            case "audio":
+                parts.push(`[audio content omitted (${block.mimeType ?? "unknown type"})]`);
+                break;
+            case "resource": {
+                const r = block.resource;
+                if (r && typeof r.text === "string") {
+                    parts.push(r.text);
+                }
+                else if (r) {
+                    parts.push(`[resource ${r.uri}${r.mimeType ? ` (${r.mimeType})` : ""}]`);
+                }
+                else {
+                    parts.push("[resource]");
+                }
+                break;
+            }
+            case "resource_link": {
+                const label = block.name ?? block.uri ?? "unknown";
+                parts.push(`[resource_link ${label}]`);
+                break;
+            }
+            default:
+                parts.push(`[unsupported content type: ${block.type}]`);
+        }
+    }
+    return parts.join("\n");
+}
+function defaultOnError(server, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.warn(`[minicode-mcp] Failed to load tools from server "${server}": ${message}`);
+}
+async function connectServer(config) {
+    const transport = createTransport(config);
+    const client = new Client({ name: "@minicode/agent-sdk", version: "0.1.0" }, { capabilities: {} });
+    // The MCP SDK's Transport interface uses `string` for some fields the
+    // concrete transports declare as `string | undefined`. Cast to bypass
+    // the exactOptionalPropertyTypes mismatch — same pattern used on the
+    // server side in src/serve/mcp-server.ts.
+    await client.connect(transport);
+    return { name: config.name, client };
+}
+/**
+ * Anthropic and OpenAI-compatible providers restrict tool names to
+ * `^[a-zA-Z0-9_-]{1,64}$`. MCP servers and config impose no such
+ * limit (a server might be named `github mcp` or expose a tool
+ * `repo.create_issue`), so we sanitize each segment by replacing any
+ * disallowed character with `_` and truncating to 64 chars. The
+ * original MCP tool name is preserved separately for `callTool`
+ * dispatch — sanitization only affects what the model sees.
+ */
+const TOOL_NAME_INVALID = /[^a-zA-Z0-9_-]/g;
+const TOOL_NAME_MAX_LENGTH = 64;
+function sanitizeNameSegment(segment) {
+    return segment.replace(TOOL_NAME_INVALID, "_");
+}
+function buildExposedName(serverName, toolName, namespace) {
+    const raw = namespace
+        ? `${sanitizeNameSegment(serverName)}__${sanitizeNameSegment(toolName)}`
+        : sanitizeNameSegment(toolName);
+    return raw.slice(0, TOOL_NAME_MAX_LENGTH);
+}
+function buildToolDefinition(server, tool, namespace) {
+    const exposedName = buildExposedName(server.name, tool.name, namespace);
+    return {
+        name: exposedName,
+        description: tool.description ?? `Tool from MCP server "${server.name}".`,
+        inputSchema: tool.inputSchema,
+        execute: async (input) => {
+            const result = await server.client.callTool({
+                name: tool.name,
+                arguments: input,
+            });
+            const formatted = formatMcpResult((result.content ?? []));
+            if (result.isError) {
+                return `MCP tool error (${exposedName}): ${formatted}`;
+            }
+            return formatted;
+        },
+    };
+}
+/**
+ * Discover tools on a list of already-connected MCP clients and wrap
+ * each as a `ToolDefinition`. The advanced entry point — most
+ * consumers want `createMcpTools` instead, which also handles
+ * spawning / connecting the underlying transport. Useful when the
+ * caller wants to bring its own `Client` (e.g. a custom transport or
+ * an in-memory test server).
+ *
+ * Ownership: the returned bundle takes ownership of every client
+ * passed in. `bundle.close()` closes successful clients; any client
+ * whose `listTools()` throws is also closed before `onError` fires,
+ * so callers don't have to worry about leaked transports.
+ */
+export async function wrapMcpClients(servers, options) {
+    const namespace = options?.namespace ?? true;
+    const onError = options?.onError ?? defaultOnError;
+    const connected = [];
+    await Promise.all(servers.map(async ({ name, client }) => {
+        try {
+            const result = await client.listTools();
+            connected.push({
+                name,
+                client,
+                tools: result.tools.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                })),
+            });
+        }
+        catch (error) {
+            // Transport may have already connected before listTools threw —
+            // close it so we don't leak the spawned subprocess / HTTP /
+            // SSE connection. Errors during cleanup are swallowed; the
+            // original failure is what the caller cares about.
+            try {
+                await client.close();
+            }
+            catch {
+                // ignore
+            }
+            onError(name, error);
+        }
+    }));
+    const tools = [];
+    const seenNames = new Set();
+    for (const server of connected) {
+        for (const tool of server.tools) {
+            const def = buildToolDefinition(server, tool, namespace);
+            if (def.name.length === 0) {
+                onError(server.name, new Error(`Tool "${tool.name}" sanitized to an empty name; skipping.`));
+                continue;
+            }
+            if (seenNames.has(def.name)) {
+                onError(server.name, new Error(`Tool name collision: "${def.name}" is already exposed by another server.`));
+                continue;
+            }
+            seenNames.add(def.name);
+            tools.push(def);
+        }
+    }
+    const close = async () => {
+        await Promise.allSettled(connected.map((s) => s.client.close()));
+    };
+    return { tools, close };
+}
+/**
+ * Connect to each configured MCP server, discover its tools, and
+ * return them as `ToolDefinition`s ready to register. Servers that
+ * fail to connect or list their tools are skipped (with a warning);
+ * the bundle still includes tools from the servers that succeeded.
+ */
+export async function createMcpTools(options) {
+    const onError = options.onError ?? defaultOnError;
+    const settled = await Promise.allSettled(options.servers.map((s) => connectServer(s)));
+    const connected = [];
+    settled.forEach((result, idx) => {
+        const cfg = options.servers[idx];
+        if (!cfg)
+            return;
+        if (result.status === "fulfilled") {
+            connected.push(result.value);
+        }
+        else {
+            onError(cfg.name, result.reason);
+        }
+    });
+    const wrapOpts = { onError };
+    if (options.namespace !== undefined)
+        wrapOpts.namespace = options.namespace;
+    return wrapMcpClients(connected, wrapOpts);
+}
+//# sourceMappingURL=client-registry.js.map