@h-ai/kit 0.1.0-alpha.67 → 0.1.0-alpha.69

package/dist/kit-a2a-types-DwcmE668.d.ts

@@ -0,0 +1,136 @@
+import { RequestEvent } from '@sveltejs/kit';
+import { f as HandleA2AOperations, h as HandleConfig } from './kit-types-DQYqP1Cn.js';
+
+/**
+ * @h-ai/kit — A2A API Key 认证器
+ *
+ * 从请求头或 query 参数中提取 API Key，调用 IAM apiKey.verifyApiKey 验证。
+ * @module kit-a2a-auth
+ */
+
+/**
+ * A2A API Key 认证器配置
+ * @example
+ * ```ts
+ * import type { A2AApiKeyAuthConfig } from '@h-ai/kit'
+ *
+ * const value: A2AApiKeyAuthConfig = { in: 'header', name: 'X-Agent-Key' }
+ * void value
+ * ```
+ */
+interface A2AApiKeyAuthConfig {
+    /** API Key 的传递位置 */
+    in: 'header' | 'query';
+    /** 参数名 */
+    name: string;
+}
+/**
+ * 创建 A2A API Key 认证函数
+ *
+ * 根据配置从请求头或 query 参数中提取 API Key，
+ * 通过 `iam.apiKey.verifyApiKey()` 验证后返回调用方上下文。
+ *
+ * - 无 API Key → 返回 `null`（由调用方拒绝请求）
+ * - 验证失败 → 返回 `null`（拒绝）
+ * - 验证成功 → 返回 `{ agentId, apiKeyId, scopes }`
+ *
+ * @param config - API Key 提取配置
+ * @returns authenticate 函数，可直接赋给 HandleA2AConfig.authenticate
+ * @example 模块内部上下文
+ * ```ts
+ * const authenticate = createA2AApiKeyAuthenticator({ in: 'header', name: 'X-Agent-Key' })
+ * // 应用先初始化 IAM；拒绝返回 null，交给路由转为 401。
+ * void authenticate
+ * ```
+ */
+declare function createA2AApiKeyAuthenticator(config: A2AApiKeyAuthConfig): (event: RequestEvent) => Promise<Record<string, unknown> | null>;
+
+/**
+ * @h-ai/kit — A2A Handle 拦截器
+ *
+ * 在 SvelteKit Handle Hook 中拦截 A2A 端点（Agent Card 发现 + JSON-RPC 处理），
+ * 自动处理请求并返回 Response，不匹配时返回 null 由 Handle 继续后续流程。
+ * @module kit-a2a-handle
+ */
+
+/**
+ * A2A 解析后的内部配置
+ * @example
+ * ```ts
+ * import type { ResolvedA2AConfig } from '@h-ai/kit'
+ *
+ * function paths(config: ResolvedA2AConfig) { return [config.cardPath, config.rpcPath] }
+ * ```
+ */
+interface ResolvedA2AConfig {
+    operations: HandleA2AOperations;
+    cardPath: string;
+    rpcPath: string;
+    authenticate?: (event: RequestEvent) => Promise<Record<string, unknown> | null | undefined>;
+}
+/**
+ * 解析 A2A 配置（简单模式 / 配置模式）
+ *
+ * - 简单模式：直接传入 `ai.a2a` 操作对象，使用默认路径
+ * - 配置模式：传入 `{ operations, rpcPath?, cardPath?, authenticate? }`
+ *
+ * @param input - HandleConfig.a2a 配置
+ * @returns 解析后的配置，或 `null` 表示未配置
+ * @example 模块内部上下文
+ * ```ts
+ * function resolve(operations: HandleA2AOperations) {
+ *   return resolveA2AConfig({ operations, rpcPath: '/a2a', authenticate: async () => null })
+ * }
+ * ```
+ */
+declare function resolveA2AConfig(input: HandleConfig['a2a']): ResolvedA2AConfig | null;
+/**
+ * 处理 A2A 端点请求
+ *
+ * 匹配 Agent Card GET 和 JSON-RPC POST 端点，返回 Response。
+ * 不匹配时返回 `null`，由 Handle 继续后续流程。
+ *
+ * @param event - SvelteKit RequestEvent
+ * @param requestId - 当前请求 ID（用于响应头）
+ * @param config - 解析后的 A2A 配置
+ * @returns 匹配时返回 Response，不匹配返回 null
+ * @example 模块内部上下文
+ * ```ts
+ * async function handle(event: RequestEvent, config: ResolvedA2AConfig) {
+ *   return handleA2ARequest(event, 'req_1', config) // null 表示路径未匹配，交给后续 handle。
+ * }
+ * ```
+ */
+declare function handleA2ARequest(event: RequestEvent, requestId: string, config: ResolvedA2AConfig): Promise<Response | null>;
+
+/**
+ * @h-ai/kit — A2A 类型定义
+ *
+ * Kit A2A 路由处理器相关类型
+ * @module kit-a2a-types
+ */
+
+/**
+ * A2A 路由处理器配置
+ * @example
+ * ```ts
+ * import type { KitA2AHandlerConfig } from '@h-ai/kit'
+ *
+ * const value: KitA2AHandlerConfig = { authenticate: async () => null }
+ * void value
+ * ```
+ */
+interface KitA2AHandlerConfig {
+    /**
+     * 可选的认证回调
+     *
+     * 验证入站 A2A 请求的身份。返回 null/undefined 表示认证失败（401）。
+     * 未配置此项才允许匿名请求；回调可抛出 SvelteKit HTTP 错误。
+     *
+     * - `'apiKey'`：自动使用 IAM API Key 认证
+     * - 函数：自定义认证回调
+     */
+    authenticate?: 'apiKey' | ((event: RequestEvent) => Promise<Record<string, unknown> | null | undefined>);
+}
+
+export { type A2AApiKeyAuthConfig as A, type KitA2AHandlerConfig as K, type ResolvedA2AConfig as R, createA2AApiKeyAuthenticator as c, handleA2ARequest as h, resolveA2AConfig as r };

