@otto-code/client 0.5.1 → 0.5.4

package/dist/daemon-client.d.ts

@@ -1,8 +1,9 @@
 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, 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, ProjectAddResponse, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, AgentContextGetUsageResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, 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, 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, ProjectAddResponse, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, StatsActivityGetResponseMessage, AgentContextGetUsageResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, 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 { MutableDaemonConfig, MutableDaemonConfigPatch, SpeechSettingsOptions, SpeechTtsPreviewResult } from "@otto-code/protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
 import { type TerminalStreamEvent } from "./terminal-stream-router.js";
@@ -550,6 +551,8 @@ export interface CreateScheduleOptions {
         config: {
             provider: AgentProvider;
             cwd: string;
+            /** Personality binding by name, or the "@team-scheduler" sentinel. */
+            personality?: string;
             modeId?: string;
             model?: string;
             thinkingOptionId?: string;
@@ -576,6 +579,11 @@ export interface InspectScheduleOptions {
 }
 export interface UpdateScheduleNewAgentConfig {
     provider?: string;
+    /**
+     * Personality binding by name, or the "@team-scheduler" sentinel. Explicit
+     * null clears a stored binding; omission leaves it untouched.
+     */
+    personality?: string | null;
     model?: string | null;
     modeId?: string | null;
     thinkingOptionId?: string | null;
@@ -768,6 +776,30 @@ export declare class DaemonClient {
      * the provider's stopTask. See projects/observed-subagents/observed-subagents.md.
      */
     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
+     * calls the provider's stopTask, same mechanism as stopObservedSubagent.
+     */
+    stopBackgroundShellTask(parentAgentId: string, taskId: string): Promise<void>;
+    /**
+     * Clear one or more terminal background shell tasks from the Background
+     * Tasks track. Still-live tasks are stopped best-effort first.
+     */
+    clearBackgroundShellTasks(parentAgentId: string, taskIds: readonly string[]): Promise<void>;
+    /** Orchestration: fetch the current snapshot of all runs on this host. */
+    getRunsSnapshot(): Promise<Run[]>;
+    /** Orchestration: approve or reject a run's attended gate. */
+    respondToRunGate(input: {
+        runId: string;
+        phaseId: string;
+        approved: boolean;
+        note?: string;
+    }): Promise<boolean>;
+    /** Orchestration: cancel a run. */
+    cancelRun(runId: string): Promise<boolean>;
+    /** Orchestration: delete every finished (done/failed/canceled) run. */
+    clearFinishedRuns(): Promise<string[]>;
     updateAgent(agentId: string, updates: {
         name?: string;
         labels?: Record<string, string>;
@@ -789,7 +821,9 @@ export declare class DaemonClient {
     sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
     sendMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
     rewindAgent(agentId: string, messageId: string, mode: "conversation" | "files" | "both"): Promise<AgentRewindResponseMessage["payload"]>;
-    cancelAgent(agentId: string): Promise<void>;
+    cancelAgent(agentId: string): Promise<{
+        cancelled?: boolean;
+    }>;
     setAgentMode(agentId: string, modeId: string): Promise<AgentProviderNotice | null>;
     setAgentModel(agentId: string, modelId: string | null): Promise<void>;
     setAgentFeature(agentId: string, featureId: string, value: unknown): Promise<void>;
@@ -1047,6 +1081,10 @@ export declare class DaemonClient {
     listProviderUsage(options?: {
         requestId?: string;
     }): Promise<ProviderUsageListPayload>;
+    /** Daemon-wide "fun stats" — see docs/data-model.md ActivityStatsStore. */
+    getActivityStats(options?: {
+        requestId?: string;
+    }): Promise<StatsActivityGetResponseMessage["payload"]>;
     getAgentContextUsage(agentId: string, options?: {
         requestId?: string;
     }): Promise<AgentContextGetUsagePayload>;

package/dist/daemon-client.js

@@ -1256,6 +1256,73 @@ export class DaemonClient {
             throw new Error(payload.error ?? "stopObservedSubagent rejected");
         }
     }
+    /**
+     * 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
+     * calls the provider's stopTask, same mechanism as stopObservedSubagent.
+     */
+    async stopBackgroundShellTask(parentAgentId, taskId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.background_task.stop.request",
+                parentAgentId,
+                taskId,
+            },
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "stopBackgroundShellTask rejected");
+        }
+    }
+    /**
+     * Clear one or more terminal background shell tasks from the Background
+     * Tasks track. Still-live tasks are stopped best-effort first.
+     */
+    async clearBackgroundShellTasks(parentAgentId, taskIds) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.background_task.clear.request",
+                parentAgentId,
+                taskIds: [...taskIds],
+            },
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "clearBackgroundShellTasks rejected");
+        }
+    }
+    /** Orchestration: fetch the current snapshot of all runs on this host. */
+    async getRunsSnapshot() {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.get_snapshot.request" },
+        });
+        return payload.runs;
+    }
+    /** Orchestration: approve or reject a run's attended gate. */
+    async respondToRunGate(input) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "runs.gate_respond.request",
+                runId: input.runId,
+                phaseId: input.phaseId,
+                approved: input.approved,
+                ...(input.note !== undefined ? { note: input.note } : {}),
+            },
+        });
+        return payload.accepted;
+    }
+    /** Orchestration: cancel a run. */
+    async cancelRun(runId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.cancel.request", runId },
+        });
+        return payload.canceled;
+    }
+    /** Orchestration: delete every finished (done/failed/canceled) run. */
+    async clearFinishedRuns() {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "runs.clear.request" },
+        });
+        return payload.runIds;
+    }
     async updateAgent(agentId, updates) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -1541,7 +1608,7 @@ export class DaemonClient {
             agentId,
             requestId,
         });
-        await this.sendRequest({
+        const payload = await this.sendRequest({
             requestId,
             message,
             options: { skipQueue: true },
@@ -1555,6 +1622,8 @@ export class DaemonClient {
                 return msg.payload;
             },
         });
+        // Absent ⇒ old daemon that doesn't report whether a run was interrupted.
+        return payload.cancelled !== undefined ? { cancelled: payload.cancelled } : {};
     }
     async setAgentMode(agentId, modeId) {
         const requestId = this.createRequestId();
@@ -2988,6 +3057,15 @@ export class DaemonClient {
             },
         });
     }
+    /** Daemon-wide "fun stats" — see docs/data-model.md ActivityStatsStore. */
+    async getActivityStats(options) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId: options?.requestId,
+            message: {
+                type: "stats.activity.get.request",
+            },
+        });
+    }
     async getAgentContextUsage(agentId, options) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId: options?.requestId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otto-code/client",
-  "version": "0.5.1",
+  "version": "0.5.4",
   "description": "Otto client SDK package",
   "files": [
     "dist",
@@ -35,8 +35,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@otto-code/protocol": "0.5.1",
-    "@otto-code/relay": "0.5.1",
+    "@otto-code/protocol": "0.5.4",
+    "@otto-code/relay": "0.5.4",
     "zod": "^4.4.3"
   },
   "devDependencies": {