@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/launch/consumer/prepare.js

@@ -0,0 +1,158 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { externalFileSystem } from "../../utils/runtime-fs.js";
+import { launchAbsolutePath } from "./prompt.js";
+import { resolveExternalSessionManager } from "../../session-capability.js";
+import { LAUNCH_BRIEF_KEY, LAUNCH_SCRATCHPAD_KEY } from "../schemas.js";
+/** The launch's working directory, absolute; refused `INVALID_INPUT` `launch-cwd-missing` unless it is a directory. */
+async function assertExistingDirectory(runtime, cwd) {
+    const resolved = await launchAbsolutePath(runtime, cwd);
+    const fs = await externalFileSystem(runtime);
+    const isDirectory = (await fs.exists(resolved)) && (await fs.stat(resolved)).kind === 'directory';
+    if (!isDirectory) {
+        throw new CapabilityError(`Working directory does not exist: ${resolved}`, 'INVALID_INPUT', {
+            reason: 'launch-cwd-missing',
+            retryable: false,
+            recoveryHint: 'Pass --cwd to an existing directory.'
+        });
+    }
+    return resolved;
+}
+function assertSessionMethod(manager, name) {
+    if (!manager[name]) {
+        throw new CapabilityError(`session/manager does not expose ${String(name)}`, 'UNAVAILABLE', {
+            reason: 'launch-session-method-missing',
+            retryable: false,
+            recoveryHint: 'Load the session plugin on this CLI host.'
+        });
+    }
+}
+export async function prepareLaunchSession(input, onSession, runtime) {
+    const cwd = await assertExistingDirectory(runtime, input.cwd);
+    const manager = await resolveExternalSessionManager(runtime);
+    if (!manager) {
+        throw new CapabilityError('session/manager is not available', 'UNAVAILABLE', {
+            reason: 'launch-session-manager-unavailable',
+            retryable: false,
+            recoveryHint: 'Load the session plugin before running vibes launch.'
+        });
+    }
+    const participantId = `participant-launch-${input.harness}`;
+    if (manager.getParticipant && manager.registerParticipant) {
+        const existing = await manager.getParticipant(participantId);
+        if (!existing) {
+            await manager.registerParticipant({
+                participantId,
+                name: `Launch ${input.harness}`,
+                role: 'user',
+                capabilities: ['session-management', 'todo-tracking', 'planning'],
+                metadata: { source: 'vibes-launch', harness: input.harness, cwd }
+            });
+        }
+    }
+    let sessionId;
+    let title = input.title;
+    let reused = false;
+    if (input.sessionId) {
+        const existing = await manager.getSession(input.sessionId);
+        if (!existing) {
+            throw new CapabilityError(`Session ${input.sessionId} was not found`, 'UNAVAILABLE', {
+                reason: 'launch-session-not-found',
+                retryable: false,
+                recoveryHint: 'Pass --session-id of an existing session, or omit it to create one.'
+            });
+        }
+        sessionId = existing.id;
+        title = existing.title ?? input.title;
+        reused = true;
+        await onSession?.(sessionId);
+    }
+    else {
+        assertSessionMethod(manager, 'createSession');
+        const created = await manager.createSession({
+            title: input.title,
+            description: `Headless ${input.harness} launch`,
+            ownerParticipant: participantId,
+            tags: ['launch', input.harness],
+            status: 'active',
+            metadata: {
+                source: 'vibes-launch',
+                sessionType: 'launch',
+                workspacePath: cwd
+            }
+        });
+        sessionId = created.id;
+        title = created.title ?? input.title;
+        await onSession?.(sessionId);
+    }
+    if (manager.setParticipantActiveSession) {
+        await manager.setParticipantActiveSession(participantId, sessionId);
+    }
+    if (manager.setDefaultActiveBinding) {
+        await manager.setDefaultActiveBinding(sessionId, participantId);
+    }
+    else if (manager.setDefaultActiveSession) {
+        await manager.setDefaultActiveSession(sessionId);
+    }
+    assertSessionMethod(manager, 'writeScratchpad');
+    await manager.writeScratchpad(sessionId, {
+        key: LAUNCH_BRIEF_KEY,
+        content: input.brief,
+        contentType: 'markdown',
+        tags: ['launch', 'brief']
+    });
+    assertSessionMethod(manager, 'addTodo');
+    await manager.addTodo(sessionId, {
+        content: 'Bind the workspace and read the brief',
+        activeForm: 'Binding the workspace and reading the brief',
+        priority: 'high',
+        status: 'pending',
+        tags: ['launch']
+    });
+    await manager.addTodo(sessionId, {
+        content: 'Execute the assignment',
+        activeForm: 'Executing the assignment',
+        priority: 'high',
+        status: 'pending',
+        tags: ['launch']
+    });
+    await manager.addTodo(sessionId, {
+        content: 'Write the receipt and keep session state current',
+        activeForm: 'Writing the receipt and keeping session state current',
+        priority: 'high',
+        status: 'pending',
+        tags: ['launch']
+    });
+    if (manager.updateSession) {
+        const launchIdentity = { harness: input.harness, toolId: input.toolId, cwd };
+        const launchCustom = input.model === undefined
+            ? { launch: launchIdentity }
+            : { launch: { ...launchIdentity, model: input.model } };
+        await manager.updateSession(sessionId, {
+            metadata: {
+                source: 'vibes-launch',
+                sessionType: 'launch',
+                workspacePath: cwd,
+                custom: launchCustom
+            }
+        });
+    }
+    return { sessionId, title, reused, participantId };
+}
+/**
+ * Write the launch record to the session the launch prepared. The caller passes
+ * the same runtime that prepared the session; resolving an ambient runtime here
+ * would write through a different host's session/manager, or skip the write.
+ */
+export async function writeLaunchScratchpad(sessionId, record, runtime) {
+    const manager = await resolveExternalSessionManager(runtime);
+    if (!manager)
+        return;
+    assertSessionMethod(manager, 'writeScratchpad');
+    await manager.writeScratchpad(sessionId, {
+        key: LAUNCH_SCRATCHPAD_KEY,
+        content: JSON.stringify(record, null, 2),
+        contentType: 'json',
+        tags: ['launch']
+    });
+}
+//# sourceMappingURL=prepare.js.map

