@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/remote-dispatch-admission.js.map

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

package/lib/workroom/remote-dispatch-outbox.d.ts

@@ -0,0 +1,203 @@
+import { type WorkroomRemoteDispatchOutboxItem } from './remote-dispatch.js';
+export type WorkroomRemoteDispatchOutboxStatus = 'pending' | 'leased' | 'delivered' | 'reconcile_required' | 'retryable' | 'blocked';
+export interface WorkroomRemoteDispatchLease {
+    readonly ownerId: string;
+    readonly leaseId: string;
+    readonly leaseFence: number;
+    readonly claimedAt: number;
+    readonly expiresAt: number;
+}
+export interface WorkroomRemoteDispatchTransportObservation {
+    readonly outcome: 'delivered' | 'outcome_unknown' | 'failed';
+    readonly receiptId: string;
+    readonly remoteTaskId?: string;
+    readonly remoteContextId?: string;
+    readonly reason?: string;
+}
+export interface WorkroomRemoteDispatchPersistedObservation extends WorkroomRemoteDispatchTransportObservation {
+    readonly observationId: string;
+    readonly observedAt: number;
+    readonly leaseId: string;
+    readonly leaseFence: number;
+}
+export interface WorkroomRemoteDispatchOutboxProjection {
+    readonly version: 1;
+    readonly dispatchId: string;
+    readonly sequence: number;
+    readonly status: WorkroomRemoteDispatchOutboxStatus;
+    readonly item: WorkroomRemoteDispatchOutboxItem;
+    readonly attemptCount: number;
+    readonly observations: readonly WorkroomRemoteDispatchPersistedObservation[];
+    readonly lease?: WorkroomRemoteDispatchLease;
+    readonly lastLeaseFence?: number;
+    readonly lastRecoveryCause?: WorkroomRemoteDispatchRecoveryCause;
+    readonly governanceBlock?: Readonly<{
+        reason: string;
+        manifestDigest: string;
+        attempt: number;
+        assignmentFence: number;
+        blockedAt: number;
+    }>;
+}
+interface WorkroomRemoteDispatchEnqueuedEventDraft {
+    readonly eventId: string;
+    readonly occurredAt: number;
+    readonly type: 'dispatch.enqueued';
+    readonly payload: Readonly<{
+        item: WorkroomRemoteDispatchOutboxItem;
+    }>;
+}
+interface WorkroomRemoteDispatchClaimedEventDraft {
+    readonly eventId: string;
+    readonly occurredAt: number;
+    readonly type: 'dispatch.claimed';
+    readonly payload: Readonly<{
+        lease: WorkroomRemoteDispatchLease;
+    }>;
+}
+interface WorkroomRemoteDispatchObservationEventDraft {
+    readonly eventId: string;
+    readonly occurredAt: number;
+    readonly type: 'dispatch.transport_observed';
+    readonly payload: Readonly<{
+        leaseId: string;
+        leaseFence: number;
+        observationId: string;
+        observation: WorkroomRemoteDispatchTransportObservation;
+    }>;
+}
+interface WorkroomRemoteDispatchGovernanceBlockedEventDraft {
+    readonly eventId: string;
+    readonly occurredAt: number;
+    readonly type: 'dispatch.governance_blocked';
+    readonly payload: Readonly<{
+        reason: string;
+        manifestDigest: string;
+        attempt: number;
+        assignmentFence: number;
+    }>;
+}
+export type WorkroomRemoteDispatchRecoveryCause = 'outcome_unknown' | 'transport_failed' | 'lease_expired';
+interface WorkroomRemoteDispatchRecoveredEventDraft {
+    readonly eventId: string;
+    readonly occurredAt: number;
+    readonly type: 'dispatch.recovered';
+    readonly payload: Readonly<{
+        lease: WorkroomRemoteDispatchLease;
+        cause: WorkroomRemoteDispatchRecoveryCause;
+    }>;
+}
+export type WorkroomRemoteDispatchOutboxEventDraft = WorkroomRemoteDispatchEnqueuedEventDraft | WorkroomRemoteDispatchClaimedEventDraft | WorkroomRemoteDispatchObservationEventDraft | WorkroomRemoteDispatchGovernanceBlockedEventDraft | WorkroomRemoteDispatchRecoveredEventDraft;
+export type WorkroomRemoteDispatchOutboxEvent = WorkroomRemoteDispatchOutboxEventDraft & Readonly<{
+    readonly version: 1;
+    readonly dispatchId: string;
+    readonly sequence: number;
+}>;
+export interface WorkroomRemoteDispatchClaimInput {
+    readonly dispatchId: string;
+    readonly expectedSequence: number;
+    readonly now: number;
+    readonly ownerId: string;
+    readonly leaseId: string;
+    readonly leaseFence: number;
+    readonly leaseExpiresAt: number;
+}
+export interface WorkroomRemoteDispatchObservationInput {
+    readonly dispatchId: string;
+    readonly expectedSequence: number;
+    readonly now: number;
+    readonly leaseId: string;
+    readonly leaseFence: number;
+    readonly observationId: string;
+    readonly observation: WorkroomRemoteDispatchTransportObservation;
+}
+export interface WorkroomRemoteDispatchGovernanceBlockInput {
+    readonly dispatchId: string;
+    readonly expectedSequence: number;
+    readonly now: number;
+    readonly reason: string;
+    readonly manifestDigest: string;
+    readonly attempt: number;
+    readonly assignmentFence: number;
+}
+export type WorkroomRemoteDispatchRecoverInput = WorkroomRemoteDispatchClaimInput;
+export interface WorkroomRemoteDispatchOutboxRepository {
+    read(dispatchId: string): Promise<WorkroomRemoteDispatchOutboxProjection | undefined>;
+    /** Restart-safe work discovery; excludes delivered, reconciliation and live leases. */
+    listRunnable(now: number): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    listGovernanceBlocked(input: Readonly<{
+        projectId: string;
+        runId: string;
+        taskKey: string;
+        taskRevision: number;
+    }>): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    append(dispatchId: string, expectedSequence: number, drafts: readonly WorkroomRemoteDispatchOutboxEventDraft[]): Promise<readonly WorkroomRemoteDispatchOutboxEvent[]>;
+    enqueue(item: WorkroomRemoteDispatchOutboxItem, expectedSequence: number, enqueuedAt: number): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    claim(input: WorkroomRemoteDispatchClaimInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordTransportObservation(input: WorkroomRemoteDispatchObservationInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordGovernanceBlock(input: WorkroomRemoteDispatchGovernanceBlockInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recover(input: WorkroomRemoteDispatchRecoverInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+}
+export interface WorkroomRemoteDispatchOutboxFileHandle {
+    writeFile(value: string, encoding: 'utf8'): Promise<void>;
+    sync(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Injectable only at the filesystem boundary; production defaults to real Node fs operations. */
+export interface WorkroomRemoteDispatchOutboxFileSystem {
+    mkdir(path: string): Promise<void>;
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+    open(path: string, flags: 'wx' | 'r'): Promise<WorkroomRemoteDispatchOutboxFileHandle>;
+    link(existingPath: string, newPath: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+}
+export declare class WorkroomRemoteDispatchOutboxSequenceConflictError extends Error {
+    readonly dispatchId: string;
+    readonly expectedSequence: number;
+    readonly actualSequence: number;
+    constructor(dispatchId: string, expectedSequence: number, actualSequence: number);
+}
+export declare class MemoryWorkroomRemoteDispatchOutboxRepository implements WorkroomRemoteDispatchOutboxRepository {
+    #private;
+    read(dispatchId: string): Promise<WorkroomRemoteDispatchOutboxProjection | undefined>;
+    listRunnable(now: number): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    listGovernanceBlocked(input: Readonly<{
+        projectId: string;
+        runId: string;
+        taskKey: string;
+        taskRevision: number;
+    }>): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    append(dispatchId: string, expectedSequence: number, drafts: readonly WorkroomRemoteDispatchOutboxEventDraft[]): Promise<readonly WorkroomRemoteDispatchOutboxEvent[]>;
+    enqueue(item: WorkroomRemoteDispatchOutboxItem, expectedSequence: number, enqueuedAt: number): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    claim(input: WorkroomRemoteDispatchClaimInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordTransportObservation(input: WorkroomRemoteDispatchObservationInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordGovernanceBlock(input: WorkroomRemoteDispatchGovernanceBlockInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recover(input: WorkroomRemoteDispatchRecoverInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+}
+/**
+ * Durable adapter. Each append is an immutable segment and the first sequence
+ * path is claimed with a hard link, making expectedSequence a filesystem CAS.
+ */
+export declare class FileWorkroomRemoteDispatchOutboxRepository implements WorkroomRemoteDispatchOutboxRepository {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: WorkroomRemoteDispatchOutboxFileSystem;
+    constructor(directory: string, fileSystem?: WorkroomRemoteDispatchOutboxFileSystem);
+    read(dispatchId: string): Promise<WorkroomRemoteDispatchOutboxProjection | undefined>;
+    listRunnable(now: number): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    listGovernanceBlocked(input: Readonly<{
+        projectId: string;
+        runId: string;
+        taskKey: string;
+        taskRevision: number;
+    }>): Promise<readonly WorkroomRemoteDispatchOutboxProjection[]>;
+    append(dispatchId: string, expectedSequence: number, drafts: readonly WorkroomRemoteDispatchOutboxEventDraft[]): Promise<readonly WorkroomRemoteDispatchOutboxEvent[]>;
+    enqueue(item: WorkroomRemoteDispatchOutboxItem, expectedSequence: number, enqueuedAt: number): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    claim(input: WorkroomRemoteDispatchClaimInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordTransportObservation(input: WorkroomRemoteDispatchObservationInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recordGovernanceBlock(input: WorkroomRemoteDispatchGovernanceBlockInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+    recover(input: WorkroomRemoteDispatchRecoverInput): Promise<WorkroomRemoteDispatchOutboxEvent>;
+}
+export {};
+//# sourceMappingURL=remote-dispatch-outbox.d.ts.map

package/lib/workroom/remote-dispatch-outbox.d.ts.map

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