@zmzai/agent-framework 0.1.0

package/dist/adapters/fs-workspace.d.ts

@@ -0,0 +1,7 @@
+import { unlink } from "node:fs/promises";
+import type { WorkspaceFiles } from "../core/tools/context.js";
+export declare function createFsWorkspaceFiles(input: {
+    root: string;
+}): WorkspaceFiles;
+export { unlink as deleteFsFile };
+//# sourceMappingURL=fs-workspace.d.ts.map

package/dist/adapters/fs-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-workspace.d.ts","sourceRoot":"","sources":["../../src/adapters/fs-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAK/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAiC/D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAmD9E;AAED,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,CAAC"}

package/dist/adapters/fs-workspace.js

@@ -0,0 +1,91 @@
+import { mkdir, readFile, writeFile, readdir, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { createUnifiedDiff } from "./workspace-edit.js";
+const MAX_FILE_BYTES = 512 * 1024;
+function revFile(root) {
+    return path.join(root, ".fw-revisions.json");
+}
+async function loadRevisions(root) {
+    try {
+        return JSON.parse(await readFile(revFile(root), "utf8"));
+    }
+    catch {
+        return [];
+    }
+}
+async function saveRevisions(root, revisions) {
+    await writeFile(revFile(root), JSON.stringify(revisions.slice(-200), null, 2), "utf8");
+}
+function safeJoin(root, rel) {
+    const candidate = path.resolve(root, rel);
+    if (candidate !== root && !candidate.startsWith(root + path.sep))
+        return null;
+    return candidate;
+}
+export function createFsWorkspaceFiles(input) {
+    const root = path.resolve(input.root);
+    return {
+        async list() {
+            if (!existsSync(root))
+                return [];
+            const walk = async (dir) => {
+                const entries = await readdir(dir, { withFileTypes: true });
+                const out = [];
+                for (const entry of entries) {
+                    if (entry.name === ".fw-revisions.json" || entry.name.startsWith(".git"))
+                        continue;
+                    const full = path.join(dir, entry.name);
+                    if (entry.isDirectory())
+                        out.push(...(await walk(full)));
+                    else
+                        out.push({ path: path.relative(root, full), bytes: (await readFile(full)).length });
+                }
+                return out;
+            };
+            return walk(root);
+        },
+        async read(rel) {
+            const full = safeJoin(root, rel);
+            if (!full || !existsSync(full))
+                return null;
+            const stat = await import("node:fs/promises").then((m) => m.stat(full));
+            if (!stat.isFile())
+                return null;
+            if (stat.size > MAX_FILE_BYTES)
+                return null;
+            return { path: rel, content: await readFile(full, "utf8") };
+        },
+        async write({ path: rel, content, summary }) {
+            const full = safeJoin(root, rel);
+            if (!full)
+                return null;
+            await mkdir(path.dirname(full), { recursive: true });
+            const before = existsSync(full) ? await readFile(full, "utf8") : null;
+            if (Buffer.byteLength(content, "utf8") > MAX_FILE_BYTES)
+                return null;
+            await writeFile(full, content, "utf8");
+            const id = `rev_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            await saveRevisions(root, [...(await loadRevisions(root)), { id, path: rel, before, after: content, summary, at: new Date().toISOString() }]);
+            return { revisionId: id, diff: createUnifiedDiff({ path: rel, operation: before === null ? "create" : "update", before, after: content }) };
+        },
+        async edit({ path: rel, oldText, newText, summary }) {
+            const full = safeJoin(root, rel);
+            if (!full || !existsSync(full))
+                return { error: `文件不存在：${rel}` };
+            const content = await readFile(full, "utf8");
+            const first = content.indexOf(oldText);
+            if (first === -1)
+                return { error: "EDIT_TARGET_NOT_FOUND" };
+            if (content.indexOf(oldText, first + oldText.length) !== -1)
+                return { error: "EDIT_TARGET_AMBIGUOUS" };
+            const after = `${content.slice(0, first)}${newText}${content.slice(first + oldText.length)}`;
+            await writeFile(full, after, "utf8");
+            const id = `rev_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            await saveRevisions(root, [...(await loadRevisions(root)), { id, path: rel, before: content, after, summary, at: new Date().toISOString() }]);
+            return { revisionId: id, diff: createUnifiedDiff({ path: rel, operation: "update", before: content, after }) };
+        },
+    };
+}
+export { unlink as deleteFsFile };
+//# sourceMappingURL=fs-workspace.js.map

package/dist/adapters/fs-workspace.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,46 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { StreamFn } from "@earendil-works/pi-agent-core";
+import type { ModelRef, SessionInfo } from "../core/session/types.js";
+import type { SandboxSnapshot, SandboxExecResult, SandboxExecInput } from "../core/tools/context.js";
+/** ModelProvider (M5 spec §5): the package's seam to the outside model
+ *  runtime. Products bind relay/OpenAI/etc.; the CLI binds an OpenAI-compatible
+ *  provider. The framework only ever talks to PI through these two methods. */
+export interface ModelProvider {
+    /** Resolves a model reference to a PI Model (used for the main loop). */
+    getModel(ref: ModelRef): Model<Api>;
+    /** Builds the PI streamFn for a run (per-session billing identity). */
+    streamFor(session: SessionInfo): StreamFn;
+}
+/** SandboxExecutor (M5 spec §5): isolated command execution + snapshot
+ *  building. The package ships a subprocess reference implementation (no
+ *  isolation, demo-only); products provide the OpenSandbox-backed one. */
+export interface SandboxExecutor {
+    /** Builds the workspace snapshot handed to the sandbox. */
+    buildSnapshot(input: {
+        userId: string;
+        workspaceId: string;
+        runId: string;
+    }): Promise<SandboxSnapshot>;
+    /** Runs one command in the sandbox and returns the result. */
+    run(input: SandboxExecInput & {
+        userId: string;
+        workspaceId: string;
+        runId: string;
+    }): Promise<SandboxExecResult>;
+}
+/** No-op sandbox: the framework still works for read/write/todo/subagent
+ *  flows without any execution backend; bash tool errors out clearly. */
+export declare function noopSandboxExecutor(reason?: string): SandboxExecutor;
+/** LeaseStore (M5): the runner stamps a lease on the session doc while it owns
+ *  a run. Products implement over Mongo; the package's JSONL store implements
+ *  over files. Recovery scans expired leases via the same interface. */
+export interface LeaseStore {
+    stampLease(sessionId: string, owner: string, expiresAt: Date): Promise<void>;
+    clearLease(sessionId: string): Promise<void>;
+    listExpiredLeases(): Promise<{
+        sessionId: string;
+    }[]>;
+    clearLeaseIfExpired(sessionId: string): Promise<boolean>;
+}
+export declare const leaseDurationMs: number;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAErG;;+EAE+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC3C;AAED;;0EAE0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,aAAa,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvG,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnH;AAED;yEACyE;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,SAAa,GAAG,eAAe,CASxE;AAED;;wEAEwE;AACxE,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,iBAAiB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACtD,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,eAAe,QAAiB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,14 @@
+/** No-op sandbox: the framework still works for read/write/todo/subagent
+ *  flows without any execution backend; bash tool errors out clearly. */
+export function noopSandboxExecutor(reason = "未配置沙箱执行器") {
+    return {
+        async buildSnapshot() {
+            return { revisionId: null, files: [] };
+        },
+        async run() {
+            return { ok: false, outcome: "failed", exitCode: 1, outputText: "", durationMs: 0, artifacts: [], errorMessage: reason };
+        },
+    };
+}
+export const leaseDurationMs = 10 * 60 * 1000;
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAyBA;yEACyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,MAAM,GAAG,UAAU;IACrD,OAAO;QACL,KAAK,CAAC,aAAa;YACjB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,GAAG;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAC3H,CAAC;KACF,CAAC;AACJ,CAAC;AAYD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/adapters/openai-provider.d.ts

@@ -0,0 +1,17 @@
+import type { ModelProvider } from "./index.js";
+/** OpenAI-compatible ModelProvider (M5 CLI reference): drives the framework
+ *  against any OpenAI-compatible chat-completions endpoint via env vars:
+ *
+ *   OPENAI_BASE_URL=https://api.openai.com/v1
+ *   OPENAI_API_KEY=sk-...
+ *   OPENAI_MODEL=gpt-4o            (default model)
+ *
+ *  The same provider serves relay-compatible backends (m.zmzai.cloud uses the
+ *  OpenAI wire format), so the framework runs standalone with zero product
+ *  coupling. */
+export declare function createOpenAiModelProvider(input?: {
+    baseUrl?: string;
+    apiKey?: string;
+    defaultModel?: string;
+}): ModelProvider;
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/adapters/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;;;;;;;gBASgB;AAChB,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAoG7H"}

package/dist/adapters/openai-provider.js

@@ -0,0 +1,116 @@
+/** OpenAI-compatible ModelProvider (M5 CLI reference): drives the framework
+ *  against any OpenAI-compatible chat-completions endpoint via env vars:
+ *
+ *   OPENAI_BASE_URL=https://api.openai.com/v1
+ *   OPENAI_API_KEY=sk-...
+ *   OPENAI_MODEL=gpt-4o            (default model)
+ *
+ *  The same provider serves relay-compatible backends (m.zmzai.cloud uses the
+ *  OpenAI wire format), so the framework runs standalone with zero product
+ *  coupling. */
+export function createOpenAiModelProvider(input) {
+    const baseUrl = (input?.baseUrl ?? process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1").replace(/\/$/, "");
+    const apiKey = input?.apiKey ?? process.env.OPENAI_API_KEY ?? "";
+    const defaultModel = input?.defaultModel ?? process.env.OPENAI_MODEL ?? "gpt-4o";
+    return {
+        getModel(ref) {
+            return {
+                id: ref.modelId || defaultModel,
+                name: ref.modelId || defaultModel,
+                api: "openai-completions",
+                provider: "zmzai-openai",
+                baseUrl,
+                reasoning: false,
+                input: ["text"],
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+                contextWindow: 128_000,
+                maxTokens: 16_384,
+            };
+        },
+        streamFor(session) {
+            void session;
+            // streamFn built per call; auth header injected by the provider wrapper.
+            return (async (model, context, options) => {
+                const { createAssistantMessageEventStream } = await import("@earendil-works/pi-ai");
+                const stream = createAssistantMessageEventStream();
+                void (async () => {
+                    try {
+                        const messages = (context.messages ?? []).map((message) => {
+                            if (message.role === "user" || message.role === "assistant") {
+                                const content = message.content;
+                                if (typeof content === "string")
+                                    return { role: message.role, content };
+                                if (Array.isArray(content)) {
+                                    return { role: message.role, content: content.filter((b) => b.type === "text").map((b) => ({ type: "text", text: b.text ?? "" })) };
+                                }
+                            }
+                            if (message.role === "toolResult") {
+                                const text = Array.isArray(message.content)
+                                    ? message.content.filter((b) => b.type === "text").map((b) => b.text ?? "").join("\n")
+                                    : String(message.content ?? "");
+                                return { role: "tool", content: text, tool_call_id: message.toolCallId ?? "" };
+                            }
+                            return null;
+                        }).filter(Boolean);
+                        const response = await fetch(`${baseUrl}/chat/completions`, {
+                            method: "POST",
+                            headers: { "content-type": "application/json", ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}) },
+                            body: JSON.stringify({
+                                model: model.id,
+                                messages,
+                                stream: true,
+                                ...(options?.maxTokens ? { max_tokens: options.maxTokens } : {}),
+                            }),
+                        });
+                        if (!response.ok || !response.body) {
+                            const error = { type: "error", reason: "error", error: await response.text().catch(() => "HTTP error") };
+                            stream.push(error);
+                            stream.end(error);
+                            return;
+                        }
+                        const reader = response.body.getReader();
+                        const decoder = new TextDecoder();
+                        let buffer = "";
+                        const partial = { role: "assistant", content: [{ type: "text", text: "" }] };
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done)
+                                break;
+                            buffer += decoder.decode(value, { stream: true });
+                            const lines = buffer.split("\n");
+                            buffer = lines.pop() ?? "";
+                            for (const line of lines) {
+                                const trimmed = line.trim();
+                                if (!trimmed.startsWith("data:"))
+                                    continue;
+                                const data = trimmed.slice(5).trim();
+                                if (data === "[DONE]")
+                                    continue;
+                                try {
+                                    const chunk = JSON.parse(data);
+                                    const delta = chunk.choices?.[0]?.delta?.content;
+                                    if (delta) {
+                                        partial.content[0].text += delta;
+                                        stream.push({ type: "text_delta", contentIndex: 0, delta, partial });
+                                    }
+                                }
+                                catch {
+                                    // partial JSON — ignore
+                                }
+                            }
+                        }
+                        stream.push({ type: "done", reason: "stop", message: partial });
+                        stream.end(partial);
+                    }
+                    catch (error) {
+                        const err = error instanceof Error ? error.message : String(error);
+                        stream.push({ type: "error", reason: "error", error: err });
+                        stream.end({ role: "assistant", content: [{ type: "text", text: "" }], stopReason: "error", errorMessage: err });
+                    }
+                })();
+                return stream;
+            });
+        },
+    };
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/adapters/openai-provider.js.map

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

