nodebench-mcp 2.70.0 → 3.0.1

package/dist/tools/sharedContextTools.js

@@ -0,0 +1,423 @@
+import { acceptSharedContextTask, acknowledgeSharedContextPacket, buildSharedContextPacketResource, buildSharedContextSubscriptionManifest, completeSharedContextTask, getSharedContextPacket, escalateSharedContextTask, getSharedContextPeer, getSharedContextScopedSnapshot, getSharedContextSnapshot, heartbeatSharedContextPeer, invalidateSharedContextPacket, listSharedContextMessages, listSharedContextPeers, proposeSharedContextTask, publishSharedContextPacket, pullSharedContextPackets, registerSharedContextPeer, rejectSharedContextTask, sendSharedContextMessage, } from "../sync/store.js";
+export const sharedContextTools = [
+    {
+        name: "register_shared_context_peer",
+        description: "Register a scoped peer with product, role, surface, capabilities, and heartbeat metadata for shared-context coordination.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+                product: { type: "string", enum: ["nodebench", "ta_studio"] },
+                tenantId: { type: "string" },
+                workspaceId: { type: "string" },
+                surface: { type: "string" },
+                role: { type: "string" },
+                capabilities: { type: "array", items: { type: "string" } },
+                contextScopes: { type: "array", items: { type: "string" } },
+                status: { type: "string" },
+                summary: { type: "object" },
+                metadata: { type: "object" },
+                queueForSync: { type: "boolean" },
+            },
+            required: ["product", "surface", "role"],
+        },
+        handler: async (args) => registerSharedContextPeer(args),
+    },
+    {
+        name: "heartbeat_shared_context_peer",
+        description: "Refresh peer liveness and optionally publish a compact machine-readable summary of its current work.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+                summary: { type: "object" },
+            },
+            required: ["peerId"],
+        },
+        handler: async (args) => heartbeatSharedContextPeer(args.peerId, args.summary),
+    },
+    {
+        name: "list_shared_context_peers",
+        description: "List peers by product, workspace, role, surface, capability, or scope.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                product: { type: "string" },
+                workspaceId: { type: "string" },
+                tenantId: { type: "string" },
+                role: { type: "string" },
+                surface: { type: "string" },
+                status: { type: "string" },
+                capability: { type: "string" },
+                scope: { type: "string" },
+                limit: { type: "number" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            const peers = listSharedContextPeers(args);
+            return { count: peers.length, peers };
+        },
+    },
+    {
+        name: "get_shared_context_peer",
+        description: "Fetch one peer and its current summary, capabilities, and scopes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+            },
+            required: ["peerId"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => getSharedContextPeer(args.peerId),
+    },
+    {
+        name: "publish_shared_context",
+        description: "Publish a structured shared-context packet with subject, claims, evidence refs, freshness, permissions, and lineage.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextId: { type: "string" },
+                contextType: { type: "string" },
+                producerPeerId: { type: "string" },
+                tenantId: { type: "string" },
+                workspaceId: { type: "string" },
+                scope: { type: "array", items: { type: "string" } },
+                subject: { type: "string" },
+                summary: { type: "string" },
+                claims: { type: "array", items: { type: "string" } },
+                evidenceRefs: { type: "array", items: { type: "string" } },
+                stateSnapshot: { type: "object" },
+                timeWindow: { type: "object" },
+                freshness: { type: "object" },
+                permissions: { type: "object" },
+                confidence: { type: "number" },
+                lineage: { type: "object" },
+                invalidates: { type: "array", items: { type: "string" } },
+                nextActions: { type: "array", items: { type: "string" } },
+                version: { type: "number" },
+                status: { type: "string" },
+                metadata: { type: "object" },
+                queueForSync: { type: "boolean" },
+            },
+            required: ["contextType", "producerPeerId", "subject", "summary"],
+        },
+        handler: async (args) => publishSharedContextPacket(args),
+    },
+    {
+        name: "pull_shared_context",
+        description: "Pull shared-context packets by type, producer, scope, workspace, status, or subject substring.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextType: { type: "string" },
+                producerPeerId: { type: "string" },
+                requestingPeerId: { type: "string" },
+                tenantId: { type: "string" },
+                workspaceId: { type: "string" },
+                status: { type: "string" },
+                scopeIncludes: { type: "string" },
+                subjectIncludes: { type: "string" },
+                limit: { type: "number" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            const packets = pullSharedContextPackets(args);
+            return { count: packets.length, packets };
+        },
+    },
+    {
+        name: "get_shared_context_packet",
+        description: "Fetch one shared-context packet directly and include the suggested resource URI plus pull/subscription filters for agent clients.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextId: { type: "string" },
+                peerId: { type: "string" },
+            },
+            required: ["contextId"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            const packet = getSharedContextPacket(args.contextId, args.peerId);
+            if (!packet) {
+                return {
+                    found: false,
+                    packet: null,
+                    resourceUri: null,
+                    pullQuery: null,
+                    subscriptionQuery: null,
+                };
+            }
+            const resource = buildSharedContextPacketResource(packet, args.peerId);
+            return {
+                found: true,
+                packet,
+                resourceUri: resource.resourceUri,
+                pullQuery: resource.pullQuery,
+                subscriptionQuery: resource.subscriptionQuery,
+            };
+        },
+    },
+    {
+        name: "ack_shared_context",
+        description: "Acknowledge that a peer received and accepted a context packet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextId: { type: "string" },
+                peerId: { type: "string" },
+                detail: { type: "object" },
+            },
+            required: ["contextId", "peerId"],
+        },
+        handler: async (args) => acknowledgeSharedContextPacket(args.contextId, args.peerId, args.detail),
+    },
+    {
+        name: "invalidate_shared_context",
+        description: "Invalidate a packet when it becomes stale, contradicted, or superseded.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextId: { type: "string" },
+                producerPeerId: { type: "string" },
+                reason: { type: "string" },
+                invalidates: { type: "array", items: { type: "string" } },
+            },
+            required: ["contextId", "producerPeerId", "reason"],
+        },
+        handler: async (args) => invalidateSharedContextPacket(args.contextId, args.producerPeerId, args.reason, args.invalidates ?? []),
+    },
+    {
+        name: "build_shared_context_subscription",
+        description: "Build the exact pull/subscription manifest an agent client should use to watch a packet or packet scope.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contextId: { type: "string" },
+                peerId: { type: "string" },
+            },
+            required: ["contextId"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            const packet = getSharedContextPacket(args.contextId, args.peerId);
+            if (!packet) {
+                return {
+                    found: false,
+                    resourceUri: null,
+                    pullQuery: null,
+                    subscriptionQuery: null,
+                };
+            }
+            const resource = buildSharedContextPacketResource(packet, args.peerId);
+            return {
+                found: true,
+                resourceUri: resource.resourceUri,
+                pullQuery: resource.pullQuery,
+                subscriptionQuery: resource.subscriptionQuery,
+            };
+        },
+    },
+    {
+        name: "build_shared_context_subscription_manifest",
+        description: "Build a filtered snapshot/events/pull manifest for one peer, packet class, producer, scope, or subject so clients can subscribe to only relevant shared-context updates.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+                contextType: { type: "string" },
+                producerPeerId: { type: "string" },
+                tenantId: { type: "string" },
+                workspaceId: { type: "string" },
+                status: { type: "string" },
+                scopeIncludes: { type: "string" },
+                subjectIncludes: { type: "string" },
+                taskType: { type: "string" },
+                messageClass: { type: "string" },
+                eventTypes: { type: "array", items: { type: "string" } },
+                limit: { type: "number" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => buildSharedContextSubscriptionManifest(args),
+    },
+    {
+        name: "send_peer_message",
+        description: "Send a direct structured message to a peer without routing everything through a central orchestrator.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fromPeerId: { type: "string" },
+                toPeerId: { type: "string" },
+                messageClass: { type: "string" },
+                payload: { type: "object" },
+                queueForSync: { type: "boolean" },
+            },
+            required: ["fromPeerId", "toPeerId", "messageClass", "payload"],
+        },
+        handler: async (args) => sendSharedContextMessage(args),
+    },
+    {
+        name: "check_peer_messages",
+        description: "Read the direct messages for a peer, optionally restricting to unread items.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+                unreadOnly: { type: "boolean" },
+            },
+            required: ["peerId"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            const messages = listSharedContextMessages(args.peerId, args.unreadOnly ?? false);
+            return { count: messages.length, messages };
+        },
+    },
+    {
+        name: "propose_shared_task",
+        description: "Propose a task handoff between peers with input contexts and required output packet shape.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string" },
+                taskType: { type: "string" },
+                proposerPeerId: { type: "string" },
+                assigneePeerId: { type: "string" },
+                status: { type: "string" },
+                taskSpec: { type: "object" },
+                inputContextIds: { type: "array", items: { type: "string" } },
+                outputContextId: { type: "string" },
+                reason: { type: "string" },
+                metadata: { type: "object" },
+                queueForSync: { type: "boolean" },
+            },
+            required: ["taskType", "proposerPeerId", "assigneePeerId"],
+        },
+        handler: async (args) => proposeSharedContextTask(args),
+    },
+    {
+        name: "accept_shared_task",
+        description: "Accept a proposed shared-context task.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string" },
+                peerId: { type: "string" },
+            },
+            required: ["taskId", "peerId"],
+        },
+        handler: async (args) => acceptSharedContextTask(args.taskId, args.peerId),
+    },
+    {
+        name: "reject_shared_task",
+        description: "Reject a proposed shared-context task with a reason.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string" },
+                peerId: { type: "string" },
+                reason: { type: "string" },
+            },
+            required: ["taskId", "peerId", "reason"],
+        },
+        handler: async (args) => rejectSharedContextTask(args.taskId, args.peerId, args.reason),
+    },
+    {
+        name: "complete_shared_task",
+        description: "Complete a shared-context task and attach the output packet if one was produced.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string" },
+                peerId: { type: "string" },
+                outputContextId: { type: "string" },
+            },
+            required: ["taskId", "peerId"],
+        },
+        handler: async (args) => completeSharedContextTask(args.taskId, args.peerId, args.outputContextId),
+    },
+    {
+        name: "escalate_shared_task",
+        description: "Escalate a shared-context task when the assignee cannot complete it cleanly.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string" },
+                peerId: { type: "string" },
+                reason: { type: "string" },
+                outputContextId: { type: "string" },
+            },
+            required: ["taskId", "peerId", "reason"],
+        },
+        handler: async (args) => escalateSharedContextTask(args.taskId, args.peerId, args.reason, args.outputContextId),
+    },
+    {
+        name: "get_shared_context_snapshot",
+        description: "Inspect the current shared-context protocol state: peers, packets, handoffs, messages, and aggregate counts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                peerId: { type: "string" },
+                workspaceId: { type: "string" },
+                contextType: { type: "string" },
+                producerPeerId: { type: "string" },
+                scopeIncludes: { type: "string" },
+                subjectIncludes: { type: "string" },
+                taskType: { type: "string" },
+                messageClass: { type: "string" },
+                limit: { type: "number" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        handler: async (args) => {
+            if (args.peerId ||
+                args.workspaceId ||
+                args.contextType ||
+                args.producerPeerId ||
+                args.scopeIncludes ||
+                args.subjectIncludes ||
+                args.taskType ||
+                args.messageClass) {
+                return getSharedContextScopedSnapshot(args);
+            }
+            return getSharedContextSnapshot(args.limit ?? 10);
+        },
+    },
+];
+//# sourceMappingURL=sharedContextTools.js.map

package/dist/tools/sharedContextTools.js.map

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

package/dist/tools/sitemapTools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sitemap Tools — Interactive site map with stateful drill-down + diff crawl + test suggestion
+ *
+ * Provides retention.sh-style interactive site exploration:
+ *   site_map({ url }) → crawl, store session
+ *   site_map({ action: 'overview' }) → navigation graph
+ *   site_map({ action: 'screen', index: N }) → drill into page
+ *   site_map({ action: 'screenshot', index: N }) → return screenshot
+ *   site_map({ action: 'findings' }) → QA findings
+ *
+ *   diff_crawl({ url }) → baseline or compare
+ *   suggest_tests({ session_id }) → generate test cases from crawl
+ */
+import type { McpTool } from "../types.js";
+export declare const sitemapTools: McpTool[];