agent-embassy 1.7.0 → 1.8.0

package/dist/src/gateway/claude-peer.d.ts

@@ -1,24 +1,16 @@
 import { type Socket } from "node:net";
 import type { GatewayDeliveryNoticeMode } from "./config.js";
 import { type DashboardLocale } from "./locale.js";
-/**
- * This adapter intentionally pins the inspected, implementation-specific
- * local peer boundary. The feature is documented in Claude Code, but its
- * registry and NDJSON formats are not a stable public integration contract.
- */
 export declare const CLAUDE_PEER_COMPATIBILITY: Readonly<{
-    claudeCodeVersion: "2.1.227";
     peerProtocol: 1;
-    messageVersion: 1;
 }>;
 export declare const claudePeerStatuses: readonly ["busy", "shell", "idle", "waiting"];
 export type ClaudePeerStatus = (typeof claudePeerStatuses)[number];
 export declare const claudePeerKinds: readonly ["interactive", "bg", "daemon", "daemon-worker"];
 export type ClaudePeerKind = (typeof claudePeerKinds)[number];
-export declare const claudePeerRejectionCodes: readonly ["ENTRY_LIMIT_EXCEEDED", "INVALID_FILE_NAME", "REGISTRY_NOT_REGULAR", "REGISTRY_OWNER_MISMATCH", "REGISTRY_MODE_UNSAFE", "REGISTRY_TOO_LARGE", "REGISTRY_RACED", "REGISTRY_INVALID_JSON", "REGISTRY_INVALID_SCHEMA", "PID_MISMATCH", "PID_NOT_LIVE", "PID_OWNER_MISMATCH", "SOCKET_OUTSIDE_ROOT", "SOCKET_NOT_SOCKET", "SOCKET_OWNER_MISMATCH", "SOCKET_MODE_UNSAFE", "SELF_TARGET", "SESSION_ID_COLLISION"];
+export declare const claudePeerRejectionCodes: readonly ["ENTRY_LIMIT_EXCEEDED", "INVALID_FILE_NAME", "REGISTRY_NOT_REGULAR", "REGISTRY_TOO_LARGE", "REGISTRY_RACED", "REGISTRY_INVALID_JSON", "REGISTRY_INVALID_SCHEMA", "PID_MISMATCH", "PID_NOT_LIVE", "PID_OWNER_MISMATCH", "SOCKET_OUTSIDE_ROOT", "SOCKET_NOT_SOCKET", "SELF_TARGET", "SESSION_ID_COLLISION"];
 export type ClaudePeerRejectionCode = (typeof claudePeerRejectionCodes)[number];
 export type ClaudePeerDescriptor = {
-    /** Claude's stable logical session UUID. Names and sockets are not identity. */
     targetId: string;
     alias: string;
     kind: ClaudePeerKind;
@@ -29,20 +21,13 @@ export type ClaudePeerDiscovery = {
     peers: ClaudePeerDescriptor[];
     rejected: Partial<Record<ClaudePeerRejectionCode, number>>;
     truncated: boolean;
-    /** Bounded registry entries examined, including safely skipped records. */
     entriesScanned: number;
-    /** Records whose required known fields parsed before later liveness checks. */
     parseableRecords: number;
 };
-export type ClaudePeerTransportStatus = "connecting" | "write_started" | "transport_written" | "ambiguous" | "not_written";
-export type ClaudePeerReceiptStatus = "held"
-/** Native `delivered`: approval released the frame to Claude's queue. */
- | "released" | "denied" | "expired" | "unconfirmed" | "ambiguous";
 export type ClaudePeerDeliveryDiagnostic = {
-    /** Stable, non-sensitive gateway code rendered into Claude's context. */
     code: string;
 };
-export declare const claudePeerInboundStallReasons: readonly ["ROUTE_BUSY", "ROUTE_UNAVAILABLE", "CODEX_ROUTE_STALE", "AWAITING_EXTERNAL_APPROVAL"];
+export declare const claudePeerInboundStallReasons: readonly ["ROUTE_BUSY", "ROUTE_UNAVAILABLE", "AWAITING_EXTERNAL_APPROVAL"];
 export type ClaudePeerInboundStallReason = (typeof claudePeerInboundStallReasons)[number];
 export type ClaudePeerInboundProgress = {
     kind: "stall";
@@ -52,33 +37,20 @@ export type ClaudePeerInboundProgress = {
 export type ClaudePeerAcknowledgmentResult = {
     transportStatus: "transport_written" | "suppressed";
 };
-export type ClaudePeerTransportEvent = {
-    messageId: string;
-    status: ClaudePeerTransportStatus;
-};
-export type ClaudePeerReceiptEvent = {
-    messageId: string;
-    status: ClaudePeerReceiptStatus;
-    trust: "untrusted_same_uid_peer";
-};
 export type ClaudePeerInboundMessage = {
     inboundId: string;
     content: string;
-    /** Validated connect-back capability, not proof of the connecting PID. */
     sourceTargetId?: string;
-    /** Display label from that capability; never an authority. */
     sourceAlias?: string;
-    /** Opaque listener-owned handle for native held/delivered status updates. */
     receiptHandle?: string;
     replySupported: boolean;
     trust: "untrusted_same_uid_peer" | "untrusted_anonymous_local_peer";
 };
 export type ClaudePeerProtocolNotice = {
-    code: "FRAME_TOO_LARGE" | "INVALID_UTF8" | "INVALID_FRAME" | "UNSUPPORTED_FRAME" | "UNREGISTERED_REPLY_ADDRESS" | "UNKNOWN_RECEIPT" | "INVALID_RECEIPT_TRANSITION" | "RECEIPT_LIMIT" | "CONNECTION_LIMIT" | "CONNECTION_TIMEOUT" | "CALLBACK_ERROR";
+    code: "FRAME_TOO_LARGE" | "INVALID_UTF8" | "INVALID_FRAME" | "UNSUPPORTED_FRAME" | "UNREGISTERED_REPLY_ADDRESS" | "RECEIPT_LIMIT" | "CONNECTION_LIMIT" | "CONNECTION_TIMEOUT" | "CALLBACK_ERROR";
 };
 export type ClaudeProcessIdentity = {
     uid: number;
-    /** Stable only for the lifetime of this process, such as ps(1) lstart. */
     generation: string;
 };
 export type ClaudeProcessInspector = (pid: number) => Promise<ClaudeProcessIdentity | undefined>;
@@ -86,99 +58,69 @@ export type ClaudePeerConnect = (socketPath: string) => Socket;
 export type ClaudePeerAdapterOptions = {
     sessionsDir: string;
     socketDir: string;
-    /** Bounded metadata from the attested runtime, never user input. */
-    attestedClaudeCodeVersion: string;
-    /** Locale for bounded user-visible gateway notices written to Claude. */
     locale?: DashboardLocale;
-    /** Gateway-authored user-frame policy; native status frames are unaffected. */
     deliveryNotices?: GatewayDeliveryNoticeMode;
     maxRegistryEntries?: number;
     maxRegistryBytes?: number;
     maxFrameBytes?: number;
-    targetLeaseMs?: number;
     connectTimeoutMs?: number;
-    receiptDeadlineMs?: number;
     maxPendingReceipts?: number;
     maxConnections?: number;
     connectionIdleMs?: number;
     maxFramesPerConnection?: number;
 };
-/** Dependency seams for deterministic tests; never populate from config. */
 export type ClaudePeerAdapterTestOverrides = {
-    /** Deterministic owner-mismatch seam; production always uses process.getuid(). */
     expectedUid?: number;
     processInspector?: ClaudeProcessInspector;
     connect?: ClaudePeerConnect;
     now?: () => number;
     createId?: () => string;
-    /** Separate from protocol/message UUID generation so lifecycle tests cannot alias it. */
-    createGeneration?: () => string;
+    createArtifactToken?: () => string;
     registryRename?: (source: string, destination: string) => Promise<void>;
     registryOperationHook?: (event: {
-        operation: "advertise" | "publish" | "status" | "unadvertise";
+        operation: "advertise" | "status" | "unadvertise";
         phase: "entered" | "exited";
         generation: string;
     }) => void | Promise<void>;
     userHome?: string;
     tempRoots?: readonly string[];
-    registryPublicationHook?: (stage: "before_rename" | "after_rename") => void | Promise<void>;
     postBindHook?: (socketPath: string) => void | Promise<void>;
 };
-export type ClaudePeerRegistryPublicationOutcome = "published" | "not_published" | "unknown";
 export type ClaudePeerListenerOptions = {
     onMessage: (message: ClaudePeerInboundMessage) => void | Promise<void>;
-    onReceipt?: (event: ClaudePeerReceiptEvent) => void | Promise<void>;
     onProtocolNotice?: (notice: ClaudePeerProtocolNotice) => void | Promise<void>;
 };
-export type ClaudePeerSendOptions = {
-    listener?: ClaudePeerListener;
-    /** Exact gateway message deadline as an epoch-millisecond timestamp. */
-    receiptDeadlineAt?: number;
-    onTransportStatus?: (event: ClaudePeerTransportEvent) => void | Promise<void>;
-};
-export type ClaudePeerSendResult = {
+export type ClaudePeerPreparedSendResult = {
     messageId: string;
     transportStatus: "transport_written";
-    receiptStatus: "pending" | "unavailable";
-};
-type FileGeneration = {
-    dev: number;
-    ino: number;
-    size: number;
-    mtimeMs: number;
-};
-type SocketGeneration = {
-    dev: number;
-    ino: number;
 };
+export type ClaudePeerPreparedSend = Readonly<{
+    messageId: string;
+    frameBytes: number;
+    sha256: string;
+    perform: () => Promise<ClaudePeerPreparedSendResult>;
+    cancel: () => void;
+}>;
 type ParsedRegistryRecord = {
     pid: number;
     sessionId: string;
     cwd: string;
-    peerProtocol: 1;
     kind: ClaudePeerKind;
     messagingSocketPath: string;
     name: string;
     status: ClaudePeerStatus;
     embassyAdvertisement: boolean;
 };
-type TargetBinding = {
+type TargetBinding = Readonly<{
     targetId: string;
     alias: string;
-    registryPath: string;
-    registryGeneration: FileGeneration;
-    socketGeneration: SocketGeneration;
     record: ParsedRegistryRecord;
-    processGeneration: string;
-    expiresAt: number;
-};
+}>;
 type AdapterLimits = {
     maxRegistryEntries: number;
     maxRegistryBytes: number;
     maxFrameBytes: number;
-    targetLeaseMs: number;
     connectTimeoutMs: number;
-    receiptDeadlineMs: number;
     maxPendingReceipts: number;
     maxConnections: number;
     connectionIdleMs: number;
@@ -206,8 +148,11 @@ export declare class ClaudePeerAdapter {
      */
     resolveReplyAddress(address: string): Promise<ClaudePeerDescriptor>;
     listen(options: ClaudePeerListenerOptions): Promise<ClaudePeerListener>;
-    listenPrepared(generation: string, options: ClaudePeerListenerOptions): Promise<ClaudePeerListener>;
-    send(targetId: string, content: string, options?: ClaudePeerSendOptions): Promise<ClaudePeerSendResult>;
+    prepareSend(targetId: string, content: string, options: Readonly<{
+        deadlineAt: number;
+        /** Owned reply address only; no outbound receipt is tracked. */
+        replyListener?: ClaudePeerListener;
+    }>): Promise<ClaudePeerPreparedSend>;
     close(): Promise<void>;
 }
 type ListenerCreateOptions = {
@@ -217,21 +162,15 @@ type ListenerCreateOptions = {
     limits: AdapterLimits;
     createId: () => string;
     connect: ClaudePeerConnect;
-    now: () => number;
     locale: DashboardLocale;
     deliveryNotices: GatewayDeliveryNoticeMode;
-    attestedClaudeCodeVersion: string;
     resolveReplyAddress: (address: string) => Promise<TargetBinding>;
     resolveSessionBinding: (sessionId: string) => Promise<TargetBinding>;
-    revalidateBinding: (binding: TargetBinding) => Promise<TargetBinding>;
     options: ClaudePeerListenerOptions;
-    owner: object;
     generation: string;
     registryRename: (source: string, destination: string) => Promise<void>;
     registryOperationHook?: ClaudePeerAdapterTestOverrides["registryOperationHook"];
     runRegistryMutation: <T>(operation: () => Promise<T>) => Promise<T>;
-    preparedGeneration?: string;
-    registryPublicationHook?: (stage: "before_rename" | "after_rename") => void | Promise<void>;
     postBindHook: ClaudePeerAdapterTestOverrides["postBindHook"];
     onClosed: () => void;
 };
@@ -243,11 +182,8 @@ export declare class ClaudePeerListener {
     static create(options: ListenerCreateOptions): Promise<ClaudePeerListener>;
     get closed(): boolean;
     advertise(name: string, cwd: string): Promise<void>;
-    publishReplacing(current: ClaudePeerListener, name: string, cwd: string): Promise<ClaudePeerRegistryPublicationOutcome>;
     updateAdvertisedStatus(status: ClaudePeerStatus): Promise<void>;
     unadvertise(name?: string): Promise<void>;
-    grantSuccessionActivation(): void;
-    resumeInbound(): void;
     acknowledge(receiptHandle: string, status: "held" | "delivered" | "denied" | "expired", diagnostic?: ClaudePeerDeliveryDiagnostic): Promise<ClaudePeerAcknowledgmentResult>;
     /**
      * Writes one nonterminal gateway progress frame without synthesizing a
@@ -268,9 +204,6 @@ export declare class ClaudePeerListener {
      * closing the provider socket.
      */
     quiesceInbound(): Promise<void>;
-    track(messageId: string, binding: TargetBinding, receiptDeadlineAt?: number): void;
-    recordTransportOutcome(messageId: string, outcome: "transport_written" | "transport_uncertain"): void;
-    untrack(messageId: string): void;
     close(): Promise<void>;
 }
 export {};