@evalops/maestro 0.10.50 → 0.10.53

package/dist/agent/swarm/orchestrator-prompt.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Swarm orchestrator prompt
+ *
+ * The orchestrator is the agent that plans a swarm and delegates to workers.
+ * Its posture is "architect, not builder": it designs the system of workers,
+ * tracks every requirement, and steers the mission to success — it does not
+ * reach past its workers to implement features itself.
+ *
+ * This prompt is paired with the coverage gate (see ./coverage-gate.ts): the
+ * orchestrator is expected to produce a validation contract whose assertions
+ * are each claimed by exactly one feature before any worker is dispatched.
+ */
+export interface SwarmOrchestratorPromptOptions {
+    /**
+     * When true, the mission has explicitly opted out of the end-to-end
+     * validation default and workers may use mocks/stubs for unavailable
+     * integrations.
+     */
+    mocksAllowed?: boolean;
+}
+/**
+ * Build the orchestrator system prompt for a swarm mission.
+ */
+export declare function buildSwarmOrchestratorPrompt(options?: SwarmOrchestratorPromptOptions): string;
+//# sourceMappingURL=orchestrator-prompt.d.ts.map

package/dist/agent/swarm/orchestrator-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-prompt.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/orchestrator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,8BAA8B;IAC9C;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AA4BD;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,GAAE,8BAAmC,GAC1C,MAAM,CAUR"}

package/dist/agent/swarm/orchestrator-prompt.js

@@ -0,0 +1,48 @@
+/**
+ * Swarm orchestrator prompt
+ *
+ * The orchestrator is the agent that plans a swarm and delegates to workers.
+ * Its posture is "architect, not builder": it designs the system of workers,
+ * tracks every requirement, and steers the mission to success — it does not
+ * reach past its workers to implement features itself.
+ *
+ * This prompt is paired with the coverage gate (see ./coverage-gate.ts): the
+ * orchestrator is expected to produce a validation contract whose assertions
+ * are each claimed by exactly one feature before any worker is dispatched.
+ */
+const ARCHITECT_MINDSET = `# Role & Mindset
+
+You are the architect and orchestrator of a multi-worker swarm. You design the architecture, plan the work, decompose it into features, and steer the workers to success.
+
+You do not build directly — you design the system that builds, and provide every worker with the context, files, and acceptance criteria it needs. Reach for a worker, not your own edit tools, to implement a feature.`;
+const REQUIREMENT_TRACKING = `## Requirement Tracking
+
+Every requirement the user states — even casually, even once — must be captured and tracked.
+
+- Maintain an explicit inventory of all stated requirements before you decompose work.
+- If the user names a specific package, library, SDK, tool, or version, treat it as a requirement, not a suggestion. Do not silently substitute an alternative; if you believe a substitution is warranted, surface it and get agreement first.
+- Echo back the full set of captured requirements at least once before dispatching workers, so the user can correct omissions.`;
+const VALIDATION_DEFAULT = `## End-to-End Validation Is the Default
+
+All functionality must be validated end-to-end against real integrations (real services, real data, real auth) before the mission is declared done. Mocks and stubs are a conscious opt-out, not the default, and are acceptable only when the user explicitly requests them or a real integration is genuinely impossible in this environment. If end-to-end validation is blocked, treat it as a setup problem to solve with the user during planning — do not silently skip it.`;
+const MOCKS_ALLOWED_NOTE = `## Validation Posture: Mocks Permitted
+
+This mission has explicitly opted into using mocks/stubs where a real integration is unavailable. Still prefer the real execution path wherever it exists, and have each worker state exactly what was exercised with a mock rather than for real.`;
+const COVERAGE_GATE_CONTRACT = `## Coverage Contract
+
+Before any worker is dispatched, define a validation contract — the mission's exhaustive definition of done as a set of behavioral assertions — and decompose the work so that every assertion is claimed by exactly one feature. The coverage gate refuses to start work until every assertion is claimed exactly once and no feature references an unknown assertion. An uncovered assertion means the plan is incomplete, not that the gate is wrong.`;
+/**
+ * Build the orchestrator system prompt for a swarm mission.
+ */
+export function buildSwarmOrchestratorPrompt(options = {}) {
+    const validationSection = options.mocksAllowed
+        ? MOCKS_ALLOWED_NOTE
+        : VALIDATION_DEFAULT;
+    return [
+        ARCHITECT_MINDSET,
+        REQUIREMENT_TRACKING,
+        validationSection,
+        COVERAGE_GATE_CONTRACT,
+    ].join("\n\n");
+}
+//# sourceMappingURL=orchestrator-prompt.js.map

package/dist/agent/swarm/orchestrator-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-prompt.js","sourceRoot":"","sources":["../../../src/agent/swarm/orchestrator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,iBAAiB,GAAG;;;;wNAI8L,CAAC;AAEzN,MAAM,oBAAoB,GAAG;;;;;;+HAMkG,CAAC;AAEhI,MAAM,kBAAkB,GAAG;;mdAEwb,CAAC;AAEpd,MAAM,kBAAkB,GAAG;;mPAEwN,CAAC;AAEpP,MAAM,sBAAsB,GAAG;;ybAE0Z,CAAC;AAE1b;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC3C,UAA0C,EAAE;IAE5C,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY;QAC7C,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,kBAAkB,CAAC;IACtB,OAAO;QACN,iBAAiB;QACjB,oBAAoB;QACpB,iBAAiB;QACjB,sBAAsB;KACtB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Swarm orchestrator prompt\n *\n * The orchestrator is the agent that plans a swarm and delegates to workers.\n * Its posture is \"architect, not builder\": it designs the system of workers,\n * tracks every requirement, and steers the mission to success — it does not\n * reach past its workers to implement features itself.\n *\n * This prompt is paired with the coverage gate (see ./coverage-gate.ts): the\n * orchestrator is expected to produce a validation contract whose assertions\n * are each claimed by exactly one feature before any worker is dispatched.\n */\n\nexport interface SwarmOrchestratorPromptOptions {\n\t/**\n\t * When true, the mission has explicitly opted out of the end-to-end\n\t * validation default and workers may use mocks/stubs for unavailable\n\t * integrations.\n\t */\n\tmocksAllowed?: boolean;\n}\n\nconst ARCHITECT_MINDSET = `# Role & Mindset\n\nYou are the architect and orchestrator of a multi-worker swarm. You design the architecture, plan the work, decompose it into features, and steer the workers to success.\n\nYou do not build directly — you design the system that builds, and provide every worker with the context, files, and acceptance criteria it needs. Reach for a worker, not your own edit tools, to implement a feature.`;\n\nconst REQUIREMENT_TRACKING = `## Requirement Tracking\n\nEvery requirement the user states — even casually, even once — must be captured and tracked.\n\n- Maintain an explicit inventory of all stated requirements before you decompose work.\n- If the user names a specific package, library, SDK, tool, or version, treat it as a requirement, not a suggestion. Do not silently substitute an alternative; if you believe a substitution is warranted, surface it and get agreement first.\n- Echo back the full set of captured requirements at least once before dispatching workers, so the user can correct omissions.`;\n\nconst VALIDATION_DEFAULT = `## End-to-End Validation Is the Default\n\nAll functionality must be validated end-to-end against real integrations (real services, real data, real auth) before the mission is declared done. Mocks and stubs are a conscious opt-out, not the default, and are acceptable only when the user explicitly requests them or a real integration is genuinely impossible in this environment. If end-to-end validation is blocked, treat it as a setup problem to solve with the user during planning — do not silently skip it.`;\n\nconst MOCKS_ALLOWED_NOTE = `## Validation Posture: Mocks Permitted\n\nThis mission has explicitly opted into using mocks/stubs where a real integration is unavailable. Still prefer the real execution path wherever it exists, and have each worker state exactly what was exercised with a mock rather than for real.`;\n\nconst COVERAGE_GATE_CONTRACT = `## Coverage Contract\n\nBefore any worker is dispatched, define a validation contract — the mission's exhaustive definition of done as a set of behavioral assertions — and decompose the work so that every assertion is claimed by exactly one feature. The coverage gate refuses to start work until every assertion is claimed exactly once and no feature references an unknown assertion. An uncovered assertion means the plan is incomplete, not that the gate is wrong.`;\n\n/**\n * Build the orchestrator system prompt for a swarm mission.\n */\nexport function buildSwarmOrchestratorPrompt(\n\toptions: SwarmOrchestratorPromptOptions = {},\n): string {\n\tconst validationSection = options.mocksAllowed\n\t\t? MOCKS_ALLOWED_NOTE\n\t\t: VALIDATION_DEFAULT;\n\treturn [\n\t\tARCHITECT_MINDSET,\n\t\tREQUIREMENT_TRACKING,\n\t\tvalidationSection,\n\t\tCOVERAGE_GATE_CONTRACT,\n\t].join(\"\\n\\n\");\n}\n"]}

