npm - @pellux/goodvibes-sdk - Versions diffs - 0.33.19 → 0.33.21 - Mend

@pellux/goodvibes-sdk 0.33.19 → 0.33.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (58) hide show

package/dist/platform/tools/agent/index.js CHANGED Viewed

@@ -5,6 +5,7 @@ import { AGENT_TEMPLATES, AgentManager } from './manager.js';
 import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-policy.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { toRecord } from '../../utils/record-coerce.js';
+import { evaluateWrfcBatchPolicy } from './wrfc-batch-policy.js';
 export { AGENT_TEMPLATES, AgentManager } from './manager.js';
 // ---------------------------------------------------------------------------
 // Tool implementation
@@ -23,6 +24,72 @@ function summarizeWrfcEvent(event) {
         issueCount: Array.isArray(event.issues) ? event.issues.length : undefined,
     };
 }
+function agentTopology(record) {
+    return {
+        parentAgentId: record.parentAgentId ?? null,
+        wrfcId: record.wrfcId ?? null,
+        wrfcRole: record.wrfcRole ?? null,
+        wrfcPhaseOrder: record.wrfcPhaseOrder ?? null,
+        wrfcRouteReason: record.wrfcRouteReason ?? null,
+        orchestrationGraphId: record.orchestrationGraphId ?? null,
+        orchestrationNodeId: record.orchestrationNodeId ?? null,
+        parentNodeId: record.parentNodeId ?? null,
+    };
+}
+function agentExecutionContract(record) {
+    return {
+        executionIntent: record.executionIntent ?? null,
+        tools: record.tools,
+        capabilityCeilingTools: record.capabilityCeilingTools ?? record.tools,
+        successCriteria: record.successCriteria ?? [],
+        requiredEvidence: record.requiredEvidence ?? [],
+        writeScope: record.writeScope ?? [],
+        executionProtocol: record.executionProtocol,
+        reviewMode: record.reviewMode,
+        communicationLane: record.communicationLane,
+        knowledgeInjections: record.knowledgeInjections ?? [],
+    };
+}
+function agentSummary(record) {
+    return {
+        id: record.id,
+        task: record.task,
+        template: record.template,
+        status: record.status,
+        startedAt: record.startedAt,
+        toolCallCount: record.toolCallCount,
+        cohort: record.cohort,
+        progress: record.progress,
+        ...agentTopology(record),
+    };
+}
+function batchTaskToSpawnInput(input, taskDef) {
+    return {
+        mode: 'spawn',
+        task: taskDef.task,
+        template: taskDef.template ?? input.template ?? 'general',
+        model: taskDef.model ?? input.model,
+        provider: taskDef.provider ?? input.provider,
+        fallbackModels: taskDef.fallbackModels ?? input.fallbackModels,
+        routing: taskDef.routing ?? input.routing,
+        reasoningEffort: taskDef.reasoningEffort ?? input.reasoningEffort,
+        tools: taskDef.tools ?? input.tools,
+        restrictTools: taskDef.restrictTools ?? input.restrictTools,
+        context: taskDef.context ?? input.context,
+        successCriteria: taskDef.successCriteria ?? input.successCriteria,
+        requiredEvidence: taskDef.requiredEvidence ?? input.requiredEvidence,
+        writeScope: taskDef.writeScope ?? input.writeScope,
+        executionProtocol: taskDef.executionProtocol ?? input.executionProtocol,
+        reviewMode: taskDef.reviewMode ?? input.reviewMode,
+        communicationLane: taskDef.communicationLane ?? input.communicationLane,
+        parentAgentId: taskDef.parentAgentId ?? input.parentAgentId,
+        orchestrationGraphId: taskDef.orchestrationGraphId ?? input.orchestrationGraphId,
+        orchestrationNodeId: taskDef.orchestrationNodeId,
+        parentNodeId: taskDef.parentNodeId ?? input.parentNodeId,
+        dangerously_disable_wrfc: taskDef.dangerously_disable_wrfc ?? input.dangerously_disable_wrfc,
+        cohort: input.cohort,
+    };
+}
 export function createAgentTool(config) {
     const archetypeLoader = config.archetypeLoader ?? new ArchetypeLoader();
     return {
@@ -78,17 +145,8 @@ export function createAgentTool(config) {
                             status: 'spawned',
                             template: record.template,
                             task: record.task,
-                            executionIntent: record.executionIntent ?? null,
-                            tools: record.tools,
-                            capabilityCeilingTools: record.capabilityCeilingTools ?? record.tools,
-                            successCriteria: record.successCriteria ?? [],
-                            requiredEvidence: record.requiredEvidence ?? [],
-                            writeScope: record.writeScope ?? [],
-                            executionProtocol: record.executionProtocol,
-                            reviewMode: record.reviewMode,
-                            communicationLane: record.communicationLane,
-                            knowledgeInjections: record.knowledgeInjections ?? [],
-                            parentAgentId: record.parentAgentId ?? null,
+                            ...agentExecutionContract(record),
+                            ...agentTopology(record),
                         }),
                     };
                 }
