agent-embassy 1.7.1 → 1.8.0

package/dist/src/gateway/claude-helper-supervisor.d.ts

@@ -1,12 +1,58 @@
+import { type ChildProcess } from "node:child_process";
 import type { AttestedClaudePeerRuntime } from "./claude-runtime.js";
-import { type ClaudeNativeHelperFactory } from "./claude-helper-client.js";
 import type { GatewayDeliveryNoticeMode } from "./config.js";
 import type { DashboardLocale } from "./locale.js";
-import type { ClaudeNativeCodexSuccessionBarrier } from "./providers.js";
 import type { GatewayAdapterCallbacks, GatewayAdapterDispatchResult } from "./service.js";
-import { type GatewayProvider, type PrivateEndpointIdentity, type PrivateRouteBinding } from "./types.js";
+import { type GatewayProvider, type LogicalRouteBinding } from "./types.js";
+import { type ClaudeNativeHelperCommand, type ClaudeNativeHelperEvent, type ClaudeNativeHelperRegistration, type ClaudeNativeHelperResult } from "./claude-helper-protocol.js";
+export type ClaudeNativeHelperClientCallbacks = Readonly<{
+    onEvent: (event: ClaudeNativeHelperEvent) => void;
+    onExit: (event: Readonly<{
+        code: number | null;
+        signal: NodeJS.Signals | null;
+    }>) => void;
+}>;
+export type ClaudeNativeHelperClientStartOptions = Readonly<{
+    entryPath?: string;
+    runtime: AttestedClaudePeerRuntime;
+    hostId: "this-mac";
+    locale: DashboardLocale;
+    deliveryNotices: GatewayDeliveryNoticeMode;
+    maxPendingMessages: number;
+    registration: ClaudeNativeHelperRegistration;
+    callbacks: ClaudeNativeHelperClientCallbacks;
+}>;
+export interface ClaudeNativeHelperClientLike {
+    readonly pid: number;
+    readonly registration: ClaudeNativeHelperRegistration;
+    generation: string;
+    request(command: ClaudeNativeHelperCommand, timeoutMs?: number): Promise<ClaudeNativeHelperResult>;
+    close(): Promise<void>;
+    forceClose(): Promise<void>;
+}
+export type ClaudeNativeHelperFactory = (options: ClaudeNativeHelperClientStartOptions) => Promise<ClaudeNativeHelperClientLike>;
+export declare class ClaudeNativeHelperClient implements ClaudeNativeHelperClientLike {
+    #private;
+    readonly child: ChildProcess;
+    readonly callbacks: ClaudeNativeHelperClientCallbacks;
+    readonly pid: number;
+    readonly registration: ClaudeNativeHelperRegistration;
+    generation: string;
+    private constructor();
+    static start(options: ClaudeNativeHelperClientStartOptions): Promise<ClaudeNativeHelperClient>;
+    request(command: ClaudeNativeHelperCommand, timeoutMs?: number): Promise<ClaudeNativeHelperResult>;
+    close(): Promise<void>;
+    forceClose(): Promise<void>;
+}
+export declare const createClaudeNativeHelper: ClaudeNativeHelperFactory;
+export type ClaudeNativeHelperPreparedDispatch = Readonly<{
+    frameBytes: number;
+    sha256: string;
+    perform: () => Promise<GatewayAdapterDispatchResult>;
+    cancel: () => Promise<void>;
+}>;
 export type ClaudeNativeHelperSupervisorOptions = Readonly<{
-    identity: PrivateEndpointIdentity;
+    identity: Pick<LogicalRouteBinding, "provider" | "hostId">;
     runtime: AttestedClaudePeerRuntime;
     locale: DashboardLocale;
     deliveryNotices: GatewayDeliveryNoticeMode;
@@ -17,63 +63,29 @@ export type ClaudeNativeHelperSupervisorOptions = Readonly<{
 }>;
 export declare class ClaudeNativeHelperSupervisor {
     #private;
+    readonly options: ClaudeNativeHelperSupervisorOptions;
     constructor(options: ClaudeNativeHelperSupervisorOptions);
     get size(): number;
-    advertise(input: Readonly<{
-        alias: string;
-        sourceProvider: GatewayProvider;
-        cwd: string;
-    }>): Promise<void>;
-    currentGeneration(alias: string): string;
+    advertise(input: ClaudeNativeHelperRegistration): Promise<void>;
     updateStatus(alias: string, status: "idle" | "busy" | "waiting"): Promise<void>;
     unadvertise(alias: string): Promise<void>;
-    dispatch(input: Readonly<{
+    prepareDispatch(input: Readonly<{
         sourceAlias: string;
         sourceProvider: GatewayProvider;
         targetAlias: string;
         conversationId: string;
         selectedAlias?: string;
         stateRoot?: string;
-        binding: PrivateRouteBinding;
+        binding: LogicalRouteBinding;
         authorization: "selected_route" | "native_reply";
         messageId: string;
         text: string;
         expectsReply: boolean;
         deadlineAt: string;
         progressWatchActive?: true;
-    }>): Promise<GatewayAdapterDispatchResult>;
-    releaseRoute(routeHandle: string): Promise<void>;
+    }>): Promise<ClaudeNativeHelperPreparedDispatch>;
     updateInboundStatus(receiptHandle: string, status: "held" | "delivered" | "denied" | "expired", diagnosticCode?: string): Promise<void>;
-    notifyInboundProgress(receiptHandle: string, progress: Readonly<{
-        kind: "stall";
-        reason: "ROUTE_BUSY" | "ROUTE_UNAVAILABLE" | "CODEX_ROUTE_STALE" | "AWAITING_EXTERNAL_APPROVAL";
-        queuedForMs: number;
-    }>): Promise<void>;
+    notifyInboundProgress(receiptHandle: string, progress: import("./claude-peer.js").ClaudePeerInboundProgress): Promise<void>;
     releaseInboundReceipt(receiptHandle: string): Promise<boolean>;
-    quiesceAll(): Promise<void>;
-    quiesceGeneration(generation: string): Promise<void>;
-    observeBarrier(generation: string): Promise<ClaudeNativeCodexSuccessionBarrier>;
-    prepareGeneration(input: Readonly<{
-        alias: string;
-        cwd: string;
-        generation: string;
-        currentGeneration: string;
-    }>): Promise<void>;
-    publishPrepared(input: Readonly<{
-        currentGeneration: string;
-        preparedGeneration: string;
-    }>): Promise<"published" | "not_published" | "unknown">;
-    activatePrepared(generation: string): Promise<void>;
-    cleanupPrepared(generation: string): Promise<void>;
-    resumeGeneration(generation: string): Promise<void>;
-    rollbackPrepared(input: Readonly<{
-        preparedGeneration: string;
-        resumeGeneration: string;
-    }>): Promise<void>;
-    retireGeneration(input: Readonly<{
-        retiredGeneration: string;
-        protectedActiveGeneration: string;
-    }>): Promise<void>;
-    purgeGenerationReplies(generation: string): Promise<number>;
     close(): Promise<void>;
 }