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

package/dist/client/execution/recorded.js

@@ -0,0 +1,74 @@
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { JsonValueSchema } from "@vibesdotdev/kernel/schemas/json";
+import { RunnableDescriptorSchema } from "../../schemas/descriptors.js";
+import { RunnableNativeExecutionSchema } from "../../schemas/runs.js";
+import { captureRunAdmission, assertRunWrite } from "../records/authority.js";
+import { RunnableExecutionInputSchema } from "../../schemas/contracts/index.js";
+import { RunnableRecordOwner } from "../records/owner.js";
+import { RunnableNativeOwner } from "../native/owner.js";
+import { RunnableNativeCompletion } from "../native/completion.js";
+import { RunnableSelection } from "./selection.js";
+import { RunnableTransport } from "../transport.js";
+import { RunnableSupervision } from "../native/supervision.js";
+import { prepareRecordedExecution } from "./prepare-record.js";
+import { produceRecordedOutcome } from "./produce.js";
+import { finalizeRecordedOutcome } from "./finalize.js";
+import { finalMemoRevision } from "./memo.js";
+export class RunnableRecordedExecution {
+    runtime;
+    records;
+    native;
+    completion;
+    selection;
+    transport;
+    supervision;
+    constructor(runtime, records, native, completion, selection, transport, supervision) {
+        this.runtime = runtime;
+        this.records = records;
+        this.native = native;
+        this.completion = completion;
+        this.selection = selection;
+        this.transport = transport;
+        this.supervision = supervision;
+    }
+    async recordNativeExecution(id, input, execute, options, nativeExecution) {
+        const selected = await this.selection.selectNamed(id);
+        if (selected.descriptor.execution !== 'native') {
+            throw new CapabilityError('Receiving execution must belong to a native Runnable.', 'INVALID_INPUT', { reason: 'runnable-native-admission-invalid' });
+        }
+        const owner = { execute };
+        if (selected.impl.prepareInput)
+            owner.prepareInput = selected.impl.prepareInput.bind(selected.impl);
+        return this.executeRecorded({ ...selected.descriptor, memo: false }, input, options, { named: true }, owner, nativeExecution);
+    }
+    async recordPreparedExecution(runId, execute, nativeExecution, options) {
+        const receipt = RunnableNativeExecutionSchema.parse(nativeExecution);
+        const held = options?.held?.record.id === runId ? options.held : await this.records.inputAdmission(runId);
+        if (!held || held.admission.owner.kind !== 'runnable/runnable') {
+            throw new CapabilityError('Prepared native execution needs its selected owner admission.', 'PERMISSION_DENIED', { reason: 'runnable-input-admission-mismatch' });
+        }
+        assertRunWrite(held.record, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+        const selected = await this.runtime.query('runnable/runnable').withId(held.admission.owner.id).select();
+        if (!selected)
+            throw new CapabilityError('The prepared native owner is unavailable.', 'UNAVAILABLE', { reason: 'runnable-native-owner-unavailable' });
+        const descriptor = RunnableDescriptorSchema.parse(selected.descriptor);
+        if (descriptor.id !== held.record.runnableId || descriptor.execution !== 'native') {
+            throw new CapabilityError('The receiving owner differs from its prepared admission.', 'PERMISSION_DENIED', { reason: 'runnable-native-execution-mismatch' });
+        }
+        return this.executeRecorded({ ...descriptor, memo: false, nativeResult: receipt.result.mode }, JsonValueSchema.parse(held.record.metadata['runnable.submittedInput']), {
+            signal: options?.signal, configUnit: RunnableExecutionInputSchema.shape.configUnit.parse(held.record.metadata.configUnit)
+        }, { named: true }, { execute }, receipt, held.record);
+    }
+    async executeRecorded(descriptor, input, options, rankReason, implementation, nativeExecution, preparedRecord) {
+        return this.runtime.runInvocation(async () => {
+            const prepared = await prepareRecordedExecution(this, descriptor, input, options, rankReason, implementation, nativeExecution, preparedRecord);
+            const produced = await produceRecordedOutcome(this, prepared, descriptor, implementation);
+            const refusal = await finalMemoRevision(this.runtime, descriptor, prepared.runtimeRevision, prepared.memoUnits, produced.outcome, prepared.record);
+            const result = await finalizeRecordedOutcome(this, prepared, produced, descriptor, refusal);
+            // SAFETY: Shared Outcome/JSON is validated by the execution owner. O is the caller's
+            // declared result type; it is erased and is not proved by OutcomeSchema.
+            return { runId: result.runId, outcome: result.outcome };
+        });
+    }
+}
+//# sourceMappingURL=recorded.js.map

package/dist/client/execution/recorded.js.map

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

package/dist/client/execution/selection.d.ts

@@ -0,0 +1,19 @@
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+import { type RunnableResolvedDescriptor, type RunnableRole } from "../../schemas/descriptors.ts";
+import type { EntityKind } from "../../schemas/outcome.ts";
+import type { RunnableImplementation } from "../../schemas/contracts/index.ts";
+import { type RunnableDescription } from "../../schemas/description.ts";
+export declare class RunnableSelection {
+    readonly runtime: RuntimeRef;
+    constructor(runtime: RuntimeRef);
+    select(query: {
+        role: RunnableRole;
+        entity?: EntityKind;
+    }): Promise<RunnableResolvedDescriptor[]>;
+    selectNamed(id: string): Promise<{
+        descriptor: RunnableResolvedDescriptor;
+        impl: RunnableImplementation;
+    }>;
+    describe(id: string): Promise<RunnableDescription>;
+}
+//# sourceMappingURL=selection.d.ts.map

package/dist/client/execution/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/client/execution/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAA4B,KAAK,0BAA0B,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAkC,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAA+D,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAErI,qBAAa,iBAAiB;IACjB,QAAQ,CAAC,OAAO,EAAE,UAAU;gBAAnB,OAAO,EAAE,UAAU;IAElC,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAQjG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,0BAA0B,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,CAAC;IAQ1G,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAaxD"}

package/dist/client/execution/selection.js

@@ -0,0 +1,38 @@
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { JsonValueFromReaderSchema } from "@vibesdotdev/kernel/schemas/json";
+import { RunnableDescriptorSchema } from "../../schemas/descriptors.js";
+import { RunnableDescriptionSchema, RunnableDescriptionSchemasSchema } from "../../schemas/description.js";
+export class RunnableSelection {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async select(query) {
+        return (await this.runtime.query('runnable/runnable').enabled().descriptorsAsync())
+            .map((descriptor) => RunnableDescriptorSchema.parse(descriptor))
+            .filter((descriptor) => descriptor.roles.includes(query.role) &&
+            (!query.entity || !descriptor.entities || descriptor.entities.includes(query.entity)))
+            .sort((left, right) => left.cost - right.cost || left.id.localeCompare(right.id));
+    }
+    async selectNamed(id) {
+        const selected = await this.runtime.query('runnable/runnable').withId(id).enabled().select();
+        if (!selected) {
+            throw new CapabilityError(`Runnable '${id}' is not registered.`, 'UNAVAILABLE', { reason: 'runnable-unknown' });
+        }
+        return { descriptor: RunnableDescriptorSchema.parse(selected.descriptor), impl: selected.impl };
+    }
+    async describe(id) {
+        const selected = await this.selectNamed(id);
+        const executor = selected.descriptor.execution === 'native' ? null : await this.runtime
+            .query('runnable/executor')
+            .enabled().filter(candidate => candidate.runnableType === selected.descriptor.type).select();
+        const described = executor
+            ? await executor.impl.describe?.(selected.descriptor.settings)
+            : await selected.impl.describe?.();
+        return RunnableDescriptionSchema.parse(JsonValueFromReaderSchema.parse({
+            descriptor: selected.descriptor,
+            ...RunnableDescriptionSchemasSchema.parse(described ?? {})
+        }));
+    }
+}
+//# sourceMappingURL=selection.js.map

package/dist/client/execution/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/client/execution/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAsD,MAAM,8BAA8B,CAAC;AAG5H,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAA4B,MAAM,8BAA8B,CAAC;AAErI,MAAM,OAAO,iBAAiB;IACR;IAArB,YAAqB,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAE5C,KAAK,CAAC,MAAM,CAAC,KAAkD;QAC9D,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;aACjF,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;aAC/D,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;aACtF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAA4C,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;QACxI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjG,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO;aACrF,KAAK,CAA+E,mBAAmB,CAAC;aACxG,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,KAAK,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9F,MAAM,SAAS,GAAG,QAAQ;YACzB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC9D,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpC,OAAO,yBAAyB,CAAC,KAAK,CAAC,yBAAyB,CAAC,KAAK,CAAC;YACtE,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,GAAG,gCAAgC,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;SAC1D,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/client/native/completion.d.ts

@@ -0,0 +1,19 @@
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+import { type RunnableNativeObservation, type RunRecord } from "../../schemas/runs.ts";
+import type { RunHandle, RunEmitterOptions } from "../../schemas/contracts/index.ts";
+import { RunnableRecordOwner } from "../records/owner.ts";
+import { RunnableNativeOwner } from "./owner.ts";
+export declare class RunnableNativeCompletion {
+    readonly runtime: RuntimeRef;
+    private readonly records;
+    private readonly native;
+    private readonly createRun;
+    private readonly nativeObservers;
+    private readonly nativeFinalizers;
+    constructor(runtime: RuntimeRef, records: RunnableRecordOwner, native: RunnableNativeOwner, createRun: (options: RunEmitterOptions) => Promise<RunHandle>);
+    reconcileNativeExecution(runId: string): Promise<RunnableNativeObservation>;
+    reconcileNativeOnce(runId: string): Promise<RunnableNativeObservation>;
+    followNativeCompletion(record: RunRecord): Promise<void>;
+    join(runId: string, generation: number): Promise<void>;
+}
+//# sourceMappingURL=completion.d.ts.map

package/dist/client/native/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/client/native/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG/G,OAAO,EAAyH,KAAK,yBAAyB,EAA4B,KAAK,SAAS,EAA4E,MAAM,uBAAuB,CAAC;AAGlT,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,wBAAwB;IAIxB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAuB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyD;gBAErE,OAAO,EAAE,UAAU,EAAmB,OAAO,EAAE,mBAAmB,EACrE,MAAM,EAAE,mBAAmB,EAAmB,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,CAAC;IAEvH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAe3E,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAuDtE,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CxD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5D"}

package/dist/client/native/completion.js

@@ -0,0 +1,158 @@
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from "@vibesdotdev/kernel";
+import { hashHex } from "@vibesdotdev/crypto/hash";
+import { JsonObjectSchema, JsonValueFromReaderSchema } from "@vibesdotdev/kernel/schemas/json";
+import { RunCompletedPayloadSchema, RUN_COMPLETED_EVENT, RunnableNativeExecutionStateSchema, RUN_NATIVE_EXECUTION_METADATA_KEY, RunnableNativeCompletionOutboxSchema, RUN_NATIVE_COMPLETION_METADATA_KEY } from "../../schemas/runs.js";
+import { canonical } from "../records/identity.js";
+import { captureRunAdmission, assertRunWrite } from "../records/authority.js";
+import { RunnableRecordOwner } from "../records/owner.js";
+import { RunnableNativeOwner } from "./owner.js";
+export class RunnableNativeCompletion {
+    runtime;
+    records;
+    native;
+    createRun;
+    nativeObservers = new Map();
+    nativeFinalizers = new Map();
+    constructor(runtime, records, native, createRun) {
+        this.runtime = runtime;
+        this.records = records;
+        this.native = native;
+        this.createRun = createRun;
+    }
+    async reconcileNativeExecution(runId) {
+        const record = await this.records.storedRecord(runId);
+        if (!record)
+            throw new CapabilityError('Native execution record is unavailable.', 'NOT_FOUND', { reason: 'runnable-run-not-found' });
+        assertRunWrite(record, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+        const pending = this.nativeFinalizers.get(runId);
+        if (pending)
+            return pending;
+        const work = this.reconcileNativeOnce(runId);
+        this.nativeFinalizers.set(runId, work);
+        try {
+            return await work;
+        }
+        finally {
+            if (this.nativeFinalizers.get(runId) === work)
+                this.nativeFinalizers.delete(runId);
+        }
+    }
+    async reconcileNativeOnce(runId) {
+        let record = await this.records.storedRecord(runId);
+        if (!record)
+            throw new CapabilityError('Native execution record is unavailable.', 'NOT_FOUND', { reason: 'runnable-run-not-found' });
+        assertRunWrite(record, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+        const observed = await this.native.observeNative(record);
+        if (!observed)
+            throw new CapabilityError('Run has no admitted native execution reference.', 'INVALID_INPUT', { reason: 'runnable-native-execution-absent' });
+        // The body persists its attempt evidence before the queue commits its
+        // receipt. Refresh that evidence after observing the terminal receipt.
+        record = await this.records.storedRecord(runId);
+        if (!record)
+            throw new CapabilityError('Native execution record is unavailable.', 'NOT_FOUND', { reason: 'runnable-run-not-found' });
+        assertRunWrite(record, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+        const execution = RunnableNativeExecutionStateSchema.parse(record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY]);
+        if (observed.terminal && execution.generation !== observed.generation) {
+            throw new CapabilityError('Native execution changed while its terminal receipt was being observed.', 'CONFLICT', { reason: 'runnable-native-execution-changed' });
+        }
+        const outbox = RunnableNativeCompletionOutboxSchema.parse(record.metadata[RUN_NATIVE_COMPLETION_METADATA_KEY] ?? []);
+        const records = await this.records.records();
+        if (observed.terminal && !outbox.some(completion => completion.receiptId === observed.receiptId)) {
+            if (!observed.outcome)
+                throw new CapabilityError('Terminal native receipt has no task outcome.', 'UNAVAILABLE', { reason: 'runnable-native-outcome-unavailable' });
+            const attempt = execution.attempts.at(-1);
+            if (!attempt || attempt.generation !== observed.generation)
+                throw new CapabilityError('Terminal native receipt has no admitted attempt.', 'UNAVAILABLE', { reason: 'runnable-native-attempt-unavailable' });
+            const view = this.native.nativeView(record, observed);
+            const eventId = `completion-${await hashHex(this.runtime, 'sha256', canonical({ runId, receipt: observed.receiptId }))}`;
+            outbox.push({
+                receiptId: observed.receiptId,
+                eventId, generation: observed.generation, attempt: attempt.attempt,
+                timestamp: observed.endedAt ?? Date.now(), delivered: false,
+                payload: RunCompletedPayloadSchema.parse(JsonValueFromReaderSchema.parse({ runId, occurrenceId: eventId, generation: observed.generation, attempt: attempt.attempt, runnableId: view.runnableId, status: view.status, outcome: observed.outcome, parentRunId: view.parentRunId }))
+            });
+            view.metadata[RUN_NATIVE_COMPLETION_METADATA_KEY] = JsonValueFromReaderSchema.parse(outbox);
+            await records.save(view);
+        }
+        for (const completion of outbox.filter(occurrence => !occurrence.delivered)) {
+            const emitter = await this.createRun({ runId, type: record.runnableType, name: record.runnableId,
+                executionGeneration: completion.generation, executionAttempt: completion.attempt });
+            await emitter.event(RUN_COMPLETED_EVENT, JsonObjectSchema.parse(completion.payload), { eventId: completion.eventId, timestamp: completion.timestamp });
+            await emitter.event('status', { status: completion.payload.status }, { eventId: `${completion.eventId}:status`, timestamp: completion.timestamp });
+            await this.runtime.hooks('runnable.run').emit('completed', completion.payload);
+            // Another native generation may have started while delivery waited.
+            // Only acknowledge this occurrence on that latest admitted snapshot.
+            const latest = await this.records.storedRecord(runId);
+            if (!latest)
+                throw new CapabilityError('Native execution record is unavailable.', 'NOT_FOUND', { reason: 'runnable-run-not-found' });
+            assertRunWrite(latest, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+            const pending = RunnableNativeCompletionOutboxSchema.parse(latest.metadata[RUN_NATIVE_COMPLETION_METADATA_KEY] ?? []);
+            const delivered = pending.find(occurrence => occurrence.receiptId === completion.receiptId);
+            if (!delivered || canonical({ ...delivered, delivered: false }) !== canonical({ ...completion, delivered: false })) {
+                throw new CapabilityError('Native completion occurrence changed during delivery.', 'CONFLICT', { reason: 'runnable-native-completion-changed' });
+            }
+            delivered.delivered = true;
+            latest.metadata[RUN_NATIVE_COMPLETION_METADATA_KEY] = JsonValueFromReaderSchema.parse(pending);
+            await records.save(latest);
+        }
+        return observed;
+    }
+    async followNativeCompletion(record) {
+        const execution = RunnableNativeExecutionStateSchema.parse(record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY]);
+        const observerId = `${record.id}:${execution.generation}`;
+        if (this.nativeObservers.has(observerId))
+            return;
+        const owner = await this.native.nativeObserver(record);
+        if (!owner.subscribeObservation)
+            throw new CapabilityError('The native execution owner cannot subscribe to its durable receipt.', 'UNAVAILABLE', { reason: 'runnable-native-subscription-unavailable' });
+        const subscribe = owner.subscribeObservation.bind(owner);
+        const invocation = this.runtime.captureInvocation();
+        const ready = Promise.withResolvers();
+        const work = this.runtime.lifecycle.own(() => invocation.run(async () => {
+            let changed = Promise.withResolvers();
+            const stop = await subscribe(record, () => changed.resolve());
+            try {
+                ready.resolve();
+                for (;;) {
+                    const notified = changed.promise;
+                    // A running receipt changes on every heartbeat and checkpoint. Only a terminal one has
+                    // completion to record; observing the queue receipt does not reread the run record.
+                    const observed = await this.native.observeNative(record);
+                    if (observed?.terminal !== false && (await this.reconcileNativeExecution(record.id)).terminal)
+                        return;
+                    const signal = this.runtime.lifecycle.signal;
+                    await new Promise(resolve => {
+                        const cancelled = () => resolve();
+                        if (signal.aborted)
+                            resolve();
+                        else
+                            signal.addEventListener('abort', cancelled, { once: true });
+                        void notified.then(() => {
+                            signal.removeEventListener('abort', cancelled);
+                            resolve();
+                        });
+                    });
+                    if (signal.aborted)
+                        return;
+                    changed = Promise.withResolvers();
+                }
+            }
+            finally {
+                await stop();
+            }
+        }));
+        this.nativeObservers.set(observerId, work);
+        void work.catch(error => {
+            ready.reject(error);
+            const caught = CaughtFailureSchema.parse(error);
+            if (!(this.runtime.lifecycle.signal.aborted && isCapabilityError(caught) && caught.code === 'CANCELLED')) {
+                this.runtime.diagnostics.error('Native Runnable completion observation failed', { scope: 'runnable:native-completion', plugin: 'runnable', error: caught });
+            }
+        }).finally(() => this.nativeObservers.delete(observerId));
+        await ready.promise;
+    }
+    async join(runId, generation) {
+        await this.nativeObservers.get(`${runId}:${generation}`);
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/client/native/completion.js.map

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

package/dist/client/native/controls.d.ts

@@ -0,0 +1,18 @@
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+import { type RunnableNativeObservation, type RunRecord } from "../../schemas/runs.ts";
+import { type RunnableControlInput, type RunnableControlAction } from "../../schemas/contracts/index.ts";
+import { RunnableRecordOwner } from "../records/owner.ts";
+import { RunnableNativeOwner } from "./owner.ts";
+import { RunnableSupervision } from "./supervision.ts";
+export declare class RunnableControls {
+    readonly runtime: RuntimeRef;
+    private readonly records;
+    private readonly native;
+    private readonly supervision;
+    constructor(runtime: RuntimeRef, records: RunnableRecordOwner, native: RunnableNativeOwner, supervision: RunnableSupervision);
+    observeNativeExecution(runId: string): Promise<RunnableNativeObservation | null>;
+    controlRecord(runId: string): Promise<RunRecord | null>;
+    controls(runId: string): Promise<RunnableControlAction[]>;
+    control(input: RunnableControlInput): Promise<boolean>;
+}
+//# sourceMappingURL=controls.d.ts.map

package/dist/client/native/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../src/client/native/controls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAqC,KAAK,yBAAyB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE1H,OAAO,EAA2D,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAElK,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAuB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADtD,OAAO,EAAE,UAAU,EAAmB,OAAO,EAAE,mBAAmB,EACrE,MAAM,EAAE,mBAAmB,EAAmB,WAAW,EAAE,mBAAmB;IAE1F,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAKhF,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAUzD,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAwB5D"}

package/dist/client/native/controls.js

@@ -0,0 +1,69 @@
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { RUN_NATIVE_EXECUTION_METADATA_KEY } from "../../schemas/runs.js";
+import { captureRunAdmission, assertRunWrite } from "../records/authority.js";
+import { RunnableControlActionSchema, RunnableControlInputSchema } from "../../schemas/contracts/index.js";
+import { RUNNABLE_STATE_HOST_CONTEXT_ID } from "../../runtime/host.js";
+import { RunnableRecordOwner } from "../records/owner.js";
+import { RunnableNativeOwner } from "./owner.js";
+import { RunnableSupervision } from "./supervision.js";
+export class RunnableControls {
+    runtime;
+    records;
+    native;
+    supervision;
+    constructor(runtime, records, native, supervision) {
+        this.runtime = runtime;
+        this.records = records;
+        this.native = native;
+        this.supervision = supervision;
+    }
+    async observeNativeExecution(runId) {
+        const record = await this.controlRecord(runId);
+        return record ? this.native.observeNative(record) : null;
+    }
+    async controlRecord(runId) {
+        if (!this.runtime.hasContext(RUNNABLE_STATE_HOST_CONTEXT_ID))
+            return null;
+        const host = await this.records.stateHost();
+        if (!host.reads && !host.records)
+            return null;
+        return this.records.storedRecord(runId);
+    }
+    async controls(runId) {
+        const record = await this.controlRecord(runId);
+        if (record) {
+            const owner = await this.native.executionController(record);
+            if (owner?.controls)
+                return RunnableControlActionSchema.array().parse(await owner.controls(record));
+            if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] !== undefined)
+                return [];
+        }
+        return await this.supervision.isSupervised(runId) ? ['stop', 'pause', 'resume'] : [];
+    }
+    async control(input) {
+        const request = RunnableControlInputSchema.parse(input);
+        const record = await this.controlRecord(request.runId);
+        if (!record)
+            return (await this.supervision.supervisor()).control(request.runId, request.action);
+        assertRunWrite(record, captureRunAdmission(this.runtime), await this.records.scopeIdentity());
+        if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] !== undefined &&
+            request.action === 'resume' && !request.observation) {
+            throw new CapabilityError('Resuming a native execution requires its observed receipt.', 'INVALID_INPUT', {
+                reason: 'runnable-native-observation-required', retryable: false
+            });
+        }
+        const owner = await this.native.executionController(record);
+        const actions = owner?.controls ? RunnableControlActionSchema.array().parse(await owner.controls(record)) : [];
+        if (owner?.control && actions.includes(request.action)) {
+            const { runId: _runId, ...control } = request;
+            return owner.control(record, control);
+        }
+        if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined && await this.supervision.isSupervised(request.runId)) {
+            return (await this.supervision.supervisor()).control(request.runId, request.action);
+        }
+        throw new CapabilityError('The admitted owner does not support this Runnable control.', 'UNAVAILABLE', {
+            reason: 'runnable-control-unavailable', details: { action: request.action }
+        });
+    }
+}
+//# sourceMappingURL=controls.js.map

