bitbank-lab-mcp 0.1.0

package/tools/private/get_my_trade_history.ts

@@ -0,0 +1,229 @@
+/**
+ * get_my_trade_history — 自分の約定履歴を取得する Private API ツール。
+ *
+ * bitbank Private API `/v1/user/spot/trade_history` を呼び出し、
+ * LLM が分析しやすい形に整形して返す。
+ *
+ * - 自動ページネーション: count > PAGE_SIZE (1000) の場合、cursor ベースで
+ *   複数回リクエストし全件取得を試みる（最大 MAX_PAGES ページ）。
+ * - isComplete フラグ: 全件取得できたかどうかを meta に含める。
+ */
+
+import { nowIso, parseIso8601, toIsoMs } from '../../lib/datetime.js';
+import { formatPair, formatPrice } from '../../lib/formatter.js';
+import { fail, ok } from '../../lib/result.js';
+import { type BitbankPrivateClient, getDefaultClient, PrivateApiError } from '../../src/private/client.js';
+import { GetMyTradeHistoryInputSchema, GetMyTradeHistoryOutputSchema } from '../../src/private/schemas.js';
+import type { ToolDefinition } from '../../src/tool-definition.js';
+
+/** bitbank /v1/user/spot/trade_history のレスポンス型 */
+interface RawTrade {
+	trade_id: number;
+	pair: string;
+	order_id: number;
+	side: string;
+	position_side?: string;
+	type: string;
+	amount: string;
+	price: string;
+	maker_taker: string;
+	fee_amount_base: string;
+	fee_amount_quote: string;
+	profit_loss?: string;
+	interest?: string;
+	executed_at: number;
+}
+
+// ── ページネーション設定 ──
+const PAGE_SIZE = 1000;
+const MAX_PAGES = 10;
+
+/**
+ * cursor ベースの自動ページネーション（asc 順で取得し、最後の executed_at + 1 を since に）。
+ * since/end が外部指定されている場合でもページネーションする。
+ */
+async function paginateTrades(
+	client: BitbankPrivateClient,
+	baseParams: Record<string, string>,
+	limit: number,
+): Promise<{ trades: RawTrade[]; isComplete: boolean }> {
+	const all: RawTrade[] = [];
+	let since: string | undefined = baseParams.since;
+
+	for (let page = 0; page < MAX_PAGES; page++) {
+		const params: Record<string, string> = {
+			...baseParams,
+			count: String(PAGE_SIZE),
+			order: 'asc',
+			...(since ? { since } : {}),
+		};
+		const rawData = await client.get<{ trades: RawTrade[] }>(
+			'/v1/user/spot/trade_history',
+			Object.keys(params).length > 0 ? params : undefined,
+		);
+		const batch = rawData.trades || [];
+		all.push(...batch);
+
+		// 取得件数が PAGE_SIZE 未満 → 全件取得完了
+		if (batch.length < PAGE_SIZE) {
+			return { trades: all.slice(0, limit), isComplete: true };
+		}
+
+		// limit に達したら打ち切り（全件取得済みかは不明）
+		if (all.length >= limit) {
+			return { trades: all.slice(0, limit), isComplete: true };
+		}
+
+		// 次ページ: 最後の約定の executed_at + 1ms を since に
+		const lastTs = batch[batch.length - 1]?.executed_at;
+		if (!lastTs) break;
+		since = String(lastTs + 1);
+	}
+
+	// MAX_PAGES 到達 → 打ち切り
+	return { trades: all.slice(0, limit), isComplete: false };
+}
+
+export default async function getMyTradeHistory(args: {
+	pair?: string;
+	count?: number;
+	order?: 'asc' | 'desc';
+	since?: string;
+	end?: string;
+}) {
+	const { pair, count = 100, order = 'desc', since, end } = args;
+	const client = getDefaultClient();
+
+	try {
+		// クエリパラメータを組み立て
+		const baseParams: Record<string, string> = {};
+		if (pair) baseParams.pair = pair;
+
+		// ISO8601 → unix ms 変換（strict parse で不正日時を弾く）
+		if (since) {
+			const parsed = parseIso8601(since);
+			if (!parsed) {
+				return GetMyTradeHistoryOutputSchema.parse(fail(`since の日時形式が不正です: ${since}`, 'validation_error'));
+			}
+			baseParams.since = String(parsed.valueOf());
+		}
+		if (end) {
+			const parsed = parseIso8601(end);
+			if (!parsed) {
+				return GetMyTradeHistoryOutputSchema.parse(fail(`end の日時形式が不正です: ${end}`, 'validation_error'));
+			}
+			baseParams.end = String(parsed.valueOf());
+		}
+
+		let rawTrades: RawTrade[];
+		let isComplete: boolean;
+
+		if (count <= PAGE_SIZE) {
+			// 単発リクエストで十分なケース
+			const params = { ...baseParams, count: String(count), order };
+			const rawData = await client.get<{ trades: RawTrade[] }>(
+				'/v1/user/spot/trade_history',
+				Object.keys(params).length > 0 ? params : undefined,
+			);
+			rawTrades = rawData.trades;
+			// 取得件数が count 未満なら全件取得済み
+			isComplete = rawTrades.length < count;
+		} else {
+			// 自動ページネーション
+			const result = await paginateTrades(client, baseParams, count);
+			rawTrades = result.trades;
+			isComplete = result.isComplete;
+		}
+
+		const timestamp = nowIso();
+
+		// 約定データの整形
+		const trades = rawTrades.map((t) => ({
+			trade_id: t.trade_id,
+			pair: t.pair,
+			order_id: t.order_id,
+			side: t.side,
+			type: t.type,
+			amount: t.amount,
+			price: t.price,
+			maker_taker: t.maker_taker,
+			fee_amount_base: t.fee_amount_base,
+			fee_amount_quote: t.fee_amount_quote,
+			executed_at: toIsoMs(t.executed_at) ?? String(t.executed_at),
+		}));
+
+		// desc 指定時は逆順にソート（ページネーションは asc で取得するため）
+		if (order === 'desc') {
+			trades.reverse();
+		}
+
+		// サマリー文字列の生成
+		const lines: string[] = [];
+		const pairLabel = pair ? formatPair(pair) : '全ペア';
+		lines.push(`約定履歴: ${pairLabel} ${trades.length}件`);
+		if (!isComplete) {
+			lines.push('※ 全件ではなく一部のみ取得されています。API件数上限に達した可能性があります');
+		}
+
+		if (trades.length > 0) {
+			lines.push('');
+
+			// サマリーに表示する約定（最大10件）
+			// desc（デフォルト）: 先頭が直近なのでそのまま slice
+			// asc: 末尾が直近なので末尾10件を取得
+			const displayTrades = order === 'asc' ? trades.slice(-10) : trades.slice(0, 10);
+			for (const t of displayTrades) {
+				const sideLabel = t.side === 'buy' ? '買' : '売';
+				const isJpy = t.pair.includes('jpy');
+				const price = isJpy ? formatPrice(Number(t.price)) : t.price;
+				lines.push(
+					`[trade: ${t.trade_id} / order: ${t.order_id}] ${t.executed_at} ${formatPair(t.pair)} ${sideLabel} ${t.amount} @ ${price} (${t.maker_taker})`,
+				);
+			}
+
+			if (trades.length > 10) {
+				lines.push(`... 他 ${trades.length - 10}件`);
+			}
+
+			// 集計情報
+			const buyCount = trades.filter((t) => t.side === 'buy').length;
+			const sellCount = trades.filter((t) => t.side === 'sell').length;
+			lines.push('');
+			lines.push(`集計: 買 ${buyCount}件 / 売 ${sellCount}件`);
+		}
+
+		const summary = lines.join('\n');
+
+		const data = {
+			trades,
+			timestamp,
+		};
+
+		const meta = {
+			fetchedAt: timestamp,
+			tradeCount: trades.length,
+			pair: pair || undefined,
+			isComplete,
+			...(client.lastRateLimit ? { rateLimit: client.lastRateLimit } : {}),
+		};
+
+		return GetMyTradeHistoryOutputSchema.parse(ok(summary, data, meta));
+	} catch (err) {
+		if (err instanceof PrivateApiError) {
+			return GetMyTradeHistoryOutputSchema.parse(fail(err.message, err.errorType));
+		}
+		return GetMyTradeHistoryOutputSchema.parse(
+			fail(err instanceof Error ? err.message : '約定履歴取得中に予期しないエラーが発生しました', 'upstream_error'),
+		);
+	}
+}
+
+// ── MCP ツール定義（tool-registry から自動収集） ──
+export const toolDef: ToolDefinition = {
+	name: 'get_my_trade_history',
+	description:
+		'[My Trades / Trade History / Fills] 自分の約定履歴（my trades / trade history / fills / executions）を取得。通貨ペア・期間・件数でフィルタ可能。Private API。',
+	inputSchema: GetMyTradeHistoryInputSchema,
+	handler: async (args: { pair?: string; count?: number; order?: 'asc' | 'desc'; since?: string; end?: string }) =>
+		getMyTradeHistory(args),
+};

