@soleri/core 2.8.0 → 2.9.0

package/dist/runtime/facades/control-facade.js

@@ -0,0 +1,244 @@
+/**
+ * Control facade — agent behavior ops.
+ * identity, intent routing, morphing, guidelines, governance.
+ */
+import { z } from 'zod';
+export function createControlFacadeOps(runtime) {
+    const { identityManager, intentRouter, governance } = runtime;
+    return [
+        // ─── Control (inline from core-ops.ts) ──────────────────────
+        {
+            name: 'get_identity',
+            description: 'Get current agent identity with guidelines.',
+            auth: 'read',
+            schema: z.object({
+                agentId: z.string().describe('Agent identifier.'),
+            }),
+            handler: async (params) => {
+                const identity = identityManager.getIdentity(params.agentId);
+                if (!identity)
+                    return { found: false, agentId: params.agentId };
+                return identity;
+            },
+        },
+        {
+            name: 'update_identity',
+            description: 'Update identity fields. Auto-versions and snapshots previous state.',
+            auth: 'write',
+            schema: z.object({
+                agentId: z.string(),
+                name: z.string().optional(),
+                role: z.string().optional(),
+                description: z.string().optional(),
+                personality: z.array(z.string()).optional(),
+                changedBy: z.string().optional(),
+                changeReason: z.string().optional(),
+            }),
+            handler: async (params) => {
+                const identity = identityManager.setIdentity(params.agentId, {
+                    name: params.name,
+                    role: params.role,
+                    description: params.description,
+                    personality: params.personality,
+                    changedBy: params.changedBy,
+                    changeReason: params.changeReason,
+                });
+                return { updated: true, identity };
+            },
+        },
+        {
+            name: 'add_guideline',
+            description: 'Add a behavioral guideline (behavior/preference/restriction/style).',
+            auth: 'write',
+            schema: z.object({
+                agentId: z.string(),
+                category: z.enum(['behavior', 'preference', 'restriction', 'style']),
+                text: z.string(),
+                priority: z.number().optional(),
+            }),
+            handler: async (params) => {
+                const guideline = identityManager.addGuideline(params.agentId, {
+                    category: params.category,
+                    text: params.text,
+                    priority: params.priority,
+                });
+                return { added: true, guideline };
+            },
+        },
+        {
+            name: 'remove_guideline',
+            description: 'Remove a guideline by ID.',
+            auth: 'write',
+            schema: z.object({
+                guidelineId: z.string(),
+            }),
+            handler: async (params) => {
+                const removed = identityManager.removeGuideline(params.guidelineId);
+                return { removed };
+            },
+        },
+        {
+            name: 'rollback_identity',
+            description: 'Restore a previous identity version. Creates a new version with the old data.',
+            auth: 'write',
+            schema: z.object({
+                agentId: z.string(),
+                version: z.number().describe('Version number to roll back to.'),
+            }),
+            handler: async (params) => {
+                const identity = identityManager.rollback(params.agentId, params.version);
+                return { rolledBack: true, identity };
+            },
+        },
+        {
+            name: 'route_intent',
+            description: 'Classify a prompt into intent + operational mode via keyword matching.',
+            auth: 'read',
+            schema: z.object({
+                prompt: z.string().describe('The user prompt to classify.'),
+            }),
+            handler: async (params) => {
+                return intentRouter.routeIntent(params.prompt);
+            },
+        },
+        {
+            name: 'morph',
+            description: 'Switch operational mode manually.',
+            auth: 'write',
+            schema: z.object({
+                mode: z
+                    .string()
+                    .describe('The operational mode to switch to (e.g., BUILD-MODE, FIX-MODE).'),
+            }),
+            handler: async (params) => {
+                return intentRouter.morph(params.mode);
+            },
+        },
+        {
+            name: 'get_behavior_rules',
+            description: 'Get behavior rules for current or specified mode.',
+            auth: 'read',
+            schema: z.object({
+                mode: z.string().optional().describe('Mode to get rules for. Defaults to current mode.'),
+            }),
+            handler: async (params) => {
+                const mode = params.mode;
+                const rules = intentRouter.getBehaviorRules(mode);
+                const currentMode = intentRouter.getCurrentMode();
+                return { mode: mode ?? currentMode, rules };
+            },
+        },
+        // ─── Governance (inline from core-ops.ts) ───────────────────
+        {
+            name: 'governance_policy',
+            description: 'Get, set, or apply a preset to vault governance policies (quota, retention, auto-capture).',
+            auth: 'write',
+            schema: z.object({
+                action: z.enum(['get', 'set', 'applyPreset']),
+                projectPath: z.string(),
+                policyType: z.enum(['quota', 'retention', 'auto-capture']).optional(),
+                config: z.record(z.unknown()).optional(),
+                preset: z.enum(['strict', 'moderate', 'permissive']).optional(),
+                changedBy: z.string().optional(),
+            }),
+            handler: async (params) => {
+                const action = params.action;
+                const projectPath = params.projectPath;
+                if (action === 'get') {
+                    return governance.getPolicy(projectPath);
+                }
+                if (action === 'set') {
+                    governance.setPolicy(projectPath, params.policyType, params.config, params.changedBy);
+                    return { updated: true, policy: governance.getPolicy(projectPath) };
+                }
+                if (action === 'applyPreset') {
+                    governance.applyPreset(projectPath, params.preset, params.changedBy);
+                    return {
+                        applied: true,
+                        preset: params.preset,
+                        policy: governance.getPolicy(projectPath),
+                    };
+                }
+                return { error: 'Unknown action: ' + action };
+            },
+        },
+        {
+            name: 'governance_proposals',
+            description: 'Manage knowledge capture proposals — list, approve, reject, modify, get stats, or expire stale.',
+            auth: 'write',
+            schema: z.object({
+                action: z.enum(['list', 'approve', 'reject', 'modify', 'stats', 'expire']),
+                projectPath: z.string().optional(),
+                proposalId: z.number().optional(),
+                decidedBy: z.string().optional(),
+                note: z.string().optional(),
+                modifications: z.record(z.unknown()).optional(),
+                maxAgeDays: z.number().optional(),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                const action = params.action;
+                if (action === 'list') {
+                    return governance.listPendingProposals(params.projectPath, params.limit);
+                }
+                if (action === 'approve') {
+                    return governance.approveProposal(params.proposalId, params.decidedBy);
+                }
+                if (action === 'reject') {
+                    return governance.rejectProposal(params.proposalId, params.decidedBy, params.note);
+                }
+                if (action === 'modify') {
+                    return governance.modifyProposal(params.proposalId, params.modifications, params.decidedBy);
+                }
+                if (action === 'stats') {
+                    return governance.getProposalStats(params.projectPath);
+                }
+                if (action === 'expire') {
+                    const expired = governance.expireStaleProposals(params.maxAgeDays);
+                    return { expired };
+                }
+                return { error: 'Unknown action: ' + action };
+            },
+        },
+        {
+            name: 'governance_stats',
+            description: 'Get governance statistics — quota status and proposal stats for a project.',
+            auth: 'read',
+            schema: z.object({
+                projectPath: z.string(),
+            }),
+            handler: async (params) => {
+                const projectPath = params.projectPath;
+                return {
+                    quotaStatus: governance.getQuotaStatus(projectPath),
+                    proposalStats: governance.getProposalStats(projectPath),
+                };
+            },
+        },
+        {
+            name: 'governance_expire',
+            description: 'Expire stale pending proposals older than a threshold.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().optional(),
+                maxAgeDays: z.number().optional().describe('Days threshold. Default 14.'),
+            }),
+            handler: async (params) => {
+                const expired = governance.expireStaleProposals(params.maxAgeDays);
+                return { expired };
+            },
+        },
+        {
+            name: 'governance_dashboard',
+            description: 'Get governance dashboard — vault size, quota usage, pending proposals, acceptance rate, evaluation trend.',
+            auth: 'read',
+            schema: z.object({
+                projectPath: z.string(),
+            }),
+            handler: async (params) => {
+                return governance.getDashboard(params.projectPath);
+            },
+        },
+    ];
+}
+//# sourceMappingURL=control-facade.js.map

