@otto-code/client 0.8.10 → 0.8.13

package/README.md

@@ -1,12 +1,39 @@
 # @otto-code/client
 
-Otto's JavaScript/TypeScript client package.
+TypeScript SDK for building integrations on top of a Otto daemon.
 
-## Stability
+```bash
+npm install @otto-code/client
+```
+
+```ts
+import { createOttoClient } from "@otto-code/client";
+
+const client = createOttoClient({ url: "ws://127.0.0.1:6868/ws" });
+await client.connect();
+
+const agent = await client.agents.create({
+  config: { provider: "codex/gpt-5.5" },
+  cwd: "/Users/me/dev/storefront",
+  prompt: "Review the current diff and name the riskiest change.",
+});
+
+const result = await agent.waitForFinish();
+console.log(result.lastMessage);
+
+await client.close();
+```
 
-This package is public so Otto's published packages can depend on it cleanly.
-It is not a stable public SDK yet.
+The public API is the package root. Imports under `@otto-code/client/internal/*` are unsupported implementation details used by Otto's own packages.
+
+Read the [SDK documentation](https://otto-code.me/docs/sdk) for agents, workspaces, provider discovery, events, recipes, and the API reference. Runnable TypeScript patterns also live in [`examples/`](./examples/README.md).
+
+## Runtime
+
+The client needs a WebSocket implementation. Modern browsers and Node.js 22 provide one globally.
+
+Use a WebSocket URL ending in `/ws`, such as `ws://127.0.0.1:6868/ws`. Pass `password` when the daemon requires authentication.
+
+## Stability
 
-APIs, exports, runtime behavior, and types may change or disappear in any
-release without advance notice. Use it outside Otto at your own risk until the
-package is explicitly documented as stable.
+The high-level API exported from `@otto-code/client` is the supported SDK surface. The SDK and daemon remain protocol-compatible across versions, but newly added capabilities can require a newer daemon.

package/dist/compat/normalize-provider-models.js

@@ -1,4 +1,5 @@
 import { normalizeAgentModelDefinition } from "@otto-code/protocol/agent-types";
+import { expandProviderSnapshot } from "@otto-code/protocol/provider-snapshot-codec";
 // COMPAT(model-normalize): daemon normalizes at source (provider-registry) - shim covers older daemons; drop when floor >= v0.1.104
 function normalizeAgentModels(models) {
     if (!models) {
@@ -30,7 +31,9 @@ export function normalizeListProviderModelsPayload(payload) {
     return models === payload.models ? payload : { ...payload, models };
 }
 export function normalizeProvidersSnapshotPayload(payload) {
-    const entries = normalizeProviderSnapshotEntries(payload.entries);
+    const entries = payload.compactSnapshot
+        ? expandProviderSnapshot(payload.compactSnapshot)
+        : normalizeProviderSnapshotEntries(payload.entries);
     return entries === payload.entries ? payload : { ...payload, entries };
 }
 export function normalizeProviderSnapshotUpdateMessage(msg) {

package/dist/daemon-client-websocket-transport.d.ts

@@ -3,6 +3,10 @@ export declare function defaultWebSocketFactory(url: string, options?: {
     headers?: Record<string, string>;
     protocols?: string[];
 }): WebSocketLike;
+export declare function nativeWebSocketFactory(url: string, options?: {
+    headers?: Record<string, string>;
+    protocols?: string[];
+}): WebSocketLike;
 export declare function createWebSocketTransportFactory(factory: WebSocketFactory): DaemonTransportFactory;
 export declare function bindWsHandler(ws: WebSocketLike, event: "open" | "close" | "error" | "message", handler: (...args: unknown[]) => void): () => void;
 //# sourceMappingURL=daemon-client-websocket-transport.d.ts.map

package/dist/daemon-client-websocket-transport.js

@@ -1,10 +1,22 @@
 import { extractRelayMessage } from "./daemon-client-transport-utils.js";
-export function defaultWebSocketFactory(url, options) {
+function getGlobalWebSocket() {
     const globalWs = globalThis.WebSocket;
     if (!globalWs) {
         throw new Error("WebSocket is not available in this runtime");
     }
-    return new globalWs(url, options?.protocols);
+    return globalWs;
+}
+export function defaultWebSocketFactory(url, options) {
+    const globalWs = getGlobalWebSocket();
+    if (options?.protocols === undefined) {
+        return new globalWs(url);
+    }
+    return new globalWs(url, options.protocols);
+}
+// React Native and Node-compatible WebSocket implementations accept this extra options object.
+// Keep it out of the standard browser factory above.
+export function nativeWebSocketFactory(url, options) {
+    return new (getGlobalWebSocket())(url, options?.protocols, { headers: options?.headers });
 }
 export function createWebSocketTransportFactory(factory) {
     return ({ url, headers, protocols }) => {

package/dist/daemon-client.d.ts

@@ -3,10 +3,11 @@ import type { z } from "zod";
 import type { ProjectGithubCloneProtocol } from "@otto-code/protocol/messages";
 import { type ClientCapability } from "@otto-code/protocol/client-capabilities";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ServerInfoStatusPayload } from "@otto-code/protocol/messages";
-import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreateOttoWorktreeRequest, CodeListFilesResponse, CodeSymbolLocation, CodeDefinitionLocation, CodeDefinitionStatus, CodeRenameApplyStatus, CodeRenameFileOutcome, CodeRenameUndoFile, CodeRenameUndoStatus, CodeHoverRange, CodeRenameEdit, CodeRenameFilePlan, LspLanguageState, LspRunningServer, CodeSolutionGetTreeResponse, CodeSolutionLoadProjectResponse, SolutionFormat, SolutionRef, SolutionTreeFolder, SolutionTreeProject, SolutionProjectNode, SolutionProjectStatus, SolutionPackageReference, FileCreateResult, FileDeleteResult, FileDownloadTokenResponse, FileEntryKind, FileEol, FileRenameResult, FileReplaceFileResult, FileReplaceRequest, FileReplaceResponse, FileSearchResultPayload, FileSearchSummary, FileUploadResponse, FileExplorerResponse, FileWatchEventPayload, FileWriteResult, FileRefineResult, FileRefineDocument, FileRefineReference, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommitResponse, CheckoutGitCommitResponse, CheckoutGitCommitAgentResponse, CheckoutGitRollbackResponse, CheckoutGitFileHistoryResponse, CheckoutGitFileCommitDiffResponse, CheckoutGitFileBlameResponse, CheckoutGitFileOriginResponse, CheckoutGitGetOperationLogResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutGithubSetAutoMergeResponse, CheckoutGithubGetCheckDetailsResponse, PreviewListConfigResponse, PreviewStartResponse, PreviewBindTabResponse, PreviewStopResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, FileVersion, CheckoutCommit, ParsedDiffFile, WorkspaceRecoveryState, CheckoutForgeGetCheckDetailsResponse, CheckoutForgeSetAutoMergeResponse, ProjectCreateDirectoryResponse, FsFileWriteResult, FsFileWriteBinaryResult, GitHubSearchResponse, GitHubSearchRequest, ForgeSearchResponse, ForgeSearchRequest, GitHostingProviderId, HostingSearchRequest, HostingSearchResponse, HostingAuthStatusResponse, DirectorySuggestionsResponse, OttoWorktreeListResponse, OttoWorktreeArchiveResponse, ProjectIconResponse, ContextCategory, ContextPromptPreviewGetResponseMessage, ContextReportGetResponseMessage, ContextEdgeConvertResponseMessage, ContextFindingsFixResponseMessage, PersonalityMemoryListResponseMessage, PersonalityMemoryUpdateResponseMessage, PersonalityMemoryTransferResponseMessage, PersonalityMemoryStatsResponseMessage, ProjectKnowledgeListResponseMessage, ProjectKnowledgeGetResponseMessage, ProjectKnowledgeCreateResponseMessage, ProjectKnowledgeApplyResponseMessage, ProjectKnowledgeStatusResponseMessage, ProjectKnowledgeProjectApplyResponseMessage, ProjectKnowledgeReferenceApplyResponseMessage, ProjectKnowledgeRootApplyResponseMessage, ProjectKnowledgeDeleteResponseMessage, ProjectAddResponse, ProjectResolveWorkspaceForPathResponse, ProjectScaffoldGit, ProjectScaffoldProgress, ProjectScaffoldResponse, HostingListRepositoriesResponse, HostingListOwnersResponse, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceArchivePreflightResponse, WorktreeBaseRefSetResponse, WorktreeReattachListResponse, WorktreeReattachResponse, WorktreeReattachTarget, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, StatsActivityGetResponseMessage, StatsActivityResetResponseMessage, UsageLogGetResponseMessage, AgentContextGetUsageResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, AttachmentsImagesClearResponse, AttachmentsImagesStatsResponse, HistoryAgentsClearArchivedResponse, HistoryAgentsStorageStatsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalCompatibilityDiagnosticResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, AgentPromptDelivery, TasksSuggestedStartMode, OttoConfigRaw, OttoConfigRevision, WorkspaceCreateRequest } from "@otto-code/protocol/messages";
+import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreateOttoWorktreeRequest, CodeListFilesResponse, CodeSymbolLocation, CodeDefinitionLocation, CodeDefinitionStatus, CodeRenameApplyStatus, CodeRenameFileOutcome, CodeRenameUndoFile, CodeRenameUndoStatus, CodeHoverRange, CodeRenameEdit, CodeRenameFilePlan, LspLanguageState, LspRunningServer, CodeSolutionGetTreeResponse, CodeSolutionLoadProjectResponse, SolutionFormat, SolutionRef, SolutionTreeFolder, SolutionTreeProject, SolutionProjectNode, SolutionProjectStatus, SolutionPackageReference, FileDownloadTokenResponse, FileEntryKind, FileEol, FileReplaceFileResult, FileReplaceRequest, FileReplaceResponse, FileSearchResultPayload, FileSearchSummary, FileUploadResponse, FileExplorerResponse, FileWatchEventPayload, FileWriteResult, FileRefineResult, FileRefineDocument, FileRefineReference, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommitResponse, CheckoutGitCommitResponse, CheckoutGitCommitAgentResponse, CheckoutGitRollbackResponse, CheckoutGitFileHistoryResponse, CheckoutGitFileCommitDiffResponse, CheckoutGitFileBlameResponse, CheckoutGitFileOriginResponse, CheckoutGitGetOperationLogResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutGitFetchResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutGithubSetAutoMergeResponse, CheckoutGithubGetCheckDetailsResponse, PreviewListConfigResponse, PreviewStartResponse, PreviewBindTabResponse, PreviewStopResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, KanbanBoardsListResponse, ProjectKanbanTarget, KanbanBoardGetResponse, KanbanCardMoveResponse, KanbanCardCreateResponse, KanbanTaskLinkResponse, ValidateBranchResponse, BranchSuggestionsResponse, FileVersion, CheckoutCommit, ParsedDiffFile, WorkspaceRecoveryState, CheckoutForgeGetCheckDetailsResponse, CheckoutForgeSetAutoMergeResponse, ProjectCreateDirectoryResponse, FsFileWriteResult, FsFileWriteBinaryResult, GitHubSearchResponse, GitHubSearchRequest, ForgeSearchResponse, ForgeSearchRequest, GitHostingProviderId, HostingSearchRequest, HostingSearchResponse, HostingAuthStatusResponse, DirectorySuggestionsResponse, OttoWorktreeListResponse, OttoWorktreeArchiveResponse, ProjectIconSource, ProjectIconResponse, ContextCategory, ContextPromptPreviewGetResponseMessage, ContextReportGetResponseMessage, ContextEdgeConvertResponseMessage, ContextFindingsFixResponseMessage, PersonalityMemoryListResponseMessage, PersonalityMemoryUpdateResponseMessage, PersonalityMemoryTransferResponseMessage, PersonalityMemoryStatsResponseMessage, ProjectKnowledgeListResponseMessage, ProjectKnowledgeGetResponseMessage, ProjectKnowledgeCreateResponseMessage, ProjectKnowledgeApplyResponseMessage, ProjectKnowledgeStatusResponseMessage, ProjectKnowledgeProjectApplyResponseMessage, ProjectKnowledgeReferenceApplyResponseMessage, ProjectKnowledgeRootApplyResponseMessage, ProjectKnowledgeDeleteResponseMessage, ProjectIconGetResponse, ProjectAddResponse, ProjectResolveWorkspaceForPathResponse, ProjectScaffoldGit, ProjectScaffoldProgress, ProjectScaffoldResponse, HostingListRepositoriesResponse, HostingListOwnersResponse, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceArchivePreflightResponse, WorktreeBaseRefSetResponse, WorktreeReattachListResponse, WorktreeReattachResponse, WorktreeReattachTarget, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, StatsActivityGetResponseMessage, StatsActivityResetResponseMessage, UsageLogGetResponseMessage, AgentContextGetUsageResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, AttachmentsImagesClearResponse, AttachmentsImagesStatsResponse, HistoryAgentsClearArchivedResponse, HistoryAgentsStorageStatsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalCompatibilityDiagnosticResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, AgentPromptDelivery, TasksSuggestedStartMode, OttoConfigRaw, OttoConfigRevision, WorkspaceCreateRequest } from "@otto-code/protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@otto-code/protocol/agent-types";
 import type { OrchestrationGraph, PromptTemplate, Run } from "@otto-code/protocol/orchestration";
-import type { BrainCatalogModel, BrainDiskUsage, BrainEvals, BrainHfSearchResult, BrainHostStatus, BrainInstalledModel, BrainInventoryModel, BrainJob, BrainLogsTailResponse, BrainModelBudgetGetResponse, BrainModelDeleteResponse, BrainModelLoadResponse, BrainModelProfileGetResponse, BrainModelProfileSetResponse, BrainModelRenameResetResponse, BrainModelRenameResponse, BrainNetworkInfo, BrainRemoteConfig, BrainRepoQuant, BrainRuntime, ConnectorsListToolsResponse, ConnectorsOauthAuthorizeResponse, ConnectorsOauthDisconnectResponse, CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, SpeechTtsSpeakResult, SpeechTtsSpeakCancelResult, VisualizerVoiceCuesResult, AgentPersonalitiesGenerateProfileResult } from "@otto-code/protocol/messages";
+import type { BrainCatalogModel, BrainDiskUsage, BrainEvals, BrainHfSearchResult, BrainHostStatus, BrainInstalledModel, BrainInventoryModel, BrainJob, BrainLogsTailResponse, BrainLogsWatchResponse, BrainModelBudgetGetResponse, BrainModelDeleteResponse, BrainModelLoadResponse, BrainModelProfileGetResponse, BrainModelProfileSetResponse, BrainModelRenameResetResponse, BrainModelRenameResponse, BrainNetworkInfo, BrainRemoteConfig, BrainRepoQuant, BrainRuntime, ConnectorsListToolsResponse, ConnectorsOauthAuthorizeResponse, ConnectorsOauthDisconnectResponse, CommunicationsGetOverviewResponse, CommunicationsInboxGetHomeResponse, CommunicationsInboxNotificationsAcknowledgeResponse, CommunicationsInboxSearchResponse, CommunicationsInboxSetFavoriteResponse, CommunicationsInboxGetPresenceResponse, CommunicationsInboxGetMessagesResponse, CommunicationsInboxSetPresenceResponse, CommunicationsInboxSetEnabledResponse, CommunicationsInboxSendMessageResponse, CommunicationsRoomGetResponse, CommunicationsRoomThreadGetResponse, CommunicationsRoomMessageSendResponse, CommunicationsRoomReactionSetResponse, IntegrationsAuthorizationGetOverviewResponse, IntegrationsAuthorizationGetMethodsResponse, IntegrationsAuthorizationStartBrowserResponse, IntegrationsZoomStartAuthorizationResponse, CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, SpeechTtsSpeakResult, SpeechTtsSpeakCancelResult, VisualizerVoiceCuesResult, AgentPersonalitiesGenerateProfileResult } from "@otto-code/protocol/messages";
+import type { AgentConfigApply } from "@otto-code/protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
 import { type DaemonClientTrafficHotspot, type DaemonClientTrafficTotals } from "./daemon-client-runtime-metrics.js";
 import { type TerminalStreamEvent } from "./terminal-stream-router.js";
@@ -127,8 +128,14 @@ export interface DaemonClientConfig {
     };
     runtimeMetricsIntervalMs?: number;
     runtimeMetricsWindowMs?: number;
+    trace?: DaemonClientTrace;
     capabilities?: Partial<Record<ClientCapability, unknown>>;
 }
+export interface DaemonClientTrace {
+    isEnabled(): boolean;
+    beginSection(name: string, args?: Record<string, string>): void;
+    endSection(): void;
+}
 export interface SendMessageOptions {
     messageId?: string;
     images?: Array<{
@@ -197,6 +204,7 @@ type CheckoutMergeFromBasePayload = CheckoutMergeFromBaseResponse["payload"];
 type CheckoutPullPayload = CheckoutPullResponse["payload"];
 type CheckoutPushPayload = CheckoutPushResponse["payload"];
 type CheckoutRefreshPayload = CheckoutRefreshResponse["payload"];
+type CheckoutGitFetchPayload = CheckoutGitFetchResponse["payload"];
 type CheckoutPrCreatePayload = CheckoutPrCreateResponse["payload"];
 type CheckoutPrMergePayload = CheckoutPrMergeResponse["payload"];
 type CheckoutGithubSetAutoMergePayload = CheckoutGithubSetAutoMergeResponse["payload"];
@@ -480,42 +488,6 @@ type CloseItemsPayload = CloseItemsResponse["payload"];
 type KillTerminalPayload = KillTerminalResponse["payload"];
 type CaptureTerminalPayload = CaptureTerminalResponse["payload"];
 type TerminalCompatibilityDiagnosticPayload = TerminalCompatibilityDiagnosticResponse["payload"];
-type ChatCreatePayload = Extract<SessionOutboundMessage, {
-    type: "chat/create/response";
-}>["payload"];
-type ChatListPayload = Extract<SessionOutboundMessage, {
-    type: "chat/list/response";
-}>["payload"];
-type ChatInspectPayload = Extract<SessionOutboundMessage, {
-    type: "chat/inspect/response";
-}>["payload"];
-type ChatDeletePayload = Extract<SessionOutboundMessage, {
-    type: "chat/delete/response";
-}>["payload"];
-type ChatPostPayload = Extract<SessionOutboundMessage, {
-    type: "chat/post/response";
-}>["payload"];
-type ChatReadPayload = Extract<SessionOutboundMessage, {
-    type: "chat/read/response";
-}>["payload"];
-type ChatWaitPayload = Extract<SessionOutboundMessage, {
-    type: "chat/wait/response";
-}>["payload"];
-type LoopRunPayload = Extract<SessionOutboundMessage, {
-    type: "loop/run/response";
-}>["payload"];
-type LoopListPayload = Extract<SessionOutboundMessage, {
-    type: "loop/list/response";
-}>["payload"];
-type LoopInspectPayload = Extract<SessionOutboundMessage, {
-    type: "loop/inspect/response";
-}>["payload"];
-type LoopLogsPayload = Extract<SessionOutboundMessage, {
-    type: "loop/logs/response";
-}>["payload"];
-type LoopStopPayload = Extract<SessionOutboundMessage, {
-    type: "loop/stop/response";
-}>["payload"];
 type ScheduleCreatePayload = Extract<SessionOutboundMessage, {
     type: "schedule/create/response";
 }>["payload"];
@@ -583,9 +555,13 @@ export interface FetchAgentTimelineOptions {
     cursor?: FetchAgentTimelineCursor;
     limit?: number;
     projection?: FetchAgentTimelineProjection;
+    mergeWindow?: boolean;
     requestId?: string;
     timeout?: number;
 }
+export type AgentTimelinePromptIndexPayload = Extract<SessionOutboundMessage, {
+    type: "agent.timeline.list_prompts.response";
+}>["payload"];
 export type ProviderSubagentListPayload = Extract<SessionOutboundMessage, {
     type: "agent.provider_subagents.list.response";
 }>["payload"];
@@ -664,70 +640,6 @@ export type FetchWorkspacesOptions = Omit<FetchWorkspacesRequest, "type" | "requ
 };
 export type FetchWorkspacesEntry = FetchWorkspacesPayload["entries"][number];
 export type FetchWorkspacesPageInfo = FetchWorkspacesPayload["pageInfo"];
-export interface CreateChatRoomOptions {
-    name: string;
-    purpose?: string | null;
-    requestId?: string;
-}
-export interface InspectChatRoomOptions {
-    room: string;
-    requestId?: string;
-}
-export interface DeleteChatRoomOptions {
-    room: string;
-    requestId?: string;
-}
-export interface PostChatMessageOptions {
-    room: string;
-    body: string;
-    authorAgentId?: string;
-    replyToMessageId?: string | null;
-    requestId?: string;
-}
-export interface ReadChatMessagesOptions {
-    room: string;
-    limit?: number;
-    since?: string;
-    authorAgentId?: string;
-    requestId?: string;
-    timeout?: number;
-}
-export interface WaitForChatMessagesOptions {
-    room: string;
-    afterMessageId?: string | null;
-    timeoutMs?: number;
-    requestId?: string;
-}
-export interface RunLoopOptions {
-    prompt: string;
-    cwd: string;
-    provider?: string;
-    model?: string;
-    modeId?: string;
-    verifierProvider?: string;
-    verifierModel?: string;
-    verifierModeId?: string;
-    verifyPrompt?: string | null;
-    verifyChecks?: string[];
-    name?: string | null;
-    sleepMs?: number;
-    maxIterations?: number;
-    maxTimeMs?: number;
-    requestId?: string;
-}
-export interface InspectLoopOptions {
-    id: string;
-    requestId?: string;
-}
-export interface LoopLogsOptions {
-    id: string;
-    afterSeq?: number;
-    requestId?: string;
-}
-export interface StopLoopOptions {
-    id: string;
-    requestId?: string;
-}
 export interface CreateScheduleOptions {
     prompt: string;
     name?: string | null;
@@ -758,11 +670,7 @@ export interface CreateScheduleOptions {
             archiveOnFinish?: boolean;
             isolation?: "local" | "worktree";
             title?: string | null;
-            approvalPolicy?: string;
-            sandboxMode?: string;
-            networkAccess?: boolean;
-            webSearch?: boolean;
-            extra?: AgentSessionConfig["extra"];
+            providerOptions?: AgentSessionConfig["providerOptions"];
             systemPrompt?: string;
             mcpServers?: AgentSessionConfig["mcpServers"];
         };
@@ -839,6 +747,21 @@ export interface WaitForFinishResult {
     error: string | null;
     lastMessage: string | null;
 }
+type GetDaemonConfigResponse = Extract<SessionOutboundMessage, {
+    type: "get_daemon_config_response";
+}>;
+type SetDaemonConfigResponse = Extract<SessionOutboundMessage, {
+    type: "set_daemon_config_response";
+}>;
+type CorrelatedResponseMessage = Extract<SessionOutboundMessage, {
+    payload: {
+        requestId: string;
+    };
+}> | GetDaemonConfigResponse | SetDaemonConfigResponse;
+type CorrelatedResponseType = CorrelatedResponseMessage["type"];
+type CorrelatedResponsePayload<TType extends CorrelatedResponseType> = Extract<CorrelatedResponseMessage, {
+    type: TType;
+}>["payload"];
 type ProjectGithubClonePayload = Extract<SessionOutboundMessage, {
     type: "project.github.clone.response";
 }>["payload"];
@@ -903,6 +826,11 @@ export declare class DaemonClient {
         type: TType;
     }>) => void): () => void;
     on(handler: DaemonEventHandler): () => void;
+    private beginTraceSection;
+    private endTraceSection;
+    private traceInstant;
+    private sendJsonMessage;
+    private sendTransportFrame;
     /**
      * Send a session message. For fire-and-forget messages (heartbeats, etc.),
      * failures are suppressed if `suppressSendErrors` is configured.
@@ -941,6 +869,7 @@ export declare class DaemonClient {
         appVisibilityChangedAt?: string;
     }): void;
     registerPushToken(token: string): void;
+    unregisterPushToken(token: string): Promise<void>;
     ping(params?: {
         requestId?: string;
         timeoutMs?: number;
@@ -1137,6 +1066,19 @@ export declare class DaemonClient {
     renameProject(projectId: string, customName: string | null, requestId?: string): Promise<{
         customName: string | null;
     }>;
+    /**
+     * Sets (or with a null target, clears) which tracking board a project shows
+     * on the Kanban screen. The daemon normalizes what it stores - a pasted board
+     * URL comes back as the parsed id - so the caller should render the returned
+     * target rather than its own draft.
+     */
+    setKanbanProjectTarget(input: {
+        projectId: string;
+        target: ProjectKanbanTarget | null;
+    }, requestId?: string): Promise<{
+        target: ProjectKanbanTarget | null;
+    }>;
+    setProjectIcon(projectId: string, source: ProjectIconSource, requestId?: string): Promise<void>;
     removeProject(projectId: string, requestId?: string): Promise<{
         removedWorkspaceIds: string[];
     }>;
@@ -1180,6 +1122,42 @@ export declare class DaemonClient {
         parentPath: string;
         name: string;
     }, requestId?: string): Promise<ProjectCreateDirectoryPayload>;
+    /**
+     * The provider-agnostic Kanban board surface. Each call names its provider
+     * ("memory", "github", ...) - the daemon dispatches to the registered
+     * KanbanProvider implementation and the wire never carries provider-native
+     * identifiers beyond the opaque board/card/column ids.
+     *
+     * A project-scoped request is authoritative: the daemon resolves the
+     * project's configured board target and overrides providerId from it. The
+     * wire still carries providerId so older clients keep working; pass an inert
+     * value (e.g. "github") when a project is supplied.
+     */
+    kanbanListBoards(input: {
+        providerId: string;
+        projectId?: string;
+        projectKey?: string;
+    }, requestId?: string): Promise<KanbanBoardsListResponse["payload"]>;
+    kanbanGetBoard(providerId: string, boardId: string, requestId?: string): Promise<KanbanBoardGetResponse["payload"]>;
+    kanbanMoveCard(input: {
+        providerId: string;
+        boardId: string;
+        cardId: string;
+        targetColumnId: string;
+    }, requestId?: string): Promise<KanbanCardMoveResponse["payload"]>;
+    kanbanCreateCard(input: {
+        providerId: string;
+        boardId: string;
+        columnId?: string;
+        title: string;
+        body?: string;
+    }, requestId?: string): Promise<KanbanCardCreateResponse["payload"]>;
+    kanbanLinkTask(input: {
+        providerId: string;
+        boardId: string;
+        externalId: string;
+        columnId?: string;
+    }, requestId?: string): Promise<KanbanTaskLinkResponse["payload"]>;
     getCommitFileDiff(cwd: string, sha: string, path: string, requestId?: string): Promise<{
         file: ParsedDiffFile | null;
     }>;
@@ -1207,6 +1185,10 @@ export declare class DaemonClient {
         unsubscribe: () => void;
     }>;
     fetchAgentTimeline(agentId: string, options?: FetchAgentTimelineOptions): Promise<FetchAgentTimelinePayload>;
+    listAgentTimelinePrompts(agentId: string, options?: {
+        requestId?: string;
+        timeout?: number;
+    }): Promise<AgentTimelinePromptIndexPayload>;
     buildAgentForkContext(agentId: string, options?: AgentForkContextOptions): Promise<AgentForkContextPayload>;
     sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<SendAgentMessageResult>;
     sendMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
@@ -1244,6 +1226,14 @@ export declare class DaemonClient {
      * server_info.features.setAgentPersonality.
      */
     setAgentPersonality(agentId: string, personalityId: string | null): Promise<AgentProviderNotice | null>;
+    /**
+     * Applies a whole agent-config bundle in one request. Use this instead of
+     * chaining the single-field setters when the values belong together so client
+     * interruption and other mutations cannot interleave between steps. A
+     * provider rejection can still leave earlier steps applied.
+     * Gated on `server_info.features.agentConfigApply`.
+     */
+    applyAgentConfig(agentId: string, config: AgentConfigApply): Promise<AgentProviderNotice | null>;
     restartServer(reason?: string, requestId?: string): Promise<RestartRequestedStatusPayload>;
     shutdownServer(options?: ShutdownServerOptions): Promise<ShutdownRequestedStatusPayload>;
     updateDaemon(requestId?: string): Promise<DaemonUpdateResponse["payload"]>;
@@ -1324,6 +1314,7 @@ export declare class DaemonClient {
     checkoutPull(cwd: string, requestId?: string): Promise<CheckoutPullPayload>;
     checkoutPush(cwd: string, requestId?: string): Promise<CheckoutPushPayload>;
     checkoutRefresh(cwd: string, requestId?: string): Promise<CheckoutRefreshPayload>;
+    checkoutGitFetch(cwd: string, requestId?: string): Promise<CheckoutGitFetchPayload>;
     checkoutPrCreate(cwd: string, input: {
         title?: string;
         body?: string;
@@ -1458,12 +1449,6 @@ export declare class DaemonClient {
      * frames leave in order and behind the JSON request that announced them.
      */
     private sendFileTransfer;
-    /** Create an empty file or a directory. Never overwrites - see FileCreateResultSchema. */
-    createFileEntry(options: FileCreateOptions): Promise<FileCreateResult>;
-    /** Permanent delete - an unlink, not a move to any trash. */
-    deleteFileEntry(options: FileDeleteOptions): Promise<FileDeleteResult>;
-    /** Rename, which is also move. Never clobbers an occupied destination. */
-    renameFileEntry(options: FileRenameOptions): Promise<FileRenameResult>;
     refineFile(options: FileRefineOptions): Promise<FileRefineResult>;
     /**
      * Project-wide search. Per-file results stream through onFileResult (the
@@ -1745,6 +1730,7 @@ export declare class DaemonClient {
     }): Promise<ListAvailableProvidersPayload>;
     getProvidersSnapshot(options?: {
         cwd?: string;
+        ifNoneMatch?: string;
         requestId?: string;
     }): Promise<GetProvidersSnapshotPayload>;
     getDaemonConfig(requestId?: string): Promise<{
@@ -1768,6 +1754,114 @@ export declare class DaemonClient {
     connectorsOauthAuthorize(connectorId: string, scope?: string, requestId?: string): Promise<ConnectorsOauthAuthorizeResponse["payload"]>;
     /** Drop a connector's stored authorization. */
     connectorsOauthDisconnect(connectorId: string, requestId?: string): Promise<ConnectorsOauthDisconnectResponse["payload"]>;
+    /**
+     * Read the daemon-owned, provider-neutral communications inbox projection.
+     * Requires server_info.features.communications; callers own that one gate.
+     */
+    communicationsGetOverview(requestId?: string): Promise<CommunicationsGetOverviewResponse["payload"]["overview"]>;
+    communicationsInboxGetHome(providerId: string, requestId?: string): Promise<CommunicationsInboxGetHomeResponse["payload"]["home"]>;
+    communicationsInboxAcknowledgeNotifications(input: {
+        providerId: string;
+        notificationIds?: string[];
+        conversationId?: string;
+        clearAll?: boolean;
+    }, requestId?: string): Promise<CommunicationsInboxNotificationsAcknowledgeResponse["payload"]["home"]>;
+    communicationsInboxSearch(input: {
+        providerId: string;
+        query: string;
+    }, requestId?: string): Promise<CommunicationsInboxSearchResponse["payload"]["results"]>;
+    communicationsInboxSetFavorite(input: {
+        providerId: string;
+        conversationId: string;
+        favorite: boolean;
+    }, requestId?: string): Promise<CommunicationsInboxSetFavoriteResponse["payload"]["home"]>;
+    communicationsInboxGetPresence(providerId: string, requestId?: string): Promise<CommunicationsInboxGetPresenceResponse["payload"]["presence"]>;
+    communicationsInboxSetPresence(input: {
+        providerId: string;
+        status: "available" | "busy" | "do_not_disturb" | "away" | "out_of_office" | "unknown";
+    }, requestId?: string): Promise<CommunicationsInboxSetPresenceResponse["payload"]["presence"]>;
+    communicationsInboxSetEnabled(input: {
+        providerId: string;
+        enabled: boolean;
+    }, requestId?: string): Promise<CommunicationsInboxSetEnabledResponse["payload"]["presence"]>;
+    communicationsInboxGetMessages(input: {
+        providerId: string;
+        conversationId: string;
+    }, requestId?: string): Promise<CommunicationsInboxGetMessagesResponse["payload"]["messages"]>;
+    communicationsInboxSendMessage(input: {
+        providerId: string;
+        conversationId: string;
+        text: string;
+    }, requestId?: string): Promise<CommunicationsInboxSendMessageResponse["payload"]["message"]>;
+    /** Requires server_info.features.communicationsRooms. */
+    communicationsRoomGet(input: {
+        providerId: string;
+        conversationId: string;
+    }, requestId?: string): Promise<CommunicationsRoomGetResponse["payload"]["room"]>;
+    communicationsRoomThreadGet(input: {
+        providerId: string;
+        conversationId: string;
+        parentMessageId: string;
+    }, requestId?: string): Promise<CommunicationsRoomThreadGetResponse["payload"]["messages"]>;
+    communicationsRoomMessageSend(input: {
+        providerId: string;
+        conversationId: string;
+        text: string;
+        parentMessageId?: string | null;
+    }, requestId?: string): Promise<CommunicationsRoomMessageSendResponse["payload"]["message"]>;
+    communicationsRoomReactionSet(input: {
+        providerId: string;
+        conversationId: string;
+        messageId: string;
+        emoji: string;
+        active: boolean;
+    }, requestId?: string): Promise<CommunicationsRoomReactionSetResponse["payload"]["message"]>;
+    /**
+     * Daemon-owned meeting transcript library. Requires
+     * `server_info.features.meetingTranscripts`; callers own that capability gate.
+     */
+    meetingsTranscriptsList(requestId?: string): Promise<Extract<SessionOutboundMessage, {
+        type: "meetings.transcripts.list.response";
+    }>["payload"]["records"]>;
+    meetingsTranscriptsCreate(input: {
+        provider: string;
+        title: string;
+        content: string;
+        occurredAt?: string;
+    }, requestId?: string): Promise<Extract<SessionOutboundMessage, {
+        type: "meetings.transcripts.create.response";
+    }>["payload"]["record"]>;
+    meetingsTranscriptsUpdate(input: {
+        id: string;
+        title?: string;
+        content?: string;
+    }, requestId?: string): Promise<Extract<SessionOutboundMessage, {
+        type: "meetings.transcripts.update.response";
+    }>["payload"]["record"]>;
+    meetingsTranscriptsDelete(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Read daemon-owned connection metadata for reusable integration settings.
+     * Requires server_info.features.integrationAuthorization; callers own that
+     * one capability gate.
+     */
+    integrationsAuthorizationGetOverview(requestId?: string): Promise<IntegrationsAuthorizationGetOverviewResponse["payload"]["overview"]>;
+    /**
+     * List the daemon's nonsecret authorization choices for an integration.
+     * Requires server_info.features.integrationAuthorization; callers own that
+     * one capability gate.
+     */
+    integrationsAuthorizationGetMethods(integrationId?: string, requestId?: string): Promise<IntegrationsAuthorizationGetMethodsResponse["payload"]["methods"]>;
+    /**
+     * Starts a daemon-owned browser sign-in through a registered integration
+     * driver. Requires server_info.features.integrationAuthorizationBrowserFlow;
+     * callers own that one capability gate.
+     */
+    integrationsAuthorizationStartBrowser(input: {
+        integrationId: string;
+        connectionId: string;
+    }, requestId?: string): Promise<IntegrationsAuthorizationStartBrowserResponse["payload"]>;
+    /** Starts the daemon-owned Zoom Team Chat browser sign-in. */
+    integrationsZoomStartAuthorization(requestId?: string): Promise<IntegrationsZoomStartAuthorizationResponse["payload"]>;
     /**
      * The brain's status. Pass `resources` only from a surface that renders the
      * live CPU/RAM/GPU numbers: it costs an `nvidia-smi` spawn on the brain, and
@@ -1787,15 +1881,37 @@ export declare class DaemonClient {
     brainModelsScan(requestId?: string): Promise<BrainInstalledModel[]>;
     brainCatalogList(requestId?: string): Promise<BrainCatalogModel[]>;
     brainRuntimeList(requestId?: string): Promise<BrainRuntime[]>;
-    brainModelsPull(model: string, componentsOrRequestId?: string[] | string, quantOrRequestId?: string): Promise<BrainJob>;
+    brainModelsPull(model: string, componentsOrRequestId?: string[] | string, quantOrRequestId?: string, expectedBytes?: number): Promise<BrainJob>;
     brainHfSearch(query: string, limit?: number | null, requestId?: string): Promise<BrainHfSearchResult[]>;
     brainHfQuants(repo: string, requestId?: string): Promise<BrainRepoQuant[]>;
-    brainModelsAdd(repo: string, quant: string, components?: string[], requestId?: string): Promise<BrainJob>;
+    brainModelsAdd(repo: string, quant: string, components?: string[], requestId?: string, expectedBytes?: number): Promise<BrainJob>;
     brainRuntimeInstall(build?: string | null, requestId?: string): Promise<BrainJob>;
     brainRuntimeRemove(name: string, requestId?: string): Promise<BrainJob>;
     brainCalibrate(model: string, requestId?: string): Promise<BrainJob>;
     brainSweep(model: string, requestId?: string): Promise<BrainJob>;
     brainBench(model?: string | null, requestId?: string): Promise<BrainJob>;
+    createFileEntry(input: {
+        cwd: string;
+        parentPath: string;
+        name: string;
+        kind: "file" | "directory";
+    }): Promise<CorrelatedResponsePayload<"fs.entry.create.response">>;
+    renameFileEntry(input: {
+        cwd: string;
+        path: string;
+        name: string;
+    }): Promise<CorrelatedResponsePayload<"fs.entry.rename.response">>;
+    duplicateFileEntry(input: {
+        cwd: string;
+        path: string;
+    }): Promise<CorrelatedResponsePayload<"fs.entry.duplicate.response">>;
+    deleteFileEntry(input: {
+        cwd: string;
+        path: string;
+    }): Promise<CorrelatedResponsePayload<"fs.entry.delete.response">>;
+    checkoutDiscardChanges(cwd: string, input: {
+        paths: string[];
+    }): Promise<CorrelatedResponsePayload<"checkout.discard_changes.response">>;
     brainJobsList(requestId?: string): Promise<BrainJob[]>;
     brainJobsCancel(jobId: string, requestId?: string): Promise<BrainJob[]>;
     /**
@@ -1828,6 +1944,7 @@ export declare class DaemonClient {
     brainModelLoad(modelId: string, requestId?: string): Promise<BrainModelLoadResponse["payload"]>;
     /** Unload the resident model, leaving the brain up and serving nothing. */
     brainModelUnload(requestId?: string): Promise<BrainHostStatus | null>;
+    getProjectIcon(projectId: string, requestId?: string): Promise<ProjectIconGetResponse["payload"]>;
     /** Delete a model's files. The brain refuses while that model is loaded. */
     brainModelDelete(modelId: string, requestId?: string): Promise<BrainModelDeleteResponse["payload"]>;
     brainModelComponentDelete(modelId: string, componentId: string, requestId?: string): Promise<{
@@ -1845,6 +1962,15 @@ export declare class DaemonClient {
     brainModelRenameReset(modelId: string, requestId?: string): Promise<BrainModelRenameResetResponse["payload"]>;
     /** Tail the brain's llama-server log. */
     brainLogsTail(limit?: number | null, requestId?: string): Promise<BrainLogsTailResponse["payload"]>;
+    /**
+     * Turn the live Brain log feed on or off for this socket.
+     *
+     * Only meaningful against a daemon advertising `features.brainLogWatch`; older
+     * daemons push every line regardless, and the request would go unrouted.
+     * Watching is per socket, so this does not affect the same account's other
+     * connected clients.
+     */
+    brainLogsWatch(watching: boolean, requestId?: string): Promise<BrainLogsWatchResponse["payload"]>;
     getSpeechSettingsOptions(requestId?: string): Promise<{
         requestId: string;
         options: SpeechSettingsOptions;
@@ -1959,13 +2085,6 @@ export declare class DaemonClient {
         stripAnsi?: boolean;
     }, requestId?: string): Promise<CaptureTerminalPayload>;
     runTerminalCompatibilityDiagnostic(requestId?: string): Promise<TerminalCompatibilityDiagnosticPayload>;
-    createChatRoom(options: CreateChatRoomOptions): Promise<ChatCreatePayload>;
-    listChatRooms(requestId?: string): Promise<ChatListPayload>;
-    inspectChatRoom(options: InspectChatRoomOptions): Promise<ChatInspectPayload>;
-    deleteChatRoom(options: DeleteChatRoomOptions): Promise<ChatDeletePayload>;
-    postChatMessage(options: PostChatMessageOptions): Promise<ChatPostPayload>;
-    readChatMessages(options: ReadChatMessagesOptions): Promise<ChatReadPayload>;
-    waitForChatMessages(options: WaitForChatMessagesOptions): Promise<ChatWaitPayload>;
     scheduleCreate(options: CreateScheduleOptions): Promise<ScheduleCreatePayload>;
     scheduleList(requestId?: string): Promise<ScheduleListPayload>;
     scheduleInspect(options: InspectScheduleOptions): Promise<ScheduleInspectPayload>;
@@ -2026,11 +2145,6 @@ export declare class DaemonClient {
         artifactId: string;
         requestId?: string;
     }): Promise<ArtifactGetContentPayload>;
-    loopRun(options: RunLoopOptions): Promise<LoopRunPayload>;
-    loopList(requestId?: string): Promise<LoopListPayload>;
-    loopInspect(options: string | InspectLoopOptions): Promise<LoopInspectPayload>;
-    loopLogs(options: string | LoopLogsOptions, afterSeq?: number): Promise<LoopLogsPayload>;
-    loopStop(options: string | StopLoopOptions): Promise<LoopStopPayload>;
     onTerminalStreamEvent(handler: (event: TerminalStreamEvent) => void): () => void;
     waitForTerminalStreamEvent(predicate: (event: TerminalStreamEvent) => boolean, timeout?: number): Promise<TerminalStreamEvent>;
     private createRequestId;