frely-cli 0.13.0 → 0.13.2

package/dist/agent/ops-server.js

@@ -1,175 +0,0 @@
-/**
- * Local GUI ops socket (plan §4.2 as amended for M4): a Unix domain socket
- * bound to the current user (0600) exposing the shared agent-op surface plus
- * `config_get`/`config_set`, and pushing `tasks_changed` notifications so the
- * Frely App task panel stays live. The socket lives only as long as the
- * serving process (`frely mcp serve`), which is also the process hosting
- * agent task execution, so remote and GUI views share one task store.
- */
-import { connect, createServer } from "node:net";
-import { chmod, mkdir, rm } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { loadAgentConfig, saveAgentConfig } from "./agent-service.js";
-import { AGENT_MAX_COST_USD_LIMIT, agentStateDir, TaskStore } from "./task-store.js";
-import { VERSION } from "../version.js";
-import { AGENT_OPS, dispatchAgentOp, isAgentOp } from "./ops.js";
-const MAX_LINE_BYTES = 512 * 1024;
-export async function startAgentOpsServer(agent, options) {
-    const env = options.env ?? process.env;
-    const socketPath = options.socketPath ?? join(agentStateDir(env), "ops.sock");
-    await mkdir(dirname(socketPath), { recursive: true, mode: 0o700 });
-    await rm(socketPath, { force: true });
-    const sockets = new Set();
-    const clients = new Set();
-    const store = TaskStore.open(undefined, env);
-    const server = createServer((socket) => {
-        sockets.add(socket);
-        socket.setEncoding("utf8");
-        const client = {
-            write: (line) => {
-                if (!socket.destroyed)
-                    socket.write(`${line}\n`);
-            },
-        };
-        clients.add(client);
-        let buffer = "";
-        socket.on("data", (chunk) => {
-            buffer += chunk;
-            let newline = buffer.indexOf("\n");
-            while (newline >= 0) {
-                const line = buffer.slice(0, newline).trim();
-                buffer = buffer.slice(newline + 1);
-                if (line.length > 0)
-                    void handleLine(line, client);
-                if (buffer.length > MAX_LINE_BYTES) {
-                    client.write(JSON.stringify({ id: null, ok: false, error: { code: "request_too_large", message: "Request line exceeds the 512KB limit." } }));
-                    socket.destroy();
-                    return;
-                }
-                newline = buffer.indexOf("\n");
-            }
-        });
-        socket.on("close", () => { clients.delete(client); sockets.delete(socket); });
-        socket.on("error", () => { clients.delete(client); sockets.delete(socket); });
-        // Greet the client with a task snapshot so it can render without a leading list call.
-        void store.list().then((tasks) => client.write(JSON.stringify({ push: "tasks_changed", tasks })), () => undefined);
-    });
-    await new Promise((resolve, reject) => {
-        server.once("error", reject);
-        server.listen(socketPath, () => resolve());
-    });
-    await chmod(socketPath, 0o600);
-    const pollIntervalMs = options.pollIntervalMs ?? 1000;
-    // Establish the baseline before accepting changes: any task created after
-    // startup (including between a client's welcome snapshot and the first
-    // poll tick) must eventually produce a push.
-    let fingerprint = fingerprintFor(await store.list());
-    const poll = setInterval(() => {
-        if (clients.size === 0)
-            return;
-        void store.list().then((tasks) => {
-            const next = fingerprintFor(tasks);
-            if (next === fingerprint)
-                return;
-            fingerprint = next;
-            broadcast(JSON.stringify({ push: "tasks_changed", tasks }));
-        }, (error) => options.log?.(`agent.ops.poll_failed ${error instanceof Error ? error.message : String(error)}`));
-    }, pollIntervalMs);
-    poll.unref?.();
-    async function handleLine(line, client) {
-        let request;
-        try {
-            const parsed = JSON.parse(line);
-            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-                throw new Error("not an object");
-            request = parsed;
-        }
-        catch {
-            client.write(JSON.stringify({ id: null, ok: false, error: { code: "invalid_request", message: "Each line must be a JSON request object." } }));
-            return;
-        }
-        const id = request.id ?? null;
-        try {
-            const result = await dispatch(request);
-            client.write(JSON.stringify({ id, ok: true, result }));
-        }
-        catch (error) {
-            const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "internal";
-            client.write(JSON.stringify({ id, ok: false, error: { code, message: error instanceof Error ? error.message : String(error) } }));
-        }
-    }
-    async function dispatch(request) {
-        if (request.op === "ping")
-            return { pong: true, pid: process.pid, version: VERSION };
-        if (request.op === "config_get")
-            return { config: await loadAgentConfig(env) };
-        if (request.op === "config_set") {
-            const patch = (request.args && typeof request.args === "object" && !Array.isArray(request.args) ? request.args : {});
-            const current = await loadAgentConfig(env);
-            const next = {
-                schemaVersion: 1,
-                remoteControlEnabled: typeof patch.remoteControlEnabled === "boolean" ? patch.remoteControlEnabled : current.remoteControlEnabled,
-                defaultMaxCostUsd: typeof patch.defaultMaxCostUsd === "number" ? patch.defaultMaxCostUsd : current.defaultMaxCostUsd,
-                maxCostUsdLimit: clampCost(patch.maxCostUsdLimit, current.maxCostUsdLimit),
-                maxConcurrentTasks: clampConcurrency(patch.maxConcurrentTasks, current.maxConcurrentTasks),
-            };
-            await saveAgentConfig(next, env);
-            return { config: next };
-        }
-        if (typeof request.op === "string" && isAgentOp(request.op)) {
-            const args = (request.args && typeof request.args === "object" && !Array.isArray(request.args) ? request.args : {});
-            return dispatchAgentOp(request.op, args, agent, { workspace: options.workspace }, { source: { kind: "gui" }, approvedBy: "gui" });
-        }
-        throw Object.assign(new Error(`Unknown op. Supported: ping, config_get, config_set, and agent ops (${AGENT_OPS.join(", ")}).`), { code: "unknown_op" });
-    }
-    function broadcast(line) {
-        for (const client of clients)
-            client.write(line);
-    }
-    return {
-        path: socketPath,
-        close: async () => {
-            clearInterval(poll);
-            clients.clear();
-            for (const socket of sockets)
-                socket.destroy();
-            await new Promise((resolve) => server.close(() => resolve()));
-            await rm(socketPath, { force: true });
-        },
-    };
-}
-function clampCost(value, fallback) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0 && value <= AGENT_MAX_COST_USD_LIMIT ? value : fallback;
-}
-function clampConcurrency(value, fallback) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value >= 1 && value <= 4 ? value : fallback;
-}
-function fingerprintFor(tasks) {
-    return JSON.stringify(tasks.map((task) => [task.id, task.status, task.mergeStatus, task.usage.costUsd, task.updatedAt]));
-}
-export function pingAgentOpsSocket(socketPath, timeoutMs) {
-    return new Promise((resolvePing) => {
-        const socket = connect(socketPath);
-        const finish = (value) => {
-            socket.destroy();
-            clearTimeout(timer);
-            resolvePing(value);
-        };
-        const timer = setTimeout(() => finish({ running: false }), timeoutMs);
-        socket.on("connect", () => socket.write(`${JSON.stringify({ id: 1, op: "ping", args: {} })}\n`));
-        socket.on("data", (chunk) => {
-            for (const line of chunk.toString("utf8").split("\n")) {
-                if (line.trim().length === 0)
-                    continue;
-                try {
-                    const response = JSON.parse(line);
-                    if (response.ok && response.result?.pong)
-                        finish({ running: true, pid: response.result.pid, version: response.result.version });
-                }
-                catch { /* ignore partial lines */ }
-            }
-        });
-        socket.on("error", () => finish({ running: false }));
-    });
-}
-//# sourceMappingURL=ops-server.js.map