package/tools/private/get_order.ts

@@ -0,0 +1,95 @@
+/**
+ * get_order — 注文詳細を取得する Private API ツール。
+ *
+ * bitbank Private API `GET /v1/user/spot/order` を呼び出し、
+ * 指定した注文IDの詳細情報を返す。
+ *
+ * ※ 約定・キャンセルから3ヶ月以上経過した注文は取得不可（エラー 50009）。
+ */
+
+import { nowIso, toIsoMs } from '../../lib/datetime.js';
+import { formatPair, formatPrice } from '../../lib/formatter.js';
+import { fail, ok, toStructured } from '../../lib/result.js';
+import { getDefaultClient, PrivateApiError } from '../../src/private/client.js';
+import type { OrderResponse } from '../../src/private/schemas.js';
+import { GetOrderInputSchema, GetOrderOutputSchema } from '../../src/private/schemas.js';
+import type { ToolDefinition } from '../../src/tool-definition.js';
+
+/** 注文情報を人間可読な文字列に整形 */
+function formatOrderSummary(o: OrderResponse, pair: string): string {
+	const sideLabel = o.side === 'buy' ? '買' : '売';
+	const isJpy = pair.includes('jpy');
+	const price = o.price ? (isJpy ? formatPrice(Number(o.price)) : o.price) : '成行';
+	const amount = o.start_amount ?? o.executed_amount;
+	const lines: string[] = [];
+
+	lines.push(`注文詳細: ${formatPair(pair)}`);
+	lines.push(`  注文ID: ${o.order_id}`);
+	lines.push(`  方向: ${sideLabel} / タイプ: ${o.type}`);
+	lines.push(`  数量: ${amount} / 未約定: ${o.remaining_amount ?? '0'} / 約定済: ${o.executed_amount}`);
+	lines.push(`  価格: ${price}`);
+	if (o.average_price && o.average_price !== '0') {
+		lines.push(`  平均約定価格: ${isJpy ? formatPrice(Number(o.average_price)) : o.average_price}`);
+	}
+	if (o.trigger_price) {
+		lines.push(`  トリガー価格: ${isJpy ? formatPrice(Number(o.trigger_price)) : o.trigger_price}`);
+	}
+	lines.push(`  ステータス: ${o.status}`);
+	lines.push(`  注文日時: ${toIsoMs(o.ordered_at) ?? String(o.ordered_at)}`);
+	if (o.canceled_at) {
+		lines.push(`  キャンセル日時: ${toIsoMs(o.canceled_at) ?? String(o.canceled_at)}`);
+	}
+
+	return lines.join('\n');
+}
+
+export default async function getOrder(args: { pair: string; order_id: number }) {
+	const { pair, order_id } = args;
+	const client = getDefaultClient();
+
+	try {
+		const rawOrder = await client.get<OrderResponse>('/v1/user/spot/order', {
+			pair,
+			order_id: String(order_id),
+		});
+
+		const timestamp = nowIso();
+		const summary = formatOrderSummary(rawOrder, pair);
+
+		return GetOrderOutputSchema.parse(
+			ok(
+				summary,
+				{ order: rawOrder, timestamp },
+				{
+					fetchedAt: timestamp,
+					orderId: order_id,
+					pair,
+					...(client.lastRateLimit ? { rateLimit: client.lastRateLimit } : {}),
+				},
+			),
+		);
+	} catch (err) {
+		if (err instanceof PrivateApiError) {
+			return GetOrderOutputSchema.parse(fail(err.message, err.errorType));
+		}
+		return GetOrderOutputSchema.parse(
+			fail(err instanceof Error ? err.message : '注文情報取得中に予期しないエラーが発生しました', 'upstream_error'),
+		);
+	}
+}
+
+export const toolDef: ToolDefinition = {
+	name: 'get_order',
+	description:
+		'[Order Detail / Order Status] 指定した注文IDの詳細情報を取得。ステータス・約定状況・価格を確認できる。Private API。',
+	inputSchema: GetOrderInputSchema,
+	handler: async (args) => {
+		const result = await getOrder(args as { pair: string; order_id: number });
+		if (!result.ok) return result;
+		const text = `${result.summary}\n${JSON.stringify(result.data, null, 2)}`;
+		return {
+			content: [{ type: 'text', text }],
+			structuredContent: toStructured(result),
+		};
+	},
+};

