bitbank-lab-mcp 0.1.0

package/src/schema/market-data.ts

@@ -0,0 +1,298 @@
+import { z } from 'zod';
+import {
+	BaseMetaSchema,
+	BasePairInputSchema,
+	CandleSchema,
+	CandleTypeEnum,
+	FailResultSchema,
+	toolResultSchema,
+} from './base.js';
+
+// === Ticker ===
+export const TickerNormalizedSchema = z.object({
+	pair: z.string(),
+	last: z.number().nullable(),
+	buy: z.number().nullable(),
+	sell: z.number().nullable(),
+	open: z.number().nullable(),
+	high: z.number().nullable(),
+	low: z.number().nullable(),
+	volume: z.number().nullable(),
+	timestamp: z.number().nullable(),
+	isoTime: z.string().nullable(),
+});
+
+export const GetTickerDataSchemaOut = z.object({ raw: z.unknown(), normalized: TickerNormalizedSchema });
+export const GetTickerMetaSchemaOut = BaseMetaSchema;
+export const GetTickerOutputSchema = toolResultSchema(GetTickerDataSchemaOut, GetTickerMetaSchemaOut);
+export const GetTickerInputSchema = BasePairInputSchema;
+
+// === Orderbook ===
+export const OrderbookLevelSchema = z.object({ price: z.number(), size: z.number() });
+export const OrderbookLevelWithCumSchema = OrderbookLevelSchema.extend({ cumSize: z.number() });
+export const OrderbookNormalizedSchema = z.object({
+	pair: z.string(),
+	bestBid: z.number().nullable(),
+	bestAsk: z.number().nullable(),
+	spread: z.number().nullable(),
+	mid: z.number().nullable(),
+	bids: z.array(OrderbookLevelWithCumSchema),
+	asks: z.array(OrderbookLevelWithCumSchema),
+	timestamp: z.number().nullable(),
+	isoTime: z.string().nullable(),
+});
+export const GetOrderbookDataSchemaOut = z.object({ raw: z.unknown(), normalized: OrderbookNormalizedSchema });
+export const GetOrderbookMetaSchemaOut = BaseMetaSchema.extend({ topN: z.number(), count: z.number() });
+export const GetOrderbookOutputSchema = toolResultSchema(GetOrderbookDataSchemaOut, GetOrderbookMetaSchemaOut);
+
+export const GetOrderbookInputSchema = BasePairInputSchema.extend({
+	mode: z.enum(['summary', 'pressure', 'statistics', 'raw']).optional().default('summary'),
+	/** summary mode: 上位N層 (1-200) */
+	topN: z.number().int().min(1).max(200).optional().default(10),
+	/** pressure mode: 帯域幅 (例: [0.001, 0.005, 0.01]) */
+	bandsPct: z.array(z.number().positive()).optional().default([0.001, 0.005, 0.01]),
+	/** statistics mode: 範囲% (例: [0.5, 1.0, 2.0]) */
+	ranges: z.array(z.number().positive()).optional().default([0.5, 1.0, 2.0]),
+	/** statistics mode: 価格ゾーン分割数 */
+	priceZones: z.number().int().min(2).max(50).optional().default(10),
+});
+
+// === Candles ===
+export const KeyPointSchema = z.object({
+	index: z.number(),
+	date: z.string().nullable(),
+	close: z.number(),
+	changePct: z.number().nullable().optional(),
+});
+
+export const KeyPointsSchema = z.object({
+	today: KeyPointSchema.nullable(),
+	sevenDaysAgo: KeyPointSchema.nullable(),
+	thirtyDaysAgo: KeyPointSchema.nullable(),
+	ninetyDaysAgo: KeyPointSchema.nullable(),
+});
+
+export const VolumeStatsSchema = z.object({
+	recent7DaysAvg: z.number(),
+	previous7DaysAvg: z.number(),
+	last30DaysAvg: z.number().nullable(),
+	changePct: z.number(),
+	judgment: z.string(),
+});
+
+export const GetCandlesDataSchemaOut = z.object({
+	raw: z.unknown(),
+	normalized: z.array(CandleSchema),
+	keyPoints: KeyPointsSchema.optional(),
+	volumeStats: VolumeStatsSchema.nullable().optional(),
+});
+export const GetCandlesMetaSchemaOut = BaseMetaSchema.extend({
+	type: CandleTypeEnum,
+	count: z.number(),
+});
+export const GetCandlesOutputSchema = toolResultSchema(GetCandlesDataSchemaOut, GetCandlesMetaSchemaOut);
+
+export const GetCandlesInputSchema = z.object({
+	pair: z.string(),
+	type: CandleTypeEnum,
+	date: z
+		.string()
+		.optional()
+		.describe(
+			"YYYYMMDD format (e.g., 20251022). Fetches the {limit} most recent candles up to and including this date. For '1month' type use YYYY format. If omitted, returns latest candles.",
+		),
+	limit: z.number().int().min(1).max(1000).optional().default(200),
+	view: z.enum(['full', 'items']).optional().default('full'),
+	tz: z
+		.string()
+		.optional()
+		.default('Asia/Tokyo')
+		.describe('タイムゾーン（デフォルト: Asia/Tokyo）。各ローソク足に isoTimeLocal フィールドを追加。空文字でUTCのみ'),
+});
+
+// === Transactions ===
+export const TransactionItemSchema = z.object({
+	price: z.number(),
+	amount: z.number(),
+	side: z.enum(['buy', 'sell']),
+	timestampMs: z.number().int(),
+	isoTime: z.string(),
+});
+
+export const GetTransactionsDataSchemaOut = z.object({ raw: z.unknown(), normalized: z.array(TransactionItemSchema) });
+export const GetTransactionsMetaSchemaOut = BaseMetaSchema.extend({
+	count: z.number().int(),
+	source: z.enum(['latest', 'by_date']),
+});
+export const GetTransactionsOutputSchema = toolResultSchema(GetTransactionsDataSchemaOut, GetTransactionsMetaSchemaOut);
+
+export const GetTransactionsInputSchema = BasePairInputSchema.extend({
+	limit: z.number().int().min(1).max(1000).optional().default(100),
+	date: z
+		.string()
+		.regex(/^\d{8}$/)
+		.optional()
+		.describe('YYYYMMDD; omit for latest'),
+	minAmount: z.number().positive().optional(),
+	maxAmount: z.number().positive().optional(),
+	minPrice: z.number().positive().optional(),
+	maxPrice: z.number().positive().optional(),
+	view: z.enum(['summary', 'items']).optional().default('summary'),
+});
+
+// === Depth (raw depth for analysis/visualization) ===
+export const DepthLevelTupleSchema = z.tuple([z.string(), z.string()]);
+export const GetDepthDataSchemaOut = z.object({
+	asks: z.array(DepthLevelTupleSchema),
+	bids: z.array(DepthLevelTupleSchema),
+	asks_over: z.string().optional(),
+	asks_under: z.string().optional(),
+	bids_over: z.string().optional(),
+	bids_under: z.string().optional(),
+	ask_market: z.string().optional(),
+	bid_market: z.string().optional(),
+	timestamp: z.number().int(),
+	sequenceId: z.number().int().optional(),
+	overlays: z
+		.object({
+			depth_zones: z.array(
+				z.object({ low: z.number(), high: z.number(), color: z.string().optional(), label: z.string().optional() }),
+			),
+		})
+		.optional(),
+});
+export const GetDepthMetaSchemaOut = BaseMetaSchema;
+export const GetDepthOutputSchema = toolResultSchema(GetDepthDataSchemaOut, GetDepthMetaSchemaOut);
+
+// === Flow Metrics (derived from recent transactions) ===
+export const FlowBucketSchema = z.object({
+	timestampMs: z.number().int(),
+	isoTime: z.string(),
+	isoTimeJST: z.string().optional(),
+	displayTime: z.string().optional(),
+	buyVolume: z.number(),
+	sellVolume: z.number(),
+	totalVolume: z.number(),
+	cvd: z.number(),
+	zscore: z.number().nullable().optional(),
+	spike: z.enum(['notice', 'warning', 'strong']).nullable().optional(),
+});
+
+export const GetFlowMetricsDataSchemaOut = z.object({
+	source: z.literal('transactions'),
+	params: z.object({ bucketMs: z.number().int().min(1000) }),
+	aggregates: z.object({
+		totalTrades: z.number().int(),
+		buyTrades: z.number().int(),
+		sellTrades: z.number().int(),
+		buyVolume: z.number(),
+		sellVolume: z.number(),
+		netVolume: z.number(),
+		aggressorRatio: z.number().min(0).max(1),
+		finalCvd: z.number(),
+	}),
+	series: z.object({ buckets: z.array(FlowBucketSchema) }),
+});
+
+export const GetFlowMetricsMetaSchemaOut = BaseMetaSchema.extend({
+	count: z.number().int(),
+	bucketMs: z.number().int(),
+	timezone: z.string().optional(),
+	timezoneOffset: z.string().optional(),
+	serverTime: z.string().optional(),
+	hours: z.number().optional(),
+	mode: z.enum(['time_range']).optional(),
+	actualRange: z
+		.object({
+			start: z.string(),
+			end: z.string(),
+			durationMinutes: z.number().int(),
+		})
+		.optional(),
+	warning: z.string().optional(),
+});
+
+export const GetFlowMetricsOutputSchema = toolResultSchema(GetFlowMetricsDataSchemaOut, GetFlowMetricsMetaSchemaOut);
+
+export const GetFlowMetricsInputSchema = BasePairInputSchema.extend({
+	limit: z
+		.number()
+		.int()
+		.min(1)
+		.max(2000)
+		.optional()
+		.default(100)
+		.describe('取得する約定件数（バケット数ではない）。hours 指定時は無視されます'),
+	hours: z
+		.number()
+		.min(0.1)
+		.max(24)
+		.optional()
+		.describe(
+			'指定した時間数分の約定を取得して分析（例: 8 → 直近8時間）。limit より優先。複数日にまたがる場合も自動で取得します',
+		),
+	date: z
+		.string()
+		.regex(/^\d{8}$/)
+		.optional()
+		.describe('YYYYMMDD; omit for latest'),
+	bucketMs: z
+		.number()
+		.int()
+		.min(1000)
+		.max(3600_000)
+		.optional()
+		.default(60_000)
+		.describe('バケットの時間幅（ミリ秒）。デフォルト60000=1分間隔'),
+	view: z
+		.enum(['summary', 'compact', 'buckets', 'full'])
+		.optional()
+		.default('summary')
+		.describe(
+			'summary: 集計値のみ (buckets 省略) / compact: 非ゼロバケットのみ / buckets: 直近 N バケット / full: 全バケット',
+		),
+	bucketsN: z.number().int().min(1).max(100).optional().default(10),
+	tz: z.string().optional().default('Asia/Tokyo'),
+});
+
+// === /tickers_jpy (public REST) ===
+export const TickerJpyItemSchema = z.object({
+	pair: z.string(),
+	sell: z.string().nullable(),
+	buy: z.string().nullable(),
+	high: z.string(),
+	low: z.string(),
+	open: z.string(),
+	last: z.string(),
+	vol: z.string(),
+	timestamp: z.number(),
+	// 追加: 24h変化率（%）。open/last から算出
+	change24h: z.number().nullable().optional(),
+	change24hPct: z.number().nullable().optional(),
+});
+export const GetTickersJpyOutputSchema = z.union([
+	z.object({
+		ok: z.literal(true),
+		summary: z.string(),
+		data: z.array(TickerJpyItemSchema),
+		meta: z.object({ cache: z.object({ hit: z.boolean(), key: z.string() }).optional(), ts: z.string() }).passthrough(),
+	}),
+	FailResultSchema,
+]);
+
+// === Market Summary (tickers + volatility snapshot) ===
+export const MarketSummaryItemSchema = z.object({
+	pair: z.string(),
+	last: z.number().nullable(),
+	change24hPct: z.number().nullable().optional(),
+	vol24h: z.number().nullable().optional(),
+	rv_std_ann: z.number().nullable().optional(),
+	vol_bucket: z.enum(['low', 'mid', 'high']).nullable().optional(),
+	tags: z.array(z.string()).optional(),
+});
+
+export const MarketSummaryRanksSchema = z.object({
+	topGainers: z.array(z.object({ pair: z.string(), change24hPct: z.number().nullable() })).optional(),
+	topLosers: z.array(z.object({ pair: z.string(), change24hPct: z.number().nullable() })).optional(),
+	topVolatility: z.array(z.object({ pair: z.string(), rv_std_ann: z.number().nullable() })).optional(),
+});

