@steerable/agent-runtime 0.9.1 → 0.10.0

package/dist/methods.d.ts

@@ -9,7 +9,7 @@
  * has) fails CI instead of drifting silently.
  */
 /** Every host→sidecar request method the sidecar registers. */
-export declare const SIDECAR_METHODS: readonly ["system.ping", "system.shutdown", "system.shutdown_now", "agent.session.create", "agent.session.resume", "agent.session.list", "agent.session.fork", "agent.session.branches", "agent.session.messages", "agent.chat.stream", "agent.chat.cancel", "agent.chat.steer", "agent.chat.fork", "agent.chat.compact", "agent.session.tree", "tool.list", "tool.invoke", "workspace.apply_edits", "skills.list", "trace.fetch", "trace.export", "metrics.export", "config.get", "config.set", "compat.describe", "sandbox.describe", "harness.describe", "models.list", "presets.describe", "presets.resolve", "catalog.describe", "plugin.list", "plugin.enable", "plugin.disable", "plugin.reload", "plugin.tools.describe"];
+export declare const SIDECAR_METHODS: readonly ["system.ping", "system.shutdown", "system.shutdown_now", "agent.session.create", "agent.session.resume", "agent.session.list", "agent.session.fork", "agent.session.branches", "agent.session.messages", "agent.chat.stream", "agent.chat.cancel", "agent.chat.steer", "agent.chat.fork", "agent.chat.compact", "agent.session.tree", "agent.children.list", "agent.children.interrupt", "tool.list", "tool.invoke", "workspace.apply_edits", "skills.list", "trace.fetch", "trace.export", "metrics.export", "config.get", "config.set", "compat.describe", "sandbox.describe", "harness.describe", "models.list", "presets.describe", "presets.resolve", "catalog.describe", "plugin.list", "plugin.enable", "plugin.disable", "plugin.reload", "plugin.tools.describe"];
 export type SidecarMethod = (typeof SIDECAR_METHODS)[number];
 /** Notification methods the sidecar pushes (no id, no response). */
 export declare const SIDECAR_NOTIFICATIONS: readonly ["lifecycle.ready", "lifecycle.shutdown", "stream.chunk", "stream.done", "stream.error", "agent.child"];

package/dist/methods.js

@@ -25,6 +25,8 @@ export const SIDECAR_METHODS = [
     'agent.chat.fork',
     'agent.chat.compact',
     'agent.session.tree',
+    'agent.children.list',
+    'agent.children.interrupt',
     'tool.list',
     'tool.invoke',
     'workspace.apply_edits',

package/dist/runtime.d.ts

@@ -29,6 +29,35 @@ export interface SessionMessages {
         content: string;
     }[];
 }
+/**
+ * One child agent as the durable index reports it.
+ *
+ * `status` is composed, never stored raw: a terminal row reports its own
+ * status, a non-terminal row with a live handle reports `running`, and one
+ * with no handle reports `interrupted` (the spawning turn ended or the
+ * process died — `resumable` says whether a send can continue it).
+ */
+export interface ChildAgentStatus {
+    recordId: string;
+    parentRecordId: string;
+    childId: string;
+    depth: number;
+    profile: string | null;
+    engine: string;
+    status: string;
+    resumable: boolean;
+    live: boolean;
+    promptTokens: number | null;
+    completionTokens: number | null;
+    usageKnown: boolean;
+    createdAt: string;
+    updatedAt: string;
+    answerPreview?: string;
+}
+export interface ChildrenList {
+    parentRecordId: string | null;
+    children: ChildAgentStatus[];
+}
 export interface ToolDescriptor {
     name: string;
     description?: string;
@@ -321,6 +350,31 @@ export declare class AgentRuntime {
      * model would see on resume. Fails loud on unknown records.
      */
     sessionMessages(recordId: string): Promise<SessionMessages>;
+    /**
+     * Every child agent recorded for one parent session — the durable answer
+     * to "what did this session spawn", which the live pool cannot give once
+     * the spawning turn ended.
+     */
+    childrenList(params?: {
+        parentRecordId?: string;
+        prefix?: string;
+        includeFinished?: boolean;
+        answerPreviewChars?: number;
+    }): Promise<ChildrenList>;
+    /**
+     * Cooperatively interrupt one running child of a chat's live turn.
+     *
+     * The panel's stop control, not a model-driven tool call: it must not wait
+     * for a turn of its own. `interrupted: false` means the child is not running
+     * in this process (already settled, or a restarted sidecar).
+     *
+     * @param chatId The chat whose turn owns the child.
+     * @param childId The child's lineage id (`0.2`).
+     */
+    childrenInterrupt(chatId: string, childId: string): Promise<{
+        interrupted: boolean;
+        reason?: string;
+    }>;
     /**
      * Start one CoreLoop turn. Resolves with a handle as soon as the sidecar
      * assigns a stream id; consume `handle.events` for the turn and await

package/dist/runtime.js

@@ -157,6 +157,27 @@ export class AgentRuntime {
     sessionMessages(recordId) {
         return this.process.request('agent.session.messages', { recordId });
     }
+    /**
+     * Every child agent recorded for one parent session — the durable answer
+     * to "what did this session spawn", which the live pool cannot give once
+     * the spawning turn ended.
+     */
+    childrenList(params = {}) {
+        return this.process.request('agent.children.list', params);
+    }
+    /**
+     * Cooperatively interrupt one running child of a chat's live turn.
+     *
+     * The panel's stop control, not a model-driven tool call: it must not wait
+     * for a turn of its own. `interrupted: false` means the child is not running
+     * in this process (already settled, or a restarted sidecar).
+     *
+     * @param chatId The chat whose turn owns the child.
+     * @param childId The child's lineage id (`0.2`).
+     */
+    childrenInterrupt(chatId, childId) {
+        return this.process.request('agent.children.interrupt', { chatId, childId });
+    }
     // ---- chat ------------------------------------------------------------
     /**
      * Start one CoreLoop turn. Resolves with a handle as soon as the sidecar

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-runtime",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Steerable framework — official TypeScript production runtime. Owns the embedded Python sidecar lifecycle (spawn / ready handshake / health / bounded auto-restart / graceful drain) and exposes the CoreLoop-level API over the sidecar JSON-RPC surface. There is no TS CoreLoop; this package drives the same Rust CoreLoop the server uses (via the Python sidecar facade), so cross-language conformance holds by construction.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -35,20 +35,20 @@
     "node": ">=22.19.0"
   },
   "dependencies": {
-    "@steerable/agent-protocol": "0.9.1"
+    "@steerable/agent-protocol": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@steerable/agent-ui": "0.9.1"
+    "@steerable/agent-ui": "0.10.0"
   },
   "optionalDependencies": {
-    "@steerable/runtime-darwin-arm64": "0.9.1",
-    "@steerable/runtime-darwin-x64": "0.9.1",
-    "@steerable/runtime-linux-arm64": "0.9.1",
-    "@steerable/runtime-linux-x64": "0.9.1",
-    "@steerable/runtime-win32-x64": "0.9.1"
+    "@steerable/runtime-darwin-arm64": "0.10.0",
+    "@steerable/runtime-darwin-x64": "0.10.0",
+    "@steerable/runtime-linux-arm64": "0.10.0",
+    "@steerable/runtime-linux-x64": "0.10.0",
+    "@steerable/runtime-win32-x64": "0.10.0"
   },
   "scripts": {
     "gen": "echo agent-runtime-ts",