@77-zhike/app-sdk 0.2.0-d7b1.13 → 0.2.0-d7b1.14

package/README.md

@@ -1,5 +1,13 @@
 # 智客 App SDK 与 CLI
 
+## 操作系统与 Windows 候选
+
+当前 npm 发布版的 Developer CLI 仅提供 macOS Keychain 适配。本开发分支新增 Windows Credential Manager 候选：复用现有浏览器 PKCE 和 Session，使用系统 Windows PowerShell 5.1 固定桥接，refresh credential 按当前用户和 API origin 存储。
+
+Windows 候选通过独立的 `SDK Windows 自动化验证（不发布）` Actions 检查，分别运行 Node 22/24。测试制品仅供验证，未发布 npm；Windows 11 桌面、系统默认浏览器弹起、双用户和注销重登暂未覆盖。完整结果与边界见 `openspec/changes/windows-app-developer-cli/`。
+
+`zhike doctor --json` 的 `secureStore` 检查表示当前机制可用性，`writeAccess: not_checked` 和 `authentication: not_checked` 不证明凭据已保存、登录有效或业务可用。系统策略禁止桥接时会返回安全存储错误，不修改系统策略或降级为明文文件。
+
 ## 获准依赖
 
 工具链从 `src/toolchain/allowed-packages.json` 读取平台维护的包白名单。目前允许 `@77-zhike/qiqi-openapi@0.1.0` 的服务端包根入口 `.`；前端不可导入。项目安装依赖后直接使用静态 ESM import，真实解析的包名、精确版本、入口及间接模块在打包时核对，代码合并进 Artifact。App 的 Manifest、Settings 或 `package.json` 不能扩展名单。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@77-zhike/app-sdk",
-  "version": "0.2.0-d7b1.13",
+  "version": "0.2.0-d7b1.14",
   "description": "智客 Integration App 一期 SDK 与本地 Toolchain",
   "repository": {
     "type": "git",
@@ -67,5 +67,5 @@
       "optional": true
     }
   },
-  "gitHead": "f2a667ec95a8d1787cf0c0655787266317069b55"
+  "gitHead": "04ae9c07742d99322d12790db9c7934cea8f6f64"
 }

package/src/cli/browser-auth.js

@@ -2,6 +2,7 @@ import { execFile as execFileCallback } from "node:child_process";
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 import { createServer } from "node:http";
 import { promisify } from "node:util";
+import { win32 } from "node:path";
 
 import { CLI_CLIENT_ID } from "../config.js";
 import { ZhikeCliError } from "../errors.js";
@@ -17,25 +18,33 @@ export async function authorizeCli({
   openBrowser = openSystemBrowser,
   onProgress = () => {},
   timeoutMs = 120_000,
+  signal,
 }) {
   const state = randomBytes(32).toString("base64url");
   const codeVerifier = randomBytes(48).toString("base64url");
   const codeChallenge = createHash("sha256")
     .update(codeVerifier, "ascii")
     .digest("base64url");
-  const callback = await createLoopbackCallback({ state, timeoutMs });
-  const redirectUri = `http://127.0.0.1:${callback.port}/callback`;
-  const authorizationUrl = new URL("/cli/authorize", consoleBaseUrl);
-  authorizationUrl.searchParams.set("client_id", CLI_CLIENT_ID);
-  authorizationUrl.searchParams.set("redirect_uri", redirectUri);
-  authorizationUrl.searchParams.set("code_challenge", codeChallenge);
-  authorizationUrl.searchParams.set("code_challenge_method", "S256");
-  authorizationUrl.searchParams.set("state", state);
-
+  const cancellation = new AbortController();
+  const stop = () => cancellation.abort();
+  const authorizationSignal = signal || cancellation.signal;
+  if (!signal) { process.once("SIGINT", stop); process.once("SIGTERM", stop); }
+  let callback;
   try {
+    if (authorizationSignal.aborted) throw new ZhikeCliError("zhike_cli_authorization_cancelled", "Developer CLI 授权已取消", { exitCode: 130 });
+    callback = await createLoopbackCallback({ state, timeoutMs, signal: authorizationSignal });
+    if (authorizationSignal.aborted) await callback.waitForCode;
+    const redirectUri = `http://127.0.0.1:${callback.port}/callback`;
+    const authorizationUrl = new URL("/cli/authorize", consoleBaseUrl);
+    authorizationUrl.searchParams.set("client_id", CLI_CLIENT_ID);
+    authorizationUrl.searchParams.set("redirect_uri", redirectUri);
+    authorizationUrl.searchParams.set("code_challenge", codeChallenge);
+    authorizationUrl.searchParams.set("code_challenge_method", "S256");
+    authorizationUrl.searchParams.set("state", state);
     callback.waitForCode.catch(() => {});
     onProgress("正在浏览器中完成 Developer CLI 授权...");
-    await openBrowser(authorizationUrl.toString());
+    try { await openBrowser(authorizationUrl.toString()); }
+    catch { onProgress(`无法自动打开浏览器，请手动访问：${authorizationUrl}`); }
     const code = await callback.waitForCode;
     onProgress("已收到浏览器授权，正在完成 Developer CLI 登录...");
     const api = new DeveloperApiClient({ apiBaseUrl, fetchImpl });
@@ -45,10 +54,11 @@ export async function authorizeCli({
       redirect_uri: redirectUri,
       code_verifier: codeVerifier,
     });
-    await credentialStore.set(apiBaseUrl, token.refresh_credential);
+    await persistRefreshCredential(api, token.refresh_credential, credentialStore);
     return renewableClient(api, token.access_token, credentialStore);
   } finally {
-    await callback.close();
+    await callback?.close();
+    if (!signal) { process.removeListener("SIGINT", stop); process.removeListener("SIGTERM", stop); }
   }
 }
 
@@ -77,7 +87,7 @@ export async function authenticateCli({
     }
     if (token) {
       if (token.refresh_credential !== refreshCredential) {
-        await credentialStore.set(apiBaseUrl, token.refresh_credential);
+        await persistRefreshCredential(api, token.refresh_credential, credentialStore);
       }
       return renewableClient(api, token.access_token, credentialStore);
     }
@@ -98,16 +108,27 @@ export async function authenticateCli({
   });
 }
 