package/dist/{index-B7s-0mZl.d.ts → kit-client-auth-B5y1g5_A.d.ts}

@@ -12,51 +12,109 @@ import { z } from 'zod';
  * @module kit-config
  */
 
-/** 服务器监听配置（对应 `config/_kit.yml` 的 `server`）。 */
+/**
+ * 服务器监听配置（对应 `config/_kit.yml` 的 `server`）。
+ * @example
+ * ```ts
+ * import type { KitServerConfig } from '@h-ai/kit'
+ *
+ * const value: KitServerConfig = { host: '127.0.0.1', port: 3000 }
+ * void value
+ * ```
+ */
 interface KitServerConfig {
     readonly host: string;
     readonly port: number;
 }
-/** `config/_kit.yml` 中的服务器监听输入类型。 */
+/**
+ * `config/_kit.yml` 中的服务器监听输入类型。
+ * @example
+ * ```ts
+ * import type { KitServerConfigInput } from '@h-ai/kit'
+ *
+ * const value: KitServerConfigInput = { port: 4000 }
+ * void value
+ * ```
+ */
 type KitServerConfigInput = Partial<KitServerConfig>;
-/** `config/_kit.yml` 中的 transport 配置。 */
+/**
+ * `config/_kit.yml` 中的 transport 配置。
+ * @example
+ * ```ts
+ * import type { KitTransportConfig } from '@h-ai/kit'
+ *
+ * const value: KitTransportConfig = { keyExchangePath: '/api/_hai/key-exchange', excludePaths: ['/api/health'] }
+ * void value
+ * ```
+ */
 interface KitTransportConfig {
+    /** 双向明文 UTF-8 字节上限；省略使用 1 MiB，范围 1 KiB～64 MiB。 */
+    readonly maxPlaintextBytes?: number;
     readonly keyExchangePath: `/${string}`;
     readonly excludePaths: readonly `/${string}`[];
-    readonly requireEncryption: boolean;
-    readonly encryptResponse: boolean;
-    readonly maxClients: number;
 }
-/** `config/_kit.yml` 的顶层配置结构。 */
+/**
+ * `config/_kit.yml` 的顶层配置结构。
+ * @example
+ * ```ts
+ * import type { KitConfig } from '@h-ai/kit'
+ *
+ * const value: KitConfig = { server: { host: '127.0.0.1', port: 3000 }, transport: false }
+ * void value
+ * ```
+ */
 interface KitConfig {
     readonly server: KitServerConfig;
     readonly transport: false | KitTransportConfig;
 }
