@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/task-intent.js

@@ -0,0 +1,154 @@
+// @ts-nocheck
+/**
+ * Shared task mutation-intent classifier.
+ *
+ * Single authority for reading a task's wording, answering two different
+ * questions from one prohibition analysis:
+ *
+ * - `classifyTaskMutationIntent` / `expectsImplementationMutation`: does the
+ *   task REQUIRE file changes? Consumed by the completion mutation guard,
+ *   which blocks completion, so its vocabulary is deliberately narrow.
+ * - `taskMayMutate`: COULD the task plausibly change files? Consumed by
+ *   acceptance level inference, which only raises evidence gates, so its
+ *   vocabulary is deliberately broad (any bare write verb).
+ *
+ * Explicit read-only wording ("do not modify", "review only") is a task-level
+ * intent only when no write imperative survives outside those phrases. A task
+ * like "Do not modify tests; implement the fix" is an implementation task with
+ * a scoped constraint, not a read-only task.
+ */
+const REVIEW_ONLY_PATTERNS = [
+    /\breview only\b/i,
+    /\bsuggest fixes only\b/i,
+    /\bonly return findings\b/i,
+    /\breturn findings only\b/i,
+];
+const REVIEWER_REQUIRED_EDIT_PATTERNS = [
+    /\bmust\s+(?:edit|modify|change|fix|patch|apply)\b/i,
+    /\brequired\s+to\s+(?:edit|modify|change|fix|patch|apply)\b/i,
+    /\bregardless\s+of\s+findings\b/i,
+    /\balways\s+(?:edit|modify|change|fix|patch|apply)\b/i,
+    /\bapply\s+(?:the\s+)?fix(?:es)?\s+directly\b/i,
+    /\bmake\s+(?:the\s+)?code\s+changes\b/i,
+];
+// The prohibition's object ends at punctuation or at a coordinating word
+// (but/and/then), so a follow-on clause like "but implement the fix" stays in
+// the text for write-intent testing instead of being swallowed as the object.
+const NO_EDIT_PROHIBITION_PATTERN = /\b(?:do not|don't|must not)\s+(?:edit|modify|write(?:\s+to)?|touch|change)\b((?:(?!\b(?:but|and|then)\b)[^.;,:!?\n–—-])*)/gi;
+/** Objects of a no-edit prohibition that mean "the codebase in general" rather than a named scope. */
+const GENERIC_PROHIBITION_OBJECT = /^\s*(?:(?:any|all|the|these|those|your|our|existing|project|source|sources|repo|repository)[\s/,-]*)*(?:files?|code|codebase|sources?|anything|repo(?:sitory)?)?\s*$/i;
+const SCOPED_NO_EDIT_CONSTRAINT_PATTERNS = [
+    /\bdo not edit files?\s+outside\b/i,
+    /\bdo not edit\s+outside\b/i,
+    /\bdo not edit\s+unrelated files?\b/i,
+    /\bdo not change\s+unrelated files?\b/i,
+    /\bdo not modify\s+unrelated files?\b/i,
+];
+const NO_TOOL_INTENT_PATTERNS = [
+    /\bno tools? needed\b/i,
+    /\bno tools? required\b/i,
+    /\bwithout using tools\b/i,
+    /\bdo not use tools\b/i,
+    /\bdon't use tools\b/i,
+];
+const READ_ONLY_DELIVERABLE_PATTERNS = [
+    /\b(?:draft|write|compose|prepare|produce)\s+(?:(?:a|an|the)\s+)?(?:github\s+)?(?:issue|bug report|issue draft|issue body|proposal|plan|report|summary|findings?|analysis|recommendations?)\b/i,
+    /\b(?:issue|bug report)\s+(?:draft|body|template)\b/i,
+    /\b(?:return|provide|produce)\s+(?:text|markdown|answer|findings?|recommendations?)\s+only\b/i,
+];
+const RESEARCH_AGENT_PATTERNS = [
+    /\binvestigate\b/i,
+    /\bscout\b/i,
+    /\bresearch(?:er)?\b/i,
+];
+const FIX_OR_PATCH_IMPLEMENTATION_PATTERN = /\b(?:fix|patch)\s+(?:(?:it|this|that|them|each|any|all|these|those)\b|(?:(?:a|an|the|any|all)\s+)?(?:(?:failing|failed|broken|flaky|red|cold|start|current|existing|reported|approved|known|regression|unit|integration|e2e|source|typescript|type-?script|ts|type-?check|compiler)\s+)*(?:bug|defect|issues?|problems?|failures?|regressions?|tests?|errors?|items?|typos?|code|source|implementation|component|function|module|class|method|logic|file|files|readme|docs?|changelog|package\.json|config|manifest|extension|prompt|command|lint(?:ing)?|build|ci|type-?check|type\s+checking)\b)/i;
+const WORKER_IMPLEMENTATION_PATTERNS = [
+    /\b(?:implement|edit|modify|refactor|delete)\b/i,
+    FIX_OR_PATCH_IMPLEMENTATION_PATTERN,
+    /\b(?:update|add|remove|replace|create)\b(?!\s+(?:(?:a|an|the)\s+)?(?:report|summary|findings?)(?:\b|$))/i,
+    /\bapply\s+(?:the\s+)?(?:(?:suggested|proposed|recommended)\s+)?(?:changes?|fix(?:es)?|patch)\b/i,
+    /\bmake\s+(?:the\s+)?changes\b/i,
+    /\bdo those fixes\b/i,
+];
+const GENERAL_IMPLEMENTATION_PATTERNS = [
+    /\b(?:implement|edit|modify|refactor)\b/i,
+    FIX_OR_PATCH_IMPLEMENTATION_PATTERN,
+    /\bapply\s+(?:the\s+)?(?:(?:suggested|proposed|recommended)\s+)?(?:changes?|fix(?:es)?|patch)\b/i,
+    /\bmake\s+(?:the\s+)?changes\b/i,
+    /\bdo those fixes\b/i,
+    /\b(?:update|add|remove|replace|delete|create)\s+(?:the\s+)?(?:file|files|code|source|implementation|test|tests|component|function|module|class|method|logic|import|imports|readme|docs?|changelog|package\.json|config|manifest|extension|prompt|command)\b/i,
+];
+function stripFrameworkInstructions(task) {
+    return task
+        .split("\n")
+        .filter((line) => !/^\s*\[(?:Write to|Read from):/i.test(line))
+        .filter((line) => !/^\s*(?:Create and maintain progress at:|Update progress at:|\*\*Output:\*\*|Write your findings to(?: exactly this path)?:|Return the complete artifact in your final response\.|The runtime will persist it to exactly this path:|Do not call contact_supervisor merely because no write-capable tool is available\.|This path is authoritative for this run\.|Ignore any other output filename or output path mentioned elsewhere)/i.test(line))
+        .join("\n");
+}
+function stripPatterns(task, patterns) {
+    let stripped = task;
+    for (const pattern of patterns) {
+        const flags = pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`;
+        stripped = stripped.replace(new RegExp(pattern.source, flags), " ");
+    }
+    return stripped;
+}
+function analyzeNoEditProhibitions(taskText) {
+    let present = REVIEW_ONLY_PATTERNS.some((pattern) => pattern.test(taskText))
+        || NO_TOOL_INTENT_PATTERNS.some((pattern) => pattern.test(taskText));
+    let blanket = present;
+    let strippedText = stripPatterns(taskText, [...REVIEW_ONLY_PATTERNS, ...NO_TOOL_INTENT_PATTERNS]);
+    strippedText = strippedText.replace(new RegExp(NO_EDIT_PROHIBITION_PATTERN.source, NO_EDIT_PROHIBITION_PATTERN.flags), (_match, object) => {
+        present = true;
+        if (GENERIC_PROHIBITION_OBJECT.test(object))
+            blanket = true;
+        return " ";
+    });
+    return { present, blanket, strippedText };
+}
+function taskHasReadOnlyDeliverable(taskText) {
+    return READ_ONLY_DELIVERABLE_PATTERNS.some((pattern) => pattern.test(taskText));
+}
+function hasImplementationIntent(agent, taskText) {
+    if (/\breviewer\b/i.test(agent))
+        return REVIEWER_REQUIRED_EDIT_PATTERNS.some((pattern) => pattern.test(taskText));
+    if (agent === "worker")
+        return WORKER_IMPLEMENTATION_PATTERNS.some((pattern) => pattern.test(taskText));
+    return GENERAL_IMPLEMENTATION_PATTERNS.some((pattern) => pattern.test(taskText));
+}
+export function classifyTaskMutationIntent(agent, task) {
+    const taskText = stripFrameworkInstructions(task);
+    const taskTextWithoutScopedConstraints = stripPatterns(taskText, SCOPED_NO_EDIT_CONSTRAINT_PATTERNS);
+    const prohibitions = analyzeNoEditProhibitions(taskTextWithoutScopedConstraints);
+    if (prohibitions.present) {
+        if (prohibitions.blanket)
+            return { kind: "read-only" };
+        return hasImplementationIntent(agent, prohibitions.strippedText) ? { kind: "implementation" } : { kind: "read-only" };
+    }
+    if (RESEARCH_AGENT_PATTERNS.some((pattern) => pattern.test(agent)))
+        return { kind: "read-only" };
+    if (hasImplementationIntent(agent, taskText))
+        return { kind: "implementation" };
+    if (/\breviewer\b/i.test(agent))
+        return { kind: "read-only" };
+    return taskHasReadOnlyDeliverable(taskTextWithoutScopedConstraints) ? { kind: "read-only" } : { kind: "unknown" };
+}
+export function expectsImplementationMutation(agent, task) {
+    return classifyTaskMutationIntent(agent, task).kind === "implementation";
+}
+/** Bare write verbs that make a task write-capable for acceptance inference. */
+const MAY_MUTATE_VERB_PATTERN = /\b(?:fix|implement|update|write|edit|modify|migrate|delete|remove|refactor|commit)\b/i;
+/**
+ * Whether the task could plausibly change files. Blanket prohibitions win;
+ * write verbs inside a scoped prohibition's object or a read-only deliverable
+ * phrase ("write a summary report") do not count; any other bare write verb
+ * does.
+ */
+export function taskMayMutate(task) {
+    const taskText = stripPatterns(stripFrameworkInstructions(task), SCOPED_NO_EDIT_CONSTRAINT_PATTERNS);
+    const prohibitions = analyzeNoEditProhibitions(taskText);
+    if (prohibitions.blanket)
+        return false;
+    return MAY_MUTATE_VERB_PATTERN.test(stripPatterns(prohibitions.strippedText, READ_ONLY_DELIVERABLE_PATTERNS));
+}
+//# sourceMappingURL=task-intent.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/task-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-intent.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/task-intent.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,oBAAoB,GAAG;IAC5B,kBAAkB;IAClB,yBAAyB;IACzB,2BAA2B;IAC3B,2BAA2B;CAC3B,CAAC;AAEF,MAAM,+BAA+B,GAAG;IACvC,oDAAoD;IACpD,6DAA6D;IAC7D,iCAAiC;IACjC,sDAAsD;IACtD,+CAA+C;IAC/C,uCAAuC;CACvC,CAAC;AAEF,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,iIAA6H,CAAC;AAElK,sGAAsG;AACtG,MAAM,0BAA0B,GAAG,uKAAuK,CAAC;AAE3M,MAAM,kCAAkC,GAAG;IAC1C,mCAAmC;IACnC,4BAA4B;IAC5B,qCAAqC;IACrC,uCAAuC;IACvC,uCAAuC;CACvC,CAAC;AAEF,MAAM,uBAAuB,GAAG;IAC/B,uBAAuB;IACvB,yBAAyB;IACzB,0BAA0B;IAC1B,uBAAuB;IACvB,sBAAsB;CACtB,CAAC;AAEF,MAAM,8BAA8B,GAAG;IACtC,+LAA+L;IAC/L,qDAAqD;IACrD,8FAA8F;CAC9F,CAAC;AAEF,MAAM,uBAAuB,GAAG;IAC/B,kBAAkB;IAClB,YAAY;IACZ,sBAAsB;CACtB,CAAC;AAEF,MAAM,mCAAmC,GAAG,qkBAAqkB,CAAC;AAElnB,MAAM,8BAA8B,GAAG;IACtC,gDAAgD;IAChD,mCAAmC;IACnC,0GAA0G;IAC1G,iGAAiG;IACjG,gCAAgC;IAChC,qBAAqB;CACrB,CAAC;AAEF,MAAM,+BAA+B,GAAG;IACvC,yCAAyC;IACzC,mCAAmC;IACnC,iGAAiG;IACjG,gCAAgC;IAChC,qBAAqB;IACrB,8PAA8P;CAC9P,CAAC;AAIF,SAAS,0BAA0B,CAAC,IAAY,EAAU;IACzD,OAAO,IAAI;SACT,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC9D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,uaAAua,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACrc,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,QAAkB,EAAU;IAChE,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC;QAChF,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,QAAQ,CAAC;AAAA,CAChB;AAWD,SAAS,yBAAyB,CAAC,QAAgB,EAA6B;IAC/E,IAAI,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;WACxE,uBAAuB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC,GAAG,oBAAoB,EAAE,GAAG,uBAAuB,CAAC,CAAC,CAAC;IAClG,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,EAAE,CAAC;QAClJ,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,GAAG,IAAI,CAAC;QAC5D,OAAO,GAAG,CAAC;IAAA,CACX,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAAA,CAC1C;AAED,SAAS,0BAA0B,CAAC,QAAgB,EAAW;IAC9D,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAAA,CAChF;AAED,SAAS,uBAAuB,CAAC,KAAa,EAAE,QAAgB,EAAW;IAC1E,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClH,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxG,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAAA,CACjF;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAAE,IAAY,EAAsB;IAC3F,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,gCAAgC,GAAG,aAAa,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAC;IACrG,MAAM,YAAY,GAAG,yBAAyB,CAAC,gCAAgC,CAAC,CAAC;IACjF,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,YAAY,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACvD,OAAO,uBAAuB,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACvH,CAAC;IAED,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACjG,IAAI,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAChF,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9D,OAAO,0BAA0B,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAAA,CAClH;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa,EAAE,IAAY,EAAW;IACnF,OAAO,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC;AAAA,CACzE;AAED,gFAAgF;AAChF,MAAM,uBAAuB,GAAG,uFAAuF,CAAC;AAExH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAW;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAC;IACrG,MAAM,YAAY,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,YAAY,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,uBAAuB,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,YAAY,EAAE,8BAA8B,CAAC,CAAC,CAAC;AAAA,CAC9G","sourcesContent":["// @ts-nocheck\n/**\n * Shared task mutation-intent classifier.\n *\n * Single authority for reading a task's wording, answering two different\n * questions from one prohibition analysis:\n *\n * - `classifyTaskMutationIntent` / `expectsImplementationMutation`: does the\n *   task REQUIRE file changes? Consumed by the completion mutation guard,\n *   which blocks completion, so its vocabulary is deliberately narrow.\n * - `taskMayMutate`: COULD the task plausibly change files? Consumed by\n *   acceptance level inference, which only raises evidence gates, so its\n *   vocabulary is deliberately broad (any bare write verb).\n *\n * Explicit read-only wording (\"do not modify\", \"review only\") is a task-level\n * intent only when no write imperative survives outside those phrases. A task\n * like \"Do not modify tests; implement the fix\" is an implementation task with\n * a scoped constraint, not a read-only task.\n */\n\nconst REVIEW_ONLY_PATTERNS = [\n\t/\\breview only\\b/i,\n\t/\\bsuggest fixes only\\b/i,\n\t/\\bonly return findings\\b/i,\n\t/\\breturn findings only\\b/i,\n];\n\nconst REVIEWER_REQUIRED_EDIT_PATTERNS = [\n\t/\\bmust\\s+(?:edit|modify|change|fix|patch|apply)\\b/i,\n\t/\\brequired\\s+to\\s+(?:edit|modify|change|fix|patch|apply)\\b/i,\n\t/\\bregardless\\s+of\\s+findings\\b/i,\n\t/\\balways\\s+(?:edit|modify|change|fix|patch|apply)\\b/i,\n\t/\\bapply\\s+(?:the\\s+)?fix(?:es)?\\s+directly\\b/i,\n\t/\\bmake\\s+(?:the\\s+)?code\\s+changes\\b/i,\n];\n\n// The prohibition's object ends at punctuation or at a coordinating word\n// (but/and/then), so a follow-on clause like \"but implement the fix\" stays in\n// the text for write-intent testing instead of being swallowed as the object.\nconst NO_EDIT_PROHIBITION_PATTERN = /\\b(?:do not|don't|must not)\\s+(?:edit|modify|write(?:\\s+to)?|touch|change)\\b((?:(?!\\b(?:but|and|then)\\b)[^.;,:!?\\n–—-])*)/gi;\n\n/** Objects of a no-edit prohibition that mean \"the codebase in general\" rather than a named scope. */\nconst GENERIC_PROHIBITION_OBJECT = /^\\s*(?:(?:any|all|the|these|those|your|our|existing|project|source|sources|repo|repository)[\\s/,-]*)*(?:files?|code|codebase|sources?|anything|repo(?:sitory)?)?\\s*$/i;\n\nconst SCOPED_NO_EDIT_CONSTRAINT_PATTERNS = [\n\t/\\bdo not edit files?\\s+outside\\b/i,\n\t/\\bdo not edit\\s+outside\\b/i,\n\t/\\bdo not edit\\s+unrelated files?\\b/i,\n\t/\\bdo not change\\s+unrelated files?\\b/i,\n\t/\\bdo not modify\\s+unrelated files?\\b/i,\n];\n\nconst NO_TOOL_INTENT_PATTERNS = [\n\t/\\bno tools? needed\\b/i,\n\t/\\bno tools? required\\b/i,\n\t/\\bwithout using tools\\b/i,\n\t/\\bdo not use tools\\b/i,\n\t/\\bdon't use tools\\b/i,\n];\n\nconst READ_ONLY_DELIVERABLE_PATTERNS = [\n\t/\\b(?:draft|write|compose|prepare|produce)\\s+(?:(?:a|an|the)\\s+)?(?:github\\s+)?(?:issue|bug report|issue draft|issue body|proposal|plan|report|summary|findings?|analysis|recommendations?)\\b/i,\n\t/\\b(?:issue|bug report)\\s+(?:draft|body|template)\\b/i,\n\t/\\b(?:return|provide|produce)\\s+(?:text|markdown|answer|findings?|recommendations?)\\s+only\\b/i,\n];\n\nconst RESEARCH_AGENT_PATTERNS = [\n\t/\\binvestigate\\b/i,\n\t/\\bscout\\b/i,\n\t/\\bresearch(?:er)?\\b/i,\n];\n\nconst FIX_OR_PATCH_IMPLEMENTATION_PATTERN = /\\b(?:fix|patch)\\s+(?:(?:it|this|that|them|each|any|all|these|those)\\b|(?:(?:a|an|the|any|all)\\s+)?(?:(?:failing|failed|broken|flaky|red|cold|start|current|existing|reported|approved|known|regression|unit|integration|e2e|source|typescript|type-?script|ts|type-?check|compiler)\\s+)*(?:bug|defect|issues?|problems?|failures?|regressions?|tests?|errors?|items?|typos?|code|source|implementation|component|function|module|class|method|logic|file|files|readme|docs?|changelog|package\\.json|config|manifest|extension|prompt|command|lint(?:ing)?|build|ci|type-?check|type\\s+checking)\\b)/i;\n\nconst WORKER_IMPLEMENTATION_PATTERNS = [\n\t/\\b(?:implement|edit|modify|refactor|delete)\\b/i,\n\tFIX_OR_PATCH_IMPLEMENTATION_PATTERN,\n\t/\\b(?:update|add|remove|replace|create)\\b(?!\\s+(?:(?:a|an|the)\\s+)?(?:report|summary|findings?)(?:\\b|$))/i,\n\t/\\bapply\\s+(?:the\\s+)?(?:(?:suggested|proposed|recommended)\\s+)?(?:changes?|fix(?:es)?|patch)\\b/i,\n\t/\\bmake\\s+(?:the\\s+)?changes\\b/i,\n\t/\\bdo those fixes\\b/i,\n];\n\nconst GENERAL_IMPLEMENTATION_PATTERNS = [\n\t/\\b(?:implement|edit|modify|refactor)\\b/i,\n\tFIX_OR_PATCH_IMPLEMENTATION_PATTERN,\n\t/\\bapply\\s+(?:the\\s+)?(?:(?:suggested|proposed|recommended)\\s+)?(?:changes?|fix(?:es)?|patch)\\b/i,\n\t/\\bmake\\s+(?:the\\s+)?changes\\b/i,\n\t/\\bdo those fixes\\b/i,\n\t/\\b(?:update|add|remove|replace|delete|create)\\s+(?:the\\s+)?(?:file|files|code|source|implementation|test|tests|component|function|module|class|method|logic|import|imports|readme|docs?|changelog|package\\.json|config|manifest|extension|prompt|command)\\b/i,\n];\n\nexport type TaskMutationIntent = { kind: \"implementation\" } | { kind: \"read-only\" } | { kind: \"unknown\" };\n\nfunction stripFrameworkInstructions(task: string): string {\n\treturn task\n\t\t.split(\"\\n\")\n\t\t.filter((line) => !/^\\s*\\[(?:Write to|Read from):/i.test(line))\n\t\t.filter((line) => !/^\\s*(?:Create and maintain progress at:|Update progress at:|\\*\\*Output:\\*\\*|Write your findings to(?: exactly this path)?:|Return the complete artifact in your final response\\.|The runtime will persist it to exactly this path:|Do not call contact_supervisor merely because no write-capable tool is available\\.|This path is authoritative for this run\\.|Ignore any other output filename or output path mentioned elsewhere)/i.test(line))\n\t\t.join(\"\\n\");\n}\n\nfunction stripPatterns(task: string, patterns: RegExp[]): string {\n\tlet stripped = task;\n\tfor (const pattern of patterns) {\n\t\tconst flags = pattern.flags.includes(\"g\") ? pattern.flags : `${pattern.flags}g`;\n\t\tstripped = stripped.replace(new RegExp(pattern.source, flags), \" \");\n\t}\n\treturn stripped;\n}\n\ninterface NoEditProhibitionAnalysis {\n\t/** True when any prohibition (or review-only/no-tool wording) is present. */\n\tpresent: boolean;\n\t/** True when a prohibition covers files/code in general; such wording wins over write verbs. */\n\tblanket: boolean;\n\t/** Task text with prohibition phrases and their objects removed, for write-intent testing. */\n\tstrippedText: string;\n}\n\nfunction analyzeNoEditProhibitions(taskText: string): NoEditProhibitionAnalysis {\n\tlet present = REVIEW_ONLY_PATTERNS.some((pattern) => pattern.test(taskText))\n\t\t|| NO_TOOL_INTENT_PATTERNS.some((pattern) => pattern.test(taskText));\n\tlet blanket = present;\n\tlet strippedText = stripPatterns(taskText, [...REVIEW_ONLY_PATTERNS, ...NO_TOOL_INTENT_PATTERNS]);\n\tstrippedText = strippedText.replace(new RegExp(NO_EDIT_PROHIBITION_PATTERN.source, NO_EDIT_PROHIBITION_PATTERN.flags), (_match, object: string) => {\n\t\tpresent = true;\n\t\tif (GENERIC_PROHIBITION_OBJECT.test(object)) blanket = true;\n\t\treturn \" \";\n\t});\n\treturn { present, blanket, strippedText };\n}\n\nfunction taskHasReadOnlyDeliverable(taskText: string): boolean {\n\treturn READ_ONLY_DELIVERABLE_PATTERNS.some((pattern) => pattern.test(taskText));\n}\n\nfunction hasImplementationIntent(agent: string, taskText: string): boolean {\n\tif (/\\breviewer\\b/i.test(agent)) return REVIEWER_REQUIRED_EDIT_PATTERNS.some((pattern) => pattern.test(taskText));\n\tif (agent === \"worker\") return WORKER_IMPLEMENTATION_PATTERNS.some((pattern) => pattern.test(taskText));\n\treturn GENERAL_IMPLEMENTATION_PATTERNS.some((pattern) => pattern.test(taskText));\n}\n\nexport function classifyTaskMutationIntent(agent: string, task: string): TaskMutationIntent {\n\tconst taskText = stripFrameworkInstructions(task);\n\tconst taskTextWithoutScopedConstraints = stripPatterns(taskText, SCOPED_NO_EDIT_CONSTRAINT_PATTERNS);\n\tconst prohibitions = analyzeNoEditProhibitions(taskTextWithoutScopedConstraints);\n\tif (prohibitions.present) {\n\t\tif (prohibitions.blanket) return { kind: \"read-only\" };\n\t\treturn hasImplementationIntent(agent, prohibitions.strippedText) ? { kind: \"implementation\" } : { kind: \"read-only\" };\n\t}\n\n\tif (RESEARCH_AGENT_PATTERNS.some((pattern) => pattern.test(agent))) return { kind: \"read-only\" };\n\tif (hasImplementationIntent(agent, taskText)) return { kind: \"implementation\" };\n\tif (/\\breviewer\\b/i.test(agent)) return { kind: \"read-only\" };\n\treturn taskHasReadOnlyDeliverable(taskTextWithoutScopedConstraints) ? { kind: \"read-only\" } : { kind: \"unknown\" };\n}\n\nexport function expectsImplementationMutation(agent: string, task: string): boolean {\n\treturn classifyTaskMutationIntent(agent, task).kind === \"implementation\";\n}\n\n/** Bare write verbs that make a task write-capable for acceptance inference. */\nconst MAY_MUTATE_VERB_PATTERN = /\\b(?:fix|implement|update|write|edit|modify|migrate|delete|remove|refactor|commit)\\b/i;\n\n/**\n * Whether the task could plausibly change files. Blanket prohibitions win;\n * write verbs inside a scoped prohibition's object or a read-only deliverable\n * phrase (\"write a summary report\") do not count; any other bare write verb\n * does.\n */\nexport function taskMayMutate(task: string): boolean {\n\tconst taskText = stripPatterns(stripFrameworkInstructions(task), SCOPED_NO_EDIT_CONSTRAINT_PATTERNS);\n\tconst prohibitions = analyzeNoEditProhibitions(taskText);\n\tif (prohibitions.blanket) return false;\n\treturn MAY_MUTATE_VERB_PATTERN.test(stripPatterns(prohibitions.strippedText, READ_ONLY_DELIVERABLE_PATTERNS));\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.d.ts

@@ -0,0 +1,13 @@
+export declare const REQUIRED_CHILD_TOOLS_ENV = "PI_SUBAGENT_REQUIRED_TOOLS";
+export declare const CHILD_TOOL_DIAGNOSTIC_PATH_ENV = "PI_SUBAGENT_TOOL_DIAGNOSTIC_PATH";
+export interface ChildToolDiagnostic {
+    agent?: string;
+    required: string[];
+    available: string[];
+    missing: string[];
+}
+export declare function writeChildToolDiagnostic(filePath: string, required: string[], available: string[], agent?: string): ChildToolDiagnostic | undefined;
+export declare function readChildToolDiagnostic(filePath: string | undefined): ChildToolDiagnostic | undefined;
+export declare function formatChildToolDiagnostic(diagnostic: ChildToolDiagnostic): string;
+export declare function readChildToolDiagnosticError(filePath: string | undefined): string | undefined;
+//# sourceMappingURL=tool-availability.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AACrE,eAAO,MAAM,8BAA8B,qCAAqC,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,CAAC,EAAE,MAAM,GACZ,mBAAmB,GAAG,SAAS,CAYjC;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAarG;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAQjF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAO7F","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\nexport const REQUIRED_CHILD_TOOLS_ENV = \"PI_SUBAGENT_REQUIRED_TOOLS\";\nexport const CHILD_TOOL_DIAGNOSTIC_PATH_ENV = \"PI_SUBAGENT_TOOL_DIAGNOSTIC_PATH\";\n\nexport interface ChildToolDiagnostic {\n\tagent?: string;\n\trequired: string[];\n\tavailable: string[];\n\tmissing: string[];\n}\n\nexport function writeChildToolDiagnostic(\n\tfilePath: string,\n\trequired: string[],\n\tavailable: string[],\n\tagent?: string,\n): ChildToolDiagnostic | undefined {\n\tconst availableNames = new Set(available);\n\tconst missing = required.filter((name) => !availableNames.has(name));\n\tif (missing.length === 0) {\n\t\tfs.rmSync(filePath, { force: true });\n\t\treturn undefined;\n\t}\n\n\tconst diagnostic: ChildToolDiagnostic = { agent, required, available, missing };\n\tfs.mkdirSync(path.dirname(filePath), { recursive: true });\n\tfs.writeFileSync(filePath, JSON.stringify(diagnostic), { mode: 0o600 });\n\treturn diagnostic;\n}\n\nexport function readChildToolDiagnostic(filePath: string | undefined): ChildToolDiagnostic | undefined {\n\tif (!filePath || !fs.existsSync(filePath)) return undefined;\n\tconst parsed = JSON.parse(fs.readFileSync(filePath, \"utf-8\")) as Partial<ChildToolDiagnostic>;\n\tconst stringArray = (value: unknown): value is string[] => Array.isArray(value) && value.every((entry) => typeof entry === \"string\" && entry.length > 0);\n\tif (!stringArray(parsed.required) || !stringArray(parsed.available) || !stringArray(parsed.missing) || (parsed.agent !== undefined && typeof parsed.agent !== \"string\")) {\n\t\tthrow new Error(`Malformed child tool diagnostic at '${filePath}'.`);\n\t}\n\treturn {\n\t\t...(parsed.agent ? { agent: parsed.agent } : {}),\n\t\trequired: parsed.required,\n\t\tavailable: parsed.available,\n\t\tmissing: parsed.missing,\n\t};\n}\n\nexport function formatChildToolDiagnostic(diagnostic: ChildToolDiagnostic): string {\n\tconst subject = diagnostic.agent ? `Agent '${diagnostic.agent}'` : \"Subagent\";\n\treturn [\n\t\t`${subject} requested unavailable child tools: ${diagnostic.missing.join(\", \")}.`,\n\t\t\"The `tools` field is a strict allowlist; it does not load extension code.\",\n\t\t\"For extension tools, add the provider path to `subagentOnlyExtensions` (child-only), `extensions`, or as a path-like entry in `tools`, while keeping each registered tool name in `tools`.\",\n\t\t\"For MCP tools, verify the MCP adapter configuration and selected tool names. For builtin tools, verify the name against the installed Pi version.\",\n\t].join(\"\\n\");\n}\n\nexport function readChildToolDiagnosticError(filePath: string | undefined): string | undefined {\n\ttry {\n\t\tconst diagnostic = readChildToolDiagnostic(filePath);\n\t\treturn diagnostic ? formatChildToolDiagnostic(diagnostic) : undefined;\n\t} catch (error) {\n\t\treturn `Failed to read child tool availability diagnostic: ${error instanceof Error ? error.message : String(error)}`;\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.js

@@ -0,0 +1,51 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+export const REQUIRED_CHILD_TOOLS_ENV = "PI_SUBAGENT_REQUIRED_TOOLS";
+export const CHILD_TOOL_DIAGNOSTIC_PATH_ENV = "PI_SUBAGENT_TOOL_DIAGNOSTIC_PATH";
+export function writeChildToolDiagnostic(filePath, required, available, agent) {
+    const availableNames = new Set(available);
+    const missing = required.filter((name) => !availableNames.has(name));
+    if (missing.length === 0) {
+        fs.rmSync(filePath, { force: true });
+        return undefined;
+    }
+    const diagnostic = { agent, required, available, missing };
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(diagnostic), { mode: 0o600 });
+    return diagnostic;
+}
+export function readChildToolDiagnostic(filePath) {
+    if (!filePath || !fs.existsSync(filePath))
+        return undefined;
+    const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    const stringArray = (value) => Array.isArray(value) && value.every((entry) => typeof entry === "string" && entry.length > 0);
+    if (!stringArray(parsed.required) || !stringArray(parsed.available) || !stringArray(parsed.missing) || (parsed.agent !== undefined && typeof parsed.agent !== "string")) {
+        throw new Error(`Malformed child tool diagnostic at '${filePath}'.`);
+    }
+    return {
+        ...(parsed.agent ? { agent: parsed.agent } : {}),
+        required: parsed.required,
+        available: parsed.available,
+        missing: parsed.missing,
+    };
+}
+export function formatChildToolDiagnostic(diagnostic) {
+    const subject = diagnostic.agent ? `Agent '${diagnostic.agent}'` : "Subagent";
+    return [
+        `${subject} requested unavailable child tools: ${diagnostic.missing.join(", ")}.`,
+        "The `tools` field is a strict allowlist; it does not load extension code.",
+        "For extension tools, add the provider path to `subagentOnlyExtensions` (child-only), `extensions`, or as a path-like entry in `tools`, while keeping each registered tool name in `tools`.",
+        "For MCP tools, verify the MCP adapter configuration and selected tool names. For builtin tools, verify the name against the installed Pi version.",
+    ].join("\n");
+}
+export function readChildToolDiagnosticError(filePath) {
+    try {
+        const diagnostic = readChildToolDiagnostic(filePath);
+        return diagnostic ? formatChildToolDiagnostic(diagnostic) : undefined;
+    }
+    catch (error) {
+        return `Failed to read child tool availability diagnostic: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+//# sourceMappingURL=tool-availability.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/tool-availability.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\nexport const REQUIRED_CHILD_TOOLS_ENV = \"PI_SUBAGENT_REQUIRED_TOOLS\";\nexport const CHILD_TOOL_DIAGNOSTIC_PATH_ENV = \"PI_SUBAGENT_TOOL_DIAGNOSTIC_PATH\";\n\nexport interface ChildToolDiagnostic {\n\tagent?: string;\n\trequired: string[];\n\tavailable: string[];\n\tmissing: string[];\n}\n\nexport function writeChildToolDiagnostic(\n\tfilePath: string,\n\trequired: string[],\n\tavailable: string[],\n\tagent?: string,\n): ChildToolDiagnostic | undefined {\n\tconst availableNames = new Set(available);\n\tconst missing = required.filter((name) => !availableNames.has(name));\n\tif (missing.length === 0) {\n\t\tfs.rmSync(filePath, { force: true });\n\t\treturn undefined;\n\t}\n\n\tconst diagnostic: ChildToolDiagnostic = { agent, required, available, missing };\n\tfs.mkdirSync(path.dirname(filePath), { recursive: true });\n\tfs.writeFileSync(filePath, JSON.stringify(diagnostic), { mode: 0o600 });\n\treturn diagnostic;\n}\n\nexport function readChildToolDiagnostic(filePath: string | undefined): ChildToolDiagnostic | undefined {\n\tif (!filePath || !fs.existsSync(filePath)) return undefined;\n\tconst parsed = JSON.parse(fs.readFileSync(filePath, \"utf-8\")) as Partial<ChildToolDiagnostic>;\n\tconst stringArray = (value: unknown): value is string[] => Array.isArray(value) && value.every((entry) => typeof entry === \"string\" && entry.length > 0);\n\tif (!stringArray(parsed.required) || !stringArray(parsed.available) || !stringArray(parsed.missing) || (parsed.agent !== undefined && typeof parsed.agent !== \"string\")) {\n\t\tthrow new Error(`Malformed child tool diagnostic at '${filePath}'.`);\n\t}\n\treturn {\n\t\t...(parsed.agent ? { agent: parsed.agent } : {}),\n\t\trequired: parsed.required,\n\t\tavailable: parsed.available,\n\t\tmissing: parsed.missing,\n\t};\n}\n\nexport function formatChildToolDiagnostic(diagnostic: ChildToolDiagnostic): string {\n\tconst subject = diagnostic.agent ? `Agent '${diagnostic.agent}'` : \"Subagent\";\n\treturn [\n\t\t`${subject} requested unavailable child tools: ${diagnostic.missing.join(\", \")}.`,\n\t\t\"The `tools` field is a strict allowlist; it does not load extension code.\",\n\t\t\"For extension tools, add the provider path to `subagentOnlyExtensions` (child-only), `extensions`, or as a path-like entry in `tools`, while keeping each registered tool name in `tools`.\",\n\t\t\"For MCP tools, verify the MCP adapter configuration and selected tool names. For builtin tools, verify the name against the installed Pi version.\",\n\t].join(\"\\n\");\n}\n\nexport function readChildToolDiagnosticError(filePath: string | undefined): string | undefined {\n\ttry {\n\t\tconst diagnostic = readChildToolDiagnostic(filePath);\n\t\treturn diagnostic ? formatChildToolDiagnostic(diagnostic) : undefined;\n\t} catch (error) {\n\t\treturn `Failed to read child tool availability diagnostic: ${error instanceof Error ? error.message : String(error)}`;\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.d.ts

@@ -0,0 +1,16 @@
+import type { ResolvedToolBudget, ToolBudgetConfig, ToolBudgetState } from "../../shared/types.ts";
+export declare const DEFAULT_TOOL_BUDGET_BLOCK: readonly ["read", "grep", "find", "ls"];
+export declare const TOOL_BUDGET_ENV = "PI_SUBAGENT_TOOL_BUDGET";
+export declare function normalizeToolBudgetBlock(block: ToolBudgetConfig["block"] | undefined): "*" | string[];
+export declare function validateToolBudgetConfig(raw: unknown, label?: string): {
+    budget?: ResolvedToolBudget;
+    error?: string;
+};
+export declare function initialToolBudgetState(budget: ResolvedToolBudget): ToolBudgetState;
+export declare function toolBudgetState(budget: ResolvedToolBudget, toolCount: number, blockedTool?: string): ToolBudgetState;
+export declare function shouldBlockToolForBudget(budget: ResolvedToolBudget, toolName: string, nextToolCount: number): boolean;
+export declare function toolBudgetSoftNudge(budget: ResolvedToolBudget, toolCount: number): string;
+export declare function toolBudgetBlockedMessage(budget: ResolvedToolBudget, toolName: string, toolCount: number): string;
+export declare function encodeToolBudgetEnv(budget: ResolvedToolBudget | undefined): string | undefined;
+export declare function decodeToolBudgetEnv(value: string | undefined): ResolvedToolBudget | undefined;
+//# sourceMappingURL=tool-budget.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-budget.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEnG,eAAO,MAAM,yBAAyB,yCAA0C,CAAC;AACjF,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,GAAG,GAAG,MAAM,EAAE,CAIrG;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,SAAe,GAAG;IAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqB5H;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAElF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAUpH;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAGrH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE9F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAM7F","sourcesContent":["// @ts-nocheck\nimport type { ResolvedToolBudget, ToolBudgetConfig, ToolBudgetState } from \"../../shared/types.ts\";\n\nexport const DEFAULT_TOOL_BUDGET_BLOCK = [\"read\", \"grep\", \"find\", \"ls\"] as const;\nexport const TOOL_BUDGET_ENV = \"PI_SUBAGENT_TOOL_BUDGET\";\n\nexport function normalizeToolBudgetBlock(block: ToolBudgetConfig[\"block\"] | undefined): \"*\" | string[] {\n\tif (block === \"*\") return \"*\";\n\tif (block === undefined) return [...DEFAULT_TOOL_BUDGET_BLOCK];\n\treturn [...new Set(block.map((tool) => tool.trim()).filter(Boolean))];\n}\n\nexport function validateToolBudgetConfig(raw: unknown, label = \"toolBudget\"): { budget?: ResolvedToolBudget; error?: string } {\n\tif (raw === undefined) return {};\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return { error: `${label} must be an object with hard and optional soft/block.` };\n\tconst value = raw as ToolBudgetConfig;\n\tif (typeof value.hard !== \"number\" || !Number.isInteger(value.hard) || value.hard < 1) {\n\t\treturn { error: `${label}.hard must be an integer >= 1.` };\n\t}\n\tif (value.soft !== undefined && (typeof value.soft !== \"number\" || !Number.isInteger(value.soft) || value.soft < 1)) {\n\t\treturn { error: `${label}.soft must be an integer >= 1 when provided.` };\n\t}\n\tif (value.soft !== undefined && value.soft > value.hard) {\n\t\treturn { error: `${label}.soft must be <= ${label}.hard.` };\n\t}\n\tif (value.block !== undefined && value.block !== \"*\") {\n\t\tif (!Array.isArray(value.block)) return { error: `${label}.block must be \"*\" or an array of tool names.` };\n\t\tif (value.block.length === 0) return { error: `${label}.block must contain at least one tool name.` };\n\t\tfor (const item of value.block) {\n\t\t\tif (typeof item !== \"string\" || !item.trim()) return { error: `${label}.block must contain non-empty tool names.` };\n\t\t}\n\t}\n\treturn { budget: { hard: value.hard, ...(value.soft !== undefined ? { soft: value.soft } : {}), block: normalizeToolBudgetBlock(value.block) } };\n}\n\nexport function initialToolBudgetState(budget: ResolvedToolBudget): ToolBudgetState {\n\treturn { ...budget, toolCount: 0, outcome: \"within-budget\" };\n}\n\nexport function toolBudgetState(budget: ResolvedToolBudget, toolCount: number, blockedTool?: string): ToolBudgetState {\n\tconst overHard = toolCount > budget.hard;\n\tconst overSoft = budget.soft !== undefined && toolCount >= budget.soft;\n\treturn {\n\t\t...budget,\n\t\ttoolCount,\n\t\toutcome: overHard ? \"hard-blocked\" : overSoft ? \"soft-reached\" : \"within-budget\",\n\t\t...(overSoft ? { softReachedAt: budget.soft } : {}),\n\t\t...(overHard ? { hardReachedAt: budget.hard, blockedTool } : {}),\n\t};\n}\n\nexport function shouldBlockToolForBudget(budget: ResolvedToolBudget, toolName: string, nextToolCount: number): boolean {\n\tif (nextToolCount <= budget.hard) return false;\n\treturn budget.block === \"*\" || budget.block.includes(toolName);\n}\n\nexport function toolBudgetSoftNudge(budget: ResolvedToolBudget, toolCount: number): string {\n\treturn `Tool budget soft limit reached after ${toolCount} tool call${toolCount === 1 ? \"\" : \"s\"} (soft ${budget.soft}, hard ${budget.hard}). Stop starting new browsing/search work and finalize from the context you already have.`;\n}\n\nexport function toolBudgetBlockedMessage(budget: ResolvedToolBudget, toolName: string, toolCount: number): string {\n\treturn `Tool budget hard limit reached after ${toolCount} tool call${toolCount === 1 ? \"\" : \"s\"} (hard ${budget.hard}). The '${toolName}' tool is blocked so you can finalize from the context you already have.`;\n}\n\nexport function encodeToolBudgetEnv(budget: ResolvedToolBudget | undefined): string | undefined {\n\treturn budget ? JSON.stringify(budget) : undefined;\n}\n\nexport function decodeToolBudgetEnv(value: string | undefined): ResolvedToolBudget | undefined {\n\tif (!value?.trim()) return undefined;\n\tconst parsed = JSON.parse(value) as unknown;\n\tconst normalized = validateToolBudgetConfig(parsed, TOOL_BUDGET_ENV);\n\tif (normalized.error) throw new Error(normalized.error);\n\treturn normalized.budget;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.js

@@ -0,0 +1,74 @@
+export const DEFAULT_TOOL_BUDGET_BLOCK = ["read", "grep", "find", "ls"];
+export const TOOL_BUDGET_ENV = "PI_SUBAGENT_TOOL_BUDGET";
+export function normalizeToolBudgetBlock(block) {
+    if (block === "*")
+        return "*";
+    if (block === undefined)
+        return [...DEFAULT_TOOL_BUDGET_BLOCK];
+    return [...new Set(block.map((tool) => tool.trim()).filter(Boolean))];
+}
+export function validateToolBudgetConfig(raw, label = "toolBudget") {
+    if (raw === undefined)
+        return {};
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return { error: `${label} must be an object with hard and optional soft/block.` };
+    const value = raw;
+    if (typeof value.hard !== "number" || !Number.isInteger(value.hard) || value.hard < 1) {
+        return { error: `${label}.hard must be an integer >= 1.` };
+    }
+    if (value.soft !== undefined && (typeof value.soft !== "number" || !Number.isInteger(value.soft) || value.soft < 1)) {
+        return { error: `${label}.soft must be an integer >= 1 when provided.` };
+    }
+    if (value.soft !== undefined && value.soft > value.hard) {
+        return { error: `${label}.soft must be <= ${label}.hard.` };
+    }
+    if (value.block !== undefined && value.block !== "*") {
+        if (!Array.isArray(value.block))
+            return { error: `${label}.block must be "*" or an array of tool names.` };
+        if (value.block.length === 0)
+            return { error: `${label}.block must contain at least one tool name.` };
+        for (const item of value.block) {
+            if (typeof item !== "string" || !item.trim())
+                return { error: `${label}.block must contain non-empty tool names.` };
+        }
+    }
+    return { budget: { hard: value.hard, ...(value.soft !== undefined ? { soft: value.soft } : {}), block: normalizeToolBudgetBlock(value.block) } };
+}
+export function initialToolBudgetState(budget) {
+    return { ...budget, toolCount: 0, outcome: "within-budget" };
+}
+export function toolBudgetState(budget, toolCount, blockedTool) {
+    const overHard = toolCount > budget.hard;
+    const overSoft = budget.soft !== undefined && toolCount >= budget.soft;
+    return {
+        ...budget,
+        toolCount,
+        outcome: overHard ? "hard-blocked" : overSoft ? "soft-reached" : "within-budget",
+        ...(overSoft ? { softReachedAt: budget.soft } : {}),
+        ...(overHard ? { hardReachedAt: budget.hard, blockedTool } : {}),
+    };
+}
+export function shouldBlockToolForBudget(budget, toolName, nextToolCount) {
+    if (nextToolCount <= budget.hard)
+        return false;
+    return budget.block === "*" || budget.block.includes(toolName);
+}
+export function toolBudgetSoftNudge(budget, toolCount) {
+    return `Tool budget soft limit reached after ${toolCount} tool call${toolCount === 1 ? "" : "s"} (soft ${budget.soft}, hard ${budget.hard}). Stop starting new browsing/search work and finalize from the context you already have.`;
+}
+export function toolBudgetBlockedMessage(budget, toolName, toolCount) {
+    return `Tool budget hard limit reached after ${toolCount} tool call${toolCount === 1 ? "" : "s"} (hard ${budget.hard}). The '${toolName}' tool is blocked so you can finalize from the context you already have.`;
+}
+export function encodeToolBudgetEnv(budget) {
+    return budget ? JSON.stringify(budget) : undefined;
+}
+export function decodeToolBudgetEnv(value) {
+    if (!value?.trim())
+        return undefined;
+    const parsed = JSON.parse(value);
+    const normalized = validateToolBudgetConfig(parsed, TOOL_BUDGET_ENV);
+    if (normalized.error)
+        throw new Error(normalized.error);
+    return normalized.budget;
+}
+//# sourceMappingURL=tool-budget.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-budget.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/tool-budget.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport type { ResolvedToolBudget, ToolBudgetConfig, ToolBudgetState } from \"../../shared/types.ts\";\n\nexport const DEFAULT_TOOL_BUDGET_BLOCK = [\"read\", \"grep\", \"find\", \"ls\"] as const;\nexport const TOOL_BUDGET_ENV = \"PI_SUBAGENT_TOOL_BUDGET\";\n\nexport function normalizeToolBudgetBlock(block: ToolBudgetConfig[\"block\"] | undefined): \"*\" | string[] {\n\tif (block === \"*\") return \"*\";\n\tif (block === undefined) return [...DEFAULT_TOOL_BUDGET_BLOCK];\n\treturn [...new Set(block.map((tool) => tool.trim()).filter(Boolean))];\n}\n\nexport function validateToolBudgetConfig(raw: unknown, label = \"toolBudget\"): { budget?: ResolvedToolBudget; error?: string } {\n\tif (raw === undefined) return {};\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return { error: `${label} must be an object with hard and optional soft/block.` };\n\tconst value = raw as ToolBudgetConfig;\n\tif (typeof value.hard !== \"number\" || !Number.isInteger(value.hard) || value.hard < 1) {\n\t\treturn { error: `${label}.hard must be an integer >= 1.` };\n\t}\n\tif (value.soft !== undefined && (typeof value.soft !== \"number\" || !Number.isInteger(value.soft) || value.soft < 1)) {\n\t\treturn { error: `${label}.soft must be an integer >= 1 when provided.` };\n\t}\n\tif (value.soft !== undefined && value.soft > value.hard) {\n\t\treturn { error: `${label}.soft must be <= ${label}.hard.` };\n\t}\n\tif (value.block !== undefined && value.block !== \"*\") {\n\t\tif (!Array.isArray(value.block)) return { error: `${label}.block must be \"*\" or an array of tool names.` };\n\t\tif (value.block.length === 0) return { error: `${label}.block must contain at least one tool name.` };\n\t\tfor (const item of value.block) {\n\t\t\tif (typeof item !== \"string\" || !item.trim()) return { error: `${label}.block must contain non-empty tool names.` };\n\t\t}\n\t}\n\treturn { budget: { hard: value.hard, ...(value.soft !== undefined ? { soft: value.soft } : {}), block: normalizeToolBudgetBlock(value.block) } };\n}\n\nexport function initialToolBudgetState(budget: ResolvedToolBudget): ToolBudgetState {\n\treturn { ...budget, toolCount: 0, outcome: \"within-budget\" };\n}\n\nexport function toolBudgetState(budget: ResolvedToolBudget, toolCount: number, blockedTool?: string): ToolBudgetState {\n\tconst overHard = toolCount > budget.hard;\n\tconst overSoft = budget.soft !== undefined && toolCount >= budget.soft;\n\treturn {\n\t\t...budget,\n\t\ttoolCount,\n\t\toutcome: overHard ? \"hard-blocked\" : overSoft ? \"soft-reached\" : \"within-budget\",\n\t\t...(overSoft ? { softReachedAt: budget.soft } : {}),\n\t\t...(overHard ? { hardReachedAt: budget.hard, blockedTool } : {}),\n\t};\n}\n\nexport function shouldBlockToolForBudget(budget: ResolvedToolBudget, toolName: string, nextToolCount: number): boolean {\n\tif (nextToolCount <= budget.hard) return false;\n\treturn budget.block === \"*\" || budget.block.includes(toolName);\n}\n\nexport function toolBudgetSoftNudge(budget: ResolvedToolBudget, toolCount: number): string {\n\treturn `Tool budget soft limit reached after ${toolCount} tool call${toolCount === 1 ? \"\" : \"s\"} (soft ${budget.soft}, hard ${budget.hard}). Stop starting new browsing/search work and finalize from the context you already have.`;\n}\n\nexport function toolBudgetBlockedMessage(budget: ResolvedToolBudget, toolName: string, toolCount: number): string {\n\treturn `Tool budget hard limit reached after ${toolCount} tool call${toolCount === 1 ? \"\" : \"s\"} (hard ${budget.hard}). The '${toolName}' tool is blocked so you can finalize from the context you already have.`;\n}\n\nexport function encodeToolBudgetEnv(budget: ResolvedToolBudget | undefined): string | undefined {\n\treturn budget ? JSON.stringify(budget) : undefined;\n}\n\nexport function decodeToolBudgetEnv(value: string | undefined): ResolvedToolBudget | undefined {\n\tif (!value?.trim()) return undefined;\n\tconst parsed = JSON.parse(value) as unknown;\n\tconst normalized = validateToolBudgetConfig(parsed, TOOL_BUDGET_ENV);\n\tif (normalized.error) throw new Error(normalized.error);\n\treturn normalized.budget;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.d.ts

@@ -0,0 +1,14 @@
+import type { ResolvedTurnBudget, TurnBudgetState } from "../../shared/types.ts";
+export declare const DEFAULT_TURN_BUDGET_GRACE_TURNS = 1;
+export declare function resolveTurnBudgetConfig(raw: unknown, label?: string): {
+    turnBudget?: ResolvedTurnBudget;
+    error?: string;
+};
+export declare function appendTurnBudgetSystemPrompt(systemPrompt: string, budget: ResolvedTurnBudget | undefined): string;
+export declare function turnBudgetSoftNote(budget: ResolvedTurnBudget, turnCount: number): string;
+export declare function turnBudgetExceededMessage(budget: ResolvedTurnBudget, turnCount: number): string;
+export declare function formatTurnBudgetOutput(message: string, output: string): string;
+export declare function initialTurnBudgetState(budget: ResolvedTurnBudget): TurnBudgetState;
+export declare function turnBudgetState(budget: ResolvedTurnBudget, turnCount: number, exceeded: boolean): TurnBudgetState;
+export declare function shouldAbortForTurnBudget(budget: ResolvedTurnBudget, turnCount: number, terminalAssistantStop: boolean): boolean;
+//# sourceMappingURL=turn-budget.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-budget.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjF,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,SAAe,GAClB;IAAE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBrD;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAYjH;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAElF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,eAAe,CAQjH;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,GAAG,OAAO,CAK/H","sourcesContent":["// @ts-nocheck\nimport type { ResolvedTurnBudget, TurnBudgetState } from \"../../shared/types.ts\";\n\nexport const DEFAULT_TURN_BUDGET_GRACE_TURNS = 1;\n\nexport function resolveTurnBudgetConfig(\n\traw: unknown,\n\tlabel = \"turnBudget\",\n): { turnBudget?: ResolvedTurnBudget; error?: string } {\n\tif (raw === undefined) return {};\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n\t\treturn { error: `${label} must be an object with maxTurns and optional graceTurns.` };\n\t}\n\tconst unknownField = Object.keys(raw).find((key) => key !== \"maxTurns\" && key !== \"graceTurns\");\n\tif (unknownField) return { error: `${label}.${unknownField} is not supported.` };\n\tconst budget = raw as { maxTurns?: unknown; graceTurns?: unknown };\n\tif (typeof budget.maxTurns !== \"number\" || !Number.isInteger(budget.maxTurns) || budget.maxTurns < 1) {\n\t\treturn { error: `${label}.maxTurns must be an integer >= 1.` };\n\t}\n\tconst graceTurns = budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS;\n\tif (typeof graceTurns !== \"number\" || !Number.isInteger(graceTurns) || graceTurns < 0) {\n\t\treturn { error: `${label}.graceTurns must be an integer >= 0.` };\n\t}\n\treturn { turnBudget: { maxTurns: budget.maxTurns, graceTurns } };\n}\n\nexport function appendTurnBudgetSystemPrompt(systemPrompt: string, budget: ResolvedTurnBudget | undefined): string {\n\tif (!budget) return systemPrompt;\n\tconst grace = budget.graceTurns === 1 ? \"1 additional assistant turn\" : `${budget.graceTurns} additional assistant turns`;\n\tconst block = [\n\t\t\"## Turn budget\",\n\t\t`This child run has a soft budget of ${budget.maxTurns} assistant turn${budget.maxTurns === 1 ? \"\" : \"s\"}.`,\n\t\t`After that, ${grace} may be allowed only for a final wrap-up.`,\n\t\t\"When you approach or reach the soft budget, stop starting new tool work and return the final answer immediately.\",\n\t\t\"This runner uses process-mode execution, so live steering after launch may be unavailable; treat this instruction as the wrap-up request.\",\n\t\t\"If you continue past the soft budget plus grace turns, the supervisor may abort the process and return only partial output.\",\n\t].join(\"\\n\");\n\treturn systemPrompt.trim() ? `${systemPrompt.trim()}\\n\\n${block}` : block;\n}\n\nexport function turnBudgetSoftNote(budget: ResolvedTurnBudget, turnCount: number): string {\n\treturn `Turn budget wrap-up was requested after ${turnCount} assistant turn${turnCount === 1 ? \"\" : \"s\"} (soft limit ${budget.maxTurns}, grace ${budget.graceTurns}). Process-mode live steering is unavailable, so the child was warned at launch to wrap up by this budget. Output may be partial.`;\n}\n\nexport function turnBudgetExceededMessage(budget: ResolvedTurnBudget, turnCount: number): string {\n\treturn `Subagent exceeded turn budget after ${turnCount} assistant turn${turnCount === 1 ? \"\" : \"s\"} (soft limit ${budget.maxTurns} + grace ${budget.graceTurns}).`;\n}\n\nexport function formatTurnBudgetOutput(message: string, output: string): string {\n\treturn output.trim()\n\t\t? `${message}\\n\\nPartial output before turn-budget abort:\\n${output}`\n\t\t: message;\n}\n\nexport function initialTurnBudgetState(budget: ResolvedTurnBudget): TurnBudgetState {\n\treturn { ...budget, outcome: \"within-budget\", turnCount: 0 };\n}\n\nexport function turnBudgetState(budget: ResolvedTurnBudget, turnCount: number, exceeded: boolean): TurnBudgetState {\n\treturn {\n\t\t...budget,\n\t\tturnCount,\n\t\toutcome: exceeded ? \"exceeded\" : \"wrap-up-requested\",\n\t\twrapUpRequestedAtTurn: budget.maxTurns,\n\t\t...(exceeded ? { exceededAtTurn: turnCount } : {}),\n\t};\n}\n\nexport function shouldAbortForTurnBudget(budget: ResolvedTurnBudget, turnCount: number, terminalAssistantStop: boolean): boolean {\n\tconst hardLimit = budget.maxTurns + budget.graceTurns;\n\tif (turnCount < hardLimit) return false;\n\tif (turnCount > hardLimit) return true;\n\treturn !terminalAssistantStop;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.js

@@ -0,0 +1,66 @@
+export const DEFAULT_TURN_BUDGET_GRACE_TURNS = 1;
+export function resolveTurnBudgetConfig(raw, label = "turnBudget") {
+    if (raw === undefined)
+        return {};
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        return { error: `${label} must be an object with maxTurns and optional graceTurns.` };
+    }
+    const unknownField = Object.keys(raw).find((key) => key !== "maxTurns" && key !== "graceTurns");
+    if (unknownField)
+        return { error: `${label}.${unknownField} is not supported.` };
+    const budget = raw;
+    if (typeof budget.maxTurns !== "number" || !Number.isInteger(budget.maxTurns) || budget.maxTurns < 1) {
+        return { error: `${label}.maxTurns must be an integer >= 1.` };
+    }
+    const graceTurns = budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS;
+    if (typeof graceTurns !== "number" || !Number.isInteger(graceTurns) || graceTurns < 0) {
+        return { error: `${label}.graceTurns must be an integer >= 0.` };
+    }
+    return { turnBudget: { maxTurns: budget.maxTurns, graceTurns } };
+}
+export function appendTurnBudgetSystemPrompt(systemPrompt, budget) {
+    if (!budget)
+        return systemPrompt;
+    const grace = budget.graceTurns === 1 ? "1 additional assistant turn" : `${budget.graceTurns} additional assistant turns`;
+    const block = [
+        "## Turn budget",
+        `This child run has a soft budget of ${budget.maxTurns} assistant turn${budget.maxTurns === 1 ? "" : "s"}.`,
+        `After that, ${grace} may be allowed only for a final wrap-up.`,
+        "When you approach or reach the soft budget, stop starting new tool work and return the final answer immediately.",
+        "This runner uses process-mode execution, so live steering after launch may be unavailable; treat this instruction as the wrap-up request.",
+        "If you continue past the soft budget plus grace turns, the supervisor may abort the process and return only partial output.",
+    ].join("\n");
+    return systemPrompt.trim() ? `${systemPrompt.trim()}\n\n${block}` : block;
+}
+export function turnBudgetSoftNote(budget, turnCount) {
+    return `Turn budget wrap-up was requested after ${turnCount} assistant turn${turnCount === 1 ? "" : "s"} (soft limit ${budget.maxTurns}, grace ${budget.graceTurns}). Process-mode live steering is unavailable, so the child was warned at launch to wrap up by this budget. Output may be partial.`;
+}
+export function turnBudgetExceededMessage(budget, turnCount) {
+    return `Subagent exceeded turn budget after ${turnCount} assistant turn${turnCount === 1 ? "" : "s"} (soft limit ${budget.maxTurns} + grace ${budget.graceTurns}).`;
+}
+export function formatTurnBudgetOutput(message, output) {
+    return output.trim()
+        ? `${message}\n\nPartial output before turn-budget abort:\n${output}`
+        : message;
+}
+export function initialTurnBudgetState(budget) {
+    return { ...budget, outcome: "within-budget", turnCount: 0 };
+}
+export function turnBudgetState(budget, turnCount, exceeded) {
+    return {
+        ...budget,
+        turnCount,
+        outcome: exceeded ? "exceeded" : "wrap-up-requested",
+        wrapUpRequestedAtTurn: budget.maxTurns,
+        ...(exceeded ? { exceededAtTurn: turnCount } : {}),
+    };
+}
+export function shouldAbortForTurnBudget(budget, turnCount, terminalAssistantStop) {
+    const hardLimit = budget.maxTurns + budget.graceTurns;
+    if (turnCount < hardLimit)
+        return false;
+    if (turnCount > hardLimit)
+        return true;
+    return !terminalAssistantStop;
+}
+//# sourceMappingURL=turn-budget.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-budget.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/turn-budget.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CACtC,GAAY,EACZ,KAAK,GAAG,YAAY,EACkC;IACtD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,2DAA2D,EAAE,CAAC;IACvF,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,YAAY,CAAC,CAAC;IAChG,IAAI,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,YAAY,oBAAoB,EAAE,CAAC;IACjF,MAAM,MAAM,GAAG,GAAmD,CAAC;IACnE,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACtG,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,oCAAoC,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,+BAA+B,CAAC;IACxE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,sCAAsC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC;AAAA,CACjE;AAED,MAAM,UAAU,4BAA4B,CAAC,YAAoB,EAAE,MAAsC,EAAU;IAClH,IAAI,CAAC,MAAM;QAAE,OAAO,YAAY,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,6BAA6B,CAAC;IAC1H,MAAM,KAAK,GAAG;QACb,gBAAgB;QAChB,uCAAuC,MAAM,CAAC,QAAQ,kBAAkB,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QAC3G,eAAe,KAAK,2CAA2C;QAC/D,kHAAkH;QAClH,2IAA2I;QAC3I,6HAA6H;KAC7H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAAA,CAC1E;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA0B,EAAE,SAAiB,EAAU;IACzF,OAAO,2CAA2C,SAAS,kBAAkB,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,gBAAgB,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,UAAU,mIAAmI,CAAC;AAAA,CACtS;AAED,MAAM,UAAU,yBAAyB,CAAC,MAA0B,EAAE,SAAiB,EAAU;IAChG,OAAO,uCAAuC,SAAS,kBAAkB,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,gBAAgB,MAAM,CAAC,QAAQ,YAAY,MAAM,CAAC,UAAU,IAAI,CAAC;AAAA,CACpK;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAc,EAAU;IAC/E,OAAO,MAAM,CAAC,IAAI,EAAE;QACnB,CAAC,CAAC,GAAG,OAAO,iDAAiD,MAAM,EAAE;QACrE,CAAC,CAAC,OAAO,CAAC;AAAA,CACX;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA0B,EAAmB;IACnF,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAAA,CAC7D;AAED,MAAM,UAAU,eAAe,CAAC,MAA0B,EAAE,SAAiB,EAAE,QAAiB,EAAmB;IAClH,OAAO;QACN,GAAG,MAAM;QACT,SAAS;QACT,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB;QACpD,qBAAqB,EAAE,MAAM,CAAC,QAAQ;QACtC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AAAA,CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA0B,EAAE,SAAiB,EAAE,qBAA8B,EAAW;IAChI,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;IACtD,IAAI,SAAS,GAAG,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,SAAS,GAAG,SAAS;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,CAAC,qBAAqB,CAAC;AAAA,CAC9B","sourcesContent":["// @ts-nocheck\nimport type { ResolvedTurnBudget, TurnBudgetState } from \"../../shared/types.ts\";\n\nexport const DEFAULT_TURN_BUDGET_GRACE_TURNS = 1;\n\nexport function resolveTurnBudgetConfig(\n\traw: unknown,\n\tlabel = \"turnBudget\",\n): { turnBudget?: ResolvedTurnBudget; error?: string } {\n\tif (raw === undefined) return {};\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n\t\treturn { error: `${label} must be an object with maxTurns and optional graceTurns.` };\n\t}\n\tconst unknownField = Object.keys(raw).find((key) => key !== \"maxTurns\" && key !== \"graceTurns\");\n\tif (unknownField) return { error: `${label}.${unknownField} is not supported.` };\n\tconst budget = raw as { maxTurns?: unknown; graceTurns?: unknown };\n\tif (typeof budget.maxTurns !== \"number\" || !Number.isInteger(budget.maxTurns) || budget.maxTurns < 1) {\n\t\treturn { error: `${label}.maxTurns must be an integer >= 1.` };\n\t}\n\tconst graceTurns = budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS;\n\tif (typeof graceTurns !== \"number\" || !Number.isInteger(graceTurns) || graceTurns < 0) {\n\t\treturn { error: `${label}.graceTurns must be an integer >= 0.` };\n\t}\n\treturn { turnBudget: { maxTurns: budget.maxTurns, graceTurns } };\n}\n\nexport function appendTurnBudgetSystemPrompt(systemPrompt: string, budget: ResolvedTurnBudget | undefined): string {\n\tif (!budget) return systemPrompt;\n\tconst grace = budget.graceTurns === 1 ? \"1 additional assistant turn\" : `${budget.graceTurns} additional assistant turns`;\n\tconst block = [\n\t\t\"## Turn budget\",\n\t\t`This child run has a soft budget of ${budget.maxTurns} assistant turn${budget.maxTurns === 1 ? \"\" : \"s\"}.`,\n\t\t`After that, ${grace} may be allowed only for a final wrap-up.`,\n\t\t\"When you approach or reach the soft budget, stop starting new tool work and return the final answer immediately.\",\n\t\t\"This runner uses process-mode execution, so live steering after launch may be unavailable; treat this instruction as the wrap-up request.\",\n\t\t\"If you continue past the soft budget plus grace turns, the supervisor may abort the process and return only partial output.\",\n\t].join(\"\\n\");\n\treturn systemPrompt.trim() ? `${systemPrompt.trim()}\\n\\n${block}` : block;\n}\n\nexport function turnBudgetSoftNote(budget: ResolvedTurnBudget, turnCount: number): string {\n\treturn `Turn budget wrap-up was requested after ${turnCount} assistant turn${turnCount === 1 ? \"\" : \"s\"} (soft limit ${budget.maxTurns}, grace ${budget.graceTurns}). Process-mode live steering is unavailable, so the child was warned at launch to wrap up by this budget. Output may be partial.`;\n}\n\nexport function turnBudgetExceededMessage(budget: ResolvedTurnBudget, turnCount: number): string {\n\treturn `Subagent exceeded turn budget after ${turnCount} assistant turn${turnCount === 1 ? \"\" : \"s\"} (soft limit ${budget.maxTurns} + grace ${budget.graceTurns}).`;\n}\n\nexport function formatTurnBudgetOutput(message: string, output: string): string {\n\treturn output.trim()\n\t\t? `${message}\\n\\nPartial output before turn-budget abort:\\n${output}`\n\t\t: message;\n}\n\nexport function initialTurnBudgetState(budget: ResolvedTurnBudget): TurnBudgetState {\n\treturn { ...budget, outcome: \"within-budget\", turnCount: 0 };\n}\n\nexport function turnBudgetState(budget: ResolvedTurnBudget, turnCount: number, exceeded: boolean): TurnBudgetState {\n\treturn {\n\t\t...budget,\n\t\tturnCount,\n\t\toutcome: exceeded ? \"exceeded\" : \"wrap-up-requested\",\n\t\twrapUpRequestedAtTurn: budget.maxTurns,\n\t\t...(exceeded ? { exceededAtTurn: turnCount } : {}),\n\t};\n}\n\nexport function shouldAbortForTurnBudget(budget: ResolvedTurnBudget, turnCount: number, terminalAssistantStop: boolean): boolean {\n\tconst hardLimit = budget.maxTurns + budget.graceTurns;\n\tif (turnCount < hardLimit) return false;\n\tif (turnCount > hardLimit) return true;\n\treturn !terminalAssistantStop;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.d.ts

@@ -0,0 +1,30 @@
+import { type ChainStep } from "../../shared/settings.ts";
+import type { SingleResult, SubagentRunMode, WorkflowGraphSnapshot, WorkflowNodeStatus } from "../../shared/types.ts";
+export interface WorkflowGraphBuildInput {
+    runId: string;
+    mode?: SubagentRunMode;
+    steps: ChainStep[];
+    results?: Array<Pick<SingleResult, "exitCode" | "detached" | "interrupted" | "error" | "acceptance">>;
+    currentFlatIndex?: number;
+    currentStepIndex?: number;
+    stepStatuses?: Array<{
+        status?: string;
+        error?: string;
+    }>;
+    dynamicChildren?: Record<number, Array<{
+        agent: string;
+        label?: string;
+        flatIndex: number;
+        itemKey: string;
+        outputName?: string;
+        structured?: boolean;
+        error?: string;
+    }>>;
+    dynamicGroupStatuses?: Record<number, {
+        status: WorkflowNodeStatus;
+        error?: string;
+        acceptance?: SingleResult["acceptance"];
+    }>;
+}
+export declare function buildWorkflowGraphSnapshot(input: WorkflowGraphBuildInput): WorkflowGraphSnapshot;
+//# sourceMappingURL=workflow-graph.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,SAAS,EAAuB,MAAM,0BAA0B,CAAC;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAqB,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1K,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/H;AA2DD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,qBAAqB,CAqIhG","sourcesContent":["// @ts-nocheck\nimport { isDynamicParallelStep, isParallelStep, type ChainStep, type SequentialStep } from \"../../shared/settings.ts\";\nimport type { SingleResult, SubagentRunMode, WorkflowGraphNode, WorkflowGraphSnapshot, WorkflowNodeStatus } from \"../../shared/types.ts\";\n\nexport interface WorkflowGraphBuildInput {\n\trunId: string;\n\tmode?: SubagentRunMode;\n\tsteps: ChainStep[];\n\tresults?: Array<Pick<SingleResult, \"exitCode\" | \"detached\" | \"interrupted\" | \"error\" | \"acceptance\">>;\n\tcurrentFlatIndex?: number;\n\tcurrentStepIndex?: number;\n\tstepStatuses?: Array<{ status?: string; error?: string }>;\n\tdynamicChildren?: Record<number, Array<{ agent: string; label?: string; flatIndex: number; itemKey: string; outputName?: string; structured?: boolean; error?: string }>>;\n\tdynamicGroupStatuses?: Record<number, { status: WorkflowNodeStatus; error?: string; acceptance?: SingleResult[\"acceptance\"] }>;\n}\n\nfunction normalizeStatus(status: string | undefined): WorkflowNodeStatus | undefined {\n\tswitch (status) {\n\t\tcase \"complete\":\n\t\tcase \"completed\":\n\t\t\treturn \"completed\";\n\t\tcase \"running\":\n\t\t\treturn \"running\";\n\t\tcase \"failed\":\n\t\t\treturn \"failed\";\n\t\tcase \"paused\":\n\t\t\treturn \"paused\";\n\t\tcase \"detached\":\n\t\t\treturn \"detached\";\n\t\tcase \"pending\":\n\t\t\treturn \"pending\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction resultStatus(result: Pick<SingleResult, \"exitCode\" | \"detached\" | \"interrupted\"> | undefined): WorkflowNodeStatus | undefined {\n\tif (!result) return undefined;\n\tif (result.detached) return \"detached\";\n\tif (result.interrupted) return \"paused\";\n\treturn result.exitCode === 0 ? \"completed\" : \"failed\";\n}\n\nfunction nodeStatus(input: WorkflowGraphBuildInput, flatIndex: number): WorkflowNodeStatus {\n\treturn normalizeStatus(input.stepStatuses?.[flatIndex]?.status)\n\t\t?? resultStatus(input.results?.[flatIndex])\n\t\t?? (input.currentFlatIndex === flatIndex ? \"running\" : \"pending\");\n}\n\nfunction pushPhase(phases: WorkflowGraphSnapshot[\"phases\"], phase: string | undefined, nodeId: string): void {\n\tif (!phase) return;\n\tlet group = phases.find((candidate) => candidate.title === phase);\n\tif (!group) {\n\t\tgroup = { title: phase, nodeIds: [] };\n\t\tphases.push(group);\n\t}\n\tgroup.nodeIds.push(nodeId);\n}\n\nfunction seqLabel(step: SequentialStep, stepIndex: number): string {\n\treturn step.label?.trim() || step.agent || `Step ${stepIndex + 1}`;\n}\n\nfunction summarizeParallelStatuses(statuses: WorkflowNodeStatus[]): WorkflowNodeStatus {\n\tif (statuses.some((status) => status === \"running\")) return \"running\";\n\tif (statuses.some((status) => status === \"failed\")) return \"failed\";\n\tif (statuses.some((status) => status === \"paused\")) return \"paused\";\n\tif (statuses.some((status) => status === \"detached\")) return \"detached\";\n\tif (statuses.length > 0 && statuses.every((status) => status === \"completed\")) return \"completed\";\n\tif (statuses.some((status) => status === \"completed\")) return \"running\";\n\treturn \"pending\";\n}\n\nexport function buildWorkflowGraphSnapshot(input: WorkflowGraphBuildInput): WorkflowGraphSnapshot {\n\tconst nodes: WorkflowGraphNode[] = [];\n\tconst phases: WorkflowGraphSnapshot[\"phases\"] = [];\n\tlet flatIndex = 0;\n\tlet currentNodeId: string | undefined;\n\n\tfor (let stepIndex = 0; stepIndex < input.steps.length; stepIndex++) {\n\t\tconst step = input.steps[stepIndex]!;\n\t\tif (isParallelStep(step)) {\n\t\t\tconst groupId = `step-${stepIndex}`;\n\t\t\tconst children: WorkflowGraphNode[] = [];\n\t\t\tconst childStatuses: WorkflowNodeStatus[] = [];\n\t\t\tfor (let taskIndex = 0; taskIndex < step.parallel.length; taskIndex++) {\n\t\t\t\tconst task = step.parallel[taskIndex]!;\n\t\t\t\tconst status = nodeStatus(input, flatIndex);\n\t\t\t\tchildStatuses.push(status);\n\t\t\t\tconst childId = `step-${stepIndex}-agent-${taskIndex}`;\n\t\t\t\tconst child: WorkflowGraphNode = {\n\t\t\t\t\tid: childId,\n\t\t\t\t\tkind: \"agent\",\n\t\t\t\t\tagent: task.agent,\n\t\t\t\t\tphase: task.phase,\n\t\t\t\t\tlabel: task.label?.trim() || task.agent || `Agent ${taskIndex + 1}`,\n\t\t\t\t\tstatus,\n\t\t\t\t\tflatIndex,\n\t\t\t\t\tstepIndex,\n\t\t\t\t\toutputName: task.as,\n\t\t\t\t\tstructured: Boolean(task.outputSchema),\n\t\t\t\t\tacceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,\n\t\t\t\t\terror: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,\n\t\t\t\t};\n\t\t\t\tchildren.push(child);\n\t\t\t\tpushPhase(phases, task.phase, childId);\n\t\t\t\tif (status === \"running\" || input.currentFlatIndex === flatIndex) currentNodeId = childId;\n\t\t\t\tflatIndex++;\n\t\t\t}\n\t\t\tconst groupStatus = summarizeParallelStatuses(childStatuses);\n\t\t\tif (input.currentStepIndex === stepIndex && !currentNodeId) currentNodeId = groupId;\n\t\t\tnodes.push({\n\t\t\t\tid: groupId,\n\t\t\t\tkind: \"parallel-group\",\n\t\t\t\tlabel: step.parallel.length === 1 ? \"Parallel task\" : `Parallel group (${step.parallel.length})`,\n\t\t\t\tstatus: groupStatus,\n\t\t\t\tstepIndex,\n\t\t\t\tchildren,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (isDynamicParallelStep(step)) {\n\t\t\tconst groupId = `step-${stepIndex}`;\n\t\t\tconst materialized = input.dynamicChildren?.[stepIndex] ?? [];\n\t\t\tconst groupOverride = input.dynamicGroupStatuses?.[stepIndex];\n\t\t\tconst children: WorkflowGraphNode[] = [];\n\t\t\tconst childStatuses: WorkflowNodeStatus[] = [];\n\t\t\tfor (let taskIndex = 0; taskIndex < materialized.length; taskIndex++) {\n\t\t\t\tconst task = materialized[taskIndex]!;\n\t\t\t\tconst status = nodeStatus(input, task.flatIndex);\n\t\t\t\tchildStatuses.push(status);\n\t\t\t\tconst childId = `step-${stepIndex}-item-${task.itemKey.replace(/[^a-zA-Z0-9_-]/g, \"-\")}`;\n\t\t\t\tconst child: WorkflowGraphNode = {\n\t\t\t\t\tid: childId,\n\t\t\t\t\tkind: \"agent\",\n\t\t\t\t\tagent: task.agent,\n\t\t\t\t\tphase: step.parallel.phase ?? step.phase,\n\t\t\t\t\tlabel: task.label?.trim() || step.parallel.label?.trim() || `${task.agent} ${task.itemKey}`,\n\t\t\t\t\tstatus,\n\t\t\t\t\tflatIndex: task.flatIndex,\n\t\t\t\t\tstepIndex,\n\t\t\t\t\titemKey: task.itemKey,\n\t\t\t\t\toutputName: task.outputName,\n\t\t\t\t\tstructured: task.structured,\n\t\t\t\t\tacceptanceStatus: input.results?.[task.flatIndex]?.acceptance?.status,\n\t\t\t\t\terror: input.stepStatuses?.[task.flatIndex]?.error ?? input.results?.[task.flatIndex]?.error ?? task.error,\n\t\t\t\t};\n\t\t\t\tchildren.push(child);\n\t\t\t\tpushPhase(phases, child.phase, childId);\n\t\t\t\tif (status === \"running\" || input.currentFlatIndex === task.flatIndex) currentNodeId = childId;\n\t\t\t}\n\t\t\tconst groupStatus = groupOverride?.status ?? (children.length > 0 ? summarizeParallelStatuses(childStatuses) : (input.currentStepIndex === stepIndex ? \"running\" : \"pending\"));\n\t\t\tif (input.currentStepIndex === stepIndex && !currentNodeId) currentNodeId = groupId;\n\t\t\tnodes.push({\n\t\t\t\tid: groupId,\n\t\t\t\tkind: \"dynamic-parallel-group\",\n\t\t\t\tlabel: step.label?.trim() || step.parallel.label?.trim() || `Dynamic fanout (${step.collect.as})`,\n\t\t\t\tstatus: groupStatus,\n\t\t\t\tstepIndex,\n\t\t\t\toutputName: step.collect.as,\n\t\t\t\tstructured: Boolean(step.collect.outputSchema),\n\t\t\t\tacceptanceStatus: groupOverride?.acceptance?.status,\n\t\t\t\terror: groupOverride?.error,\n\t\t\t\tdynamic: {\n\t\t\t\t\tsourceOutput: step.expand.from.output,\n\t\t\t\t\tsourcePath: step.expand.from.path,\n\t\t\t\t\titemName: step.expand.item ?? \"item\",\n\t\t\t\t\tmaxItems: step.expand.maxItems,\n\t\t\t\t\tcollectAs: step.collect.as,\n\t\t\t\t},\n\t\t\t\tchildren,\n\t\t\t});\n\t\t\tif (materialized.length > 0) flatIndex = Math.max(flatIndex, ...materialized.map((child) => child.flatIndex + 1));\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst seq = step as SequentialStep;\n\t\tconst status = nodeStatus(input, flatIndex);\n\t\tconst id = `step-${stepIndex}`;\n\t\tnodes.push({\n\t\t\tid,\n\t\t\tkind: \"step\",\n\t\t\tagent: seq.agent,\n\t\t\tphase: seq.phase,\n\t\t\tlabel: seqLabel(seq, stepIndex),\n\t\t\tstatus,\n\t\t\tflatIndex,\n\t\t\tstepIndex,\n\t\t\toutputName: seq.as,\n\t\t\tstructured: Boolean(seq.outputSchema),\n\t\t\tacceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,\n\t\t\terror: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,\n\t\t});\n\t\tpushPhase(phases, seq.phase, id);\n\t\tif (status === \"running\" || input.currentFlatIndex === flatIndex || input.currentStepIndex === stepIndex) currentNodeId = id;\n\t\tflatIndex++;\n\t}\n\n\treturn {\n\t\trunId: input.runId,\n\t\tmode: input.mode ?? \"chain\",\n\t\tphases,\n\t\tnodes,\n\t\tcurrentNodeId,\n\t};\n}\n"]}