package/dist/agent/swarm/plan-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/plan-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAcxD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAG1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA+H5D;AA2ID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAc1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAAE,GAC1B,MAAM,CAWR"}
+{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/plan-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAmBxD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAG1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA+H5D;AAuKD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAc1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAAE,GAC1B,MAAM,CAWR"}

package/dist/agent/swarm/plan-parser.js

@@ -8,6 +8,8 @@ import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { createLogger } from "../../utils/logger.js";
 const logger = createLogger("agent:swarm:plan-parser");
+const MOCKS_ALLOWED_MARKER = /\s*\[(?:mocks\s+allowed|allow(?:ed)?\s+mocks|allow-mocks|mocksAllowed\s*=\s*true|mocks\s*=\s*true)\]/giu;
+const MOCKS_STRICT_MARKER = /\s*\[(?:mocks\s+disallowed|no\s+mocks|mocksAllowed\s*=\s*false|mocks\s*=\s*false)\]/giu;
 /**
  * Parse a plan file into structured tasks.
  */
@@ -170,18 +172,41 @@ function isLikelyTask(text) {
  * Convert a raw task to a SwarmTask.
  */
 function convertToSwarmTask(raw, index, allTasks) {
+    const metadata = extractTaskMetadata(raw.text);
     const task = {
         id: `task-${index + 1}-${randomUUID().slice(0, 8)}`,
-        prompt: raw.text,
+        prompt: metadata.text,
         priority: allTasks.length - index, // Earlier tasks have higher priority
     };
+    if (metadata.mocksAllowed !== undefined) {
+        task.mocksAllowed = metadata.mocksAllowed;
+    }
     // Extract file references from the task text
-    const files = extractFileReferences(raw.text);
+    const files = extractFileReferences(metadata.text);
     if (files.length > 0) {
         task.files = files;
     }
     return task;
 }
+function extractTaskMetadata(text) {
+    const allowsMocks = MOCKS_ALLOWED_MARKER.test(text);
+    MOCKS_ALLOWED_MARKER.lastIndex = 0;
+    const explicitlyStrict = MOCKS_STRICT_MARKER.test(text);
+    MOCKS_STRICT_MARKER.lastIndex = 0;
+    const cleanedText = text
+        .replace(MOCKS_ALLOWED_MARKER, "")
+        .replace(MOCKS_STRICT_MARKER, "")
+        .replace(/\s{2,}/gu, " ")
+        .trim();
+    return {
+        text: cleanedText,
+        ...(explicitlyStrict
+            ? { mocksAllowed: false }
+            : allowsMocks
+                ? { mocksAllowed: true }
+                : {}),
+    };
+}
 /**
  * Extract file path references from task text.
  */

package/dist/agent/swarm/plan-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-parser.js","sourceRoot":"","sources":["../../../src/agent/swarm/plan-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Plan Parser\n *\n * Parses markdown plan files into structured tasks for swarm execution.\n * Supports various markdown formats for task lists.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport { createLogger } from \"../../utils/logger.js\";\nimport type { ParsedPlan, SwarmTask } from \"./types.js\";\n\nconst logger = createLogger(\"agent:swarm:plan-parser\");\n\n/**\n * Task item extracted from markdown.\n */\ninterface RawTask {\n\ttext: string;\n\tcompleted: boolean;\n\tindent: number;\n\tlineNumber: number;\n}\n\n/**\n * Parse a plan file into structured tasks.\n */\nexport function parsePlanFile(filePath: string): ParsedPlan {\n\tconst content = readFileSync(filePath, \"utf-8\");\n\treturn parsePlanContent(content);\n}\n\n/**\n * Parse plan content (markdown string) into structured tasks.\n */\nexport function parsePlanContent(content: string): ParsedPlan {\n\tconst lines = content.split(\"\\n\");\n\tconst rawTasks: RawTask[] = [];\n\tlet title = \"Implementation Plan\";\n\n\t// Extract title from first H1\n\tfor (const line of lines) {\n\t\tconst h1Match = line.match(/^#\\s+(?:Plan:\\s*)?(.+)$/);\n\t\tif (h1Match?.[1]) {\n\t\t\ttitle = h1Match[1].trim();\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Extract tasks from checkbox items and numbered lists\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tif (!line) continue;\n\n\t\t// Match checkbox items: - [ ] task or - [x] task\n\t\tconst checkboxMatch = line.match(/^(\\s*)[-*]\\s*\\[([ xX])\\]\\s*(.+)$/);\n\t\tif (\n\t\t\tcheckboxMatch?.[1] !== undefined &&\n\t\t\tcheckboxMatch[2] &&\n\t\t\tcheckboxMatch[3]\n\t\t) {\n\t\t\trawTasks.push({\n\t\t\t\ttext: checkboxMatch[3].trim(),\n\t\t\t\tcompleted: checkboxMatch[2].toLowerCase() === \"x\",\n\t\t\t\tindent: checkboxMatch[1].length,\n\t\t\t\tlineNumber: i + 1,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Match numbered list items: 1. task or 1) task\n\t\tconst numberedMatch = line.match(/^(\\s*)\\d+[.)]\\s+(.+)$/);\n\t\tif (numberedMatch?.[1] !== undefined && numberedMatch[2]) {\n\t\t\t// Skip if it's a sub-item description\n\t\t\tconst text = numberedMatch[2].trim();\n\t\t\tif (\n\t\t\t\t!text.startsWith(\"**\") &&\n\t\t\t\t!text.match(/^[A-Z].*:$/) &&\n\t\t\t\ttext.length > 10\n\t\t\t) {\n\t\t\t\trawTasks.push({\n\t\t\t\t\ttext,\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tindent: numberedMatch[1].length,\n\t\t\t\t\tlineNumber: i + 1,\n\t\t\t\t});\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Match bullet items that look like tasks (starts with verb or \"Add/Create/Implement\")\n\t\tconst bulletMatch = line.match(/^(\\s*)[-*]\\s+(.+)$/);\n\t\tif (bulletMatch?.[1] !== undefined && bulletMatch[2]) {\n\t\t\tconst text = bulletMatch[2].trim();\n\t\t\tconst isTask = isLikelyTask(text);\n\t\t\tif (isTask && !text.startsWith(\"[\") && text.length > 10) {\n\t\t\t\trawTasks.push({\n\t\t\t\t\ttext,\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tindent: bulletMatch[1].length,\n\t\t\t\t\tlineNumber: i + 1,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t// Convert raw tasks to SwarmTasks (incomplete only)\n\tconst incompleteTasks = rawTasks.filter((t) => !t.completed);\n\tconst tasks = incompleteTasks.map((raw, index) =>\n\t\tconvertToSwarmTask(raw, index, rawTasks),\n\t);\n\n\t// Build mapping from raw task index -> full task ID (only for incomplete tasks).\n\tconst rawIndexByLine = new Map<number, number>();\n\tfor (const [rawIndex, raw] of rawTasks.entries()) {\n\t\trawIndexByLine.set(raw.lineNumber, rawIndex);\n\t}\n\n\tconst rawIndexToFullId = new Map<number, string>();\n\tfor (const [incompleteIndex, raw] of incompleteTasks.entries()) {\n\t\tconst rawIndex =\n\t\t\trawIndexByLine.get(raw.lineNumber) ?? rawTasks.indexOf(raw);\n\t\tconst task = tasks[incompleteIndex];\n\t\tif (task) {\n\t\t\trawIndexToFullId.set(rawIndex, task.id);\n\t\t}\n\t}\n\n\t// Resolve dependencies to full IDs so executor checks work.\n\t// Dependencies refer to task numbers in the full raw list; if a dependency\n\t// points to a completed task, it's considered already satisfied and skipped.\n\tfor (const [incompleteIndex, raw] of incompleteTasks.entries()) {\n\t\tconst currentRawIndex =\n\t\t\trawIndexByLine.get(raw.lineNumber) ?? rawTasks.indexOf(raw);\n\t\tconst baseDeps = extractDependencies(raw.text, currentRawIndex, rawTasks);\n\t\tif (baseDeps.length === 0) continue;\n\n\t\tconst depRawIndices = baseDeps\n\t\t\t.map((dep) => Number.parseInt(dep.replace(/^task-/, \"\"), 10) - 1)\n\t\t\t.filter((idx) => idx >= 0);\n\n\t\tconst fullDeps = depRawIndices\n\t\t\t.map((idx) => rawIndexToFullId.get(idx))\n\t\t\t.filter((dep): dep is string => Boolean(dep));\n\n\t\tconst task = tasks[incompleteIndex];\n\t\tif (fullDeps.length > 0 && task) {\n\t\t\ttask.dependsOn = fullDeps;\n\t\t}\n\t}\n\n\tlogger.debug(\"Parsed plan\", {\n\t\ttitle,\n\t\ttotalRawTasks: rawTasks.length,\n\t\tincompleteTasks: tasks.length,\n\t});\n\n\treturn {\n\t\ttitle,\n\t\ttasks,\n\t\tcontent,\n\t};\n}\n\n/**\n * Check if text looks like a task (starts with action verb).\n */\nfunction isLikelyTask(text: string): boolean {\n\tconst actionVerbs = [\n\t\t\"add\",\n\t\t\"create\",\n\t\t\"implement\",\n\t\t\"update\",\n\t\t\"modify\",\n\t\t\"change\",\n\t\t\"fix\",\n\t\t\"remove\",\n\t\t\"delete\",\n\t\t\"refactor\",\n\t\t\"extract\",\n\t\t\"move\",\n\t\t\"rename\",\n\t\t\"write\",\n\t\t\"build\",\n\t\t\"configure\",\n\t\t\"setup\",\n\t\t\"set up\",\n\t\t\"install\",\n\t\t\"integrate\",\n\t\t\"connect\",\n\t\t\"test\",\n\t\t\"verify\",\n\t\t\"validate\",\n\t\t\"check\",\n\t\t\"ensure\",\n\t\t\"make\",\n\t\t\"define\",\n\t\t\"declare\",\n\t\t\"export\",\n\t\t\"import\",\n\t];\n\n\tconst lowerText = text.toLowerCase();\n\treturn actionVerbs.some(\n\t\t(verb) => lowerText.startsWith(verb) || lowerText.startsWith(`${verb} `),\n\t);\n}\n\n/**\n * Convert a raw task to a SwarmTask.\n */\nfunction convertToSwarmTask(\n\traw: RawTask,\n\tindex: number,\n\tallTasks: RawTask[],\n): SwarmTask {\n\tconst task: SwarmTask = {\n\t\tid: `task-${index + 1}-${randomUUID().slice(0, 8)}`,\n\t\tprompt: raw.text,\n\t\tpriority: allTasks.length - index, // Earlier tasks have higher priority\n\t};\n\n\t// Extract file references from the task text\n\tconst files = extractFileReferences(raw.text);\n\tif (files.length > 0) {\n\t\ttask.files = files;\n\t}\n\n\treturn task;\n}\n\n/**\n * Extract file path references from task text.\n */\nfunction extractFileReferences(text: string): string[] {\n\tconst files: string[] = [];\n\n\t// Match quoted paths\n\tconst quotedMatches = text.matchAll(/[\"'`]([^\"'`]+\\.[a-z]+)[\"'`]/gi);\n\tfor (const match of quotedMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\t// Match backtick code spans with paths\n\tconst codeMatches = text.matchAll(/`([^`]+\\.[a-z]+)`/gi);\n\tfor (const match of codeMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured && !files.includes(captured)) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\t// Match common file patterns\n\tconst pathMatches = text.matchAll(\n\t\t/\\b((?:src|lib|test|tests|packages?)\\/[^\\s,)]+\\.[a-z]+)\\b/gi,\n\t);\n\tfor (const match of pathMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured && !files.includes(captured)) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\treturn files;\n}\n\n/**\n * Extract task dependencies from text.\n */\nfunction extractDependencies(\n\ttext: string,\n\tcurrentIndex: number,\n\tallTasks: RawTask[],\n): string[] {\n\tconst deps: string[] = [];\n\tconst lowerText = text.toLowerCase();\n\n\t// Check for \"after\" references\n\tconst afterMatch = lowerText.match(/after\\s+(?:task\\s+)?(\\d+)/);\n\tif (afterMatch?.[1]) {\n\t\tconst depIndex = Number.parseInt(afterMatch[1], 10) - 1;\n\t\tif (depIndex >= 0 && depIndex < currentIndex) {\n\t\t\tdeps.push(`task-${depIndex + 1}`);\n\t\t}\n\t}\n\n\t// Check for \"depends on\" references\n\tconst dependsMatch = lowerText.match(/depends\\s+on\\s+(?:task\\s+)?(\\d+)/);\n\tif (dependsMatch?.[1]) {\n\t\tconst depIndex = Number.parseInt(dependsMatch[1], 10) - 1;\n\t\tif (depIndex >= 0 && depIndex < currentIndex) {\n\t\t\tdeps.push(`task-${depIndex + 1}`);\n\t\t}\n\t}\n\n\treturn deps;\n}\n\n/**\n * Generate a plan markdown template.\n */\nexport function generatePlanTemplate(name: string, tasks: string[]): string {\n\tconst timestamp = new Date().toISOString();\n\tlet content = `# Plan: ${name}\\n\\n`;\n\tcontent += `Created: ${timestamp}\\n\\n`;\n\tcontent += \"## Tasks\\n\\n\";\n\n\tfor (let i = 0; i < tasks.length; i++) {\n\t\tcontent += `- [ ] ${tasks[i]}\\n`;\n\t}\n\n\tcontent += \"\\n## Notes\\n\\n\";\n\tcontent += \"<!-- Add any additional notes or context here -->\\n\";\n\n\treturn content;\n}\n\n/**\n * Update a plan file by marking tasks as complete.\n */\nexport function markTasksComplete(\n\tcontent: string,\n\tcompletedTaskTexts: string[],\n): string {\n\tlet updated = content;\n\n\tfor (const taskText of completedTaskTexts) {\n\t\t// Escape special regex characters in task text\n\t\tconst escaped = taskText.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t\tconst pattern = new RegExp(`^(\\\\s*[-*]\\\\s*)\\\\[ \\\\](\\\\s*${escaped})`, \"gm\");\n\t\tupdated = updated.replace(pattern, \"$1[x]$2\");\n\t}\n\n\treturn updated;\n}\n"]}
+{"version":3,"file":"plan-parser.js","sourceRoot":"","sources":["../../../src/agent/swarm/plan-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Plan Parser\n *\n * Parses markdown plan files into structured tasks for swarm execution.\n * Supports various markdown formats for task lists.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport { createLogger } from \"../../utils/logger.js\";\nimport type { ParsedPlan, SwarmTask } from \"./types.js\";\n\nconst logger = createLogger(\"agent:swarm:plan-parser\");\n\n/**\n * Task item extracted from markdown.\n */\ninterface RawTask {\n\ttext: string;\n\tcompleted: boolean;\n\tindent: number;\n\tlineNumber: number;\n}\n\nconst MOCKS_ALLOWED_MARKER =\n\t/\\s*\\[(?:mocks\\s+allowed|allow(?:ed)?\\s+mocks|allow-mocks|mocksAllowed\\s*=\\s*true|mocks\\s*=\\s*true)\\]/giu;\nconst MOCKS_STRICT_MARKER =\n\t/\\s*\\[(?:mocks\\s+disallowed|no\\s+mocks|mocksAllowed\\s*=\\s*false|mocks\\s*=\\s*false)\\]/giu;\n\n/**\n * Parse a plan file into structured tasks.\n */\nexport function parsePlanFile(filePath: string): ParsedPlan {\n\tconst content = readFileSync(filePath, \"utf-8\");\n\treturn parsePlanContent(content);\n}\n\n/**\n * Parse plan content (markdown string) into structured tasks.\n */\nexport function parsePlanContent(content: string): ParsedPlan {\n\tconst lines = content.split(\"\\n\");\n\tconst rawTasks: RawTask[] = [];\n\tlet title = \"Implementation Plan\";\n\n\t// Extract title from first H1\n\tfor (const line of lines) {\n\t\tconst h1Match = line.match(/^#\\s+(?:Plan:\\s*)?(.+)$/);\n\t\tif (h1Match?.[1]) {\n\t\t\ttitle = h1Match[1].trim();\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Extract tasks from checkbox items and numbered lists\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tif (!line) continue;\n\n\t\t// Match checkbox items: - [ ] task or - [x] task\n\t\tconst checkboxMatch = line.match(/^(\\s*)[-*]\\s*\\[([ xX])\\]\\s*(.+)$/);\n\t\tif (\n\t\t\tcheckboxMatch?.[1] !== undefined &&\n\t\t\tcheckboxMatch[2] &&\n\t\t\tcheckboxMatch[3]\n\t\t) {\n\t\t\trawTasks.push({\n\t\t\t\ttext: checkboxMatch[3].trim(),\n\t\t\t\tcompleted: checkboxMatch[2].toLowerCase() === \"x\",\n\t\t\t\tindent: checkboxMatch[1].length,\n\t\t\t\tlineNumber: i + 1,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Match numbered list items: 1. task or 1) task\n\t\tconst numberedMatch = line.match(/^(\\s*)\\d+[.)]\\s+(.+)$/);\n\t\tif (numberedMatch?.[1] !== undefined && numberedMatch[2]) {\n\t\t\t// Skip if it's a sub-item description\n\t\t\tconst text = numberedMatch[2].trim();\n\t\t\tif (\n\t\t\t\t!text.startsWith(\"**\") &&\n\t\t\t\t!text.match(/^[A-Z].*:$/) &&\n\t\t\t\ttext.length > 10\n\t\t\t) {\n\t\t\t\trawTasks.push({\n\t\t\t\t\ttext,\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tindent: numberedMatch[1].length,\n\t\t\t\t\tlineNumber: i + 1,\n\t\t\t\t});\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Match bullet items that look like tasks (starts with verb or \"Add/Create/Implement\")\n\t\tconst bulletMatch = line.match(/^(\\s*)[-*]\\s+(.+)$/);\n\t\tif (bulletMatch?.[1] !== undefined && bulletMatch[2]) {\n\t\t\tconst text = bulletMatch[2].trim();\n\t\t\tconst isTask = isLikelyTask(text);\n\t\t\tif (isTask && !text.startsWith(\"[\") && text.length > 10) {\n\t\t\t\trawTasks.push({\n\t\t\t\t\ttext,\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tindent: bulletMatch[1].length,\n\t\t\t\t\tlineNumber: i + 1,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t// Convert raw tasks to SwarmTasks (incomplete only)\n\tconst incompleteTasks = rawTasks.filter((t) => !t.completed);\n\tconst tasks = incompleteTasks.map((raw, index) =>\n\t\tconvertToSwarmTask(raw, index, rawTasks),\n\t);\n\n\t// Build mapping from raw task index -> full task ID (only for incomplete tasks).\n\tconst rawIndexByLine = new Map<number, number>();\n\tfor (const [rawIndex, raw] of rawTasks.entries()) {\n\t\trawIndexByLine.set(raw.lineNumber, rawIndex);\n\t}\n\n\tconst rawIndexToFullId = new Map<number, string>();\n\tfor (const [incompleteIndex, raw] of incompleteTasks.entries()) {\n\t\tconst rawIndex =\n\t\t\trawIndexByLine.get(raw.lineNumber) ?? rawTasks.indexOf(raw);\n\t\tconst task = tasks[incompleteIndex];\n\t\tif (task) {\n\t\t\trawIndexToFullId.set(rawIndex, task.id);\n\t\t}\n\t}\n\n\t// Resolve dependencies to full IDs so executor checks work.\n\t// Dependencies refer to task numbers in the full raw list; if a dependency\n\t// points to a completed task, it's considered already satisfied and skipped.\n\tfor (const [incompleteIndex, raw] of incompleteTasks.entries()) {\n\t\tconst currentRawIndex =\n\t\t\trawIndexByLine.get(raw.lineNumber) ?? rawTasks.indexOf(raw);\n\t\tconst baseDeps = extractDependencies(raw.text, currentRawIndex, rawTasks);\n\t\tif (baseDeps.length === 0) continue;\n\n\t\tconst depRawIndices = baseDeps\n\t\t\t.map((dep) => Number.parseInt(dep.replace(/^task-/, \"\"), 10) - 1)\n\t\t\t.filter((idx) => idx >= 0);\n\n\t\tconst fullDeps = depRawIndices\n\t\t\t.map((idx) => rawIndexToFullId.get(idx))\n\t\t\t.filter((dep): dep is string => Boolean(dep));\n\n\t\tconst task = tasks[incompleteIndex];\n\t\tif (fullDeps.length > 0 && task) {\n\t\t\ttask.dependsOn = fullDeps;\n\t\t}\n\t}\n\n\tlogger.debug(\"Parsed plan\", {\n\t\ttitle,\n\t\ttotalRawTasks: rawTasks.length,\n\t\tincompleteTasks: tasks.length,\n\t});\n\n\treturn {\n\t\ttitle,\n\t\ttasks,\n\t\tcontent,\n\t};\n}\n\n/**\n * Check if text looks like a task (starts with action verb).\n */\nfunction isLikelyTask(text: string): boolean {\n\tconst actionVerbs = [\n\t\t\"add\",\n\t\t\"create\",\n\t\t\"implement\",\n\t\t\"update\",\n\t\t\"modify\",\n\t\t\"change\",\n\t\t\"fix\",\n\t\t\"remove\",\n\t\t\"delete\",\n\t\t\"refactor\",\n\t\t\"extract\",\n\t\t\"move\",\n\t\t\"rename\",\n\t\t\"write\",\n\t\t\"build\",\n\t\t\"configure\",\n\t\t\"setup\",\n\t\t\"set up\",\n\t\t\"install\",\n\t\t\"integrate\",\n\t\t\"connect\",\n\t\t\"test\",\n\t\t\"verify\",\n\t\t\"validate\",\n\t\t\"check\",\n\t\t\"ensure\",\n\t\t\"make\",\n\t\t\"define\",\n\t\t\"declare\",\n\t\t\"export\",\n\t\t\"import\",\n\t];\n\n\tconst lowerText = text.toLowerCase();\n\treturn actionVerbs.some(\n\t\t(verb) => lowerText.startsWith(verb) || lowerText.startsWith(`${verb} `),\n\t);\n}\n\n/**\n * Convert a raw task to a SwarmTask.\n */\nfunction convertToSwarmTask(\n\traw: RawTask,\n\tindex: number,\n\tallTasks: RawTask[],\n): SwarmTask {\n\tconst metadata = extractTaskMetadata(raw.text);\n\tconst task: SwarmTask = {\n\t\tid: `task-${index + 1}-${randomUUID().slice(0, 8)}`,\n\t\tprompt: metadata.text,\n\t\tpriority: allTasks.length - index, // Earlier tasks have higher priority\n\t};\n\tif (metadata.mocksAllowed !== undefined) {\n\t\ttask.mocksAllowed = metadata.mocksAllowed;\n\t}\n\n\t// Extract file references from the task text\n\tconst files = extractFileReferences(metadata.text);\n\tif (files.length > 0) {\n\t\ttask.files = files;\n\t}\n\n\treturn task;\n}\n\nfunction extractTaskMetadata(text: string): {\n\ttext: string;\n\tmocksAllowed?: boolean;\n} {\n\tconst allowsMocks = MOCKS_ALLOWED_MARKER.test(text);\n\tMOCKS_ALLOWED_MARKER.lastIndex = 0;\n\tconst explicitlyStrict = MOCKS_STRICT_MARKER.test(text);\n\tMOCKS_STRICT_MARKER.lastIndex = 0;\n\tconst cleanedText = text\n\t\t.replace(MOCKS_ALLOWED_MARKER, \"\")\n\t\t.replace(MOCKS_STRICT_MARKER, \"\")\n\t\t.replace(/\\s{2,}/gu, \" \")\n\t\t.trim();\n\n\treturn {\n\t\ttext: cleanedText,\n\t\t...(explicitlyStrict\n\t\t\t? { mocksAllowed: false }\n\t\t\t: allowsMocks\n\t\t\t\t? { mocksAllowed: true }\n\t\t\t\t: {}),\n\t};\n}\n\n/**\n * Extract file path references from task text.\n */\nfunction extractFileReferences(text: string): string[] {\n\tconst files: string[] = [];\n\n\t// Match quoted paths\n\tconst quotedMatches = text.matchAll(/[\"'`]([^\"'`]+\\.[a-z]+)[\"'`]/gi);\n\tfor (const match of quotedMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\t// Match backtick code spans with paths\n\tconst codeMatches = text.matchAll(/`([^`]+\\.[a-z]+)`/gi);\n\tfor (const match of codeMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured && !files.includes(captured)) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\t// Match common file patterns\n\tconst pathMatches = text.matchAll(\n\t\t/\\b((?:src|lib|test|tests|packages?)\\/[^\\s,)]+\\.[a-z]+)\\b/gi,\n\t);\n\tfor (const match of pathMatches) {\n\t\tconst captured = match[1];\n\t\tif (captured && !files.includes(captured)) {\n\t\t\tfiles.push(captured);\n\t\t}\n\t}\n\n\treturn files;\n}\n\n/**\n * Extract task dependencies from text.\n */\nfunction extractDependencies(\n\ttext: string,\n\tcurrentIndex: number,\n\tallTasks: RawTask[],\n): string[] {\n\tconst deps: string[] = [];\n\tconst lowerText = text.toLowerCase();\n\n\t// Check for \"after\" references\n\tconst afterMatch = lowerText.match(/after\\s+(?:task\\s+)?(\\d+)/);\n\tif (afterMatch?.[1]) {\n\t\tconst depIndex = Number.parseInt(afterMatch[1], 10) - 1;\n\t\tif (depIndex >= 0 && depIndex < currentIndex) {\n\t\t\tdeps.push(`task-${depIndex + 1}`);\n\t\t}\n\t}\n\n\t// Check for \"depends on\" references\n\tconst dependsMatch = lowerText.match(/depends\\s+on\\s+(?:task\\s+)?(\\d+)/);\n\tif (dependsMatch?.[1]) {\n\t\tconst depIndex = Number.parseInt(dependsMatch[1], 10) - 1;\n\t\tif (depIndex >= 0 && depIndex < currentIndex) {\n\t\t\tdeps.push(`task-${depIndex + 1}`);\n\t\t}\n\t}\n\n\treturn deps;\n}\n\n/**\n * Generate a plan markdown template.\n */\nexport function generatePlanTemplate(name: string, tasks: string[]): string {\n\tconst timestamp = new Date().toISOString();\n\tlet content = `# Plan: ${name}\\n\\n`;\n\tcontent += `Created: ${timestamp}\\n\\n`;\n\tcontent += \"## Tasks\\n\\n\";\n\n\tfor (let i = 0; i < tasks.length; i++) {\n\t\tcontent += `- [ ] ${tasks[i]}\\n`;\n\t}\n\n\tcontent += \"\\n## Notes\\n\\n\";\n\tcontent += \"<!-- Add any additional notes or context here -->\\n\";\n\n\treturn content;\n}\n\n/**\n * Update a plan file by marking tasks as complete.\n */\nexport function markTasksComplete(\n\tcontent: string,\n\tcompletedTaskTexts: string[],\n): string {\n\tlet updated = content;\n\n\tfor (const taskText of completedTaskTexts) {\n\t\t// Escape special regex characters in task text\n\t\tconst escaped = taskText.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t\tconst pattern = new RegExp(`^(\\\\s*[-*]\\\\s*)\\\\[ \\\\](\\\\s*${escaped})`, \"gm\");\n\t\tupdated = updated.replace(pattern, \"$1[x]$2\");\n\t}\n\n\treturn updated;\n}\n"]}

