@opencow-ai/opencow-agent-sdk 0.4.17 → 0.4.19

package/dist/session/backgroundAbortRegistry.d.ts

@@ -1,13 +1,20 @@
-export declare function registerBackgroundAgentAbort(agentId: string, controller: AbortController): void;
+type BackgroundAgentStopActions = {
+    abort: () => void;
+    stopShells: () => void;
+};
+export declare function registerBackgroundAgentAbort(agentId: string, actions: BackgroundAgentStopActions): void;
 export declare function unregisterBackgroundAgentAbort(agentId: string): void;
 /**
- * Abort a background sub-agent by id. Returns true if a live controller was
- * found and signalled, false if the agent is unknown / already settled.
- * The entry stays registered until the run's finally unregisters it — the
- * run is still draining at this point and its terminal delivery (and any
- * late natural-stop marking) still needs the per-run state.
+ * Stop a background sub-agent by id and wait for its runAgent finalizer.
+ *
+ * The first caller synchronously aborts the run and stops its owned shells.
+ * Later callers share the same Promise. The Promise resolves only when
+ * runAgent unregisters after MCP cleanup and all remaining finalizers.
+ * Unknown or already-settled agents are an idempotent completed stop.
  */
-export declare function abortBackgroundAgentById(agentId: string): boolean;
+export declare function abortBackgroundAgentById(agentId: string): Promise<void>;
+export declare function hasBackgroundAgent(agentId: string): boolean;
+export declare function stopBackgroundAgentShellsById(agentId: string): void;
 /**
  * Record that the natural-stop path delivered SubagentStop for this run.
  * No-op when the run is gone (e.g. the fallback delivery in runAgent's
@@ -21,3 +28,4 @@ export declare function markSubagentStopFired(agentId: string): void;
  * is still needed. Purely a read — the per-run state dies with the entry.
  */
 export declare function hasSubagentStopFired(agentId: string): boolean;
+export {};

package/dist/session/backgroundTaskScope.d.ts

@@ -0,0 +1,29 @@
+import type { SetAppState } from '../tasks/Task.js';
+type OwnedBackgroundTask = {
+    stop: () => Promise<void>;
+    settled: Promise<void>;
+};
+/**
+ * Query/Session 维度的后台任务所有权。
+ *
+ * stop() 会先触发每个任务的 stop，再等待任务自身 settled；重复调用共享
+ * 同一个 Promise。任务自然结束时会从 scope 自动注销。
+ */
+export declare class BackgroundTaskScope {
+    private readonly tasks;
+    private stopPromise;
+    private stopped;
+    register(task: OwnedBackgroundTask): () => void;
+    stop(): Promise<void>;
+    private drain;
+    private stopTask;
+}
+/**
+ * 用每个 SDK Query 独有的 setAppState 函数作为窄 owner key。
+ *
+ * 这只负责把深层 shell spawn 路由到已有 scope，不保存 QueryContext，
+ * 也不创建第二套 AsyncLocalStorage。
+ */
+export declare function bindBackgroundTaskScope(setAppState: SetAppState, scope: BackgroundTaskScope): () => void;
+export declare function getBackgroundTaskScope(setAppState: SetAppState): BackgroundTaskScope | undefined;
+export {};

package/dist/session/collapseReadSearch.d.ts

@@ -1,4 +1,5 @@
 import { type Tools } from '../Tool.js';
+import { type ToolRuntimes } from '../types/toolRuntime.js';
 import type { CollapsedReadSearchGroup, CollapsibleMessage, RenderableMessage } from '../types/message.js';
 /**
  * Result of checking if a tool use is a search or read operation.
@@ -27,7 +28,7 @@ export type SearchOrReadResult = {
  * Also treats Write/Edit of memory files as collapsible.
  * Returns detailed information about whether it's a search or read operation.
  */
