@hcmai/sdk 0.3.11 → 0.3.12

package/dist/index.d.ts

@@ -1,5 +1,178 @@
 import { AxiosInstance } from 'axios';
 
+/**
+ * 侦察层对 HTTP 的**窄端口**与**响应分类**。
+ *
+ * 🔴 为什么是端口而不是搬一份客户端过来（ADR-319 刀 6b 明令）：
+ * CLI 已经有认证 / endpoint 解析 / token 刷新 / 拦截器这一整条管道
+ * （`packages/core/src/client.ts` + `src/http/`）。侦察层再造一份，就是
+ * 「集成 reference path 必复用 helper」那条铁律的反面。
+ *
+ * 但**响应分类**不在那条管道里，而它是侦察层的命根子：顾问打的是一个陌生环境，
+ * 「没权限」「没这个端点」「网关吐了 HTML」「连不上」的下一步完全不同。
+ * 把它们压成一个布尔，产物里就再也分不出来了。所以这一层必须自己有。
+ *
+ * ⚠️ `error` 用字符串而不是布尔：要区分的不是「成没成」，而是「没成是哪一种」。
+ * 判成功一律写 `error === 'ok'`，别写 `!error`。
+ */
+
+/** 响应分类的完整取值域。 */
+type OutcomeError = 'ok' | 'unauthorized' | 'forbidden' | 'not-found' | 'server-error' | 'bad-response' | 'network';
+interface Outcome {
+    /** 网络层没走通时是 `-1`——它不是 HTTP 状态，别拿去和 4xx 比。 */
+    status: number;
+    /** 🔴 是 unknown 不是对象：服务端完全可能返回 array / string / number。 */
+    body: unknown;
+    error: OutcomeError;
+    /**
+     * 本次响应的头，键一律小写。
+     *
+     * 🔴 挂在 Outcome 上而不是客户端实例上（Python 侧是 `client.last_headers`）：
+     * 那种可变字段有「串味」风险——上一次成功的头留到这一次失败时被读到，
+     * 而 `probeExtensionSource` 恰恰是紧跟每次 GET 读头。挂在返回值上让串味**结构上不可能**，
+     * 契约里那几条「last_headers 必须清空」于是从「要测的行为」变成「构造上成立」。
+     */
+    headers: Record<string, string>;
+}
+interface ReconProbe {
+    get(path: string, params?: Record<string, unknown>): Promise<Outcome>;
+    post?(path: string, body: unknown): Promise<Outcome>;
+    getMany?(paths: string[]): Promise<Record<string, Outcome>>;
+    postMany?(jobs: Array<{
+        path: string;
+        body: unknown;
+    }>): Promise<Record<string, Outcome>>;
+    /** 爬取时声明的 capability 串——它是**爬法**属性，不是环境属性。 */
+    readonly capabilities: string;
+}
+/** 把既有 axios 管道（已带认证与刷新）适配成侦察层的窄端口。 */
+declare function httpProbe(http: AxiosInstance, capabilities: string): Required<ReconProbe>;
+
+/** 🔴 只有这三个分量作门。backendVersion 仅记录——实测它在 on-prem 恒返 "unknown"。 */
+declare const GATE_COMPONENTS: readonly ["tenantMetaManifestDigest", "extensionSource", "modelListHash"];
+declare const BLIND_SPOTS: string;
+declare const MODELS_PATH = "/api/system/models";
+declare const MANIFEST_PATH = "/api/tenant-meta/list";
+declare const VERSION_PATH = "/api/version/backend";
+declare const META_PATH = "/api/models/{model}/meta";
+declare const EXTENSION_SOURCE_HEADER = "x-hcm-extension-source";
+/**
+ * 探针上限。取不到就取不到，**不许**为了拿到一个值把 761 个模型全试一遍——
+ * 那会让 doctor 从「几秒」变成「几分钟」，而 doctor 存在的意义就是**快速**告诉顾问他站在哪儿。
+ *
+ * 🔴 为什么是 50 而不是 20：「20 够不够」这个问题，原工位实测第 1 个 key 就命中，
+ * 但**这不能证明任何别的环境**；若某环境排序靠前的 key 恰好全是隐藏型（实测有 19 个），
+ * 探针会空手而归并阻断门，而 key 21 可能就带着这个头。
+ * ⇒ 正确的应对**不是**把 20 换成另一个同样证明不了的数字，而是：
+ * ① 放宽到显然够用又不至于拖慢 doctor（命中即停，坏情况 50 × ~50ms ≈ 2.5s）；
+ * ② 把失败讲清楚（见 attempted/answered）。判据从「猜一个够用的数」换成「失败时说得出为什么」。
+ */
+declare const MAX_SOURCE_PROBES = 50;
+/**
+ * 本模块的全部前提是「打一个不认识的环境」。一个把 totalPages 报成 2**31 的
+ * 服务端会让顾问的笔记本原地转圈。200 页 × 200 行 = 4 万行，远超真实 workspace。
+ */
+declare const MAX_MANIFEST_PAGES = 200;
+interface ModelEntry {
+    modelKey?: string;
+    type?: string;
+    [k: string]: unknown;
+}
+/**
+ * `/api/system/models` 的响应体 → **可用的**模型条目。
+ *
+ * 🔴 **这是唯一一道门**。原先 doctor / computeFingerprint / 布局解析三个点各写各的过滤，
+ * 第三个漏了——而它跑在**最前面**，客户网关一改清单形状，recon 就在第一步崩掉，
+ * 而 FDE 手上没有源码、没有安装包、也没有第二份基线可对照。
+ *
+ * 两种敌意形状都在这里挡掉，调用方不必（也不许）自己判：
+ * ① `body` 整体不是对象——服务端**声明**返 object，但网关扒掉 envelope 直接返数组是真会发生的；
+ * ② `models[]` 里混进非对象元素——部分序列化失败 / 拼接出错。
+ *
+ * ⚠️ **降级不是静默**：这里只负责「不崩」，「有没有掉东西」由调用方各自留痕。
+ */
+declare function modelEntries(body: unknown): ModelEntry[];
+/**
+ * `/api/system/models` 的响应体 → 探针用的 modelKey 列表（去空串 + 排序）。
+ *
+ * 🔴 空串过滤不能省：一条缺 `modelKey` 的记录会让第一发打到 `/api/models//meta`，
+ * 白烧一发**有限的**探针配额。
+ * 🔴 排序 = 探针确定性：同一个环境两次 recon 必须探同一个模型，否则 `extensionSourceProbe`
+ * 会无端漂移，看上去像环境变了。
+ */
+declare function modelKeys(body: unknown): string[];
+interface ProbeResult {
+    sourceKey: string;
+    probeModelKey: string;
+    attempted: number;
+    answered: number;
+}
+/**
+ * 探 `X-HCM-Extension-Source`。
+ *
+ * 🔴 **这个头只挂在 `GET /api/models/{model}/meta` 上，`/api/system/models` 上没有**。
+ * 读错端点的后果不是「偶尔取不到」，是**每一个真实环境上恒为 unknown**：三个门分量残掉
+ * 一个 ⇒ `compareFingerprint` 恒返 `incomplete:` ⇒ 门被 `--force-stale` 常态化绕过。
+ *
+ * 🔴 `answered` 不是凑数的统计量，它是「unknown 到底是哪种 unknown」的唯一判据。
+ * 只返回 `(sourceKey, probeModelKey)` 时，「一个模型都没答应」与「答应了但没回这个头」
+ * **都**返回空串、**都**写同一条失败条目——顾问看到 `unknown` 照样不知道该查连通/权限还是查反代。
+ * **一个自己都分辨不了的分辨承诺比不承诺更糟**，它让人以为这件事已经处理了。
+ */
+declare function probeExtensionSource(probe: ReconProbe, keys: string[]): Promise<ProbeResult>;
+/**
+ * 产物目录要用的 `sourceKey`——`recon` 打出去的**第一个**请求序列。
+ *
+ * 🔴 单独一个入口，而**不是**让命令层自己 `probe.get(MODELS_PATH)` 再就地取 key：
+ * `probeExtensionSource` 此前有三个调用点，其中一个（recon 的这一跳）漏了
+ * 「元素可能不是对象 / body 整体可能不是对象 / modelKey 可能是空串」这三道过滤，
+ * 于是客户网关一改清单形状，`recon` 就在第一步以一条裸堆栈收场 —— 而顾问手上
+ * 没有源码、没有安装包、也没有第二份基线可对照。
+ * 三处各修各的会再漏第四处；收进 `modelKeys()` 这**一道门**，漏不掉。
+ *
+ * 🔴 探不到时回 `'unknown'` 而不是抛：探不到是**可降级**的（产物目录名带 unknown，
+ * 顾问一眼看得出这份基线的层次身份没确认），而抛会让整轮爬取在第一步就没了。
+ */
+declare function computeReconSourceKey(probe: ReconProbe): Promise<string>;
+interface Fingerprint {
+    tenantMetaManifestDigest: string;
+    manifestEntryCount: number;
+    extensionSource: string;
+    extensionSourceProbe: string;
+    extensionSourceProbeAttempted: number;
+    extensionSourceProbeAnswered: number;
+    modelListHash: string;
+    modelCount: number;
+    backendVersion: unknown;
+    capabilities: string;
+    createdAt: string;
+    ttlDays: number;
+    coverageNotes: {
+        gateComponents: string[];
+        blindSpots: string;
+        fetchFailures: string[];
+    };
+}
+declare function computeFingerprint(probe: ReconProbe, opts?: {
+    ttlDays?: number;
+    now?: () => Date;
+}): Promise<Fingerprint>;
+/**
+ * 比对两份四元组，回**差异清单**（空 = 同源）。
+ *
+ * 🔴 某个分量没爬到时，它和「爬到了而且相等」在值上同形。两边都没爬到 → 三个分量全等
+ * → 门放行一份根本没验过的基线。所以残缺本身也要进差异清单。
+ */
+declare function compareFingerprint(recorded: Record<string, unknown>, current: Record<string, unknown>): string[];
+
+/**
+ * 列出目标环境有哪些 Model。
+ *
+ * 解析复用 `fde/fingerprint` 的 {@link modelEntries}——那里是这个响应形状的唯一一道门
+ * （网关扒 envelope、数组里混非对象都在那儿挡掉），此处不另写一份过滤。
+ */
+declare function listModels(http: AxiosInstance): Promise<ModelEntry[]>;
+
 interface ModelQueryDsl {
     filter?: Record<string, unknown>;
     sort?: Array<Record<string, unknown>>;
@@ -223,6 +396,8 @@ declare class HcmClient {
     }): Promise<HcmClient>;
     query<T = Record<string, unknown>>(model: string, dsl: ModelQueryDsl): Promise<QueryResult<T>>;
     action<R = unknown>(model: string, name: string, input: ActionInput): Promise<ActionResult<R>>;
