@geminixiang/mikan 1.0.0-beta.51 → 1.0.0-beta.53

package/dist/adapters/slack/update-diagnostics.d.ts

@@ -0,0 +1,14 @@
+import type { KnownBlock } from "@slack/types";
+/** Best-effort telemetry: must not mask an API error or fail a successful update. */
+export declare function recordSlackUpdate(owner: object, target: {
+    channel: string;
+    ts: string;
+}, source: string, payload: {
+    text: string;
+    blocks: KnownBlock[];
+}, outcome: {
+    error: unknown;
+} | {
+    success: true;
+}): void;
+//# sourceMappingURL=update-diagnostics.d.ts.map

package/dist/adapters/slack/update-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/update-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqG/C,qFAAqF;AACrF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,EAC/C,OAAO,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAC9C,IAAI,CAmDN"}

package/dist/adapters/slack/update-diagnostics.js

@@ -0,0 +1,150 @@
+import * as Sentry from "@sentry/node";
+// Diagnostic correlation only: eviction never changes transport behavior.
+const pending = new WeakMap();
+const MAX_PENDING = 128;
+const RETENTION_MS = 10 * 60_000;
+const ERROR_CODES = new Set([
+    "block_mismatch",
+    "invalid_blocks",
+    "msg_too_long",
+    "ratelimited",
+    "rate_limited",
+]);
+const BLOCK_TYPES = new Set([
+    "markdown",
+    "table",
+    "section",
+    "context",
+    "divider",
+    "actions",
+    "rich_text",
+]);
+function record(value) {
+    return value !== null && typeof value === "object" ? value : {};
+}
+function syntax(source) {
+    const trimmed = source.trimStart();
+    const fences = source.split("\n").filter((line) => /^\s*(`{3,}|~{3,})/.test(line));
+    return {
+        leadingConstruct: /^(?:`{3,}|~{3,})/.test(trimmed)
+            ? "fence"
+            : trimmed.startsWith("|")
+                ? "table_like"
+                : /^#{1,6}(?:\s|$)/.test(trimmed)
+                    ? "heading"
+                    : /^[*_-]/.test(trimmed)
+                        ? "list_or_emphasis"
+                        : /^[[<]/.test(trimmed)
+                            ? "link_like"
+                            : "other",
+        fenceLineCount: fences.length,
+        fenceWithWorkingSuffix: fences.some((line) => /^\s*(?:`{3,}|~{3,}) +\.\.\.\s*$/.test(line)),
+    };
+}
+function shape(source, payload) {
+    return {
+        sourceLength: source.length,
+        fallbackLength: payload.text.length,
+        blockCount: payload.blocks.length,
+        ...syntax(source),
+        // Flat arrays survive the existing Sentry depth limit. No text or identifiers.
+        blockTypes: payload.blocks
+            .slice(0, 50)
+            .map((block) => (BLOCK_TYPES.has(block.type) ? block.type : "other")),
+        markdownLengths: payload.blocks
+            .filter((block) => block.type === "markdown")
+            .slice(0, 50)
+            .map((block) => block.text.length),
+        tableRows: payload.blocks
+            .filter((block) => block.type === "table")
+            .slice(0, 50)
+            .map((block) => block.rows.length),
+        tableMaxColumns: payload.blocks
+            .filter((block) => block.type === "table")
+            .slice(0, 50)
+            .map((block) => Math.max(0, ...block.rows.map((row) => row.length))),
+    };
+}
+function validation(error) {
+    const data = record(record(error).data);
+    const messages = record(data.response_metadata).messages;
+    const details = Array.isArray(messages)
+        ? messages.slice(0, 10).filter((item) => typeof item === "string")
+        : [];
+    return {
+        errorCode: typeof data.error === "string" && ERROR_CODES.has(data.error) ? data.error : "other",
+        validationCount: Array.isArray(messages) ? messages.length : 0,
+        // Never copy a free-form Slack validation message: it can quote user content.
+        validationCategories: details.map((message) => /must be less than|maximum|too long/i.test(message)
+            ? "limit"
+            : /missing|required/i.test(message)
+                ? "required"
+                : /invalid|unsupported|not allowed/i.test(message)
+                    ? "invalid"
+                    : "other"),
+        blockIndices: details
+            .flatMap((message) => [...message.matchAll(/\/blocks\/(\d{1,3})(?=\/|\]|\s|$)/g)]
+            .slice(0, 10)
+            .map((match) => Number(match[1])))
+            .slice(0, 10),
+    };
+}
+/** Best-effort telemetry: must not mask an API error or fail a successful update. */
+export function recordSlackUpdate(owner, target, source, payload, outcome) {
+    try {
+        const { channel, ts } = target;
+        const now = Date.now();
+        let failures = pending.get(owner);
+        if (failures)
+            for (const [key, value] of failures) {
+                if (now - value.at >= RETENTION_MS)
+                    failures.delete(key);
+            }
+        const key = `${channel}:${ts}`;
+        const previous = failures?.get(key);
+        if ("success" in outcome && !previous)
+            return;
+        const attempts = (previous?.attempts ?? 0) + ("error" in outcome ? 1 : 0);
+        if ("error" in outcome) {
+            if (!failures) {
+                failures = new Map();
+                pending.set(owner, failures);
+            }
+            failures.delete(key);
+            failures.set(key, { at: now, attempts });
+            if (failures.size > MAX_PENDING)
+                failures.delete(failures.keys().next().value);
+        }
+        else {
+            failures?.delete(key);
+        }
+        if ("success" in outcome) {
+            // Successful runs may emit no later error event to retain breadcrumbs.
+            Sentry.logger.info("Slack update recovered", {
+                channelId: channel,
+                responseMessageId: ts,
+                failedAttempts: attempts,
+                sourceLength: source.length,
+                blockCount: payload.blocks.length,
+                ...syntax(source),
+            });
+        }
+        Sentry.addBreadcrumb({
+            category: "slack.update",
+            level: "error" in outcome ? "warning" : "info",
+            message: "error" in outcome ? "Slack update rejected" : "Slack update recovered",
+            data: {
+                operation: "chat.update",
+                channelId: channel,
+                responseMessageId: ts,
+                failedAttempts: attempts,
+                ...shape(source, payload),
+                ...("error" in outcome ? validation(outcome.error) : {}),
+            },
+        });
+    }
+    catch {
+        // Observability must never change delivery or retry semantics.
+    }
+}
+//# sourceMappingURL=update-diagnostics.js.map

package/dist/adapters/slack/update-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-diagnostics.js","sourceRoot":"","sources":["../../../src/adapters/slack/update-diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Sentry from \"@sentry/node\";\nimport type { KnownBlock } from \"@slack/types\";\n\n// Diagnostic correlation only: eviction never changes transport behavior.\nconst pending = new WeakMap<object, Map<string, { at: number; attempts: number }>>();\nconst MAX_PENDING = 128;\nconst RETENTION_MS = 10 * 60_000;\nconst ERROR_CODES = new Set([\n  \"block_mismatch\",\n  \"invalid_blocks\",\n  \"msg_too_long\",\n  \"ratelimited\",\n  \"rate_limited\",\n]);\nconst BLOCK_TYPES = new Set([\n  \"markdown\",\n  \"table\",\n  \"section\",\n  \"context\",\n  \"divider\",\n  \"actions\",\n  \"rich_text\",\n]);\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === \"object\" ? (value as Record<string, unknown>) : {};\n}\n\nfunction syntax(source: string) {\n  const trimmed = source.trimStart();\n  const fences = source.split(\"\\n\").filter((line) => /^\\s*(`{3,}|~{3,})/.test(line));\n  return {\n    leadingConstruct: /^(?:`{3,}|~{3,})/.test(trimmed)\n      ? \"fence\"\n      : trimmed.startsWith(\"|\")\n        ? \"table_like\"\n        : /^#{1,6}(?:\\s|$)/.test(trimmed)\n          ? \"heading\"\n          : /^[*_-]/.test(trimmed)\n            ? \"list_or_emphasis\"\n            : /^[[<]/.test(trimmed)\n              ? \"link_like\"\n              : \"other\",\n    fenceLineCount: fences.length,\n    fenceWithWorkingSuffix: fences.some((line) => /^\\s*(?:`{3,}|~{3,}) +\\.\\.\\.\\s*$/.test(line)),\n  };\n}\n\nfunction shape(source: string, payload: { text: string; blocks: KnownBlock[] }) {\n  return {\n    sourceLength: source.length,\n    fallbackLength: payload.text.length,\n    blockCount: payload.blocks.length,\n    ...syntax(source),\n    // Flat arrays survive the existing Sentry depth limit. No text or identifiers.\n    blockTypes: payload.blocks\n      .slice(0, 50)\n      .map((block) => (BLOCK_TYPES.has(block.type) ? block.type : \"other\")),\n    markdownLengths: payload.blocks\n      .filter((block) => block.type === \"markdown\")\n      .slice(0, 50)\n      .map((block) => block.text.length),\n    tableRows: payload.blocks\n      .filter((block) => block.type === \"table\")\n      .slice(0, 50)\n      .map((block) => block.rows.length),\n    tableMaxColumns: payload.blocks\n      .filter((block) => block.type === \"table\")\n      .slice(0, 50)\n      .map((block) => Math.max(0, ...block.rows.map((row) => row.length))),\n  };\n}\n\nfunction validation(error: unknown) {\n  const data = record(record(error).data);\n  const messages = record(data.response_metadata).messages;\n  const details = Array.isArray(messages)\n    ? messages.slice(0, 10).filter((item): item is string => typeof item === \"string\")\n    : [];\n  return {\n    errorCode: typeof data.error === \"string\" && ERROR_CODES.has(data.error) ? data.error : \"other\",\n    validationCount: Array.isArray(messages) ? messages.length : 0,\n    // Never copy a free-form Slack validation message: it can quote user content.\n    validationCategories: details.map((message) =>\n      /must be less than|maximum|too long/i.test(message)\n        ? \"limit\"\n        : /missing|required/i.test(message)\n          ? \"required\"\n          : /invalid|unsupported|not allowed/i.test(message)\n            ? \"invalid\"\n            : \"other\",\n    ),\n    blockIndices: details\n      .flatMap((message) =>\n        [...message.matchAll(/\\/blocks\\/(\\d{1,3})(?=\\/|\\]|\\s|$)/g)]\n          .slice(0, 10)\n          .map((match) => Number(match[1])),\n      )\n      .slice(0, 10),\n  };\n}\n\n/** Best-effort telemetry: must not mask an API error or fail a successful update. */\nexport function recordSlackUpdate(\n  owner: object,\n  target: { channel: string; ts: string },\n  source: string,\n  payload: { text: string; blocks: KnownBlock[] },\n  outcome: { error: unknown } | { success: true },\n): void {\n  try {\n    const { channel, ts } = target;\n    const now = Date.now();\n    let failures = pending.get(owner);\n    if (failures)\n      for (const [key, value] of failures) {\n        if (now - value.at >= RETENTION_MS) failures.delete(key);\n      }\n    const key = `${channel}:${ts}`;\n    const previous = failures?.get(key);\n    if (\"success\" in outcome && !previous) return;\n    const attempts = (previous?.attempts ?? 0) + (\"error\" in outcome ? 1 : 0);\n    if (\"error\" in outcome) {\n      if (!failures) {\n        failures = new Map();\n        pending.set(owner, failures);\n      }\n      failures.delete(key);\n      failures.set(key, { at: now, attempts });\n      if (failures.size > MAX_PENDING) failures.delete(failures.keys().next().value!);\n    } else {\n      failures?.delete(key);\n    }\n    if (\"success\" in outcome) {\n      // Successful runs may emit no later error event to retain breadcrumbs.\n      Sentry.logger.info(\"Slack update recovered\", {\n        channelId: channel,\n        responseMessageId: ts,\n        failedAttempts: attempts,\n        sourceLength: source.length,\n        blockCount: payload.blocks.length,\n        ...syntax(source),\n      });\n    }\n    Sentry.addBreadcrumb({\n      category: \"slack.update\",\n      level: \"error\" in outcome ? \"warning\" : \"info\",\n      message: \"error\" in outcome ? \"Slack update rejected\" : \"Slack update recovered\",\n      data: {\n        operation: \"chat.update\",\n        channelId: channel,\n        responseMessageId: ts,\n        failedAttempts: attempts,\n        ...shape(source, payload),\n        ...(\"error\" in outcome ? validation(outcome.error) : {}),\n      },\n    });\n  } catch {\n    // Observability must never change delivery or retry semantics.\n  }\n}\n"]}

package/dist/harness/subagent-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-profiles.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,0BAA0B,EAI3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAkRxF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B,CAiCrF"}
+{"version":3,"file":"subagent-profiles.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,0BAA0B,EAI3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AA8PxF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B,CAiCrF"}

package/dist/harness/subagent-profiles.js

@@ -20,10 +20,6 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join } from "node:path";
 import { parseFrontmatter } from "./skills.js";
-// Built-ins carry no requiredTools. The check is a per-task evidence demand
-// ("prove you actually inspected X") that only the caller can judge; as a
-// profile default it fails every task that legitimately needs a subset of the
-// granted tools, discarding a finished answer after the budget is spent.
 const BUILTIN_PROFILES = [
     {
         name: "worker",
@@ -36,7 +32,6 @@ const BUILTIN_PROFILES = [
             "Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.",
         ].join("\n"),
         tools: ["read", "bash", "edit", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 30,
         maxTokens: 100_000,
@@ -52,7 +47,6 @@ const BUILTIN_PROFILES = [
             "Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.",
         ].join("\n"),
         tools: ["read", "bash", "edit", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 35,
         maxTokens: 100_000,
@@ -68,7 +62,6 @@ const BUILTIN_PROFILES = [
             "Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.",
         ].join("\n"),
         tools: ["read", "bash", "edit", "write", "event", "sandbox"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 40,
         maxTokens: 100_000,
@@ -84,7 +77,6 @@ const BUILTIN_PROFILES = [
             "Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.",
         ].join("\n"),
         tools: ["read", "bash", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 35,
         maxTokens: 100_000,
@@ -100,7 +92,6 @@ const BUILTIN_PROFILES = [
             "Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.",
         ].join("\n"),
         tools: ["read", "bash", "write", "event"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 30,
         maxTokens: 100_000,
@@ -116,7 +107,6 @@ const BUILTIN_PROFILES = [
             "Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.",
         ].join("\n"),
         tools: ["read", "bash", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 30,
         maxTokens: 100_000,
@@ -132,7 +122,6 @@ const BUILTIN_PROFILES = [
             "Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.",
         ].join("\n"),
         tools: ["read", "bash", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 40,
         maxTokens: 100_000,
@@ -148,7 +137,6 @@ const BUILTIN_PROFILES = [
             "Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.",
         ].join("\n"),
         tools: ["read", "bash", "write"],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 35,
         maxTokens: 100_000,
@@ -162,7 +150,6 @@ const BUILTIN_PROFILES = [
             "Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details.",
         ].join("\n"),
         tools: [],
-        requiredTools: [],
         thinkingLevel: "high",
         maxTurns: 20,
         maxTokens: 100_000,
@@ -231,7 +218,6 @@ function parseProfilePatch(filePath, base) {
     const patch = {};
     applyField(patch, values, "description", "description", (value) => value.trim());
     applyField(patch, values, "tools", "tools", csv);
-    applyField(patch, values, "required_tools", "requiredTools", csv);
     applyField(patch, values, "model", "model", parseModel);
     applyField(patch, values, "thinking", "thinkingLevel", parseThinking);
     applyField(patch, values, "max_turns", "maxTurns", (v) => parsePositiveInteger(v, "max_turns"));
@@ -252,12 +238,7 @@ function parseProfilePatch(filePath, base) {
         description: patch.description || base?.description || name,
         systemPrompt,
         tools: patch.tools ?? base?.tools ?? [],
-        requiredTools: patch.requiredTools ?? base?.requiredTools ?? [],
     };
-    const ungranted = merged.requiredTools.filter((tool) => !merged.tools.includes(tool));
-    if (ungranted.length > 0) {
-        throw new Error(`required_tools must be included in tools: ${ungranted.join(", ")}`);
-    }
     return merged;
 }
 /**

package/dist/harness/subagent-profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-profiles.js","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,gBAAgB,GAAsB;IAC1C;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4EAA4E;QACzF,YAAY,EAAE;YACZ,sFAAsF;YACtF,EAAE;YACF,maAAma;YACna,EAAE;YACF,8KAA8K;SAC/K,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACxC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,sFAAsF;QACxF,YAAY,EAAE;YACZ,gFAAgF;YAChF,EAAE;YACF,iaAAia;YACja,EAAE;YACF,6QAA6Q;SAC9Q,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACxC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mFAAmF;QACrF,YAAY,EAAE;YACZ,4GAA4G;YAC5G,EAAE;YACF,+cAA+c;YAC/c,EAAE;YACF,sMAAsM;SACvM,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;QAC5D,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mFAAmF;QACrF,YAAY,EAAE;YACZ,2FAA2F;YAC3F,EAAE;YACF,kcAAkc;YAClc,EAAE;YACF,mLAAmL;SACpL,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,oFAAoF;YACpF,EAAE;YACF,kdAAkd;YACld,EAAE;YACF,4NAA4N;SAC7N,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,+FAA+F;YAC/F,EAAE;YACF,maAAma;YACna,EAAE;YACF,mNAAmN;SACpN,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,gFAAgF;QAC7F,YAAY,EAAE;YACZ,gFAAgF;YAChF,EAAE;YACF,wdAAwd;YACxd,EAAE;YACF,sPAAsP;SACvP,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,kGAAkG;YAClG,EAAE;YACF,udAAud;YACvd,EAAE;YACF,mQAAmQ;SACpQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qEAAqE;QAClF,YAAY,EAAE;YACZ,sFAAsF;YACtF,EAAE;YACF,wQAAwQ;SACzQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,EAAE;QACT,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAgB;IAC7C,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,+EAA+E;AAC/E,SAAS,GAAG,CAAC,KAAa;IACxB,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO;QACL,GAAG,IAAI,GAAG,CACR,KAAK;aACF,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC,CACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAsB,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa,EAAE,KAAa;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gCAAgC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CACjB,KAA+B,EAC/B,MAA8B,EAC9B,GAAW,EACX,KAAQ,EACR,KAA4C;IAE5C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,IAAiC;IAC5E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;IAClE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACxD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IACtE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CACzD,oBAAoB,CAAC,CAAC,EAAE,YAAY,CAAC,CACtC,CAAC;IACF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5D,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAC1C,CAAC;IACF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAClE,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAC3C,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,YAAY,CAAC;IACvD,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,GAAG,IAAI;QACP,GAAG,KAAK;QACR,IAAI;QACJ,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,WAAW,IAAI,IAAI;QAC3D,YAAY;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE;QACvC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI,EAAE,aAAa,IAAI,EAAE;KAChE,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,WAAW,GAAgC,EAAE,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEvD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACvF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Subagent profiles: the curated capability sets a subagent may be launched\n * with.\n *\n * Profiles exist because the two halves of a subagent definition have\n * different owners. What a profile *does* — its tools, required evidence,\n * prompt and budget — is portable, so it ships as a built-in below and is\n * versioned with the code. Which model runs it is per-installation, so it is\n * overridden by `<workspaceDir>/agents/<name>.md`.\n *\n * A workspace file therefore *patches* the built-in of the same name rather\n * than replacing it: overriding only `model:` must not force an operator to\n * restate the tools and prompt, because a restated copy silently drifts from\n * the built-in it was cloned from. A file whose name matches no built-in\n * defines a new profile and must supply `tools` itself.\n *\n * A malformed file is reported as a diagnostic and skipped, never thrown:\n * these are hand-edited, and one typo must not take the whole workspace down.\n */\nimport { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type {\n  LoadSubagentProfilesResult,\n  SubagentModelSpec,\n  SubagentProfile,\n  SubagentProfileDiagnostic,\n} from \"./types.js\";\n\nexport type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from \"./types.js\";\nimport { parseFrontmatter } from \"./skills.js\";\n\n// Built-ins carry no requiredTools. The check is a per-task evidence demand\n// (\"prove you actually inspected X\") that only the caller can judge; as a\n// profile default it fails every task that legitimately needs a subset of the\n// granted tools, discarding a finished answer after the budget is spent.\nconst BUILTIN_PROFILES: SubagentProfile[] = [\n  {\n    name: \"worker\",\n    description: \"Completes a bounded general-purpose task without adding domain assumptions\",\n    systemPrompt: [\n      \"You are a general-purpose worker responsible for one clearly bounded delegated task.\",\n      \"\",\n      \"Use `read` and `bash` to inspect the actual workspace state, and use `edit` or `write` only when the assignment requires changes. Follow applicable skill instructions, preserve behavior outside the stated scope, and do not invent requirements or broaden the task. Verify concrete outputs before reporting success; if the assignment lacks information or a required capability, state the limitation instead of guessing.\",\n      \"\",\n      \"Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"software-engineer\",\n    description:\n      \"Owns software investigation, implementation, integration, and technical verification\",\n    systemPrompt: [\n      \"You are the software engineer responsible for one delegated technical outcome.\",\n      \"\",\n      \"Apply the relevant engineering and vendor skill instructions. Use `bash` to inspect repositories, run development tools, diagnose browser or integration behavior, and make only changes explicitly included in the assignment. Trace failures to their technical cause, preserve existing contracts outside scope, and verify work with the narrowest meaningful checks. Do not treat plausible output as evidence of success.\",\n      \"\",\n      \"Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"devops-engineer\",\n    description:\n      \"Owns cloud access, environments, deployments, and production workflow reliability\",\n    systemPrompt: [\n      \"You are the DevOps engineer responsible for one delegated infrastructure or production-operations outcome.\",\n      \"\",\n      \"Apply the relevant setup, GCP, repository-access, service-status, and production workflow skill instructions. Use `bash` to inspect current state before acting. Respect the named project, environment, principal, and resource scope; protect credentials; prefer least privilege; and check idempotency before writes, retries, or provisioning. Do not broaden access or repeat a non-idempotent operation without explicit authorization and evidence that it is needed.\",\n      \"\",\n      \"Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"event\", \"sandbox\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"data-scientist\",\n    description:\n      \"Owns metric definition, data analysis, reconciliation, and defensible conclusions\",\n    systemPrompt: [\n      \"You are the data scientist responsible for answering one delegated quantitative question.\",\n      \"\",\n      \"Apply the relevant Metabase, GAM, accounting, billing, reporting, and parser skill instructions. Use `bash` to run the prescribed queries and analysis tools. Establish the time range, timezone, filters, dimensions, population, and metric definitions before interpreting results. Reconcile totals and cross-check consequential figures when practical. Separate source values, derived calculations, and inference; never fill missing data with guesses.\",\n      \"\",\n      \"Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"account-manager\",\n    description:\n      \"Owns existing-client onboarding, account coordination, and delivery follow-through\",\n    systemPrompt: [\n      \"You are the account manager responsible for one delegated existing-client outcome.\",\n      \"\",\n      \"Apply the relevant onboarding, publisher account, slot, workspace, meeting, and communication skill instructions. Use `bash` to inspect the current customer and account state before acting. Preserve supplied commercial and technical requirements, coordinate dependencies, avoid duplicate account changes, and clearly distinguish completed work from items awaiting another owner. Do not invent customer approval or make an external commitment beyond the assignment.\",\n      \"\",\n      \"Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"event\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"business-development\",\n    description:\n      \"Owns prospect research, qualification, contact discovery, and outreach preparation\",\n    systemPrompt: [\n      \"You are the business development specialist responsible for one delegated growth opportunity.\",\n      \"\",\n      \"Apply the relevant prospecting, website sampling, contact-finding, email-validation, and client-approach skill instructions. Use `bash` to gather and verify public evidence. Evaluate fit against the supplied criteria, distinguish verified contacts from inferred ones, and preserve source URLs. Do not contact prospects, submit forms, or represent that outreach occurred unless the assignment explicitly authorizes it.\",\n      \"\",\n      \"Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"creative-producer\",\n    description: \"Owns media deliverables from creative brief through verified production output\",\n    systemPrompt: [\n      \"You are the creative producer responsible for one delegated media deliverable.\",\n      \"\",\n      \"Apply the relevant source acquisition, storyboard, video, image, speech, lipsync, and generation-provider skill instructions. Use `bash` to run the prescribed production tools. Confirm the brief, audience, format, dimensions, duration, language, and source inputs; use discovery commands rather than guessing provider or model identifiers. Preserve provenance and generation parameters, and verify that claimed outputs exist and match the requested technical properties.\",\n      \"\",\n      \"Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"ad-operations-specialist\",\n    description:\n      \"Owns ad serving setup, delivery diagnostics, policy checks, and operational health\",\n    systemPrompt: [\n      \"You are the ad operations specialist responsible for one delegated advertising-delivery outcome.\",\n      \"\",\n      \"Apply the relevant GAM, ads.txt, player detection, targeting, behavior, monitoring, and policy skill instructions. Use `bash` to run the prescribed browser and reporting tools. Establish the site, account, slot, time window, geography, device, and consent conditions; distinguish configuration, eligibility, request, impression, and playback evidence. Reproduce dynamic behavior when practical, and do not change live serving configuration unless explicitly authorized.\",\n      \"\",\n      \"Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"analysis-only\",\n    description: \"Analyzes supplied task input without claiming external verification\",\n    systemPrompt: [\n      \"You analyze only the task text and structured dependency input supplied to this run.\",\n      \"\",\n      \"Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details.\",\n    ].join(\"\\n\"),\n    tools: [],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 20,\n    maxTokens: 100_000,\n  },\n];\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\n/** Parse a comma-separated tool list. The literal `none` is an empty grant. */\nfunction csv(value: string): string[] {\n  if (value.trim() === \"none\") return [];\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((item) => item.trim())\n        .filter(Boolean),\n    ),\n  ];\n}\n\nfunction parseModel(value: string): SubagentModelSpec {\n  const separator = value.indexOf(\"/\");\n  if (separator <= 0 || separator === value.length - 1) {\n    throw new Error(`model must be provider/id, got ${value}`);\n  }\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\n}\n\nfunction parseThinking(value: string): ThinkingLevel {\n  if (!THINKING_LEVELS.has(value as ThinkingLevel)) {\n    throw new Error(`unknown thinking level: ${value}`);\n  }\n  return value as ThinkingLevel;\n}\n\nfunction parsePositiveInteger(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`${field} must be a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseNonNegativeNumber(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new Error(`${field} must be a non-negative number`);\n  }\n  return parsed;\n}\n\n/** Apply `field` from frontmatter onto `patch` only when the file sets it. */\nfunction applyField<K extends keyof SubagentProfile>(\n  patch: Partial<SubagentProfile>,\n  values: Record<string, string>,\n  key: string,\n  field: K,\n  parse: (value: string) => SubagentProfile[K],\n): void {\n  const raw = values[key];\n  if (raw === undefined) return;\n  patch[field] = parse(raw);\n}\n\n/**\n * Build the overlay a single file contributes. Throws with a human-readable\n * message on malformed input; the caller turns that into a diagnostic.\n */\nfunction parseProfilePatch(filePath: string, base: SubagentProfile | undefined): SubagentProfile {\n  const { values, body } = parseFrontmatter(readFileSync(filePath, \"utf-8\"));\n  const name = basename(filePath, \".md\");\n  const patch: Partial<SubagentProfile> = {};\n\n  applyField(patch, values, \"description\", \"description\", (value) => value.trim());\n  applyField(patch, values, \"tools\", \"tools\", csv);\n  applyField(patch, values, \"required_tools\", \"requiredTools\", csv);\n  applyField(patch, values, \"model\", \"model\", parseModel);\n  applyField(patch, values, \"thinking\", \"thinkingLevel\", parseThinking);\n  applyField(patch, values, \"max_turns\", \"maxTurns\", (v) => parsePositiveInteger(v, \"max_turns\"));\n  applyField(patch, values, \"max_tokens\", \"maxTokens\", (v) =>\n    parsePositiveInteger(v, \"max_tokens\"),\n  );\n  applyField(patch, values, \"max_cost_usd\", \"maxCostUsd\", (v) =>\n    parseNonNegativeNumber(v, \"max_cost_usd\"),\n  );\n  applyField(patch, values, \"max_duration_ms\", \"maxDurationMs\", (v) =>\n    parsePositiveInteger(v, \"max_duration_ms\"),\n  );\n\n  const systemPrompt = body.trim() || base?.systemPrompt;\n  if (!base && patch.tools === undefined) {\n    throw new Error(`tools is required for a new profile (no built-in named ${name})`);\n  }\n  if (!systemPrompt) {\n    throw new Error(`a new profile needs prompt text in the file body`);\n  }\n\n  const merged: SubagentProfile = {\n    ...base,\n    ...patch,\n    name,\n    description: patch.description || base?.description || name,\n    systemPrompt,\n    tools: patch.tools ?? base?.tools ?? [],\n    requiredTools: patch.requiredTools ?? base?.requiredTools ?? [],\n  };\n\n  const ungranted = merged.requiredTools.filter((tool) => !merged.tools.includes(tool));\n  if (ungranted.length > 0) {\n    throw new Error(`required_tools must be included in tools: ${ungranted.join(\", \")}`);\n  }\n  return merged;\n}\n\n/**\n * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.\n * Malformed files are reported and skipped, leaving the built-in in place.\n */\nexport function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult {\n  const dir = join(workspaceDir, \"agents\");\n  const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));\n  const diagnostics: SubagentProfileDiagnostic[] = [];\n  if (!existsSync(dir)) return { profiles, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : String(error),\n      path: dir,\n    });\n    return { profiles, diagnostics };\n  }\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n    const filePath = join(dir, entry.name);\n    try {\n      const profile = parseProfilePatch(filePath, profiles.get(basename(entry.name, \".md\")));\n      profiles.set(profile.name, profile);\n    } catch (error) {\n      diagnostics.push({\n        type: \"warning\",\n        message: error instanceof Error ? error.message : String(error),\n        path: filePath,\n      });\n    }\n  }\n  return { profiles, diagnostics };\n}\n"]}
+{"version":3,"file":"subagent-profiles.js","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,gBAAgB,GAAsB;IAC1C;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4EAA4E;QACzF,YAAY,EAAE;YACZ,sFAAsF;YACtF,EAAE;YACF,maAAma;YACna,EAAE;YACF,8KAA8K;SAC/K,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACxC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,sFAAsF;QACxF,YAAY,EAAE;YACZ,gFAAgF;YAChF,EAAE;YACF,iaAAia;YACja,EAAE;YACF,6QAA6Q;SAC9Q,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACxC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mFAAmF;QACrF,YAAY,EAAE;YACZ,4GAA4G;YAC5G,EAAE;YACF,+cAA+c;YAC/c,EAAE;YACF,sMAAsM;SACvM,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;QAC5D,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mFAAmF;QACrF,YAAY,EAAE;YACZ,2FAA2F;YAC3F,EAAE;YACF,kcAAkc;YAClc,EAAE;YACF,mLAAmL;SACpL,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,oFAAoF;YACpF,EAAE;YACF,kdAAkd;YACld,EAAE;YACF,4NAA4N;SAC7N,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,+FAA+F;YAC/F,EAAE;YACF,maAAma;YACna,EAAE;YACF,mNAAmN;SACpN,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,gFAAgF;QAC7F,YAAY,EAAE;YACZ,gFAAgF;YAChF,EAAE;YACF,wdAAwd;YACxd,EAAE;YACF,sPAAsP;SACvP,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,oFAAoF;QACtF,YAAY,EAAE;YACZ,kGAAkG;YAClG,EAAE;YACF,udAAud;YACvd,EAAE;YACF,mQAAmQ;SACpQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qEAAqE;QAClF,YAAY,EAAE;YACZ,sFAAsF;YACtF,EAAE;YACF,wQAAwQ;SACzQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,EAAE;QACT,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,OAAO;KACnB;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAgB;IAC7C,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,+EAA+E;AAC/E,SAAS,GAAG,CAAC,KAAa;IACxB,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO;QACL,GAAG,IAAI,GAAG,CACR,KAAK;aACF,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC,CACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAsB,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa,EAAE,KAAa;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gCAAgC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CACjB,KAA+B,EAC/B,MAA8B,EAC9B,GAAW,EACX,KAAQ,EACR,KAA4C;IAE5C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,IAAiC;IAC5E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACxD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IACtE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CACzD,oBAAoB,CAAC,CAAC,EAAE,YAAY,CAAC,CACtC,CAAC;IACF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5D,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAC1C,CAAC;IACF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAClE,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAC3C,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,YAAY,CAAC;IACvD,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,GAAG,IAAI;QACP,GAAG,KAAK;QACR,IAAI;QACJ,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,WAAW,IAAI,IAAI;QAC3D,YAAY;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE;KACxC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,WAAW,GAAgC,EAAE,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEvD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACvF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Subagent profiles: the curated capability sets a subagent may be launched\n * with.\n *\n * Profiles exist because the two halves of a subagent definition have\n * different owners. What a profile *does* — its tools, required evidence,\n * prompt and budget — is portable, so it ships as a built-in below and is\n * versioned with the code. Which model runs it is per-installation, so it is\n * overridden by `<workspaceDir>/agents/<name>.md`.\n *\n * A workspace file therefore *patches* the built-in of the same name rather\n * than replacing it: overriding only `model:` must not force an operator to\n * restate the tools and prompt, because a restated copy silently drifts from\n * the built-in it was cloned from. A file whose name matches no built-in\n * defines a new profile and must supply `tools` itself.\n *\n * A malformed file is reported as a diagnostic and skipped, never thrown:\n * these are hand-edited, and one typo must not take the whole workspace down.\n */\nimport { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type {\n  LoadSubagentProfilesResult,\n  SubagentModelSpec,\n  SubagentProfile,\n  SubagentProfileDiagnostic,\n} from \"./types.js\";\n\nexport type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from \"./types.js\";\nimport { parseFrontmatter } from \"./skills.js\";\n\nconst BUILTIN_PROFILES: SubagentProfile[] = [\n  {\n    name: \"worker\",\n    description: \"Completes a bounded general-purpose task without adding domain assumptions\",\n    systemPrompt: [\n      \"You are a general-purpose worker responsible for one clearly bounded delegated task.\",\n      \"\",\n      \"Use `read` and `bash` to inspect the actual workspace state, and use `edit` or `write` only when the assignment requires changes. Follow applicable skill instructions, preserve behavior outside the stated scope, and do not invent requirements or broaden the task. Verify concrete outputs before reporting success; if the assignment lacks information or a required capability, state the limitation instead of guessing.\",\n      \"\",\n      \"Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"software-engineer\",\n    description:\n      \"Owns software investigation, implementation, integration, and technical verification\",\n    systemPrompt: [\n      \"You are the software engineer responsible for one delegated technical outcome.\",\n      \"\",\n      \"Apply the relevant engineering and vendor skill instructions. Use `bash` to inspect repositories, run development tools, diagnose browser or integration behavior, and make only changes explicitly included in the assignment. Trace failures to their technical cause, preserve existing contracts outside scope, and verify work with the narrowest meaningful checks. Do not treat plausible output as evidence of success.\",\n      \"\",\n      \"Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"devops-engineer\",\n    description:\n      \"Owns cloud access, environments, deployments, and production workflow reliability\",\n    systemPrompt: [\n      \"You are the DevOps engineer responsible for one delegated infrastructure or production-operations outcome.\",\n      \"\",\n      \"Apply the relevant setup, GCP, repository-access, service-status, and production workflow skill instructions. Use `bash` to inspect current state before acting. Respect the named project, environment, principal, and resource scope; protect credentials; prefer least privilege; and check idempotency before writes, retries, or provisioning. Do not broaden access or repeat a non-idempotent operation without explicit authorization and evidence that it is needed.\",\n      \"\",\n      \"Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"event\", \"sandbox\"],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"data-scientist\",\n    description:\n      \"Owns metric definition, data analysis, reconciliation, and defensible conclusions\",\n    systemPrompt: [\n      \"You are the data scientist responsible for answering one delegated quantitative question.\",\n      \"\",\n      \"Apply the relevant Metabase, GAM, accounting, billing, reporting, and parser skill instructions. Use `bash` to run the prescribed queries and analysis tools. Establish the time range, timezone, filters, dimensions, population, and metric definitions before interpreting results. Reconcile totals and cross-check consequential figures when practical. Separate source values, derived calculations, and inference; never fill missing data with guesses.\",\n      \"\",\n      \"Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"account-manager\",\n    description:\n      \"Owns existing-client onboarding, account coordination, and delivery follow-through\",\n    systemPrompt: [\n      \"You are the account manager responsible for one delegated existing-client outcome.\",\n      \"\",\n      \"Apply the relevant onboarding, publisher account, slot, workspace, meeting, and communication skill instructions. Use `bash` to inspect the current customer and account state before acting. Preserve supplied commercial and technical requirements, coordinate dependencies, avoid duplicate account changes, and clearly distinguish completed work from items awaiting another owner. Do not invent customer approval or make an external commitment beyond the assignment.\",\n      \"\",\n      \"Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"event\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"business-development\",\n    description:\n      \"Owns prospect research, qualification, contact discovery, and outreach preparation\",\n    systemPrompt: [\n      \"You are the business development specialist responsible for one delegated growth opportunity.\",\n      \"\",\n      \"Apply the relevant prospecting, website sampling, contact-finding, email-validation, and client-approach skill instructions. Use `bash` to gather and verify public evidence. Evaluate fit against the supplied criteria, distinguish verified contacts from inferred ones, and preserve source URLs. Do not contact prospects, submit forms, or represent that outreach occurred unless the assignment explicitly authorizes it.\",\n      \"\",\n      \"Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"creative-producer\",\n    description: \"Owns media deliverables from creative brief through verified production output\",\n    systemPrompt: [\n      \"You are the creative producer responsible for one delegated media deliverable.\",\n      \"\",\n      \"Apply the relevant source acquisition, storyboard, video, image, speech, lipsync, and generation-provider skill instructions. Use `bash` to run the prescribed production tools. Confirm the brief, audience, format, dimensions, duration, language, and source inputs; use discovery commands rather than guessing provider or model identifiers. Preserve provenance and generation parameters, and verify that claimed outputs exist and match the requested technical properties.\",\n      \"\",\n      \"Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"ad-operations-specialist\",\n    description:\n      \"Owns ad serving setup, delivery diagnostics, policy checks, and operational health\",\n    systemPrompt: [\n      \"You are the ad operations specialist responsible for one delegated advertising-delivery outcome.\",\n      \"\",\n      \"Apply the relevant GAM, ads.txt, player detection, targeting, behavior, monitoring, and policy skill instructions. Use `bash` to run the prescribed browser and reporting tools. Establish the site, account, slot, time window, geography, device, and consent conditions; distinguish configuration, eligibility, request, impression, and playback evidence. Reproduce dynamic behavior when practical, and do not change live serving configuration unless explicitly authorized.\",\n      \"\",\n      \"Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"analysis-only\",\n    description: \"Analyzes supplied task input without claiming external verification\",\n    systemPrompt: [\n      \"You analyze only the task text and structured dependency input supplied to this run.\",\n      \"\",\n      \"Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details.\",\n    ].join(\"\\n\"),\n    tools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 20,\n    maxTokens: 100_000,\n  },\n];\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\n/** Parse a comma-separated tool list. The literal `none` is an empty grant. */\nfunction csv(value: string): string[] {\n  if (value.trim() === \"none\") return [];\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((item) => item.trim())\n        .filter(Boolean),\n    ),\n  ];\n}\n\nfunction parseModel(value: string): SubagentModelSpec {\n  const separator = value.indexOf(\"/\");\n  if (separator <= 0 || separator === value.length - 1) {\n    throw new Error(`model must be provider/id, got ${value}`);\n  }\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\n}\n\nfunction parseThinking(value: string): ThinkingLevel {\n  if (!THINKING_LEVELS.has(value as ThinkingLevel)) {\n    throw new Error(`unknown thinking level: ${value}`);\n  }\n  return value as ThinkingLevel;\n}\n\nfunction parsePositiveInteger(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`${field} must be a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseNonNegativeNumber(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new Error(`${field} must be a non-negative number`);\n  }\n  return parsed;\n}\n\n/** Apply `field` from frontmatter onto `patch` only when the file sets it. */\nfunction applyField<K extends keyof SubagentProfile>(\n  patch: Partial<SubagentProfile>,\n  values: Record<string, string>,\n  key: string,\n  field: K,\n  parse: (value: string) => SubagentProfile[K],\n): void {\n  const raw = values[key];\n  if (raw === undefined) return;\n  patch[field] = parse(raw);\n}\n\n/**\n * Build the overlay a single file contributes. Throws with a human-readable\n * message on malformed input; the caller turns that into a diagnostic.\n */\nfunction parseProfilePatch(filePath: string, base: SubagentProfile | undefined): SubagentProfile {\n  const { values, body } = parseFrontmatter(readFileSync(filePath, \"utf-8\"));\n  const name = basename(filePath, \".md\");\n  const patch: Partial<SubagentProfile> = {};\n\n  applyField(patch, values, \"description\", \"description\", (value) => value.trim());\n  applyField(patch, values, \"tools\", \"tools\", csv);\n  applyField(patch, values, \"model\", \"model\", parseModel);\n  applyField(patch, values, \"thinking\", \"thinkingLevel\", parseThinking);\n  applyField(patch, values, \"max_turns\", \"maxTurns\", (v) => parsePositiveInteger(v, \"max_turns\"));\n  applyField(patch, values, \"max_tokens\", \"maxTokens\", (v) =>\n    parsePositiveInteger(v, \"max_tokens\"),\n  );\n  applyField(patch, values, \"max_cost_usd\", \"maxCostUsd\", (v) =>\n    parseNonNegativeNumber(v, \"max_cost_usd\"),\n  );\n  applyField(patch, values, \"max_duration_ms\", \"maxDurationMs\", (v) =>\n    parsePositiveInteger(v, \"max_duration_ms\"),\n  );\n\n  const systemPrompt = body.trim() || base?.systemPrompt;\n  if (!base && patch.tools === undefined) {\n    throw new Error(`tools is required for a new profile (no built-in named ${name})`);\n  }\n  if (!systemPrompt) {\n    throw new Error(`a new profile needs prompt text in the file body`);\n  }\n\n  const merged: SubagentProfile = {\n    ...base,\n    ...patch,\n    name,\n    description: patch.description || base?.description || name,\n    systemPrompt,\n    tools: patch.tools ?? base?.tools ?? [],\n  };\n  return merged;\n}\n\n/**\n * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.\n * Malformed files are reported and skipped, leaving the built-in in place.\n */\nexport function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult {\n  const dir = join(workspaceDir, \"agents\");\n  const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));\n  const diagnostics: SubagentProfileDiagnostic[] = [];\n  if (!existsSync(dir)) return { profiles, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : String(error),\n      path: dir,\n    });\n    return { profiles, diagnostics };\n  }\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n    const filePath = join(dir, entry.name);\n    try {\n      const profile = parseProfilePatch(filePath, profiles.get(basename(entry.name, \".md\")));\n      profiles.set(profile.name, profile);\n    } catch (error) {\n      diagnostics.push({\n        type: \"warning\",\n        message: error instanceof Error ? error.message : String(error),\n        path: filePath,\n      });\n    }\n  }\n  return { profiles, diagnostics };\n}\n"]}

package/dist/harness/subagent-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-runner.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAe,KAAK,GAAG,EAAyB,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK/E,eAAO,MAAM,uBAAuB;aAClC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,EAAE;aACd,aAAa;CACL,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAuG3C,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAyQD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAc9D"}
+{"version":3,"file":"subagent-runner.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAe,KAAK,GAAG,EAAyB,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK/E,eAAO,MAAM,uBAAuB;aAClC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,EAAE;aACd,aAAa;CACL,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAuG3C,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkPD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAc9D"}

package/dist/harness/subagent-runner.js

@@ -206,28 +206,6 @@ function selectTools(requested, available) {
     }
     return selected;
 }
-/**
- * Wrap a tool so the run can prove it was actually reached. Fields are listed
- * explicitly rather than spread: `AgentTool` is a plain interface, and a
- * structural copy would silently drop anything added to it later.
- */
-function witnessToolUse(tool, invoked) {
-    return {
-        name: tool.name,
-        label: tool.label,
-        description: tool.description,
-        parameters: tool.parameters,
-        ...(tool.constrainedSampling !== undefined
-            ? { constrainedSampling: tool.constrainedSampling }
-            : {}),
-        ...(tool.prepareArguments ? { prepareArguments: tool.prepareArguments.bind(tool) } : {}),
-        ...(tool.executionMode ? { executionMode: tool.executionMode } : {}),
-        execute: (...args) => {
-            invoked.add(tool.name);
-            return tool.execute(...args);
-        },
-    };
-}
 function formatTask(task, input, parentContext) {
     const trimmed = task.trim();
     if (!trimmed)
@@ -468,9 +446,6 @@ function resolveProfile(request, options) {
         ...request,
         systemPrompt: profile.systemPrompt,
         tools: profile.tools,
-        // The guard above allows requiredTools to combine with a profile, so the
-        // caller's evidence requirements must survive alongside the profile's.
-        requiredTools: [...new Set([...(request.requiredTools ?? []), ...profile.requiredTools])],
         ...(profile.model ? { model: profile.model } : {}),
         ...(profile.thinkingLevel ? { thinkingLevel: profile.thinkingLevel } : {}),
         ...(Object.keys(budget).length > 0 ? { budget } : {}),
@@ -480,18 +455,13 @@ function prepareSubagentRun(options, request, runId, startedAt) {
     const model = request.model
         ? options.models.resolve(request.model.provider, request.model.id)
         : options.defaultModel;
-    const invokedTools = new Set();
     const granted = selectTools(request.tools, options.availableTools);
-    const missingRequiredTools = (request.requiredTools ?? []).filter((name) => !granted.some((tool) => tool.name === name));
-    if (missingRequiredTools.length > 0) {
-        throw new Error(`Required subagent tools were not granted: ${missingRequiredTools.join(", ")}`);
-    }
     const task = formatTask(request.task, request.input, normalizedParentContext(request, options.parentMessages));
     const session = new MikanAgentSession({
         systemPrompt: buildSystemPrompt(request.systemPrompt, request.outputSchema, granted.map((tool) => tool.name)),
         model,
         thinkingLevel: request.thinkingLevel ?? options.thinkingLevel,
-        tools: granted.map((tool) => witnessToolUse(tool, invokedTools)),
+        tools: granted,
         models: options.models,
         sessionStore: SessionStore.inMemory(options.workspaceDir),
         settings: { compaction: { enabled: false } },
@@ -505,12 +475,11 @@ function prepareSubagentRun(options, request, runId, startedAt) {
         modelSpec: { provider: model.provider, id: model.id },
         session,
         budget: resolveBudget(request.budget),
-        invokedTools,
         task,
     };
 }
 function buildSubagentResult(run, terminalSignal, cleanupPending = false) {
-    const { session, request, invokedTools, budget } = run;
+    const { session, request, budget } = run;
     const stats = session.getLastRunStats();
     const assistant = finalAssistant(session.messages);
     const text = assistant ? contentText(assistant.content, "") : "";
@@ -531,14 +500,6 @@ function buildSubagentResult(run, terminalSignal, cleanupPending = false) {
     if (stats.budgetExceededReason) {
         return { ...base, status: "budget_exceeded", error: stats.budgetExceededReason };
     }
-    const unusedRequiredTools = (request.requiredTools ?? []).filter((name) => !invokedTools.has(name));
-    if (unusedRequiredTools.length > 0) {
-        return {
-            ...base,
-            status: "failed",
-            error: `Required tool not used: ${unusedRequiredTools.join(", ")}`,
-        };
-    }
     if (assistant?.stopReason === "error") {
         return { ...base, status: "failed", error: assistant.errorMessage || "Subagent failed" };
     }