@crewhaus/tool-task 0.2.4 → 0.3.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { SubAgentDefinition } from "@crewhaus/agent-context-isolation";
+import type { SubAgentDefinition, SubAgentFailure } from "@crewhaus/agent-context-isolation";
 import { CrewhausError } from "@crewhaus/errors";
 import type { RegisteredTool } from "@crewhaus/tool-catalog";
 import { z } from "zod";
@@ -6,6 +6,20 @@ export declare class SubAgentResolutionError extends CrewhausError {
     readonly name = "SubAgentResolutionError";
     constructor(message: string, cause?: unknown);
 }
+/**
+ * v0.3.0 §7.1 — a NON-fatal classified child failure, rethrown by the Task
+ * tool so `tool-executor` surfaces it as an `is_error: true` tool result
+ * whose content is the structured `{isError, failureClass, report}` JSON —
+ * the parent model sees an honest, classified failure instead of a bare
+ * `[sub-agent error]` string. Fatal classes (billing/auth) never reach
+ * here: the spawner rethrows `RunFailedError`, which tool-executor lets
+ * propagate so the whole run halts with the child's report.
+ */
+export declare class SubAgentFailedError extends CrewhausError {
+    readonly name = "SubAgentFailedError";
+    readonly failure: SubAgentFailure;
+    constructor(failure: SubAgentFailure);
+}
 export declare const BUILTIN_GENERAL_PURPOSE: SubAgentDefinition;
 declare const taskInputSchema: z.ZodObject<{
     description: z.ZodString;

package/dist/index.js

@@ -48,6 +48,23 @@ export class SubAgentResolutionError extends CrewhausError {
         super("config", message, cause);
     }
 }
+/**
+ * v0.3.0 §7.1 — a NON-fatal classified child failure, rethrown by the Task
+ * tool so `tool-executor` surfaces it as an `is_error: true` tool result
+ * whose content is the structured `{isError, failureClass, report}` JSON —
+ * the parent model sees an honest, classified failure instead of a bare
+ * `[sub-agent error]` string. Fatal classes (billing/auth) never reach
+ * here: the spawner rethrows `RunFailedError`, which tool-executor lets
+ * propagate so the whole run halts with the child's report.
+ */
+export class SubAgentFailedError extends CrewhausError {
+    name = "SubAgentFailedError";
+    failure;
+    constructor(failure) {
+        super("tool", JSON.stringify({ isError: true, failureClass: failure.failureClass, report: failure.report }));
+        this.failure = failure;
+    }
+}
 export const BUILTIN_GENERAL_PURPOSE = {
     name: "general-purpose",
     description: "General-purpose sub-agent. Pass it a task and it will use the parent's tools (filtered by inherited permissions) to complete it and return a single summary.",
@@ -253,7 +270,20 @@ export function createTaskTool(opts = {}) {
                 model: bridge.model,
                 maxTokens: bridge.maxTokens,
                 ...(bridge.sessionRootDir !== undefined ? { sessionRootDir: bridge.sessionRootDir } : {}),
+                // v0.3.0 §7.1 — the four child seams, projected by runtime-core onto
+                // the bridge (recall-only memory, skills list, failure taxonomy,
+                // read-only continuity) and handed to the spawner verbatim.
+                ...(bridge.memory !== undefined ? { memory: bridge.memory } : {}),
+                ...(bridge.skills !== undefined ? { skills: bridge.skills } : {}),
+                ...(bridge.failureTaxonomy !== undefined
+                    ? { failureTaxonomy: bridge.failureTaxonomy }
+                    : {}),
+                ...(bridge.continuity !== undefined ? { continuity: bridge.continuity } : {}),
             };
+            // A fatal child failure (billing/auth) makes `spawnSubAgent` throw
+            // `RunFailedError`; it propagates through here and through
+            // tool-executor's carve-out so the whole run halts with the child's
+            // report (§7.1: "a billing failure anywhere ends the run").
             const result = await spawnSubAgent(parentHandle, {
                 def,
                 prompt: input.prompt,
@@ -262,6 +292,12 @@ export function createTaskTool(opts = {}) {
                 childTools,
                 ...(bridge.sessionRootDir !== undefined ? { sessionRootDir: bridge.sessionRootDir } : {}),
             });
+            if (result.failure !== undefined) {
+                // Non-fatal classified failure → an is_error tool result carrying
+                // the structured {isError, failureClass, report} content. The run
+                // continues; the parent model decides what to do next.
+                throw new SubAgentFailedError(result.failure);
+            }
             return result.finalMessage;
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/tool-task",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "type": "module",
   "description": "Task(description, prompt, subagent_type?) tool — spawns a sub-agent and returns its final message (Section 13)",
   "main": "dist/index.js",
@@ -15,18 +15,18 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/agent-context-isolation": "0.2.4",
-    "@crewhaus/errors": "0.2.4",
-    "@crewhaus/sub-agent-permission-inheritance": "0.2.4",
-    "@crewhaus/tool-builder": "0.2.4",
-    "@crewhaus/tool-catalog": "0.2.4",
+    "@crewhaus/agent-context-isolation": "0.3.1",
+    "@crewhaus/errors": "0.3.1",
+    "@crewhaus/sub-agent-permission-inheritance": "0.3.1",
+    "@crewhaus/tool-builder": "0.3.1",
+    "@crewhaus/tool-catalog": "0.3.1",
     "yaml": "^2.6.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@crewhaus/event-log": "0.2.4",
-    "@crewhaus/permission-engine": "0.2.4",
-    "@crewhaus/run-context": "0.2.4"
+    "@crewhaus/event-log": "0.3.1",
+    "@crewhaus/permission-engine": "0.3.1",
+    "@crewhaus/run-context": "0.3.1"
   },
   "license": "Apache-2.0",
   "author": {