frinus-mcp 3.1.0

package/dist/tools/definitions.js

@@ -0,0 +1,1548 @@
+export const TOOLS = [
+    // ==========================================================================
+    // Core Memory (5)
+    // ==========================================================================
+    {
+        name: "memory_store",
+        description: `Store a memory in the memory service.
+
+Use this to record important information, learnings, decisions, or procedures
+that should be remembered for future reference.
+
+Memory types:
+- episodic: Specific experiences and events (what happened)
+- semantic: General knowledge and facts (what I know)
+- procedural: How to do things (step-by-step procedures)
+
+Scopes:
+- user: Private to the user
+- agent: Private to the agent
+- universe: Shared within the universe (department)
+- organization: Available to all agents in the organization`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent storing the memory",
+                },
+                content: {
+                    type: "string",
+                    description: "The memory content to store",
+                },
+                memory_type: {
+                    type: "string",
+                    enum: ["episodic", "semantic", "procedural"],
+                    description: "Type of memory (default: episodic)",
+                },
+                scope: {
+                    type: "string",
+                    enum: ["user", "agent", "universe", "organization"],
+                    description: "Visibility scope: user (private), agent (agent-only), universe (department), organization (org-wide). Default: organization",
+                },
+                importance: {
+                    type: "number",
+                    description: "Importance score 0-1 (default: 0.5)",
+                },
+                user_id: {
+                    type: "string",
+                    description: "Optional user identifier (email) who owns this memory",
+                },
+                created_by_user_id: {
+                    type: "string",
+                    description: "Optional user identifier (email) who triggered this memory creation. Auto-injected from logged-in user if not provided.",
+                },
+                metadata: {
+                    type: "object",
+                    description: "Metadata adicional (tags, universe, idioma, etc.)",
+                },
+                context_id: {
+                    type: "string",
+                    description: "Optional UUID of a hierarchy node (universe, concept, theme, topic, or point). When provided, the memory is automatically linked to this node and all its ancestors. Takes precedence over universe_id for hierarchy placement.",
+                },
+                credential_ref: {
+                    type: "string",
+                    description: "Reference key linking this memory to an encrypted credential in the vault. When an agent retrieves this memory and sees a credential_ref, it can fetch the credential via credential_get(ref). E.g., 'jira_muza', 'mysql_centerpag'.",
+                },
+            },
+            required: ["agent_id", "content"],
+        },
+    },
+    {
+        name: "memory_search",
+        description: `Search memories by semantic similarity.
+
+Use this to find relevant memories based on a query.
+Returns memories ranked by similarity to the query.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                query_text: {
+                    type: "string",
+                    description: "The search query text",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Filter by agent UUID",
+                },
+                memory_types: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by memory types",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum results (default: 10)",
+                },
+            },
+            required: ["query_text"],
+        },
+    },
+    {
+        name: "memory_get",
+        description: `Get a specific memory by its ID.
+
+Use this to retrieve the full details of a memory including content,
+metadata, importance score, and hierarchy level.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: { type: "string", description: "UUID of the memory to retrieve" },
+            },
+            required: ["memory_id"],
+        },
+    },
+    {
+        name: "memory_list",
+        description: `List memories for an agent.
+
+Use this to see all memories stored by an agent,
+optionally filtered by type.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent",
+                },
+                memory_type: {
+                    type: "string",
+                    enum: ["episodic", "semantic", "procedural"],
+                    description: "Filter by memory type",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum results (default: 50)",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "memory_delete",
+        description: `Delete a memory by its ID.
+
+Use with caution - this permanently removes the memory.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: { type: "string", description: "UUID of the memory to delete" },
+            },
+            required: ["memory_id"],
+        },
+    },
+    // ==========================================================================
+    // Dynamic Relevance (2)
+    // ==========================================================================
+    {
+        name: "memory_reinforce",
+        description: `Reinforce a memory after successful use (Dynamic Relevance).
+
+Use this when a memory was helpful to increase its importance.
+The memory's relevance score will be boosted.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: { type: "string", description: "UUID of the memory to reinforce" },
+                boost: { type: "number", description: "Boost amount 0-1 (default: 0.1)" },
+            },
+            required: ["memory_id"],
+        },
+    },
+    {
+        name: "memory_weaken",
+        description: `Weaken a memory that was not useful (Dynamic Relevance).
+
+Use this when a memory was retrieved but not helpful.
+The memory's relevance score will be reduced.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: { type: "string", description: "UUID of the memory to weaken" },
+                penalty: { type: "number", description: "Penalty amount 0-1 (default: 0.05)" },
+            },
+            required: ["memory_id"],
+        },
+    },
+    // ==========================================================================
+    // Working Memory (3)
+    // ==========================================================================
+    {
+        name: "working_memory_get",
+        description: `Get working memory for a context (agent, universe, or organization).
+
+CRITICAL: Always call this at the START of any task to load current state.
+Working memory contains the agent's current role, responsibilities, and task state.
+
+Context ID formats:
+- agent:{uuid} - Agent's working memory
+- universe:{uuid} - Universe's working memory
+- organization:{uuid} - Organization's working memory`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                context_id: {
+                    type: "string",
+                    description: "Context ID (e.g., 'agent:aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa')",
+                },
+            },
+            required: ["context_id"],
+        },
+    },
+    {
+        name: "working_memory_add",
+        description: `Add or update working memory for a context.
+
+Use this to save current state during and after tasks.
+Limited to 7 items per context (Miller's Law). Oldest items auto-evict.
+Default TTL: 30 minutes.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                context_id: {
+                    type: "string",
+                    description: "Context ID (e.g., 'agent:uuid', 'project:uuid')",
+                },
+                content: {
+                    type: "string",
+                    description: "Current state/task description to remember",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Optional agent UUID",
+                },
+                ttl_seconds: {
+                    type: "integer",
+                    description: "TTL in seconds (default: 1800 = 30min, max: 7200 = 2h)",
+                },
+            },
+            required: ["context_id", "content"],
+        },
+    },
+    {
+        name: "working_memory_clear",
+        description: "Clear all working memory for a context. Use with caution.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                context_id: {
+                    type: "string",
+                    description: "Context ID to clear",
+                },
+            },
+            required: ["context_id"],
+        },
+    },
+    // ==========================================================================
+    // Session (5)
+    // ==========================================================================
+    {
+        name: "session_start",
+        description: `Start a memory session.
+
+Loads agent rules and memories, creates session tracking.
+Streams from this point are linked to the session.
+Memories generated from streams are NOT linked to the session.
+
+For subagent inheritance, pass the parent's session_id as parent_session_id.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "Agent UUID for this session",
+                },
+                parent_session_id: {
+                    type: "string",
+                    description: "Parent session ID for subagent inheritance. "
+                        + "When a subagent is invoked, pass the parent's session_id here.",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "session_end",
+        description: `End an active memory session.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Session ID to end",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
+    {
+        name: "session_context",
+        description: `Get combined working + long-term memory context for a session.
+
+Retrieves:
+1. Recent items from working memory (session-specific)
+2. Relevant long-term memories using RAG (enhanced with session context)
+3. Extracted topics from the session
+
+The query is enhanced with session topics to improve retrieval relevance.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Session identifier" },
+                query: { type: "string", description: "Current query to contextualize" },
+                agent_id: { type: "string", description: "Optional agent UUID" },
+                max_working_memory: { type: "integer", description: "Max working memory items (default: 5)" },
+                max_long_term: { type: "integer", description: "Max long-term memories (default: 10)" },
+                include_topics: { type: "boolean", description: "Include extracted topics (default: true)" },
+            },
+            required: ["session_id", "query"],
+        },
+    },
+    {
+        name: "session_summary",
+        description: `Get a summary of the current session.
+
+Returns main topics, item count, and recent items for the session.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Session identifier" },
+            },
+            required: ["session_id"],
+        },
+    },
+    {
+        name: "session_clear",
+        description: `Clear all working memory for a session.
+
+Removes all temporary items from the session's working memory.
+Long-term memories are not affected.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Session identifier" },
+            },
+            required: ["session_id"],
+        },
+    },
+    // ==========================================================================
+    // Stream (4)
+    // ==========================================================================
+    {
+        name: "stream_capture",
+        description: `Capture interaction to memory stream for learning.
+
+Use this to record important inputs, outputs, decisions, or learnings.
+The memory stream is processed periodically and important items
+are promoted to long-term memory.
+
+Directions:
+- input: User/external input
+- output: Agent response/action
+- internal: Internal thought/decision`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Session identifier for grouping related captures",
+                },
+                content: {
+                    type: "string",
+                    description: "Content to capture",
+                },
+                direction: {
+                    type: "string",
+                    enum: ["input", "output", "internal"],
+                    description: "Direction of the content",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Optional agent UUID",
+                },
+                importance: {
+                    type: "number",
+                    description: "Importance score 0-1 (default: 0.5)",
+                },
+            },
+            required: ["session_id", "content", "direction"],
+        },
+    },
+    {
+        name: "stream_get_session",
+        description: `Get all stream items from a specific session.
+
+Returns the captured inputs, outputs, and internal thoughts
+for the specified session.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Session ID to retrieve (required)" },
+                limit: { type: "integer", description: "Maximum items to return (default: 100, max: 500)" },
+            },
+            required: ["session_id"],
+        },
+    },
+    {
+        name: "stream_get_recent",
+        description: `Get recent stream items.
+
+Returns the most recent items captured to the memory stream,
+optionally filtered by agent.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Filter by agent UUID" },
+                limit: { type: "integer", description: "Maximum items to return (default: 50, max: 500)" },
+                include_forgotten: { type: "boolean", description: "Include forgotten items (default: false)" },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "stream_process",
+        description: `Process unprocessed stream items.
+
+- Calculates true importance based on content analysis
+- Promotes items with importance >= 0.6 to permanent memories
+- Marks all processed items as processed
+
+Call this periodically or during sleep cycles to convert
+stream items into permanent memories.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                batch_size: { type: "integer", description: "Number of items to process (default: 100, max: 1000)" },
+            },
+            required: [],
+        },
+    },
+    // ==========================================================================
+    // Context (2)
+    // ==========================================================================
+    {
+        name: "memory_get_context",
+        description: `Get relevant context for a task.
+
+Use this at the start of a task to retrieve relevant memories
+that can help with the task. Returns a formatted context prompt.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent",
+                },
+                task_description: {
+                    type: "string",
+                    description: "Description of the task",
+                },
+                max_tokens: {
+                    type: "integer",
+                    description: "Maximum tokens in context (default: 2000)",
+                },
+            },
+            required: ["agent_id", "task_description"],
+        },
+    },
+    {
+        name: "search_with_attention",
+        description: `Search memories with task-specific attention (Selective Attention).
+
+Weights memory types based on task type for better results.
+E.g., debug tasks prioritize episodic memories.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                query_text: { type: "string", description: "Search query text" },
+                agent_id: { type: "string", description: "Optional agent UUID filter" },
+                user_id: { type: "string", description: "Optional user identifier filter (auto-injected from logged-in user if not provided)" },
+                task_type: { type: "string", description: "Task type (deploy, debug, documentation, implementation, review)" },
+                limit: { type: "integer", description: "Maximum results (default: 10)" },
+            },
+            required: ["query_text"],
+        },
+    },
+    // ==========================================================================
+    // User (2)
+    // ==========================================================================
+    {
+        name: "user_register",
+        description: `Register a new user and create an organization.
+
+Creates a Keycloak user, provisions a tenant database, and returns auth tokens.
+After successful registration, the user is automatically logged in.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                email: { type: "string", description: "User email address" },
+                password: { type: "string", description: "User password (min 8 chars)" },
+                first_name: { type: "string", description: "First name" },
+                last_name: { type: "string", description: "Last name" },
+                org_name: { type: "string", description: "Organization name" },
+                org_slug: { type: "string", description: "Organization slug (lowercase, alphanumeric, hyphens)" },
+            },
+            required: ["email", "password", "first_name", "last_name", "org_name", "org_slug"],
+        },
+    },
+    {
+        name: "user_get_context",
+        description: `Get combined user context for current logged-in user.
+
+Use this to retrieve context that combines:
+- User's personal memories and preferences
+- Relevant task context
+
+Returns formatted context ready for use.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_description: {
+                    type: "string",
+                    description: "Optional task description for context filtering",
+                },
+                user_email: {
+                    type: "string",
+                    description: "User email (from previous login)",
+                },
+            },
+            required: [],
+        },
+    },
+    // ==========================================================================
+    // Maintenance (2)
+    // ==========================================================================
+    {
+        name: "heartbeat_tick",
+        description: `Tick the heartbeat and trigger scheduled maintenance routines.
+
+Call this on every user interaction or periodically. It will automatically
+trigger maintenance routines based on configured intervals:
+- Every 5 ticks: Working memory check
+- Every 10 ticks: Stream capture
+- Every 20 ticks: Mini-sleep (light maintenance)
+- Every 50 ticks: Normal sleep (full maintenance)
+- Daily: Deep sleep (all phases)
+- Weekly: Full meta-cognition
+
+Returns the current interaction count and any actions that were triggered.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Optional agent UUID" },
+                context_id: { type: "string", description: "Optional context ID for working memory (e.g., 'agent:uuid')" },
+                session_id: { type: "string", description: "Optional session ID for stream capture" },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "sleep_run",
+        description: `Run a sleep cycle (Sleep Meta-Evaluation).
+
+Executes memory maintenance phases:
+1. evaluation - Assess memory quality
+2. forgetting - Detect and resolve conflicts
+3. consolidation - Create hierarchical summaries
+4. relevance - Adjust dynamic relevance`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                phases: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Phases to run (default: all)",
+                },
+            },
+            required: [],
+        },
+    },
+    // ==========================================================================
+    // Consolidation (3)
+    // ==========================================================================
+    {
+        name: "consolidation_detect_conflicts",
+        description: `Detect conflicting memories (Active Forgetting).
+
+Finds memories that may contain contradictory information.
+Useful for maintaining consistency in the knowledge base.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                similarity_threshold: { type: "number", description: "Similarity threshold 0-1 (default: 0.9)" },
+                limit: { type: "integer", description: "Maximum results (default: 50)" },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "consolidation_resolve_conflict",
+        description: `Resolve a conflict between two memories (Active Forgetting).
+
+When two memories contain contradictory information, use this to:
+- Keep one memory as the authoritative source
+- Mark the other as superseded
+- Document the resolution reason
+
+The superseded memory will be marked as obsolete.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                keep_id: { type: "string", description: "UUID of the memory to keep as current" },
+                supersede_id: { type: "string", description: "UUID of the memory to mark as superseded" },
+                resolution_note: { type: "string", description: "Explanation of why this resolution was chosen (required)" },
+            },
+            required: ["keep_id", "supersede_id", "resolution_note"],
+        },
+    },
+    {
+        name: "consolidation_detect_redundant",
+        description: `Detect redundant memories (Active Forgetting).
+
+Finds near-duplicate memories that could be consolidated.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                similarity_threshold: { type: "number", description: "Similarity threshold 0-1 (default: 0.95)" },
+                limit: { type: "integer", description: "Maximum results (default: 50)" },
+            },
+            required: [],
+        },
+    },
+    // ==========================================================================
+    // Hierarchy (2)
+    // ==========================================================================
+    {
+        name: "hierarchy_consolidate",
+        description: `Consolidate multiple memories into a summary (Hierarchical Memory).
+
+Takes a list of related memories (minimum 2) and creates a higher-level summary.
+Useful for creating abstract knowledge from detailed experiences.
+If summary_content is not provided, it will be auto-generated.
+
+Levels: raw -> chunk -> summary -> abstract`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "UUIDs of memories to consolidate (minimum 2)",
+                },
+                summary_content: { type: "string", description: "Custom summary content (optional, auto-generated if not provided)" },
+                agent_id: { type: "string", description: "Agent UUID for the new memory (inherits from first memory if not specified)" },
+            },
+            required: ["memory_ids"],
+        },
+    },
+    {
+        name: "hierarchy_get_tree",
+        description: `Get the hierarchy tree for a memory (Hierarchical Memory).
+
+Returns the memory and all its related memories in the hierarchy:
+- Parent memories (if this is derived from others)
+- Child memories (if this was used to create others)`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: { type: "string", description: "UUID of the memory" },
+            },
+            required: ["memory_id"],
+        },
+    },
+    // ==========================================================================
+    // Agent CRUD (5)
+    // ==========================================================================
+    {
+        name: "agent_create",
+        description: `Create a new agent in the organization.
+
+An agent is an AI entity with a persona, optional universe membership,
+and optional team assignment.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Name of the agent (required)" },
+                template_id: { type: "string", description: "Optional template ID to base the agent on" },
+                universe_id: { type: "string", description: "Optional universe ID to assign the agent to" },
+                persona: { type: "object", description: "Optional persona configuration (personality, instructions, greeting, etc.)" },
+                team_id: { type: "string", description: "Optional team ID to assign the agent to" },
+                is_team_lead: { type: "boolean", description: "Whether this agent is a team lead (default: false)" },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "agent_list",
+        description: `List all agents in the organization.
+
+Returns agent name, ID, status, and universe assignment.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                org_id: { type: "string", description: "Optional organization ID filter" },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "agent_get",
+        description: `Get detailed information about a specific agent.
+
+Returns full agent data including persona, status, and configuration.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "UUID of the agent to retrieve" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "agent_update",
+        description: `Update an agent's persona and configuration.
+
+Allows updating personality, instructions, greeting, forbidden topics,
+language, specialization, and name.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "UUID of the agent to update" },
+                name: { type: "string", description: "New agent name" },
+                personality: { type: "string", description: "Agent personality description" },
+                instructions: { type: "string", description: "Agent system instructions" },
+                greeting: { type: "string", description: "Agent greeting message" },
+                forbidden_topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of topics the agent should not discuss",
+                },
+                language: { type: "string", description: "Agent's primary language (e.g., 'pt-BR', 'en')" },
+                specialization: { type: "string", description: "Agent's area of specialization" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "agent_delete",
+        description: `Delete an agent permanently.
+
+Use with caution - this removes the agent and its configuration.
+Memories created by the agent are NOT deleted.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "UUID of the agent to delete" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "agent_bootstrap",
+        description: `Bootstrap completo do agente — chame no início da sessão para carregar identidade, system prompt e contexto runtime. O agente thin-client chama isto como regra única de boot.
+
+Retorna identity, system_prompt, runtime (working_memory, recent_memories, skills, delegate_targets) e persona_version em uma única chamada.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "UUID of the agent to bootstrap (required)" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "agent_reorient",
+        description: `Re-fundamentação compacta (heartbeat de reorientação). Chame a cada N alterações ou ao saturar o contexto para o agente se re-orientar sem recarregar tudo.
+
+Retorna identity, working_memory, active_task, relevant_memories, recent_high_importance, persona_version e config. Opcionalmente filtra por um foco específico.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "UUID of the agent to reorient (required)" },
+                focus: { type: "string", description: "Optional focus/topic to bias the reorientation toward" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    // ==========================================================================
+    // Universe CRUD (3)
+    // ==========================================================================
+    {
+        name: "universe_create",
+        description: `Create a universe within the organization.
+
+A universe is an isolated knowledge domain (e.g., Security, Operations).
+Agents can be assigned to universes for scoped memory access.
+The org_id is auto-resolved from your API key.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Universe display name" },
+                slug: { type: "string", description: "Universe slug (lowercase, alphanumeric, hyphens)" },
+                description: { type: "string", description: "Optional description of the universe" },
+            },
+            required: ["name", "slug"],
+        },
+    },
+    {
+        name: "universe_list",
+        description: `List all universes in the organization.
+
+Returns universe name, slug, ID, and description.
+The org_id is auto-resolved from your API key.`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "universe_update",
+        description: `Update a universe's name or description.
+
+The org_id is auto-resolved from your API key.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                universe_id: { type: "string", description: "UUID of the universe to update" },
+                name: { type: "string", description: "New universe name" },
+                description: { type: "string", description: "New universe description" },
+            },
+            required: ["universe_id"],
+        },
+    },
+    {
+        name: "universe_delete",
+        description: `Delete a universe and all its contents (concepts, themes, topics, points).
+
+WARNING: This is destructive and cannot be undone.
+The org_id is auto-resolved from your API key.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                universe_id: { type: "string", description: "UUID of the universe to delete" },
+            },
+            required: ["universe_id"],
+        },
+    },
+    // ==========================================================================
+    // Knowledge Graph - Concepts (4)
+    // ==========================================================================
+    {
+        name: "concept_create",
+        description: `Create a concept within a universe (L0 - knowledge body).
+
+A concept is the top-level node in the knowledge hierarchy:
+Concept > Theme > Topic > Point.
+
+Each concept belongs to a universe and represents a major knowledge domain.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Concept name" },
+                universe_id: { type: "string", description: "UUID of the universe this concept belongs to" },
+                description: { type: "string", description: "Optional description" },
+            },
+            required: ["name", "universe_id"],
+        },
+    },
+    {
+        name: "concept_list",
+        description: `List all concepts for a universe.
+
+Returns the L0 nodes of the knowledge hierarchy within a universe.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                universe_id: { type: "string", description: "UUID of the universe" },
+            },
+            required: ["universe_id"],
+        },
+    },
+    {
+        name: "concept_update",
+        description: `Update a concept's name or description.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept_id: { type: "string", description: "UUID of the concept to update" },
+                name: { type: "string", description: "New concept name" },
+                description: { type: "string", description: "New concept description" },
+            },
+            required: ["concept_id"],
+        },
+    },
+    {
+        name: "concept_delete",
+        description: `Delete a concept and all its children (themes, topics, points).
+
+Use with caution - this cascades to all child nodes.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept_id: { type: "string", description: "UUID of the concept to delete" },
+            },
+            required: ["concept_id"],
+        },
+    },
+    // ==========================================================================
+    // Knowledge Graph - Themes (4)
+    // ==========================================================================
+    {
+        name: "theme_create",
+        description: `Create a theme within a concept (L1 - thematic division).
+
+A theme groups related topics under a concept:
+Concept > Theme > Topic > Point.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Theme name" },
+                concept_id: { type: "string", description: "UUID of the parent concept" },
+                description: { type: "string", description: "Optional description" },
+            },
+            required: ["name", "concept_id"],
+        },
+    },
+    {
+        name: "theme_list",
+        description: `List all themes for a concept.
+
+Returns the L1 nodes under a specific concept.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept_id: { type: "string", description: "UUID of the parent concept" },
+            },
+            required: ["concept_id"],
+        },
+    },
+    {
+        name: "theme_update",
+        description: `Update a theme's name or description.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                theme_id: { type: "string", description: "UUID of the theme to update" },
+                name: { type: "string", description: "New theme name" },
+                description: { type: "string", description: "New theme description" },
+            },
+            required: ["theme_id"],
+        },
+    },
+    {
+        name: "theme_delete",
+        description: `Delete a theme and all its children (topics, points).
+
+Use with caution - this cascades to all child nodes.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                theme_id: { type: "string", description: "UUID of the theme to delete" },
+            },
+            required: ["theme_id"],
+        },
+    },
+    // ==========================================================================
+    // Knowledge Graph - Topics (4)
+    // ==========================================================================
+    {
+        name: "topic_create",
+        description: `Create a topic within a theme (L2 - work unit).
+
+A topic is a specific subject area that can be tracked:
+Concept > Theme > Topic > Point.
+
+Status: pending | in_progress | completed.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Topic name" },
+                theme_id: { type: "string", description: "UUID of the parent theme" },
+                description: { type: "string", description: "Optional description" },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed"],
+                    description: "Topic status (default: pending)",
+                },
+            },
+            required: ["name", "theme_id"],
+        },
+    },
+    {
+        name: "topic_list",
+        description: `List all topics for a theme.
+
+Returns the L2 nodes under a specific theme with their status.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                theme_id: { type: "string", description: "UUID of the parent theme" },
+            },
+            required: ["theme_id"],
+        },
+    },
+    {
+        name: "topic_update",
+        description: `Update a topic's name, description, or status.
+
+When status is provided alongside other fields, both the metadata
+and status are updated. Status: pending | in_progress | completed.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic_id: { type: "string", description: "UUID of the topic to update" },
+                name: { type: "string", description: "New topic name" },
+                description: { type: "string", description: "New topic description" },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed"],
+                    description: "New topic status",
+                },
+            },
+            required: ["topic_id"],
+        },
+    },
+    {
+        name: "topic_delete",
+        description: `Delete a topic and all its children (points).
+
+Use with caution - this cascades to all child points.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic_id: { type: "string", description: "UUID of the topic to delete" },
+            },
+            required: ["topic_id"],
+        },
+    },
+    // ==========================================================================
+    // Knowledge Graph - Points (4)
+    // ==========================================================================
+    {
+        name: "point_create",
+        description: `Create a point within a topic (L3 - atomic knowledge unit).
+
+A point is the leaf node in the knowledge hierarchy:
+Concept > Theme > Topic > Point.
+
+Points represent individual facts, procedures, or learnings.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Point name" },
+                topic_id: { type: "string", description: "UUID of the parent topic" },
+                description: { type: "string", description: "Optional short description" },
+                status: { type: "string", description: "Optional status (e.g., pending, completed)" },
+            },
+            required: ["name", "topic_id"],
+        },
+    },
+    {
+        name: "point_list",
+        description: `List all points for a topic.
+
+Returns the L3 leaf nodes under a specific topic.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic_id: { type: "string", description: "UUID of the parent topic" },
+            },
+            required: ["topic_id"],
+        },
+    },
+    {
+        name: "point_update",
+        description: `Update a point's name, description, content, or status.
+
+When status is provided alongside other fields, both the metadata
+and status are updated.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                point_id: { type: "string", description: "UUID of the point to update" },
+                name: { type: "string", description: "New point name" },
+                description: { type: "string", description: "New point description" },
+                content: { type: "string", description: "New point content (detailed knowledge)" },
+                status: { type: "string", description: "New point status" },
+            },
+            required: ["point_id"],
+        },
+    },
+    {
+        name: "point_delete",
+        description: `Delete a point permanently.
+
+This removes the leaf node from the knowledge hierarchy.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                point_id: { type: "string", description: "UUID of the point to delete" },
+            },
+            required: ["point_id"],
+        },
+    },
+    // ==========================================================================
+    // Knowledge Hierarchy (1)
+    // ==========================================================================
+    {
+        name: "universe_hierarchy",
+        description: `Get the full knowledge hierarchy tree for a universe.
+
+Returns a tree structure: Concepts > Themes > Topics > Points.
+Useful for understanding the complete knowledge structure of a universe.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                universe_id: { type: "string", description: "UUID of the universe" },
+            },
+            required: ["universe_id"],
+        },
+    },
+    // ==========================================================================
+    // Training (6)
+    // ==========================================================================
+    {
+        name: "training_teach",
+        description: `Teach a fact or procedure to the memory system.
+
+Use this to directly teach the system new knowledge.
+Creates a permanent memory of the specified type.
+
+Types:
+- semantic: Facts, knowledge, definitions
+- procedural: How-to, step-by-step instructions`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                content: {
+                    type: "string",
+                    description: "The fact or procedure to teach (min 10 chars)",
+                },
+                type: {
+                    type: "string",
+                    enum: ["semantic", "procedural"],
+                    description: "Memory type (default: semantic)",
+                },
+                importance: {
+                    type: "number",
+                    description: "Importance score 0-1 (default: 0.7)",
+                },
+                universe_id: {
+                    type: "string",
+                    description: "Optional universe UUID for scoped access",
+                },
+            },
+            required: ["content"],
+        },
+    },
+    {
+        name: "training_qa",
+        description: `Train with question-answer pairs.
+
+Provide Q&A pairs to improve FAQ-style responses.
+Each pair becomes a high-value semantic memory optimized for question matching.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                pairs: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            question: { type: "string", description: "The question" },
+                            answer: { type: "string", description: "The answer" },
+                        },
+                        required: ["question", "answer"],
+                    },
+                    description: "Array of Q&A pairs (min 1, max 100)",
+                },
+                importance: {
+                    type: "number",
+                    description: "Importance score 0-1 (default: 0.8)",
+                },
+                universe_id: {
+                    type: "string",
+                    description: "Optional universe UUID for scoped access",
+                },
+            },
+            required: ["pairs"],
+        },
+    },
+    {
+        name: "training_stats",
+        description: `Get training statistics.
+
+Returns memory counts by type, layer, recent daily activity,
+and counts of gaps and conflicts. Useful for monitoring training progress.`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "training_gaps",
+        description: `Identify training coverage gaps.
+
+Analyzes existing memories and suggests areas that need more training:
+- Missing procedural knowledge
+- Missing Q&A pairs
+- Low factual coverage
+- Low overall training volume`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "training_recent",
+        description: `Get recently created training memories.
+
+Returns the most recent memories ordered by creation date.
+Useful for reviewing what was recently taught or uploaded.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum results (default: 20, max: 100)",
+                },
+            },
+            required: [],
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Agent Invocation
+    // -------------------------------------------------------------------------
+    {
+        name: "agent_invoke",
+        description: `Invoke an agent to execute a task and return the result.
+
+Calls an agent by ID or name, waits for completion, and returns the full response.
+Use this for programmatic agent orchestration when you need a specialist's output.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent to invoke (use this OR agent_name)",
+                },
+                agent_name: {
+                    type: "string",
+                    description: "Name of the agent to invoke (use this OR agent_id)",
+                },
+                message: {
+                    type: "string",
+                    description: "The task/question for the agent",
+                },
+                context: {
+                    type: "object",
+                    description: "Optional context/data for the agent",
+                },
+                timeout_seconds: {
+                    type: "integer",
+                    description: "Timeout in seconds (default: 120, max: 600)",
+                },
+            },
+            required: ["message"],
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Task Management (4 tools)
+    // -------------------------------------------------------------------------
+    {
+        name: "task_create",
+        description: `Create a tracked task for delegated work.
+
+Use this when assigning work to another agent or breaking down complex operations
+into subtasks. Returns the task ID for tracking progress.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Short title describing the task",
+                },
+                description: {
+                    type: "string",
+                    description: "Detailed description of what needs to be done",
+                },
+                assigned_agent_id: {
+                    type: "string",
+                    description: "UUID of the agent to assign this task to",
+                },
+                parent_task_id: {
+                    type: "string",
+                    description: "UUID of parent task (for creating subtasks)",
+                },
+                priority: {
+                    type: "integer",
+                    description: "Priority 1-10 (default 5). Higher = more urgent",
+                },
+                input_data: {
+                    type: "object",
+                    description: "Input data/context for the task",
+                },
+            },
+            required: ["title"],
+        },
+    },
+    {
+        name: "task_get",
+        description: `Get details of a specific task by ID.
+
+Returns full task information including status, output, timestamps, and metadata.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "UUID of the task to retrieve",
+                },
+            },
+            required: ["task_id"],
+        },
+    },
+    {
+        name: "task_list",
+        description: `List tasks with optional filters.
+
+Can filter by status, assigned agent, or parent task. Returns paginated results
+ordered by creation date (newest first).`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["pending", "assigned", "running", "completed", "failed", "cancelled"],
+                    description: "Filter by task status",
+                },
+                assigned_agent_id: {
+                    type: "string",
+                    description: "Filter by assigned agent UUID",
+                },
+                parent_task_id: {
+                    type: "string",
+                    description: "Filter by parent task UUID (get subtasks)",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Max results (default: 50, max: 200)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "task_update",
+        description: `Update a task's status, output, or error message.
+
+Use this to report progress (status='running'), submit results (status='completed'
+with output_data), or report failures (status='failed' with error_message).`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "UUID of the task to update",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "assigned", "running", "completed", "failed", "cancelled"],
+                    description: "New status for the task",
+                },
+                output_data: {
+                    type: "object",
+                    description: "Output/result data from task execution",
+                },
+                error_message: {
+                    type: "string",
+                    description: "Error message if task failed",
+                },
+            },
+            required: ["task_id"],
+        },
+    },
+    // ---------------------------------------------------------------------------
+    // Skills
+    // ---------------------------------------------------------------------------
+    {
+        name: "skill_list",
+        description: `List available skills in the organization.
+
+Returns skills with their schemas, categories, and integration requirements.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Filter by skill category (e.g., 'communication', 'development')",
+                },
+            },
+        },
+    },
+    {
+        name: "skill_agent_list",
+        description: `List skills assigned to a specific agent.
+
+Returns the agent's assigned skills with permission levels.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "skill_assign",
+        description: `Assign a skill to an agent.
+
+Gives an agent the ability to use a specific skill.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent",
+                },
+                skill_id: {
+                    type: "string",
+                    description: "UUID of the skill to assign",
+                },
+                permission: {
+                    type: "string",
+                    enum: ["execute", "manage"],
+                    description: "Permission level (default: execute)",
+                },
+            },
+            required: ["agent_id", "skill_id"],
+        },
+    },
+    {
+        name: "skill_remove",
+        description: `Remove a skill from an agent.
+
+Revokes the agent's ability to use a specific skill.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "UUID of the agent",
+                },
+                skill_id: {
+                    type: "string",
+                    description: "UUID of the skill to remove",
+                },
+            },
+            required: ["agent_id", "skill_id"],
+        },
+    },
+    // ==========================================================================
+    // Credential Vault (4)
+    // ==========================================================================
+    {
+        name: "credential_store",
+        description: `Store an encrypted credential in the vault.
+
+Credentials are encrypted at rest with AES-256-GCM using per-org derived keys.
+Use this to securely store API keys, tokens, passwords, or connection strings
+for third-party integrations (JIRA, databases, APIs, etc.).
+
+The 'ref' is a unique identifier for this credential (e.g., 'jira_muza',
+'mysql_centerpag'). Use the same ref in memory_store's credential_ref field
+to link a memory to this credential.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: {
+                    type: "string",
+                    description: "Unique credential reference (e.g., 'jira_muza', 'mysql_centerpag', 'elastic_prod')",
+                },
+                data: {
+                    type: "object",
+                    description: "Secret credential data to encrypt (e.g., { api_key: '...', email: '...', base_url: '...' })",
+                },
+                metadata: {
+                    type: "object",
+                    description: "Optional non-secret metadata (e.g., { type: 'api_key', provider: 'atlassian' })",
+                },
+            },
+            required: ["ref", "data"],
+        },
+    },
+    {
+        name: "credential_get",
+        description: `Retrieve a decrypted credential from the vault.
+
+Returns the decrypted credential data for the given reference.
+Only the credential owner (authenticated user) can access their credentials.
+
+Use this when a memory has a credential_ref and you need the actual
+credentials to perform an action (e.g., connect to a database, call an API).`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: {
+                    type: "string",
+                    description: "Credential reference to retrieve (e.g., 'jira_muza')",
+                },
+            },
+            required: ["ref"],
+        },
+    },
+    {
+        name: "credential_list",
+        description: `List all stored credentials for the current user.
+
+Returns credential metadata (ref, type, created_at) without any secret data.
+Use this to see what integrations have stored credentials.`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "credential_delete",
+        description: `Delete a stored credential from the vault.
+
+Permanently removes the encrypted credential for the given reference.
+This cannot be undone.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: {
+                    type: "string",
+                    description: "Credential reference to delete (e.g., 'jira_muza')",
+                },
+            },
+            required: ["ref"],
+        },
+    },
+];