package/dist/agent/swarm/types.d.ts

@@ -7,6 +7,7 @@
 import type { A2ATaskPushNotificationConfig } from "../../platform/a2a-client.js";
 import type { AgentMode, ModelProvider, ReasoningEffort } from "../modes.js";
 import type { SubagentType } from "../subagent-specs.js";
+import type { FeatureClaim, ValidationContract } from "../validation-contract.js";
 /**
  * Status of a swarm teammate.
  */
@@ -31,6 +32,14 @@ export interface SwarmTask {
     a2aPeer?: string;
     /** Optional A2A skill override when the task maps to a remote Maestro lane */
     a2aSkillId?: string;
+    /** Optional durable specialist profile to prepend to the teammate prompt. */
+    specialistProfile?: string;
+    /**
+     * Explicit opt-out of the end-to-end validation default. When true, the
+     * teammate may use mocks/stubs for unavailable integrations; otherwise the
+     * worker must validate against real integrations before reporting done.
+     */
+    mocksAllowed?: boolean;
     /** Priority (higher = earlier execution when no dependencies) */
     priority?: number;
 }
@@ -95,6 +104,14 @@ export interface SwarmConfig {
     continueOnFailure?: boolean;
     /** Git branch to work on (creates if doesn't exist) */
     gitBranch?: string;
+    /**
+     * Optional mission validation contract. When present, the coverage gate
+     * refuses to start the swarm until every assertion is claimed exactly once
+     * by the feature claims below.
+     */
+    validationContract?: ValidationContract;
+    /** Feature claims evaluated against validationContract by the coverage gate. */
+    featureClaims?: FeatureClaim[];
 }
 /**
  * Configuration for remote A2A-backed swarm teammates.

package/dist/agent/swarm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/swarm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/swarm/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Swarm Mode Types\n *\n * Type definitions for the swarm execution system that enables\n * parallel agent execution for implementing plans.\n */\n\nimport type { A2ATaskPushNotificationConfig } from \"../../platform/a2a-client.js\";\nimport type { AgentMode, ModelProvider, ReasoningEffort } from \"../modes.js\";\nimport type { SubagentType } from \"../subagent-specs.js\";\n\n/**\n * Status of a swarm teammate.\n */\nexport type TeammateStatus =\n\t| \"pending\"\n\t| \"running\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"cancelled\";\n\n/**\n * A single task assigned to a teammate in the swarm.\n */\nexport interface SwarmTask {\n\t/** Unique task identifier */\n\tid: string;\n\t/** Task description/prompt for the teammate */\n\tprompt: string;\n\t/** Files relevant to this task */\n\tfiles?: string[];\n\t/** Dependencies on other task IDs (must complete first) */\n\tdependsOn?: string[];\n\t/** Optional model override for this task */\n\tmodel?: string;\n\t/** Optional subagent type used for mode-level model dispatch */\n\tsubagentType?: SubagentType;\n\t/** Optional A2A peer override when the swarm uses remote transport */\n\ta2aPeer?: string;\n\t/** Optional A2A skill override when the task maps to a remote Maestro lane */\n\ta2aSkillId?: string;\n\t/** Priority (higher = earlier execution when no dependencies) */\n\tpriority?: number;\n}\n\n/**\n * A teammate in the swarm - an individual agent working on tasks.\n */\nexport interface SwarmTeammate {\n\t/** Unique teammate identifier */\n\tid: string;\n\t/** Display name for the teammate */\n\tname: string;\n\t/** Current status */\n\tstatus: TeammateStatus;\n\t/** Currently assigned task */\n\tcurrentTask?: SwarmTask;\n\t/** Tasks completed by this teammate */\n\tcompletedTasks: string[];\n\t/** Process ID if running as subprocess */\n\tpid?: number;\n\t/** Remote A2A task correlation when this teammate runs on a peer */\n\ta2a?: SwarmA2ATeammateExecution;\n\t/** Start timestamp */\n\tstartedAt?: number;\n\t/** Completion timestamp */\n\tcompletedAt?: number;\n\t/** Error message if failed */\n\terror?: string;\n\t/** Output/results from the teammate */\n\toutput?: string;\n}\n\n/**\n * Configuration for launching a swarm.\n */\nexport interface SwarmConfig {\n\t/** Number of teammates to spawn (1-10) */\n\tteammateCount: number;\n\t/** Plan file path to implement */\n\tplanFile: string;\n\t/** Tasks to distribute among teammates */\n\ttasks: SwarmTask[];\n\t/** Working directory for all teammates */\n\tcwd: string;\n\t/** Session ID of the parent session */\n\tparentSessionId?: string;\n\t/** Model to use for teammates (defaults to parent's model) */\n\tmodel?: string;\n\t/** Agent mode used to resolve subagent model dispatch */\n\tmode?: AgentMode;\n\t/** Parent model provider used when dispatch falls back to a model tier */\n\tmodelProvider?: ModelProvider;\n\t/** Default subagent type for teammate tasks without their own type */\n\tsubagentType?: SubagentType;\n\t/** Default reasoning hint for teammate tasks */\n\treasoningEffort?: ReasoningEffort;\n\t/** Execution transport for teammates; local preserves subprocess behavior. */\n\ttransport?: \"local\" | \"a2a\";\n\t/** Remote A2A routing options for Platform-discovered or registry peers. */\n\ta2a?: SwarmA2AConfig;\n\t/** Maximum time per task in milliseconds */\n\ttaskTimeout?: number;\n\t/** Whether to continue on individual task failures */\n\tcontinueOnFailure?: boolean;\n\t/** Git branch to work on (creates if doesn't exist) */\n\tgitBranch?: string;\n}\n\n/**\n * Configuration for remote A2A-backed swarm teammates.\n */\nexport interface SwarmA2AConfig {\n\t/** Named peers from the local A2A registry, used round-robin. */\n\tpeers?: string[];\n\t/** Override for the local A2A peer registry path. */\n\tregistryPath?: string;\n\t/** Override for the local A2A task ledger path. */\n\ttasksPath?: string;\n\t/** Default remote A2A skill id. */\n\tskillId?: string;\n\t/** Optional delegation role shown in task ledger metadata. */\n\trole?: string;\n\t/** Discover remote peers from Platform Agent Registry instead of local peers. */\n\tdiscover?: boolean;\n\t/** Platform workspace id for discovery. */\n\tworkspaceId?: string;\n\t/** Capability filter for Platform discovery. */\n\tcapability?: string;\n\t/** Surface filter for Platform discovery. Defaults to a2a. */\n\tsurface?: string;\n\t/** Prefer internal endpoints returned by Platform Agent Registry. */\n\tpreferInternalEndpoint?: boolean;\n\t/** Maximum Platform candidates to consider. */\n\tlimit?: number;\n\t/** Timeout for individual A2A HTTP calls. */\n\ttimeoutMs?: number;\n\t/** Max attempts for individual A2A HTTP calls. */\n\tmaxAttempts?: number;\n\t/** Max time to wait for a remote task to reach terminal state. */\n\tmaxWaitMs?: number;\n\t/** Poll interval while waiting for remote task state. */\n\tpollIntervalMs?: number;\n\t/** Optional push callback config sent to remote peers for task progress/artifact updates. */\n\tpushNotificationConfig?: A2ATaskPushNotificationConfig;\n}\n\n/**\n * Public, non-secret correlation metadata for a remote A2A swarm teammate.\n */\nexport interface SwarmA2ATeammateExecution {\n\t/** Peer selected for this teammate task. */\n\tpeer: string;\n\t/** Optional human-readable peer label. */\n\tpeerDisplayName?: string;\n\t/** Peer source used by the router. */\n\tsource: \"registry\" | \"platform-agent-registry\";\n\t/** Parent swarm task id used to derive telemetry lane ids. */\n\tparentTaskId?: string;\n\t/** A2A task id returned by the peer. */\n\ttaskId: string;\n\t/** A2A context id used for resume/reply. */\n\tcontextId?: string;\n\t/** A2A message id sent by the coordinator. */\n\tmessageId: string;\n\t/** A2A skill id used for remote routing. */\n\tskillId?: string;\n\t/** Delegation role recorded for the remote task. */\n\trole?: string;\n}\n\n/**\n * Status of the overall swarm execution.\n */\nexport type SwarmStatus =\n\t| \"initializing\"\n\t| \"running\"\n\t| \"completing\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"cancelled\";\n\n/**\n * State of the swarm execution.\n */\nexport interface SwarmState {\n\t/** Unique swarm execution ID */\n\tid: string;\n\t/** Current status */\n\tstatus: SwarmStatus;\n\t/** Configuration used to launch */\n\tconfig: SwarmConfig;\n\t/** All teammates in the swarm */\n\tteammates: SwarmTeammate[];\n\t/** Tasks pending assignment */\n\tpendingTasks: SwarmTask[];\n\t/** Tasks currently being worked on */\n\tactiveTasks: Map<string, string>; // taskId -> teammateId\n\t/** Completed task IDs */\n\tcompletedTasks: Set<string>;\n\t/** Failed task IDs */\n\tfailedTasks: Set<string>;\n\t/** Start timestamp */\n\tstartedAt: number;\n\t/** Completion timestamp */\n\tcompletedAt?: number;\n\t/** Error message if swarm failed */\n\terror?: string;\n}\n\n/**\n * Event emitted during swarm execution.\n */\nexport type SwarmEvent =\n\t| { type: \"swarm_start\"; swarmId: string; config: SwarmConfig }\n\t| { type: \"teammate_spawn\"; swarmId: string; teammate: SwarmTeammate }\n\t| {\n\t\t\ttype: \"task_start\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttask: SwarmTask;\n\t  }\n\t| {\n\t\t\ttype: \"task_complete\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttaskId: string;\n\t\t\toutput: string;\n\t  }\n\t| {\n\t\t\ttype: \"task_fail\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttaskId: string;\n\t\t\terror: string;\n\t  }\n\t| {\n\t\t\ttype: \"teammate_complete\";\n\t\t\tswarmId: string;\n\t\t\tteammate: SwarmTeammate;\n\t  }\n\t| { type: \"swarm_complete\"; swarmId: string; state: SwarmState }\n\t| { type: \"swarm_fail\"; swarmId: string; error: string };\n\n/**\n * Callback for swarm events.\n */\nexport type SwarmEventHandler = (event: SwarmEvent) => void;\n\n/**\n * Result of parsing a plan file into tasks.\n */\nexport interface ParsedPlan {\n\t/** Plan title/name */\n\ttitle: string;\n\t/** Extracted tasks */\n\ttasks: SwarmTask[];\n\t/** Raw plan content */\n\tcontent: string;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/swarm/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Swarm Mode Types\n *\n * Type definitions for the swarm execution system that enables\n * parallel agent execution for implementing plans.\n */\n\nimport type { A2ATaskPushNotificationConfig } from \"../../platform/a2a-client.js\";\nimport type { AgentMode, ModelProvider, ReasoningEffort } from \"../modes.js\";\nimport type { SubagentType } from \"../subagent-specs.js\";\nimport type {\n\tFeatureClaim,\n\tValidationContract,\n} from \"../validation-contract.js\";\n\n/**\n * Status of a swarm teammate.\n */\nexport type TeammateStatus =\n\t| \"pending\"\n\t| \"running\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"cancelled\";\n\n/**\n * A single task assigned to a teammate in the swarm.\n */\nexport interface SwarmTask {\n\t/** Unique task identifier */\n\tid: string;\n\t/** Task description/prompt for the teammate */\n\tprompt: string;\n\t/** Files relevant to this task */\n\tfiles?: string[];\n\t/** Dependencies on other task IDs (must complete first) */\n\tdependsOn?: string[];\n\t/** Optional model override for this task */\n\tmodel?: string;\n\t/** Optional subagent type used for mode-level model dispatch */\n\tsubagentType?: SubagentType;\n\t/** Optional A2A peer override when the swarm uses remote transport */\n\ta2aPeer?: string;\n\t/** Optional A2A skill override when the task maps to a remote Maestro lane */\n\ta2aSkillId?: string;\n\t/** Optional durable specialist profile to prepend to the teammate prompt. */\n\tspecialistProfile?: string;\n\t/**\n\t * Explicit opt-out of the end-to-end validation default. When true, the\n\t * teammate may use mocks/stubs for unavailable integrations; otherwise the\n\t * worker must validate against real integrations before reporting done.\n\t */\n\tmocksAllowed?: boolean;\n\t/** Priority (higher = earlier execution when no dependencies) */\n\tpriority?: number;\n}\n\n/**\n * A teammate in the swarm - an individual agent working on tasks.\n */\nexport interface SwarmTeammate {\n\t/** Unique teammate identifier */\n\tid: string;\n\t/** Display name for the teammate */\n\tname: string;\n\t/** Current status */\n\tstatus: TeammateStatus;\n\t/** Currently assigned task */\n\tcurrentTask?: SwarmTask;\n\t/** Tasks completed by this teammate */\n\tcompletedTasks: string[];\n\t/** Process ID if running as subprocess */\n\tpid?: number;\n\t/** Remote A2A task correlation when this teammate runs on a peer */\n\ta2a?: SwarmA2ATeammateExecution;\n\t/** Start timestamp */\n\tstartedAt?: number;\n\t/** Completion timestamp */\n\tcompletedAt?: number;\n\t/** Error message if failed */\n\terror?: string;\n\t/** Output/results from the teammate */\n\toutput?: string;\n}\n\n/**\n * Configuration for launching a swarm.\n */\nexport interface SwarmConfig {\n\t/** Number of teammates to spawn (1-10) */\n\tteammateCount: number;\n\t/** Plan file path to implement */\n\tplanFile: string;\n\t/** Tasks to distribute among teammates */\n\ttasks: SwarmTask[];\n\t/** Working directory for all teammates */\n\tcwd: string;\n\t/** Session ID of the parent session */\n\tparentSessionId?: string;\n\t/** Model to use for teammates (defaults to parent's model) */\n\tmodel?: string;\n\t/** Agent mode used to resolve subagent model dispatch */\n\tmode?: AgentMode;\n\t/** Parent model provider used when dispatch falls back to a model tier */\n\tmodelProvider?: ModelProvider;\n\t/** Default subagent type for teammate tasks without their own type */\n\tsubagentType?: SubagentType;\n\t/** Default reasoning hint for teammate tasks */\n\treasoningEffort?: ReasoningEffort;\n\t/** Execution transport for teammates; local preserves subprocess behavior. */\n\ttransport?: \"local\" | \"a2a\";\n\t/** Remote A2A routing options for Platform-discovered or registry peers. */\n\ta2a?: SwarmA2AConfig;\n\t/** Maximum time per task in milliseconds */\n\ttaskTimeout?: number;\n\t/** Whether to continue on individual task failures */\n\tcontinueOnFailure?: boolean;\n\t/** Git branch to work on (creates if doesn't exist) */\n\tgitBranch?: string;\n\t/**\n\t * Optional mission validation contract. When present, the coverage gate\n\t * refuses to start the swarm until every assertion is claimed exactly once\n\t * by the feature claims below.\n\t */\n\tvalidationContract?: ValidationContract;\n\t/** Feature claims evaluated against validationContract by the coverage gate. */\n\tfeatureClaims?: FeatureClaim[];\n}\n\n/**\n * Configuration for remote A2A-backed swarm teammates.\n */\nexport interface SwarmA2AConfig {\n\t/** Named peers from the local A2A registry, used round-robin. */\n\tpeers?: string[];\n\t/** Override for the local A2A peer registry path. */\n\tregistryPath?: string;\n\t/** Override for the local A2A task ledger path. */\n\ttasksPath?: string;\n\t/** Default remote A2A skill id. */\n\tskillId?: string;\n\t/** Optional delegation role shown in task ledger metadata. */\n\trole?: string;\n\t/** Discover remote peers from Platform Agent Registry instead of local peers. */\n\tdiscover?: boolean;\n\t/** Platform workspace id for discovery. */\n\tworkspaceId?: string;\n\t/** Capability filter for Platform discovery. */\n\tcapability?: string;\n\t/** Surface filter for Platform discovery. Defaults to a2a. */\n\tsurface?: string;\n\t/** Prefer internal endpoints returned by Platform Agent Registry. */\n\tpreferInternalEndpoint?: boolean;\n\t/** Maximum Platform candidates to consider. */\n\tlimit?: number;\n\t/** Timeout for individual A2A HTTP calls. */\n\ttimeoutMs?: number;\n\t/** Max attempts for individual A2A HTTP calls. */\n\tmaxAttempts?: number;\n\t/** Max time to wait for a remote task to reach terminal state. */\n\tmaxWaitMs?: number;\n\t/** Poll interval while waiting for remote task state. */\n\tpollIntervalMs?: number;\n\t/** Optional push callback config sent to remote peers for task progress/artifact updates. */\n\tpushNotificationConfig?: A2ATaskPushNotificationConfig;\n}\n\n/**\n * Public, non-secret correlation metadata for a remote A2A swarm teammate.\n */\nexport interface SwarmA2ATeammateExecution {\n\t/** Peer selected for this teammate task. */\n\tpeer: string;\n\t/** Optional human-readable peer label. */\n\tpeerDisplayName?: string;\n\t/** Peer source used by the router. */\n\tsource: \"registry\" | \"platform-agent-registry\";\n\t/** Parent swarm task id used to derive telemetry lane ids. */\n\tparentTaskId?: string;\n\t/** A2A task id returned by the peer. */\n\ttaskId: string;\n\t/** A2A context id used for resume/reply. */\n\tcontextId?: string;\n\t/** A2A message id sent by the coordinator. */\n\tmessageId: string;\n\t/** A2A skill id used for remote routing. */\n\tskillId?: string;\n\t/** Delegation role recorded for the remote task. */\n\trole?: string;\n}\n\n/**\n * Status of the overall swarm execution.\n */\nexport type SwarmStatus =\n\t| \"initializing\"\n\t| \"running\"\n\t| \"completing\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"cancelled\";\n\n/**\n * State of the swarm execution.\n */\nexport interface SwarmState {\n\t/** Unique swarm execution ID */\n\tid: string;\n\t/** Current status */\n\tstatus: SwarmStatus;\n\t/** Configuration used to launch */\n\tconfig: SwarmConfig;\n\t/** All teammates in the swarm */\n\tteammates: SwarmTeammate[];\n\t/** Tasks pending assignment */\n\tpendingTasks: SwarmTask[];\n\t/** Tasks currently being worked on */\n\tactiveTasks: Map<string, string>; // taskId -> teammateId\n\t/** Completed task IDs */\n\tcompletedTasks: Set<string>;\n\t/** Failed task IDs */\n\tfailedTasks: Set<string>;\n\t/** Start timestamp */\n\tstartedAt: number;\n\t/** Completion timestamp */\n\tcompletedAt?: number;\n\t/** Error message if swarm failed */\n\terror?: string;\n}\n\n/**\n * Event emitted during swarm execution.\n */\nexport type SwarmEvent =\n\t| { type: \"swarm_start\"; swarmId: string; config: SwarmConfig }\n\t| { type: \"teammate_spawn\"; swarmId: string; teammate: SwarmTeammate }\n\t| {\n\t\t\ttype: \"task_start\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttask: SwarmTask;\n\t  }\n\t| {\n\t\t\ttype: \"task_complete\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttaskId: string;\n\t\t\toutput: string;\n\t  }\n\t| {\n\t\t\ttype: \"task_fail\";\n\t\t\tswarmId: string;\n\t\t\tteammateId: string;\n\t\t\ttaskId: string;\n\t\t\terror: string;\n\t  }\n\t| {\n\t\t\ttype: \"teammate_complete\";\n\t\t\tswarmId: string;\n\t\t\tteammate: SwarmTeammate;\n\t  }\n\t| { type: \"swarm_complete\"; swarmId: string; state: SwarmState }\n\t| { type: \"swarm_fail\"; swarmId: string; error: string };\n\n/**\n * Callback for swarm events.\n */\nexport type SwarmEventHandler = (event: SwarmEvent) => void;\n\n/**\n * Result of parsing a plan file into tasks.\n */\nexport interface ParsedPlan {\n\t/** Plan title/name */\n\ttitle: string;\n\t/** Extracted tasks */\n\ttasks: SwarmTask[];\n\t/** Raw plan content */\n\tcontent: string;\n}\n"]}

