@acpus/runtime 0.8.0 → 0.9.0-alpha.1

package/dist/daemon/sessions.d.ts

@@ -0,0 +1,23 @@
+import { type RuntimeAdvanceResult } from "../runs/advance-runtime.js";
+import type { RuntimeMutationResult } from "../runs/use-cases.js";
+import type { HookRunner } from "../hooks/runner.js";
+import type { RunDetails, RuntimeStore } from "../store/store.js";
+import { type DaemonControlIntent } from "./socket.js";
+export declare class RunExecutionSessions {
+    private readonly cwd;
+    private readonly store;
+    private readonly hookRunner?;
+    private readonly sessions;
+    constructor(cwd: string, store: RuntimeStore, hookRunner?: HookRunner | undefined);
+    activeCount(): number;
+    hookActiveCount(): number;
+    drainHooks(): Promise<void>;
+    start(runId: string): RunDetails;
+    observe(runId: string): Promise<RuntimeAdvanceResult>;
+    control(intent: DaemonControlIntent): Promise<RuntimeMutationResult | undefined>;
+    private controlWithShortSession;
+    private fork;
+    private triggerHooks;
+    private run;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/daemon/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/daemon/sessions.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAChH,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAS3E,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAgB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAF5G,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEnC,GAAG,EAAE,MAAM,EAAmB,KAAK,EAAE,YAAY,EAAmB,UAAU,CAAC,EAAE,UAAU,YAAA;IAExH,WAAW,IAAI,MAAM;IAIrB,eAAe,IAAI,MAAM;IAInB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAW1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOrD,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;YAmBxE,uBAAuB;YAsBvB,IAAI;IAQlB,OAAO,CAAC,YAAY;YAUN,GAAG;CAwBlB"}

package/dist/daemon/sessions.js

@@ -0,0 +1,190 @@
+import { advanceRuntimeRun, runtimeAdvanceResult } from "../runs/advance-runtime.js";
+import { applySchedulerControlIntentWithOwnerEpoch } from "../scheduler/control.js";
+import { triggerHooksForCommittedRowsForRun } from "../scheduler/runtime-runner.js";
+import { DaemonRequestError } from "./socket.js";
+export class RunExecutionSessions {
+    cwd;
+    store;
+    hookRunner;
+    sessions = new Map();
+    constructor(cwd, store, hookRunner) {
+        this.cwd = cwd;
+        this.store = store;
+        this.hookRunner = hookRunner;
+    }
+    activeCount() {
+        return this.sessions.size;
+    }
+    hookActiveCount() {
+        return this.hookRunner?.activeCount() ?? 0;
+    }
+    async drainHooks() {
+        await this.hookRunner?.drain();
+    }
+    start(runId) {
+        const existing = this.store.getRun(runId);
+        if (!existing)
+            throw new DaemonRequestError("RUN_NOT_FOUND", `Run '${runId}' was not found.`);
+        if (!this.sessions.has(runId) && !isTerminal(existing.status)) {
+            const session = createSession();
+            this.sessions.set(runId, session);
+            session.promise = this.run(runId);
+        }
+        return existing;
+    }
+    async observe(runId) {
+        const run = this.start(runId);
+        const session = this.sessions.get(runId);
+        if (!session?.promise)
+            return runtimeAdvanceResult(this.store, runId, { status: terminalSummaryStatus(run.status) ?? "idle", runId, started: 0, completed: 0, failed: 0, cancelled: 0, active: 0 });
+        return session.promise;
+    }
+    async control(intent) {
+        const session = this.sessions.get(intent.runId);
+        if (!session)
+            return this.controlWithShortSession(intent);
+        if (intent.type === "fork")
+            return await this.fork(intent);
+        if (!session.ownerEpoch) {
+            await Promise.race([waitForOwnerEpoch(session), session.promise]);
+            if (!session.ownerEpoch)
+                return undefined;
+        }
+        const eventCursor = this.store.getLastRunEventSequence(intent.runId);
+        const result = applySchedulerControlIntentWithOwnerEpoch(this.store, controlIntent(intent), session.ownerEpoch);
+        this.triggerHooks(intent.runId, eventCursor);
+        if (intent.type === "pause" || intent.type === "cancel") {
+            for (const controller of session.activeAttempts.values())
+                controller.abort();
+        }
+        const run = this.store.getRun(result.runId);
+        if (!run)
+            throw new DaemonRequestError("RUN_NOT_FOUND", `Run '${result.runId}' was not found.`);
+        return { run };
+    }
+    async controlWithShortSession(intent) {
+        const existing = this.store.getRun(intent.runId);
+        if (!existing)
+            throw new DaemonRequestError("RUN_NOT_FOUND", `Run '${intent.runId}' was not found.`);
+        const claim = this.store.scheduler.claimRun(intent.runId, `daemon:${process.pid}:${intent.runId}:control`, 30_000);
+        if (!claim)
+            throw new DaemonRequestError("CONTROL_CONFLICT", `Run '${intent.runId}' is currently controlled by another owner.`);
+        const session = createSession();
+        session.ownerEpoch = claim.ownerEpoch;
+        this.sessions.set(intent.runId, session);
+        try {
+            if (intent.type === "fork")
+                return await this.fork(intent);
+            const eventCursor = this.store.getLastRunEventSequence(intent.runId);
+            const result = applySchedulerControlIntentWithOwnerEpoch(this.store, controlIntent(intent), claim.ownerEpoch);
+            this.triggerHooks(intent.runId, eventCursor);
+            const run = this.store.getRun(result.runId);
+            if (!run)
+                throw new DaemonRequestError("RUN_NOT_FOUND", `Run '${result.runId}' was not found.`);
+            return { run };
+        }
+        finally {
+            this.store.scheduler.releaseRun(claim);
+            if (this.sessions.get(intent.runId) === session)
+                this.sessions.delete(intent.runId);
+        }
+    }
+    async fork(intent) {
+        const fork = await this.store.forkRun(intent.runId, { ...(intent.input ?? {}), requestId: intent.requestId });
+        if (fork.forkCreated)
+            this.triggerHooks(fork.id, 0);
+        const run = this.store.getRun(intent.runId);
+        if (!run)
+            throw new DaemonRequestError("RUN_NOT_FOUND", `Run '${intent.runId}' was not found.`);
+        return { run, forkRunId: fork.id };
+    }
+    triggerHooks(runId, afterSequence) {
+        triggerHooksForCommittedRowsForRun({
+            cwd: this.cwd,
+            store: this.store,
+            runId,
+            ...(this.hookRunner === undefined ? {} : { hookRunner: this.hookRunner }),
+            afterSequence,
+        });
+    }
+    async run(runId) {
+        const session = this.sessions.get(runId);
+        try {
+            return await advanceRuntimeRun(this.cwd, this.store, runId, `daemon:${process.pid}:${runId}`, undefined, {
+                onClaim: claim => {
+                    if (claim.runId === runId && session) {
+                        session.ownerEpoch = claim.ownerEpoch;
+                        resolveOwnerEpochWaiters(session);
+                    }
+                },
+                onRelease: claim => {
+                    if (claim.runId === runId && session?.ownerEpoch === claim.ownerEpoch)
+                        delete session.ownerEpoch;
+                },
+                onActiveAttempt: attempt => {
+                    if (attempt.runId !== runId || !session)
+                        return undefined;
+                    return trackActiveAttempt(session, attempt);
+                },
+                ...(this.hookRunner === undefined ? {} : { hookRunner: this.hookRunner }),
+            });
+        }
+        finally {
+            if (session)
+                resolveOwnerEpochWaiters(session);
+            if (this.sessions.get(runId) === session)
+                this.sessions.delete(runId);
+        }
+    }
+}
+function createSession() {
+    return { ownerEpochWaiters: [], activeAttempts: new Map() };
+}
+function waitForOwnerEpoch(session) {
+    if (session.ownerEpoch)
+        return Promise.resolve();
+    return new Promise(resolve => session.ownerEpochWaiters.push(resolve));
+}
+function resolveOwnerEpochWaiters(session) {
+    const waiters = session.ownerEpochWaiters.splice(0);
+    for (const resolve of waiters)
+        resolve();
+}
+function trackActiveAttempt(session, attempt) {
+    session.activeAttempts.set(attempt.nodeKey, attempt.controller);
+    return () => {
+        if (session.activeAttempts.get(attempt.nodeKey) === attempt.controller)
+            session.activeAttempts.delete(attempt.nodeKey);
+    };
+}
+function controlIntent(intent) {
+    if (intent.type === "signal") {
+        return {
+            requestId: intent.requestId,
+            runId: intent.runId,
+            type: "signal",
+            node: intent.nodeId,
+            payload: intent.payload,
+            commandIdempotencyKey: intent.requestId,
+        };
+    }
+    const input = intent.input;
+    if (intent.type === "pause")
+        return { requestId: intent.requestId, runId: intent.runId, type: "pause" };
+    if (intent.type === "resume")
+        return { requestId: intent.requestId, runId: intent.runId, type: "resume" };
+    if (intent.type === "retry")
+        return { requestId: intent.requestId, runId: intent.runId, type: "retry", ...(input?.target ? { target: input.target } : {}) };
+    if (intent.type === "cancel")
+        return { requestId: intent.requestId, runId: intent.runId, type: "cancel", ...(input?.target ? { target: input.target } : {}) };
+    throw new Error(`Unsupported active control '${intent.type}'.`);
+}
+function isTerminal(status) {
+    return status === "completed" || status === "failed" || status === "canceled";
+}
+function terminalSummaryStatus(status) {
+    if (status === "completed" || status === "failed" || status === "canceled")
+        return status;
+    return undefined;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/daemon/sessions.js.map

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

package/dist/daemon/socket.d.ts

@@ -0,0 +1,82 @@
+import { type RuntimeAdvanceResult } from "../runs/advance-runtime.js";
+import { type RuntimeMutationAction, type RuntimeMutationInput, type RuntimeMutationResult } from "../runs/use-cases.js";
+import type { RunDetails } from "../store/store.js";
+export type DaemonStatus = {
+    status: "ok";
+    pid: number;
+    generation?: number;
+    protocolVersion: number;
+    packageVersion: string;
+};
+export type DaemonRequest = {
+    id?: string;
+    method: "status";
+} | {
+    id?: string;
+    method: "shutdown";
+} | {
+    id?: string;
+    method: "control";
+    control: DaemonControlIntent;
+} | {
+    id?: string;
+    method: "startRun" | "observeRun";
+    runId: string;
+};
+export type DaemonControlIntent = {
+    requestId: string;
+    type: Exclude<RuntimeMutationAction, "fork">;
+    runId: string;
+    input?: RuntimeMutationInput;
+} | {
+    requestId: string;
+    type: "fork";
+    runId: string;
+    input?: RuntimeMutationInput;
+} | {
+    requestId: string;
+    type: "signal";
+    runId: string;
+    nodeId: string;
+    payload: unknown;
+};
+export type DaemonResponse = {
+    id?: string;
+    ok: true;
+    outcome: "applied";
+    result: DaemonStatus | DaemonShutdownResult | RunDetails | RuntimeAdvanceResult | RuntimeMutationResult;
+} | {
+    id?: string;
+    ok: false;
+    outcome: "failed";
+    error: {
+        code: DaemonErrorCode;
+        message: string;
+    };
+};
+export type DaemonErrorCode = "INVALID_CONTROL" | "RUN_NOT_FOUND" | "RUN_TERMINAL" | "RUN_NOT_CONTROLLABLE" | "CONTROL_CONFLICT" | "EXECUTION_UNAVAILABLE" | "STORE_ERROR" | "INTERNAL_ERROR";
+export type DaemonShutdownResult = {
+    status: "shutdown";
+};
+export declare class DaemonRequestError extends Error {
+    readonly code: DaemonErrorCode;
+    constructor(code: DaemonErrorCode, message: string);
+}
+export type DaemonServerHandle = {
+    endpoint: string;
+    close(): Promise<void>;
+};
+export declare function daemonEndpoint(cwd: string): string;
+export declare function startDaemonServer(cwd: string, handlers: {
+    status(): DaemonStatus;
+    control(intent: DaemonControlIntent): Promise<RuntimeMutationResult>;
+    startRun(runId: string): Promise<RunDetails> | RunDetails;
+    observeRun(runId: string): Promise<RuntimeAdvanceResult>;
+    shutdown(): Promise<DaemonShutdownResult> | DaemonShutdownResult;
+}): Promise<DaemonServerHandle>;
+export declare function requestDaemonStatus(cwd: string): Promise<DaemonStatus>;
+export declare function requestDaemonControl(cwd: string, control: DaemonControlIntent): Promise<RuntimeMutationResult>;
+export declare function requestDaemonStartRun(cwd: string, runId: string): Promise<RunDetails>;
+export declare function requestDaemonObserveRun(cwd: string, runId: string): Promise<RuntimeAdvanceResult>;
+export declare function requestDaemonShutdown(cwd: string): Promise<DaemonShutdownResult>;
+//# sourceMappingURL=socket.d.ts.map

package/dist/daemon/socket.d.ts.map

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

package/dist/daemon/socket.js

@@ -0,0 +1,341 @@
+import { createHash } from "node:crypto";
+import { mkdir, open, rm } from "node:fs/promises";
+import { createServer, connect } from "node:net";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { openExistingRuntimeStore } from "../store/store.js";
+import {} from "../runs/advance-runtime.js";
+import { RuntimeUseCaseException } from "../runs/use-cases.js";
+export class DaemonRequestError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export function daemonEndpoint(cwd) {
+    const workspace = resolve(cwd);
+    const digest = createHash("sha256").update(workspace).digest("hex").slice(0, 24);
+    if (process.platform === "win32") {
+        return `\\\\.\\pipe\\acpus-daemon-${digest}`;
+    }
+    const workspaceEndpoint = join(workspace, ".acpus", ".local", "daemon.sock");
+    if (Buffer.byteLength(workspaceEndpoint) < 100)
+        return workspaceEndpoint;
+    if (process.platform === "linux")
+        return `\0acpus-daemon-${digest}`;
+    return join(tmpdir(), `acpus-daemon-${digest}.sock`);
+}
+export async function startDaemonServer(cwd, handlers) {
+    const endpoint = daemonEndpoint(cwd);
+    if (isFilesystemSocket(endpoint)) {
+        await mkdir(dirname(endpoint), { recursive: true });
+    }
+    const sockets = new Set();
+    const server = createServer({ allowHalfOpen: true }, socket => {
+        sockets.add(socket);
+        socket.once("close", () => sockets.delete(socket));
+        void handleSocket(socket, handlers);
+    });
+    try {
+        await listen(server, endpoint);
+    }
+    catch (error) {
+        if (!isFilesystemSocket(endpoint) || !isAddressInUse(error))
+            throw error;
+        await recoverStaleFilesystemSocket(cwd, endpoint, server, error);
+    }
+    return {
+        endpoint,
+        close: async () => {
+            for (const socket of sockets)
+                socket.destroy();
+            await new Promise((resolveClose, rejectClose) => {
+                server.close(error => {
+                    if (error)
+                        rejectClose(error);
+                    else
+                        resolveClose();
+                });
+            });
+            if (isFilesystemSocket(endpoint))
+                await rm(endpoint, { force: true });
+        },
+    };
+}
+async function recoverStaleFilesystemSocket(cwd, endpoint, server, originalError) {
+    const lock = await acquireStaleSocketLock(endpoint);
+    if (!lock)
+        throw originalError;
+    try {
+        if (await hasLiveDaemon(cwd))
+            throw originalError;
+        if (!await hasStaleDaemonEvidence(cwd))
+            throw originalError;
+        await rm(endpoint, { force: true });
+        try {
+            await listen(server, endpoint);
+        }
+        catch (retryError) {
+            if (isAddressInUse(retryError))
+                throw originalError;
+            throw retryError;
+        }
+    }
+    finally {
+        await lock.release();
+    }
+}
+async function acquireStaleSocketLock(endpoint) {
+    const lockPath = `${endpoint}.lock`;
+    try {
+        const file = await open(lockPath, "wx");
+        return {
+            release: async () => {
+                await file.close();
+                await rm(lockPath, { force: true });
+            },
+        };
+    }
+    catch (error) {
+        if (isFileExists(error))
+            return undefined;
+        throw error;
+    }
+}
+async function listen(server, endpoint) {
+    await new Promise((resolveListen, rejectListen) => {
+        server.once("error", rejectListen);
+        server.listen(endpoint, () => {
+            server.off("error", rejectListen);
+            resolveListen();
+        });
+    });
+}
+export async function requestDaemonStatus(cwd) {
+    const response = await requestDaemon(cwd, { method: "status" });
+    if (!response.ok)
+        throw new DaemonRequestError(response.error.code, response.error.message);
+    if (!isDaemonStatus(response.result))
+        throw new Error("Daemon returned an invalid status response.");
+    return response.result;
+}
+export async function requestDaemonControl(cwd, control) {
+    const response = await requestDaemon(cwd, { method: "control", control });
+    if (!response.ok)
+        throw new DaemonRequestError(response.error.code, response.error.message);
+    if (isDaemonStatus(response.result) || isDaemonShutdownResult(response.result) || isRunDetails(response.result) || isRuntimeAdvanceResult(response.result))
+        throw new Error("Daemon returned an invalid control response.");
+    return response.result;
+}
+export async function requestDaemonStartRun(cwd, runId) {
+    const response = await requestDaemon(cwd, { method: "startRun", runId });
+    if (!response.ok)
+        throw new DaemonRequestError(response.error.code, response.error.message);
+    if (isDaemonStatus(response.result) || isRuntimeAdvanceResult(response.result) || !isRunDetails(response.result))
+        throw new Error("Daemon returned an invalid startRun response.");
+    return response.result;
+}
+export async function requestDaemonObserveRun(cwd, runId) {
+    const response = await requestDaemon(cwd, { method: "observeRun", runId });
+    if (!response.ok)
+        throw new DaemonRequestError(response.error.code, response.error.message);
+    if (!isRuntimeAdvanceResult(response.result))
+        throw new Error("Daemon returned an invalid observeRun response.");
+    return response.result;
+}
+export async function requestDaemonShutdown(cwd) {
+    const response = await requestDaemon(cwd, { method: "shutdown" });
+    if (!response.ok)
+        throw new DaemonRequestError(response.error.code, response.error.message);
+    if (!isDaemonShutdownResult(response.result))
+        throw new Error("Daemon returned an invalid shutdown response.");
+    return response.result;
+}
+async function requestDaemon(cwd, request) {
+    const endpoint = daemonEndpoint(cwd);
+    return new Promise((resolveRequest, rejectRequest) => {
+        const socket = connect(endpoint);
+        const chunks = [];
+        const timeoutMs = request.method === "observeRun" ? undefined : request.method === "control" ? 30_000 : 1_000;
+        const timeout = timeoutMs === undefined ? undefined : setTimeout(() => {
+            socket.destroy();
+            rejectRequest(new DaemonRequestError("EXECUTION_UNAVAILABLE", `Timed out waiting for daemon ${describeRequest(request)} response.`));
+        }, timeoutMs);
+        socket.once("error", error => {
+            if (timeout)
+                clearTimeout(timeout);
+            rejectRequest(error);
+        });
+        socket.on("data", chunk => chunks.push(Buffer.from(chunk)));
+        socket.once("end", () => {
+            if (timeout)
+                clearTimeout(timeout);
+            try {
+                resolveRequest(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+            }
+            catch (error) {
+                rejectRequest(error);
+            }
+        });
+        socket.once("connect", () => {
+            socket.end(JSON.stringify(request));
+        });
+    });
+}
+async function handleSocket(socket, handlers) {
+    const chunks = [];
+    socket.setTimeout(5_000, () => socket.destroy());
+    socket.on("data", chunk => chunks.push(Buffer.from(chunk)));
+    socket.once("end", () => {
+        socket.setTimeout(0);
+        void (async () => {
+            const request = parseRequest(Buffer.concat(chunks).toString("utf8"));
+            const response = request.ok ? await dispatchRequest(request.value, handlers) : request.response;
+            socket.end(JSON.stringify(response));
+        })();
+    });
+}
+function parseRequest(raw) {
+    try {
+        const value = JSON.parse(raw);
+        if (value.method !== "status") {
+            if (value.method === "shutdown")
+                return { ok: true, value: { ...(value.id === undefined ? {} : { id: value.id }), method: value.method } };
+            if (value.method === "startRun" || value.method === "observeRun") {
+                if (typeof value.runId !== "string")
+                    return { ok: false, response: failedResponse(value.id, "INVALID_CONTROL", "Invalid daemon run request.") };
+                return { ok: true, value: { ...(value.id === undefined ? {} : { id: value.id }), method: value.method, runId: value.runId } };
+            }
+            if (value.method !== "control" || !isControlIntent(value.control)) {
+                return { ok: false, response: failedResponse(value.id, "INVALID_CONTROL", "Unsupported daemon method.") };
+            }
+            return { ok: true, value: { ...(value.id === undefined ? {} : { id: value.id }), method: "control", control: value.control } };
+        }
+        return { ok: true, value: { ...(value.id === undefined ? {} : { id: value.id }), method: value.method } };
+    }
+    catch {
+        return { ok: false, response: failedResponse(undefined, "INVALID_CONTROL", "Invalid daemon request JSON.") };
+    }
+}
+async function dispatchRequest(request, handlers) {
+    try {
+        if (request.method === "control")
+            return appliedResponse(request.id, await handlers.control(request.control));
+        if (request.method === "startRun")
+            return appliedResponse(request.id, await handlers.startRun(request.runId));
+        if (request.method === "observeRun")
+            return appliedResponse(request.id, await handlers.observeRun(request.runId));
+        if (request.method === "shutdown")
+            return appliedResponse(request.id, await handlers.shutdown());
+        return appliedResponse(request.id, handlers.status());
+    }
+    catch (error) {
+        return failedResponse(request.id, request.method === "status" ? "INTERNAL_ERROR" : daemonControlErrorCode(error), error instanceof Error ? error.message : String(error));
+    }
+}
+function responseId(id) {
+    return id === undefined ? {} : { id };
+}
+function appliedResponse(id, result) {
+    return { ...responseId(id), ok: true, outcome: "applied", result };
+}
+function failedResponse(id, code, message) {
+    return { ...responseId(id), ok: false, outcome: "failed", error: { code, message } };
+}
+function describeRequest(request) {
+    if (request.method === "control")
+        return `${request.control.type} control for run '${request.control.runId}'`;
+    if (request.method === "startRun" || request.method === "observeRun")
+        return `${request.method} for run '${request.runId}'`;
+    return request.method;
+}
+function daemonControlErrorCode(error) {
+    if (error instanceof DaemonRequestError)
+        return error.code;
+    const failure = runtimeFailure(error);
+    if (failure) {
+        if (failure.type === "run-not-found" || failure.type === "runtime-store-not-found")
+            return "RUN_NOT_FOUND";
+        if (failure.type === "scheduler-store-failed")
+            return "STORE_ERROR";
+        if (failure.type === "run-control-failed" && error instanceof Error && error.message.includes("currently controlled by another owner"))
+            return "CONTROL_CONFLICT";
+        return "RUN_NOT_CONTROLLABLE";
+    }
+    return "RUN_NOT_CONTROLLABLE";
+}
+function runtimeFailure(error) {
+    if (error instanceof RuntimeUseCaseException)
+        return error.failure;
+    if (typeof error !== "object" || error === null || !("failure" in error))
+        return undefined;
+    const failure = error.failure;
+    if (typeof failure !== "object" || failure === null || !("type" in failure))
+        return undefined;
+    return failure;
+}
+function isFilesystemSocket(endpoint) {
+    return process.platform !== "win32" && !endpoint.startsWith("\0");
+}
+function isDaemonStatus(value) {
+    return typeof value === "object" && value !== null && value.status === "ok";
+}
+function isDaemonShutdownResult(value) {
+    return typeof value === "object" && value !== null && value.status === "shutdown";
+}
+function isRunDetails(value) {
+    return typeof value === "object" && value !== null && typeof value.id === "string" && typeof value.status === "string";
+}
+function isRuntimeAdvanceResult(value) {
+    return typeof value === "object" && value !== null && "summary" in value && "run" in value;
+}
+function isControlIntent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const intent = value;
+    if (typeof intent.requestId !== "string" || typeof intent.type !== "string" || typeof intent.runId !== "string")
+        return false;
+    return intent.type === "signal" ? typeof intent.nodeId === "string" : ["pause", "resume", "retry", "cancel", "fork"].includes(intent.type);
+}
+async function hasLiveDaemon(cwd) {
+    try {
+        await requestDaemonStatus(cwd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isAddressInUse(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "EADDRINUSE";
+}
+function isFileExists(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
+}
+async function hasStaleDaemonEvidence(cwd) {
+    const store = await openExistingRuntimeStore(cwd);
+    if (!store)
+        return true;
+    try {
+        const daemon = store.getRuntimeDiagnostics().daemon;
+        if (!daemon)
+            return true;
+        if (daemon.heartbeatAt && Date.now() - Date.parse(daemon.heartbeatAt) > 5_000)
+            return true;
+        return daemon.pid !== undefined && !isProcessAlive(daemon.pid);
+    }
+    finally {
+        store.close();
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return typeof error === "object" && error !== null && "code" in error && error.code === "EPERM";
+    }
+}
+//# sourceMappingURL=socket.js.map