package/dist/launch/consumer/prepare.js.map

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

package/dist/launch/consumer/prompt.d.ts

@@ -0,0 +1,18 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare function composeLaunchPrompt(sessionId: string, userPrompt: string): string;
+/**
+ * A caller-given path made absolute: as given when absolute, else against the
+ * host's captured cwd (where the user ran the command), else the bound
+ * workspace. Never the executable's process cwd.
+ */
+export declare function launchAbsolutePath(runtime: RuntimeRef, path: string): Promise<string>;
+/**
+ * The launch brief: the brief file's text (through the runtime's filesystem),
+ * then the inline prompt. A brief path with no file is refused `NOT_FOUND`
+ * `launch-brief-missing`.
+ */
+export declare function readLaunchBrief(runtime: RuntimeRef, options: {
+    briefPath?: string;
+    prompt?: string;
+}): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/launch/consumer/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGvE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3F;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/launch/consumer/prompt.js

@@ -0,0 +1,45 @@
+import { isAbsolute, resolve } from '@vibesdotdev/filesystem';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { externalFileSystem, readTextIfPresent } from "../../utils/runtime-fs.js";
+export function composeLaunchPrompt(sessionId, userPrompt) {
+    return [
+        `Bind session ${sessionId}: resume with \`vibes session resume ${sessionId}\`. Keep session-todo and session-scratchpad current. Reach the lead via session-collaborate.`,
+        '',
+        userPrompt.trim()
+    ].join('\n');
+}
+/**
+ * A caller-given path made absolute: as given when absolute, else against the
+ * host's captured cwd (where the user ran the command), else the bound
+ * workspace. Never the executable's process cwd.
+ */
+export async function launchAbsolutePath(runtime, path) {
+    if (isAbsolute(path))
+        return path;
+    const base = runtime.localEnvironment.getCwd?.() ?? (await runtime.context('runtime/workspace-path'));
+    return resolve(base, path);
+}
+/**
+ * The launch brief: the brief file's text (through the runtime's filesystem),
+ * then the inline prompt. A brief path with no file is refused `NOT_FOUND`
+ * `launch-brief-missing`.
+ */
+export async function readLaunchBrief(runtime, options) {
+    const parts = [];
+    if (options.briefPath) {
+        const path = await launchAbsolutePath(runtime, options.briefPath);
+        const text = await readTextIfPresent(await externalFileSystem(runtime), path);
+        if (text === null) {
+            throw new CapabilityError(`The launch brief ${path} does not exist.`, 'NOT_FOUND', {
+                reason: 'launch-brief-missing',
+                retryable: false,
+                details: { path }
+            });
+        }
+        parts.push(text);
+    }
+    if (options.prompt?.trim())
+        parts.push(options.prompt.trim());
+    return parts.join('\n\n').trim();
+}
+//# sourceMappingURL=prompt.js.map

