@otto-code/client 0.7.6 → 0.8.1

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

@@ -1,5 +1,5 @@
 import { normalizeAgentModelDefinition } from "@otto-code/protocol/agent-types";
-// COMPAT(model-normalize): daemon normalizes at source (provider-registry) — shim covers older daemons; drop when floor >= v0.1.104
+// COMPAT(model-normalize): daemon normalizes at source (provider-registry) - shim covers older daemons; drop when floor >= v0.1.104
 function normalizeAgentModels(models) {
     if (!models) {
         return models;

package/dist/daemon-client.d.ts

@@ -6,7 +6,7 @@ import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema,
 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, 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, PromptTemplate, Run } from "@otto-code/protocol/orchestration";
-import type { BrainCatalogModel, BrainEvals, BrainHfSearchResult, BrainHostStatus, BrainInstalledModel, BrainJob, BrainNetworkInfo, BrainRemoteConfig, BrainRepoQuant, BrainRuntime, ConnectorsListToolsResponse, 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, BrainModelBudgetGetResponse, BrainModelDeleteResponse, BrainModelLoadResponse, BrainModelProfileGetResponse, BrainModelProfileSetResponse, BrainNetworkInfo, BrainRemoteConfig, BrainRepoQuant, BrainRuntime, ConnectorsListToolsResponse, ConnectorsOauthAuthorizeResponse, ConnectorsOauthDisconnectResponse, CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, SpeechTtsSpeakResult, SpeechTtsSpeakCancelResult, VisualizerVoiceCuesResult, AgentPersonalitiesGenerateProfileResult } 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";
@@ -255,7 +255,7 @@ export interface FileReadResult {
     modifiedAt: string;
     /**
      * Detected line endings. Optional because only the inline JSON read path
-     * reports them — the chunked binary transfer never does, and neither do
+     * reports them - the chunked binary transfer never does, and neither do
      * daemons older than v0.4.4. Absent means "not reported", not "LF".
      */
     eol?: FileEol;
@@ -284,7 +284,7 @@ export interface FileWriteOptions {
 /**
  * Bytes to a workspace path. Gated on `features.binaryFileWrite`. Unlike
  * {@link FileWriteOptions} this carries no precondition: `overwrite` is the
- * whole policy — see `FsFileWriteBinaryRequestSchema` for why a generated
+ * whole policy - see `FsFileWriteBinaryRequestSchema` for why a generated
  * artifact has nothing to reconcile against.
  */
 export interface FileWriteBinaryOptions {
@@ -299,7 +299,7 @@ export interface FileWriteBinaryOptions {
     chunkSize?: number;
 }
 /**
- * The general file-mutation surface — what exists in a directory, rather than
+ * 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.
  */
@@ -325,14 +325,14 @@ export interface FileRenameOptions {
     requestId?: string;
 }
 /**
- * Refine — ask the daemon for proposed rewrites of a pinned set of documents.
+ * 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. */
+    /** 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[];
@@ -1008,7 +1008,7 @@ export declare class DaemonClient {
      * 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
+     * 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.
      */
@@ -1029,7 +1029,7 @@ export declare class DaemonClient {
      * `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
+     * 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`.
      */
@@ -1050,7 +1050,7 @@ export declare class DaemonClient {
     stopObservedSubagent(agentId: string): Promise<void>;
     /**
      * Stop a running background shell task (Claude Bash tool run_in_background).
-     * Not an AI subagent — the daemon resolves it to its owning provider task and
+     * Not an AI subagent - the daemon resolves it to its owning provider task and
      * calls the provider's stopTask, same mechanism as stopObservedSubagent.
      */
     stopBackgroundShellTask(parentAgentId: string, taskId: string): Promise<void>;
@@ -1061,7 +1061,7 @@ export declare class DaemonClient {
     clearBackgroundShellTasks(parentAgentId: string, taskIds: readonly string[]): Promise<void>;
     /**
      * Start one or more suggested tasks (from `spawn_task` chips), applying the
-     * same mode to each — a new worktree workspace per task, a new local session
+     * same mode to each - a new worktree workspace per task, a new local session
      * per task, or steering the parent's current session. Individual actions pass
      * a single-element array; the "Start all" collective action passes the whole
      * pending queue. Resolves to the count started; throws only if all failed.
@@ -1087,7 +1087,7 @@ export declare class DaemonClient {
     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.
+     * 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. */
@@ -1217,7 +1217,7 @@ export declare class DaemonClient {
     } | 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
+     * was already drained or was already there - the authoritative order arrives
      * on the agent snapshot either way. Requires
      * `server_info.features.steerQueueReorder`.
      */
@@ -1235,7 +1235,7 @@ export declare class DaemonClient {
     /**
      * Live-switch a running agent's personality (null clears it). The daemon
      * re-resolves the roster id against the agent's cwd and applies the full
-     * personality — system prompt, identity, model/mode/effort — restarting the
+     * personality - system prompt, identity, model/mode/effort - restarting the
      * provider query so the prompt takes effect on the next turn. Gate on
      * server_info.features.setAgentPersonality.
      */
@@ -1436,10 +1436,10 @@ export declare class DaemonClient {
         expectedModifiedAt: string;
         expectedRevision?: string;
     }): Promise<FsFileWriteResult>;
-    /** Conditional save — see FileWriteRequestSchema for the no-clobber contract. */
+    /** Conditional save - see FileWriteRequestSchema for the no-clobber contract. */
     writeFile(options: FileWriteOptions): Promise<FileWriteResult>;
     /**
-     * Write bytes to a workspace file — the path for generated artifacts the
+     * Write bytes to a workspace file - the path for generated artifacts the
      * text write cannot carry (it refuses binary targets outright). Gated on
      * `features.binaryFileWrite`; there is no client-side substitute, because
      * the client never touches a workspace file on any platform.
@@ -1454,9 +1454,9 @@ 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. */
+    /** 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. */
+    /** 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>;
@@ -1483,7 +1483,7 @@ export declare class DaemonClient {
     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.
+     * 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. */
@@ -1497,7 +1497,7 @@ export declare class DaemonClient {
     /** 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
+     * 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>;
@@ -1531,7 +1531,7 @@ export declare class DaemonClient {
      *
      * 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.
+     * 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. */
@@ -1552,7 +1552,7 @@ export declare class DaemonClient {
     }, 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. */
+    /** Preview-first project replace - see FileReplaceRequestSchema. */
     replaceFiles(options: {
         cwd: string;
         replacement: string;
@@ -1606,7 +1606,7 @@ export declare class DaemonClient {
      *
      * 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,
+     * scoped to "project" with no root is filtered out of every brief - stored,
      * listed, and never sent.
      */
     updatePersonalityMemory(input: {
@@ -1683,7 +1683,23 @@ export declare class DaemonClient {
         config: MutableDaemonConfig;
     }>;
     connectorsListTools(connectorId: string, requestId?: string): Promise<ConnectorsListToolsResponse["payload"]>;
-    brainHostStatus(requestId?: string): Promise<BrainHostStatus>;
+    /**
+     * Start a connector's OAuth login. Resolves with the URL to open, or with
+     * status "authorized" when the daemon already held a usable token. The login
+     * itself settles later on the `connectors.oauth.status` push, because the user
+     * is in a browser by then.
+     */
+    connectorsOauthAuthorize(connectorId: string, scope?: string, requestId?: string): Promise<ConnectorsOauthAuthorizeResponse["payload"]>;
+    /** Drop a connector's stored authorization. */
+    connectorsOauthDisconnect(connectorId: string, requestId?: string): Promise<ConnectorsOauthDisconnectResponse["payload"]>;
+    /**
+     * The brain's status. Pass `resources` only from a surface that renders the
+     * live CPU/RAM/GPU/slot numbers: it costs an `nvidia-smi` spawn plus a /slots
+     * round trip on the brain, and this call is also the liveness poll.
+     */
+    brainHostStatus(options?: {
+        resources?: boolean;
+    }, requestId?: string): Promise<BrainHostStatus>;
     brainHostStart(model?: string | null, requestId?: string): Promise<BrainHostStatus>;
     brainHostStop(requestId?: string): Promise<BrainHostStatus>;
     brainHostRestart(model?: string | null, requestId?: string): Promise<BrainHostStatus>;
@@ -1705,6 +1721,40 @@ export declare class DaemonClient {
     brainBench(model?: string | null, requestId?: string): Promise<BrainJob>;
     brainJobsList(requestId?: string): Promise<BrainJob[]>;
     brainJobsCancel(jobId: string, requestId?: string): Promise<BrainJob[]>;
+    /**
+     * The joined model inventory: scan row, GGUF metadata, saved profile,
+     * calibration state, VRAM budget and benchmark score per model, plus disk
+     * usage. One call feeds the whole Models tab.
+     */
+    brainModelsInventory(requestId?: string): Promise<{
+        models: BrainInventoryModel[];
+        disk: BrainDiskUsage | null;
+    }>;
+    /** One model's saved profile, the field descriptors, and its warnings. */
+    brainModelProfileGet(modelId: string, requestId?: string): Promise<BrainModelProfileGetResponse["payload"]>;
+    /**
+     * Write the editable profile fields. The reply carries the recomputed budget,
+     * so an edit costs one round trip rather than a write the UI has to follow
+     * with a read.
+     */
+    brainModelProfileSet(modelId: string, patch: Record<string, unknown>, requestId?: string): Promise<BrainModelProfileSetResponse["payload"]>;
+    /**
+     * The VRAM budget for a hypothetical profile. `overrides` are string-encoded
+     * field values, so the UI can preview the budget while a control is mid-drag
+     * without persisting a value the user is scrubbing past.
+     */
+    brainModelBudget(modelId: string, overrides?: Record<string, string>, requestId?: string): Promise<BrainModelBudgetGetResponse["payload"]>;
+    /**
+     * Load a model into the running brain. This is not `brainHostStart`, which
+     * restarts the daemon's child process and has no remote equivalent.
+     */
+    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>;
+    /** Delete a model's files. The brain refuses while that model is loaded. */
+    brainModelDelete(modelId: string, requestId?: string): Promise<BrainModelDeleteResponse["payload"]>;
+    /** Tail the brain's llama-server log. */
+    brainLogsTail(limit?: number | null, requestId?: string): Promise<BrainLogsTailResponse["payload"]>;
     getSpeechSettingsOptions(requestId?: string): Promise<{
         requestId: string;
         options: SpeechSettingsOptions;
@@ -1758,7 +1808,7 @@ export declare class DaemonClient {
     listProviderUsage(options?: {
         requestId?: string;
     }): Promise<ProviderUsageListPayload>;
-    /** Daemon-wide "fun stats" — see docs/data-model.md ActivityStatsStore. */
+    /** Daemon-wide "fun stats" - see docs/data-model.md ActivityStatsStore. */
     getActivityStats(options?: {
         requestId?: string;
     }): Promise<StatsActivityGetResponseMessage["payload"]>;
@@ -1766,7 +1816,7 @@ export declare class DaemonClient {
     resetActivityStats(options?: {
         requestId?: string;
     }): Promise<StatsActivityResetResponseMessage["payload"]>;
-    /** Itemized usage ledger — the scrollable rows behind the stats tiles (usage-ledger). */
+    /** Itemized usage ledger - the scrollable rows behind the stats tiles (usage-ledger). */
     getUsageLog(options?: {
         limit?: number;
         before?: number;
@@ -1895,7 +1945,7 @@ export declare class DaemonClient {
     /**
      * 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
+     * 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;
@@ -1932,7 +1982,7 @@ export declare class DaemonClient {
     /**
      * `includeDiscovered` also returns the Scripts the workspace's own project
      * files declare (package.json scripts today), each tagged with its `source`.
-     * Gate it on `server_info.features.workspaceScriptDiscovery` — an older
+     * Gate it on `server_info.features.workspaceScriptDiscovery` - an older
      * daemon ignores the flag and answers with the otto.json list only.
      */
     listWorkspaceScripts(workspaceId: string, options?: {
@@ -1950,7 +2000,7 @@ export declare class DaemonClient {
     connectHub(hubUrl: string, token: string, requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             scopes: string[];
@@ -1961,7 +2011,7 @@ export declare class DaemonClient {
     getHubStatus(requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             scopes: string[];
@@ -1972,7 +2022,7 @@ export declare class DaemonClient {
     disconnectHub(force?: boolean, requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             scopes: string[];

package/dist/daemon-client.js

@@ -293,7 +293,7 @@ export class DaemonClient {
         const runtimeMetricsIntervalMs = typeof config.runtimeMetricsIntervalMs === "number" && config.runtimeMetricsIntervalMs > 0
             ? config.runtimeMetricsIntervalMs
             : 0;
-        // The metrics object is always constructed — it is a handful of Maps keyed
+        // The metrics object is always constructed - it is a handful of Maps keyed
         // by message type, and its per-message cost is dwarfed by the JSON.parse it
         // is measuring. What `runtimeMetricsIntervalMs` gates is the *periodic log*,
         // which is the part that is actually noisy. Keeping the counters on
@@ -1393,7 +1393,7 @@ export class DaemonClient {
      * 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
+     * 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.
      */
@@ -1424,7 +1424,7 @@ export class DaemonClient {
      * `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
+     * 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`.
      */
@@ -1490,7 +1490,7 @@ export class DaemonClient {
     }
     /**
      * Stop a running background shell task (Claude Bash tool run_in_background).
-     * Not an AI subagent — the daemon resolves it to its owning provider task and
+     * Not an AI subagent - the daemon resolves it to its owning provider task and
      * calls the provider's stopTask, same mechanism as stopObservedSubagent.
      */
     async stopBackgroundShellTask(parentAgentId, taskId) {
@@ -1523,7 +1523,7 @@ export class DaemonClient {
     }
     /**
      * Start one or more suggested tasks (from `spawn_task` chips), applying the
-     * same mode to each — a new worktree workspace per task, a new local session
+     * same mode to each - a new worktree workspace per task, a new local session
      * per task, or steering the parent's current session. Individual actions pass
      * a single-element array; the "Start all" collective action passes the whole
      * pending queue. Resolves to the count started; throws only if all failed.
@@ -1591,7 +1591,7 @@ export class DaemonClient {
     }
     /**
      * Orchestration: delete one finished (or draft) run. Throws with the
-     * daemon's reason when it refuses — an active run has to be canceled first.
+     * daemon's reason when it refuses - an active run has to be canceled first.
      */
     async deleteRun(runId) {
         const payload = await this.sendNamespacedCorrelatedSessionRequest({
@@ -2298,7 +2298,7 @@ export class DaemonClient {
     }
     /**
      * Move one queued message to a new position. Resolves false when the entry
-     * was already drained or was already there — the authoritative order arrives
+     * was already drained or was already there - the authoritative order arrives
      * on the agent snapshot either way. Requires
      * `server_info.features.steerQueueReorder`.
      */
@@ -2408,7 +2408,7 @@ export class DaemonClient {
         });
         // A refused cancellation comes back as an error payload, not a rejected
         // frame. Dropping it reported Stop as successful while the provider was
-        // still running and still spending tokens — the exact outcome the daemon
+        // still running and still spending tokens - the exact outcome the daemon
         // refuses the cancel to avoid.
         if (payload.error) {
             throw new Error(payload.error);
@@ -2527,7 +2527,7 @@ export class DaemonClient {
     /**
      * Live-switch a running agent's personality (null clears it). The daemon
      * re-resolves the roster id against the agent's cwd and applies the full
-     * personality — system prompt, identity, model/mode/effort — restarting the
+     * personality - system prompt, identity, model/mode/effort - restarting the
      * provider query so the prompt takes effect on the next turn. Gate on
      * server_info.features.setAgentPersonality.
      */
@@ -2619,7 +2619,7 @@ export class DaemonClient {
         return this.sendRequest({
             requestId: resolvedRequestId,
             message,
-            timeout: 300000, // 5 minutes — npm update can be slow on remote machines
+            timeout: 300000, // 5 minutes - npm update can be slow on remote machines
             options: { skipQueue: true },
             select: (msg) => {
                 const parsed = DaemonUpdateResponseSchema.safeParse(msg);
@@ -3017,7 +3017,7 @@ export class DaemonClient {
         });
     }
     // ── Git file investigation ────────────────────────────────────────────────
-    // Local git only: no remote, no forge, and no per-provider variant — the same
+    // Local git only: no remote, no forge, and no per-provider variant - the same
     // four calls answer for every agent provider. Gated by
     // server_info.features.checkoutGitFileHistory.
     async checkoutGitFileHistory(cwd, input, requestId) {
@@ -3510,7 +3510,7 @@ export class DaemonClient {
             content: file.content,
             size: file.size,
             modifiedAt: file.modifiedAt,
-            // COMPAT(textEditor): added in v0.4.4 — the editor is gated on
+            // COMPAT(textEditor): added in v0.4.4 - the editor is gated on
             // features.textEditor, so a gated daemon always sends both fields.
             eol: file.eol ?? "lf",
             hash: file.hash ?? null,
@@ -3528,7 +3528,7 @@ export class DaemonClient {
         });
         return payload.result;
     }
-    /** Conditional save — see FileWriteRequestSchema for the no-clobber contract. */
+    /** Conditional save - see FileWriteRequestSchema for the no-clobber contract. */
     async writeFile(options) {
         const payload = await this.sendCorrelatedSessionRequest({
             requestId: options.requestId,
@@ -3547,7 +3547,7 @@ export class DaemonClient {
         return payload.result;
     }
     /**
-     * Write bytes to a workspace file — the path for generated artifacts the
+     * Write bytes to a workspace file - the path for generated artifacts the
      * text write cannot carry (it refuses binary targets outright). Gated on
      * `features.binaryFileWrite`; there is no client-side substitute, because
      * the client never touches a workspace file on any platform.
@@ -3576,8 +3576,8 @@ export class DaemonClient {
         this.sendFileTransfer({
             requestId: resolvedRequestId,
             bytes,
-            // Nothing downstream reads the mime for a workspace write — the path
-            // decides what the file is — but the frame metadata requires one.
+            // Nothing downstream reads the mime for a workspace write - the path
+            // decides what the file is - but the frame metadata requires one.
             mime: "application/octet-stream",
             chunkSize: options.chunkSize,
         });
@@ -3613,7 +3613,7 @@ export class DaemonClient {
             requestId: input.requestId,
         }));
     }
-    /** Create an empty file or a directory. Never overwrites — see FileCreateResultSchema. */
+    /** Create an empty file or a directory. Never overwrites - see FileCreateResultSchema. */
     async createFileEntry(options) {
         const payload = await this.sendCorrelatedSessionRequest({
             requestId: options.requestId,
@@ -3627,7 +3627,7 @@ export class DaemonClient {
         });
         return payload.result;
     }
-    /** Permanent delete — an unlink, not a move to any trash. */
+    /** Permanent delete - an unlink, not a move to any trash. */
     async deleteFileEntry(options) {
         const payload = await this.sendCorrelatedSessionRequest({
             requestId: options.requestId,
@@ -3749,7 +3749,7 @@ export class DaemonClient {
     }
     /**
      * 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.
+     * unsaved edits. Debounced by the caller - this is not a per-keystroke RPC.
      */
     async syncCodeDocument(cwd, path, text, requestId) {
         const payload = await this.sendCorrelatedSessionRequest({
@@ -3813,7 +3813,7 @@ export class DaemonClient {
         return { status: payload.status, locations: payload.locations, error: payload.error };
     }
     /**
-     * A rename **dry run** — every edit it would make, and nothing written. The client
+     * 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.
      */
     async previewCodeRename(input, requestId) {
@@ -3924,7 +3924,7 @@ export class DaemonClient {
      *
      * 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.
+     * empty list, so the caller has one silent case - "no switcher" - rather than four states.
      */
     async listSolutions(cwd, requestId) {
         const payload = await this.sendCorrelatedSessionRequest({
@@ -3999,7 +3999,7 @@ export class DaemonClient {
         }
         return payload.symbols;
     }
-    /** Preview-first project replace — see FileReplaceRequestSchema. */
+    /** Preview-first project replace - see FileReplaceRequestSchema. */
     async replaceFiles(options) {
         return this.sendCorrelatedSessionRequest({
             requestId: options.requestId,
@@ -4171,7 +4171,7 @@ export class DaemonClient {
      *
      * 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,
+     * scoped to "project" with no root is filtered out of every brief - stored,
      * listed, and never sent.
      */
     async updatePersonalityMemory(input, requestId) {
@@ -4358,11 +4358,45 @@ export class DaemonClient {
             responseType: "connectors.list_tools.response",
         });
     }
-    async brainHostStatus(requestId) {
+    /**
+     * Start a connector's OAuth login. Resolves with the URL to open, or with
+     * status "authorized" when the daemon already held a usable token. The login
+     * itself settles later on the `connectors.oauth.status` push, because the user
+     * is in a browser by then.
+     */
+    async connectorsOauthAuthorize(connectorId, scope, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "connectors.oauth.authorize.request",
+                connectorId,
+                ...(scope ? { scope } : {}),
+            },
+            responseType: "connectors.oauth.authorize.response",
+        });
+    }
+    /** Drop a connector's stored authorization. */
+    async connectorsOauthDisconnect(connectorId, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "connectors.oauth.disconnect.request",
+                connectorId,
+            },
+            responseType: "connectors.oauth.disconnect.response",
+        });
+    }
+    /**
+     * The brain's status. Pass `resources` only from a surface that renders the
+     * live CPU/RAM/GPU/slot numbers: it costs an `nvidia-smi` spawn plus a /slots
+     * round trip on the brain, and this call is also the liveness poll.
+     */
+    async brainHostStatus(options, requestId) {
         const payload = await this.sendCorrelatedSessionRequest({
             requestId,
             message: {
                 type: "brain.host.status.request",
+                resources: options?.resources ?? false,
             },
             responseType: "brain.host.status.response",
         });
@@ -4588,6 +4622,123 @@ export class DaemonClient {
         }
         return payload.jobs;
     }
+    // --- Brain Console --------------------------------------------------------
+    // These proxy the brain's own /__host/* management API and work against a
+    // local or a remote brain identically. Gated by features.brainConsole on the
+    // daemon, and by `capabilities` on brain.host.status for the brain itself.
+    // Each throws the brain's own message on failure, because "could not delete
+    // the model" with no reason is not a usable error.
+    /**
+     * The joined model inventory: scan row, GGUF metadata, saved profile,
+     * calibration state, VRAM budget and benchmark score per model, plus disk
+     * usage. One call feeds the whole Models tab.
+     */
+    async brainModelsInventory(requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.models.inventory.request" },
+            responseType: "brain.models.inventory.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return { models: payload.models, disk: payload.disk };
+    }
+    /** One model's saved profile, the field descriptors, and its warnings. */
+    async brainModelProfileGet(modelId, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.profile.get.request", modelId },
+            responseType: "brain.model.profile.get.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
+    /**
+     * Write the editable profile fields. The reply carries the recomputed budget,
+     * so an edit costs one round trip rather than a write the UI has to follow
+     * with a read.
+     */
+    async brainModelProfileSet(modelId, patch, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.profile.set.request", modelId, patch },
+            responseType: "brain.model.profile.set.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
+    /**
+     * The VRAM budget for a hypothetical profile. `overrides` are string-encoded
+     * field values, so the UI can preview the budget while a control is mid-drag
+     * without persisting a value the user is scrubbing past.
+     */
+    async brainModelBudget(modelId, overrides, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.budget.get.request", modelId, overrides: overrides ?? {} },
+            responseType: "brain.model.budget.get.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
+    /**
+     * Load a model into the running brain. This is not `brainHostStart`, which
+     * restarts the daemon's child process and has no remote equivalent.
+     */
+    async brainModelLoad(modelId, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.load.request", modelId },
+            responseType: "brain.model.load.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
+    /** Unload the resident model, leaving the brain up and serving nothing. */
+    async brainModelUnload(requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.unload.request" },
+            responseType: "brain.model.unload.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload.status;
+    }
+    /** Delete a model's files. The brain refuses while that model is loaded. */
+    async brainModelDelete(modelId, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.model.delete.request", modelId },
+            responseType: "brain.model.delete.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
+    /** Tail the brain's llama-server log. */
+    async brainLogsTail(limit, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "brain.logs.tail.request", limit: limit ?? null },
+            responseType: "brain.logs.tail.response",
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
     async getSpeechSettingsOptions(requestId) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId,
@@ -4733,7 +4884,7 @@ export class DaemonClient {
             },
         });
     }
-    /** Daemon-wide "fun stats" — see docs/data-model.md ActivityStatsStore. */
+    /** Daemon-wide "fun stats" - see docs/data-model.md ActivityStatsStore. */
     async getActivityStats(options) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId: options?.requestId,
@@ -4751,7 +4902,7 @@ export class DaemonClient {
             },
         });
     }
-    /** Itemized usage ledger — the scrollable rows behind the stats tiles (usage-ledger). */
+    /** Itemized usage ledger - the scrollable rows behind the stats tiles (usage-ledger). */
     async getUsageLog(options) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId: options?.requestId,
@@ -5475,7 +5626,7 @@ export class DaemonClient {
     /**
      * 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
+     * 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() {
@@ -6043,7 +6194,7 @@ export class DaemonClient {
     /**
      * `includeDiscovered` also returns the Scripts the workspace's own project
      * files declare (package.json scripts today), each tagged with its `source`.
-     * Gate it on `server_info.features.workspaceScriptDiscovery` — an older
+     * Gate it on `server_info.features.workspaceScriptDiscovery` - an older
      * daemon ignores the flag and answers with the otto.json list only.
      */
     async listWorkspaceScripts(workspaceId, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otto-code/client",
-  "version": "0.7.6",
+  "version": "0.8.1",
   "description": "Otto client SDK package",
   "license": "AGPL-3.0-or-later",
   "files": [
@@ -36,8 +36,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@otto-code/protocol": "0.7.6",
-    "@otto-code/relay": "0.7.6",
+    "@otto-code/protocol": "0.8.1",
+    "@otto-code/relay": "0.8.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {