@opencow-ai/opencow-agent-sdk 0.4.18 → 0.4.20

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/package.json

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