package/dist/adapters/subprocess-sandbox.d.ts

@@ -0,0 +1,7 @@
+import type { SandboxExecutor } from "../adapters/index.js";
+/** Subprocess SandboxExecutor (M5 §5 CLI reference implementation): writes the
+ *  snapshot to a temp dir and runs the command as a plain child process — NO
+ *  isolation. Good enough to demo the framework standalone; production uses
+ *  OpenSandbox. */
+export declare function createSubprocessSandbox(): SandboxExecutor;
+//# sourceMappingURL=subprocess-sandbox.d.ts.map

package/dist/adapters/subprocess-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess-sandbox.d.ts","sourceRoot":"","sources":["../../src/adapters/subprocess-sandbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;mBAGmB;AACnB,wBAAgB,uBAAuB,IAAI,eAAe,CAoEzD"}

package/dist/adapters/subprocess-sandbox.js

@@ -0,0 +1,91 @@
+import { spawn } from "node:child_process";
+import { mkdtemp, writeFile, rm, readdir, readFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+/** Subprocess SandboxExecutor (M5 §5 CLI reference implementation): writes the
+ *  snapshot to a temp dir and runs the command as a plain child process — NO
+ *  isolation. Good enough to demo the framework standalone; production uses
+ *  OpenSandbox. */
+export function createSubprocessSandbox() {
+    return {
+        async buildSnapshot(input) {
+            void input;
+            return { revisionId: null, files: [] };
+        },
+        async run(input) {
+            const dir = await mkdtemp(path.join(tmpdir(), "fw-sandbox-"));
+            try {
+                for (const file of input.snapshot.files) {
+                    const full = path.join(dir, file.path);
+                    await writeFile(full, file.content, "utf8");
+                }
+                const cwd = input.command.cwd ? path.join(dir, input.command.cwd) : dir;
+                const result = await new Promise((resolve, reject) => {
+                    const child = spawn(input.command.program, input.command.args ?? [], {
+                        cwd,
+                        env: { ...process.env, ...(input.command.env ?? {}) },
+                        shell: false,
+                        stdio: ["ignore", "pipe", "pipe"],
+                    });
+                    let output = "";
+                    child.stdout.on("data", (chunk) => {
+                        output += String(chunk);
+                    });
+                    child.stderr.on("data", (chunk) => {
+                        output += String(chunk);
+                    });
+                    child.on("error", reject);
+                    child.on("close", (code) => resolve({ code, output }));
+                });
+                // Collect files written during the run as deliverables.
+                const artifacts = [];
+                const walk = async (dirPath) => {
+                    const entries = await readdir(dirPath, { withFileTypes: true });
+                    for (const entry of entries) {
+                        const full = path.join(dirPath, entry.name);
+                        if (entry.isDirectory()) {
+                            await walk(full);
+                        }
+                        else if (entry.name !== ".fw-sandbox") {
+                            const rel = path.relative(dir, full);
+                            const content = await readFile(full);
+                            artifacts.push({
+                                path: rel,
+                                bytes: content.length,
+                                contentType: guessContentType(rel),
+                                downloadUrl: `file://${full}`,
+                            });
+                        }
+                    }
+                };
+                await walk(dir);
+                // Only files NOT in the original snapshot count as deliverables.
+                const snapshotPaths = new Set(input.snapshot.files.map((f) => f.path));
+                const deliverables = artifacts.filter((a) => !snapshotPaths.has(a.path));
+                return {
+                    ok: result.code === 0,
+                    outcome: result.code === 0 ? "succeeded" : "failed",
+                    exitCode: result.code,
+                    outputText: result.output,
+                    durationMs: 0,
+                    artifacts: deliverables,
+                };
+            }
+            finally {
+                await rm(dir, { recursive: true, force: true });
+            }
+        },
+    };
+}
+function guessContentType(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    const map = {
+        ".html": "text/html", ".htm": "text/html", ".png": "image/png", ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg", ".gif": "image/gif", ".svg": "image/svg+xml", ".webp": "image/webp",
+        ".pdf": "application/pdf", ".md": "text/markdown", ".txt": "text/plain", ".css": "text/css",
+        ".js": "text/javascript", ".json": "application/json", ".py": "text/x-python",
+        ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+//# sourceMappingURL=subprocess-sandbox.js.map

package/dist/adapters/subprocess-sandbox.js.map

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

package/dist/adapters/workspace-edit.d.ts

@@ -0,0 +1,19 @@
+/** Pure workspace text-edit + diff helpers, shared by the framework's
+ *  mongo-workspace (direct write/edit) and any code that renders a unified
+ *  diff. Extracted from the legacy proposals module so the proposal-staging
+ *  machinery could be retired without losing these. */
+export type FileChange = {
+    path: string;
+    operation: "create" | "update" | "delete";
+    before: string | null;
+    after: string | null;
+};
+export declare function createUnifiedDiff(change: FileChange): string;
+/** Applies an exact oldText → newText replacement. Returns an error when the
+ *  target is missing or occurs more than once (ambiguous edit). */
+export declare function applySingleEdit(content: string, oldText: string, newText: string): {
+    content: string;
+} | {
+    error: string;
+};
+//# sourceMappingURL=workspace-edit.d.ts.map

package/dist/adapters/workspace-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-edit.d.ts","sourceRoot":"","sources":["../../src/adapters/workspace-edit.ts"],"names":[],"mappings":"AAAA;;;uDAGuD;AAEvD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAWF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU5D;AAED;mEACmE;AACnE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAM1H"}

package/dist/adapters/workspace-edit.js

@@ -0,0 +1,36 @@
+/** Pure workspace text-edit + diff helpers, shared by the framework's
+ *  mongo-workspace (direct write/edit) and any code that renders a unified
+ *  diff. Extracted from the legacy proposals module so the proposal-staging
+ *  machinery could be retired without losing these. */
+function lineCount(value) {
+    return value ? value.split("\n").length : 0;
+}
+function diffLines(prefix, value) {
+    if (value === null || value === "")
+        return [];
+    return value.split("\n").map((line) => `${prefix}${line}`);
+}
+export function createUnifiedDiff(change) {
+    const beforeLabel = change.before === null ? "/dev/null" : `a/${change.path}`;
+    const afterLabel = change.after === null ? "/dev/null" : `b/${change.path}`;
+    return [
+        `--- ${beforeLabel}`,
+        `+++ ${afterLabel}`,
+        `@@ -1,${lineCount(change.before ?? "")} +1,${lineCount(change.after ?? "")} @@`,
+        ...diffLines("-", change.before),
+        ...diffLines("+", change.after),
+    ].join("\n");
+}
+/** Applies an exact oldText → newText replacement. Returns an error when the
+ *  target is missing or occurs more than once (ambiguous edit). */
+export function applySingleEdit(content, oldText, newText) {
+    if (!oldText)
+        return { error: "EDIT_TARGET_REQUIRED" };
+    const first = content.indexOf(oldText);
+    if (first === -1)
+        return { error: "EDIT_TARGET_NOT_FOUND" };
+    if (content.indexOf(oldText, first + oldText.length) !== -1)
+        return { error: "EDIT_TARGET_AMBIGUOUS" };
+    return { content: `${content.slice(0, first)}${newText}${content.slice(first + oldText.length)}` };
+}
+//# sourceMappingURL=workspace-edit.js.map

package/dist/adapters/workspace-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-edit.js","sourceRoot":"","sources":["../../src/adapters/workspace-edit.ts"],"names":[],"mappings":"AAAA;;;uDAGuD;AASvD,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,KAAoB;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO;QACL,OAAO,WAAW,EAAE;QACpB,OAAO,UAAU,EAAE;QACnB,SAAS,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK;QAChF,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC;QAChC,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;mEACmE;AACnE,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAe,EAAE,OAAe;IAC/E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IAC5D,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvG,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;AACrG,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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