package/dist/launch/consumer/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/launch/consumer/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAElF,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,UAAkB;IACxE,OAAO;QACN,gBAAgB,SAAS,wCAAwC,SAAS,+FAA+F;QACzK,EAAE;QACF,UAAU,CAAC,IAAI,EAAE;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAmB,EAAE,IAAY;IACzE,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC,CAAC;IAC9G,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,OAAmB,EACnB,OAAgD;IAEhD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9E,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,eAAe,CAAC,oBAAoB,IAAI,kBAAkB,EAAE,WAAW,EAAE;gBAClF,MAAM,EAAE,sBAAsB;gBAC9B,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,EAAE,IAAI,EAAE;aACjB,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/launch/consumer/rotate-logs.d.ts

@@ -0,0 +1,23 @@
+/** Prelaunch copy-truncate rotation. This is not a running size cap. */
+import { valueFreeFailure, type RuntimeRef } from '@vibesdotdev/kernel';
+import { type LaunchStore } from './store.ts';
+export declare const LAUNCH_ROTATION_POLICY = "launch.capture";
+export interface RotatedLaunchLog {
+    sessionId: string;
+    path: string;
+    previousSize: number;
+}
+export interface RotateLaunchLogsResult {
+    rotated: RotatedLaunchLog[];
+    failed: Array<{
+        sessionId: string;
+        path: string;
+        failure: ReturnType<typeof valueFreeFailure>;
+    }>;
+    /** Only confirmed absence is a skip. Config or file refusals remain failures. */
+    skipped?: 'config-client-absent';
+}
+export declare function rotateLaunchLogsForSession(runtime: RuntimeRef, sessionId: string, home: string): Promise<RotateLaunchLogsResult>;
+/** Callers own scheduling and must inspect the aggregate failures. */
+export declare function rotateOversizedLaunchLogs(runtime: RuntimeRef, store: LaunchStore): Promise<RotateLaunchLogsResult>;
+//# sourceMappingURL=rotate-logs.d.ts.map

package/dist/launch/consumer/rotate-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate-logs.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/rotate-logs.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAuB,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;KAAE,CAAC,CAAC;IACjG,iFAAiF;IACjF,OAAO,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,sBAAsB,CAAC,CAuBjC;AAED,sEAAsE;AACtE,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CASxH"}

package/dist/launch/consumer/rotate-logs.js

