@otto-code/client 0.7.5 → 0.8.0

package/dist/daemon-client.d.ts

@@ -1,10 +1,12 @@
+import type { AgentAttentionNotificationPayload } from "@otto-code/protocol/agent-attention-notification";
 import type { z } from "zod";
+import type { ProjectGithubCloneProtocol } from "@otto-code/protocol/messages";
 import { type ClientCapability } from "@otto-code/protocol/client-capabilities";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ServerInfoStatusPayload } from "@otto-code/protocol/messages";
-import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreateOttoWorktreeRequest, CodeListFilesResponse, CodeSymbolLocation, CodeDefinitionLocation, CodeDefinitionStatus, CodeRenameApplyStatus, CodeRenameFileOutcome, CodeRenameUndoFile, CodeRenameUndoStatus, CodeHoverRange, CodeRenameEdit, CodeRenameFilePlan, LspLanguageState, LspRunningServer, CodeSolutionGetTreeResponse, CodeSolutionLoadProjectResponse, SolutionFormat, SolutionRef, SolutionTreeFolder, SolutionTreeProject, SolutionProjectNode, SolutionProjectStatus, SolutionPackageReference, FileCreateResult, FileDeleteResult, FileDownloadTokenResponse, FileEntryKind, FileEol, FileRenameResult, FileReplaceFileResult, FileReplaceRequest, FileReplaceResponse, FileSearchResultPayload, FileSearchSummary, FileUploadResponse, FileExplorerResponse, FileWatchEventPayload, FileWriteResult, FileRefineResult, FileRefineDocument, FileRefineReference, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommitResponse, CheckoutGitCommitResponse, CheckoutGitCommitAgentResponse, CheckoutGitRollbackResponse, CheckoutGitFileHistoryResponse, CheckoutGitFileCommitDiffResponse, CheckoutGitFileBlameResponse, CheckoutGitFileOriginResponse, CheckoutGitGetOperationLogResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutGithubSetAutoMergeResponse, CheckoutGithubGetCheckDetailsResponse, PreviewListConfigResponse, PreviewStartResponse, PreviewBindTabResponse, PreviewStopResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, 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 { 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";
@@ -156,6 +158,12 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     personality?: CreateAgentRequestMessage["personality"];
     env?: CreateAgentRequestMessage["env"];
     workspaceId?: string;
+    /**
+     * Caller agent making this request. The daemon resolves the caller's own
+     * workspace and parentage from it, so a managed CLI run nests under its
+     * parent exactly as agent-scoped MCP creation does.
+     */
+    callerAgentId?: string;
     initialPrompt?: string;
     clientMessageId?: string;
     outputSchema?: Record<string, unknown>;
@@ -168,7 +176,7 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     requestId?: string;
     labels?: Record<string, string>;
 }