-export declare function getToolSearchOrReadInfo(toolName: string, toolInput: unknown, tools: Tools): SearchOrReadResult;
+export declare function getToolSearchOrReadInfo(toolName: string, toolInput: unknown, tools: ToolRuntimes): SearchOrReadResult;
 /**
  * Check if a tool_use content block is a search/read operation.
  * Returns { isSearch, isRead, isREPL } if it's a collapsible search/read, null otherwise.

package/dist/session/promptShellExecution.d.ts

@@ -1,4 +1,4 @@
-import type { ToolRuntimeContext } from '../Tool.js';
+import type { ToolRuntimeContext } from '../types/toolRuntime.js';
 import type { FrontmatterShell } from '../lib/frontmatterParser.js';
 /**
  * Parses prompt text and executes any embedded shell commands.
@@ -6,9 +6,7 @@ import type { FrontmatterShell } from '../lib/frontmatterParser.js';
  * - Code blocks: ```! command ```
  * - Inline: !`command`
  *
- * @param shell - Shell to route commands through. Defaults to bash.
- *   This is *never* read from settings.defaultShell — it comes from .md
- *   frontmatter (author's choice) or is undefined for built-in commands.
- *   See docs/design/ps-shell-selection.md §5.3.
+ * @param shell - Explicit frontmatter shell. When omitted, uses the detected
+ *   process default. Explicit requests never fall back to another language.
  */
 export declare function executeShellCommandsInPrompt(text: string, context: ToolRuntimeContext, slashCommandName: string, shell?: FrontmatterShell): Promise<string>;

package/dist/session/settings/types.d.ts