package/tools/private/get_orders_info.ts

@@ -0,0 +1,90 @@
+/**
+ * get_orders_info — 複数注文の詳細を一括取得する Private API ツール。
+ *
+ * bitbank Private API `POST /v1/user/spot/orders_info` を呼び出し、
+ * 指定した複数の注文IDの詳細情報を返す。
+ *
+ * ※ 約定・キャンセルから3ヶ月以上経過した注文は結果に含まれない（エラーにはならない）。
+ */
+
+import { nowIso, toIsoMs } from '../../lib/datetime.js';
+import { formatPair, formatPrice } from '../../lib/formatter.js';
+import { fail, ok, toStructured } from '../../lib/result.js';
+import { getDefaultClient, PrivateApiError } from '../../src/private/client.js';
+import type { OrderResponse } from '../../src/private/schemas.js';
+import { GetOrdersInfoInputSchema, GetOrdersInfoOutputSchema } from '../../src/private/schemas.js';
+import type { ToolDefinition } from '../../src/tool-definition.js';
+
+export default async function getOrdersInfo(args: { pair: string; order_ids: number[] }) {
+	const { pair, order_ids } = args;
+	const client = getDefaultClient();
+
+	try {
+		const rawData = await client.post<{ orders: OrderResponse[] }>('/v1/user/spot/orders_info', {
+			pair,
+			order_ids,
+		});
+
+		const timestamp = nowIso();
+		const orders = rawData.orders;
+		const isJpy = pair.includes('jpy');
+
+		const lines: string[] = [];
+		lines.push(`注文情報: ${formatPair(pair)} ${orders.length}件`);
+
+		if (orders.length > 0) {
+			lines.push('');
+			for (const o of orders) {
+				const sideLabel = o.side === 'buy' ? '買' : '売';
+				const price = o.price ? (isJpy ? formatPrice(Number(o.price)) : o.price) : '成行';
+				const amount = o.start_amount ?? o.executed_amount;
+				lines.push(
+					`#${o.order_id} ${sideLabel}${o.type} ${amount} @ ${price} [${o.status}] (${toIsoMs(o.ordered_at) ?? String(o.ordered_at)})`,
+				);
+			}
+		}
+
+		if (orders.length < order_ids.length) {
+			lines.push('');
+			lines.push(`※ ${order_ids.length - orders.length}件は3ヶ月以上前の注文のため取得できませんでした`);
+		}
+
+		const summary = lines.join('\n');
+
+		return GetOrdersInfoOutputSchema.parse(
+			ok(
+				summary,
+				{ orders, timestamp },
+				{
+					fetchedAt: timestamp,
+					orderCount: orders.length,
+					pair,
+					...(client.lastRateLimit ? { rateLimit: client.lastRateLimit } : {}),
+				},
+			),
+		);
+	} catch (err) {
+		if (err instanceof PrivateApiError) {
+			return GetOrdersInfoOutputSchema.parse(fail(err.message, err.errorType));
+		}
+		return GetOrdersInfoOutputSchema.parse(
+			fail(err instanceof Error ? err.message : '注文情報取得中に予期しないエラーが発生しました', 'upstream_error'),
+		);
+	}
+}
+
+export const toolDef: ToolDefinition = {
+	name: 'get_orders_info',
+	description:
+		'[Orders Info / Bulk Order Status] 複数の注文IDの詳細情報を一括取得。ステータス・約定状況を一度に確認できる。Private API。',
+	inputSchema: GetOrdersInfoInputSchema,
+	handler: async (args) => {
+		const result = await getOrdersInfo(args as { pair: string; order_ids: number[] });
+		if (!result.ok) return result;
+		const text = `${result.summary}\n${JSON.stringify(result.data, null, 2)}`;
+		return {
+			content: [{ type: 'text', text }],
+			structuredContent: toStructured(result),
+		};
+	},
+};

