swarm-engine 1.41.0 → 1.43.0

package/dist/runtime/output-schemas.js

@@ -0,0 +1,252 @@
+/**
+ * Structured Output Contracts for Agent Types.
+ *
+ * Defines JSON schemas per agent type so agents emit structured, compact JSON
+ * instead of verbose prose. A reviewer emitting `{"findings": [...]}` is 3-5x
+ * more compact than a narrative review.
+ *
+ * Usage:
+ *   const schema = getOutputSchema('reviewer');
+ *   // Pass schema to agent prompt so it knows the expected output shape
+ */
+// ─── Schema Definitions ─────────────────────────────────────────────
+const researcherSchema = {
+    name: 'researcher',
+    description: 'Structured research findings with confidence levels and source files',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            findings: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        topic: { type: 'string' },
+                        detail: { type: 'string' },
+                        files: { type: 'array', items: { type: 'string' } },
+                        confidence: { type: 'string', enum: ['high', 'medium', 'low'] },
+                    },
+                    required: ['topic', 'detail', 'files', 'confidence'],
+                    additionalProperties: false,
+                },
+            },
+            summary: { type: 'string' },
+            unknowns: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['findings', 'summary', 'unknowns'],
+        additionalProperties: false,
+    },
+};
+const reviewerSchema = {
+    name: 'reviewer',
+    description: 'Structured code review findings with severity, category, and verdict',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            findings: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        file: { type: 'string' },
+                        line: { type: ['integer', 'null'] },
+                        severity: {
+                            type: 'string',
+                            enum: ['critical', 'high', 'medium', 'low', 'info'],
+                        },
+                        category: {
+                            type: 'string',
+                            enum: ['bug', 'security', 'performance', 'style', 'logic'],
+                        },
+                        issue: { type: 'string' },
+                        suggestion: { type: ['string', 'null'] },
+                    },
+                    required: ['file', 'line', 'severity', 'category', 'issue', 'suggestion'],
+                    additionalProperties: false,
+                },
+            },
+            verdict: {
+                type: 'string',
+                enum: ['approve', 'request-changes', 'comment'],
+            },
+            summary: { type: 'string' },
+        },
+        required: ['findings', 'verdict', 'summary'],
+        additionalProperties: false,
+    },
+};
+const testerSchema = {
+    name: 'tester',
+    description: 'Structured test results with coverage analysis',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            tests: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string' },
+                        file: { type: 'string' },
+                        type: { type: 'string', enum: ['unit', 'integration', 'e2e'] },
+                        status: { type: 'string', enum: ['written', 'existing', 'skipped'] },
+                        reason: { type: 'string' },
+                    },
+                    required: ['name', 'file', 'type', 'status'],
+                    additionalProperties: false,
+                },
+            },
+            coverage: {
+                type: 'object',
+                properties: {
+                    added: { type: 'array', items: { type: 'string' } },
+                    gaps: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['added', 'gaps'],
+                additionalProperties: false,
+            },
+            summary: { type: 'string' },
+        },
+        required: ['tests', 'coverage', 'summary'],
+        additionalProperties: false,
+    },
+};
+const implementerSchema = {
+    name: 'implementer',
+    description: 'Structured implementation report with changes, decisions, and blockers',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            changes: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        file: { type: 'string' },
+                        action: { type: 'string', enum: ['create', 'modify', 'delete'] },
+                        description: { type: 'string' },
+                    },
+                    required: ['file', 'action', 'description'],
+                    additionalProperties: false,
+                },
+            },
+            decisions: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        choice: { type: 'string' },
+                        reason: { type: 'string' },
+                        alternatives: { type: 'array', items: { type: 'string' } },
+                    },
+                    required: ['choice', 'reason'],
+                    additionalProperties: false,
+                },
+            },
+            blockers: { type: 'array', items: { type: 'string' } },
+            summary: { type: 'string' },
+        },
+        required: ['changes', 'decisions', 'blockers', 'summary'],
+        additionalProperties: false,
+    },
+};
+const plannerSchema = {
+    name: 'planner',
+    description: 'Structured execution plan with phases, dependencies, and risks',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            phases: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string' },
+                        kind: { type: 'string' },
+                        agents: { type: 'array', items: { type: 'string' } },
+                        description: { type: 'string' },
+                        dependsOn: { type: 'array', items: { type: 'string' } },
+                    },
+                    required: ['name', 'kind', 'agents', 'description'],
+                    additionalProperties: false,
+                },
+            },
+            risks: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        description: { type: 'string' },
+                        mitigation: { type: 'string' },
+                        severity: { type: 'string', enum: ['high', 'medium', 'low'] },
+                    },
+                    required: ['description', 'mitigation', 'severity'],
+                    additionalProperties: false,
+                },
+            },
+            summary: { type: 'string' },
+        },
+        required: ['phases', 'risks', 'summary'],
+        additionalProperties: false,
+    },
+};
+const debuggerSchema = {
+    name: 'debugger',
+    description: 'Structured debugging report with hypothesis, root cause, and fix',
+    schema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            hypothesis: { type: 'string' },
+            rootCause: { type: ['string', 'null'] },
+            evidence: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        source: { type: 'string' },
+                        detail: { type: 'string' },
+                    },
+                    required: ['source', 'detail'],
+                    additionalProperties: false,
+                },
+            },
+            fix: {
+                type: ['object', 'null'],
+                properties: {
+                    file: { type: 'string' },
+                    description: { type: 'string' },
+                },
+                required: ['file', 'description'],
+                additionalProperties: false,
+            },
+            summary: { type: 'string' },
+        },
+        required: ['hypothesis', 'rootCause', 'evidence', 'fix', 'summary'],
+        additionalProperties: false,
+    },
+};
+// ─── Registry ───────────────────────────────────────────────────────
+const SCHEMAS = new Map([
+    [researcherSchema.name, researcherSchema],
+    [reviewerSchema.name, reviewerSchema],
+    [testerSchema.name, testerSchema],
+    [implementerSchema.name, implementerSchema],
+    [plannerSchema.name, plannerSchema],
+    [debuggerSchema.name, debuggerSchema],
+]);
+// ─── Public API ─────────────────────────────────────────────────────
+/** Get the output schema for a given agent type. Returns undefined if no schema defined. */
+export function getOutputSchema(agentType) {
+    return SCHEMAS.get(agentType);
+}
+/** List all available output schemas. */
+export function listOutputSchemas() {
+    return [...SCHEMAS.values()];
+}
+//# sourceMappingURL=output-schemas.js.map

package/dist/runtime/output-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.js","sourceRoot":"","sources":["../../src/runtime/output-schemas.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarm-engine",
-  "version": "1.41.0",
+  "version": "1.43.0",
   "description": "Self-aware multi-agent orchestration engine with knowledge graph, causal inference, GNN failure prediction, and self-evolving rules — pure TypeScript",
   "type": "module",
   "main": "dist/index.js",