@soleri/core 2.1.0 → 2.5.0

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

@@ -0,0 +1,173 @@
+/**
+ * Extended memory operations — 8 ops for advanced memory management.
+ *
+ * These complement the 4 base memory ops in core-ops.ts:
+ *   memory_search, memory_capture, memory_list, session_capture
+ *
+ * New ops: memory_delete, memory_stats, memory_export, memory_import,
+ *          memory_prune, memory_deduplicate, memory_topics, memory_by_project
+ */
+import { z } from 'zod';
+export function createMemoryExtraOps(runtime) {
+    const { vault } = runtime;
+    return [
+        {
+            name: 'memory_delete',
+            description: 'Delete a memory by ID. Returns whether the deletion was successful.',
+            auth: 'write',
+            schema: z.object({
+                memoryId: z.string().describe('The memory ID to delete'),
+            }),
+            handler: async (params) => {
+                const memoryId = params.memoryId;
+                const existing = vault.getMemory(memoryId);
+                if (!existing) {
+                    return { deleted: false, error: `Memory "${memoryId}" not found.` };
+                }
+                const deleted = vault.deleteMemory(memoryId);
+                return { deleted, memoryId };
+            },
+        },
+        {
+            name: 'memory_stats',
+            description: 'Detailed memory statistics — counts by type, project, date range, plus oldest/newest timestamps and archived count.',
+            auth: 'read',
+            schema: z.object({
+                projectPath: z.string().optional().describe('Filter stats to a specific project'),
+                fromDate: z
+                    .number()
+                    .optional()
+                    .describe('Unix timestamp — only include memories created after this date'),
+                toDate: z
+                    .number()
+                    .optional()
+                    .describe('Unix timestamp — only include memories created before this date'),
+            }),
+            handler: async (params) => {
+                return vault.memoryStatsDetailed({
+                    projectPath: params.projectPath,
+                    fromDate: params.fromDate,
+                    toDate: params.toDate,
+                });
+            },
+        },
+        {
+            name: 'memory_export',
+            description: 'Export memories as a JSON array. Optionally filter by project or type. Useful for backup and migration.',
+            auth: 'read',
+            schema: z.object({
+                projectPath: z.string().optional().describe('Filter to a specific project'),
+                type: z
+                    .enum(['session', 'lesson', 'preference'])
+                    .optional()
+                    .describe('Filter by memory type'),
+                includeArchived: z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe('Whether to include archived memories'),
+            }),
+            handler: async (params) => {
+                const memories = vault.exportMemories({
+                    projectPath: params.projectPath,
+                    type: params.type,
+                    includeArchived: params.includeArchived ?? false,
+                });
+                return { exported: true, count: memories.length, memories };
+            },
+        },
+        {
+            name: 'memory_import',
+            description: 'Import memories from a JSON array. Duplicates (same ID) are skipped. Returns imported and skipped counts.',
+            auth: 'write',
+            schema: z.object({
+                memories: z
+                    .array(z.object({
+                    id: z.string(),
+                    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([]),
+                    createdAt: z.number(),
+                    archivedAt: z.number().nullable().optional().default(null),
+                }))
+                    .describe('Array of memory objects to import'),
+            }),
+            handler: async (params) => {
+                const memories = params.memories.map((m) => ({
+                    id: m.id,
+                    projectPath: m.projectPath,
+                    type: m.type,
+                    context: m.context,
+                    summary: m.summary,
+                    topics: m.topics ?? [],
+                    filesModified: m.filesModified ?? [],
+                    toolsUsed: m.toolsUsed ?? [],
+                    createdAt: m.createdAt,
+                    archivedAt: m.archivedAt ?? null,
+                }));
+                const result = vault.importMemories(memories);
+                return { ...result, total: memories.length };
+            },
+        },
+        {
+            name: 'memory_prune',
+            description: 'Delete non-archived memories older than N days. Destructive — cannot be undone.',
+            auth: 'admin',
+            schema: z.object({
+                olderThanDays: z.number().min(1).describe('Delete memories older than this many days'),
+            }),
+            handler: async (params) => {
+                const days = params.olderThanDays;
+                const result = vault.pruneMemories(days);
+                return { ...result, olderThanDays: days };
+            },
+        },
+        {
+            name: 'memory_deduplicate',
+            description: 'Find and remove duplicate memories (same summary + project + type). Keeps the earliest entry in each duplicate group.',
+            auth: 'admin',
+            schema: z.object({}),
+            handler: async () => {
+                return vault.deduplicateMemories();
+            },
+        },
+        {
+            name: 'memory_topics',
+            description: 'List all unique topics across memories, with occurrence counts. Sorted by frequency descending.',
+            auth: 'read',
+            schema: z.object({}),
+            handler: async () => {
+                const topics = vault.memoryTopics();
+                return { count: topics.length, topics };
+            },
+        },
+        {
+            name: 'memory_by_project',
+            description: 'List memories grouped by project path. Each group includes the project path, count, and the memories themselves.',
+            auth: 'read',
+            schema: z.object({
+                includeMemories: z
+                    .boolean()
+                    .optional()
+                    .default(true)
+                    .describe('Whether to include full memory objects or just counts'),
+            }),
+            handler: async (params) => {
+                const includeMemories = params.includeMemories ?? true;
+                const groups = vault.memoriesByProject();
+                if (!includeMemories) {
+                    return {
+                        count: groups.length,
+                        projects: groups.map((g) => ({ project: g.project, count: g.count })),
+                    };
+                }
+                return { count: groups.length, projects: groups };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=memory-extra-ops.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Orchestration operations — compose planning + brain + vault into high-level workflows.
+ *
+ * These ops are convenience wrappers that sequence multiple module calls:
+ *   - orchestrate_plan: brain-informed plan creation
+ *   - orchestrate_execute: start plan + brain session together
+ *   - orchestrate_complete: finish plan + brain session + extract knowledge
+ *   - orchestrate_status: combined status across all modules
+ *   - orchestrate_quick_capture: one-call knowledge capture without full planning
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from './types.js';
+/**
+ * Create the 5 orchestration operations for an agent runtime.
+ */
+export declare function createOrchestrateOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=orchestrate-ops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/orchestrate-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAmQ1E"}

package/dist/runtime/orchestrate-ops.js

@@ -0,0 +1,246 @@
+/**
+ * Orchestration operations — compose planning + brain + vault into high-level workflows.
+ *
+ * These ops are convenience wrappers that sequence multiple module calls:
+ *   - orchestrate_plan: brain-informed plan creation
+ *   - orchestrate_execute: start plan + brain session together
+ *   - orchestrate_complete: finish plan + brain session + extract knowledge
+ *   - orchestrate_status: combined status across all modules
+ *   - orchestrate_quick_capture: one-call knowledge capture without full planning
+ */
+import { z } from 'zod';
+/**
+ * Create the 5 orchestration operations for an agent runtime.
+ */
+export function createOrchestrateOps(runtime) {
+    const { planner, brainIntelligence, vault } = runtime;
+    return [
+        // ─── orchestrate_plan ─────────────────────────────────────────
+        {
+            name: 'orchestrate_plan',
+            description: 'Create a brain-informed plan with recommendations from pattern strengths. ' +
+                'Fetches relevant brain recommendations for the domain/task, then creates a plan ' +
+                'with those recommendations injected as decisions.',
+            auth: 'write',
+            schema: z.object({
+                objective: z.string().describe('What the plan aims to achieve'),
+                scope: z.string().describe('Boundaries of the work'),
+                domain: z
+                    .string()
+                    .optional()
+                    .describe('Domain for brain recommendations (e.g. "component", "styling")'),
+                tasks: z
+                    .array(z.object({ title: z.string(), description: z.string() }))
+                    .optional()
+                    .describe('Optional pre-defined tasks'),
+            }),
+            handler: async (params) => {
+                const objective = params.objective;
+                const scope = params.scope;
+                const domain = params.domain;
+                const tasks = params.tasks ?? [];
+                // Get brain recommendations — graceful degradation if no data
+                let recommendations = [];
+                try {
+                    const raw = brainIntelligence.recommend({
+                        domain,
+                        task: objective,
+                        limit: 5,
+                    });
+                    recommendations = raw.map((r) => ({
+                        pattern: r.pattern,
+                        strength: r.strength,
+                    }));
+                }
+                catch {
+                    // Brain has no data yet — proceed without recommendations
+                }
+                // Build decisions from recommendations
+                const decisions = recommendations.map((r) => `Brain pattern: ${r.pattern} (strength: ${r.strength.toFixed(1)})`);
+                // Create plan with recommendations as context
+                const plan = planner.create({
+                    objective,
+                    scope,
+                    decisions,
+                    tasks,
+                });
+                return { plan, recommendations };
+            },
+        },
+        // ─── orchestrate_execute ──────────────────────────────────────
+        {
+            name: 'orchestrate_execute',
+            description: 'Start plan execution and open a brain session to track the work. ' +
+                'The plan must be in "approved" status. Returns both the updated plan and session ID.',
+            auth: 'write',
+            schema: z.object({
+                planId: z.string().describe('ID of the approved plan to start executing'),
+                domain: z.string().optional().describe('Domain for brain session tracking'),
+                context: z.string().optional().describe('Additional context for the brain session'),
+            }),
+            handler: async (params) => {
+                const planId = params.planId;
+                const domain = params.domain;
+                const context = params.context;
+                // Start plan execution
+                const plan = planner.startExecution(planId);
+                // Start brain session linked to this plan
+                const session = brainIntelligence.lifecycle({
+                    action: 'start',
+                    domain,
+                    context,
+                    planId,
+                });
+                return { plan, session };
+            },
+        },
+        // ─── orchestrate_complete ─────────────────────────────────────
+        {
+            name: 'orchestrate_complete',
+            description: 'Complete plan execution, end brain session, and extract knowledge. ' +
+                'Performs three steps: marks plan completed, ends the brain session with outcome, ' +
+                'and runs knowledge extraction on the session.',
+            auth: 'write',
+            schema: z.object({
+                planId: z.string().describe('ID of the executing plan to complete'),
+                sessionId: z.string().describe('ID of the brain session to end'),
+                outcome: z
+                    .enum(['completed', 'abandoned', 'partial'])
+                    .optional()
+                    .default('completed')
+                    .describe('Plan outcome'),
+                toolsUsed: z.array(z.string()).optional().describe('Tools used during execution'),
+                filesModified: z.array(z.string()).optional().describe('Files modified during execution'),
+            }),
+            handler: async (params) => {
+                const planId = params.planId;
+                const sessionId = params.sessionId;
+                const outcome = params.outcome ?? 'completed';
+                const toolsUsed = params.toolsUsed ?? [];
+                const filesModified = params.filesModified ?? [];
+                // Complete the plan
+                const plan = planner.complete(planId);
+                // End brain session with outcome
+                const session = brainIntelligence.lifecycle({
+                    action: 'end',
+                    sessionId,
+                    planId,
+                    planOutcome: outcome,
+                    toolsUsed,
+                    filesModified,
+                });
+                // Extract knowledge from the session — graceful if nothing to extract
+                let extraction = null;
+                try {
+                    extraction = brainIntelligence.extractKnowledge(sessionId);
+                }
+                catch {
+                    // Session may not have enough signal for extraction — that's OK
+                }
+                return { plan, session, extraction };
+            },
+        },
+        // ─── orchestrate_status ───────────────────────────────────────
+        {
+            name: 'orchestrate_status',
+            description: 'Get combined orchestration status: active plans, brain session context, ' +
+                'vault stats, and recent brain recommendations.',
+            auth: 'read',
+            schema: z.object({
+                domain: z.string().optional().describe('Filter recommendations by domain'),
+                sessionLimit: z
+                    .number()
+                    .optional()
+                    .describe('Number of recent sessions to include (default 5)'),
+            }),
+            handler: async (params) => {
+                const domain = params.domain;
+                const sessionLimit = params.sessionLimit ?? 5;
+                // Active plans
+                const activePlans = planner.getActive();
+                // Brain session context
+                const sessionContext = brainIntelligence.getSessionContext(sessionLimit);
+                // Vault stats
+                const vaultStats = vault.stats();
+                // Recent recommendations — graceful degradation
+                let recommendations = [];
+                try {
+                    const raw = brainIntelligence.recommend({
+                        domain,
+                        limit: 5,
+                    });
+                    recommendations = raw.map((r) => ({
+                        pattern: r.pattern,
+                        strength: r.strength,
+                    }));
+                }
+                catch {
+                    // No recommendations available
+                }
+                // Brain intelligence stats
+                const brainStats = brainIntelligence.getStats();
+                return {
+                    activePlans,
+                    sessionContext,
+                    vaultStats,
+                    recommendations,
+                    brainStats,
+                };
+            },
+        },
+        // ─── orchestrate_quick_capture ────────────────────────────────
+        {
+            name: 'orchestrate_quick_capture',
+            description: 'Capture knowledge from a completed task without full plan lifecycle. ' +
+                'Creates a brain session, records the context, ends it, and extracts knowledge — all in one call.',
+            auth: 'write',
+            schema: z.object({
+                domain: z.string().describe('Knowledge domain (e.g. "component", "accessibility")'),
+                context: z.string().describe('What was done — summary of the task'),
+                toolsUsed: z.array(z.string()).optional().describe('Tools used during the task'),
+                filesModified: z.array(z.string()).optional().describe('Files modified during the task'),
+                outcome: z
+                    .enum(['completed', 'abandoned', 'partial'])
+                    .optional()
+                    .default('completed')
+                    .describe('Task outcome'),
+            }),
+            handler: async (params) => {
+                const domain = params.domain;
+                const context = params.context;
+                const toolsUsed = params.toolsUsed ?? [];
+                const filesModified = params.filesModified ?? [];
+                const outcome = params.outcome ?? 'completed';
+                // Start session
+                const startedSession = brainIntelligence.lifecycle({
+                    action: 'start',
+                    domain,
+                    context,
+                    toolsUsed,
+                    filesModified,
+                });
+                // End session immediately with outcome
+                const endedSession = brainIntelligence.lifecycle({
+                    action: 'end',
+                    sessionId: startedSession.id,
+                    toolsUsed,
+                    filesModified,
+                    planOutcome: outcome,
+                });
+                // Extract knowledge — graceful if nothing to extract
+                let extraction = null;
+                try {
+                    extraction = brainIntelligence.extractKnowledge(startedSession.id);
+                }
+                catch {
+                    // Not enough signal — that's fine
+                }
+                return {
+                    session: endedSession,
+                    extraction,
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=orchestrate-ops.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Extended planning operations — 22 ops for advanced plan lifecycle management.
+ *
+ * These complement the 5 basic planning ops in core-ops.ts with:
+ * iteration, splitting, reconciliation, lifecycle completion,
+ * dispatch, review, archival, task listing, statistics,
+ * evidence submission, verification, validation, auto-reconciliation,
+ * review prompt generation, brainstorming, execution metrics,
+ * deliverable submission, and deliverable verification.
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from './types.js';
+/**
+ * Create 22 extended planning operations for an agent runtime.
+ *
+ * Groups:
+ *   mutation: plan_iterate, plan_split, plan_reconcile, plan_complete_lifecycle,
+ *             plan_review, plan_archive, plan_submit_evidence, plan_auto_reconcile,
+ *             plan_review_outcome, plan_record_task_metrics, plan_submit_deliverable
+ *   query:   plan_dispatch, plan_list_tasks, plan_stats, plan_verify_task,
+ *             plan_verify_plan, plan_validate, plan_review_spec, plan_review_quality,
+ *             plan_brainstorm, plan_execution_metrics, plan_verify_deliverables
+ */
+export declare function createPlanningExtraOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=planning-extra-ops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAgrB5E"}