@vinhnt-sdk/core 0.1.0

package/dist/tool/define-tool.js

@@ -0,0 +1,120 @@
+import { validateInput } from "./validate.js";
+/** Map a Zod schema to the codebase's `NestedJsonSchema` shape (best effort). */
+export function zodSchemaToNestedJsonSchema(schema) {
+    if (!schema)
+        return undefined;
+    const out = convert(schema);
+    return out ? Object.assign({}, out) : undefined;
+}
+function convert(schema) {
+    if (!schema)
+        return undefined;
+    // Unwrap effects (refine/transform) and optional/default wrappers.
+    while (schema._def.type === "effects" || schema._def.type === "optional" || schema._def.type === "default") {
+        if (schema._def.type === "effects")
+            schema = schema._def.schema;
+        else
+            schema = schema._def.innerType;
+    }
+    const base = {};
+    const desc = schema.description ?? schema._def.description;
+    if (desc)
+        base.description = desc;
+    switch (schema._def.type) {
+        case "string":
+            base.type = "string";
+            return base;
+        case "number":
+            base.type = "number";
+            return base;
+        case "boolean":
+            base.type = "boolean";
+            return base;
+        case "enum": {
+            const entries = schema._def.entries ?? {};
+            base.type = "string";
+            base.enum = Object.keys(entries);
+            return base;
+        }
+        case "literal":
+            base.type = typeof schema._def.value === "string" ? "string" : "number";
+            return base;
+        case "array": {
+            base.type = "array";
+            base.items = convert(schema._def.innerType) ?? { type: "string" };
+            return base;
+        }
+        case "record":
+            base.type = "object";
+            return base;
+        case "object": {
+            base.type = "object";
+            const raw = schema._def.shape;
+            const shape = typeof raw === "function" ? raw() : (raw ?? {});
+            const properties = {};
+            const required = [];
+            for (const [key, child] of Object.entries(shape)) {
+                properties[key] = convert(child) ?? { type: "string" };
+                if (!child.isOptional?.() && child._def?.type !== "optional" && child._def?.type !== "default") {
+                    required.push(key);
+                }
+            }
+            base.properties = properties;
+            if (required.length)
+                base.required = required;
+            return base;
+        }
+        case "union": {
+            const options = schema._def.options ?? [];
+            if (options.every((o) => o._def?.type === "string")) {
+                base.type = "string";
+                return base;
+            }
+            if (options.every((o) => o._def?.type === "number")) {
+                base.type = "number";
+                return base;
+            }
+            base.type = "string";
+            return base;
+        }
+        default:
+            base.type = "string";
+            return base;
+    }
+}
+export function defineTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        risk: config.risk,
+        timeoutMs: config.timeoutMs,
+        permissionAction: config.permissionAction,
+        input: config.input,
+        toDefinition() {
+            return {
+                id: config.name,
+                description: config.description,
+                risk: config.risk,
+                inputSchema: config.jsonSchema ?? zodSchemaToNestedJsonSchema(config.input),
+                timeoutMs: config.timeoutMs,
+                permissionAction: config.permissionAction,
+                inputZodSchema: config.input,
+                outputZodSchema: config.output,
+                async execute(raw, ctx) {
+                    const normalized = config.normalize ? config.normalize(raw) : raw;
+                    const input = validateInput(config.name, config.input, normalized);
+                    const result = await config.execute(input, ctx);
+                    if (config.output) {
+                        return validateInput(config.name, config.output, result);
+                    }
+                    return result;
+                },
+            };
+        },
+    };
+}
+/** Convenience: build a ToolDefinition directly from a ToolConfig. */
+export function toolToDefinition(config) {
+    return defineTool(config).toDefinition();
+}
+//# sourceMappingURL=define-tool.js.map

package/dist/tool/define-tool.js.map

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

package/dist/tool/definitions.d.ts

@@ -0,0 +1,22 @@
+import type { z } from "zod";
+import type { ToolContext } from "./context.js";
+export type { ToolContext };
+import type { NestedJsonSchema } from "./json-schema.js";
+export type ToolRisk = "read" | "write" | "destructive" | "external";
+export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
+    readonly id: string;
+    readonly description: string;
+    /** JSON Schema for LLM-facing input generation */
+    readonly inputSchema?: NestedJsonSchema | undefined;
+    readonly risk: ToolRisk;
+    /** Per-tool timeout in ms (overrides global default). */
+    readonly timeoutMs?: number;
+    /** Permission action key for the gate (e.g. "edit", "shell"). Optional; defaults to risk. */
+    readonly permissionAction?: string;
+    /** Zod schema for runtime input validation (carried from defineTool). */
+    readonly inputZodSchema?: z.ZodType<TInput>;
+    /** Zod schema for runtime output validation (carried from defineTool). */
+    readonly outputZodSchema?: z.ZodType<TOutput>;
+    execute(input: TInput, ctx: ToolContext): Promise<TOutput>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/tool/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tool/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D"}

package/dist/tool/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/tool/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tool/definitions.ts"],"names":[],"mappings":""}

package/dist/tool/description-lint.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ── Tool description lint (Phase 5) ──────────────────────────────────────
+ * LLM tool-selection accuracy depends on description quality: a bad or vague
+ * description ("Do stuff") makes the model pick the wrong tool or skip it.
+ * This module flags the common "smells" in tool descriptions so authors and
+ * CI can catch them early, mirroring API-doc review practices.
+ */
+export type DescriptionIssueCode = "empty" | "too-short" | "no-verb" | "vague" | "placeholder" | "too-long";
+export interface ToolDescriptionIssue {
+    readonly code: DescriptionIssueCode;
+    readonly message: string;
+}
+export interface ToolDescriptionReport {
+    readonly tool: string;
+    readonly description: string;
+    readonly issues: readonly ToolDescriptionIssue[];
+}
+/** Lint a single tool description. Returns the report (empty `issues` = clean). */
+export declare function lintToolDescription(tool: string, description: string): ToolDescriptionReport;
+/** Lint a list of tool definitions, returning only the ones with issues. */
+export declare function lintToolDefinitions(definitions: readonly {
+    id: string;
+    description: string;
+}[]): ToolDescriptionReport[];
+//# sourceMappingURL=description-lint.d.ts.map

package/dist/tool/description-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-lint.d.ts","sourceRoot":"","sources":["../../src/tool/description-lint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAE5G,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAwCD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,qBAAqB,CA6C5F;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,GAC1D,qBAAqB,EAAE,CAIzB"}

package/dist/tool/description-lint.js

