@vibesdotdev/workers 0.0.0-stage → 1.0.0-rc.3

package/dist/execution/thread-host.program.js

@@ -0,0 +1,253 @@
+/**
+ * The worker_thread job execution host's thread program
+ * (`runtime/plugin-host` spawnRuntimeThread; parent: `./thread-host.ts`).
+ *
+ * The thread booted the parent's workspace composition under its own scope,
+ * which drops the queue server's serve role, so it opens no queue and serves
+ * no listener of the parent's. It serves the job root on its job port and
+ * reaches the parent's job-context root on its context port; the wire is
+ * `./thread-host.schemas.ts`.
+ *
+ * Many runs share one thread: each is an async producer the thread
+ * multiplexes. A run resolves its `workers/job` implementation by the
+ * envelope's job type, refuses an implementation generation other than the
+ * envelope's, reports `started`, and only then calls the handler, under the
+ * envelope's own caller and workspace. Its events, subtasks and park go to
+ * the parent as context calls. Once the handler and every context call it
+ * issued have settled, the run reports `settled`. The thread never decides
+ * retirement: the parent derives it from `settled`, or from the thread's exit.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema, settle } from '@vibesdotdev/kernel';
+import { JobExecutionParkTicketSchema } from '@vibesdotdev/kernel/schemas/job-execution';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { LOCAL_ATTESTED_SOURCE, wireConsumer } from '@vibesdotdev/kernel-rpc';
+import { listenMessagePort, MessagePortRpcConnection } from '@vibesdotdev/kernel-rpc/messageport';
+import { readJobImplementationGeneration } from "./implementation-generation.js";
+import { JOB_THREAD_CONTEXT_ROOT_METHODS, JOB_THREAD_ROOT_METHODS, JobThreadAbortSchema, JobThreadCompleteSchema, JobThreadDispatchSchema, JobThreadPayloadSchema, JobThreadReadySchema } from "./thread-host.schemas.js";
+import { callRoot, fromThreadFailure, toThreadFailure } from "./thread-host.wire.js";
+/** The invocation a run's handler runs in: the envelope's own caller and workspace, never this thread's ambient identity. */
+function invocationOf(envelope) {
+    const workspace = envelope.workspace;
+    if (envelope.caller === undefined)
+        return workspace === undefined ? {} : { workspace };
+    // The actor is the admitted caller minus its free-form `extra`, as the runtime's invoke pipeline admits it.
+    const { extra: _extra, ...actor } = envelope.caller;
+    return workspace === undefined ? { actor, actorReplaces: true } : { actor, actorReplaces: true, workspace };
+}
+/** Settle `work` early when `signal` aborts, as the runner's own park and wait do; the work itself runs on. */
+function untilAborted(work, signal) {
+    if (!signal)
+        return work;
+    if (signal.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(signal.reason);
+        signal.addEventListener('abort', onAbort, { once: true });
+        work.then((value) => { signal.removeEventListener('abort', onAbort); resolve(value); }, (error) => { signal.removeEventListener('abort', onAbort); reject(CaughtFailureSchema.parse(error)); });
+    });
+}
+class JobThread {
+    runtime;
+    parent;
+    root = {
+        dispatch: (input) => this.dispatch(input),
+        abort: (input) => this.abort(input),
+        complete: (input) => this.complete(input),
+        drain: () => this.drain()
+    };
+    drained = Promise.withResolvers();
+    runs = new Map();
+    calls = new Map();
+    draining = false;
+    constructor(runtime, parent) {
+        this.runtime = runtime;
+        this.parent = parent;
+    }
+    dispatch(input) {
+        const { runId, envelope } = JobThreadDispatchSchema.parse(input);
+        if (this.draining) {
+            throw new CapabilityError('The job thread is draining.', 'UNAVAILABLE', { reason: 'job-execution-thread-draining' });
+        }
+        if (this.runs.has(runId)) {
+            throw new CapabilityError('The job thread already carries this run.', 'CONFLICT', { reason: 'job-execution-run-duplicate' });
+        }
+        const run = { controller: new AbortController(), calls: new Set() };
+        this.runs.set(runId, run);
+        void this.execute(runId, envelope, run);
+        return { accepted: true };
+    }
+    abort(input) {
+        const { runId, reason } = JobThreadAbortSchema.parse(input);
+        const run = this.runs.get(runId);
+        if (run && !run.controller.signal.aborted) {
+            run.controller.abort(fromThreadFailure(reason));
+            void this.report('aborted', { runId, at: new Date().toISOString() });
+        }
+        return {};
+    }
+    complete(input) {
+        const { callId, outcome } = JobThreadCompleteSchema.parse(input);
+        const pending = this.calls.get(callId);
+        if (!pending)
+            return {};
+        this.calls.delete(callId);
+        if (outcome.ok)
+            pending.resolve(outcome.value);
+        else
+            pending.reject(fromThreadFailure(outcome.failure));
+        return {};
+    }
+    drain() {
+        this.draining = true;
+        if (this.runs.size === 0)
+            this.drained.resolve();
+        return {};
+    }
+    async execute(runId, envelope, run) {
+        const ran = await settle(async () => {
+            const implementation = await this.runtime
+                .query('workers/job')
+                .withId(envelope.jobType)
+                .forHardware(this.runtime.scope.hardware)
+                .enabled()
+                .resolve();
+            const generation = await readJobImplementationGeneration(this.runtime, implementation);
+            if (generation !== envelope.implementationGeneration) {
+                throw new CapabilityError('The job thread runs another generation of this job implementation.', 'CONFLICT', {
+                    reason: 'job-implementation-generation-mismatch', retryable: false,
+                    details: { jobType: envelope.jobType, admitted: envelope.implementationGeneration, resolved: generation }
+                });
+            }
+            if (run.controller.signal.aborted)
+                throw run.controller.signal.reason;
+            // The handler runs only once the parent heard the start, so a thread that blocks inside it has already said so.
+            const started = await callRoot(this.parent, 'started', { runId, at: new Date().toISOString() });
+            if ('refused' in started)
+                throw started.refused;
+            const context = this.contextFor(runId, envelope, run);
+            const value = await this.runtime.runInvocation(() => implementation.handle(context), invocationOf(envelope));
+            const json = JsonValueSchema.optional().safeParse(value);
+            if (!json.success) {
+                throw new CapabilityError('The job handler returned a result that is not JSON.', 'INTERNAL', {
+                    reason: 'job-execution-result-not-json', details: { jobType: envelope.jobType }
+                });
+            }
+            return json.data;
+        });
+        // Execution-scoped work joins before the run is reported settled.
+        await Promise.allSettled(run.calls);
+        this.runs.delete(runId);
+        const outcome = ran.ok ? { ok: true, value: ran.value } : { ok: false, failure: toThreadFailure(ran.cause) };
+        await this.report('settled', { runId, outcome, at: new Date().toISOString() });
+        if (this.draining && this.runs.size === 0)
+            this.drained.resolve();
+    }
+    /** Report to the parent's context root; a report the parent did not hear is still delivered, and one it refused is a diagnostic. */
+    async report(method, input) {
+        const answer = await callRoot(this.parent, method, input);
+        if ('refused' in answer) {
+            this.runtime.diagnostics.error('job-thread-report-refused', { scope: 'workers:job-thread', plugin: 'workers', error: answer.refused });
+        }
+    }
+    /** Issue one context call for run `runId`; the parent answers it with `complete`. */
+    contextCall(runId, run, op) {
+        const callId = crypto.randomUUID();
+        const pending = Promise.withResolvers();
+        this.calls.set(callId, pending);
+        run.calls.add(pending.promise);
+        void callRoot(this.parent, 'call', { runId, callId, op }).then((answer) => {
+            if (!('refused' in answer))
+                return;
+            this.calls.delete(callId);
+            pending.reject(answer.refused);
+        });
+        return pending.promise;
+    }
+    contextFor(runId, envelope, run) {
+        const call = (op) => this.contextCall(runId, run, op);
+        const signal = run.controller.signal;
+        const context = {
+            jobId: envelope.jobId,
+            data: envelope.data,
+            attempt: envelope.claim.attempt,
+            maxAttempts: envelope.maxAttempts,
+            events: {
+                progress: async (progress) => { await call({ method: 'progress', progress }); },
+                emit: async (event, data) => { await call(data === undefined ? { method: 'emit', event } : { method: 'emit', event, data }); },
+                stream: async (data) => { await call({ method: 'stream', data }); },
+                updateMetadata: async (metadata) => { await call({ method: 'updateMetadata', metadata }); }
+            },
+            subtasks: {
+                spawn: async (jobType, data, options) => {
+                    const input = JsonValueSchema.parse(data);
+                    const metadata = options?.metadata;
+                    const answer = await call(metadata === undefined
+                        ? { method: 'spawn', jobType, data: input }
+                        : { method: 'spawn', jobType, data: input, metadata });
+                    const jobId = z.string().min(1).safeParse(answer);
+                    if (!jobId.success) {
+                        throw new CapabilityError('The parent answered a subtask spawn without a job id.', 'INTERNAL', { reason: 'job-execution-spawn-answer-invalid' });
+                    }
+                    return jobId.data;
+                },
+                wait: async (jobId, options) => {
+                    const result = await untilAborted(call({ method: 'wait', jobId }), options?.signal);
+                    // SAFETY: as inline (job-context.ts), the child's queue keeps its handler result; TResult is the caller-selected result contract for the spawned job.
+                    return (result ?? null);
+                }
+            },
+            signal,
+            // A park is a parent slot transition around work kept here; no function crosses.
+            park: async (work) => {
+                const ticket = JobExecutionParkTicketSchema.parse(await call({ method: 'park' }));
+                try {
+                    return await untilAborted(work(), signal);
+                }
+                finally {
+                    await call({ method: 'unpark', ticket });
+                }
+            }
+        };
+        if (envelope.metadata !== undefined)
+            context.metadata = { ...envelope.metadata };
+        return context;
+    }
+}
+/**
+ * Serve this thread's job root until the parent drains it, then dispose the
+ * runtime and close the owner channel. The thread exits when its program
+ * ends; a thread the parent terminates instead exits without this.
+ */
+/** A job thread omits package exports declared for TUI while keeping every other selection. */
+export const omitSurfaces = ['tui'];
+export async function run(runtime, owner, payload) {
+    const input = JobThreadPayloadSchema.parse(payload);
+    const connection = new MessagePortRpcConnection(input.contextPort, input.contextRootRef, { lifecycle: runtime.lifecycle });
+    const parent = wireConsumer({
+        rootRef: connection.rootRef, rootMethods: JOB_THREAD_CONTEXT_ROOT_METHODS,
+        send: (request) => connection.send(request),
+        openStream: (...args) => connection.openStream(...args),
+        closed: connection.closed,
+        onRequest: (handler) => connection.onRequest(handler)
+    }, 'job-thread');
+    const thread = new JobThread(runtime, parent);
+    const listener = listenMessagePort(input.jobPort, {
+        root: thread.root, rootMethods: JOB_THREAD_ROOT_METHODS,
+        pipeline: runtime.invoke, lifecycle: runtime.lifecycle,
+        classifyResult: () => ({ mode: 'inline' }), kindId: 'runtime/rpc',
+        // The job port is the spawning host's own, never exposed to a peer.
+        verifiedPeer: { source: LOCAL_ATTESTED_SOURCE, caller: {} }
+    });
+    owner.postMessage(JobThreadReadySchema.parse({ state: 'ready', jobRootRef: listener.rootRef }));
+    await thread.drained.promise;
+    listener.close();
+    const closed = await settle(() => connection.close());
+    const disposed = await settle(() => runtime.dispose());
+    owner.close();
+    if (!closed.ok)
+        throw closed.cause;
+    if (!disposed.ok)
+        throw disposed.cause;
+}
+//# sourceMappingURL=thread-host.program.js.map

