Twining MCP Server

Instructions

Implementation Reference

• src/tools/coordination-tools.ts:328-347 (handler)

  The handler for the twining_acknowledge tool, which calls the coordinationEngine.acknowledgeHandoff method.

  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",
      );
    }
  },

• src/tools/coordination-tools.ts:314-348 (registration)

  Registration of the twining_acknowledge tool in the coordination tools server.

  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",
        );
      }
    },
  );

• src/engine/coordination.ts:328-334 (handler)

  The implementation of acknowledgeHandoff within the CoordinationEngine class, which interacts with the handoffStore.

  /** Acknowledge receipt of a handoff. */
  async acknowledgeHandoff(
    handoffId: string,
    agentId: string,
  ): Promise<HandoffRecord> {
    return this.handoffStore.acknowledge(handoffId, agentId);
  }