@gedatou/cadenza-ai 0.7.1

package/README.md

@@ -0,0 +1,71 @@
+# @gedatou/cadenza-ai
+
+TanStack AI 的薄门面：`useChat` 等 React API 原样可用，provider 接入、思考强度、会话列表、
+用量、附件与会话视图（基于 `@gedatou/cadenza-ui`）作为包默认提供。
+
+**文档与交互 demo：<https://cadenza-ui-docs.vercel.app/docs/ai/conversation>**
+
+## 用法
+
+```bash
+pnpm add @gedatou/cadenza-ai @gedatou/cadenza-ui
+pnpm add @tanstack/ai-openai   # 用到哪家装哪家；adapter 都是 optional peer
+```
+
+```tsx
+// 客户端
+import { fetchServerSentEvents, useChat } from '@gedatou/cadenza-ai'
+```
+
+```ts
+// 服务端 route handler
+import { openai } from '@gedatou/cadenza-ai/providers/openai'
+import { createChatHandler } from '@gedatou/cadenza-ai/server'
+
+export const { POST, GET } = createChatHandler({ providers: [openai] })
+```
+
+preset 一家一个子路径（只 import 自家 adapter）：`openai` / `anthropic` / `gemini` / `openrouter` /
+`grok` / `groq` / `mistral` / `vercel-gateway` / `llmgateway` / `bedrock` / `vertex` / `ollama` / `deepseek`；
+`providers/openai-compatible` 的 `openaiCompatiblePreset(config)` 接任何 OpenAI 兼容端点；
+`byteplus` 是占位。
+
+```tsx
+// 无密钥的假流（demo / 测试）
+import { useChat } from '@gedatou/cadenza-ai'
+import { scripted, text } from '@gedatou/cadenza-ai/mock'
+
+function Demo() {
+  const chat = useChat({ fetcher: scripted(() => [text('Hello')]) })
+  return <pre>{JSON.stringify(chat.messages)}</pre>
+}
+```
+
+入口 CSS（streamdown 的样式与 KaTeX 都在里面；再让 Tailwind 扫到 streamdown 的产物）：
+
+```css
+@import "@gedatou/cadenza-ai/styles.css";
+@source "../node_modules/streamdown/dist/*.js";
+```
+
+## 文档
+
+- [会话](https://cadenza-ui-docs.vercel.app/docs/ai/conversation) — `useChat` 接线与 Transcript 家族
+- [消息部件](https://cadenza-ui-docs.vercel.app/docs/ai/parts) — Markdown、推理、工具、审批、附件、来源、结构化输出
+- [输入区](https://cadenza-ui-docs.vercel.app/docs/ai/composer) — 输入、附件、模型与思考强度、建议、排队、听写
+- [会话列表](https://cadenza-ui-docs.vercel.app/docs/ai/threads) — 线程索引与本地持久化
+- [接入提供者](https://cadenza-ui-docs.vercel.app/docs/ai/providers) — 目录、thinking 映射、BYOK、route handler
+- [脚本化传输](https://cadenza-ui-docs.vercel.app/docs/ai/scripted) — `./mock` 的步骤 DSL
+- [试玩](https://cadenza-ui-docs.vercel.app/docs/ai/playground) — 用自己的 key 跑真模型
+
+## 与官方 API 的差异
+
+- 根入口 `export * from '@tanstack/ai-react'`，不覆盖任何上游导出；本包新增的导出不与上游同名。
+- 密钥走官方 BYOK relay 形态（浏览器 `x-byok-<id>` 头 → 你的 route handler），不做浏览器直连。
+- 思考强度统一为七级 `ThinkingLevel`（`off | minimal | low | medium | high | xhigh | max`），
+  由各 provider preset 翻译成自己的 `modelOptions`。
+- 服务端只从 `forwardedProps` 读 `provider` / `model` / `thinking` 三个键。
+
+## License
+
+[MIT](../../LICENSE.md)

package/dist/anthropic-DdrANeO1.mjs

@@ -0,0 +1,236 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/catalog/providers/anthropic.ts
+const anthropic = {
+	id: "anthropic",
+	label: "Anthropic",
+	byok: defineByokProvider({
+		id: "anthropic",
+		label: "Anthropic",
+		env: "ANTHROPIC_API_KEY"
+	}),
+	keyRequired: true,
+	runtime: "node",
+	models: [
+		{
+			id: "claude-opus-5",
+			name: "Claude Opus 5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 5,
+				output: 25,
+				cacheRead: .5
+			}
+		},
+		{
+			id: "claude-opus-5-fast",
+			name: "Claude Opus 5 Fast",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 10,
+				output: 50,
+				cacheRead: 1
+			}
+		},
+		{
+			id: "claude-sonnet-5",
+			name: "Claude Sonnet 5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 3,
+				output: 15,
+				cacheRead: .3
+			}
+		},
+		{
+			id: "claude-fable-5",
+			name: "Claude Fable 5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 10,
+				output: 50,
+				cacheRead: 1
+			},
+			thinkingLevels: [
+				"low",
+				"medium",
+				"high",
+				"xhigh",
+				"max"
+			]
+		},
+		{
+			id: "claude-opus-4-8",
+			name: "Claude Opus 4.8",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 5,
+				output: 25,
+				cacheRead: .5
+			}
+		},
+		{
+			id: "claude-opus-4-7",
+			name: "Claude Opus 4.7",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 5,
+				output: 25,
+				cacheRead: .5
+			}
+		},
+		{
+			id: "claude-opus-4-6",
+			name: "Claude Opus 4.6",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 2e5,
+			maxOutputTokens: 128e3,
+			cost: {
+				input: 5,
+				output: 25
+			},
+			thinkingLevels: ["off", "medium"]
+		},
+		{
+			id: "claude-sonnet-4-6",
+			name: "Claude Sonnet 4.6",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1e6,
+			maxOutputTokens: 64e3,
+			cost: {
+				input: 3,
+				output: 15
+			},
+			thinkingLevels: ["off", "medium"]
+		},
+		{
+			id: "claude-opus-4-5",
+			name: "Claude Opus 4.5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 2e5,
+			maxOutputTokens: 32e3,
+			cost: {
+				input: 15,
+				output: 75
+			}
+		},
+		{
+			id: "claude-sonnet-4-5",
+			name: "Claude Sonnet 4.5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 2e5,
+			maxOutputTokens: 64e3,
+			cost: {
+				input: 3,
+				output: 15
+			}
+		},
+		{
+			id: "claude-haiku-4-5",
+			name: "Claude Haiku 4.5",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 2e5,
+			maxOutputTokens: 64e3,
+			cost: {
+				input: 1,
+				output: 5
+			}
+		},
+		{
+			id: "claude-opus-4-1",
+			name: "Claude Opus 4.1",
+			provider: "anthropic",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 2e5,
+			maxOutputTokens: 64e3,
+			cost: {
+				input: 15,
+				output: 75
+			}
+		}
+	]
+};
+//#endregion
+export { anthropic as t };

package/dist/bedrock-534H9yfk.mjs

@@ -0,0 +1,75 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/catalog/providers/bedrock.ts
+const bedrock = {
+	id: "bedrock",
+	label: "Amazon Bedrock",
+	byok: defineByokProvider({
+		id: "bedrock",
+		label: "Amazon Bedrock",
+		env: ["BEDROCK_API_KEY", "AWS_BEARER_TOKEN_BEDROCK"]
+	}),
+	keyRequired: true,
+	runtime: "node",
+	models: [
+		{
+			id: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
+			name: "Claude Sonnet 4.5",
+			provider: "bedrock",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: false
+		},
+		{
+			id: "us.anthropic.claude-haiku-4-5-20251001-v1:0",
+			name: "Claude Haiku 4.5",
+			provider: "bedrock",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: false
+		},
+		{
+			id: "us.amazon.nova-pro-v1:0",
+			name: "Amazon Nova Pro",
+			provider: "bedrock",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: false
+		},
+		{
+			id: "us.amazon.nova-lite-v1:0",
+			name: "Amazon Nova Lite",
+			provider: "bedrock",
+			input: [
+				"text",
+				"image",
+				"document"
+			],
+			reasoning: false
+		},
+		{
+			id: "us.meta.llama4-maverick-17b-instruct-v1:0",
+			name: "Llama 4 Maverick 17B",
+			provider: "bedrock",
+			input: ["text", "image"],
+			reasoning: false
+		},
+		{
+			id: "us.deepseek.r1-v1:0",
+			name: "DeepSeek R1",
+			provider: "bedrock",
+			input: ["text"],
+			reasoning: false
+		}
+	]
+};
+//#endregion
+export { bedrock as t };

package/dist/catalog-CvvS2JaW.mjs

@@ -0,0 +1,32 @@
+//#region src/catalog/catalog.ts
+function modelRef(model) {
+	return `${model.provider}/${model.id}`;
+}
+/** 只切第一个斜杠：OpenRouter / Vercel Gateway 的模型 id 自带 `vendor/model`。 */
+function parseModelRef(ref) {
+	const slash = ref.indexOf("/");
+	if (slash === -1) return {
+		provider: ref,
+		id: ""
+	};
+	return {
+		provider: ref.slice(0, slash),
+		id: ref.slice(slash + 1)
+	};
+}
+function createCatalog(providers) {
+	const byId = new Map(providers.map((p) => [p.id, p]));
+	return {
+		providers,
+		models: providers.flatMap((p) => p.models),
+		getProvider: (id) => byId.get(id),
+		getModel: (ref) => {
+			const { provider, id } = parseModelRef(ref);
+			return byId.get(provider)?.models.find((m) => m.id === id);
+		},
+		withProvider: (p) => createCatalog([...providers.filter((x) => x.id !== p.id), p]),
+		withoutProvider: (id) => createCatalog(providers.filter((x) => x.id !== id))
+	};
+}
+//#endregion
+export { modelRef as n, parseModelRef as r, createCatalog as t };

package/dist/deepseek-C1b74T2F.mjs

@@ -0,0 +1,55 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/catalog/providers/deepseek.ts
+const deepseek = {
+	id: "deepseek",
+	label: "DeepSeek",
+	byok: defineByokProvider({
+		id: "deepseek",
+		label: "DeepSeek",
+		env: "DEEPSEEK_API_KEY"
+	}),
+	keyRequired: true,
+	runtime: "node",
+	models: [{
+		id: "deepseek-v4-flash",
+		name: "DeepSeek V4 Flash",
+		provider: "deepseek",
+		input: ["text"],
+		reasoning: true,
+		contextWindow: 1e6,
+		maxOutputTokens: 384e3,
+		cost: {
+			input: .14,
+			output: .28,
+			cacheRead: .0028
+		},
+		thinkingLevels: [
+			"off",
+			"low",
+			"high",
+			"max"
+		],
+		search: true
+	}, {
+		id: "deepseek-v4-pro",
+		name: "DeepSeek V4 Pro",
+		provider: "deepseek",
+		input: ["text"],
+		reasoning: true,
+		contextWindow: 1e6,
+		maxOutputTokens: 384e3,
+		cost: {
+			input: .435,
+			output: .87,
+			cacheRead: .003625
+		},
+		thinkingLevels: [
+			"off",
+			"high",
+			"max"
+		],
+		search: true
+	}]
+};
+//#endregion
+export { deepseek as t };

package/dist/gemini-DcJ5Kr3h.mjs

@@ -0,0 +1,229 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/catalog/providers/gemini.ts
+const gemini = {
+	id: "gemini",
+	label: "Google Gemini",
+	byok: defineByokProvider({
+		id: "gemini",
+		label: "Google Gemini",
+		env: ["GOOGLE_API_KEY", "GEMINI_API_KEY"]
+	}),
+	keyRequired: true,
+	runtime: "node",
+	models: [
+		{
+			id: "gemini-3.7-flash",
+			name: "Gemini 3.7 Flash",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"video",
+				"audio",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .75,
+				output: 3.75,
+				cacheRead: .075
+			}
+		},
+		{
+			id: "gemini-3.6-flash",
+			name: "Gemini 3.6 Flash",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"video",
+				"audio",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: 1.5,
+				output: 7.5,
+				cacheRead: .15
+			}
+		},
+		{
+			id: "gemini-3.5-flash",
+			name: "Gemini 3.5 Flash",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"video",
+				"document",
+				"audio"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: 1.5,
+				output: 9,
+				cacheRead: .15
+			}
+		},
+		{
+			id: "gemini-3.5-flash-lite",
+			name: "Gemini 3.5 Flash Lite",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"video",
+				"audio",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .3,
+				output: 2.5,
+				cacheRead: .03
+			}
+		},
+		{
+			id: "gemini-3.1-pro-preview",
+			name: "Gemini 3.1 Pro Preview",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: 2.5,
+				output: 15
+			}
+		},
+		{
+			id: "gemini-3-flash-preview",
+			name: "Gemini 3 Flash Preview",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .5,
+				output: 3
+			}
+		},
+		{
+			id: "gemini-3.1-flash-lite",
+			name: "Gemini 3.1 Flash Lite",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .25,
+				output: 1.5
+			}
+		},
+		{
+			id: "gemini-3.1-flash-lite-preview",
+			name: "Gemini 3.1 Flash Lite Preview",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .25,
+				output: 1.5
+			}
+		},
+		{
+			id: "gemini-2.5-pro",
+			name: "Gemini 2.5 Pro",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: 2.5,
+				output: 15
+			}
+		},
+		{
+			id: "gemini-2.5-flash",
+			name: "Gemini 2.5 Flash",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: 1,
+				output: 2.5
+			}
+		},
+		{
+			id: "gemini-2.5-flash-lite",
+			name: "Gemini 2.5 Flash Lite",
+			provider: "gemini",
+			input: [
+				"text",
+				"image",
+				"audio",
+				"video",
+				"document"
+			],
+			reasoning: true,
+			contextWindow: 1048576,
+			maxOutputTokens: 65536,
+			cost: {
+				input: .1,
+				output: .4
+			}
+		}
+	]
+};
+//#endregion
+export { gemini as t };