@otto-code/client 0.6.6 → 0.6.7

package/dist/daemon-client.d.ts

@@ -1,10 +1,10 @@
 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, 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, 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 { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@otto-code/protocol/agent-types";
-import type { Run } from "@otto-code/protocol/orchestration";
-import type { CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, VisualizerVoiceCuesResult } from "@otto-code/protocol/messages";
+import type { OrchestrationGraph, 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 TerminalStreamEvent } from "./terminal-stream-router.js";
 import type { BrowserAutomationExecuteRequest, BrowserAutomationExecuteResponse } from "@otto-code/protocol/browser-automation/rpc-schemas";
@@ -631,6 +631,9 @@ export interface RenameTerminalInput {
 type OpenProjectPayload = OpenProjectResponseMessage["payload"];
 type ProjectAddPayload = ProjectAddResponse["payload"];
 type ArchiveWorkspacePayload = ArchiveWorkspaceResponseMessage["payload"];
+type WorkspaceArchivePreflightPayload = WorkspaceArchivePreflightResponse["payload"];
+type WorktreeReattachListPayload = WorktreeReattachListResponse["payload"];
+type WorktreeReattachPayload = WorktreeReattachResponse["payload"];
 type WorkspaceSetupStatusPayload = WorkspaceSetupStatusResponseMessage["payload"];
 export interface FetchAgentResult {
     agent: AgentSnapshotPayload;
@@ -766,7 +769,16 @@ export declare class DaemonClient {
     startWorkspaceScript(workspaceId: string, scriptName: string, requestId?: string): Promise<Extract<SessionOutboundMessage, {
         type: "start_workspace_script_response";
     }>["payload"]>;
-    archiveWorkspace(workspaceId: string, requestId?: string): Promise<ArchiveWorkspacePayload>;
+    archiveWorkspace(workspaceId: string, options?: {
+        branchDisposition?: "keep" | "delete";
+        requestId?: string;
+    }): Promise<ArchiveWorkspacePayload>;
+    workspaceArchivePreflight(workspaceId: string, requestId?: string): Promise<WorkspaceArchivePreflightPayload>;
+    listReattachableWorktrees(scope: {
+        projectId?: string;
+        cwd?: string;
+    }, requestId?: string): Promise<WorktreeReattachListPayload>;
+    reattachWorktree(target: WorktreeReattachTarget, requestId?: string): Promise<WorktreeReattachPayload>;
     fetchWorkspaceSetupStatus(workspaceId: string, requestId?: string): Promise<WorkspaceSetupStatusPayload>;
     fetchAgent(options: FetchAgentOptions): Promise<FetchAgentResult | null>;
     fetchAgent(agentId: string, requestId?: string): Promise<FetchAgentResult | null>;
@@ -823,6 +835,36 @@ export declare class DaemonClient {
     cancelRun(runId: string): Promise<boolean>;
     /** Orchestration: delete every finished (done/failed/canceled) run. */
     clearFinishedRuns(): 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: start (or draft) a user-initiated orchestration. Returns the
+     * run id (graph flavor) and the orchestrator chat's agent id to navigate to.
+     */
+    startOrchestration(input: {
+        flavor: "ai" | "graph";
+        cwd: string;
+        workspaceId?: string;
+        title?: string;
+        description?: string;
+        orchestratorPersonalityId?: string;
+        orchestratorProvider?: string;
+        orchestratorModel?: string;
+        orchestratorThinkingOptionId?: string;
+        prompt?: string;
+        graphId?: string;
+        graphInputs?: Record<string, string>;
+        draft?: boolean;
+        runId?: string;
+    }): Promise<{
+        runId?: string;
+        agentId?: string;
+        workspaceId?: string;
+    }>;
     updateAgent(agentId: string, updates: {
         name?: string;
         labels?: Record<string, string>;
@@ -1132,6 +1174,15 @@ export declare class DaemonClient {
             name: string;
         };
     }, requestId?: string): Promise<SpeechTtsPreviewResult>;
+    speakMessage(params: {
+        text: string;
+        voice?: {
+            provider?: string;
+            model?: string;
+            name: string;
+        };
+    }, requestId?: string): Promise<SpeechTtsSpeakResult>;
+    cancelSpeakMessage(requestId?: string): Promise<SpeechTtsSpeakCancelResult>;
     generateVisualizerVoiceCues(params: {
         name: string;
         prompt?: string;

package/dist/daemon-client.js

@@ -1033,16 +1033,55 @@ export class DaemonClient {
             responseType: "start_workspace_script_response",
         });
     }
-    async archiveWorkspace(workspaceId, requestId) {
+    async archiveWorkspace(workspaceId, options) {
         return this.sendCorrelatedSessionRequest({
-            requestId,
+            requestId: options?.requestId,
             message: {
                 type: "archive_workspace_request",
                 workspaceId,
+                ...(options?.branchDisposition ? { branchDisposition: options.branchDisposition } : {}),
             },
             responseType: "archive_workspace_response",
         });
     }
+    // Read-only pre-archive inspection of a worktree's leftover branch (merge
+    // state, deletability). Gated by server_info.features.worktreeArchiveBranchCleanup.
+    async workspaceArchivePreflight(workspaceId, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "workspace.archive.preflight.request",
+                workspaceId,
+            },
+            responseType: "workspace.archive.preflight.response",
+        });
+    }
+    // List re-attachable Otto worktrees for a project (or the repo containing cwd):
+    // archived worktree workspaces with a kept branch, plus orphaned on-disk
+    // worktrees. Gated by server_info.features.worktreeReattach.
+    async listReattachableWorktrees(scope, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "worktree.reattach.list.request",
+                ...(scope.projectId ? { projectId: scope.projectId } : {}),
+                ...(scope.cwd ? { cwd: scope.cwd } : {}),
+            },
+            responseType: "worktree.reattach.list.response",
+        });
+    }
+    // Re-attach a "left" worktree as a live workspace: revive an archived workspace
+    // record in place, or bind a fresh workspace to an orphaned on-disk worktree.
+    async reattachWorktree(target, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "worktree.reattach.request",
+                target,
+            },
+            responseType: "worktree.reattach.response",
+        });
+    }
     async fetchWorkspaceSetupStatus(workspaceId, requestId) {
         return this.sendCorrelatedSessionRequest({
             requestId,
@@ -1358,6 +1397,74 @@ export class DaemonClient {
         });
         return payload.runIds;
     }
+    /** Orchestration: list the host's reusable graph templates. */
+    async listOrchestrationGraphs() {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.graphs.list.request" },
+        });
+        return payload.graphs;
+    }
+    /** Orchestration: upsert a graph template. Returns the persisted graph. */
+    async saveOrchestrationGraph(graph) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.graphs.save.request", graph },
+        });
+        if (payload.error !== undefined || payload.graph === undefined) {
+            throw new Error(payload.error ?? "saveOrchestrationGraph rejected");
+        }
+        return payload.graph;
+    }
+    /** Orchestration: delete a graph template (built-in starters refuse). */
+    async deleteOrchestrationGraph(graphId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.graphs.delete.request", graphId },
+        });
+        if (payload.error !== undefined) {
+            throw new Error(payload.error);
+        }
+        return payload.deleted;
+    }
+    /**
+     * Orchestration: start (or draft) a user-initiated orchestration. Returns the
+     * run id (graph flavor) and the orchestrator chat's agent id to navigate to.
+     */
+    async startOrchestration(input) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "runs.start.request",
+                flavor: input.flavor,
+                cwd: input.cwd,
+                ...(input.workspaceId !== undefined ? { workspaceId: input.workspaceId } : {}),
+                ...(input.title !== undefined ? { title: input.title } : {}),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+                ...(input.orchestratorPersonalityId !== undefined
+                    ? { orchestratorPersonalityId: input.orchestratorPersonalityId }
+                    : {}),
+                ...(input.orchestratorProvider !== undefined
+                    ? { orchestratorProvider: input.orchestratorProvider }
+                    : {}),
+                ...(input.orchestratorModel !== undefined
+                    ? { orchestratorModel: input.orchestratorModel }
+                    : {}),
+                ...(input.orchestratorThinkingOptionId !== undefined
+                    ? { orchestratorThinkingOptionId: input.orchestratorThinkingOptionId }
+                    : {}),
+                ...(input.prompt !== undefined ? { prompt: input.prompt } : {}),
+                ...(input.graphId !== undefined ? { graphId: input.graphId } : {}),
+                ...(input.graphInputs !== undefined ? { graphInputs: input.graphInputs } : {}),
+                ...(input.draft !== undefined ? { draft: input.draft } : {}),
+                ...(input.runId !== undefined ? { runId: input.runId } : {}),
+            },
+        });
+        if (payload.error !== undefined) {
+            throw new Error(payload.error);
+        }
+        return {
+            ...(payload.runId !== undefined ? { runId: payload.runId } : {}),
+            ...(payload.agentId !== undefined ? { agentId: payload.agentId } : {}),
+            ...(payload.workspaceId !== undefined ? { workspaceId: payload.workspaceId } : {}),
+        };
+    }
     async updateAgent(agentId, updates) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -3147,6 +3254,27 @@ export class DaemonClient {
             },
         });
     }
