@soleri/core 2.7.0 → 2.9.0

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

@@ -0,0 +1,294 @@
+/**
+ * Brain facade — learning system ops.
+ * intelligence pipeline, strengths, feedback, sessions.
+ */
+import { z } from 'zod';
+export function createBrainFacadeOps(runtime) {
+    const { brain, brainIntelligence, llmClient, keyPool, governance } = runtime;
+    return [
+        // ─── Brain (inline from core-ops.ts) ────────────────────────
+        {
+            name: 'record_feedback',
+            description: 'Record feedback on a search result — accepted or dismissed. Used for adaptive weight tuning.',
+            auth: 'write',
+            schema: z.object({
+                query: z.string().describe('The original search query'),
+                entryId: z.string().describe('The entry ID that was accepted or dismissed'),
+                action: z.enum(['accepted', 'dismissed']),
+            }),
+            handler: async (params) => {
+                brain.recordFeedback(params.query, params.entryId, params.action);
+                return {
+                    recorded: true,
+                    query: params.query,
+                    entryId: params.entryId,
+                    action: params.action,
+                };
+            },
+        },
+        {
+            name: 'brain_feedback',
+            description: 'Enhanced feedback with typed actions (accepted/dismissed/modified/failed), source tracking, confidence, duration, and reason.',
+            auth: 'write',
+            schema: z.object({
+                query: z.string().describe('The original search query'),
+                entryId: z.string().describe('The entry ID'),
+                action: z.enum(['accepted', 'dismissed', 'modified', 'failed']),
+                source: z
+                    .enum(['search', 'recommendation', 'tool-execution', 'explicit'])
+                    .optional()
+                    .describe("Feedback source. Default 'search'."),
+                confidence: z.number().optional().describe('Confidence 0-1. Default 0.6.'),
+                duration: z.number().optional().describe('Duration in ms.'),
+                context: z.string().optional().describe("JSON context string. Default '{}'."),
+                reason: z.string().optional().describe('Human-readable reason.'),
+            }),
+            handler: async (params) => {
+                const entry = brain.recordFeedback({
+                    query: params.query,
+                    entryId: params.entryId,
+                    action: params.action,
+                    source: params.source,
+                    confidence: params.confidence,
+                    duration: params.duration,
+                    context: params.context,
+                    reason: params.reason,
+                });
+                return entry;
+            },
+        },
+        {
+            name: 'brain_feedback_stats',
+            description: 'Feedback statistics — counts by action and source, acceptance rate, average confidence.',
+            auth: 'read',
+            handler: async () => {
+                return brain.getFeedbackStats();
+            },
+        },
+        {
+            name: 'rebuild_vocabulary',
+            description: 'Force rebuild the TF-IDF vocabulary from all vault entries.',
+            auth: 'write',
+            handler: async () => {
+                brain.rebuildVocabulary();
+                return { rebuilt: true, vocabularySize: brain.getVocabularySize() };
+            },
+        },
+        {
+            name: 'brain_stats',
+            description: 'Get brain intelligence stats — vocabulary size, feedback count, current scoring weights, intelligence pipeline stats.',
+            auth: 'read',
+            handler: async () => {
+                const base = brain.getStats();
+                const intelligence = brainIntelligence.getStats();
+                return { ...base, intelligence };
+            },
+        },
+        {
+            name: 'brain_decay_report',
+            description: 'Show temporal decay scores for entries matching a query — reveals which entries are expiring, active, or expired.',
+            auth: 'read',
+            schema: z.object({
+                query: z.string().describe('Search query to find entries'),
+                limit: z.number().optional().describe('Max results (default 10)'),
+            }),
+            handler: async (params) => {
+                const results = await brain.getDecayReport(params.query, params.limit ?? 10);
+                return { results, count: results.length };
+            },
+        },
+        {
+            name: 'llm_status',
+            description: 'LLM client status — provider availability, key pool status, model routing config.',
+            auth: 'read',
+            handler: async () => {
+                const available = llmClient.isAvailable();
+                return {
+                    providers: {
+                        openai: {
+                            available: available.openai,
+                            keyPool: keyPool.openai.hasKeys ? keyPool.openai.getStatus() : null,
+                        },
+                        anthropic: {
+                            available: available.anthropic,
+                            keyPool: keyPool.anthropic.hasKeys ? keyPool.anthropic.getStatus() : null,
+                        },
+                    },
+                    routes: llmClient.getRoutes(),
+                };
+            },
+        },
+        // ─── Brain Intelligence ──────────────────────────────────────
+        {
+            name: 'brain_session_context',
+            description: 'Get recent session context — sessions, tool usage frequency, file change frequency.',
+            auth: 'read',
+            schema: z.object({
+                limit: z.number().optional().describe('Number of recent sessions. Default 10.'),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.getSessionContext(params.limit ?? 10);
+            },
+        },
+        {
+            name: 'brain_strengths',
+            description: 'Get pattern strength scores. 4-signal scoring: usage (0-25) + spread (0-25) + success (0-25) + recency (0-25).',
+            auth: 'read',
+            schema: z.object({
+                domain: z.string().optional(),
+                minStrength: z.number().optional().describe('Minimum strength score (0-100).'),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.getStrengths({
+                    domain: params.domain,
+                    minStrength: params.minStrength,
+                    limit: params.limit ?? 50,
+                });
+            },
+        },
+        {
+            name: 'brain_global_patterns',
+            description: 'Get cross-domain pattern registry — patterns that appear across multiple domains.',
+            auth: 'read',
+            schema: z.object({
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.getGlobalPatterns(params.limit ?? 20);
+            },
+        },
+        {
+            name: 'brain_recommend',
+            description: 'Get pattern recommendations for a task context. Matches domain, task terms, and source-specific acceptance rates against known strengths.',
+            auth: 'read',
+            schema: z.object({
+                domain: z.string().optional(),
+                task: z.string().optional().describe('Task description for contextual matching.'),
+                source: z
+                    .string()
+                    .optional()
+                    .describe('Feedback source to boost by (search, recommendation, tool-execution, explicit).'),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.recommend({
+                    domain: params.domain,
+                    task: params.task,
+                    source: params.source,
+                    limit: params.limit ?? 5,
+                });
+            },
+        },
+        {
+            name: 'brain_build_intelligence',
+            description: 'Run the full intelligence pipeline: compute strengths → build global registry → build domain profiles.',
+            auth: 'write',
+            handler: async () => {
+                return brainIntelligence.buildIntelligence();
+            },
+        },
+        {
+            name: 'brain_export',
+            description: 'Export all brain intelligence data — strengths, sessions, proposals, global patterns, domain profiles.',
+            auth: 'read',
+            handler: async () => {
+                return brainIntelligence.exportData();
+            },
+        },
+        {
+            name: 'brain_import',
+            description: 'Import brain intelligence data from a previous export.',
+            auth: 'write',
+            schema: z.object({
+                data: z.any().describe('BrainExportData object from brain_export.'),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.importData(params.data);
+            },
+        },
+        {
+            name: 'brain_extract_knowledge',
+            description: 'Extract knowledge proposals from a session using 6 heuristic rules (repeated tools, multi-file edits, long sessions, plan outcomes, feedback ratios).',
+            auth: 'write',
+            schema: z.object({
+                sessionId: z.string().describe('Session ID to extract knowledge from.'),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.extractKnowledge(params.sessionId);
+            },
+        },
+        {
+            name: 'brain_archive_sessions',
+            description: 'Archive (delete) completed sessions older than N days.',
+            auth: 'write',
+            schema: z.object({
+                olderThanDays: z.number().optional().describe('Days threshold. Default 30.'),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.archiveSessions(params.olderThanDays ?? 30);
+            },
+        },
+        {
+            name: 'brain_promote_proposals',
+            description: 'Promote knowledge proposals to vault entries. Creates intelligence entries from auto-extracted patterns. Gated by governance policies.',
+            auth: 'write',
+            schema: z.object({
+                proposalIds: z.array(z.string()).describe('IDs of proposals to promote.'),
+                projectPath: z.string().optional().default('.'),
+            }),
+            handler: async (params) => {
+                const pp = params.projectPath ?? '.';
+                return brainIntelligence.promoteProposals(params.proposalIds, governance, pp);
+            },
+        },
+        {
+            name: 'brain_lifecycle',
+            description: 'Start or end a brain session. Sessions track tool usage, file changes, and plan context.',
+            auth: 'write',
+            schema: z.object({
+                action: z.enum(['start', 'end']),
+                sessionId: z
+                    .string()
+                    .optional()
+                    .describe('Required for end. Auto-generated for start if omitted.'),
+                domain: z.string().optional(),
+                context: z.string().optional(),
+                toolsUsed: z.array(z.string()).optional(),
+                filesModified: z.array(z.string()).optional(),
+                planId: z.string().optional(),
+                planOutcome: z.string().optional(),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.lifecycle({
+                    action: params.action,
+                    sessionId: params.sessionId,
+                    domain: params.domain,
+                    context: params.context,
+                    toolsUsed: params.toolsUsed,
+                    filesModified: params.filesModified,
+                    planId: params.planId,
+                    planOutcome: params.planOutcome,
+                });
+            },
+        },
+        {
+            name: 'brain_reset_extracted',
+            description: 'Reset extraction status on brain sessions, allowing re-extraction. Filter by sessionId, since date, or all.',
+            auth: 'write',
+            schema: z.object({
+                sessionId: z.string().optional().describe('Reset a specific session.'),
+                since: z.string().optional().describe('Reset sessions extracted since this ISO date.'),
+                all: z.boolean().optional().describe('Reset all extracted sessions.'),
+            }),
+            handler: async (params) => {
+                return brainIntelligence.resetExtracted({
+                    sessionId: params.sessionId,
+                    since: params.since,
+                    all: params.all,
+                });
+            },
+        },
+    ];
+}
+//# sourceMappingURL=brain-facade.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Cognee facade — knowledge graph ops.
+ * Cognee search, sync, export, graph stats.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createCogneeFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=cognee-facade.d.ts.map

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

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

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

@@ -0,0 +1,154 @@
+/**
+ * Cognee facade — knowledge graph ops.
+ * Cognee search, sync, export, graph stats.
+ */
+import { z } from 'zod';
+import { createCogneeSyncOps } from '../cognee-sync-ops.js';
+export function createCogneeFacadeOps(runtime) {
+    const { cognee, vault, syncManager } = runtime;
+    return [
+        // ─── Cognee (inline from core-ops.ts) ───────────────────────
+        {
+            name: 'cognee_status',
+            description: 'Cognee vector search health — availability, URL, latency. Checks the Cognee API endpoint.',
+            auth: 'read',
+            handler: async () => {
+                return cognee.healthCheck();
+            },
+        },
+        {
+            name: 'cognee_search',
+            description: 'Vector similarity search via Cognee. Complements TF-IDF vault search with semantic understanding.',
+            auth: 'read',
+            schema: z.object({
+                query: z.string(),
+                searchType: z
+                    .enum([
+                    'SUMMARIES',
+                    'CHUNKS',
+                    'RAG_COMPLETION',
+                    'TRIPLET_COMPLETION',
+                    'GRAPH_COMPLETION',
+                    'GRAPH_SUMMARY_COMPLETION',
+                    'NATURAL_LANGUAGE',
+                    'GRAPH_COMPLETION_COT',
+                    'FEELING_LUCKY',
+                    'CHUNKS_LEXICAL',
+                ])
+                    .optional()
+                    .describe('Cognee search type. Default CHUNKS (pure vector similarity).'),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return cognee.search(params.query, {
+                    searchType: params.searchType,
+                    limit: params.limit ?? 10,
+                });
+            },
+        },
+        {
+            name: 'cognee_add',
+            description: 'Ingest vault entries into Cognee for vector indexing. Auto-schedules cognify after ingest.',
+            auth: 'write',
+            schema: z.object({
+                entryIds: z.array(z.string()).describe('Vault entry IDs to ingest into Cognee.'),
+            }),
+            handler: async (params) => {
+                const ids = params.entryIds;
+                const entries = ids
+                    .map((id) => vault.get(id))
+                    .filter((e) => e !== null && e !== undefined);
+                if (entries.length === 0)
+                    return { added: 0, error: 'No matching vault entries found' };
+                return cognee.addEntries(entries);
+            },
+        },
+        {
+            name: 'cognee_cognify',
+            description: 'Trigger Cognee knowledge graph processing on the vault dataset. Usually auto-scheduled after add.',
+            auth: 'write',
+            handler: async () => {
+                return cognee.cognify();
+            },
+        },
+        {
+            name: 'cognee_config',
+            description: 'Get current Cognee client configuration and cached health status.',
+            auth: 'read',
+            handler: async () => {
+                return { config: cognee.getConfig(), cachedStatus: cognee.getStatus() };
+            },
+        },
+        // ─── Cognee Graph ────────────────────────────────────────────
+        {
+            name: 'cognee_get_node',
+            description: 'Get a specific Cognee graph node by UUID with all properties and connections.',
+            auth: 'read',
+            schema: z.object({
+                nodeId: z.string().describe('UUID of the graph node'),
+            }),
+            handler: async (params) => {
+                try {
+                    const results = await cognee.search(params.nodeId, {
+                        searchType: 'GRAPH_COMPLETION',
+                        limit: 1,
+                    });
+                    if (!results || (Array.isArray(results) && results.length === 0)) {
+                        return { found: false, nodeId: params.nodeId };
+                    }
+                    return {
+                        found: true,
+                        nodeId: params.nodeId,
+                        node: Array.isArray(results) ? results[0] : results,
+                    };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            },
+        },
+        {
+            name: 'cognee_graph_stats',
+            description: 'Cognee graph statistics — availability, endpoint, latency from last health check.',
+            auth: 'read',
+            handler: async () => {
+                try {
+                    const status = cognee.getStatus();
+                    const health = await cognee.healthCheck();
+                    return {
+                        available: status?.available ?? false,
+                        url: status?.url ?? cognee.getConfig().baseUrl,
+                        latencyMs: status?.latencyMs ?? health.latencyMs ?? null,
+                        error: status?.error ?? health.error ?? null,
+                    };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            },
+        },
+        {
+            name: 'cognee_export_status',
+            description: 'Check Cognee dataset and processing status — availability, pending operations.',
+            auth: 'read',
+            handler: async () => {
+                try {
+                    const status = cognee.getStatus();
+                    const config = cognee.getConfig();
+                    return {
+                        available: status?.available ?? false,
+                        dataset: config.dataset ?? 'default',
+                        pendingCognify: false,
+                        url: status?.url ?? config.baseUrl,
+                    };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createCogneeSyncOps(syncManager),
+    ];
+}
+//# sourceMappingURL=cognee-facade.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Control facade — agent behavior ops.
+ * identity, intent routing, morphing, guidelines, governance.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createControlFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=control-facade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/control-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,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CA2Q5E"}