@otto-code/client 0.5.2 → 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";
@@ -775,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>;
@@ -1056,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({
@@ -2990,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.2",
+  "version": "0.5.4",
   "description": "Otto client SDK package",
   "files": [
     "dist",
@@ -35,8 +35,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@otto-code/protocol": "0.5.2",
-    "@otto-code/relay": "0.5.2",
+    "@otto-code/protocol": "0.5.4",
+    "@otto-code/relay": "0.5.4",
     "zod": "^4.4.3"
   },
   "devDependencies": {