@vibesdotdev/kernel-rpc 0.0.0-stage → 1.0.0-rc.3

package/dist/daemon/client/contracts1/restart.d.ts

@@ -0,0 +1,69 @@
+import type { RuntimeDaemonClientRuntime } from '../../../schemas/daemon/daemon-runtime.ts';
+import { type RuntimeDaemonRestartReceipt, type RuntimeDaemonSupervisor } from '../../../schemas/daemon/daemon-supervisor.ts';
+export declare const START_TIMEOUT_MS = 30000;
+/** The supervisor that claims the runtime's daemon, with what it reported. */
+export interface RuntimeDaemonSupervisorClaim {
+    supervisor: RuntimeDaemonSupervisor;
+    /** The claiming supervisor's descriptor id. */
+    id: string;
+    processId: string;
+    /** The pid of the supervisor's live run, when it has one. */
+    pid?: number;
+}
+export type RuntimeDaemonSupervisionSelection = {
+    supervised: true;
+    claim: RuntimeDaemonSupervisorClaim;
+} | {
+    supervised: false;
+    reasons: Array<{
+        supervisor: string;
+        reason: string;
+    }>;
+};
+/**
+ * Ask every registered `runtime/daemon/supervisor` whether it manages the
+ * handed runtime's daemon. One claim selects that supervisor; none is the
+ * typed unsupervised answer with each supervisor's reason; two claims are
+ * ambiguous and refuse, since a restart through either would fight the other.
+ */
+export declare function resolveRuntimeDaemonSupervision(runtime: Pick<RuntimeDaemonClientRuntime, 'hasKind' | 'query'>): Promise<RuntimeDaemonSupervisionSelection>;
+/**
+ * Restart the runtime daemon through the supervisor that manages it.
+ *
+ * A daemon whose recorded pid is not the supervisor's tracked run (an orphan a
+ * past detached restart left, or a foreground `runtime daemon serve`) would
+ * keep the runtime socket from the supervisor's fresh run, whose serve
+ * pre-check yields to it. So that holder is stopped first, honouring `force`;
+ * the supervisor then stops its own run (if any) and starts a fresh one. The
+ * restart is done when the runtime socket answers.
+ */
+export declare function restartRuntimeDaemonThroughSupervisor(runtime: RuntimeDaemonClientRuntime, claim: RuntimeDaemonSupervisorClaim, options?: {
+    force?: boolean;
+}): Promise<RuntimeDaemonRestartReceipt>;
+/**
+ * Spawn a detached runtime daemon on this host's workspace (handed to the
+ * child in argv) and wait until it answers. Nothing supervises it: the
+ * unsupervised path of start and restart. A child that exits first, or never
+ * answers, refuses typed `runtime-daemon-start-failed` with its exit code.
+ */
+export declare function spawnUnsupervisedRuntimeDaemon(runtime: RuntimeDaemonClientRuntime, timeoutMs: number): Promise<void>;
+/** Wait until the runtime socket answers after `claim`'s supervisor started its run, or refuse typed. */
+export declare function awaitSupervisedRuntimeDaemon(runtime: RuntimeDaemonClientRuntime, claim: RuntimeDaemonSupervisorClaim, started: {
+    pid?: number;
+}, timeoutMs: number): Promise<void>;
+/**
+ * Restart the runtime daemon the CLI's `runtime daemon restart` names.
+ *
+ * When a `runtime/daemon/supervisor` manages the daemon (PM, when it runs and
+ * declares `vibes-runtime-daemon`), the restart goes through it, so the
+ * daemon stays supervised. Only when none does is the daemon restarted
+ * unsupervised, and the receipt names that path and each supervisor's reason.
+ *
+ * `options.force` matches the CLI's `-f, --force` flag: SIGKILL up front
+ * instead of a graceful stop, for the supervisor's run and for any holder it
+ * does not track.
+ */
+export declare function restartRuntimeDaemon(runtime: RuntimeDaemonClientRuntime, options?: {
+    force?: boolean;
+}): Promise<RuntimeDaemonRestartReceipt>;
+//# sourceMappingURL=restart.d.ts.map

