@kynver-app/mcp-agent-os 0.1.0 → 0.2.0

package/dist/server.js

@@ -38,7 +38,7 @@ export function createAgentOsServer() {
     const defaultAgentOsSlug = () => process.env.KYNVER_AGENT_OS_SLUG?.trim() || "ghost";
     const osSlug = (s) => (s && s.trim()) || defaultAgentOsSlug();
     register("agent_os_get_context", "Get the agent's full Agentic-OS state in one call: identity, open goals, active projects with current focus/next-actions/blockers, recent sessions, contacts, and long-term memory stats. Use at session start instead of reading SOUL.md / USER.md / MEMORY.md.", { slug: z.string().optional().describe("AgentOS slug. Defaults to KYNVER_AGENT_OS_SLUG, then 'ghost'.") }, async (args) => jsonResult(await get(`/agent-os/${osSlug(args.slug)}/stats`)));
-    register("agent_os_open_session", "Mark the start of a session. Returns the session id — pass it to agent_os_close_session at the end.", {
+    register("agent_os_open_session", "Call this at the START of every session. Records channel, model, and opens a session record for continuity. Ghost calls this immediately after agent_os_get_context on startup.", {
         channel: z.string().describe("Runtime channel: 'webchat' | 'telegram' | 'discord' | …"),
         model: z.string().optional().describe("Model used for the session (default 'claude-sonnet-4-6')."),
         slug: z.string().optional().describe("AgentOS slug. Defaults to KYNVER_AGENT_OS_SLUG, then 'ghost'."),
@@ -46,7 +46,7 @@ export function createAgentOsServer() {
         const { slug, ...body } = args;
         return jsonResult(await post(`/agent-os/${osSlug(slug)}/sessions`, body));
     });
-    register("agent_os_close_session", "Close a session with an end-of-session summary (2-3 sentences), the topics worked on, and optional decisions log / touched goal & project ids. The summary is ingested into long-term memory.", {
+    register("agent_os_close_session", "Call this at the END of every session with a summary of what was accomplished and key decisions made. This is how Ghost maintains cross-session continuity — without it, the next session has no record of what happened.", {
         sessionId: z.string(),
         summary: z.string(),
         topicsWorked: z.array(z.string()).optional(),
@@ -142,7 +142,7 @@ export function createAgentOsServer() {
         const { projectId, slug, ...body } = args;
         return jsonResult(await patch(`/agent-os/${osSlug(slug)}/projects/${projectId}`, body));
     });
-    register("agent_os_search_memory", "Semantic + keyword hybrid search over the agent's long-term MARM memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md.", {
+    register("agent_os_search_memory", "Semantic + keyword hybrid search over the agent's long-term MARM memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md. Results include rrfScore — a Reciprocal Rank Fusion score where ~0.033 is a near-perfect match. Higher is better; do not treat low numbers as poor results.", {
         query: z.string().describe("Natural language query to search memory."),
         k: z.number().optional().describe("Number of results (default 10, max 50)."),
         slug: z.string().optional(),
@@ -181,5 +181,57 @@ export function createAgentOsServer() {
     });
     register("agent_os_get_contacts", "Get all people the agent knows: their relationship, context, preferences, and notes. Replaces reading USER.md and contact sections of MEMORY.md.", { slug: z.string().optional() }, async (args) => jsonResult(await get(`/agent-os/${osSlug(args.slug)}/contacts`)));
     register("agent_os_consolidate_memory", "Trigger a memory consolidation pass: LLM reviews recent daily logs and distils key decisions, lessons, and facts into long-term MARM memory. Use during heartbeat maintenance instead of manually rewriting MEMORY.md. Rate-limited to 2 runs per agent per day.", { slug: z.string().optional() }, async (args) => jsonResult(await post(`/agent-os/${osSlug(args.slug)}/consolidate`, {})));
+    register("agent_os_create_project", "Create a new project in the agent OS. Use this to add a newly started project to tracking. Returns the created project with its DB id.", {
+        name: z.string().describe("Project name (required)."),
+        description: z.string().optional(),
+        status: z.enum(["active", "on_hold", "shipped", "archived"]).optional().default("active"),
+        currentFocus: z.string().optional().describe("What is being worked on right now."),
+        nextActions: z.array(z.string()).optional().describe("Ordered list of next steps."),
+        blockers: z.array(z.string()).optional(),
+        repoUrl: z.string().optional(),
+        deployUrl: z.string().optional(),
+        slug: z.string().optional(),
+    }, async (args) => {
+        const { slug, ...body } = args;
+        return jsonResult(await post(`/agent-os/${osSlug(slug)}/projects`, body));
+    });
+    register("agent_os_create_contact", "Add a new contact (or upsert by name) to the agent OS. Use when you meet someone new or want to record info about a person.", {
+        name: z.string().describe("Contact name (required)."),
+        relationship: z.string().optional().describe("e.g. owner, collaborator, client, stakeholder"),
+        context: z.string().optional().describe("Background on who they are and what they do."),
+        preferences: z.record(z.string(), z.unknown()).optional().describe("Communication preferences, timezone, style notes, etc."),
+        notes: z.string().optional(),
+        slug: z.string().optional(),
+    }, async (args) => {
+        const { slug, ...body } = args;
+        return jsonResult(await post(`/agent-os/${osSlug(slug)}/contacts`, body));
+    });
+    register("agent_os_update_contact", "Update an existing contact by their DB id. Use agent_os_get_contacts to get the id first.", {
+        contactId: z.string().describe("DB id of the contact to update (from agent_os_get_contacts)."),
+        name: z.string().optional(),
+        relationship: z.string().optional(),
+        context: z.string().optional(),
+        preferences: z.record(z.string(), z.unknown()).optional(),
+        notes: z.string().optional(),
+        slug: z.string().optional(),
+    }, async (args) => {
+        const { contactId, slug, ...body } = args;
+        return jsonResult(await patch(`/agent-os/${osSlug(slug)}/contacts/${contactId}`, body));
+    });
+    register("agent_os_update_memory", "Update an existing memory entry by its key/slug. Use to correct or replace a previously written memory. The key must match the slug used when the memory was written — if key was omitted on write, the auto-generated slug (note-<timestamp>) is returned in the write response.", {
+        key: z.string().describe("The slug/key of the memory to update (from the original agent_os_write_memory call)."),
+        content: z.string().describe("New content to replace the existing memory with."),
+        sourceId: z.string().optional().describe("Override the sourceId tag if needed."),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+        slug: z.string().optional().describe("AgentOS slug. Defaults to KYNVER_AGENT_OS_SLUG, then ghost."),
+    }, async (args) => {
+        const { key, slug, content, sourceId, metadata } = args;
+        const body = { content, slug: key };
+        if (sourceId)
+            body.sourceId = sourceId;
+        if (metadata)
+            body.metadata = metadata;
+        return jsonResult(await post(`/agent-os/${osSlug(slug)}/memory`, body));
+    });
     return server;
 }

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {
     "kynver-mcp-agent-os": "dist/index.js"
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "node --max-old-space-size=8192 ../../node_modules/typescript/bin/tsc",
     "dev": "node --max-old-space-size=8192 ../../node_modules/typescript/bin/tsc --watch",