package/dist/execution/thread-host.program.js.map

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

package/dist/execution/thread-host.schemas.d.ts

@@ -0,0 +1,279 @@
+/**
+ * The worker_thread job execution host's wire (`./thread-host.ts`, parent;
+ * `./thread-host.program.ts`, thread): runtime-rpc root methods over one pair
+ * of MessagePort connections per thread incarnation. The thread serves the job
+ * root and the parent serves the job-context root.
+ *
+ * Every call returns at once. What takes time (a run, a child wait, an
+ * unpark, the delivery of an abort) reports back later as its own call, so no
+ * run, wait or park sits inside a request's deadline. A call whose answer
+ * missed its deadline is still delivered: a MessagePort queues it, and a
+ * thread that is synchronously blocked receives it, in order, once it yields.
+ * So a deadline on these calls means only that the caller did not hear back.
+ */
+import * as z from 'zod/v4';
+import type { RpcMessagePort } from '@vibesdotdev/kernel-rpc/messageport';
+/** The job root's methods, served by the thread. */
+export declare const JOB_THREAD_ROOT_METHODS: readonly ["dispatch", "abort", "complete", "drain"];
+/** The job-context root's methods, served by the parent. */
+export declare const JOB_THREAD_CONTEXT_ROOT_METHODS: readonly ["started", "call", "aborted", "settled"];
+/** The role a job thread's boot declares (`runtime/plugin-host` captureRuntimeThreadBoot). */
+export declare const JOB_THREAD_ROLE = "workers.job-thread";
+/**
+ * A failure as it crosses. A `CapabilityError` crosses with every field the
+ * runner classifies retry, cancel and permanence by. Any other error crosses
+ * by its class name and message, the text the queue keeps for it when it runs
+ * inline.
+ */
+export declare const JobThreadFailureSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"capability">;
+    code: z.ZodString & z.ZodType<import("@vibesdotdev/kernel").CapabilityErrorCode, string, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel").CapabilityErrorCode, string>>;
+    reason: z.ZodString;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+    recoveryHint: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"error">;
+    name: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type JobThreadFailure = z.output<typeof JobThreadFailureSchema>;
+/** A settled call or run: its JSON value, or its failure. */
+export declare const JobThreadOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    value: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strict>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    failure: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"capability">;
+        code: z.ZodString & z.ZodType<import("@vibesdotdev/kernel").CapabilityErrorCode, string, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel").CapabilityErrorCode, string>>;
+        reason: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        recoveryHint: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"error">;
+        name: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>], "ok">;
+export type JobThreadOutcome = z.output<typeof JobThreadOutcomeSchema>;
+/** One job-context operation a thread's producer issues: the parent port method it calls, with its arguments. */
+export declare const JobThreadContextOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    method: z.ZodLiteral<"progress">;
+    progress: z.ZodUnion<readonly [z.ZodNumber, z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>]>;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"emit">;
+    event: z.ZodString;
+    data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"stream">;
+    data: z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"updateMetadata">;
+    metadata: z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"spawn">;
+    jobType: z.ZodString;
+    data: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+    metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"wait">;
+    jobId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"park">;
+}, z.core.$strict>, z.ZodObject<{
+    method: z.ZodLiteral<"unpark">;
+    ticket: z.ZodReadonly<z.ZodObject<{
+        ticket: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "method">;
+export type JobThreadContextOp = z.output<typeof JobThreadContextOpSchema>;
+/** Job root `dispatch`: run one admitted envelope as run `runId`. */
+export declare const JobThreadDispatchSchema: z.ZodObject<{
+    runId: z.ZodString;
+    envelope: z.ZodReadonly<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        queue: z.ZodString;
+        jobId: z.ZodString;
+        jobType: z.ZodString;
+        isolation: z.ZodEnum<{
+            inline: "inline";
+            worker_thread: "worker_thread";
+            subprocess: "subprocess";
+        }>;
+        implementationGeneration: z.ZodString;
+        claim: z.ZodReadonly<z.ZodObject<{
+            token: z.ZodString;
+            generation: z.ZodNumber;
+            attempt: z.ZodNumber;
+            owner: z.ZodString;
+        }, z.core.$strict>>;
+        maxAttempts: z.ZodNumber;
+        data: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+        metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        caller: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            agentId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harness: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            agentSystemId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harnessSessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            userId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            orgId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            projectId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            teamId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            home: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                organization: "organization";
+                team: "team";
+            }>>;
+            projectIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>>;
+            participantId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            sessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            instanceId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>>>;
+        workspace: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            root: z.ZodOptional<z.ZodString>;
+            sessionId: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            remoteHostId: z.ZodOptional<z.ZodString>;
+            access: z.ZodOptional<z.ZodEnum<{
+                read: "read";
+                write: "write";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Job root `abort`: deliver the parent's cancellation, and its reason, to run `runId`'s producer. */
+export declare const JobThreadAbortSchema: z.ZodObject<{
+    runId: z.ZodString;
+    reason: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"capability">;
+        code: z.ZodString & z.ZodType<import("@vibesdotdev/kernel").CapabilityErrorCode, string, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel").CapabilityErrorCode, string>>;
+        reason: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        recoveryHint: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"error">;
+        name: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+/** Job root `complete`: the parent finished context call `callId`. */
+export declare const JobThreadCompleteSchema: z.ZodObject<{
+    callId: z.ZodString;
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        value: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        failure: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"capability">;
+            code: z.ZodString & z.ZodType<import("@vibesdotdev/kernel").CapabilityErrorCode, string, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel").CapabilityErrorCode, string>>;
+            reason: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            recoveryHint: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"error">;
+            name: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>], "ok">;
+}, z.core.$strict>;
+/**
+ * Context root `started`: the thread resolved run `runId`'s implementation at
+ * the envelope's generation, and calls its handler once this is answered. A
+ * run that settles without it never started a producer.
+ */
+export declare const JobThreadStartedSchema: z.ZodObject<{
+    runId: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strict>;
+/** Context root `call`: run `runId`'s producer issued context operation `op` as call `callId`. */
+export declare const JobThreadCallSchema: z.ZodObject<{
+    runId: z.ZodString;
+    callId: z.ZodString;
+    op: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        method: z.ZodLiteral<"progress">;
+        progress: z.ZodUnion<readonly [z.ZodNumber, z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"emit">;
+        event: z.ZodString;
+        data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"stream">;
+        data: z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"updateMetadata">;
+        metadata: z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"spawn">;
+        jobType: z.ZodString;
+        data: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+        metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"wait">;
+        jobId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"park">;
+    }, z.core.$strict>, z.ZodObject<{
+        method: z.ZodLiteral<"unpark">;
+        ticket: z.ZodReadonly<z.ZodObject<{
+            ticket: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "method">;
+}, z.core.$strict>;
+/** Context root `aborted`: the thread delivered run `runId`'s abort into its producer's signal. */
+export declare const JobThreadAbortedSchema: z.ZodObject<{
+    runId: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strict>;
+/** Context root `settled`: run `runId`'s producer and every context call it issued have settled. */
+export declare const JobThreadSettledSchema: z.ZodObject<{
+    runId: z.ZodString;
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        value: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        failure: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"capability">;
+            code: z.ZodString & z.ZodType<import("@vibesdotdev/kernel").CapabilityErrorCode, string, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel").CapabilityErrorCode, string>>;
+            reason: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            recoveryHint: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"error">;
+            name: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>], "ok">;
+    at: z.ZodString;
+}, z.core.$strict>;
+/**
+ * The program's payload (`spawnRuntimeThread`): the incarnation id the parent
+ * issued, the port the thread serves its job root on, and the port and root
+ * ref of the parent's job-context root. Both ports are transferred.
+ */
+export declare const JobThreadPayloadSchema: z.ZodObject<{
+    incarnation: z.ZodString;
+    jobPort: z.ZodCustom<RpcMessagePort, RpcMessagePort>;
+    contextPort: z.ZodCustom<RpcMessagePort, RpcMessagePort>;
+    contextRootRef: z.ZodString;
+}, z.core.$strict>;
+/** The thread's one owner message: its job root is served, at this ref. */
+export declare const JobThreadReadySchema: z.ZodObject<{
+    state: z.ZodLiteral<"ready">;
+    jobRootRef: z.ZodString;
+}, z.core.$strict>;
+//# sourceMappingURL=thread-host.schemas.d.ts.map

package/dist/execution/thread-host.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-host.schemas.d.ts","sourceRoot":"","sources":["../../src/execution/thread-host.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,qDAAsD,CAAC;AAE3F,4DAA4D;AAC5D,eAAO,MAAM,+BAA+B,oDAAqD,CAAC;AAElG,8FAA8F;AAC9F,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;4BAWjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;0BAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,iHAAiH;AACjH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BASnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM3E,qEAAqE;AACrE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA0F,CAAC;AAC/H,sGAAsG;AACtG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;kBAA4E,CAAC;AAC9G,sEAAsE;AACtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;kBAA+E,CAAC;AAEpH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;kBAA0D,CAAC;AAC9F,kGAAkG;AAClG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAgG,CAAC;AACjI,mGAAmG;AACnG,eAAO,MAAM,sBAAsB;;;kBAA0D,CAAC;AAC9F,oGAAoG;AACpG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBAA2F,CAAC;AAS/H;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;kBAKxB,CAAC;AAEZ,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB;;;kBAAkF,CAAC"}