package/dist/agent/swarm/validation-directive.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Swarm validation directive
+ *
+ * Builds the "## Validation" section handed to every swarm teammate. The
+ * default posture is end-to-end validation against real integrations: a worker
+ * may not declare a task done on the strength of a mocked path. Mocks/stubs are
+ * an explicit per-task opt-out (`SwarmTask.mocksAllowed`), not the baseline.
+ *
+ * This mirrors the orchestrator discipline that high-end coding agents apply at
+ * the mission level, pushed down to the per-worker delegation prompt so the
+ * default holds even for a single delegated task.
+ */
+/**
+ * Returns the validation directive for a swarm task.
+ *
+ * @param mocksAllowed When true, the task has explicitly opted out of the
+ *   real-integration default and may use mocks/stubs for unavailable
+ *   dependencies.
+ */
+export declare function buildSwarmValidationDirective(mocksAllowed?: boolean): string;
+//# sourceMappingURL=validation-directive.d.ts.map

package/dist/agent/swarm/validation-directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-directive.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/validation-directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5E"}

package/dist/agent/swarm/validation-directive.js

@@ -0,0 +1,25 @@
+/**
+ * Swarm validation directive
+ *
+ * Builds the "## Validation" section handed to every swarm teammate. The
+ * default posture is end-to-end validation against real integrations: a worker
+ * may not declare a task done on the strength of a mocked path. Mocks/stubs are
+ * an explicit per-task opt-out (`SwarmTask.mocksAllowed`), not the baseline.
+ *
+ * This mirrors the orchestrator discipline that high-end coding agents apply at
+ * the mission level, pushed down to the per-worker delegation prompt so the
+ * default holds even for a single delegated task.
+ */
+const REAL_INTEGRATION_DIRECTIVE = "Validate end-to-end against real integrations. The default is that every change is exercised through its real execution path — real services, real data, real auth — before you finish. Do not introduce mocks or stubs to make a check pass. Add or update focused tests when behavior changes, and run the relevant verification (build, lint, the touched tests, and the real end-to-end path) before reporting completion. If an integration genuinely cannot be exercised in this environment, stop and report it as a blocker rather than claiming success — never report that something works on the strength of a mocked path alone.";
+const MOCKS_ALLOWED_DIRECTIVE = "This task is explicitly approved to use mocks or stubs where a real integration is unavailable. Prefer the real execution path wherever it exists; where you fall back to a mock, say so explicitly and name exactly what was not exercised for real. Add or update focused tests when behavior changes, and run the relevant verification before reporting completion.";
+/**
+ * Returns the validation directive for a swarm task.
+ *
+ * @param mocksAllowed When true, the task has explicitly opted out of the
+ *   real-integration default and may use mocks/stubs for unavailable
+ *   dependencies.
+ */
+export function buildSwarmValidationDirective(mocksAllowed) {
+    return mocksAllowed ? MOCKS_ALLOWED_DIRECTIVE : REAL_INTEGRATION_DIRECTIVE;
+}
+//# sourceMappingURL=validation-directive.js.map

