npm - @pellux/goodvibes-sdk - Versions diffs - 0.33.20 → 0.33.22 - Mend

@pellux/goodvibes-sdk 0.33.20 → 0.33.22

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 (65) hide show

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

@@ -5,7 +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, isRootReviewRoleTask } from './wrfc-batch-policy.js';
+import { evaluateWrfcBatchPolicy } from './wrfc-batch-policy.js';
 export { AGENT_TEMPLATES, AgentManager } from './manager.js';
 // ---------------------------------------------------------------------------
 // Tool implementation
@@ -24,6 +24,90 @@ 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 agentOrchestrationControl(record) {
+    const authoritativeWrfcChain = record.wrfcRole === 'owner' && typeof record.wrfcId === 'string' && record.wrfcId.length > 0;
+    return {
+        authoritativeWrfcChain,
+        continueRootSpawning: authoritativeWrfcChain ? false : true,
+        rootSpawnContinuation: authoritativeWrfcChain ? 'stop' : 'allowed',
+        orchestrationStopSignal: authoritativeWrfcChain ? 'wrfc_owner_chain_started' : null,
+        orchestrationInstruction: authoritativeWrfcChain
+            ? 'This WRFC owner chain is authoritative for the deliverable. Do not spawn additional root review/test/verification/fix agents for the same work.'
+            : 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 agentSpawnSummary(record) {
+    return {
+        ...agentSummary(record),
+        ...agentOrchestrationControl(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 {
@@ -50,12 +134,6 @@ export function createAgentTool(config) {
                     if (!input.task || typeof input.task !== 'string' || input.task.trim() === '') {
                         return { success: false, error: 'Missing required parameter for spawn: task' };
                     }
-                    if (!input.parentAgentId && input.dangerously_disable_wrfc && isRootReviewRoleTask({ task: input.task, template: input.template })) {
-                        return {
-                            success: false,
-                            error: 'Root reviewer/tester/verifier agents are not valid independent roots. Start one WRFC owner chain for the deliverable, or spawn genuinely independent sidecar research/implementation tasks.',
-                        };
-                    }
                     if (input.template && !AGENT_TEMPLATES[input.template]) {
                         // Also allow custom archetypes loaded from .goodvibes/agents/*.md
                         const customArchetype = archetypeLoader.loadArchetype(input.template);
@@ -85,17 +163,9 @@ 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),
+                            ...agentOrchestrationControl(record),
                         }),
                     };
                 }
@@ -121,6 +191,7 @@ export function createAgentTool(config) {
                             toolCallCount: record.toolCallCount,
                             progress: record.progress,
                             error: record.error,
+                            ...agentTopology(record),
                         }),
                     };
                 }
@@ -149,15 +220,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 } : {}),
                         }),
