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

@pellux/goodvibes-sdk 0.33.20 → 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 (55) 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,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 {
@@ -50,12 +116,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 +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),
                         }),
                     };
                 }
@@ -121,6 +172,7 @@ export function createAgentTool(config) {
                             toolCallCount: record.toolCallCount,
                             progress: record.progress,
                             error: record.error,
+                            ...agentTopology(record),
                         }),
                     };
                 }
@@ -149,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 } : {}),
                         }),
@@ -203,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,
@@ -381,6 +423,41 @@ 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;
@@ -396,14 +473,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: [{ ...agentSummary(record), task: record.task.slice(0, 80) }],
                                 count: 1,
                                 cohort: input.cohort,
                                 skipped: 0,
@@ -444,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);
@@ -479,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":"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~~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,31 @@ 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';
+        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;
@@ -307,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',
@@ -315,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

@@ -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 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.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.20",
+  "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.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.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",