+    // Stream a full message aloud on demand (per-message playback button). Audio
+    // arrives as `audio_output` chunks the session already plays; this promise
+    // resolves when playback finishes, is canceled, or errors. `voice` is the
+    // speaking agent's personality voice (resolved on the client).
+    async speakMessage(params, requestId) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "speech.tts.speak.request",
+                text: params.text,
+                ...(params.voice ? { voice: params.voice } : {}),
+            },
+        });
+    }
+    // Stop the in-flight message playback started by speakMessage.
+    async cancelSpeakMessage(requestId) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: { type: "speech.tts.speak.cancel.request" },
+        });
+    }
     // Author short spoken cue lines (join / thinking / done) for a persona,
     // described inline (name + prompt) so it works for an unsaved editor draft.
     // Routed through the Writer chain; the caller stores the result on the

package/dist/index.js

@@ -14,7 +14,7 @@ export function createOttoClient(config) {
             ref: (workspace) => createWorkspaceHandle(workspace),
             open: (input, requestId) => openWorkspace(daemonClient, createWorkspaceHandle, input, requestId),
             create: (input, requestId) => openWorkspace(daemonClient, createWorkspaceHandle, input, requestId),
-            archive: (workspace, requestId) => daemonClient.archiveWorkspace(resolveWorkspaceId(workspace), requestId),
+            archive: (workspace, requestId) => daemonClient.archiveWorkspace(resolveWorkspaceId(workspace), { requestId }),
             subscribe: (handler) => daemonClient.on("workspace_update", (message) => {
                 handler(message.payload);
             }),
@@ -75,7 +75,7 @@ function createWorkspaceHandleFactory(daemonClient) {
                 return latest;
             },
             archive: async (requestId) => {
-                const result = await daemonClient.archiveWorkspace(id, requestId);
+                const result = await daemonClient.archiveWorkspace(id, { requestId });
                 if (latest) {
                     latest = { ...latest, archivingAt: result.archivedAt };
                 }

package/package.json

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