+    /** 列出目标环境有哪些 Model —— `describe` 的上一步。 */
+    listModels(): Promise<ModelEntry[]>;
     describe(model: string, opts?: DescribeOpts): Promise<ModelDescription>;
     create(model: string, data: Record<string, unknown>): Promise<CreateResult>;
     update(model: string, id: string, data: Record<string, unknown>): Promise<CreateResult>;
@@ -1962,171 +2137,6 @@ declare class LayoutContainmentError extends Error {
     constructor(message: string);
 }
 
-/**
- * 侦察层对 HTTP 的**窄端口**与**响应分类**。
- *
- * 🔴 为什么是端口而不是搬一份客户端过来（ADR-319 刀 6b 明令）：
- * CLI 已经有认证 / endpoint 解析 / token 刷新 / 拦截器这一整条管道
- * （`packages/core/src/client.ts` + `src/http/`）。侦察层再造一份，就是
- * 「集成 reference path 必复用 helper」那条铁律的反面。
- *
- * 但**响应分类**不在那条管道里，而它是侦察层的命根子：顾问打的是一个陌生环境，
- * 「没权限」「没这个端点」「网关吐了 HTML」「连不上」的下一步完全不同。
- * 把它们压成一个布尔，产物里就再也分不出来了。所以这一层必须自己有。
- *
- * ⚠️ `error` 用字符串而不是布尔：要区分的不是「成没成」，而是「没成是哪一种」。
- * 判成功一律写 `error === 'ok'`，别写 `!error`。
- */
-
-/** 响应分类的完整取值域。 */
-type OutcomeError = 'ok' | 'unauthorized' | 'forbidden' | 'not-found' | 'server-error' | 'bad-response' | 'network';
-interface Outcome {
-    /** 网络层没走通时是 `-1`——它不是 HTTP 状态，别拿去和 4xx 比。 */
-    status: number;
-    /** 🔴 是 unknown 不是对象：服务端完全可能返回 array / string / number。 */
-    body: unknown;
-    error: OutcomeError;
-    /**
-     * 本次响应的头，键一律小写。
-     *
-     * 🔴 挂在 Outcome 上而不是客户端实例上（Python 侧是 `client.last_headers`）：
-     * 那种可变字段有「串味」风险——上一次成功的头留到这一次失败时被读到，
-     * 而 `probeExtensionSource` 恰恰是紧跟每次 GET 读头。挂在返回值上让串味**结构上不可能**，
-     * 契约里那几条「last_headers 必须清空」于是从「要测的行为」变成「构造上成立」。
-     */
-    headers: Record<string, string>;
-}
-interface ReconProbe {
-    get(path: string, params?: Record<string, unknown>): Promise<Outcome>;
-    post?(path: string, body: unknown): Promise<Outcome>;
-    getMany?(paths: string[]): Promise<Record<string, Outcome>>;
-    postMany?(jobs: Array<{
-        path: string;
-        body: unknown;
-    }>): Promise<Record<string, Outcome>>;
-    /** 爬取时声明的 capability 串——它是**爬法**属性，不是环境属性。 */
-    readonly capabilities: string;
-}
-/** 把既有 axios 管道（已带认证与刷新）适配成侦察层的窄端口。 */
-declare function httpProbe(http: AxiosInstance, capabilities: string): Required<ReconProbe>;
-
-/** 🔴 只有这三个分量作门。backendVersion 仅记录——实测它在 on-prem 恒返 "unknown"。 */
-declare const GATE_COMPONENTS: readonly ["tenantMetaManifestDigest", "extensionSource", "modelListHash"];
-declare const BLIND_SPOTS: string;
-declare const MODELS_PATH = "/api/system/models";
-declare const MANIFEST_PATH = "/api/tenant-meta/list";
-declare const VERSION_PATH = "/api/version/backend";
-declare const META_PATH = "/api/models/{model}/meta";
-declare const EXTENSION_SOURCE_HEADER = "x-hcm-extension-source";
-/**
- * 探针上限。取不到就取不到，**不许**为了拿到一个值把 761 个模型全试一遍——
- * 那会让 doctor 从「几秒」变成「几分钟」，而 doctor 存在的意义就是**快速**告诉顾问他站在哪儿。
- *
- * 🔴 为什么是 50 而不是 20：「20 够不够」这个问题，原工位实测第 1 个 key 就命中，
- * 但**这不能证明任何别的环境**；若某环境排序靠前的 key 恰好全是隐藏型（实测有 19 个），
- * 探针会空手而归并阻断门，而 key 21 可能就带着这个头。
- * ⇒ 正确的应对**不是**把 20 换成另一个同样证明不了的数字，而是：
- * ① 放宽到显然够用又不至于拖慢 doctor（命中即停，坏情况 50 × ~50ms ≈ 2.5s）；
- * ② 把失败讲清楚（见 attempted/answered）。判据从「猜一个够用的数」换成「失败时说得出为什么」。
- */
-declare const MAX_SOURCE_PROBES = 50;
-/**
- * 本模块的全部前提是「打一个不认识的环境」。一个把 totalPages 报成 2**31 的
- * 服务端会让顾问的笔记本原地转圈。200 页 × 200 行 = 4 万行，远超真实 workspace。
- */
-declare const MAX_MANIFEST_PAGES = 200;
-interface ModelEntry {
-    modelKey?: string;
-    type?: string;
-    [k: string]: unknown;
-}
-/**
- * `/api/system/models` 的响应体 → **可用的**模型条目。
- *
- * 🔴 **这是唯一一道门**。原先 doctor / computeFingerprint / 布局解析三个点各写各的过滤，
- * 第三个漏了——而它跑在**最前面**，客户网关一改清单形状，recon 就在第一步崩掉，
- * 而 FDE 手上没有源码、没有安装包、也没有第二份基线可对照。
- *
- * 两种敌意形状都在这里挡掉，调用方不必（也不许）自己判：
- * ① `body` 整体不是对象——服务端**声明**返 object，但网关扒掉 envelope 直接返数组是真会发生的；
- * ② `models[]` 里混进非对象元素——部分序列化失败 / 拼接出错。
- *
- * ⚠️ **降级不是静默**：这里只负责「不崩」，「有没有掉东西」由调用方各自留痕。
- */
-declare function modelEntries(body: unknown): ModelEntry[];
-/**
- * `/api/system/models` 的响应体 → 探针用的 modelKey 列表（去空串 + 排序）。
- *
- * 🔴 空串过滤不能省：一条缺 `modelKey` 的记录会让第一发打到 `/api/models//meta`，
- * 白烧一发**有限的**探针配额。
- * 🔴 排序 = 探针确定性：同一个环境两次 recon 必须探同一个模型，否则 `extensionSourceProbe`
- * 会无端漂移，看上去像环境变了。
- */
-declare function modelKeys(body: unknown): string[];
-interface ProbeResult {
-    sourceKey: string;
-    probeModelKey: string;
-    attempted: number;
-    answered: number;
-}
-/**
- * 探 `X-HCM-Extension-Source`。
- *
- * 🔴 **这个头只挂在 `GET /api/models/{model}/meta` 上，`/api/system/models` 上没有**。
- * 读错端点的后果不是「偶尔取不到」，是**每一个真实环境上恒为 unknown**：三个门分量残掉
- * 一个 ⇒ `compareFingerprint` 恒返 `incomplete:` ⇒ 门被 `--force-stale` 常态化绕过。
- *
- * 🔴 `answered` 不是凑数的统计量，它是「unknown 到底是哪种 unknown」的唯一判据。
- * 只返回 `(sourceKey, probeModelKey)` 时，「一个模型都没答应」与「答应了但没回这个头」
- * **都**返回空串、**都**写同一条失败条目——顾问看到 `unknown` 照样不知道该查连通/权限还是查反代。
- * **一个自己都分辨不了的分辨承诺比不承诺更糟**，它让人以为这件事已经处理了。
- */
-declare function probeExtensionSource(probe: ReconProbe, keys: string[]): Promise<ProbeResult>;
-/**
- * 产物目录要用的 `sourceKey`——`recon` 打出去的**第一个**请求序列。
- *
- * 🔴 单独一个入口，而**不是**让命令层自己 `probe.get(MODELS_PATH)` 再就地取 key：
- * `probeExtensionSource` 此前有三个调用点，其中一个（recon 的这一跳）漏了
- * 「元素可能不是对象 / body 整体可能不是对象 / modelKey 可能是空串」这三道过滤，
- * 于是客户网关一改清单形状，`recon` 就在第一步以一条裸堆栈收场 —— 而顾问手上
- * 没有源码、没有安装包、也没有第二份基线可对照。
- * 三处各修各的会再漏第四处；收进 `modelKeys()` 这**一道门**，漏不掉。
- *
- * 🔴 探不到时回 `'unknown'` 而不是抛：探不到是**可降级**的（产物目录名带 unknown，
- * 顾问一眼看得出这份基线的层次身份没确认），而抛会让整轮爬取在第一步就没了。
- */
-declare function computeReconSourceKey(probe: ReconProbe): Promise<string>;
-interface Fingerprint {
-    tenantMetaManifestDigest: string;
-    manifestEntryCount: number;
-    extensionSource: string;
-    extensionSourceProbe: string;
-    extensionSourceProbeAttempted: number;
-    extensionSourceProbeAnswered: number;
-    modelListHash: string;
-    modelCount: number;
-    backendVersion: unknown;
-    capabilities: string;
-    createdAt: string;
-    ttlDays: number;
-    coverageNotes: {
-        gateComponents: string[];
-        blindSpots: string;
-        fetchFailures: string[];
-    };
-}
-declare function computeFingerprint(probe: ReconProbe, opts?: {
-    ttlDays?: number;
-    now?: () => Date;
-}): Promise<Fingerprint>;
-/**
- * 比对两份四元组，回**差异清单**（空 = 同源）。
- *
- * 🔴 某个分量没爬到时，它和「爬到了而且相等」在值上同形。两边都没爬到 → 三个分量全等
- * → 门放行一份根本没验过的基线。所以残缺本身也要进差异清单。
- */
-declare function compareFingerprint(recorded: Record<string, unknown>, current: Record<string, unknown>): string[];
-
 type DoctorAnchor = 'connectivity' | 'identity' | 'config-admin' | 'layer';
 /** 四条锚点的顺序是固定的：连通 → 我是谁 → 有没有权限 → 站在哪一层。 */
 declare const DOCTOR_ANCHORS: readonly DoctorAnchor[];
