@codetreker/daynight 0.25.2 → 0.26.0

package/dist/commands/controller/local-client.js

@@ -0,0 +1,75 @@
+import { sessionBinding, sessionBindingKeys } from "../../session/protocol.js";
+import { randomUUID, timingSafeEqual } from "node:crypto";
+import { createConnection } from "node:net";
+export const validateControllerLocalRequest = (value, ticket) => {
+    if (typeof value !== "object" || value === null)
+        throw new Error("Invalid controller IPC request.");
+    const data = value;
+    if (Object.keys(data).sort().join() !== ["requestId", "executionId", ...sessionBindingKeys(ticket), "executionGeneration", "controllerInstanceId", "secret", "action"].sort().join() || typeof data.secret !== "string" || data.secret.length !== ticket.ipcSecret.length || !timingSafeEqual(Buffer.from(data.secret), Buffer.from(ticket.ipcSecret)) || data.executionId !== ticket.executionId || data.claimId !== ticket.claimId || data.testExecutionId !== ticket.testExecutionId || data.executionGeneration !== ticket.executionGeneration || data.controllerInstanceId !== ticket.controllerInstanceId || typeof data.requestId !== "string" || !/^[a-f0-9-]{36}$/.test(data.requestId))
+        throw new Error("Controller IPC authentication or identity mismatch.");
+    const action = data.action;
+    if (typeof action !== "object" || action === null || !["observe", "submit_initial", "cleanup", "stop"].includes(String(action.kind)))
+        throw new Error("Unsupported controller IPC action.");
+    const keys = action.kind === "observe" ? ["kind"] : action.kind === "submit_initial" ? ["kind", "operationId"] : action.kind === "stop" ? ["kind", "deadline"] : ["kind", "operationId", "prompt", "deadline"];
+    if (Object.keys(action).sort().join() !== keys.sort().join())
+        throw new Error("Controller IPC action has invalid fields.");
+    if (action.kind === "submit_initial" && (ticket.initialInput === "none" || action.operationId !== ticket.initialOperationId))
+        throw new Error("Controller initial operation identity mismatch.");
+    if ((action.kind === "cleanup" || action.kind === "submit_initial") && (typeof action.operationId !== "string" || !/^[a-f0-9-]{36}$/.test(action.operationId)))
+        throw new Error("Controller operation identity is invalid.");
+    if (action.kind === "cleanup" && (typeof action.prompt !== "string" || action.prompt.trim() === "" || Buffer.byteLength(action.prompt) > 4 * 1024 * 1024))
+        throw new Error("Controller cleanup prompt is invalid.");
+    if ((action.kind === "stop" || action.kind === "cleanup") && (typeof action.deadline !== "number" || !Number.isSafeInteger(action.deadline) || action.deadline < 0))
+        throw new Error("Controller deadline is invalid.");
+    return value;
+};
+// A missing transport response cannot establish whether an authenticated action
+// reached the controller. Callers may observe its journal, but must not replay it.
+export class ControllerIpcOutcomeUnknownError extends Error {
+}
+export const requestController = (ticket, action, options = {}) => new Promise((resolve, reject) => {
+    const request = { requestId: randomUUID(), executionId: ticket.executionId, ...sessionBinding(ticket), executionGeneration: ticket.executionGeneration, controllerInstanceId: ticket.controllerInstanceId, secret: ticket.ipcSecret, action };
+    validateControllerLocalRequest(request, ticket);
+    const socket = createConnection(ticket.ipcEndpoint);
+    let text = "";
+    let settled = false;
+    const finish = (error, result) => { if (settled)
+        return; settled = true; clearTimeout(timer); options.signal?.removeEventListener("abort", cancel); socket.destroy(); if (error !== undefined)
+        reject(error);
+    else
+        resolve(result); };
+    const cancel = () => finish(options.signal?.reason ?? new Error("Controller IPC cancelled."));
+    const timer = setTimeout(() => finish(new ControllerIpcOutcomeUnknownError("Controller IPC outcome is unknown after its deadline.")), options.timeoutMs ?? 10000);
+    socket.setEncoding("utf8");
+    socket.once("error", cause => finish(new ControllerIpcOutcomeUnknownError("Controller IPC transport failed; outcome is unknown.", { cause })));
+    socket.once("end", () => { if (!settled)
+        finish(new ControllerIpcOutcomeUnknownError("Controller IPC closed before its response; outcome is unknown.")); });
+    socket.once("connect", () => socket.write(`${JSON.stringify(request)}\n`));
+    socket.on("data", (chunk) => {
+        text += chunk;
+        if (Buffer.byteLength(text) > 8 * 1024 * 1024) {
+            finish(new Error("Controller IPC response exceeds its limit."));
+            return;
+        }
+        const newline = text.indexOf("\n");
+        if (newline < 0)
+            return;
+        try {
+            const response = JSON.parse(text.slice(0, newline));
+            if (response.requestId !== request.requestId || (response.ok !== true && response.ok !== false))
+                throw new Error("Controller IPC response identity mismatch.");
+            if (!response.ok)
+                throw new Error(response.error);
+            if (response.snapshot.executionId !== ticket.executionId || response.snapshot.claimId !== ticket.claimId || response.snapshot.testExecutionId !== ticket.testExecutionId || response.snapshot.executionGeneration !== ticket.executionGeneration || response.snapshot.controllerInstanceId !== ticket.controllerInstanceId)
+                throw new Error("Controller IPC snapshot fence mismatch.");
+            finish(undefined, response);
+        }
+        catch (error) {
+            finish(error);
+        }
+    });
+    options.signal?.addEventListener("abort", cancel, { once: true });
+    if (options.signal?.aborted)
+        cancel();
+});
+//# sourceMappingURL=local-client.js.map