@@ -114,6 +172,7 @@ export function createAgentTool(config) {
                             toolCallCount: record.toolCallCount,
                             progress: record.progress,
                             error: record.error,
+                            ...agentTopology(record),
                         }),
                     };
                 }
@@ -142,15 +201,7 @@ export function createAgentTool(config) {
                     return {
                         success: true,
                         output: JSON.stringify({
-                            agents: records.map((r) => ({
-                                id: r.id,
-                                task: r.task,
-                                template: r.template,
-                                status: r.status,
-                                startedAt: r.startedAt,
-                                toolCallCount: r.toolCallCount,
-                                cohort: r.cohort,
-                            })),
+                            agents: records.map(agentSummary),
                             count: records.length,
                             ...(input.cohort ? { cohort: input.cohort } : {}),
                         }),
@@ -196,9 +247,7 @@ export function createAgentTool(config) {
                         executionProtocol: record.executionProtocol,
                         reviewMode: record.reviewMode,
                         communicationLane: record.communicationLane,
-                        parentAgentId: record.parentAgentId ?? null,
-                        orchestrationGraphId: record.orchestrationGraphId ?? null,
-                        orchestrationNodeId: record.orchestrationNodeId ?? null,
+                        ...agentTopology(record),
                     };
                     const contract = {
                         tools: record.tools,
@@ -374,6 +423,67 @@ export function createAgentTool(config) {
                     if (input.tasks.length > 20) {
                         return { success: false, error: 'batch-spawn limited to 20 tasks per batch.' };
                     }
+                    if (input.tasks.length === 1) {
+                        const taskDef = input.tasks[0];
+                        if (!taskDef.task || typeof taskDef.task !== 'string' || taskDef.task.trim() === '') {
+                            return { success: false, error: 'Each task in batch-spawn must have a non-empty task string.' };
+                        }
+                        if (taskDef.template && !AGENT_TEMPLATES[taskDef.template]) {
+                            const customArchetype = archetypeLoader.loadArchetype(taskDef.template);
+                            if (!customArchetype || customArchetype.isCustom === false) {
+                                return {
+                                    success: false,
+                                    error: `Unknown template: '${taskDef.template}'. Available: ${Object.keys(AGENT_TEMPLATES).join(', ')}`,
+                                };
+                            }
+                        }
+                        let record;
+                        try {
+                            record = manager.spawn(batchTaskToSpawnInput(input, taskDef));
+                        }
+                        catch (error) {
+                            return {
+                                success: false,
+                                error: summarizeError(error),
+                            };
+                        }
+                        return {
+                            success: true,
+                            output: JSON.stringify({
+                                agents: [{ ...agentSummary(record), task: record.task.slice(0, 80) }],
+                                count: 1,
+                                cohort: input.cohort,
+                                skipped: 0,
+                                normalizedToSpawn: true,
+                            }),
+                        };
+                    }
+                    const batchPolicy = evaluateWrfcBatchPolicy(input);
+                    if (batchPolicy.kind === 'collapse-to-wrfc') {
+                        let record;
+                        try {
+                            record = manager.spawn(batchPolicy.ownerInput);
+                        }
+                        catch (error) {
+                            return {
+                                success: false,
+                                error: `Failed to collapse role-decomposition batch into a WRFC owner chain: ${summarizeError(error)}`,
+                            };
+                        }
+                        return {
+                            success: true,
+                            output: JSON.stringify({
+                                agents: [{ ...agentSummary(record), task: record.task.slice(0, 80) }],
+                                count: 1,
+                                cohort: input.cohort,
+                                skipped: 0,
+                                collapsedToWrfc: true,
+                                collapsedTaskCount: input.tasks.length,
+                                reason: batchPolicy.reason,
+                                roleTaskIndexes: batchPolicy.roleTaskIndexes ?? [],
+                            }),
+                        };
+                    }
                     const currentCount = manager.list().filter(a => a.status === 'pending' || a.status === 'running').length;
                     const spawnDecision = evaluateOrchestrationSpawn({
                         configManager: config.configManager,
@@ -404,31 +514,7 @@ export function createAgentTool(config) {
                                 };
                             }
                         }
-                        const spawnInput = {
-                            mode: 'spawn',
-                            task: taskDef.task,
-                            template: taskDef.template ?? input.template ?? 'general',
-                            model: taskDef.model ?? input.model,
-                            provider: taskDef.provider ?? input.provider,
-                            fallbackModels: taskDef.fallbackModels ?? input.fallbackModels,
-                            routing: taskDef.routing ?? input.routing,
-                            reasoningEffort: taskDef.reasoningEffort ?? input.reasoningEffort,
-                            tools: taskDef.tools ?? input.tools,
-                            restrictTools: taskDef.restrictTools ?? input.restrictTools,
-                            context: taskDef.context ?? input.context,
-                            successCriteria: taskDef.successCriteria ?? input.successCriteria,
-                            requiredEvidence: taskDef.requiredEvidence ?? input.requiredEvidence,
-                            writeScope: taskDef.writeScope ?? input.writeScope,
-                            executionProtocol: taskDef.executionProtocol ?? input.executionProtocol,
-                            reviewMode: taskDef.reviewMode ?? input.reviewMode,
-                            communicationLane: taskDef.communicationLane ?? input.communicationLane,
-                            parentAgentId: taskDef.parentAgentId ?? input.parentAgentId,
-                            orchestrationGraphId: taskDef.orchestrationGraphId ?? input.orchestrationGraphId,
-                            orchestrationNodeId: taskDef.orchestrationNodeId,
-                            parentNodeId: taskDef.parentNodeId ?? input.parentNodeId,
-                            dangerously_disable_wrfc: taskDef.dangerously_disable_wrfc ?? input.dangerously_disable_wrfc,
-                            cohort: input.cohort,
-                        };
+                        const spawnInput = batchTaskToSpawnInput(input, taskDef);
                         let record;
                         try {
                             record = manager.spawn(spawnInput);
@@ -439,7 +525,7 @@ export function createAgentTool(config) {
                                 error: summarizeError(error),
                             };
                         }
-                        results.push({ id: record.id, task: taskDef.task.slice(0, 80), template: record.template, cohort: record.cohort });
+                        results.push({ ...agentSummary(record), task: taskDef.task.slice(0, 80) });
                     }
                     return {
                         success: true,

package/dist/platform/tools/agent/manager.d.ts CHANGED Viewed

@@ -52,6 +52,7 @@ export interface AgentRecord {
     streamingContent?: string | undefined;
     wrfcId?: string | undefined;
     wrfcRole?: WrfcAgentRole | undefined;
+    wrfcPhaseOrder?: number | undefined;
     wrfcRouteReason?: string | undefined;
     dangerously_disable_wrfc?: boolean | undefined;
     cohort?: string | undefined;

package/dist/platform/tools/agent/manager.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAcrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;~~AAEhE~~,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;CACjE;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB3F,CAAC;AAoBF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC5C,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,eAAe,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5C,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAClC,iBAAiB,EAAE,QAAQ,GAAG,mBAAmB,CAAC;IAClD,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iBAAiB,EAAE,aAAa,GAAG,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/E,6GAA6G;IAC7G,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAC1B,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;KAC9D,CAAC,CAAC;CACJ;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;gBAEtD,IAAI,GAAE,wBAA6B;IAQ/C,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAIvD,OAAO,CAAC,oBAAoB;IAkC5B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW;~~IAmQrC~~,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAkC3B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAI3C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAkB5C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAQtC,IAAI,IAAI,WAAW,EAAE;IAIrB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAI3C,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,WAAW,EAAE;IAU5B,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAOzC,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIjD,iBAAiB,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,IAAI,GAAG,IAAI;CAGpF"}
1	+ {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/manager.ts"],"names":[],"mappings":"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"}

package/dist/platform/tools/agent/manager.js CHANGED Viewed

@@ -7,6 +7,7 @@ import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-po
 import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { splitModelRegistryKey } from '../../providers/registry-helpers.js';
+import { isRootReviewRoleTask } from './wrfc-batch-policy.js';
 export const AGENT_TEMPLATES = {
     engineer: {
         description: 'Full-stack implementation agent',
@@ -90,14 +91,32 @@ export class AgentManager {
         };
     }
     spawn(input) {
-        const task = input.task;
+        let task = input.task;
         if (!task || typeof task !== 'string' || task.trim() === '') {
             throw new Error('spawn() requires a non-empty task string');
         }
         if (!this.configManager) {
             throw new Error('AgentManager requires configManager');
         }
-        const template = input.template ?? 'general';
+        let template = input.template ?? 'general';
+        if (!input.parentAgentId && isRootReviewRoleTask({ task, template })) {
+            input = {
+                ...input,
+                template: 'engineer',
+                reviewMode: 'wrfc',
+                dangerously_disable_wrfc: false,
+                context: [
+                    input.context?.trim(),
+                    'SDK WRFC topology enforcement normalized this root review/test/verification task into a single owner chain. Review, test, verification, and fix work are lifecycle phases owned by the WRFC controller, not independent root agents.',
+                ].filter((part) => Boolean(part)).join('\n\n'),
+                successCriteria: [
+                    ...(input.successCriteria ?? []),
+                    'Keep the work as one WRFC owner chain; review, test, verification, and fix phases must remain lifecycle children.',
+                ],
+            };
+            task = input.task ?? task;
+            template = input.template ?? 'engineer';
+        }
         const archetype = this.archetypeLoader.loadArchetype(template);
         const templateDef = AGENT_TEMPLATES[template] ?? AGENT_TEMPLATES.general;
         const defaultTools = archetype ? archetype.tools : templateDef.defaultTools;
@@ -303,7 +322,7 @@ export class AgentManager {
                 this.wrfcController?.createChain(record);
                 if (record.wrfcRole === 'owner') {
                     record.status = 'running';
-                    record.progress = 'WRFC owner supervising child agents';
+                    record.progress ??= 'WRFC owner supervising child agents';
                     if (this.runtimeBus) {
                         const ctx = {
                             sessionId: 'agent-manager',
@@ -311,8 +330,19 @@ export class AgentManager {
                             source: 'agent-manager',
                             agentId: id,
                         };
-                        emitAgentRunning(this.runtimeBus, ctx, { agentId: id });
-                        emitAgentProgress(this.runtimeBus, ctx, { agentId: id, progress: record.progress });
+                        emitAgentRunning(this.runtimeBus, ctx, {
+                            agentId: id,
+                            wrfcId: record.wrfcId,
+                            wrfcRole: record.wrfcRole,
+                            wrfcPhaseOrder: record.wrfcPhaseOrder,
+                        });
+                        emitAgentProgress(this.runtimeBus, ctx, {
+                            agentId: id,
+                            progress: record.progress,
+                            wrfcId: record.wrfcId,
+                            wrfcRole: record.wrfcRole,
+                            wrfcPhaseOrder: record.wrfcPhaseOrder,
+                        });
                     }
                     return record;
                 }

package/dist/platform/tools/agent/schema.js CHANGED Viewed

@@ -5,7 +5,7 @@
 export const AGENT_TOOL_SCHEMA = {
     name: 'agent',
     description: 'Manages in-process subagents. Modes: spawn (create a new agent task), ' +
-        'batch-spawn (spawn multiple agents at once from a tasks array), ' +
+        'batch-spawn (spawn multiple genuinely independent sidecar agents at once from a tasks array; review/test/verification role decomposition is WRFC and is collapsed to one owner chain), ' +
         'status (check agent progress by ID), cancel (stop a running agent), ' +
         'list (show all agents and their status), ' +
         'templates (list available agent templates with default tool sets), ' +
@@ -151,7 +151,7 @@ export const AGENT_TOOL_SCHEMA = {
             },
             dangerously_disable_wrfc: {
                 type: 'boolean',
-                description: 'If true, skip the WRFC review chain for this agent (mode: spawn). Default: false.',
+                description: 'If true, skip the WRFC review chain for ordinary implementation/research agents (mode: spawn). Root reviewer/tester/verifier tasks are still normalized into one WRFC owner chain.',
                 default: false,
             },
             // mode: batch-spawn
@@ -191,10 +191,10 @@ export const AGENT_TOOL_SCHEMA = {
                         orchestrationGraphId: { type: 'string', description: 'Graph id to attach the worker to.' },
                         orchestrationNodeId: { type: 'string', description: 'Explicit node id for the worker.' },
                         parentNodeId: { type: 'string', description: 'Parent node id for the worker.' },
-                        dangerously_disable_wrfc: { type: 'boolean', description: 'Skip WRFC review.' },
+                        dangerously_disable_wrfc: { type: 'boolean', description: 'Skip WRFC review for ordinary implementation/research agents. Root review/test/verify role phases are still normalized into WRFC ownership.' },
                     },
                 },
-                description: 'Array of tasks to spawn as agents (mode: batch-spawn). Max 20.',
+                description: 'Array of genuinely independent tasks to spawn as agents (mode: batch-spawn). Max 20. One-task batches are normalized through spawn. Do not place tester/reviewer/verifier role phases here for one deliverable; those are WRFC lifecycle children owned by one owner chain.',
             },
             // mode: spawn, batch-spawn, list, cohort-status, cohort-report
             cohort: {

package/dist/platform/tools/agent/wrfc-batch-policy.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { AgentInput } from './schema.js';
+type BatchTask = NonNullable<AgentInput['tasks']>[number];
+export interface WrfcBatchPolicyDecision {
+    readonly kind: 'independent' | 'collapse-to-wrfc';
+    readonly reason?: string | undefined;
+    readonly ownerInput?: AgentInput | undefined;
+    readonly roleTaskIndexes?: readonly number[] | undefined;
+}
+export declare function isRootReviewRoleTemplate(template: string | undefined): boolean;
+export declare function isRootReviewRoleTask(task: Pick<BatchTask, 'task' | 'template'>): boolean;
+export declare function evaluateWrfcBatchPolicy(input: AgentInput): WrfcBatchPolicyDecision;
+export {};
+//# sourceMappingURL=wrfc-batch-policy.d.ts.map

package/dist/platform/tools/agent/wrfc-batch-policy.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"wrfc-batch-policy.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/wrfc-batch-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAsB1D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC1D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,OAAO,CAIxF;AA8BD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,uBAAuB,CAoElF"}

package/dist/platform/tools/agent/wrfc-batch-policy.js ADDED Viewed

@@ -0,0 +1,108 @@
+const ROOT_REVIEW_ROLE_TEMPLATES = new Set([
+    'reviewer',
+    'tester',
+    'verifier',
+    'review',
+    'test',
+    'qa',
+]);
+const IMPLEMENTATION_TEMPLATES = new Set(['engineer', 'general']);
+const ROLE_PREFIX_RE = /^\s*(?:\[?\s*)?(?:reviewer|tester|verifier|qa|quality\s+assurance|test|review|verify|validator)\b[\]\s:;-]*/i;
+const ROLE_ACTION_RE = /\b(?:test|tests|testing|review|reviews|reviewing|verify|verifies|verifying|verification|validate|validates|validating|validation|qa)\s+(?:the|this|that|implementation|solution|feature|deliverable|code|changes|work|output|result|patch|diff)\b/i;
+const IMPLEMENTATION_ACTION_RE = /\b(?:build|implement|create|add|write|fix|repair|update|refactor|change|modify|deliver|make)\b/i;
+export function isRootReviewRoleTemplate(template) {
+    return ROOT_REVIEW_ROLE_TEMPLATES.has((template ?? '').trim().toLowerCase());
+}
+export function isRootReviewRoleTask(task) {
+    if (isRootReviewRoleTemplate(task.template))
+        return true;
+    const text = task.task.trim();
+    return ROLE_PREFIX_RE.test(text) || ROLE_ACTION_RE.test(text);
+}
+function isImplementationLikeTask(task) {
+    const template = (task.template ?? '').trim().toLowerCase();
+    return IMPLEMENTATION_TEMPLATES.has(template) || IMPLEMENTATION_ACTION_RE.test(task.task);
+}
+function uniqueStrings(values) {
+    const unique = [...new Set(values.flatMap((value) => value ?? []).filter((value) => value.trim().length > 0))];
+    return unique.length > 0 ? unique : undefined;
+}
+function formatTask(task, index) {
+    const template = task.template ?? 'general';
+    return `${index + 1}. [${template}] ${task.task}`;
+}
+function buildCollapsedContext(input, tasks, roleTaskIndexes) {
+    const roleIndexText = roleTaskIndexes.map((index) => index + 1).join(', ');
+    const existing = input.context?.trim();
+    return [
+        existing ? `Caller context:\n${existing}` : null,
+        'SDK WRFC topology enforcement collapsed this batch because root review/test/verification tasks are lifecycle phases, not independent root agents.',
+        `Collapsed role-task indexes: ${roleIndexText}.`,
+        'The WRFC owner must keep one root chain for the original deliverable. The controller owns engineer, reviewer, tester/verifier, and fixer child lifecycle agents after owner output exists.',
+        'Original batch:',
+        ...tasks.map(formatTask),
+    ].filter((line) => Boolean(line)).join('\n');
+}
+export function evaluateWrfcBatchPolicy(input) {
+    const tasks = input.tasks ?? [];
+    if (input.mode !== 'batch-spawn' || tasks.length <= 1) {
+        return { kind: 'independent' };
+    }
+    const roleTaskIndexes = tasks
+        .map((task, index) => isRootReviewRoleTask(task) ? index : -1)
+        .filter((index) => index >= 0);
+    if (roleTaskIndexes.length === 0) {
+        return { kind: 'independent' };
+    }
+    const primaryIndex = tasks.findIndex((task, index) => !roleTaskIndexes.includes(index) && isImplementationLikeTask(task));
+    const ownerTask = tasks[primaryIndex >= 0 ? primaryIndex : 0];
+    const ownerTemplate = isRootReviewRoleTemplate(ownerTask.template)
+        ? 'engineer'
+        : ownerTask.template ?? input.template ?? 'engineer';
+    const template = isRootReviewRoleTemplate(ownerTemplate) ? 'engineer' : ownerTemplate;
+    const ownerInput = {
+        mode: 'spawn',
+        task: ownerTask.task,
+        template,
+        model: ownerTask.model ?? input.model,
+        provider: ownerTask.provider ?? input.provider,
+        fallbackModels: ownerTask.fallbackModels ?? input.fallbackModels,
+        routing: ownerTask.routing ?? input.routing,
+        executionIntent: ownerTask.executionIntent ?? input.executionIntent,
+        reasoningEffort: ownerTask.reasoningEffort ?? input.reasoningEffort,
+        tools: ownerTask.tools ?? input.tools,
+        restrictTools: ownerTask.restrictTools ?? input.restrictTools,
+        context: buildCollapsedContext(input, tasks, roleTaskIndexes),
+        successCriteria: uniqueStrings([
+            ownerTask.successCriteria,
+            input.successCriteria,
+            ...tasks.map((task) => task.successCriteria),
+            ['Keep the WRFC work as one owner chain; review, test, verification, and fix work must be WRFC lifecycle children, not sibling root agents.'],
+        ]),
+        requiredEvidence: uniqueStrings([
+            ownerTask.requiredEvidence,
+            input.requiredEvidence,
+            ...tasks.map((task) => task.requiredEvidence),
+        ]),
+        writeScope: uniqueStrings([
+            ownerTask.writeScope,
+            input.writeScope,
+            ...tasks.map((task) => task.writeScope),
+        ]),
+        executionProtocol: ownerTask.executionProtocol ?? input.executionProtocol,
+        reviewMode: 'wrfc',
+        communicationLane: ownerTask.communicationLane ?? input.communicationLane,
+        parentAgentId: ownerTask.parentAgentId ?? input.parentAgentId,
+        orchestrationGraphId: ownerTask.orchestrationGraphId ?? input.orchestrationGraphId,
+        orchestrationNodeId: ownerTask.orchestrationNodeId ?? input.orchestrationNodeId,
+        parentNodeId: ownerTask.parentNodeId ?? input.parentNodeId,
+        dangerously_disable_wrfc: false,
+        cohort: input.cohort,
+    };
+    return {
+        kind: 'collapse-to-wrfc',
+        reason: 'batch-spawn contained root review/test/verification role tasks for the same deliverable',
+        ownerInput,
+        roleTaskIndexes,
+    };
+}

package/dist/platform/version.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.33.19';
+let version = '0.33.21';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.33.19",
+  "version": "0.33.21",
   "description": "TypeScript SDK for building GoodVibes operator, peer, web, mobile, and daemon-connected apps with typed contracts, auth, realtime events, and transport layers.",
   "keywords": [
     "goodvibes",
@@ -449,14 +449,14 @@
   "sideEffects": false,
   "type": "module",
   "dependencies": {
-    "@pellux/goodvibes-contracts": "0.33.19",
-    "@pellux/goodvibes-daemon-sdk": "0.33.19",
-    "@pellux/goodvibes-errors": "0.33.19",
-    "@pellux/goodvibes-operator-sdk": "0.33.19",
-    "@pellux/goodvibes-peer-sdk": "0.33.19",
-    "@pellux/goodvibes-transport-core": "0.33.19",
-    "@pellux/goodvibes-transport-http": "0.33.19",
-    "@pellux/goodvibes-transport-realtime": "0.33.19"
+    "@pellux/goodvibes-contracts": "0.33.21",
+    "@pellux/goodvibes-daemon-sdk": "0.33.21",
+    "@pellux/goodvibes-errors": "0.33.21",
+    "@pellux/goodvibes-operator-sdk": "0.33.21",
+    "@pellux/goodvibes-peer-sdk": "0.33.21",
+    "@pellux/goodvibes-transport-core": "0.33.21",
+    "@pellux/goodvibes-transport-http": "0.33.21",
+    "@pellux/goodvibes-transport-realtime": "0.33.21"
   },
   "optionalDependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",