package/dist/client/native/controls.js.map

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

package/dist/client/native/owner.d.ts

@@ -0,0 +1,36 @@
+import type { RunnableRecordOwner } from '../records/owner.ts';
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+import { type RunnableNativeObservation, type RunRecord, type RunnableTrackedRun, type RunnableExecutionOwner } from "../../schemas/runs.ts";
+import type { NativeOwner } from "../../schemas/contracts/index.ts";
+export declare class RunnableNativeOwner {
+    readonly runtime: RuntimeRef;
+    private readonly records;
+    constructor(runtime: RuntimeRef, records: RunnableRecordOwner);
+    unverifiedView<T extends RunRecord | RunnableTrackedRun>(record: T): T;
+    resolveNativeOwner(owner: RunnableExecutionOwner): Promise<NativeOwner>;
+    nativeObserverView(owner: RunnableExecutionOwner, implementation: NativeOwner): {
+        owner: {
+            kind: "runnable/runnable" | "runnable/executor";
+            id: string;
+        };
+        observe: (record: RunRecord) => Promise<RunnableNativeObservation>;
+        subscribeObservation: ((record: RunRecord, changed: () => void) => Promise<() => void | Promise<void>>) | undefined;
+    };
+    nativeObserver(record: RunRecord): Promise<{
+        owner: {
+            kind: "runnable/runnable" | "runnable/executor";
+            id: string;
+        };
+        observe: (record: RunRecord) => Promise<RunnableNativeObservation>;
+        subscribeObservation: ((record: RunRecord, changed: () => void) => Promise<() => void | Promise<void>>) | undefined;
+    }>;
+    observeNative(record: RunRecord): Promise<RunnableNativeObservation | null>;
+    nativeView(record: RunRecord, observation: RunnableNativeObservation): RunRecord;
+    namedRun<T extends {
+        runnableId: string;
+        name?: string;
+    }>(run: T): T;
+    trackingView(input: RunnableTrackedRun | RunRecord): Promise<RunnableTrackedRun>;
+    executionController(record: RunRecord): Promise<NativeOwner | null>;
+}
+//# sourceMappingURL=owner.d.ts.map

