@zhin.js/workroom 0.0.0 → 0.0.1

package/lib/workroom/remote-assignment-dispatch-command.js

@@ -0,0 +1,56 @@
+/**
+ * Trusted claim-side command. The external producer never supplies an
+ * Assignment Envelope: Kernel issuance is persisted first, then this
+ * projection repairs Link + Outbox idempotently before waking the worker.
+ */
+export class RemoteAssignmentDispatchCommandService {
+    #kernel;
+    #admission;
+    #scheduler;
+    constructor(options) {
+        this.#kernel = options.kernel;
+        this.#admission = options.admission;
+        this.#scheduler = options.scheduler;
+    }
+    async issue(request) {
+        const issued = await this.#kernel.issueRemoteAssignment(request);
+        await this.#project(issued);
+        await this.#scheduler.drain();
+        return issued;
+    }
+    async recover() {
+        const results = [];
+        let admitted = false;
+        for (const issued of await this.#kernel.listRemoteAssignmentIssuances()) {
+            try {
+                await this.#project(issued);
+                admitted = true;
+                results.push(Object.freeze({ operationId: issued.operationId, status: 'admitted' }));
+            }
+            catch (error) {
+                results.push(Object.freeze({
+                    operationId: issued.operationId,
+                    status: 'blocked',
+                    reason: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+        if (admitted)
+            await this.#scheduler.drain();
+        return Object.freeze(results);
+    }
+    async #project(issued) {
+        await this.#admission.admit({
+            envelope: issued.envelope,
+            dispatch: dispatchInput(issued),
+            linkedAt: issued.issuedAt,
+            reconcileDeadline: issued.reconcileDeadline,
+            enqueuedAt: issued.issuedAt,
+        });
+    }
+}
+function dispatchInput(issued) {
+    const { version: _version, dispatchId: _dispatchId, messageId: _messageId, ...input } = issued.dispatchItem.envelope;
+    return input;
+}
+//# sourceMappingURL=remote-assignment-dispatch-command.js.map

package/lib/workroom/remote-assignment-dispatch-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-assignment-dispatch-command.js","sourceRoot":"","sources":["../../src/workroom/remote-assignment-dispatch-command.ts"],"names":[],"mappings":"AAoCA;;;;GAIG;AACH,MAAM,OAAO,sCAAsC;IACxC,OAAO,CAA0D;IACjE,UAAU,CAAwC;IAClD,UAAU,CAAmC;IAEtD,YAAY,OAAsD;QAChE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK,CACT,OAA6C;QAE7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAA6C,EAAE,CAAC;QAC7D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;YACxE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC5B,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YACvF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;oBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC/D,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QACD,IAAI,QAAQ;YAAE,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+C;QAC5D,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,UAAU,EAAE,MAAM,CAAC,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,aAAa,CACpB,MAA+C;IAE/C,MAAM,EACJ,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,WAAW,EACvB,SAAS,EAAE,UAAU,EACrB,GAAG,KAAK,EACT,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/workroom/remote-assignment-issuance.d.ts

@@ -0,0 +1,88 @@
+import type { WorkroomAcceptanceContract } from './acceptance-policy.js';
+import type { GovernedDisclosureManifestSnapshot } from '../data-governance/disclosure-manifest.js';
+import { type AssignmentExecutionEnvelope, type AssignmentExecutionFactAnchor, type AssignmentExecutionSnapshotReference, type AssignmentExecutionWorkspaceReference, type AssignmentExecutorRole } from './assignment-executor.js';
+import { type WorkroomGithubWorkspaceReference, type WorkroomRemoteDispatchOutboxItem, type WorkroomRemoteEndpointSnapshot } from './remote-dispatch.js';
+export interface WorkroomRemoteAssignmentClaimRequest {
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly agentDefinitionId: string;
+    readonly endpointId: string;
+}
+export interface WorkroomRemoteAssignmentAuthorityInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly task: Readonly<{
+        key: string;
+        revision: number;
+        acceptanceContract: WorkroomAcceptanceContract;
+    }>;
+    readonly assignment: Readonly<{
+        id: string;
+        revision: number;
+        attempt: number;
+        fence: number;
+    }>;
+    readonly requestedAgentDefinitionId: string;
+    readonly requestedEndpointId: string;
+    readonly factAnchor: AssignmentExecutionFactAnchor;
+}
+/**
+ * Generation-owned resolver. Its implementation must intersect the current
+ * Run Profile pin, Agent Definition, role/task policy and generation catalog;
+ * callers only name the desired definition/endpoint and cannot provide refs.
+ */
+export interface WorkroomRemoteAssignmentAuthorityPort {
+    resolve(input: WorkroomRemoteAssignmentAuthorityInput): Promise<WorkroomRemoteAssignmentResolvedAuthority>;
+}
+export interface WorkroomRemoteAssignmentResolvedAuthority {
+    /** Authorized execution identity; never copied from the scheduler request. */
+    readonly principalId: string;
+    readonly role: AssignmentExecutorRole;
+    readonly agentDefinitionId: string;
+    readonly agentDefinition: AssignmentExecutionSnapshotReference;
+    readonly plan: AssignmentExecutionSnapshotReference;
+    readonly contextPolicy: AssignmentExecutionSnapshotReference;
+    /** Exact six-way generation/profile/definition/role/task/policy intersection. */
+    readonly capabilitySnapshot: AssignmentExecutionSnapshotReference;
+    /** Composite current Profile + execution/risk policy pin. */
+    readonly policySnapshot: AssignmentExecutionSnapshotReference;
+    readonly workspace: AssignmentExecutionWorkspaceReference;
+    readonly endpoint: WorkroomRemoteEndpointSnapshot;
+    readonly contextView: Readonly<{
+        ref: string;
+        hash: string;
+    }>;
+    readonly capabilityGrantRef: string;
+    readonly disclosureManifest: GovernedDisclosureManifestSnapshot;
+    readonly remoteWorkspace: WorkroomGithubWorkspaceReference;
+}
+export interface WorkroomRemoteAssignmentIssuance {
+    readonly operationId: string;
+    readonly requestDigest: string;
+    readonly issuedAt: number;
+    readonly reconcileDeadline: number;
+    readonly envelope: AssignmentExecutionEnvelope;
+    readonly dispatchItem: WorkroomRemoteDispatchOutboxItem;
+}
+export interface MaterializeWorkroomRemoteAssignmentInput {
+    readonly request: WorkroomRemoteAssignmentClaimRequest;
+    readonly taskRevision: number;
+    readonly assignmentId: string;
+    readonly assignmentRevision: number;
+    readonly attempt: number;
+    readonly fence: number;
+    readonly issuedAt: number;
+    readonly leaseExpiresAt: number;
+    readonly reconcileDeadline: number;
+    readonly acceptanceContract: WorkroomAcceptanceContract;
+    readonly factAnchor: AssignmentExecutionFactAnchor;
+    readonly authority: WorkroomRemoteAssignmentResolvedAuthority;
+}
+export declare function normalizeWorkroomRemoteAssignmentClaimRequest(value: WorkroomRemoteAssignmentClaimRequest): WorkroomRemoteAssignmentClaimRequest;
+export declare function workroomRemoteAssignmentRequestDigest(request: WorkroomRemoteAssignmentClaimRequest): string;
+export declare function workroomRemoteAssignmentId(operationId: string): string;
+export declare function materializeWorkroomRemoteAssignment(input: MaterializeWorkroomRemoteAssignmentInput): WorkroomRemoteAssignmentIssuance;
+export declare function parseWorkroomRemoteAssignmentIssuance(value: unknown): WorkroomRemoteAssignmentIssuance;
+//# sourceMappingURL=remote-assignment-issuance.d.ts.map

package/lib/workroom/remote-assignment-issuance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-assignment-issuance.d.ts","sourceRoot":"","sources":["../../src/workroom/remote-assignment-issuance.ts"],"names":[],"mappings":"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"}

package/lib/workroom/remote-assignment-issuance.js

@@ -0,0 +1,201 @@
+import { createAssignmentExecutionEnvelope, } from './assignment-executor.js';
+import { deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+import { assertWorkroomRemoteDispatchRetry, createWorkroomRemoteDispatchOutboxItem, } from './remote-dispatch.js';
+export function normalizeWorkroomRemoteAssignmentClaimRequest(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Remote Assignment request must be an object');
+    }
+    const keys = Object.keys(value).sort();
+    const expected = [
+        'operationId', 'projectId', 'runId', 'taskKey', 'agentDefinitionId', 'endpointId',
+    ].sort();
+    if (keys.length !== expected.length || keys.some((key, index) => key !== expected[index])) {
+        throw new Error('Remote Assignment request contains forbidden identity or authority fields');
+    }
+    return deepFreeze({
+        operationId: text(value.operationId, 'operationId'),
+        projectId: text(value.projectId, 'projectId'),
+        runId: text(value.runId, 'runId'),
+        taskKey: text(value.taskKey, 'taskKey'),
+        agentDefinitionId: text(value.agentDefinitionId, 'agentDefinitionId'),
+        endpointId: text(value.endpointId, 'endpointId'),
+    });
+}
+export function workroomRemoteAssignmentRequestDigest(request) {
+    return digest({ version: 1, ...normalizeWorkroomRemoteAssignmentClaimRequest(request) });
+}
+export function workroomRemoteAssignmentId(operationId) {
+    return `remote-assignment:v1:${encodeURIComponent(text(operationId, 'operationId'))}`;
+}
+export function materializeWorkroomRemoteAssignment(input) {
+    const request = normalizeWorkroomRemoteAssignmentClaimRequest(input.request);
+    positive(input.taskRevision, 'taskRevision');
+    positive(input.assignmentRevision, 'assignmentRevision');
+    positive(input.attempt, 'attempt');
+    positive(input.fence, 'fence');
+    const issuedAt = timestamp(input.issuedAt, 'issuedAt');
+    const leaseExpiresAt = timestamp(input.leaseExpiresAt, 'leaseExpiresAt');
+    const reconcileDeadline = timestamp(input.reconcileDeadline, 'reconcileDeadline');
+    if (leaseExpiresAt <= issuedAt || reconcileDeadline < leaseExpiresAt) {
+        throw new Error('Remote Assignment deadlines must follow issuance and Assignment lease');
+    }
+    if (input.authority.role !== 'executor' && input.authority.role !== 'integration') {
+        throw new Error('Resolved Remote Assignment role is not executable');
+    }
+    if (input.authority.endpoint.id !== request.endpointId) {
+        throw new Error('Resolved Remote Assignment endpoint does not match the requested endpoint');
+    }
+    if (input.authority.agentDefinitionId !== request.agentDefinitionId) {
+        throw new Error('Resolved Remote Assignment Agent Definition does not match the request');
+    }
+    if (input.authority.workspace.fence !== input.fence
+        || input.authority.remoteWorkspace.fence !== input.fence
+        || input.authority.workspace.baseRevision !== input.authority.remoteWorkspace.baseSha) {
+        throw new Error('Resolved Remote Assignment Workspace authority drift');
+    }
+    const envelope = createAssignmentExecutionEnvelope({
+        projectId: request.projectId,
+        runId: request.runId,
+        taskKey: request.taskKey,
+        taskRevision: input.taskRevision,
+        assignmentId: text(input.assignmentId, 'assignmentId'),
+        assignmentRevision: input.assignmentRevision,
+        attempt: input.attempt,
+        fence: input.fence,
+        principalId: text(input.authority.principalId, 'resolved principalId'),
+        role: input.authority.role,
+        agentDefinition: input.authority.agentDefinition,
+        plan: input.authority.plan,
+        contextPolicy: input.authority.contextPolicy,
+        factAnchor: input.factAnchor,
+        capabilitySnapshot: input.authority.capabilitySnapshot,
+        policySnapshot: input.authority.policySnapshot,
+        workspace: input.authority.workspace,
+    });
+    const dispatchItem = createWorkroomRemoteDispatchOutboxItem({
+        projectId: envelope.projectId,
+        runId: envelope.runId,
+        taskKey: envelope.taskKey,
+        taskRevision: envelope.taskRevision,
+        assignmentId: envelope.assignmentId,
+        attempt: envelope.attempt,
+        fence: envelope.fence,
+        endpoint: input.authority.endpoint,
+        contextView: input.authority.contextView,
+        acceptanceContract: {
+            ref: input.acceptanceContract.id,
+            hash: input.acceptanceContract.digest,
+        },
+        capabilitySnapshot: {
+            ref: envelope.capabilitySnapshot.ref,
+            hash: envelope.capabilitySnapshot.digest,
+            grantRef: text(input.authority.capabilityGrantRef, 'capabilityGrantRef'),
+        },
+        disclosureManifest: input.authority.disclosureManifest,
+        workspace: input.authority.remoteWorkspace,
+    });
+    return deepFreeze({
+        operationId: request.operationId,
+        requestDigest: workroomRemoteAssignmentRequestDigest(request),
+        issuedAt,
+        reconcileDeadline,
+        envelope,
+        dispatchItem,
+    });
+}
+export function parseWorkroomRemoteAssignmentIssuance(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Persisted Remote Assignment issuance must be an object');
+    }
+    const record = value;
+    const keys = Object.keys(record).sort();
+    const expected = [
+        'dispatchItem', 'envelope', 'issuedAt', 'operationId', 'reconcileDeadline', 'requestDigest',
+    ].sort();
+    if (keys.length !== expected.length || keys.some((key, index) => key !== expected[index])) {
+        throw new Error('Persisted Remote Assignment issuance has invalid keys');
+    }
+    const operationId = text(record.operationId, 'operationId');
+    if (!/^sha256:[a-f0-9]{64}$/u.test(record.requestDigest ?? '')) {
+        throw new Error('Persisted Remote Assignment requestDigest is invalid');
+    }
+    const issuedAt = timestamp(record.issuedAt, 'issuedAt');
+    const reconcileDeadline = timestamp(record.reconcileDeadline, 'reconcileDeadline');
+    if (reconcileDeadline <= issuedAt) {
+        throw new Error('Persisted Remote Assignment reconcile deadline must follow issuance');
+    }
+    const persistedEnvelope = record.envelope;
+    if (!persistedEnvelope || typeof persistedEnvelope !== 'object') {
+        throw new Error('Persisted Remote Assignment Envelope is invalid');
+    }
+    const { version: _envelopeVersion, digest: persistedEnvelopeDigest, ...envelopeInput } = persistedEnvelope;
+    const canonicalEnvelope = createAssignmentExecutionEnvelope(envelopeInput);
+    if (canonicalEnvelope.digest !== persistedEnvelopeDigest) {
+        throw new Error('Persisted Remote Assignment Envelope digest drift');
+    }
+    const item = record.dispatchItem;
+    assertExactKeys(item, [
+        'version', 'dispatchId', 'messageId', 'envelopeDigest', 'envelope',
+    ], 'dispatch item');
+    const envelope = item?.envelope;
+    if (!envelope || typeof envelope !== 'object') {
+        throw new Error('Persisted Remote Assignment dispatch item is invalid');
+    }
+    assertExactKeys(envelope, [
+        'version', 'dispatchId', 'messageId', 'projectId', 'runId', 'taskKey',
+        'taskRevision', 'assignmentId', 'attempt', 'fence', 'endpoint', 'contextView',
+        'acceptanceContract', 'capabilitySnapshot', 'disclosureManifest', 'workspace',
+    ], 'dispatch Envelope');
+    const { version: _version, dispatchId: _dispatchId, messageId: _messageId, ...dispatchInput } = envelope;
+    const canonicalItem = createWorkroomRemoteDispatchOutboxItem(dispatchInput);
+    assertWorkroomRemoteDispatchRetry(canonicalItem, item);
+    if (canonicalEnvelope.projectId !== item.envelope.projectId
+        || canonicalEnvelope.runId !== item.envelope.runId
+        || canonicalEnvelope.taskKey !== item.envelope.taskKey
+        || canonicalEnvelope.taskRevision !== item.envelope.taskRevision
+        || canonicalEnvelope.assignmentId !== item.envelope.assignmentId
+        || canonicalEnvelope.attempt !== item.envelope.attempt
+        || canonicalEnvelope.fence !== item.envelope.fence
+        || canonicalEnvelope.capabilitySnapshot.ref !== item.envelope.capabilitySnapshot.ref
+        || canonicalEnvelope.capabilitySnapshot.digest !== item.envelope.capabilitySnapshot.hash) {
+        throw new Error('Persisted Remote Assignment Envelope and dispatch intent drift');
+    }
+    return deepFreeze({
+        operationId,
+        requestDigest: record.requestDigest,
+        issuedAt,
+        reconcileDeadline,
+        envelope: canonicalEnvelope,
+        dispatchItem: canonicalItem,
+    });
+}
+function assertExactKeys(value, expected, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Persisted Remote Assignment ${field} must be an object`);
+    }
+    const actual = Object.keys(value).sort();
+    const canonical = [...expected].sort();
+    if (actual.length !== canonical.length
+        || actual.some((key, index) => key !== canonical[index])) {
+        throw new Error(`Persisted Remote Assignment ${field} has invalid keys`);
+    }
+}
+function timestamp(value, field) {
+    if (!Number.isFinite(value) || Number(value) < 0) {
+        throw new Error(`Remote Assignment ${field} must be a finite timestamp`);
+    }
+    return Number(value);
+}
+function text(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`Remote Assignment ${field} is required`);
+    }
+    return value.trim();
+}
+function positive(value, field) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Remote Assignment ${field} must be a positive integer`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=remote-assignment-issuance.js.map

package/lib/workroom/remote-assignment-issuance.js.map

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

package/lib/workroom/remote-callback-application.d.ts

@@ -0,0 +1,115 @@
+import { type AssignmentExecutionEnvelope, type AssignmentExecutionObservation } from './assignment-executor.js';
+import { type RemoteCallbackInboxProjection, type RemoteCallbackInboxRepository, type RemoteExecutionLink } from './remote-callback-inbox.js';
+import { type WorkroomRemoteDispatchOutboxItem } from './remote-dispatch.js';
+import { type DurableFileHandle, type DurableFileSystem } from './durable-file-store.js';
+export interface RemoteExecutionLinkPreregistration {
+    readonly version: 1;
+    readonly id: string;
+    readonly revision: 1;
+    readonly status: 'preregistered';
+    readonly linkedAt: number;
+    readonly reconcileDeadline: number;
+    readonly dispatchItem: WorkroomRemoteDispatchOutboxItem;
+    readonly assignmentEnvelope: AssignmentExecutionEnvelope;
+    readonly digest: string;
+}
+import { type RemoteCallbackPollPort, type RemoteCallbackReconciliationClock, type RemoteCallbackReconciliationWorkerOutcome } from './remote-callback-reconciliation-worker.js';
+export interface RemoteExecutionLinkRecord {
+    readonly version: 1;
+    readonly id: string;
+    readonly revision: 1;
+    readonly link: RemoteExecutionLink;
+    readonly assignmentEnvelope: AssignmentExecutionEnvelope;
+    readonly digest: string;
+}
+export interface RemoteExecutionLinkRegistryRepository {
+    preregisterPending(registration: RemoteExecutionLinkPreregistration, expectedSequence: number): Promise<RemoteExecutionLinkPreregistration>;
+    readPending(linkId: string): Promise<RemoteExecutionLinkPreregistration | undefined>;
+    bindTransportReceipt(record: RemoteExecutionLinkRecord, expectedRegistrationRevision: number): Promise<RemoteExecutionLinkRecord>;
+    preregister(record: RemoteExecutionLinkRecord, expectedSequence: number): Promise<RemoteExecutionLinkRecord>;
+    read(linkId: string): Promise<RemoteExecutionLinkRecord | undefined>;
+    listRegistered(): Promise<readonly RemoteExecutionLinkRecord[]>;
+    listReconcileRequired(inboxRepository: Pick<RemoteCallbackInboxRepository, 'read'>): Promise<readonly RemoteExecutionLinkRecord[]>;
+}
+export type RemoteExecutionLinkRegistryFileHandle = DurableFileHandle;
+/** Injectable only at the durable filesystem boundary. */
+export interface RemoteExecutionLinkRegistryFileSystem extends DurableFileSystem {
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+}
+export declare class RemoteExecutionLinkRegistrySequenceConflictError extends Error {
+    readonly linkId: string;
+    readonly expectedSequence: number;
+    readonly actualSequence: number;
+    constructor(linkId: string, expectedSequence: number, actualSequence: number);
+}
+export interface RemoteCallbackApplicationObservationIngressPort {
+    apply(envelope: AssignmentExecutionEnvelope, observation: AssignmentExecutionObservation, expectedSequence: number): Promise<Readonly<{
+        sequence: number;
+    }>>;
+}
+export interface RemoteCallbackApplicationRunStatePort {
+    read(projectId: string, runId: string): Promise<Readonly<{
+        sequence: number;
+    }>>;
+}
+export interface RemoteCallbackApplicationOptions {
+    readonly registry: RemoteExecutionLinkRegistryRepository;
+    readonly inboxRepository: RemoteCallbackInboxRepository;
+    readonly maxSequenceGap: number;
+    readonly pollPort: RemoteCallbackPollPort;
+    readonly reconciliationClock: RemoteCallbackReconciliationClock;
+    readonly observationIngress: RemoteCallbackApplicationObservationIngressPort;
+    readonly runState: RemoteCallbackApplicationRunStatePort;
+}
+export type RemoteCallbackApplicationOutcome = Readonly<{
+    status: 'noop';
+    reason: 'link_not_registered' | 'inbox_not_registered';
+}> | Readonly<{
+    status: 'applied';
+    reconciliation: RemoteCallbackReconciliationWorkerOutcome;
+    submittedObservationIds: readonly string[];
+    projection: RemoteCallbackInboxProjection;
+}>;
+/**
+ * Recovery/application bridge. Transport callbacks never provide the
+ * Assignment authority used here; only the preregistered Envelope does.
+ */
+export declare class RemoteCallbackApplication {
+    #private;
+    constructor(options: RemoteCallbackApplicationOptions);
+    runOnce(linkId: string, signal: AbortSignal): Promise<RemoteCallbackApplicationOutcome>;
+}
+export declare function createRemoteExecutionLinkRecord(link: RemoteExecutionLink, assignmentEnvelope: AssignmentExecutionEnvelope): RemoteExecutionLinkRecord;
+/**
+ * Persists all local Assignment/dispatch authority before transport I/O. The
+ * A2A-owned task/context receipt is deliberately absent until a delivered
+ * transport observation is durably bound through `bindTransportReceipt`.
+ */
+export declare function createRemoteExecutionLinkPreregistration(dispatchItem: WorkroomRemoteDispatchOutboxItem, assignmentEnvelope: AssignmentExecutionEnvelope, linkedAt: number, reconcileDeadline: number): RemoteExecutionLinkPreregistration;
+export declare function bindRemoteExecutionLinkTransportReceipt(registration: RemoteExecutionLinkPreregistration, remoteTaskId: string, remoteContextId: string): RemoteExecutionLinkRecord;
+export declare class MemoryRemoteExecutionLinkRegistryRepository implements RemoteExecutionLinkRegistryRepository {
+    #private;
+    preregisterPending(value: RemoteExecutionLinkPreregistration, expectedSequence: number): Promise<RemoteExecutionLinkPreregistration>;
+    readPending(linkId: string): Promise<RemoteExecutionLinkPreregistration | undefined>;
+    bindTransportReceipt(value: RemoteExecutionLinkRecord, expectedRegistrationRevision: number): Promise<RemoteExecutionLinkRecord>;
+    preregister(value: RemoteExecutionLinkRecord, expectedSequence: number): Promise<RemoteExecutionLinkRecord>;
+    read(linkId: string): Promise<RemoteExecutionLinkRecord | undefined>;
+    listRegistered(): Promise<readonly RemoteExecutionLinkRecord[]>;
+    listReconcileRequired(inboxRepository: Pick<RemoteCallbackInboxRepository, 'read'>): Promise<readonly RemoteExecutionLinkRecord[]>;
+}
+/** Immutable create-only records provide restart-safe preregistration before dispatch. */
+export declare class FileRemoteExecutionLinkRegistryRepository implements RemoteExecutionLinkRegistryRepository {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: RemoteExecutionLinkRegistryFileSystem;
+    constructor(directory: string, fileSystem?: RemoteExecutionLinkRegistryFileSystem);
+    preregisterPending(value: RemoteExecutionLinkPreregistration, expectedSequence: number): Promise<RemoteExecutionLinkPreregistration>;
+    readPending(linkId: string): Promise<RemoteExecutionLinkPreregistration | undefined>;
+    bindTransportReceipt(value: RemoteExecutionLinkRecord, expectedRegistrationRevision: number): Promise<RemoteExecutionLinkRecord>;
+    preregister(value: RemoteExecutionLinkRecord, expectedSequence: number): Promise<RemoteExecutionLinkRecord>;
+    read(linkId: string): Promise<RemoteExecutionLinkRecord | undefined>;
+    listRegistered(): Promise<readonly RemoteExecutionLinkRecord[]>;
+    listReconcileRequired(inboxRepository: Pick<RemoteCallbackInboxRepository, 'read'>): Promise<readonly RemoteExecutionLinkRecord[]>;
+}
+//# sourceMappingURL=remote-callback-application.d.ts.map

package/lib/workroom/remote-callback-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-callback-application.d.ts","sourceRoot":"","sources":["../../src/workroom/remote-callback-application.ts"],"names":[],"mappings":"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"}