package/dist/daemon/client/contracts1/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../../../src/daemon/client/contracts1/restart.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAIN,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAG5B,MAAM,8CAA8C,CAAC;AAKtD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAqBvC,8EAA8E;AAC9E,MAAM,WAAW,4BAA4B;IAC5C,UAAU,EAAE,uBAAuB,CAAC;IACpC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,iCAAiC,GAC1C;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,GACzD;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEjF;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACpD,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,SAAS,GAAG,OAAO,CAAC,GAC5D,OAAO,CAAC,iCAAiC,CAAC,CA2C5C;AAED;;;;;;;;;GASG;AACH,wBAAsB,qCAAqC,CAC1D,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,4BAA4B,EACnC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,2BAA2B,CAAC,CAsBtC;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B1H;AAED,yGAAyG;AACzG,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACzB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,2BAA2B,CAAC,CAOtC"}

package/dist/daemon/client/contracts1/restart.js

@@ -0,0 +1,181 @@
+import { CapabilityError, getRuntimeStdio } from '@vibesdotdev/kernel';
+import { resolveRuntimeDaemonServeSpawnCommands } from "../../hosting/process/spawn.consumer.js";
+import { runtimeDaemonWorkspace } from "../../hosting/socket/runtime-daemon.socket-path.js";
+import { RUNTIME_DAEMON_SUPERVISOR_KIND, RuntimeDaemonSupervisionSchema, RuntimeDaemonSupervisorRestartSchema } from "../../../schemas/daemon/daemon-supervisor.js";
+import { stopRuntimeDaemon } from "../contracts2/stop.js";
+import { awaitRuntimeDaemonReady, waitUntil } from "../contracts2/wait.js";
+import { getRuntimeDaemonPid, isRuntimeDaemonReachable, isRuntimeDaemonRunning } from "./connectivity.js";
+export const START_TIMEOUT_MS = 30_000;
+async function stopBeforeRestart(runtime, options) {
+    if (!(await isRuntimeDaemonRunning(runtime)))
+        return { continued: true };
+    const stdio = await getRuntimeStdio(runtime);
+    stdio.write('stdout', '  Stopping daemon...\n');
+    try {
+        if (!(await stopRuntimeDaemon(runtime, options))) {
+            stdio.write('stderr', '  Warning: the previous daemon did not stop; starting anyway\n');
+        }
+        return { continued: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        stdio.write('stderr', `  Warning: ${message}\n`);
+        return { continued: true, cause: error };
+    }
+}
+/**
+ * Ask every registered `runtime/daemon/supervisor` whether it manages the
+ * handed runtime's daemon. One claim selects that supervisor; none is the
+ * typed unsupervised answer with each supervisor's reason; two claims are
+ * ambiguous and refuse, since a restart through either would fight the other.
+ */
+export async function resolveRuntimeDaemonSupervision(runtime) {
+    if (!runtime.hasKind(RUNTIME_DAEMON_SUPERVISOR_KIND)) {
+        return { supervised: false, reasons: [] };
+    }
+    const descriptors = runtime
+        .query(RUNTIME_DAEMON_SUPERVISOR_KIND)
+        .enabled()
+        .descriptors();
+    const claims = [];
+    const reasons = [];
+    for (const descriptor of descriptors) {
+        const supervisor = await runtime
+            .query(RUNTIME_DAEMON_SUPERVISOR_KIND)
+            .withId(descriptor.id)
+            .resolve();
+        const supervision = RuntimeDaemonSupervisionSchema.parse(await supervisor.inspect());
+        if (supervision.supervised) {
+            const claim = { supervisor, id: descriptor.id, processId: supervision.processId };
+            if (supervision.pid !== undefined)
+                claim.pid = supervision.pid;
+            claims.push(claim);
+        }
+        else {
+            reasons.push({ supervisor: descriptor.id, reason: supervision.reason });
+        }
+    }
+    const [claim, ...others] = claims;
+    if (others.length > 0) {
+        throw new CapabilityError('More than one runtime daemon supervisor claims the workspace runtime daemon; a restart cannot choose between them.', 'CONFLICT', {
+            reason: 'runtime-daemon-supervisor-ambiguous',
+            retryable: false,
+            recoveryHint: 'Compose exactly one plugin whose `runtime/daemon/supervisor` manages the runtime daemon.',
+            details: { supervisors: claims.map((entry) => entry.id) }
+        });
+    }
+    if (!claim)
+        return { supervised: false, reasons };
+    return { supervised: true, claim };
+}
+/**
+ * Restart the runtime daemon through the supervisor that manages it.
+ *
+ * A daemon whose recorded pid is not the supervisor's tracked run (an orphan a
+ * past detached restart left, or a foreground `runtime daemon serve`) would
+ * keep the runtime socket from the supervisor's fresh run, whose serve
+ * pre-check yields to it. So that holder is stopped first, honouring `force`;
+ * the supervisor then stops its own run (if any) and starts a fresh one. The
+ * restart is done when the runtime socket answers.
+ */
+export async function restartRuntimeDaemonThroughSupervisor(runtime, claim, options) {
+    const stdio = await getRuntimeStdio(runtime);
+    const holder = await getRuntimeDaemonPid(runtime);
+    if (holder !== null && holder !== claim.pid) {
+        stdio.write('stdout', `  Daemon PID ${holder} is not supervised by '${claim.id}'.\n`);
+        await stopBeforeRestart(runtime, options);
+    }
+    stdio.write('stdout', `  Restarting daemon through '${claim.id}' (${claim.processId})...\n`);
+    const restartOptions = {};
+    if (options?.force)
+        restartOptions.force = true;
+    const restarted = RuntimeDaemonSupervisorRestartSchema.parse(await claim.supervisor.restart(restartOptions));
+    await awaitSupervisedRuntimeDaemon(runtime, claim, restarted, START_TIMEOUT_MS);
+    return {
+        supervision: 'supervised',
+        supervisor: claim.id,
+        processId: claim.processId,
+        pid: await getRuntimeDaemonPid(runtime)
+    };
+}
+/**
+ * Spawn a detached runtime daemon on this host's workspace (handed to the
+ * child in argv) and wait until it answers. Nothing supervises it: the
+ * unsupervised path of start and restart. A child that exits first, or never
+ * answers, refuses typed `runtime-daemon-start-failed` with its exit code.
+ */
+export async function spawnUnsupervisedRuntimeDaemon(runtime, timeoutMs) {
+    const workspaceRoot = runtimeDaemonWorkspace(runtime);
+    const { commands, env } = await resolveRuntimeDaemonServeSpawnCommands(runtime, import.meta.url, {
+        workspaceRoot
+    });
+    const { spawnSupervised } = await import("../../../core/utils/exec.js");
+    const [cmd, ...args] = commands[0];
+    const proc = await spawnSupervised(runtime, cmd, args, {
+        detached: true,
+        cwd: workspaceRoot,
+        env,
+        envMode: 'replace'
+    });
+    // Detach so the caller can exit without killing the daemon.
+    proc.unref();
+    if ((await awaitRuntimeDaemonReady(runtime, proc, timeoutMs)) === 'reachable')
+        return;
+    const exitCode = proc.exitCode;
+    throw new CapabilityError(exitCode !== null
+        ? `Daemon process exited early with code ${exitCode}.`
+        : `Daemon did not become reachable within ${timeoutMs}ms.`, 'UNAVAILABLE', {
+        reason: 'runtime-daemon-start-failed',
+        retryable: true,
+        details: { exitCode, timeoutMs }
+    });
+}
+/** Wait until the runtime socket answers after `claim`'s supervisor started its run, or refuse typed. */
+export async function awaitSupervisedRuntimeDaemon(runtime, claim, started, timeoutMs) {
+    const ready = await waitUntil(runtime, () => isRuntimeDaemonReachable(runtime, 1000), {
+        timeoutMs,
+        intervalMs: 100,
+        reason: 'runtime-daemon-ready'
+    });
+    if (ready.settled)
+        return;
+    throw new CapabilityError(`The runtime daemon started through '${claim.id}' did not become reachable within ${timeoutMs}ms.`, 'UNAVAILABLE', {
+        reason: 'runtime-daemon-supervised-unready',
+        retryable: true,
+        details: { supervisor: claim.id, processId: claim.processId, pid: started.pid },
+        cause: ready.cause
+    });
+}
+/**
+ * The unsupervised restart: no supervisor manages the daemon (no supervisor
+ * is composed, its daemon is not running, or it declares no runtime daemon
+ * process), so this host stops the daemon and starts a detached one itself.
+ * Nothing restarts that daemon if it dies; the receipt says so.
+ */
+async function restartUnsupervisedRuntimeDaemon(runtime, reasons, options) {
+    await stopBeforeRestart(runtime, options);
+    const stdio = await getRuntimeStdio(runtime);
+    stdio.write('stdout', '  No supervisor manages the daemon; starting an unsupervised daemon...\n');
+    await spawnUnsupervisedRuntimeDaemon(runtime, START_TIMEOUT_MS);
+    return { supervision: 'unsupervised', reasons, pid: await getRuntimeDaemonPid(runtime) };
+}
+/**
+ * Restart the runtime daemon the CLI's `runtime daemon restart` names.
+ *
+ * When a `runtime/daemon/supervisor` manages the daemon (PM, when it runs and
+ * declares `vibes-runtime-daemon`), the restart goes through it, so the
+ * daemon stays supervised. Only when none does is the daemon restarted
+ * unsupervised, and the receipt names that path and each supervisor's reason.
+ *
+ * `options.force` matches the CLI's `-f, --force` flag: SIGKILL up front
+ * instead of a graceful stop, for the supervisor's run and for any holder it
+ * does not track.
+ */
+export async function restartRuntimeDaemon(runtime, options) {
+    const selection = await resolveRuntimeDaemonSupervision(runtime);
+    if (selection.supervised) {
+        return restartRuntimeDaemonThroughSupervisor(runtime, selection.claim, options);
+    }
+    return restartUnsupervisedRuntimeDaemon(runtime, selection.reasons, options);
+}
+//# sourceMappingURL=restart.js.map

package/dist/daemon/client/contracts1/restart.js.map

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

package/dist/daemon/client/contracts1/supervised-lifecycle.d.ts

@@ -0,0 +1,28 @@
+import type { RuntimeDaemonClientRuntime } from '../../../schemas/daemon/daemon-runtime.ts';
+import { type RuntimeDaemonStartReceipt, type RuntimeDaemonStopReceipt } from '../../../schemas/daemon/daemon-supervisor.ts';
+/** The reason a claiming supervisor gives way to a daemon it does not track that already serves. */
+export declare const RUNTIME_DAEMON_HELD_OUTSIDE_SUPERVISOR = "runtime-daemon-held-outside-supervisor";
+/**
+ * Start the runtime daemon unless one already answers.
+ *
+ * A claiming supervisor ensures its own run (readiness awaited), so the daemon
+ * starts supervised. A daemon already answering is left as it is: when the
+ * claiming supervisor does not track it, the receipt is `unsupervised` with
+ * `runtime-daemon-held-outside-supervisor` (a restart hands it over). With no
+ * claim, a detached daemon is spawned: the explicit unsupervised path.
+ */
+export declare function startRuntimeDaemon(runtime: RuntimeDaemonClientRuntime, options?: {
+    timeoutMs?: number;
+}): Promise<RuntimeDaemonStartReceipt>;
+/**
+ * Stop the runtime daemon, the owner of `runtime daemon stop`.
+ *
+ * A claiming supervisor stops its live run on purpose, so it records the run
+ * stopped and does not restart it. Any daemon still holding the runtime
+ * afterwards (one the supervisor does not track) is signalled as before, as is
+ * the daemon when no supervisor claims it. `force` kills outright (SIGKILL).
+ */
+export declare function shutdownRuntimeDaemon(runtime: RuntimeDaemonClientRuntime, options?: {
+    force?: boolean;
+}): Promise<RuntimeDaemonStopReceipt>;
+//# sourceMappingURL=supervised-lifecycle.d.ts.map

package/dist/daemon/client/contracts1/supervised-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervised-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/daemon/client/contracts1/supervised-lifecycle.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAEN,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAE7B,MAAM,8CAA8C,CAAC;AAUtD,oGAAoG;AACpG,eAAO,MAAM,sCAAsC,2CAA2C,CAAC;AAE/F;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CA2CpC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CA0BnC"}

package/dist/daemon/client/contracts1/supervised-lifecycle.js

@@ -0,0 +1,96 @@
+/**
+ * Start and stop of the workspace runtime daemon through its supervisor
+ * (`runtime/daemon/supervisor`), the owners of `runtime daemon start` and
+ * `runtime daemon stop`. Like restart, each resolves the supervisor that
+ * claims the daemon; only when none does is the daemon started detached or
+ * stopped by signal, and the receipt names that unsupervised path.
+ */
+import { getRuntimeStdio } from '@vibesdotdev/kernel';
+import { RuntimeDaemonSupervisorRestartSchema } from "../../../schemas/daemon/daemon-supervisor.js";
+import { stopRuntimeDaemon } from "../contracts2/stop.js";
+import { getRuntimeDaemonPid, isRuntimeDaemonReachable, isRuntimeDaemonRunning } from "./connectivity.js";
+import { awaitSupervisedRuntimeDaemon, resolveRuntimeDaemonSupervision, spawnUnsupervisedRuntimeDaemon, START_TIMEOUT_MS } from "./restart.js";
+/** The reason a claiming supervisor gives way to a daemon it does not track that already serves. */
+export const RUNTIME_DAEMON_HELD_OUTSIDE_SUPERVISOR = 'runtime-daemon-held-outside-supervisor';
+/**
+ * Start the runtime daemon unless one already answers.
+ *
+ * A claiming supervisor ensures its own run (readiness awaited), so the daemon
+ * starts supervised. A daemon already answering is left as it is: when the
+ * claiming supervisor does not track it, the receipt is `unsupervised` with
+ * `runtime-daemon-held-outside-supervisor` (a restart hands it over). With no
+ * claim, a detached daemon is spawned: the explicit unsupervised path.
+ */
+export async function startRuntimeDaemon(runtime, options) {
+    const timeoutMs = options?.timeoutMs ?? START_TIMEOUT_MS;
+    const selection = await resolveRuntimeDaemonSupervision(runtime);
+    const answering = await isRuntimeDaemonReachable(runtime, 1000);
+    if (selection.supervised) {
+        const claim = selection.claim;
+        const holder = await getRuntimeDaemonPid(runtime);
+        if (answering && holder !== null && holder !== claim.pid) {
+            return {
+                supervision: 'unsupervised',
+                outcome: 'already-running',
+                reasons: [{ supervisor: claim.id, reason: RUNTIME_DAEMON_HELD_OUTSIDE_SUPERVISOR }],
+                pid: holder
+            };
+        }
+        if (!answering) {
+            (await getRuntimeStdio(runtime)).write('stdout', `  Starting daemon through '${claim.id}' (${claim.processId})...\n`);
+            const started = RuntimeDaemonSupervisorRestartSchema.parse(await claim.supervisor.ensure());
+            await awaitSupervisedRuntimeDaemon(runtime, claim, started, timeoutMs);
+        }
+        return {
+            supervision: 'supervised',
+            outcome: answering ? 'already-running' : 'started',
+            supervisor: claim.id,
+            processId: claim.processId,
+            pid: await getRuntimeDaemonPid(runtime)
+        };
+    }
+    if (!answering) {
+        (await getRuntimeStdio(runtime)).write('stdout', '  No supervisor manages the daemon; starting an unsupervised daemon...\n');
+        await spawnUnsupervisedRuntimeDaemon(runtime, timeoutMs);
+    }
+    return {
+        supervision: 'unsupervised',
+        outcome: answering ? 'already-running' : 'started',
+        reasons: selection.reasons,
+        pid: await getRuntimeDaemonPid(runtime)
+    };
+}
+/**
+ * Stop the runtime daemon, the owner of `runtime daemon stop`.
+ *
+ * A claiming supervisor stops its live run on purpose, so it records the run
+ * stopped and does not restart it. Any daemon still holding the runtime
+ * afterwards (one the supervisor does not track) is signalled as before, as is
+ * the daemon when no supervisor claims it. `force` kills outright (SIGKILL).
+ */
+export async function shutdownRuntimeDaemon(runtime, options) {
+    const selection = await resolveRuntimeDaemonSupervision(runtime);
+    const pid = await getRuntimeDaemonPid(runtime);
+    const supervisedRun = selection.supervised && selection.claim.pid !== undefined;
+    if (!supervisedRun && !(await isRuntimeDaemonRunning(runtime))) {
+        return selection.supervised
+            ? { supervision: 'supervised', outcome: 'not-running', supervisor: selection.claim.id, processId: selection.claim.processId, pid }
+            : { supervision: 'unsupervised', outcome: 'not-running', reasons: selection.reasons, pid };
+    }
+    if (selection.supervised && supervisedRun) {
+        const stopOptions = {};
+        if (options?.force)
+            stopOptions.force = true;
+        (await getRuntimeStdio(runtime)).write('stdout', `  Stopping daemon through '${selection.claim.id}' (${selection.claim.processId})...\n`);
+        await selection.claim.supervisor.stop(stopOptions);
+    }
+    // A holder the supervisor does not track, or the daemon nothing supervises.
+    let stopped = !(await isRuntimeDaemonRunning(runtime));
+    if (!stopped)
+        stopped = await stopRuntimeDaemon(runtime, options);
+    const outcome = stopped ? 'stopped' : 'survived';
+    return selection.supervised
+        ? { supervision: 'supervised', outcome, supervisor: selection.claim.id, processId: selection.claim.processId, pid }
+        : { supervision: 'unsupervised', outcome, reasons: selection.reasons, pid };
+}
+//# sourceMappingURL=supervised-lifecycle.js.map

package/dist/daemon/client/contracts1/supervised-lifecycle.js.map

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

package/dist/daemon/client/contracts2/stop.d.ts

@@ -0,0 +1,6 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { RuntimeDaemonSocketRuntime } from '../../../schemas/daemon/daemon-runtime.ts';
+export declare function stopRuntimeDaemon(runtime: RuntimeDaemonSocketRuntime & RuntimeRef, options?: {
+    force?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/daemon/client/contracts2/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../../src/daemon/client/contracts2/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAI5F,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,0BAA0B,GAAG,UAAU,EAChD,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CAsClB"}

package/dist/daemon/client/contracts2/stop.js

@@ -0,0 +1,41 @@
+import {} from '@vibesdotdev/kernel';
+import { getRuntimeProcessService } from '@vibesdotdev/kernel/process';
+import { getRuntimeDaemonPid, isRuntimeDaemonRunning } from "../contracts1/connectivity.js";
+import { waitUntil } from "./wait.js";
+export async function stopRuntimeDaemon(runtime, options) {
+    const pid = await getRuntimeDaemonPid(runtime);
+    if (!pid)
+        return false;
+    try {
+        const signal = options?.force ? 'SIGKILL' : 'SIGTERM';
+        await (await getRuntimeProcessService(runtime)).signal(pid, signal);
+        const stopped = async () => !(await isRuntimeDaemonRunning(runtime));
+        if ((await waitUntil(runtime, stopped, {
+            timeoutMs: options?.force ? 1000 : 10000,
+            intervalMs: 250,
+            reason: 'runtime-daemon-stop'
+        })).settled) {
+            return true;
+        }
+        if (!options?.force) {
+            try {
+                await (await getRuntimeProcessService(runtime)).signal(pid, 'SIGKILL');
+            }
+            catch (error) {
+                // ESRCH: it exited between the last probe and the kill.
+                if (!(error instanceof Error && 'code' in error && error.code === 'ESRCH'))
+                    throw error;
+            }
+            return (await waitUntil(runtime, stopped, { timeoutMs: 1000, intervalMs: 100, reason: 'runtime-daemon-kill' })).settled;
+        }
+        return !(await isRuntimeDaemonRunning(runtime));
+    }
+    catch (error) {
+        // ESRCH: the daemon is already gone, which is what stop asked for. Any
+        // other failure (EPERM: not ours to signal) propagates.
+        if (error instanceof Error && 'code' in error && error.code === 'ESRCH')
+            return true;
+        throw error;
+    }
+}
+//# sourceMappingURL=stop.js.map

package/dist/daemon/client/contracts2/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../../src/daemon/client/contracts2/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAgD,EAChD,OAA6B;IAE7B,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvB,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,MAAM,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;QACrE,IACC,CACC,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE;YACjC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;YACxC,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,qBAAqB;SAC7B,CAAC,CACF,CAAC,OAAO,EACR,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC;gBACJ,MAAM,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACxE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,wDAAwD;gBACxD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;oBAAE,MAAM,KAAK,CAAC;YACzF,CAAC;YACD,OAAO,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACzH,CAAC;QAED,OAAO,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,uEAAuE;QACvE,wDAAwD;QACxD,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACrF,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/daemon/client/contracts2/unix-client.d.ts

@@ -0,0 +1,24 @@
+import { type CommandArgRecord } from '../../commands/command-argv.ts';
+import { type RuntimeDaemonHealth } from '../../protocol/schemas.ts';
+import type { DoctorOptions, DoctorResult, InvokeOptions, InvokeResult, QueryFilters, QueryResult, ReadResult, ResolveResult, RuntimeClientOptions } from '../../../schemas/daemon/daemon-client.ts';
+import type { RuntimeDaemonClientRuntime } from '../../../schemas/daemon/daemon-runtime.ts';
+import { DaemonClientConnection } from '../contracts1/connection.ts';
+export declare class RpcUnixClient extends DaemonClientConnection {
+    query(kind?: string, filters?: QueryFilters): Promise<QueryResult>;
+    resolve(id: string): Promise<ResolveResult>;
+    readStorage(manifestId: string): Promise<ReadResult>;
+    readConfig(manifestId: string): Promise<ReadResult>;
+    health(): Promise<RuntimeDaemonHealth | null>;
+    private readHealth;
+    doctor(options?: DoctorOptions): Promise<DoctorResult>;
+    invokeTool(id: string, params?: CommandArgRecord, options?: InvokeOptions): Promise<InvokeResult>;
+    invokeCommand(id: string, args?: CommandArgRecord, opts?: CommandArgRecord, options?: InvokeOptions): Promise<InvokeResult>;
+    disconnect(): void;
+}
+/**
+ * Create a new RpcUnixClient for `runtime`, the runtime the caller was
+ * handed, with its default socket path unless one is named.
+ * Drop-in replacement for the deleted `new RuntimeClient()`.
+ */
+export declare function createRuntimeClient(runtime: RuntimeDaemonClientRuntime, socketPath?: string, options?: RuntimeClientOptions): RpcUnixClient;
+//# sourceMappingURL=unix-client.d.ts.map

package/dist/daemon/client/contracts2/unix-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-client.d.ts","sourceRoot":"","sources":["../../../../src/daemon/client/contracts2/unix-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrM,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAE5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,qBAAa,aAAc,SAAQ,sBAAsB;IAClD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAclE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMpD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMnD,MAAM,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;YAKrC,UAAU;IAWlB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAMtD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBjG,aAAa,CAClB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC;IAmBxB,UAAU,IAAI,IAAI;CAClB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,0BAA0B,EACnC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GAChC,aAAa,CAIf"}

package/dist/daemon/client/contracts2/unix-client.js

@@ -0,0 +1,84 @@
+import {} from "../../commands/command-argv.js";
+import { isRuntimeDaemonHost } from "../../hosting/process/daemon-role.js";
+import {} from "../../protocol/schemas.js";
+import { jsonRecord } from "../contracts1/arguments.js";
+import { DaemonClientConnection } from "../contracts1/connection.js";
+import { loadReclaim } from "../contracts1/reclaim.js";
+import { readDoctor, readHealthPayload, readInvoke, readManifest, readQuery, readResolve } from "../contracts1/responses.js";
+export class RpcUnixClient extends DaemonClientConnection {
+    async query(kind, filters) {
+        const raw = await this.call('query', jsonRecord({
+            kind,
+            tags: filters?.tags,
+            scope: filters?.scope,
+            enabled: filters?.enabled,
+            ids: filters?.ids
+        }));
+        return readQuery(raw);
+    }
+    async resolve(id) {
+        return readResolve(await this.call('resolve', jsonRecord({ id })));
+    }
+    async readStorage(manifestId) {
+        return readManifest(await this.call('read', jsonRecord({ manifestId, manifestKind: 'storage' })));
+    }
+    async readConfig(manifestId) {
+        return readManifest(await this.call('read', jsonRecord({ manifestId, manifestKind: 'config' })));
+    }
+    async health() {
+        const reading = await this.readHealth();
+        return reading.health;
+    }
+    async readHealth() {
+        try {
+            return { health: readHealthPayload(await this.call('health', {})) };
+        }
+        catch (error) {
+            // A daemon that is not listening has no health; any other failure propagates.
+            const reclaim = await loadReclaim();
+            if (await reclaim.isStaleSocketError(this.runtime, error))
+                return { health: null, cause: error };
+            throw error;
+        }
+    }
+    async doctor(options) {
+        return readDoctor(await this.call('doctor', jsonRecord({ fix: options?.fix, kinds: options?.kinds })));
+    }
+    async invokeTool(id, params, options) {
+        return readInvoke(await this.call('invoke', jsonRecord({
+            invokeType: 'tool',
+            id,
+            params,
+            timeout: options?.timeout,
+            source: options?.source,
+            emitActivity: options?.emitActivity,
+            caller: options?.caller,
+            workspace: options?.workspace
+        })));
+    }
+    async invokeCommand(id, args, opts, options) {
+        return readInvoke(await this.call('invoke', jsonRecord({
+            invokeType: 'command',
+            id,
+            args,
+            opts,
+            timeout: options?.timeout,
+            source: options?.source,
+            emitActivity: options?.emitActivity,
+            caller: options?.caller,
+            workspace: options?.workspace
+        })));
+    }
+    disconnect() { }
+}
+/**
+ * Create a new RpcUnixClient for `runtime`, the runtime the caller was
+ * handed, with its default socket path unless one is named.
+ * Drop-in replacement for the deleted `new RuntimeClient()`.
+ */
+export function createRuntimeClient(runtime, socketPath, options = {}) {
+    // On the runtime daemon's host (a declared fact of its serve host, carried
+    // by every hot-reload generation) the client never starts a daemon.
+    return new RpcUnixClient(runtime, socketPath, isRuntimeDaemonHost(runtime) ? { ...options, autoStart: false } : options);
+}
+//# sourceMappingURL=unix-client.js.map

package/dist/daemon/client/contracts2/unix-client.js.map

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

package/dist/daemon/client/contracts2/wait.d.ts

@@ -0,0 +1,22 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { RuntimeDaemonSocketRuntime } from '../../../schemas/daemon/daemon-runtime.ts';
+export declare function waitUntil(runtime: Pick<RuntimeRef, 'lifecycle'>, check: () => Promise<boolean>, options: {
+    timeoutMs: number;
+    intervalMs: number;
+    reason: string;
+}): Promise<{
+    settled: boolean;
+    cause?: undefined;
+} | {
+    settled: boolean;
+    cause: import("@vibesdotdev/kernel").CapabilityError;
+}>;
+/**
+ * Wait for a freshly spawned runtime daemon: `reachable` once its socket
+ * answers, `exited` when the child exits first (and nothing else answers),
+ * `timeout` at the deadline. Bounded by the runtime lifecycle (RC07).
+ */
+export declare function awaitRuntimeDaemonReady(runtime: RuntimeDaemonSocketRuntime, proc: {
+    readonly exitCode: number | null;
+}, timeoutMs: number, healthTimeoutMs?: number): Promise<'reachable' | 'exited' | 'timeout'>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/daemon/client/contracts2/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../src/daemon/client/contracts2/wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAG5F,wBAAsB,SAAS,CAC9B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACtC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;GAiBlE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,0BAA0B,EACnC,IAAI,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC1C,SAAS,EAAE,MAAM,EACjB,eAAe,SAAO,GACpB,OAAO,CAAC,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC,CAY7C"}