sandbox-agent 0.2.2 → 0.3.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { NewSessionRequest, SessionConfigOption, SessionModeState, AnyMessage, AcpEnvelopeDirection, NewSessionResponse, PromptRequest, PromptResponse, SetSessionModeResponse, SetSessionConfigOptionResponse } from 'acp-http-client';
+import { NewSessionRequest, SessionConfigOption, SessionModeState, AnyMessage, AcpEnvelopeDirection, RequestPermissionRequest, RequestPermissionResponse, NewSessionResponse, PermissionOptionKind, PromptRequest, PromptResponse, SetSessionModeResponse, SetSessionConfigOptionResponse } from 'acp-http-client';
 export { AcpRpcError } from 'acp-http-client';
 
 type SandboxAgentSpawnLogMode = "inherit" | "pipe" | "silent";
@@ -1353,6 +1353,14 @@ interface ProcessTerminalErrorFrame {
     message: string;
 }
 type ProcessTerminalServerFrame = ProcessTerminalReadyFrame | ProcessTerminalExitFrame | ProcessTerminalErrorFrame;
+type TerminalReadyStatus = ProcessTerminalReadyFrame;
+type TerminalExitStatus = ProcessTerminalExitFrame;
+type TerminalErrorStatus = ProcessTerminalErrorFrame;
+type TerminalStatusMessage = ProcessTerminalServerFrame;
+interface TerminalResizePayload {
+    cols: number;
+    rows: number;
+}
 interface SessionRecord {
     id: string;
     agent: string;
@@ -1480,8 +1488,25 @@ interface SessionSendOptions {
     notification?: boolean;
 }
 type SessionEventListener = (event: SessionEvent) => void;
+type PermissionReply = "once" | "always" | "reject";
+type PermissionRequestListener = (request: SessionPermissionRequest) => void;
 type ProcessLogListener = (entry: ProcessLogEntry) => void;
 type ProcessLogFollowQuery = Omit<ProcessLogsQuery, "follow">;
+interface SessionPermissionRequestOption {
+    optionId: string;
+    name: string;
+    kind: PermissionOptionKind;
+}
+interface SessionPermissionRequest {
+    id: string;
+    createdAt: number;
+    sessionId: string;
+    agentSessionId: string;
+    availableReplies: PermissionReply[];
+    options: SessionPermissionRequestOption[];
+    toolCall: RequestPermissionRequest["toolCall"];
+    rawRequest: RequestPermissionRequest;
+}
 interface AgentQueryOptions {
     config?: boolean;
     noCache?: boolean;
@@ -1497,6 +1522,7 @@ interface ProcessTerminalConnectOptions extends ProcessTerminalWebSocketUrlOptio
     protocols?: string | string[];
     WebSocket?: typeof WebSocket;
 }
+type ProcessTerminalSessionOptions = ProcessTerminalConnectOptions;
 declare class SandboxAgentError extends Error {
     readonly status: number;
     readonly problem?: ProblemDetails;
@@ -1523,6 +1549,12 @@ declare class UnsupportedSessionConfigOptionError extends Error {
     readonly availableConfigIds: string[];
     constructor(sessionId: string, configId: string, availableConfigIds: string[]);
 }
+declare class UnsupportedPermissionReplyError extends Error {
+    readonly permissionId: string;
+    readonly requestedReply: PermissionReply;
+    readonly availableReplies: PermissionReply[];
+    constructor(permissionId: string, requestedReply: PermissionReply, availableReplies: PermissionReply[]);
+}
 declare class Session {
     private record;
     private readonly sandbox;
@@ -1534,7 +1566,7 @@ declare class Session {
     get createdAt(): number;
     get destroyedAt(): number | undefined;
     refresh(): Promise<Session>;
-    send(method: string, params?: Record<string, unknown>, options?: SessionSendOptions): Promise<unknown>;
+    rawSend(method: string, params?: Record<string, unknown>, options?: SessionSendOptions): Promise<unknown>;
     prompt(prompt: PromptRequest["prompt"]): Promise<PromptResponse>;
     setMode(modeId: string): Promise<SetSessionModeResponse | void>;
     setConfigOption(configId: string, value: string): Promise<SetSessionConfigOptionResponse>;
@@ -1543,6 +1575,9 @@ declare class Session {
     getConfigOptions(): Promise<SessionConfigOption[]>;
     getModes(): Promise<SessionModeState | null>;
     onEvent(listener: SessionEventListener): () => void;
+    onPermissionRequest(listener: PermissionRequestListener): () => void;
+    respondPermission(permissionId: string, reply: PermissionReply): Promise<void>;
+    rawRespondPermission(permissionId: string, response: RequestPermissionResponse): Promise<void>;
     toRecord(): SessionRecord;
     apply(record: SessionRecord): void;
 }
@@ -1558,6 +1593,7 @@ declare class LiveAcpConnection {
     private lastAdapterExit;
     private lastAdapterExitAt;
     private readonly onObservedEnvelope;
+    private readonly onPermissionRequest;
     private constructor();
     static create(options: {
         baseUrl: string;
@@ -1567,6 +1603,7 @@ declare class LiveAcpConnection {
         agent: string;
         serverId: string;
         onObservedEnvelope: (connection: LiveAcpConnection, envelope: AnyMessage, direction: AcpEnvelopeDirection, localSessionId: string | null) => void;
+        onPermissionRequest: (connection: LiveAcpConnection, localSessionId: string, agentSessionId: string, request: RequestPermissionRequest) => Promise<RequestPermissionResponse>;
     }): Promise<LiveAcpConnection>;
     close(): Promise<void>;
     hasBoundSession(localSessionId: string, agentSessionId?: string): boolean;
@@ -1576,9 +1613,33 @@ declare class LiveAcpConnection {
     sendSessionMethod(localSessionId: string, method: string, params: Record<string, unknown>, options: SessionSendOptions): Promise<unknown>;
     private handleEnvelope;
     private handleAdapterNotification;
+    private handlePermissionRequest;
     private resolveSessionId;
     private localFromEnvelopeParams;
 }
+declare class ProcessTerminalSession {
+    readonly socket: WebSocket;
+    readonly closed: Promise<void>;
+    private readonly readyListeners;
+    private readonly dataListeners;
+    private readonly exitListeners;
+    private readonly errorListeners;
+    private readonly closeListeners;
+    private closeSignalSent;
+    private closedResolve;
+    constructor(socket: WebSocket);
+    onReady(listener: (status: TerminalReadyStatus) => void): () => void;
+    onData(listener: (data: Uint8Array) => void): () => void;
+    onExit(listener: (status: TerminalExitStatus) => void): () => void;
+    onError(listener: (error: TerminalErrorStatus | Error) => void): () => void;
+    onClose(listener: () => void): () => void;
+    sendInput(data: string | ArrayBuffer | ArrayBufferView): void;
+    resize(payload: TerminalResizePayload): void;
+    close(): void;
+    private handleMessage;
+    private sendFrame;
+    private emitError;
+}
 declare class SandboxAgent {
     private readonly baseUrl;
     private readonly token?;
@@ -1597,6 +1658,8 @@ declare class SandboxAgent {
     private readonly pendingLiveConnections;
     private readonly sessionHandles;
     private readonly eventListeners;
+    private readonly permissionListeners;
+    private readonly pendingPermissionRequests;
     private readonly nextSessionEventIndexBySession;
     private readonly seedSessionEventIndexBySession;
     constructor(options: SandboxAgentConnectOptions);
@@ -1630,13 +1693,16 @@ declare class SandboxAgent {
     getSessionModes(sessionId: string): Promise<SessionModeState | null>;
     private setSessionCategoryValue;
     private hydrateSessionConfigOptions;
-    sendSessionMethod(sessionId: string, method: string, params: Record<string, unknown>, options?: SessionSendOptions): Promise<{
+    rawSendSessionMethod(sessionId: string, method: string, params: Record<string, unknown>, options?: SessionSendOptions): Promise<{
         session: Session;
         response: unknown;
     }>;
     private sendSessionMethodInternal;
     private persistSessionStateFromMethod;
     onSessionEvent(sessionId: string, listener: SessionEventListener): () => void;
+    onPermissionRequest(sessionId: string, listener: PermissionRequestListener): () => void;
+    respondPermission(permissionId: string, reply: PermissionReply): Promise<void>;
+    rawRespondPermission(permissionId: string, response: RequestPermissionResponse): Promise<void>;
     getHealth(): Promise<HealthResponse>;
     listAgents(options?: AgentQueryOptions): Promise<AgentListResponse>;
     getAgent(agent: string, options?: AgentQueryOptions): Promise<AgentInfo>;
@@ -1671,6 +1737,7 @@ declare class SandboxAgent {
     resizeProcessTerminal(id: string, request: ProcessTerminalResizeRequest): Promise<ProcessTerminalResizeResponse>;
     buildProcessTerminalWebSocketUrl(id: string, options?: ProcessTerminalWebSocketUrlOptions): string;
     connectProcessTerminalWebSocket(id: string, options?: ProcessTerminalConnectOptions): WebSocket;
+    connectProcessTerminal(id: string, options?: ProcessTerminalSessionOptions): ProcessTerminalSession;
     private getLiveConnection;
     private persistObservedEnvelope;
     private persistSessionStateFromEvent;
@@ -1680,6 +1747,9 @@ declare class SandboxAgent {
     private collectReplayEvents;
     private upsertSessionHandle;
     private requireSessionRecord;
+    private enqueuePermissionRequest;
+    private resolvePendingPermission;
+    private cancelPendingPermissionsForSession;
     private requestJson;
     private requestRaw;
     private startHealthWait;
@@ -1711,4 +1781,4 @@ interface InspectorUrlOptions {
  */
 declare function buildInspectorUrl(options: InspectorUrlOptions): string;
 
-export { type AcpEnvelope, type AcpServerInfo, type AcpServerListResponse, type AgentInfo, type AgentInstallRequest, type AgentInstallResponse, type AgentListResponse, type AgentQuery, type AgentQueryOptions, type FsActionResponse, type FsDeleteQuery, type FsEntriesQuery, type FsEntry, type FsMoveRequest, type FsMoveResponse, type FsPathQuery, type FsStat, type FsUploadBatchQuery, type FsUploadBatchResponse, type FsWriteResponse, type HealthResponse, InMemorySessionPersistDriver, type InMemorySessionPersistDriverOptions, type InspectorUrlOptions, type ListEventsRequest, type ListPage, type ListPageRequest, LiveAcpConnection, type McpConfigQuery, type McpServerConfig, type ProblemDetails, type ProcessConfig, type ProcessCreateRequest, type ProcessInfo, type ProcessInputRequest, type ProcessInputResponse, type ProcessListResponse, type ProcessLogEntry, type ProcessLogFollowQuery, type ProcessLogListener, type ProcessLogSubscription, type ProcessLogsQuery, type ProcessLogsResponse, type ProcessLogsStream, type ProcessRunRequest, type ProcessRunResponse, type ProcessSignalQuery, type ProcessState, type ProcessTerminalClientFrame, type ProcessTerminalConnectOptions, type ProcessTerminalErrorFrame, type ProcessTerminalExitFrame, type ProcessTerminalReadyFrame, type ProcessTerminalResizeRequest, type ProcessTerminalResizeResponse, type ProcessTerminalServerFrame, type ProcessTerminalWebSocketUrlOptions, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentHealthWaitOptions, type SandboxAgentSpawnLogMode, type SandboxAgentSpawnOptions, type SandboxAgentStartOptions, Session, type SessionCreateRequest, type SessionEvent, type SessionEventListener, type SessionPersistDriver, type SessionRecord, type SessionResumeOrCreateRequest, type SessionSendOptions, type SkillsConfig, type SkillsConfigQuery, UnsupportedSessionCategoryError, UnsupportedSessionConfigOptionError, UnsupportedSessionValueError, buildInspectorUrl };
+export { type AcpEnvelope, type AcpServerInfo, type AcpServerListResponse, type AgentInfo, type AgentInstallRequest, type AgentInstallResponse, type AgentListResponse, type AgentQuery, type AgentQueryOptions, type FsActionResponse, type FsDeleteQuery, type FsEntriesQuery, type FsEntry, type FsMoveRequest, type FsMoveResponse, type FsPathQuery, type FsStat, type FsUploadBatchQuery, type FsUploadBatchResponse, type FsWriteResponse, type HealthResponse, InMemorySessionPersistDriver, type InMemorySessionPersistDriverOptions, type InspectorUrlOptions, type ListEventsRequest, type ListPage, type ListPageRequest, LiveAcpConnection, type McpConfigQuery, type McpServerConfig, type PermissionReply, type PermissionRequestListener, type ProblemDetails, type ProcessConfig, type ProcessCreateRequest, type ProcessInfo, type ProcessInputRequest, type ProcessInputResponse, type ProcessListResponse, type ProcessLogEntry, type ProcessLogFollowQuery, type ProcessLogListener, type ProcessLogSubscription, type ProcessLogsQuery, type ProcessLogsResponse, type ProcessLogsStream, type ProcessRunRequest, type ProcessRunResponse, type ProcessSignalQuery, type ProcessState, type ProcessTerminalClientFrame, type ProcessTerminalConnectOptions, type ProcessTerminalErrorFrame, type ProcessTerminalExitFrame, type ProcessTerminalReadyFrame, type ProcessTerminalResizeRequest, type ProcessTerminalResizeResponse, type ProcessTerminalServerFrame, ProcessTerminalSession, type ProcessTerminalSessionOptions, type ProcessTerminalWebSocketUrlOptions, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentHealthWaitOptions, type SandboxAgentSpawnLogMode, type SandboxAgentSpawnOptions, type SandboxAgentStartOptions, Session, type SessionCreateRequest, type SessionEvent, type SessionEventListener, type SessionPermissionRequest, type SessionPermissionRequestOption, type SessionPersistDriver, type SessionRecord, type SessionResumeOrCreateRequest, type SessionSendOptions, type SkillsConfig, type SkillsConfigQuery, type TerminalErrorStatus, type TerminalExitStatus, type TerminalReadyStatus, type TerminalResizePayload, type TerminalStatusMessage, UnsupportedPermissionReplyError, UnsupportedSessionCategoryError, UnsupportedSessionConfigOptionError, UnsupportedSessionValueError, buildInspectorUrl };