@kynver-app/mcp-agent-os 0.3.61 → 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/dist/tools/taskflow.js

@@ -22,11 +22,46 @@ const idSchema = {
 export function registerTaskflowTools({ register, resolveToolSlug, jsonResult, }) {
     register("agent_os_taskflow_list", [
         "List Kynver-native managed TaskFlows projected to the openclaw adapter wire shape.",
+        "Defaults: scope=active, detail=compact (use scope=all|recent and detail=full for audits).",
+        "Supports limit/offset flow pagination; taskWindow.truncated signals the shared 1000-row board window was saturated.",
         "Safe for verify_live — read-only.",
-    ].join(" "), idSchema, async (args) => {
+    ].join(" "), {
+        ...idSchema,
+        scope: z
+            .enum(["active", "recent", "all"])
+            .optional()
+            .describe("Flow inventory scope (default active — non-terminal only)"),
+        detail: z
+            .enum(["compact", "full"])
+            .optional()
+            .describe("Projection detail (default compact — pruned terminal state)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(200)
+            .optional()
+            .describe("Max flows per page (default 50, max 200)"),
+        offset: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Flow page offset (default 0)"),
+    }, async (args) => {
         const agentOsId = args.agentOsId?.trim() ||
             (await resolveAgentOsId(args.slug ?? (await resolveToolSlug())));
-        const data = await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/taskflow`);
+        const params = new URLSearchParams();
+        if (args.scope)
+            params.set("scope", args.scope);
+        if (args.detail)
+            params.set("detail", args.detail);
+        if (args.limit !== undefined)
+            params.set("limit", String(args.limit));
+        if (args.offset !== undefined)
+            params.set("offset", String(args.offset));
+        const qs = params.toString();
+        const data = await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/taskflow${qs ? `?${qs}` : ""}`);
         return jsonResult(data);
     });
     register("agent_os_taskflow_get", [

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.61",
-  "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"