@@ -3007,4 +3017,4 @@ interface TriageRoundResult {
  */
 declare function runTriageRound(probe: ReconProbe, artifactsDir: string, entriesIn: readonly TriageEntry[]): Promise<TriageRoundResult>;
 
-export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ARTIFACT_ROOT, ARTIFACT_SUFFIXES, ARTIFACT_WORDING, AUTH_INFO_PATH, type Aclass, type AclassKind, type AclassProblem, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, type ApprovalConfirmPayload, type ApprovalRejectPayload, type AttachmentMeta, type AuthScheme, BLIND_SPOTS, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CHANNELS, CHANNEL_ACLASS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CLASS_REASONS, CLASS_SCOPE, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type Channel, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, DATA_PACKAGE_BLIND_NOTE, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_SESSION_TTL_SECONDS, DOCTOR_ANCHORS, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FOLDED_NOTE, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Fingerprint, type Fixture, type FormatOptions, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HcmClient, type HcmClientOpts, type HttpClientOptions, type IdentityMeta, type ImportClient, type ImportOptions, type ImportResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, LEDGER_MISSING_WORD, LayoutContainmentError, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_PATH, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MappingArtifactError, Matcher, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelQueryDsl, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, type ResumeSummary, type ResumeTurn, type RoundResult, type RoundState, type RowResult, type RowStatus, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, type SaveMetaResult, type ScanOptions, type ScanResult, type SendMessageOpts, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type V4RenderSink, type V4StreamEventType, VERSION_PATH, WORKSPACES_PATH, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, adminResetPassword, archiveDir, artifactReason, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, checkGaps, checkPremise, checkReds, cjkRunAt, classifyMessage, clearMetaCache, clearModelCache, compareFingerprint, computeFingerprint, computeReconSourceKey, conversationStateFile, covered, create, createConversation, createHttpClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deriveAclass, deriveNamelessToolLabel, describePrincipal, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, displayWidth, downloadDocument, endpointsIn, ensureSessionFresh, envDir, envFile, envsDir, exitCode, exitCodeFor, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, httpProbe, identitiesDir, identityDir, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, isCjk, isDelegationToolName, isReadOnly, isServerSlidingSession, listEnvs, listIdentities, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadGlobalConfig, loadIdentity, loadProfile, loadProtocolFacts, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchSkills, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, oneShot, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, readBusinessKeyFields, readMiniContext, readPullManifest, refreshToken, remove, renderRound, renderTriage, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveChironBase, resolveRefs, resolveSkillInstallOrder, roundAge, runDoctor, runImport, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, segmentsOf, sendMessageAndStream, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unguardedKinds, update, uploadDocument, validateMiniProject };
+export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ARTIFACT_ROOT, ARTIFACT_SUFFIXES, ARTIFACT_WORDING, AUTH_INFO_PATH, type Aclass, type AclassKind, type AclassProblem, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, type ApprovalConfirmPayload, type ApprovalRejectPayload, type AttachmentMeta, type AuthScheme, BLIND_SPOTS, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CHANNELS, CHANNEL_ACLASS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CLASS_REASONS, CLASS_SCOPE, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type Channel, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, DATA_PACKAGE_BLIND_NOTE, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_SESSION_TTL_SECONDS, DOCTOR_ANCHORS, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FOLDED_NOTE, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Fingerprint, type Fixture, type FormatOptions, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HcmClient, type HcmClientOpts, type HttpClientOptions, type IdentityMeta, type ImportClient, type ImportOptions, type ImportResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, LEDGER_MISSING_WORD, LayoutContainmentError, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_PATH, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MappingArtifactError, Matcher, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, type ResumeSummary, type ResumeTurn, type RoundResult, type RoundState, type RowResult, type RowStatus, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, type SaveMetaResult, type ScanOptions, type ScanResult, type SendMessageOpts, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type V4RenderSink, type V4StreamEventType, VERSION_PATH, WORKSPACES_PATH, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, adminResetPassword, archiveDir, artifactReason, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, checkGaps, checkPremise, checkReds, cjkRunAt, classifyMessage, clearMetaCache, clearModelCache, compareFingerprint, computeFingerprint, computeReconSourceKey, conversationStateFile, covered, create, createConversation, createHttpClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deriveAclass, deriveNamelessToolLabel, describePrincipal, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, displayWidth, downloadDocument, endpointsIn, ensureSessionFresh, envDir, envFile, envsDir, exitCode, exitCodeFor, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, httpProbe, identitiesDir, identityDir, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, isCjk, isDelegationToolName, isReadOnly, isServerSlidingSession, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadGlobalConfig, loadIdentity, loadProfile, loadProtocolFacts, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchSkills, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, oneShot, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, readBusinessKeyFields, readMiniContext, readPullManifest, refreshToken, remove, renderRound, renderTriage, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveChironBase, resolveRefs, resolveSkillInstallOrder, roundAge, runDoctor, runImport, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, segmentsOf, sendMessageAndStream, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unguardedKinds, update, uploadDocument, validateMiniProject };