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

package/dist/jsonrpc/schemas.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Wire and option schemas for the JSON-RPC child client.
+ *
+ * The envelope is parsed from a line the child wrote: hostile by default. Ids
+ * are bounded (a string of at most 256 characters or a safe integer), a method
+ * is a non-empty string of at most 1024 characters, and nothing here reads or
+ * recurses into `params`/`result`/`data`: those are JSON by construction (they
+ * came out of `JSON.parse`) and are carried as values, never walked.
+ */
+import * as z from 'zod/v4';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+/** The default hard cap on one line a child writes: 1 MiB. */
+export declare const DEFAULT_MAX_LINE_BYTES = 1048576;
+/** The largest `maxLineBytes` a caller may declare: 256 MiB. */
+export declare const MAX_DECLARABLE_LINE_BYTES = 268435456;
+/** The default grace between SIGTERM and SIGKILL, in milliseconds. */
+export declare const DEFAULT_GRACE_MS = 2000;
+/** The default wait for a SIGKILLed child to be confirmed gone, in milliseconds. */
+export declare const DEFAULT_KILL_WAIT_MS = 5000;
+/** The default notification queue capacity. */
+export declare const DEFAULT_NOTIFICATION_CAPACITY = 1024;
+/** The default size of the stderr diagnostic tail, in bytes. */
+export declare const DEFAULT_STDERR_TAIL_BYTES = 8192;
+/** The largest timer a host honours: lifecycle waits and timeouts refuse more. */
+export declare const MAX_TIMER_MS = 2147483647;
+/** A JSON-RPC id: a bounded string or a safe integer. */
+export declare const JsonRpcIdSchema: z.ZodUnion<readonly [z.ZodString, z.ZodInt]>;
+export type JsonRpcId = z.infer<typeof JsonRpcIdSchema>;
+/** One decoded line of child output, before it is classified. */
+export declare const JsonRpcEnvelopeSchema: z.ZodObject<{
+    jsonrpc: z.ZodOptional<z.ZodLiteral<"2.0">>;
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodInt]>, z.ZodNull]>>;
+    method: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;
+    result: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodCatch<z.ZodInt>;
+        message: z.ZodCatch<z.ZodString>;
+        data: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Whether outgoing messages carry `"jsonrpc": "2.0"` (`jsonrpc-2.0`) or omit it (`lite`, as Codex app-server writes). */
+export declare const JsonRpcEnvelopeStyleSchema: z.ZodEnum<{
+    "jsonrpc-2.0": "jsonrpc-2.0";
+    lite: "lite";
+}>;
+export type JsonRpcEnvelopeStyle = z.infer<typeof JsonRpcEnvelopeStyleSchema>;
+/** Whether notifications are queued for `notifications()` or declared unwanted. */
+export declare const JsonRpcNotificationModeSchema: z.ZodEnum<{
+    queue: "queue";
+    discard: "discard";
+}>;
+/** The declared numeric options of a client; every value is the caller's, with the defaults above. */
+export declare const JsonRpcChildLimitsSchema: z.ZodObject<{
+    maxLineBytes: z.ZodDefault<z.ZodInt>;
+    graceMs: z.ZodDefault<z.ZodInt>;
+    killWaitMs: z.ZodDefault<z.ZodInt>;
+    notificationCapacity: z.ZodDefault<z.ZodInt>;
+    stderrTailBytes: z.ZodDefault<z.ZodInt>;
+    notifications: z.ZodDefault<z.ZodEnum<{
+        queue: "queue";
+        discard: "discard";
+    }>>;
+    envelope: z.ZodDefault<z.ZodEnum<{
+        "jsonrpc-2.0": "jsonrpc-2.0";
+        lite: "lite";
+    }>>;
+}, z.core.$strip>;
+export type JsonRpcChildLimits = z.infer<typeof JsonRpcChildLimitsSchema>;
+/** The declared options of one request. */
+export declare const JsonRpcRequestLimitsSchema: z.ZodObject<{
+    deadlineMs: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/jsonrpc/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAChD,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,YAAc,CAAC;AACrD,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAC1C,+CAA+C;AAC/C,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AACnD,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,kFAAkF;AAClF,eAAO,MAAM,YAAY,aAAgB,CAAC;AAE1C,yDAAyD;AACzD,eAAO,MAAM,eAAe,8CAA0C,CAAC;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAexD,iEAAiE;AACjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAOhC,CAAC;AAEH,0HAA0H;AAC1H,eAAO,MAAM,0BAA0B;;;EAAkC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;EAA+B,CAAC;AAE1E,sGAAsG;AACtG,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAQnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B;;iBAErC,CAAC"}

package/dist/jsonrpc/schemas.js

@@ -0,0 +1,65 @@
+/**
+ * Wire and option schemas for the JSON-RPC child client.
+ *
+ * The envelope is parsed from a line the child wrote: hostile by default. Ids
+ * are bounded (a string of at most 256 characters or a safe integer), a method
+ * is a non-empty string of at most 1024 characters, and nothing here reads or
+ * recurses into `params`/`result`/`data`: those are JSON by construction (they
+ * came out of `JSON.parse`) and are carried as values, never walked.
+ */
+import * as z from 'zod/v4';
+/** The default hard cap on one line a child writes: 1 MiB. */
+export const DEFAULT_MAX_LINE_BYTES = 1_048_576;
+/** The largest `maxLineBytes` a caller may declare: 256 MiB. */
+export const MAX_DECLARABLE_LINE_BYTES = 268_435_456;
+/** The default grace between SIGTERM and SIGKILL, in milliseconds. */
+export const DEFAULT_GRACE_MS = 2_000;
+/** The default wait for a SIGKILLed child to be confirmed gone, in milliseconds. */
+export const DEFAULT_KILL_WAIT_MS = 5_000;
+/** The default notification queue capacity. */
+export const DEFAULT_NOTIFICATION_CAPACITY = 1_024;
+/** The default size of the stderr diagnostic tail, in bytes. */
+export const DEFAULT_STDERR_TAIL_BYTES = 8_192;
+/** The largest timer a host honours: lifecycle waits and timeouts refuse more. */
+export const MAX_TIMER_MS = 2_147_483_647;
+/** A JSON-RPC id: a bounded string or a safe integer. */
+export const JsonRpcIdSchema = z.union([z.string().max(256), z.int()]);
+/**
+ * A JSON value taken from `JSON.parse`. It is JSON by construction, so it is
+ * not re-validated: re-walking a hostile, deeply nested value is exactly the
+ * recursion the line cap exists to bound.
+ */
+const WireJsonSchema = z.custom();
+const WireErrorSchema = z.object({
+    code: z.int().catch(0),
+    message: z.string().catch(''),
+    data: WireJsonSchema.optional()
+});
+/** One decoded line of child output, before it is classified. */
+export const JsonRpcEnvelopeSchema = z.object({
+    jsonrpc: z.literal('2.0').optional(),
+    id: z.union([JsonRpcIdSchema, z.null()]).optional(),
+    method: z.string().min(1).max(1_024).optional(),
+    params: WireJsonSchema.optional(),
+    result: WireJsonSchema.optional(),
+    error: WireErrorSchema.optional()
+});
+/** Whether outgoing messages carry `"jsonrpc": "2.0"` (`jsonrpc-2.0`) or omit it (`lite`, as Codex app-server writes). */
+export const JsonRpcEnvelopeStyleSchema = z.enum(['jsonrpc-2.0', 'lite']);
+/** Whether notifications are queued for `notifications()` or declared unwanted. */
+export const JsonRpcNotificationModeSchema = z.enum(['queue', 'discard']);
+/** The declared numeric options of a client; every value is the caller's, with the defaults above. */
+export const JsonRpcChildLimitsSchema = z.object({
+    maxLineBytes: z.int().min(1).max(MAX_DECLARABLE_LINE_BYTES).default(DEFAULT_MAX_LINE_BYTES),
+    graceMs: z.int().min(0).max(MAX_TIMER_MS).default(DEFAULT_GRACE_MS),
+    killWaitMs: z.int().min(0).max(MAX_TIMER_MS).default(DEFAULT_KILL_WAIT_MS),
+    notificationCapacity: z.int().min(1).max(1_000_000).default(DEFAULT_NOTIFICATION_CAPACITY),
+    stderrTailBytes: z.int().min(0).max(1_048_576).default(DEFAULT_STDERR_TAIL_BYTES),
+    notifications: JsonRpcNotificationModeSchema.default('queue'),
+    envelope: JsonRpcEnvelopeStyleSchema.default('jsonrpc-2.0')
+});
+/** The declared options of one request. */
+export const JsonRpcRequestLimitsSchema = z.object({
+    deadlineMs: z.int().min(1).max(MAX_TIMER_MS).optional()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/jsonrpc/schemas.js.map

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

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

@@ -0,0 +1,5 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type ExecuteLaunchInput, type LaunchExecution } from '../schemas.ts';
+export type { ExecuteLaunchInput, LaunchExecution, LaunchSupervision } from '../schemas.ts';
+export declare function executeLaunch(input: ExecuteLaunchInput, runtime: RuntimeRef): Promise<LaunchExecution>;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKvH,OAAO,EAAwB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAA6C,MAAM,eAAe,CAAC;AAqB/I,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5F,wBAAsB,aAAa,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,eAAe,CAAC,CA8R1B"}

package/dist/launch/consumer/execute.js

@@ -0,0 +1,358 @@
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, settle } from '@vibesdotdev/kernel';
+import { getPathRoots } from '@vibesdotdev/paths';
+import { resolveExternalHostDescriptor } from "../../external-tool/runtime.js";
+import { LAUNCH_MODE_HEADLESS } from "../schemas.js";
+import { resolveLaunchMode } from "../resolve.js";
+import { composeLaunchPrompt, launchAbsolutePath, readLaunchBrief } from "./prompt.js";
+import { prepareLaunchSession, writeLaunchScratchpad } from "./prepare.js";
+import { launchPaths } from "./paths.js";
+import { rotateLaunchLogsForSession } from "./rotate-logs.js";
+import { launchChildEnvironment, spawnDetachedLaunch } from "./spawn.js";
+import { runPmTask } from '@vibesdotdev/pm/tasks';
+import { externalFileSystem } from "../../utils/runtime-fs.js";
+import { appendLaunchAttempt, bindLaunchSession, claimLaunchWriter, completeSupervisedLaunch, lookupLaunchReplay, openLaunchStore, reserveLaunchKey, redactLaunchArgv, writeLaunchRecord } from "./store.js";
+export async function executeLaunch(input, runtime) {
+    // A stable key is the only cross-request identity. Without one, each call prepares a new session.
+    const explicitKey = input.idempotencyKey?.trim();
+    const harnessName = input.harness.trim();
+    const home = input.home?.trim() || getPathRoots(runtime).activeHome;
+    const store = await openLaunchStore(runtime, home);
+    // The launch's cwd is its workspace (claims are keyed by it): the caller's
+    // directory, else the bound workspace, never the executable's cwd.
+    const requestedCwd = input.cwd?.trim();
+    const cwd = requestedCwd
+        ? await launchAbsolutePath(runtime, requestedCwd)
+        : await runtime.context('runtime/workspace-path');
+    if (explicitKey) {
+        const host = resolveExternalHostDescriptor(runtime, harnessName);
+        const replay = await lookupLaunchReplay(store, explicitKey, {
+            cwd,
+            harness: harnessName,
+            toolId: host?.id,
+            sessionId: input.sessionId?.trim()
+        });
+        if (replay.kind === 'record')
+            return { status: 'record', record: replay.record };
+        if (replay.kind === 'pending') {
+            return { status: 'pending', sessionId: replay.sessionId, attemptId: replay.attemptId };
+        }
+        if (replay.kind === 'conflict')
+            return { status: 'conflict', ...replay };
+    }
+    const harness = harnessName;
+    const hostDescriptor = resolveExternalHostDescriptor(runtime, harness);
+    if (!hostDescriptor) {
+        const available = runtime
+            .query('external/host')
+            .enabled()
+            .descriptors()
+            .map((descriptor) => descriptor.id)
+            .join(', ');
+        throw new CapabilityError(`Unknown external launch host '${harness}'`, 'NOT_FOUND', {
+            reason: 'launch-host-unknown',
+            retryable: false,
+            recoveryHint: available ? `Available hosts: ${available}` : undefined
+        });
+    }
+    const toolId = hostDescriptor.id;
+    const mode = input.mode?.trim() || hostDescriptor.manifest.launch?.defaultMode || LAUNCH_MODE_HEADLESS;
+    const userPrompt = await readLaunchBrief(runtime, {
+        briefPath: input.brief,
+        prompt: input.prompt
+    });
+    if (!userPrompt) {
+        throw new CapabilityError('A --prompt or --brief is required', 'INVALID_INPUT', {
+            reason: 'launch-prompt-required',
+            retryable: false,
+            recoveryHint: 'Pass --prompt "…" or --brief path/to/brief.md'
+        });
+    }
+    let externalTool;
+    try {
+        externalTool = await runtime.query('external/host').withId(toolId).resolve();
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (failure instanceof Error && isCapabilityError(failure))
+            throw failure;
+        const available = runtime
+            .query('external/host')
+            .enabled()
+            .descriptors()
+            .map((descriptor) => descriptor.id)
+            .join(', ');
+        throw new CapabilityError(`Failed to resolve external/host '${toolId}'.`, 'UNAVAILABLE', {
+            reason: 'launch-host-unresolvable',
+            retryable: false,
+            cause: failure,
+            recoveryHint: available ? `Available targets: ${available}` : undefined
+        });
+    }
+    // Preflight: a harness without MCP cannot reach the Vibes tools its session is built on.
+    if (input.requireVibesMcp && !externalTool.manifest.mcp.supported) {
+        throw new CapabilityError(`Harness '${toolId}' does not support MCP, so it cannot use the Vibes tools.`, 'UNAVAILABLE', {
+            reason: 'launch-harness-mcp-unsupported',
+            retryable: false,
+            details: { harness, toolId },
+            recoveryHint: 'Use a harness whose external/host manifest declares mcp.supported, or configure the Vibes MCP server for it.'
+        });
+    }
+    const title = input.title?.trim() || `launch:${toolId}`;
+    let reservedAttemptId;
+    if (explicitKey) {
+        const reserved = await reserveLaunchKey(store, {
+            idempotencyKey: explicitKey,
+            cwd,
+            harness,
+            toolId,
+            mode,
+            command: toolId,
+            readOnly: input.readOnly
+        });
+        if (reserved.kind !== 'reserved') {
+            if (reserved.kind === 'record')
+                return { status: 'record', record: reserved.record };
+            if (reserved.kind === 'pending') {
+                return { status: 'pending', sessionId: reserved.sessionId, attemptId: reserved.attemptId };
+            }
+            if (reserved.kind === 'conflict') {
+                return {
+                    status: 'conflict',
+                    sessionId: reserved.sessionId,
+                    attemptId: reserved.attemptId,
+                    reason: reserved.reason
+                };
+            }
+            return {
+                status: 'conflict',
+                sessionId: null,
+                attemptId: null,
+                reason: 'Launch reservation is in progress.'
+            };
+        }
+        reservedAttemptId = reserved.attemptId;
+    }
+    const prepared = await prepareLaunchSession({
+        harness,
+        toolId,
+        cwd,
+        title,
+        brief: userPrompt,
+        sessionId: input.sessionId,
+        model: input.model
+    }, explicitKey
+        ? (sessionId) => bindLaunchSession(store, explicitKey, sessionId)
+        : undefined, runtime);
+    const prompt = composeLaunchPrompt(prepared.sessionId, userPrompt);
+    const resolved = resolveLaunchMode({
+        launch: externalTool.manifest.launch,
+        detectionCommand: externalTool.manifest.detection?.command,
+        mode,
+        vars: {
+            prompt,
+            cwd,
+            sessionId: prepared.sessionId,
+            harness,
+            toolId,
+            title: prepared.title,
+            model: input.model,
+            effort: input.effort,
+            provider: input.provider,
+            executionPolicy: input.executionPolicy,
+            outputSchema: input.outputSchema
+        }
+    });
+    const paths = launchPaths(prepared.sessionId, home);
+    const idempotencyKey = input.idempotencyKey?.trim() || prepared.sessionId;
+    let intent;
+    if (reservedAttemptId) {
+        intent = await appendLaunchAttempt(store, {
+            attemptId: reservedAttemptId,
+            sessionId: prepared.sessionId,
+            idempotencyKey,
+            phase: 'intent',
+            exitObserved: false,
+            harness,
+            toolId,
+            mode: resolved.mode,
+            command: resolved.command,
+            cwd,
+            createdAt: new Date().toISOString()
+        });
+    }
+    else {
+        // A second writer on this workspace is refused CONFLICT launch-workspace-claimed by the store.
+        const claimed = await claimLaunchWriter(store, {
+            sessionId: prepared.sessionId,
+            idempotencyKey,
+            harness,
+            toolId,
+            mode: resolved.mode,
+            command: resolved.command,
+            cwd,
+            readOnly: input.readOnly
+        });
+        if (claimed.kind !== 'started') {
+            throw new CapabilityError(claimed.kind === 'conflict'
+                ? claimed.reason
+                : 'This launch key already has an attempt. Not starting another writer.', 'UNAVAILABLE', {
+                reason: claimed.kind === 'conflict' ? 'launch-key-claim-unreadable' : 'launch-key-claimed',
+                retryable: false,
+                recoveryHint: claimed.kind === 'replay'
+                    ? `Attempt ${claimed.attemptId} is ${claimed.disposition}. Not returning another session's state.`
+                    : 'The key claim is unreadable.'
+            });
+        }
+        intent = claimed.attempt;
+    }
+    const attemptFields = {
+        attemptId: intent.attemptId,
+        sessionId: prepared.sessionId,
+        idempotencyKey,
+        exitObserved: false,
+        harness,
+        toolId,
+        mode: resolved.mode,
+        command: resolved.command,
+        cwd: intent.cwd
+    };
+    // Advisory housekeeping must report genuine failures, but cannot prevent
+    // an otherwise valid launch. It bounds existing files, not a running child.
+    const rotation = await rotateLaunchLogsForSession(runtime, prepared.sessionId, store.home);
+    if (rotation.failed.length > 0) {
+        runtime.diagnostics.error('Launch log rotation failed', {
+            scope: 'external.launch',
+            plugin: 'launch.capture',
+            error: new CapabilityError('Launch log rotation failed.', 'UNAVAILABLE', {
+                reason: 'launch-rotation-failed',
+                details: { failedFiles: rotation.failed.length, failures: rotation.failed.map(({ failure }) => ({ name: failure.name, code: failure.code ?? null, reason: failure.reason ?? null })) }
+            })
+        });
+    }
+    if (input.supervision) {
+        return runSupervisedLaunch({
+            supervision: input.supervision,
+            runtime,
+            store,
+            resolved,
+            cwd,
+            paths,
+            prepared,
+            attemptFields,
+            harness,
+            toolId,
+            userPrompt,
+            model: input.model,
+            intentAttemptId: intent.attemptId
+        });
+    }
+    let pid;
+    try {
+        pid = (await spawnDetachedLaunch({
+            resolved,
+            runtime,
+            cwd,
+            sessionId: prepared.sessionId,
+            participantId: prepared.participantId,
+            stdoutPath: paths.stdoutPath,
+            stderrPath: paths.stderrPath
+        })).pid;
+    }
+    catch (error) {
+        // The spawn's outcome is unknown to the store: record it so the key is never silently re-run.
+        await appendLaunchAttempt(store, { ...attemptFields, phase: 'unknown', createdAt: new Date().toISOString() });
+        throw error;
+    }
+    await appendLaunchAttempt(store, { ...attemptFields, phase: 'dispatched', pid, createdAt: new Date().toISOString() });
+    const record = {
+        sessionId: prepared.sessionId,
+        harness,
+        toolId,
+        mode: resolved.mode,
+        title: prepared.title,
+        cwd,
+        model: input.model,
+        command: resolved.command,
+        attemptId: intent.attemptId,
+        argv: redactLaunchArgv(resolved.argv, [userPrompt]),
+        pid,
+        startedAt: new Date().toISOString(),
+        stdoutPath: paths.stdoutPath,
+        stderrPath: paths.stderrPath,
+        statePath: paths.statePath
+    };
+    await writeLaunchRecord(store, record);
+    await writeLaunchScratchpad(prepared.sessionId, record, runtime);
+    return { status: 'record', record };
+}
+/** Run the harness under PM, await its exit, and record what it wrote and how it ended. */
+async function runSupervisedLaunch(input) {
+    if (input.resolved.stdin === 'inherit') {
+        throw new CapabilityError(`Launch mode '${input.resolved.mode}' reads the terminal; it cannot run supervised.`, 'INVALID_INPUT', {
+            reason: 'launch-mode-interactive',
+            retryable: false,
+            recoveryHint: "Choose the harness's headless mode (for example 'print' or 'exec')."
+        });
+    }
+    const { env } = launchChildEnvironment({ sessionId: input.prepared.sessionId, participantId: input.prepared.participantId });
+    const command = {
+        command: input.resolved.command,
+        args: [...input.resolved.argv],
+        cwd: input.cwd,
+        name: `${input.toolId} launch ${input.prepared.sessionId}`,
+        env,
+        allowFailure: true
+    };
+    if (input.supervision.inheritEnv)
+        command.inheritEnv = [...input.supervision.inheritEnv];
+    if (input.supervision.timeoutMs !== undefined)
+        command.timeoutMs = input.supervision.timeoutMs;
+    const options = { runId: input.supervision.runId, tags: ['launch'], returnInterrupted: true };
+    if (input.supervision.signal)
+        options.signal = input.supervision.signal;
+    const ran = await settle(() => runPmTask(input.runtime, command, options));
+    if (!ran.ok) {
+        // PM could not run or await the harness: its outcome is unknown, but this launch no longer writes.
+        await appendLaunchAttempt(input.store, { ...input.attemptFields, phase: 'unknown', createdAt: new Date().toISOString() });
+        await completeSupervisedLaunch(input.store, { ...input.attemptFields, attemptId: input.intentAttemptId });
+        throw ran.cause;
+    }
+    const result = ran.value;
+    const fs = await externalFileSystem(input.runtime);
+    await fs.mkdir(fs.dirname(input.paths.stdoutPath), { recursive: true });
+    await fs.writeFile(input.paths.stdoutPath, result.stdout);
+    await fs.writeFile(input.paths.stderrPath, result.stderr);
+    const completedAttempt = { ...input.attemptFields, attemptId: input.intentAttemptId };
+    if (result.pid !== undefined)
+        completedAttempt.pid = result.pid;
+    await completeSupervisedLaunch(input.store, completedAttempt);
+    const record = {
+        sessionId: input.prepared.sessionId,
+        harness: input.harness,
+        toolId: input.toolId,
+        mode: input.resolved.mode,
+        title: input.prepared.title,
+        cwd: input.cwd,
+        model: input.model,
+        command: input.resolved.command,
+        attemptId: input.intentAttemptId,
+        argv: redactLaunchArgv(input.resolved.argv, [input.userPrompt]),
+        startedAt: new Date().toISOString(),
+        exitCode: result.exitCode,
+        exitedAt: new Date().toISOString(),
+        stdoutPath: input.paths.stdoutPath,
+        stderrPath: input.paths.stderrPath,
+        statePath: input.paths.statePath
+    };
+    if (result.pid !== undefined)
+        record.pid = result.pid;
+    await writeLaunchRecord(input.store, record);
+    await writeLaunchScratchpad(input.prepared.sessionId, record, input.runtime);
+    const exited = { status: 'exited', record, exitCode: result.exitCode, stdout: result.stdout, stderr: result.stderr };
+    if (result.termination)
+        exited.termination = result.termination;
+    if (input.resolved.structuredOutput)
+        exited.structuredOutput = input.resolved.structuredOutput;
+    return exited;
+}
+//# sourceMappingURL=execute.js.map

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

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

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

@@ -0,0 +1,15 @@
+export interface LaunchPathLayout {
+    home: string;
+    sessionDir: string;
+    attemptsDir: string;
+    stdoutPath: string;
+    stderrPath: string;
+    statePath: string;
+    indexPath: string;
+}
+/**
+ * Launch state for one session under `home`: the runtime's per-user
+ * `paths/roots` activeHome, handed in by the caller that holds the runtime.
+ */
+export declare function launchPaths(sessionId: string, home: string): LaunchPathLayout;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/paths.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAW7E"}

package/dist/launch/consumer/paths.js

@@ -0,0 +1,18 @@
+import { join } from '@vibesdotdev/filesystem';
+/**
+ * Launch state for one session under `home`: the runtime's per-user
+ * `paths/roots` activeHome, handed in by the caller that holds the runtime.
+ */
+export function launchPaths(sessionId, home) {
+    const sessionDir = join(home, 'sessions', sessionId, 'launch');
+    return {
+        home,
+        sessionDir,
+        attemptsDir: join(sessionDir, 'attempts'),
+        stdoutPath: join(sessionDir, 'stdout.log'),
+        stderrPath: join(sessionDir, 'stderr.log'),
+        statePath: join(sessionDir, 'state.json'),
+        indexPath: join(home, 'launch', 'index.json')
+    };
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/launch/consumer/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAY/C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,IAAY;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO;QACN,IAAI;QACJ,UAAU;QACV,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;QACzC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;QAC1C,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;QACzC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC;KAC7C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,25 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type LaunchRecord } from '../schemas.ts';
+export interface PrepareLaunchSessionInput {
+    harness: string;
+    toolId: string;
+    cwd: string;
+    title: string;
+    brief: string;
+    sessionId?: string;
+    model?: string;
+}
+export interface PreparedLaunchSession {
+    sessionId: string;
+    title: string;
+    reused: boolean;
+    participantId: string;
+}
+export declare function prepareLaunchSession(input: PrepareLaunchSessionInput, onSession: ((sessionId: string) => Promise<void>) | undefined, runtime: RuntimeRef): Promise<PreparedLaunchSession>;
+/**
+ * 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 declare function writeLaunchScratchpad(sessionId: string, record: LaunchRecord, runtime: RuntimeRef): Promise<void>;
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/launch/consumer/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOvE,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACtB;AA+BD,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,yBAAyB,EAChC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EAC7D,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,qBAAqB,CAAC,CAoHhC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf"}