package/dist/commands/controller/local-client.js.map

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

package/dist/commands/controller/local-content.d.ts

@@ -0,0 +1,23 @@
+import type Database from "better-sqlite3";
+import { type TimelineEntry, type SessionResource } from "../../session/protocol.js";
+import type { TimelinePage } from "../../session/controller-protocol.js";
+export type LocalTimelineQuery = {
+    historyEpoch: string;
+    direction: "tail" | "before" | "after";
+    cursor: string | null;
+    limit: number;
+};
+export declare const createLocalSessionContent: (db: Database.Database, sessionId: string) => {
+    readTimeline(query: LocalTimelineQuery): Omit<TimelinePage, "sessionId" | "lastEventSeq"> & {
+        kind: "timeline";
+    };
+    pendingInteractions(): TimelineEntry[];
+    saveResource(resource: SessionResource, content?: Uint8Array): void;
+    readResource(resourceId: string, offset: string, limit: number): {
+        kind: "resource";
+        resource: SessionResource;
+        offset: string;
+        data: string;
+        eof: boolean;
+    };
+};

package/dist/commands/controller/local-content.js

@@ -0,0 +1,103 @@
+import { sessionDisplayEntry, sessionWireBytes } from "./wire-display.js";
+import { createHash } from "node:crypto";
+import { parseTimelineEntry, parseSessionResource } from "../../session/protocol.js";
+const sequence = (value) => {
+    if (!/^(0|[1-9][0-9]{0,18})$/.test(value) || BigInt(value) > 9223372036854775807n)
+        throw new Error("Invalid local content sequence.");
+    return BigInt(value);
+};
+export const createLocalSessionContent = (db, sessionId) => {
+    const resourcesFor = (items) => {
+        const ids = new Set();
+        for (const item of items) {
+            const parts = item.kind === "tool_call" ? item.output : item.kind === "user_message" || item.kind === "assistant_message" ? item.content : [];
+            for (const part of parts)
+                if (part.type === "resource")
+                    ids.add(part.resourceId);
+        }
+        return [...ids].flatMap(id => {
+            const row = db.prepare("SELECT descriptor FROM resources WHERE id=?").get(id);
+            return row ? [parseSessionResource(JSON.parse(row.descriptor))] : [];
+        });
+    };
+    return {
+        readTimeline(query) {
+            if (!Number.isSafeInteger(query.limit) || query.limit < 1 || query.limit > 200 || !["tail", "before", "after"].includes(query.direction))
+                throw new Error("Invalid local timeline page.");
+            let pivot = 0n;
+            if (query.direction === "tail") {
+                if (query.cursor !== null)
+                    throw new Error("Tail must not contain a cursor.");
+            }
+            else {
+                if (!query.cursor || query.cursor.length > 256 || !/^[A-Za-z0-9_-]+$/.test(query.cursor))
+                    throw new Error("Invalid local timeline cursor.");
+                try {
+                    const values = JSON.parse(Buffer.from(query.cursor, "base64url").toString("utf8"));
+                    if (!Array.isArray(values) || values.length !== 3 || values[0] !== sessionId || values[1] !== query.historyEpoch || typeof values[2] !== "string")
+                        throw new Error();
+                    pivot = sequence(values[2]);
+                }
+                catch {
+                    throw new Error("Invalid local timeline cursor.");
+                }
+            }
+            const where = query.direction === "tail" ? "" : query.direction === "before" ? "WHERE rowid < ?" : "WHERE rowid > ?";
+            const ascending = query.direction === "after";
+            const rows = db.prepare(`SELECT CAST(rowid AS TEXT) AS seq, value FROM projection ${where} ORDER BY rowid ${ascending ? "ASC" : "DESC"} LIMIT ?`).all(...(query.direction === "tail" ? [query.limit] : [pivot, query.limit]));
+            const items = [];
+            // Leave room for the envelope and resource descriptors in the WS frame.
+            let bytes = 1024;
+            for (const row of rows) {
+                const entry = sessionDisplayEntry(parseTimelineEntry({ ...JSON.parse(row.value), entrySeq: row.seq }));
+                const size = sessionWireBytes(entry) + sessionWireBytes(resourcesFor([entry]));
+                if (bytes + size > 1_500_000) {
+                    if (!items.length)
+                        throw new Error("Local timeline entry exceeds the relay frame limit.");
+                    break;
+                }
+                items.push(entry);
+                bytes += size;
+            }
+            if (!ascending)
+                items.reverse();
+            const first = items[0]?.entrySeq, last = items.at(-1)?.entrySeq;
+            const cursor = (seq) => seq === undefined ? null : Buffer.from(JSON.stringify([sessionId, query.historyEpoch, seq])).toString("base64url");
+            const hasBefore = first !== undefined && db.prepare("SELECT 1 FROM projection WHERE rowid < ? LIMIT 1").get(sequence(first)) !== undefined;
+            const hasAfter = last !== undefined && db.prepare("SELECT 1 FROM projection WHERE rowid > ? LIMIT 1").get(sequence(last)) !== undefined;
+            return { kind: "timeline", historyEpoch: query.historyEpoch, items, resources: resourcesFor(items), beforeCursor: cursor(first), afterCursor: cursor(last), hasMoreBefore: hasBefore, hasMoreAfter: hasAfter };
+        },
+        pendingInteractions() {
+            const rows = db.prepare("SELECT CAST(rowid AS TEXT) AS seq,value FROM projection WHERE json_extract(value,'$.kind')='interaction' AND json_extract(value,'$.interaction.state')='pending' ORDER BY rowid LIMIT 101").all();
+            if (rows.length > 100)
+                throw new Error("Too many pending native interactions to synchronize safely.");
+            return rows.map(row => parseTimelineEntry({ ...JSON.parse(row.value), entrySeq: row.seq }));
+        },
+        saveResource(resource, content) {
+            parseSessionResource(resource);
+            if (content && (content.byteLength > 8_388_608 || String(content.byteLength) !== resource.byteLength || createHash("sha256").update(content).digest("hex") !== resource.sha256))
+                throw new Error("Local session resource content does not match its descriptor.");
+            const previous = db.prepare("SELECT descriptor FROM resources WHERE id=?").get(resource.resourceId);
+            if (previous) {
+                const old = parseSessionResource(JSON.parse(previous.descriptor));
+                if (old.status === "available" && JSON.stringify(old) !== JSON.stringify(resource))
+                    throw new Error("An available local resource cannot change identity.");
+            }
+            db.prepare("INSERT INTO resources(id,descriptor,content) VALUES(?,?,?) ON CONFLICT(id) DO UPDATE SET descriptor=excluded.descriptor,content=COALESCE(excluded.content,resources.content)").run(resource.resourceId, JSON.stringify(resource), content ? Buffer.from(content) : null);
+        },
+        readResource(resourceId, offset, limit) {
+            const position = sequence(offset);
+            if (!Number.isSafeInteger(limit) || limit < 1 || limit > 524288)
+                throw new Error("Invalid local resource chunk limit.");
+            const row = db.prepare("SELECT descriptor,content FROM resources WHERE id=?").get(resourceId);
+            if (!row?.content)
+                throw new Error("Local session resource is unavailable.");
+            const resource = parseSessionResource(JSON.parse(row.descriptor));
+            if (resource.status !== "available" || position > BigInt(row.content.length))
+                throw new Error("Local session resource is unavailable.");
+            const end = Math.min(Number(position) + limit, row.content.length);
+            return { kind: "resource", resource, offset, data: row.content.subarray(Number(position), end).toString("base64"), eof: end === row.content.length };
+        },
+    };
+};
+//# sourceMappingURL=local-content.js.map