package/dist/client/native/owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner.d.ts","sourceRoot":"","sources":["../../../src/client/native/owner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAgJ,KAAK,yBAAyB,EAAE,KAAK,SAAS,EAA4B,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAErT,OAAO,KAAK,EAA0D,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE5H,qBAAa,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAA7C,OAAO,EAAE,UAAU,EAAmB,OAAO,EAAE,mBAAmB;IAEvF,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;IAQhE,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7E,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,WAAW;;;;;;;;IAWvE,cAAc,CAAC,MAAM,EAAE,SAAS;;;;;;;;IAchC,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAKjF,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,GAAG,SAAS;IAkBhF,QAAQ,CAAC,CAAC,SAAS;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAM9D,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBhF,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CAMzE"}

package/dist/client/native/owner.js

@@ -0,0 +1,111 @@
+import { bindRunContext, runContextBindings, runContextReferenceId } from "../../context.js";
+import { RunnableDescriptorSchema } from "../../schemas/descriptors.js";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { JsonValueFromReaderSchema } from "@vibesdotdev/kernel/schemas/json";
+import { RunRecordSchema, RunnableNativeExecutionStateSchema, RunnableNativeObservationSchema, RUN_NATIVE_EXECUTION_METADATA_KEY, pinnedRunResultMode, RunnableTrackedRunSchema } from "../../schemas/runs.js";
+import { readInputAdmission } from "../records/input-admission.js";
+export class RunnableNativeOwner {
+    runtime;
+    records;
+    constructor(runtime, records) {
+        this.runtime = runtime;
+        this.records = records;
+    }
+    unverifiedView(record) {
+        if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined && record.runnableType === 'job'
+            && record.ref?.jobId && ['running', 'loading', 'paused', 'stopping', 'queued'].includes(record.status)) {
+            return { ...record, status: 'unverified' };
+        }
+        return record;
+    }
+    async resolveNativeOwner(owner) {
+        return this.runtime.query(owner.kind).withId(owner.id).resolve();
+    }
+    nativeObserverView(owner, implementation) {
+        if (!implementation.observe)
+            throw new CapabilityError('The admitted native owner cannot observe its receipt.', 'UNAVAILABLE', {
+                reason: 'runnable-native-observation-unavailable'
+            });
+        return {
+            owner,
+            observe: implementation.observe.bind(implementation),
+            subscribeObservation: implementation.subscribeObservation?.bind(implementation)
+        };
+    }
+    async nativeObserver(record) {
+        const execution = RunnableNativeExecutionStateSchema.parse(record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY]);
+        if (execution.observer) {
+            return this.nativeObserverView(execution.observer, await this.resolveNativeOwner(execution.observer));
+        }
+        const native = await this.runtime.query('runnable/runnable')
+            .withId(record.runnableId).enabled().select();
+        if (native?.impl.observe)
+            return this.nativeObserverView({ kind: 'runnable/runnable', id: native.descriptor.id }, native.impl);
+        const executor = await this.runtime.query('runnable/executor')
+            .enabled().filter(owner => owner.runnableType === record.runnableType).select();
+        if (!executor?.impl.observe)
+            throw new CapabilityError('The native execution owner does not provide receipt observation.', 'UNAVAILABLE', { reason: 'runnable-native-observation-unavailable' });
+        return this.nativeObserverView({ kind: 'runnable/executor', id: executor.descriptor.id }, executor.impl);
+    }
+    async observeNative(record) {
+        if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined)
+            return null;
+        return RunnableNativeObservationSchema.parse(await (await this.nativeObserver(record)).observe(record));
+    }
+    nativeView(record, observation) {
+        const view = RunRecordSchema.parse(record);
+        view.status = observation.status;
+        if (observation.progress !== undefined)
+            view.progress = observation.progress;
+        if (observation.outcome !== undefined)
+            view.outcome = observation.outcome;
+        else
+            delete view.outcome;
+        const execution = record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined
+            ? undefined
+            : RunnableNativeExecutionStateSchema.safeParse(record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY]);
+        const attemptEndedAt = execution?.success && observation.terminal
+            ? execution.data.attempts.findLast(attempt => attempt.generation === observation.generation)?.endedAt
+            : undefined;
+        const endedAt = observation.endedAt ?? attemptEndedAt;
+        if (endedAt !== undefined)
+            view.endedAt = endedAt;
+        else
+            delete view.endedAt;
+        return view;
+    }
+    namedRun(run) {
+        if (run.name)
+            return run;
+        const declared = this.runtime.query('runnable/runnable').withId(run.runnableId).descriptors()[0];
+        return declared ? { ...run, name: RunnableDescriptorSchema.parse(declared).name } : run;
+    }
+    async trackingView(input) {
+        const record = this.namedRun(RunnableTrackedRunSchema.parse(JsonValueFromReaderSchema.parse(input)));
+        const resultMode = record.resultMode ?? pinnedRunResultMode(record.metadata);
+        if (resultMode)
+            record.resultMode = resultMode;
+        const binding = runContextBindings(this.runtime).find(binding => binding.runnables.includes(record.runnableId));
+        if (binding) {
+            const value = JsonValueFromReaderSchema.parse(record);
+            const referenceId = runContextReferenceId(value, binding);
+            const reference = referenceId ? await this.records.storedRecord(referenceId) : null;
+            record.context = bindRunContext(value, binding, reference ? JsonValueFromReaderSchema.parse(reference) : undefined);
+        }
+        if (record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined) {
+            return this.unverifiedView(record);
+        }
+        if ((record.status === 'completed' || record.status === 'stopped') && record.outcome !== undefined && record.endedAt !== undefined)
+            return record;
+        const strict = RunRecordSchema.parse(record);
+        const observation = await this.observeNative(strict);
+        return observation ? RunnableTrackedRunSchema.parse({ ...this.nativeView(strict, observation), context: record.context, ...(resultMode ? { resultMode } : {}) }) : record;
+    }
+    async executionController(record) {
+        const native = record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY] === undefined
+            ? undefined : RunnableNativeExecutionStateSchema.parse(record.metadata[RUN_NATIVE_EXECUTION_METADATA_KEY]);
+        const owner = native?.observer ?? (await readInputAdmission(this.runtime, record))?.owner;
+        return owner ? this.resolveNativeOwner(owner) : null;
+    }
+}
+//# sourceMappingURL=owner.js.map