-/** `config/_kit.yml` 中的 transport 输入类型。 */
+/**
+ * `config/_kit.yml` 中的 transport 输入类型。
+ * @example
+ * ```ts
+ * import type { KitTransportConfigInput } from '@h-ai/kit'
+ *
+ * const value: KitTransportConfigInput = { excludePaths: ['/api/health'] }
+ * void value
+ * ```
+ */
 type KitTransportConfigInput = Partial<{
+    readonly maxPlaintextBytes: number;
     readonly keyExchangePath: `/${string}`;
     readonly excludePaths: readonly `/${string}`[];
-    readonly requireEncryption: boolean;
-    readonly encryptResponse: boolean;
-    readonly maxClients: number;
 }>;
-/** `config/_kit.yml` 的顶层输入类型。 */
+/**
+ * `config/_kit.yml` 的顶层输入类型。
+ * @example
+ * ```ts
+ * import type { KitConfigInput } from '@h-ai/kit'
+ *
+ * const value: KitConfigInput = { transport: false }
+ * void value
+ * ```
+ */
 interface KitConfigInput {
     readonly server?: KitServerConfigInput;
     readonly transport?: false | KitTransportConfigInput;
 }
-/** `config/_kit.yml` 对应的配置 Schema。 */
+/**
+ * `config/_kit.yml` 对应的配置 Schema。
+ * @example
+ * ```ts
+ * import { KitConfigSchema } from '@h-ai/kit'
+ *
+ * const config = KitConfigSchema.parse({ server: { port: 3000 }, transport: false })
+ * void config
+ * ```
+ */
 declare const KitConfigSchema: z.ZodPipe<z.ZodObject<{
     server: z.ZodOptional<z.ZodObject<{
         host: z.ZodDefault<z.ZodString>;
         port: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     transport: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+        maxPlaintextBytes: z.ZodOptional<z.ZodNumber>;
         keyExchangePath: z.ZodDefault<z.ZodCustom<`/${string}`, `/${string}`>>;
         excludePaths: z.ZodDefault<z.ZodArray<z.ZodCustom<`/${string}`, `/${string}`>>>;
-        requireEncryption: z.ZodDefault<z.ZodBoolean>;
-        encryptResponse: z.ZodDefault<z.ZodBoolean>;
-        maxClients: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>, z.ZodTransform<{
     server: KitServerConfig;
@@ -69,9 +127,7 @@ declare const KitConfigSchema: z.ZodPipe<z.ZodObject<{
     transport?: false | {
         keyExchangePath: `/${string}`;
         excludePaths: `/${string}`[];
-        requireEncryption: boolean;
-        encryptResponse: boolean;
-        maxClients: number;
+        maxPlaintextBytes?: number | undefined;
     } | undefined;
 }>>;
 /**
@@ -79,12 +135,28 @@ declare const KitConfigSchema: z.ZodPipe<z.ZodObject<{
  *
  * @param input - `config/_kit.yml` 中的 transport 配置
  * @returns 完整 transport 配置；`false` 表示关闭
+ * @example
+ * ```ts
+ * import { resolveKitTransportConfig } from '@h-ai/kit'
+ *
+ * const transport = resolveKitTransportConfig({ excludePaths: ['/api/health'] })
+ * if (transport) void transport.keyExchangePath
+ * ```
  */
 declare function resolveKitTransportConfig(input?: false | KitTransportConfigInput): false | KitTransportConfig;
 /**
  * 解析 `config/_kit.yml` 顶层配置并补齐默认值。
  *
  * 适合同一份配置同时供 SvelteKit 服务端 hook 与浏览器端 client 读取。
+ * @param input - Kit 监听和公开 transport 输入；省略字段按 Schema 补默认值。
+ * @returns 已补齐默认值的配置；不合法输入抛出 ZodError。
+ * @example
+ * ```ts
+ * import { resolveKitConfig } from '@h-ai/kit'
+ *
+ * const config = resolveKitConfig({ transport: false })
+ * void config.server.port
+ * ```
  */
 declare function resolveKitConfig(input?: KitConfigInput): KitConfig;
 
@@ -95,6 +167,15 @@ declare function resolveKitConfig(input?: KitConfigInput): KitConfig;
  * @module kit-auth
  */
 
+/**
+ * 服务端认证写入/删除 Cookie 依赖；由当前请求提供并执行安全属性。
+ * @example 模块内部上下文
+ * ```ts
+ * function signIn(cookies: CookieWriter, credentials: PasswordCredentials) {
+ *   return login(cookies, credentials) // 业务调用者检查 success 后消费身份。
+ * }
+ * ```
+ */
 interface CookieWriter {
     set: (name: string, value: string, options: {
         path: string;
@@ -107,7 +188,14 @@ interface CookieWriter {
         path: string;
     }) => void;
 }
-/** 浏览器 Token 存储器 */
+/**
+ * 浏览器 Token 存储器；使用页面内存或平台安全存储，禁止写入 Web Storage。
+ * @example 模块内部上下文
+ * ```ts
+ * const store: BrowserTokenStore = getDefaultBrowserTokenStore()
+ * store.clear() // 当前页面内存状态；不持有服务端会话真值。
+ * ```
+ */
 interface BrowserTokenStore {
     get: () => string | null;
     set: (token: string) => void;
@@ -119,12 +207,13 @@ interface BrowserTokenStore {
  * @param cookies - SvelteKit cookies 对象
  * @param credentials - 密码凭证（identifier + password）
  * @returns 认证结果（成功时 Cookie 已自动写入）
- *
- * @example
+ * @example 模块内部上下文
  * ```ts
- * const result = await kit.auth.login(cookies, { identifier, password })
- * if (!result.success) return kit.response.fromError(result.error, IamErrorHttpStatus)
- * const { user, roles, permissions } = result.data
+ * async function signIn(cookies: CookieWriter, credentials: PasswordCredentials) {
+ *   const result = await login(cookies, credentials)
+ *   if (!result.success) return result.error.message
+ *   return result.data
+ * }
  * ```
  */
 declare function login(cookies: CookieWriter, credentials: PasswordCredentials): Promise<HaiResult<AuthResult>>;
@@ -134,10 +223,13 @@ declare function login(cookies: CookieWriter, credentials: PasswordCredentials):
  * @param cookies - SvelteKit cookies 对象
  * @param credentials - OTP 凭证（identifier + code）
  * @returns 认证结果（成功时 Cookie 已自动写入）
- *
- * @example
+ * @example 模块内部上下文
  * ```ts
- * const result = await kit.auth.loginWithOtp(cookies, { identifier, code })
+ * async function signIn(cookies: CookieWriter, credentials: OtpCredentials) {
+ *   const result = await loginWithOtp(cookies, credentials)
+ *   if (!result.success) return result.error.message
+ *   return result.data
+ * }
  * ```
  */
 declare function loginWithOtp(cookies: CookieWriter, credentials: OtpCredentials): Promise<HaiResult<AuthResult>>;
@@ -147,10 +239,13 @@ declare function loginWithOtp(cookies: CookieWriter, credentials: OtpCredentials
  * @param cookies - SvelteKit cookies 对象
  * @param credentials - LDAP 凭证（username + password）
  * @returns 认证结果（成功时 Cookie 已自动写入）
- *
- * @example
+ * @example 模块内部上下文
  * ```ts
- * const result = await kit.auth.loginWithLdap(cookies, { username, password })
+ * async function signIn(cookies: CookieWriter, credentials: LdapCredentials) {
+ *   const result = await loginWithLdap(cookies, credentials)
+ *   if (!result.success) return result.error.message
+ *   return result.data
+ * }
  * ```
  */
 declare function loginWithLdap(cookies: CookieWriter, credentials: LdapCredentials): Promise<HaiResult<AuthResult>>;
@@ -160,11 +255,13 @@ declare function loginWithLdap(cookies: CookieWriter, credentials: LdapCredentia
  * @param cookies - SvelteKit cookies 对象
  * @param credentials - API Key 凭证（key）
  * @returns 认证结果（成功时 Cookie 已自动写入）
- *
- * @example
+ * @example 模块内部上下文
  * ```ts
- * const result = await kit.auth.loginWithApiKey(cookies, { key: apiKey })
- * if (!result.success) return kit.response.fromError(result.error, IamErrorHttpStatus)
+ * async function signIn(cookies: CookieWriter, credentials: ApiKeyCredentials) {
+ *   const result = await loginWithApiKey(cookies, credentials)
+ *   if (!result.success) return result.error.message
+ *   return result.data
+ * }
  * ```
  */
 declare function loginWithApiKey(cookies: CookieWriter, credentials: ApiKeyCredentials): Promise<HaiResult<AuthResult>>;
@@ -174,42 +271,55 @@ declare function loginWithApiKey(cookies: CookieWriter, credentials: ApiKeyCrede
  * @param cookies - SvelteKit cookies 对象
  * @param options - 注册选项（username、password、email 等）
  * @returns 认证结果（成功时 Cookie 已自动写入）
- *
- * @example
+ * @example 模块内部上下文
  * ```ts
- * const result = await kit.auth.registerAndLogin(cookies, { username, email, password })
+ * async function signIn(cookies: CookieWriter, credentials: RegisterOptions) {
+ *   const result = await registerAndLogin(cookies, credentials)
+ *   if (!result.success) return result.error.message
+ *   return result.data
+ * }
  * ```
  */
 declare function registerAndLogin(cookies: CookieWriter, options: RegisterOptions): Promise<HaiResult<AuthResult>>;
 /**
- * 服务端登出：内部调用 iam.auth.logout 使会话失效，并清除 Token Cookie。
+ * 服务端登出：委托 iam.auth.logout 原子撤销凭据，并始终清除当前请求的 Token Cookie。
+ * Cookie 清理只代表本地退出；服务端撤销失败仍返回失败，不能由调用端改成成功响应。
  *
  * @param cookies - SvelteKit cookies 对象
  * @param accessToken - 访问令牌（为 null/undefined 时仅清除 Cookie）
- *
- * @example
+ * @returns 服务端撤销结果；无令牌时仅清理 Cookie 并成功，有令牌但未配置认证操作时失败。
+ * @remarks 底层控制流异常仍以 Promise 拒绝传播；Cookie 清理不吞掉业务失败。
+ * @example 模块内部上下文
  * ```ts
- * await kit.auth.logout(cookies, locals.accessToken)
- * return kit.response.ok(null)
+ * async function signOut(cookies: CookieWriter, accessToken: string) {
+ *   const result = await logout(cookies, accessToken)
+ *   if (!result.success) return result.error.code
+ *   return result.data
+ * }
  * ```
  */
-declare function logout(cookies: CookieWriter, accessToken?: string | null): Promise<void>;
-/**
- * 创建浏览器端 Token 存储器（localStorage）。
- *
- * ⚠️ 安全提示：localStorage 对同源脚本可读，任意 XSS 都可能窃取 Token。
- * 本函数仅供调用方显式接受风险时使用；`kit.client.create({ auth: true })`
- * 不会默认调用它。
- *
- * @param key - localStorage 键名，默认 `'hai_access_token'`
- */
-declare function createTokenStore(key?: string): BrowserTokenStore;
+declare function logout(cookies: CookieWriter, accessToken?: string | null): Promise<HaiResult<void>>;
 /**
  * 写入默认浏览器端 Access Token（仅页面内存，不持久化到 localStorage）。
+ * @param token - 当前页面内存中使用的 access token，不写入 Web Storage。
+ * @example
+ * ```ts
+ * import { kit } from '@h-ai/kit'
+ *
+ * kit.auth.setBrowserToken('example-only-token')
+ * // 页面注销时同步清除浏览器内存令牌。
+ * kit.auth.clearBrowserToken()
+ * ```
  */
 declare function setBrowserToken(token: string): void;
 /**
  * 清除默认浏览器端 Access Token（仅页面内存）。
+ * @example
+ * ```ts
+ * import { kit } from '@h-ai/kit'
+ *
+ * kit.auth.clearBrowserToken()
+ * ```
  */
 declare function clearBrowserToken(): void;
 
@@ -223,8 +333,17 @@ declare function clearBrowserToken(): void;
 
 /**
  * 传输加密客户端配置
+ * @example
+ * ```ts
+ * import type { ClientTransportConfig } from '@h-ai/kit'
+ * import { crypto } from '@h-ai/crypto'
+ *
+ * function configAfterInit(): ClientTransportConfig { return { crypto, excludePaths: ['/api/health'] } }
+ * ```
  */
 interface ClientTransportConfig {
+    /** 可选本地明文上限；缺省跟随服务端握手。 */
+    maxPlaintextBytes?: number;
     /** @h-ai/crypto 服务实例 */
     crypto: CryptoFunctions;
     /** 密钥交换端点 URL（默认 `'/api/_hai/key-exchange'`） */
@@ -234,6 +353,13 @@ interface ClientTransportConfig {
 }
 /**
  * Kit 客户端配置
+ * @example
+ * ```ts
+ * import type { KitClientConfig } from '@h-ai/kit'
+ *
+ * const value: KitClientConfig = { auth: true }
+ * void value
+ * ```
  */
 interface KitClientConfig {
     /**
@@ -256,10 +382,20 @@ interface KitClientConfig {
 }
 /**
  * Kit 客户端实例
+ * @example
+ * ```ts
+ * import type { KitClient } from '@h-ai/kit'
+ *
+ * async function read(client: KitClient) {
+ *   const response = await client.apiFetch('/api/health')
+ *   if (!response.ok) throw new Error('Request failed')
+ *   return response.json()
+ * }
+ * ```
  */
 interface KitClient {
     /** 统一 API fetch（写请求自动附加 CSRF，启用 transport 时自动加解密） */
-    apiFetch: (url: string, init?: RequestInit) => Promise<Response>;
+    apiFetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
     /** 传输加密是否就绪（未启用传输加密时始终为 true） */
     readonly ready: boolean;
     /**
@@ -279,6 +415,14 @@ interface KitClient {
  * 静态资源以及 multipart/form-data 等上传请求保持原样。应用只需安装一次，
  * 后续 `fetch` / SvelteKit 内部 data fetch / `kit.client.create()` 明文发送路径
  * 都会共用这层传输加密能力。
+ * @param transportConfig - 已初始化 crypto、同源密钥交换路径及排除路径；省略时不安装包装。
+ * @example
+ * ```ts
+ * import { kit } from '@h-ai/kit'
+ *
+ * // 不传配置时不安装全局包装；启用时应传已初始化 crypto 与同源端点。
+ * kit.client.installBrowserTransportFetch()
+ * ```
  */
 declare function installBrowserTransportFetch(transportConfig?: ClientTransportConfig): void;
 /**
@@ -294,16 +438,14 @@ declare function installBrowserTransportFetch(transportConfig?: ClientTransportC
  * @param config 已解析的 kit 顶层配置
  * @param deps  外部依赖
  * @param deps.crypto `@h-ai/crypto` 模块实例
- *
  * @example
  * ```ts
- * import { browser } from '$app/environment'
- * import { crypto } from '@h-ai/crypto'
  * import { kit } from '@h-ai/kit'
- * import { adminConsoleKitConfig } from '$lib/config/kit-config.js'
  *
- * if (browser) {
- *   kit.client.installBrowserTransport(adminConsoleKitConfig, { crypto })
+ * import { crypto } from '@h-ai/crypto'
+ *
+ * function installAfterCryptoInit() {
+ *   kit.client.installBrowserTransport({ server: { host: '127.0.0.1', port: 3000 }, transport: { keyExchangePath: '/api/_hai/key-exchange', excludePaths: ['/api/health'] } }, { crypto })
  * }
  * ```
  */
@@ -321,17 +463,38 @@ declare function installBrowserTransport(config: KitConfig, deps: {
  *
  * @param config - 客户端配置
  * @returns KitClient 实例
- *
  * @example
  * ```ts
- * const client = createKitClient({ transport: { crypto } })
- * const res = await client.apiFetch('/api/users', { method: 'POST', body: '{}' })
+ * import { kit } from '@h-ai/kit'
+ *
+ * const client = kit.client.create({ auth: true })
+ * try {
+ *   await client.init() // Client API 使用 Promise 拒绝；不是 HaiResult。
+ *   const response = await client.apiFetch('/api/health')
+ *   if (!response.ok) throw new Error('Request failed')
+ * } finally {
+ *   client.destroy()
+ * }
  * ```
  */
 declare function createKitClient(config?: KitClientConfig): KitClient;
 
 /** 与标准 Kit 认证端点配套的表单动作；复用已有 CSRF/transport fetch。 */
 
+/**
+ * 创建标准 Cookie 认证表单动作；复用可选 apiFetch 以保留 CSRF 和传输配置。
+ * @param options - 可复用的 apiFetch 和标准认证端点 basePath。
+ * @param options.apiFetch - 已装配 CSRF/transport 的 fetch；省略时使用默认 Kit 客户端。
+ * @param options.basePath - 同源认证端点前缀，默认 /api/auth。
+ * @returns 标准表单动作；业务返回 HaiResult，网络/格式错误会拒绝 Promise。
+ * @example
+ * ```ts
+ * import { kit } from '@h-ai/kit'
+ *
+ * const actions = kit.client.createAuthActions({ basePath: '/api/auth' })
+ * void actions
+ * ```
+ */
 declare function createKitAuthActions(options?: {
     apiFetch?: KitClient['apiFetch'];
     basePath?: string;
@@ -347,41 +510,4 @@ declare function createKitAuthActions(options?: {
     confirmPasswordReset: (token: string, newPassword: string) => Promise<HaiResult<unknown>>;
 };
 
-/**
- * @h-ai/kit — SvelteKit 路由适配器
- *
- * 此前位于 `@h-ai/ui/sveltekit`，为避免 `@h-ai/ui` 耦合 SvelteKit，迁移至本模块。
- *
- * 为 `@h-ai/ui` 的 `CrudPage` 等需要“宿主路由”的场景组件提供 SvelteKit 实现。
- * 返回值结构与 `@h-ai/ui` 的 `NavAdapter` 完全一致；TS 通过结构类型自动匹配，
- * 无需在 `@h-ai/kit` 中显式依赖 `@h-ai/ui`。
- *
- * @example
- * ```svelte
- * <script lang='ts'>
- *   import { CrudPage } from '@h-ai/ui'
- *   import { createSvelteKitNavAdapter } from '@h-ai/kit/client'
- *
- *   const nav = createSvelteKitNavAdapter()
- * </script>
- *
- * <CrudPage {crud} {data} {nav} />
- * ```
- *
- * @module kit-nav-adapter
- */
-/**
- * SvelteKit `NavAdapter`：
- *
- * - `pathname` 来自 `$app/state` 的 `page.url.pathname`（响应式）。
- * - `navigate` 使用 `$app/navigation` 的 `goto`，并自动 `invalidateAll`，
- *   触发 `+page.server.ts` 的 `load` 重新执行。
- * - `refresh` 调用 `invalidateAll()`，常用于写操作后刷新列表数据。
- */
-declare function createSvelteKitNavAdapter(): {
-    readonly pathname: string;
-    readonly navigate: (url: string) => Promise<void>;
-    readonly refresh: () => Promise<void>;
-};
-
-export { type ClientTransportConfig as C, type KitClient as K, createKitAuthActions as a, installBrowserTransportFetch as b, createKitClient as c, clearBrowserToken as d, createTokenStore as e, type KitClientConfig as f, type KitConfig as g, type KitConfigInput as h, installBrowserTransport as i, KitConfigSchema as j, type KitServerConfig as k, type KitServerConfigInput as l, type KitTransportConfig as m, type KitTransportConfigInput as n, createSvelteKitNavAdapter as o, resolveKitTransportConfig as p, login as q, resolveKitConfig as r, setBrowserToken as s, loginWithOtp as t, loginWithLdap as u, loginWithApiKey as v, registerAndLogin as w, logout as x };
+export { type ClientTransportConfig as C, type KitClient as K, createKitAuthActions as a, installBrowserTransportFetch as b, createKitClient as c, clearBrowserToken as d, type KitClientConfig as e, type KitConfig as f, type KitConfigInput as g, KitConfigSchema as h, installBrowserTransport as i, type KitServerConfig as j, type KitServerConfigInput as k, type KitTransportConfig as l, type KitTransportConfigInput as m, resolveKitTransportConfig as n, login as o, loginWithOtp as p, loginWithLdap as q, resolveKitConfig as r, setBrowserToken as s, loginWithApiKey as t, registerAndLogin as u, logout as v };