stellar-memory 0.5.0

package/dist/mcp/server.js

@@ -0,0 +1,242 @@
+/**
+ * mcp/server.ts — Thin factory that wires tool handlers to the MCP server.
+ *
+ * Responsibilities:
+ *   1. Instantiate McpServer.
+ *   2. Register the stellar://sun resource.
+ *   3. Register each tool, forwarding parsed args to the appropriate handler.
+ *
+ * Business logic lives in mcp/tools/. This file contains no logic beyond wiring.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { handleStatus, handleCommit, handleRecall, handleRemember, handleOrbit, handleForget, handleExport, handleConstellation, handleGalaxy, handleAnalytics, handleSunResource, handleObserve, handleConsolidate, handleResolveConflict, handleTemporal, } from './tools/memory-tools.js';
+import { handleScan } from './tools/ingestion-tools.js';
+import { handleDaemon } from './tools/daemon-tool.js';
+// ---------------------------------------------------------------------------
+// Server factory
+// ---------------------------------------------------------------------------
+export function createStellarServer() {
+    const server = new McpServer({ name: 'stellar-memory', version: '0.4.0' });
+    // ── Resource: stellar://sun ───────────────────────────────────────────────
+    server.resource('sun', 'stellar://sun', {
+        description: 'Current working context (the Sun). Contains active project state, recent decisions, and next steps. ' +
+            'Read this at the start of every session to restore context.\n\n' +
+            '[AUTO-TRIGGER] Read this resource at the very beginning of every conversation before any other action.',
+        mimeType: 'text/plain',
+    }, (uri) => handleSunResource(uri.href));
+    // ── Tool: status ──────────────────────────────────────────────────────────
+    server.tool('status', 'View the current state of your stellar memory system. Shows memories grouped by orbital zone ' +
+        '(core = actively working, forgotten = nearly forgotten), and optionally lists registered data sources. ' +
+        'Use this to get a snapshot of what the system knows.\n\n' +
+        '[AUTO-TRIGGER] Call at the start of every session alongside recall to restore full context.', {
+        zone: z.enum(['all', 'core', 'near', 'active', 'archive', 'fading', 'forgotten'])
+            .optional()
+            .describe('Filter memories to a specific orbital zone. Defaults to "all".'),
+        limit: z.number().int().min(1).max(200)
+            .optional()
+            .describe('Maximum number of memories to return. Defaults to 50.'),
+        show: z.enum(['memories', 'sources', 'all'])
+            .optional()
+            .describe('What to display: memories, data sources, or both. Default: "memories".'),
+    }, (args) => handleStatus(args));
+    // ── Tool: commit ──────────────────────────────────────────────────────────
+    server.tool('commit', 'Save the current session state into the Sun (working context). Call this at the end of each session ' +
+        'or when switching tasks to preserve your progress.\n\n' +
+        '[AUTO-TRIGGER] Call automatically before a conversation ends. This is the most critical auto-trigger.', {
+        current_work: z.string().min(1)
+            .describe('A clear description of what you are currently working on.'),
+        decisions: z.array(z.string()).optional()
+            .describe('Key decisions made during this session.'),
+        next_steps: z.array(z.string()).optional()
+            .describe('Concrete next actions to take in future sessions.'),
+        errors: z.array(z.string()).optional()
+            .describe('Active errors or blockers that need attention.'),
+        context: z.string().optional()
+            .describe('Additional background context for the project.'),
+    }, (args) => handleCommit(args));
+    // ── Tool: recall ──────────────────────────────────────────────────────────
+    server.tool('recall', 'Search memories by content and pull relevant ones closer to the Sun. ' +
+        'Uses hybrid FTS5 + vector search for best results.\n\n' +
+        '[AUTO-TRIGGER] Call at session start with keywords from the user\'s first message.', {
+        query: z.string().min(1)
+            .describe('Search query to find relevant memories.'),
+        type: z.enum(['all', 'decision', 'observation', 'task', 'context', 'error', 'milestone'])
+            .optional()
+            .describe('Filter by memory type. Defaults to "all".'),
+        max_au: z.number().min(0.1).max(100).optional()
+            .describe('Only return memories within this distance in AU.'),
+        limit: z.number().int().min(1).max(50).optional()
+            .describe('Maximum number of memories to return. Defaults to 10.'),
+        include_universal: z.boolean().optional()
+            .describe('Also include universal memories from other projects. Default: false.'),
+        at: z.string().optional()
+            .describe('ISO date string. If provided, returns memories that were active at this point in time (temporal query) instead of normal recall.'),
+    }, (args) => handleRecall(args));
+    // ── Tool: remember ────────────────────────────────────────────────────────
+    server.tool('remember', 'Store a new memory in the stellar system. Memories are automatically placed in an orbital zone ' +
+        'based on their type and impact.\n\n' +
+        '[AUTO-TRIGGER] Call immediately when: (1) a design decision is made, (2) a bug is resolved, ' +
+        '(3) a feature milestone is reached, (4) important technical context is discovered.', {
+        content: z.string().min(1)
+            .describe('The full content of the memory to store.'),
+        summary: z.string().optional()
+            .describe('A short one-line summary. If omitted, first 50 chars of content are used.'),
+        type: z.enum(['decision', 'observation', 'task', 'context', 'error', 'milestone'])
+            .optional()
+            .describe('Memory type. Defaults to "observation".'),
+        impact: z.number().min(0).max(1).optional()
+            .describe('Impact score 0.0–1.0 affecting orbital distance.'),
+        tags: z.array(z.string()).optional()
+            .describe('Tags for categorizing and searching this memory.'),
+    }, (args) => handleRemember(args));
+    // ── Tool: orbit ───────────────────────────────────────────────────────────
+    server.tool('orbit', 'Force a recalculation of all orbital positions for the project.\n\n' +
+        '[AUTO-TRIGGER] Call after storing 5+ memories in a single session.', {}, () => handleOrbit({}));
+    // ── Tool: forget ──────────────────────────────────────────────────────────
+    server.tool('forget', 'Push a memory into a distant orbit (soft forget) or permanently delete it.', {
+        id: z.string().min(1)
+            .describe('The ID of the memory to forget.'),
+        mode: z.enum(['push', 'delete']).optional()
+            .describe('"push" moves to Oort Cloud; "delete" permanently removes. Defaults to "push".'),
+    }, (args) => handleForget(args));
+    // ── Tool: scan ────────────────────────────────────────────────────────────
+    server.tool('scan', 'Scan a local directory and automatically convert files into memories. ' +
+        'Files already indexed (same content hash) are skipped — scanning is idempotent.', {
+        path: z.string().min(1)
+            .describe('Absolute or relative path to the directory to scan.'),
+        recursive: z.boolean().optional()
+            .describe('Recurse into subdirectories. Defaults to true.'),
+        git: z.boolean().optional()
+            .describe('Also import recent git commit history as memories. Defaults to true.'),
+        max_kb: z.number().int().min(1).max(10240).optional()
+            .describe('Maximum individual file size in KB to process. Defaults to 1024 KB.'),
+    }, (args) => handleScan(args));
+    // ── Tool: daemon ──────────────────────────────────────────────────────────
+    server.tool('daemon', 'Control the background scheduler daemon. ' +
+        'The scheduler automatically recalculates orbits, runs local scans, ' +
+        'and cleans up the Oort cloud on configurable intervals.', {
+        action: z.enum(['status', 'start', 'stop'])
+            .describe('"status" — show state, "start" — start scheduler, "stop" — stop scheduler.'),
+    }, (args) => handleDaemon(args));
+    // ── Tool: constellation ───────────────────────────────────────────────────
+    server.tool('constellation', 'Explore the Knowledge Graph (constellation) of relationships between memories. ' +
+        'Use action="graph" to see the full graph around a memory, "related" to list connected memories, ' +
+        'or "extract" to auto-discover relationships from content similarity.', {
+        id: z.string().min(1)
+            .describe('The memory ID to explore.'),
+        action: z.enum(['graph', 'related', 'extract']).optional()
+            .describe('"graph" — show constellation graph (default). "related" — list related memories. "extract" — auto-extract relationships.'),
+        depth: z.number().int().min(1).max(3).optional()
+            .describe('Graph traversal depth for action="graph". Default: 1.'),
+        limit: z.number().int().min(1).max(50).optional()
+            .describe('Max memories to return for action="related". Default: 10.'),
+    }, (args) => handleConstellation(args));
+    // ── Tool: export ──────────────────────────────────────────────────────────
+    server.tool('export', 'Export all memories as JSON or Markdown for backup or migration.', {
+        type: z.enum(['all', 'decision', 'observation', 'task', 'context', 'error', 'milestone'])
+            .optional()
+            .describe('Filter by memory type. Defaults to all.'),
+        zone: z.enum(['all', 'core', 'near', 'active', 'archive', 'fading', 'forgotten'])
+            .optional()
+            .describe('Filter by orbital zone. Defaults to all.'),
+        format: z.enum(['json', 'markdown']).optional()
+            .describe('Output format. Defaults to json.'),
+    }, (args) => handleExport(args));
+    // ── Tool: galaxy ───────────────────────────────────────────────────────────
+    server.tool('galaxy', 'Manage multiple projects (star systems) in your stellar memory galaxy.\n\n' +
+        'Actions:\n' +
+        '  switch          — switch the active project at runtime (no restart needed)\n' +
+        '  list            — list all projects with memory counts and stats\n' +
+        '  create          — create a new project\n' +
+        '  stats           — detailed statistics for a project\n' +
+        '  mark_universal  — mark a memory as universal (visible in all projects)\n' +
+        '  universal_context — retrieve universal memories from other projects\n' +
+        '  candidates      — detect memories that are good candidates to become universal', {
+        action: z.enum(['switch', 'list', 'create', 'stats', 'mark_universal', 'universal_context', 'candidates'])
+            .describe('Action to perform.'),
+        project: z.string().optional()
+            .describe('Project name. Required for switch/create; optional for stats/universal_context/candidates (defaults to current).'),
+        memory_id: z.string().optional()
+            .describe('Memory ID. Required for mark_universal.'),
+        is_universal: z.boolean().optional()
+            .describe('Whether to mark as universal (true) or project-specific (false). Default: true.'),
+        limit: z.number().int().min(1).max(100).optional()
+            .describe('Maximum results to return for universal_context. Default: 10.'),
+    }, (args) => handleGalaxy(args));
+    // ── Tool: analytics ───────────────────────────────────────────────────────
+    server.tool('analytics', 'Get insights and analytics about your memory system. Includes survival curves, topic clusters, ' +
+        'health metrics, and recommendations.\n\n' +
+        'Reports:\n' +
+        '  summary   — full analytics summary (zone/type distribution, quality, recall rate)\n' +
+        '  health    — health metrics + actionable recommendations\n' +
+        '  topics    — topic cluster heatmap (most active topics)\n' +
+        '  survival  — memory survival curve by age bucket\n' +
+        '  movements — orbit movement timeline (which memories moved most)\n' +
+        '  full      — full text report combining all analytics', {
+        report: z.enum(['summary', 'health', 'topics', 'survival', 'movements', 'full'])
+            .describe('Type of analytics report to generate.'),
+        project: z.string().optional()
+            .describe('Project to analyse. Defaults to the current active project.'),
+        days: z.number().int().min(1).max(365).optional()
+            .describe('Lookback window in days for report="movements". Default: 30.'),
+    }, (args) => handleAnalytics(args));
+    // ── Tool: observe ─────────────────────────────────────────────────────────
+    server.tool('observe', 'Process a conversation chunk to automatically extract and store memories. ' +
+        'The Observer phase extracts key facts, decisions, and errors. ' +
+        'The Reflector phase compares against existing memories to categorize as novel, reinforcing, or conflicting.', {
+        conversation: z.string().min(1)
+            .describe('The conversation text to observe and extract memories from.'),
+        project: z.string().optional()
+            .describe('Project context. Defaults to the current active project.'),
+    }, (args) => handleObserve(args));
+    // ── Tool: consolidate ─────────────────────────────────────────────────────
+    server.tool('consolidate', 'Find and merge similar memories to reduce redundancy and improve quality. ' +
+        'Memories with high similarity are combined into richer single memories. ' +
+        'Use dry_run=true (default) to preview candidates before merging.', {
+        project: z.string().optional()
+            .describe('Project context. Defaults to the current active project.'),
+        dry_run: z.boolean().optional()
+            .describe('If true, only report candidates without merging. Default: true.'),
+    }, (args) => handleConsolidate(args));
+    // ── Tool: resolve_conflict ────────────────────────────────────────────────
+    server.tool('resolve_conflict', 'View and resolve memory conflicts. Conflicts are detected when new memories contradict existing ones.\n\n' +
+        'Actions:\n' +
+        '  list    — list all unresolved conflicts\n' +
+        '  resolve — resolve a conflict (supersede, dismiss, or keep_both)\n' +
+        '  dismiss — dismiss a conflict without changes', {
+        action: z.enum(['list', 'resolve', 'dismiss'])
+            .describe('Action to perform: list conflicts, resolve one, or dismiss one.'),
+        conflict_id: z.string().optional()
+            .describe('Conflict ID. Required for resolve/dismiss actions.'),
+        resolution: z.string().optional()
+            .describe('Human-readable description of how the conflict was resolved.'),
+        resolve_action: z.enum(['supersede', 'dismiss', 'keep_both']).optional()
+            .describe('How to resolve: supersede the older memory, dismiss without changes, or keep both. Default: supersede.'),
+        project: z.string().optional()
+            .describe('Project context. Defaults to the current active project.'),
+    }, (args) => handleResolveConflict(args));
+    // ── Tool: temporal ────────────────────────────────────────────────────────
+    server.tool('temporal', 'Query memories at a specific point in time or view how knowledge has evolved. ' +
+        'Supports temporal browsing and evolution chain tracking.\n\n' +
+        'Actions:\n' +
+        '  at         — get memories that were active at a specific timestamp\n' +
+        '  chain      — view the full evolution chain of a memory\n' +
+        '  summary    — temporal summary (active vs superseded counts)\n' +
+        '  set_bounds — set valid_from / valid_until bounds on a memory', {
+        action: z.enum(['at', 'chain', 'summary', 'set_bounds'])
+            .describe('Action to perform.'),
+        timestamp: z.string().optional()
+            .describe('ISO date string. Required for action="at".'),
+        memory_id: z.string().optional()
+            .describe('Memory ID. Required for action="chain" and "set_bounds".'),
+        valid_from: z.string().optional()
+            .describe('ISO date. For set_bounds — when the memory became valid.'),
+        valid_until: z.string().optional()
+            .describe('ISO date. For set_bounds — when the memory stopped being valid.'),
+        project: z.string().optional()
+            .describe('Project context. Defaults to the current active project.'),
+    }, (args) => handleTemporal(args));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/daemon-tool.d.ts

@@ -0,0 +1,16 @@
+/**
+ * mcp/tools/daemon-tool.ts — Handler function for the daemon MCP tool.
+ *
+ * The daemon tool manages the background StellarScheduler.
+ */
+type McpResponse = {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export declare function handleDaemon(args: {
+    action: 'status' | 'start' | 'stop';
+}): Promise<McpResponse>;
+export {};
+//# sourceMappingURL=daemon-tool.d.ts.map

package/dist/mcp/tools/daemon-tool.js

@@ -0,0 +1,58 @@
+/**
+ * mcp/tools/daemon-tool.ts — Handler function for the daemon MCP tool.
+ *
+ * The daemon tool manages the background StellarScheduler.
+ */
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { StellarScheduler, DEFAULT_SCHEDULE_CONFIG } from '../../service/scheduler.js';
+// Module-level scheduler state (one daemon per process)
+let _scheduler = null;
+let _schedulerStartedAt = null;
+function getOrCreateScheduler() {
+    if (!_scheduler) {
+        _scheduler = new StellarScheduler(DEFAULT_SCHEDULE_CONFIG);
+    }
+    return _scheduler;
+}
+// ---------------------------------------------------------------------------
+// daemon
+// ---------------------------------------------------------------------------
+export async function handleDaemon(args) {
+    try {
+        const scheduler = getOrCreateScheduler();
+        switch (args.action) {
+            case 'start': {
+                scheduler.start();
+                _schedulerStartedAt = new Date();
+                return { content: [{ type: 'text', text: 'Daemon: started.' }] };
+            }
+            case 'stop': {
+                scheduler.stop();
+                _schedulerStartedAt = null;
+                return { content: [{ type: 'text', text: 'Daemon: stopped.' }] };
+            }
+            case 'status': {
+                const taskStatus = scheduler.getStatus();
+                const isRunning = _schedulerStartedAt !== null;
+                const startedStr = _schedulerStartedAt ? _schedulerStartedAt.toISOString() : '—';
+                const lines = [
+                    `Daemon: ${isRunning ? 'RUNNING' : 'STOPPED'} | started: ${startedStr}`,
+                    '',
+                ];
+                for (const [name, status] of Object.entries(taskStatus)) {
+                    const last = status.lastRunAt ? status.lastRunAt.toISOString() : 'never';
+                    const dur = status.lastDuration !== null ? `${status.lastDuration}ms` : '—';
+                    const err = status.lastError ? ` ERR: ${status.lastError}` : '';
+                    lines.push(`  ${name.padEnd(22)} runs=${status.runCount}  last=${last}  dur=${dur}${err}`);
+                }
+                return { content: [{ type: 'text', text: lines.join('\n') }] };
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof McpError)
+            throw err;
+        throw new McpError(ErrorCode.InternalError, `daemon failed: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=daemon-tool.js.map

package/dist/mcp/tools/daemon-tool.js.map

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

package/dist/mcp/tools/ingestion-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * mcp/tools/ingestion-tools.ts — Handler functions for scan MCP tool.
+ *
+ * Exported functions:
+ *   handleScan — scan tool (local directory ingestion)
+ */
+type McpResponse = {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export declare function handleScan(args: {
+    path: string;
+    recursive?: boolean;
+    git?: boolean;
+    max_kb?: number;
+}): Promise<McpResponse>;
+export {};
+//# sourceMappingURL=ingestion-tools.d.ts.map

package/dist/mcp/tools/ingestion-tools.js

@@ -0,0 +1,34 @@
+/**
+ * mcp/tools/ingestion-tools.ts — Handler functions for scan MCP tool.
+ *
+ * Exported functions:
+ *   handleScan — scan tool (local directory ingestion)
+ */
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { StellarScanner } from '../../scanner/index.js';
+// ---------------------------------------------------------------------------
+// scan
+// ---------------------------------------------------------------------------
+export async function handleScan(args) {
+    try {
+        const scanner = new StellarScanner({
+            paths: [args.path],
+            maxFileSize: (args.max_kb ?? 1024) * 1024,
+        });
+        const result = await scanner.scanPath(args.path, {
+            recursive: args.recursive ?? true,
+            includeGit: args.git ?? true,
+        });
+        const lines = [
+            `Scan: ${args.path} | ${(result.durationMs / 1000).toFixed(2)}s`,
+            `  files: ${result.scannedFiles}  new: ${result.createdMemories}  skipped: ${result.skippedFiles}  errors: ${result.errorFiles}`,
+        ];
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (err) {
+        if (err instanceof McpError)
+            throw err;
+        throw new McpError(ErrorCode.InternalError, `scan failed: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=ingestion-tools.js.map

package/dist/mcp/tools/ingestion-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/ingestion-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAKhC;IACC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;YACjC,KAAK,EAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI;SAC1C,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YAC/C,SAAS,EAAG,IAAI,CAAC,SAAS,IAAI,IAAI;YAClC,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;SAC7B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAa;YACtB,SAAS,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;YAChE,YAAY,MAAM,CAAC,YAAY,UAAU,MAAM,CAAC,eAAe,cAAc,MAAM,CAAC,YAAY,aAAa,MAAM,CAAC,UAAU,EAAE;SACjI,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAC;QACvC,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/mcp/tools/memory-tools.d.ts

@@ -0,0 +1,122 @@
+/**
+ * mcp/tools/memory-tools.ts — Handler functions for memory-related MCP tools.
+ *
+ * Exported functions:
+ *   handleStatus  — status tool
+ *   handleCommit  — commit tool
+ *   handleRecall  — recall tool
+ *   handleRemember — remember tool
+ *   handleOrbit   — orbit tool
+ *   handleForget  — forget tool
+ *   handleExport  — export tool
+ *
+ * Each function receives only the parsed tool arguments it needs plus any
+ * dependencies injected at call-site. It returns the MCP response object
+ * `{ content: [{ type: 'text', text: string }] }`.
+ *
+ * No McpServer or SDK imports are needed here — that coupling lives in server.ts.
+ */
+import type { OrbitZone } from '../../engine/types.js';
+import type { MemoryType } from '../../engine/types.js';
+declare const bgErrors: {
+    embedding: number;
+    constellation: number;
+    consolidation: number;
+};
+/** Increment a background error counter. Called from fire-and-forget tasks. */
+export declare function trackBgError(category: keyof typeof bgErrors): void;
+/** Get background error stats snapshot. */
+export declare function getBgErrorStats(): typeof bgErrors;
+type McpResponse = {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export declare function handleStatus(args: {
+    zone?: 'all' | 'core' | 'near' | 'active' | 'archive' | 'fading' | 'forgotten';
+    limit?: number;
+    show?: 'memories' | 'sources' | 'all';
+}): Promise<McpResponse>;
+export declare function handleCommit(args: {
+    current_work: string;
+    decisions?: string[];
+    next_steps?: string[];
+    errors?: string[];
+    context?: string;
+}): Promise<McpResponse>;
+export declare function handleRecall(args: {
+    query: string;
+    type?: 'all' | MemoryType;
+    max_au?: number;
+    limit?: number;
+    include_universal?: boolean;
+    at?: string;
+}): Promise<McpResponse>;
+export declare function handleRemember(args: {
+    content: string;
+    summary?: string;
+    type?: MemoryType;
+    impact?: number;
+    tags?: string[];
+}): Promise<McpResponse>;
+export declare function handleOrbit(_args: Record<string, never>): Promise<McpResponse>;
+export declare function handleForget(args: {
+    id: string;
+    mode?: 'push' | 'delete';
+}): Promise<McpResponse>;
+export declare function handleExport(args: {
+    type?: 'all' | MemoryType;
+    zone?: 'all' | OrbitZone;
+    format?: 'json' | 'markdown';
+}): Promise<McpResponse>;
+export declare function handleConstellation(args: {
+    id: string;
+    action?: 'graph' | 'related' | 'extract';
+    depth?: number;
+    limit?: number;
+}): Promise<McpResponse>;
+export declare function handleGalaxy(args: {
+    action: 'switch' | 'list' | 'create' | 'stats' | 'mark_universal' | 'universal_context' | 'candidates';
+    project?: string;
+    memory_id?: string;
+    is_universal?: boolean;
+    limit?: number;
+}): Promise<McpResponse>;
+export declare function handleAnalytics(args: {
+    report?: 'summary' | 'health' | 'topics' | 'survival' | 'movements' | 'full';
+    action?: 'overview' | 'survival' | 'movements' | 'clusters' | 'patterns' | 'health' | 'report';
+    project?: string;
+    days?: number;
+}): Promise<McpResponse>;
+export declare function handleSunResource(uriHref: string): {
+    contents: [{
+        uri: string;
+        text: string;
+    }];
+};
+export declare function handleObserve(args: {
+    conversation: string;
+    project?: string;
+}): Promise<McpResponse>;
+export declare function handleConsolidate(args: {
+    project?: string;
+    dry_run?: boolean;
+}): Promise<McpResponse>;
+export declare function handleResolveConflict(args: {
+    action: 'list' | 'resolve' | 'dismiss';
+    conflict_id?: string;
+    resolution?: string;
+    resolve_action?: 'supersede' | 'dismiss' | 'keep_both';
+    project?: string;
+}): Promise<McpResponse>;
+export declare function handleTemporal(args: {
+    action: 'at' | 'chain' | 'summary' | 'set_bounds';
+    timestamp?: string;
+    memory_id?: string;
+    valid_from?: string;
+    valid_until?: string;
+    project?: string;
+}): Promise<McpResponse>;
+export {};
+//# sourceMappingURL=memory-tools.d.ts.map