agent-embassy 3.0.0 → 4.0.0

package/dist/src/gateway/providers.d.ts

@@ -1,163 +0,0 @@
-import { type GatewayNodeInventory } from "./federation-nodes.js";
-import { ClaudePeerAdapter, type ClaudePeerInboundProgress } from "./claude-peer.js";
-import type { AttestedClaudePeerRuntime } from "./claude-runtime.js";
-import type { LocalCodexTransportFactory } from "./codex-local-transport.js";
-import type { StatelessCodexOperationTransport } from "./codex-stateless-transport.js";
-import type { GatewayDeliveryNoticeMode } from "./config.js";
-import type { ClaudeNativeHelperFactory } from "./claude-helper-client.js";
-import type { GatewayAdapterCallbacks, GatewayAdapterDiscoverySnapshot, GatewayAdapterDispatchResult, GatewayAdapterDispatchInput, GatewayAdapterRouteState, GatewayAdapterRegistryObservation, GatewayAdapterStart, GatewayProviderAdapter } from "./service.js";
-import type { GatewayProvider } from "./types.js";
-type ClaudePeerFactory = (runtime: AttestedClaudePeerRuntime, deliveryNotices: GatewayDeliveryNoticeMode) => ClaudePeerAdapter;
-export type LocalClaudeGatewayProviderOptions = {
-    /** Exact result of attestClaudePeerRuntime; paths are never rediscovered. */
-    runtime: AttestedClaudePeerRuntime;
-    /** Fixed controller-owned root re-attested by each selected-route dispatch. */
-    stateRoot: string;
-    hostId: string;
-    nodeInventory: GatewayNodeInventory;
-    /** Gateway-authored user-frame policy; native receipt status is unchanged. */
-    deliveryNotices?: GatewayDeliveryNoticeMode;
-    discoveryPollMs?: number;
-    maxPendingMessages?: number;
-    now?: () => number;
-    /** Production-only real-PID advertisement helpers. Omit in child/test hosts. */
-    nativeHelpers?: Readonly<{
-        maxHelpers: number;
-        factory?: ClaudeNativeHelperFactory;
-    }>;
-    /** Deterministic test seam. Production callers must omit this. */
-    peerFactory?: ClaudePeerFactory;
-};
-export declare class LocalClaudeGatewayProvider implements GatewayProviderAdapter {
-    readonly identity: Readonly<{
-        provider: "claude";
-        hostId: string;
-    }>;
-    readonly protocol = "claude-peer";
-    readonly protocolVersion: string;
-    private readonly peer;
-    private readonly stateRoot;
-    private readonly maxPending;
-    private readonly discoveryPollMs;
-    private readonly now;
-    private readonly nativeHelpers;
-    private readonly discovered;
-    /** Exact UUID selection plus its display-only observation bookkeeping. */
-    private readonly selected;
-    private discoveryInFlight;
-    private registryObservation;
-    private monitorTimer;
-    private callbacks;
-    private initialized;
-    private closed;
-    constructor(options: LocalClaudeGatewayProviderOptions);
-    latestRegistryObservation(): GatewayAdapterRegistryObservation | undefined;
-    initialize(callbacks: GatewayAdapterCallbacks): Promise<GatewayAdapterStart>;
-    discoverClaudePeers(): Promise<GatewayAdapterDiscoverySnapshot>;
-    assertWorkspaceDisjoint(routeHandle: string, stateRoot: string): Promise<void>;
-    selectRoute(input: {
-        alias: string;
-        routeHandle: string;
-    }): Promise<{
-        routeHandle: string;
-        state: GatewayAdapterRouteState;
-    }>;
-    observeLogicalRoute(input: {
-        alias: string;
-        routeHandle: string;
-        registrationId: string;
-    }): void;
-    forgetLogicalRoute(registrationId: string): void;
-    /**
-     * Converts an inherited messaging-socket capability into the owning
-     * session's UUID. The session need not hold a route yet: its route installs
-     * on its first send, and the service compares the claimed alias against
-     * discovery for that UUID.
-     */
-    resolveReplyAddress(address: string): Promise<{
-        routeHandle: string;
-    }>;
-    advertiseNativeSourcePeer(input: {
-        alias: string;
-        sourceProvider: GatewayProvider;
-        cwd: string;
-    }): Promise<void>;
-    unadvertiseNativeSourcePeer(alias: string): Promise<void>;
-    updateNativeSourcePeerStatus(alias: string, status: "idle" | "busy" | "waiting"): Promise<void>;
-    updateNativeInboundStatus(receiptHandle: string, status: "held" | "delivered" | "denied" | "expired", diagnosticCode?: string): Promise<void>;
-    notifyNativeInboundProgress(receiptHandle: string, progress: ClaudePeerInboundProgress): Promise<void>;
-    releaseNativeInboundReceipt(receiptHandle: string): Promise<boolean>;
-    dispatch(input: GatewayAdapterDispatchInput): Promise<GatewayAdapterDispatchResult>;
-    releaseRoute(routeHandle: string): Promise<void>;
-    close(): Promise<void>;
-    private assertReady;
-    private helpers;
-    private refreshClaudeDiscovery;
-    private refreshClaudeDiscoveryOnce;
-    private emitClaudeRouteObservation;
-    private scheduleClaudeMonitor;
-}
-export declare function createLocalClaudeGatewayProvider(options: LocalClaudeGatewayProviderOptions): LocalClaudeGatewayProvider;
-export type LocalCodexGatewayProviderOptions = {
-    hostId: string;
-    nodeInventory: GatewayNodeInventory;
-    operation: StatelessCodexOperationTransport;
-    createObservationFactory?: () => Promise<LocalCodexTransportFactory>;
-    observationPollMs?: number;
-    observationTimeoutMs?: number;
-    observationBackoffMaxMs?: number;
-    maxObservedRoutes?: number;
-    now?: () => Date;
-    timers?: Readonly<{
-        setTimeout: (callback: () => void, delayMs: number) => NodeJS.Timeout;
-        clearTimeout: (timer: NodeJS.Timeout) => void;
-    }>;
-};
-/**
- * Thin logical Codex adapter. Registration and construction perform no App
- * Server I/O. Each semantic operation owns a fresh attested transport, while
- * the independent observer publishes only best-effort in-memory freshness.
- */
-export declare class LocalCodexGatewayProvider implements GatewayProviderAdapter {
-    private readonly hostId;
-    private readonly operation;
-    private readonly observationPollMs;
-    private readonly observationTimeoutMs;
-    private readonly observationBackoffMaxMs;
-    private readonly maxObservedRoutes;
-    private readonly now;
-    private readonly timers;
-    private readonly observedRoutes;
-    private readonly activeTurns;
-    private readonly inFlightOperations;
-    private readonly operationControllers;
-    private callbacks;
-    private observationTimer;
-    private observationInFlight;
-    private observationController;
-    private initialized;
-    private closing;
-    private closed;
-    constructor(options: LocalCodexGatewayProviderOptions);
-    get identity(): Readonly<{
-        provider: "codex";
-        hostId: string;
-    }>;
-    get protocol(): string;
-    get protocolVersion(): string;
-    initialize(callbacks: GatewayAdapterCallbacks): Promise<GatewayAdapterStart>;
-    observeLogicalRoute(input: {
-        alias: string;
-        routeHandle: string;
-        registrationId: string;
-    }): void;
-    forgetLogicalRoute(registrationId: string): void;
-    dispatch(input: GatewayAdapterDispatchInput): Promise<GatewayAdapterDispatchResult>;
-    close(): Promise<void>;
-    private publishOperationObservation;
-    private scheduleObservation;
-    private runObservation;
-    private emitObservation;
-}
-export declare function createLocalCodexGatewayProvider(options: LocalCodexGatewayProviderOptions): LocalCodexGatewayProvider;
-export {};