@zhin.js/agent 1.1.13 → 1.1.14

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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"}