@hcmai/sdk 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2601,6 +2601,11 @@ declare function loadKeyIndex(client: KeyIndexClient, model: unknown, keyFields:
2601
2601
  * Python 的 dict 没有这个问题。
2602
2602
  */
2603
2603
 
2604
+ /**
2605
+ * 🔴 **无默认值**:不写就是校验失败。静默默认成 `skip` 会让「本该更新的行」被悄悄跳过,
2606
+ * 而顾问看到的是一次成功的导入。
2607
+ */
2608
+ declare const ON_EXISTING: readonly ["skip", "update", "fail"];
2604
2609
  /**
2605
2610
  * 本模块会发出的全部 problem code。它自己也被
2606
2611
  * `test_the_declared_problem_codes_are_exactly_the_ones_the_code_emits` 拿源码里的
@@ -3404,6 +3409,11 @@ declare function existingJournalStop(journalPath: string, entries: number): [str
3404
3409
  * 且下游 `encodeKeyTuple` 会拿 `undefined.length` 炸在一个完全指不到真因的地方。
3405
3410
  */
3406
3411
 
3412
+ /**
3413
+ * 产物的顶层键集。🔴 写出去的与读回来的**共用这一份** ——
3414
+ * 它是「形状知识只有一处」这句话的落点,不是一张说明表。
3415
+ */
3416
+ declare const PLAN_JSON_KEYS: readonly ["version", "roundId", "models", "problems", "notes", "crossModelOrder", "baseline"];
3407
3417
  interface PlanFromArtifactsOptions {
3408
3418
  /**
3409
3419
  * 这份计划照的是哪一份基线。
@@ -4432,6 +4442,222 @@ declare function riskFromArtifacts(mappingPath: string, reconDir: string, option
4432
4442
  */
4433
4443
  declare function writeRisk(risk: Risk, out: string): string;
4434
4444
 
4445
+ /**
4446
+ * 🔴 三种同形陷阱。「我要了字段 X,回来没有 X」在
4447
+ * ① 产品里没这个字段 ② 该行该字段为 null ③ 你的角色被 RBAC 裁掉了这一列 ——
4448
+ * 三者在产物里**完全同形**,工具分不开它们。
4449
+ * 不说出来,顾问会把「查不到」直接读成「产品里没有」,方向是低报。
4450
+ */
4451
+ declare const VALUE_FOOTNOTE: string;
4452
+ /**
4453
+ * 🔴 只认**本地名**:`values ../../models` 不许被拼成一条读路径。
4454
+ * 写入端有产物落盘那道闸,读这一侧不经过它,判据得自己立。
4455
+ */
4456
+ declare function isLocalName(name: unknown): boolean;
4457
+ /**
4458
+ * 一份基线上的值域指路器。
4459
+ *
4460
+ * 缓存是三态:`undefined` = 还没读过 · `null` = 读过且**读不到** · Map = 读到了。
4461
+ * 🔴 用 `null` 而不是往 Map 里塞一个哨兵键 —— 哨兵键会与真实 modelKey 抢名字,
4462
+ * 而这份 Map 的键就是服务端说了算的模型名。
4463
+ */
4464
+ declare class ValueHints {
4465
+ private readonly root;
4466
+ private sheets;
4467
+ private domains;
4468
+ constructor(root: string);
4469
+ /** → `{modelKey: completeness}`;**索引根本读不到时返回 `null`**(与「读到了但是空的」分开)。 */
4470
+ private domainIndex;
4471
+ /** 某个模型的 `mapping/<model>.json` → `{fieldKey: 该字段那一行}`;没有则 null。 */
4472
+ private sheet;
4473
+ private refLine;
4474
+ /** 一条命中的指路行(含换行);无从指路时返回空串。 */
4475
+ line(model: unknown, key: unknown): string;
4476
+ }
4477
+
4478
+ /**
4479
+ * 跨模型按关键词找**字段** —— `hcm delivery seed find` 的检索层。
4480
+ *
4481
+ * 移植自 `hcm_nx_core` 的 `tools/fde-kit/hcmnx_kit/find.py`(ADR-319 刀 11i)。
4482
+ *
4483
+ * ## 为什么这一跳非有不可
4484
+ *
4485
+ * 顾问要写 `work/mapping.json` 把客户的 Excel 列映射到产品字段,前提是**知道产品里
4486
+ * 有哪些字段、叫什么**。而他一开始并不知道该看哪个模型 —— `hcm describe <Model>`
4487
+ * 要你先说出模型名,`hcm meta list --keyword` 搜的是租户元数据文件(yml/properties)
4488
+ * 而不是模型字段目录。两者都不是这一跳的对等物。
4489
+ *
4490
+ * 🔴 **本层零网络**:吃的是 `hcm delivery recon` 已经爬到本地的 `index/fields.jsonl`。
4491
+ * `recon/fields.ts` 的头注释把这件事说得很直白 —— 顾问在一台没有代码仓库、没有安装包的
4492
+ * 机器上,「只能靠 `grep 部门 index/fields.jsonl`」。本模块就是把那一跳 grep 做成命令,
4493
+ * 顺带把 grep 做不到的三件事补上:**按命中质量排序** · **搜业务话术** · **不越预算**。
4494
+ *
4495
+ * ## 三条承重纪律(都是低报方向的事故换来的,不是设想)
4496
+ *
4497
+ * 1. **必须搜业务话术**(`synonyms` / `description` / 枚举 label),不能只搜 name/key/model。
4498
+ * kit 侧夹具实测:只搜后三者时「工号」「部门」「在职」「离职」**全部 0 命中** ——
4499
+ * 而 0 命中与「产品里没有这个东西」同形,方向是低报。
4500
+ * 2. **排序必须在截断之前,且必须在本层做**。实测语料:200 个 description 含「组织」
4501
+ * + 1 个 name 恰为「组织名称」,搜「组织」得 201 命中、只显示 129 行,而那个
4502
+ * **唯一真正叫「组织名称」的字段完全不出现**。光在渲染层排序救不回来 ——
4503
+ * 精确命中可能已经被这里的 `slice(0, limit)` 削掉了,渲染层根本看不到它。
4504
+ * 3. **没有静默截断**:削掉了多少就说多少,而且「渲染放不下」与「检索本身到顶了」
4505
+ * 是两件事,各自具名。合并会把「命中 500」印成确数,方向还是低报。
4506
+ */
4507
+
4508
+ /** 单次输出的硬上界。AC-2 说的是「**单次输出** ≤ 8KB」,不是「检索正文 ≤ 8KB」。 */
4509
+ declare const MAX_BYTES = 8192;
4510
+ /**
4511
+ * 检索上限,**必须显著大于渲染预算放得下的行数**,否则渲染截断分支是死代码。
4512
+ *
4513
+ * 🔴 它同时是 `renderFind` 判断「命中被削过没有」的唯一依据 —— 那边算不出真实命中量。
4514
+ */
4515
+ declare const FIND_LIMIT = 500;
4516
+ /** 每行最多显示几个枚举取值。藏起来的部分由「…共 N 个」说出来(no silent caps)。 */
4517
+ declare const ENUM_SHOW = 8;
4518
+ /**
4519
+ * kit 合成取值的行内标记。
4520
+ *
4521
+ * 🔴 `_kitValueSource` 说的是「这个 value 我们编的,产品从没发过」—— 不标出来,
4522
+ * 顾问会拿它去拼筛选条件:请求 200、结果空集,而他读作「这个环境没有这类数据」。
4523
+ */
4524
+ declare const SYNTH_MARK = "\u26A0\u5408\u6210";
4525
+ declare const SYNTH_FOOTNOTE: string;
4526
+ declare const DIMENSION_LABELS: Readonly<Record<string, string>>;
4527
+ /** 命中维度写在**副本**上的键。见 {@link find} 里那条「返回副本」的纪律。 */
4528
+ declare const KIT_MATCHED_ON = "_kitMatchedOn";
4529
+ /** 索引里的一行。形状与 `recon/fields.ts` 的 `FieldRow` 对齐,但读的是**盘上的** JSON,故全可选。 */
4530
+ interface FoundRow {
4531
+ model?: unknown;
4532
+ key?: unknown;
4533
+ name?: unknown;
4534
+ type?: unknown;
4535
+ isRequired?: unknown;
4536
+ synonyms?: unknown;
4537
+ description?: unknown;
4538
+ enums?: unknown;
4539
+ [k: string]: unknown;
4540
+ }
4541
+ interface LoadedRows {
4542
+ rows: FoundRow[];
4543
+ problems: string[];
4544
+ }
4545
+ /**
4546
+ * 读 `index/fields.jsonl`:一行一个 JSON 对象。
4547
+ *
4548
+ * 🔴 **一行坏掉不许拖垮整份索引**:坏行进 `problems` 台账,好行照常返回。
4549
+ * 顾问手上这份基线可能是拷过来的、可能被编辑器截断过 —— 整份拒读等于让他在现场
4550
+ * 什么都查不了,而他**没有源码可以回去看**。
4551
+ *
4552
+ * 🔴 空行**不算坏行**:`jsonl` 末尾一个换行是再正常不过的形态,把它记进台账等于
4553
+ * 每份正常索引都报一条假问题,读的人很快学会跳过整个台账。
4554
+ */
4555
+ declare function loadRows(text: string): LoadedRows;
4556
+ /**
4557
+ * 这一行是**凭哪几个维度**命中的。顺序固定,便于断言与阅读。
4558
+ *
4559
+ * 🔴 `synonyms` / `description` / 枚举 label 是 recon 特意爬回来并落了盘的**业务话术**。
4560
+ * 只搜 name/key/model 时「工号」「部门」「在职」「离职」全部 0 命中 —— 而 0 命中与
4561
+ * 「产品里没有这个东西」同形,方向是低报,正是这套工具存在的理由要防的那件事。
4562
+ */
4563
+ declare function matchedDimensions(row: FoundRow, term: string): string[];
4564
+ /** 一条命中的质量 = 它**最强**的那个维度。多维命中不叠加分,只取最好的那一档。 */
4565
+ declare function hitRank(row: FoundRow, dims: readonly string[], term: string): number;
4566
+ /**
4567
+ * 检索。空词返回空集(不是全集)—— 「什么都没敲」与「敲了但没命中」都该是空手而归。
4568
+ *
4569
+ * 🔴 **返回副本**:命中维度是本次检索的产物,不是那一行字段的属性。就地写回会污染
4570
+ * 调用方手上的语料 —— 同一批 rows 连搜两次,第二次会读到上次的标记。
4571
+ */
4572
+ declare function find(rows: readonly FoundRow[], term: string, limit?: number): FoundRow[];
4573
+ /**
4574
+ * 命中依据在这一行里**看不见**时,把它说出来。
4575
+ *
4576
+ * 规则只有一条:命中维度**一个都不在这一行里印出来**时才标注。`name` / `key` / `model`
4577
+ * 三者逐字印在行里,人一眼能看出自己为什么匹配上;凭同义词 / 描述 / 枚举命中时行里
4578
+ * 一个线索都没有,不标注就等于让顾问猜。反过来,凭可见维度命中时再标一句是**恒真的
4579
+ * 噪音** —— 读的人很快学会跳过它。
4580
+ */
4581
+ declare function matchNote(hit: FoundRow): string;
4582
+ interface RenderOptions {
4583
+ /**
4584
+ * 值域指路器(刀 11j)。给了就在每条命中行下面追加一行「值该怎么填」。
4585
+ *
4586
+ * 🔴 不给**不是**「没有指路」的同义词,而是「本次不指路」——`find` 在一份没有
4587
+ * `valuedomain/` 的旧基线上仍要能用(那正是 `hints.line()` 返回空串的那一档)。
4588
+ */
4589
+ hints?: Pick<ValueHints, 'line'> | null;
4590
+ /**
4591
+ * 调用方**已经打出去**的字节(出处行 / 轮次告警)。
4592
+ *
4593
+ * 🔴 不扣掉它,命令层就在预算外无条件多加几百字节,而同一个函数为了 `shown` 位数
4594
+ * 把预算越到 8194 都当违规 —— 同一份代码里两套标准。
4595
+ * ⚠️ 扣的是**命中行**(它本来就有具名截断机制),不是出处行与告警:那两行说的是
4596
+ * 「这份基线可不可信」,截掉它们比超预算更糟。
4597
+ */
4598
+ prefixBytes?: number;
4599
+ }
4600
+ /**
4601
+ * 渲染成一页 ≤ 8KB 的检索结果。
4602
+ *
4603
+ * 🔴 尾注余量**算出来**,不写一个魔数:加一段就得同步改那个数,而漏改不会报错,
4604
+ * 只会静默越过 8KB 硬线。这里按「所有尾注全出现」的最坏情况取,因此恒不小于实际尾注。
4605
+ * 🔴 `shown` 位数也算最坏(用 `hits.length`,而 `shown <= hits.length` 恒成立):
4606
+ * 按 `shown=0` 估算时那句印出来的是「此处只显示 163 条」——3 位数比 1 位数多 2 字节,
4607
+ * 预留就少 2 字节,8192 硬线可被越到 8194。越界不报错、不抛异常,只是悄悄多吃
4608
+ * agent 的上下文,正是 AC-2 要防的那件事。
4609
+ */
4610
+ declare function renderFind(hits: readonly FoundRow[], term: string, total: number, options?: RenderOptions): string;
4611
+
4612
+ /** 某一列在这一行**没有值**时印的占位符。 */
4613
+ declare const VALUE_CELL_MISSING = "\u2014";
4614
+ /**
4615
+ * 🔴 停用行**必须与可用值长得不一样**。`values` 是顾问抄值的唯一输出面,停用值抄进
4616
+ * 导入脚本,错误要到写入那一刻才暴露。
4617
+ *
4618
+ * 🔴 **第三态不许并档**:**没有 `enabled` 键 ≠ 启用**。某个工位实测每一行都带这个键,
4619
+ * 但那是**一次观测不是契约** —— 别的租户/版本少发这个键时,替产品假设成 true 就是替它担保。
4620
+ */
4621
+ declare const VALUE_STATE_DISABLED = "\u505C\u7528";
4622
+ declare const VALUE_STATE_UNKNOWN = "enabled?";
4623
+ declare const VALUE_STATE_FOOTNOTE: string;
4624
+ /** 这一行是启用、停用,还是**这份产物里根本没说**。三态,不许并成两态。 */
4625
+ declare function valueState(row: Record<string, unknown>): string;
4626
+ declare function valuesRoundCaveat(round: unknown): string;
4627
+ type ValuesFailure = {
4628
+ kind: 'index-unreadable';
4629
+ message: string;
4630
+ } | {
4631
+ kind: 'not-a-code-table';
4632
+ message: string;
4633
+ } | {
4634
+ kind: 'model-not-in-baseline';
4635
+ message: string;
4636
+ } | {
4637
+ kind: 'file-missing';
4638
+ message: string;
4639
+ } | {
4640
+ kind: 'rows-unreadable';
4641
+ message: string;
4642
+ };
4643
+ interface ValuesOk {
4644
+ ok: true;
4645
+ text: string;
4646
+ }
4647
+ type ValuesResult = ValuesOk | ({
4648
+ ok: false;
4649
+ } & ValuesFailure);
4650
+ interface RenderValuesOptions {
4651
+ /** `undefined` = 走字节预算 · `0` = 不截断 · `>0` = 按行数。 */
4652
+ limit?: number;
4653
+ /** 轮次告警(由调用方从 `inspectRound` 取,本层不自己判轮次)。 */
4654
+ roundCaveat?: string;
4655
+ }
4656
+ /**
4657
+ * 读一张码表并渲染。**四种打不出来各自具名**(见模块头注释那张表)。
4658
+ */
4659
+ declare function renderValues(root: string, model: string, options?: RenderValuesOptions): ValuesResult;
4660
+
4435
4661
  declare const ACLASS_KINDS: readonly ["fieldKey", "fieldLabel", "enumValue", "modelName", "codeValue", "naturalKey", "caliber"];
4436
4662
  type AclassKind = (typeof ACLASS_KINDS)[number];
4437
4663
  /** 枚举元素里**属于租户事实**的那几个键。 */
@@ -5077,4 +5303,4 @@ interface TriageRoundResult {
5077
5303
  */
5078
5304
  declare function runTriageRound(probe: ReconProbe, artifactsDir: string, entriesIn: readonly TriageEntry[]): Promise<TriageRoundResult>;
5079
5305
 
5080
- export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, 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, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type AttachmentMeta, type AuthScheme, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANNELS, CHANNEL_ACLASS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, 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, PREMISE_CODES as DELIVERY_PREMISE_CODES, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FOLDED_NOTE, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Finding, 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, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAPPING_FILE, 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, MappingError, 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, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, 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 PlanProblem, PlanReadError, type PlannedRow, type Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, VERDICTS$1 as RECONCILE_VERDICTS, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_STOP, type SaveMetaResult, type ScanOptions, type ScanResult, type SeedPathArgs, 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, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, VERSION_PATH, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, artifactReason, askedTheDatabase, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, 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, deliveryRunFields, deriveAclass, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, displayWidth, downloadDocument, endpointsIn, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, existingJournalStop, 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, identityKnown, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, isCjk, isDelegationToolName, isReadOnly, isServerSlidingSession, isZeroNetwork, journalNote, judgeDrift, ledgerOnlySignpost, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadProtocolFacts, loadRecordedFingerprint, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchSkills, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, refreshToken, remove, renderRound, renderTriage, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runDoctor, runImport, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unguardedKinds, update, uploadDocument, validateMiniProject, verifyAttention, verifyRc, verifyText, writeImportPlan, writeRisk };
5306
+ export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, 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, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type AttachmentMeta, type AuthScheme, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANNELS, CHANNEL_ACLASS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, 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, PREMISE_CODES as DELIVERY_PREMISE_CODES, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, ENUM_SHOW, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FOLDED_NOTE, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Finding, 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, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAPPING_FILE, 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, MappingError, 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, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, 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 PlanProblem, PlanReadError, type PlannedRow, type Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, VERDICTS$1 as RECONCILE_VERDICTS, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_STOP, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScanOptions, type ScanResult, type SeedPathArgs, 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, VALUE_CELL_MISSING, VALUE_FOOTNOTE, VALUE_STATE_DISABLED, VALUE_STATE_FOOTNOTE, VALUE_STATE_UNKNOWN, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, VERSION_PATH, ValueHints, type ValuesResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, artifactReason, askedTheDatabase, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, 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, deliveryRunFields, deriveAclass, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, displayWidth, downloadDocument, endpointsIn, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, existingJournalStop, exitCode, exitCodeFor, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, find, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, isCjk, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isZeroNetwork, journalNote, judgeDrift, ledgerOnlySignpost, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadProtocolFacts, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, refreshToken, remove, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runDoctor, runImport, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unguardedKinds, update, uploadDocument, validateMiniProject, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, writeImportPlan, writeRisk };