@scitrera/memorylayer-mcp-server 0.0.5 → 0.2.0

package/dist/src/tools.d.ts.map

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

package/dist/src/tools.js

@@ -38,6 +38,26 @@ export const TOOLS = [
                     type: "string",
                     enum: ["solution", "problem", "code_pattern", "fix", "error", "workflow", "preference", "decision", "directive"],
                     description: "Optional domain-specific classification"
+                },
+                metadata: {
+                    type: "object",
+                    description: "Arbitrary memory metadata"
+                },
+                relations: {
+                    type: "array",
+                    description: "Explicit typed entity relations evidenced by this memory",
+                    items: {
+                        type: "object",
+                        properties: {
+                            source_entity_id: { type: "string" },
+                            source_entity_name: { type: "string" },
+                            target_entity_id: { type: "string" },
+                            target_entity_name: { type: "string" },
+                            relationship: { type: "string" },
+                            confidence: { type: "number", minimum: 0, maximum: 1 }
+                        },
+                        required: ["relationship"]
+                    }
                 }
             },
             required: ["content"]
@@ -78,6 +98,21 @@ export const TOOLS = [
                     type: "array",
                     items: { type: "string" },
                     description: "Filter by tags (AND logic)"
+                },
+                budget_tokens: {
+                    type: "integer",
+                    minimum: 1,
+                    description: "Hard estimated-token budget for returned memory content"
+                },
+                include_confidence: {
+                    type: "boolean",
+                    default: true,
+                    description: "Include deterministic retrieval-confidence metadata"
+                },
+                include_relations: {
+                    type: "boolean",
+                    default: true,
+                    description: "Allow bounded typed-relation retrieval when enabled"
                 }
             },
             required: ["query"]