@@ -0,0 +1,43 @@
+/** Prelaunch copy-truncate rotation. This is not a running size cap. */
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { readRotationPolicy, rotateAppendedFile } from '@vibesdotdev/logging';
+import { launchPaths } from "./paths.js";
+import { listLaunchRecords } from "./store.js";
+export const LAUNCH_ROTATION_POLICY = 'launch.capture';
+export async function rotateLaunchLogsForSession(runtime, sessionId, home) {
+    const result = { rotated: [], failed: [] };
+    if (!runtime.hasKind('runtime/client') || runtime.query('runtime/client').withId('config').descriptors().length === 0) {
+        return { ...result, skipped: 'config-client-absent' };
+    }
+    const paths = launchPaths(sessionId, home);
+    const targets = [paths.stdoutPath, paths.stderrPath];
+    let policy;
+    try {
+        policy = await readRotationPolicy(runtime, LAUNCH_ROTATION_POLICY);
+    }
+    catch (error) {
+        const failure = valueFreeFailure(CaughtFailureSchema.parse(error));
+        return { rotated: [], failed: [{ sessionId, path: paths.stdoutPath, failure }, { sessionId, path: paths.stderrPath, failure }] };
+    }
+    for (const path of targets) {
+        const outcome = await rotateAppendedFile(runtime, path, policy).then((rotation) => ({ failed: false, rotation }), (error) => ({ failed: true, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) }));
+        if (outcome.failed)
+            result.failed.push({ sessionId, path, failure: outcome.failure });
+        else if (outcome.rotation.rotated)
+            result.rotated.push({ sessionId, path, previousSize: outcome.rotation.previousSize ?? 0 });
+    }
+    return result;
+}
+/** Callers own scheduling and must inspect the aggregate failures. */
+export async function rotateOversizedLaunchLogs(runtime, store) {
+    const result = { rotated: [], failed: [] };
+    for (const record of await listLaunchRecords(store)) {
+        const one = await rotateLaunchLogsForSession(runtime, record.sessionId, store.home);
+        result.rotated.push(...one.rotated);
+        result.failed.push(...one.failed);
+        if (one.skipped)
+            result.skipped = one.skipped;
+    }
+    return result;
+}
+//# sourceMappingURL=rotate-logs.js.map

package/dist/launch/consumer/rotate-logs.js.map

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

package/dist/launch/consumer/spawn.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Start a launched harness as a detached child through the handed runtime's
+ * execution kind: an argv array (never a shell), stdout and stderr appended
+ * to the launch's log files, the host environment inherited plus the
+ * launch's session variables. Pid liveness is the runtime process service's.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LaunchRecord, ResolvedLaunch } from '../schemas.ts';
+export interface SpawnLaunchInput {
+    resolved: ResolvedLaunch;
+    runtime: RuntimeRef;
+    cwd: string;
+    sessionId: string;
+    participantId?: string;
+    stdoutPath: string;
+    stderrPath: string;
+    env?: Record<string, string | undefined>;
+}
+/** Whether `pid` is running, as `runtime`'s process service sees it. */
+export declare function isPidAlive(runtime: RuntimeRef, pid: number): Promise<boolean>;
+/** A launch child's environment layer: variables to set and names to remove. */
+export interface LaunchChildEnvironment {
+    env: Record<string, string>;
+    unsetEnv: string[];
+}
+/** The launch's child environment: its declared variables, its session, and removals for `undefined` entries. */
+/** Whether a recorded launch is still running: an observed exit or an unknown pid is not. */
+export declare function isLaunchAlive(runtime: RuntimeRef, record: Pick<LaunchRecord, 'pid' | 'exitCode'>): Promise<boolean>;
+export declare function launchChildEnvironment(input: Pick<SpawnLaunchInput, 'env' | 'sessionId' | 'participantId'>): LaunchChildEnvironment;
+/**
+ * Spawn the launch detached. A spawn the execution host refuses is refused
+ * `UNAVAILABLE` `launch-spawn-failed` with the host's refusal as its cause:
+ * the message names the command, never the OS or child's text.
+ */
+export declare function spawnDetachedLaunch(input: SpawnLaunchInput): Promise<{
+    pid: number;
+}>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/launch/consumer/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/spawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA2D,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG/G,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGlE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAKD,wEAAwE;AACxE,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnF;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iHAAiH;AACjH,6FAA6F;AAC7F,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzH;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,WAAW,GAAG,eAAe,CAAC,GAClE,sBAAsB,CAUxB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC3F"}

package/dist/launch/consumer/spawn.js

