@soleri/core 2.1.0 → 2.5.0

package/dist/runtime/capture-ops.js

@@ -0,0 +1,363 @@
+/**
+ * Intelligent capture operations — 4 ops for governance-gated knowledge capture
+ * and project-scoped intelligent search.
+ *
+ * Ops: capture_knowledge, capture_quick, search_intelligent, search_feedback.
+ */
+import { z } from 'zod';
+/**
+ * Create the 4 intelligent capture operations for an agent runtime.
+ *
+ * Groups: capture (2), search (2).
+ */
+export function createCaptureOps(runtime) {
+    const { vault, brain, governance } = runtime;
+    return [
+        // ─── Capture ──────────────────────────────────────────────────
+        {
+            name: 'capture_knowledge',
+            description: 'Batch-capture knowledge entries with governance gating and auto-enrichment via TF-IDF tagging.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().optional().default('.'),
+                entries: z.array(z.object({
+                    id: z.string().optional(),
+                    type: z
+                        .enum([
+                        'pattern',
+                        'anti-pattern',
+                        'rule',
+                        'playbook',
+                        'workflow',
+                        'principle',
+                        'reference',
+                    ])
+                        .describe('Entry type'),
+                    domain: z.string(),
+                    title: z.string(),
+                    severity: z.enum(['critical', 'warning', 'info']).optional().default('info'),
+                    description: z.string(),
+                    tags: z.array(z.string()).optional().default([]),
+                    context: z.string().optional(),
+                    example: z.string().optional(),
+                    counterExample: z.string().optional(),
+                    why: z.string().optional(),
+                })),
+            }),
+            handler: async (params) => {
+                const projectPath = params.projectPath ?? '.';
+                const entries = params.entries;
+                let captured = 0;
+                let proposed = 0;
+                let rejected = 0;
+                const results = [];
+                for (const entry of entries) {
+                    const entryId = entry.id ?? `${entry.domain}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+                    const mappedSeverity = mapSeverity(entry.severity);
+                    const mappedType = mapType(entry.type);
+                    try {
+                        const decision = governance.evaluateCapture(projectPath, {
+                            type: mappedType,
+                            category: entry.domain,
+                            title: entry.title,
+                        });
+                        switch (decision.action) {
+                            case 'capture': {
+                                try {
+                                    brain.enrichAndCapture({
+                                        id: entryId,
+                                        type: mappedType,
+                                        domain: entry.domain,
+                                        title: entry.title,
+                                        severity: mappedSeverity,
+                                        description: entry.description,
+                                        tags: entry.tags ?? [],
+                                        context: entry.context,
+                                        example: entry.example,
+                                        counterExample: entry.counterExample,
+                                        why: entry.why,
+                                    });
+                                    captured++;
+                                    results.push({ id: entryId, action: 'capture' });
+                                }
+                                catch (err) {
+                                    rejected++;
+                                    results.push({
+                                        id: entryId,
+                                        action: 'error',
+                                        reason: err instanceof Error ? err.message : String(err),
+                                    });
+                                }
+                                break;
+                            }
+                            case 'propose': {
+                                try {
+                                    governance.propose(projectPath, {
+                                        entryId,
+                                        title: entry.title,
+                                        type: mappedType,
+                                        category: entry.domain,
+                                        data: {
+                                            severity: mappedSeverity,
+                                            description: entry.description,
+                                            context: entry.context,
+                                            example: entry.example,
+                                            counterExample: entry.counterExample,
+                                            why: entry.why,
+                                            tags: entry.tags,
+                                        },
+                                    }, 'capture-ops');
+                                    proposed++;
+                                    results.push({ id: entryId, action: 'propose', reason: decision.reason });
+                                }
+                                catch (err) {
+                                    rejected++;
+                                    results.push({
+                                        id: entryId,
+                                        action: 'error',
+                                        reason: err instanceof Error ? err.message : String(err),
+                                    });
+                                }
+                                break;
+                            }
+                            default: {
+                                // reject or quarantine
+                                rejected++;
+                                results.push({ id: entryId, action: decision.action, reason: decision.reason });
+                            }
+                        }
+                    }
+                    catch (err) {
+                        rejected++;
+                        results.push({
+                            id: entryId,
+                            action: 'error',
+                            reason: err instanceof Error ? err.message : String(err),
+                        });
+                    }
+                }
+                return { captured, proposed, rejected, results };
+            },
+        },
+        {
+            name: 'capture_quick',
+            description: 'Quick single-entry capture with minimal required fields. Auto-generates ID and infers severity.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().optional().default('.'),
+                type: z
+                    .enum([
+                    'pattern',
+                    'anti-pattern',
+                    'rule',
+                    'playbook',
+                    'workflow',
+                    'principle',
+                    'reference',
+                ])
+                    .describe('Entry type'),
+                domain: z.string(),
+                title: z.string(),
+                description: z.string(),
+                tags: z.array(z.string()).optional().default([]),
+            }),
+            handler: async (params) => {
+                const projectPath = params.projectPath ?? '.';
+                const entryType = params.type;
+                const domain = params.domain;
+                const title = params.title;
+                const description = params.description;
+                const tags = params.tags ?? [];
+                const id = `${domain}-${Date.now()}`;
+                const mappedSeverity = 'info';
+                const mappedType = mapType(entryType);
+                try {
+                    const decision = governance.evaluateCapture(projectPath, {
+                        type: mappedType,
+                        category: domain,
+                        title,
+                    });
+                    switch (decision.action) {
+                        case 'capture': {
+                            try {
+                                brain.enrichAndCapture({
+                                    id,
+                                    type: mappedType,
+                                    domain,
+                                    title,
+                                    severity: mapSeverity(mappedSeverity),
+                                    description,
+                                    tags,
+                                });
+                                return { captured: true, id, governance: { action: 'capture' } };
+                            }
+                            catch (err) {
+                                return {
+                                    captured: false,
+                                    id,
+                                    governance: {
+                                        action: 'error',
+                                        reason: err instanceof Error ? err.message : String(err),
+                                    },
+                                };
+                            }
+                        }
+                        case 'propose': {
+                            try {
+                                governance.propose(projectPath, {
+                                    entryId: id,
+                                    title,
+                                    type: mappedType,
+                                    category: domain,
+                                    data: { severity: mapSeverity(mappedSeverity), description, tags },
+                                }, 'capture-ops-quick');
+                                return {
+                                    captured: false,
+                                    id,
+                                    governance: { action: 'propose', reason: decision.reason },
+                                };
+                            }
+                            catch (err) {
+                                return {
+                                    captured: false,
+                                    id,
+                                    governance: {
+                                        action: 'error',
+                                        reason: err instanceof Error ? err.message : String(err),
+                                    },
+                                };
+                            }
+                        }
+                        default: {
+                            return {
+                                captured: false,
+                                id,
+                                governance: { action: decision.action, reason: decision.reason },
+                            };
+                        }
+                    }
+                }
+                catch (err) {
+                    return {
+                        captured: false,
+                        id,
+                        governance: {
+                            action: 'error',
+                            reason: err instanceof Error ? err.message : String(err),
+                        },
+                    };
+                }
+            },
+        },
+        // ─── Search ────────────────────────────────────────────────────
+        {
+            name: 'search_intelligent',
+            description: 'Project-scoped intelligent search combining vault FTS, brain TF-IDF ranking, and optional memory search.',
+            auth: 'read',
+            schema: z.object({
+                query: z.string(),
+                projectPath: z.string().optional(),
+                domain: z.string().optional(),
+                type: z.string().optional(),
+                limit: z.number().optional().default(20),
+                includeMemories: z.boolean().optional().default(false),
+            }),
+            handler: async (params) => {
+                const query = params.query;
+                const domain = params.domain;
+                const type = params.type;
+                const limit = params.limit ?? 20;
+                const includeMemories = params.includeMemories ?? false;
+                // Search vault via brain's intelligent search (TF-IDF ranked)
+                let vaultResults = [];
+                try {
+                    const ranked = await brain.intelligentSearch(query, { domain, type, limit });
+                    vaultResults = ranked.map((r) => ({ ...r, source: 'vault' }));
+                }
+                catch {
+                    // Graceful degradation — return empty vault results
+                }
+                // Optionally include memories
+                let memoryResults = [];
+                if (includeMemories) {
+                    try {
+                        const memories = vault.searchMemories(query, { limit });
+                        memoryResults = memories.map((m) => ({ ...m, source: 'memory', score: 0.5 }));
+                    }
+                    catch {
+                        // Graceful degradation — return empty memory results
+                    }
+                }
+                // Merge and sort by score descending
+                const combined = [...vaultResults, ...memoryResults];
+                combined.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+                return combined.slice(0, limit);
+            },
+        },
+        {
+            name: 'search_feedback',
+            description: 'Record feedback on search results to improve future ranking via brain learning.',
+            auth: 'write',
+            schema: z.object({
+                query: z.string(),
+                entryId: z.string(),
+                helpful: z.boolean(),
+                context: z.string().optional(),
+            }),
+            handler: async (params) => {
+                const query = params.query;
+                const entryId = params.entryId;
+                const helpful = params.helpful;
+                const context = params.context;
+                try {
+                    const action = helpful ? 'accepted' : 'dismissed';
+                    brain.recordFeedback(query, entryId, action);
+                    return { recorded: true, query, entryId, action, context: context ?? null };
+                }
+                catch (err) {
+                    return {
+                        recorded: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    };
+                }
+            },
+        },
+    ];
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+/**
+ * Map extended severity values to IntelligenceEntry-compatible severity.
+ * 'info' maps to 'suggestion' (the closest existing severity level).
+ */
+function mapSeverity(severity) {
+    switch (severity) {
+        case 'critical':
+            return 'critical';
+        case 'warning':
+            return 'warning';
+        case 'info':
+        default:
+            return 'suggestion';
+    }
+}
+/**
+ * Map extended type values to IntelligenceEntry-compatible types.
+ * 'workflow', 'principle', 'reference' map to 'rule' (the closest existing type).
+ */
+function mapType(type) {
+    switch (type) {
+        case 'pattern':
+            return 'pattern';
+        case 'anti-pattern':
+            return 'anti-pattern';
+        case 'playbook':
+            return 'playbook';
+        case 'rule':
+        case 'workflow':
+        case 'principle':
+        case 'reference':
+        default:
+            return 'rule';
+    }
+}
+//# sourceMappingURL=capture-ops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture-ops.js","sourceRoot":"","sources":["../../src/runtime/capture-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE7C,OAAO;QACL,iEAAiE;QACjE;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACT,gGAAgG;YAClG,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;oBACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBACzB,IAAI,EAAE,CAAC;yBACJ,IAAI,CAAC;wBACJ,SAAS;wBACT,cAAc;wBACd,MAAM;wBACN,UAAU;wBACV,UAAU;wBACV,WAAW;wBACX,WAAW;qBACZ,CAAC;yBACD,QAAQ,CAAC,YAAY,CAAC;oBACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;oBAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;oBACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC3B,CAAC,CACH;aACF,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,WAAW,GAAI,MAAM,CAAC,WAAkC,IAAI,GAAG,CAAC;gBACtE,MAAM,OAAO,GAAG,MAAM,CAAC,OAYrB,CAAC;gBAEH,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,MAAM,OAAO,GAA2D,EAAE,CAAC;gBAE3E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,MAAM,OAAO,GACX,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACxF,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACnD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAEvC,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,WAAW,EAAE;4BACvD,IAAI,EAAE,UAAU;4BAChB,QAAQ,EAAE,KAAK,CAAC,MAAM;4BACtB,KAAK,EAAE,KAAK,CAAC,KAAK;yBACnB,CAAC,CAAC;wBAEH,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;4BACxB,KAAK,SAAS,CAAC,CAAC,CAAC;gCACf,IAAI,CAAC;oCACH,KAAK,CAAC,gBAAgB,CAAC;wCACrB,EAAE,EAAE,OAAO;wCACX,IAAI,EAAE,UAA8D;wCACpE,MAAM,EAAE,KAAK,CAAC,MAAM;wCACpB,KAAK,EAAE,KAAK,CAAC,KAAK;wCAClB,QAAQ,EAAE,cAAc;wCACxB,WAAW,EAAE,KAAK,CAAC,WAAW;wCAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;wCACtB,OAAO,EAAE,KAAK,CAAC,OAAO;wCACtB,OAAO,EAAE,KAAK,CAAC,OAAO;wCACtB,cAAc,EAAE,KAAK,CAAC,cAAc;wCACpC,GAAG,EAAE,KAAK,CAAC,GAAG;qCACf,CAAC,CAAC;oCACH,QAAQ,EAAE,CAAC;oCACX,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gCACnD,CAAC;gCAAC,OAAO,GAAG,EAAE,CAAC;oCACb,QAAQ,EAAE,CAAC;oCACX,OAAO,CAAC,IAAI,CAAC;wCACX,EAAE,EAAE,OAAO;wCACX,MAAM,EAAE,OAAO;wCACf,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qCACzD,CAAC,CAAC;gCACL,CAAC;gCACD,MAAM;4BACR,CAAC;4BACD,KAAK,SAAS,CAAC,CAAC,CAAC;gCACf,IAAI,CAAC;oCACH,UAAU,CAAC,OAAO,CAChB,WAAW,EACX;wCACE,OAAO;wCACP,KAAK,EAAE,KAAK,CAAC,KAAK;wCAClB,IAAI,EAAE,UAAU;wCAChB,QAAQ,EAAE,KAAK,CAAC,MAAM;wCACtB,IAAI,EAAE;4CACJ,QAAQ,EAAE,cAAc;4CACxB,WAAW,EAAE,KAAK,CAAC,WAAW;4CAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;4CACtB,OAAO,EAAE,KAAK,CAAC,OAAO;4CACtB,cAAc,EAAE,KAAK,CAAC,cAAc;4CACpC,GAAG,EAAE,KAAK,CAAC,GAAG;4CACd,IAAI,EAAE,KAAK,CAAC,IAAI;yCACjB;qCACF,EACD,aAAa,CACd,CAAC;oCACF,QAAQ,EAAE,CAAC;oCACX,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gCAC5E,CAAC;gCAAC,OAAO,GAAG,EAAE,CAAC;oCACb,QAAQ,EAAE,CAAC;oCACX,OAAO,CAAC,IAAI,CAAC;wCACX,EAAE,EAAE,OAAO;wCACX,MAAM,EAAE,OAAO;wCACf,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qCACzD,CAAC,CAAC;gCACL,CAAC;gCACD,MAAM;4BACR,CAAC;4BACD,OAAO,CAAC,CAAC,CAAC;gCACR,uBAAuB;gCACvB,QAAQ,EAAE,CAAC;gCACX,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;4BAClF,CAAC;wBACH,CAAC;oBACH,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,QAAQ,EAAE,CAAC;wBACX,OAAO,CAAC,IAAI,CAAC;4BACX,EAAE,EAAE,OAAO;4BACX,MAAM,EAAE,OAAO;4BACf,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACzD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YACnD,CAAC;SACF;QAED;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,iGAAiG;YACnG,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC/C,IAAI,EAAE,CAAC;qBACJ,IAAI,CAAC;oBACJ,SAAS;oBACT,cAAc;oBACd,MAAM;oBACN,UAAU;oBACV,UAAU;oBACV,WAAW;oBACX,WAAW;iBACZ,CAAC;qBACD,QAAQ,CAAC,YAAY,CAAC;gBACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;gBACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;aACjD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,WAAW,GAAI,MAAM,CAAC,WAAkC,IAAI,GAAG,CAAC;gBACtE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAc,CAAC;gBACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgB,CAAC;gBACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;gBACrC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAqB,CAAC;gBACjD,MAAM,IAAI,GAAI,MAAM,CAAC,IAA6B,IAAI,EAAE,CAAC;gBAEzD,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACrC,MAAM,cAAc,GAAG,MAAe,CAAC;gBACvC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;gBAEtC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,WAAW,EAAE;wBACvD,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,MAAM;wBAChB,KAAK;qBACN,CAAC,CAAC;oBAEH,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;wBACxB,KAAK,SAAS,CAAC,CAAC,CAAC;4BACf,IAAI,CAAC;gCACH,KAAK,CAAC,gBAAgB,CAAC;oCACrB,EAAE;oCACF,IAAI,EAAE,UAA8D;oCACpE,MAAM;oCACN,KAAK;oCACL,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC;oCACrC,WAAW;oCACX,IAAI;iCACL,CAAC,CAAC;gCACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAkB,EAAE,EAAE,CAAC;4BAC5E,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,OAAO;oCACL,QAAQ,EAAE,KAAK;oCACf,EAAE;oCACF,UAAU,EAAE;wCACV,MAAM,EAAE,OAAgB;wCACxB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qCACzD;iCACF,CAAC;4BACJ,CAAC;wBACH,CAAC;wBACD,KAAK,SAAS,CAAC,CAAC,CAAC;4BACf,IAAI,CAAC;gCACH,UAAU,CAAC,OAAO,CAChB,WAAW,EACX;oCACE,OAAO,EAAE,EAAE;oCACX,KAAK;oCACL,IAAI,EAAE,UAAU;oCAChB,QAAQ,EAAE,MAAM;oCAChB,IAAI,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;iCACnE,EACD,mBAAmB,CACpB,CAAC;gCACF,OAAO;oCACL,QAAQ,EAAE,KAAK;oCACf,EAAE;oCACF,UAAU,EAAE,EAAE,MAAM,EAAE,SAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;iCACpE,CAAC;4BACJ,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,OAAO;oCACL,QAAQ,EAAE,KAAK;oCACf,EAAE;oCACF,UAAU,EAAE;wCACV,MAAM,EAAE,OAAgB;wCACxB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qCACzD;iCACF,CAAC;4BACJ,CAAC;wBACH,CAAC;wBACD,OAAO,CAAC,CAAC,CAAC;4BACR,OAAO;gCACL,QAAQ,EAAE,KAAK;gCACf,EAAE;gCACF,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;6BACjE,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO;wBACL,QAAQ,EAAE,KAAK;wBACf,EAAE;wBACF,UAAU,EAAE;4BACV,MAAM,EAAE,OAAgB;4BACxB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACzD;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;QAED,kEAAkE;QAClE;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,0GAA0G;YAC5G,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;aACvD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;gBACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAA4B,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA0B,CAAC;gBAC/C,MAAM,KAAK,GAAI,MAAM,CAAC,KAA4B,IAAI,EAAE,CAAC;gBACzD,MAAM,eAAe,GAAI,MAAM,CAAC,eAAuC,IAAI,KAAK,CAAC;gBAEjF,8DAA8D;gBAC9D,IAAI,YAAY,GAAsD,EAAE,CAAC;gBACzE,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC7E,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChE,CAAC;gBAAC,MAAM,CAAC;oBACP,oDAAoD;gBACtD,CAAC;gBAED,8BAA8B;gBAC9B,IAAI,aAAa,GAAsD,EAAE,CAAC;gBAC1E,IAAI,eAAe,EAAE,CAAC;oBACpB,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;wBACxD,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;oBAChF,CAAC;oBAAC,MAAM,CAAC;wBACP,qDAAqD;oBACvD,CAAC;gBACH,CAAC;gBAED,qCAAqC;gBACrC,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,aAAa,CAAC,CAAC;gBACrD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAE,CAAC,CAAC,KAAgB,IAAI,CAAC,CAAC,GAAG,CAAE,CAAC,CAAC,KAAgB,IAAI,CAAC,CAAC,CAAC,CAAC;gBAEjF,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;SACF;QAED;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,iFAAiF;YACnF,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;gBACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;gBACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC/B,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;gBACrC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;gBACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAkB,CAAC;gBAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAA6B,CAAC;gBAErD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;oBAClD,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC7C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;gBAC9E,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO;wBACL,QAAQ,EAAE,KAAK;wBACf,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,SAAS,WAAW,CAAC,QAA4B;IAC/C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/runtime/cognee-sync-ops.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cognee sync operations — 3 ops for queue visibility and control.
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { CogneeSyncManager } from '../cognee/sync-manager.js';
+/**
+ * Create the 3 cognee-sync operations.
+ *
+ * The sync manager is optional — when null, all ops return a graceful error.
+ */
+export declare function createCogneeSyncOps(syncManager: CogneeSyncManager | null): OpDefinition[];
+//# sourceMappingURL=cognee-sync-ops.d.ts.map

package/dist/runtime/cognee-sync-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognee-sync-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/cognee-sync-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,YAAY,EAAE,CAiDzF"}

package/dist/runtime/cognee-sync-ops.js

@@ -0,0 +1,55 @@
+/**
+ * Cognee sync operations — 3 ops for queue visibility and control.
+ */
+import { z } from 'zod';
+/**
+ * Create the 3 cognee-sync operations.
+ *
+ * The sync manager is optional — when null, all ops return a graceful error.
+ */
+export function createCogneeSyncOps(syncManager) {
+    return [
+        // ─── Status ──────────────────────────────────────────────────
+        {
+            name: 'cognee_sync_status',
+            description: 'Get current cognee sync queue stats — pending, processing, completed, failed counts.',
+            auth: 'read',
+            schema: z.object({}),
+            handler: async () => {
+                if (!syncManager) {
+                    return { error: 'Sync manager not configured' };
+                }
+                return syncManager.getStats();
+            },
+        },
+        // ─── Drain ───────────────────────────────────────────────────
+        {
+            name: 'cognee_sync_drain',
+            description: 'Process pending items in the cognee sync queue. Returns count of processed items and updated stats.',
+            auth: 'write',
+            schema: z.object({}),
+            handler: async () => {
+                if (!syncManager) {
+                    return { error: 'Sync manager not configured' };
+                }
+                const processed = await syncManager.drain();
+                return { processed, stats: syncManager.getStats() };
+            },
+        },
+        // ─── Reconcile ───────────────────────────────────────────────
+        {
+            name: 'cognee_sync_reconcile',
+            description: 'Find vault entries with stale or missing cognee ingestion and enqueue them for sync.',
+            auth: 'write',
+            schema: z.object({}),
+            handler: async () => {
+                if (!syncManager) {
+                    return { error: 'Sync manager not configured' };
+                }
+                const enqueued = syncManager.reconcile();
+                return { enqueued, stats: syncManager.getStats() };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=cognee-sync-ops.js.map

package/dist/runtime/cognee-sync-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognee-sync-ops.js","sourceRoot":"","sources":["../../src/runtime/cognee-sync-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAqC;IACvE,OAAO;QACL,gEAAgE;QAChE;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,sFAAsF;YACxF,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;gBAClD,CAAC;gBACD,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;YAChC,CAAC;SACF;QAED,gEAAgE;QAChE;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACT,qGAAqG;YACvG,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;gBAClD,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;gBAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtD,CAAC;SACF;QAED,gEAAgE;QAChE;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,sFAAsF;YACxF,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;gBAClD,CAAC;gBACD,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;gBACzC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrD,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * Generic core operations factory — 37 ops that every agent gets.
+ * Generic core operations factory — 158 ops that every agent gets.
  *
  * These ops are agent-agnostic (no persona, no activation).
  * The 5 agent-specific ops (health, identity, activate, inject_claude_md, setup)
@@ -8,10 +8,16 @@
 import type { OpDefinition } from '../facades/types.js';
 import type { AgentRuntime } from './types.js';
 /**
- * Create the 37 generic core operations for an agent runtime.
+ * Create the 203 generic core operations for an agent runtime.
  *
  * Groups: search/vault (4), memory (4), export (1), planning (5),
- *         brain (4), brain intelligence (11), curator (8).
+ *         brain (8), brain intelligence (11), cognee (5),
+ *         llm (2), curator (8), control (8), governance (5),
+ *         playbook (5), prompt templates (2),
+ *         planning-extra (22), memory-extra (8), vault-extra (20),
+ *         admin (8), admin-extra (23), loop (9), orchestrate (5),
+ *         grading (5), capture (4), curator-extra (5), project (12),
+ *         cognee-sync (3), intake (4).
  */
 export declare function createCoreOps(runtime: AgentRuntime): OpDefinition[];
 //# sourceMappingURL=core-ops.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/core-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CA2nBnE"}
+{"version":3,"file":"core-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/core-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB/C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAu3CnE"}