@otto-code/client 0.8.12 → 0.8.14

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-runtime-metrics.d.ts

@@ -32,6 +32,28 @@ export interface DaemonClientTrafficHotspot {
     maxMs: number;
     bytes: number;
 }
+/**
+ * One inbound session-message dispatch, retained only long enough to align it
+ * with a browser Long Animation Frame in the app's performance capture.
+ *
+ * `at` is an epoch timestamp so callers can compare it directly to the LoAF
+ * API. The phase timings are synchronous main-thread work and sum to
+ * approximately `totalMs`; small gaps are metric bookkeeping.
+ */
+export interface DaemonClientInboundDispatchTiming {
+    at: number;
+    type: string;
+    /** Set for agent-scoped messages, so a capture can tell one hot agent from a spread. */
+    agentId?: string;
+    bytes: number;
+    decodeAndValidateMs: number;
+    internalDispatchMs: number;
+    rawListenersMs: number;
+    typedHandlersMs: number;
+    totalMs: number;
+}
+/** Bounded independently from rolling log buckets: this is capture evidence, not telemetry. */
+export declare const INBOUND_DISPATCH_TIMING_CAPACITY = 500;
 export declare class DaemonClientRuntimeMetrics {
     private readonly logger;
     private readonly context;
@@ -49,11 +71,18 @@ export declare class DaemonClientRuntimeMetrics {
     private totalHandlerMs;
     private totalBinaryFrames;
     private readonly cumulativeByType;
+    private readonly inboundDispatchTimings;
     constructor(logger: RuntimeMetricsLogger, context: RuntimeMetricsContext, options?: RuntimeMetricsOptions);
     recordMessage(type: string, bytes: number, handlerMs: number): void;
     getTrafficTotals(): DaemonClientTrafficTotals;
     /** Inbound message types ranked by the main-thread time they have cost. */
     getTrafficHotspots(limit?: number): DaemonClientTrafficHotspot[];
+    recordInboundDispatch(timing: DaemonClientInboundDispatchTiming): void;
+    /**
+     * Recent inbound dispatches for a performance capture. Copies keep capture
+     * consumers from mutating a live client's bounded ring.
+     */
+    getInboundDispatchTimings(sinceMs?: number): DaemonClientInboundDispatchTiming[];
     private recordCumulative;
     recordAgentStream(payload: Extract<SessionOutboundMessage, {
         type: "agent_stream";

package/dist/daemon-client-runtime-metrics.js

@@ -1,4 +1,6 @@
 const DEFAULT_ROLLING_WINDOW_MS = 60000;
+/** Bounded independently from rolling log buckets: this is capture evidence, not telemetry. */
+export const INBOUND_DISPATCH_TIMING_CAPACITY = 500;
 export class DaemonClientRuntimeMetrics {
     constructor(logger, context, options) {
         this.logger = logger;
@@ -17,6 +19,7 @@ export class DaemonClientRuntimeMetrics {
         this.totalHandlerMs = 0;
         this.totalBinaryFrames = 0;
         this.cumulativeByType = new Map();
+        this.inboundDispatchTimings = [];
         this.windowMs =
             typeof options?.windowMs === "number" && options.windowMs > 0
                 ? options.windowMs
@@ -54,6 +57,21 @@ export class DaemonClientRuntimeMetrics {
         rows.sort((left, right) => right.totalMs - left.totalMs);
         return rows.slice(0, limit);
     }
+    recordInboundDispatch(timing) {
+        this.inboundDispatchTimings.push(cloneInboundDispatchTiming(timing));
+        if (this.inboundDispatchTimings.length > INBOUND_DISPATCH_TIMING_CAPACITY) {
+            this.inboundDispatchTimings.splice(0, this.inboundDispatchTimings.length - INBOUND_DISPATCH_TIMING_CAPACITY);
+        }
+    }
+    /**
+     * Recent inbound dispatches for a performance capture. Copies keep capture
+     * consumers from mutating a live client's bounded ring.
+     */
+    getInboundDispatchTimings(sinceMs) {
+        return this.inboundDispatchTimings
+            .filter((timing) => sinceMs === undefined || timing.at >= sinceMs)
+            .map(cloneInboundDispatchTiming);
+    }
     // Shared by JSON messages and binary frames; the per-sink totals
     // (`totalMessages` / `totalBinaryFrames`) are bumped by the callers so a
     // binary frame is never counted as both.
@@ -192,6 +210,19 @@ function cloneHandlerTimingMap(map) {
         { count: value.count, totalMs: value.totalMs, maxMs: value.maxMs },
     ]));
 }
+function cloneInboundDispatchTiming(timing) {
+    return {
+        at: timing.at,
+        type: timing.type,
+        agentId: timing.agentId,
+        bytes: timing.bytes,
+        decodeAndValidateMs: timing.decodeAndValidateMs,
+        internalDispatchMs: timing.internalDispatchMs,
+        rawListenersMs: timing.rawListenersMs,
+        typedHandlersMs: timing.typedHandlersMs,
+        totalMs: timing.totalMs,
+    };
+}
 function mergeCountMap(target, source) {
     for (const [key, value] of source) {
         incrementCount(target, key, value);

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,14 +3,16 @@ 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, 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, 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, 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 DaemonClientInboundDispatchTiming, type DaemonClientTrafficHotspot, type DaemonClientTrafficTotals } from "./daemon-client-runtime-metrics.js";
 import { type TerminalStreamEvent } from "./terminal-stream-router.js";
 import type { BrowserAutomationExecuteRequest, BrowserAutomationExecuteResponse } from "@otto-code/protocol/browser-automation/rpc-schemas";
+export type { DaemonClientInboundDispatchTiming } from "./daemon-client-runtime-metrics.js";
 export interface Logger {
     debug(obj: object, msg?: string): void;
     info(obj: object, msg?: string): void;
@@ -127,8 +129,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<{
@@ -481,42 +489,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"];
@@ -584,9 +556,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"];
@@ -665,70 +641,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;
@@ -759,11 +671,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"];
         };
@@ -840,6 +748,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"];
@@ -904,6 +827,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.
@@ -942,6 +870,7 @@ export declare class DaemonClient {
         appVisibilityChangedAt?: string;
     }): void;
     registerPushToken(token: string): void;
+    unregisterPushToken(token: string): Promise<void>;
     ping(params?: {
         requestId?: string;
         timeoutMs?: number;
@@ -1150,6 +1079,7 @@ export declare class DaemonClient {
     }, requestId?: string): Promise<{
         target: ProjectKanbanTarget | null;
     }>;
+    setProjectIcon(projectId: string, source: ProjectIconSource, requestId?: string): Promise<void>;
     removeProject(projectId: string, requestId?: string): Promise<{
         removedWorkspaceIds: string[];
     }>;
@@ -1256,6 +1186,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>;
@@ -1293,6 +1227,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"]>;
@@ -1508,12 +1450,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
@@ -1795,6 +1731,7 @@ export declare class DaemonClient {
     }): Promise<ListAvailableProvidersPayload>;
     getProvidersSnapshot(options?: {
         cwd?: string;
+        ifNoneMatch?: string;
         requestId?: string;
     }): Promise<GetProvidersSnapshotPayload>;
     getDaemonConfig(requestId?: string): Promise<{
@@ -1954,6 +1891,28 @@ export declare class DaemonClient {
     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[]>;
     /**
@@ -1986,6 +1945,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<{
@@ -2126,13 +2086,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>;
@@ -2193,11 +2146,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;
@@ -2210,6 +2158,12 @@ export declare class DaemonClient {
      */
     getTrafficTotals(): DaemonClientTrafficTotals | null;
     getTrafficHotspots(limit?: number): DaemonClientTrafficHotspot[];
+    /**
+     * Bounded, timestamped dispatch phases for matching an inbound daemon
+     * message to a browser Long Animation Frame. This is diagnostic evidence,
+     * not a protocol surface.
+     */
+    getInboundDispatchTimings(sinceMs?: number): DaemonClientInboundDispatchTiming[];
     private resolveTransportUrlForAttempt;
     private sendHelloMessage;
     private disposeTransport;