@@ -0,0 +1,82 @@
+/**
+ * Start a launched harness as a detached child through the handed runtime's
+ * execution kind: an argv array (never a shell), stdout and stderr appended
+ * to the launch's log files, the host environment inherited plus the
+ * launch's session variables. Pid liveness is the runtime process service's.
+ */
+import { dirname } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { getRuntimeExecution } from '@vibesdotdev/kernel/execution';
+import { getRuntimeProcessService } from '@vibesdotdev/kernel/process';
+import { externalFileSystem } from "../../utils/runtime-fs.js";
+/** Why a launched harness inherits the host environment. */
+const LAUNCH_INHERIT_REASON = 'A launched harness runs as the user, with the user’s PATH, HOME and credentials.';
+/** Whether `pid` is running, as `runtime`'s process service sees it. */
+export async function isPidAlive(runtime, pid) {
+    return (await getRuntimeProcessService(runtime)).isRunning(pid);
+}
+/** The launch's child environment: its declared variables, its session, and removals for `undefined` entries. */
+/** Whether a recorded launch is still running: an observed exit or an unknown pid is not. */
+export async function isLaunchAlive(runtime, record) {
+    if (record.exitCode !== undefined || record.pid === undefined)
+        return false;
+    return isPidAlive(runtime, record.pid);
+}
+export function launchChildEnvironment(input) {
+    const entries = Object.entries(input.env ?? {});
+    const declared = entries.filter((entry) => entry[1] !== undefined);
+    const env = Object.fromEntries(declared);
+    env.VIBES_SESSION_ID = input.sessionId;
+    if (input.participantId)
+        env.VIBES_PARTICIPANT_ID = input.participantId;
+    return {
+        env,
+        unsetEnv: entries.filter((entry) => entry[1] === undefined).map(([name]) => name)
+    };
+}
+/**
+ * Spawn the launch detached. A spawn the execution host refuses is refused
+ * `UNAVAILABLE` `launch-spawn-failed` with the host's refusal as its cause:
+ * the message names the command, never the OS or child's text.
+ */
+export async function spawnDetachedLaunch(input) {
+    const fs = await externalFileSystem(input.runtime);
+    await fs.mkdir(dirname(input.stdoutPath), { recursive: true });
+    const { env, unsetEnv } = launchChildEnvironment(input);
+    let pid;
+    try {
+        const handle = await (await getRuntimeExecution(input.runtime)).spawn({
+            command: input.resolved.command,
+            args: [...input.resolved.argv],
+            cwd: input.cwd,
+            env,
+            unsetEnv,
+            envMode: 'inherit',
+            inheritReason: LAUNCH_INHERIT_REASON,
+            stdin: input.resolved.stdin === 'inherit' ? 'inherit' : 'ignore',
+            stdoutFile: input.stdoutPath,
+            stderrFile: input.stderrPath,
+            detached: true
+        });
+        handle.unref?.();
+        pid = handle.pid;
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        throw new CapabilityError(`Failed to launch ${input.resolved.command}.`, 'UNAVAILABLE', {
+            reason: 'launch-spawn-failed',
+            retryable: false,
+            cause: failure,
+            details: failure instanceof Error && isCapabilityError(failure) ? { hostReason: failure.reason } : undefined,
+            recoveryHint: `Make sure ${input.resolved.command} is installed and on PATH`
+        });
+    }
+    if (!Number.isSafeInteger(pid) || pid <= 0) {
+        throw new CapabilityError(`Failed to launch ${input.resolved.command}: the host reported no pid.`, 'UNAVAILABLE', {
+            reason: 'launch-pid-missing',
+            retryable: false
+        });
+    }
+    return { pid };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/launch/consumer/spawn.js.map

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

package/dist/launch/consumer/state-rows.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Launch state rows: the `external.launch_state` storage record, declared as
+ * data. Launch records, attempts and writer claims are rows in it (no raw JSON
+ * state files); only a launch's stdout/stderr logs remain files.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { StorageRecordInterface } from '@vibesdotdev/storage/interfaces/record';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record/descriptor';
+export declare const LAUNCH_STATE_RECORD_ID = "external.launch_state";
+export declare const LaunchStateKindSchema: z.ZodEnum<{
+    record: "record";
+    claim: "claim";
+    attempt: "attempt";
+}>;
+export type LaunchStateKind = z.infer<typeof LaunchStateKindSchema>;
+export declare const LaunchStateRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        record: "record";
+        claim: "claim";
+        attempt: "attempt";
+    }>;
+    sessionId: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type LaunchStateRow = z.infer<typeof LaunchStateRowSchema>;
+export declare const launchStateRecordDescriptor: StorageRecordDescriptorInput;
+/** The row operations the launch store needs; backed by the storage record. */
+export interface LaunchRows {
+    get(id: string): Promise<LaunchStateRow | null>;
+    put(row: LaunchStateRow): Promise<void>;
+    /** Create the row only when no row has this id; `false` when another writer already holds it. */
+    createExclusive(row: LaunchStateRow): Promise<boolean>;
+    remove(id: string): Promise<void>;
+    list(kind: LaunchStateKind, sessionId?: string): Promise<LaunchStateRow[]>;
+}
+export declare function launchRowsOf(record: StorageRecordInterface<LaunchStateRow>): LaunchRows;
+/** The launch state rows the runtime composes. */
+export declare function resolveLaunchRows(runtime: RuntimeRef): Promise<LaunchRows>;
+//# sourceMappingURL=state-rows.d.ts.map