package/dist/runtime/facades/control-facade.js.map

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

package/dist/runtime/facades/curator-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Curator facade — quality ops.
+ * duplicate detection, contradictions, grooming, health audit.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createCuratorFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=curator-facade.d.ts.map

package/dist/runtime/facades/curator-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curator-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/curator-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAyH5E"}

package/dist/runtime/facades/curator-facade.js

@@ -0,0 +1,117 @@
+/**
+ * Curator facade — quality ops.
+ * duplicate detection, contradictions, grooming, health audit.
+ */
+import { z } from 'zod';
+import { createCuratorExtraOps } from '../curator-extra-ops.js';
+export function createCuratorFacadeOps(runtime) {
+    const { curator } = runtime;
+    return [
+        // ─── Curator (inline from core-ops.ts) ──────────────────────
+        {
+            name: 'curator_status',
+            description: 'Curator status — table row counts, last groomed timestamp.',
+            auth: 'read',
+            handler: async () => {
+                return curator.getStatus();
+            },
+        },
+        {
+            name: 'curator_detect_duplicates',
+            description: 'Detect duplicate entries using TF-IDF cosine similarity.',
+            auth: 'read',
+            schema: z.object({
+                entryId: z.string().optional().describe('Check a specific entry. Omit to scan all.'),
+                threshold: z.number().optional().describe('Similarity threshold (0-1). Default 0.45.'),
+            }),
+            handler: async (params) => {
+                return curator.detectDuplicates(params.entryId, params.threshold);
+            },
+        },
+        {
+            name: 'curator_contradictions',
+            description: 'List or detect contradictions between patterns and anti-patterns.',
+            auth: 'read',
+            schema: z.object({
+                status: z.enum(['open', 'resolved', 'dismissed']).optional().describe('Filter by status.'),
+                detect: z.boolean().optional().describe('If true, run detection before listing.'),
+            }),
+            handler: async (params) => {
+                if (params.detect) {
+                    curator.detectContradictions();
+                }
+                return curator.getContradictions(params.status);
+            },
+        },
+        {
+            name: 'curator_resolve_contradiction',
+            description: 'Resolve or dismiss a contradiction.',
+            auth: 'write',
+            schema: z.object({
+                id: z.number().describe('Contradiction ID.'),
+                resolution: z.enum(['resolved', 'dismissed']),
+            }),
+            handler: async (params) => {
+                return curator.resolveContradiction(params.id, params.resolution);
+            },
+        },
+        {
+            name: 'curator_groom',
+            description: 'Groom a single entry — normalize tags, check staleness.',
+            auth: 'write',
+            schema: z.object({
+                entryId: z.string().describe('Entry ID to groom.'),
+            }),
+            handler: async (params) => {
+                return curator.groomEntry(params.entryId);
+            },
+        },
+        {
+            name: 'curator_groom_all',
+            description: 'Groom all vault entries — normalize tags, detect staleness.',
+            auth: 'write',
+            handler: async () => {
+                return curator.groomAll();
+            },
+        },
+        {
+            name: 'curator_consolidate',
+            description: 'Consolidate vault — find duplicates, stale entries, contradictions. Dry-run by default.',
+            auth: 'write',
+            schema: z.object({
+                dryRun: z.boolean().optional().describe('Default true. Set false to apply mutations.'),
+                staleDaysThreshold: z
+                    .number()
+                    .optional()
+                    .describe('Days before entry is stale. Default 90.'),
+                duplicateThreshold: z
+                    .number()
+                    .optional()
+                    .describe('Cosine similarity threshold. Default 0.45.'),
+                contradictionThreshold: z
+                    .number()
+                    .optional()
+                    .describe('Contradiction threshold. Default 0.4.'),
+            }),
+            handler: async (params) => {
+                return curator.consolidate({
+                    dryRun: params.dryRun,
+                    staleDaysThreshold: params.staleDaysThreshold,
+                    duplicateThreshold: params.duplicateThreshold,
+                    contradictionThreshold: params.contradictionThreshold,
+                });
+            },
+        },
+        {
+            name: 'curator_health_audit',
+            description: 'Audit vault health — score (0-100), coverage, freshness, quality, tag health, recommendations.',
+            auth: 'read',
+            handler: async () => {
+                return curator.healthAudit();
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createCuratorExtraOps(runtime),
+    ];
+}
+//# sourceMappingURL=curator-facade.js.map

package/dist/runtime/facades/curator-facade.js.map

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

package/dist/runtime/facades/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Semantic facade assembler — creates 10 domain-specific facades
+ * matching Salvador's engine-level architecture.
+ *
+ * Each facade becomes its own MCP tool with op dispatch.
+ */
+import type { FacadeConfig } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createSemanticFacades(runtime: AgentRuntime, agentId: string): FacadeConfig[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAqD5F"}

package/dist/runtime/facades/index.js

@@ -0,0 +1,71 @@
+/**
+ * Semantic facade assembler — creates 10 domain-specific facades
+ * matching Salvador's engine-level architecture.
+ *
+ * Each facade becomes its own MCP tool with op dispatch.
+ */
+import { createVaultFacadeOps } from './vault-facade.js';
+import { createPlanFacadeOps } from './plan-facade.js';
+import { createBrainFacadeOps } from './brain-facade.js';
+import { createMemoryFacadeOps } from './memory-facade.js';
+import { createAdminFacadeOps } from './admin-facade.js';
+import { createCuratorFacadeOps } from './curator-facade.js';
+import { createLoopFacadeOps } from './loop-facade.js';
+import { createOrchestrateFacadeOps } from './orchestrate-facade.js';
+import { createControlFacadeOps } from './control-facade.js';
+import { createCogneeFacadeOps } from './cognee-facade.js';
+export function createSemanticFacades(runtime, agentId) {
+    return [
+        {
+            name: `${agentId}_vault`,
+            description: 'Knowledge management — search, CRUD, import/export, intake, archival.',
+            ops: createVaultFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_plan`,
+            description: 'Plan lifecycle — create, approve, execute, reconcile, complete, grading.',
+            ops: createPlanFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_brain`,
+            description: 'Learning system — intelligence pipeline, strengths, feedback, sessions.',
+            ops: createBrainFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_memory`,
+            description: 'Session & cross-project memory — capture, search, dedup, promote.',
+            ops: createMemoryFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_admin`,
+            description: 'Infrastructure — health, config, telemetry, tokens, LLM, prompts.',
+            ops: createAdminFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_curator`,
+            description: 'Quality — duplicate detection, contradictions, grooming, health audit.',
+            ops: createCuratorFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_loop`,
+            description: 'Iterative validation loops — start, iterate, cancel, complete, history.',
+            ops: createLoopFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_orchestrate`,
+            description: 'Execution orchestration — project registration, playbooks, plan/execute/complete.',
+            ops: createOrchestrateFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_control`,
+            description: 'Agent behavior — identity, intent routing, morphing, guidelines, governance.',
+            ops: createControlFacadeOps(runtime),
+        },
+        {
+            name: `${agentId}_cognee`,
+            description: 'Knowledge graph — Cognee search, sync, export, graph stats.',
+            ops: createCogneeFacadeOps(runtime),
+        },
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/facades/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/facades/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,UAAU,qBAAqB,CAAC,OAAqB,EAAE,OAAe;IAC1E,OAAO;QACL;YACE,IAAI,EAAE,GAAG,OAAO,QAAQ;YACxB,WAAW,EAAE,uEAAuE;YACpF,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC;SACnC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,OAAO;YACvB,WAAW,EAAE,0EAA0E;YACvF,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC;SAClC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,QAAQ;YACxB,WAAW,EAAE,yEAAyE;YACtF,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC;SACnC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,SAAS;YACzB,WAAW,EAAE,mEAAmE;YAChF,GAAG,EAAE,qBAAqB,CAAC,OAAO,CAAC;SACpC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,QAAQ;YACxB,WAAW,EAAE,mEAAmE;YAChF,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC;SACnC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,UAAU;YAC1B,WAAW,EAAE,wEAAwE;YACrF,GAAG,EAAE,sBAAsB,CAAC,OAAO,CAAC;SACrC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,OAAO;YACvB,WAAW,EAAE,yEAAyE;YACtF,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC;SAClC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,cAAc;YAC9B,WAAW,EAAE,mFAAmF;YAChG,GAAG,EAAE,0BAA0B,CAAC,OAAO,CAAC;SACzC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,UAAU;YAC1B,WAAW,EAAE,8EAA8E;YAC3F,GAAG,EAAE,sBAAsB,CAAC,OAAO,CAAC;SACrC;QACD;YACE,IAAI,EAAE,GAAG,OAAO,SAAS;YACzB,WAAW,EAAE,6DAA6D;YAC1E,GAAG,EAAE,qBAAqB,CAAC,OAAO,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/facades/loop-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Loop facade — iterative validation loops.
+ * start, iterate, cancel, complete, history.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createLoopFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=loop-facade.d.ts.map

package/dist/runtime/facades/loop-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/loop-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAEzE"}

package/dist/runtime/facades/loop-facade.js

@@ -0,0 +1,9 @@
+/**
+ * Loop facade — iterative validation loops.
+ * start, iterate, cancel, complete, history.
+ */
+import { createLoopOps } from '../loop-ops.js';
+export function createLoopFacadeOps(runtime) {
+    return createLoopOps(runtime);
+}
+//# sourceMappingURL=loop-facade.js.map

package/dist/runtime/facades/loop-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-facade.js","sourceRoot":"","sources":["../../../src/runtime/facades/loop-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/runtime/facades/memory-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Memory facade — session & cross-project memory ops.
+ * capture, search, dedup, promote.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createMemoryFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=memory-facade.d.ts.map

package/dist/runtime/facades/memory-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/memory-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAsG3E"}

package/dist/runtime/facades/memory-facade.js

@@ -0,0 +1,108 @@
+/**
+ * Memory facade — session & cross-project memory ops.
+ * capture, search, dedup, promote.
+ */
+import { z } from 'zod';
+import { createMemoryExtraOps } from '../memory-extra-ops.js';
+import { createMemoryCrossProjectOps } from '../memory-cross-project-ops.js';
+export function createMemoryFacadeOps(runtime) {
+    const { vault } = runtime;
+    return [
+        // ─── Memory (inline from core-ops.ts) ───────────────────────
+        {
+            name: 'memory_search',
+            description: 'Search memories using full-text search.',
+            auth: 'read',
+            schema: z.object({
+                query: z.string(),
+                type: z.enum(['session', 'lesson', 'preference']).optional(),
+                projectPath: z.string().optional(),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return vault.searchMemories(params.query, {
+                    type: params.type,
+                    projectPath: params.projectPath,
+                    limit: params.limit ?? 10,
+                });
+            },
+        },
+        {
+            name: 'memory_capture',
+            description: 'Capture a memory — session summary, lesson learned, or preference.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string(),
+                type: z.enum(['session', 'lesson', 'preference']),
+                context: z.string(),
+                summary: z.string(),
+                topics: z.array(z.string()).optional().default([]),
+                filesModified: z.array(z.string()).optional().default([]),
+                toolsUsed: z.array(z.string()).optional().default([]),
+            }),
+            handler: async (params) => {
+                const memory = vault.captureMemory({
+                    projectPath: params.projectPath,
+                    type: params.type,
+                    context: params.context,
+                    summary: params.summary,
+                    topics: params.topics ?? [],
+                    filesModified: params.filesModified ?? [],
+                    toolsUsed: params.toolsUsed ?? [],
+                });
+                return { captured: true, memory };
+            },
+        },
+        {
+            name: 'memory_list',
+            description: 'List memories with optional filters.',
+            auth: 'read',
+            schema: z.object({
+                type: z.enum(['session', 'lesson', 'preference']).optional(),
+                projectPath: z.string().optional(),
+                limit: z.number().optional(),
+                offset: z.number().optional(),
+            }),
+            handler: async (params) => {
+                const memories = vault.listMemories({
+                    type: params.type,
+                    projectPath: params.projectPath,
+                    limit: params.limit ?? 50,
+                    offset: params.offset ?? 0,
+                });
+                const stats = vault.memoryStats();
+                return { memories, stats };
+            },
+        },
+        {
+            name: 'session_capture',
+            description: 'Capture a session summary before context compaction. Called automatically by PreCompact hook.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().optional().default('.'),
+                summary: z.string().describe('Brief summary of what was accomplished in this session'),
+                topics: z.array(z.string()).optional().default([]),
+                filesModified: z.array(z.string()).optional().default([]),
+                toolsUsed: z.array(z.string()).optional().default([]),
+            }),
+            handler: async (params) => {
+                const { resolve } = await import('node:path');
+                const projectPath = resolve(params.projectPath ?? '.');
+                const memory = vault.captureMemory({
+                    projectPath,
+                    type: 'session',
+                    context: 'Auto-captured before context compaction',
+                    summary: params.summary,
+                    topics: params.topics ?? [],
+                    filesModified: params.filesModified ?? [],
+                    toolsUsed: params.toolsUsed ?? [],
+                });
+                return { captured: true, memory, message: 'Session summary saved to memory.' };
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createMemoryExtraOps(runtime),
+        ...createMemoryCrossProjectOps(runtime),
+    ];
+}
+//# sourceMappingURL=memory-facade.js.map

package/dist/runtime/facades/memory-facade.js.map

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