package/dist/agent/ops-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-server.js","sourceRoot":"","sources":["../../src/agent/ops-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAA2B,MAAM,oBAAoB,CAAC;AAE/F,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,SAAS,EAAwB,MAAM,iBAAiB,CAAC;AAC3G,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAiBlC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAmB,EAAE,OAA8B;IAC3F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;IAC9E,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAW,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,MAAM,CAAC,SAAS;oBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;YACnD,CAAC;SACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,OAAO,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACnD,IAAI,MAAM,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;oBACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,uCAAuC,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC9I,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,sFAAsF;QACtF,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACrH,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAE/B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,0EAA0E;IAC1E,uEAAuE;IACvE,6CAA6C;IAC7C,IAAI,WAAW,GAAG,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAC/B,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,WAAW;gBAAE,OAAO;YACjC,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC,EAAE,cAAc,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IAEf,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,MAAyC;QAC/E,IAAI,OAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;YAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YACrG,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,0CAA0C,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/I,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;YAChK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpI,CAAC;IACH,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,OAAmB;QACzC,IAAI,OAAO,CAAC,EAAE,KAAK,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACrF,IAAI,OAAO,CAAC,EAAE,KAAK,YAAY;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/E,IAAI,OAAO,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAgC,CAAC;YACpJ,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAuB;gBAC/B,aAAa,EAAE,CAAC;gBAChB,oBAAoB,EAAE,OAAO,KAAK,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB;gBACjI,iBAAiB,EAAE,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB;gBACpH,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC;gBAC1E,kBAAkB,EAAE,gBAAgB,CAAC,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,CAAC;aAC3F,CAAC;YACF,MAAM,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;YAC/I,OAAO,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACpI,CAAC;QACD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uEAAuE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1J,CAAC;IAED,SAAS,SAAS,CAAC,IAAY;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,aAAa,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpE,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,QAAgB;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClI,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,QAAgB;IACxD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjH,CAAC;AAED,SAAS,cAAc,CAAC,KAAwB;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,SAAiB;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,KAAmF,EAAE,EAAE;YACrG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACtE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACjG,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBACvC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkF,CAAC;oBACnH,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI;wBAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClI,CAAC;gBAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/ops-stdio.d.ts

