bitbank-lab-mcp 0.2.0 → 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/README.md +2 -2
- package/lib/validate.ts +70 -0
- package/package.json +3 -2
- package/src/lib/bitbank-errors.ts +2 -0
- package/src/private/elicitation.ts +141 -60
- package/src/private/request-state.ts +98 -0
- package/src/schema/backtest.ts +9 -1
- package/src/schema/index.ts +1 -0
- package/src/schema/ui.ts +16 -0
- package/src/server.ts +71 -162
- package/src/tool-definition.ts +8 -5
- package/src/tool-registry.ts +4 -0
- package/src/ui-snapshot-cache.ts +80 -0
- package/tools/get_ui_snapshot.ts +46 -0
- package/tools/private/cancel_order.ts +5 -0
- package/tools/private/cancel_orders.ts +4 -0
- package/tools/private/create_order.ts +5 -0
- package/tools/private/preview_cancel_order.ts +16 -6
- package/tools/private/preview_cancel_orders.ts +7 -5
- package/tools/private/preview_order.ts +7 -5
- package/tools/trading_process/lib/svg_to_png.ts +11 -2
- package/tools/trading_process/run_backtest.ts +17 -5
- package/ui/cancel-confirm/dist/cancel-confirm.html +61 -36
- package/ui/order-confirm/dist/order-confirm.html +55 -30
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/
|
|
3
|
-
import { StdioServerTransport } from '@modelcontextprotocol/
|
|
4
|
-
import { z } from 'zod';
|
|
5
|
-
import {
|
|
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(
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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
|
-
/**
|
|
83
|
-
*
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
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
|
-
//
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
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:
|
|
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>,
|
|
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
|
-
//
|
|
171
|
-
//
|
|
172
|
-
//
|
|
173
|
-
//
|
|
174
|
-
const handlerExtra = { ...
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
238
|
-
|
|
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
|
-
|
|
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 {}
|
package/src/tool-definition.ts
CHANGED
|
@@ -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
|
|
14
|
-
* SDK の `
|
|
15
|
-
*
|
|
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` は
|
|
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)。
|
package/src/tool-registry.ts
CHANGED
|
@@ -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
|
-
'
|
|
88
|
-
'
|
|
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
|
-
'
|
|
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
|
-
'
|
|
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' で記録される。
|