@soleri/core 2.0.2 → 2.4.0

package/dist/runtime/project-ops.js

@@ -0,0 +1,181 @@
+/**
+ * Project registry operations — 12 ops for managing projects, rules, and links.
+ *
+ * These ops expose the ProjectRegistry module as facade operations.
+ * All state is persisted in the Vault's SQLite database.
+ */
+import { z } from 'zod';
+/**
+ * Create the 12 project registry operations for an agent runtime.
+ *
+ * Groups: projects (3), rules (4), links (4), misc (1).
+ */
+export function createProjectOps(runtime) {
+    const { projectRegistry } = runtime;
+    return [
+        // ─── Projects ───────────────────────────────────────────────────
+        {
+            name: 'project_get',
+            description: 'Get a registered project by ID.',
+            auth: 'read',
+            schema: z.object({
+                projectId: z.string().describe('Project ID to look up'),
+            }),
+            handler: async (params) => {
+                const project = projectRegistry.get(params.projectId);
+                if (!project) {
+                    return { found: false, project: null };
+                }
+                return { found: true, project };
+            },
+        },
+        {
+            name: 'project_list',
+            description: 'List all registered projects, ordered by last accessed time.',
+            auth: 'read',
+            handler: async () => {
+                const projects = projectRegistry.list();
+                return { count: projects.length, projects };
+            },
+        },
+        {
+            name: 'project_unregister',
+            description: 'Unregister a project — removes it and all associated rules and links.',
+            auth: 'write',
+            schema: z.object({
+                projectId: z.string().describe('Project ID to unregister'),
+            }),
+            handler: async (params) => {
+                const removed = projectRegistry.unregister(params.projectId);
+                return { removed, projectId: params.projectId };
+            },
+        },
+        // ─── Rules ──────────────────────────────────────────────────────
+        {
+            name: 'project_get_rules',
+            description: 'Get all rules for a specific project.',
+            auth: 'read',
+            schema: z.object({
+                projectId: z.string().describe('Project ID'),
+            }),
+            handler: async (params) => {
+                const rules = projectRegistry.getRules(params.projectId);
+                return { count: rules.length, rules };
+            },
+        },
+        {
+            name: 'project_list_rules',
+            description: 'List all projects with their associated rules.',
+            auth: 'read',
+            handler: async () => {
+                const result = projectRegistry.listRulesAll();
+                return {
+                    count: result.length,
+                    projects: result.map((r) => ({
+                        project: r.project,
+                        ruleCount: r.rules.length,
+                        rules: r.rules,
+                    })),
+                };
+            },
+        },
+        {
+            name: 'project_add_rule',
+            description: 'Add a rule to a project — behavior, preference, restriction, or convention.',
+            auth: 'write',
+            schema: z.object({
+                projectId: z.string().describe('Project ID to add the rule to'),
+                category: z.enum(['behavior', 'preference', 'restriction', 'convention']).describe('Rule category'),
+                text: z.string().describe('Rule text'),
+                priority: z.number().default(0).describe('Priority (higher = more important)'),
+            }),
+            handler: async (params) => {
+                const rule = projectRegistry.addRule(params.projectId, {
+                    category: params.category,
+                    text: params.text,
+                    priority: params.priority ?? 0,
+                });
+                return { added: true, rule };
+            },
+        },
+        {
+            name: 'project_remove_rule',
+            description: 'Remove a project rule by its ID.',
+            auth: 'write',
+            schema: z.object({
+                ruleId: z.string().describe('Rule ID to remove'),
+            }),
+            handler: async (params) => {
+                const removed = projectRegistry.removeRule(params.ruleId);
+                return { removed, ruleId: params.ruleId };
+            },
+        },
+        // ─── Links ──────────────────────────────────────────────────────
+        {
+            name: 'project_link',
+            description: 'Create a link between two projects (related, parent, child, fork).',
+            auth: 'write',
+            schema: z.object({
+                sourceId: z.string().describe('Source project ID'),
+                targetId: z.string().describe('Target project ID'),
+                linkType: z.enum(['related', 'parent', 'child', 'fork']).describe('Type of link'),
+            }),
+            handler: async (params) => {
+                const link = projectRegistry.link(params.sourceId, params.targetId, params.linkType);
+                return { linked: true, link };
+            },
+        },
+        {
+            name: 'project_unlink',
+            description: 'Remove links between two projects. Omit linkType to remove all link types.',
+            auth: 'write',
+            schema: z.object({
+                sourceId: z.string().describe('Source project ID'),
+                targetId: z.string().describe('Target project ID'),
+                linkType: z.enum(['related', 'parent', 'child', 'fork']).optional().describe('Specific link type to remove'),
+            }),
+            handler: async (params) => {
+                const count = projectRegistry.unlink(params.sourceId, params.targetId, params.linkType);
+                return { removed: count, sourceId: params.sourceId, targetId: params.targetId };
+            },
+        },
+        {
+            name: 'project_get_links',
+            description: 'Get all links for a project (both incoming and outgoing).',
+            auth: 'read',
+            schema: z.object({
+                projectId: z.string().describe('Project ID'),
+            }),
+            handler: async (params) => {
+                const links = projectRegistry.getLinks(params.projectId);
+                return { count: links.length, links };
+            },
+        },
+        {
+            name: 'project_linked_projects',
+            description: 'Get linked projects with full details — project info, link type, and direction.',
+            auth: 'read',
+            schema: z.object({
+                projectId: z.string().describe('Project ID'),
+            }),
+            handler: async (params) => {
+                const linked = projectRegistry.getLinkedProjects(params.projectId);
+                return { count: linked.length, linked };
+            },
+        },
+        // ─── Misc ───────────────────────────────────────────────────────
+        {
+            name: 'project_touch',
+            description: 'Update the last accessed timestamp for a project.',
+            auth: 'write',
+            schema: z.object({
+                projectId: z.string().describe('Project ID to touch'),
+            }),
+            handler: async (params) => {
+                projectRegistry.touch(params.projectId);
+                return { touched: true, projectId: params.projectId };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=project-ops.js.map

package/dist/runtime/project-ops.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA0C3E"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAsF3E"}

package/dist/runtime/runtime.js

@@ -10,11 +10,20 @@ import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { Vault } from '../vault/vault.js';
 import { Brain } from '../brain/brain.js';
+import { BrainIntelligence } from '../brain/intelligence.js';
 import { Planner } from '../planning/planner.js';
 import { Curator } from '../curator/curator.js';
+import { Governance } from '../governance/governance.js';
+import { CogneeClient } from '../cognee/client.js';
+import { LoopManager } from '../loop/loop-manager.js';
+import { IdentityManager } from '../control/identity-manager.js';
+import { IntentRouter } from '../control/intent-router.js';
 import { KeyPool, loadKeyPoolConfig } from '../llm/key-pool.js';
 import { loadIntelligenceData } from '../intelligence/loader.js';
 import { LLMClient } from '../llm/llm-client.js';
+import { Telemetry } from '../telemetry/telemetry.js';
+import { ProjectRegistry } from '../project/project-registry.js';
+import { createLogger } from '../logging/logger.js';
 /**
  * Create a fully initialized agent runtime.
  *
@@ -28,6 +37,8 @@ export function createAgentRuntime(config) {
     const agentHome = join(homedir(), `.${agentId}`);
     const vaultPath = config.vaultPath ?? join(agentHome, 'vault.db');
     const plansPath = config.plansPath ?? join(agentHome, 'plans.json');
+    // Logger — structured output to stderr
+    const logger = createLogger({ level: config.logLevel, prefix: `[${agentId}]` });
     // Vault — persistent SQLite knowledge store
     const vault = new Vault(vaultPath);
     // Seed intelligence data if dataDir provided
@@ -41,8 +52,31 @@ export function createAgentRuntime(config) {
     const planner = new Planner(plansPath);
     // Brain — intelligence layer (TF-IDF scoring, auto-tagging, dedup)
     const brain = new Brain(vault);
+    // Brain Intelligence — pattern strengths, session knowledge, intelligence pipeline
+    const brainIntelligence = new BrainIntelligence(vault, brain);
     // Curator — vault self-maintenance (dedup, contradictions, grooming, health)
     const curator = new Curator(vault);
+    // Governance — policy engine + proposal tracker for gated knowledge capture
+    const governance = new Governance(vault);
+    // Cognee — vector search client (graceful degradation if Cognee is down)
+    const cogneePartial = { dataset: agentId };
+    if (process.env.COGNEE_BASE_URL)
+        cogneePartial.baseUrl = process.env.COGNEE_BASE_URL;
+    if (process.env.COGNEE_API_TOKEN)
+        cogneePartial.apiToken = process.env.COGNEE_API_TOKEN;
+    if (process.env.COGNEE_DATASET)
+        cogneePartial.dataset = process.env.COGNEE_DATASET;
+    const cognee = new CogneeClient(cogneePartial);
+    // Loop Manager — iterative validation loop tracking (in-memory, session-scoped)
+    const loop = new LoopManager();
+    // Identity Manager — agent persona CRUD with versioning/rollback
+    const identityManager = new IdentityManager(vault);
+    // Intent Router — keyword-based intent classification and mode management
+    const intentRouter = new IntentRouter(vault);
+    // Telemetry — in-memory facade call tracking
+    const telemetry = new Telemetry();
+    // Project Registry — multi-project tracking with rules and links
+    const projectRegistry = new ProjectRegistry(vault.getDb());
     // LLM key pools and client
     const keyPoolFiles = loadKeyPoolConfig(agentId);
     const openaiKeyPool = new KeyPool(keyPoolFiles.openai);
@@ -50,13 +84,26 @@ export function createAgentRuntime(config) {
     const llmClient = new LLMClient(openaiKeyPool, anthropicKeyPool, agentId);
     return {
         config,
+        logger,
         vault,
         brain,
+        brainIntelligence,
         planner,
         curator,
+        governance,
+        cognee,
+        loop,
+        identityManager,
+        intentRouter,
         keyPool: { openai: openaiKeyPool, anthropic: anthropicKeyPool },
         llmClient,
-        close: () => vault.close(),
+        telemetry,
+        projectRegistry,
+        createdAt: Date.now(),
+        close: () => {
+            cognee.resetPendingCognify();
+            vault.close();
+        },
     };
 }
 //# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnC,6CAA6C;IAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,mEAAmE;IACnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,OAAO;QACP,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE;QAC/D,SAAS;QACT,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types.d.ts

@@ -1,9 +1,19 @@
 import type { Vault } from '../vault/vault.js';
 import type { Brain } from '../brain/brain.js';
+import type { BrainIntelligence } from '../brain/intelligence.js';
 import type { Planner } from '../planning/planner.js';
 import type { Curator } from '../curator/curator.js';
+import type { Governance } from '../governance/governance.js';
+import type { CogneeClient } from '../cognee/client.js';
 import type { KeyPool } from '../llm/key-pool.js';
 import type { LLMClient } from '../llm/llm-client.js';
+import type { IdentityManager } from '../control/identity-manager.js';
+import type { IntentRouter } from '../control/intent-router.js';
+import type { LoopManager } from '../loop/loop-manager.js';
+import type { Telemetry } from '../telemetry/telemetry.js';
+import type { ProjectRegistry } from '../project/project-registry.js';
+import type { Logger } from '../logging/logger.js';
+import type { LogLevel } from '../logging/types.js';
 /**
  * Configuration for creating an agent runtime.
  * Only `agentId` is required — everything else has sensible defaults.
@@ -17,6 +27,8 @@ export interface AgentRuntimeConfig {
     plansPath?: string;
     /** Intelligence data directory to seed vault from. Optional. */
     dataDir?: string;
+    /** Minimum log level. Default: 'info' (or SOLERI_LOG_LEVEL env var). */
+    logLevel?: LogLevel;
 }
 /**
  * Fully initialized agent runtime — all modules ready.
@@ -24,15 +36,26 @@ export interface AgentRuntimeConfig {
  */
 export interface AgentRuntime {
     config: AgentRuntimeConfig;
+    logger: Logger;
     vault: Vault;
     brain: Brain;
+    brainIntelligence: BrainIntelligence;
     planner: Planner;
     curator: Curator;
+    governance: Governance;
+    cognee: CogneeClient;
+    loop: LoopManager;
+    identityManager: IdentityManager;
+    intentRouter: IntentRouter;
     keyPool: {
         openai: KeyPool;
         anthropic: KeyPool;
     };
     llmClient: LLMClient;
+    telemetry: Telemetry;
+    projectRegistry: ProjectRegistry;
+    /** Timestamp (ms since epoch) when this runtime was created. */
+    createdAt: number;
     /** Close the vault database connection. Call on shutdown. */
     close(): void;
 }

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/runtime/vault-extra-ops.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extra vault operations — 12 ops that extend the 4 base vault ops in core-ops.ts.
+ *
+ * Groups: single-entry CRUD (3), bulk (2), discovery (3), import/export (3), analytics (1).
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from './types.js';
+export declare function createVaultExtraOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=vault-extra-ops.d.ts.map

package/dist/runtime/vault-extra-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/vault-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAsMzE"}

package/dist/runtime/vault-extra-ops.js

@@ -0,0 +1,195 @@
+/**
+ * Extra vault operations — 12 ops that extend the 4 base vault ops in core-ops.ts.
+ *
+ * Groups: single-entry CRUD (3), bulk (2), discovery (3), import/export (3), analytics (1).
+ */
+import { z } from 'zod';
+const entrySchema = z.object({
+    id: z.string(),
+    type: z.enum(['pattern', 'anti-pattern', 'rule']),
+    domain: z.string(),
+    title: z.string(),
+    severity: z.enum(['critical', 'warning', 'suggestion']),
+    description: z.string(),
+    context: z.string().optional(),
+    example: z.string().optional(),
+    counterExample: z.string().optional(),
+    why: z.string().optional(),
+    tags: z.array(z.string()),
+    appliesTo: z.array(z.string()).optional(),
+});
+export function createVaultExtraOps(runtime) {
+    const { vault } = runtime;
+    return [
+        // ─── Single-Entry CRUD ──────────────────────────────────────────
+        {
+            name: 'vault_get',
+            description: 'Get a single vault entry by ID.',
+            auth: 'read',
+            schema: z.object({ id: z.string() }),
+            handler: async (params) => {
+                const entry = vault.get(params.id);
+                if (!entry)
+                    return { error: 'Entry not found: ' + params.id };
+                return entry;
+            },
+        },
+        {
+            name: 'vault_update',
+            description: 'Update an existing vault entry. Only the fields provided are changed; the rest stay the same.',
+            auth: 'write',
+            schema: z.object({
+                id: z.string(),
+                title: z.string().optional(),
+                description: z.string().optional(),
+                context: z.string().optional(),
+                example: z.string().optional(),
+                counterExample: z.string().optional(),
+                why: z.string().optional(),
+                tags: z.array(z.string()).optional(),
+                appliesTo: z.array(z.string()).optional(),
+                severity: z.enum(['critical', 'warning', 'suggestion']).optional(),
+                type: z.enum(['pattern', 'anti-pattern', 'rule']).optional(),
+                domain: z.string().optional(),
+            }),
+            handler: async (params) => {
+                const id = params.id;
+                const { id: _id, ...fields } = params;
+                // Strip undefined values so we only pass what was actually provided
+                const cleaned = {};
+                for (const [k, v] of Object.entries(fields)) {
+                    if (v !== undefined)
+                        cleaned[k] = v;
+                }
+                if (Object.keys(cleaned).length === 0) {
+                    return { error: 'No fields to update' };
+                }
+                const updated = vault.update(id, cleaned);
+                if (!updated)
+                    return { error: 'Entry not found: ' + id };
+                return { updated: true, entry: updated };
+            },
+        },
+        {
+            name: 'vault_remove',
+            description: 'Remove a single vault entry by ID.',
+            auth: 'admin',
+            schema: z.object({ id: z.string() }),
+            handler: async (params) => {
+                const removed = vault.remove(params.id);
+                return { removed, id: params.id };
+            },
+        },
+        // ─── Bulk Operations ────────────────────────────────────────────
+        {
+            name: 'vault_bulk_add',
+            description: 'Add multiple vault entries at once. Uses upsert — existing IDs are updated.',
+            auth: 'write',
+            schema: z.object({
+                entries: z.array(entrySchema),
+            }),
+            handler: async (params) => {
+                const entries = params.entries;
+                const count = vault.seed(entries);
+                return { added: count, total: vault.stats().totalEntries };
+            },
+        },
+        {
+            name: 'vault_bulk_remove',
+            description: 'Remove multiple vault entries by IDs in a single transaction.',
+            auth: 'admin',
+            schema: z.object({
+                ids: z.array(z.string()),
+            }),
+            handler: async (params) => {
+                const ids = params.ids;
+                const removed = vault.bulkRemove(ids);
+                return { removed, requested: ids.length, total: vault.stats().totalEntries };
+            },
+        },
+        // ─── Discovery ──────────────────────────────────────────────────
+        {
+            name: 'vault_tags',
+            description: 'List all unique tags used across vault entries with their occurrence counts.',
+            auth: 'read',
+            handler: async () => {
+                const tags = vault.getTags();
+                return { tags, count: tags.length };
+            },
+        },
+        {
+            name: 'vault_domains',
+            description: 'List all domains in the vault with their entry counts.',
+            auth: 'read',
+            handler: async () => {
+                const domains = vault.getDomains();
+                return { domains, count: domains.length };
+            },
+        },
+        {
+            name: 'vault_recent',
+            description: 'Get recently added or updated vault entries, ordered by most recent first.',
+            auth: 'read',
+            schema: z.object({
+                limit: z.number().optional().describe('Max entries to return (default 20)'),
+            }),
+            handler: async (params) => {
+                const limit = params.limit ?? 20;
+                const entries = vault.getRecent(limit);
+                return { entries, count: entries.length };
+            },
+        },
+        // ─── Import / Export / Seed ──────────────────────────────────────
+        {
+            name: 'vault_import',
+            description: 'Import vault entries from a JSON bundle. Uses upsert — existing IDs are updated, new IDs are inserted.',
+            auth: 'write',
+            schema: z.object({
+                entries: z.array(entrySchema),
+            }),
+            handler: async (params) => {
+                const entries = params.entries;
+                const before = vault.stats().totalEntries;
+                const count = vault.seed(entries);
+                const after = vault.stats().totalEntries;
+                return {
+                    imported: count,
+                    newEntries: after - before,
+                    updatedEntries: count - (after - before),
+                    total: after,
+                };
+            },
+        },
+        {
+            name: 'vault_seed',
+            description: 'Seed the vault from intelligence data. Idempotent — safe to call multiple times. Uses upsert.',
+            auth: 'write',
+            schema: z.object({
+                entries: z.array(entrySchema),
+            }),
+            handler: async (params) => {
+                const entries = params.entries;
+                const count = vault.seed(entries);
+                return { seeded: count, total: vault.stats().totalEntries };
+            },
+        },
+        {
+            name: 'vault_backup',
+            description: 'Export the full vault as a JSON bundle suitable for backup or transfer to another agent.',
+            auth: 'read',
+            handler: async () => {
+                return vault.exportAll();
+            },
+        },
+        // ─── Analytics ──────────────────────────────────────────────────
+        {
+            name: 'vault_age_report',
+            description: 'Show vault entry age distribution — how many entries are from today, this week, this month, this quarter, or older.',
+            auth: 'read',
+            handler: async () => {
+                return vault.getAgeReport();
+            },
+        },
+    ];
+}
+//# sourceMappingURL=vault-extra-ops.js.map

package/dist/runtime/vault-extra-ops.js.map

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

package/dist/telemetry/telemetry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * In-memory telemetry tracker for facade calls.
+ *
+ * No external deps — records calls, computes stats, bounds memory usage.
+ * Max 10 000 entries; auto-trims to 5 000 when limit is hit.
+ */
+export interface FacadeCall {
+    facade: string;
+    op: string;
+    timestamp: number;
+    durationMs: number;
+    success: boolean;
+    error?: string;
+}
+export interface TelemetryStats {
+    totalCalls: number;
+    successRate: number;
+    avgDurationMs: number;
+    callsByFacade: Record<string, number>;
+    callsByOp: Record<string, number>;
+    errorsByOp: Record<string, number>;
+    slowestOps: Array<{
+        op: string;
+        avgMs: number;
+    }>;
+    since: number;
+}
+export declare class Telemetry {
+    private calls;
+    private startedAt;
+    /**
+     * Record a facade call. Timestamp is auto-set to Date.now().
+     */
+    record(call: Omit<FacadeCall, 'timestamp'>): void;
+    /**
+     * Compute aggregate stats from all recorded calls.
+     */
+    getStats(): TelemetryStats;
+    /**
+     * Get the N most recent calls, newest first.
+     */
+    getRecent(limit?: number): FacadeCall[];
+    /**
+     * Clear all recorded data and reset the start timestamp.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAc;IAE/B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;IAOjD;;OAEG;IACH,QAAQ,IAAI,cAAc;IAwD1B;;OAEG;IACH,SAAS,CAAC,KAAK,SAAK,GAAG,UAAU,EAAE;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}