package/dist/launch/consumer/state-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-rows.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/state-rows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAEnG,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;EAAyC,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;iBAO/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,2BAA2B,EAAE,4BA2BzC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,iGAAiG;IACjG,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC3E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,CAAC,cAAc,CAAC,GAAG,UAAU,CAqBvF;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAMhF"}

package/dist/launch/consumer/state-rows.js

@@ -0,0 +1,78 @@
+/**
+ * Launch state rows: the `external.launch_state` storage record, declared as
+ * data. Launch records, attempts and writer claims are rows in it (no raw JSON
+ * state files); only a launch's stdout/stderr logs remain files.
+ */
+import * as z from 'zod/v4';
+import { settle } from '@vibesdotdev/kernel';
+export const LAUNCH_STATE_RECORD_ID = 'external.launch_state';
+export const LaunchStateKindSchema = z.enum(['record', 'attempt', 'claim']);
+export const LaunchStateRowSchema = z.object({
+    id: z.string().min(1),
+    kind: LaunchStateKindSchema,
+    /** The launch session the row belongs to; empty for a claim reserved before its session exists. */
+    sessionId: z.string(),
+    /** The row's value as JSON text; the owning schema in `../schemas.ts` or `store.ts` parses it. */
+    body: z.string()
+});
+export const launchStateRecordDescriptor = {
+    kind: 'storage/record',
+    id: LAUNCH_STATE_RECORD_ID,
+    name: 'External launch state',
+    description: 'Durable launch records, attempt history and writer claims for supervised and detached harness launches',
+    schema: LaunchStateRowSchema,
+    tableName: 'external_launch_state',
+    primaryKey: 'id',
+    indexes: [
+        { name: 'idx_external_launch_state_kind', fields: ['kind'], unique: false },
+        { name: 'idx_external_launch_state_session', fields: ['sessionId'], unique: false }
+    ],
+    version: 1,
+    autoId: { field: 'id', strategy: 'uuid' },
+    softDelete: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: { 'storage.localdb': { dbName: 'external.db', scope: 'global' } },
+    scope: 'global',
+    validateOnWrite: true,
+    validateOnRead: false,
+    internal: false,
+    namespace: 'external.launch_state',
+    tags: ['external', 'launch'],
+    versioning: false,
+    audit: false,
+    changeTracking: false
+};
+export function launchRowsOf(record) {
+    return {
+        get: (id) => record.get(id),
+        async put(row) {
+            await record.upsert(row.id, row, row);
+        },
+        async createExclusive(row) {
+            const outcome = await settle(() => record.create(row));
+            if (outcome.ok)
+                return true;
+            // A refused create is a lost race only when the row now exists.
+            if (await record.get(row.id))
+                return false;
+            throw outcome.cause;
+        },
+        async remove(id) {
+            await record.delete(id);
+        },
+        async list(kind, sessionId) {
+            const where = sessionId === undefined ? { kind } : { kind, sessionId };
+            return (await record.list({ where })).items;
+        }
+    };
+}
+/** The launch state rows the runtime composes. */
+export async function resolveLaunchRows(runtime) {
+    const record = await runtime
+        .query('storage/record')
+        .withId(LAUNCH_STATE_RECORD_ID)
+        .resolve();
+    return launchRowsOf(record);
+}
+//# sourceMappingURL=state-rows.js.map

package/dist/launch/consumer/state-rows.js.map

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