-export async function openSystemBrowser(url, platform = process.platform) {
+export async function openSystemBrowser(url, platform = process.platform, { runner = execFile, systemRoot = process.env.SystemRoot } = {}) {
+  const parsed = new URL(url);
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password) {
+    throw new ZhikeCliError("zhike_browser_open_failed", "浏览器地址必须是无凭据的 HTTP(S) URL");
+  }
+  // URL 只作为 base64 数据传入固定表达式，避免 cmd/start 把 query 中的 & 当成命令。
+  const encodedUrl = Buffer.from(parsed.href, "utf8").toString("base64");
+  const windowsCommand = `Start-Process -FilePath ([Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${encodedUrl}')))`;
   const command =
     platform === "darwin"
       ? ["open", [url]]
       : platform === "win32"
-        ? ["cmd", ["/c", "start", "", url]]
+        ? [systemRoot && win32.isAbsolute(systemRoot)
+          ? win32.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe") : "",
+          ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(windowsCommand, "utf16le").toString("base64")]]
         : ["xdg-open", [url]];
   try {
-    await execFile(command[0], command[1], {
+    if (!command[0]) throw new Error("system browser unavailable");
+    await runner(command[0], command[1], {
       windowsHide: true,
+      timeout: 10_000,
     });
   } catch (error) {
     throw new ZhikeCliError(
@@ -127,14 +148,30 @@ function renewableClient(api, accessToken, credentialStore) {
     }
     const token = await api.refreshCliSession(refreshCredential);
     if (token.refresh_credential !== refreshCredential) {
-      await credentialStore.set(api.apiBaseUrl, token.refresh_credential);
+      await persistRefreshCredential(api, token.refresh_credential, credentialStore);
     }
     return token.access_token;
   };
   return client;
 }
 
-async function createLoopbackCallback({ state, timeoutMs }) {
+async function persistRefreshCredential(api, refreshCredential, credentialStore) {
+  try { await credentialStore.set(api.apiBaseUrl, refreshCredential); }
+  catch {
+    let cleanupConfirmed = false;
+    const previousSignal = api.signal;
+    try {
+      api.signal = AbortSignal.timeout(5_000);
+      await api.logoutCliSession(refreshCredential);
+      cleanupConfirmed = true;
+    } catch { /* 网络失败不改变本地存储失败这一事实。 */ }
+    finally { api.signal = previousSignal; }
+    throw new ZhikeCliError("zhike_secure_store_failed", "无法保存 Developer CLI 登录凭据，请修复系统安全存储后重新登录"
+      + (cleanupConfirmed ? "" : "；远端会话清理未确认"));
+  }
+}
+
+async function createLoopbackCallback({ state, timeoutMs, signal }) {
   let timer;
   let resolveCode;
   let rejectCode;
@@ -142,6 +179,7 @@ async function createLoopbackCallback({ state, timeoutMs }) {
     resolveCode = resolve;
     rejectCode = reject;
   });
+  waitForCode.catch(() => {});
   const server = createServer((request, response) => {
     const url = new URL(request.url || "/", "http://127.0.0.1");
     const receivedState = url.searchParams.get("state") || "";
@@ -169,6 +207,13 @@ async function createLoopbackCallback({ state, timeoutMs }) {
     server.once("error", reject);
     server.listen(0, "127.0.0.1", resolve);
   });
+  const cancel = () => {
+    rejectCode(new ZhikeCliError("zhike_cli_authorization_cancelled", "Developer CLI 授权已取消", { exitCode: 130 }));
+    server.close();
+    server.closeAllConnections();
+  };
+  signal?.addEventListener("abort", cancel, { once: true });
+  if (signal?.aborted) cancel();
   const address = server.address();
   if (!address || typeof address === "string") {
     server.close();
@@ -190,6 +235,7 @@ async function createLoopbackCallback({ state, timeoutMs }) {
     waitForCode,
     close: async () => {
       clearTimeout(timer);
+      signal?.removeEventListener("abort", cancel);
       if (!server.listening) {
         return;
       }

package/src/cli/credential-store.js

@@ -1,7 +1,9 @@
 import { execFile as execFileCallback } from "node:child_process";
 import { promisify } from "node:util";
+import { randomUUID } from "node:crypto";
 
 import { ZhikeCliError } from "../errors.js";
+import { WindowsCredentialStore } from "./windows-credential-store.js";
 
 const execFile = promisify(execFileCallback);
 const KEYCHAIN_SERVICE = "com.77hub.zhike.developer-cli";
@@ -86,12 +88,31 @@ export function createSystemCredentialStore(platform = process.platform) {
   if (platform === "darwin") {
     return new MacOSKeychainCredentialStore();
   }
+  if (platform === "win32") {
+    return new WindowsCredentialStore();
+  }
   throw new ZhikeCliError(
     "zhike_secure_store_unavailable",
     "当前操作系统尚未配置安全凭据存储适配器",
   );
 }
 
+export async function inspectSystemCredentialStore(platform = process.platform, createStore = createSystemCredentialStore) {
+  const provider = platform === "darwin" ? "macos-keychain" : platform === "win32" ? "windows-credential-manager" : null;
+  const check = { name: "secureStore", platform, provider, supported: Boolean(provider),
+    available: false, ok: false, writeAccess: "not_checked" };
+  if (!provider) return { ...check, code: "zhike_secure_store_unavailable" };
+  try {
+    const store = createStore(platform);
+    if (store.probe) await store.probe();
+    else await store.get(`https://probe-${randomUUID()}.invalid`);
+    return { ...check, available: true, ok: true };
+  } catch (error) {
+    return { ...check, code: ["zhike_secure_store_unavailable", "zhike_secure_store_failed"].includes(error?.code)
+      ? error.code : "zhike_secure_store_failed" };
+  }
+}
+
 function _keychainError(error) {
   return new ZhikeCliError(
     "zhike_secure_store_failed",

package/src/cli/local-commands.js

@@ -5,6 +5,7 @@ import { resolve } from "node:path";
 import { loadCliConfig } from "../config.js";
 import { ZhikeCliError } from "../errors.js";
 import { readProjectBinding } from "../project-binding.js";
+import { inspectSystemCredentialStore } from "./credential-store.js";
 
 const metadata = JSON.parse(await readFile(new URL("../../package.json", import.meta.url), "utf8"));
 export const commandHelp = {
@@ -72,7 +73,7 @@ export async function runLocalCommand(command, args, { cwd, environment }) {
   } catch {
     checks.push({ name: "package", ok: false, code: "package_missing_or_invalid" });
   }
-  checks.push({ name: "secureStore", ok: process.platform === "darwin", platform: process.platform });
+  checks.push(await inspectSystemCredentialStore());
   const result = localEnvelope({ localReady: checks.every((check) => check.ok),
     authentication: "not_checked", installation: "not_checked", checks });
   result.target = config ? { environment: config.apiBaseUrl, appId: binding?.appId ?? null } : null;

package/src/cli/windows-credential-bridge.ps1

@@ -0,0 +1,131 @@
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'
+$PSModuleAutoLoadingPreference = 'None'
+
+try {
+    if ($ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage') {
+        [Console]::Out.Write('{"version":1,"ok":false,"code":"zhike_secure_store_unavailable"}')
+        exit 0
+    }
+    Import-Module "$PSHOME\Modules\Microsoft.PowerShell.Utility\Microsoft.PowerShell.Utility.psd1" -ErrorAction Stop
+    [Console]::InputEncoding = New-Object System.Text.UTF8Encoding($false)
+    [Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+    $request = [Console]::In.ReadToEnd() | ConvertFrom-Json
+    $keys = @($request.PSObject.Properties.Name)
+    if ($request.version -ne 1 -or $request.operation -notin @('get', 'set', 'delete', 'probe') -or
+        @($keys | Where-Object { $_ -notin @('version', 'operation', 'origin', 'credential') }).Count -ne 0 -or
+        $request.origin -isnot [string] -or $request.origin.Length -gt 2048) { throw 'invalid request' }
+    $uri = New-Object System.Uri($request.origin, [System.UriKind]::Absolute)
+    if ($uri.Scheme -notin @('http', 'https') -or $uri.UserInfo -or $uri.AbsolutePath -ne '/' -or $uri.Query -or $uri.Fragment) { throw 'invalid origin' }
+    if ($request.operation -eq 'set') {
+        if ($request.credential -isnot [string] -or $request.credential.Length -lt 1 -or $request.credential.Length -gt 512) { throw 'invalid credential' }
+    } elseif ($keys -contains 'credential') { throw 'unexpected credential' }
+
+    # 仅绑定固定 Win32 API；全部在内存中构造，避免运行时编译器对 Unicode TEMP 的依赖。
+    $assembly = [AppDomain]::CurrentDomain.DefineDynamicAssembly(
+        (New-Object Reflection.AssemblyName('ZhikeCredentialBridge')), [Reflection.Emit.AssemblyBuilderAccess]::Run)
+    $module = $assembly.DefineDynamicModule('ZhikeCredentialBridge')
+    $layout = [Reflection.TypeAttributes]::Public -bor [Reflection.TypeAttributes]::SequentialLayout -bor [Reflection.TypeAttributes]::Sealed
+    $structure = $module.DefineType('ZhikeCredential', $layout, [ValueType])
+    # 字段顺序对应 CREDENTIALW；指针由当前进程位数决定，FILETIME 作为 64 位值对齐。
+    $fields = @(
+        @('Flags', [uint32]), @('Type', [uint32]), @('TargetName', [IntPtr]), @('Comment', [IntPtr]),
+        @('LastWritten', [long]), @('CredentialBlobSize', [uint32]), @('CredentialBlob', [IntPtr]),
+        @('Persist', [uint32]), @('AttributeCount', [uint32]), @('Attributes', [IntPtr]),
+        @('TargetAlias', [IntPtr]), @('UserName', [IntPtr]))
+    foreach ($field in $fields) { [void]$structure.DefineField($field[0], $field[1], [Reflection.FieldAttributes]::Public) }
+    $credentialType = $structure.CreateType()
+    $binding = $module.DefineType('ZhikeNativeCredential', [Reflection.TypeAttributes]::Public)
+    $dllImport = [Runtime.InteropServices.DllImportAttribute]
+    $importFields = [Reflection.FieldInfo[]]@($dllImport.GetField('EntryPoint'), $dllImport.GetField('CharSet'), $dllImport.GetField('SetLastError'))
+    $signatures = @(
+        @('Read', 'CredReadW', [bool], [type[]]@([string], [uint32], [uint32], [IntPtr].MakeByRefType())),
+        @('Write', 'CredWriteW', [bool], [type[]]@([IntPtr], [uint32])),
+        @('Delete', 'CredDeleteW', [bool], [type[]]@([string], [uint32], [uint32])),
+        @('Free', 'CredFree', [void], [type[]]@([IntPtr])))
+    foreach ($signature in $signatures) {
+        $method = $binding.DefineMethod($signature[0], [Reflection.MethodAttributes]'Public, Static, PinvokeImpl', $signature[2], $signature[3])
+        $attribute = New-Object Reflection.Emit.CustomAttributeBuilder(
+            $dllImport.GetConstructor([type[]]@([string])), [object[]]@('advapi32.dll'),
+            $importFields, [object[]]@($signature[1], [Runtime.InteropServices.CharSet]::Unicode, $true))
+        $method.SetCustomAttribute($attribute)
+        $method.SetImplementationFlags([Reflection.MethodImplAttributes]::PreserveSig)
+    }
+    $native = $binding.CreateType()
+    $hash = [Security.Cryptography.SHA256]::Create()
+    try { $digest = [BitConverter]::ToString($hash.ComputeHash([Text.Encoding]::UTF8.GetBytes($request.origin))).Replace('-', '').ToLowerInvariant() }
+    finally { $hash.Dispose() }
+    $target = 'com.77hub.zhike.developer-cli/v1/' + $digest
+    $value = $null
+    switch ($request.operation) {
+        { $_ -in @('get', 'probe') } {
+            $pointer = [IntPtr]::Zero
+            if (-not $native::Read($target, 1, 0, [ref]$pointer)) {
+                $errorCode = [Runtime.InteropServices.Marshal]::GetLastWin32Error()
+                if ($errorCode -ne 1168) { throw 'credential read failed' }
+            } else {
+                $blob = [IntPtr]::Zero
+                $blobSize = 0
+                try {
+                    # 按固定结构的实际偏移读取，避免 PowerShell 在 PtrToStructure 的 Type/Object 重载间歧义。
+                    $kind = [Runtime.InteropServices.Marshal]::ReadInt32($pointer, [Runtime.InteropServices.Marshal]::OffsetOf($credentialType, 'Type').ToInt32())
+                    $persist = [Runtime.InteropServices.Marshal]::ReadInt32($pointer, [Runtime.InteropServices.Marshal]::OffsetOf($credentialType, 'Persist').ToInt32())
+                    $blobSize = [Runtime.InteropServices.Marshal]::ReadInt32($pointer, [Runtime.InteropServices.Marshal]::OffsetOf($credentialType, 'CredentialBlobSize').ToInt32())
+                    $blob = [Runtime.InteropServices.Marshal]::ReadIntPtr($pointer, [Runtime.InteropServices.Marshal]::OffsetOf($credentialType, 'CredentialBlob').ToInt32())
+                    # Generic / 本用户本机跨登录持久化；BlobSize 单位为字节，内容为 UTF-16LE。
+                    if ($kind -ne 1 -or $persist -ne 2 -or $blobSize -lt 1 -or $blobSize -gt 1024 -or
+                        $blobSize % 2 -ne 0 -or $blob -eq [IntPtr]::Zero) { throw 'invalid credential metadata' }
+                    if ($request.operation -eq 'get') {
+                        $value = [Runtime.InteropServices.Marshal]::PtrToStringUni($blob, [int]($blobSize / 2))
+                    }
+                } finally {
+                    if ($blob -ne [IntPtr]::Zero -and $blobSize -gt 0 -and $blobSize -le 1024) {
+                        for ($i = 0; $i -lt $blobSize; $i++) { [Runtime.InteropServices.Marshal]::WriteByte($blob, $i, 0) }
+                    }
+                    $native::Free($pointer)
+                }
+            }
+        }
+        'set' {
+            $bytes = [Text.Encoding]::Unicode.GetBytes($request.credential)
+            $blob = [IntPtr]::Zero
+            $record = [IntPtr]::Zero
+            $namePointer = [IntPtr]::Zero
+            $userPointer = [IntPtr]::Zero
+            try {
+                $blob = [Runtime.InteropServices.Marshal]::AllocHGlobal($bytes.Length)
+                [Runtime.InteropServices.Marshal]::Copy($bytes, 0, $blob, $bytes.Length)
+                $namePointer = [Runtime.InteropServices.Marshal]::StringToHGlobalUni($target)
+                $userPointer = [Runtime.InteropServices.Marshal]::StringToHGlobalUni($request.origin)
+                $credential = [Activator]::CreateInstance($credentialType)
+                $credential.Type = 1
+                $credential.TargetName = $namePointer
+                $credential.UserName = $userPointer
+                $credential.CredentialBlob = $blob
+                $credential.CredentialBlobSize = $bytes.Length
+                $credential.Persist = 2
+                $record = [Runtime.InteropServices.Marshal]::AllocHGlobal([Runtime.InteropServices.Marshal]::SizeOf($credential))
+                [Runtime.InteropServices.Marshal]::StructureToPtr($credential, $record, $false)
+                if (-not $native::Write($record, 0)) { throw 'credential write failed' }
+            } finally {
+                [Array]::Clear($bytes, 0, $bytes.Length)
+                if ($blob -ne [IntPtr]::Zero) {
+                    [Runtime.InteropServices.Marshal]::Copy($bytes, 0, $blob, $bytes.Length)
+                    [Runtime.InteropServices.Marshal]::FreeHGlobal($blob)
+                }
+                foreach ($allocated in @($record, $namePointer, $userPointer)) {
+                    if ($allocated -ne [IntPtr]::Zero) { [Runtime.InteropServices.Marshal]::FreeHGlobal($allocated) }
+                }
+            }
+        }
+        'delete' {
+            if (-not $native::Delete($target, 1, 0)) {
+                $errorCode = [Runtime.InteropServices.Marshal]::GetLastWin32Error()
+                if ($errorCode -ne 1168) { throw 'credential delete failed' }
+            }
+        }
+    }
+    [Console]::Out.Write((@{ version = 1; ok = $true; value = $value } | ConvertTo-Json -Compress))
+} catch {
+    [Console]::Out.Write('{"version":1,"ok":false,"code":"zhike_secure_store_failed"}')
+}

package/src/cli/windows-credential-store.js

@@ -0,0 +1,112 @@
+import { execFile, spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { win32 } from "node:path";
+
+import { normalizeOrigin } from "../config.js";
+import { ZhikeCliError } from "../errors.js";
+
+let script;
+const failure = () => new ZhikeCliError("zhike_secure_store_failed", "无法访问 Windows 安全凭据存储，请检查系统凭据库和 PowerShell 策略后重试");
+const unavailable = () => new ZhikeCliError("zhike_secure_store_unavailable", "Windows 安全凭据适配不可用，需要系统 Windows PowerShell 5.1 及允许的原生 API 调用");
+
+export class WindowsCredentialStore {
+  constructor({ runner = runWindowsCredentialBridge } = {}) {
+    this.runner = runner;
+  }
+
+  async get(environmentId) { return this.request("get", normalizeOrigin(environmentId, "Developer API")); }
+
+  async set(environmentId, refreshCredential) {
+    if (typeof refreshCredential !== "string" || !refreshCredential.length || refreshCredential.length > 512) throw failure();
+    await this.request("set", normalizeOrigin(environmentId, "Developer API"), refreshCredential);
+  }
+
+  async delete(environmentId) { await this.request("delete", normalizeOrigin(environmentId, "Developer API")); }
+
+  async probe() { await this.request("probe", `https://probe-${randomUUID()}.invalid`); }
+
+  async request(operation, origin, credential) {
+    try {
+      const result = await this.runner({ version: 1, operation, origin, ...(credential === undefined ? {} : { credential }) });
+      if (!result || result.version !== 1 || typeof result.ok !== "boolean" ||
+          Object.keys(result).some((key) => !["version", "ok", "value", "code"].includes(key))) throw failure();
+      if (!result.ok) {
+        if (result.code === "zhike_secure_store_unavailable") throw unavailable();
+        throw failure();
+      }
+      if (operation === "get") {
+        if (result.value !== null && (typeof result.value !== "string" || !result.value.length || result.value.length > 512)) throw failure();
+        return result.value;
+      }
+      if (result.value !== null) throw failure();
+    } catch (error) {
+      if (error instanceof ZhikeCliError) throw error;
+      throw failure();
+    }
+  }
+}
+
+/** 固定程序/脚本与秘密数据分离；子进程输出不得原文进入 CLI 错误。 */
+export async function runWindowsCredentialBridge(request, {
+  spawnImpl = spawn, systemRoot = process.env.SystemRoot, environment = process.env,
+  timeoutMs = 10_000, maxOutputBytes = 65_536,
+} = {}) {
+  if (!systemRoot || !win32.isAbsolute(systemRoot)) throw unavailable();
+  let source;
+  try { source = await (script ??= readFile(new URL("./windows-credential-bridge.ps1", import.meta.url), "utf8")); } catch { throw unavailable(); }
+  const executable = win32.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+  const encoded = Buffer.from(source, "utf16le").toString("base64");
+  const env = Object.fromEntries(Object.entries(environment).filter(([key]) =>
+    ["systemroot", "windir", "temp", "tmp", "path", "comspec", "systemdrive",
+      "userprofile", "appdata", "localappdata", "homedrive", "homepath", "username", "userdomain",
+      "programfiles", "programfiles(x86)", "programw6432", "programdata", "allusersprofile",
+      "pathext", "computername", "processor_architecture", "processor_identifier", "processor_level",
+      "processor_revision", "number_of_processors", "os"].includes(key.toLowerCase())));
+  // ConvertFrom-Json / Add-Type 的模块解析只使用系统目录，不加载项目或用户自定义模块。
+  // 固定子进程不需要持久化命令发现缓存；避免依赖 runner/用户的缓存路径或锁。
+  env.PSModuleAnalysisCachePath = "NUL";
+  env.PSModulePath = win32.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "Modules");
+  return new Promise((resolve, reject) => {
+    let child;
+    let output = "";
+    let outputSize = 0;
+    let settled = false;
+    let timer;
+    const finish = (error, result) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      output = "";
+      if (error) reject(error); else resolve(result);
+    };
+    const terminate = () => {
+      if (Number.isInteger(child?.pid) && process.platform === "win32") {
+        execFile(win32.join(systemRoot, "System32", "taskkill.exe"), ["/PID", String(child.pid), "/T", "/F"],
+          { windowsHide: true, timeout: 3_000 }, () => child.kill());
+      } else child?.kill();
+    };
+    try {
+      child = spawnImpl(executable, ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", encoded],
+        { shell: false, windowsHide: true, stdio: ["pipe", "pipe", "pipe"], env });
+    } catch { finish(unavailable()); return; }
+    timer = setTimeout(() => { terminate(); finish(failure()); }, timeoutMs);
+    const collect = (bytes, keep) => {
+      if (settled) return;
+      outputSize += Buffer.byteLength(bytes);
+      if (outputSize > maxOutputBytes) { terminate(); finish(failure()); return; }
+      if (keep) output += bytes;
+    };
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (bytes) => collect(bytes, true));
+    child.stderr.on("data", (bytes) => collect(bytes, false));
+    child.on("error", () => finish(unavailable()));
+    child.stdin.on("error", () => { terminate(); finish(failure()); });
+    child.on("close", (code) => {
+      if (settled) return;
+      if (code !== 0) { finish(failure()); return; }
+      try { finish(null, JSON.parse(output)); } catch { finish(failure()); }
+    });
+    child.stdin.end(JSON.stringify(request), "utf8");
+  });
+}

package/src/toolchain/real-build.js

@@ -148,7 +148,7 @@ async function assertTypeScriptProgram(projectDirectory, { sourceFiles, serverFu
   const diagnostics = ts.getPreEmitDiagnostics(program);
   if (diagnostics.length === 0) return;
   const diagnostic = diagnostics[0];
-  const contractLine = diagnostic.file?.fileName === contractPath
+  const contractLine = diagnostic.file && resolve(diagnostic.file.fileName) === contractPath
     ? diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start || 0).line : -1;
   const contractOwner = contractLine > 0 ? handlers[Math.floor((contractLine - 1) / 2)] : null;
   const location = contractOwner ? `src/${contractOwner.relativePath}（参数/返回类型）` : diagnostic.file
@@ -314,7 +314,7 @@ function createSdkBuildPlugin(projectDirectory, sources, target) {
           };
           export const TableCell = Object.defineProperties(props => createElement(ui.TableCell, props), { Avatar: { get: () => ui.Avatar }, Badge: { value: Badge } });
           export const Table = Object.defineProperties(props => createElement(ui.Table, props), { Header: { get: () => ui.Table.Header }, HeaderCell: { get: () => ui.Table.HeaderCell }, Body: { get: () => ui.Table.Body }, Row: { get: () => ui.Table.Row }, Cell: { value: TableCell } });
-          export const { ${[...publicComponentNames.filter(name => !["TextBlock", "Badge", "Table", "TableCell"].includes(name)), "Typography", "Widget"].join(", ")} } = ui;
+          export const { ${[...publicComponentNames.filter(name => !["TextBlock", "Badge", "Table", "TableCell"].includes(name)), "Typography", "Widget", "useConversation"].join(", ")} } = ui;
         ` }));
       }
       if (target !== "remote-client") buildApi.onResolve({ filter: /^@77-zhike\/app-sdk\/(client|server)$/ }, (args) => ({

package/src/ui/conversation.d.ts

@@ -31,3 +31,46 @@ export interface ConversationErrorEvent {
   turnId?: string;
   executionId?: string;
 }
+
+import type { JsonValue } from './index.js';
+/** 定位符不授予权限；prepareTurn须从当前场景白名单解析快照。 */
+export interface ConversationReference { id: string; type: string; label: string; value: Record<string, JsonValue>; }
+export interface PreparedConversationReference extends ConversationReference {
+  /** App给出的业务修订或内容指纹，不授予权限。 */
+  revision: string;
+  /** 发送时冻结的白名单业务数据，历史不重新读取对象。 */
+  snapshot: JsonValue;
+}
+export interface ConversationTurnInput { context: JsonValue; references: PreparedConversationReference[]; }
+export interface ConversationOptions {
+  agentId: string;
+  scenario: string;
+  /** 会话创建背景，逐轮数据请使用prepareTurn。 */
+  context: string;
+  prepareTurn?: (input: { text: string; references: ConversationReference[] }) => ConversationTurnInput | Promise<ConversationTurnInput>;
+}
+export type ConversationRootBinding = (ConversationOptions & { controller?: never }) | {
+  controller: ConversationController; agentId?: never; scenario?: never; context?: never; prepareTurn?: never;
+};
+export interface ConversationController {
+  readonly state: { readonly canSend: boolean; readonly status: 'idle' | 'preparing' | 'running' | 'stopping' | 'unconfirmed'; readonly readOnly: boolean; readonly conversationId: string };
+  /** Promise只确认本次输入受理，模型终态由原callback通知。 */
+  send(input: { text: string; references?: ConversationReference[] }): Promise<void>;
+  readonly composer: {
+    setText(text: string, options?: { mode?: 'append' | 'replace' }): Promise<void>;
+    addReference(reference: ConversationReference): Promise<void>;
+    removeReference(id: string): Promise<void>;
+  };
+}
+export interface ToolResultView {
+  readonly messageId: string;
+  readonly toolCallId: string;
+  readonly tool: { kind: 'app'; key: string; name: string };
+  readonly result: JsonValue;
+  /** 产生此工具结果的那一轮资料，不能当作当前编辑器真值。 */
+  readonly turnContext: JsonValue;
+  readonly references: readonly PreparedConversationReference[];
+  /** 当前绑定不允许继续或操作此结果；App仍须独立校验业务版本。 */
+  readonly readOnly: boolean;
+}
+export function useConversation(options: ConversationOptions): ConversationController;

package/src/ui/conversation.js

@@ -0,0 +1,82 @@
+import { assertJsonValue } from './validation.js';
+
+const bindings = new WeakMap();
+const idle = Object.freeze({ status: 'preparing', canSend: false, readOnly: false, conversationId: '' });
+
+/** 只持有Worker内的局部句柄；调用资格始终由Host重新检查。 */
+export function createConversationComponents(React, components, { useInvoke = () => () => Promise.reject(new Error('runtime_host_interaction_unavailable')) } = {}) {
+  const Context = React.createContext(null);
+  function useConversation(options) {
+    const bindingId = React.useId();
+    const invoke = useInvoke();
+    const latest = React.useRef(options); latest.current = options;
+    const [state, setState] = React.useState(idle);
+    const handle = React.useMemo(() => {
+      const binding = { bindingId: `${bindingId}:${options.agentId}:${options.scenario}`, state: idle, mounted: false,
+        options: () => latest.current, publish(value) { binding.state = value; setState(value); } };
+      const operate = (operation, payload) => {
+        assertJsonValue(payload);
+        if (!binding.mounted || !binding.state.conversationId) return Promise.reject(new Error('app_agent_controller_unbound'));
+        return invoke('conversation', { bindingId: binding.bindingId, conversationId: binding.state.conversationId, operation, payload });
+      };
+      const result = Object.freeze({
+        get state() { return binding.state; },
+        send: input => operate('send', input),
+        composer: Object.freeze({
+          setText: (text, options = {}) => operate('setText', { text, mode: options.mode ?? 'append' }),
+          addReference: reference => operate('addReference', reference),
+          removeReference: id => operate('removeReference', { id }),
+        }),
+      });
+      bindings.set(result, binding);
+      return result;
+    }, [bindingId, options.agentId, options.scenario]);
+    // publish的setState只负责让使用state的页面重新渲染，handle引用保持稳定。
+    void state;
+    return handle;
+  }
+  const NativeRoot = components.ConversationRoot;
+  function Root({ controller, children, ...props }) {
+    const internal = useConversation({ agentId: props.agentId, scenario: props.scenario, context: props.context, prepareTurn: props.prepareTurn });
+    const selected = controller ?? internal;
+    const binding = bindings.get(selected);
+    if (!binding || controller && ['agentId', 'scenario', 'context', 'prepareTurn'].some(key => props[key] !== undefined)) throw new Error('app_agent_controller_config_conflict');
+    const options = binding.options();
+    React.useEffect(() => {
+      if (binding.mounted) throw new Error('app_agent_controller_already_bound');
+      binding.mounted = true;
+      return () => { binding.mounted = false; binding.publish(idle); };
+    }, [binding]);
+    const onState = React.useCallback(value => { binding.publish(value); }, [binding]);
+    const onPrepareTurn = React.useCallback(async input => {
+      const prepare = binding.options().prepareTurn;
+      return prepare ? await prepare(input) : { context: null, references: input.references.map(item => ({ ...item, revision: 'unspecified', snapshot: item.value })) };
+    }, [binding]);
+    const { prepareTurn: _prepare, ...safe } = props;
+    return React.createElement(Context.Provider, { value: selected }, React.createElement(NativeRoot, {
+      ...safe, agentId: options.agentId, scenario: options.scenario, context: options.context ?? '',
+      bindingId: binding.bindingId, onState, ...(options.prepareTurn ? { onPrepareTurn } : {}),
+    }, children));
+  }
+  const NativeMessages = components.ConversationMessages;
+  function Messages({ toolRenderers, ...props }) {
+    React.useContext(Context);
+    const [views, setViews] = React.useState([]);
+    const onToolViews = React.useCallback(value => setViews(value), []);
+    const selected = views.filter(view => typeof toolRenderers?.[view.tool.key] === 'function');
+    return React.createElement(NativeMessages, { ...props, ...(toolRenderers ? { onToolViews,
+      resultSlots: selected.map(({ messageId, toolCallId }) => ({ messageId, toolCallId })) } : {}) },
+      selected.map(view => React.createElement(components.Stack, { key: view.toolCallId }, React.createElement(toolRenderers[view.tool.key], view))));
+  }
+  function Conversation(props) {
+    // 默认组合与组合Root共享同一控制器，老Bundle的Host节点仍然兼容。
+    const { placeholder, ...rootProps } = props;
+    return React.createElement(Root, rootProps,
+      React.createElement(components.Stack, { direction: 'row' }, React.createElement(components.ConversationHistory), React.createElement(components.ConversationNewButton, { iconOnly: true }), React.createElement(components.ConversationStopButton)),
+      React.createElement(Messages), React.createElement(components.ConversationStatus), React.createElement(components.ConversationComposer, { placeholder }));
+  }
+  return { useConversation, Conversation: Object.assign(Conversation, { Root, Messages,
+    Composer: components.ConversationComposer, History: components.ConversationHistory,
+    NewButton: components.ConversationNewButton, StopButton: components.ConversationStopButton, Status: components.ConversationStatus }),
+    ConversationRoot: Root, ConversationMessages: Messages };
+}

package/src/ui/factory.js

@@ -1,10 +1,11 @@
+import { createConversationComponents } from './conversation.js';
 import { componentTypes, legacyComponentTypes } from './components.generated.js';
 import { useNormalizedOptions } from '../forms/normalize-options.js';
 import { assertExternalUrl } from '../client/external-url.js';
 import { assertBannerActions, assertJsonValue, assertChartData, assertChartSelection, assertAnalysisViewData } from './validation.js';
 import { assertNativeStyles } from './native-dom.js';
 
-export function createUiComponents(React, { legacy = false, useOwner = () => null, openExternal = () => Promise.reject(new Error('runtime_host_interaction_unavailable')) } = {}) {
+export function createUiComponents(React, { legacy = false, useOwner = () => null, useInvoke, openExternal = () => Promise.reject(new Error('runtime_host_interaction_unavailable')) } = {}) {
   const TabValue = React.createContext(null);
   const components = Object.fromEntries((legacy ? legacyComponentTypes : componentTypes).map(type => [type, function RemoteComponent(props) {
     if (type === 'NativeDOM' && props.styles !== undefined) assertNativeStyles(props.styles);
@@ -70,5 +71,6 @@ export function createUiComponents(React, { legacy = false, useOwner = () => nul
     Loading: components.WidgetLoading,
     Decoration: components.WidgetDecoration,
   });
+  if (components.Conversation) Object.assign(components, createConversationComponents(React, components, { useInvoke }));
   return components;
 }

package/src/ui/index.d.ts

@@ -8,10 +8,7 @@ export interface ChartData { labels: string[]; series: { id: string; label: stri
 export type AppIconName = "a-arrow-down" | "a-arrow-up" | "a-large-small" | "accessibility" | "activity" | "activity-square" | "ad" | "air-vent" | "airplay" | "alarm-check" | "alarm-clock" | "alarm-clock-check" | "alarm-clock-minus" | "alarm-clock-off" | "alarm-clock-plus" | "alarm-minus" | "alarm-plus" | "alarm-smoke" | "album" | "alert-circle" | "alert-octagon" | "alert-triangle" | "align-center" | "align-center-horizontal" | "align-center-vertical" | "align-end-horizontal" | "align-end-vertical" | "align-horizontal-distribute-center" | "align-horizontal-distribute-end" | "align-horizontal-distribute-start" | "align-horizontal-justify-center" | "align-horizontal-justify-end" | "align-horizontal-justify-start" | "align-horizontal-space-around" | "align-horizontal-space-between" | "align-justify" | "align-left" | "align-right" | "align-start-horizontal" | "align-start-vertical" | "align-vertical-distribute-center" | "align-vertical-distribute-end" | "align-vertical-distribute-start" | "align-vertical-justify-center" | "align-vertical-justify-end" | "align-vertical-justify-start" | "align-vertical-space-around" | "align-vertical-space-between" | "ambulance" | "ampersand" | "ampersands" | "amphora" | "anchor" | "angle" | "angry" | "annoyed" | "antenna" | "anvil" | "aperture" | "app-window" | "app-window-mac" | "apple" | "archive" | "archive-restore" | "archive-x" | "area-chart" | "armchair" | "arrow-big-down" | "arrow-big-down-dash" | "arrow-big-left" | "arrow-big-left-dash" | "arrow-big-right" | "arrow-big-right-dash" | "arrow-big-up" | "arrow-big-up-dash" | "arrow-down" | "arrow-down-0-1" | "arrow-down-01" | "arrow-down-1-0" | "arrow-down-10" | "arrow-down-a-z" | "arrow-down-az" | "arrow-down-circle" | "arrow-down-from-line" | "arrow-down-left" | "arrow-down-left-from-circle" | "arrow-down-left-from-square" | "arrow-down-left-square" | "arrow-down-narrow-wide" | "arrow-down-right" | "arrow-down-right-from-circle" | "arrow-down-right-from-square" | "arrow-down-right-square" | "arrow-down-square" | "arrow-down-to-dot" | "arrow-down-to-line" | "arrow-down-up" | "arrow-down-wide-narrow" | "arrow-down-z-a" | "arrow-down-za" | "arrow-left" | "arrow-left-circle" | "arrow-left-from-line" | "arrow-left-right" | "arrow-left-square" | "arrow-left-to-line" | "arrow-right" | "arrow-right-circle" | "arrow-right-from-line" | "arrow-right-left" | "arrow-right-square" | "arrow-right-to-line" | "arrow-up" | "arrow-up-0-1" | "arrow-up-01" | "arrow-up-1-0" | "arrow-up-10" | "arrow-up-a-z" | "arrow-up-az" | "arrow-up-circle" | "arrow-up-down" | "arrow-up-from-dot" | "arrow-up-from-line" | "arrow-up-left" | "arrow-up-left-from-circle" | "arrow-up-left-from-square" | "arrow-up-left-square" | "arrow-up-narrow-wide" | "arrow-up-right" | "arrow-up-right-from-circle" | "arrow-up-right-from-square" | "arrow-up-right-square" | "arrow-up-square" | "arrow-up-to-line" | "arrow-up-wide-narrow" | "arrow-up-z-a" | "arrow-up-za" | "arrows-up-from-line" | "asterisk" | "asterisk-square" | "astroid" | "at-sign" | "atom" | "audio-lines" | "audio-lines-off" | "audio-lines-x" | "audio-waveform" | "award" | "axe" | "axis-3-d" | "axis-3d" | "baby" | "backpack" | "badge" | "badge-alert" | "badge-cent" | "badge-check" | "badge-dollar-sign" | "badge-euro" | "badge-help" | "badge-indian-rupee" | "badge-info" | "badge-japanese-yen" | "badge-minus" | "badge-percent" | "badge-plus" | "badge-pound-sterling" | "badge-question-mark" | "badge-russian-ruble" | "badge-swiss-franc" | "badge-turkish-lira" | "badge-x" | "baggage-claim" | "balloon" | "ban" | "banana" | "bandage" | "banknote" | "banknote-arrow-down" | "banknote-arrow-up" | "banknote-check" | "banknote-x" | "bar-chart" | "bar-chart-2" | "bar-chart-3" | "bar-chart-4" | "bar-chart-big" | "bar-chart-horizontal" | "bar-chart-horizontal-big" | "barcode" | "barrel" | "baseline" | "bath" | "battery" | "battery-charging" | "battery-full" | "battery-low" | "battery-medium" | "battery-plus" | "battery-warning" | "beaker" | "bean" | "bean-off" | "bed" | "bed-double" | "bed-single" | "beef" | "beef-off" | "beer" | "beer-off" | "bell" | "bell-check" | "bell-dot" | "bell-electric" | "bell-minus" | "bell-off" | "bell-plus" | "bell-ring" | "between-horizonal-end" | "between-horizonal-start" | "between-horizontal-end" | "between-horizontal-start" | "between-vertical-end" | "between-vertical-start" | "biceps-flexed" | "bike" | "binary" | "binoculars" | "biohazard" | "bird" | "birdhouse" | "bitcoin" | "blend" | "blender" | "blinds" | "blocks" | "bluetooth" | "bluetooth-connected" | "bluetooth-off" | "bluetooth-searching" | "bold" | "bolt" | "bomb" | "bone" | "bone-fracture" | "book" | "book-a" | "book-alert" | "book-audio" | "book-check" | "book-copy" | "book-dashed" | "book-down" | "book-headphones" | "book-heart" | "book-image" | "book-key" | "book-lock" | "book-marked" | "book-minus" | "book-open" | "book-open-check" | "book-open-text" | "book-plus" | "book-search" | "book-template" | "book-text" | "book-type" | "book-up" | "book-up-2" | "book-user" | "book-x" | "bookmark" | "bookmark-check" | "bookmark-minus" | "bookmark-off" | "bookmark-plus" | "bookmark-x" | "boom-box" | "bot" | "bot-message-square" | "bot-off" | "bottle-wine" | "bow-arrow" | "box" | "box-select" | "boxes" | "braces" | "brackets" | "brain" | "brain-circuit" | "brain-cog" | "brick-wall" | "brick-wall-fire" | "brick-wall-shield" | "briefcase" | "briefcase-business" | "briefcase-conveyor-belt" | "briefcase-medical" | "bring-to-front" | "broccoli" | "broom" | "broom-sparkles" | "brush" | "brush-cleaning" | "bubbles" | "bug" | "bug-off" | "bug-play" | "building" | "building-2" | "bus" | "bus-front" | "cable" | "cable-car" | "cake" | "cake-slice" | "calculator" | "calendar" | "calendar-1" | "calendar-arrow-down" | "calendar-arrow-up" | "calendar-check" | "calendar-check-2" | "calendar-clock" | "calendar-cog" | "calendar-days" | "calendar-fold" | "calendar-heart" | "calendar-minus" | "calendar-minus-2" | "calendar-off" | "calendar-plus" | "calendar-plus-2" | "calendar-range" | "calendar-search" | "calendar-sync" | "calendar-x" | "calendar-x-2" | "calendars" | "camera" | "camera-off" | "candlestick-chart" | "candy" | "candy-cane" | "candy-off" | "cannabis" | "cannabis-off" | "captions" | "captions-off" | "car" | "car-battery" | "car-front" | "car-taxi-front" | "caravan" | "card-sim" | "carrot" | "case-lower" | "case-sensitive" | "case-upper" | "cassette-tape" | "cast" | "castle" | "cat" | "cctv" | "cctv-off" | "chart-area" | "chart-bar" | "chart-bar-big" | "chart-bar-decreasing" | "chart-bar-increasing" | "chart-bar-stacked" | "chart-candlestick" | "chart-column" | "chart-column-big" | "chart-column-decreasing" | "chart-column-increasing" | "chart-column-stacked" | "chart-gantt" | "chart-line" | "chart-network" | "chart-no-axes-column" | "chart-no-axes-column-decreasing" | "chart-no-axes-column-increasing" | "chart-no-axes-combined" | "chart-no-axes-gantt" | "chart-pie" | "chart-scatter" | "chart-spline" | "check" | "check-check" | "check-circle" | "check-circle-2" | "check-line" | "check-square" | "check-square-2" | "chef-hat" | "cherry" | "chess-bishop" | "chess-king" | "chess-knight" | "chess-pawn" | "chess-queen" | "chess-rook" | "chevron-down" | "chevron-down-circle" | "chevron-down-square" | "chevron-first" | "chevron-last" | "chevron-left" | "chevron-left-circle" | "chevron-left-square" | "chevron-right" | "chevron-right-circle" | "chevron-right-square" | "chevron-up" | "chevron-up-circle" | "chevron-up-square" | "chevrons-down" | "chevrons-down-up" | "chevrons-left" | "chevrons-left-right" | "chevrons-left-right-ellipsis" | "chevrons-right" | "chevrons-right-left" | "chevrons-up" | "chevrons-up-down" | "church" | "cigarette" | "cigarette-off" | "circle" | "circle-alert" | "circle-arrow-down" | "circle-arrow-left" | "circle-arrow-out-down-left" | "circle-arrow-out-down-right" | "circle-arrow-out-up-left" | "circle-arrow-out-up-right" | "circle-arrow-right" | "circle-arrow-up" | "circle-check" | "circle-check-big" | "circle-chevron-down" | "circle-chevron-left" | "circle-chevron-right" | "circle-chevron-up" | "circle-dashed" | "circle-divide" | "circle-dollar-sign" | "circle-dot" | "circle-dot-dashed" | "circle-ellipsis" | "circle-equal" | "circle-euro" | "circle-fading-arrow-up" | "circle-fading-plus" | "circle-gauge" | "circle-help" | "circle-minus" | "circle-off" | "circle-parking" | "circle-parking-off" | "circle-pause" | "circle-percent" | "circle-pile" | "circle-play" | "circle-plus" | "circle-pound-sterling" | "circle-power" | "circle-question-mark" | "circle-slash" | "circle-slash-2" | "circle-slashed" | "circle-small" | "circle-star" | "circle-stop" | "circle-user" | "circle-user-round" | "circle-x" | "circuit-board" | "citrus" | "clapperboard" | "clipboard" | "clipboard-check" | "clipboard-clock" | "clipboard-copy" | "clipboard-edit" | "clipboard-list" | "clipboard-minus" | "clipboard-paste" | "clipboard-pen" | "clipboard-pen-line" | "clipboard-plus" | "clipboard-signature" | "clipboard-type" | "clipboard-x" | "clock" | "clock-1" | "clock-10" | "clock-11" | "clock-12" | "clock-2" | "clock-3" | "clock-4" | "clock-5" | "clock-6" | "clock-7" | "clock-8" | "clock-9" | "clock-alert" | "clock-arrow-down" | "clock-arrow-left" | "clock-arrow-right" | "clock-arrow-up" | "clock-check" | "clock-fading" | "clock-plus" | "closed-caption" | "cloud" | "cloud-alert" | "cloud-backup" | "cloud-check" | "cloud-cog" | "cloud-download" | "cloud-drizzle" | "cloud-fog" | "cloud-hail" | "cloud-lightning" | "cloud-moon" | "cloud-moon-rain" | "cloud-off" | "cloud-rain" | "cloud-rain-wind" | "cloud-snow" | "cloud-sun" | "cloud-sun-rain" | "cloud-sync" | "cloud-upload" | "cloudy" | "clover" | "club" | "code" | "code-2" | "code-square" | "code-xml" | "coffee" | "cog" | "coins" | "columns" | "columns-2" | "columns-3" | "columns-3-cog" | "columns-4" | "columns-settings" | "combine" | "command" | "compass" | "component" | "computer" | "concierge-bell" | "cone" | "construction" | "contact" | "contact-2" | "contact-round" | "container" | "contrast" | "cookie" | "cooking-pot" | "copy" | "copy-check" | "copy-minus" | "copy-plus" | "copy-slash" | "copy-x" | "copyleft" | "copyright" | "corner-down-left" | "corner-down-right" | "corner-left-down" | "corner-left-up" | "corner-right-down" | "corner-right-up" | "corner-up-left" | "corner-up-right" | "cpu" | "creative-commons" | "credit-card" | "croissant" | "crop" | "cross" | "crosshair" | "crown" | "cuboid" | "cup-soda" | "curly-braces" | "currency" | "cylinder" | "dam" | "database" | "database-arrow-down" | "database-arrow-up" | "database-backup" | "database-check" | "database-minus" | "database-plus" | "database-search" | "database-x" | "database-zap" | "decimals-arrow-left" | "decimals-arrow-right" | "delete" | "dessert" | "diameter" | "diamond" | "diamond-minus" | "diamond-percent" | "diamond-plus" | "dice-1" | "dice-2" | "dice-3" | "dice-4" | "dice-5" | "dice-6" | "dices" | "diff" | "disc" | "disc-2" | "disc-3" | "disc-album" | "divide" | "divide-circle" | "divide-square" | "dna" | "dna-off" | "dock" | "dog" | "dollar-sign" | "donut" | "door-closed" | "door-closed-locked" | "door-open" | "dot" | "dot-square" | "download" | "download-cloud" | "drafting-compass" | "drama" | "drill" | "drone" | "droplet" | "droplet-off" | "droplets" | "drum" | "drumstick" | "dumbbell" | "ear" | "ear-off" | "earth" | "earth-lock" | "eclipse" | "edit" | "edit-2" | "edit-3" | "egg" | "egg-fried" | "egg-off" | "eject" | "ellipse" | "ellipsis" | "ellipsis-vertical" | "equal" | "equal-approximately" | "equal-not" | "equal-square" | "eraser" | "ethernet-port" | "euro" | "ev-charger" | "expand" | "external-link" | "eye" | "eye-closed" | "eye-dashed" | "eye-off" | "face-angry" | "face-expressionless" | "face-grinning" | "face-neutral" | "face-slightly-frowning" | "face-slightly-smiling" | "face-slightly-smiling-plus" | "factory" | "fan" | "fast-forward" | "feather" | "fence" | "ferris-wheel" | "file" | "file-archive" | "file-audio" | "file-audio-2" | "file-axis-3-d" | "file-axis-3d" | "file-badge" | "file-badge-2" | "file-bar-chart" | "file-bar-chart-2" | "file-box" | "file-braces" | "file-braces-corner" | "file-chart-column" | "file-chart-column-increasing" | "file-chart-line" | "file-chart-pie" | "file-check" | "file-check-2" | "file-check-corner" | "file-clock" | "file-code" | "file-code-2" | "file-code-corner" | "file-cog" | "file-cog-2" | "file-diff" | "file-digit" | "file-down" | "file-edit" | "file-exclamation-point" | "file-headphone" | "file-heart" | "file-image" | "file-input" | "file-json" | "file-json-2" | "file-key" | "file-key-2" | "file-line-chart" | "file-lock" | "file-lock-2" | "file-minus" | "file-minus-2" | "file-minus-corner" | "file-music" | "file-output" | "file-pen" | "file-pen-line" | "file-pie-chart" | "file-play" | "file-plus" | "file-plus-2" | "file-plus-corner" | "file-question" | "file-question-mark" | "file-scan" | "file-search" | "file-search-2" | "file-search-corner" | "file-signal" | "file-signature" | "file-sliders" | "file-spreadsheet" | "file-stack" | "file-symlink" | "file-terminal" | "file-text" | "file-type" | "file-type-2" | "file-type-corner" | "file-up" | "file-user" | "file-video" | "file-video-2" | "file-video-camera" | "file-volume" | "file-volume-2" | "file-warning" | "file-x" | "file-x-2" | "file-x-corner" | "files" | "film" | "filter" | "filter-x" | "fingerprint" | "fingerprint-pattern" | "fire-extinguisher" | "fish" | "fish-off" | "fish-symbol" | "fishing-hook" | "fishing-rod" | "flag" | "flag-off" | "flag-triangle-left" | "flag-triangle-right" | "flame" | "flame-kindling" | "flashlight" | "flashlight-off" | "flask-conical" | "flask-conical-off" | "flask-round" | "flip-horizontal" | "flip-horizontal-2" | "flip-vertical" | "flip-vertical-2" | "flower" | "flower-2" | "focus" | "fold-horizontal" | "fold-vertical" | "folder" | "folder-archive" | "folder-bookmark" | "folder-check" | "folder-clock" | "folder-closed" | "folder-code" | "folder-cog" | "folder-cog-2" | "folder-dot" | "folder-down" | "folder-edit" | "folder-git" | "folder-git-2" | "folder-heart" | "folder-input" | "folder-kanban" | "folder-key" | "folder-lock" | "folder-minus" | "folder-open" | "folder-open-dot" | "folder-output" | "folder-pen" | "folder-plus" | "folder-root" | "folder-search" | "folder-search-2" | "folder-symlink" | "folder-sync" | "folder-tree" | "folder-up" | "folder-x" | "folders" | "footprints" | "fork-knife" | "fork-knife-crossed" | "forklift" | "form" | "form-input" | "forward" | "frame" | "frown" | "fuel" | "fullscreen" | "function-square" | "funnel" | "funnel-plus" | "funnel-x" | "gallery-horizontal" | "gallery-horizontal-end" | "gallery-thumbnails" | "gallery-vertical" | "gallery-vertical-end" | "gamepad" | "gamepad-2" | "gamepad-directional" | "gantt-chart" | "gantt-chart-square" | "gauge" | "gauge-circle" | "gavel" | "gem" | "georgian-lari" | "ghost" | "gift" | "git-branch" | "git-branch-minus" | "git-branch-plus" | "git-commit" | "git-commit-horizontal" | "git-commit-vertical" | "git-compare" | "git-compare-arrows" | "git-fork" | "git-graph" | "git-merge" | "git-merge-conflict" | "git-pull-request" | "git-pull-request-arrow" | "git-pull-request-closed" | "git-pull-request-create" | "git-pull-request-create-arrow" | "git-pull-request-draft" | "glass-water" | "glasses" | "globe" | "globe-2" | "globe-check" | "globe-lock" | "globe-off" | "globe-x" | "goal" | "gpu" | "grab" | "graduation-cap" | "grape" | "grid" | "grid-2-x-2" | "grid-2-x-2-check" | "grid-2-x-2-plus" | "grid-2-x-2-x" | "grid-2x2" | "grid-2x2-check" | "grid-2x2-plus" | "grid-2x2-x" | "grid-3-x-3" | "grid-3x2" | "grid-3x3" | "grip" | "grip-horizontal" | "grip-vertical" | "group" | "guitar" | "ham" | "hamburger" | "hammer" | "hand" | "hand-coins" | "hand-fist" | "hand-grab" | "hand-heart" | "hand-helping" | "hand-metal" | "hand-platter" | "handbag" | "handshake" | "hard-drive" | "hard-drive-download" | "hard-drive-upload" | "hard-hat" | "hash" | "hat-glasses" | "haze" | "hd" | "hdmi-port" | "heading" | "heading-1" | "heading-2" | "heading-3" | "heading-4" | "heading-5" | "heading-6" | "headphone-off" | "headphones" | "headset" | "heart" | "heart-crack" | "heart-handshake" | "heart-minus" | "heart-off" | "heart-plus" | "heart-pulse" | "heart-x" | "heater" | "helicopter" | "help-circle" | "helping-hand" | "hexagon" | "highlighter" | "history" | "home" | "hop" | "hop-off" | "hospital" | "hotel" | "hourglass" | "house" | "house-heart" | "house-plug" | "house-plus" | "house-wifi" | "ice-cream" | "ice-cream-2" | "ice-cream-bowl" | "ice-cream-cone" | "id-card" | "id-card-lanyard" | "image" | "image-down" | "image-minus" | "image-off" | "image-play" | "image-plus" | "image-up" | "image-upscale" | "images" | "import" | "inbox" | "indent" | "indent-decrease" | "indent-increase" | "indian-rupee" | "infinity" | "info" | "inspect" | "inspection-panel" | "italic" | "iteration-ccw" | "iteration-cw" | "japanese-yen" | "joystick" | "kanban" | "kanban-square" | "kanban-square-dashed" | "kayak" | "key" | "key-round" | "key-square" | "keyboard" | "keyboard-music" | "keyboard-off" | "lamp" | "lamp-ceiling" | "lamp-desk" | "lamp-floor" | "lamp-wall-down" | "lamp-wall-up" | "land-plot" | "landmark" | "languages" | "laptop" | "laptop-2" | "laptop-minimal" | "laptop-minimal-check" | "lasso" | "lasso-select" | "laugh" | "layer-arrow-down" | "layer-arrow-up" | "layers" | "layers-2" | "layers-3" | "layers-arrow-down" | "layers-arrow-up" | "layers-minus" | "layers-plus" | "layout" | "layout-dashboard" | "layout-freeform" | "layout-grid" | "layout-list" | "layout-panel-left" | "layout-panel-top" | "layout-template" | "leaf" | "leafy-green" | "lectern" | "lens-concave" | "lens-convex" | "letter-text" | "library" | "library-big" | "library-square" | "life-buoy" | "ligature" | "lightbulb" | "lightbulb-off" | "line-chart" | "line-dot-right-horizontal" | "line-squiggle" | "line-style" | "link" | "link-2" | "link-2-off" | "list" | "list-check" | "list-checks" | "list-chevrons-down-up" | "list-chevrons-up-down" | "list-clock" | "list-collapse" | "list-end" | "list-filter" | "list-filter-plus" | "list-indent-decrease" | "list-indent-increase" | "list-minus" | "list-music" | "list-ordered" | "list-plus" | "list-restart" | "list-sort-ascending" | "list-sort-descending" | "list-start" | "list-todo" | "list-tree" | "list-video" | "list-x" | "loader" | "loader-2" | "loader-circle" | "loader-pinwheel" | "locate" | "locate-fixed" | "locate-off" | "location-edit" | "lock" | "lock-keyhole" | "lock-keyhole-open" | "lock-open" | "log-in" | "log-out" | "logs" | "lollipop" | "luggage" | "m-square" | "magnet" | "mail" | "mail-badge" | "mail-check" | "mail-minus" | "mail-open" | "mail-plus" | "mail-question" | "mail-question-mark" | "mail-search" | "mail-warning" | "mail-x" | "mailbox" | "mails" | "map" | "map-minus" | "map-pin" | "map-pin-check" | "map-pin-check-inside" | "map-pin-house" | "map-pin-minus" | "map-pin-minus-inside" | "map-pin-off" | "map-pin-pen" | "map-pin-plus" | "map-pin-plus-inside" | "map-pin-search" | "map-pin-x" | "map-pin-x-inside" | "map-pinned" | "map-plus" | "mars" | "mars-stroke" | "martini" | "maximize" | "maximize-2" | "medal" | "megaphone" | "megaphone-off" | "meh" | "memory-stick" | "menu" | "menu-square" | "merge" | "message-circle" | "message-circle-check" | "message-circle-code" | "message-circle-dashed" | "message-circle-heart" | "message-circle-more" | "message-circle-off" | "message-circle-plus" | "message-circle-question" | "message-circle-question-mark" | "message-circle-reply" | "message-circle-warning" | "message-circle-x" | "message-square" | "message-square-check" | "message-square-code" | "message-square-dashed" | "message-square-diff" | "message-square-dot" | "message-square-heart" | "message-square-lock" | "message-square-more" | "message-square-off" | "message-square-plus" | "message-square-quote" | "message-square-reply" | "message-square-share" | "message-square-text" | "message-square-warning" | "message-square-x" | "messages-square" | "metronome" | "mic" | "mic-2" | "mic-audio-lines" | "mic-off" | "mic-signal" | "mic-vocal" | "microchip" | "microscope" | "microwave" | "midi-port" | "milestone" | "milk" | "milk-off" | "minimize" | "minimize-2" | "minus" | "minus-circle" | "minus-square" | "mirror-rectangular" | "mirror-round" | "monitor" | "monitor-check" | "monitor-cloud" | "monitor-cog" | "monitor-dot" | "monitor-down" | "monitor-off" | "monitor-pause" | "monitor-play" | "monitor-smartphone" | "monitor-speaker" | "monitor-stop" | "monitor-up" | "monitor-x" | "moon" | "moon-star" | "mop" | "mop-sparkles" | "more-horizontal" | "more-vertical" | "mosque" | "motorbike" | "mountain" | "mountain-snow" | "mouse" | "mouse-left" | "mouse-off" | "mouse-pointer" | "mouse-pointer-2" | "mouse-pointer-2-off" | "mouse-pointer-ban" | "mouse-pointer-click" | "mouse-pointer-square-dashed" | "mouse-right" | "move" | "move-3-d" | "move-3d" | "move-diagonal" | "move-diagonal-2" | "move-down" | "move-down-left" | "move-down-right" | "move-horizontal" | "move-left" | "move-right" | "move-up" | "move-up-left" | "move-up-right" | "move-vertical" | "music" | "music-2" | "music-3" | "music-4" | "navigation" | "navigation-2" | "navigation-2-off" | "navigation-off" | "network" | "newspaper" | "nfc" | "non-binary" | "notebook" | "notebook-pen" | "notebook-tabs" | "notebook-text" | "notepad-text" | "notepad-text-dashed" | "nut" | "nut-off" | "octagon" | "octagon-alert" | "octagon-minus" | "octagon-pause" | "octagon-x" | "omega" | "option" | "orbit" | "origami" | "outdent" | "package" | "package-2" | "package-check" | "package-minus" | "package-open" | "package-plus" | "package-search" | "package-x" | "paint-bucket" | "paint-roller" | "paintbrush" | "paintbrush-2" | "paintbrush-vertical" | "palette" | "palmtree" | "panda" | "panel-bottom" | "panel-bottom-close" | "panel-bottom-dashed" | "panel-bottom-inactive" | "panel-bottom-open" | "panel-left" | "panel-left-close" | "panel-left-dashed" | "panel-left-inactive" | "panel-left-open" | "panel-left-right-dashed" | "panel-right" | "panel-right-close" | "panel-right-dashed" | "panel-right-inactive" | "panel-right-open" | "panel-top" | "panel-top-bottom-dashed" | "panel-top-close" | "panel-top-dashed" | "panel-top-inactive" | "panel-top-open" | "panels-left-bottom" | "panels-left-right" | "panels-right-bottom" | "panels-top-bottom" | "panels-top-left" | "paper-bag" | "paperclip" | "parasol" | "parentheses" | "parking-circle" | "parking-circle-off" | "parking-meter" | "parking-square" | "parking-square-off" | "party-popper" | "pause" | "pause-circle" | "pause-octagon" | "paw-print" | "pc-case" | "pen" | "pen-box" | "pen-line" | "pen-off" | "pen-square" | "pen-tool" | "pencil" | "pencil-line" | "pencil-off" | "pencil-ruler" | "pencil-sparkles" | "pentagon" | "percent" | "percent-circle" | "percent-diamond" | "percent-square" | "person-standing" | "phi" | "philippine-peso" | "phone" | "phone-call" | "phone-forwarded" | "phone-incoming" | "phone-missed" | "phone-off" | "phone-outgoing" | "pi" | "pi-square" | "piano" | "pickaxe" | "picture-in-picture" | "picture-in-picture-2" | "pie-chart" | "piggy-bank" | "pilcrow" | "pilcrow-left" | "pilcrow-right" | "pilcrow-square" | "pill" | "pill-bottle" | "pin" | "pin-off" | "pipette" | "pizza" | "plane" | "plane-landing" | "plane-takeoff" | "play" | "play-circle" | "play-off" | "play-square" | "plug" | "plug-2" | "plug-zap" | "plug-zap-2" | "plus" | "plus-circle" | "plus-square" | "pocket-knife" | "podcast" | "podium" | "pointer" | "pointer-off" | "popcorn" | "popsicle" | "pound-sterling" | "power" | "power-circle" | "power-off" | "power-square" | "presentation" | "printer" | "printer-check" | "printer-x" | "projector" | "proportions" | "puzzle" | "pyramid" | "qr-code" | "quote" | "rabbit" | "radar" | "radiation" | "radical" | "radio" | "radio-off" | "radio-receiver" | "radio-tower" | "radius" | "rainbow" | "rat" | "ratio" | "receipt" | "receipt-cent" | "receipt-euro" | "receipt-indian-rupee" | "receipt-japanese-yen" | "receipt-pound-sterling" | "receipt-russian-ruble" | "receipt-swiss-franc" | "receipt-text" | "receipt-turkish-lira" | "rectangle-circle" | "rectangle-ellipsis" | "rectangle-goggles" | "rectangle-horizontal" | "rectangle-vertical" | "recycle" | "redo" | "redo-2" | "redo-dot" | "refresh-ccw" | "refresh-ccw-dot" | "refresh-cw" | "refresh-cw-off" | "refrigerator" | "regex" | "remove-formatting" | "repeat" | "repeat-1" | "repeat-2" | "repeat-off" | "replace" | "replace-all" | "reply" | "reply-all" | "rewind" | "ribbon" | "road" | "rocket" | "rocking-chair" | "roller-coaster" | "rose" | "rotate-3-d" | "rotate-3d" | "rotate-ccw" | "rotate-ccw-clock" | "rotate-ccw-key" | "rotate-ccw-square" | "rotate-cw" | "rotate-cw-fading-clock" | "rotate-cw-square" | "route" | "route-off" | "router" | "rows" | "rows-2" | "rows-3" | "rows-4" | "rss" | "ruler" | "ruler-dimension-line" | "russian-ruble" | "sailboat" | "salad" | "sandwich" | "satellite" | "satellite-dish" | "saudi-riyal" | "save" | "save-all" | "save-check" | "save-off" | "save-pen" | "save-plus" | "scale" | "scale-3-d" | "scale-3d" | "scaling" | "scan" | "scan-barcode" | "scan-box" | "scan-eye" | "scan-face" | "scan-heart" | "scan-line" | "scan-qr-code" | "scan-search" | "scan-square" | "scan-text" | "scatter-chart" | "school" | "school-2" | "scissors" | "scissors-line-dashed" | "scissors-square" | "scissors-square-dashed-bottom" | "scooter" | "screen-share" | "screen-share-off" | "scroll" | "scroll-text" | "search" | "search-alert" | "search-check" | "search-code" | "search-slash" | "search-x" | "section" | "send" | "send-horizonal" | "send-horizontal" | "send-to-back" | "separator-horizontal" | "separator-vertical" | "server" | "server-cog" | "server-crash" | "server-off" | "server-plus" | "settings" | "settings-2" | "shapes" | "share" | "share-2" | "sheet" | "shell" | "shelving-unit" | "shield" | "shield-alert" | "shield-ban" | "shield-check" | "shield-close" | "shield-cog" | "shield-cog-corner" | "shield-ellipsis" | "shield-half" | "shield-keyhole" | "shield-lock" | "shield-minus" | "shield-off" | "shield-plus" | "shield-question" | "shield-question-mark" | "shield-user" | "shield-x" | "ship" | "ship-wheel" | "shirt" | "shopping-bag" | "shopping-basket" | "shopping-cart" | "shovel" | "shower-head" | "shredder" | "shrimp" | "shrink" | "shrub" | "shuffle" | "sidebar" | "sidebar-close" | "sidebar-open" | "sigma" | "sigma-square" | "signal" | "signal-high" | "signal-low" | "signal-medium" | "signal-zero" | "signature" | "signpost" | "signpost-big" | "siren" | "skip-back" | "skip-forward" | "skull" | "slash" | "slash-square" | "slice" | "sliders" | "sliders-horizontal" | "sliders-vertical" | "smartphone" | "smartphone-charging" | "smartphone-nfc" | "smile" | "smile-plus" | "snail" | "snowflake" | "soap-dispenser-droplet" | "sofa" | "solar-panel" | "sort-asc" | "sort-desc" | "soup" | "space" | "spade" | "sparkle" | "sparkles" | "speaker" | "speech" | "spell-check" | "spell-check-2" | "spline" | "spline-pointer" | "split" | "split-square-horizontal" | "split-square-vertical" | "spool" | "sport-shoe" | "spotlight" | "spray-can" | "sprout" | "square" | "square-activity" | "square-arrow-down" | "square-arrow-down-left" | "square-arrow-down-right" | "square-arrow-left" | "square-arrow-out-down-left" | "square-arrow-out-down-right" | "square-arrow-out-up-left" | "square-arrow-out-up-right" | "square-arrow-right" | "square-arrow-right-enter" | "square-arrow-right-exit" | "square-arrow-up" | "square-arrow-up-left" | "square-arrow-up-right" | "square-asterisk" | "square-bottom-dashed-scissors" | "square-centerline-dashed-horizontal" | "square-centerline-dashed-vertical" | "square-chart-gantt" | "square-check" | "square-check-big" | "square-chevron-down" | "square-chevron-left" | "square-chevron-right" | "square-chevron-up" | "square-code" | "square-dashed" | "square-dashed-bottom" | "square-dashed-bottom-code" | "square-dashed-kanban" | "square-dashed-mouse-pointer" | "square-dashed-text" | "square-dashed-top-solid" | "square-dimensions" | "square-divide" | "square-dot" | "square-equal" | "square-function" | "square-gantt-chart" | "square-kanban" | "square-library" | "square-m" | "square-menu" | "square-minus" | "square-mouse-pointer" | "square-off" | "square-parking" | "square-parking-off" | "square-pause" | "square-pen" | "square-percent" | "square-pi" | "square-pilcrow" | "square-play" | "square-plus" | "square-power" | "square-radical" | "square-round-corner" | "square-scissors" | "square-sigma" | "square-slash" | "square-split-horizontal" | "square-split-vertical" | "square-square" | "square-stack" | "square-star" | "square-stop" | "square-terminal" | "square-text" | "square-user" | "square-user-round" | "square-x" | "squares-exclude" | "squares-intersect" | "squares-subtract" | "squares-unite" | "squircle" | "squircle-dashed" | "squirrel" | "stamp" | "star" | "star-check" | "star-half" | "star-minus" | "star-off" | "star-plus" | "star-x" | "stars" | "step-back" | "step-forward" | "stethoscope" | "sticker" | "sticky-note" | "sticky-note-check" | "sticky-note-minus" | "sticky-note-off" | "sticky-note-plus" | "sticky-note-x" | "sticky-notes" | "stone" | "stop-circle" | "store" | "stretch-horizontal" | "stretch-vertical" | "strikethrough" | "subscript" | "subtitles" | "summary" | "sun" | "sun-dim" | "sun-medium" | "sun-moon" | "sun-snow" | "sunrise" | "sunset" | "superscript" | "swatch-book" | "swiss-franc" | "switch-camera" | "sword" | "swords" | "syringe" | "table" | "table-2" | "table-cells-merge" | "table-cells-split" | "table-columns-split" | "table-config" | "table-of-contents" | "table-properties" | "table-rows-split" | "tablet" | "tablet-smartphone" | "tablets" | "tag" | "tag-plus" | "tag-x" | "tags" | "tally-1" | "tally-2" | "tally-3" | "tally-4" | "tally-5" | "tangent" | "target" | "telescope" | "tent" | "tent-tree" | "terminal" | "terminal-square" | "test-tube" | "test-tube-2" | "test-tube-diagonal" | "test-tubes" | "text" | "text-align-center" | "text-align-end" | "text-align-justify" | "text-align-start" | "text-cursor" | "text-cursor-input" | "text-initial" | "text-quote" | "text-search" | "text-select" | "text-selection" | "text-wrap" | "theater" | "thermometer" | "thermometer-snowflake" | "thermometer-sun" | "thumbs-down" | "thumbs-up" | "ticket" | "ticket-check" | "ticket-minus" | "ticket-percent" | "ticket-plus" | "ticket-slash" | "ticket-x" | "tickets" | "tickets-plane" | "timeline" | "timer" | "timer-off" | "timer-reset" | "toggle-left" | "toggle-right" | "toilet" | "tool-case" | "toolbox" | "tornado" | "torus" | "touchpad" | "touchpad-off" | "towel-rack" | "tower-control" | "toy-brick" | "tractor" | "traffic-cone" | "train" | "train-front" | "train-front-tunnel" | "train-track" | "tram-front" | "transgender" | "trash" | "trash-2" | "tree-deciduous" | "tree-palm" | "tree-pine" | "trees" | "trending-down" | "trending-up" | "trending-up-down" | "triangle" | "triangle-alert" | "triangle-dashed" | "triangle-right" | "trophy" | "truck" | "truck-electric" | "turkish-lira" | "turntable" | "turtle" | "tv" | "tv-2" | "tv-minimal" | "tv-minimal-play" | "type" | "type-outline" | "umbrella" | "umbrella-off" | "underline" | "undo" | "undo-2" | "undo-dot" | "unfold-horizontal" | "unfold-vertical" | "ungroup" | "university" | "unlink" | "unlink-2" | "unlock" | "unlock-keyhole" | "unplug" | "upload" | "upload-cloud" | "usb" | "usb-c-port" | "user" | "user-2" | "user-check" | "user-check-2" | "user-circle" | "user-circle-2" | "user-cog" | "user-cog-2" | "user-key" | "user-lock" | "user-minus" | "user-minus-2" | "user-pen" | "user-plus" | "user-plus-2" | "user-round" | "user-round-arrow-left" | "user-round-check" | "user-round-cog" | "user-round-key" | "user-round-minus" | "user-round-pen" | "user-round-plus" | "user-round-search" | "user-round-x" | "user-search" | "user-shield" | "user-square" | "user-square-2" | "user-star" | "user-x" | "user-x-2" | "users" | "users-2" | "users-round" | "utensils" | "utensils-crossed" | "utility-pole" | "van" | "variable" | "vault" | "vector-square" | "vegan" | "venetian-mask" | "venus" | "venus-and-mars" | "verified" | "vibrate" | "vibrate-off" | "video" | "video-off" | "videotape" | "view" | "voicemail" | "volleyball" | "volume" | "volume-1" | "volume-2" | "volume-off" | "volume-x" | "vote" | "wallet" | "wallet-2" | "wallet-cards" | "wallet-minimal" | "wallpaper" | "wand" | "wand-2" | "wand-sparkles" | "warehouse" | "washing-machine" | "watch" | "waves" | "waves-arrow-down" | "waves-arrow-up" | "waves-horizontal" | "waves-ladder" | "waves-vertical" | "waypoints" | "webcam" | "webcam-off" | "webhook" | "webhook-off" | "weight" | "weight-tilde" | "wheat" | "wheat-off" | "whole-word" | "wifi" | "wifi-cog" | "wifi-high" | "wifi-low" | "wifi-off" | "wifi-pen" | "wifi-sync" | "wifi-zero" | "wind" | "wind-arrow-down" | "wine" | "wine-off" | "workflow" | "worm" | "wrap-text" | "wrench" | "wrench-off" | "x" | "x-circle" | "x-line-top" | "x-octagon" | "x-square" | "zap" | "zap-off" | "zodiac-aquarius" | "zodiac-aries" | "zodiac-cancer" | "zodiac-capricorn" | "zodiac-gemini" | "zodiac-leo" | "zodiac-libra" | "zodiac-ophiuchus" | "zodiac-pisces" | "zodiac-sagittarius" | "zodiac-scorpio" | "zodiac-taurus" | "zodiac-virgo" | "zoom-in" | "zoom-out";
 export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
 export interface BannerAction { label: string; variant: "primary" | "secondary"; onTrigger: () => void | Promise<void>; }
-export interface ConversationProps {
-  agentId: string;
-  scenario: string;
-  context: string;
+export type ConversationProps = {
   title?: string;
   placeholder?: string;
   onConversationCreated?: (event: import("./conversation.js").ConversationCreatedEvent) => void | Promise<void>;
@@ -20,12 +17,9 @@ export interface ConversationProps {
   onToolCall?: (event: import("./conversation.js").ToolCallEvent) => void | Promise<void>;
   onError?: (event: import("./conversation.js").ConversationErrorEvent) => void | Promise<void>;
   style?: AppStyle;
-}
+} & import("./conversation.js").ConversationRootBinding;
 export const Conversation: ComponentType<ConversationProps> & { Root: typeof ConversationRoot; Messages: typeof ConversationMessages; Composer: typeof ConversationComposer; History: typeof ConversationHistory; NewButton: typeof ConversationNewButton; StopButton: typeof ConversationStopButton; Status: typeof ConversationStatus };
-export interface ConversationRootProps {
-  agentId: string;
-  scenario: string;
-  context: string;
+export type ConversationRootProps = {
   title?: string;
   placeholder?: string;
   onConversationCreated?: (event: import("./conversation.js").ConversationCreatedEvent) => void | Promise<void>;
@@ -35,12 +29,13 @@ export interface ConversationRootProps {
   onError?: (event: import("./conversation.js").ConversationErrorEvent) => void | Promise<void>;
   style?: AppStyle;
   children?: ReactNode;
-}
+} & import("./conversation.js").ConversationRootBinding;
 export const ConversationRoot: ComponentType<ConversationRootProps>;
 export interface ConversationMessagesProps {
   fill?: boolean;
   emptyTitle?: string;
   emptyDescription?: string;
+  toolRenderers?: Readonly<Record<string, ComponentType<import("./conversation.js").ToolResultView>>>;
 }
 export const ConversationMessages: ComponentType<ConversationMessagesProps>;
 export interface ConversationComposerProps {
@@ -400,6 +395,8 @@ export interface WidgetDecorationProps {
   children: ReactNode;
 }
 export const WidgetDecoration: ComponentType<WidgetDecorationProps>;
+export { useConversation } from "./conversation.js";
+export type { ConversationController, ConversationOptions, ToolResultView, ConversationReference, PreparedConversationReference } from "./conversation.js";
 export type { ConversationCreatedEvent, TurnStartedEvent, TurnFinishedEvent, ToolCallEvent, ConversationErrorEvent } from "./conversation.js";
 export const Typography: { Title: typeof TypographyTitle; Body: typeof TypographyBody; Caption: typeof TypographyCaption };
 export const Widget: { TextWidget: typeof WidgetTextWidget; Title: typeof WidgetTitle; Text: { Primary: typeof WidgetTextPrimary; Secondary: typeof WidgetTextSecondary }; Loading: typeof WidgetLoading; Decoration: typeof WidgetDecoration };

package/src/ui/index.js

@@ -1,4 +1,4 @@
 // 此文件由 scripts/generate-components.mjs 生成，请修改产品能力声明。
 import * as React from "react";
 import { createUiComponents } from "./factory.js";
-export const { Conversation, ConversationRoot, ConversationMessages, ConversationComposer, ConversationHistory, ConversationNewButton, ConversationStopButton, ConversationStatus, NativeDOM, Icon, Stack, SplitLayout, SplitLayoutMain, SplitLayoutAside, SplitLayoutActions, Section, Banner, Badge, LoadingState, Skeleton, Card, Grid, EmptyState, ZhikeLink, Button, SearchInput, FilterSelect, Switch, LookupCell, Tabs, TabsList, TabsTrigger, TabsContent, Table, TableHeader, TableBody, TableRow, TableCell, Avatar, DescriptionList, DescriptionListItem, DescriptionListMenu, DescriptionListMenuItem, Divider, Chart, DashboardSurface, DashboardLayout, DashboardPanel, MetricReadout, AnalysisView, Json, Link, StatusBadge, TextBlock, TypographyTitle, TypographyBody, TypographyCaption, TableHeaderCell, WidgetTextWidget, WidgetTitle, WidgetTextPrimary, WidgetTextSecondary, WidgetLoading, WidgetDecoration, Typography, Widget } = createUiComponents(React);
+export const { useConversation, Conversation, ConversationRoot, ConversationMessages, ConversationComposer, ConversationHistory, ConversationNewButton, ConversationStopButton, ConversationStatus, NativeDOM, Icon, Stack, SplitLayout, SplitLayoutMain, SplitLayoutAside, SplitLayoutActions, Section, Banner, Badge, LoadingState, Skeleton, Card, Grid, EmptyState, ZhikeLink, Button, SearchInput, FilterSelect, Switch, LookupCell, Tabs, TabsList, TabsTrigger, TabsContent, Table, TableHeader, TableBody, TableRow, TableCell, Avatar, DescriptionList, DescriptionListItem, DescriptionListMenu, DescriptionListMenuItem, Divider, Chart, DashboardSurface, DashboardLayout, DashboardPanel, MetricReadout, AnalysisView, Json, Link, StatusBadge, TextBlock, TypographyTitle, TypographyBody, TypographyCaption, TableHeaderCell, WidgetTextWidget, WidgetTitle, WidgetTextPrimary, WidgetTextSecondary, WidgetLoading, WidgetDecoration, Typography, Widget } = createUiComponents(React);