@otto-code/client 0.6.7 → 0.7.1

package/dist/daemon-client-runtime-metrics.d.ts

@@ -10,6 +10,28 @@ interface RuntimeMetricsContext {
 interface RuntimeMetricsOptions {
     windowMs?: number;
 }
+/**
+ * Session totals, never pruned. The rolling buckets answer "what is happening
+ * now"; these answer "what has this connection cost the JS thread since the app
+ * started", which is the number you need when the complaint is that the app gets
+ * slower the longer it stays open.
+ */
+export interface DaemonClientTrafficTotals {
+    messages: number;
+    bytes: number;
+    /** Main-thread ms spent inside inbound message handlers. */
+    handlerMs: number;
+    binaryFrames: number;
+    /** Distinct inbound message types seen. */
+    types: number;
+}
+export interface DaemonClientTrafficHotspot {
+    type: string;
+    count: number;
+    totalMs: number;
+    maxMs: number;
+    bytes: number;
+}
 export declare class DaemonClientRuntimeMetrics {
     private readonly logger;
     private readonly context;
@@ -22,8 +44,17 @@ export declare class DaemonClientRuntimeMetrics {
     private readonly inboundAgentStreamCounts;
     private readonly inboundAgentStreamByAgentCounts;
     private readonly inboundBinaryFrameCounts;
+    private totalMessages;
+    private totalBytes;
+    private totalHandlerMs;
+    private totalBinaryFrames;
+    private readonly cumulativeByType;
     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[];
+    private recordCumulative;
     recordAgentStream(payload: Extract<SessionOutboundMessage, {
         type: "agent_stream";
     }>["payload"]): void;

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

@@ -11,6 +11,12 @@ export class DaemonClientRuntimeMetrics {
         this.inboundAgentStreamCounts = new Map();
         this.inboundAgentStreamByAgentCounts = new Map();
         this.inboundBinaryFrameCounts = new Map();
+        // Cumulative, deliberately outside the bucket pruning above.
+        this.totalMessages = 0;
+        this.totalBytes = 0;
+        this.totalHandlerMs = 0;
+        this.totalBinaryFrames = 0;
+        this.cumulativeByType = new Map();
         this.windowMs =
             typeof options?.windowMs === "number" && options.windowMs > 0
                 ? options.windowMs
@@ -20,6 +26,55 @@ export class DaemonClientRuntimeMetrics {
         incrementCount(this.inboundMessageCounts, type, 1);
         incrementCount(this.inboundMessageBytes, type, bytes);
         incrementHandlerTiming(this.inboundMessageHandlerMs, type, handlerMs);
+        this.totalMessages += 1;
+        this.recordCumulative(type, bytes, handlerMs);
+    }
+    getTrafficTotals() {
+        return {
+            messages: this.totalMessages,
+            bytes: this.totalBytes,
+            handlerMs: this.totalHandlerMs,
+            binaryFrames: this.totalBinaryFrames,
+            types: this.cumulativeByType.size,
+        };
+    }
+    /** Inbound message types ranked by the main-thread time they have cost. */
+    getTrafficHotspots(limit = 15) {
+        // Copied out so a caller cannot mutate the running totals.
+        const rows = [];
+        for (const row of this.cumulativeByType.values()) {
+            rows.push({
+                type: row.type,
+                count: row.count,
+                totalMs: row.totalMs,
+                maxMs: row.maxMs,
+                bytes: row.bytes,
+            });
+        }
+        rows.sort((left, right) => right.totalMs - left.totalMs);
+        return rows.slice(0, limit);
+    }
+    // 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.
+    recordCumulative(type, bytes, handlerMs) {
+        this.totalBytes += bytes;
+        this.totalHandlerMs += handlerMs;
+        const existing = this.cumulativeByType.get(type);
+        if (existing) {
+            existing.count += 1;
+            existing.bytes += bytes;
+            existing.totalMs += handlerMs;
+            existing.maxMs = Math.max(existing.maxMs, handlerMs);
+            return;
+        }
+        this.cumulativeByType.set(type, {
+            type,
+            count: 1,
+            bytes,
+            totalMs: handlerMs,
+            maxMs: handlerMs,
+        });
     }
     recordAgentStream(payload) {
         const { agentId, event } = payload;
@@ -31,6 +86,8 @@ export class DaemonClientRuntimeMetrics {
         incrementCount(this.inboundBinaryFrameCounts, kind, 1);
         incrementCount(this.inboundMessageBytes, `binary:${kind}`, bytes);
         incrementHandlerTiming(this.inboundMessageHandlerMs, `binary:${kind}`, handlerMs);
+        this.totalBinaryFrames += 1;
+        this.recordCumulative(`binary:${kind}`, bytes, handlerMs);
     }
     flush(options) {
         const now = Date.now();

package/dist/daemon-client.d.ts

@@ -1,11 +1,12 @@
 import type { z } from "zod";
 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, FileDownloadTokenResponse, FileEol, FileReplaceFileResult, FileReplaceRequest, FileReplaceResponse, FileSearchResultPayload, FileSearchSummary, FileUploadResponse, FileExplorerResponse, FileWatchEventPayload, FileWriteResult, 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, GitHubSearchResponse, GitHubSearchRequest, GitHostingProviderId, HostingSearchRequest, HostingSearchResponse, HostingAuthStatusResponse, DirectorySuggestionsResponse, OttoWorktreeListResponse, OttoWorktreeArchiveResponse, ProjectIconResponse, ContextReportGetResponseMessage, ContextEdgeConvertResponseMessage, ProjectAddResponse, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceArchivePreflightResponse, 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, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, 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, 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, GitHubSearchResponse, GitHubSearchRequest, GitHostingProviderId, HostingSearchRequest, HostingSearchResponse, HostingAuthStatusResponse, DirectorySuggestionsResponse, OttoWorktreeListResponse, OttoWorktreeArchiveResponse, ProjectIconResponse, ContextCategory, ContextPromptPreviewGetResponseMessage, ContextReportGetResponseMessage, ContextEdgeConvertResponseMessage, ContextFindingsFixResponseMessage, PersonalityMemoryListResponseMessage, PersonalityMemoryUpdateResponseMessage, PersonalityMemoryTransferResponseMessage, PersonalityMemoryStatsResponseMessage, ProjectAddResponse, 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, KillTerminalResponse, CaptureTerminalResponse, 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, Run } from "@otto-code/protocol/orchestration";
+import type { OrchestrationGraph, PromptTemplate, Run } from "@otto-code/protocol/orchestration";
 import type { CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, SpeechTtsSpeakResult, SpeechTtsSpeakCancelResult, VisualizerVoiceCuesResult } 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";
 import type { BrowserAutomationExecuteRequest, BrowserAutomationExecuteResponse } from "@otto-code/protocol/browser-automation/rpc-schemas";
 export interface Logger {
@@ -16,6 +17,12 @@ export interface Logger {
 }
 interface ImportAgentInputBase {
     cwd?: string;
+    /**
+     * Workspace the import was requested from. Supply it whenever the caller has
+     * one, so the imported session lands in that workspace instead of the daemon
+     * resolving (or minting) another workspace for the same directory.
+     */
+    workspaceId?: string;
     labels?: Record<string, string>;
 }
 export type ImportAgentInput = (ImportAgentInputBase & {
@@ -127,6 +134,18 @@ export interface SendMessageOptions {
         mimeType: string;
     }>;
     attachments?: SendAgentMessageRequest["attachments"];
+    /**
+     * How to reach the agent if it is busy. Omit for `interrupt` (cancel the
+     * in-flight turn and run this now). `queue` parks the message and runs it as
+     * the agent's next turn. Requires `server_info.features.steerQueue`.
+     */
+    delivery?: AgentPromptDelivery;
+}
+export interface SendAgentMessageResult {
+    /** True when the daemon parked the message instead of dispatching it. */
+    queued: boolean;
+    /** The queue entry's id, for finding this message again in `queuedMessages`. */
+    queuedMessageId: string | null;
 }
 type AgentConfigOverrides = Partial<Omit<AgentSessionConfig, "provider" | "cwd">>;
 export interface CreateAgentRequestOptions extends AgentConfigOverrides {
@@ -235,7 +254,48 @@ export interface FileWriteOptions {
     eol?: FileEol;
     requestId?: string;
 }
-export type { FileReplaceFileResult, FileSearchResultPayload, FileSearchSummary, FileWatchEventPayload, FileWriteResult, };
+/**
+ * The general file-mutation surface — what exists in a directory, rather than
+ * what is inside a file. Gated on `features.fileMutations`; there is no
+ * client-side substitute, so callers check the flag before offering the action.
+ */
+export interface FileCreateOptions {
+    cwd: string;
+    /** Workspace-relative. The parent directory must already exist. */
+    path: string;
+    kind: FileEntryKind;
+    requestId?: string;
+}
+export interface FileDeleteOptions {
+    cwd: string;
+    path: string;
+    /** Required for a directory with children; otherwise the daemon reports `not_empty`. */
+    recursive?: boolean;
+    requestId?: string;
+}
+export interface FileRenameOptions {
+    cwd: string;
+    path: string;
+    /** Workspace-relative destination. A different parent makes this a move. */
+    newPath: string;
+    requestId?: string;
+}
+/**
+ * Refine — ask the daemon for proposed rewrites of a pinned set of documents.
+ * This call never writes: accepted proposals go back through {@link
+ * DaemonClient.writeFile}, one per file, like any other save.
+ */
+export interface FileRefineOptions {
+    /** Provider resolution only; the documents themselves travel inline. */
+    cwd: string;
+    /** What the model may rewrite — this list is the request's blast radius. */
+    documents: FileRefineDocument[];
+    /** What it may read for context but must never rewrite. */
+    references?: FileRefineReference[];
+    instruction: string;
+    requestId?: string;
+}
+export type { FileReplaceFileResult, FileSearchResultPayload, FileSearchSummary, FileWatchEventPayload, FileWriteResult, FileRefineResult, FileRefineDocument, FileRefineReference, };
 export interface FileSearchOptions {
     cwd: string;
     query: string;
@@ -250,8 +310,78 @@ export interface FileSearchOptions {
 }
 export type FileReplaceFilesInput = FileReplaceRequest["files"];
 export type FileReplaceResultPayload = FileReplaceResponse["payload"];
-export type { CodeSymbolLocation };
+export type { CodeSymbolLocation, CodeHoverRange, CodeRenameEdit, CodeRenameFilePlan, LspLanguageState, LspRunningServer, };
 export type CodeListFilesResultPayload = CodeListFilesResponse["payload"];
+/** 1-based, matching the wire and `CodeSymbolLocation`. */
+export interface CodeDefinitionQuery {
+    cwd: string;
+    path: string;
+    line: number;
+    column: number;
+}
+export interface LspServersSnapshot {
+    languages: LspLanguageState[];
+    running: LspRunningServer[];
+}
+/** The Solution view (projects/solution-view). Independent of the LSP family above. */
+export type { SolutionFormat, SolutionRef, SolutionTreeFolder, SolutionTreeProject, SolutionProjectNode, SolutionProjectStatus, SolutionPackageReference, };
+export type SolutionTree = Omit<CodeSolutionGetTreeResponse["payload"], "cwd" | "error" | "requestId">;
+export type SolutionProjectContents = Omit<CodeSolutionLoadProjectResponse["payload"], "cwd" | "solutionPath" | "requestId">;
+export interface CodeHoverResult {
+    status: CodeDefinitionStatus;
+    /** Markdown, or null when the server had nothing to say here. */
+    markdown: string | null;
+    range: CodeHoverRange | null;
+    serverId: string | null;
+    error: string | null;
+}
+export interface CodeReferencesResult {
+    status: CodeDefinitionStatus;
+    locations: CodeDefinitionLocation[];
+    error: string | null;
+}
+export interface CodeRenamePreviewQuery extends CodeDefinitionQuery {
+    newName: string;
+}
+export interface CodeRenamePlan {
+    status: CodeDefinitionStatus;
+    files: CodeRenameFilePlan[];
+    /** Blast radius, so a dry-run surface can lead with it. */
+    fileCount: number;
+    editCount: number;
+    /** Identity of this exact plan. Send it back to apply; see `applyCodeRename`. */
+    planId: string;
+    error: string | null;
+}
+export interface CodeRenameApplyQuery extends CodeRenamePreviewQuery {
+    /** The `planId` of the plan that was actually shown to the user. */
+    planId: string;
+}
+export interface CodeRenameApplyOutcome {
+    status: CodeRenameApplyStatus;
+    /** Identity of the run, for undo. Null when nothing ran. */
+    runId: string | null;
+    files: CodeRenameFileOutcome[];
+    appliedFiles: number;
+    appliedEdits: number;
+    skippedEdits: number;
+    /** True only when every planned edit landed. */
+    complete: boolean;
+    error: string | null;
+}
+export interface CodeRenameUndoOutcome {
+    status: CodeRenameUndoStatus;
+    files: CodeRenameUndoFile[];
+    restoredFiles: number;
+    /** True only when every file the run wrote was put back. */
+    complete: boolean;
+    error: string | null;
+}
+export interface CodeDefinitionResult {
+    status: CodeDefinitionStatus;
+    locations: CodeDefinitionLocation[];
+    error: string | null;
+}
 export interface FileUploadInput {
     fileName: string;
     mimeType: string;
@@ -630,8 +760,12 @@ export interface RenameTerminalInput {
 }
 type OpenProjectPayload = OpenProjectResponseMessage["payload"];
 type ProjectAddPayload = ProjectAddResponse["payload"];
+export type ProjectScaffoldPayload = ProjectScaffoldResponse["payload"];
+export type HostingListRepositoriesPayload = HostingListRepositoriesResponse["payload"];
+export type HostingListOwnersPayload = HostingListOwnersResponse["payload"];
 type ArchiveWorkspacePayload = ArchiveWorkspaceResponseMessage["payload"];
 type WorkspaceArchivePreflightPayload = WorkspaceArchivePreflightResponse["payload"];
+type WorktreeBaseRefSetPayload = WorktreeBaseRefSetResponse["payload"];
 type WorktreeReattachListPayload = WorktreeReattachListResponse["payload"];
 type WorktreeReattachPayload = WorktreeReattachResponse["payload"];
 type WorkspaceSetupStatusPayload = WorkspaceSetupStatusResponseMessage["payload"];
@@ -668,6 +802,7 @@ export declare class DaemonClient {
     private checkoutDiffSubscriptions;
     private terminalDirectorySubscriptions;
     private readonly terminalStreams;
+    private readonly scaffoldProgressListeners;
     private pendingBinaryFileReads;
     private activeBinaryFileTransfers;
     private completedBinaryFileReads;
@@ -766,6 +901,20 @@ export declare class DaemonClient {
     fetchWorkspaces(options?: FetchWorkspacesOptions): Promise<FetchWorkspacesPayload>;
     openProject(cwd: string, requestId?: string): Promise<OpenProjectPayload>;
     addProject(cwd: string, requestId?: string): Promise<ProjectAddPayload>;
+    scaffoldProject(options: {
+        parentDirectory: string;
+        folderName?: string;
+        git: ProjectScaffoldGit;
+        onProgress?: (payload: ProjectScaffoldProgress["payload"]) => void;
+    }, requestId?: string): Promise<ProjectScaffoldPayload>;
+    listHostingRepositories(options: {
+        provider: GitHostingProviderId;
+        query?: string;
+        limit?: number;
+    }, requestId?: string): Promise<HostingListRepositoriesPayload>;
+    listHostingOwners(options: {
+        provider: GitHostingProviderId;
+    }, requestId?: string): Promise<HostingListOwnersPayload>;
     startWorkspaceScript(workspaceId: string, scriptName: string, requestId?: string): Promise<Extract<SessionOutboundMessage, {
         type: "start_workspace_script_response";
     }>["payload"]>;
@@ -774,6 +923,7 @@ export declare class DaemonClient {
         requestId?: string;
     }): Promise<ArchiveWorkspacePayload>;
     workspaceArchivePreflight(workspaceId: string, requestId?: string): Promise<WorkspaceArchivePreflightPayload>;
+    setWorktreeBaseRef(workspaceId: string, baseRef: string | null, requestId?: string): Promise<WorktreeBaseRefSetPayload>;
     listReattachableWorktrees(scope: {
         projectId?: string;
         cwd?: string;
@@ -788,6 +938,42 @@ export declare class DaemonClient {
     private resubscribeFileWatches;
     createAgent(options: CreateAgentRequestOptions): Promise<AgentSnapshotPayload>;
     deleteAgent(agentId: string): Promise<void>;
+    /**
+     * Bulk-delete archived chat records on this host. Server-side by necessity:
+     * the client's history list is cursor-paginated across hosts and never holds
+     * the whole archived set. Pass `dryRun: true` first to get the count the
+     * confirm dialog quotes, then the same call with `dryRun: false` to delete.
+     *
+     * Removes Otto's records only — provider transcripts are left on disk. Gated
+     * by `server_info.features.historyDelete`; there is no fallback path, so check
+     * the flag before offering the action.
+     */
+    clearArchivedAgents(options: {
+        dryRun: boolean;
+        olderThanDays?: number;
+        requestId?: string;
+    }): Promise<HistoryAgentsClearArchivedResponse["payload"]>;
+    /**
+     * How much disk the images agents produced occupy on this host, plus the
+     * retention policy currently ageing them out. Gated by
+     * `server_info.features.attachmentStorage`.
+     */
+    getAttachmentImageStats(requestId?: string): Promise<AttachmentsImagesStatsResponse["payload"]>;
+    /**
+     * Reclaims the materialized image store. Call once with `dryRun: true` for
+     * the count and size the confirm dialog quotes, then again with
+     * `dryRun: false` to delete.
+     *
+     * Cleared images do not come back: a message that referenced one renders its
+     * alt text from then on. Scope is the whole host — filenames are a content
+     * hash, so per-chat or per-workspace scope does not exist. Gated by
+     * `server_info.features.attachmentStorage`.
+     */
+    clearAttachmentImages(options: {
+        dryRun: boolean;
+        olderThanDays?: number;
+        requestId?: string;
+    }): Promise<AttachmentsImagesClearResponse["payload"]>;
     archiveAgent(agentId: string): Promise<{
         archivedAt: string;
     }>;
@@ -835,12 +1021,23 @@ export declare class DaemonClient {
     cancelRun(runId: string): Promise<boolean>;
     /** Orchestration: delete every finished (done/failed/canceled) run. */
     clearFinishedRuns(): Promise<string[]>;
+    /**
+     * Orchestration: delete one finished (or draft) run. Throws with the
+     * daemon's reason when it refuses — an active run has to be canceled first.
+     */
+    deleteRun(runId: string): Promise<string>;
     /** Orchestration: list the host's reusable graph templates. */
     listOrchestrationGraphs(): Promise<OrchestrationGraph[]>;
     /** Orchestration: upsert a graph template. Returns the persisted graph. */
     saveOrchestrationGraph(graph: OrchestrationGraph): Promise<OrchestrationGraph>;
     /** Orchestration: delete a graph template (built-in starters refuse). */
     deleteOrchestrationGraph(graphId: string): Promise<boolean>;
+    /** Orchestration: list the host's reusable prompt templates and snippets. */
+    listPromptTemplates(): Promise<PromptTemplate[]>;
+    /** Orchestration: upsert a prompt template. Returns the persisted template. */
+    savePromptTemplate(template: PromptTemplate): Promise<PromptTemplate>;
+    /** Orchestration: delete a prompt template (built-in starters refuse). */
+    deletePromptTemplate(templateId: string): Promise<boolean>;
     /**
      * Orchestration: start (or draft) a user-initiated orchestration. Returns the
      * run id (graph flavor) and the orchestrator chat's agent id to navigate to.
@@ -886,8 +1083,26 @@ export declare class DaemonClient {
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;
     fetchAgentTimeline(agentId: string, options?: FetchAgentTimelineOptions): Promise<FetchAgentTimelinePayload>;
     buildAgentForkContext(agentId: string, options?: AgentForkContextOptions): Promise<AgentForkContextPayload>;
-    sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
+    sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<SendAgentMessageResult>;
     sendMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
+    /**
+     * Pull one message back out of an agent's queue. Returns its text so the
+     * caller can put it back in the composer, or null when the turn already
+     * drained it. Requires `server_info.features.steerQueue`.
+     */
+    removeQueuedAgentMessage(agentId: string, messageId: string): Promise<{
+        id: string;
+        text: string;
+    } | null>;
+    /**
+     * Move one queued message to a new position. Resolves false when the entry
+     * was already drained or was already there — the authoritative order arrives
+     * on the agent snapshot either way. Requires
+     * `server_info.features.steerQueueReorder`.
+     */
+    reorderQueuedAgentMessage(agentId: string, messageId: string, toIndex: number): Promise<boolean>;
+    /** Drop every message queued behind an agent's current turn. */
+    clearAgentQueue(agentId: string): Promise<number>;
     rewindAgent(agentId: string, messageId: string, mode: "conversation" | "files" | "both"): Promise<AgentRewindResponseMessage["payload"]>;
     cancelAgent(agentId: string): Promise<{
         cancelled?: boolean;
@@ -1084,6 +1299,13 @@ export declare class DaemonClient {
     readTextFile(cwd: string, path: string, requestId?: string): Promise<TextFileReadResult>;
     /** Conditional save — see FileWriteRequestSchema for the no-clobber contract. */
     writeFile(options: FileWriteOptions): Promise<FileWriteResult>;
+    /** 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
      * daemon emits them in order, before the summary response resolves); the
@@ -1094,6 +1316,81 @@ export declare class DaemonClient {
     listCodeFiles(cwd: string, requestId?: string): Promise<CodeListFilesResultPayload>;
     /** Name-based go-to-definition: one hit jumps, multiple hits are a picker. */
     findCodeSymbols(cwd: string, name: string, requestId?: string): Promise<CodeSymbolLocation[]>;
+    /**
+     * Language-server-backed go-to-definition. Unlike `findCodeSymbols` this resolves the
+     * reference *at a position*, so multiple results mean real overloads or
+     * implementations rather than "two files happen to use this name".
+     *
+     * Line and column are 1-based. Returns the whole payload, not just the locations,
+     * because `indexing` and `unavailable` are answers the caller must show differently
+     * from an empty result.
+     */
+    findCodeDefinition(input: CodeDefinitionQuery, requestId?: string): Promise<CodeDefinitionResult>;
+    /**
+     * Mirror the editor's current buffer to the daemon so definitions resolve against
+     * unsaved edits. Debounced by the caller — this is not a per-keystroke RPC.
+     */
+    syncCodeDocument(cwd: string, path: string, text: string, requestId?: string): Promise<void>;
+    /** Release the daemon-side mirror when a file tab closes. */
+    closeCodeDocument(cwd: string, path: string, requestId?: string): Promise<void>;
+    /**
+     * The language server's own explanation of the symbol at a position. Returns the
+     * whole payload: `indexing` and `unavailable` read differently to a user than "the
+     * server had nothing to say", which is `ok` with a null `markdown`.
+     */
+    getCodeHover(input: CodeDefinitionQuery, requestId?: string): Promise<CodeHoverResult>;
+    /** Every reference to the symbol at a position, for the references results tab. */
+    findCodeReferences(input: CodeDefinitionQuery, requestId?: string): Promise<CodeReferencesResult>;
+    /**
+     * A rename **dry run** — every edit it would make, and nothing written. The client
+     * puts this in front of the user as a job to audit before applying.
+     */
+    previewCodeRename(input: CodeRenamePreviewQuery, requestId?: string): Promise<CodeRenamePlan>;
+    /**
+     * Execute a rename the user audited. Sends the  and NOT the edits: the daemon
+     * recomputes the plan and refuses unless the identity still matches, which is what keeps
+     * this from being an arbitrary-write RPC and what makes "what you approved is what
+     * happens" enforceable rather than merely intended.
+     */
+    applyCodeRename(input: CodeRenameApplyQuery, requestId?: string): Promise<CodeRenameApplyOutcome>;
+    /**
+     * Take a rename run back. Sends only the run id: the daemon holds the before-images, and
+     * restores a file only if it still holds exactly what the run wrote.
+     */
+    undoCodeRename(cwd: string, runId: string, requestId?: string): Promise<CodeRenameUndoOutcome>;
+    /**
+     * Live language-server state for the Daemon → Code screen: what this host can
+     * supply, and what is running now. `cwd` scopes availability, since a server can
+     * be present in one workspace's `node_modules` and absent in another's.
+     */
+    listLspServers(cwd: string, requestId?: string): Promise<LspServersSnapshot>;
+    /** Stop one running language server. */
+    stopLspServer(rootPath: string, serverId: string, requestId?: string): Promise<void>;
+    /**
+     * Solutions in a workspace, which is what decides whether the Files tab shows a view switcher
+     * at all.
+     *
+     * Never throws and never carries an error the caller has to render. A workspace with no
+     * solution, a host with no .NET SDK, and a host with the feature switched off all answer with an
+     * empty list, so the caller has one silent case — "no switcher" — rather than four states.
+     */
+    listSolutions(cwd: string, requestId?: string): Promise<SolutionRef[]>;
+    /** One solution's organisation: folders, the projects inside them, configurations. */
+    getSolutionTree(input: {
+        cwd: string;
+        solutionPath: string;
+    }, requestId?: string): Promise<SolutionTree>;
+    /**
+     * One project's evaluated file membership, fetched on expand.
+     *
+     * A `failed` status is a normal answer, not an exception: the daemon carries MSBuild's own
+     * message for a project it refused, and one bad project must not blank the tree.
+     */
+    loadSolutionProject(input: {
+        cwd: string;
+        solutionPath: string;
+        projectPath: string;
+    }, requestId?: string): Promise<SolutionProjectContents>;
     /** Definition symbols for a single file (document outline). */
     getCodeOutline(cwd: string, path: string, requestId?: string): Promise<CodeSymbolLocation[]>;
     /** Preview-first project replace — see FileReplaceRequestSchema. */
@@ -1121,7 +1418,59 @@ export declare class DaemonClient {
         workspaceId: string;
         provider?: string;
         windowTokens?: number;
+        personalityId?: string;
     }, requestId?: string): Promise<ContextReportGetResponseMessage["payload"]>;
+    /**
+     * The assembled prompt, for reading. Takes the same what-if inputs as the
+     * report so the text on screen always matches the numbers beside it.
+     */
+    requestContextPromptPreview(input: {
+        workspaceId: string;
+        provider?: string;
+        windowTokens?: number;
+        personalityId?: string;
+        /** Assemble only this section; omitted means the whole prompt. */
+        category?: ContextCategory;
+    }, requestId?: string): Promise<ContextPromptPreviewGetResponseMessage["payload"]>;
+    /**
+     * A personality's accrued lessons plus the EXACT brief the daemon would inject
+     * for `projectRoot`. The brief is returned rather than rebuilt client-side
+     * because memory is only trustworthy if what you are shown is what is sent.
+     */
+    listPersonalityMemory(input: {
+        personalityId: string;
+        workspaceId?: string;
+        projectRoot?: string;
+    }, requestId?: string): Promise<PersonalityMemoryListResponseMessage["payload"]>;
+    /**
+     * Add (no `entryId`), edit, or forget (`drop`) one lesson.
+     *
+     * Pass `workspaceId` whenever the write may be project-scoped: the daemon
+     * binds the entry to the repo root that workspace resolves to, and an entry
+     * scoped to "project" with no root is filtered out of every brief — stored,
+     * listed, and never sent.
+     */
+    updatePersonalityMemory(input: {
+        personalityId: string;
+        entryId?: string;
+        text?: string;
+        scope?: string;
+        workspaceId?: string;
+        projectRoot?: string;
+        drop?: boolean;
+    }, requestId?: string): Promise<PersonalityMemoryUpdateResponseMessage["payload"]>;
+    /**
+     * Resolve a deleted personality's lessons: move them to another personality or
+     * discard them. Called BEFORE the roster write, so a failure leaves both the
+     * personality and its memory intact.
+     */
+    transferPersonalityMemory(input: {
+        fromPersonalityId: string;
+        toPersonalityId?: string;
+        mode: "transfer" | "delete";
+    }, requestId?: string): Promise<PersonalityMemoryTransferResponseMessage["payload"]>;
+    /** Per-personality lesson counts, for the accrual indicator and the selector. */
+    getPersonalityMemoryStats(requestId?: string): Promise<PersonalityMemoryStatsResponseMessage["payload"]>;
     /** Rewrites one reference between "always loaded" and "link only". */
     requestContextEdgeConvert(input: {
         workspaceId: string;
@@ -1133,6 +1482,18 @@ export declare class DaemonClient {
         };
         target: "import" | "reference";
     }, requestId?: string): Promise<ContextEdgeConvertResponseMessage["payload"]>;
+    /** Deletes every mechanically-fixable finding's range in one pass. */
+    requestContextFindingsFix(input: {
+        workspaceId: string;
+        findings: Array<{
+            filePath: string;
+            range: {
+                start: number;
+                end: number;
+            };
+            snippet: string;
+        }>;
+    }, requestId?: string): Promise<ContextFindingsFixResponseMessage["payload"]>;
     listProviderModels(provider: AgentProvider, options?: {
         cwd?: string;
         requestId?: string;
@@ -1342,6 +1703,14 @@ export declare class DaemonClient {
     waitForTerminalStreamEvent(predicate: (event: TerminalStreamEvent) => boolean, timeout?: number): Promise<TerminalStreamEvent>;
     private createRequestId;
     getLastServerInfoMessage(): ServerInfoStatusPayload | null;
+    /**
+     * Session totals for inbound daemon traffic, including the main-thread time
+     * spent handling it. Null when runtime metrics are disabled for this client.
+     * Read by the app's resource monitor — the wire is a first-class suspect when
+     * the UI thread degrades, so it has to be measurable rather than inferred.
+     */
+    getTrafficTotals(): DaemonClientTrafficTotals | null;
+    getTrafficHotspots(limit?: number): DaemonClientTrafficHotspot[];
     private resolveTransportUrlForAttempt;
     private sendHelloMessage;
     private disposeTransport;