@soleri/core 2.12.0 → 7.0.0

package/dist/domain-packs/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Domain Pack types — the contract for plug-and-play domain intelligence.
+ *
+ * A DomainPack is an npm package that bundles:
+ * - Custom ops with real algorithmic logic (e.g., WCAG contrast checking)
+ * - Optional standalone facades (one pack can register multiple MCP tools)
+ * - Tiered knowledge (canonical/curated/captured)
+ * - CLAUDE.md behavioral rules
+ * - Skills
+ *
+ * One pack = one npm package, can register multiple facades.
+ */
+import { z } from 'zod';
+import type { OpDefinition, FacadeConfig } from '../facades/types.js';
+import type { AgentRuntime } from '../runtime/types.js';
+import type { PackRuntime } from './pack-runtime.js';
+export declare const SEMANTIC_FACADE_NAMES: ReadonlyArray<string>;
+/** Three-tier knowledge structure. Each tier has different lifecycle rules. */
+export interface KnowledgeManifest {
+    /** Immutable rules and axioms. Never overwritten by curator. Highest search authority. */
+    canonical?: string;
+    /** Patterns and anti-patterns. Curator can groom, deduplicate, enrich. */
+    curated?: string;
+    /** Seed learnings. Rarely shipped — normally emerges from agent usage. */
+    captured?: string;
+}
+export interface PackSkillDefinition {
+    /** Skill file name (without .md extension) */
+    name: string;
+    /** Path to the .md skill file relative to the pack */
+    path: string;
+}
+/** The contract every domain pack must implement. */
+export interface DomainPack {
+    /** Unique pack name (e.g., 'design', 'security-intelligence') */
+    name: string;
+    /** Semver version */
+    version: string;
+    /** Domains this pack claims. Ops inject into these domain facades. */
+    domains: string[];
+    /** Custom operations with real logic — injected into claimed domain facades. */
+    ops: OpDefinition[];
+    /** Additional standalone facades (one pack can register multiple MCP tools). */
+    facades?: FacadeConfig[];
+    /** Tiered knowledge to install into the agent's vault. */
+    knowledge?: KnowledgeManifest;
+    /** CLAUDE.md behavioral rules fragment (markdown). */
+    rules?: string;
+    /** Skills to install into the agent's skills directory. */
+    skills?: PackSkillDefinition[];
+    /** Capability handler factory — returns handlers for declared capabilities */
+    capabilities?: (runtime: PackRuntime) => Map<string, import('../capabilities/types.js').CapabilityHandler>;
+    /** Other packs this pack depends on (by name). */
+    requires?: string[];
+    /** Called after pack is installed (one-time setup). */
+    onInstall?: (runtime: AgentRuntime) => Promise<void>;
+    /** Called each time the agent starts (runtime initialization). */
+    onActivate?: (runtime: AgentRuntime) => Promise<void>;
+}
+/** Reference to a domain pack in agent configuration. */
+export interface DomainPackRef {
+    /** Display name */
+    name: string;
+    /** npm package name (e.g., '@soleri/domain-design') */
+    package: string;
+    /** Optional version constraint */
+    version?: string;
+}
+/** A DomainPack that has been validated and resolved. */
+export interface DomainPackManifest extends DomainPack {
+    /** Resolved from npm package name */
+    packageName: string;
+    /** Absolute path to the pack's root directory */
+    rootDir?: string;
+}
+export type ValidateResult = {
+    success: true;
+    data: DomainPack;
+} | {
+    success: false;
+    errors: z.ZodError;
+};
+/**
+ * Validate an unknown value as a DomainPack.
+ *
+ * Beyond Zod shape validation, also checks:
+ * - Op names are unique within the pack
+ * - Facade names don't collide with semantic facades
+ */
+export declare function validateDomainPack(value: unknown): ValidateResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/domain-packs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/domain-packs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAgB9C,CAAC;AAMX,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,gFAAgF;IAChF,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,WAAW,KACjB,GAAG,CAAC,MAAM,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;IACvE,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,kEAAkE;IAClE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAMD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,yDAAyD;AACzD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiDD,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA6CjE"}

