pilotswarm 0.4.1 → 0.5.1

package/mcp/dist/src/tools/graph.js

@@ -0,0 +1,237 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * Knowledge-graph tools (proposal G2b). Registered ONLY when `ctx.graph` is
+ * non-null — a separate injection, never derived from the fact store
+ * (enhancedfactstore 07 D2). Namespace-registry write tools are [admin].
+ *
+ * Deliberately absent: mergeGraphNodes and removeGraphEvidence — in-cluster
+ * harvester machinery, not a client surface (see WebGraphStore docstring).
+ */
+export function registerGraphTools(server, ctx) {
+    const graph = ctx.graph;
+    if (!graph)
+        return;
+    // ── Read ────────────────────────────────────────────────────────────
+    server.registerTool("graph_search_nodes", {
+        title: "Search Graph Nodes",
+        description: "Search knowledge-graph nodes. name_like is a lexical match on name/aliases; seeds (fact scope keys "
+            + "or node keys) anchor an expansion query. Returns node hits with ACL-filtered evidence.",
+        inputSchema: {
+            name_like: z.string().optional().describe("Lexical match against node names/aliases (no embeddings)"),
+            kind: z.string().optional().describe("Filter by node kind (free text: person, service, file, ...)"),
+            seeds: z.array(z.string()).optional().describe("Fact scope keys or node keys anchoring the query"),
+            depth: z.number().int().min(1).max(5).optional().describe("Hops to expand from seeds"),
+            namespace: z.string().optional().describe("Namespace filter (matches subtree)"),
+            min_confidence: z.number().min(0).max(1).optional().describe("Minimum confidence"),
+            limit: z.number().int().positive().max(200).optional().describe("Max results"),
+        },
+    }, withToolErrors(async ({ name_like, kind, seeds, depth, namespace, min_confidence, limit }) => {
+        const hits = await graph.searchGraphNodes({
+            nameLike: name_like,
+            kind,
+            seeds,
+            depth,
+            namespace,
+            minConfidence: min_confidence,
+            limit,
+        });
+        return jsonResult({ count: hits.length, nodes: hits });
+    }));
+    server.registerTool("graph_search_edges", {
+        title: "Search Graph Edges",
+        description: "Search knowledge-graph edges (relations). Anchor by endpoint node keys (explore mode) and/or "
+            + "predicate — predicate_key is the normalized exact key (preferred), predicate the exact raw text.",
+        inputSchema: {
+            from_key: z.string().optional().describe("Source node key anchor"),
+            to_key: z.string().optional().describe("Target node key anchor"),
+            predicate_key: z.string().optional().describe("Exact normalized predicate key (preferred)"),
+            predicate: z.string().optional().describe("Exact raw predicate text"),
+            namespace: z.string().optional().describe("Namespace filter (edge or either endpoint in subtree)"),
+            min_confidence: z.number().min(0).max(1).optional().describe("Minimum confidence"),
+            limit: z.number().int().positive().max(200).optional().describe("Max results"),
+        },
+    }, withToolErrors(async ({ from_key, to_key, predicate_key, predicate, namespace, min_confidence, limit }) => {
+        const hits = await graph.searchGraphEdges({
+            fromKey: from_key,
+            toKey: to_key,
+            predicateKey: predicate_key,
+            predicate,
+            namespace,
+            minConfidence: min_confidence,
+            limit,
+        });
+        return jsonResult({ count: hits.length, edges: hits });
+    }));
+    server.registerTool("graph_neighbourhood", {
+        title: "Graph Neighbourhood",
+        description: "Expand the subgraph around a node to a bounded depth — nodes plus connecting edges. "
+            + "The go-to tool after graph_search_nodes finds an anchor.",
+        inputSchema: {
+            node_key: z.string().min(1).describe("Anchor node key"),
+            depth: z.number().int().min(1).max(5).optional().describe("Expansion depth (default 1)"),
+            namespace: z.string().optional().describe("Graph namespace"),
+        },
+    }, withToolErrors(async ({ node_key, depth, namespace }) => {
+        const sub = await graph.graphNeighbourhood(node_key, depth ?? 1, undefined, namespace ? { namespace } : undefined);
+        return jsonResult(sub);
+    }));
+    // graph_stats — optional provider method; register iff implemented.
+    if (typeof graph.graphStats === "function") {
+        server.registerTool("graph_stats", {
+            title: "Graph Stats",
+            description: "Total node/edge counts for a graph namespace (plus uncrawled-facts backlog when reported).",
+            inputSchema: {
+                namespace: z.string().optional().describe("Graph namespace (default when omitted)"),
+            },
+        }, withToolErrors(async ({ namespace }) => {
+            const stats = await graph.graphStats(namespace ? { namespace } : undefined);
+            return jsonResult(stats);
+        }));
+    }
+    // ── Write ───────────────────────────────────────────────────────────
+    // Writes carry an agentId (provenance). External MCP writes default to a
+    // fixed operator identity so graph provenance distinguishes them from
+    // in-loop agent harvesting.
+    const DEFAULT_WRITER_ID = "mcp-operator";
+    server.registerTool("graph_upsert_node", {
+        title: "Upsert Graph Node",
+        description: "Create or update a knowledge-graph node (keyed by kind+name). Aliases and evidence (fact scope keys) "
+            + "union in on upsert; re-asserting known evidence is a no-op.",
+        inputSchema: {
+            kind: z.string().min(1).describe("Node kind (free text: person, service, file, ...)"),
+            name: z.string().min(1).describe("Node name"),
+            aliases: z.array(z.string()).optional().describe("Alternative names (merged on upsert)"),
+            evidence: z.array(z.string()).optional().describe("Fact scope keys supporting this node"),
+            namespace: z.string().optional().describe("Graph namespace"),
+            agent_id: z.string().optional().describe(`Provenance writer id (default '${DEFAULT_WRITER_ID}')`),
+        },
+    }, withToolErrors(async ({ kind, name, aliases, evidence, namespace, agent_id }) => {
+        const ref = await graph.upsertGraphNode({
+            kind,
+            name,
+            aliases,
+            evidence,
+            namespace,
+            agentId: agent_id ?? DEFAULT_WRITER_ID,
+        });
+        return jsonResult({ upserted: true, node: ref });
+    }));
+    server.registerTool("graph_upsert_edge", {
+        title: "Upsert Graph Edge",
+        description: "Create or update a directed edge between two nodes (by node key). Evidence unions in; "
+            + "reinforcement counts only novel evidence.",
+        inputSchema: {
+            from_key: z.string().min(1).describe("Source node key"),
+            to_key: z.string().min(1).describe("Target node key"),
+            predicate: z.string().min(1).describe("Relation predicate (free text, e.g. 'depends on')"),
+            confidence: z.number().min(0).max(1).optional().describe("Assertion confidence (default 1.0)"),
+            evidence: z.array(z.string()).optional().describe("Fact scope keys supporting this edge"),
+            namespace: z.string().optional().describe("Graph namespace"),
+            agent_id: z.string().optional().describe(`Provenance writer id (default '${DEFAULT_WRITER_ID}')`),
+        },
+    }, withToolErrors(async ({ from_key, to_key, predicate, confidence, evidence, namespace, agent_id }) => {
+        const ref = await graph.upsertGraphEdge({
+            fromKey: from_key,
+            toKey: to_key,
+            predicate,
+            confidence,
+            evidence,
+            namespace,
+            agentId: agent_id ?? DEFAULT_WRITER_ID,
+        });
+        return jsonResult({ upserted: true, edge: ref });
+    }));
+    server.registerTool("graph_delete_node", {
+        title: "Delete Graph Node",
+        description: "Delete a knowledge-graph node by key. No cross-store cascade (source facts untouched).",
+        inputSchema: {
+            node_key: z.string().min(1).describe("Node key to delete"),
+            namespace: z.string().optional().describe("Graph namespace"),
+        },
+    }, withToolErrors(async ({ node_key, namespace }) => {
+        const deleted = await graph.deleteGraphNode(node_key, namespace ? { namespace } : undefined);
+        return jsonResult({ deleted });
+    }));
+    server.registerTool("graph_delete_edge", {
+        title: "Delete Graph Edge",
+        description: "Delete a knowledge-graph edge identified by (from, to, predicate).",
+        inputSchema: {
+            from_key: z.string().min(1).describe("Source node key"),
+            to_key: z.string().min(1).describe("Target node key"),
+            predicate: z.string().min(1).describe("Relation predicate key"),
+            namespace: z.string().optional().describe("Graph namespace"),
+        },
+    }, withToolErrors(async ({ from_key, to_key, predicate, namespace }) => {
+        const deleted = await graph.deleteGraphEdge(from_key, to_key, predicate, namespace ? { namespace } : undefined);
+        return jsonResult({ deleted });
+    }));
+    // ── Namespace registry (optional provider surface) ──────────────────
+    if (typeof graph.listGraphNamespaces === "function") {
+        server.registerTool("list_graph_namespaces", {
+            title: "List Graph Namespaces",
+            description: "List registered graph namespaces (corpora). Compact by default.",
+            inputSchema: {
+                prefix: z.string().optional().describe("Namespace prefix filter"),
+                include_archived: z.boolean().optional().describe("Include archived namespaces (default false)"),
+                include_details: z.boolean().optional().describe("Include detail fields (default false)"),
+            },
+        }, withToolErrors(async ({ prefix, include_archived, include_details }) => {
+            const namespaces = await graph.listGraphNamespaces({
+                prefix,
+                includeArchived: include_archived,
+                includeDetails: include_details,
+            });
+            return jsonResult({ count: namespaces.length, namespaces });
+        }));
+    }
+    if (typeof graph.getGraphNamespace === "function") {
+        server.registerTool("get_graph_namespace", {
+            title: "Get Graph Namespace",
+            description: "Full descriptor for one graph namespace (returned regardless of archived state).",
+            inputSchema: {
+                namespace: z.string().min(1).describe("Namespace name"),
+            },
+        }, withToolErrors(async ({ namespace }) => {
+            const info = await graph.getGraphNamespace(namespace);
+            if (!info)
+                return errorResult("namespace not found", { namespace });
+            return jsonResult(info);
+        }));
+    }
+    if (ctx.admin && typeof graph.upsertGraphNamespace === "function") {
+        server.registerTool("upsert_graph_namespace", {
+            title: "Upsert Graph Namespace",
+            description: "Register or update a graph namespace (corpus). [admin]",
+            inputSchema: {
+                namespace: z.string().min(1).describe("Namespace name"),
+                description: z.string().min(1).describe("When to use this corpus — the discovery hint reader agents see"),
+                name: z.string().optional().describe("Short label (defaults to the namespace)"),
+                source: z.string().optional().describe("Detail: where this corpus comes from"),
+                archived: z.boolean().optional().describe("Set false to un-archive on upsert"),
+            },
+        }, withToolErrors(async ({ namespace, description, name, source, archived }) => {
+            const info = await graph.upsertGraphNamespace({
+                namespace,
+                frontmatter: { description, ...(name ? { name } : {}) },
+                source,
+                archived,
+            });
+            return jsonResult({ upserted: true, namespace: info });
+        }));
+    }
+    if (ctx.admin && typeof graph.deleteGraphNamespace === "function") {
+        server.registerTool("delete_graph_namespace", {
+            title: "Delete Graph Namespace",
+            description: "DESTRUCTIVE: drop all graph data for a namespace, then its registry row. Never deletes source "
+                + "facts. The 'default' namespace cannot be deleted. [admin]",
+            inputSchema: {
+                namespace: z.string().min(1).describe("Namespace to delete"),
+            },
+        }, withToolErrors(async ({ namespace }) => {
+            const result = await graph.deleteGraphNamespace(namespace);
+            return jsonResult(result);
+        }));
+    }
+}
+//# sourceMappingURL=graph.js.map