@@ -1,5 +0,0 @@
-export declare function runAgentOpsStdioBridge(args: {
-    stdout: NodeJS.WriteStream;
-    stdin: NodeJS.ReadStream;
-    stderr: NodeJS.WriteStream;
-}): Promise<number>;

package/dist/agent/ops-stdio.js

@@ -1,47 +0,0 @@
-/**
- * `frely app ops`: stdio bridge to the local agent ops socket.
- *
- * The Frely App GUI cannot open Unix domain sockets from Dart, so it spawns
- * this command instead: the process connects to `<state>/agent/ops.sock`,
- * bridges stdin -> socket and socket -> stdout line by line, and exits 1 with
- * a stderr hint when no serving process is running. This keeps the socket's
- * same-user permission boundary (the bridge runs as the current user) while
- * giving the GUI a plain NDJSON stream with tasks_changed pushes.
- */
-import { connect } from "node:net";
-import { createInterface } from "node:readline";
-import { agentStateDir } from "./task-store.js";
-import { pingAgentOpsSocket } from "./ops-server.js";
-export async function runAgentOpsStdioBridge(args) {
-    const socketPath = `${agentStateDir()}/ops.sock`;
-    const probe = await pingAgentOpsSocket(socketPath, 1000);
-    if (!probe.running) {
-        args.stderr.write(`Agent ops socket is not reachable at ${socketPath}. Start it with: frely mcp serve\n`);
-        return 1;
-    }
-    await new Promise((resolve) => {
-        let settled = false;
-        const finish = (code) => {
-            if (!settled) {
-                settled = true;
-                resolve(code);
-            }
-        };
-        const socket = connect(socketPath);
-        socket.on("error", (error) => {
-            args.stderr.write(`Agent ops socket failed: ${error instanceof Error ? error.message : String(error)}\n`);
-            finish(1);
-        });
-        socket.on("close", () => finish(0));
-        socket.pipe(args.stdout);
-        const lines = createInterface({ input: args.stdin });
-        lines.on("line", (line) => {
-            if (line.trim().length > 0 && !socket.destroyed)
-                socket.write(`${line}\n`);
-        });
-        args.stdin.on("close", () => socket.end());
-        args.stdin.on("end", () => socket.end());
-    });
-    return 0;
-}
-//# sourceMappingURL=ops-stdio.js.map

package/dist/agent/ops-stdio.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-stdio.js","sourceRoot":"","sources":["../../src/agent/ops-stdio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAe,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAA0F;IACrI,MAAM,UAAU,GAAG,GAAG,aAAa,EAAE,WAAW,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,UAAU,oCAAoC,CAAC,CAAC;QAC1G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACpC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QACF,MAAM,MAAM,GAAW,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1G,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/agent/ops.d.ts

@@ -1,25 +0,0 @@
-/**
- * Shared agent-op dispatch (plan §5). The same op surface serves three
- * transports: device-relay `method: "agent"` (remote web), the MCP frely-app
- * toolset bridge, and the local GUI ops socket (M4). Each transport passes its
- * own task `source` and merge `approvedBy` identity; only the ops socket gets
- * the full task record (source, worktreePath, approval) because it never
- * leaves the device.
- */
-import type { AgentService } from "./agent-service.js";
-import type { AgentTaskRecord, AgentTaskSource } from "./task-store.js";
-export declare const AGENT_OPS: readonly ["agent_start_task", "agent_list_tasks", "agent_get_task", "agent_get_events", "agent_send_message", "agent_get_diff", "agent_request_merge", "agent_approve_merge", "agent_discard_task", "agent_cancel_task"];
-export type AgentOp = (typeof AGENT_OPS)[number];
-export declare class AgentOpError extends Error {
-    readonly code: string;
-    constructor(code: string, message?: string);
-}
-export type AgentOpIdentity = {
-    source: AgentTaskSource;
-    approvedBy: "gui" | "web";
-};
-export declare function isAgentOp(op: string): op is AgentOp;
-export declare function dispatchAgentOp(op: AgentOp, args: Record<string, unknown>, agent: AgentService, defaults: {
-    workspace: string;
-}, identity?: AgentOpIdentity): Promise<unknown>;
-export type { AgentTaskRecord };

package/dist/agent/ops.js

@@ -1,82 +0,0 @@
-export const AGENT_OPS = [
-    "agent_start_task",
-    "agent_list_tasks",
-    "agent_get_task",
-    "agent_get_events",
-    "agent_send_message",
-    "agent_get_diff",
-    "agent_request_merge",
-    "agent_approve_merge",
-    "agent_discard_task",
-    "agent_cancel_task",
-];
-export class AgentOpError extends Error {
-    code;
-    constructor(code, message) {
-        super(message ?? code);
-        this.code = code;
-        this.name = "AgentOpError";
-    }
-}
-export function isAgentOp(op) {
-    return AGENT_OPS.includes(op);
-}
-export async function dispatchAgentOp(op, args, agent, defaults, identity = { source: { kind: "web" }, approvedBy: "web" }) {
-    switch (op) {
-        case "agent_start_task": {
-            const task = await agent.startTask({
-                workspace: optionalString(args.workspace) ?? defaults.workspace,
-                goal: requiredString(args.goal, "goal"),
-                ...(typeof args.model === "string" && args.model.length > 0 ? { model: args.model } : {}),
-                ...(typeof args.maxCostUsd === "number" && Number.isFinite(args.maxCostUsd) ? { maxCostUsd: args.maxCostUsd } : {}),
-                source: identity.source,
-            });
-            return { task };
-        }
-        case "agent_list_tasks": {
-            const workspace = optionalString(args.workspace) ?? defaults.workspace;
-            return { tasks: await agent.listTasks(workspace) };
-        }
-        case "agent_get_task":
-            return { task: await agent.getTask(requiredTaskId(args)) };
-        case "agent_get_events": {
-            const cursor = optionalNumber(args.cursor) ?? 0;
-            const page = await agent.getEvents(requiredTaskId(args), Number.isSafeInteger(cursor) && cursor >= 0 ? cursor : 0);
-            return { events: page.events, nextCursor: page.nextCursor };
-        }
-        case "agent_send_message":
-            await agent.sendMessage(requiredTaskId(args), requiredString(args.message, "message"));
-            return { sent: true };
-        case "agent_get_diff": {
-            const result = await agent.getDiff(requiredTaskId(args), optionalString(args.path));
-            return { diff: result.diff, truncated: result.truncated };
-        }
-        case "agent_request_merge": {
-            const note = optionalString(args.note);
-            return { task: await agent.requestMerge(requiredTaskId(args), note) };
-        }
-        case "agent_approve_merge":
-            return { task: await agent.approveMerge(requiredTaskId(args), identity.approvedBy) };
-        case "agent_discard_task":
-            return { task: await agent.discardTask(requiredTaskId(args)) };
-        case "agent_cancel_task":
-            return { task: await agent.cancelTask(requiredTaskId(args)) };
-        default:
-            throw new AgentOpError("unknown_op", op);
-    }
-}
-function requiredTaskId(args) {
-    return requiredString(args.taskId, "taskId");
-}
-function requiredString(value, name) {
-    if (typeof value !== "string" || value.length === 0)
-        throw new AgentOpError("invalid_args", `${name} must be a non-empty string.`);
-    return value;
-}
-function optionalString(value) {
-    return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function optionalNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
-}
-//# sourceMappingURL=ops.js.map