package/tools/private/preview_cancel_order.ts

@@ -0,0 +1,172 @@
+/**
+ * preview_cancel_order — 注文キャンセルのプレビューと確認トークン発行。
+ *
+ * キャンセル対象の注文情報を表示し、cancel_order に渡す確認トークンを発行する。
+ * 実際のキャンセルは行わない。
+ *
+ * elicitation 対応ホストでは preview → ユーザー確認 → cancel_order までを
+ * このハンドラ内で完結させる（LLM から見ると preview_cancel_order 1 回呼び出しで
+ * キャンセル完了）。非対応ホストでは従来通り structuredContent 経由でトークンを
+ * 渡しフォールバックする（Progressive Enhancement）。
+ */
+
+import { formatPair, formatPrice } from '../../lib/formatter.js';
+import { ok, toStructured } from '../../lib/result.js';
+import { generateToken } from '../../src/private/confirmation.js';
+import type { OrderResponse } from '../../src/private/schemas.js';
+import { PreviewCancelOrderInputSchema, PreviewCancelOrderOutputSchema } from '../../src/private/schemas.js';
+import type { ToolDefinition, ToolHandlerExtra } from '../../src/tool-definition.js';
+import cancelOrder from './cancel_order.js';
+import getOrder from './get_order.js';
+
+/** 注文詳細をキャンセルプレビューのサマリ行に整形する */
+function formatOrderDetailLines(order: OrderResponse, pair: string): string[] {
+	const sideLabel = order.side === 'buy' ? '買' : '売';
+	const isJpy = pair.includes('jpy');
+	const price = order.price ? (isJpy ? formatPrice(Number(order.price)) : order.price) : '成行';
+	const amount = order.start_amount ?? order.executed_amount ?? '?';
+	const lines: string[] = [];
+	lines.push(`  方向: ${sideLabel} / タイプ: ${order.type}`);
+	lines.push(`  数量: ${amount}（残: ${order.remaining_amount ?? '0'} / 約定: ${order.executed_amount}）`);
+	lines.push(`  価格: ${price}`);
+	if (order.trigger_price) {
+		lines.push(`  トリガー価格: ${isJpy ? formatPrice(Number(order.trigger_price)) : order.trigger_price}`);
+	}
+	if (order.average_price && order.average_price !== '0') {
+		lines.push(`  平均約定価格: ${isJpy ? formatPrice(Number(order.average_price)) : order.average_price}`);
+	}
+	lines.push(`  ステータス: ${order.status}`);
+	return lines;
+}
+
+export default async function previewCancelOrder(args: { pair: string; order_id: number }) {
+	const { pair, order_id } = args;
+
+	// 注文詳細を取得して preview にも同梱する。失敗してもキャンセル自体は可能なので、
+	// エラーは握りつぶしてフォールバック表示にとどめる（ネットワーク不調や認証異常で
+	// キャンセル不能になる方が UX として悪いため）。
+	let orderDetail: OrderResponse | undefined;
+	const detailResult = await getOrder({ pair, order_id });
+	if (detailResult.ok) {
+		orderDetail = detailResult.data.order;
+	}
+
+	const tokenParams = { pair, order_id };
+	const { token, expiresAt } = generateToken('cancel_order', tokenParams);
+
+	const lines: string[] = [];
+	lines.push(`📋 キャンセルプレビュー: ${formatPair(pair)}`);
+	lines.push(`  注文ID: ${order_id}`);
+	if (orderDetail) {
+		lines.push(...formatOrderDetailLines(orderDetail, pair));
+	}
+	lines.push('');
+	lines.push('⚠️ このキャンセルはユーザーの最終確認（ホスト UI または elicitation）を経るまで実行されません。');
+
+	const summary = lines.join('\n');
+
+	const data: Record<string, unknown> = {
+		confirmation_token: token,
+		expires_at: expiresAt,
+		preview: { pair, order_id },
+	};
+	if (orderDetail) data.order = orderDetail;
+
+	return PreviewCancelOrderOutputSchema.parse(ok(summary, data, { action: 'cancel_order' as const }));
+}
+
+/**
+ * クライアントが elicitation/create に対応しているかを判定する。
+ * 非対応ホストでは従来挙動（structuredContent でトークンを返す）にフォールバックする。
+ */
+function clientSupportsElicitation(extra: ToolHandlerExtra | undefined): boolean {
+	const server = (extra as { server?: { getClientCapabilities?: () => unknown } } | undefined)?.server;
+	const caps = typeof server?.getClientCapabilities === 'function' ? server.getClientCapabilities() : undefined;
+	const elicitation = (caps as { elicitation?: unknown } | undefined)?.elicitation;
+	return Boolean(elicitation);
+}
+
+/** SDK の elicitInput を呼び出すための最小限の interface */
+interface ElicitCapableServer {
+	elicitInput: (params: {
+		message: string;
+		requestedSchema: Record<string, unknown>;
+	}) => Promise<{ action: 'accept' | 'decline' | 'cancel'; content?: Record<string, unknown> }>;
+}
+
+export const toolDef: ToolDefinition = {
+	name: 'preview_cancel_order',
+	description: [
+		'[Preview Cancel Order] 注文キャンセルのプレビューと確認トークン発行。実際のキャンセルは行わない。Private API。',
+		'cancel_order を実行するには、まずこのツールで確認トークンを取得する必要がある。',
+		'⚠️ confirmation_token は LLM 可視テキストには含めない。ホスト UI または elicitation のユーザー確認を経て cancel_order が呼ばれる前提。LLM が独断でトークンを引用して cancel_order を呼ぶと意図しないキャンセルになり得る。',
+	].join(' '),
+	inputSchema: PreviewCancelOrderInputSchema,
+	// MCP Apps (SEP-1865): 対応ホストでは iframe 内にキャンセル確認 UI を表示する。
+	// 非対応ホストでは無視され、従来のテキスト確認フローがそのまま動作する（Progressive Enhancement）。
+	_meta: {
+		ui: {
+			resourceUri: 'ui://cancel/confirm.html',
+		},
+	},
+	handler: async (args, extra) => {
+		const typedArgs = args as { pair: string; order_id: number };
+		const result = await previewCancelOrder(typedArgs);
+		if (!result.ok) return result;
+
+		// elicitation 対応ホストでは preview → ユーザー確認 → cancel_order までを
+		// このハンドラ内で完結させる。
+		if (clientSupportsElicitation(extra)) {
+			const server = (extra as { server?: ElicitCapableServer } | undefined)?.server;
+			if (server && typeof server.elicitInput === 'function') {
+				try {
+					const elicit = await server.elicitInput({
+						message: result.summary,
+						requestedSchema: {
+							type: 'object',
+							properties: {
+								confirmed: { type: 'boolean', title: 'この注文をキャンセルする' },
+							},
+							required: ['confirmed'],
+						},
+					});
+					if (elicit.action !== 'accept' || !elicit.content?.confirmed) {
+						return {
+							content: [{ type: 'text', text: 'ユーザーがキャンセル操作を取り消しました（elicitation）' }],
+							structuredContent: toStructured(result),
+						};
+					}
+					// 内部的に cancel_order を実行。監査ログには route='elicitation' で記録される。
+					const cancelResult = await cancelOrder(
+						{
+							...typedArgs,
+							confirmation_token: result.data.confirmation_token,
+							token_expires_at: result.data.expires_at,
+						},
+						'elicitation',
+					);
+					const cancelText = cancelResult.ok ? cancelResult.summary : `Error: ${cancelResult.summary}`;
+					return {
+						content: [{ type: 'text', text: cancelText }],
+						structuredContent: toStructured(cancelResult),
+					};
+				} catch {
+					// elicitInput が想定外に失敗した場合はフォールバックに進む。
+				}
+			}
+		}
+
+		// フォールバック: confirmation_token は LLM 可視テキストには含めず、
+		// structuredContent 側にだけ残す。SEP-1865 UI ボタンや Inspector はこちらを参照する。
+		const text = [
+			result.summary,
+			'',
+			'※ confirmation_token はホスト UI / structuredContent 経由でのみ受け渡されます。',
+			'  LLM はトークンを引用したり、ユーザー確認なしに cancel_order を呼ばないでください。',
+		].join('\n');
+		return {
+			content: [{ type: 'text', text }],
+			structuredContent: toStructured(result),
+		};
+	},
+};