twining-mcp 1.3.0

package/dist/tools/blackboard-tools.js

@@ -0,0 +1,131 @@
+/**
+ * MCP tool handlers for blackboard operations.
+ * Registers twining_post, twining_read, and twining_recent.
+ */
+import { z } from "zod";
+import { ENTRY_TYPES } from "../utils/types.js";
+import { toolResult, toolError, TwiningError } from "../utils/errors.js";
+export function registerBlackboardTools(server, engine) {
+    // twining_post — Post an entry to the shared blackboard
+    server.registerTool("twining_post", {
+        description: "Post an entry to the shared blackboard. Use this to share findings, needs, warnings, decisions, and other coordination messages with other agents.",
+        inputSchema: {
+            entry_type: z.enum(ENTRY_TYPES).describe("Type of blackboard entry"),
+            summary: z
+                .string()
+                .max(200)
+                .describe("One-line summary (max 200 chars)"),
+            detail: z.string().optional().describe("Full context and details"),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("Domain tags for filtering"),
+            scope: z
+                .string()
+                .optional()
+                .describe('File path, module name, or "project"'),
+            relates_to: z
+                .array(z.string())
+                .optional()
+                .describe("IDs of related entries"),
+            agent_id: z
+                .string()
+                .optional()
+                .describe("Identifier for the posting agent"),
+        },
+    }, async (args) => {
+        try {
+            const result = await engine.post(args);
+            return toolResult(result);
+        }
+        catch (e) {
+            if (e instanceof TwiningError) {
+                return toolError(e.message, e.code);
+            }
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_read — Read blackboard entries with optional filters
+    server.registerTool("twining_read", {
+        description: "Read blackboard entries with optional filters. Use this to check what other agents have posted, find relevant context, or review recent activity.",
+        inputSchema: {
+            entry_types: z
+                .array(z.string())
+                .optional()
+                .describe("Filter by entry type(s)"),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("Filter by tags (OR match)"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Filter by scope (prefix match)"),
+            since: z
+                .string()
+                .optional()
+                .describe("Only entries after this ISO 8601 timestamp"),
+            limit: z
+                .number()
+                .optional()
+                .describe("Max entries to return (default: 50)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await engine.read(args);
+            return toolResult(result);
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_query — Semantic search across blackboard entries
+    server.registerTool("twining_query", {
+        description: "Semantic search across blackboard entries. Uses embeddings when available, falls back to keyword search. Returns entries ranked by relevance.",
+        inputSchema: {
+            query: z.string().describe("Natural language query"),
+            entry_types: z
+                .array(z.string())
+                .optional()
+                .describe("Optional type filter"),
+            limit: z
+                .number()
+                .optional()
+                .describe("Max results (default: 10)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await engine.query(args.query, {
+                entry_types: args.entry_types,
+                limit: args.limit,
+            });
+            return toolResult(result);
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_recent — Quick access to latest entries
+    server.registerTool("twining_recent", {
+        description: "Get the most recent blackboard entries. Quick way to see latest activity without specifying filters.",
+        inputSchema: {
+            n: z
+                .number()
+                .optional()
+                .describe("Number of entries to return (default: 20)"),
+            entry_types: z
+                .array(z.string())
+                .optional()
+                .describe("Optional type filter"),
+        },
+    }, async (args) => {
+        try {
+            const result = await engine.recent(args.n, args.entry_types);
+            return toolResult(result);
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+}
+//# sourceMappingURL=blackboard-tools.js.map

package/dist/tools/blackboard-tools.js.map

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

package/dist/tools/context-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ContextAssembler } from "../engine/context-assembler.js";
+export declare function registerContextTools(server: McpServer, contextAssembler: ContextAssembler): void;
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/tools/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/tools/context-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,gBAAgB,GACjC,IAAI,CAkGN"}

package/dist/tools/context-tools.js

@@ -0,0 +1,76 @@
+/**
+ * MCP tool handlers for context assembly operations.
+ * Registers twining_assemble, twining_summarize, and twining_what_changed.
+ */
+import { z } from "zod";
+import { toolResult, toolError, TwiningError } from "../utils/errors.js";
+export function registerContextTools(server, contextAssembler) {
+    // twining_assemble — Build tailored context for a specific task
+    server.registerTool("twining_assemble", {
+        description: "Build tailored context for a specific task. Returns relevant decisions, warnings, needs, findings, and questions within a token budget. Call this before starting any task to get shared context from other agents.",
+        inputSchema: {
+            task: z.string().describe("Description of what the agent is about to do"),
+            scope: z
+                .string()
+                .describe('File path, module, or area of codebase (e.g., "src/auth/" or "project")'),
+            max_tokens: z
+                .number()
+                .optional()
+                .describe("Token budget (default: from config, typically 4000)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await contextAssembler.assemble(args.task, args.scope, args.max_tokens);
+            return toolResult(result);
+        }
+        catch (e) {
+            if (e instanceof TwiningError) {
+                return toolError(e.message, e.code);
+            }
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_summarize — High-level summary of project or scope state
+    server.registerTool("twining_summarize", {
+        description: "Get a high-level summary of project or scope state. Returns counts of active decisions, open needs, warnings, and a recent activity narrative.",
+        inputSchema: {
+            scope: z
+                .string()
+                .optional()
+                .describe('Optional scope filter (default: "project")'),
+        },
+    }, async (args) => {
+        try {
+            const result = await contextAssembler.summarize(args.scope);
+            return toolResult(result);
+        }
+        catch (e) {
+            if (e instanceof TwiningError) {
+                return toolError(e.message, e.code);
+            }
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_what_changed — Report changes since a given point in time
+    server.registerTool("twining_what_changed", {
+        description: "Report what changed since a given point in time. Returns new decisions, new entries, overridden decisions, and reconsidered decisions. Use this to catch up on changes since you last checked.",
+        inputSchema: {
+            since: z
+                .string()
+                .describe("ISO 8601 timestamp (e.g., 2024-01-15T10:00:00Z)"),
+            scope: z.string().optional().describe("Optional scope filter"),
+        },
+    }, async (args) => {
+        try {
+            const result = await contextAssembler.whatChanged(args.since, args.scope);
+            return toolResult(result);
+        }
+        catch (e) {
+            if (e instanceof TwiningError) {
+                return toolError(e.message, e.code);
+            }
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+}
+//# sourceMappingURL=context-tools.js.map

package/dist/tools/context-tools.js.map

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

package/dist/tools/coordination-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentStore } from "../storage/agent-store.js";
+import type { CoordinationEngine } from "../engine/coordination.js";
+import type { TwiningConfig } from "../utils/types.js";
+export declare function registerCoordinationTools(server: McpServer, agentStore: AgentStore, coordinationEngine: CoordinationEngine, config: TwiningConfig): void;
+//# sourceMappingURL=coordination-tools.d.ts.map

package/dist/tools/coordination-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-tools.d.ts","sourceRoot":"","sources":["../../src/tools/coordination-tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAOvD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,kBAAkB,EACtC,MAAM,EAAE,aAAa,GACpB,IAAI,CAuQN"}

package/dist/tools/coordination-tools.js

@@ -0,0 +1,220 @@
+/**
+ * MCP tool handlers for agent coordination operations.
+ * Registers twining_agents, twining_discover, twining_delegate,
+ * twining_handoff, and twining_acknowledge.
+ */
+import { z } from "zod";
+import { computeLiveness, DEFAULT_LIVENESS_THRESHOLDS, } from "../utils/liveness.js";
+import { toolResult, toolError } from "../utils/errors.js";
+export function registerCoordinationTools(server, agentStore, coordinationEngine, config) {
+    // twining_agents — List all registered agents with liveness status
+    server.registerTool("twining_agents", {
+        description: "List all registered agents with their capabilities and liveness status.",
+        inputSchema: {
+            include_gone: z
+                .boolean()
+                .optional()
+                .describe("Whether to include gone agents (default: true)"),
+        },
+    }, async (args) => {
+        try {
+            const includeGone = args.include_gone ?? true;
+            const agents = await agentStore.getAll();
+            const thresholds = config.agents?.liveness ?? DEFAULT_LIVENESS_THRESHOLDS;
+            const now = new Date();
+            const mapped = agents.map((agent) => ({
+                agent_id: agent.agent_id,
+                capabilities: agent.capabilities,
+                role: agent.role,
+                description: agent.description,
+                registered_at: agent.registered_at,
+                last_active: agent.last_active,
+                liveness: computeLiveness(agent.last_active, now, thresholds),
+            }));
+            const filtered = includeGone
+                ? mapped
+                : mapped.filter((a) => a.liveness !== "gone");
+            const activeCount = mapped.filter((a) => a.liveness === "active").length;
+            return toolResult({
+                agents: filtered,
+                total_registered: agents.length,
+                active_count: activeCount,
+            });
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_discover — Find agents matching required capabilities
+    server.registerTool("twining_discover", {
+        description: "Find agents matching required capabilities, ranked by capability overlap and liveness. Returns scored agent list for delegation decisions.",
+        inputSchema: {
+            required_capabilities: z
+                .array(z.string())
+                .describe("Capabilities the agent must have (e.g. ['testing', 'typescript'])"),
+            include_gone: z
+                .boolean()
+                .optional()
+                .describe("Whether to include gone agents (default: true)"),
+            min_score: z
+                .number()
+                .optional()
+                .describe("Minimum total_score threshold (default: 0)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await coordinationEngine.discover({
+                required_capabilities: args.required_capabilities,
+                include_gone: args.include_gone,
+                min_score: args.min_score,
+            });
+            return toolResult(result);
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_delegate — Post a delegation request to the blackboard
+    server.registerTool("twining_delegate", {
+        description: "Post a delegation request to the blackboard as a 'need' entry with capability requirements. Returns suggested agents ranked by match quality.",
+        inputSchema: {
+            summary: z
+                .string()
+                .describe("Description of the task to delegate (max 200 chars)"),
+            required_capabilities: z
+                .array(z.string())
+                .describe("Capabilities needed for this task"),
+            urgency: z
+                .enum(["high", "normal", "low"])
+                .optional()
+                .describe("Urgency level affecting timeout (default: 'normal')"),
+            timeout_ms: z
+                .number()
+                .optional()
+                .describe("Custom timeout in ms (overrides urgency-based default)"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Scope for the delegation (default: 'project')"),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("Additional tags for the delegation entry"),
+            agent_id: z
+                .string()
+                .optional()
+                .describe("ID of the delegating agent (default: 'main')"),
+        },
+    }, async (args) => {
+        try {
+            const result = await coordinationEngine.postDelegation({
+                summary: args.summary,
+                required_capabilities: args.required_capabilities,
+                urgency: args.urgency,
+                timeout_ms: args.timeout_ms,
+                scope: args.scope,
+                tags: args.tags,
+                agent_id: args.agent_id,
+            });
+            return toolResult(result);
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_handoff — Create a handoff between agents
+    server.registerTool("twining_handoff", {
+        description: "Create a handoff record from one agent to another, capturing work results and auto-assembling context snapshot. Posts a status entry to the blackboard.",
+        inputSchema: {
+            source_agent: z
+                .string()
+                .describe("ID of the agent handing off work"),
+            target_agent: z
+                .string()
+                .optional()
+                .describe("ID of the target agent (omit for open handoff to any agent)"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Scope of the handoff (default: 'project')"),
+            summary: z
+                .string()
+                .describe("Summary of work being handed off"),
+            results: z
+                .array(z.object({
+                description: z.string().describe("What was done"),
+                status: z
+                    .enum(["completed", "partial", "blocked", "failed"])
+                    .describe("Result status"),
+                artifacts: z
+                    .array(z.string())
+                    .optional()
+                    .describe("File paths or artifact IDs produced"),
+                notes: z
+                    .string()
+                    .optional()
+                    .describe("Additional notes"),
+            }))
+                .describe("Results of the work being handed off"),
+            auto_snapshot: z
+                .boolean()
+                .optional()
+                .describe("Auto-assemble context snapshot from decisions/warnings (default: true)"),
+        },
+    }, async (args) => {
+        try {
+            const record = await coordinationEngine.createHandoff({
+                source_agent: args.source_agent,
+                target_agent: args.target_agent,
+                scope: args.scope,
+                summary: args.summary,
+                results: args.results,
+                auto_snapshot: args.auto_snapshot,
+            });
+            return toolResult({
+                id: record.id,
+                created_at: record.created_at,
+                source_agent: record.source_agent,
+                target_agent: record.target_agent,
+                scope: record.scope,
+                summary: record.summary,
+                result_count: record.results.length,
+                context_snapshot_size: {
+                    decisions: record.context_snapshot.decision_ids.length,
+                    warnings: record.context_snapshot.warning_ids.length,
+                    findings: record.context_snapshot.finding_ids.length,
+                },
+            });
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+    // twining_acknowledge — Acknowledge receipt of a handoff
+    server.registerTool("twining_acknowledge", {
+        description: "Acknowledge receipt of a handoff, recording which agent picked it up.",
+        inputSchema: {
+            handoff_id: z
+                .string()
+                .describe("ID of the handoff to acknowledge"),
+            agent_id: z
+                .string()
+                .describe("ID of the agent acknowledging the handoff"),
+        },
+    }, async (args) => {
+        try {
+            const record = await coordinationEngine.acknowledgeHandoff(args.handoff_id, args.agent_id);
+            return toolResult({
+                id: record.id,
+                acknowledged_by: record.acknowledged_by,
+                acknowledged_at: record.acknowledged_at,
+                summary: record.summary,
+                source_agent: record.source_agent,
+            });
+        }
+        catch (e) {
+            return toolError(e instanceof Error ? e.message : "Unknown error", "INTERNAL_ERROR");
+        }
+    });
+}
+//# sourceMappingURL=coordination-tools.js.map

package/dist/tools/coordination-tools.js.map

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

package/dist/tools/decision-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DecisionEngine } from "../engine/decisions.js";
+export declare function registerDecisionTools(server: McpServer, engine: DecisionEngine): void;
+//# sourceMappingURL=decision-tools.d.ts.map

package/dist/tools/decision-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-tools.d.ts","sourceRoot":"","sources":["../../src/tools/decision-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2VN"}