package/dist/agent/ops.js.map

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

package/dist/agent/protocol.d.ts

@@ -1,72 +0,0 @@
-export declare const AGENT_HOST_PROTOCOL = "frely.agent-host.v1";
-export declare const AGENT_HOST_PROTOCOL_VERSION = 1;
-export declare const AGENT_HOST_MAX_FRAME_BYTES: number;
-export declare const AGENT_HOST_CONNECTION_KEY_ENV = "FRELY_AGENT_HOST_KEY";
-export type AgentHostTaskStatus = "running" | "waiting_input" | "completed" | "failed" | "cancelled";
-export type AgentHostTaskEvent = {
-    type: "status";
-    status: AgentHostTaskStatus;
-    detail?: string;
-} | {
-    type: "message";
-    role: "assistant" | "user" | "system";
-    text: string;
-    partial?: boolean;
-} | {
-    type: "tool_call";
-    tool: string;
-    summary: string;
-    state: "started" | "finished" | "failed";
-} | {
-    type: "usage";
-    inputTokens: number;
-    outputTokens: number;
-    costUsd: number;
-} | {
-    type: "log";
-    text: string;
-};
-export type JsonRpcId = number | string;
-export type JsonRpcRequest = {
-    jsonrpc: "2.0";
-    id?: JsonRpcId;
-    method: string;
-    params?: Record<string, unknown>;
-};
-export type JsonRpcResponse = {
-    jsonrpc: "2.0";
-    id: JsonRpcId;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-};
-export type JsonRpcMessage = JsonRpcRequest | JsonRpcResponse | {
-    jsonrpc: "2.0";
-    method: string;
-    params?: Record<string, unknown>;
-};
-export declare class AgentHostProtocolError extends Error {
-    readonly code: "frame_invalid" | "frame_too_large" | "handshake_rejected" | "unexpected_frame";
-    constructor(code: "frame_invalid" | "frame_too_large" | "handshake_rejected" | "unexpected_frame");
-}
-export declare function newConnectionKey(): string;
-export declare function isValidTaskId(id: string): boolean;
-export declare function newTaskId(): string;
-/** Encode one NDJSON frame. */
-export declare function encodeAgentHostFrame(message: JsonRpcMessage): string;
-/** Decode one NDJSON frame (without the trailing newline). */
-export declare function decodeAgentHostFrame(line: Buffer | string): JsonRpcMessage;
-/** Validate and normalize a `task.event` notification params object. */
-export declare function decodeTaskEvent(params: unknown): {
-    taskId: string;
-    event: AgentHostTaskEvent;
-};
-export declare function isToolMethod(method: string): boolean;
-/** Validate params of a `tool.*` request from the host. Returns normalized args. */
-export declare function decodeToolParams(method: string, params: unknown): {
-    taskId: string;
-    args: Record<string, unknown>;
-};

package/dist/agent/protocol.js