-export interface CreateOttoWorktreeInput extends Pick<CreateOttoWorktreeRequest, "cwd" | "projectId" | "worktreeSlug" | "firstAgentContext" | "refName" | "action" | "githubPrNumber"> {
+export interface CreateOttoWorktreeInput extends Pick<CreateOttoWorktreeRequest, "cwd" | "projectId" | "worktreeSlug" | "firstAgentContext" | "refName" | "action" | "githubPrNumber" | "checkoutSource"> {
 }
 type CheckoutStatusPayload = CheckoutStatusResponse["payload"];
 type SubscribeCheckoutDiffPayload = Extract<SessionOutboundMessage, {
@@ -207,6 +215,23 @@ type StashListPayload = StashListResponse["payload"];
 type ValidateBranchPayload = ValidateBranchResponse["payload"];
 type BranchSuggestionsPayload = BranchSuggestionsResponse["payload"];
 type GitHubSearchPayload = GitHubSearchResponse["payload"];
+type CheckoutForgeGetCheckDetailsPayload = CheckoutForgeGetCheckDetailsResponse["payload"];
+type CheckoutForgeSetAutoMergePayload = CheckoutForgeSetAutoMergeResponse["payload"];
+export type ProjectCreateDirectoryPayload = ProjectCreateDirectoryResponse["payload"];
+export type ProjectListPayload = Extract<SessionOutboundMessage, {
+    type: "project.list.response";
+}>["payload"];
+export type WorkspaceGithubSearchRepositoriesPayload = Extract<SessionOutboundMessage, {
+    type: "workspace.github.search_repositories.response";
+}>["payload"];
+export interface AgentAttentionRequiredNotification {
+    agentId: string;
+    reason: "finished" | "error" | "permission";
+    timestamp: string;
+    shouldNotify: boolean;
+    notification?: AgentAttentionNotificationPayload;
+}
+type ForgeSearchPayload = ForgeSearchResponse["payload"];
 export type HostingSearchPayload = HostingSearchResponse["payload"];
 export type HostingAuthStatusPayload = HostingAuthStatusResponse["payload"];
 type DirectorySuggestionsPayload = DirectorySuggestionsResponse["payload"];
@@ -230,10 +255,12 @@ 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;
+    /** Opaque version tag for optimistic-concurrency writes; same caveat as eol. */
+    revision?: string;
 }
 export interface TextFileReadResult {
     path: string;
@@ -255,7 +282,24 @@ export interface FileWriteOptions {
     requestId?: string;
 }
 /**
- * The general file-mutation surface — what exists in a directory, rather than
+ * 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
+ * artifact has nothing to reconcile against.
+ */
+export interface FileWriteBinaryOptions {
+    cwd: string;
+    /** Workspace-relative, like every other file RPC. */
+    path: string;
+    /** Sent as file-transfer frames, not inside the request. */
+    bytes: Uint8Array | ArrayBuffer;
+    overwrite?: boolean;
+    requestId?: string;
+    /** Frame size, for tests that want to observe chunking. Defaults to 1 MB. */
+    chunkSize?: number;
+}
+/**
+ * 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.
  */
@@ -281,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[];
@@ -541,7 +585,21 @@ export interface FetchAgentTimelineOptions {
     requestId?: string;
     timeout?: number;
 }
+export type ProviderSubagentListPayload = Extract<SessionOutboundMessage, {
+    type: "agent.provider_subagents.list.response";
+}>["payload"];
+export type ProviderSubagentTimelinePayload = Extract<SessionOutboundMessage, {
+    type: "agent.provider_subagents.timeline.get.response";
+}>["payload"];
+export interface FetchProviderSubagentTimelineOptions {
+    direction?: ProviderSubagentTimelinePayload["direction"];
+    cursor?: FetchAgentTimelineCursor;
+    limit?: number;
+    requestId?: string;
+    timeout?: number;
+}
 export interface AgentForkContextOptions {
+    boundaryCursor?: FetchAgentTimelineCursor;
     boundaryMessageId?: string;
     requestId?: string;
 }
@@ -779,6 +837,9 @@ export interface WaitForFinishResult {
     error: string | null;
     lastMessage: string | null;
 }
+type ProjectGithubClonePayload = Extract<SessionOutboundMessage, {
+    type: "project.github.clone.response";
+}>["payload"];
 export declare class DaemonClient {
     private config;
     private transport;
@@ -801,6 +862,7 @@ export declare class DaemonClient {
     private connectionState;
     private checkoutDiffSubscriptions;
     private terminalDirectorySubscriptions;
+    private fileSubscriptions;
     private readonly terminalStreams;
     private readonly scaffoldProgressListeners;
     private pendingBinaryFileReads;
@@ -946,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.
      */
@@ -967,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`.
      */
@@ -988,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>;
@@ -999,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.
@@ -1025,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. */
@@ -1091,6 +1153,55 @@ export declare class DaemonClient {
     resumeAgent(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>): Promise<AgentSnapshotPayload>;
     importAgent(input: ImportAgentInput): Promise<AgentSnapshotPayload>;
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;
+    listProviderSubagents(parentAgentId: string, options?: {
+        requestId?: string;
+        timeout?: number;
+    }): Promise<ProviderSubagentListPayload>;
+    fetchProviderSubagentTimeline(parentAgentId: string, subagentId: string, options?: FetchProviderSubagentTimelineOptions): Promise<ProviderSubagentTimelinePayload>;
+    checkoutForgeGetCheckDetails(input: {
+        cwd: string;
+        repoOwner?: string;
+        repoName?: string;
+        checkRunId?: number;
+        workflowRunId?: number;
+        changeRequestNumber?: number;
+    }, requestId?: string): Promise<CheckoutForgeGetCheckDetailsPayload>;
+    checkoutForgeSetAutoMerge(cwd: string, input: {
+        enabled: true;
+        method: CheckoutPrMergeMethod;
+    } | {
+        enabled: false;
+    }, requestId?: string): Promise<CheckoutForgeSetAutoMergePayload>;
+    createProjectDirectory(input: {
+        parentPath: string;
+        name: string;
+    }, requestId?: string): Promise<ProjectCreateDirectoryPayload>;
+    getCommitFileDiff(cwd: string, sha: string, path: string, requestId?: string): Promise<{
+        file: ParsedDiffFile | null;
+    }>;
+    inspectWorkspaceRecovery(workspaceId: string, requestId?: string): Promise<WorkspaceRecoveryState>;
+    listCheckoutCommits(cwd: string, requestId?: string): Promise<{
+        baseRef: string | null;
+        commits: CheckoutCommit[];
+    }>;
+    listProjects(requestId?: string): Promise<ProjectListPayload>;
+    onAgentAttentionRequired(handler: (notification: AgentAttentionRequiredNotification) => void): () => void;
+    restoreWorkspace(workspaceId: string, requestId?: string): Promise<void>;
+    searchGithubRepositories(input: {
+        query: string;
+        limit?: number;
+    }, requestId?: string): Promise<WorkspaceGithubSearchRepositoriesPayload>;
+    setAgentTimelineSubscription(agentIds: string[]): Promise<void>;
+    setWorkspacePinned(workspaceId: string, pinned: boolean, requestId?: string): Promise<{
+        pinnedAt: string | null;
+    }>;
+    subscribeFile(input: {
+        cwd: string;
+        path: string;
+    }, onUpdate: (version: FileVersion) => void): Promise<{
+        initial: FileVersion;
+        unsubscribe: () => void;
+    }>;
     fetchAgentTimeline(agentId: string, options?: FetchAgentTimelineOptions): Promise<FetchAgentTimelinePayload>;
     buildAgentForkContext(agentId: string, options?: AgentForkContextOptions): Promise<AgentForkContextPayload>;
     sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<SendAgentMessageResult>;
@@ -1106,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`.
      */
@@ -1118,13 +1229,13 @@ export declare class DaemonClient {
         cancelled?: boolean;
     }>;
     setAgentMode(agentId: string, modeId: string): Promise<AgentProviderNotice | null>;
-    setAgentModel(agentId: string, modelId: string | null): Promise<void>;
+    setAgentModel(agentId: string, modelId: string | null): Promise<AgentProviderNotice | null>;
     setAgentFeature(agentId: string, featureId: string, value: unknown): Promise<void>;
     setAgentThinkingOption(agentId: string, thinkingOptionId: string | null): Promise<AgentProviderNotice | null>;
     /**
      * 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.
      */
@@ -1276,6 +1387,12 @@ export declare class DaemonClient {
         query?: string;
         limit?: number;
     }, requestId?: string): Promise<BranchSuggestionsPayload>;
+    searchForge(options: {
+        cwd: string;
+        query: string;
+        limit?: number;
+        kinds?: ForgeSearchRequest["kinds"];
+    }, requestId?: string): Promise<ForgeSearchPayload>;
     searchGitHub(options: {
         cwd: string;
         query: string;
@@ -1307,11 +1424,39 @@ export declare class DaemonClient {
      * save-precondition baseline (modifiedAt, eol, hash) alongside the content.
      */
     readTextFile(cwd: string, path: string, requestId?: string): Promise<TextFileReadResult>;
-    /** Conditional save — see FileWriteRequestSchema for the no-clobber contract. */
+    /**
+     * The fs.file.write RPC: optimistic-concurrency writes keyed by an opaque
+     * revision. The hash-keyed `writeFile` below is kept for callers
+     * that have not moved over.
+     */
+    writeFsFile(input: {
+        cwd: string;
+        path: string;
+        content: string;
+        expectedModifiedAt: string;
+        expectedRevision?: string;
+    }): Promise<FsFileWriteResult>;
+    /** 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. */
+    /**
+     * 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.
+     *
+     * Shaped like {@link uploadFile}: the JSON request says where the bytes go
+     * and how many to expect, then the bytes follow as file-transfer frames
+     * correlated on the same `requestId`. The daemon answers at FileEnd.
+     */
+    writeBinaryFile(options: FileWriteBinaryOptions): Promise<FsFileWriteBinaryResult>;
+    /**
+     * FileBegin, chunks, FileEnd. Synchronous through `sendBinaryFrame`, so the
+     * 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. */
+    /** 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>;
@@ -1338,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. */
@@ -1352,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>;
@@ -1386,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. */
@@ -1407,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;
@@ -1461,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: {
@@ -1538,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>;
@@ -1560,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;
@@ -1613,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"]>;
@@ -1621,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;
@@ -1750,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;
@@ -1775,8 +1970,67 @@ export declare class DaemonClient {
     private recordLivenessFailure;
     private handleSessionMessage;
     private resolveWaiters;
+    private rejectWaitersForRequestId;
     private clearWaiters;
     private toEvent;
     private waitForWithCancel;
+    cloneGithubProject(input: {
+        repo: string;
+        targetDirectory: string;
+        cloneProtocol?: ProjectGithubCloneProtocol;
+    }, requestId?: string): Promise<ProjectGithubClonePayload>;
+    /**
+     * `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
+     * daemon ignores the flag and answers with the otto.json list only.
+     */
+    listWorkspaceScripts(workspaceId: string, options?: {
+        includeDiscovered?: boolean;
+        requestId?: string;
+    }): Promise<Extract<SessionOutboundMessage, {
+        type: "workspace.script.list.response";
+    }>["payload"]>;
+    startWorkspaceScriptWithStatus(workspaceId: string, scriptName: string, requestId?: string): Promise<Extract<SessionOutboundMessage, {
+        type: "workspace.script.start.response";
+    }>["payload"]>;
+    stopWorkspaceScript(workspaceId: string, scriptName: string, requestId?: string): Promise<Extract<SessionOutboundMessage, {
+        type: "workspace.script.stop.response";
+    }>["payload"]>;
+    connectHub(hubUrl: string, token: string, requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+    }>;
+    getHubStatus(requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+    }>;
+    disconnectHub(force?: boolean, requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connected" | "connecting" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+        warning?: string | undefined;
+    }>;
+    private requireHubRelationshipSupport;
 }
 //# sourceMappingURL=daemon-client.d.ts.map