@kynver-app/mcp-agent-os 0.3.62 → 0.3.63

package/dist/tools/graph.d.ts

@@ -5,6 +5,9 @@
  * returns server-computed insights (bottlenecks, per-owner load, orphans) over
  * the operational graph. Read-only; the Kynver route enforces session +
  * workspace scope. Kept in its own module so server.ts stays slim.
+ *
+ * agent_os_memory_graph_expand (PR10) proxies scoped memory-entity neighborhood
+ * expansion through the authenticated app route — handles/previews only.
  */
 type ToolResult = {
     content: {

package/dist/tools/graph.js

@@ -5,6 +5,9 @@
  * returns server-computed insights (bottlenecks, per-owner load, orphans) over
  * the operational graph. Read-only; the Kynver route enforces session +
  * workspace scope. Kept in its own module so server.ts stays slim.
+ *
+ * agent_os_memory_graph_expand (PR10) proxies scoped memory-entity neighborhood
+ * expansion through the authenticated app route — handles/previews only.
  */
 import { z } from "zod";
 import { get, post } from "../lib/kynver-client.js";
@@ -110,4 +113,33 @@ export function registerGraphTools({ register, resolveToolSlug, jsonResult }) {
             source: "agent",
         }));
     });
+    register("agent_os_memory_graph_expand", [
+        "Expand a scoped memory-entity graph neighborhood from an opaque start handle.",
+        "Returns compact previews and expansion handles only — never raw entity IDs or full memory bodies.",
+        "Requires graph view + expansion security gates (scoped opt-in). Read-only.",
+    ].join(" "), {
+        slug: z.string().optional().describe("AgentOS slug. Defaults to env/primary."),
+        startEntityHandle: z
+            .string()
+            .describe("Opaque graph entity handle (gent:…) issued by the server."),
+        grantToken: z
+            .string()
+            .describe("Signed expansion grant (kve:g:…) bound to this graph handle and envelope."),
+        purpose: z.string().describe("Why expansion is requested (audit-bound)."),
+        envelopeId: z.string().describe("Active context envelope id binding this expansion."),
+        asOf: z.string().optional().describe("Optional UTC ISO as-of instant for temporal filtering."),
+        maxDepth: z.number().int().min(1).max(2).optional(),
+        maxNodes: z.number().int().min(1).max(36).optional(),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        return jsonResult(await post(`/agent-os/${slug}/memory-graph/expand`, {
+            startEntityHandle: args.startEntityHandle,
+            grantToken: args.grantToken,
+            purpose: args.purpose,
+            envelopeId: args.envelopeId,
+            asOf: args.asOf,
+            maxDepth: args.maxDepth,
+            maxNodes: args.maxNodes,
+        }));
+    });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.62",
-  "description": "Kynver Agentic OS MCP server \u2014 slug-keyed agent identity, goals, projects, sessions, and long-term memory",
+  "version": "0.3.63",
+  "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"