bitbank-lab-mcp 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/server.ts CHANGED
@@ -1,22 +1,27 @@
1
1
  import './env.js'; // must be first — loads .env before other modules read process.env
2
- import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
- import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
- import { z } from 'zod';
5
- import { getErrorMessage, toPublicError } from '../lib/error.js';
2
+ import { isInputRequiredResult, McpServer } from '@modelcontextprotocol/server';
3
+ import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
4
+ import type { z } from 'zod';
5
+ import { toPublicError } from '../lib/error.js';
6
6
  import { logError, logToolRun } from '../lib/logger.js';
7
+ import { requestStateCodec } from './private/request-state.js';
7
8
  import { type PromptDef, prompts as promptDefs } from './prompts.js';
8
9
  import { appResourceRegistry } from './resources/app-resources.js';
9
10
  import { allToolDefs } from './tool-registry.js';
11
+ import { storeUiSnapshot } from './ui-snapshot-cache.js';
10
12
 
11
- const server = new McpServer({ name: 'bitbank-mcp', version: '0.4.2' });
12
- // Explicit registries for tools/prompts to improve STDIO inspector compatibility
13
- const registeredTools: Array<{
14
- name: string;
15
- description: string;
16
- inputSchema: Record<string, unknown>;
17
- _meta?: Record<string, unknown>;
18
- }> = [];
19
- const registeredPrompts: Array<{ name: string; description: string }> = [];
13
+ const server = new McpServer(
14
+ { name: 'bitbank-mcp', version: '0.4.2' },
15
+ {
16
+ // MRTR (SEP-2322) の requestState 検証。HMAC / 有効期限の検証をハンドラ実行前に行い、
17
+ // 失敗時は SDK が wire レベルの -32602(Invalid or expired requestState)を返す。
18
+ // codec の詳細と payload の文脈バインド検証は src/private/request-state.ts /
19
+ // src/private/elicitation.ts を参照。
20
+ requestState: {
21
+ verify: (state, ctx) => requestStateCodec.verify(state, ctx),
22
+ },
23
+ },
24
+ );
20
25
 
21
26
  type TextContent = { type: 'text'; text: string; _meta?: Record<string, unknown> };
22
27
  type ToolReturn = { content: TextContent[]; structuredContent?: Record<string, unknown> };
@@ -79,49 +84,23 @@ const respond = (result: unknown): ToolReturn => {
79
84
  };
80
85
  };
81
86
 