package/dist/agent/swarm/validation-directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-directive.js","sourceRoot":"","sources":["../../../src/agent/swarm/validation-directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,0BAA0B,GAC/B,8mBAA8mB,CAAC;AAEhnB,MAAM,uBAAuB,GAC5B,yWAAyW,CAAC;AAE3W;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,YAAsB;IACnE,OAAO,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,0BAA0B,CAAC;AAC5E,CAAC","sourcesContent":["/**\n * Swarm validation directive\n *\n * Builds the \"## Validation\" section handed to every swarm teammate. The\n * default posture is end-to-end validation against real integrations: a worker\n * may not declare a task done on the strength of a mocked path. Mocks/stubs are\n * an explicit per-task opt-out (`SwarmTask.mocksAllowed`), not the baseline.\n *\n * This mirrors the orchestrator discipline that high-end coding agents apply at\n * the mission level, pushed down to the per-worker delegation prompt so the\n * default holds even for a single delegated task.\n */\n\nconst REAL_INTEGRATION_DIRECTIVE =\n\t\"Validate end-to-end against real integrations. The default is that every change is exercised through its real execution path — real services, real data, real auth — before you finish. Do not introduce mocks or stubs to make a check pass. Add or update focused tests when behavior changes, and run the relevant verification (build, lint, the touched tests, and the real end-to-end path) before reporting completion. If an integration genuinely cannot be exercised in this environment, stop and report it as a blocker rather than claiming success — never report that something works on the strength of a mocked path alone.\";\n\nconst MOCKS_ALLOWED_DIRECTIVE =\n\t\"This task is explicitly approved to use mocks or stubs where a real integration is unavailable. Prefer the real execution path wherever it exists; where you fall back to a mock, say so explicitly and name exactly what was not exercised for real. Add or update focused tests when behavior changes, and run the relevant verification before reporting completion.\";\n\n/**\n * Returns the validation directive for a swarm task.\n *\n * @param mocksAllowed When true, the task has explicitly opted out of the\n *   real-integration default and may use mocks/stubs for unavailable\n *   dependencies.\n */\nexport function buildSwarmValidationDirective(mocksAllowed?: boolean): string {\n\treturn mocksAllowed ? MOCKS_ALLOWED_DIRECTIVE : REAL_INTEGRATION_DIRECTIVE;\n}\n"]}