@@ -0,0 +1,90 @@
+/**
+ * ── Tool description lint (Phase 5) ──────────────────────────────────────
+ * LLM tool-selection accuracy depends on description quality: a bad or vague
+ * description ("Do stuff") makes the model pick the wrong tool or skip it.
+ * This module flags the common "smells" in tool descriptions so authors and
+ * CI can catch them early, mirroring API-doc review practices.
+ */
+/** Curated imperative verbs a tool description should start with. */
+const ACTION_VERBS = new Set([
+    "abort", "accept", "add", "analyze", "apply", "ask", "attach", "authenticate", "authorize",
+    "build", "calculate", "cancel", "check", "clear", "close", "commit", "compile", "convert",
+    "copy", "count", "create", "decode", "delete", "deploy", "describe", "detect", "diff",
+    "download", "edit", "encode", "execute", "explain", "export", "fetch", "find", "fix",
+    "format", "generate", "get", "initialize", "install", "invoke", "join", "launch", "list",
+    "load", "login", "manage", "merge", "monitor", "move", "open", "optimize", "parse",
+    "patch", "plan", "preview", "publish", "push", "query", "read", "rebuild", "refactor",
+    "register", "reload", "remove", "rename", "replace", "resolve", "restart", "restore",
+    "review", "rollback", "run", "save", "scan", "schedule", "search", "select", "send",
+    "set", "show", "simulate", "sort", "spawn", "stage", "start", "stop", "subscribe",
+    "summarize", "sync", "test", "trace", "track", "translate", "trigger", "undo", "update",
+    "upload", "use", "validate", "verify", "view", "wait", "write", "zoom",
+]);
+/** Leading adverbs that should be skipped when checking the first verb. */
+const LEADING_ADVERBS = new Set([
+    "recursively", "automatically", "quickly", "quietly", "silently", "lazily", "eagerly",
+    "simply", "always", "never", "only", "just", "also", "finally", "first", "then", "once",
+]);
+const MIN_DESCRIPTION_LENGTH = 12;
+const MAX_DESCRIPTION_LENGTH = 220;
+const MIN_WORDS = 4;
+const PLACEHOLDER_RE = /\b(todo|tbd|fixme|placeholder|lorem|coming soon)\b|\byour (tool|plugin)\b|\betc\.?\.?\s*$/i;
+function firstSignificantWord(description) {
+    const words = description.split(/\s+/);
+    for (const word of words) {
+        const normalized = word.toLowerCase().replace(/[^a-z]/g, "");
+        if (!normalized)
+            continue;
+        if (LEADING_ADVERBS.has(normalized))
+            continue;
+        return normalized;
+    }
+    return undefined;
+}
+/** Lint a single tool description. Returns the report (empty `issues` = clean). */
+export function lintToolDescription(tool, description) {
+    const issues = [];
+    const trimmed = description.trim();
+    if (!trimmed) {
+        return { tool, description: trimmed, issues: [{ code: "empty", message: "Tool description is empty — the model cannot decide when to use this tool." }] };
+    }
+    if (trimmed.length < MIN_DESCRIPTION_LENGTH) {
+        issues.push({
+            code: "too-short",
+            message: `Description is only ${trimmed.length} chars (min ${MIN_DESCRIPTION_LENGTH}) — too little signal for tool selection.`,
+        });
+    }
+    if (trimmed.length > MAX_DESCRIPTION_LENGTH) {
+        issues.push({
+            code: "too-long",
+            message: `Description is ${trimmed.length} chars (max ${MAX_DESCRIPTION_LENGTH}) — wasteful for the context window; keep the first sentence scannable.`,
+        });
+    }
+    const verb = firstSignificantWord(trimmed);
+    if (!verb || !ACTION_VERBS.has(verb)) {
+        issues.push({
+            code: "no-verb",
+            message: `Description should start with an imperative verb (e.g. "Fetch", "Create", "Search") but starts with "${verb ?? "nothing"}".`,
+        });
+    }
+    if (trimmed.split(/\s+/).length < MIN_WORDS) {
+        issues.push({
+            code: "vague",
+            message: `Description is too vague (${trimmed.split(/\s+/).length} words) — state what it does and on what input.`,
+        });
+    }
+    if (PLACEHOLDER_RE.test(trimmed)) {
+        issues.push({
+            code: "placeholder",
+            message: "Description contains placeholder/TODO text — replace with a real description.",
+        });
+    }
+    return { tool, description: trimmed, issues };
+}
+/** Lint a list of tool definitions, returning only the ones with issues. */
+export function lintToolDefinitions(definitions) {
+    return definitions
+        .map((d) => lintToolDescription(d.id, d.description))
+        .filter((report) => report.issues.length > 0);
+}
+//# sourceMappingURL=description-lint.js.map

package/dist/tool/description-lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-lint.js","sourceRoot":"","sources":["../../src/tool/description-lint.ts"],"names":[],"mappings":"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"}

package/dist/tool/diff.d.ts

