neoctl 0.1.0

package/dist/skills/smoke-skills.js

@@ -0,0 +1,60 @@
+import { InMemoryAppState } from "../app/app-state.js";
+import { ToolRegistry } from "../tools/registry.js";
+import { runToolUse } from "../tools/run-tool-use.js";
+import { createSkillTool, InMemorySkillCatalog } from "./skill-tool.js";
+async function main() {
+    const catalog = new InMemorySkillCatalog([
+        {
+            name: "review-plan",
+            description: "Review a plan before implementation.",
+            entrypoint: "Review the supplied plan for correctness and missing validation.",
+            execution: "inline",
+            allowedTools: ["echo"],
+            model: "gpt-5.5",
+            effort: "high",
+        },
+        {
+            name: "fork-docs",
+            description: "Long-running docs workflow.",
+            entrypoint: "Analyze docs independently.",
+            execution: "fork",
+        },
+    ]);
+    const tools = new ToolRegistry();
+    tools.register(createSkillTool(catalog));
+    const context = {
+        agentId: "main",
+        tools,
+        appState: new InMemoryAppState("main"),
+        emit: () => undefined,
+    };
+    const inline = await runToolUse({
+        id: "skill_inline",
+        name: "skill",
+        input: { skill: "/review-plan", args: "Plan A" },
+    }, context);
+    const fork = await runToolUse({
+        id: "skill_fork",
+        name: "skill",
+        input: { name: "fork-docs" },
+    }, context);
+    const missing = await runToolUse({
+        id: "skill_missing",
+        name: "skill",
+        input: { skill: "missing" },
+    }, context);
+    const inlineResult = inline.find((update) => update.message.blocks.some((block) => block.type === "tool_result"));
+    const injected = inline.some((update) => update.message.metadata?.skill === "review-plan");
+    const contextUpdated = inline.some((update) => update.context?.options?.mainLoopModel === "gpt-5.5");
+    const forkRejected = fork.some((update) => update.message.blocks.some((block) => block.type === "tool_result" && !block.ok));
+    const missingRejected = missing.some((update) => update.message.blocks.some((block) => block.type === "tool_result" && !block.ok));
+    const ok = Boolean(inlineResult && injected && contextUpdated && forkRejected && missingRejected);
+    console.log(JSON.stringify({ ok, injected, contextUpdated, forkRejected, missingRejected }, null, 2));
+    if (!ok)
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.stack ?? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=smoke-skills.js.map

package/dist/skills/smoke-skills.js.map

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

package/dist/tasks/task-store.d.ts

@@ -0,0 +1,43 @@
+import { type Message } from "../types/messages.js";
+import { type AgentToolResult, type LocalAgentTask, type LocalAgentTaskStatus } from "../agents/local-agent-task.js";
+export declare class TaskStore {
+    private readonly tasks;
+    private readonly agentNames;
+    private readonly waiters;
+    private readonly subscribers;
+    upsert(task: LocalAgentTask): void;
+    get(id: string): LocalAgentTask | undefined;
+    getByAgentId(agentId: string): LocalAgentTask | undefined;
+    list(): LocalAgentTask[];
+    activeCount(): number;
+    subscribe(listener: () => void): () => void;
+    registerName(name: string, agentId: string): void;
+    resolveAgentName(nameOrId: string): string | undefined;
+    appendMessage(taskId: string, message: Message): void;
+    queueMessage(agentNameOrId: string, text: string): {
+        ok: true;
+        task: LocalAgentTask;
+    } | {
+        ok: false;
+        error: string;
+    };
+    drainPendingMessages(taskId: string): Message[];
+    collectUnnotifiedCompletions(): LocalAgentTask[];
+    markRunning(taskId: string): void;
+    complete(taskId: string, result: AgentToolResult): void;
+    fail(taskId: string, error: string): void;
+    kill(taskId: string, reason?: string): void;
+    markNotified(taskId: string): void;
+    isTerminal(task: LocalAgentTask): boolean;
+    waitForTerminal(taskId: string, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<LocalAgentTask | undefined>;
+    private patch;
+    private patchTerminal;
+    private persistTerminalOutput;
+    private require;
+    private notify;
+}
+export declare function isTerminalStatus(status: LocalAgentTaskStatus): boolean;
+export declare const globalTaskStore: TaskStore;

package/dist/tasks/task-store.js

@@ -0,0 +1,150 @@
+import { createTextMessage } from "../types/messages.js";
+import { writeLocalAgentTaskOutput } from "../agents/local-agent-task.js";
+export class TaskStore {
+    tasks = new Map();
+    agentNames = new Map();
+    waiters = new Set();
+    subscribers = new Set();
+    upsert(task) {
+        task.updatedAt = new Date().toISOString();
+        this.tasks.set(task.id, task);
+        this.notify();
+    }
+    get(id) {
+        return this.tasks.get(id);
+    }
+    getByAgentId(agentId) {
+        return [...this.tasks.values()].find((task) => task.agentId === agentId);
+    }
+    list() {
+        return [...this.tasks.values()].sort((left, right) => left.createdAt.localeCompare(right.createdAt));
+    }
+    activeCount() {
+        return this.list().filter((task) => !this.isTerminal(task)).length;
+    }
+    subscribe(listener) {
+        this.subscribers.add(listener);
+        return () => this.subscribers.delete(listener);
+    }
+    registerName(name, agentId) {
+        this.agentNames.set(name, agentId);
+    }
+    resolveAgentName(nameOrId) {
+        return this.agentNames.get(nameOrId) ?? (this.getByAgentId(nameOrId) ? nameOrId : undefined);
+    }
+    appendMessage(taskId, message) {
+        const task = this.require(taskId);
+        task.messages.push(message);
+        this.upsert(task);
+    }
+    queueMessage(agentNameOrId, text) {
+        const agentId = this.resolveAgentName(agentNameOrId);
+        if (!agentId)
+            return { ok: false, error: `Unknown agent: ${agentNameOrId}` };
+        const task = this.getByAgentId(agentId);
+        if (!task)
+            return { ok: false, error: `No task found for agent: ${agentNameOrId}` };
+        task.pendingMessages.push(createTextMessage("user", text));
+        this.upsert(task);
+        return { ok: true, task };
+    }
+    drainPendingMessages(taskId) {
+        const task = this.get(taskId);
+        if (!task || task.pendingMessages.length === 0)
+            return [];
+        const drained = task.pendingMessages.splice(0);
+        this.upsert(task);
+        return drained;
+    }
+    collectUnnotifiedCompletions() {
+        return [...this.tasks.values()].filter((task) => this.isTerminal(task) && !task.notified);
+    }
+    markRunning(taskId) {
+        this.patch(taskId, { status: "running" });
+    }
+    complete(taskId, result) {
+        this.patchTerminal(taskId, { status: "completed", result, completedAt: new Date().toISOString() });
+    }
+    fail(taskId, error) {
+        this.patchTerminal(taskId, { status: "failed", error, completedAt: new Date().toISOString() });
+    }
+    kill(taskId, reason = "Task stopped") {
+        const task = this.require(taskId);
+        task.abortController?.abort(reason);
+        task.status = "killed";
+        task.error = reason;
+        task.completedAt = new Date().toISOString();
+        this.persistTerminalOutput(task);
+        this.upsert(task);
+    }
+    markNotified(taskId) {
+        this.patch(taskId, { notified: true });
+    }
+    isTerminal(task) {
+        return isTerminalStatus(task.status);
+    }
+    waitForTerminal(taskId, options = {}) {
+        const existing = this.get(taskId);
+        if (!existing)
+            return Promise.resolve(undefined);
+        if (this.isTerminal(existing))
+            return Promise.resolve(existing);
+        return new Promise((resolve) => {
+            const deadline = options.timeoutMs ? Date.now() + options.timeoutMs : undefined;
+            let timeout;
+            const done = (task) => {
+                if (timeout)
+                    clearTimeout(timeout);
+                this.waiters.delete(listener);
+                options.signal?.removeEventListener("abort", abort);
+                resolve(task);
+            };
+            const listener = () => {
+                const task = this.get(taskId);
+                if (!task || this.isTerminal(task))
+                    done(task);
+            };
+            const abort = () => done(this.get(taskId));
+            if (deadline)
+                timeout = setTimeout(() => done(this.get(taskId)), Math.max(0, deadline - Date.now()));
+            options.signal?.addEventListener("abort", abort, { once: true });
+            this.waiters.add(listener);
+        });
+    }
+    patch(taskId, fields) {
+        const task = this.require(taskId);
+        Object.assign(task, fields);
+        this.upsert(task);
+    }
+    patchTerminal(taskId, fields) {
+        const task = this.require(taskId);
+        Object.assign(task, fields);
+        this.persistTerminalOutput(task);
+        this.upsert(task);
+    }
+    persistTerminalOutput(task) {
+        try {
+            writeLocalAgentTaskOutput(task);
+        }
+        catch (error) {
+            task.error = task.error ?? `Failed to write output file: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }
+    require(taskId) {
+        const task = this.get(taskId);
+        if (!task)
+            throw new Error(`Unknown task: ${taskId}`);
+        return task;
+    }
+    notify() {
+        for (const waiter of [...this.waiters])
+            waiter();
+        for (const subscriber of [...this.subscribers])
+            subscriber();
+    }
+}
+export function isTerminalStatus(status) {
+    return status === "completed" || status === "failed" || status === "killed";
+}
+export const globalTaskStore = new TaskStore();
+//# sourceMappingURL=task-store.js.map

package/dist/tasks/task-store.js.map

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

package/dist/tasks/task-tools.d.ts

@@ -0,0 +1,31 @@
+import type { Tool, ToolResult } from "../tools/tool.js";
+import { type TaskStore } from "./task-store.js";
+export type TaskToolName = "TaskOutput" | "TaskList" | "TaskGet" | "TaskStop" | "SendMessage" | "TaskResume";
+export interface TaskOutputInput {
+    task_id: string;
+    block?: boolean;
+    timeout_ms?: number;
+}
+export interface TaskIdInput {
+    task_id: string;
+}
+export interface SendMessageInput {
+    target: string;
+    message: string;
+}
+export interface TaskResumeInput {
+    task_id: string;
+    directive?: string;
+}
+export type TaskResumeHandler = (taskId: string, directive?: string) => Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function createTaskTools(taskStore?: TaskStore, resumeHandler?: TaskResumeHandler): Tool<any>[];
+export declare function createTaskOutputTool(taskStore?: TaskStore): Tool<TaskOutputInput>;
+export declare function createTaskListTool(taskStore?: TaskStore): Tool<Record<string, never>>;
+export declare function createTaskGetTool(taskStore?: TaskStore): Tool<TaskIdInput>;
+export declare function createTaskStopTool(taskStore?: TaskStore): Tool<TaskIdInput>;
+export declare function createSendMessageTool(taskStore?: TaskStore): Tool<SendMessageInput>;
+export declare function createTaskResumeTool(taskStore?: TaskStore, resumeHandler?: TaskResumeHandler): Tool<TaskResumeInput>;
+export declare function asToolResult(output: unknown): ToolResult;

package/dist/tasks/task-tools.js

@@ -0,0 +1,232 @@
+import { globalTaskStore, isTerminalStatus } from "./task-store.js";
+export function createTaskTools(taskStore = globalTaskStore, resumeHandler) {
+    return [
+        createTaskOutputTool(taskStore),
+        createTaskListTool(taskStore),
+        createTaskGetTool(taskStore),
+        createTaskStopTool(taskStore),
+        createSendMessageTool(taskStore),
+        createTaskResumeTool(taskStore, resumeHandler),
+    ];
+}
+export function createTaskOutputTool(taskStore = globalTaskStore) {
+    return {
+        name: "TaskOutput",
+        aliases: ["task_output"],
+        description: "Read a background task output, optionally blocking until it reaches a terminal state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: { type: "string" },
+                block: { type: "boolean" },
+                timeout_ms: { type: "number" },
+            },
+            required: ["task_id"],
+            additionalProperties: false,
+        },
+        metadata: { readOnly: true, concurrent: true, visible: true, searchHint: "read background task output" },
+        validate(input) {
+            return input;
+        },
+        async call(input, context, options) {
+            const task = taskStore.get(input.task_id);
+            if (!task)
+                return { ok: false, output: { error: `Unknown task: ${input.task_id}` } };
+            if (input.block && !taskStore.isTerminal(task)) {
+                options.onProgress?.({ toolName: "TaskOutput", message: `Waiting for task ${input.task_id}` });
+                await taskStore.waitForTerminal(input.task_id, { timeoutMs: input.timeout_ms ?? 30000, signal: context.abortSignal });
+            }
+            const latest = taskStore.get(input.task_id);
+            if (!latest)
+                return { ok: false, output: { error: `Unknown task: ${input.task_id}` } };
+            if (!taskStore.isTerminal(latest)) {
+                return { ok: true, output: formatTaskOutput(latest, "not_ready") };
+            }
+            taskStore.markNotified(latest.taskId);
+            return { ok: true, output: formatTaskOutput(latest, "ready") };
+        },
+        mapResult(result) {
+            return result.output;
+        },
+    };
+}
+export function createTaskListTool(taskStore = globalTaskStore) {
+    return {
+        name: "TaskList",
+        aliases: ["task_list"],
+        description: "List known background tasks and their current status.",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        metadata: { readOnly: true, concurrent: true, visible: true, searchHint: "list background tasks" },
+        validate() {
+            return {};
+        },
+        async call() {
+            return { ok: true, output: { tasks: taskStore.list().map(taskSummary) } };
+        },
+    };
+}
+export function createTaskGetTool(taskStore = globalTaskStore) {
+    return {
+        name: "TaskGet",
+        aliases: ["task_get"],
+        description: "Get a background task detail by task id.",
+        inputSchema: {
+            type: "object",
+            properties: { task_id: { type: "string" } },
+            required: ["task_id"],
+            additionalProperties: false,
+        },
+        metadata: { readOnly: true, concurrent: true, visible: true, searchHint: "get background task detail" },
+        validate(input) {
+            return input;
+        },
+        async call(input) {
+            const task = taskStore.get(input.task_id);
+            return task ? { ok: true, output: taskDetail(task) } : { ok: false, output: { error: `Unknown task: ${input.task_id}` } };
+        },
+    };
+}
+export function createTaskStopTool(taskStore = globalTaskStore) {
+    return {
+        name: "TaskStop",
+        aliases: ["task_stop"],
+        description: "Stop a background task and mark it killed.",
+        inputSchema: {
+            type: "object",
+            properties: { task_id: { type: "string" } },
+            required: ["task_id"],
+            additionalProperties: false,
+        },
+        metadata: { readOnly: false, concurrent: false, visible: true, searchHint: "stop background task" },
+        validate(input) {
+            return input;
+        },
+        async call(input) {
+            const task = taskStore.get(input.task_id);
+            if (!task)
+                return { ok: false, output: { error: `Unknown task: ${input.task_id}` } };
+            if (!isTerminalStatus(task.status))
+                taskStore.kill(input.task_id, "Stopped by TaskStop");
+            return { ok: true, output: taskDetail(taskStore.get(input.task_id) ?? task) };
+        },
+    };
+}
+export function createSendMessageTool(taskStore = globalTaskStore) {
+    return {
+        name: "SendMessage",
+        aliases: ["send_message"],
+        description: "Queue a message for a named or identified background agent. Stopped-agent resume is represented as queued state in this scaffold.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: { type: "string" },
+                message: { type: "string" },
+            },
+            required: ["target", "message"],
+            additionalProperties: false,
+        },
+        metadata: { readOnly: false, concurrent: false, visible: true, searchHint: "send message to agent" },
+        validate(input) {
+            return input;
+        },
+        async call(input) {
+            const queued = taskStore.queueMessage(input.target, input.message);
+            if (!queued.ok)
+                return { ok: false, output: { status: "failed", error: queued.error } };
+            return {
+                ok: true,
+                output: {
+                    status: queued.task.status === "running" ? "queued" : "queued_for_resume",
+                    agent_id: queued.task.agentId,
+                    task_id: queued.task.taskId,
+                    pending_messages: queued.task.pendingMessages.length,
+                },
+            };
+        },
+    };
+}
+export function createTaskResumeTool(taskStore = globalTaskStore, resumeHandler) {
+    return {
+        name: "TaskResume",
+        aliases: ["task_resume"],
+        description: "Resume a completed, failed, or killed background agent task with an optional new directive. The agent re-launches with its prior conversation context intact.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: { type: "string", description: "Task ID to resume." },
+                directive: { type: "string", description: "Optional new instructions for the resumed agent." },
+            },
+            required: ["task_id"],
+            additionalProperties: false,
+        },
+        metadata: { readOnly: false, concurrent: false, visible: true, searchHint: "resume stopped agent task" },
+        validate(input) {
+            return input;
+        },
+        async call(input) {
+            const task = taskStore.get(input.task_id);
+            if (!task)
+                return { ok: false, output: { error: `Unknown task: ${input.task_id}` } };
+            if (task.type !== "agent")
+                return { ok: false, output: { error: `Only agent tasks can be resumed, got type: ${task.type}` } };
+            if (!isTerminalStatus(task.status)) {
+                return { ok: false, output: { error: `Task ${input.task_id} is still ${task.status}; stop it first or wait for completion.` } };
+            }
+            if (!resumeHandler) {
+                return { ok: false, output: { error: "TaskResume handler is not configured in this runtime." } };
+            }
+            const result = await resumeHandler(input.task_id, input.directive);
+            if (!result.ok)
+                return { ok: false, output: { error: result.error ?? "Resume failed" } };
+            return {
+                ok: true,
+                output: {
+                    status: "resumed",
+                    task_id: task.taskId,
+                    agent_id: task.agentId,
+                    directive: input.directive ?? "(continue)",
+                },
+            };
+        },
+    };
+}
+function formatTaskOutput(task, retrievalStatus) {
+    const output = task.result?.content ?? task.error ?? task.progress.lastText ?? "";
+    return [
+        `<retrieval_status>${retrievalStatus}</retrieval_status>`,
+        `<task_id>${task.taskId}</task_id>`,
+        `<task_type>${task.type}</task_type>`,
+        `<status>${task.status}</status>`,
+        `<agent_id>${task.agentId}</agent_id>`,
+        `<output>${escapeXml(output)}</output>`,
+        task.error ? `<error>${escapeXml(task.error)}</error>` : undefined,
+    ].filter(Boolean).join("\n");
+}
+function taskSummary(task) {
+    return {
+        task_id: task.taskId,
+        agent_id: task.agentId,
+        status: task.status,
+        description: task.description,
+        output_file: task.outputFile,
+        updated_at: task.updatedAt,
+    };
+}
+function taskDetail(task) {
+    return {
+        ...taskSummary(task),
+        prompt: task.prompt,
+        progress: task.progress,
+        result: task.result,
+        error: task.error,
+        notified: task.notified,
+        pending_messages: task.pendingMessages.length,
+    };
+}
+function escapeXml(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+export function asToolResult(output) {
+    return { ok: true, output };
+}
+//# sourceMappingURL=task-tools.js.map

package/dist/tasks/task-tools.js.map

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

package/dist/tools/builtins/echo-tool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "../tool.js";
+export declare const echoTool: Tool<{
+    text: string;
+}>;

package/dist/tools/builtins/echo-tool.js

@@ -0,0 +1,26 @@
+export const echoTool = {
+    name: "echo",
+    aliases: ["say"],
+    description: "Return the provided text. Useful for wiring tests before real tools exist.",
+    inputSchema: {
+        type: "object",
+        properties: { text: { type: "string", description: "Text to return." } },
+        required: ["text"],
+        additionalProperties: false,
+    },
+    metadata: { readOnly: true, concurrent: true, visible: true, maxResultSizeChars: 4096, searchHint: "echo text" },
+    validate(input) {
+        return { text: input.text };
+    },
+    validateInput(input) {
+        return input.text.length > 0 ? { ok: true, value: input } : { ok: false, message: "echo.text cannot be empty" };
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async call(input, _context, options) {
+        options.onProgress?.({ toolName: "echo", message: "Echo text prepared" });
+        return { ok: true, output: input.text };
+    },
+};
+//# sourceMappingURL=echo-tool.js.map

package/dist/tools/builtins/echo-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-tool.js","sourceRoot":"","sources":["../../../src/tools/builtins/echo-tool.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,CAAC,KAAK,CAAC;IAChB,WAAW,EAAE,4EAA4E;IACzF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE;QACxE,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE;IAChH,QAAQ,CAAC,KAAc;QACrB,OAAO,EAAE,IAAI,EAAG,KAA0B,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IACD,aAAa,CAAC,KAAK;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IAClH,CAAC;IACD,iBAAiB;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO;QACjC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;CACF,CAAC"}

package/dist/tools/builtins/edit-tool.d.ts

@@ -0,0 +1,30 @@
+import type { Tool } from "../tool.js";
+export interface EditToolInput {
+    path: string;
+    oldString: string;
+    newString: string;
+    replaceAll: boolean;
+}
+export interface WriteToolInput {
+    path: string;
+    content: string;
+}
+export interface TextEditOutput {
+    path: string;
+    operation: "create" | "edit" | "write";
+    replacements: number;
+    bytesBefore: number;
+    bytesAfter: number;
+    lineEnding: "LF" | "CRLF" | "CR" | "mixed" | "none";
+    encoding: "utf8" | "utf16le";
+    patch: PatchHunk[];
+}
+export interface PatchHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+}
+export declare const editTool: Tool<EditToolInput>;
+export declare const writeTool: Tool<WriteToolInput>;