82
- /** Zod スキーマ → MCP inspector 用 JSON Schema に変換する。
83
- * Zod 4 組み込みの toJSONSchema を使い、MCP 不要の additionalProperties を除去する。 */
84
- function zodToInputJsonSchema(schema: z.ZodTypeAny): Record<string, unknown> {
85
- const json = z.toJSONSchema(schema, { target: 'openApi3' }) as Record<string, unknown>;
86
- delete json.additionalProperties;
87
- // default 付きフィールドは required から除外(Zod が parse 時に適用するため MCP 入力では不要)
88
- const props = json.properties as Record<string, Record<string, unknown>> | undefined;
89
- if (Array.isArray(json.required) && props) {
90
- json.required = (json.required as string[]).filter((k) => !('default' in (props[k] ?? {})));
91
- if ((json.required as string[]).length === 0) delete json.required;
92
- }
93
- return json;
94
- }
95
-
96
- /** SDK の registerTool に渡すための ZodRawShape を取得する。
97
- * .describe() / .default() / .optional() 等のラッパーを再帰的にアンラップする。 */
98
- function getRawShape(s: z.ZodTypeAny): z.ZodRawShape {
99
- type Unwrappable = {
100
- shape?: z.ZodRawShape;
101
- _def?: { schema?: z.ZodTypeAny; innerType?: z.ZodTypeAny; in?: z.ZodTypeAny };
102
- };
103
- let cur = s as Unwrappable;
104
- for (let i = 0; i < 6; i++) {
105
- if (cur.shape) break;
106
- const def = cur._def;
107
- if (!def) break;
108
- // Zod 3: ZodEffects uses _def.schema / Zod 4: uses _def.in
109
- if (def.schema) {
110
- cur = def.schema as Unwrappable;
111
- continue;
112
- }
113
- if (def.in) {
114
- cur = def.in as Unwrappable;
115
- continue;
116
- }
117
- if (def.innerType) {
118
- cur = def.innerType as Unwrappable;
119
- continue;
120
- }
121
- break;
87
+ /**
88
+ * `_meta.ui.resourceUri` を持つツール(MCP Apps 連携ツール)の応答を
89
+ * UI スナップショットとして保持する。一部ホストで `ui/notifications/tool-result` が
90
+ * iframe に配信されない場合の pull 型 hydration(get_ui_snapshot)に使う。
91
+ * スナップショットは呼び出し元接続の sessionId にバインドする(stdio では undefined)。
92
+ */
93
+ function storeSnapshotIfUiTool(
94
+ meta: Record<string, unknown> | undefined,
95
+ response: ToolReturn,
96
+ ctx?: Record<string, unknown>,
97
+ ): void {
98
+ const resourceUri = (meta as { ui?: { resourceUri?: unknown } } | undefined)?.ui?.resourceUri;
99
+ if (typeof resourceUri === 'string' && response.structuredContent) {
100
+ storeUiSnapshot(resourceUri, response.structuredContent, {
101
+ sessionId: (ctx as { sessionId?: string } | undefined)?.sessionId,
102
+ });
122
103
  }
123
- if (cur.shape) return cur.shape;
124
- throw new Error('inputSchema must be or wrap a ZodObject');
125
104
  }
126
105
 
127
106
  function registerToolWithLog(
@@ -129,37 +108,22 @@ function registerToolWithLog(
129
108
  schema: { description: string; inputSchema: z.ZodTypeAny; _meta?: Record<string, unknown> },
130
109
  handler: (input: Record<string, unknown>, extra?: Record<string, unknown>) => Promise<unknown>,
131
110
  ) {
132
- // Build JSON Schema for listing
133
- const inputSchemaJson = zodToInputJsonSchema(schema.inputSchema);
134
- registeredTools.push({
135
- name,
136
- description: schema.description,
137
- inputSchema: inputSchemaJson,
138
- ...(schema._meta ? { _meta: schema._meta } : {}),
139
- });
140
-
141
- // SDK の registerTool は第2引数に { inputSchema: ZodRawShape } を要求するが
142
- // 型定義が厳密すぎて直接渡せないため、ここでキャストを集約する
111
+ // SDK v2 は Standard Schema(Zod v4 オブジェクト)を inputSchema として直接受け、
112
+ // `.refine()` / `.superRefine()` 等のクロスフィールド制約も含めた完全なスキーマで
113
+ // ハンドラ実行前に入力検証する(v1 時代の raw shape 抽出 + 二重 parse は不要になった)。
114
+ // 型定義は Zod スキーマの generics に厳密なため、ここでキャストを集約する。
143
115
  const toolConfig: Record<string, unknown> = {
144
116
  description: schema.description,
145
- inputSchema: getRawShape(schema.inputSchema),
117
+ inputSchema: schema.inputSchema,
146
118
  };
147
119
  if (schema._meta) toolConfig._meta = schema._meta;
148
120
  (server as unknown as { registerTool: (n: string, s: unknown, h: unknown) => void }).registerTool(
149
121
  name,
150
122
  toolConfig,
151
- async (input: Record<string, unknown>, extra?: Record<string, unknown>) => {
123
+ async (input: Record<string, unknown>, ctx?: Record<string, unknown>) => {
152
124
  const TOOL_TIMEOUT_MS = 60_000;
153
125
  const t0 = Date.now();
154
126
  try {
155
- // 入力を完全な inputSchema で検証する(defense-in-depth)。
156
- // SDK には getRawShape() で抽出した shape のみ渡しているため、
157
- // .refine() / .superRefine() 等のクロスフィールド制約は MCP 経由では失われ得る。
158
- // また各 handler は `args as ...` で cast しており明示 parse をしないため、
159
- // ここで本来のスキーマを通して取りこぼし・将来の登録経路変更に備える。
160
- // ZodError は下の catch で toPublicError により 'validation_error' に正規化され、
161
- // 入力断片やローカルパスは応答に露出しない。
162
- schema.inputSchema.parse(input ?? {});
163
127
  let timeoutId: ReturnType<typeof setTimeout> | undefined;
164
128
  const timeoutPromise = new Promise<never>((_, reject) => {
165
129
  timeoutId = setTimeout(
@@ -167,23 +131,31 @@ function registerToolWithLog(
167
131
  TOOL_TIMEOUT_MS,
168
132
  );
169
133
  });
170
- // elicitation 等で server.elicitInput / getClientCapabilities を使うツール向けに、
171
- // SDK の RequestHandlerExtra に内部 Server インスタンスを合流させる。
172
- // (elicitInput / getClientCapabilities は McpServer 直下ではなく
173
- // McpServer.server (= 内部 Server) 上にあるため、wrapper ではなく中身を渡す)
174
- const handlerExtra = { ...extra, server: server.server };
175
- const result = await Promise.race([handler(input, handlerExtra), timeoutPromise]).finally(() => {
134
+ // MRTR / elicitation を使うツール向けに、SDK の ServerContext
135
+ // (mcpReq.inputResponses / mcpReq.requestState 等)へ内部 Server インスタンスを
136
+ // 合流させて渡す。server は 2025 系接続の client capabilities 判定
137
+ // (getClientCapabilities)に使う。
138
+ const handlerExtra = { ...ctx, server: server.server };
139
+ const result = await Promise.race([handler(input ?? {}, handlerExtra), timeoutPromise]).finally(() => {
176
140
  if (timeoutId) clearTimeout(timeoutId);
177
141
  });
178
142
  const ms = Date.now() - t0;
143
+ // MRTR ラウンド(input_required)は SDK にそのまま渡す。respond() で包むと
144
+ // resultType が失われ、クライアントが確認要求を受け取れなくなる。
145
+ if (isInputRequiredResult(result)) {
146
+ logToolRun({ tool: name, input, result: { ok: true, summary: '[MRTR] input_required round' }, ms });
147
+ return result;
148
+ }
179
149
  logToolRun({ tool: name, input, result, ms });
180
- return respond(result);
150
+ const response = respond(result);
151
+ storeSnapshotIfUiTool(schema._meta, response, ctx);
152
+ return response;
181
153
  } catch (err: unknown) {
182
154
  const ms = Date.now() - t0;
183
155
  // ログには元のエラー詳細を残し、応答層は toPublicError で正規化する。
184
156
  logError(name, err, input);
185
157
  const publicErr = toPublicError(err);
186
- return {
158
+ const errorResponse: ToolReturn = {
187
159
  content: [{ type: 'text', text: publicErr.summary }],
188
160
  structuredContent: {
189
161
  ok: false,
@@ -191,6 +163,10 @@ function registerToolWithLog(
191
163
  meta: { ms, errorType: publicErr.errorType },
192
164
  },
193
165
  };
166
+ // エラー応答も ontoolresult で配信されるはずの内容なので、同様にスナップショットへ残す
167
+ // (UI 側は preview 未受領時の ok:false をエラー表示として扱う)。
168
+ storeSnapshotIfUiTool(schema._meta, errorResponse, ctx);
169
+ return errorResponse;
194
170
  }
195
171
  },
196
172
  );
@@ -205,7 +181,7 @@ for (const def of allToolDefs) {
205
181
  );
206
182
  }
207
183
 
208
- // === Register prompts (SDK 形式に寄せた最小導入) ===
184
+ // === Register prompts ===
209
185
 
210
186
  type PromptMessage = PromptDef['messages'][number];
211
187
  type ContentBlock = PromptMessage['content'][number];
@@ -234,29 +210,22 @@ function toSdkMessages(msgs: PromptMessage[]) {
234
210
  });
235
211
  }
236
212
 
237
- function registerPromptSafe(name: string, def: Pick<PromptDef, 'description' | 'messages'>) {
238
- const s = server as unknown as {
239
- registerPrompt?: (name: string, meta: { description: string }, cb: () => unknown) => void;
240
- };
241
- if (typeof s.registerPrompt === 'function') {
242
- registeredPrompts.push({ name, description: def.description });
243
- s.registerPrompt(name, { description: def.description }, () => ({
244
- description: def.description,
245
- messages: toSdkMessages(def.messages),
246
- }));
247
- }
248
- }
249
-
250
- // === Register prompts from src/prompts.ts ===
213
+ // SDK の registerPrompt は argsSchema の generics に厳密なため、引数なしプロンプトの
214
+ // 登録はキャストを集約して行う。prompts/list・prompts/get のルーティングは SDK が担う。
251
215
  for (const p of promptDefs) {
252
- registerPromptSafe(p.name, p);
216
+ (server as unknown as { registerPrompt: (n: string, c: unknown, cb: unknown) => void }).registerPrompt(
217
+ p.name,
218
+ { description: p.description },
219
+ () => ({
220
+ description: p.description,
221
+ messages: toSdkMessages(p.messages),
222
+ }),
223
+ );
253
224
  }
254
225
 
255
226
  // === Register MCP Apps UI resources ===
256
227
  // SDK の `registerResource` を使うことで `resources/list` と `resources/read` の
257
228
  // JSON-RPC ルーティングが SDK 内部で正しく行われる。
258
- // (以前の `setHandler('resources/...')` は SDK が要求する Zod スキーマではなく
259
- // 文字列を渡していたため silently no-op となり、本番で `Method not found` を返していた)
260
229
  for (const r of appResourceRegistry) {
261
230
  const config: Record<string, unknown> = {
262
231
  description: r.description,
@@ -287,63 +256,3 @@ for (const r of appResourceRegistry) {
287
256
  // === トランスポート接続 ===
288
257
  const transport = new StdioServerTransport();
289
258
  await server.connect(transport);
290
-
291
- // SDK の McpServer は setRequestHandler を public 型として export していないため、
292
- // 低レベル API アクセスのキャストをこのヘルパーに集約する。
293
- type HandlerFn = (request: unknown) => Promise<unknown>;
294
- function setHandler(method: string, fn: HandlerFn) {
295
- (server as unknown as { setRequestHandler?: (method: string, fn: HandlerFn) => void }).setRequestHandler?.(
296
- method,
297
- fn,
298
- );
299
- }
300
-
301
- // Fallback handlers to ensure list operations work over STDIO
302
- try {
303
- setHandler('tools/list', async () => ({
304
- tools: registeredTools.map((t) => ({
305
- name: t.name,
306
- description: t.description,
307
- inputSchema: t.inputSchema,
308
- ...(t._meta ? { _meta: t._meta } : {}),
309
- })),
310
- }));
311
- setHandler('prompts/list', async () => ({
312
- prompts: registeredPrompts.map((p) => ({ name: p.name, description: p.description })),
313
- }));
314
- // prompts/get: convert content arrays to single TextContent objects per MCP spec
315
- setHandler('prompts/get', async (request: unknown) => {
316
- try {
317
- const params = (request as { params?: { name?: string } })?.params;
318
- const name = params?.name;
319
- console.error('[prompts/get] Requested name:', name);
320
- if (!name) {
321
- throw new Error('Prompt name is required');
322
- }
323
-
324
- const promptDef = promptDefs.find((p) => p.name === name);
325
- if (!promptDef) {
326
- console.error('[prompts/get] ERROR: Prompt not found:', name);
327
- throw new Error(`Prompt not found: ${name}`);
328
- }
329
-
330
- console.error('[prompts/get] Found prompt:', name, 'with', promptDef.messages.length, 'messages');
331
- // prompts/get はテキストブロックのみ抽出(tool_code は除外)
332
- const messages = promptDef.messages.map((msg) => {
333
- const blocks: ContentBlock[] = Array.isArray(msg.content) ? msg.content : [];
334
- const text = blocks
335
- .filter((b): b is ContentBlock & { text: string } => b.type === 'text' && typeof b.text === 'string')
336
- .map((b) => b.text)
337
- .join('\n');
338
- return {
339
- role: msg.role === 'assistant' ? ('assistant' as const) : ('user' as const),
340
- content: { type: 'text' as const, text },
341
- };
342
- });
343
- return { description: promptDef.description, messages };
344
- } catch (error: unknown) {
345
- console.error('[prompts/get] EXCEPTION:', getErrorMessage(error));
346
- throw error;
347
- }
348
- });
349
- } catch {}
@@ -1,3 +1,4 @@
1
+ import type { InputRequiredResult } from '@modelcontextprotocol/server';
1
2
  import type { z } from 'zod';
2
3
  import type { Result } from './schemas.js';
3
4
 
@@ -10,9 +11,10 @@ export interface McpResponse {
10
11
  /**
11
12
  * ハンドラに渡される MCP リクエストコンテキスト。
12
13
  *
13
- * elicitation/sampling 等のサーバー → クライアント呼び出しを行うツール用。
14
- * SDK の `RequestHandlerExtra` をそのまま受け取れるよう構造的型で受ける。
15
- * `server` プロパティは server.ts 側で `McpServer` を合流させて注入する。
14
+ * MRTR(input_required)/ elicitation 等でリクエスト文脈を参照するツール用。
15
+ * SDK v2 の `ServerContext`(`mcpReq.inputResponses` / `mcpReq.requestState` 等)を
16
+ * そのまま受け取れるよう構造的型で受ける。
17
+ * `server` プロパティは server.ts 側で内部 `Server` を合流させて注入する。
16
18
  */
17
19
  export interface ToolHandlerExtra {
18
20
  [key: string]: unknown;
@@ -33,9 +35,10 @@ export interface ToolDefinition {
33
35
  inputSchema: z.ZodTypeAny;
34
36
  /**
35
37
  * MCP ハンドラ(入力を受けて結果を返す)。respond() で自動ラップされる。
36
- * 第2引数 `extra` は elicitation 等で SDK のサーバー機能にアクセスする必要があるツールのみ参照する。
38
+ * 第2引数 `extra` は MRTR / elicitation 等でリクエスト文脈にアクセスする必要があるツールのみ参照する。
39
+ * MRTR ラウンドでは `InputRequiredResult` を返してよい(server.ts が素通しする)。
37
40
  */
38
- handler(args: Record<string, unknown>, extra?: ToolHandlerExtra): Promise<Result | McpResponse>;
41
+ handler(args: Record<string, unknown>, extra?: ToolHandlerExtra): Promise<Result | McpResponse | InputRequiredResult>;
39
42
  /**
40
43
  * MCP ツール メタデータ。MCP Apps (SEP-1865) の `_meta.ui.resourceUri` 等を保持する。
41
44
  * 未対応ホストでは無視される(Progressive Enhancement)。
@@ -30,6 +30,7 @@ import { toolDef as getFlowMetrics } from '../tools/get_flow_metrics.js';
30
30
  import { toolDef as getOrderbook } from '../tools/get_orderbook.js';
31
31
  import { toolDef as getTicker } from '../tools/get_ticker.js';
32
32
  import { toolDef as getTransactions } from '../tools/get_transactions.js';
33
+ import { toolDef as getUiSnapshot } from '../tools/get_ui_snapshot.js';
33
34
  import { toolDef as prepareChartData } from '../tools/prepare_chart_data.js';
34
35
  import { toolDef as prepareDepthData } from '../tools/prepare_depth_data.js';
35
36
  import { toolDef as refreshPairsCache } from '../tools/refresh_pairs_cache.js';
@@ -106,6 +107,9 @@ export const allToolDefs: ToolDefinition[] = [
106
107
 
107
108
  // ── Maintenance (1) ──
108
109
  refreshPairsCache,
110
+
111
+ // ── MCP Apps support (1) ──
112
+ getUiSnapshot,
109
113
  ];
110
114
 
111
115
  // ── Private API tools(APIキー設定時のみ有効化) ──
@@ -0,0 +1,80 @@
1
+ /**
2
+ * MCP Apps ウィジェット向けの直近ツール応答スナップショット。
3
+ *
4
+ * 一部ホスト(2026-07-28 ロールアウト後の Claude Desktop 等)で
5
+ * `ui/notifications/tool-result` が iframe に配信されない事象が確認されている。
6
+ * その場合でもウィジェットが自力で内容を復元(pull 型 hydration)できるよう、
7
+ * `_meta.ui.resourceUri` を持つツールの直近の structuredContent を
8
+ * resourceUri 単位で保持し、`get_ui_snapshot` ツール経由で再提供する。
9
+ *
10
+ * セキュリティ境界:
11
+ * - ここで保持・返却するのは「ホストへ送信済みのツール応答」そのものであり、
12
+ * 新たな情報露出は発生しない(trust-host モードで token を含む場合も、
13
+ * ホストへ返した structuredContent と同一内容)。
14
+ * - stdio デプロイではプロセス = 単一接続のため接続間の境界は存在しないが、
15
+ * 将来のセッションを持つトランスポート追加に備え、エントリは保存時の
16
+ * sessionId にバインドし、取得時に一致を要求する(別セッションのスナップ
17
+ * ショット読み出し = IDOR を構造的に防ぐ)。stdio では sessionId は
18
+ * 保存・取得とも undefined で一致し、挙動は変わらない。
19
+ */
20
+
21
+ /** スナップショットの保持期間(ms)。確認フローの実用時間に合わせる。 */
22
+ const SNAPSHOT_TTL_MS = 5 * 60_000;
23
+
24
+ interface SnapshotEntry {
25
+ structuredContent: Record<string, unknown>;
26
+ storedAt: number;
27
+ /** 保存元接続のセッション ID。セッションレス(stdio)では undefined。 */
28
+ sessionId: string | undefined;
29
+ }
30
+
31
+ interface SnapshotScope {
32
+ /** 呼び出し元接続のセッション ID(ToolHandlerExtra の sessionId) */
33
+ sessionId?: string;
34
+ /** 現在時刻(テスト用にオーバーライド可能) */
35
+ nowMs?: number;
36
+ }
37
+
38
+ const snapshots = new Map<string, SnapshotEntry>();
39
+
40
+ /** ツール応答送出時に呼び、resourceUri 単位で最新スナップショットを保持する。 */
41
+ export function storeUiSnapshot(
42
+ resourceUri: string,
43
+ structuredContent: Record<string, unknown>,
44
+ scope: SnapshotScope = {},
45
+ ): void {
46
+ snapshots.set(resourceUri, {
47
+ structuredContent,
48
+ storedAt: scope.nowMs ?? Date.now(),
49
+ sessionId: scope.sessionId,
50
+ });
51
+ }
52
+
53
+ /**
54
+ * 有効期限内かつ同一セッションのスナップショットを返す。無ければ null。
55
+ * 保存時と異なるセッションからの取得は拒否する(stdio では両者 undefined で一致)。
56
+ */
57
+ export function getUiSnapshot(resourceUri: string, scope: SnapshotScope = {}): Record<string, unknown> | null {
58
+ const entry = snapshots.get(resourceUri);
59
+ if (!entry) return null;
60
+ if ((scope.nowMs ?? Date.now()) - entry.storedAt > SNAPSHOT_TTL_MS) {
61
+ snapshots.delete(resourceUri);
62
+ return null;
63
+ }
64
+ if (entry.sessionId !== scope.sessionId) return null;
65
+ return entry.structuredContent;
66
+ }
67
+
68
+ /**
69
+ * 指定リソースのスナップショットを破棄する。
70
+ * 取引実行(create_order / cancel_order(s))の成功時に呼び、実行済み内容の
71
+ * 「操作可能な確認カード」が再描画時に復元されて二重実行を誘発するのを防ぐ。
72
+ */
73
+ export function clearUiSnapshot(resourceUri: string): void {
74
+ snapshots.delete(resourceUri);
75
+ }
76
+
77
+ /** スナップショットをすべて破棄する(テスト用)。 */
78
+ export function _resetUiSnapshots(): void {
79
+ snapshots.clear();
80
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * get_ui_snapshot — MCP Apps ウィジェット向けの直近ツール応答スナップショット取得。
3
+ *
4
+ * 一部ホストで `ui/notifications/tool-result` が iframe に配信されない事象への
5
+ * 自己復元(pull 型 hydration)用。ウィジェットは接続成立後、一定時間結果通知が
6
+ * 届かない場合に本ツールを `app.callServerTool` で呼び、直近の preview 応答を
7
+ * 取得して自力で描画する。
8
+ *
9
+ * 返す内容は「ホストへ送信済みのツール応答の structuredContent」そのものであり、
10
+ * 新たな情報露出は無い(詳細は src/ui-snapshot-cache.ts のヘッダコメント参照)。
11
+ */
12
+
13
+ import { fail } from '../lib/result.js';
14
+ import { GetUiSnapshotInputSchema } from '../src/schema/ui.js';
15
+ import type { ToolDefinition } from '../src/tool-definition.js';
16
+ import { getUiSnapshot } from '../src/ui-snapshot-cache.js';
17
+
18
+ export const toolDef: ToolDefinition = {
19
+ name: 'get_ui_snapshot',
20
+ description: [
21
+ '[Internal / MCP Apps] 確認 UI(iframe)向けに、直近の preview 系ツール応答のスナップショットを返す。',
22
+ 'ホストがツール結果通知(ui/notifications/tool-result)を配信しない場合の UI 自己復元用。',
23
+ 'LLM が会話の応答生成のために呼ぶ必要はない(preview 系ツールの応答に同じ内容が含まれる)。',
24
+ ].join(' '),
25
+ inputSchema: GetUiSnapshotInputSchema,
26
+ handler: async (args, extra) => {
27
+ const { resource_uri } = args as { resource_uri: string };
28
+ // スナップショットは保存元接続の sessionId にバインドされている。
29
+ // 呼び出し元のセッションを渡し、別セッションからの読み出しを拒否する
30
+ // (stdio では両者 undefined で一致し、挙動は変わらない)。
31
+ const sessionId = (extra as { sessionId?: string } | undefined)?.sessionId;
32
+ const snapshot = getUiSnapshot(resource_uri, { sessionId });
33
+ if (!snapshot) {
34
+ return fail('表示できるスナップショットがありません。preview ツールを再実行してください', 'snapshot_not_found');
35
+ }
36
+ return {
37
+ content: [
38
+ {
39
+ type: 'text',
40
+ text: 'MCP Apps ウィジェット向けスナップショット(直近の preview 応答の再送。内容は元の応答と同一)',
41
+ },
42
+ ],
43
+ structuredContent: snapshot,
44
+ };
45
+ },
46
+ };
@@ -21,6 +21,7 @@ import type { OrderResponse } from '../../src/private/schemas.js';
21
21
  import { CancelOrderInputSchema, CancelOrderOutputSchema } from '../../src/private/schemas.js';
22
22
  import { failPrivateToolError } from '../../src/private/tool-error.js';
23
23
  import type { ToolDefinition } from '../../src/tool-definition.js';
24
+ import { clearUiSnapshot } from '../../src/ui-snapshot-cache.js';
24
25
 
25
26
  export default async function cancelOrder(
26
27
  args: {
@@ -78,6 +79,10 @@ export default async function cancelOrder(
78
79
  route,
79
80
  });
80
81
 
82
+ // 実行済み preview のスナップショットを無効化する(再描画で復元された古い確認
83
+ // カードからの二重キャンセル → bitbank 70019 を防ぐ)。
84
+ clearUiSnapshot('ui://cancel/confirm.html');
85
+
81
86
  return CancelOrderOutputSchema.parse(
82
87
  ok(
83
88
  summary,
@@ -15,6 +15,7 @@ import type { OrderResponse } from '../../src/private/schemas.js';
15
15
  import { CancelOrdersInputSchema, CancelOrdersOutputSchema } from '../../src/private/schemas.js';
16
16
  import { failPrivateToolError } from '../../src/private/tool-error.js';
17
17
  import type { ToolDefinition } from '../../src/tool-definition.js';
18
+ import { clearUiSnapshot } from '../../src/ui-snapshot-cache.js';
18
19
 
19
20
  export default async function cancelOrders(
20
21
  args: {
@@ -77,6 +78,9 @@ export default async function cancelOrders(
77
78
  route,
78
79
  });
79
80
 
81
+ // 実行済み preview のスナップショットを無効化(cancel_order と同趣旨)。
82
+ clearUiSnapshot('ui://cancel/confirm.html');
83
+
80
84
  return CancelOrdersOutputSchema.parse(
81
85
  ok(
82
86
  summary,
@@ -31,6 +31,7 @@ import type { OrderResponse } from '../../src/private/schemas.js';
31
31
  import { CreateOrderInputSchema, CreateOrderOutputSchema } from '../../src/private/schemas.js';
32
32
  import { failPrivateToolError } from '../../src/private/tool-error.js';
33
33
  import type { ToolDefinition } from '../../src/tool-definition.js';
34
+ import { clearUiSnapshot } from '../../src/ui-snapshot-cache.js';
34
35
 
35
36
  /** create_order がどの経路から呼ばれたかを示す監査ログ用のラベル */
36
37
  export type CreateOrderRoute = 'elicitation' | 'ui-button' | 'direct-text';
@@ -185,6 +186,10 @@ export default async function createOrder(
185
186
 
186
187
  const summary = lines.join('\n');
187
188
 
189
+ // 実行済み preview のスナップショットを無効化(発注済み内容の確認カードが
190
+ // 復元されて二重発注を誘発するのを防ぐ)。
191
+ clearUiSnapshot('ui://order/confirm.html');
192
+
188
193
  return CreateOrderOutputSchema.parse(
189
194
  ok(
190
195
  summary,
@@ -13,7 +13,7 @@
13
13
  */
14
14
 
15
15
  import { formatOrderPositionLabel, formatPair, formatPrice } from '../../lib/formatter.js';
16
- import { ok, toStructured } from '../../lib/result.js';
16
+ import { fail, ok, toStructured } from '../../lib/result.js';
17
17
  import { generateToken } from '../../src/private/confirmation.js';
18
18
  import { withElicitedConfirmation } from '../../src/private/elicitation.js';
19
19
  import type { OrderResponse } from '../../src/private/schemas.js';
@@ -55,6 +55,14 @@ export default async function previewCancelOrder(args: { pair: string; order_id:
55
55
  orderDetail = detailResult.data.order;
56
56
  }
57
57
 
58
+ // 既にキャンセル済みの注文はプレビュー段階で拒否する(復元された古いカードや
59
+ // 重複依頼による二重キャンセルを bitbank へ届く前に止める)。
60
+ if (orderDetail?.status?.startsWith('CANCELED')) {
61
+ return PreviewCancelOrderOutputSchema.parse(
62
+ fail(`この注文は既にキャンセル済みです(status: ${orderDetail.status})`, 'validation_error'),
63
+ );
64
+ }
65
+
58
66
  const tokenParams = { pair, order_id };
59
67
  const { token, expiresAt } = generateToken('cancel_order', tokenParams);
60
68
 
@@ -84,8 +92,8 @@ export const toolDef: ToolDefinition = {
84
92
  description: [
85
93
  '[Preview Cancel Order] 注文キャンセルのプレビュー。実際のキャンセルは行わない。Private API。',
86
94
  '⚠️ confirmation_token はクライアント側には返さない(content / structuredContent / _meta のいずれにも含めない)。',
87
- '実際のキャンセルは elicitation 対応ホストでのみ可能で、その場合はこのハンドラ内で preview → ユーザー確認 → cancel_order までを完結させる。',
88
- 'elicitation 非対応ホストではプレビュー内容のみ返し、キャンセル実行は受け付けない。',
95
+ '実際のキャンセルはユーザーの明示操作を経てチャット内で完結できる(elicitation/MRTR 対応ホストは確認ダイアログ、SEP-1865 + BITBANK_TRUST_HOST_APPROVAL=1 はチャット内確認カードの「キャンセルを確定する」ボタン)。',
96
+ 'いずれも不可のホストではプレビューのみ返し、キャンセル実行は受け付けない。ユーザーにはチャット内の確認手段を第一に案内し、bitbank アプリ/ウェブでのキャンセルは任意の代替手段として扱う。',
89
97
  ].join(' '),
90
98
  inputSchema: PreviewCancelOrderInputSchema,
91
99
  // MCP Apps (SEP-1865): 対応ホストでは iframe 内にキャンセル確認 UI を表示する。
@@ -108,7 +116,7 @@ export const toolDef: ToolDefinition = {
108
116
  result.summary,
109
117
  '',
110
118
  '※ このホストでは取引実行に対応していません。',
111
- ' 実際にキャンセルするには、elicitation 対応クライアント(Claude Desktop など)で同じ操作を実行してください。',
119
+ ' 実際にキャンセルするには、取引実行対応クライアント(Claude Desktop など)で同じ操作を行うか、bitbank アプリ/ウェブで該当注文をキャンセルしてください。',
112
120
  ].join('\n');
113
121
 
114
122
  // BITBANK_TRUST_HOST_APPROVAL=1 のときに使う妥協経路用のレスポンス。
@@ -116,8 +124,8 @@ export const toolDef: ToolDefinition = {
116
124
  const trustHostFallbackText = [
117
125
  result.summary,
118
126
  '',
119
- 'iframe の「キャンセルを確定する」ボタンを押してキャンセルを確定してください。',
120
- 'ボタンを押さない限りキャンセルは行われません。',
127
+ 'このチャットに表示される確認カードの「キャンセルを確定する」ボタンを押すと、キャンセルがチャット内で完結します。ボタンを押さない限りキャンセルは行われません。',
128
+ 'ユーザーへの案内: まず上記の確認カードのボタン操作を案内すること(キャンセルはこのチャット内で完了できる)。bitbank アプリ/ウェブで該当注文をキャンセルすることも可能だが、任意の代替手段として扱う。LLM 自身が cancel_order を呼んでキャンセルを代行してはならない(実行は必ずユーザーのボタン操作に委ねる)。',
121
129
  ].join('\n');
122
130
 
123
131
  // elicitation 対応ホストでは preview → ユーザー確認 → cancel_order までを
@@ -126,6 +134,8 @@ export const toolDef: ToolDefinition = {
126
134
  // から必ず剥がすため caller 側で sanitize する必要はない(最終ガードは helper 側)。
127
135
  return withElicitedConfirmation({
128
136
  extra,
137
+ action: 'cancel_order',
138
+ bindArgs: typedArgs as unknown as Record<string, unknown>,
129
139
  summary: result.summary,
130
140
  confirmTitle: 'この注文をキャンセルする',
131
141
  // 内部的に cancel_order を実行。監査ログには route='elicitation' で記録される。