@kynver-app/mcp-agent-os 0.2.1 → 0.2.2

package/README.md

@@ -30,6 +30,10 @@ Schemas are mirrored in `lib/mcp/tool-manifests/kynver-mcp-agent-os.json` in
 the Kynver repo (used as the static fallback when stdio spawn isn't available
 — e.g. on Vercel).
 
+Memory write/update tools accept `sourceRefs` for structured provenance. Use it
+to attach repo paths, commits, PRs, map files, sessions, tools, or URLs to
+important memories instead of burying those pointers in freeform text.
+
 ## Env
 
 | Var | Purpose |

package/dist/server.js

@@ -17,7 +17,7 @@ function jsonResult(data) {
 }
 const MCP_LEGACY_SLUG_FALLBACK = "ghost";
 export function createAgentOsServer() {
-    const server = new McpServer({ name: "kynver-mcp-agent-os", version: "0.2.1" }, { capabilities: { tools: {} } });
+    const server = new McpServer({ name: "kynver-mcp-agent-os", version: "0.2.2" }, { capabilities: { tools: {} } });
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     function register(name, description, inputSchema, cb) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -55,6 +55,23 @@ export function createAgentOsServer() {
         return MCP_LEGACY_SLUG_FALLBACK;
     }
     const slugField = z.string().optional().describe("AgentOS slug within your account. Omit to use env or server-discovered primary (GET /api/agent-os). Legacy: `ghost`.");
+    const sourceRefSchema = z
+        .object({
+        type: z
+            .enum(["repo", "commit", "branch", "pr", "map", "session", "tool", "url", "manual", "unknown"])
+            .describe("What kind of source backs this memory."),
+        label: z.string().optional(),
+        repo: z.string().optional(),
+        path: z.string().optional(),
+        commit: z.string().optional(),
+        branch: z.string().optional(),
+        pr: z.union([z.number(), z.string()]).optional(),
+        url: z.string().optional(),
+        sessionId: z.string().optional(),
+        toolName: z.string().optional(),
+        note: z.string().optional(),
+    })
+        .passthrough();
     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: slugField }, async (args) => {
         const s = await resolveToolSlug(args.slug);
         return jsonResult(await get(`/agent-os/${s}/stats`));
@@ -190,6 +207,7 @@ export function createAgentOsServer() {
             .describe("Memory category. Mapped to sourceId: long_term/contact/tool_config -> 'agent:long-term', project -> 'agent:project'. Ignored if sourceId is set."),
         sourceId: z.string().optional().describe("Advanced: override the sourceId tag directly. If set, category is ignored."),
         metadata: z.record(z.string(), z.unknown()).optional(),
+        sourceRefs: z.array(sourceRefSchema).optional().describe("Structured provenance references for this memory, such as repo/path/commit/PR/map/session."),
         slug: slugField,
     }, async (args) => {
         const categoryToSourceId = {
@@ -206,6 +224,8 @@ export function createAgentOsServer() {
             body.sourceId = sourceId;
         if (args.metadata)
             body.metadata = args.metadata;
+        if (args.sourceRefs)
+            body.sourceRefs = args.sourceRefs;
         const s = await resolveToolSlug(args.slug);
         return jsonResult(await post(`/agent-os/${s}/memory`, body));
     });
@@ -262,14 +282,17 @@ export function createAgentOsServer() {
         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(),
+        sourceRefs: z.array(sourceRefSchema).optional().describe("Structured provenance references for this replacement memory."),
         slug: slugField,
     }, async (args) => {
-        const { key, slug, content, sourceId, metadata } = args;
+        const { key, slug, content, sourceId, metadata, sourceRefs } = args;
         const body = { content, slug: key };
         if (sourceId)
             body.sourceId = sourceId;
         if (metadata)
             body.metadata = metadata;
+        if (sourceRefs)
+            body.sourceRefs = sourceRefs;
         const s = await resolveToolSlug(slug);
         return jsonResult(await post(`/agent-os/${s}/memory`, body));
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {