@henjicc/ai-sdk 0.2.8

package/examples/llm-chat/index.ts

@@ -0,0 +1,100 @@
+import {
+  resolveLlmTaskId,
+  runLlmChatStream,
+  type LlmChatRequestDto,
+  type MediaReader,
+  type RuntimeContext,
+  type Transport,
+} from '@henjicc/ai-sdk/llm/streaming'
+
+const live = process.argv.includes('--live')
+const providerId = process.env.LLM_PROVIDER_ID?.trim() || 'deepseek'
+const modelId = process.env.LLM_MODEL_ID?.trim() || 'deepseek-v4-flash'
+const baseUrl = process.env.LLM_BASE_URL?.trim() || 'https://api.deepseek.com'
+
+class SingleChatTransport implements Transport {
+  private paidRequests = 0
+
+  async fetch(url: string, init?: RequestInit): Promise<Response> {
+    if ((init?.method ?? 'GET').toUpperCase() === 'POST' && new URL(url).pathname.endsWith('/chat/completions')) {
+      this.paidRequests += 1
+      if (this.paidRequests > 1) throw new Error('Blocked a repeated paid LLM request')
+    }
+    return await fetch(url, init)
+  }
+}
+
+class DryRunTransport implements Transport {
+  calls = 0
+
+  async fetch(): Promise<Response> {
+    this.calls += 1
+    return new Response(
+      'data: {"choices":[{"delta":{"content":"SDK OK"}}]}\n\ndata: [DONE]\n\n',
+      { status: 200, headers: { 'Content-Type': 'text/event-stream' } },
+    )
+  }
+}
+
+const unusedMedia: MediaReader = {
+  async read() {
+    throw new Error('This text-only example does not read media')
+  },
+}
+
+async function main(): Promise<void> {
+  const dryTransport = new DryRunTransport()
+  const apiKey = live ? process.env.LLM_API_KEY?.trim() : 'dry-run-not-a-secret'
+  if (!apiKey) throw new Error('Missing LLM_API_KEY')
+
+  const runtime: RuntimeContext = {
+    transport: live ? new SingleChatTransport() : dryTransport,
+    credentials: {
+      get: (scope, requestedProviderId) => scope === 'llm' && requestedProviderId === providerId
+        ? apiKey
+        : undefined,
+    },
+    media: unusedMedia,
+  }
+  const prompt = '只回复两个英文单词：SDK OK'
+  const request: LlmChatRequestDto = {
+    requestId: live ? `example-llm-${Date.now()}` : 'example-llm-dry-run',
+    providerId,
+    modelId,
+    adapter: providerId === 'deepseek' ? 'deepseek' : 'openai',
+    baseUrl,
+    messages: [{ role: 'user', content: prompt }],
+    capabilities: { reasoning: providerId === 'deepseek' },
+    reasoning: providerId === 'deepseek'
+      ? { enabled: false, effort: 'high' }
+      : undefined,
+    policy: { max_tokens: 16 },
+  }
+  const taskId = resolveLlmTaskId(request)
+  let output = ''
+
+  const outcome = await runLlmChatStream(request, taskId, (event) => {
+    if (event.type === 'Token') output += event.data
+  }, runtime)
+
+  if (!output.trim()) {
+    throw new Error('LLM completed without a text token')
+  }
+
+  const conservativeCny = ((outcome.inputChars * 3) + (outcome.outputChars * 9)) / 1_000_000
+  console.log(JSON.stringify({
+    mode: live ? 'live' : 'dry-run',
+    networkCalls: live ? 1 : 0,
+    interceptedRequests: live ? undefined : dryTransport.calls,
+    providerId,
+    modelId,
+    output,
+    elapsedMs: outcome.elapsedMs,
+    conservativeCnyEstimate: Number(conservativeCny.toFixed(6)),
+  }))
+}
+
+void main().catch((error: unknown) => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exitCode = 1
+})

package/examples/llm-chat/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@henjicc/ai-sdk-example-llm-chat",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dry-run": "npm run build && node dist/index.js --dry-run",
+    "check:bundle": "node scripts/check-bundle.mjs",
+    "start": "npm run build && node dist/index.js --live"
+  },
+  "dependencies": {
+    "@henjicc/ai-sdk": "0.2.8"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.25.9",
+    "typescript": "^5.9.2"
+  }
+}

package/examples/llm-chat/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "types": ["node"]
+  },
+  "include": ["index.ts"]
+}

package/examples/minimal-node/README.md

@@ -0,0 +1,31 @@
+# minimal-node
+
+用 `@henjicc/ai-sdk@0.2.8` 的 `generation` 与 `runtime` 按需入口调用 KIE `z-image`。
+它保留完整 generation catalog，但不会带入 LLM/BigModel。示例不会下载结果文件；成功后只输出供应商返回的 URL。
+
+## 安装
+
+SDK 公开发布在 npm，无需配置 registry 或访问令牌。
+
+```bash
+npm install
+npm run dry-run
+```
+
+`dry-run` 会走真实 catalog、builder、预处理和 KIE provider，但用本地 `Response` 截住请求，
+输出中的 `networkCalls` 必须是 `0`。
+
+## 一次真实调用
+
+当前模型目录估价是 **$0.004/张**。确认账户有余额后，仅在当前终端注入密钥：
+
+```bash
+KIE_API_KEY='你的密钥' npm start
+```
+
+示例在付费创建端点前有一次性闸门：即使 SDK 的“安全预连接重试”判断被触发，也会在第二次 POST
+到达网络前本地拒绝，因此一次进程最多发出一个 KIE 创建请求。状态轮询是只读 GET，不会重复创建任务。
+
+`generate()` 返回 `pending + taskId` 时，示例继续调用 `continuePolling()` 直到得到 URL；SDK 不负责把
+URL 下载到磁盘。取消时应保留本次 `requestId` 或供应商 `taskId`，调用
+`client.cancel({ namespace: 'generation', taskId })`。

package/examples/minimal-node/index.ts

@@ -0,0 +1,138 @@
+import { readFile } from 'node:fs/promises'
+import { basename, extname } from 'node:path'
+
+import {
+  createGenerationClient,
+} from '@henjicc/ai-sdk/generation'
+import type {
+  Logger,
+  MediaReader,
+  RuntimeContext,
+  Transport,
+} from '@henjicc/ai-sdk/runtime'
+
+const MODEL_ID = 'kie-z-image'
+const CREATE_TASK_PATH = '/api/v1/jobs/createTask'
+const live = process.argv.includes('--live')
+
+class SingleCreateTransport implements Transport {
+  private createRequests = 0
+
+  async fetch(url: string, init?: RequestInit): Promise<Response> {
+    const method = (init?.method ?? 'GET').toUpperCase()
+    if (method === 'POST' && new URL(url).pathname === CREATE_TASK_PATH) {
+      this.createRequests += 1
+      if (this.createRequests > 1) {
+        throw new Error('Blocked a repeated paid KIE create request')
+      }
+    }
+    return await fetch(url, init)
+  }
+}
+
+class DryRunTransport implements Transport {
+  calls = 0
+
+  async fetch(url: string, init?: RequestInit): Promise<Response> {
+    this.calls += 1
+    const method = (init?.method ?? 'GET').toUpperCase()
+    if (method !== 'POST' || new URL(url).pathname !== CREATE_TASK_PATH) {
+      throw new Error(`Dry-run rejected unexpected request: ${method} ${url}`)
+    }
+    return Response.json({ code: 200, data: { taskId: 'dry-run-task' } })
+  }
+}
+
+const media: MediaReader = {
+  async read(ref) {
+    const bytes = new Uint8Array(await readFile(ref))
+    return {
+      bytes,
+      filename: basename(ref),
+      mimeType: mimeFromExtension(extname(ref)),
+    }
+  },
+}
+
+const logger: Logger = {
+  info: (message) => console.log(`[sdk] ${message}`),
+  warn: (message) => console.warn(`[sdk] ${message}`),
+  error: (message) => console.error(`[sdk] ${message}`),
+}
+
+async function main(): Promise<void> {
+  const dryTransport = new DryRunTransport()
+  const apiKey = live ? process.env.KIE_API_KEY?.trim() : 'dry-run-not-a-secret'
+  if (!apiKey) throw new Error('Missing KIE_API_KEY')
+
+  const runtime: RuntimeContext = {
+    transport: live ? new SingleCreateTransport() : dryTransport,
+    credentials: {
+      get: (scope, providerId) => scope === 'generation' && providerId === 'kie'
+        ? apiKey
+        : undefined,
+    },
+    media,
+    logger,
+  }
+  const client = createGenerationClient({ runtime })
+  const params = {
+    prompt: 'A tiny blue paper boat on a calm white background, studio light',
+    kieZImageAspectRatio: '1:1',
+  }
+
+  try {
+    const price = client.catalog.estimatePrice(MODEL_ID, params)
+    const result = await client.generate({
+      modelId: MODEL_ID,
+      requestId: live ? `example-kie-${Date.now()}` : 'example-kie-dry-run',
+      params,
+    }, {
+      onRequestBuilt: ({ providerId, route, method }) => {
+        console.log(JSON.stringify({ stage: 'request-built', providerId, route, method }))
+      },
+    })
+
+    if (!live) {
+      console.log(JSON.stringify({
+        mode: 'dry-run',
+        networkCalls: 0,
+        interceptedRequests: dryTransport.calls,
+        status: result.status,
+        taskId: result.taskId,
+        estimatedUsd: price,
+      }))
+      return
+    }
+
+    const completed = result.status === 'pending' && result.taskId
+      ? await client.continuePolling({ modelId: MODEL_ID, taskId: result.taskId, params })
+      : result
+    if (completed.status !== 'completed' || !completed.url) {
+      throw new Error(`KIE generation did not complete: ${completed.status}`)
+    }
+    console.log(JSON.stringify({
+      mode: 'live',
+      status: completed.status,
+      resultUrl: completed.url,
+      estimatedUsd: price,
+    }))
+  } finally {
+    client.dispose()
+  }
+}
+
+function mimeFromExtension(extension: string): string {
+  const normalized = extension.toLowerCase()
+  if (normalized === '.png') return 'image/png'
+  if (normalized === '.webp') return 'image/webp'
+  if (normalized === '.gif') return 'image/gif'
+  if (normalized === '.mp4') return 'video/mp4'
+  if (normalized === '.mp3') return 'audio/mpeg'
+  return 'image/jpeg'
+}
+
+void main().catch((error: unknown) => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exitCode = 1
+})

package/examples/minimal-node/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@henjicc/ai-sdk-example-minimal-node",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dry-run": "npm run build && node dist/index.js --dry-run",
+    "start": "npm run build && node dist/index.js --live"
+  },
+  "dependencies": {
+    "@henjicc/ai-sdk": "0.2.8"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.2"
+  }
+}

package/examples/minimal-node/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "types": ["node"]
+  },
+  "include": ["index.ts"]
+}

package/package.json

@@ -0,0 +1,198 @@
+{
+  "name": "@henjicc/ai-sdk",
+  "version": "0.2.8",
+  "description": "痕迹AI 多供应商模型适配 SDK",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/henjicc/Henji-AI.git",
+    "directory": "packages/ai-sdk"
+  },
+  "homepage": "https://github.com/henjicc/Henji-AI/tree/main/packages/ai-sdk",
+  "bugs": {
+    "url": "https://github.com/henjicc/Henji-AI/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js",
+      "default": "./dist/providers/index.js"
+    },
+    "./generation": {
+      "types": "./dist/generation.d.ts",
+      "import": "./dist/generation.js",
+      "default": "./dist/generation.js"
+    },
+    "./generation/core": {
+      "types": "./dist/generation/core.d.ts",
+      "import": "./dist/generation/core.js",
+      "default": "./dist/generation/core.js"
+    },
+    "./models/*": {
+      "types": "./dist/packs/models/*.d.ts",
+      "import": "./dist/packs/models/*.js",
+      "default": "./dist/packs/models/*.js"
+    },
+    "./provider-adapters/*": {
+      "types": "./dist/packs/provider-adapters/*.d.ts",
+      "import": "./dist/packs/provider-adapters/*.js",
+      "default": "./dist/packs/provider-adapters/*.js"
+    },
+    "./provider-packs/*": {
+      "types": "./dist/packs/provider-packs/*.d.ts",
+      "import": "./dist/packs/provider-packs/*.js",
+      "default": "./dist/packs/provider-packs/*.js"
+    },
+    "./tool-models/*": {
+      "types": "./dist/packs/tool-models/*.d.ts",
+      "import": "./dist/packs/tool-models/*.js",
+      "default": "./dist/packs/tool-models/*.js"
+    },
+    "./tool-packs/*": {
+      "types": "./dist/packs/tool-packs/*.d.ts",
+      "import": "./dist/packs/tool-packs/*.js",
+      "default": "./dist/packs/tool-packs/*.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.ts",
+      "import": "./dist/catalog/index.js",
+      "default": "./dist/catalog/index.js"
+    },
+    "./pricing": {
+      "types": "./dist/pricing/index.d.ts",
+      "import": "./dist/pricing/index.js",
+      "default": "./dist/pricing/index.js"
+    },
+    "./llm": {
+      "types": "./dist/llm/index.d.ts",
+      "import": "./dist/llm/index.js",
+      "default": "./dist/llm/index.js"
+    },
+    "./llm/streaming": {
+      "types": "./dist/llm/streaming/index.d.ts",
+      "import": "./dist/llm/streaming/index.js",
+      "default": "./dist/llm/streaming/index.js"
+    },
+    "./llm/groq": {
+      "types": "./dist/llm/groq/index.d.ts",
+      "import": "./dist/llm/groq/index.js",
+      "default": "./dist/llm/groq/index.js"
+    },
+    "./llm/bigmodel": {
+      "types": "./dist/llm/bigmodel/index.d.ts",
+      "import": "./dist/llm/bigmodel/index.js",
+      "default": "./dist/llm/bigmodel/index.js"
+    },
+    "./llm/modules": {
+      "types": "./dist/llm/modules/index.d.ts",
+      "import": "./dist/llm/modules/index.js",
+      "default": "./dist/llm/modules/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities/index.d.ts",
+      "import": "./dist/capabilities/index.js",
+      "default": "./dist/capabilities/index.js"
+    },
+    "./capabilities/speech-recognition": {
+      "types": "./dist/capabilities/speech-recognition/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/index.js",
+      "default": "./dist/capabilities/speech-recognition/index.js"
+    },
+    "./capabilities/speech-recognition/bailian": {
+      "types": "./dist/capabilities/speech-recognition/bailian/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/bailian/index.js",
+      "default": "./dist/capabilities/speech-recognition/bailian/index.js"
+    },
+    "./capabilities/speech-recognition/bailian/realtime": {
+      "types": "./dist/capabilities/speech-recognition/bailian/realtime/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/bailian/realtime/index.js",
+      "default": "./dist/capabilities/speech-recognition/bailian/realtime/index.js"
+    },
+    "./capabilities/speech-recognition/volcengine": {
+      "types": "./dist/capabilities/speech-recognition/volcengine/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/volcengine/index.js",
+      "default": "./dist/capabilities/speech-recognition/volcengine/index.js"
+    },
+    "./capabilities/speech-recognition/volcengine/realtime": {
+      "types": "./dist/capabilities/speech-recognition/volcengine/realtime/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/volcengine/realtime/index.js",
+      "default": "./dist/capabilities/speech-recognition/volcengine/realtime/index.js"
+    },
+    "./capabilities/speech-recognition/siliconflow": {
+      "types": "./dist/capabilities/speech-recognition/siliconflow/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/siliconflow/index.js",
+      "default": "./dist/capabilities/speech-recognition/siliconflow/index.js"
+    },
+    "./capabilities/speech-recognition/groq": {
+      "types": "./dist/capabilities/speech-recognition/groq/index.d.ts",
+      "import": "./dist/capabilities/speech-recognition/groq/index.js",
+      "default": "./dist/capabilities/speech-recognition/groq/index.js"
+    },
+    "./capabilities/translation": {
+      "types": "./dist/capabilities/translation/index.d.ts",
+      "import": "./dist/capabilities/translation/index.js",
+      "default": "./dist/capabilities/translation/index.js"
+    },
+    "./capabilities/translation/bailian": {
+      "types": "./dist/capabilities/translation/bailian/index.d.ts",
+      "import": "./dist/capabilities/translation/bailian/index.js",
+      "default": "./dist/capabilities/translation/bailian/index.js"
+    },
+    "./capabilities/realtime": {
+      "types": "./dist/capabilities/realtime.d.ts",
+      "import": "./dist/capabilities/realtime.js",
+      "default": "./dist/capabilities/realtime.js"
+    },
+    "./discovery": {
+      "types": "./dist/discovery/index.d.ts",
+      "import": "./dist/discovery/index.js",
+      "default": "./dist/discovery/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples/*/README.md",
+    "examples/*/index.ts",
+    "examples/form-renderer/cli.ts",
+    "examples/*/package.json",
+    "examples/*/tsconfig.json",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "node scripts/build.cjs",
+    "test": "vitest run --root ../.. packages/ai-sdk",
+    "prepublishOnly": "node scripts/prepublish-check.cjs"
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^3.0.89",
+    "@ai-sdk/openai-compatible": "2.0.62",
+    "@ai-sdk/provider-utils": "4.0.40",
+    "ai": "6.0.234",
+    "fflate": "0.8.2",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.2"
+  }
+}