package/mcp/dist/src/tools/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/tools/graph.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/groups.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Session-group tools (proposal G5). Groups are the fleet-batching primitive:
+ * create N sessions in a group, then cancel/complete the group as a unit.
+ * Seven write routes consolidate into one action-dispatched tool to keep
+ * tool-count growth sane.
+ */
+export declare function registerGroupTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=groups.d.ts.map

package/mcp/dist/src/tools/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../src/tools/groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QAmGvE"}

package/mcp/dist/src/tools/groups.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * Session-group tools (proposal G5). Groups are the fleet-batching primitive:
+ * create N sessions in a group, then cancel/complete the group as a unit.
+ * Seven write routes consolidate into one action-dispatched tool to keep
+ * tool-count growth sane.
+ */
+export function registerGroupTools(server, ctx) {
+    server.registerTool("list_session_groups", {
+        title: "List Session Groups",
+        description: "List PilotSwarm session groups. Set include_sessions to also return each group's member sessions "
+            + "(derived from list_sessions filtered by group).",
+        inputSchema: {
+            include_sessions: z.boolean().optional().describe("Also return member sessions per group (default false)"),
+        },
+    }, withToolErrors(async ({ include_sessions }) => {
+        const groups = await ctx.mgmt.listSessionGroups();
+        if (!include_sessions) {
+            return jsonResult({ count: groups.length, groups });
+        }
+        // Group membership rides on the session views — one listSessions
+        // call covers every group (listGroupSessions is direct-mode-only).
+        const sessions = await ctx.mgmt.listSessions();
+        const byGroup = new Map();
+        for (const s of sessions) {
+            const gid = s.groupId ?? s.sessionGroupId ?? null;
+            if (!gid)
+                continue;
+            const arr = byGroup.get(gid) ?? [];
+            arr.push({ session_id: s.sessionId, title: s.title ?? null, status: s.status });
+            byGroup.set(gid, arr);
+        }
+        const enriched = groups.map((g) => ({
+            ...g,
+            sessions: byGroup.get(g.groupId ?? g.id) ?? [],
+        }));
+        return jsonResult({ count: enriched.length, groups: enriched });
+    }));
+    server.registerTool("manage_session_group", {
+        title: "Manage Session Group",
+        description: "Session-group lifecycle, dispatched by action:\n"
+            + "  create   — create a group (title required)\n"
+            + "  update   — patch title/description (group_id required)\n"
+            + "  assign   — assign session_ids to group_id\n"
+            + "  move     — move session_ids to group_id (null/omitted group_id = ungroup)\n"
+            + "  cancel   — cancel every session in the group\n"
+            + "  complete — complete every session in the group\n"
+            + "  delete   — delete an EMPTY group (move sessions out first)",
+        inputSchema: {
+            action: z.enum(["create", "update", "assign", "move", "cancel", "complete", "delete"]).describe("The operation to perform"),
+            group_id: z.string().optional().describe("Target group (required for all actions except create; optional for move = ungroup)"),
+            title: z.string().optional().describe("Group title (create/update)"),
+            description: z.string().optional().describe("Group description (create/update)"),
+            session_ids: z.array(z.string()).optional().describe("Sessions to assign/move"),
+            reason: z.string().optional().describe("Reason (cancel/complete/delete)"),
+        },
+    }, withToolErrors(async ({ action, group_id, title, description, session_ids, reason }) => {
+        switch (action) {
+            case "create": {
+                if (!title)
+                    return errorResult("create requires title");
+                const group = await ctx.mgmt.createSessionGroup({ title, description });
+                return jsonResult({ created: true, group });
+            }
+            case "update": {
+                if (!group_id)
+                    return errorResult("update requires group_id");
+                const group = await ctx.mgmt.updateSessionGroup(group_id, { title, description });
+                return jsonResult({ updated: true, group });
+            }
+            case "assign": {
+                if (!group_id)
+                    return errorResult("assign requires group_id");
+                if (!session_ids?.length)
+                    return errorResult("assign requires session_ids");
+                await ctx.mgmt.assignSessionsToGroup(group_id, session_ids);
+                return jsonResult({ assigned: true, group_id, session_ids });
+            }
+            case "move": {
+                if (!session_ids?.length)
+                    return errorResult("move requires session_ids");
+                await ctx.mgmt.moveSessionsToGroup(group_id ?? null, session_ids);
+                return jsonResult({ moved: true, group_id: group_id ?? null, session_ids });
+            }
+            case "cancel": {
+                if (!group_id)
+                    return errorResult("cancel requires group_id");
+                await ctx.mgmt.cancelSessionGroup(group_id, reason);
+                return jsonResult({ cancelled: true, group_id });
+            }
+            case "complete": {
+                if (!group_id)
+                    return errorResult("complete requires group_id");
+                await ctx.mgmt.completeSessionGroup(group_id, reason ? { reason } : undefined);
+                return jsonResult({ completed: true, group_id });
+            }
+            case "delete": {
+                if (!group_id)
+                    return errorResult("delete requires group_id");
+                await ctx.mgmt.deleteSessionGroup(group_id, reason);
+                return jsonResult({ deleted: true, group_id });
+            }
+        }
+    }));
+}
+//# sourceMappingURL=groups.js.map

package/mcp/dist/src/tools/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../../src/tools/groups.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/tools/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QAyRvE"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/tools/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QAqSvE"}

package/mcp/dist/src/tools/models.js

@@ -79,10 +79,14 @@ export function registerModelTools(server, ctx) {
     // 2. switch_model — Change the model for a session
     server.registerTool("switch_model", {
         title: "Switch Model",
-        description: "Change the model for a PilotSwarm session",
+        description: "Change the model for a PilotSwarm session, optionally setting reasoning effort",
         inputSchema: {
             session_id: z.string().describe("The session to switch the model for"),
             model: z.string().describe("The model to switch to"),
+            reasoning_effort: z
+                .string()
+                .optional()
+                .describe("Reasoning effort for the new model (e.g. low, medium, high) — web mode only"),
             timeout_ms: z
                 .number()
                 .int()
@@ -90,19 +94,27 @@ export function registerModelTools(server, ctx) {
                 .optional()
                 .describe("Max time to wait for the orchestration to acknowledge the switch (default 15000)"),
         },
-    }, async ({ session_id, model, timeout_ms }) => {
+    }, async ({ session_id, model, reasoning_effort, timeout_ms }) => {
         try {
             if (ctx.webMode) {
                 // Web API mode: the supported model-switch path (same one
                 // the portal UI uses). The server validates the model and
                 // enqueues the switch; rejections surface as API errors.
-                await ctx.mgmt.setSessionModel(session_id, model);
+                await ctx.mgmt.setSessionModel(session_id, model, reasoning_effort !== undefined ? { reasoningEffort: reasoning_effort } : {});
                 return {
                     content: [
-                        { type: "text", text: JSON.stringify({ switched: true, model }) },
+                        { type: "text", text: JSON.stringify({ switched: true, model, ...(reasoning_effort ? { reasoning_effort } : {}) }) },
                     ],
                 };
             }
+            if (reasoning_effort !== undefined) {
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify({ switched: false, error: "reasoning_effort is only supported in Web API mode" }) },
+                    ],
+                    isError: true,
+                };
+            }
             // Direct mode: wait for the orchestration's command response so
             // we don't claim success when the orchestration rejects the
             // command (e.g. unknown model, set_model not allowed mid-turn).

package/mcp/dist/src/tools/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/tools/models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/tools/models.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/observability.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Observability & forensics tools (proposal G6), consolidated by axis:
+ *
+ *   get_session_metrics   per-session (or spawn-tree) metrics via include[]
+ *   get_fleet_overview    fleet-wide aggregates via include[]
+ *   list_child_outcomes   what did the sub-agents conclude
+ *   get_execution_history raw orchestration execution events
+ *   export_execution_history  export history → artifact
+ */
+export declare function registerObservabilityTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=observability.d.ts.map

package/mcp/dist/src/tools/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../src/tools/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA4L/E"}