@soleri/core 2.12.0 → 8.0.0

package/dist/engine/core-ops.js

@@ -0,0 +1,159 @@
+/**
+ * Soleri v7 — Agent Core Ops
+ *
+ * Generates the agent-specific ops (health, identity, activate, setup)
+ * from agent.yaml config, without generated TypeScript.
+ *
+ * These ops were previously hardcoded in the Forge entry-point template.
+ * Now they're created dynamically by the engine at startup.
+ */
+import { z } from 'zod';
+/**
+ * Create agent-specific core ops from identity config.
+ * These are registered under `{agentId}_core`.
+ */
+export function createCoreOps(runtime, identity) {
+    return [
+        {
+            name: 'health',
+            description: 'Health check — vault status and agent info.',
+            auth: 'read',
+            handler: async () => {
+                const s = runtime.vault.stats();
+                return {
+                    status: 'ok',
+                    agent: { name: identity.name, role: identity.role, format: 'filetree' },
+                    vault: { entries: s.totalEntries, domains: Object.keys(s.byDomain) },
+                };
+            },
+        },
+        {
+            name: 'identity',
+            description: 'Get agent identity — name, role, principles.',
+            auth: 'read',
+            handler: async () => {
+                // Check IdentityManager first (may have evolved via updates)
+                const managed = runtime.identityManager?.getIdentity(identity.id);
+                if (managed)
+                    return managed;
+                return {
+                    name: identity.name,
+                    role: identity.role,
+                    description: identity.description,
+                    domains: identity.domains,
+                    principles: identity.principles,
+                    tone: identity.tone,
+                };
+            },
+        },
+        {
+            name: 'activate',
+            description: `Activate agent persona. Say "Hello, ${identity.name}!" to trigger.`,
+            auth: 'read',
+            schema: z.object({
+                projectPath: z.string().optional().default('.'),
+                deactivate: z.boolean().optional(),
+            }),
+            handler: async (params) => {
+                if (params.deactivate) {
+                    return { deactivated: true, agent: identity.id };
+                }
+                // Seed identity on first activation
+                if (runtime.identityManager && !runtime.identityManager.getIdentity(identity.id)) {
+                    runtime.identityManager.setIdentity(identity.id, {
+                        name: identity.name,
+                        role: identity.role,
+                        description: identity.description,
+                        personality: identity.principles,
+                        changedBy: 'system',
+                        changeReason: 'Initial identity seeded from agent.yaml',
+                    });
+                }
+                // Register project if project registry available
+                const projectPath = params.projectPath ?? '.';
+                if (runtime.projectRegistry) {
+                    try {
+                        runtime.projectRegistry.register(projectPath);
+                    }
+                    catch {
+                        // Project may already be registered
+                    }
+                }
+                // Build activation context
+                const s = runtime.vault.stats();
+                return {
+                    activated: true,
+                    agent: {
+                        id: identity.id,
+                        name: identity.name,
+                        role: identity.role,
+                        description: identity.description,
+                        format: 'filetree',
+                    },
+                    persona: {
+                        tone: identity.tone,
+                        principles: identity.principles,
+                        greeting: identity.greeting ?? `Hello! I am ${identity.name}.`,
+                    },
+                    vault: {
+                        connected: true,
+                        entries: s.totalEntries,
+                        domains: Object.keys(s.byDomain),
+                    },
+                    domains: identity.domains,
+                };
+            },
+        },
+        {
+            name: 'register',
+            description: 'Register a project for context tracking.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().default('.'),
+            }),
+            handler: async (params) => {
+                const projectPath = params.projectPath ?? '.';
+                if (runtime.projectRegistry) {
+                    try {
+                        const project = runtime.projectRegistry.register(projectPath);
+                        return { registered: true, project };
+                    }
+                    catch {
+                        return { registered: false, reason: 'Already registered or error' };
+                    }
+                }
+                return { registered: false, reason: 'Project registry not available' };
+            },
+        },
+        {
+            name: 'setup',
+            description: 'Check setup status — vault entries, engine health, domain packs.',
+            auth: 'read',
+            handler: async () => {
+                const s = runtime.vault.stats();
+                return {
+                    agent: {
+                        id: identity.id,
+                        name: identity.name,
+                        format: 'filetree',
+                    },
+                    vault: {
+                        entries: s.totalEntries,
+                        domains: Object.keys(s.byDomain),
+                        byType: s.byType,
+                    },
+                    engine: {
+                        cognee: runtime.cognee !== null && runtime.cognee !== undefined,
+                        brain: true,
+                        curator: true,
+                        planner: true,
+                    },
+                    recommendations: s.totalEntries === 0
+                        ? ['Vault is empty — capture knowledge to start building intelligence']
+                        : [],
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=core-ops.js.map

package/dist/engine/core-ops.js.map

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

package/dist/engine/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Soleri Knowledge Engine — MCP Server Entry Point
+ *
+ * This is the standalone knowledge engine that file-tree agents connect to.
+ * It reads agent.yaml, initializes the runtime, and registers all tools.
+ *
+ * Usage:
+ *   npx @soleri/engine --agent ./agent.yaml
+ *
+ * Or in .mcp.json:
+ *   { "command": "npx", "args": ["@soleri/engine", "--agent", "./agent.yaml"] }
+ *
+ * Binary entry point: ./bin/soleri-engine.ts
+ */
+export { registerEngine } from './register-engine.js';
+export type { EngineRegistrationOptions, EngineRegistrationResult } from './register-engine.js';
+export { createCoreOps } from './core-ops.js';
+export type { AgentIdentityConfig } from './core-ops.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,17 @@
+/**
+ * Soleri Knowledge Engine — MCP Server Entry Point
+ *
+ * This is the standalone knowledge engine that file-tree agents connect to.
+ * It reads agent.yaml, initializes the runtime, and registers all tools.
+ *
+ * Usage:
+ *   npx @soleri/engine --agent ./agent.yaml
+ *
+ * Or in .mcp.json:
+ *   { "command": "npx", "args": ["@soleri/engine", "--agent", "./agent.yaml"] }
+ *
+ * Binary entry point: ./bin/soleri-engine.ts
+ */
+export { registerEngine } from './register-engine.js';
+export { createCoreOps } from './core-ops.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/register-engine.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Soleri v7 — Direct Engine Registration
+ *
+ * Registers all engine modules as MCP tools without the facade factory.
+ * Each module gets a single MCP tool with op-based dispatch.
+ *
+ * This replaces:
+ *   - facade-factory.ts (generic dispatch layer)
+ *   - registerAllFacades() + registerFacade() + dispatchOp()
+ *   - FacadeConfig type (no longer needed)
+ *
+ * What stays:
+ *   - createVaultFacadeOps(), createBrainFacadeOps(), etc. (op definitions)
+ *   - createAgentRuntime() (module initialization)
+ *   - OpDefinition type (handler + schema + auth)
+ *   - Auth checking (same logic, inlined)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentRuntime } from '../runtime/types.js';
+import type { OpDefinition, AuthPolicy } from '../facades/types.js';
+export interface EngineRegistrationOptions {
+    /** Agent ID — used as tool name prefix (e.g., "gaudi" → "gaudi_vault") */
+    agentId: string;
+    /** Auth policy factory (optional — defaults to permissive) */
+    authPolicy?: () => AuthPolicy;
+    /** Additional ops to add to the core facade (agent-specific ops like health, activate) */
+    coreOps?: OpDefinition[];
+    /** Knowledge domains for domain-specific facades */
+    domains?: string[];
+    /** Domain packs (from @soleri/domain-*) */
+    domainPacks?: Array<{
+        name: string;
+        facades?: Array<{
+            name: string;
+            ops: OpDefinition[];
+        }>;
+    }>;
+    /** Op names to ALSO register as standalone MCP tools (hot ops) */
+    hotOps?: string[];
+}
+export interface EngineRegistrationResult {
+    /** All registered MCP tool names */
+    tools: string[];
+    /** Total op count across all tools */
+    totalOps: number;
+}
+/**
+ * Register all engine modules as MCP tools on the given server.
+ *
+ * Each module becomes one MCP tool: `{agentId}_{module}` with `op` + `params` arguments.
+ * Dispatch is a direct switch on op name — no generic factory, no FacadeConfig type.
+ */
+export declare function registerEngine(server: McpServer, runtime: AgentRuntime, options: EngineRegistrationOptions): EngineRegistrationResult;
+//# sourceMappingURL=register-engine.d.ts.map

package/dist/engine/register-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-engine.d.ts","sourceRoot":"","sources":["../../src/engine/register-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAqBpE,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,UAAU,CAAC;IAC9B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,YAAY,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAC9F,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuFD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CA6E1B"}

package/dist/engine/register-engine.js

@@ -0,0 +1,270 @@
+/**
+ * Soleri v7 — Direct Engine Registration
+ *
+ * Registers all engine modules as MCP tools without the facade factory.
+ * Each module gets a single MCP tool with op-based dispatch.
+ *
+ * This replaces:
+ *   - facade-factory.ts (generic dispatch layer)
+ *   - registerAllFacades() + registerFacade() + dispatchOp()
+ *   - FacadeConfig type (no longer needed)
+ *
+ * What stays:
+ *   - createVaultFacadeOps(), createBrainFacadeOps(), etc. (op definitions)
+ *   - createAgentRuntime() (module initialization)
+ *   - OpDefinition type (handler + schema + auth)
+ *   - Auth checking (same logic, inlined)
+ */
+import { z } from 'zod';
+import { AUTH_LEVEL_RANK } from '../facades/types.js';
+// Re-export op creators (these are the source of truth for op definitions)
+import { createVaultFacadeOps } from '../runtime/facades/vault-facade.js';
+import { createPlanFacadeOps } from '../runtime/facades/plan-facade.js';
+import { createBrainFacadeOps } from '../runtime/facades/brain-facade.js';
+import { createMemoryFacadeOps } from '../runtime/facades/memory-facade.js';
+import { createAdminFacadeOps } from '../runtime/facades/admin-facade.js';
+import { createCuratorFacadeOps } from '../runtime/facades/curator-facade.js';
+import { createLoopFacadeOps } from '../runtime/facades/loop-facade.js';
+import { createOrchestrateFacadeOps } from '../runtime/facades/orchestrate-facade.js';
+import { createControlFacadeOps } from '../runtime/facades/control-facade.js';
+import { createCogneeFacadeOps } from '../runtime/facades/cognee-facade.js';
+import { createContextFacadeOps } from '../runtime/facades/context-facade.js';
+import { createAgencyFacadeOps } from '../runtime/facades/agency-facade.js';
+import { createChatFacadeOps } from '../runtime/facades/chat-facade.js';
+import { createDomainFacade } from '../runtime/domain-ops.js';
+const ENGINE_MODULES = [
+    {
+        suffix: 'vault',
+        description: 'Knowledge management — search, CRUD, import/export, intake, archival.',
+        createOps: createVaultFacadeOps,
+    },
+    {
+        suffix: 'plan',
+        description: 'Plan lifecycle — create, approve, execute, reconcile, complete, grading.',
+        createOps: createPlanFacadeOps,
+    },
+    {
+        suffix: 'brain',
+        description: 'Learning system — intelligence pipeline, strengths, feedback, sessions.',
+        createOps: createBrainFacadeOps,
+    },
+    {
+        suffix: 'memory',
+        description: 'Session & cross-project memory — capture, search, dedup, promote.',
+        createOps: createMemoryFacadeOps,
+    },
+    {
+        suffix: 'admin',
+        description: 'Infrastructure — health, config, telemetry, tokens, LLM, prompts.',
+        createOps: createAdminFacadeOps,
+    },
+    {
+        suffix: 'curator',
+        description: 'Quality — duplicate detection, contradictions, grooming, health audit.',
+        createOps: createCuratorFacadeOps,
+    },
+    {
+        suffix: 'loop',
+        description: 'Iterative validation loops — start, iterate, cancel, complete, history.',
+        createOps: createLoopFacadeOps,
+    },
+    {
+        suffix: 'orchestrate',
+        description: 'Execution orchestration — project registration, playbooks, plan/execute/complete.',
+        createOps: createOrchestrateFacadeOps,
+    },
+    {
+        suffix: 'control',
+        description: 'Agent behavior — identity, intent routing, morphing, guidelines, governance.',
+        createOps: createControlFacadeOps,
+    },
+    {
+        suffix: 'context',
+        description: 'Context analysis — entity extraction, knowledge retrieval, confidence scoring.',
+        createOps: createContextFacadeOps,
+    },
+    {
+        suffix: 'agency',
+        description: 'Proactive intelligence — file watching, pattern surfacing, warnings.',
+        createOps: createAgencyFacadeOps,
+    },
+    {
+        suffix: 'chat',
+        description: 'Chat transport — session management, response chunking, authentication.',
+        createOps: createChatFacadeOps,
+    },
+    {
+        suffix: 'cognee',
+        description: 'Knowledge graph — Cognee search, sync, export, graph stats.',
+        createOps: createCogneeFacadeOps,
+        condition: (rt) => rt.cognee !== null && rt.cognee !== undefined,
+    },
+];
+// ─── Core Registration ────────────────────────────────────────────────
+/**
+ * Register all engine modules as MCP tools on the given server.
+ *
+ * Each module becomes one MCP tool: `{agentId}_{module}` with `op` + `params` arguments.
+ * Dispatch is a direct switch on op name — no generic factory, no FacadeConfig type.
+ */
+export function registerEngine(server, runtime, options) {
+    const { agentId, authPolicy, coreOps, domains, domainPacks, hotOps } = options;
+    const hotSet = new Set(hotOps ?? []);
+    const registeredTools = [];
+    let totalOps = 0;
+    // 1. Register semantic module tools
+    for (const mod of ENGINE_MODULES) {
+        if (mod.condition && !mod.condition(runtime))
+            continue;
+        const ops = mod.createOps(runtime);
+        const toolName = `${agentId}_${mod.suffix}`;
+        registerModuleTool(server, toolName, mod.description, ops, authPolicy);
+        registeredTools.push(toolName);
+        totalOps += ops.length;
+        // Hot ops: also register as standalone tools
+        for (const op of ops) {
+            if (op.hot || hotSet.has(op.name)) {
+                registerStandaloneTool(server, agentId, toolName, op, authPolicy);
+                registeredTools.push(`${agentId}_${op.name}`);
+            }
+        }
+    }
+    // 2. Register core facade (agent-specific ops: health, identity, activate, etc.)
+    if (coreOps && coreOps.length > 0) {
+        const coreName = `${agentId}_core`;
+        registerModuleTool(server, coreName, 'Agent-specific operations — health, identity, activation.', coreOps, authPolicy);
+        registeredTools.push(coreName);
+        totalOps += coreOps.length;
+    }
+    // 3. Register domain facades
+    if (domains) {
+        for (const domain of domains) {
+            const domainConfig = createDomainFacade(runtime, agentId, domain);
+            registerModuleTool(server, domainConfig.name, domainConfig.description, domainConfig.ops, authPolicy);
+            registeredTools.push(domainConfig.name);
+            totalOps += domainConfig.ops.length;
+        }
+    }
+    // 4. Register domain pack facades
+    if (domainPacks) {
+        for (const pack of domainPacks) {
+            if (pack.facades) {
+                for (const facade of pack.facades) {
+                    const packToolName = `${agentId}_${facade.name}`;
+                    registerModuleTool(server, packToolName, `Domain pack: ${pack.name}`, facade.ops, authPolicy);
+                    registeredTools.push(packToolName);
+                    totalOps += facade.ops.length;
+                }
+            }
+        }
+    }
+    return { tools: registeredTools, totalOps };
+}
+// ─── Tool Registration (No Factory) ──────────────────────────────────
+/**
+ * Register a single grouped tool with op dispatch.
+ * This is the replacement for registerFacade() — same behavior, no FacadeConfig type.
+ */
+function registerModuleTool(server, toolName, description, ops, authPolicy) {
+    const opNames = ops.map((o) => o.name);
+    const opMap = new Map(ops.map((o) => [o.name, o]));
+    server.tool(toolName, description, {
+        op: z.string().describe(`Operation: ${opNames.join(' | ')}`),
+        params: z.record(z.unknown()).optional().default({}).describe('Operation parameters'),
+    }, async ({ op: opName, params }) => {
+        const op = opMap.get(opName);
+        if (!op) {
+            return jsonResponse({
+                success: false,
+                error: `Unknown operation "${opName}" on ${toolName}. Available: ${opNames.join(', ')}`,
+                op: opName,
+                facade: toolName,
+            });
+        }
+        // Auth check
+        const policy = authPolicy?.();
+        const authErr = checkAuth(opName, op.auth, toolName, policy);
+        if (authErr)
+            return jsonResponse(authErr);
+        // Validate + execute
+        try {
+            let validatedParams = params;
+            if (op.schema) {
+                const result = op.schema.safeParse(params);
+                if (!result.success) {
+                    return jsonResponse({
+                        success: false,
+                        error: `Invalid params for ${opName}: ${result.error.message}`,
+                        op: opName,
+                        facade: toolName,
+                    });
+                }
+                validatedParams = result.data;
+            }
+            const data = await op.handler(validatedParams);
+            return jsonResponse({ success: true, data, op: opName, facade: toolName });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return jsonResponse({ success: false, error: message, op: opName, facade: toolName });
+        }
+    });
+}
+/**
+ * Register a single op as a standalone MCP tool (hot op).
+ */
+function registerStandaloneTool(server, agentId, parentTool, op, authPolicy) {
+    const toolName = `${agentId}_${op.name}`;
+    const schema = op.schema
+        ? op.schema.shape
+            ? op.schema
+            : z.object({ params: op.schema })
+        : z.object({});
+    server.tool(toolName, op.description, schema instanceof z.ZodObject ? schema.shape : {}, async (params) => {
+        const policy = authPolicy?.();
+        const authErr = checkAuth(op.name, op.auth, parentTool, policy);
+        if (authErr)
+            return jsonResponse(authErr);
+        try {
+            let validatedParams = params;
+            if (op.schema) {
+                const result = op.schema.safeParse(params);
+                if (!result.success) {
+                    return jsonResponse({
+                        success: false,
+                        error: `Invalid params: ${result.error.message}`,
+                        op: op.name,
+                        facade: parentTool,
+                    });
+                }
+                validatedParams = result.data;
+            }
+            const data = await op.handler(validatedParams);
+            return jsonResponse({ success: true, data, op: op.name, facade: parentTool });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return jsonResponse({ success: false, error: message, op: op.name, facade: parentTool });
+        }
+    });
+}
+// ─── Helpers ──────────────────────────────────────────────────────────
+function checkAuth(opName, opAuth, toolName, policy) {
+    if (!policy || policy.mode === 'permissive')
+        return null;
+    const requiredLevel = policy.overrides?.[opName] ?? opAuth;
+    const callerRank = AUTH_LEVEL_RANK[policy.callerLevel] ?? 0;
+    const requiredRank = AUTH_LEVEL_RANK[requiredLevel] ?? 0;
+    if (callerRank >= requiredRank)
+        return null;
+    const message = `Auth denied: "${opName}" requires ${requiredLevel}, caller has ${policy.callerLevel}`;
+    if (policy.mode === 'warn') {
+        console.error(`[auth-warn] ${message}`);
+        return null;
+    }
+    return { success: false, error: message, op: opName, facade: toolName };
+}
+function jsonResponse(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+//# sourceMappingURL=register-engine.js.map

package/dist/engine/register-engine.js.map

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

package/dist/engine/test-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Test helpers for the engine registration.
+ *
+ * Provides captureOps() — equivalent to the old captureHandler() pattern
+ * used across 18+ E2E tests — but for the new direct registration.
+ */
+import type { OpDefinition } from '../facades/types.js';
+export interface CapturedOp {
+    name: string;
+    handler: (params: Record<string, unknown>) => Promise<unknown>;
+    schema?: unknown;
+    auth: string;
+}
+/**
+ * Capture all op handlers from an op creator function for direct testing.
+ * Replaces the old pattern of mocking McpServer + registerFacade + captureHandler.
+ */
+export declare function captureOps(ops: OpDefinition[]): Map<string, CapturedOp>;
+/**
+ * Execute an op by name against captured ops, with response envelope.
+ * Matches the old dispatchOp() behavior for test compatibility.
+ */
+export declare function executeOp(ops: Map<string, CapturedOp>, opName: string, params?: Record<string, unknown>, facadeName?: string): Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    op: string;
+    facade: string;
+}>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/engine/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/engine/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAWvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAU,SAAS,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC3F"}

package/dist/engine/test-helpers.js

@@ -0,0 +1,59 @@
+/**
+ * Test helpers for the engine registration.
+ *
+ * Provides captureOps() — equivalent to the old captureHandler() pattern
+ * used across 18+ E2E tests — but for the new direct registration.
+ */
+/**
+ * Capture all op handlers from an op creator function for direct testing.
+ * Replaces the old pattern of mocking McpServer + registerFacade + captureHandler.
+ */
+export function captureOps(ops) {
+    const map = new Map();
+    for (const op of ops) {
+        map.set(op.name, {
+            name: op.name,
+            handler: op.handler,
+            schema: op.schema,
+            auth: op.auth,
+        });
+    }
+    return map;
+}
+/**
+ * Execute an op by name against captured ops, with response envelope.
+ * Matches the old dispatchOp() behavior for test compatibility.
+ */
+export async function executeOp(ops, opName, params = {}, facadeName = 'test') {
+    const op = ops.get(opName);
+    if (!op) {
+        return {
+            success: false,
+            error: `Unknown operation "${opName}". Available: ${[...ops.keys()].join(', ')}`,
+            op: opName,
+            facade: facadeName,
+        };
+    }
+    try {
+        let validatedParams = params;
+        if (op.schema && typeof op.schema.safeParse === 'function') {
+            const result = op.schema.safeParse(params);
+            if (!result.success) {
+                return {
+                    success: false,
+                    error: `Invalid params for ${opName}: ${result.error?.message}`,
+                    op: opName,
+                    facade: facadeName,
+                };
+            }
+            validatedParams = result.data;
+        }
+        const data = await op.handler(validatedParams);
+        return { success: true, data, op: opName, facade: facadeName };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: message, op: opName, facade: facadeName };
+    }
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/engine/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/engine/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAmB;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAA4B,EAC5B,MAAc,EACd,SAAkC,EAAE,EACpC,UAAU,GAAG,MAAM;IAEnB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sBAAsB,MAAM,iBAAiB,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChF,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,eAAe,GAAG,MAAM,CAAC;QAC7B,IAAI,EAAE,CAAC,MAAM,IAAI,OAAQ,EAAE,CAAC,MAAkC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACxF,MAAM,MAAM,GACV,EAAE,CAAC,MAOJ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,sBAAsB,MAAM,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE;oBAC/D,EAAE,EAAE,MAAM;oBACV,MAAM,EAAE,UAAU;iBACnB,CAAC;YACJ,CAAC;YACD,eAAe,GAAG,MAAM,CAAC,IAA+B,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}