@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/agents/archetypes.d.ts

@@ -8,32 +8,32 @@ export interface AgentArchetype {
     /** Tool names the agent has access to. */
     tools: string[];
     /** Model override (optional). */
-    model?: string;
+    model?: string | undefined;
     /** Provider override (optional). */
-    provider?: string;
+    provider?: string | undefined;
     /** System prompt injected at agent start (optional). */
-    systemPrompt?: string;
+    systemPrompt?: string | undefined;
     /** True if loaded from a markdown file, false if built-in. */
     isCustom: boolean;
     /** Where this archetype came from. */
     origin: 'builtin' | 'local-markdown';
     /** Source path when loaded from a markdown file. */
-    sourcePath?: string;
+    sourcePath?: string | undefined;
     /** Validation or schema issues discovered while loading. */
-    validationIssues?: readonly string[];
+    validationIssues?: readonly string[] | undefined;
     /** Brief preview of the archetype body. */
-    preview?: string;
+    preview?: string | undefined;
     /** Lazy @ references discovered in the body. */
-    includes?: readonly string[];
+    includes?: readonly string[] | undefined;
     /** Markdown headings discovered in the body. */
-    sections?: readonly string[];
+    sections?: readonly string[] | undefined;
 }
 /** Loads and caches agent archetypes from .goodvibes/agents/*.md files.
  *
  * Progressive loading:
  *  - `listArchetypes()` returns all known archetypes (frontmatter only);
  *    full body (system_prompt) is populated on first call to `loadArchetype()`.
- *  - Falls back to built-in templates when no .md file is found.
+ *  - Built-in archetypes are available when no local .md file is found.
  */
 export declare class ArchetypeLoader {
     /** Map from archetype name -> AgentArchetype (may be partially loaded) */
@@ -57,9 +57,9 @@ export declare class ArchetypeLoader {
      *  Override properties take precedence over archetype defaults.
      *  Returns null if the named archetype is not found. */
     mergeWithOverrides(name: string, overrides: {
-        model?: string;
-        provider?: string;
-        tools?: string[];
+        model?: string | undefined;
+        provider?: string | undefined;
+        tools?: string[] | undefined;
     }): AgentArchetype | null;
     /** Clear all cached archetypes and force re-scan on next access.
      *  Primarily for testing. */

package/dist/platform/agents/archetypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/archetypes.ts"],"names":[],"mappings":"AAeA;kCACkC;AAClC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACrC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAmKD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,KAAK,CAAqC;IAClD,0DAA0D;IAC1D,OAAO,CAAC,SAAS,CAA6B;IAC9C,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,CAAC,EAAE,MAAM;IAQxB;8CAC0C;IAC1C,OAAO,CAAC,IAAI;IAyEZ;2DACuD;IACvD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkBlD,qEAAqE;IACrE,cAAc,IAAI,cAAc,EAAE;IAKlC;;4DAEwD;IACxD,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,GACA,cAAc,GAAG,IAAI;IAYxB;iCAC6B;IAC7B,KAAK,IAAI,IAAI;CAKd"}
+{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/archetypes.ts"],"names":[],"mappings":"AAeA;kCACkC;AAClC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACrC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC1C;AAkKD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,KAAK,CAAqC;IAClD,0DAA0D;IAC1D,OAAO,CAAC,SAAS,CAA6B;IAC9C,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,CAAC,EAAE,MAAM;IAQxB;8CAC0C;IAC1C,OAAO,CAAC,IAAI;IAyEZ;2DACuD;IACvD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkBlD,qEAAqE;IACrE,cAAc,IAAI,cAAc,EAAE;IAKlC;;4DAEwD;IACxD,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KAC9B,GACA,cAAc,GAAG,IAAI;IAYxB;iCAC6B;IAC7B,KAAK,IAAI,IAAI;CAKd"}

package/dist/platform/agents/archetypes.js

@@ -4,8 +4,7 @@ import { logger } from '../utils/logger.js';
 import { summarizeError } from '../utils/error-display.js';
 import { collectMarkdownReferences, extractMarkdownPreview, extractMarkdownSections, materializeMarkdownBody, } from '../utils/markdown-disclosure.js';
 // ---------------------------------------------------------------------------
-// Built-in fallback templates
-// Mirrors the AGENT_TEMPLATES in src/tools/agent/index.ts so that
+// Built-in archetypes mirror AGENT_TEMPLATES in src/tools/agent/index.ts so
 // archetypes.ts has no circular dependency on the tool module.
 // ---------------------------------------------------------------------------
 const BUILT_IN_ARCHETYPES = [
@@ -71,7 +70,7 @@ function parseSimpleYaml(yaml) {
         // List item under current key
         const listItemMatch = line.match(/^\s+-\s+(.+)$/);
         if (listItemMatch && collectingList) {
-            listBuffer.push(listItemMatch[1].trim());
+            listBuffer.push(listItemMatch[1]?.trim() ?? '');
             continue;
         }
         // Key: value line
@@ -81,7 +80,7 @@ function parseSimpleYaml(yaml) {
             if (collectingList)
                 flushList();
             currentKey = kvMatch[1];
-            const rawValue = kvMatch[2].trim();
+            const rawValue = kvMatch[2]?.trim() ?? '';
             if (!rawValue) {
                 // Value will be on following list lines
                 collectingList = true;
@@ -140,7 +139,7 @@ function validateArchetype(archetype) {
  * Progressive loading:
  *  - `listArchetypes()` returns all known archetypes (frontmatter only);
  *    full body (system_prompt) is populated on first call to `loadArchetype()`.
- *  - Falls back to built-in templates when no .md file is found.
+ *  - Built-in archetypes are available when no local .md file is found.
  */
 export class ArchetypeLoader {
     /** Map from archetype name -> AgentArchetype (may be partially loaded) */
@@ -163,7 +162,7 @@ export class ArchetypeLoader {
         if (this.scanned)
             return;
         this.scanned = true;
-        // Seed with built-ins first so they act as fallbacks
+        // Seed built-ins first; local markdown files override matching names.
         for (const builtin of BUILT_IN_ARCHETYPES) {
             this.cache.set(builtin.name, { ...builtin });
         }

package/dist/platform/agents/communication-policy.d.ts

@@ -3,14 +3,14 @@ export type AgentCommunicationRole = 'orchestrator' | 'planner' | 'engineer' | '
 export interface AgentCommunicationMetadata {
     agentId: string;
     role: AgentCommunicationRole;
-    parentAgentId?: string;
-    cohort?: string;
-    wrfcId?: string;
+    parentAgentId?: string | undefined;
+    cohort?: string | undefined;
+    wrfcId?: string | undefined;
 }
 export declare function communicationRoleForTemplate(template?: string): AgentCommunicationRole;
 export interface CommunicationDecision {
     allowed: boolean;
-    reason?: string;
+    reason?: string | undefined;
 }
 export declare function evaluateCommunicationRoute(input: {
     from: AgentCommunicationMetadata;

package/dist/platform/agents/communication-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communication-policy.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/communication-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAatF;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,0BAA0B,CAAC;IACjC,EAAE,EAAE,0BAA0B,CAAC;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,qBAAqB,CAwCxB"}
+{"version":3,"file":"communication-policy.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/communication-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAatF;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAcD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,0BAA0B,CAAC;IACjC,EAAE,EAAE,0BAA0B,CAAC;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,qBAAqB,CAwCxB"}

package/dist/platform/agents/completion-report.d.ts

@@ -8,7 +8,7 @@ export interface BaseCompletionReport {
     version: 1;
     archetype: string;
     summary: string;
-    wrfcId?: string;
+    wrfcId?: string | undefined;
 }
 /**
  * A single constraint extracted from the task prompt or inherited from a parent chain.
@@ -43,7 +43,7 @@ export interface EngineerReport extends BaseCompletionReport {
     issues: string[];
     uncertainties: string[];
     /** Constraints enumerated from the task prompt (or inherited from parent chain). Defaults to [] when absent. */
-    constraints?: Constraint[];
+    constraints?: Constraint[] | undefined;
 }
 /** Reviewer agent completion report. */
 export interface ReviewerReport extends BaseCompletionReport {
@@ -59,12 +59,12 @@ export interface ReviewerReport extends BaseCompletionReport {
     issues: Array<{
         severity: 'critical' | 'major' | 'minor' | 'suggestion';
         description: string;
-        file?: string;
-        line?: number;
+        file?: string | undefined;
+        line?: number | undefined;
         pointValue: number;
     }>;
     /** Per-constraint satisfaction findings from the reviewer. Defaults to [] when absent. */
-    constraintFindings?: ConstraintFinding[];
+    constraintFindings?: ConstraintFinding[] | undefined;
 }
 /** Tester agent completion report. */
 export interface TesterReport extends BaseCompletionReport {

package/dist/platform/agents/completion-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF;;;GAGG;AAEH,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;CAC3C;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,SAAS,EAAE,UAAU,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gHAAgH;IAChH,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;QACxD,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;CACtD;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAqE9F,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA6ChF"}

package/dist/platform/agents/completion-report.js

@@ -15,9 +15,50 @@ function isWellFormedConstraintFinding(f) {
     if (typeof f !== 'object' || f === null)
         return false;
     const obj = f;
+    const severity = obj['severity'];
     return (typeof obj['constraintId'] === 'string' && obj['constraintId'].length > 0 &&
         typeof obj['satisfied'] === 'boolean' &&
-        typeof obj['evidence'] === 'string' && obj['evidence'].length > 0);
+        typeof obj['evidence'] === 'string' && obj['evidence'].length > 0 &&
+        (severity === undefined || severity === 'critical' || severity === 'major' || severity === 'minor'));
+}
+function filterWellFormed(raw, guard) {
+    if (raw === undefined)
+        return { items: [], dropped: 0, malformedContainer: false };
+    if (!Array.isArray(raw))
+        return { items: [], dropped: 0, malformedContainer: true };
+    const items = [];
+    let dropped = 0;
+    for (const item of raw) {
+        if (guard(item)) {
+            items.push(item);
+        }
+        else {
+            dropped += 1;
+        }
+    }
+    return { items, dropped, malformedContainer: false };
+}
+function appendEngineerIssue(report, issue) {
+    const existing = Array.isArray(report['issues'])
+        ? report['issues'].filter((item) => typeof item === 'string')
+        : [];
+    report['issues'] = [...existing, issue];
+}
+function appendReviewerIssue(report, description) {
+    const existing = Array.isArray(report['issues'])
+        ? report['issues'].filter((item) => typeof item === 'object' && item !== null &&
+            typeof item.severity === 'string' &&
+            typeof item.description === 'string' &&
+            typeof item.pointValue === 'number')
+        : [];
+    report['issues'] = [
+        ...existing,
+        {
+            severity: 'major',
+            description,
+            pointValue: 2,
+        },
+    ];
 }
 export function parseCompletionReport(rawOutput) {
     // Strategy 1: Find ```json ... ``` block
@@ -77,7 +118,7 @@ export function parseCompletionReport(rawOutput) {
 /**
  * Normalize constraint-related fields on a parsed report:
  * - defaults `constraints` and `constraintFindings` to []
- * - silently filters out malformed entries
+ * - filters malformed entries and records a report issue so drops are observable
  *
  * Pure: returns a new object rather than mutating the input, so callers can
  * share references without surprise writes.
@@ -85,12 +126,24 @@ export function parseCompletionReport(rawOutput) {
 function applyConstraintDefaults(parsed) {
     const next = { ...parsed };
     if (next['archetype'] === 'engineer') {
-        const raw = next['constraints'];
-        next['constraints'] = Array.isArray(raw) ? raw.filter(isWellFormedConstraint) : [];
+        const normalized = filterWellFormed(next['constraints'], isWellFormedConstraint);
+        next['constraints'] = normalized.items;
+        if (normalized.malformedContainer) {
+            appendEngineerIssue(next, 'Malformed constraints field ignored: expected an array.');
+        }
+        else if (normalized.dropped > 0) {
+            appendEngineerIssue(next, `Malformed constraints ignored: ${normalized.dropped} entr${normalized.dropped === 1 ? 'y' : 'ies'}.`);
+        }
     }
     if (next['archetype'] === 'reviewer') {
-        const raw = next['constraintFindings'];
-        next['constraintFindings'] = Array.isArray(raw) ? raw.filter(isWellFormedConstraintFinding) : [];
+        const normalized = filterWellFormed(next['constraintFindings'], isWellFormedConstraintFinding);
+        next['constraintFindings'] = normalized.items;
+        if (normalized.malformedContainer) {
+            appendReviewerIssue(next, 'Malformed constraintFindings field ignored: expected an array.');
+        }
+        else if (normalized.dropped > 0) {
+            appendReviewerIssue(next, `Malformed constraintFindings ignored: ${normalized.dropped} entr${normalized.dropped === 1 ? 'y' : 'ies'}.`);
+        }
     }
     return next;
 }

package/dist/platform/agents/message-bus-core.d.ts

@@ -10,20 +10,20 @@ export interface AgentMessage {
     ttlMs: number;
     kind: CommunicationKind;
     scope: CommunicationScope;
-    fromRole?: string;
-    toRole?: string;
-    cohort?: string;
-    wrfcId?: string;
-    parentAgentId?: string;
+    fromRole?: string | undefined;
+    toRole?: string | undefined;
+    cohort?: string | undefined;
+    wrfcId?: string | undefined;
+    parentAgentId?: string | undefined;
 }
 export type MessageCallback = (message: AgentMessage) => void;
 type MessageOptions = {
-    ttlMs?: number;
-    kind?: CommunicationKind;
-    scope?: CommunicationScope;
-    cohort?: string;
-    wrfcId?: string;
-    parentAgentId?: string;
+    ttlMs?: number | undefined;
+    kind?: CommunicationKind | undefined;
+    scope?: CommunicationScope | undefined;
+    cohort?: string | undefined;
+    wrfcId?: string | undefined;
+    parentAgentId?: string | undefined;
 };
 export declare class AgentMessageBus {
     private messages;
@@ -33,11 +33,11 @@ export declare class AgentMessageBus {
     setRuntimeBus(runtimeBus: RuntimeEventBus | null): void;
     registerAgent(meta: {
         agentId: string;
-        template?: string;
-        role?: AgentCommunicationMetadata['role'];
-        parentAgentId?: string;
-        cohort?: string;
-        wrfcId?: string;
+        template?: string | undefined;
+        role?: AgentCommunicationMetadata['role'] | undefined;
+        parentAgentId?: string | undefined;
+        cohort?: string | undefined;
+        wrfcId?: string | undefined;
     }): void;
     private resolveOptions;
     send(fromId: string, toId: string, content: string, ttlOrOptions?: number | MessageOptions): boolean;

package/dist/platform/agents/message-bus-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-bus-core.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/message-bus-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAG3F,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,UAAU,CAEf;IACH,OAAO,CAAC,UAAU,CAAgC;IAElD,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAIvD,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI;IAUR,OAAO,CAAC,cAAc;IActB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,cAA+B,GAAG,OAAO;IA2CpH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,cAA+B,GAAG,OAAO;IAmD3G,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAgBjE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAY5C,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAsCnB,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,OAAO;CAahB"}
+{"version":3,"file":"message-bus-core.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/message-bus-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAG3F,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,UAAU,CAEf;IACH,OAAO,CAAC,UAAU,CAAgC;IAElD,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAIvD,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QACtD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GAAG,IAAI;IAUR,OAAO,CAAC,cAAc;IActB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,cAA+B,GAAG,OAAO;IA2CpH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,cAA+B,GAAG,OAAO;IAmD3G,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAgBjE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAY5C,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAsCnB,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,OAAO;CAahB"}

package/dist/platform/agents/message-bus-core.js

@@ -112,7 +112,7 @@ export class AgentMessageBus {
                     callback(message);
                 }
                 catch (error) {
-                    logger.debug('MessageBus: subscriber error in broadcast', {
+                    logger.warn('MessageBus: subscriber error in broadcast', {
                         error: summarizeError(error),
                     });
                 }
@@ -126,7 +126,7 @@ export class AgentMessageBus {
         if (!this.subscriptions.has(agentId)) {
             this.subscriptions.set(agentId, new Set());
         }
-        this.subscriptions.get(agentId).add(callback);
+        this.subscriptions.get(agentId)?.add(callback);
         return () => {
             const callbacks = this.subscriptions.get(agentId);
             if (!callbacks)
@@ -224,7 +224,7 @@ export class AgentMessageBus {
         if (!this.messages.has(recipientId)) {
             this.messages.set(recipientId, []);
         }
-        this.messages.get(recipientId).push(message);
+        this.messages.get(recipientId)?.push(message);
     }
     deliver(agentId, message) {
         const callbacks = this.subscriptions.get(agentId);
@@ -235,7 +235,7 @@ export class AgentMessageBus {
                 callback(message);
             }
             catch (error) {
-                logger.debug('MessageBus: subscriber error in deliver', {
+                logger.warn('MessageBus: subscriber error in deliver', {
                     error: summarizeError(error),
                 });
             }

package/dist/platform/agents/orchestrator-prompts.d.ts

@@ -4,13 +4,13 @@ type PromptContextDeps = {
     readonly workingDirectory: string;
     readonly knowledgeService?: {
         buildPromptPacketSync(task: string, writeScope?: readonly string[]): string | null;
-    };
-    readonly memoryRegistry?: Pick<MemoryRegistry, 'getAll' | 'searchSemantic'>;
+    } | undefined;
+    readonly memoryRegistry?: Pick<MemoryRegistry, 'getAll' | 'searchSemantic'> | undefined;
     readonly archetypeLoader?: {
         loadArchetype(template: string): {
-            systemPrompt?: string;
+            systemPrompt?: string | undefined;
         } | null | undefined;
-    };
+    } | undefined;
 };
 /**
  * Build a layered system prompt from base instructions, archetype, project

package/dist/platform/agents/orchestrator-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-prompts.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-prompts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC1B,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;KACpF,CAAC;IACF,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,gBAAgB,CAAC,CAAC;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAC;KAC/E,CAAC;CACH,CAAC;AAmFF;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,MAAM,CA8LR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,iBAAiB,GACvB,MAAM,CAwCR"}
+{"version":3,"file":"orchestrator-prompts.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-prompts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EACtB;QACE,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;KACpF,GACD,SAAS,CAAC;IACd,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACxF,QAAQ,CAAC,eAAe,CAAC,EACrB;QACE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;YAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAC;KAC3F,GACD,SAAS,CAAC;CACf,CAAC;AAmFF;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,MAAM,CA8LR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,iBAAiB,GACvB,MAAM,CAwCR"}

package/dist/platform/agents/orchestrator-prompts.js

@@ -217,7 +217,7 @@ The report format depends on your role:
         parts.push(archetype.systemPrompt);
     }
     else {
-        // Fallback: minimal role description from built-in templates
+        // Use the minimal role description from built-in templates.
         const roleDescriptions = {
             engineer: '## Role: Engineer\nFull-stack implementation agent. Build production-ready features with error handling, type safety, input validation, and security. Follow existing project patterns.\n\nEngineer execution protocol:\n1. Gather: read the necessary files, symbols, and constraints before editing.\n2. Plan: decide the exact writes and tool actions before making changes.\n3. Apply: perform the smallest correct set of edits and validations.\n\nYour final message MUST include a structured EngineerReport JSON block with gatheredContext, plannedActions, and appliedChanges (see Structured Output section).\n\nWill NOT do: architecture planning, code review, test writing, deployment.',
             reviewer: '## Role: Reviewer\nCode review and quality assessment agent. Evaluate code for correctness, security, performance, and adherence to project conventions. Produce structured pass/fail assessments with specific issues.\n\nYour final message MUST include a structured ReviewerReport JSON block (see Structured Output section).\n\nWill NOT do: implementation, deployment, testing.',
@@ -314,7 +314,7 @@ export function buildLayeredOrchestratorSystemPrompt(record, remainingTokens, de
         logger.info('[AgentOrchestrator] context-window awareness: system prompt trimmed - dropped conventions + project context', { agentId: record.id });
         return noContext;
     }
-    // Final fallback: truncate the reduced prompt to fit
+    // Final bounded reduction: truncate the reduced prompt to fit.
     const targetChars = remainingTokens * 4; // rough chars from tokens
     const truncated = noContext.length > targetChars
         ? noContext.slice(0, targetChars) + '\n[...system prompt truncated to fit context window]'

package/dist/platform/agents/orchestrator-runner.d.ts

@@ -1,5 +1,6 @@
 import { ToolRegistry } from '../tools/registry.js';
 import type { ProviderRegistry } from '../providers/registry.js';
+import type { ModelDefinition } from '../providers/registry-types.js';
 import type { ProviderOptimizer } from '../providers/optimizer.js';
 import type { AgentRecord } from '../tools/agent/index.js';
 import type { LLMProvider } from '../providers/interface.js';
@@ -8,11 +9,10 @@ import type { FeatureFlagManager } from '../runtime/feature-flags/manager.js';
 import type { RuntimeEventBus } from '../runtime/events/index.js';
 import type { AgentMessageBus } from './message-bus.js';
 import type { KnowledgeService } from '../knowledge/index.js';
-import type { ArchetypeLoader } from './archetypes.js';
 type EmitterContext = import('../runtime/emitters/index.js').EmitterContext;
 export interface AgentOrchestratorRunContext {
     readonly workingDirectory: string;
-    readonly surfaceRoot?: string;
+    readonly surfaceRoot?: string | undefined;
     readonly runtimeBus: RuntimeEventBus | null;
     readonly featureFlagManager: FeatureFlagManager | null;
     readonly emitterContext: (agentId: string) => EmitterContext;
@@ -26,18 +26,23 @@ export interface AgentOrchestratorRunContext {
     readonly emitAgentCompletedEvent: (recordId: string, durationMs: number, output: string, toolCallsMade: number) => void;
     readonly emitOrchestrationCompleted: (record: AgentRecord, output: string) => void;
     readonly emitStreamDelta: (recordId: string, content: string, accumulated: string) => void;
-    readonly processManager?: ProcessManager;
+    readonly processManager?: ProcessManager | undefined;
     readonly messageBus: Pick<AgentMessageBus, 'getMessages'>;
-    readonly knowledgeService?: Pick<KnowledgeService, 'buildPromptPacketSync'>;
-    readonly memoryRegistry?: Pick<import('../state/index.js').MemoryRegistry, 'getAll' | 'searchSemantic'>;
-    readonly archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'>;
+    readonly knowledgeService?: Pick<KnowledgeService, 'buildPromptPacketSync'> | undefined;
+    readonly memoryRegistry?: Pick<import('../state/index.js').MemoryRegistry, 'getAll' | 'searchSemantic'> | undefined;
+    readonly archetypeLoader?: {
+        loadArchetype(template: string): {
+            systemPrompt?: string | undefined;
+        } | null | undefined;
+    } | undefined;
     readonly getFullRegistry: () => ToolRegistry;
     readonly buildScopedRegistry: (allowedNames: string[], fullRegistry: ToolRegistry) => ToolRegistry;
     readonly providerRegistry: Pick<ProviderRegistry, 'getCurrentModel' | 'getForModel' | 'listModels' | 'getContextWindowForModel'>;
-    readonly providerOptimizer?: Pick<ProviderOptimizer, 'recordFallbackTransition'>;
+    readonly providerOptimizer?: Pick<ProviderOptimizer, 'recordFallbackTransition'> | undefined;
     readonly resolveProviderForRecord: (providerRegistry: Pick<ProviderRegistry, 'getCurrentModel' | 'getForModel' | 'listModels'>, record: AgentRecord, currentModel: {
         id: string;
         provider: string;
+        registryKey: string;
     }) => {
         provider: LLMProvider;
         modelId: string;
@@ -46,12 +51,19 @@ export interface AgentOrchestratorRunContext {
     readonly resolveFallbackModelRoutes: (providerRegistry: Pick<ProviderRegistry, 'listModels' | 'getForModel'>, record: AgentRecord, currentModel: {
         id: string;
         provider: string;
+        registryKey: string;
     }, primaryRequestedModelId: string) => Array<{
         provider: LLMProvider;
         modelId: string;
         requestedModelId: string;
     }>;
 }
+type ActiveProviderRoute = {
+    readonly provider: Pick<LLMProvider, 'name'>;
+    readonly modelId: string;
+    readonly requestedModelId: string;
+};
+export declare function resolveContextWindowModelDefinition(providerRegistry: Pick<ProviderRegistry, 'getCurrentModel' | 'listModels'>, activeRoute: ActiveProviderRoute): ModelDefinition;
 export declare function runAgentTask(context: AgentOrchestratorRunContext, record: AgentRecord): Promise<void>;
 export {};
 //# sourceMappingURL=orchestrator-runner.d.ts.map

package/dist/platform/agents/orchestrator-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-runner.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator-runner.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-runner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,2BAA2B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAc9D,KAAK,cAAc,GAAG,OAAO,8BAA8B,EAAE,cAAc,CAAC;AAE5E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;IAC7D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,QAAQ,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,uBAAuB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,QAAQ,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnF,QAAQ,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7F,QAAQ,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/E,QAAQ,CAAC,uBAAuB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACxH,QAAQ,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnF,QAAQ,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,GAAG,SAAS,CAAC;IACxF,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,OAAO,mBAAmB,EAAE,cAAc,EAAE,QAAQ,GAAG,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACpH,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;YAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACrI,QAAQ,CAAC,eAAe,EAAE,MAAM,YAAY,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,YAAY,KAAK,YAAY,CAAC;IACnG,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,aAAa,GAAG,YAAY,GAAG,0BAA0B,CAAC,CAAC;IACjI,QAAQ,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,GAAG,SAAS,CAAC;IAC7F,QAAQ,CAAC,wBAAwB,EAAE,CACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAC,EAC1F,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAChE;QAAE,QAAQ,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,0BAA0B,EAAE,CACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,aAAa,CAAC,EACtE,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EACnE,uBAAuB,EAAE,MAAM,KAC5B,KAAK,CAAC;QAAE,QAAQ,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF;AAED,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,CAAC;AAqBF,wBAAgB,mCAAmC,CACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,YAAY,CAAC,EAC1E,WAAW,EAAE,mBAAmB,GAC/B,eAAe,CAuBjB;AAmRD,wBAAsB,YAAY,CAChC,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAoUf"}