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.
@@ -50,8 +50,8 @@ export const toolDef: ToolDefinition = {
50
50
  description: [
51
51
  '[Preview Cancel Orders] 一括キャンセルのプレビュー。実際のキャンセルは行わない。Private API。',
52
52
  '⚠️ confirmation_token はクライアント側には返さない(content / structuredContent / _meta のいずれにも含めない)。',
53
- '実際のキャンセルは elicitation 対応ホストでのみ可能で、その場合はこのハンドラ内で preview → ユーザー確認 → cancel_orders までを完結させる。',
54
- 'elicitation 非対応ホストではプレビュー内容のみ返し、キャンセル実行は受け付けない。',
53
+ '実際のキャンセルはユーザーの明示操作を経てチャット内で完結できる(elicitation/MRTR 対応ホストは確認ダイアログ、SEP-1865 + BITBANK_TRUST_HOST_APPROVAL=1 はチャット内確認カードの「キャンセルを確定する」ボタン)。',
54
+ 'いずれも不可のホストではプレビューのみ返し、キャンセル実行は受け付けない。ユーザーにはチャット内の確認手段を第一に案内し、bitbank アプリ/ウェブでのキャンセルは任意の代替手段として扱う。',
55
55
  ].join(' '),
56
56
  inputSchema: PreviewCancelOrdersInputSchema,
57
57
  // MCP Apps (SEP-1865): 対応ホストでは iframe 内にキャンセル確認 UI を表示する。
@@ -74,7 +74,7 @@ export const toolDef: ToolDefinition = {
74
74
  result.summary,
75
75
  '',
76
76
  '※ このホストでは取引実行に対応していません。',
77
- ' 実際に一括キャンセルするには、elicitation 対応クライアント(Claude Desktop など)で同じ操作を実行してください。',
77
+ ' 実際に一括キャンセルするには、取引実行対応クライアント(Claude Desktop など)で同じ操作を行うか、bitbank アプリ/ウェブで該当注文をキャンセルしてください。',
78
78
  ].join('\n');
79
79
 
80
80
  // BITBANK_TRUST_HOST_APPROVAL=1 のときに使う妥協経路用のレスポンス。
@@ -82,8 +82,8 @@ export const toolDef: ToolDefinition = {
82
82
  const trustHostFallbackText = [
83
83
  result.summary,
84
84
  '',
85
- 'iframe の「キャンセルを確定する」ボタンを押して一括キャンセルを確定してください。',
86
- 'ボタンを押さない限りキャンセルは行われません。',
85
+ 'このチャットに表示される確認カードの「キャンセルを確定する」ボタンを押すと、一括キャンセルがチャット内で完結します。ボタンを押さない限りキャンセルは行われません。',
86
+ 'ユーザーへの案内: まず上記の確認カードのボタン操作を案内すること(キャンセルはこのチャット内で完了できる)。bitbank アプリ/ウェブで該当注文をキャンセルすることも可能だが、任意の代替手段として扱う。LLM 自身が cancel_orders を呼んでキャンセルを代行してはならない(実行は必ずユーザーのボタン操作に委ねる)。',
87
87
  ].join('\n');
88
88
 
89
89
  // elicitation 対応ホストでは preview → ユーザー確認 → cancel_orders までを
@@ -92,6 +92,8 @@ export const toolDef: ToolDefinition = {
92
92
  // から必ず剥がすため caller 側で sanitize する必要はない(最終ガードは helper 側)。
93
93
  return withElicitedConfirmation({
94
94
  extra,
95
+ action: 'cancel_orders',
96
+ bindArgs: typedArgs as unknown as Record<string, unknown>,
95
97
  summary: result.summary,
96
98
  confirmTitle: `これら ${typedArgs.order_ids.length} 件の注文を一括キャンセルする`,
97
99
  // 内部的に cancel_orders を実行。監査ログには route='elicitation' で記録される。
@@ -262,8 +262,8 @@ export const toolDef: ToolDefinition = {
262
262
  '対応注文タイプは limit / market / stop / stop_limit の 4 種類のみ(take_profit / stop_loss / losscut は未対応)。',
263
263
  'position_side を指定すると信用注文として扱う(ロング新規=buy+long, ロング決済=sell+long, ショート新規=sell+short, ショート決済=buy+short)。',
264
264
  '⚠️ confirmation_token はクライアント側には返さない(content / structuredContent / _meta のいずれにも含めない)。',
265
- '実際の発注は elicitation 対応ホストでのみ可能で、その場合はこのハンドラ内で preview → ユーザー確認 → create_order までを完結させる。',
266
- 'elicitation 非対応ホストではプレビュー内容のみ返し、取引実行は受け付けない。',
265
+ '実際の発注はユーザーの明示操作を経てチャット内で完結できる(elicitation/MRTR 対応ホストは確認ダイアログ、SEP-1865 + BITBANK_TRUST_HOST_APPROVAL=1 はチャット内確認カードの「注文を確定する」ボタン)。',
266
+ 'いずれも不可のホストではプレビューのみ返し、取引実行は受け付けない。ユーザーにはチャット内の確認手段を第一に案内し、bitbank アプリ/ウェブでの手動発注は任意の代替手段として扱う。',
267
267
  ].join(' '),
268
268
  inputSchema: PreviewOrderInputSchema,
269
269
  // MCP Apps (SEP-1865): 対応ホストでは iframe 内に注文確認 UI を表示する。
@@ -295,7 +295,7 @@ export const toolDef: ToolDefinition = {
295
295
  result.summary,
296
296
  '',
297
297
  '※ このホストでは取引実行に対応していません。',
298
- ' 実際に発注するには、elicitation 対応クライアント(Claude Desktop など)で同じ操作を実行してください。',
298
+ ' 実際に発注するには、取引実行対応クライアント(Claude Desktop など)で同じ操作を行うか、bitbank アプリ/ウェブで同じ内容を手動発注してください。',
299
299
  ].join('\n');
300
300
 
301
301
  // BITBANK_TRUST_HOST_APPROVAL=1 のときに使う妥協経路用のレスポンス。
@@ -305,8 +305,8 @@ export const toolDef: ToolDefinition = {
305
305
  const trustHostFallbackText = [
306
306
  result.summary,
307
307
  '',
308
- 'iframe の「注文を確定する」ボタンを押して発注を確定してください。',
309
- 'ボタンを押さない限り発注は行われません。',
308
+ 'このチャットに表示される確認カードの「注文を確定する」ボタンを押すと、発注がチャット内で完結します。ボタンを押さない限り発注は行われません。',
309
+ 'ユーザーへの案内: まず上記の確認カードのボタン操作を案内すること(発注はこのチャット内で完了できる)。bitbank アプリ/ウェブで同じ内容を手動発注することも可能だが、任意の代替手段として扱う。LLM 自身が create_order を呼んで発注を代行してはならない(実行は必ずユーザーのボタン操作に委ねる)。',
310
310
  ].join('\n');
311
311
 
312
312
  // elicitation 対応ホストでは preview → ユーザー確認 → create_order までを
@@ -316,6 +316,8 @@ export const toolDef: ToolDefinition = {
316
316
  // caller 側で sanitize する必要はない(多層防御の最終ガードは helper 側)。
317
317
  return withElicitedConfirmation({
318
318
  extra,
319
+ action: 'create_order',
320
+ bindArgs: typedArgs as unknown as Record<string, unknown>,
319
321
  summary: result.summary,
320
322
  confirmTitle: 'この注文を発注する',
321
323
  // 内部的に create_order を実行。監査ログには route='elicitation' で記録される。
@@ -49,6 +49,15 @@ export async function svgToPng(
49
49
  return outputPath;
50
50
  }
51
51
 
52
+ /**
53
+ * ファイル名に埋め込む値からパス区切り・ドット等を除去する。
54
+ * pair は上流(ensurePair)で検証済みだが、ファイル名の安全性を
55
+ * 上流バリデーションに依存させないための防御的サニタイズ。
56
+ */
57
+ function sanitizeFilenamePart(part: string): string {
58
+ return part.replace(/[^a-zA-Z0-9_-]/g, '');
59
+ }
60
+
52
61
  /**
53
62
  * Generate a unique filename for backtest chart
54
63
  */
@@ -59,6 +68,6 @@ export function generateBacktestChartFilename(
59
68
  format: 'png' | 'svg' = 'png',
60
69
  ): string {
61
70
  const timestamp = dayjs().format('YYYY-MM-DDTHH-mm-ss');
62
- const safePair = pair.replace('_', '');
63
- return `backtest_${safePair}_${timeframe}_${strategy}_${timestamp}.${format}`;
71
+ const safePair = sanitizeFilenamePart(pair.replace('_', ''));
72
+ return `backtest_${safePair}_${sanitizeFilenamePart(timeframe)}_${sanitizeFilenamePart(strategy)}_${timestamp}.${format}`;
64
73
  }
@@ -7,6 +7,7 @@
7
7
  import { existsSync, mkdirSync } from 'node:fs';
8
8
  import { join } from 'node:path';
9
9
  import { dayjs, formatDateInTz } from '../../lib/datetime.js';
10
+ import { DEFAULT_CHART_OUTPUT_DIR, ensureAllowedOutputDir } from '../../lib/validate.js';
10
11
  import { prependWarnings } from '../../lib/warning-propagation.js';
11
12
  import { type BacktestEngineInput, type BacktestEngineResult, runBacktestEngine } from './lib/backtest_engine.js';
12
13
  import { fetchCandlesForBacktest } from './lib/fetch_candles.js';
@@ -21,7 +22,7 @@ import {
21
22
  import type { BacktestRange, Period, Timeframe } from './types.js';
22
23
 
23
24
  // Claude.ai のデフォルト出力ディレクトリ
24
- const DEFAULT_OUTPUT_DIR = '/mnt/user-data/outputs';
25
+ const DEFAULT_OUTPUT_DIR = DEFAULT_CHART_OUTPUT_DIR;
25
26
 
26
27
  /**
27
28
  * 書き込み可能なディレクトリを確保
@@ -48,7 +49,7 @@ export interface RunBacktestInput {
48
49
  strategy: StrategyConfig;
49
50
  fee_bp?: number;
50
51
  execution?: 't+1_open';
51
- /** 出力ディレクトリ(デフォルト: /mnt/user-data/outputs/) */
52
+ /** 出力ディレクトリ(デフォルト: /mnt/user-data/outputs/)。許可 root 配下のみ(lib/validate.ts の ensureAllowedOutputDir) */
52
53
  outputDir?: string;
53
54
  /** PNG ファイルを生成する(デフォルト: false、ファイルシステム非共有のため) */
54
55
  savePng?: boolean;
@@ -118,6 +119,17 @@ export default async function runBacktest(input: RunBacktestInput): Promise<RunB
118
119
  }
119
120
  const params = validation.normalizedParams;
120
121
 
122
+ // 出力ディレクトリをバリデーション(savePng 時のみ・fetch 前に弾く)。
123
+ // LLM 指定の任意パスへの書き込みを許可 root 配下に制限する。
124
+ let resolvedOutputDir: string | undefined;
125
+ if (savePng) {
126
+ const dirCheck = ensureAllowedOutputDir(outputDir);
127
+ if (!dirCheck.ok) {
128
+ return { ok: false, error: dirCheck.error.message };
129
+ }
130
+ resolvedOutputDir = dirCheck.dir;
131
+ }
132
+
121
133
  // 必要なバー数を params から動的に計算(ユーザーが long / slow / signal 等を
122
134
  // デフォルトより大きく指定した場合でもウォームアップを十分確保するため)
123
135
  const requiredBars = strategy.computeRequiredBars(params);
@@ -214,11 +226,11 @@ export default async function runBacktest(input: RunBacktestInput): Promise<RunB
214
226
  };
215
227
 
216
228
  // PNG ファイル保存(savePng: true の場合のみ)
217
- if (savePng && svg) {
229
+ if (savePng && svg && resolvedOutputDir) {
218
230
  try {
219
- ensureOutputDir(outputDir);
231
+ ensureOutputDir(resolvedOutputDir);
220
232
  const filename = generateBacktestChartFilename(pair, timeframe, strategyConfig.type, 'png');
221
- const pngPath = join(outputDir, filename);
233
+ const pngPath = join(resolvedOutputDir, filename);
222
234
  await svgToPng(svg, pngPath, { density: 150 });
223
235
  output.chartPath = pngPath;
224
236
  } catch (pngError) {