@@ -1,195 +0,0 @@
-/**
- * frely.agent-host.v1 — wire contract between the CLI (supervisor) and the
- * Pi Node agent host. See docs/agent-host.md for the public description.
- */
-import { randomBytes } from "node:crypto";
-export const AGENT_HOST_PROTOCOL = "frely.agent-host.v1";
-export const AGENT_HOST_PROTOCOL_VERSION = 1;
-export const AGENT_HOST_MAX_FRAME_BYTES = 1024 * 1024;
-export const AGENT_HOST_CONNECTION_KEY_ENV = "FRELY_AGENT_HOST_KEY";
-export class AgentHostProtocolError extends Error {
-    code;
-    constructor(code) {
-        super(code);
-        this.code = code;
-        this.name = "AgentHostProtocolError";
-    }
-}
-export function newConnectionKey() {
-    return randomBytes(32).toString("base64url");
-}
-export function isValidTaskId(id) {
-    return /^at_[a-z0-9]{24}$/u.test(id);
-}
-export function newTaskId() {
-    return `at_${randomBytes(12).toString("hex")}`;
-}
-/** Encode one NDJSON frame. */
-export function encodeAgentHostFrame(message) {
-    const line = JSON.stringify(message);
-    if (Buffer.byteLength(line) > AGENT_HOST_MAX_FRAME_BYTES)
-        throw new AgentHostProtocolError("frame_too_large");
-    return `${line}\n`;
-}
-/** Decode one NDJSON frame (without the trailing newline). */
-export function decodeAgentHostFrame(line) {
-    if (Buffer.byteLength(line) > AGENT_HOST_MAX_FRAME_BYTES)
-        throw new AgentHostProtocolError("frame_too_large");
-    let value;
-    try {
-        value = JSON.parse(Buffer.isBuffer(line) ? line.toString("utf8") : line);
-    }
-    catch {
-        throw new AgentHostProtocolError("frame_invalid");
-    }
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        throw new AgentHostProtocolError("frame_invalid");
-    const record = value;
-    if (record.jsonrpc !== "2.0")
-        throw new AgentHostProtocolError("frame_invalid");
-    if ("method" in record) {
-        if (typeof record.method !== "string" || record.method.length === 0)
-            throw new AgentHostProtocolError("frame_invalid");
-        if ("id" in record && record.id !== null && typeof record.id !== "number" && typeof record.id !== "string") {
-            throw new AgentHostProtocolError("frame_invalid");
-        }
-        if ("params" in record && record.params !== undefined && (typeof record.params !== "object" || record.params === null)) {
-            throw new AgentHostProtocolError("frame_invalid");
-        }
-        return value;
-    }
-    if (typeof record.id !== "number" && typeof record.id !== "string")
-        throw new AgentHostProtocolError("frame_invalid");
-    if (!("result" in record) && !("error" in record))
-        throw new AgentHostProtocolError("frame_invalid");
-    if ("error" in record && record.error !== undefined) {
-        const error = record.error;
-        if (!error || typeof error !== "object" || typeof error.code !== "number" || typeof error.message !== "string") {
-            throw new AgentHostProtocolError("frame_invalid");
-        }
-    }
-    return value;
-}
-/** Validate and normalize a `task.event` notification params object. */
-export function decodeTaskEvent(params) {
-    if (!params || typeof params !== "object")
-        throw new AgentHostProtocolError("frame_invalid");
-    const record = params;
-    if (typeof record.taskId !== "string" || !isValidTaskId(record.taskId))
-        throw new AgentHostProtocolError("frame_invalid");
-    const event = record.event;
-    if (!event || typeof event !== "object")
-        throw new AgentHostProtocolError("frame_invalid");
-    const item = event;
-    switch (item.type) {
-        case "status":
-            if (item.status !== "running" && item.status !== "waiting_input" && item.status !== "completed" && item.status !== "failed" && item.status !== "cancelled") {
-                throw new AgentHostProtocolError("frame_invalid");
-            }
-            if (item.detail !== undefined && typeof item.detail !== "string")
-                throw new AgentHostProtocolError("frame_invalid");
-            return { taskId: record.taskId, event: item };
-        case "message":
-            if (item.role !== "assistant" && item.role !== "user" && item.role !== "system")
-                throw new AgentHostProtocolError("frame_invalid");
-            if (typeof item.text !== "string" || item.text.length > 64 * 1024)
-                throw new AgentHostProtocolError("frame_invalid");
-            if (item.partial !== undefined && typeof item.partial !== "boolean")
-                throw new AgentHostProtocolError("frame_invalid");
-            return { taskId: record.taskId, event: item };
-        case "tool_call":
-            if (typeof item.tool !== "string" || typeof item.summary !== "string" || item.summary.length > 2048)
-                throw new AgentHostProtocolError("frame_invalid");
-            if (item.state !== "started" && item.state !== "finished" && item.state !== "failed")
-                throw new AgentHostProtocolError("frame_invalid");
-            return { taskId: record.taskId, event: item };
-        case "usage": {
-            for (const key of ["inputTokens", "outputTokens", "costUsd"]) {
-                const value = item[key];
-                if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
-                    throw new AgentHostProtocolError("frame_invalid");
-            }
-            return { taskId: record.taskId, event: item };
-        }
-        case "log":
-            if (typeof item.text !== "string" || item.text.length > 4096)
-                throw new AgentHostProtocolError("frame_invalid");
-            return { taskId: record.taskId, event: item };
-        default:
-            throw new AgentHostProtocolError("frame_invalid");
-    }
-}
-const TOOL_METHODS = new Set(["tool.read", "tool.write", "tool.edit", "tool.bash", "tool.grep", "tool.find", "tool.ls"]);
-export function isToolMethod(method) {
-    return TOOL_METHODS.has(method);
-}
-/** Validate params of a `tool.*` request from the host. Returns normalized args. */
-export function decodeToolParams(method, params) {
-    if (!params || typeof params !== "object")
-        throw new AgentHostProtocolError("frame_invalid");
-    const record = params;
-    if (typeof record.taskId !== "string" || !isValidTaskId(record.taskId))
-        throw new AgentHostProtocolError("frame_invalid");
-    const { taskId, ...args } = record;
-    switch (method) {
-        case "tool.read":
-            requireString(args, "path");
-            break;
-        case "tool.write":
-            requireString(args, "path");
-            if (typeof args.content !== "string")
-                throw new AgentHostProtocolError("frame_invalid");
-            optionalBoolean(args, "overwrite");
-            break;
-        case "tool.edit":
-            requireString(args, "path");
-            if (!Array.isArray(args.edits) || args.edits.length === 0)
-                throw new AgentHostProtocolError("frame_invalid");
-            break;
-        case "tool.bash":
-            requireString(args, "command");
-            optionalString(args, "cwd");
-            if (args.timeoutMs !== undefined && (typeof args.timeoutMs !== "number" || !Number.isSafeInteger(args.timeoutMs) || args.timeoutMs < 100 || args.timeoutMs > 120_000)) {
-                throw new AgentHostProtocolError("frame_invalid");
-            }
-            break;
-        case "tool.grep":
-            requireString(args, "query");
-            optionalString(args, "path");
-            optionalBoolean(args, "regex");
-            optionalBoolean(args, "caseSensitive");
-            optionalInteger(args, "maxResults", 1, 200);
-            optionalInteger(args, "contextLines", 0, 5);
-            break;
-        case "tool.find":
-            requireString(args, "pattern");
-            optionalString(args, "path");
-            optionalInteger(args, "maxResults", 1, 500);
-            break;
-        case "tool.ls":
-            optionalString(args, "path");
-            break;
-        default:
-            throw new AgentHostProtocolError("frame_invalid");
-    }
-    return { taskId, args };
-}
-function requireString(args, key) {
-    if (typeof args[key] !== "string" || args[key].length === 0)
-        throw new AgentHostProtocolError("frame_invalid");
-}
-function optionalString(args, key) {
-    if (args[key] !== undefined && typeof args[key] !== "string")
-        throw new AgentHostProtocolError("frame_invalid");
-}
-function optionalBoolean(args, key) {
-    if (args[key] !== undefined && typeof args[key] !== "boolean")
-        throw new AgentHostProtocolError("frame_invalid");
-}
-function optionalInteger(args, key, min, max) {
-    const value = args[key];
-    if (value !== undefined && (typeof value !== "number" || !Number.isSafeInteger(value) || value < min || value > max)) {
-        throw new AgentHostProtocolError("frame_invalid");
-    }
-}
-//# sourceMappingURL=protocol.js.map