package/dist/domain-packs/types.js

@@ -0,0 +1,122 @@
+/**
+ * Domain Pack types — the contract for plug-and-play domain intelligence.
+ *
+ * A DomainPack is an npm package that bundles:
+ * - Custom ops with real algorithmic logic (e.g., WCAG contrast checking)
+ * - Optional standalone facades (one pack can register multiple MCP tools)
+ * - Tiered knowledge (canonical/curated/captured)
+ * - CLAUDE.md behavioral rules
+ * - Skills
+ *
+ * One pack = one npm package, can register multiple facades.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Reserved names — packs cannot claim these as facade names
+// ---------------------------------------------------------------------------
+export const SEMANTIC_FACADE_NAMES = [
+    'vault',
+    'plan',
+    'brain',
+    'memory',
+    'admin',
+    'curator',
+    'loop',
+    'orchestrate',
+    'control',
+    'cognee',
+    'governance',
+    'context',
+    'agency',
+    'chat',
+    'playbook',
+];
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+const knowledgeManifestSchema = z.object({
+    canonical: z.string().optional(),
+    curated: z.string().optional(),
+    captured: z.string().optional(),
+});
+const packSkillSchema = z.object({
+    name: z.string(),
+    path: z.string(),
+});
+/** Zod schema for validating DomainPack structure (data fields only). */
+const domainPackSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().min(1),
+    domains: z.array(z.string().min(1)).min(1),
+    ops: z.array(z.object({
+        name: z.string().min(1),
+        description: z.string(),
+        auth: z.enum(['read', 'write', 'admin']),
+        handler: z.function(),
+        schema: z.any().optional(),
+        hot: z.boolean().optional(),
+    })),
+    facades: z
+        .array(z.object({
+        name: z.string().min(1),
+        description: z.string(),
+        ops: z.array(z.any()),
+    }))
+        .optional(),
+    knowledge: knowledgeManifestSchema.optional(),
+    rules: z.string().optional(),
+    skills: z.array(packSkillSchema).optional(),
+    requires: z.array(z.string()).optional(),
+    onInstall: z.function().optional(),
+    onActivate: z.function().optional(),
+});
+/**
+ * Validate an unknown value as a DomainPack.
+ *
+ * Beyond Zod shape validation, also checks:
+ * - Op names are unique within the pack
+ * - Facade names don't collide with semantic facades
+ */
+export function validateDomainPack(value) {
+    const parsed = domainPackSchema.safeParse(value);
+    if (!parsed.success) {
+        return { success: false, errors: parsed.error };
+    }
+    const pack = parsed.data;
+    // Check for duplicate op names
+    const opNames = new Set();
+    for (const op of pack.ops) {
+        if (opNames.has(op.name)) {
+            return {
+                success: false,
+                errors: new z.ZodError([
+                    {
+                        code: 'custom',
+                        path: ['ops'],
+                        message: `Duplicate op name: "${op.name}"`,
+                    },
+                ]),
+            };
+        }
+        opNames.add(op.name);
+    }
+    // Check facade name collisions with semantic facades
+    if (pack.facades) {
+        for (const facade of pack.facades) {
+            if (SEMANTIC_FACADE_NAMES.includes(facade.name)) {
+                return {
+                    success: false,
+                    errors: new z.ZodError([
+                        {
+                            code: 'custom',
+                            path: ['facades'],
+                            message: `Facade name "${facade.name}" collides with semantic facade. Reserved names: ${SEMANTIC_FACADE_NAMES.join(', ')}`,
+                        },
+                    ]),
+                };
+            }
+        }
+    }
+    return { success: true, data: pack };
+}
+//# sourceMappingURL=types.js.map

package/dist/domain-packs/types.js.map

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

