Twining MCP Server

Instructions

Implementation Reference

• src/tools/blackboard-tools.ts:188-200 (handler)

  The handler for the twining_dismiss tool which calls engine.dismiss(args.ids).

  async (args) => {
    try {
      const result = await engine.dismiss(args.ids);
      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",
      );
    }

• src/tools/blackboard-tools.ts:174-186 (schema)

  The input schema for the twining_dismiss tool, validating entry IDs and reason.

  {
    description:
      "Remove specific blackboard entries by ID. Use this to clean up false-positive warnings, resolved entries, or other noise. Returns which IDs were dismissed and which were not found.",
    inputSchema: {
      ids: z
        .array(z.string())
        .min(1)
        .describe("Entry IDs to remove from the blackboard"),
      reason: z
        .string()
        .optional()
        .describe("Why these entries are being dismissed (logged but not stored)"),
    },

• src/tools/blackboard-tools.ts:172-187 (registration)

  Registration of the twining_dismiss tool on the MCP server.

  server.registerTool(
    "twining_dismiss",
    {
      description:
        "Remove specific blackboard entries by ID. Use this to clean up false-positive warnings, resolved entries, or other noise. Returns which IDs were dismissed and which were not found.",
      inputSchema: {
        ids: z
          .array(z.string())
          .min(1)
          .describe("Entry IDs to remove from the blackboard"),
        reason: z
          .string()
          .optional()
          .describe("Why these entries are being dismissed (logged but not stored)"),
      },
    },