@@ -0,0 +1,7 @@
+export interface UnifiedDiff {
+    readonly diff: string;
+    readonly additions: number;
+    readonly removals: number;
+}
+export declare function generateDiff(filePath: string, oldContent: string, newContent: string): UnifiedDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/tool/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/tool/diff.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,WAAW,CA6Bb"}

package/dist/tool/diff.js

@@ -0,0 +1,26 @@
+export function generateDiff(filePath, oldContent, newContent) {
+    const oldLines = oldContent.split("\n");
+    const newLines = newContent.split("\n");
+    const maxLen = Math.max(oldLines.length, newLines.length);
+    const result = [];
+    let additions = 0;
+    let removals = 0;
+    for (let i = 0; i < maxLen; i++) {
+        const oldLine = i < oldLines.length ? oldLines[i] : "";
+        const newLine = i < newLines.length ? newLines[i] : "";
+        if (oldLine !== newLine) {
+            if (oldLines[i] !== undefined) {
+                result.push(`-${i + 1}: ${oldLine}`);
+                removals++;
+            }
+            if (newLines[i] !== undefined) {
+                result.push(`+${i + 1}: ${newLine}`);
+                additions++;
+            }
+        }
+    }
+    result.unshift(`--- a/${filePath}`);
+    result.unshift(`+++ b/${filePath}`);
+    return { diff: result.join("\n"), additions, removals };
+}
+//# sourceMappingURL=diff.js.map

package/dist/tool/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/tool/diff.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,UAAkB,EAClB,UAAkB;IAElB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEvD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;gBACrC,QAAQ,EAAE,CAAC;YACb,CAAC;YACD,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;gBACrC,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC1D,CAAC"}

package/dist/tool/domain.d.ts

@@ -0,0 +1,39 @@
+import type { ToolDefinition } from "./definitions.js";
+import type { ToolPermissionRule } from "./registry.js";
+/**
+ * ── Domain manifests (Phase 2) ────────────────────────────────────────────
+ * A domain is a named, swappable set of tools (e.g. "coding"). The agent core
+ * treats domains as opaque: it only needs each tool's id (for membership) and
+ * the set of domains an agent is allowed to use. This is the seam that lets
+ * the same core power coding, research, data, devops — differing only by which
+ * domains are mounted and which permission rules apply.
+ */
+/** A named group of tools exposed as a pluggable capability. */
+export interface DomainManifest {
+    /** Domain id used in agent config `domains: ["coding"]`. */
+    readonly id: string;
+    /** Tools belonging to this domain. Only `id`/`name` drives membership. */
+    readonly tools: readonly ToolDefinition[];
+    /** Optional domain-level system prompt (merged into the agent context). */
+    readonly systemPrompt?: string;
+    /** Domain-level permission defaults (allow/deny/ask) applied to its tools. */
+    readonly permissionDefaults?: readonly ToolPermissionRule[];
+}
+/** Summary of a domain for UI/API consumption. */
+export interface DomainSummary {
+    readonly id: string;
+    readonly toolCount: number;
+    readonly toolIds: readonly string[];
+    readonly hasSystemPrompt: boolean;
+}
+/**
+ * Group the coding toolset (file/shell/search/web/image/git/lsp) under domain
+ * "coding". Pass the tool definitions the composition root has already built.
+ */
+export declare function createCodingDomain(tools: readonly ToolDefinition[]): DomainManifest;
+/**
+ * Build a domain summary map from a list of domain manifests.
+ * Useful for API responses and UI rendering.
+ */
+export declare function summarizeDomains(domains: readonly DomainManifest[]): DomainSummary[];
+//# sourceMappingURL=domain.d.ts.map

package/dist/tool/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/tool/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;GAOG;AAEH,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC7D;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,CAEnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,EAAE,CAOpF"}

package/dist/tool/domain.js