package/dist/engine/bin/soleri-engine.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Soleri Knowledge Engine — MCP Server
+ *
+ * Reads agent.yaml, boots the runtime, registers all tools, connects stdio.
+ *
+ * Usage:
+ *   npx @soleri/engine --agent ./agent.yaml
+ *   node dist/engine/bin/soleri-engine.js --agent ./agent.yaml
+ */
+export {};
+//# sourceMappingURL=soleri-engine.d.ts.map

package/dist/engine/bin/soleri-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soleri-engine.d.ts","sourceRoot":"","sources":["../../../src/engine/bin/soleri-engine.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/engine/bin/soleri-engine.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+/**
+ * Soleri Knowledge Engine — MCP Server
+ *
+ * Reads agent.yaml, boots the runtime, registers all tools, connects stdio.
+ *
+ * Usage:
+ *   npx @soleri/engine --agent ./agent.yaml
+ *   node dist/engine/bin/soleri-engine.js --agent ./agent.yaml
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { parse as parseYaml } from 'yaml';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createAgentRuntime } from '../../runtime/runtime.js';
+import { registerEngine } from '../register-engine.js';
+import { createCoreOps } from '../core-ops.js';
+import { seedDefaultPlaybooks } from '../../playbooks/playbook-seeder.js';
+// ─── Parse CLI args ───────────────────────────────────────────────────
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let agentYamlPath;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--agent' && args[i + 1]) {
+            agentYamlPath = resolve(args[i + 1]);
+            break;
+        }
+    }
+    if (!agentYamlPath) {
+        // Default: look for agent.yaml in cwd
+        agentYamlPath = resolve('agent.yaml');
+    }
+    if (!existsSync(agentYamlPath)) {
+        console.error(`[soleri-engine] agent.yaml not found: ${agentYamlPath}`);
+        console.error('Usage: soleri-engine --agent ./agent.yaml');
+        process.exit(1);
+    }
+    return { agentYamlPath };
+}
+// ─── Main ─────────────────────────────────────────────────────────────
+async function main() {
+    const { agentYamlPath } = parseArgs();
+    const agentDir = dirname(agentYamlPath);
+    // 1. Read agent.yaml
+    const raw = readFileSync(agentYamlPath, 'utf-8');
+    const config = parseYaml(raw);
+    const agentId = config.id;
+    const tag = `[${agentId}]`;
+    console.error(`${tag} Starting Soleri Knowledge Engine...`);
+    console.error(`${tag} Agent: ${config.name} (${agentId})`);
+    console.error(`${tag} Format: file-tree`);
+    // 2. Resolve vault path
+    const engineConfig = (config.engine ?? {});
+    const vaultPath = engineConfig.vault
+        ? resolve(engineConfig.vault.replace(/^~/, homedir()))
+        : join(homedir(), `.${agentId}`, 'vault.db');
+    // 3. Create runtime
+    const runtime = createAgentRuntime({
+        agentId,
+        vaultPath,
+        cognee: engineConfig.cognee ?? false,
+    });
+    console.error(`${tag} Vault: ${vaultPath}`);
+    console.error(`${tag} Vault entries: ${runtime.vault.stats().totalEntries}`);
+    // 4. Connect linked vaults
+    const vaults = (config.vaults ?? []);
+    for (const vault of vaults) {
+        try {
+            const vaultAbsPath = resolve(vault.path.replace(/^~/, homedir()));
+            runtime.vaultManager.connect(vault.name, vaultAbsPath, vault.priority ?? 0.5);
+            console.error(`${tag} Linked vault: ${vault.name} (${vaultAbsPath})`);
+        }
+        catch (err) {
+            console.error(`${tag} Warning: failed to connect vault "${vault.name}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 5. Seed intelligence data from knowledge/ directory
+    const knowledgeDir = join(agentDir, 'knowledge');
+    if (existsSync(knowledgeDir)) {
+        const { readdirSync } = await import('node:fs');
+        const files = readdirSync(knowledgeDir).filter((f) => f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const bundle = JSON.parse(readFileSync(join(knowledgeDir, file), 'utf-8'));
+                if (bundle.entries && Array.isArray(bundle.entries) && bundle.entries.length > 0) {
+                    const seeded = runtime.vault.seed(bundle.entries);
+                    console.error(`${tag} Seeded ${seeded} entries from ${file}`);
+                }
+            }
+            catch {
+                // Skip invalid bundles
+            }
+        }
+    }
+    // 6. Seed default playbooks
+    seedDefaultPlaybooks(runtime.vault);
+    // 7. Load domain packs
+    const packs = (config.packs ?? []);
+    const loadedPacks = [];
+    if (packs.length > 0) {
+        try {
+            const { loadDomainPacksFromConfig } = await import('../../domain-packs/loader.js');
+            const refs = packs.map((p) => ({ name: p.name, package: p.package, version: p.version }));
+            const manifests = await loadDomainPacksFromConfig(refs);
+            // Packs activate sequentially — order may matter for dependencies
+            for (const manifest of manifests) {
+                if (manifest.onActivate) {
+                    await manifest.onActivate(runtime); // eslint-disable-line no-await-in-loop
+                }
+                loadedPacks.push(manifest);
+                console.error(`${tag} Domain pack: ${manifest.name}`);
+            }
+        }
+        catch (err) {
+            console.error(`${tag} Warning: domain pack loading failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 8. Build identity config from agent.yaml
+    const identity = {
+        id: agentId,
+        name: config.name,
+        role: config.role,
+        description: config.description,
+        domains: (config.domains ?? []),
+        principles: (config.principles ?? []),
+        tone: config.tone ?? 'pragmatic',
+        greeting: config.greeting,
+    };
+    // 9. Create core ops
+    const coreOps = createCoreOps(runtime, identity);
+    // 10. Create MCP server
+    const server = new McpServer({
+        name: `${agentId}-engine`,
+        version: '1.0.0',
+    });
+    // 11. Register persona prompt
+    server.prompt('persona', 'Get agent persona and principles', () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `You are ${identity.name}. ${identity.role}.\n\nPrinciples:\n${identity.principles.map((p) => `- ${p}`).join('\n')}\n\nTone: ${identity.tone}`,
+                },
+            },
+        ],
+    }));
+    // 12. Register all engine tools
+    const { tools, totalOps } = registerEngine(server, runtime, {
+        agentId,
+        coreOps,
+        domains: identity.domains,
+        domainPacks: loadedPacks,
+        hotOps: [
+            'search_intelligent',
+            'capture_knowledge',
+            'orchestrate_plan',
+            'orchestrate_execute',
+            'orchestrate_complete',
+        ],
+        authPolicy: () => runtime.authPolicy,
+    });
+    console.error(`${tag} Registered ${tools.length} tools (${totalOps} ops)`);
+    // 13. Connect stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${tag} Engine ready — listening on stdio`);
+    // 14. Graceful shutdown
+    const shutdown = () => {
+        console.error(`${tag} Shutting down...`);
+        runtime.close();
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+main().catch((err) => {
+    console.error('[soleri-engine] Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=soleri-engine.js.map

package/dist/engine/bin/soleri-engine.js.map

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

package/dist/engine/core-ops.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from '../runtime/types.js';
+export interface AgentIdentityConfig {
+    id: string;
+    name: string;
+    role: string;
+    description: string;
+    domains: string[];
+    principles: string[];
+    tone: string;
+    greeting?: string;
+}
+/**
+ * Create agent-specific core ops from identity config.
+ * These are registered under `{agentId}_core`.
+ */
+export declare function createCoreOps(runtime: AgentRuntime, identity: AgentIdentityConfig): OpDefinition[];
+//# sourceMappingURL=core-ops.d.ts.map

package/dist/engine/core-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ops.d.ts","sourceRoot":"","sources":["../../src/engine/core-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,mBAAmB,GAC5B,YAAY,EAAE,CAiJhB"}

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"}