@@ -203,9 +266,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,
@@ -381,6 +442,42 @@ 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: [{ ...agentSpawnSummary(record), task: record.task.slice(0, 80) }],
+                                count: 1,
+                                cohort: input.cohort,
+                                skipped: 0,
+                                normalizedToSpawn: true,
+                                ...agentOrchestrationControl(record),
+                            }),
+                        };
+                    }
                     const batchPolicy = evaluateWrfcBatchPolicy(input);
                     if (batchPolicy.kind === 'collapse-to-wrfc') {
                         let record;
@@ -396,14 +493,7 @@ export function createAgentTool(config) {
                         return {
                             success: true,
                             output: JSON.stringify({
-                                agents: [{
-                                        id: record.id,
-                                        task: record.task.slice(0, 80),
-                                        template: record.template,
-                                        cohort: record.cohort,
-                                        wrfcId: record.wrfcId ?? null,
-                                        wrfcRole: record.wrfcRole ?? null,
-                                    }],
+                                agents: [{ ...agentSpawnSummary(record), task: record.task.slice(0, 80) }],
                                 count: 1,
                                 cohort: input.cohort,
                                 skipped: 0,
@@ -411,6 +501,7 @@ export function createAgentTool(config) {
                                 collapsedTaskCount: input.tasks.length,
                                 reason: batchPolicy.reason,
                                 roleTaskIndexes: batchPolicy.roleTaskIndexes ?? [],
+                                ...agentOrchestrationControl(record),
                             }),
                         };
                     }
@@ -444,31 +535,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);
@@ -479,7 +546,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({ ...agentSpawnSummary(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;AAGhE,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;~~IAsQrC~~,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

@@ -91,16 +91,33 @@ 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';
-        if (!input.parentAgentId && input.dangerously_disable_wrfc && isRootReviewRoleTask({ task, template })) {
-            throw new Error('Root reviewer/tester/verifier agents are not valid independent roots. Start one WRFC owner chain for the deliverable, or spawn genuinely independent sidecar research/implementation tasks.');
+        let template = input.template ?? 'general';
+        let wrfcRouteReason;
+        if (!input.parentAgentId && isRootReviewRoleTask({ task, template })) {
+            wrfcRouteReason = 'root-review-role-normalized';
+            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;
@@ -219,6 +236,7 @@ export class AgentManager {
             } : {}),
             ...(input.parentAgentId ? { parentAgentId: input.parentAgentId } : {}),
             ...(parentNodeId ? { parentNodeId } : {}),
+            ...(wrfcRouteReason ? { wrfcRouteReason } : {}),
             ...(toolResolution.capabilityCeilingTools ? { capabilityCeilingTools: toolResolution.capabilityCeilingTools } : {}),
             ...(input.successCriteria ? { successCriteria: [...input.successCriteria] } : {}),
             ...(input.requiredEvidence ? { requiredEvidence: [...input.requiredEvidence] } : {}),
@@ -307,7 +325,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',
@@ -315,8 +333,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.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,~~cA2O~~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"}
1	+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/schema.ts"],"names":[],"mappings":"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"}

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

@@ -18,7 +18,8 @@ export const AGENT_TOOL_SCHEMA = {
         'wrfc-history (detailed event history for a specific WRFC chain — reviews, scores, issues, gates), ' +
         'cohort-status (JSON summary of all agents in a named cohort), ' +
         'cohort-report (markdown table report for all agents in a named cohort).' +
-        ' Discovery: use mode=list to see all agents and their status, mode=templates to see available agent templates.',
+        ' Discovery: use mode=list to see all agents and their status, mode=templates to see available agent templates. ' +
+        'If the user asks for WRFC, agent review, reviewed implementation, review/fix cycles, or test/verify work for one deliverable, call this tool with mode=spawn, template=engineer, reviewMode=wrfc; do not answer by describing WRFC in prose.',
     sideEffects: ['agent', 'workflow', 'state'],
     concurrency: 'serial',
     supportsProgress: true,
@@ -34,7 +35,7 @@ export const AGENT_TOOL_SCHEMA = {
             // mode: spawn
             task: {
                 type: 'string',
-                description: 'Task description for the agent to execute (mode: spawn).',
+                description: 'Task description for the agent to execute (mode: spawn). For a user request that asks for WRFC/review/test/verify of one deliverable, describe the implementation deliverable itself and use reviewMode=wrfc; do not spawn reviewer/tester roots.',
             },
             template: {
                 type: 'string',
@@ -119,7 +120,7 @@ export const AGENT_TOOL_SCHEMA = {
             reviewMode: {
                 type: 'string',
                 enum: ['none', 'wrfc'],
-                description: 'Review loop requirement for the spawned agent (mode: spawn). Default: wrfc unless explicitly disabled.',
+                description: 'Review loop requirement for the spawned agent (mode: spawn). Default: wrfc unless explicitly disabled. Use wrfc for any requested WRFC, review/fix cycle, reviewed implementation, test, or verification flow for a single deliverable.',
             },
             communicationLane: {
                 type: 'string',
@@ -151,7 +152,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 +192,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 genuinely independent tasks to spawn as agents (mode: batch-spawn). Max 20. Do not place tester/reviewer/verifier role phases here for one deliverable; those are WRFC lifecycle children owned by one owner chain.',
+                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/version.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.33.20';
+let version = '0.33.22';
 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.20",
+  "version": "0.33.22",
   "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.20",
-    "@pellux/goodvibes-daemon-sdk": "0.33.20",
-    "@pellux/goodvibes-errors": "0.33.20",
-    "@pellux/goodvibes-operator-sdk": "0.33.20",
-    "@pellux/goodvibes-peer-sdk": "0.33.20",
-    "@pellux/goodvibes-transport-core": "0.33.20",
-    "@pellux/goodvibes-transport-http": "0.33.20",
-    "@pellux/goodvibes-transport-realtime": "0.33.20"
+    "@pellux/goodvibes-contracts": "0.33.22",
+    "@pellux/goodvibes-daemon-sdk": "0.33.22",
+    "@pellux/goodvibes-errors": "0.33.22",
+    "@pellux/goodvibes-operator-sdk": "0.33.22",
+    "@pellux/goodvibes-peer-sdk": "0.33.22",
+    "@pellux/goodvibes-transport-core": "0.33.22",
+    "@pellux/goodvibes-transport-http": "0.33.22",
+    "@pellux/goodvibes-transport-realtime": "0.33.22"
   },
   "optionalDependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",