@zhixuan92/multi-model-agent-core 3.12.6 → 4.0.0

package/dist/tool-surface/skill-manifest-sync.js

@@ -0,0 +1,65 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SUPPORTED_SKILLS, readSkillContent } from './discover.js';
+import matter from 'gray-matter';
+function canonicalVersion(skillName) {
+    const content = readSkillContent(skillName);
+    if (content === null)
+        return null;
+    try {
+        const parsed = matter(content);
+        const v = parsed.data['version'];
+        return typeof v === 'string' ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function makeSkillManifestSync(perClientInstallDirs) {
+    return {
+        driftReport() {
+            const drift = [];
+            const supported = new Set(SUPPORTED_SKILLS);
+            for (const [client, dir] of Object.entries(perClientInstallDirs)) {
+                let entries;
+                try {
+                    entries = readdirSync(dir);
+                }
+                catch {
+                    continue;
+                }
+                const present = new Set(entries.filter(n => n.startsWith('mma-') || n === 'multi-model-agent'));
+                for (const exp of supported) {
+                    if (!present.has(exp))
+                        drift.push({ skill: exp, client: client, issue: 'missing' });
+                }
+                for (const got of present) {
+                    if (!supported.has(got)) {
+                        drift.push({ skill: got, client: client, issue: 'orphan' });
+                    }
+                }
+                for (const skill of present) {
+                    if (!supported.has(skill))
+                        continue;
+                    const canonVer = canonicalVersion(skill);
+                    if (canonVer === null)
+                        continue;
+                    const installedPath = join(dir, skill, 'SKILL.md');
+                    try {
+                        const installedContent = readFileSync(installedPath, 'utf-8');
+                        const parsed = matter(installedContent);
+                        const installedVer = parsed.data['version'];
+                        if (typeof installedVer === 'string' && installedVer !== canonVer) {
+                            drift.push({ skill, client: client, issue: 'outdated' });
+                        }
+                    }
+                    catch {
+                        // skip outdated check if installed SKILL.md is unreadable
+                    }
+                }
+            }
+            return drift;
+        },
+    };
+}
+//# sourceMappingURL=skill-manifest-sync.js.map

package/dist/tool-surface/skill-manifest-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest-sync.js","sourceRoot":"","sources":["../../src/tool-surface/skill-manifest-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,MAAM,MAAM,aAAa,CAAC;AAYjC,SAAS,gBAAgB,CAAC,SAAiB;IACzC,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,oBAAqD;IACzF,OAAO;QACL,WAAW;YACT,MAAM,KAAK,GAAiB,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;YACpD,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACjE,IAAI,OAAiB,CAAC;gBACtB,IAAI,CAAC;oBAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,mBAAmB,CAAC,CACvE,CAAC;gBACF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAChG,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACxE,CAAC;gBACH,CAAC;gBACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;wBAAE,SAAS;oBACpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBACzC,IAAI,QAAQ,KAAK,IAAI;wBAAE,SAAS;oBAChC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;oBACnD,IAAI,CAAC;wBACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;wBAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;wBACxC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;wBAC5C,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;4BAClE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAgB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;wBACrE,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,0DAA0D;oBAC5D,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tool-surface/tool-surface-registry.d.ts

@@ -0,0 +1,34 @@
+import type { ZodSchema } from 'zod';
+import type { ToolCategory } from '../escalation/escalation-policy.js';
+export interface SurfaceEntry {
+    routeName: string;
+    /** HTTP method on the public route. Most tools are POST. */
+    httpMethod: 'POST' | 'GET' | 'DELETE';
+    /** HTTP URL path. Differs from routeName when the wire form uses
+     * hyphens (e.g. `/execute-plan` for `execute_plan`) or a different
+     * surface name (e.g. `/retry` for `retry_tasks`). */
+    httpPath: string;
+    /** Tier the tool registration lives in: `tool` (POST /<path>) or
+     * `control` (sync state op like /context-blocks). Tool-tier entries
+     * drive standard tool-handler registration; control-tier entries are
+     * handled separately by registerControlHandlers. */
+    surface: 'tool' | 'control';
+    schema: ZodSchema<any>;
+    toolCategory: ToolCategory;
+    agentTypeDefault: 'standard' | 'complex';
+    agentTypeOverridable: boolean;
+    responseShapeName: string;
+    /** Handler builder — set by server-side wiring (wire/register-all-handlers.ts).
+     * Accepts a dependency bag and returns an HTTP handler. Typed loosely to avoid
+     * core→server package dependency. */
+    buildHandler?: (deps: Record<string, unknown>) => unknown;
+}
+export declare class ToolSurfaceRegistry {
+    private entries;
+    register(entry: SurfaceEntry): void;
+    get(routeName: string): SurfaceEntry | undefined;
+    list(): SurfaceEntry[];
+    /** Attach a handler builder to an already-registered entry. */
+    setHandler(routeName: string, builder: (deps: Record<string, unknown>) => unknown): void;
+}
+//# sourceMappingURL=tool-surface-registry.d.ts.map

package/dist/tool-surface/tool-surface-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-surface-registry.d.ts","sourceRoot":"","sources":["../../src/tool-surface/tool-surface-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACtC;;yDAEqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;wDAGoD;IACpD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;yCAEqC;IACrC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CAC3D;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAmC;IAElD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAOnC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD,IAAI,IAAI,YAAY,EAAE;IAItB,+DAA+D;IAC/D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,IAAI;CAKzF"}

package/dist/tool-surface/tool-surface-registry.js

@@ -0,0 +1,23 @@
+export class ToolSurfaceRegistry {
+    entries = new Map();
+    register(entry) {
+        if (this.entries.has(entry.routeName)) {
+            throw new Error(`route '${entry.routeName}' already registered`);
+        }
+        this.entries.set(entry.routeName, entry);
+    }
+    get(routeName) {
+        return this.entries.get(routeName);
+    }
+    list() {
+        return [...this.entries.values()];
+    }
+    /** Attach a handler builder to an already-registered entry. */
+    setHandler(routeName, builder) {
+        const entry = this.entries.get(routeName);
+        if (!entry)
+            throw new Error(`cannot set handler: route '${routeName}' not registered`);
+        entry.buildHandler = builder;
+    }
+}
+//# sourceMappingURL=tool-surface-registry.js.map

package/dist/tool-surface/tool-surface-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-surface-registry.js","sourceRoot":"","sources":["../../src/tool-surface/tool-surface-registry.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,mBAAmB;IACtB,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD,QAAQ,CAAC,KAAmB;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,SAAS,sBAAsB,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,+DAA+D;IAC/D,UAAU,CAAC,SAAiB,EAAE,OAAmD;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,kBAAkB,CAAC,CAAC;QACvF,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;IAC/B,CAAC;CACF"}

package/dist/tools/audit/schema.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+export declare const inputSchema: z.ZodObject<{
+    document: z.ZodOptional<z.ZodString>;
+    auditType: z.ZodUnion<readonly [z.ZodEnum<{
+        style: "style";
+        security: "security";
+        performance: "performance";
+        correctness: "correctness";
+        general: "general";
+    }>, z.ZodArray<z.ZodEnum<{
+        style: "style";
+        security: "security";
+        performance: "performance";
+        correctness: "correctness";
+    }>>]>;
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const outputSchema: z.ZodObject<{
+    headline: z.ZodString;
+    results: z.ZodUnion<readonly [z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    batchTimings: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    costSummary: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    structuredReport: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    error: z.ZodUnion<readonly [z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    specReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    qualityReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    roundsUsed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type Output = z.infer<typeof outputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/audit/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/audit/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;iBAUtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAExD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/tools/audit/schema.js

@@ -0,0 +1,19 @@
+// packages/core/src/tool-schemas/audit.ts
+import { z } from 'zod';
+import { buildOutputEnvelopeSchema } from '../shared-output.js';
+// Ported verbatim from packages/mcp/src/tools/audit-document.ts (auditDocumentSchema).
+// commonToolFields (filePaths + contextBlockIds) are inlined here to avoid
+// cross-package coupling.
+export const inputSchema = z.object({
+    document: z.string().optional().describe('Inline document content to audit'),
+    auditType: z.union([
+        z.enum(['security', 'performance', 'correctness', 'style', 'general']),
+        z.array(z.enum(['security', 'performance', 'correctness', 'style'])).min(1),
+    ]).describe('Audit focus.'),
+    filePaths: z.array(z.string()).optional()
+        .describe('Files the sub-agent should focus on. Multiple files are processed in parallel.'),
+    contextBlockIds: z.array(z.string()).optional()
+        .describe('IDs from register_context_block to prepend to prompt. Use for delta audits, diff-scoped reviews, or shared specs.'),
+});
+export const outputSchema = buildOutputEnvelopeSchema();
+//# sourceMappingURL=schema.js.map

package/dist/tools/audit/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/audit/schema.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,uFAAuF;AACvF,2EAA2E;AAC3E,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC5E,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC;QACjB,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5E,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACtC,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,mHAAmH,CAAC;CACjI,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/tools/audit/tool-config.d.ts

@@ -0,0 +1,17 @@
+import { ToolSurfaceRegistry } from '../../tool-surface/tool-surface-registry.js';
+import { type Input } from './schema.js';
+import { type AuditReport } from '../../reporting/report-parser-slots/audit-report.js';
+import type { ToolConfig } from '../../lifecycle/tool-config-types.js';
+export declare function registerAudit(registry: ToolSurfaceRegistry): void;
+export interface ToolAuditBrief {
+    auditTypeText: string;
+    done: string;
+    document?: string;
+    filePaths: string[];
+    hasContextBlocks: boolean;
+    contextBlockIds?: string[];
+    perFilePath?: string;
+}
+export declare function auditBriefSlot(input: Input): ToolAuditBrief[];
+export declare const toolConfig: ToolConfig<Input, ToolAuditBrief, AuditReport>;
+//# sourceMappingURL=tool-config.d.ts.map

package/dist/tools/audit/tool-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.d.ts","sourceRoot":"","sources":["../../../src/tools/audit/tool-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAE1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAIvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAYjE;AAID,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,CA0B7D;AAsDD,eAAO,MAAM,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,CAyBrE,CAAC"}

package/dist/tools/audit/tool-config.js

@@ -0,0 +1,144 @@
+import { inputSchema } from './schema.js';
+import { qualityAuditTemplate } from '../../review/templates/quality-review-audit.js';
+import { auditReportSchema } from '../../reporting/report-parser-slots/audit-report.js';
+import { auditHeadlineTemplate } from '../../reporting/headline-templates/audit.js';
+import { DEFAULT_TASK_TIMEOUT_MS } from '../../config/schema.js';
+export function registerAudit(registry) {
+    registry.register({
+        routeName: 'audit',
+        httpMethod: 'POST',
+        httpPath: '/audit',
+        surface: 'tool',
+        schema: inputSchema,
+        toolCategory: 'read_only',
+        agentTypeDefault: 'complex',
+        agentTypeOverridable: false,
+        responseShapeName: 'BatchResponse',
+    });
+}
+const AUDIT_DONE_CONDITIONS = {
+    security: 'Identify all security vulnerabilities (injection, auth bypass, data exposure, OWASP top 10). Each finding has severity (critical/high/medium/low), location, and remediation.',
+    performance: 'Identify all performance issues (O(n²) loops, unnecessary allocations, missing caching, blocking I/O). Each finding has impact level, location, and fix recommendation.',
+    correctness: 'Identify all logic errors, off-by-one bugs, unhandled edge cases, type mismatches, and contract violations. Each finding has severity, location, and correct behavior.',
+    style: 'Identify all style issues (naming, formatting, dead code, inconsistent patterns). Each finding has location and recommended fix.',
+    general: 'Identify issues across security, performance, correctness, and style. Each finding has category, severity, location, and remediation.',
+};
+const DELTA_AUDIT_SUFFIX = ' Perform a full audit (do not reduce thoroughness). Verify each prior finding as fixed or unfixed. Omit fixed prior findings from the main report. Include unfixed prior findings and new findings. End with a summary of which prior findings were resolved.';
+function resolveAuditTypeText(auditType) {
+    if (auditType === 'general')
+        return 'security, performance, correctness, and style';
+    if (Array.isArray(auditType))
+        return auditType.join(', ');
+    return auditType;
+}
+function resolveDoneCondition(auditType, hasContextBlocks) {
+    let base;
+    if (auditType === 'general') {
+        base = AUDIT_DONE_CONDITIONS.general;
+    }
+    else if (Array.isArray(auditType)) {
+        base = auditType.map(t => AUDIT_DONE_CONDITIONS[t]).join(' ');
+    }
+    else {
+        base = AUDIT_DONE_CONDITIONS[auditType] ?? AUDIT_DONE_CONDITIONS.general;
+    }
+    return hasContextBlocks ? base + DELTA_AUDIT_SUFFIX : base;
+}
+function hasContent(value) {
+    return value !== undefined && value.trim().length > 0;
+}
+export function auditBriefSlot(input) {
+    const hasContextBlocks = Array.isArray(input.contextBlockIds) && input.contextBlockIds.length > 0;
+    const auditTypeText = resolveAuditTypeText(input.auditType);
+    const done = resolveDoneCondition(input.auditType, hasContextBlocks);
+    const validPaths = (input.filePaths ?? []).filter(p => p.trim().length > 0);
+    // Fan-out: multiple file paths without an inline document
+    if (!hasContent(input.document) && validPaths.length >= 2) {
+        return validPaths.map(fp => ({
+            auditTypeText,
+            done,
+            filePaths: [fp],
+            hasContextBlocks,
+            contextBlockIds: input.contextBlockIds,
+            perFilePath: fp,
+        }));
+    }
+    return [{
+            auditTypeText,
+            done,
+            document: input.document,
+            filePaths: validPaths,
+            hasContextBlocks,
+            contextBlockIds: input.contextBlockIds,
+        }];
+}
+const FINDING_FORMAT_INSTRUCTIONS = [
+    'Produce a narrative audit report. Use this EXACT per-finding format so the deterministic extractor can recover findings if the structured reviewer pass fails:',
+    '',
+    '## Finding 1: <one-line title>',
+    '- Severity: critical | high | medium | low',
+    '- Location: file:line (when applicable)',
+    '- Issue: one-paragraph explanation',
+    '- Suggestion: one-line fix recommendation',
+    '',
+    '## Finding 2: <one-line title>',
+    '- Severity: ...',
+    '- ...',
+    '',
+    'Rules:',
+    '- Each finding heading MUST start with "## Finding N: " (h2, "Finding ", number, colon, title) — number sequentially from 1.',
+    '- Severity / Location / Issue / Suggestion bullets are on their own lines with the labels exactly as shown.',
+    '- Do NOT emit JSON. The structured reviewer extracts from this format; if that pass fails the deterministic fallback extracts from this same format — both produce identical structured output, so the format is the single source of truth.',
+].join('\n');
+function buildFilePathsPrompt(filePaths) {
+    if (filePaths.length === 0)
+        return '';
+    return `Read and analyze these files:\n${filePaths.map(p => `- ${p}`).join('\n')}`;
+}
+function buildPrompt(brief) {
+    const parts = [`Audit for ${brief.auditTypeText} issues.`];
+    if (brief.perFilePath) {
+        parts.push(`Read and analyze this file:\n- ${brief.perFilePath}`);
+    }
+    else {
+        if (brief.document)
+            parts.push(`Document:\n\n${brief.document}`);
+        const fileSection = buildFilePathsPrompt(brief.filePaths);
+        if (fileSection)
+            parts.push(fileSection);
+    }
+    if (brief.hasContextBlocks) {
+        parts.push('A prior audit report is provided as context above.', 'First, verify which prior findings have been fixed. Then perform a full audit as normal — do not skip areas or reduce thoroughness.', 'In your output:', '- **Omit** prior findings that have been fixed — do not re-report them.', '- **Include** prior findings that are still present (mark as "unfixed from prior audit").', '- **Include** any new findings not in the prior report.', '- End with a **Fixed** summary listing which prior findings were resolved.');
+    }
+    else {
+        parts.push(FINDING_FORMAT_INSTRUCTIONS);
+    }
+    return parts.join('\n\n');
+}
+export const toolConfig = {
+    name: 'audit',
+    category: 'read_only',
+    agentType: 'complex',
+    briefSlot: auditBriefSlot,
+    buildTaskSpec: (brief, ctx) => ({
+        prompt: buildPrompt(brief),
+        agentType: 'complex',
+        reviewPolicy: 'quality_only',
+        briefQualityPolicy: 'off',
+        done: brief.done,
+        tools: ctx.config.defaults?.tools ?? 'full',
+        timeoutMs: ctx.config.defaults?.timeoutMs ?? DEFAULT_TASK_TIMEOUT_MS,
+        maxCostUSD: ctx.config.defaults?.maxCostUSD ?? 10,
+        sandboxPolicy: ctx.config.defaults?.sandboxPolicy ?? 'cwd-only',
+        cwd: ctx.projectContext?.cwd ?? ctx.cwd,
+        contextBlockIds: brief.contextBlockIds,
+        filePaths: brief.filePaths.length > 0 ? brief.filePaths : undefined,
+        mainModel: ctx.mainModel,
+    }),
+    reportSchema: auditReportSchema,
+    headlineTemplate: auditHeadlineTemplate,
+    reviewTemplates: {
+        qualityAP: qualityAuditTemplate,
+    },
+};
+//# sourceMappingURL=tool-config.js.map

package/dist/tools/audit/tool-config.js.map

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

package/dist/tools/debug/schema.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+export declare const inputSchema: z.ZodObject<{
+    problem: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    hypothesis: z.ZodOptional<z.ZodString>;
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const outputSchema: z.ZodObject<{
+    headline: z.ZodString;
+    results: z.ZodUnion<readonly [z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    batchTimings: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    costSummary: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    structuredReport: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    error: z.ZodUnion<readonly [z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    specReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    qualityReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    roundsUsed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type Output = z.infer<typeof outputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/debug/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/debug/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,WAAW;;;;;;iBAStB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAExD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/tools/debug/schema.js

@@ -0,0 +1,16 @@
+// packages/core/src/tool-schemas/debug.ts
+import { z } from 'zod';
+import { buildOutputEnvelopeSchema } from '../shared-output.js';
+// Ported verbatim from packages/mcp/src/tools/debug-task.ts (debugTaskSchema).
+// The filePaths field has its description overridden in the original — reproduced here.
+// commonToolFields (filePaths + contextBlockIds) are inlined to avoid cross-package coupling.
+export const inputSchema = z.object({
+    problem: z.string().describe('What is broken'),
+    context: z.string().optional().describe('Background'),
+    hypothesis: z.string().optional().describe('Initial theory'),
+    filePaths: z.array(z.string()).optional().describe('Files the sub-agent should focus on. For debug_task, all provided files are investigated together in a single task.'),
+    contextBlockIds: z.array(z.string()).optional()
+        .describe('IDs from register_context_block to prepend to prompt. Use for delta audits, diff-scoped reviews, or shared specs.'),
+});
+export const outputSchema = buildOutputEnvelopeSchema();
+//# sourceMappingURL=schema.js.map

package/dist/tools/debug/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/debug/schema.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,+EAA+E;AAC/E,wFAAwF;AACxF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5D,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAChD,qHAAqH,CACtH;IACD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,mHAAmH,CAAC;CACjI,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/tools/debug/tool-config.d.ts

@@ -0,0 +1,7 @@
+import { ToolSurfaceRegistry } from '../../tool-surface/tool-surface-registry.js';
+import type { Input } from './schema.js';
+import type { ToolConfig } from '../../lifecycle/tool-config-types.js';
+import { type ToolDebugBrief } from '../../intake/brief-compiler-slots/debug.js';
+export declare function registerDebug(registry: ToolSurfaceRegistry): void;
+export declare const toolConfig: ToolConfig<Input, ToolDebugBrief, unknown>;
+//# sourceMappingURL=tool-config.d.ts.map

package/dist/tools/debug/tool-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.d.ts","sourceRoot":"","sources":["../../../src/tools/debug/tool-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAIjG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAYjE;AA0BD,eAAO,MAAM,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAkCjE,CAAC"}

package/dist/tools/debug/tool-config.js

@@ -0,0 +1,79 @@
+import { inputSchema } from './schema.js';
+import { qualityDebugTemplate } from '../../review/reviewer-engine.js';
+import { debugBriefSlot } from '../../intake/brief-compiler-slots/debug.js';
+import { debugHeadlineTemplate } from '../../reporting/headline-templates/debug.js';
+import { DEFAULT_TASK_TIMEOUT_MS } from '../../config/schema.js';
+export function registerDebug(registry) {
+    registry.register({
+        routeName: 'debug',
+        httpMethod: 'POST',
+        httpPath: '/debug',
+        surface: 'tool',
+        schema: inputSchema,
+        toolCategory: 'read_only',
+        agentTypeDefault: 'complex',
+        agentTypeOverridable: false,
+        responseShapeName: 'BatchResponse',
+    });
+}
+const FINDING_FORMAT_INSTRUCTIONS = [
+    'Use hypothesis-driven debugging. Use this EXACT per-finding format so the deterministic extractor can recover findings if the structured reviewer pass fails:',
+    '',
+    '## Finding 1: <one-line title>',
+    '- Severity: critical | high | medium | low',
+    '- Hypothesis: the candidate cause',
+    '- Evidence: trace, log, or code path with file:line',
+    '- Fix: proposed change',
+    '',
+    '## Finding 2: <one-line title>',
+    '- Severity: ...',
+    '- ...',
+    '',
+    'Rules:',
+    '- Each finding heading MUST start with "## Finding N: " (h2, "Finding ", number, colon, title) — number sequentially from 1.',
+    '- Severity / Hypothesis / Evidence / Fix bullets are on their own lines with the labels exactly as shown.',
+    '- Do NOT emit JSON. Both the structured reviewer and the deterministic fallback extract from this same format — the format is the single source of truth.',
+].join('\n');
+function buildFilePathsPrompt(filePaths) {
+    if (!filePaths || filePaths.length === 0)
+        return '';
+    return `Read and analyze these files:\n${filePaths.map(p => `- ${p}`).join('\n')}`;
+}
+export const toolConfig = {
+    name: 'debug',
+    category: 'read_only',
+    agentType: 'complex',
+    briefSlot: debugBriefSlot,
+    buildTaskSpec: (brief, ctx) => {
+        const parts = [`Debug this problem:\n\n${brief.problem}`];
+        if (brief.context)
+            parts.push(`Context: ${brief.context}`);
+        if (brief.hypothesis)
+            parts.push(`Initial hypothesis: ${brief.hypothesis}`);
+        const fileSection = buildFilePathsPrompt(brief.filePaths);
+        if (fileSection)
+            parts.push(fileSection);
+        parts.push(FINDING_FORMAT_INSTRUCTIONS);
+        const prompt = parts.join('\n\n');
+        return {
+            prompt,
+            agentType: 'complex',
+            reviewPolicy: 'quality_only',
+            briefQualityPolicy: 'off',
+            done: 'Identify the root cause with evidence (file, line, mechanism). Propose a fix. Verify the fix resolves the problem.',
+            tools: ctx.config.defaults?.tools ?? 'full',
+            timeoutMs: ctx.config.defaults?.timeoutMs ?? DEFAULT_TASK_TIMEOUT_MS,
+            maxCostUSD: ctx.config.defaults?.maxCostUSD ?? 10,
+            sandboxPolicy: ctx.config.defaults?.sandboxPolicy ?? 'cwd-only',
+            cwd: ctx.projectContext?.cwd ?? ctx.cwd,
+            contextBlockIds: brief.contextBlockIds,
+            autoCommit: false,
+        };
+    },
+    reportSchema: { parse: (_text) => { throw new Error('no structured report emitted by this executor'); } },
+    headlineTemplate: debugHeadlineTemplate,
+    reviewTemplates: {
+        qualityAP: qualityDebugTemplate,
+    },
+};
+//# sourceMappingURL=tool-config.js.map

package/dist/tools/debug/tool-config.js.map

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