@@ -333,10 +333,6 @@ export declare const SettingsSchema: () => z.ZodObject<{
         sparsePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     disableAllHooks: z.ZodOptional<z.ZodBoolean>;
-    defaultShell: z.ZodOptional<z.ZodEnum<{
-        bash: "bash";
-        powershell: "powershell";
-    }>>;
     allowManagedHooksOnly: z.ZodOptional<z.ZodBoolean>;
     allowedHttpHookUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
     httpHookAllowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/state/AppStateStore.d.ts

@@ -5,7 +5,8 @@ import type { Command } from '../types/command.js';
 import type { ChannelPermissionCallbacks } from '../capabilities/mcp/channelPermissions.js';
 import type { ElicitationRequestEvent } from '../capabilities/mcp/elicitationHandler.js';
 import type { MCPServerConnection, ServerResource } from '../capabilities/mcp/types.js';
-import { type Tool, type ToolPermissionContext } from '../Tool.js';
+import { type ToolPermissionContext } from '../Tool.js';
+import type { ToolRuntime } from '../types/toolRuntime.js';
 import type { TaskState } from '../tasks/types.js';
 import type { AgentColorName } from '../capabilities/tools/AgentTool/agentColorManager.js';
 import type { AgentDefinitionsResult } from '../capabilities/tools/AgentTool/loadAgentsDir.js';
@@ -119,7 +120,7 @@ export type AppState = DeepImmutable<{
     companionPetAt?: number;
     mcp: {
         clients: MCPServerConnection[];
-        tools: Tool[];
+        tools: ToolRuntime[];
         commands: Command[];
         resources: Record<string, ServerResource[]>;
         /**

package/dist/tasks/LocalAgentTask/LocalAgentTask.d.ts

@@ -1,6 +1,6 @@
 import type { AppState } from '../../state/AppStateStore.js';
 import type { SetAppState, Task, TaskStateBase } from '../Task.js';
-import type { Tools } from '../../Tool.js';
+import { type ToolRuntimes } from '../../types/toolRuntime.js';
 import type { AgentToolResult } from '../../capabilities/tools/AgentTool/agentToolUtils.js';
 import type { AgentDefinition } from '../../capabilities/tools/AgentTool/loadAgentsDir.js';
 import type { Message } from '../../types/message.js';
@@ -36,13 +36,13 @@ export declare function getTokenCountFromTracker(tracker: ProgressTracker): numb
  * from Tool.getActivityDescription() at recording time.
  */
 export type ActivityDescriptionResolver = (toolName: string, input: Record<string, unknown>) => string | undefined;
-export declare function updateProgressFromMessage(tracker: ProgressTracker, message: Message, resolveActivityDescription?: ActivityDescriptionResolver, tools?: Tools): void;
+export declare function updateProgressFromMessage(tracker: ProgressTracker, message: Message, resolveActivityDescription?: ActivityDescriptionResolver, tools?: ToolRuntimes): void;
 export declare function getProgressUpdate(tracker: ProgressTracker): AgentProgress;
 /**
  * Creates an ActivityDescriptionResolver from a tools list.
  * Looks up the tool by name and calls getActivityDescription if available.
  */
-export declare function createActivityDescriptionResolver(tools: Tools): ActivityDescriptionResolver;
+export declare function createActivityDescriptionResolver(tools: ToolRuntimes): ActivityDescriptionResolver;
 export type LocalAgentTaskState = TaskStateBase & {
     type: 'local_agent';
     agentId: string;

package/dist/tools.d.ts

@@ -1,11 +1,10 @@
-import { type Tools } from './Tool.js';
+import { type ToolPermissionContext, type ToolRuntimes } from './types/toolRuntime.js';
 /**
  * Register the built-in tools provider. Called by CLI at startup with a
  * function that returns getAllBaseTools(). SDK mode leaves this null.
  */
-export declare function registerBuiltInToolsProvider(provider: () => Tools): void;
+export declare function registerBuiltInToolsProvider(provider: () => ToolRuntimes): void;
 export { ALL_AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, ASYNC_AGENT_ALLOWED_TOOLS, COORDINATOR_MODE_ALLOWED_TOOLS, } from './constants/tools.js';
-import type { ToolPermissionContext } from './Tool.js';
 import { REPL_ONLY_TOOLS } from './capabilities/tools/REPLTool/constants.js';
 export { REPL_ONLY_TOOLS };
 /**
@@ -28,7 +27,7 @@ export declare function getToolsForDefaultPreset(): string[];
  *
  * NOTE: This MUST stay in sync with https://console.statsig.com/4aF3Ewatb6xPVpCwxb5nA3/dynamic_configs/claude_code_global_system_caching, in order to cache the system prompt across users.
  */
-export declare function getAllBaseTools(): Tools;
+export declare function getAllBaseTools(): ToolRuntimes;
 /**
  * Filters out tools that are blanket-denied by the permission context.
  * A tool is filtered out if there's a deny rule matching its name with no
@@ -45,7 +44,7 @@ export declare function filterToolsByDenyRules<T extends {
         toolName: string;
     };
 }>(tools: readonly T[], permissionContext: ToolPermissionContext): T[];
-export declare const getTools: (permissionContext: ToolPermissionContext) => Tools;
+export declare const getTools: (permissionContext: ToolPermissionContext, explicitBuiltIns?: ToolRuntimes) => ToolRuntimes;
 /**
  * Assemble the full tool pool for a given permission context and MCP tools.
  *
@@ -62,7 +61,7 @@ export declare const getTools: (permissionContext: ToolPermissionContext) => Too
  * @param mcpTools - MCP tools from appState.mcp.tools
  * @returns Combined, deduplicated array of built-in and MCP tools
  */
-export declare function assembleToolPool(permissionContext: ToolPermissionContext, mcpTools: Tools): Tools;
+export declare function assembleToolPool(permissionContext: ToolPermissionContext, mcpTools: ToolRuntimes, explicitBuiltIns?: ToolRuntimes): ToolRuntimes;
 /**
  * Get all tools including both built-in tools and MCP tools.
  *
@@ -77,4 +76,4 @@ export declare function assembleToolPool(permissionContext: ToolPermissionContex
  * @param mcpTools - MCP tools from appState.mcp.tools
  * @returns Combined array of built-in and MCP tools
  */
-export declare function getMergedTools(permissionContext: ToolPermissionContext, mcpTools: Tools): Tools;
+export declare function getMergedTools(permissionContext: ToolPermissionContext, mcpTools: ToolRuntimes): ToolRuntimes;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",