@agentknight/sdk 0.9.35

package/dist/index.d.ts

@@ -0,0 +1,1962 @@
+import { Logger } from 'pino';
+import { z } from 'zod';
+import { ManagerOptions, SocketOptions } from 'socket.io-client';
+
+declare const OperationAckSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>], "ok">;
+type OperationAck = z.infer<typeof OperationAckSchema>;
+declare const ProtocolErrorSchema: z.ZodObject<{
+    event: z.ZodString;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+type ProtocolError = z.infer<typeof ProtocolErrorSchema>;
+
+declare const SecureEventNameSchema: z.ZodEnum<{
+    "session.communication": "session.communication";
+    "session.list.result": "session.list.result";
+    "session.options.result": "session.options.result";
+    "session.create.result": "session.create.result";
+    "session.delete.result": "session.delete.result";
+    "session.configure.result": "session.configure.result";
+    "session.remote.result": "session.remote.result";
+    "session.timeline.page.result": "session.timeline.page.result";
+    "session.watch.result": "session.watch.result";
+    "session.prompt.result": "session.prompt.result";
+    "session.activity": "session.activity";
+    "session.abort.result": "session.abort.result";
+    "conversation.item.upsert": "conversation.item.upsert";
+    "conversation.activity.step.upsert": "conversation.activity.step.upsert";
+    "session.timeline.invalidated": "session.timeline.invalidated";
+    "interaction.request": "interaction.request";
+    "interaction.respond.result": "interaction.respond.result";
+    "permission.request": "permission.request";
+    "permission.respond.result": "permission.respond.result";
+    "sessions.snapshot": "sessions.snapshot";
+    "session.list": "session.list";
+    "session.options": "session.options";
+    "session.create": "session.create";
+    "session.delete": "session.delete";
+    "session.configure": "session.configure";
+    "session.remote": "session.remote";
+    "session.timeline.page": "session.timeline.page";
+    "session.watch": "session.watch";
+    "session.prompt": "session.prompt";
+    "session.abort": "session.abort";
+    "interaction.respond": "interaction.respond";
+    "permission.respond": "permission.respond";
+}>;
+type SecureEventName = z.infer<typeof SecureEventNameSchema>;
+
+declare const SecureMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    sender: z.ZodLiteral<"pc">;
+    event: z.ZodEnum<{
+        "session.communication": "session.communication";
+        "session.list.result": "session.list.result";
+        "session.options.result": "session.options.result";
+        "session.create.result": "session.create.result";
+        "session.delete.result": "session.delete.result";
+        "session.configure.result": "session.configure.result";
+        "session.remote.result": "session.remote.result";
+        "session.timeline.page.result": "session.timeline.page.result";
+        "session.watch.result": "session.watch.result";
+        "session.prompt.result": "session.prompt.result";
+        "session.activity": "session.activity";
+        "session.abort.result": "session.abort.result";
+        "conversation.item.upsert": "conversation.item.upsert";
+        "conversation.activity.step.upsert": "conversation.activity.step.upsert";
+        "session.timeline.invalidated": "session.timeline.invalidated";
+        "interaction.request": "interaction.request";
+        "interaction.respond.result": "interaction.respond.result";
+        "permission.request": "permission.request";
+        "permission.respond.result": "permission.respond.result";
+        "sessions.snapshot": "sessions.snapshot";
+    }>;
+    version: z.ZodLiteral<1>;
+    algorithm: z.ZodLiteral<"A256GCM">;
+    messageId: z.ZodString;
+    machineId: z.ZodString;
+    clientId: z.ZodString;
+    recipientClientId: z.ZodOptional<z.ZodString>;
+    keyId: z.ZodString;
+    sentAt: z.ZodNumber;
+    nonce: z.ZodString;
+    ciphertext: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    sender: z.ZodLiteral<"mobile">;
+    event: z.ZodEnum<{
+        "session.communication": "session.communication";
+        "session.list": "session.list";
+        "session.options": "session.options";
+        "session.create": "session.create";
+        "session.delete": "session.delete";
+        "session.configure": "session.configure";
+        "session.remote": "session.remote";
+        "session.timeline.page": "session.timeline.page";
+        "session.watch": "session.watch";
+        "session.prompt": "session.prompt";
+        "session.abort": "session.abort";
+        "interaction.respond": "interaction.respond";
+        "permission.respond": "permission.respond";
+    }>;
+    version: z.ZodLiteral<1>;
+    algorithm: z.ZodLiteral<"A256GCM">;
+    messageId: z.ZodString;
+    machineId: z.ZodString;
+    clientId: z.ZodString;
+    recipientClientId: z.ZodOptional<z.ZodString>;
+    keyId: z.ZodString;
+    sentAt: z.ZodNumber;
+    nonce: z.ZodString;
+    ciphertext: z.ZodString;
+}, z.core.$strict>], "sender">;
+type SecureMessage = z.infer<typeof SecureMessageSchema>;
+declare const SecureDeliveryErrorSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    event: z.ZodEnum<{
+        "session.communication": "session.communication";
+        "session.list.result": "session.list.result";
+        "session.options.result": "session.options.result";
+        "session.create.result": "session.create.result";
+        "session.delete.result": "session.delete.result";
+        "session.configure.result": "session.configure.result";
+        "session.remote.result": "session.remote.result";
+        "session.timeline.page.result": "session.timeline.page.result";
+        "session.watch.result": "session.watch.result";
+        "session.prompt.result": "session.prompt.result";
+        "session.activity": "session.activity";
+        "session.abort.result": "session.abort.result";
+        "conversation.item.upsert": "conversation.item.upsert";
+        "conversation.activity.step.upsert": "conversation.activity.step.upsert";
+        "session.timeline.invalidated": "session.timeline.invalidated";
+        "interaction.request": "interaction.request";
+        "interaction.respond.result": "interaction.respond.result";
+        "permission.request": "permission.request";
+        "permission.respond.result": "permission.respond.result";
+        "sessions.snapshot": "sessions.snapshot";
+        "session.list": "session.list";
+        "session.options": "session.options";
+        "session.create": "session.create";
+        "session.delete": "session.delete";
+        "session.configure": "session.configure";
+        "session.remote": "session.remote";
+        "session.timeline.page": "session.timeline.page";
+        "session.watch": "session.watch";
+        "session.prompt": "session.prompt";
+        "session.abort": "session.abort";
+        "interaction.respond": "interaction.respond";
+        "permission.respond": "permission.respond";
+    }>;
+    machineId: z.ZodString;
+    code: z.ZodEnum<{
+        MACHINE_OFFLINE: "MACHINE_OFFLINE";
+        IDENTITY_MISMATCH: "IDENTITY_MISMATCH";
+        KEY_ID_MISMATCH: "KEY_ID_MISMATCH";
+        INVALID_PAYLOAD: "INVALID_PAYLOAD";
+        SESSION_DELETE_UNSUPPORTED: "SESSION_DELETE_UNSUPPORTED";
+        SESSION_COMMUNICATION_UNSUPPORTED: "SESSION_COMMUNICATION_UNSUPPORTED";
+    }>;
+    message: z.ZodString;
+}, z.core.$strict>;
+type SecureDeliveryError = z.infer<typeof SecureDeliveryErrorSchema>;
+
+declare const V2MachineHelloSchema: z.ZodUnion<readonly [z.ZodObject<{
+    protocolVersion: z.ZodLiteral<9>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<10>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<11>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>]>;
+type V2MachineHello = z.infer<typeof V2MachineHelloSchema>;
+declare const MachineHeartbeatSchema: z.ZodObject<{
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    agentRunId: z.ZodString;
+    sentAt: z.ZodNumber;
+}, z.core.$strip>;
+type MachineHeartbeat = z.infer<typeof MachineHeartbeatSchema>;
+declare const MachinePresenceSchema: z.ZodUnion<readonly [z.ZodObject<{
+    protocolVersion: z.ZodLiteral<9>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    online: z.ZodLiteral<true>;
+    connectedAt: z.ZodNumber;
+    lastSeen: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<10>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    online: z.ZodLiteral<true>;
+    connectedAt: z.ZodNumber;
+    lastSeen: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<11>;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    machineName: z.ZodString;
+    platform: z.ZodString;
+    agentRunId: z.ZodString;
+    sdkVersion: z.ZodLiteral<"1.0.9">;
+    clientVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    online: z.ZodLiteral<true>;
+    connectedAt: z.ZodNumber;
+    lastSeen: z.ZodNumber;
+}, z.core.$strip>]>;
+type MachinePresence = z.infer<typeof MachinePresenceSchema>;
+declare const MachineOfflineSchema: z.ZodObject<{
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    agentRunId: z.ZodString;
+    disconnectedAt: z.ZodNumber;
+}, z.core.$strip>;
+type MachineOffline = z.infer<typeof MachineOfflineSchema>;
+declare const MobileDisconnectedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    machineId: z.ZodString;
+    disconnectedAt: z.ZodNumber;
+}, z.core.$strip>;
+type MobileDisconnected = z.infer<typeof MobileDisconnectedSchema>;
+declare const MobileConnectedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    machineId: z.ZodString;
+    connectedAt: z.ZodNumber;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type MobileConnected = z.infer<typeof MobileConnectedSchema>;
+declare const MachineListRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+}, z.core.$strip>;
+type MachineListRequest = z.infer<typeof MachineListRequestSchema>;
+declare const MachineListResultSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    machines: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        protocolVersion: z.ZodLiteral<9>;
+        userId: z.ZodString;
+        machineId: z.ZodString;
+        machineName: z.ZodString;
+        platform: z.ZodString;
+        agentRunId: z.ZodString;
+        sdkVersion: z.ZodLiteral<"1.0.9">;
+        clientVersion: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        online: z.ZodLiteral<true>;
+        connectedAt: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        protocolVersion: z.ZodLiteral<10>;
+        userId: z.ZodString;
+        machineId: z.ZodString;
+        machineName: z.ZodString;
+        platform: z.ZodString;
+        agentRunId: z.ZodString;
+        sdkVersion: z.ZodLiteral<"1.0.9">;
+        clientVersion: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        online: z.ZodLiteral<true>;
+        connectedAt: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        protocolVersion: z.ZodLiteral<11>;
+        userId: z.ZodString;
+        machineId: z.ZodString;
+        machineName: z.ZodString;
+        platform: z.ZodString;
+        agentRunId: z.ZodString;
+        sdkVersion: z.ZodLiteral<"1.0.9">;
+        clientVersion: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        online: z.ZodLiteral<true>;
+        connectedAt: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+    }, z.core.$strip>]>>;
+    relayCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type MachineListResult = z.infer<typeof MachineListResultSchema>;
+
+declare const PeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"request">;
+    content: z.ZodString;
+    timeoutMs: z.ZodNumber;
+    version: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    sourceSessionId: z.ZodString;
+    targetMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"response">;
+    requestId: z.ZodString;
+    content: z.ZodString;
+    version: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    sourceSessionId: z.ZodString;
+    targetMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"error">;
+    requestId: z.ZodString;
+    code: z.ZodString;
+    message: z.ZodString;
+    version: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    sourceSessionId: z.ZodString;
+    targetMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cancel">;
+    requestId: z.ZodString;
+    version: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    sourceSessionId: z.ZodString;
+    targetMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+}, z.core.$strict>], "kind">;
+type PeerMessage = z.infer<typeof PeerMessageSchema>;
+declare const PeerDeliverySchema: z.ZodObject<{
+    sourceMachineId: z.ZodString;
+    message: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"request">;
+        content: z.ZodString;
+        timeoutMs: z.ZodNumber;
+        version: z.ZodLiteral<1>;
+        messageId: z.ZodString;
+        sourceSessionId: z.ZodString;
+        targetMachineId: z.ZodString;
+        targetSessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"response">;
+        requestId: z.ZodString;
+        content: z.ZodString;
+        version: z.ZodLiteral<1>;
+        messageId: z.ZodString;
+        sourceSessionId: z.ZodString;
+        targetMachineId: z.ZodString;
+        targetSessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"error">;
+        requestId: z.ZodString;
+        code: z.ZodString;
+        message: z.ZodString;
+        version: z.ZodLiteral<1>;
+        messageId: z.ZodString;
+        sourceSessionId: z.ZodString;
+        targetMachineId: z.ZodString;
+        targetSessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cancel">;
+        requestId: z.ZodString;
+        version: z.ZodLiteral<1>;
+        messageId: z.ZodString;
+        sourceSessionId: z.ZodString;
+        targetMachineId: z.ZodString;
+        targetSessionId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+type PeerDelivery = z.infer<typeof PeerDeliverySchema>;
+
+declare const A2aRelayRequestSchema: z.ZodObject<{
+    userId: z.ZodString;
+    sourceMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+    endpointUrl: z.ZodURL;
+    kind: z.ZodEnum<{
+        card: "card";
+        rpc: "rpc";
+    }>;
+    body: z.ZodString;
+    protocolVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type A2aRelayRequest = z.infer<typeof A2aRelayRequestSchema>;
+declare const A2aRelayResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    body: z.ZodString;
+}, z.core.$strict>;
+type A2aRelayResponse = z.infer<typeof A2aRelayResponseSchema>;
+
+type Ack = (ack: OperationAck) => void;
+interface V2ClientToServerEvents {
+    "machine.hello": (payload: V2MachineHello, ack: Ack) => void;
+    "machine.heartbeat": (payload: MachineHeartbeat) => void;
+    "machine.list": (payload: MachineListRequest) => void;
+    "secure.message": (payload: SecureMessage, ack?: Ack) => void;
+    "peer.message": (payload: PeerMessage, ack?: Ack) => void;
+}
+interface V2ServerToClientEvents {
+    "a2a.request": (payload: A2aRelayRequest, ack: (response: A2aRelayResponse) => void) => void;
+    "machine.list.result": (payload: MachineListResult) => void;
+    "machine.online": (payload: MachinePresence) => void;
+    "machine.offline": (payload: MachineOffline) => void;
+    "mobile.connected": (payload: MobileConnected) => void;
+    "mobile.disconnected": (payload: MobileDisconnected) => void;
+    "secure.message": (payload: SecureMessage) => void;
+    "peer.message": (payload: PeerDelivery) => void;
+    "secure.delivery.error": (payload: SecureDeliveryError) => void;
+    "protocol.error": (payload: ProtocolError) => void;
+}
+
+declare const SessionGitProjectSchema: z.ZodObject<{
+    localRepositoryKey: z.ZodString;
+    worktreeRoot: z.ZodString;
+    mainWorktreeRoot: z.ZodOptional<z.ZodString>;
+    gitRemoteUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type SessionGitProject = z.infer<typeof SessionGitProjectSchema>;
+
+declare const SessionSummarySchema: z.ZodObject<{
+    userId: z.ZodString;
+    sessionId: z.ZodString;
+    machineId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    renameSupported: z.ZodOptional<z.ZodBoolean>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    gitRoot: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodString>;
+    gitRemoteUrl: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    isRemote: z.ZodBoolean;
+    createdAt: z.ZodISODateTime;
+    modifiedAt: z.ZodISODateTime;
+    groupChat: z.ZodOptional<z.ZodObject<{
+        participants: z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strict>>;
+        state: z.ZodEnum<{
+            blocked: "blocked";
+            ready: "ready";
+            running: "running";
+            paused: "paused";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+type SessionSummary = z.infer<typeof SessionSummarySchema>;
+declare const SessionAgentModeSchema: z.ZodEnum<{
+    interactive: "interactive";
+    plan: "plan";
+    autopilot: "autopilot";
+}>;
+type SessionAgentMode = z.infer<typeof SessionAgentModeSchema>;
+declare const AgentConfigurationOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    value: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type AgentConfigurationOption = z.infer<typeof AgentConfigurationOptionSchema>;
+declare const AgentConfigurationChangeSchema: z.ZodObject<{
+    id: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strict>;
+type AgentConfigurationChange = z.infer<typeof AgentConfigurationChangeSchema>;
+declare const CopilotModelOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    isDefault: z.ZodBoolean;
+    supportedReasoningEfforts: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>>;
+    defaultReasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    creation: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        agentName: z.ZodString;
+        modelName: z.ZodString;
+        agentModes: z.ZodArray<z.ZodEnum<{
+            interactive: "interactive";
+            plan: "plan";
+            autopilot: "autopilot";
+        }>>;
+        reasoningEffortConfigurationSupported: z.ZodBoolean;
+        isDefault: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+type CopilotModelOption = z.infer<typeof CopilotModelOptionSchema>;
+declare const SessionReasoningEffortSchema: z.ZodEnum<{
+    default: "default";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    xhigh: "xhigh";
+    max: "max";
+}>;
+type SessionReasoningEffort = z.infer<typeof SessionReasoningEffortSchema>;
+declare const CurrentReasoningEffortSchema: z.ZodString;
+type CurrentReasoningEffort = z.infer<typeof CurrentReasoningEffortSchema>;
+declare const SessionEnvironmentInfoSchema: z.ZodObject<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        deferred: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    slashCommands: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            builtin: "builtin";
+            skill: "skill";
+            client: "client";
+        }>;
+    }, z.core.$strip>>;
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+        enabled: z.ZodBoolean;
+        userInvocable: z.ZodBoolean;
+        commandName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type SessionEnvironmentInfo = z.infer<typeof SessionEnvironmentInfoSchema>;
+declare const SessionRemoteStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        error: "error";
+        off: "off";
+        connecting: "connecting";
+        active: "active";
+    }>;
+    attachedSessionId: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    steerable: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type SessionRemoteStatus = z.infer<typeof SessionRemoteStatusSchema>;
+
+declare const InteractionRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"permission">;
+    permissionKind: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    canApproveSession: z.ZodBoolean;
+    canApproveAlways: z.ZodOptional<z.ZodBoolean>;
+    approvalScope: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"user_input">;
+    question: z.ZodString;
+    choices: z.ZodArray<z.ZodString>;
+    allowFreeform: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"elicitation">;
+    message: z.ZodString;
+    mode: z.ZodEnum<{
+        url: "url";
+        form: "form";
+    }>;
+    source: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    fields: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        inputType: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            text: "text";
+            integer: "integer";
+            select: "select";
+            "multi-select": "multi-select";
+        }>;
+        required: z.ZodBoolean;
+        options: z.ZodArray<z.ZodString>;
+        defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        minimum: z.ZodOptional<z.ZodNumber>;
+        maximum: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minItems: z.ZodOptional<z.ZodNumber>;
+        maxItems: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<{
+            date: "date";
+            email: "email";
+            uri: "uri";
+            "date-time": "date-time";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"mcp_oauth">;
+    serverName: z.ZodString;
+    serverUrl: z.ZodURL;
+    reason: z.ZodEnum<{
+        initial: "initial";
+        refresh: "refresh";
+        reauth: "reauth";
+        upscope: "upscope";
+    }>;
+    responseMode: z.ZodLiteral<"cancel-only">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"mcp_headers">;
+    serverName: z.ZodString;
+    serverUrl: z.ZodURL;
+    reason: z.ZodString;
+    responseMode: z.ZodLiteral<"none-only">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"auto_mode_switch">;
+    errorCode: z.ZodOptional<z.ZodString>;
+    retryAfterSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"session_limits">;
+    maxAiCredits: z.ZodNumber;
+    usedAiCredits: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"exit_plan">;
+    summary: z.ZodString;
+    planContent: z.ZodOptional<z.ZodString>;
+    actions: z.ZodArray<z.ZodString>;
+    recommendedAction: z.ZodString;
+}, z.core.$strict>], "kind">;
+type InteractionRequest = z.infer<typeof InteractionRequestSchema>;
+declare const InteractionResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"permission">;
+    decision: z.ZodEnum<{
+        "approve-once": "approve-once";
+        "approve-for-session": "approve-for-session";
+        "approve-always": "approve-always";
+        reject: "reject";
+    }>;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"user_input">;
+    answer: z.ZodString;
+    wasFreeform: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"elicitation">;
+    action: z.ZodEnum<{
+        cancel: "cancel";
+        accept: "accept";
+        decline: "decline";
+    }>;
+    values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"mcp_oauth">;
+    action: z.ZodLiteral<"cancel">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"mcp_headers">;
+    action: z.ZodLiteral<"none">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"auto_mode_switch">;
+    action: z.ZodEnum<{
+        yes: "yes";
+        yes_always: "yes_always";
+        no: "no";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"session_limits">;
+    action: z.ZodEnum<{
+        set: "set";
+        cancel: "cancel";
+        add: "add";
+        unset: "unset";
+    }>;
+    additionalAiCredits: z.ZodOptional<z.ZodNumber>;
+    maxAiCredits: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"exit_plan">;
+    approved: z.ZodBoolean;
+    selectedAction: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "kind">;
+type InteractionResponse = z.infer<typeof InteractionResponseSchema>;
+
+declare const PromptImageAttachmentSchema: z.ZodObject<{
+    name: z.ZodString;
+    mimeType: z.ZodEnum<{
+        "image/webp": "image/webp";
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+    }>;
+    data: z.ZodString;
+    byteLength: z.ZodNumber;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+type PromptImageAttachment = z.infer<typeof PromptImageAttachmentSchema>;
+declare const PromptFileAttachmentSchema: z.ZodObject<{
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    data: z.ZodString;
+    byteLength: z.ZodNumber;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+type PromptFileAttachment = z.infer<typeof PromptFileAttachmentSchema>;
+
+declare const ConversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"human-message">;
+    actor: z.ZodLiteral<"human">;
+    content: z.ZodString;
+    attachments: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            unknown: "unknown";
+            file: "file";
+            image: "image";
+            html: "html";
+            selection: "selection";
+            "github-reference": "github-reference";
+        }>;
+        name: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodString>;
+        byteLength: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
+    }, z.core.$strict>>;
+    operationId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    sourceEventIds: z.ZodArray<z.ZodString>;
+    sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"assistant-message">;
+    actor: z.ZodEnum<{
+        subagent: "subagent";
+        assistant: "assistant";
+    }>;
+    content: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            unknown: "unknown";
+            file: "file";
+            image: "image";
+            html: "html";
+            selection: "selection";
+            "github-reference": "github-reference";
+        }>;
+        name: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodString>;
+        byteLength: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
+    }, z.core.$strict>>>;
+    model: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    final: z.ZodBoolean;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    sourceEventIds: z.ZodArray<z.ZodString>;
+    sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"activity-group">;
+    actor: z.ZodEnum<{
+        subagent: "subagent";
+        assistant: "assistant";
+    }>;
+    status: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"tool">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"skill">;
+        name: z.ZodString;
+        status: z.ZodLiteral<"completed">;
+        description: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"subagent">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"permission">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    sourceEventIds: z.ZodArray<z.ZodString>;
+    sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"notice">;
+    actor: z.ZodEnum<{
+        subagent: "subagent";
+        assistant: "assistant";
+        system: "system";
+    }>;
+    severity: z.ZodEnum<{
+        success: "success";
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    presentation: z.ZodOptional<z.ZodLiteral<"compact">>;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    sourceEventIds: z.ZodArray<z.ZodString>;
+    sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"plan-update">;
+    actor: z.ZodEnum<{
+        subagent: "subagent";
+        assistant: "assistant";
+    }>;
+    operation: z.ZodEnum<{
+        created: "created";
+        updated: "updated";
+        deleted: "deleted";
+    }>;
+    content: z.ZodString;
+    todos: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        dependsOn: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    sourceEventIds: z.ZodArray<z.ZodString>;
+    sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>], "kind">;
+type ConversationItem = z.infer<typeof ConversationItemSchema>;
+declare const ConversationActivityStepUpsertSchema: z.ZodObject<{
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    sessionId: z.ZodString;
+    activityId: z.ZodString;
+    revision: z.ZodNumber;
+    turnId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    actor: z.ZodEnum<{
+        subagent: "subagent";
+        assistant: "assistant";
+    }>;
+    status: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    sourceEventId: z.ZodString;
+    step: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"tool">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"skill">;
+        name: z.ZodString;
+        status: z.ZodLiteral<"completed">;
+        description: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"subagent">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodLiteral<"permission">;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+type ConversationActivityStepUpsert = z.infer<typeof ConversationActivityStepUpsertSchema>;
+
+declare const SessionTimelinePageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"human-message">;
+        actor: z.ZodLiteral<"human">;
+        content: z.ZodString;
+        attachments: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                unknown: "unknown";
+                file: "file";
+                image: "image";
+                html: "html";
+                selection: "selection";
+                "github-reference": "github-reference";
+            }>;
+            name: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodString>;
+            byteLength: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
+        }, z.core.$strict>>;
+        operationId: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        turnId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"assistant-message">;
+        actor: z.ZodEnum<{
+            subagent: "subagent";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                unknown: "unknown";
+                file: "file";
+                image: "image";
+                html: "html";
+                selection: "selection";
+                "github-reference": "github-reference";
+            }>;
+            name: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodString>;
+            byteLength: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
+        }, z.core.$strict>>>;
+        model: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        final: z.ZodBoolean;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        turnId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"activity-group">;
+        actor: z.ZodEnum<{
+            subagent: "subagent";
+            assistant: "assistant";
+        }>;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            timestamp: z.ZodOptional<z.ZodISODateTime>;
+            id: z.ZodString;
+            kind: z.ZodLiteral<"tool">;
+            name: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            timestamp: z.ZodOptional<z.ZodISODateTime>;
+            id: z.ZodString;
+            kind: z.ZodLiteral<"skill">;
+            name: z.ZodString;
+            status: z.ZodLiteral<"completed">;
+            description: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            timestamp: z.ZodOptional<z.ZodISODateTime>;
+            id: z.ZodString;
+            kind: z.ZodLiteral<"subagent">;
+            name: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            resultSummary: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            timestamp: z.ZodOptional<z.ZodISODateTime>;
+            id: z.ZodString;
+            kind: z.ZodLiteral<"permission">;
+            name: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            resultSummary: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "kind">>;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        turnId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"notice">;
+        actor: z.ZodEnum<{
+            subagent: "subagent";
+            assistant: "assistant";
+            system: "system";
+        }>;
+        severity: z.ZodEnum<{
+            success: "success";
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        content: z.ZodString;
+        presentation: z.ZodOptional<z.ZodLiteral<"compact">>;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        turnId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"plan-update">;
+        actor: z.ZodEnum<{
+            subagent: "subagent";
+            assistant: "assistant";
+        }>;
+        operation: z.ZodEnum<{
+            created: "created";
+            updated: "updated";
+            deleted: "deleted";
+        }>;
+        content: z.ZodString;
+        todos: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            status: z.ZodString;
+            dependsOn: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        turnId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        sourceMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceInteractionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>], "kind">>;
+    cursor: z.ZodString;
+    hasMore: z.ZodBoolean;
+    cursorStatus: z.ZodEnum<{
+        ok: "ok";
+        expired: "expired";
+    }>;
+    assistantPreview: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        timestamp: z.ZodISODateTime;
+        sourceEventIds: z.ZodArray<z.ZodString>;
+        text: z.ZodString;
+        final: z.ZodBoolean;
+        attachments: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                unknown: "unknown";
+                file: "file";
+                image: "image";
+                html: "html";
+                selection: "selection";
+                "github-reference": "github-reference";
+            }>;
+            name: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodString>;
+            byteLength: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>;
+    userPreview: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        timestamp: z.ZodISODateTime;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+    previewsComplete: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type SessionTimelinePage = z.infer<typeof SessionTimelinePageSchema>;
+declare const SessionTimelineInvalidatedSchema: z.ZodObject<{
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    sessionId: z.ZodString;
+    reason: z.ZodEnum<{
+        clear: "clear";
+        rewind: "rewind";
+    }>;
+    sourceEventId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>;
+type SessionTimelineInvalidated = z.infer<typeof SessionTimelineInvalidatedSchema>;
+
+declare const WorkbenchAskResultSchema: z.ZodObject<{
+    answer: z.ZodString;
+}, z.core.$strict>;
+type WorkbenchAskResult = z.infer<typeof WorkbenchAskResultSchema>;
+declare const WorkbenchCommandSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    argumentHint: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        builtin: "builtin";
+        skill: "skill";
+        client: "client";
+    }>;
+    allowDuringExecution: z.ZodBoolean;
+    supported: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type WorkbenchCommand = z.infer<typeof WorkbenchCommandSchema>;
+declare const WorkbenchCommandResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"completed">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"sent">;
+    messageId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"select-subcommand">;
+    choices: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        input: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+type WorkbenchCommandResult = z.infer<typeof WorkbenchCommandResultSchema>;
+declare const WorkbenchQueueSnapshotSchema: z.ZodObject<{
+    generation: z.ZodString;
+    revision: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        texts: z.ZodArray<z.ZodString>;
+        actions: z.ZodArray<z.ZodEnum<{
+            edit: "edit";
+            remove: "remove";
+            move: "move";
+            "send-now": "send-now";
+        }>>;
+    }, z.core.$strict>>;
+    steeringMessages: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+type WorkbenchQueueSnapshot = z.infer<typeof WorkbenchQueueSnapshotSchema>;
+declare const WorkbenchQueueMutationRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"edit">;
+    prompt: z.ZodString;
+    generation: z.ZodString;
+    revision: z.ZodString;
+    id: z.ZodString;
+    operationId: z.ZodUUID;
+    operationCreatedAt: z.ZodISODateTime;
+    expectedAgentRunId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"remove">;
+    generation: z.ZodString;
+    revision: z.ZodString;
+    id: z.ZodString;
+    operationId: z.ZodUUID;
+    operationCreatedAt: z.ZodISODateTime;
+    expectedAgentRunId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"move">;
+    toPosition: z.ZodNumber;
+    generation: z.ZodString;
+    revision: z.ZodString;
+    id: z.ZodString;
+    operationId: z.ZodUUID;
+    operationCreatedAt: z.ZodISODateTime;
+    expectedAgentRunId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"send-now">;
+    generation: z.ZodString;
+    revision: z.ZodString;
+    id: z.ZodString;
+    operationId: z.ZodUUID;
+    operationCreatedAt: z.ZodISODateTime;
+    expectedAgentRunId: z.ZodString;
+}, z.core.$strict>], "action">;
+type WorkbenchQueueMutationRequest = z.infer<typeof WorkbenchQueueMutationRequestSchema>;
+declare const WorkbenchQueueMutationResultSchema: z.ZodObject<{
+    changed: z.ZodBoolean;
+    snapshot: z.ZodObject<{
+        generation: z.ZodString;
+        revision: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            texts: z.ZodArray<z.ZodString>;
+            actions: z.ZodArray<z.ZodEnum<{
+                edit: "edit";
+                remove: "remove";
+                move: "move";
+                "send-now": "send-now";
+            }>>;
+        }, z.core.$strict>>;
+        steeringMessages: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type WorkbenchQueueMutationResult = z.infer<typeof WorkbenchQueueMutationResultSchema>;
+declare const WorkbenchInsightsSchema: z.ZodObject<{
+    sampledAt: z.ZodISODateTime;
+    generation: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    totalUserRequests: z.ZodNumber;
+    premiumRequestCost: z.ZodNumber;
+    nanoAiu: z.ZodOptional<z.ZodString>;
+    tokens: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strict>>;
+    models: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        requests: z.ZodNumber;
+        premiumRequestCost: z.ZodNumber;
+        tokens: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    context: z.ZodOptional<z.ZodObject<{
+        currentTokens: z.ZodNumber;
+        tokenLimit: z.ZodNumber;
+        systemTokens: z.ZodOptional<z.ZodNumber>;
+        conversationTokens: z.ZodOptional<z.ZodNumber>;
+        toolTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    canCompact: z.ZodBoolean;
+    compactUnavailableReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type WorkbenchInsights = z.infer<typeof WorkbenchInsightsSchema>;
+declare const WorkbenchCompactResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    tokensRemoved: z.ZodNumber;
+    messagesRemoved: z.ZodNumber;
+}, z.core.$strict>;
+type WorkbenchCompactResult = z.infer<typeof WorkbenchCompactResultSchema>;
+
+declare const WorkbenchScheduleSnapshotSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        active: "active";
+        "needs-resume": "needs-resume";
+    }>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        prompt: z.ZodString;
+        displayPrompt: z.ZodOptional<z.ZodString>;
+        recurring: z.ZodBoolean;
+        nextRunAt: z.ZodISODateTime;
+        intervalMs: z.ZodOptional<z.ZodNumber>;
+        cron: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    drafts: z.ZodArray<z.ZodObject<{
+        rule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"once">;
+            at: z.ZodISODateTime;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"interval">;
+            seconds: z.ZodNumber;
+            recurring: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"cron">;
+            expression: z.ZodString;
+            timezone: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        prompt: z.ZodString;
+        skill: z.ZodOptional<z.ZodString>;
+        id: z.ZodUUID;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        scheduleId: z.ZodNumber;
+        triggerEventId: z.ZodString;
+        time: z.ZodISODateTime;
+        prompt: z.ZodString;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            error: "error";
+            pending: "pending";
+            reply: "reply";
+            merged: "merged";
+        }>;
+        reply: z.ZodOptional<z.ZodString>;
+        replyEventId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    historyTruncated: z.ZodBoolean;
+    sampledAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const WorkbenchScheduleCreateRequestSchema: z.ZodObject<{
+    draftId: z.ZodOptional<z.ZodUUID>;
+    rule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"once">;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"interval">;
+        seconds: z.ZodNumber;
+        recurring: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cron">;
+        expression: z.ZodString;
+        timezone: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    prompt: z.ZodString;
+    skill: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodUUID;
+    operationCreatedAt: z.ZodISODateTime;
+    expectedAgentRunId: z.ZodString;
+}, z.core.$strict>;
+declare const WorkbenchScheduleCreateResultSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        state: z.ZodEnum<{
+            active: "active";
+            "needs-resume": "needs-resume";
+        }>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        entries: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            prompt: z.ZodString;
+            displayPrompt: z.ZodOptional<z.ZodString>;
+            recurring: z.ZodBoolean;
+            nextRunAt: z.ZodISODateTime;
+            intervalMs: z.ZodOptional<z.ZodNumber>;
+            cron: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        drafts: z.ZodArray<z.ZodObject<{
+            rule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"once">;
+                at: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"interval">;
+                seconds: z.ZodNumber;
+                recurring: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"cron">;
+                expression: z.ZodString;
+                timezone: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            prompt: z.ZodString;
+            skill: z.ZodOptional<z.ZodString>;
+            id: z.ZodUUID;
+            createdAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        results: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            scheduleId: z.ZodNumber;
+            triggerEventId: z.ZodString;
+            time: z.ZodISODateTime;
+            prompt: z.ZodString;
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                error: "error";
+                pending: "pending";
+                reply: "reply";
+                merged: "merged";
+            }>;
+            reply: z.ZodOptional<z.ZodString>;
+            replyEventId: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        historyTruncated: z.ZodBoolean;
+        sampledAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    verified: z.ZodBoolean;
+}, z.core.$strict>;
+declare const WorkbenchScheduleDeleteResultSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        state: z.ZodEnum<{
+            active: "active";
+            "needs-resume": "needs-resume";
+        }>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        entries: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            prompt: z.ZodString;
+            displayPrompt: z.ZodOptional<z.ZodString>;
+            recurring: z.ZodBoolean;
+            nextRunAt: z.ZodISODateTime;
+            intervalMs: z.ZodOptional<z.ZodNumber>;
+            cron: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+            at: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        drafts: z.ZodArray<z.ZodObject<{
+            rule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"once">;
+                at: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"interval">;
+                seconds: z.ZodNumber;
+                recurring: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"cron">;
+                expression: z.ZodString;
+                timezone: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            prompt: z.ZodString;
+            skill: z.ZodOptional<z.ZodString>;
+            id: z.ZodUUID;
+            createdAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        results: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            scheduleId: z.ZodNumber;
+            triggerEventId: z.ZodString;
+            time: z.ZodISODateTime;
+            prompt: z.ZodString;
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                error: "error";
+                pending: "pending";
+                reply: "reply";
+                merged: "merged";
+            }>;
+            reply: z.ZodOptional<z.ZodString>;
+            replyEventId: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        historyTruncated: z.ZodBoolean;
+        sampledAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    removed: z.ZodBoolean;
+}, z.core.$strict>;
+type WorkbenchScheduleSnapshot = z.infer<typeof WorkbenchScheduleSnapshotSchema>;
+type WorkbenchScheduleCreateRequest = z.infer<typeof WorkbenchScheduleCreateRequestSchema>;
+type WorkbenchScheduleCreateResult = z.infer<typeof WorkbenchScheduleCreateResultSchema>;
+type WorkbenchScheduleDeleteResult = z.infer<typeof WorkbenchScheduleDeleteResultSchema>;
+
+interface TimelineReadDiagnostic {
+    readRef: string;
+    readStarts: number;
+    readJoins: number;
+    untrackedReads: number;
+    inFlightReads: number;
+}
+
+interface WorkbenchSchedules {
+    isAvailable?(): boolean;
+    snapshot(sessionId: string): Promise<WorkbenchScheduleSnapshot>;
+    resume(sessionId: string, assertAccess?: () => void): Promise<WorkbenchScheduleSnapshot>;
+    create(sessionId: string, request: WorkbenchScheduleCreateRequest, assertAccess?: () => void): Promise<WorkbenchScheduleCreateResult>;
+    delete(sessionId: string, id: number, assertAccess?: () => void): Promise<WorkbenchScheduleDeleteResult>;
+    dismissDraft(sessionId: string, draftId: string, assertAccess?: () => void): Promise<void>;
+}
+
+interface WorkbenchRuntime {
+    readonly schedules?: WorkbenchSchedules;
+    ask(sessionId: string, question: string): Promise<WorkbenchAskResult>;
+    commands(sessionId: string): Promise<WorkbenchCommand[]>;
+    invokeCommand(sessionId: string, name: string, input: string, operationId: string): Promise<WorkbenchCommandResult>;
+    queue(sessionId: string): Promise<WorkbenchQueueSnapshot>;
+    mutateQueue(sessionId: string, request: WorkbenchQueueMutationRequest): Promise<WorkbenchQueueMutationResult>;
+    insights(sessionId: string): Promise<WorkbenchInsights>;
+    compact(sessionId: string): Promise<WorkbenchCompactResult>;
+}
+
+type CodingAgentId = "copilot" | "pi" | "acp";
+type AgentModelOption = CopilotModelOption;
+type AgentPermissionRequest = Readonly<{
+    kind: string;
+}>;
+interface AgentSessionConfiguration {
+    modelId?: string;
+    agentMode: SessionAgentMode;
+    reasoningEffort: CurrentReasoningEffort;
+    configOptions?: AgentConfigurationOption[];
+}
+interface AgentSessionCreateOptions {
+    userId: string;
+    machineId: string;
+    workingDirectory: string;
+    modelId: string;
+    agentMode: SessionAgentMode;
+    reasoningEffort?: SessionReasoningEffort;
+}
+interface AgentSessionConfigureOptions {
+    modelId?: string;
+    agentMode?: SessionAgentMode;
+    reasoningEffort?: SessionReasoningEffort;
+    configOption?: AgentConfigurationChange;
+}
+interface PeerTurnOptions {
+    signal: AbortSignal;
+    requestPeer?: (content: string) => Promise<string>;
+    awaitNativeSettlement?: true;
+}
+interface AgentImageProjectionFailure {
+    readonly source: "binary-result" | "binary-asset" | "content";
+    readonly reason: "asset-missing" | "asset-hash-mismatch" | "data-invalid" | "data-empty" | "data-too-large" | "length-mismatch" | "mime-unsupported" | "signature-mismatch";
+    readonly mimeType: string;
+    readonly expectedByteLength?: number;
+    readonly actualByteLength?: number;
+}
+interface CodingAgentSessionCallbacks {
+    onTimelineReadDiagnostic?(diagnostic: TimelineReadDiagnostic): void;
+    onConversationItem(sessionId: string, item: ConversationItem): void;
+    onTransientConversationItem?(sessionId: string, item: ConversationItem): void;
+    onAssistantPreview?(sessionId: string, item: ConversationItem): void;
+    onConversationActivityStep?(sessionId: string, delta: Omit<ConversationActivityStepUpsert, "userId" | "machineId" | "sessionId">): void;
+    onTimelineInvalidated?(sessionId: string, invalidation: Omit<SessionTimelineInvalidated, "userId" | "machineId" | "sessionId">): void;
+    onInteractionRequest?(sessionId: string, interactionRequestId: string, request: InteractionRequest): void;
+    onInteractionDismissed?(sessionId: string, interactionRequestId: string): void;
+    onPermissionRequest(sessionId: string, permissionRequestId: string, request: AgentPermissionRequest): void;
+    onSessionInventoryChanged(sessionId: string): void;
+    onSessionActivity?(sessionId: string, state: "working" | "idle", occurredAt: string): void;
+    onSyncError(sessionId: string, error: unknown): void;
+    onSyncRecovered?(sessionId: string): void;
+    onProjectMetadataError?(sessionId: string, error: unknown): void;
+    onProjectMetadataRecovered?(sessionId: string): void;
+    onImageProjectionFailure?(sessionId: string, failure: AgentImageProjectionFailure & {
+        readonly toolCallId: string;
+        readonly toolName: string;
+    }): void;
+}
+interface CodingAgentAdapter {
+    readonly workbench?: WorkbenchRuntime;
+    sessionPublicationSource?(sessionId: string): string;
+    captureWorkbenchAccess?(sessionId: string): () => void;
+    captureResearchAccess?(sessionId: string): ResearchSourceAccess;
+    readonly agentId: CodingAgentId | "managed";
+    readonly sdkVersion: string;
+    readonly agentModes: readonly SessionAgentMode[];
+    readonly supportsReasoningEffort: boolean;
+    readonly supportsSessionListUpdates?: boolean;
+    readonly supportsAssistantPreview?: boolean;
+    readonly supportsSessionDelete?: boolean;
+    readonly supportsFileAttachments?: boolean;
+    readonly groupChatEnabled?: boolean;
+    setGroupChatEnabled?(enabled: boolean): Promise<void>;
+    setPeerChatEnabled?(enabled: boolean): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    canUpgrade?(): Promise<boolean>;
+    listSessions(userId: string, machineId: string): Promise<SessionSummary[]>;
+    getSessionDirectoryMetadata?(sessionId: string): Promise<{
+        workingDirectory?: string;
+    } | undefined>;
+    getSessionProjectIdentity?(sessionId: string): Promise<SessionGitProject | undefined>;
+    listModels(sessionId?: string): Promise<AgentModelOption[]>;
+    getSessionCapabilities?(sessionId?: string): {
+        readonly agentModes: readonly SessionAgentMode[];
+        readonly supportsReasoningEffort: boolean;
+        readonly supportsFileAttachments?: boolean;
+        readonly agentName?: string;
+        readonly supportsPlanRead?: boolean;
+    };
+    isSessionVisible?(sessionId: string): boolean;
+    getSessionConfiguration(sessionId: string): Promise<AgentSessionConfiguration>;
+    getSessionEnvironment(sessionId: string): Promise<SessionEnvironmentInfo>;
+    createSession(options: AgentSessionCreateOptions): Promise<SessionSummary>;
+    createGroupChat?(sourceSessionId: string, peerSessionId: string, requestId: string, assertAccess?: () => void): Promise<SessionSummary>;
+    runPeerTurn?(sessionId: string, prompt: string, options: PeerTurnOptions): Promise<string>;
+    deleteSession?(sessionId: string): Promise<void>;
+    renameSession?(sessionId: string, name: string, assertAccess?: () => void): Promise<string>;
+    configureSession(sessionId: string, options: AgentSessionConfigureOptions): Promise<AgentSessionConfiguration>;
+    getSessionRemoteStatus(sessionId: string): Promise<SessionRemoteStatus>;
+    setSessionRemote(sessionId: string, enabled: boolean): Promise<SessionRemoteStatus>;
+    readSessionTimelinePage(sessionId: string, options?: {
+        cursor?: string;
+        pageSize?: number;
+        metadataOnly?: boolean;
+        assistantPreview?: boolean;
+    }): Promise<SessionTimelinePage>;
+    readSessionPlan?(sessionId: string): Promise<ConversationItem>;
+    watchSession(sessionId: string, watched: boolean): Promise<void>;
+    setSessionCallbacks(callbacks: CodingAgentSessionCallbacks): void;
+    sendPrompt(sessionId: string, prompt: string, mode: "enqueue" | "immediate", attachments?: readonly PromptImageAttachment[], persistInteractions?: boolean, fileAttachments?: readonly PromptFileAttachment[], operationId?: string): Promise<{
+        messageId: string;
+        deliveryState: "queued" | "processing";
+        submittedAt?: string;
+    }>;
+    abortSession(sessionId: string): Promise<void>;
+    respondPermission(permissionRequestId: string, decision: "approve-once" | "reject", feedback?: string): boolean;
+    respondInteraction(interactionRequestId: string, response: InteractionResponse): Promise<boolean>;
+    replayPendingInteractions(): void;
+}
+interface ResearchSourceAccess {
+    readonly detached: boolean;
+    readonly assertCurrent: () => void;
+}
+
+declare const AgentSelectionSchema: z.ZodObject<{
+    agents: z.ZodArray<z.ZodEnum<{
+        copilot: "copilot";
+        pi: "pi";
+        acp: "acp";
+    }>>;
+}, z.core.$strict>;
+type AgentSelection = z.infer<typeof AgentSelectionSchema>;
+interface SelectableAgent {
+    id: CodingAgentId;
+    name: string;
+    available: boolean;
+    selected: boolean;
+    error?: string;
+    sessions: {
+        id: string;
+        name: string;
+        workingDirectory?: string;
+    }[];
+}
+interface AgentSelectionProvider {
+    listAgents(): Promise<SelectableAgent[]>;
+    saveSelection(selection: AgentSelection): Promise<void>;
+}
+declare function supportsAgentSelection(adapter: CodingAgentAdapter): adapter is CodingAgentAdapter & AgentSelectionProvider;
+
+type CodingAgentConfig = {
+    kind: "managed";
+    initialSelection?: AgentSelection;
+    piDirectory?: string;
+    acp?: {
+        command: string;
+        args: string[];
+    };
+} | {
+    kind: "copilot";
+} | {
+    kind: "pi";
+    agentDirectory?: string;
+} | {
+    kind: "acp";
+    command: string;
+    args: string[];
+};
+interface PcAgentConfig {
+    relayUrl: string;
+    relayToken: string;
+    userId: string;
+    workspaceRoot?: string;
+    dataDirectory: string;
+    refreshIntervalMs: number;
+    heartbeatIntervalMs: number;
+    exitAfterSnapshot: boolean;
+    codingAgent?: CodingAgentConfig;
+    groupChatEnabled?: boolean;
+    peerChatEnabled?: boolean;
+    snapshotSuppressionEnabled?: boolean;
+    timelineCompressionEnabled?: boolean;
+    timelineIncrementalEnabled?: boolean;
+    secureMessagePacketBudget?: number;
+}
+
+/** Owns a data directory without opening an IPC or HTTP listener. */
+declare class DataDirectoryLease {
+    #private;
+    readonly directory: string;
+    readonly instanceId: string;
+    private readonly lockPath;
+    private constructor();
+    static acquire(dataDirectory: string): Promise<DataDirectoryLease>;
+    attach(dataDirectory: string): Promise<() => void>;
+    release(): Promise<void>;
+}
+
+declare const DeviceIdentitySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    machineId: z.ZodUUID;
+    stableDeviceId: z.ZodUUID;
+    machineName: z.ZodString;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type DeviceIdentity = z.infer<typeof DeviceIdentitySchema>;
+
+interface ContentKeyMaterial {
+    readonly encoded: string;
+    readonly keyId: string;
+    readonly bytes: Buffer;
+}
+interface ContentCipherOptions {
+    readonly now?: () => number;
+    readonly randomBytes?: (size: number) => Buffer;
+    readonly createMessageId?: () => string;
+    readonly replayWindowMs?: number;
+    readonly processedMessages?: ReadonlyMap<string, number>;
+    readonly persistProcessedMessages?: (processedMessages: ReadonlyMap<string, number>) => void;
+}
+declare function parseContentKey(encoded: string): ContentKeyMaterial;
+declare function generateContentKey(): ContentKeyMaterial;
+declare function loadOrCreateContentKey(dataDirectory: string): Promise<ContentKeyMaterial>;
+declare function createPersistentContentCipher(dataDirectory: string, key: ContentKeyMaterial): Promise<ContentCipher>;
+declare class ContentCipher {
+    #private;
+    constructor(key: ContentKeyMaterial, options?: ContentCipherOptions);
+    get keyId(): string;
+    seal(event: SecureEventName, sender: SecureMessage["sender"], machineId: string, clientId: string, recipientClientId: string | undefined, payload: unknown): SecureMessage;
+    sealWithSize(event: SecureEventName, sender: SecureMessage["sender"], machineId: string, clientId: string, recipientClientId: string | undefined, payload: unknown): {
+        message: SecureMessage;
+        plaintextBytes: number;
+    };
+    sealBytes(event: SecureEventName, sender: SecureMessage["sender"], machineId: string, clientId: string, recipientClientId: string | undefined, plaintext: Buffer): SecureMessage;
+    open(input: unknown): unknown;
+    openBytes(input: unknown): Buffer;
+}
+
+interface PairingTicket {
+    readonly uri: string;
+    readonly expiresAt: number;
+}
+interface PairingProvider {
+    getPairing(options?: {
+        readonly force?: boolean;
+    }): Promise<PairingTicket>;
+}
+declare class CachedPairingProvider implements PairingProvider {
+    #private;
+    constructor(requestPairing: () => Promise<PairingTicket>, minimumValidityMs?: number);
+    getPairing(options?: {
+        readonly force?: boolean;
+    }): Promise<PairingTicket>;
+}
+declare function buildPairingUri(relayUrl: string, code: string, machineId: string, contentKey: string): string;
+declare function requestPairingUri(config: Pick<PcAgentConfig, "relayUrl" | "relayToken" | "userId">, identity: DeviceIdentity, contentKey: ContentKeyMaterial): Promise<{
+    uri: string;
+    expiresAt: number;
+}>;
+
+declare const PEER_CHAT_TIMEOUT_MS = 120000;
+declare const PeerChatRequestSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    targetMachineId: z.ZodString;
+    targetSessionId: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strip>;
+type PeerChatRequest = z.infer<typeof PeerChatRequestSchema>;
+declare const PeerChatResultSchema: z.ZodObject<{
+    reply: z.ZodString;
+    peerReplies: z.ZodArray<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        contextId: z.ZodString;
+        exchanges: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodString;
+            requestMessageId: z.ZodString;
+            responseMessageId: z.ZodString;
+            request: z.ZodString;
+            response: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type PeerChatResult = z.infer<typeof PeerChatResultSchema>;
+
+type RelayRegistrationStatus = {
+    readonly state: "connecting" | "error";
+    readonly message: string;
+} | {
+    readonly state: "registered";
+};
+
+type OutboundArguments = {
+    [Event in keyof V2ClientToServerEvents]: [event: Event, ...args: Parameters<V2ClientToServerEvents[Event]>];
+}[keyof V2ClientToServerEvents];
+interface RelaySocket {
+    readonly connected: boolean;
+    readonly active: boolean;
+    readonly io: {
+        readonly engine?: {
+            readonly transport?: {
+                readonly name: string;
+            };
+        };
+    };
+    on(event: "connect", listener: () => void): void;
+    on(event: "connect_error", listener: (error: Error) => void): void;
+    on(event: "disconnect", listener: (reason: string, details?: unknown) => void): void;
+    on(event: "protocol.error", listener: V2ServerToClientEvents["protocol.error"]): void;
+    on(event: "secure.delivery.error", listener: V2ServerToClientEvents["secure.delivery.error"]): void;
+    on(event: "mobile.connected", listener: V2ServerToClientEvents["mobile.connected"]): void;
+    on(event: "mobile.disconnected", listener: V2ServerToClientEvents["mobile.disconnected"]): void;
+    on(event: "secure.message", listener: V2ServerToClientEvents["secure.message"]): void;
+    on(event: "peer.message", listener: V2ServerToClientEvents["peer.message"]): void;
+    on(event: "a2a.request", listener: V2ServerToClientEvents["a2a.request"]): void;
+    emit(...args: OutboundArguments): void;
+    connect(): void;
+    disconnect(): void;
+}
+type RelaySocketFactory = (uri: string, options: Partial<ManagerOptions & SocketOptions>) => RelaySocket;
+
+interface InitializeOptions extends Omit<PcAgentConfig, "refreshIntervalMs" | "heartbeatIntervalMs" | "exitAfterSnapshot"> {
+    refreshIntervalMs?: number;
+    heartbeatIntervalMs?: number;
+    exitAfterSnapshot?: boolean;
+    identity: DeviceIdentity;
+    logger: Logger;
+    adapter?: CodingAgentAdapter;
+    appVersion?: string;
+    directoryLease?: DataDirectoryLease;
+    onPairing?: (ticket: PairingTicket) => void;
+    createSocket?: RelaySocketFactory;
+}
+interface Agent {
+    readonly config: PcAgentConfig;
+    readonly identity: DeviceIdentity;
+    readonly adapter: CodingAgentAdapter;
+    readonly pairingProvider: PairingProvider;
+    readonly relayRegistrationStatus: RelayRegistrationStatus;
+    readonly isStopping: boolean;
+    readonly identityHash: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    waitUntilStopped(): Promise<void>;
+    getUpgradeStatus(): Promise<{
+        ready: boolean;
+        busy: boolean;
+    }>;
+    prepareForUpgrade(): Promise<void>;
+    cancelUpgrade(): void;
+    stopForUpgrade(): Promise<void>;
+    holdUpgradeStartup(): void;
+    runLocalMutation<T>(operation: () => Promise<T>): Promise<T>;
+    runPeerChat(request: PeerChatRequest, signal: AbortSignal): Promise<PeerChatResult>;
+    setPeerChatEnabled(enabled: boolean): Promise<void>;
+    getStatus(): Promise<{
+        state: "initialized" | "connecting" | "ready" | "error" | "stopped";
+        busy: boolean;
+    }>;
+}
+/** Initializes owned state only. The caller explicitly starts and stops the runtime. */
+declare function initialize(options: InitializeOptions): Promise<Agent>;
+
+declare function assertPiRuntimeSupported(nodeVersion?: string): void;
+declare function createCodingAgentAdapter(config: Pick<PcAgentConfig, "codingAgent" | "dataDirectory" | "groupChatEnabled" | "peerChatEnabled">, onDiagnostic?: (message: string) => void, owner?: Pick<AgentSessionCreateOptions, "userId" | "machineId">): Promise<CodingAgentAdapter>;
+
+interface CodingAgentPresentation {
+    readonly name: string;
+    readonly icon: string;
+}
+declare function codingAgentPresentation(agentId: string): CodingAgentPresentation;
+
+export { AgentSelectionSchema, CachedPairingProvider, ContentCipher, DataDirectoryLease, DeviceIdentitySchema, PEER_CHAT_TIMEOUT_MS, PeerChatRequestSchema, PeerChatResultSchema, assertPiRuntimeSupported, buildPairingUri, codingAgentPresentation, createCodingAgentAdapter, createPersistentContentCipher, generateContentKey, initialize, loadOrCreateContentKey, parseContentKey, requestPairingUri, supportsAgentSelection };
+export type { Agent, AgentSelection, AgentSelectionProvider, AgentSessionConfiguration, AgentSessionConfigureOptions, AgentSessionCreateOptions, CodingAgentAdapter, CodingAgentConfig, CodingAgentId, CodingAgentSessionCallbacks, ContentKeyMaterial, DeviceIdentity, InitializeOptions, PairingProvider, PairingTicket, PcAgentConfig, PeerChatRequest, PeerChatResult, RelayRegistrationStatus, RelaySocket, RelaySocketFactory, SelectableAgent };