@@ -204,7 +239,7 @@ export const TOOLS = [
     // Advanced tools
     {
         name: "memory_statistics",
-        description: "Get memory statistics and analytics for the workspace. Use to understand memory usage patterns.",
+        description: "Get memory statistics and analytics for the workspace. Use to understand memory usage patterns. (placeholder — not yet implemented; returns zero values)",
         inputSchema: {
             type: "object",
             properties: {
@@ -255,7 +290,7 @@ export const TOOLS = [
     },
     {
         name: "memory_audit",
-        description: "Audit memories for contradictions and inconsistencies. Use to maintain knowledge base health.",
+        description: "Audit memories for contradictions and inconsistencies. Use to maintain knowledge base health. (placeholder — not yet implemented; no audit is performed)",
         inputSchema: {
             type: "object",
             properties: {
@@ -345,6 +380,54 @@ export const SESSION_TOOLS = [
             properties: {}
         }
     },
+    {
+        name: "memory_session_checkpoint",
+        description: "Durably capture a raw transcript segment before compaction; derived indexing and enrichment never block raw capture.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                transcript_segment: { type: "string", description: "Exact raw transcript segment to preserve" },
+                content_hash: { type: "string", description: "Lowercase SHA-256 digest of the UTF-8 segment" },
+                idempotency_key: { type: "string", description: "Stable key for safe retry" },
+                source_kind: { type: "string", default: "transcript" },
+                source_sequence: { type: "integer", minimum: 0 },
+                source_boundary: { type: "integer", minimum: 0 }
+            },
+            required: ["transcript_segment", "content_hash", "idempotency_key"]
+        }
+    },
+    {
+        name: "memory_context_pack",
+        description: "Build one deterministic, hard-budgeted session resume payload with directives, working memory, recent activity, contradictions, and checkpoint recovery.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic: { type: "string", description: "Optional topic focus" },
+                entity_ids: { type: "array", items: { type: "string" } },
+                entity_names: { type: "array", items: { type: "string" } },
+                budget_tokens: { type: "integer", minimum: 32, default: 2048 },
+                section_limits: { type: "object", description: "Per-section item caps" },
+                include_directives: { type: "boolean", default: true },
+                include_working_memory: { type: "boolean", default: true },
+                include_recent_activity: { type: "boolean", default: true },
+                include_contradictions: { type: "boolean", default: true },
+                include_sandbox_summary: { type: "boolean", default: true },
+                include_checkpoint_recovery: { type: "boolean", default: true }
+            }
+        }
+    },
+    {
+        name: "memory_context_delta",
+        description: "Return collapsed context changes and tombstones since a signed context-pack cursor under a hard token budget.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cursor: { type: "string", description: "Cursor from a context pack or prior delta" },
+                budget_tokens: { type: "integer", minimum: 32, default: 2048 }
+            },
+            required: ["cursor"]
+        }
+    },
 ];
 /**
  * Context Environment tools for server-side sandbox execution.
@@ -557,6 +640,422 @@ export const CONTEXT_ENVIRONMENT_TOOLS = [
         }
     },
 ];
+/**
+ * Chat history tools for storing and managing conversation threads.
+ */
+export const CHAT_TOOLS = [
+    {
+        name: "chat_thread_create",
+        description: "Create a new chat thread for storing conversation history. Threads persist messages over time and can auto-decompose into memories.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                thread_id: { type: "string", description: "Client-provided thread ID (auto-generated if omitted)" },
+                user_id: { type: "string", description: "User who owns this conversation" },
+                observer_id: { type: "string", description: "Observer entity ID (typically the AI agent)" },
+                subject_id: { type: "string", description: "Subject entity ID (typically the human user)" },
+                title: { type: "string", description: "Optional display title" },
+                metadata: { type: "object", description: "Arbitrary metadata" }
+            }
+        }
+    },
+    {
+        name: "chat_thread_append",
+        description: "Append messages to a chat thread. Messages are stored persistently and will be decomposed into memories when threshold is reached.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                thread_id: { type: "string", description: "Thread to append to" },
+                messages: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            role: { type: "string", description: "Message role: user, assistant, system, tool" },
+                            content: { description: "Message content (string or structured blocks)" },
+                            metadata: { type: "object", description: "Optional metadata" }
+                        },
+                        required: ["role", "content"]
+                    },
+                    description: "Messages to append"
+                }
+            },
+            required: ["thread_id", "messages"]
+        }
+    },
+    {
+        name: "chat_thread_get",
+        description: "Get a chat thread with its messages. Returns thread metadata and paginated messages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                thread_id: { type: "string", description: "Thread ID to retrieve" },
+                limit: { type: "integer", default: 100, description: "Max messages to return" },
+                offset: { type: "integer", default: 0, description: "Message pagination offset" },
+                order: { type: "string", enum: ["asc", "desc"], default: "asc", description: "Message order" }
+            },
+            required: ["thread_id"]
+        }
+    },
+    {
+        name: "chat_thread_list",
+        description: "List chat threads in the workspace, optionally filtered by user.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: { type: "string", description: "Filter by user ID" },
+                limit: { type: "integer", default: 50, description: "Max threads to return" },
+                offset: { type: "integer", default: 0, description: "Pagination offset" }
+            }
+        }
+    },
+    {
+        name: "chat_thread_decompose",
+        description: "Trigger memory decomposition for a thread's unprocessed messages. Extracts memories from chat history.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                thread_id: { type: "string", description: "Thread to decompose" }
+            },
+            required: ["thread_id"]
+        }
+    },
+    {
+        name: "chat_thread_delete",
+        description: "Delete a chat thread and all its messages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                thread_id: { type: "string", description: "Thread to delete" }
+            },
+            required: ["thread_id"]
+        }
+    },
+];
+/**
+ * MCP tools for MCP server registry management.
+ *
+ * - mcp_servers_list   = list registered MCP servers
+ * - mcp_servers_get    = fetch a single server by ID or name
+ * - mcp_servers_save   = create or update a server (upsert by name)
+ * - mcp_servers_delete = delete a server by ID
+ * - mcp_servers_import = bulk import from mcpServers JSON object
+ */
+export const MCP_SERVERS_TOOLS = [
+    {
+        name: "mcp_servers_list",
+        description: "List MCP servers registered in MemoryLayer. Returns name, transport, command/url, enabled status, and ID for each server. Use to discover what MCP servers are available in the workspace.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                transport: {
+                    type: "string",
+                    enum: ["stdio", "http", "sse", "streamable-http"],
+                    description: "Filter by transport type"
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "Filter by enabled status (default: all servers)"
+                },
+                name: {
+                    type: "string",
+                    description: "Filter by exact server name"
+                },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                    description: "Maximum number of servers to return"
+                },
+                offset: {
+                    type: "integer",
+                    minimum: 0,
+                    default: 0,
+                    description: "Pagination offset"
+                }
+            },
+            required: []
+        }
+    },
+    {
+        name: "mcp_servers_get",
+        description: "Fetch a single MCP server record by ID or name. Returns full server details including transport, command/url, args, and metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server_id: {
+                    type: "string",
+                    description: "Server ID (mcp_...) — use when you have the ID from mcp_servers_list"
+                },
+                name: {
+                    type: "string",
+                    description: "Server name — resolved by the server if server_id is not provided"
+                }
+            },
+            required: []
+        }
+    },
+    {
+        name: "mcp_servers_save",
+        description: "Create or update an MCP server record in MemoryLayer. If a server with the given name already exists it is updated; otherwise a new record is created. Env values and headers are stored as secrets.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Server name (1-64 chars, lowercase letters/digits/hyphens)"
+                },
+                transport: {
+                    type: "string",
+                    enum: ["stdio", "http", "sse", "streamable-http"],
+                    description: "Transport type: stdio (local process) or http/sse/streamable-http (remote)"
+                },
+                command: {
+                    type: "string",
+                    description: "Executable for stdio transport (e.g. 'npx', 'python')"
+                },
+                args: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Arguments for the command (stdio transport)"
+                },
+                env: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Environment variables for the server process (stored as secrets)"
+                },
+                url: {
+                    type: "string",
+                    description: "URL for http/sse/streamable-http transport"
+                },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "HTTP headers for remote transport (stored as secrets)"
+                },
+                description: {
+                    type: "string",
+                    description: "Human-readable description of what this server provides"
+                },
+                enabled: {
+                    type: "boolean",
+                    default: true,
+                    description: "Whether the server is enabled"
+                },
+                metadata: {
+                    type: "object",
+                    description: "Arbitrary metadata"
+                }
+            },
+            required: ["name", "transport"]
+        }
+    },
+    {
+        name: "mcp_servers_delete",
+        description: "Delete an MCP server record from MemoryLayer by ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server_id: {
+                    type: "string",
+                    description: "Server ID (mcp_...) to delete"
+                }
+            },
+            required: ["server_id"]
+        }
+    },
+    {
+        name: "mcp_servers_import",
+        description: "Bulk-import MCP servers from a mcpServers JSON object (the same format as .mcp.json / claude_desktop_config.json). Creates new records and updates existing ones by name. Returns counts of imported, updated, and any errors.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mcpServers: {
+                    type: "object",
+                    description: "Map of server name to server config (same schema as .mcp.json mcpServers field)",
+                    additionalProperties: {
+                        type: "object",
+                        properties: {
+                            command: { type: "string" },
+                            args: { type: "array", items: { type: "string" } },
+                            env: { type: "object", additionalProperties: { type: "string" } },
+                            url: { type: "string" },
+                            type: { type: "string" }
+                        }
+                    }
+                }
+            },
+            required: ["mcpServers"]
+        }
+    }
+];
+/**
+ * MCP tools for Agent Skills management.
+ *
+ * Implements the spec's progressive disclosure tiers:
+ * - skills_list  = metadata tier  (~100 tokens per skill)
+ * - skills_get   = instructions tier (full SKILL.md, ≤5k tokens recommended)
+ * - skills_get_file = resources tier (on-demand file content)
+ * - skills_search = vector recall against skill memory mirror
+ * - skills_save  = upsert a skill (full profile only)
+ */
+export const SKILLS_TOOLS = [
+    {
+        name: "skills_list",
+        description: "List available agent skills from MemoryLayer. Returns name, description, version, and scope for each skill. Use this to discover what skills are available before fetching details.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Filter by exact skill name"
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "Filter by enabled status (default: only enabled skills)"
+                },
+                include_shadowed: {
+                    type: "boolean",
+                    description: "Include skills shadowed by higher-scope skills with the same name"
+                },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                    description: "Maximum number of skills to return"
+                },
+                offset: {
+                    type: "integer",
+                    minimum: 0,
+                    default: 0,
+                    description: "Pagination offset"
+                }
+            },
+            required: []
+        }
+    },
+    {
+        name: "skills_get",
+        description: "Fetch the full SKILL.md body for a named skill. Returns frontmatter (name, description, version) plus the full instructions markdown. Use after skills_list to get actionable skill instructions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skill_id: {
+                    type: "string",
+                    description: "Skill ID (skl_...) — use when you have the ID from skills_list"
+                },
+                name: {
+                    type: "string",
+                    description: "Skill name — resolved via the server if skill_id is not provided"
+                }
+            },
+            required: []
+        }
+    },
+    {
+        name: "skills_get_file",
+        description: "Fetch a single file from a skill's bundle (scripts, references, or assets). Returns text content or base64-encoded binary. Use for on-demand access to skill resources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skill_id: {
+                    type: "string",
+                    description: "Skill ID (skl_...)"
+                },
+                path: {
+                    type: "string",
+                    description: "Relative file path within the skill bundle (e.g. scripts/extract.py)"
+                }
+            },
+            required: ["skill_id", "path"]
+        }
+    },
+    {
+        name: "skills_search",
+        description: "Search for skills by intent or description using vector recall. Use when you want to find a skill by what it does rather than its exact name (e.g. 'how do I extract tables from PDFs?').",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language query describing the capability you need"
+                },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 50,
+                    default: 10,
+                    description: "Maximum number of candidate skills to return"
+                }
+            },
+            required: ["query"]
+        }
+    },
+    {
+        name: "skills_save",
+        description: "Create or update an agent skill in MemoryLayer. Stores the SKILL.md manifest and optional bundle files. The skill becomes available to all agents that share this MemoryLayer workspace.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Skill name (1-64 chars, lowercase letters/digits/hyphens, no leading/trailing/consecutive hyphens)"
+                },
+                description: {
+                    type: "string",
+                    description: "Skill description (1-1024 chars)"
+                },
+                body: {
+                    type: "string",
+                    description: "SKILL.md body markdown (the instructions, examples, usage)"
+                },
+                version: {
+                    type: "string",
+                    default: "0.1.0",
+                    description: "Skill version (semver-ish)"
+                },
+                license: {
+                    type: "string",
+                    description: "License identifier (e.g. MIT)"
+                },
+                compatibility: {
+                    type: "string",
+                    description: "Compatibility notes (max 500 chars)"
+                },
+                allowed_tools: {
+                    type: "string",
+                    description: "Space-separated tool allowlist (experimental spec field)"
+                },
+                source_mode: {
+                    type: "string",
+                    enum: ["server", "filesystem", "mirrored"],
+                    default: "server",
+                    description: "Where canonical storage lives"
+                },
+                metadata: {
+                    type: "object",
+                    description: "Arbitrary spec-allowed metadata"
+                },
+                files: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            path: { type: "string", description: "Relative path within skill bundle" },
+                            content_b64: { type: "string", description: "Base64-encoded file content" },
+                            mime_type: { type: "string", description: "MIME type (optional)" }
+                        },
+                        required: ["path", "content_b64"]
+                    },
+                    description: "Optional bundle files (scripts, references, assets)"
+                }
+            },
+            required: ["name", "description"]
+        }
+    }
+];
 /**
  * Tool profiles for different use cases.
  *
@@ -581,6 +1080,9 @@ export const TOOL_NAMES = {
     sessionEnd: "memory_session_end",
     sessionCommit: "memory_session_commit",
     sessionStatus: "memory_session_status",
+    sessionCheckpoint: "memory_session_checkpoint",
+    contextPack: "memory_context_pack",
+    contextDelta: "memory_context_delta",
     // Context environment (server-side sandbox)
     contextExec: "memory_context_exec",
     contextInspect: "memory_context_inspect",
@@ -590,6 +1092,25 @@ export const TOOL_NAMES = {
     contextRlm: "memory_context_rlm",
     contextStatus: "memory_context_status",
     contextCheckpoint: "memory_context_checkpoint",
+    // Chat history
+    chatThreadCreate: "chat_thread_create",
+    chatThreadAppend: "chat_thread_append",
+    chatThreadGet: "chat_thread_get",
+    chatThreadList: "chat_thread_list",
+    chatThreadDecompose: "chat_thread_decompose",
+    chatThreadDelete: "chat_thread_delete",
+    // Skills (agent harness knowledge units)
+    skillsList: "skills_list",
+    skillsGet: "skills_get",
+    skillsGetFile: "skills_get_file",
+    skillsSearch: "skills_search",
+    skillsSave: "skills_save",
+    // MCP server registry
+    mcpServersList: "mcp_servers_list",
+    mcpServersGet: "mcp_servers_get",
+    mcpServersSave: "mcp_servers_save",
+    mcpServersDelete: "mcp_servers_delete",
+    mcpServersImport: "mcp_servers_import",
 };
 export const TOOL_PROFILES = {
     /**
@@ -617,6 +1138,9 @@ export const TOOL_PROFILES = {
         TOOL_NAMES.sessionEnd,
         TOOL_NAMES.sessionCommit,
         TOOL_NAMES.sessionStatus,
+        TOOL_NAMES.sessionCheckpoint,
+        TOOL_NAMES.contextPack,
+        TOOL_NAMES.contextDelta,
         // Context environment
         TOOL_NAMES.contextExec,
         TOOL_NAMES.contextInspect,
@@ -626,6 +1150,16 @@ export const TOOL_PROFILES = {
         TOOL_NAMES.contextRlm,
         TOOL_NAMES.contextStatus,
         TOOL_NAMES.contextCheckpoint,
+        // Chat history
+        TOOL_NAMES.chatThreadCreate,
+        TOOL_NAMES.chatThreadAppend,
+        TOOL_NAMES.chatThreadGet,
+        TOOL_NAMES.chatThreadList,
+        // Skills (read-mostly: list, get, get_file, search)
+        TOOL_NAMES.skillsList,
+        TOOL_NAMES.skillsGet,
+        TOOL_NAMES.skillsGetFile,
+        TOOL_NAMES.skillsSearch,
     ],
     /**
      * Full profile - all tools enabled
@@ -648,6 +1182,9 @@ export const TOOL_PROFILES = {
         TOOL_NAMES.sessionEnd,
         TOOL_NAMES.sessionCommit,
         TOOL_NAMES.sessionStatus,
+        TOOL_NAMES.sessionCheckpoint,
+        TOOL_NAMES.contextPack,
+        TOOL_NAMES.contextDelta,
         // Context environment
         TOOL_NAMES.contextExec,
         TOOL_NAMES.contextInspect,
@@ -657,6 +1194,25 @@ export const TOOL_PROFILES = {
         TOOL_NAMES.contextRlm,
         TOOL_NAMES.contextStatus,
         TOOL_NAMES.contextCheckpoint,
+        // Chat history
+        TOOL_NAMES.chatThreadCreate,
+        TOOL_NAMES.chatThreadAppend,
+        TOOL_NAMES.chatThreadGet,
+        TOOL_NAMES.chatThreadList,
+        TOOL_NAMES.chatThreadDecompose,
+        TOOL_NAMES.chatThreadDelete,
+        // Skills (all 5 including save)
+        TOOL_NAMES.skillsList,
+        TOOL_NAMES.skillsGet,
+        TOOL_NAMES.skillsGetFile,
+        TOOL_NAMES.skillsSearch,
+        TOOL_NAMES.skillsSave,
+        // MCP server registry (all 5)
+        TOOL_NAMES.mcpServersList,
+        TOOL_NAMES.mcpServersGet,
+        TOOL_NAMES.mcpServersSave,
+        TOOL_NAMES.mcpServersDelete,
+        TOOL_NAMES.mcpServersImport,
     ],
     /**
      * Minimal profile - just the essentials
@@ -673,7 +1229,7 @@ export const DEFAULT_PROFILE = "cc";
  * Get tools for a given profile.
  */
 export function getToolsForProfile(profile) {
-    const allTools = [...TOOLS, ...SESSION_TOOLS, ...CONTEXT_ENVIRONMENT_TOOLS];
+    const allTools = [...TOOLS, ...SESSION_TOOLS, ...CONTEXT_ENVIRONMENT_TOOLS, ...CHAT_TOOLS, ...SKILLS_TOOLS, ...MCP_SERVERS_TOOLS];
     const enabledNames = TOOL_PROFILES[profile];
     return allTools.filter(tool => enabledNames.includes(tool.name));
 }