package/dist/agent/token-counter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Accurate token counter (OpenAI clade) with bytes/4 fallback.
+ *
+ * The shared heuristic in `@evalops/contracts` (`estimateTokens`, ~bytes/4) is
+ * fast, dependency-free, and correct enough for display. It under-counts code
+ * by ~25-35% versus a real BPE, which matters at budget-critical decision
+ * points (prompt-cache eligibility, context-overflow preflight, compaction
+ * thresholds).
+ *
+ * This module provides accurate counts for the OpenAI clade (o200k_base for
+ * GPT-4o/o-series, cl100k_base for GPT-4/GPT-3.5) and falls back to
+ * `estimateTokens` for providers without a bundled tokenizer (Anthropic,
+ * Google, etc.). Only the two needed encodings are imported to keep the
+ * bundle lean.
+ *
+ * Mirrored by `packages/tui-rs/src/agent/token_counting.rs` (tiktoken-rs) so
+ * native and TS counts agree for the same encoding.
+ *
+ * @example
+ * ```typescript
+ * import { countTokens } from "./token-counter.js";
+ *
+ * const n = countTokens(code, "gpt-4o");      // accurate (o200k_base)
+ * const m = countTokens(code, "claude-...");   // bytes/4 fallback
+ * ```
+ */
+/** BPE encoding families we can count accurately. */
+export type TokenEncoding = "o200k_base" | "cl100k_base";
+/**
+ * Resolve the tokenizer encoding for a model id, or `null` when no accurate
+ * tokenizer is bundled (Anthropic, Google, unknown) — callers fall back to
+ * the bytes/4 heuristic.
+ */
+export declare function encodingForModel(model: string): TokenEncoding | null;
+/**
+ * Count tokens accurately for OpenAI-clade models; fall back to the shared
+ * bytes/4 heuristic otherwise (or when `model` is unknown/omitted).
+ */
+export declare function countTokens(text: string, model?: string): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/agent/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/agent/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsBpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAahE"}

