pi-amq 0.1.1

package/dist/workflow/worker-process-supervisor.d.ts

@@ -0,0 +1,110 @@
+import { type PiSessionForker } from "./pi-session-fork.js";
+import { WorkflowRunStore } from "./run-store.js";
+import { type PiProcessLaunchCommand, type WorkerLaunchAuthority } from "./worker-launch.js";
+import { WorkflowLeaseManager, type ProcessIdentityInspector } from "./workflow-lease.js";
+import type { AcceptanceCheck, ReportSchemaV1, RunProjectionV2, WorkerAttemptProjection, WorkerId, WorkerProjection, WorkerRequest } from "./workflow-types.js";
+export declare const WORKER_PROTOCOL_LINE_LIMIT_BYTES: number;
+export declare const WORKER_STDERR_TAIL_LIMIT_BYTES: number;
+export declare class WorkerProtocolError extends Error {
+    readonly code: "protocol_output_limit" | "protocol_invalid_json";
+    readonly limitBytes?: number | undefined;
+    constructor(code: "protocol_output_limit" | "protocol_invalid_json", message: string, limitBytes?: number | undefined);
+}
+export { BudgetExceededError } from "./run-store.js";
+export type { PiProcessLaunchCommand } from "./worker-launch.js";
+export interface ProcessExit {
+    readonly code: number | null;
+    readonly signal: string | null;
+}
+export interface ManagedWorkerProcess {
+    readonly pid: number;
+    readonly stdout: AsyncIterable<Uint8Array>;
+    readonly stderr: AsyncIterable<Uint8Array>;
+    readonly exited: Promise<ProcessExit>;
+    writeLine(line: string): Promise<void>;
+    endInput(): Promise<void>;
+    signalProcessGroup(signal: NodeJS.Signals): Promise<void>;
+    closeParentLiveness(): Promise<void>;
+}
+export interface PiProcessFactory {
+    spawn(command: PiProcessLaunchCommand): Promise<ManagedWorkerProcess>;
+}
+export interface WorkerTimerScheduler {
+    schedule(delayMs: number, callback: () => void): {
+        cancel(): void;
+    };
+}
+export interface WorkerProcessSupervisorOptions {
+    readonly namespaceDirectory: string;
+    readonly store: WorkflowRunStore;
+    readonly leaseManager: WorkflowLeaseManager;
+    readonly supervisorGeneration: string;
+    readonly inspector: ProcessIdentityInspector;
+    readonly processFactory: PiProcessFactory;
+    readonly launchAuthority: WorkerLaunchAuthority;
+    readonly timerScheduler?: WorkerTimerScheduler;
+    readonly now?: () => Date;
+    readonly cancellationGraceMs?: number;
+    readonly sessionForker?: PiSessionForker;
+}
+export type SpawnWorkerResult = {
+    readonly kind: "started";
+    readonly worker: WorkerProjection;
+    readonly attempt: WorkerAttemptProjection;
+    readonly settlement: Promise<RunProjectionV2>;
+} | {
+    readonly kind: "existing" | "needs-reconcile";
+    readonly worker: WorkerProjection;
+    readonly attempt: WorkerAttemptProjection;
+};
+export type CancelWorkerResult = {
+    readonly kind: "requested";
+    readonly projection: RunProjectionV2;
+} | {
+    readonly kind: "indeterminate";
+    readonly projection: RunProjectionV2;
+    readonly reason: string;
+};
+export declare class ResumeRefusedError extends Error {
+    constructor(message: string);
+}
+export declare class WorkerProcessSupervisor {
+    #private;
+    constructor(options: WorkerProcessSupervisorOptions);
+    updateLaunchAuthority(authority: WorkerLaunchAuthority): void;
+    spawnWorker(requestKey: string, input: {
+        readonly request: WorkerRequest;
+        readonly prompt: string;
+        readonly depth: number;
+        readonly parentWorkerId?: WorkerId | null;
+        readonly continueWorkerId?: WorkerId;
+    }): Promise<SpawnWorkerResult>;
+    resumeWorker(requestKey: string, input: {
+        readonly workerId: WorkerId;
+        readonly prompt: string;
+    }): Promise<SpawnWorkerResult>;
+    cancelWorker(requestKey: string, input: {
+        readonly workerId: WorkerId;
+        readonly reason: string;
+    }): Promise<CancelWorkerResult>;
+    steerWorker(requestKey: string, input: {
+        readonly workerId: WorkerId;
+        readonly message: string;
+        readonly correlation?: string;
+    }): Promise<RunProjectionV2>;
+    reviseWorkerContract(requestKey: string, input: {
+        readonly workerId: WorkerId;
+        readonly correlation?: string;
+        readonly goal?: string;
+        readonly acceptance?: readonly string[];
+        readonly constraints?: readonly string[];
+        readonly report_schema?: ReportSchemaV1;
+        readonly requires_human_approval?: boolean;
+        readonly acceptance_check?: AcceptanceCheck;
+    }): Promise<RunProjectionV2>;
+    reconcileRun(requestKey: string): Promise<RunProjectionV2>;
+}
+export declare class NodePiProcessFactory implements PiProcessFactory {
+    spawn(command: PiProcessLaunchCommand): Promise<ManagedWorkerProcess>;
+}
+//# sourceMappingURL=worker-process-supervisor.d.ts.map

package/dist/workflow/worker-process-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-process-supervisor.d.ts","sourceRoot":"","sources":["../../workflow/worker-process-supervisor.ts"],"names":[],"mappings":"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"}