package/dist/commands/controller/local-content.js.map

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

package/dist/commands/controller/process-proof.d.ts

@@ -0,0 +1,13 @@
+export type ProcessProof = {
+    readonly pid: number;
+    readonly parentPid: number;
+    readonly processGroupId: number | null;
+    readonly startedAt: string;
+    readonly commandHash: string;
+    readonly jobObjectName?: string;
+};
+export declare const captureProcessProof: (pid: number) => Promise<ProcessProof>;
+export declare const captureControllerProcessProof: (launchId: string) => Promise<ProcessProof>;
+export declare const inspectProcessProof: (proof: ProcessProof) => Promise<"running" | "stopped" | "replaced">;
+export declare const confirmControllerProcessesStopped: (controller: ProcessProof, native: readonly ProcessProof[]) => Promise<boolean>;
+export declare const stopControllerProcesses: (controller: ProcessProof, native: readonly ProcessProof[], deadline: number) => Promise<void>;

package/dist/commands/controller/process-proof.js

@@ -0,0 +1,121 @@
+import { createControllerJob, inspectControllerJob } from "./windows-job.js";
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+// ps localizes lstart, so identity probes need a stable locale. Keep the
+// Controller and native provider environments unchanged.
+const run = (file, args) => new Promise((resolve, reject) => execFile(file, args, { encoding: "utf8", timeout: 5000, maxBuffer: 8 * 1024 * 1024, windowsHide: true, ...(file === "ps" ? { env: { ...process.env, LC_ALL: "C" } } : {}) }, (error, stdout) => error === null ? resolve(stdout) : reject(error)));
+const hash = (value) => createHash("sha256").update(value).digest("hex");
+const validPid = (pid) => { if (!Number.isSafeInteger(pid) || pid <= 0 || pid > 2_147_483_647)
+    throw new Error("Invalid process identity."); };
+export const captureProcessProof = async (pid) => {
+    validPid(pid);
+    if (process.platform === "win32") {
+        const output = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", `Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}' | Select-Object ProcessId,ParentProcessId,@{Name='Birth';Expression={$_.CreationDate.ToUniversalTime().ToString('o')}},CommandLine | ConvertTo-Json -Compress`]);
+        const value = JSON.parse(output);
+        if (value.ProcessId !== pid || typeof value.Birth !== "string" || typeof value.CommandLine !== "string")
+            throw new Error("Process identity cannot be established.");
+        return { pid, parentPid: value.ParentProcessId, processGroupId: null, startedAt: value.Birth, commandHash: hash(value.CommandLine) };
+    }
+    const output = await run("ps", ["-p", String(pid), "-o", "pid=", "-o", "ppid=", "-o", "pgid=", "-o", "lstart=", "-o", "command="]);
+    const match = /^\s*(\d+)\s+(\d+)\s+(\d+)\s+(\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+)\s+([^\n]+)\s*$/u.exec(output);
+    if (match === null || Number(match[1]) !== pid)
+        throw new Error("Process identity cannot be established.");
+    return { pid, parentPid: Number(match[2]), processGroupId: Number(match[3]), startedAt: match[4].replace(/\s+/g, " "), commandHash: hash(match[5].trim()) };
+};
+export const captureControllerProcessProof = async (launchId) => {
+    const proof = await captureProcessProof(process.pid);
+    return process.platform === "win32" ? { ...proof, jobObjectName: await createControllerJob(launchId, process.pid) } : proof;
+};
+export const inspectProcessProof = async (proof) => {
+    validPid(proof.pid);
+    try {
+        process.kill(proof.pid, 0);
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ESRCH")
+            return "stopped";
+        throw new Error("Process liveness could not be established.", { cause: error });
+    }
+    let current;
+    try {
+        current = await captureProcessProof(proof.pid);
+    }
+    catch (error) {
+        try {
+            process.kill(proof.pid, 0);
+        }
+        catch (missing) {
+            if (missing instanceof Error && "code" in missing && missing.code === "ESRCH")
+                return "stopped";
+        }
+        throw error;
+    }
+    return current.startedAt === proof.startedAt && current.commandHash === proof.commandHash && current.processGroupId === proof.processGroupId ? "running" : "replaced";
+};
+const groupMembers = async (group) => {
+    const rows = await run("ps", ["-A", "-o", "pid=", "-o", "pgid=", "-o", "stat="]);
+    const result = [];
+    for (const row of rows.split("\n")) {
+        if (row.trim() === "")
+            continue;
+        const match = /^\s*(\d+)\s+(\d+)\s+(\S+)\s*$/.exec(row);
+        if (match === null)
+            throw new Error("Cannot interpret process group inventory.");
+        if (Number(match[2]) === group && !match[3].startsWith("Z"))
+            result.push(Number(match[1]));
+    }
+    return result;
+};
+export const confirmControllerProcessesStopped = async (controller, native) => {
+    for (const proof of [controller, ...native])
+        if (await inspectProcessProof(proof) === "running")
+            return false;
+    if (process.platform === "win32") {
+        if (controller.jobObjectName === undefined)
+            throw new Error("The original Windows controller has no Job Object boundary; its descendants cannot be inferred stopped.");
+        return (await inspectControllerJob(controller.jobObjectName)).length === 0;
+    }
+    if (controller.processGroupId !== controller.pid)
+        throw new Error("Controller was not launched in its own process group.");
+    return (await groupMembers(controller.pid)).length === 0;
+};
+export const stopControllerProcesses = async (controller, native, deadline) => {
+    if (process.platform === "win32") {
+        if (controller.jobObjectName === undefined)
+            throw new Error("The original Windows controller has no Job Object boundary; cleanup retains its unknown descendants.");
+        await inspectControllerJob(controller.jobObjectName, true);
+        while (Date.now() < deadline && (await inspectControllerJob(controller.jobObjectName)).length > 0)
+            await new Promise(resolve => setTimeout(resolve, 25));
+        if (!await confirmControllerProcessesStopped(controller, native))
+            throw new Error("The original Windows Job Object did not stop completely.");
+        return;
+    }
+    if (controller.processGroupId !== controller.pid)
+        throw new Error("Refusing a process group not owned by the original controller.");
+    if ((await groupMembers(controller.pid)).length === 0)
+        return;
+    let attributable = false;
+    for (const proof of [controller, ...native])
+        if (proof.processGroupId === controller.pid && await inspectProcessProof(proof) === "running")
+            attributable = true;
+    if (!attributable)
+        throw new Error("The remaining process group has no original process-instance proof; resources are retained.");
+    const signal = (value) => { try {
+        process.kill(-controller.pid, value);
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ESRCH"))
+            throw error;
+    } };
+    signal("SIGTERM");
+    const graceful = Math.min(deadline, Date.now() + 2000);
+    while (Date.now() < graceful && (await groupMembers(controller.pid)).length > 0)
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    if ((await groupMembers(controller.pid)).length > 0)
+        signal("SIGKILL");
+    while (Date.now() < deadline && (await groupMembers(controller.pid)).length > 0)
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    if ((await groupMembers(controller.pid)).length > 0)
+        throw new Error("Original controller process group did not stop by its deadline.");
+};
+//# sourceMappingURL=process-proof.js.map

package/dist/commands/controller/process-proof.js.map

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

package/dist/commands/controller/providers/claude.d.ts

@@ -0,0 +1,2 @@
+import type { NativeProvider, ProviderOptions } from "./types.js";
+export declare const openClaudeProvider: (options: ProviderOptions) => Promise<NativeProvider>;