@@ -0,0 +1,20 @@
+/**
+ * Group the coding toolset (file/shell/search/web/image/git/lsp) under domain
+ * "coding". Pass the tool definitions the composition root has already built.
+ */
+export function createCodingDomain(tools) {
+    return { id: "coding", tools };
+}
+/**
+ * Build a domain summary map from a list of domain manifests.
+ * Useful for API responses and UI rendering.
+ */
+export function summarizeDomains(domains) {
+    return domains.map((d) => ({
+        id: d.id,
+        toolCount: d.tools.length,
+        toolIds: d.tools.map((t) => t.id),
+        hasSystemPrompt: !!d.systemPrompt,
+    }));
+}
+//# sourceMappingURL=domain.js.map

package/dist/tool/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/tool/domain.ts"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAkC;IACjE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tool/file-history.d.ts

@@ -0,0 +1,43 @@
+export interface FileVersion {
+    readonly filePath: string;
+    readonly sessionId: string;
+    readonly originalContent: string;
+    readonly newContent: string;
+    readonly timestamp: number;
+    readonly toolName: string;
+}
+export interface UndoEntry {
+    readonly filePath: string;
+    readonly originalContent: string;
+    readonly newContent: string;
+    readonly toolName: string;
+    readonly timestamp: number;
+    readonly versionId: number;
+}
+export interface FileHistory {
+    recordVersion(version: Omit<FileVersion, "timestamp"> & {
+        timestamp?: number;
+    }): Promise<void>;
+    listVersions(filePath: string): Promise<readonly FileVersion[]>;
+    getLatestVersion(filePath: string): Promise<FileVersion | null>;
+    rollbackTo(filePath: string, targetVersion: number): Promise<string>;
+    getAllChanges(): Promise<readonly FileVersion[]>;
+    undo(): Promise<UndoEntry | null>;
+    redo(): Promise<UndoEntry | null>;
+}
+export declare class InMemoryFileHistory implements FileHistory {
+    private versions;
+    private undoStack;
+    private redoStack;
+    private versionCounter;
+    recordVersion(version: Omit<FileVersion, "timestamp"> & {
+        timestamp?: number;
+    }): Promise<void>;
+    listVersions(filePath: string): Promise<readonly FileVersion[]>;
+    getLatestVersion(filePath: string): Promise<FileVersion | null>;
+    rollbackTo(filePath: string, versionIndex: number): Promise<string>;
+    getAllChanges(): Promise<readonly FileVersion[]>;
+    undo(): Promise<UndoEntry | null>;
+    redo(): Promise<UndoEntry | null>;
+}
+//# sourceMappingURL=file-history.d.ts.map

package/dist/tool/file-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-history.d.ts","sourceRoot":"","sources":["../../src/tool/file-history.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAChE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,aAAa,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACnC;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,cAAc,CAAK;IAErB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAI/D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnE,aAAa,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAIhD,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOjC,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAMxC"}

package/dist/tool/file-history.js

@@ -0,0 +1,55 @@
+export class InMemoryFileHistory {
+    versions = [];
+    undoStack = [];
+    redoStack = [];
+    versionCounter = 0;
+    async recordVersion(version) {
+        const entry = {
+            ...version,
+            timestamp: version.timestamp ?? Date.now(),
+        };
+        entry;
+        this.versions.push(entry);
+        this.undoStack.push({
+            filePath: entry.filePath,
+            originalContent: entry.originalContent,
+            newContent: entry.newContent,
+            toolName: entry.toolName,
+            timestamp: entry.timestamp,
+            versionId: this.versionCounter++,
+        });
+        this.redoStack = [];
+    }
+    async listVersions(filePath) {
+        return this.versions.filter((v) => v.filePath === filePath);
+    }
+    async getLatestVersion(filePath) {
+        const matches = this.versions.filter((v) => v.filePath === filePath);
+        return matches.length > 0 ? matches[matches.length - 1] : null;
+    }
+    async rollbackTo(filePath, versionIndex) {
+        const matches = this.versions.filter((v) => v.filePath === filePath);
+        if (versionIndex < 0 || versionIndex >= matches.length) {
+            throw new Error(`Version index ${versionIndex} out of range (0-${matches.length - 1})`);
+        }
+        return matches[versionIndex].originalContent;
+    }
+    async getAllChanges() {
+        return [...this.versions];
+    }
+    async undo() {
+        const entry = this.undoStack.pop();
+        if (!entry)
+            return null;
+        this.redoStack.push(entry);
+        return entry;
+    }
+    async redo() {
+        const entry = this.redoStack.pop();
+        if (!entry)
+            return null;
+        this.undoStack.push(entry);
+        return entry;
+    }
+}
+//# sourceMappingURL=file-history.js.map