package/dist/agent/token-counter.js

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Accurate token counter (OpenAI clade) with bytes/4 fallback.
+ *
+ * The shared heuristic in `@evalops/contracts` (`estimateTokens`, ~bytes/4) is
+ * fast, dependency-free, and correct enough for display. It under-counts code
+ * by ~25-35% versus a real BPE, which matters at budget-critical decision
+ * points (prompt-cache eligibility, context-overflow preflight, compaction
+ * thresholds).
+ *
+ * This module provides accurate counts for the OpenAI clade (o200k_base for
+ * GPT-4o/o-series, cl100k_base for GPT-4/GPT-3.5) and falls back to
+ * `estimateTokens` for providers without a bundled tokenizer (Anthropic,
+ * Google, etc.). Only the two needed encodings are imported to keep the
+ * bundle lean.
+ *
+ * Mirrored by `packages/tui-rs/src/agent/token_counting.rs` (tiktoken-rs) so
+ * native and TS counts agree for the same encoding.
+ *
+ * @example
+ * ```typescript
+ * import { countTokens } from "./token-counter.js";
+ *
+ * const n = countTokens(code, "gpt-4o");      // accurate (o200k_base)
+ * const m = countTokens(code, "claude-...");   // bytes/4 fallback
+ * ```
+ */
+import { estimateTokens } from "@evalops/contracts";
+import { countTokens as countCl100k } from "gpt-tokenizer/encoding/cl100k_base";
+// Lean per-encoding imports — only the two OpenAI clade encodings ship.
+import { countTokens as countO200k } from "gpt-tokenizer/encoding/o200k_base";
+/**
+ * Resolve the tokenizer encoding for a model id, or `null` when no accurate
+ * tokenizer is bundled (Anthropic, Google, unknown) — callers fall back to
+ * the bytes/4 heuristic.
+ */
+export function encodingForModel(model) {
+    const m = model.toLowerCase();
+    // GPT-4o family and o-series / GPT-5 use o200k_base.
+    if (m.includes("gpt-4o") ||
+        m.includes("gpt-5") ||
+        /^o[134]\b/.test(m) ||
+        m.includes("o1") ||
+        m.includes("o3") ||
+        m.includes("o4")) {
+        return "o200k_base";
+    }
+    // GPT-4 / GPT-3.5 / embeddings use cl100k_base.
+    if (m.includes("gpt-4") ||
+        m.includes("gpt-3.5") ||
+        m.includes("text-embedding")) {
+        return "cl100k_base";
+    }
+    return null;
+}
+/**
+ * Count tokens accurately for OpenAI-clade models; fall back to the shared
+ * bytes/4 heuristic otherwise (or when `model` is unknown/omitted).
+ */
+export function countTokens(text, model) {
+    if (!model) {
+        return estimateTokens(text);
+    }
+    const encoding = encodingForModel(model);
+    if (!encoding) {
+        return estimateTokens(text);
+    }
+    try {
+        return encoding === "o200k_base" ? countO200k(text) : countCl100k(text);
+    }
+    catch {
+        return estimateTokens(text);
+    }
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/agent/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../src/agent/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAChF,wEAAwE;AACxE,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAK9E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,qDAAqD;IACrD,IACC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACf,CAAC;QACF,OAAO,YAAY,CAAC;IACrB,CAAC;IACD,gDAAgD;IAChD,IACC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC3B,CAAC;QACF,OAAO,aAAa,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAc;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC;QACJ,OAAO,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACF,CAAC","sourcesContent":["/**\n * @fileoverview Accurate token counter (OpenAI clade) with bytes/4 fallback.\n *\n * The shared heuristic in `@evalops/contracts` (`estimateTokens`, ~bytes/4) is\n * fast, dependency-free, and correct enough for display. It under-counts code\n * by ~25-35% versus a real BPE, which matters at budget-critical decision\n * points (prompt-cache eligibility, context-overflow preflight, compaction\n * thresholds).\n *\n * This module provides accurate counts for the OpenAI clade (o200k_base for\n * GPT-4o/o-series, cl100k_base for GPT-4/GPT-3.5) and falls back to\n * `estimateTokens` for providers without a bundled tokenizer (Anthropic,\n * Google, etc.). Only the two needed encodings are imported to keep the\n * bundle lean.\n *\n * Mirrored by `packages/tui-rs/src/agent/token_counting.rs` (tiktoken-rs) so\n * native and TS counts agree for the same encoding.\n *\n * @example\n * ```typescript\n * import { countTokens } from \"./token-counter.js\";\n *\n * const n = countTokens(code, \"gpt-4o\");      // accurate (o200k_base)\n * const m = countTokens(code, \"claude-...\");   // bytes/4 fallback\n * ```\n */\n\nimport { estimateTokens } from \"@evalops/contracts\";\nimport { countTokens as countCl100k } from \"gpt-tokenizer/encoding/cl100k_base\";\n// Lean per-encoding imports — only the two OpenAI clade encodings ship.\nimport { countTokens as countO200k } from \"gpt-tokenizer/encoding/o200k_base\";\n\n/** BPE encoding families we can count accurately. */\nexport type TokenEncoding = \"o200k_base\" | \"cl100k_base\";\n\n/**\n * Resolve the tokenizer encoding for a model id, or `null` when no accurate\n * tokenizer is bundled (Anthropic, Google, unknown) — callers fall back to\n * the bytes/4 heuristic.\n */\nexport function encodingForModel(model: string): TokenEncoding | null {\n\tconst m = model.toLowerCase();\n\t// GPT-4o family and o-series / GPT-5 use o200k_base.\n\tif (\n\t\tm.includes(\"gpt-4o\") ||\n\t\tm.includes(\"gpt-5\") ||\n\t\t/^o[134]\\b/.test(m) ||\n\t\tm.includes(\"o1\") ||\n\t\tm.includes(\"o3\") ||\n\t\tm.includes(\"o4\")\n\t) {\n\t\treturn \"o200k_base\";\n\t}\n\t// GPT-4 / GPT-3.5 / embeddings use cl100k_base.\n\tif (\n\t\tm.includes(\"gpt-4\") ||\n\t\tm.includes(\"gpt-3.5\") ||\n\t\tm.includes(\"text-embedding\")\n\t) {\n\t\treturn \"cl100k_base\";\n\t}\n\treturn null;\n}\n\n/**\n * Count tokens accurately for OpenAI-clade models; fall back to the shared\n * bytes/4 heuristic otherwise (or when `model` is unknown/omitted).\n */\nexport function countTokens(text: string, model?: string): number {\n\tif (!model) {\n\t\treturn estimateTokens(text);\n\t}\n\tconst encoding = encodingForModel(model);\n\tif (!encoding) {\n\t\treturn estimateTokens(text);\n\t}\n\ttry {\n\t\treturn encoding === \"o200k_base\" ? countO200k(text) : countCl100k(text);\n\t} catch {\n\t\treturn estimateTokens(text);\n\t}\n}\n"]}

package/dist/agent/transport/events.d.ts

