Warden MCP Server

Instructions

Implementation Reference

• src/tools/registerTools.ts:926-947 (handler)

  Registration and tool handler for 'keychain_send_get'. Note the typo in the user prompt: the actual tool name is 'send_get' (with the prefix).

    `${deps.toolPrefix}.send_get`,
    {
      title: 'Send Get',
      description:
        'Get Sends owned by you. Use text=true to return text content; downloadFile=true to download a file send (bw send get).',
      annotations: { readOnlyHint: true, openWorldHint: true },
      inputSchema: {
        id: z.string(),
        text: z.boolean().optional(),
        downloadFile: z.boolean().optional(),
      },
      _meta: toolMeta,
    },
    async (input, extra) => {
      const sdk = await deps.getSdk(extra.authInfo);
      const result = await sdk.sendGet(input);
      return {
        structuredContent: { result },
        content: [{ type: 'text', text: 'OK' }],
      };
    },
  );

• src/sdk/keychainSdk.ts:510-549 (handler)

  Actual implementation of 'sendGet' logic within the Keychain SDK.

  async sendGet(input: {
    id: string;
    text?: boolean;
    downloadFile?: boolean;
  }): Promise<unknown> {
    return this.bw.withSession(async (session) => {
      if (input.text) {
        const { stdout } = await this.bw.runForSession(
          session,
          ['--raw', 'send', 'get', input.id, '--text'],
          { timeoutMs: 60_000 },
        );
        return { text: stdout.trim() };
      }
  
      if (input.downloadFile) {
        const dir = await mkdtemp(join(tmpdir(), 'keychain-sendfile-'));
        try {
          await this.bw.runForSession(
            session,
            ['send', 'get', input.id, '--output', dir],
            { timeoutMs: 120_000 },
          );
          const file = await this.readSingleFileAsBase64(dir);
          return { file };
        } finally {
          await rm(dir, { recursive: true, force: true });
        }
      }
  
      const { stdout } = await this.bw.runForSession(
        session,
        ['send', 'get', input.id],
        {
          timeoutMs: 60_000,
        },
      );
      return this.tryParseJson(stdout);
    });
  }