package/dist/tool/file-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-history.js","sourceRoot":"","sources":["../../src/tool/file-history.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,mBAAmB;IACtB,QAAQ,GAAkB,EAAE,CAAC;IAC7B,SAAS,GAAgB,EAAE,CAAC;IAC5B,SAAS,GAAgB,EAAE,CAAC;IAC5B,cAAc,GAAG,CAAC,CAAC;IAE3B,KAAK,CAAC,aAAa,CAAC,OAAgE;QAClF,MAAM,KAAK,GAAgB;YACzB,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SAC5B,CAAC;QACjB,KAA2B,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE;SACjC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,YAAoB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrE,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,iBAAiB,YAAY,oBAAoB,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,OAAO,CAAC,YAAY,CAAE,CAAC,eAAe,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/tool/file-tools.d.ts

@@ -0,0 +1,51 @@
+import { FileReadTracker } from "./read-tracker.js";
+import { generateDiff } from "./diff.js";
+type RootGetter = string | (() => string);
+export declare function createReadFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean, maxFileSize?: number): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    stripTrailingNewline?: boolean;
+}, string>;
+export declare function createWriteFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    content: string;
+}, {
+    written: string;
+    bytes: number;
+    diff: ReturnType<typeof generateDiff>["diff"];
+    additions: number;
+    removals: number;
+}>;
+export declare function createEditFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    oldString?: string;
+    newString?: string;
+    edits?: readonly {
+        oldString: string;
+        newString: string;
+    }[];
+}, {
+    edited: string;
+    diff: string;
+    hunkCount?: number;
+    additions: number;
+    removals: number;
+}>;
+export declare function createApplyPatchTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    patch: string;
+}, {
+    patched: string;
+    blocks: number;
+    diff: string;
+    additions: number;
+    removals: number;
+}>;
+export declare function createListDirectoryTool(workspaceRoot: RootGetter, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    dirPath: string;
+}, {
+    name: string;
+    type: string;
+    path: string;
+}[]>;
+export {};
+//# sourceMappingURL=file-tools.d.ts.map

package/dist/tool/file-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tools.d.ts","sourceRoot":"","sources":["../../src/tool/file-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkFzC,KAAK,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAiD1C,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM;cAC1G,MAAM;2BAAyB,OAAO;WAqBrE;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACrF,MAAM;aAAW,MAAM;;aAC1C,MAAM;WAAS,MAAM;UACxB,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC;eAClC,MAAM;cAAY,MAAM;GA4BtC;AAgPD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACpF,MAAM;gBAAc,MAAM;gBAAc,MAAM;YAAU,SAAS;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;;YAC/H,MAAM;UAAQ,MAAM;gBAChB,MAAM;eAAa,MAAM;cAAY,MAAM;GAuC1D;AAeD,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACtF,MAAM;WAAS,MAAM;;aACxC,MAAM;YAAU,MAAM;UAAQ,MAAM;eAAa,MAAM;cAAY,MAAM;GAsDrF;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,OAAO;aAC/D,MAAM;;UAAY,MAAM;UAAQ,MAAM;UAAQ,MAAM;KAqBlF"}