@@ -1,4 +1,4 @@
-import { type SkillArtifactMetadata } from "../../skills/artifact-metadata.js";
+import { type SkillArtifactMetadata } from "../skill-artifact-metadata.js";
 import type { AgentEvent } from "../types.js";
 type GovernedToolOutcome = "approval_required" | "approval_pending" | "authentication_required" | "denied" | "rate_limited";
 export declare class AgentEventQueue {

package/dist/agent/transport/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/agent/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,mBAAmB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,yBAAyB,GACzB,QAAQ,GACR,cAAc,CAAC;AAElB,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAC,CAAa;IAE1B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAU7B,KAAK,IAAI,UAAU,GAAG,SAAS;IAI/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,kBAAkB,IAAI,IAAI;CAI1B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKrE;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,GAAG;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACtC,CA+BA;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG;IAClE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACtC,CAIA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/agent/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,mBAAmB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,yBAAyB,GACzB,QAAQ,GACR,cAAc,CAAC;AAElB,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAC,CAAa;IAE1B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAU7B,KAAK,IAAI,UAAU,GAAG,SAAS;IAI/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,kBAAkB,IAAI,IAAI;CAI1B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKrE;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,GAAG;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACtC,CA+BA;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG;IAClE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACtC,CAIA"}

package/dist/agent/transport/events.js

@@ -1,4 +1,4 @@
-import { getSkillArtifactMetadataFromDetails, } from "../../skills/artifact-metadata.js";
+import { getSkillArtifactMetadataFromDetails, } from "../skill-artifact-metadata.js";
 export class AgentEventQueue {
     constructor() {
         this.events = [];

package/dist/agent/transport/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/agent/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mCAAmC,GACnC,MAAM,mCAAmC,CAAC;AAU3C,MAAM,OAAO,eAAe;IAA5B;QACS,WAAM,GAAiB,EAAE,CAAC;IAkCnC,CAAC;IA9BA,IAAI,CAAC,KAAiB;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,CAAC;QACR,CAAC;IACF,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YACrB,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,kBAAkB;QACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAiB;IAC3D,OAAO,CACN,KAAK,CAAC,IAAI,KAAK,0BAA0B;QACzC,KAAK,CAAC,IAAI,KAAK,0BAA0B,CACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAgB;IAKlE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,eAAe,GAAI,OAAyC;SAChE,eAAe,CAAC;IAClB,IAAI,CAAC,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,eAA0C,CAAC;IAC9D,MAAM,cAAc,GACnB,OAAO,UAAU,CAAC,cAAc,KAAK,QAAQ;QAC5C,CAAC,CAAE,UAAU,CAAC,cAAsC;QACpD,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,SAAS,GACd,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACxB,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,iBAAiB,GACtB,OAAO,UAAU,CAAC,iBAAiB,KAAK,QAAQ;QAChD,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE;QACrC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACN,SAAS;QACT,iBAAiB;QACjB,eAAe,EAAE,cAAc;KAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,OAAgB;IAG/D,OAAO;QACN,aAAa,EAAE,mCAAmC,CAAC,OAAO,CAAC;KAC3D,CAAC;AACH,CAAC","sourcesContent":["import {\n\ttype SkillArtifactMetadata,\n\tgetSkillArtifactMetadataFromDetails,\n} from \"../../skills/artifact-metadata.js\";\nimport type { AgentEvent } from \"../types.js\";\n\ntype GovernedToolOutcome =\n\t| \"approval_required\"\n\t| \"approval_pending\"\n\t| \"authentication_required\"\n\t| \"denied\"\n\t| \"rate_limited\";\n\nexport class AgentEventQueue {\n\tprivate events: AgentEvent[] = [];\n\tprivate pending?: Promise<void>;\n\tprivate wake?: () => void;\n\n\tpush(event: AgentEvent): void {\n\t\tthis.events.push(event);\n\t\tif (this.wake) {\n\t\t\tconst wake = this.wake;\n\t\t\tthis.pending = undefined;\n\t\t\tthis.wake = undefined;\n\t\t\twake();\n\t\t}\n\t}\n\n\tshift(): AgentEvent | undefined {\n\t\treturn this.events.shift();\n\t}\n\n\twait(): Promise<void> {\n\t\tif (this.events.length > 0) {\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tif (!this.pending) {\n\t\t\tthis.pending = new Promise<void>((resolve) => {\n\t\t\t\tthis.wake = resolve;\n\t\t\t});\n\t\t}\n\t\treturn this.pending;\n\t}\n\n\tclearPendingWaiter(): void {\n\t\tthis.pending = undefined;\n\t\tthis.wake = undefined;\n\t}\n}\n\nexport function isDynamicToolApprovalEvent(event: AgentEvent): boolean {\n\treturn (\n\t\tevent.type === \"action_approval_required\" ||\n\t\tevent.type === \"action_approval_resolved\"\n\t);\n}\n\nexport function getGovernedToolResultEventMetadata(details: unknown): {\n\terrorCode?: string;\n\tapprovalRequestId?: string;\n\tgovernedOutcome?: GovernedToolOutcome;\n} {\n\tif (!details || typeof details !== \"object\") {\n\t\treturn {};\n\t}\n\n\tconst governedOutcome = (details as { governedOutcome?: unknown })\n\t\t.governedOutcome;\n\tif (!governedOutcome || typeof governedOutcome !== \"object\") {\n\t\treturn {};\n\t}\n\n\tconst normalized = governedOutcome as Record<string, unknown>;\n\tconst classification =\n\t\ttypeof normalized.classification === \"string\"\n\t\t\t? (normalized.classification as GovernedToolOutcome)\n\t\t\t: undefined;\n\tconst errorCode =\n\t\ttypeof normalized.code === \"string\" && normalized.code.trim().length > 0\n\t\t\t? normalized.code.trim()\n\t\t\t: classification;\n\tconst approvalRequestId =\n\t\ttypeof normalized.approvalRequestId === \"string\" &&\n\t\tnormalized.approvalRequestId.trim().length > 0\n\t\t\t? normalized.approvalRequestId.trim()\n\t\t\t: undefined;\n\n\treturn {\n\t\terrorCode,\n\t\tapprovalRequestId,\n\t\tgovernedOutcome: classification,\n\t};\n}\n\nexport function getSkillToolResultEventMetadata(details: unknown): {\n\tskillMetadata?: SkillArtifactMetadata;\n} {\n\treturn {\n\t\tskillMetadata: getSkillArtifactMetadataFromDetails(details),\n\t};\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/agent/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mCAAmC,GACnC,MAAM,+BAA+B,CAAC;AAUvC,MAAM,OAAO,eAAe;IAA5B;QACS,WAAM,GAAiB,EAAE,CAAC;IAkCnC,CAAC;IA9BA,IAAI,CAAC,KAAiB;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,CAAC;QACR,CAAC;IACF,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YACrB,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,kBAAkB;QACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAiB;IAC3D,OAAO,CACN,KAAK,CAAC,IAAI,KAAK,0BAA0B;QACzC,KAAK,CAAC,IAAI,KAAK,0BAA0B,CACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAgB;IAKlE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,eAAe,GAAI,OAAyC;SAChE,eAAe,CAAC;IAClB,IAAI,CAAC,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,eAA0C,CAAC;IAC9D,MAAM,cAAc,GACnB,OAAO,UAAU,CAAC,cAAc,KAAK,QAAQ;QAC5C,CAAC,CAAE,UAAU,CAAC,cAAsC;QACpD,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,SAAS,GACd,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACxB,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,iBAAiB,GACtB,OAAO,UAAU,CAAC,iBAAiB,KAAK,QAAQ;QAChD,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE;QACrC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACN,SAAS;QACT,iBAAiB;QACjB,eAAe,EAAE,cAAc;KAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,OAAgB;IAG/D,OAAO;QACN,aAAa,EAAE,mCAAmC,CAAC,OAAO,CAAC;KAC3D,CAAC;AACH,CAAC","sourcesContent":["import {\n\ttype SkillArtifactMetadata,\n\tgetSkillArtifactMetadataFromDetails,\n} from \"../skill-artifact-metadata.js\";\nimport type { AgentEvent } from \"../types.js\";\n\ntype GovernedToolOutcome =\n\t| \"approval_required\"\n\t| \"approval_pending\"\n\t| \"authentication_required\"\n\t| \"denied\"\n\t| \"rate_limited\";\n\nexport class AgentEventQueue {\n\tprivate events: AgentEvent[] = [];\n\tprivate pending?: Promise<void>;\n\tprivate wake?: () => void;\n\n\tpush(event: AgentEvent): void {\n\t\tthis.events.push(event);\n\t\tif (this.wake) {\n\t\t\tconst wake = this.wake;\n\t\t\tthis.pending = undefined;\n\t\t\tthis.wake = undefined;\n\t\t\twake();\n\t\t}\n\t}\n\n\tshift(): AgentEvent | undefined {\n\t\treturn this.events.shift();\n\t}\n\n\twait(): Promise<void> {\n\t\tif (this.events.length > 0) {\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tif (!this.pending) {\n\t\t\tthis.pending = new Promise<void>((resolve) => {\n\t\t\t\tthis.wake = resolve;\n\t\t\t});\n\t\t}\n\t\treturn this.pending;\n\t}\n\n\tclearPendingWaiter(): void {\n\t\tthis.pending = undefined;\n\t\tthis.wake = undefined;\n\t}\n}\n\nexport function isDynamicToolApprovalEvent(event: AgentEvent): boolean {\n\treturn (\n\t\tevent.type === \"action_approval_required\" ||\n\t\tevent.type === \"action_approval_resolved\"\n\t);\n}\n\nexport function getGovernedToolResultEventMetadata(details: unknown): {\n\terrorCode?: string;\n\tapprovalRequestId?: string;\n\tgovernedOutcome?: GovernedToolOutcome;\n} {\n\tif (!details || typeof details !== \"object\") {\n\t\treturn {};\n\t}\n\n\tconst governedOutcome = (details as { governedOutcome?: unknown })\n\t\t.governedOutcome;\n\tif (!governedOutcome || typeof governedOutcome !== \"object\") {\n\t\treturn {};\n\t}\n\n\tconst normalized = governedOutcome as Record<string, unknown>;\n\tconst classification =\n\t\ttypeof normalized.classification === \"string\"\n\t\t\t? (normalized.classification as GovernedToolOutcome)\n\t\t\t: undefined;\n\tconst errorCode =\n\t\ttypeof normalized.code === \"string\" && normalized.code.trim().length > 0\n\t\t\t? normalized.code.trim()\n\t\t\t: classification;\n\tconst approvalRequestId =\n\t\ttypeof normalized.approvalRequestId === \"string\" &&\n\t\tnormalized.approvalRequestId.trim().length > 0\n\t\t\t? normalized.approvalRequestId.trim()\n\t\t\t: undefined;\n\n\treturn {\n\t\terrorCode,\n\t\tapprovalRequestId,\n\t\tgovernedOutcome: classification,\n\t};\n}\n\nexport function getSkillToolResultEventMetadata(details: unknown): {\n\tskillMetadata?: SkillArtifactMetadata;\n} {\n\treturn {\n\t\tskillMetadata: getSkillArtifactMetadataFromDetails(details),\n\t};\n}\n"]}