package/src/schema/patterns.ts

@@ -0,0 +1,382 @@
+import { z } from 'zod';
+import { BaseMetaSchema, BasePairInputSchema, CandleTypeEnum, FailResultSchema, toolResultSchema } from './base.js';
+
+// === Pattern Detection ===
+export const PatternTypeEnum = z.enum([
+	'double_top',
+	'double_bottom',
+	'triple_top',
+	'triple_bottom',
+	'head_and_shoulders',
+	'inverse_head_and_shoulders',
+	// legacy umbrella key (kept for filter-compat)
+	'triangle',
+	// new explicit triangle variants
+	'triangle_ascending',
+	'triangle_descending',
+	'triangle_symmetrical',
+	// wedge patterns
+	'falling_wedge',
+	'rising_wedge',
+	'pennant',
+	'flag',
+]);
+
+export const DetectPatternsInputSchema = BasePairInputSchema.extend({
+	type: CandleTypeEnum.optional().default('1day'),
+	limit: z.number().int().min(20).max(365).optional().default(90),
+	patterns: z
+		.array(PatternTypeEnum)
+		.optional()
+		.describe(
+			[
+				'Patterns to detect. Recommended params (guideline):',
+				'- double_top/double_bottom: default (swingDepth=7, tolerancePct=0.04, minBarsBetweenSwings=5)',
+				'- triple_top/triple_bottom: tolerancePct≈0.05',
+				'- triangle_*: tolerancePct≈0.06',
+				'- pennant: swingDepth≈5, minBarsBetweenSwings≈3',
+			].join('\n'),
+		),
+	// Heuristics
+	swingDepth: z.number().int().min(1).max(10).optional().default(7),
+	tolerancePct: z.number().min(0).max(0.1).optional().default(0.04),
+	minBarsBetweenSwings: z.number().int().min(1).max(30).optional().default(5),
+	view: z.enum(['summary', 'detailed', 'full', 'debug']).optional().default('detailed'),
+	// New: relevance filter for "current-involved" long-term patterns
+	requireCurrentInPattern: z.boolean().optional().default(false),
+	currentRelevanceDays: z.number().int().min(1).max(365).optional().default(7),
+
+	// Unified pattern lifecycle options
+	includeForming: z.boolean().optional().default(false).describe('形成中パターンを含める'),
+	includeCompleted: z.boolean().optional().default(true).describe('完成済みパターンを含める'),
+	includeInvalid: z.boolean().optional().default(false).describe('無効化済みパターンを含める'),
+});
+
+export const DetectedPatternSchema = z.object({
+	type: PatternTypeEnum,
+	confidence: z.number().min(0).max(1),
+	/** 検出に使用した時間足（例: '1day', '4hour', '1week'） */
+	timeframe: CandleTypeEnum.optional(),
+	/** 人間可読な時間足ラベル（例: '日足', '4時間足', '週足'） */
+	timeframeLabel: z.string().optional(),
+	range: z.object({ start: z.string(), end: z.string() }),
+	pivots: z.array(z.object({ idx: z.number().int(), price: z.number() })).optional(),
+	neckline: z
+		.array(z.object({ x: z.number().int().optional(), y: z.number() }))
+		.length(2)
+		.optional(),
+	// Optional: structure diagram (static SVG artifact to help beginners grok the pattern shape)
+	structureDiagram: z
+		.object({
+			svg: z.string(),
+			artifact: z.object({ identifier: z.string(), title: z.string() }),
+		})
+		.optional(),
+	// 統合: パターンのステータス（形成中/完成度近し/完成済み/無効化）
+	status: z.enum(['forming', 'near_completion', 'completed', 'invalid']).optional(),
+	// 形成中パターン用フィールド
+	apexDate: z.string().optional(), // アペックス（頂点）到達予定日
+	daysToApex: z.number().int().optional(), // アペックスまでの日数
+	completionPct: z.number().int().optional(), // 完成度（%）
+	// 完成済みパターン用フィールド
+	breakoutDate: z.string().optional(), // ブレイクアウト日
+	breakoutBarIndex: z.number().int().optional(), // ブレイクアウトしたローソク足のインデックス
+	daysSinceBreakout: z.number().int().optional(), // ブレイクアウトからの経過日数
+	// ブレイク方向と結果
+	breakoutDirection: z.enum(['up', 'down']).optional(), // ブレイク方向
+	outcome: z.enum(['success', 'failure']).optional(), // パターン結果（期待通り=success, 逆方向=failure）
+	// ターゲット価格（ブレイクアウト後の想定到達価格）
+	breakoutTarget: z.number().optional(), // 想定ターゲット価格（円）
+	targetMethod: z.enum(['flagpole_projection', 'pattern_height', 'neckline_projection']).optional(), // 計算根拠
+	targetReachedPct: z.number().optional(), // ターゲットまでの進捗率（%）
+	// 用語正規化ラベル（neckline フィールドが何を指すかをパターン種別ごとに明示）
+	trendlineLabel: z.string().optional(),
+	// ペナント用: フラッグポール（旗竿）情報
+	poleDirection: z.enum(['up', 'down']).optional(), // フラッグポールの方向
+	priorTrendDirection: z.enum(['bullish', 'bearish']).optional(), // 先行トレンド方向
+	isTrendContinuation: z.boolean().optional(), // ブレイク方向が先行トレンドと一致しているか
+	flagpoleHeight: z.number().optional(), // フラッグポールの値幅
+	retracementRatio: z.number().optional(), // フラッグポールに対する戻し比率（0.38未満ならペナント的）
+	aftermath: z
+		.object({
+			breakoutDate: z.string().nullable().optional(),
+			breakoutConfirmed: z.boolean(),
+			priceMove: z
+				.object({
+					days3: z.object({ return: z.number(), high: z.number(), low: z.number() }).nullable().optional(),
+					days7: z.object({ return: z.number(), high: z.number(), low: z.number() }).nullable().optional(),
+					days14: z.object({ return: z.number(), high: z.number(), low: z.number() }).nullable().optional(),
+				})
+				.optional(),
+			targetReached: z.boolean(),
+			theoreticalTarget: z.number().nullable().optional(),
+			outcome: z.string(),
+			// New: number of bars (days for 1day, weeks for 1week, etc.) to reach theoretical target (if reached within evaluation window)
+			daysToTarget: z.number().int().nullable().optional(),
+		})
+		.optional(),
+});
+
+export const DetectPatternsOutputSchema = z.union([
+	z.object({
+		ok: z.literal(true),
+		summary: z.string(),
+		data: z.object({
+			patterns: z.array(DetectedPatternSchema),
+			overlays: z
+				.object({
+					ranges: z
+						.array(
+							z.object({
+								start: z.string(),
+								end: z.string(),
+								color: z.string().optional(),
+								label: z.string().optional(),
+							}),
+						)
+						.optional(),
+					annotations: z.array(z.object({ isoTime: z.string(), text: z.string() })).optional(),
+				})
+				.optional(),
+			warnings: z
+				.array(
+					z.object({
+						type: z.string(),
+						message: z.string(),
+						suggestedParams: z.record(z.string(), z.any()).optional(),
+					}),
+				)
+				.optional(),
+			statistics: z
+				.record(
+					z.string(),
+					z.object({
+						detected: z.number().int(),
+						withAftermath: z.number().int(),
+						successRate: z.number().nullable(),
+						avgReturn7d: z.number().nullable(),
+						avgReturn14d: z.number().nullable(),
+						medianReturn7d: z.number().nullable(),
+					}),
+				)
+				.optional(),
+		}),
+		meta: z.object({
+			pair: z.string(),
+			type: CandleTypeEnum,
+			count: z.number().int(),
+			visualization_hints: z
+				.object({
+					preferred_style: z.enum(['candles', 'line']).optional(),
+					highlight_patterns: z.array(PatternTypeEnum).optional(),
+				})
+				.optional(),
+			debug: z
+				.object({
+					swings: z
+						.array(
+							z.object({
+								idx: z.number().int(),
+								price: z.number(),
+								kind: z.enum(['H', 'L']),
+								isoTime: z.string().optional(),
+							}),
+						)
+						.optional(),
+					candidates: z
+						.array(
+							z.object({
+								type: PatternTypeEnum,
+								accepted: z.boolean(),
+								reason: z.string().optional(),
+								indices: z.array(z.number().int()).optional(),
+								points: z
+									.array(
+										z.object({
+											role: z.string(),
+											idx: z.number().int(),
+											price: z.number(),
+											isoTime: z.string().optional(),
+										}),
+									)
+									.optional(),
+								details: z.any().optional(),
+							}),
+						)
+						.optional(),
+				})
+				.optional(),
+		}),
+	}),
+	FailResultSchema,
+]);
+
+// === Candle Patterns (2-bar patterns: engulfing, harami, etc.) ===
+
+export const CandlePatternTypeEnum = z.enum([
+	// 2本足パターン (Phase 1-2)
+	'bullish_engulfing',
+	'bearish_engulfing',
+	'bullish_harami',
+	'bearish_harami',
+	'tweezer_top',
+	'tweezer_bottom',
+	'dark_cloud_cover',
+	'piercing_line',
+	// 1本足パターン (Phase 3)
+	'hammer',
+	'shooting_star',
+	'doji',
+	// 3本足パターン (Phase 3)
+	'morning_star',
+	'evening_star',
+	'three_white_soldiers',
+	'three_black_crows',
+]);
+
+export const AnalyzeCandlePatternsInputSchema = z.object({
+	pair: z.string().optional().default('btc_jpy'),
+	timeframe: z.literal('1day').optional().default('1day'),
+	// as_of: 主要パラメータ名（ISO形式 "2025-11-05" または YYYYMMDD "20251105" を受け付け）
+	as_of: z
+		.string()
+		.optional()
+		.describe('Date to analyze (ISO "2025-11-05" or YYYYMMDD "20251105"). If omitted, uses latest data.'),
+	// date: 互換性のため残す（as_of が優先）
+	date: z
+		.string()
+		.regex(/^\d{8}$/)
+		.optional()
+		.describe('DEPRECATED: Use as_of instead. YYYYMMDD format.'),
+	window_days: z.number().int().min(3).max(10).optional().default(5),
+	focus_last_n: z.number().int().min(2).max(5).optional().default(5),
+	patterns: z
+		.array(CandlePatternTypeEnum)
+		.optional()
+		.describe('Patterns to detect. If omitted, all patterns are checked.'),
+	history_lookback_days: z.number().int().min(30).max(365).optional().default(180),
+	history_horizons: z.array(z.number().int().min(1).max(10)).optional().default([1, 3, 5]),
+	allow_partial_patterns: z.boolean().optional().default(true),
+});
+
+const HistoryHorizonStatsSchema = z.object({
+	avg_return: z.number(),
+	win_rate: z.number(),
+	sample: z.number().int(),
+});
+
+const HistoryStatsSchema = z.object({
+	lookback_days: z.number().int(),
+	occurrences: z.number().int(),
+	horizons: z.record(z.string(), HistoryHorizonStatsSchema),
+});
+
+const LocalContextSchema = z.object({
+	trend_before: z.enum(['up', 'down', 'neutral']),
+	volatility_level: z.enum(['low', 'medium', 'high']),
+});
+
+const DetectedCandlePatternSchema = z.object({
+	pattern: CandlePatternTypeEnum,
+	pattern_jp: z.string(),
+	direction: z.enum(['bullish', 'bearish', 'neutral']),
+	strength: z.number().min(0).max(1),
+	candle_range_index: z.tuple([z.number().int(), z.number().int()]),
+	uses_partial_candle: z.boolean(),
+	status: z.enum(['confirmed', 'forming']),
+	local_context: LocalContextSchema,
+	history_stats: HistoryStatsSchema.nullable(),
+});
+
+const WindowCandleSchema = z.object({
+	timestamp: z.string(),
+	open: z.number(),
+	high: z.number(),
+	low: z.number(),
+	close: z.number(),
+	volume: z.number(),
+	is_partial: z.boolean(),
+});
+
+export const AnalyzeCandlePatternsDataSchemaOut = z.object({
+	pair: z.string(),
+	timeframe: z.string(),
+	snapshot_time: z.string(),
+	window: z.object({
+		from: z.string(),
+		to: z.string(),
+		candles: z
+			.array(WindowCandleSchema)
+			.describe(
+				'CRITICAL: Array order is [oldest, ..., newest]. index 0 = most distant, index n-1 = latest (possibly partial).',
+			),
+	}),
+	recent_patterns: z.array(DetectedCandlePatternSchema),
+	summary: z.string(),
+});
+
+export const AnalyzeCandlePatternsMetaSchemaOut = BaseMetaSchema.extend({
+	timeframe: z.string(),
+	as_of: z.string().nullable().describe('Original input value (ISO or YYYYMMDD)'),
+	date: z.string().nullable().describe('YYYYMMDD normalized, null for latest'),
+	window_days: z.number().int(),
+	patterns_checked: z.array(CandlePatternTypeEnum),
+	history_lookback_days: z.number().int(),
+	history_horizons: z.array(z.number().int()),
+});
+
+export const AnalyzeCandlePatternsOutputSchema = z.union([
+	z.object({
+		ok: z.literal(true),
+		summary: z.string(),
+		content: z.array(z.object({ type: z.literal('text'), text: z.string() })).optional(),
+		data: AnalyzeCandlePatternsDataSchemaOut,
+		meta: AnalyzeCandlePatternsMetaSchemaOut,
+	}),
+	FailResultSchema,
+]);
+
+// === Candle Pattern Diagram (2-bar pattern visualization) ===
+
+const DiagramCandleSchema = z.object({
+	date: z.string().describe('Display date e.g. "11/6(木)"'),
+	open: z.number(),
+	high: z.number(),
+	low: z.number(),
+	close: z.number(),
+	type: z.enum(['bullish', 'bearish']),
+	isPartial: z.boolean().optional(),
+});
+
+const DiagramPatternSchema = z.object({
+	name: z.string().describe('Pattern name in Japanese e.g. "陽線包み線"'),
+	nameEn: z.string().optional().describe('Pattern name in English e.g. "bullish_engulfing"'),
+	confirmedDate: z.string().describe('Confirmed date e.g. "11/9(日)"'),
+	involvedIndices: z.tuple([z.number().int().min(0), z.number().int().min(0)]).describe('[prevIndex, confirmedIndex]'),
+	direction: z.enum(['bullish', 'bearish']).optional(),
+});
+
+export const RenderCandlePatternDiagramInputSchema = z.object({
+	candles: z.array(DiagramCandleSchema).min(2).max(10).describe('Candle data array (oldest first)'),
+	pattern: DiagramPatternSchema.optional().describe('Pattern to highlight'),
+	title: z.string().optional().describe('Chart title (default: pattern name or "ローソク足チャート")'),
+	theme: z.enum(['dark', 'light']).optional().default('dark'),
+});
+
+export const RenderCandlePatternDiagramDataSchemaOut = z.object({
+	svg: z.string().optional(),
+	filePath: z.string().optional(),
+	url: z.string().optional(),
+});
+
+export const RenderCandlePatternDiagramMetaSchemaOut = z.object({
+	width: z.number().int(),
+	height: z.number().int(),
+	candleCount: z.number().int(),
+	patternName: z.string().nullable(),
+});
+
+export const RenderCandlePatternDiagramOutputSchema = toolResultSchema(
+	RenderCandlePatternDiagramDataSchemaOut,
+	RenderCandlePatternDiagramMetaSchemaOut,
+);