swarm-engine 1.38.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/dist/runtime/prompt-compressor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PromptCompressor — strips markdown boilerplate from agent .md prompts to reduce token usage.
+ */
+export declare class PromptCompressor {
+    /** Compress an agent prompt by removing boilerplate */
+    static compress(prompt: string, maxChars?: number): string;
+    /** Extract only core instruction sections from agent markdown */
+    static extractCoreSections(prompt: string): string;
+    /** Estimate token savings (rough: 1 token ≈ 4 chars) */
+    static estimateSavings(original: string, compressed: string): {
+        originalTokens: number;
+        compressedTokens: number;
+        savedPercent: number;
+    };
+}
+//# sourceMappingURL=prompt-compressor.d.ts.map

package/dist/runtime/prompt-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-compressor.d.ts","sourceRoot":"","sources":["../../src/runtime/prompt-compressor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,gBAAgB;IAC3B,uDAAuD;IACvD,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAsC1D,iEAAiE;IACjE,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAuBlD,wDAAwD;IACxD,MAAM,CAAC,eAAe,CACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAS9E"}

package/dist/runtime/prompt-compressor.js

@@ -0,0 +1,68 @@
+/**
+ * PromptCompressor — strips markdown boilerplate from agent .md prompts to reduce token usage.
+ */
+export class PromptCompressor {
+    /** Compress an agent prompt by removing boilerplate */
+    static compress(prompt, maxChars) {
+        let result = prompt;
+        // 1. Remove YAML frontmatter (---\n...\n---)
+        result = result.replace(/^---\n[\s\S]*?\n---\n?/, '');
+        // 2. Remove horizontal rules (---, ***, ___)
+        result = result.replace(/^[-*_]{3,}\s*$/gm, '');
+        // 3. Collapse multiple blank lines to single
+        result = result.replace(/\n{3,}/g, '\n\n');
+        // 4. Remove markdown header decorations (keep text)
+        // "## Before You Act" → "Before You Act:"
+        result = result.replace(/^#{1,6}\s+(.+)$/gm, '$1:');
+        // 5. Remove repeated "IMPORTANT:" / "NOTE:" / "CRITICAL:" prefixes (keep first occurrence)
+        const seen = new Set();
+        result = result.replace(/^(IMPORTANT|NOTE|CRITICAL|WARNING):\s*$/gm, (match, prefix) => {
+            if (seen.has(prefix))
+                return '';
+            seen.add(prefix);
+            return match;
+        });
+        // 6. Compress bullet list formatting — flatten excessive indentation
+        result = result.replace(/^(\s{4,})([-*])/gm, '  $2');
+        // 7. Remove trailing whitespace
+        result = result.replace(/[ \t]+$/gm, '');
+        // 8. Truncate if over maxChars
+        if (maxChars && result.length > maxChars) {
+            result = result.slice(0, maxChars) + '\n[truncated]';
+        }
+        return result.trim();
+    }
+    /** Extract only core instruction sections from agent markdown */
+    static extractCoreSections(prompt) {
+        const sections = [];
+        // Extract role description (first paragraph after frontmatter)
+        const afterFrontmatter = prompt.replace(/^---\n[\s\S]*?\n---\n?/, '');
+        const firstParagraph = afterFrontmatter.match(/^([^\n#].+(?:\n(?![#\-]).+)*)/m);
+        if (firstParagraph)
+            sections.push(firstParagraph[1].trim());
+        // Extract "Before You Act" section
+        const beforeYouAct = prompt.match(/(?:^|\n)#{1,3}\s*Before You Act\s*\n([\s\S]*?)(?=\n#{1,3}\s|\n*$)/i);
+        if (beforeYouAct)
+            sections.push('Instructions:\n' + beforeYouAct[1].trim());
+        // Extract "Self-Check" section
+        const selfCheck = prompt.match(/(?:^|\n)#{1,3}\s*Self[- ]?Check\s*\n([\s\S]*?)(?=\n#{1,3}\s|\n*$)/i);
+        if (selfCheck)
+            sections.push('Self-Check:\n' + selfCheck[1].trim());
+        // Extract debt tagging if present
+        const debtTag = prompt.match(/(?:^|\n)#{1,3}\s*Debt\s*\n([\s\S]*?)(?=\n#{1,3}\s|\n*$)/i);
+        if (debtTag)
+            sections.push('Debt:\n' + debtTag[1].trim());
+        return sections.join('\n\n');
+    }
+    /** Estimate token savings (rough: 1 token ≈ 4 chars) */
+    static estimateSavings(original, compressed) {
+        const origTokens = Math.ceil(original.length / 4);
+        const compTokens = Math.ceil(compressed.length / 4);
+        return {
+            originalTokens: origTokens,
+            compressedTokens: compTokens,
+            savedPercent: origTokens > 0 ? Math.round((1 - compTokens / origTokens) * 100) : 0,
+        };
+    }
+}
+//# sourceMappingURL=prompt-compressor.js.map

package/dist/runtime/prompt-compressor.js.map

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

package/dist/runtime/repo-map.d.ts

@@ -0,0 +1,40 @@
+export interface RepoMapOptions {
+    maxTokens?: number;
+    includePatterns?: string[];
+    excludePatterns?: string[];
+}
+export interface FileSignature {
+    path: string;
+    exports: string[];
+    classes: string[];
+    functions: string[];
+    imports: string[];
+}
+export declare class RepoMapGenerator {
+    private static cache;
+    private static CACHE_TTL;
+    /** Generate a compressed repo map as a string (cached per rootDir for 30s) */
+    static generateMap(rootDir: string, options?: RepoMapOptions): string;
+    /** Clear the repo map cache (useful for testing) */
+    static clearCache(): void;
+    /** Extract signatures from a single file */
+    static extractSignatures(filePath: string, content: string): FileSignature;
+    /** Format signatures into a compressed string */
+    static formatMap(signatures: FileSignature[], maxChars: number): string;
+    private static scanFiles;
+    private static walkDir;
+    private static matchesExclude;
+    private static extractExtensions;
+    private static extractTypeScript;
+    private static extractPython;
+    private static extractGo;
+    private static extractRust;
+    private static extractJava;
+    /** Extract a balanced-brace block starting after an opening brace */
+    private static extractBlock;
+    /** Extract method signatures from a class body */
+    private static extractMethods;
+    /** Compress parameter list to just names (drop types for brevity) */
+    private static compressParams;
+}
+//# sourceMappingURL=repo-map.d.ts.map

package/dist/runtime/repo-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-map.d.ts","sourceRoot":"","sources":["../../src/runtime/repo-map.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAuE;IAC3F,OAAO,CAAC,MAAM,CAAC,SAAS,CAAU;IAElC,8EAA8E;IAC9E,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM;IA+BrE,oDAAoD;IACpD,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB,4CAA4C;IAC5C,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAqB1E,iDAAiD;IACjD,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAyCvE,OAAO,CAAC,MAAM,CAAC,SAAS;IASxB,OAAO,CAAC,MAAM,CAAC,OAAO;IAwBtB,OAAO,CAAC,MAAM,CAAC,cAAc;IA2B7B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgBhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA0ChC,OAAO,CAAC,MAAM,CAAC,aAAa;IA+C5B,OAAO,CAAC,MAAM,CAAC,SAAS;IA8BxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAqB1B,OAAO,CAAC,MAAM,CAAC,WAAW;IA8B1B,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B,kDAAkD;IAClD,OAAO,CAAC,MAAM,CAAC,cAAc;IAe7B,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,cAAc;CAkB9B"}