@galaxy-stack/ai-coder-core 0.3.0-alpha.1 → 0.3.0-alpha.8

package/dist/adapters/node/provider/ollama-research-port.js

@@ -0,0 +1,346 @@
+import { createHash } from "node:crypto";
+import { isIP } from "node:net";
+import { portFailure, portSuccess, } from "../../../ports/index.js";
+export const OLLAMA_RESEARCH_LIMITS = Object.freeze({
+    defaultFetchBytes: 12_000,
+    defaultSearchResults: 3,
+    maxFetchBytes: 65_536,
+    maxQueryBytes: 2_048,
+    maxResponseBytes: 1_048_576,
+    maxSearchResults: 10,
+    maxSnippetBytes: 2_048,
+    maxTitleBytes: 512,
+    maxUrlBytes: 4_096,
+    timeoutMs: 30_000,
+});
+class ResearchFailure extends Error {
+    code;
+    retryable;
+    status;
+    constructor(code, message, retryable = false, status) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.status = status;
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function valueType(value) {
+    return value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
+}
+function schemaDiagnostic(payload, fields) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(payload) ?? String(payload);
+    }
+    catch {
+        serialized = "<unserializable>";
+    }
+    const digest = createHash("sha256").update(serialized, "utf8").digest("hex");
+    const fieldTypes = fields.map((field) => (`${field}=${isObject(payload) && field in payload ? valueType(payload[field]) : "missing"}`));
+    return `payloadSha256=${digest}; root=${valueType(payload)}; ${fieldTypes.join("; ")}`;
+}
+function failure(error) {
+    const known = error instanceof ResearchFailure ? error : null;
+    return portFailure({
+        code: known?.code ?? "PROVIDER_ERROR",
+        message: known?.message ?? "Ollama research transport failed. Provider error details are withheld to protect credentials.",
+        retryable: known?.retryable ?? true,
+        ...(known?.status === undefined ? {} : { details: { status: known.status } }),
+    });
+}
+function byteLength(value) {
+    return Buffer.byteLength(value, "utf8");
+}
+function boundedText(value, maxBytes) {
+    const bytes = Buffer.from(value, "utf8");
+    if (bytes.byteLength <= maxBytes)
+        return { text: value, truncated: false };
+    let end = maxBytes;
+    // A UTF-8 cut may land in a continuation byte. Exclude the whole final code point.
+    while (end > 0 && (bytes[end] & 0xc0) === 0x80)
+        end -= 1;
+    return { text: bytes.subarray(0, end).toString("utf8"), truncated: true };
+}
+function isPublicIpv4(address) {
+    const [first = 0, second = 0, third = 0] = address.split(".").map(Number);
+    return !(first === 0 || first === 10 || first === 127 || first >= 224
+        || (first === 100 && second >= 64 && second <= 127)
+        || (first === 169 && second === 254)
+        || (first === 172 && second >= 16 && second <= 31)
+        || (first === 192 && second === 168)
+        || (first === 192 && second === 0 && (third === 0 || third === 2))
+        || (first === 198 && (second === 18 || second === 19))
+        || (first === 198 && second === 51 && third === 100)
+        || (first === 203 && second === 0 && third === 113));
+}
+function isPublicIpv6(address) {
+    // WHATWG URL canonicalizes embedded IPv4 to hexadecimal groups before this call.
+    const sections = address.split("::");
+    const head = (sections[0] ?? "").split(":").filter(Boolean).map((part) => Number.parseInt(part, 16));
+    const tail = (sections[1] ?? "").split(":").filter(Boolean).map((part) => Number.parseInt(part, 16));
+    const groups = sections.length === 1 ? head : [...head, ...Array(8 - head.length - tail.length).fill(0), ...tail];
+    const bytes = groups.flatMap((group) => [group >> 8, group & 0xff]);
+    if (bytes.slice(0, 10).every((byte) => byte === 0) && bytes[10] === 0xff && bytes[11] === 0xff) {
+        return isPublicIpv4(bytes.slice(12).join("."));
+    }
+    // Accept ordinary global unicast; exclude local, multicast, translation/tunnel,
+    // unspecified and documentation/special-use ranges conservatively.
+    if ((bytes[0] & 0xe0) !== 0x20)
+        return false;
+    if (groups[0] === 0x2002)
+        return false; // 6to4 can encode non-public IPv4.
+    if (groups[0] === 0x2001 && (groups[1] < 0x0200 || groups[1] === 0x0db8))
+        return false;
+    if (groups[0] === 0x3fff && groups[1] < 0x1000)
+        return false;
+    return true;
+}
+function publicUrl(value) {
+    if (byteLength(value) > OLLAMA_RESEARCH_LIMITS.maxUrlBytes || /[\u0000-\u0020\u007f\\]/u.test(value))
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return null;
+    }
+    if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password)
+        return null;
+    const hostname = parsed.hostname.replace(/^\[|\]$/g, "").replace(/\.$/, "").toLowerCase();
+    const version = isIP(hostname);
+    if (version === 4)
+        return isPublicIpv4(hostname) ? parsed : null;
+    if (version === 6)
+        return isPublicIpv6(hostname) ? parsed : null;
+    if (!hostname.includes(".") || !hostname.split(".").every((part) => /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u.test(part)))
+        return null;
+    if (["localhost", "local", "internal", "home", "lan", "test", "invalid", "example", "arpa"]
+        .some((suffix) => hostname === suffix || hostname.endsWith(`.${suffix}`)))
+        return null;
+    return parsed;
+}
+function assertActive(context) {
+    if (context.signal.aborted)
+        throw new ResearchFailure("CANCELED", "Ollama research request was canceled.");
+    if (!Number.isFinite(context.deadline) || Date.now() >= context.deadline) {
+        throw new ResearchFailure("DEADLINE_EXCEEDED", "Ollama research deadline elapsed.", true);
+    }
+}
+async function abortable(promise, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason);
+        if (signal.aborted) {
+            // The supplied promise may already be in flight; retain its rejection handler.
+            void promise.catch(() => { });
+            reject(signal.reason);
+            return;
+        }
+        signal.addEventListener("abort", abort, { once: true });
+        promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
+    });
+}
+/** Cloud research only: no local URL is fetched, and external content never becomes trusted instructions. */
+export class OllamaResearchPort {
+    apiKey;
+    fetchImpl;
+    timeoutMs;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey?.trim() ?? "";
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? OLLAMA_RESEARCH_LIMITS.timeoutMs;
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs < 1 || this.timeoutMs > 2_147_483_647) {
+            throw new Error("Ollama research timeoutMs must be a positive 32-bit integer.");
+        }
+    }
+    hasCredential(value) {
+        return this.apiKey.length > 0 && (value.includes(this.apiKey)
+            || value.toLowerCase().includes(encodeURIComponent(this.apiKey).toLowerCase())
+            || (() => { try {
+                return decodeURIComponent(value).includes(this.apiKey);
+            }
+            catch {
+                return false;
+            } })());
+    }
+    redact(value) {
+        let sanitized = value;
+        if (this.apiKey) {
+            sanitized = sanitized.replaceAll(this.apiKey, "[REDACTED]");
+            const encodedKey = encodeURIComponent(this.apiKey).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            sanitized = sanitized.replace(new RegExp(encodedKey, "gi"), "[REDACTED]");
+        }
+        return sanitized.replace(/Bearer\s+[^\s"'<>]+/giu, "Bearer [REDACTED]");
+    }
+    async request(route, body, context) {
+        assertActive(context);
+        if (!this.apiKey)
+            throw new ResearchFailure("PRECONDITION_FAILED", "Ollama web research requires an Ollama API key.");
+        if (/[\u0000-\u0020\u007f]/u.test(this.apiKey))
+            throw new ResearchFailure("INVALID_INPUT", "Ollama research API key contains invalid characters.");
+        const controller = new AbortController();
+        const cancel = () => controller.abort(new ResearchFailure("CANCELED", "Ollama research request was canceled."));
+        context.signal.addEventListener("abort", cancel, { once: true });
+        const timer = setTimeout(() => {
+            controller.abort(new ResearchFailure("DEADLINE_EXCEEDED", "Ollama research request timed out.", true));
+        }, Math.min(this.timeoutMs, context.deadline - Date.now()));
+        let reader;
+        let response;
+        try {
+            const responsePromise = this.fetchImpl(`https://ollama.com/api/${route}`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` },
+                body: JSON.stringify(body),
+                redirect: "manual",
+                signal: controller.signal,
+            });
+            // Also closes a late response from an injected transport that ignores abort.
+            void responsePromise.then((late) => {
+                if (controller.signal.aborted)
+                    void late.body?.cancel().catch(() => { });
+            }, () => { });
+            response = await abortable(responsePromise, controller.signal);
+            if (response.redirected || (response.status >= 300 && response.status < 400)) {
+                throw new ResearchFailure("PERMISSION_DENIED", "Ollama research redirects are disabled to protect the API key.");
+            }
+            if (!response.ok) {
+                const status = response.status;
+                if (status === 401 || status === 403)
+                    throw new ResearchFailure("PERMISSION_DENIED", "Ollama web research authentication or account permission was rejected.", false, status);
+                if (status === 408 || status === 504)
+                    throw new ResearchFailure("DEADLINE_EXCEEDED", "Ollama web research provider timed out.", true, status);
+                if (status === 429)
+                    throw new ResearchFailure("UNAVAILABLE", "Ollama web research rate limit reached; retry later.", true, status);
+                if (status >= 500)
+                    throw new ResearchFailure("UNAVAILABLE", "Ollama web research service is temporarily unavailable.", true, status);
+                throw new ResearchFailure("PROVIDER_ERROR", "Ollama web research request was rejected by the provider.", false, status);
+            }
+            const declaredLength = Number(response.headers.get("content-length") ?? "0");
+            if (declaredLength > OLLAMA_RESEARCH_LIMITS.maxResponseBytes) {
+                throw new ResearchFailure("LIMIT_EXCEEDED", "Ollama web research response exceeds the byte limit.");
+            }
+            if (!response.body)
+                throw new ResearchFailure("PROVIDER_ERROR", "Ollama web research returned an empty response body.");
+            reader = response.body.getReader();
+            const chunks = [];
+            let size = 0;
+            while (true) {
+                const item = await abortable(reader.read(), controller.signal);
+                if (item.done)
+                    break;
+                size += item.value.byteLength;
+                if (size > OLLAMA_RESEARCH_LIMITS.maxResponseBytes) {
+                    throw new ResearchFailure("LIMIT_EXCEEDED", "Ollama web research response exceeds the byte limit.");
+                }
+                chunks.push(item.value);
+            }
+            assertActive(context);
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            try {
+                return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks, size)));
+            }
+            catch {
+                throw new ResearchFailure("PROVIDER_ERROR", "Ollama web research response is not valid UTF-8 JSON.");
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            context.signal.removeEventListener("abort", cancel);
+            if (reader) {
+                // Never await cancel: a malicious/stalled stream may never settle it.
+                void reader.cancel().catch(() => { });
+                reader.releaseLock();
+            }
+            else {
+                void response?.body?.cancel().catch(() => { });
+            }
+        }
+    }
+    async search(input, context) {
+        try {
+            assertActive(context);
+            if (input.cursor !== undefined)
+                throw new ResearchFailure("UNSUPPORTED", "Ollama web search does not support cursors. Refine the query instead of retrying a page.");
+            const query = typeof input.query === "string" ? input.query.trim() : "";
+            if (!query || byteLength(query) > OLLAMA_RESEARCH_LIMITS.maxQueryBytes || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(query)) {
+                throw new ResearchFailure("INVALID_INPUT", "Search query must contain 1–2048 UTF-8 bytes of readable text.");
+            }
+            if (this.hasCredential(query))
+                throw new ResearchFailure("INVALID_INPUT", "Search query must not contain the research API key.");
+            const limit = input.limit ?? OLLAMA_RESEARCH_LIMITS.defaultSearchResults;
+            if (!Number.isSafeInteger(limit) || limit < 1 || limit > OLLAMA_RESEARCH_LIMITS.maxSearchResults) {
+                throw new ResearchFailure("INVALID_INPUT", "Ollama web search limit must be an integer between 1 and 10.");
+            }
+            const payload = await this.request("web_search", { query, max_results: limit }, context);
+            if (!isObject(payload) || !Array.isArray(payload.results)) {
+                throw new ResearchFailure("PROVIDER_ERROR", `Ollama web search response is missing its results array (${schemaDiagnostic(payload, ["results"])}).`);
+            }
+            const results = [];
+            let truncated = payload.results.length > limit;
+            for (const candidate of payload.results) {
+                if (!isObject(candidate) || typeof candidate.title !== "string" || typeof candidate.content !== "string" || typeof candidate.url !== "string") {
+                    throw new ResearchFailure("PROVIDER_ERROR", `Ollama web search returned an invalid result schema (${schemaDiagnostic(candidate, ["title", "content", "url"])}).`);
+                }
+                const parsed = publicUrl(candidate.url);
+                if (!parsed || this.hasCredential(candidate.url) || this.hasCredential(parsed.href)) {
+                    truncated = true;
+                    continue;
+                }
+                if (results.length >= limit)
+                    continue;
+                const title = boundedText(this.redact(candidate.title).trim() || parsed.hostname, OLLAMA_RESEARCH_LIMITS.maxTitleBytes);
+                const snippet = boundedText(this.redact(candidate.content), OLLAMA_RESEARCH_LIMITS.maxSnippetBytes);
+                truncated ||= title.truncated || snippet.truncated;
+                results.push(Object.freeze({ provider: "ollama", title: title.text, url: parsed.href, snippet: snippet.text }));
+            }
+            return portSuccess(Object.freeze({
+                pagination: Object.freeze({ hasMore: truncated }),
+                results: Object.freeze(results),
+                trust: "untrusted_data",
+            }));
+        }
+        catch (error) {
+            return failure(error);
+        }
+    }
+    async extract(input, context) {
+        try {
+            assertActive(context);
+            if (input.cursor !== undefined)
+                throw new ResearchFailure("UNSUPPORTED", "Ollama web fetch does not support cursors. Use a more specific source URL instead of retrying a page.");
+            if (input.extractDepth !== undefined && !["basic", "advanced"].includes(input.extractDepth))
+                throw new ResearchFailure("INVALID_INPUT", "Unsupported research extraction depth.");
+            const parsed = typeof input.url === "string" ? publicUrl(input.url) : null;
+            if (!parsed || this.hasCredential(input.url) || this.hasCredential(parsed.href)) {
+                throw new ResearchFailure("INVALID_INPUT", "Web fetch requires a public HTTP(S) URL without credentials or private/local addresses.");
+            }
+            const maxBytes = input.maxBytes ?? OLLAMA_RESEARCH_LIMITS.defaultFetchBytes;
+            if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > OLLAMA_RESEARCH_LIMITS.maxFetchBytes) {
+                throw new ResearchFailure("INVALID_INPUT", "Ollama web fetch maxBytes must be an integer between 1 and 65536.");
+            }
+            const payload = await this.request("web_fetch", { url: parsed.href }, context);
+            if (!isObject(payload) || typeof payload.title !== "string" || typeof payload.content !== "string" || !Array.isArray(payload.links) || !payload.links.every((link) => typeof link === "string")) {
+                throw new ResearchFailure("PROVIDER_ERROR", `Ollama web fetch returned an invalid page schema (${schemaDiagnostic(payload, ["title", "content", "links"])}).`);
+            }
+            if (!payload.content.trim())
+                throw new ResearchFailure("NOT_FOUND", "Ollama web fetch returned no readable page content.");
+            const bounded = boundedText(this.redact(payload.content), maxBytes);
+            return portSuccess(Object.freeze({
+                content: bounded.text,
+                contentSha256: createHash("sha256").update(bounded.text, "utf8").digest("hex"),
+                pagination: Object.freeze({ hasMore: bounded.truncated }),
+                provider: "ollama",
+                trust: "untrusted_data",
+                url: parsed.href,
+            }));
+        }
+        catch (error) {
+            return failure(error);
+        }
+    }
+}
+//# sourceMappingURL=ollama-research-port.js.map

package/dist/adapters/node/provider/ollama-research-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-research-port.js","sourceRoot":"","sources":["../../../../src/adapters/node/provider/ollama-research-port.ts"],"names":[],"mappings":"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"}

package/dist/adapters/node/skills/directory-skills.d.ts

@@ -0,0 +1,12 @@
+import type { AgentSkillsPort, SkillDescriptor } from "../../../agent/index.js";
+export declare class DirectorySkills implements AgentSkillsPort {
+    private readonly roots;
+    private readonly entries;
+    constructor(roots: Readonly<Record<string, string>>);
+    list(): Promise<readonly SkillDescriptor[]>;
+    load(id: string): Promise<SkillDescriptor & {
+        readonly content: string;
+    }>;
+    readResource(id: string, path: string): Promise<string>;
+}
+//# sourceMappingURL=directory-skills.d.ts.map

package/dist/adapters/node/skills/directory-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-skills.d.ts","sourceRoot":"","sources":["../../../../src/adapters/node/skills/directory-skills.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAsBhF,qBAAa,eAAgB,YAAW,eAAe;IAEzC,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqD;gBAChD,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAmB3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ9D"}

package/dist/adapters/node/skills/directory-skills.js

@@ -0,0 +1,90 @@
+import { open, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { createHash } from "node:crypto";
+import { parse } from "yaml";
+const MAX_BYTES = 65536;
+function inside(root, path) { const rel = relative(root, path); return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel); }
+async function boundedFile(path) {
+    const handle = await open(path, "r");
+    try {
+        const stat = await handle.stat();
+        if (!stat.isFile() || stat.size > MAX_BYTES)
+            throw new Error("Skill resource must be a regular file up to 64 KiB.");
+        const buffer = Buffer.alloc(MAX_BYTES + 1);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        if (bytesRead > MAX_BYTES)
+            throw new Error("Skill resource exceeded its size limit.");
+        return buffer.subarray(0, bytesRead).toString("utf8");
+    }
+    finally {
+        await handle.close();
+    }
+}
+function describe(id, source, content) {
+    const front = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(content);
+    if (!front)
+        throw new Error(`Skill ${id} requires YAML frontmatter.`);
+    const metadata = parse(front[1], { maxAliasCount: 20 });
+    if (!metadata || typeof metadata !== "object" || !("name" in metadata) || !("description" in metadata) || typeof metadata.name !== "string" || typeof metadata.description !== "string" || !metadata.name.trim() || !metadata.description.trim() || metadata.description.length > 2048)
+        throw new Error(`Invalid skill metadata: ${id}`);
+    return { id, name: metadata.name, description: metadata.description, source, contentHash: createHash("sha256").update(content).digest("hex") };
+}
+export class DirectorySkills {
+    roots;
+    entries = new Map();
+    constructor(roots) {
+        this.roots = roots;
+    }
+    async list() {
+        const result = [];
+        this.entries.clear();
+        for (const [namespace, path] of Object.entries(this.roots)) {
+            let root;
+            try {
+                root = await realpath(path);
+            }
+            catch (e) {
+                if (e.code === "ENOENT")
+                    continue;
+                throw e;
+            }
+            for (const entry of (await readdir(root, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+                if (!entry.isDirectory())
+                    continue;
+                if (result.length >= 256)
+                    throw new Error("Skill catalog exceeds 256 entries; narrow the configured roots.");
+                const skillRoot = await realpath(join(root, entry.name));
+                const source = await realpath(join(skillRoot, "SKILL.md")).catch(e => { if (e.code === "ENOENT")
+                    return null; throw e; });
+                if (!source)
+                    continue;
+                if (!inside(root, skillRoot) || !inside(skillRoot, source))
+                    throw new Error("Skill path escapes its catalog.");
+                const descriptor = describe(`${namespace}/${entry.name}`, source, await boundedFile(source));
+                this.entries.set(descriptor.id, { root: skillRoot, hash: descriptor.contentHash });
+                result.push(descriptor);
+            }
+        }
+        return result;
+    }
+    async load(id) {
+        const content = await this.readResource(id, "SKILL.md");
+        const entry = this.entries.get(id);
+        const descriptor = describe(id, join(entry.root, "SKILL.md"), content);
+        if (entry.hash !== descriptor.contentHash)
+            throw new Error("Skill changed after discovery; refresh the catalog.");
+        return { ...descriptor, content };
+    }
+    async readResource(id, path) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            throw new Error("Unknown skill. Discover skills before loading.");
+        if (isAbsolute(path))
+            throw new Error("Skill resources must use relative paths.");
+        const target = await realpath(resolve(entry.root, path));
+        if (!inside(entry.root, target))
+            throw new Error("Skill resource escapes its directory.");
+        return boundedFile(target);
+    }
+}
+//# sourceMappingURL=directory-skills.js.map

package/dist/adapters/node/skills/directory-skills.js.map

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

package/dist/adapters/node/tools/tool-executor.d.ts

@@ -0,0 +1,91 @@
+import { type AiCoderApprovalProfile, type AiCoderRuntimeToolEffects, type AiCoderRuntimeToolExecutor, type AiCoderRuntimeToolResult, type ApprovalPort, type CodingToolCall, type CommandRunnerPort, type ModelCapabilities, type ResearchPort, type RunExecutionContext, type ToolExecutionContext, type WorkspacePort } from "../../../index.js";
+import { type NodeWorkspaceSnapshotOptions } from "../host/node-workspace-snapshot.js";
+export declare class ContractToolError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly suggestedAction?: string | undefined;
+    constructor(code: string, message: string, retryable?: boolean, suggestedAction?: string | undefined);
+}
+export interface ContractToolPort {
+    execute(id: string, args: Readonly<Record<string, unknown>>, context: RunExecutionContext): Promise<DispatchResult>;
+}
+export declare const LAB_AVAILABLE_TOOL_IDS: readonly ["catalog.search", "task.checkpoint", "workspace.list", "workspace.glob", "workspace.grep", "workspace.read", "workspace.edit", "workspace.write", "command.run", "project.detect", "project.validate", "git.exec"];
+export declare const LAB_GRANTED_PERMISSIONS: readonly ["core.storage", "fs.workspace", "process.execute"];
+export declare const LAB_RESEARCH_TOOL_IDS: readonly ["research.search", "research.fetch"];
+export declare const LAB_OPTIONAL_CONTRACT_TOOL_IDS: readonly ["research.fetch", "research.search", "command.session", "preview.manage", "perception.analyze", "artifact.create", "artifact.list", "artifact.read", "user.ask"];
+export declare const LAB_FULL_CONTRACT_TOOL_IDS: readonly ["catalog.search", "task.checkpoint", "workspace.list", "workspace.glob", "workspace.grep", "workspace.read", "workspace.edit", "workspace.write", "command.run", "project.detect", "project.validate", "git.exec", "research.fetch", "research.search", "command.session", "preview.manage", "perception.analyze", "artifact.create", "artifact.list", "artifact.read", "user.ask"];
+export declare const LAB_FULL_CONTRACT_PERMISSIONS: readonly ["core.storage", "fs.workspace", "process.execute", "core.artifacts", "network.outbound", "preview.local", "user.interaction"];
+type JsonObject = Readonly<Record<string, unknown>>;
+export interface LabTaskCheckpointState {
+    readonly decisions: readonly string[];
+    readonly goal: string;
+    readonly nextStep: string;
+    readonly progress: string;
+    readonly updatedAt: string;
+}
+export interface LabTaskCheckpointStore {
+    get(runId: string): LabTaskCheckpointState | undefined;
+    set(runId: string, checkpoint: LabTaskCheckpointState): unknown;
+}
+type DispatchResult = Readonly<{
+    effects?: AiCoderRuntimeToolEffects;
+    output: JsonObject;
+    summary: string;
+    trust: AiCoderRuntimeToolResult["trust"];
+}>;
+export interface NodeToolExecutorOptions {
+    readonly approval?: ApprovalPort;
+    readonly approvalProfile?: AiCoderApprovalProfile;
+    readonly approvalTimeoutMs?: number;
+    readonly capabilities: ModelCapabilities;
+    readonly command: CommandRunnerPort;
+    /** Enables deterministic contract doubles; this is not a production integration profile. */
+    readonly enableContractTools?: boolean;
+    readonly contractTools?: ContractToolPort;
+    readonly enableGit?: boolean;
+    /** Real public research adapter, available only when explicitly supplied by the host. */
+    readonly research?: ResearchPort;
+    /** Host-owned durable state used by task.checkpoint across executor recreation. */
+    readonly taskCheckpointStore?: LabTaskCheckpointStore;
+    /** Must match the host's outer workspace snapshot policy. */
+    readonly workspaceSnapshot?: NodeWorkspaceSnapshotOptions;
+    /** Alias for hosts that prefer an explicit named lab profile. */
+    readonly toolProfile?: "default" | "full_contract";
+    readonly workspace: WorkspacePort;
+}
+export declare class NodeToolExecutor implements AiCoderRuntimeToolExecutor {
+    private readonly options;
+    private readonly approvalPolicy;
+    private readonly contractTools;
+    private readonly contractToolsEnabled;
+    private readonly grantedPermissions;
+    private readonly idempotencyCache;
+    private readonly researchFetchCache;
+    private readonly researchSearchCache;
+    private readonly taskCheckpointStore;
+    private registry;
+    private mutationBaseline;
+    constructor(options: NodeToolExecutorOptions);
+    getToolSet(context: RunExecutionContext): Promise<Readonly<{
+        canonicalToolIds: Readonly<Record<string, string>>;
+        definitions: readonly Readonly<{
+            function: Readonly<{
+                description: string;
+                name: string;
+                parameters: Readonly<Record<string, unknown>>;
+            }>;
+            type: "function";
+        }>[];
+        effectCapabilities: Readonly<Record<string, readonly ("research" | "write" | "plan" | "approval" | "criterion_satisfy" | "criterion_waive" | "diff_review" | "inspect" | "state_version" | "validate")[]>>;
+        snapshotHash: string;
+    }>>;
+    restoreToolSet(input: Readonly<{
+        names: readonly string[];
+        snapshotHash: string;
+    }>, context: RunExecutionContext): Promise<void>;
+    execute(call: CodingToolCall, context: ToolExecutionContext): Promise<AiCoderRuntimeToolResult>;
+    private ensureRegistry;
+    private dispatch;
+}
+export {};
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/adapters/node/tools/tool-executor.d.ts.map

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