@hcmai/sdk 0.15.12 → 0.15.14

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
@@ -396,6 +396,14 @@ interface RowResult {
396
396
  id?: string;
397
397
  error?: string;
398
398
  traceId?: string;
399
+ /**
400
+ * 这一行里**目标模型两种写法都不认**的键(原名)。只在非空时出现。
401
+ *
402
+ * 🔴 为什么它必须在行上:服务端对不认识的键连读都不读且不报错,`status: 'updated'`
403
+ * 只表示「这次请求被接受了」,不表示「值写进去了」。没有这一位,跑完全绿而数据是空的
404
+ * (hcm_nx_cli#277 · Jira HCMNX-111 现场:1024 行全绿、51200 格全空)。
405
+ */
406
+ unmappedFields?: string[];
399
407
  }
400
408
  interface ImportResult {
401
409
  created: number;
@@ -414,6 +422,14 @@ interface ImportResult {
414
422
  * 不区分就会让调用方以为整份数据都是自己造的,重跑或回滚时按错误的假设动手。
415
423
  */
416
424
  refsFromTarget: string[];
425
+ /**
426
+ * 字段清单**没读到**的那些 Model(旧后端 / 无权限 / 回空集)。这些 Model 的键按老规则
427
+ * 一律转驼峰发出,**没有做过校验**。
428
+ *
429
+ * 🔴 单列这一份,是为了不把「校验过、没问题」和「压根没校验」输出成同一个空的
430
+ * `unmappedFields` —— 后者下一步该做的是写后回读,前者不用。
431
+ */
432
+ fieldNamesUnverified: string[];
417
433
  }
418
434
  interface ImportOptions {
419
435
  dryRun?: boolean;
@@ -424,8 +440,33 @@ interface ImportOptions {
424
440
  /** snake_case → camelCase(单个 key)。 */
425
441
  declare function snakeToCamel(key: string): string;
426
442
  /** 转换 record 的**顶层** key:snake_case → camelCase。
427
- * 嵌套对象/数组的值(jsonb / i18n)原样透传,不转内部键名(对齐 schema §4)。 */
443
+ * 嵌套对象/数组的值(jsonb / i18n)原样透传,不转内部键名(对齐 schema §4)。
444
+ *
445
+ * 🔴 **写入路径别直接用它**,用 {@link resolveItemKeys}:无条件转会改掉真名本身带下划线的
446
+ * 字段名(见那边的说明)。这里留着是因为拿不到字段清单时仍要退回这条老规则。 */
428
447
  declare function camelizeKeys(obj: Record<string, unknown>): Record<string, unknown>;
448
+ /** 一行归一的结果:按什么名字发出去,以及哪些键目标模型两种写法都不认。 */
449
+ interface KeyResolution {
450
+ payload: Record<string, unknown>;
451
+ /** 原样写法与驼峰写法模型都不认的键(原名)。空数组表示没有这种键。 */
452
+ unmapped: string[];
453
+ }
454
+ /**
455
+ * 模型感知的顶层键归一:**目标模型认得原名就原样保留**,否则才 snake_case → camelCase。
456
+ *
457
+ * 🔴 为什么不能无条件转:真名本身带下划线的字段(租户扩展字段是典型,另有仓内 87 个
458
+ * `_metas` 字段)会被改成一个模型不认识的键;而服务端按元数据遍历字段,**不认识的键连读都不读**,
459
+ * 于是写入返 200 / 报告记 updated / 值一个没落。同一条规则在服务端那份载体上已经修过
460
+ * (hcm_nx_core#2023:模型认可原始下划线键时保留原名),客户端这份是第二个载体
461
+ * (hcm_nx_cli#277 · Jira HCMNX-111)。
462
+ *
463
+ * `knownKeys` 传 `null` 或空集表示**没拿到**字段清单(不是「这个模型没有字段」):那时退回
464
+ * 无条件转,并由调用方在整轮结果上留「未校验」标记 —— 兜底不禁止,不自陈的兜底才禁止。
465
+ *
466
+ * 两种写法都不认时发**原名**:我们没有任何证据说驼峰那个更对,发原名能让服务端的回执与
467
+ * 作者写下的键对得上。
468
+ */
469
+ declare function resolveItemKeys(obj: Record<string, unknown>, knownKeys: ReadonlySet<string> | null): KeyResolution;
429
470
 
430
471
  declare class RefStore {
431
472
  private map;
@@ -450,13 +491,21 @@ declare function resolveRefs(record: Record<string, unknown>, store: RefStore):
450
491
  /** 解析 + 校验单个 data fixture(对齐 spec §10 校验项 1–4)。 */
451
492
  declare function parseFixture(yamlText: string, sourcePath?: string): Fixture;
452
493
 
453
- /** runner 只依赖 client 的这三个方法,便于单测 stub。 */
494
+ /** runner 只依赖 client 的这四个方法,便于单测 stub。 */
454
495
  interface ImportClient {
455
496
  findIdByKey(model: string, keyField: string, keyValue: string): Promise<string | null>;
456
497
  create(model: string, data: Record<string, unknown>): Promise<{
457
498
  id: string;
458
499
  }>;
459
500
  update(model: string, id: string, data: Record<string, unknown>): Promise<unknown>;
501
+ /**
502
+ * 目标模型写入侧认得哪些字段键(含租户扩展字段)。字段名归一靠它才能不改错名字
503
+ * (见 {@link resolveItemKeys})。
504
+ *
505
+ * 读不到就**抛**或回空数组,runner 会退回老规则并在结果里留「未校验」标记 ——
506
+ * 不许在这里编一份猜的清单,那会让「校验过」与「猜的」同值。
507
+ */
508
+ fieldKeys(model: string): Promise<string[]>;
460
509
  }
461
510
  declare function runImport(client: ImportClient, fixtures: Fixture[], opts?: ImportOptions): Promise<ImportResult>;
462
511
 
@@ -545,6 +594,11 @@ declare class HcmClient {
545
594
  create(model: string, data: Record<string, unknown>, opts?: WriteOpts): Promise<CreateResult>;
546
595
  update(model: string, id: string, data: Record<string, unknown>, opts?: WriteOpts): Promise<CreateResult>;
547
596
  remove(model: string, id: string): Promise<RemoveResult>;
597
+ /**
598
+ * 目标模型写入侧认得哪些字段键(含租户扩展字段)—— import 的字段名归一靠它。
599
+ * 读不到就让异常上抛:runner 会退回老规则并在结果里留「未校验」标记。
600
+ */
601
+ fieldKeys(model: string): Promise<string[]>;
548
602
  /** 按业务键查已存在记录的 id(幂等用);命中返回 id,否则 null。 */
549
603
  findIdByKey(model: string, keyField: string, keyValue: string): Promise<string | null>;
550
604
  importPackage(fixtures: Fixture[], opts?: ImportOptions): Promise<ImportResult>;
@@ -6583,6 +6637,44 @@ declare class JiraHttpError extends Error {
6583
6637
  constructor(status: number, method: string, path: string, message: string);
6584
6638
  }
6585
6639
 
6640
+ /**
6641
+ * 打到 Jira 之前的非 BMP 字符体检(hcm_nx_cli#278 · Jira HCMNX-112)。
6642
+ *
6643
+ * HCMNX 那台 Jira 的文本列存不下码点 > U+FFFF 的字符(3 字节 UTF-8 的库)。整单被 400 拒,
6644
+ * 而返回里的 `errors` 是**空对象**——既不说哪个字段,也不说哪个字符。顾问只能二分 + PUT
6645
+ * 一层层扒,单次定位十余次请求。这份体检把那十余次压成一次。
6646
+ *
6647
+ * 🔴 判据是**码点是否 > U+FFFF**,不是「是不是 emoji」:同一族里 ✅(U+2705)收、
6648
+ * 🟢(U+1F7E2)拒;反过来生僻姓氏用字(如 𠮷 U+20BB7)也在 CJK 扩展 B 区,同样存不下。
6649
+ * 所以文案一律按码点说话,不说「表情符号」。
6650
+ */
6651
+ /** 一处命中。{@link index} 按**码点**计数,不是 UTF-16 码元——代理对算一个字符。 */
6652
+ interface NonBmpHit {
6653
+ /** 字段路径,如 `fields.customfield_11805[1]`;顶层字符串为空串。 */
6654
+ path: string;
6655
+ /** 第几个字符,0 基,按码点计。 */
6656
+ index: number;
6657
+ char: string;
6658
+ /** 形如 `U+1F534`。 */
6659
+ codePoint: string;
6660
+ }
6661
+ /** 判据本身,两处文案共用一份,免得改一处漏一处。 */
6662
+ declare const NON_BMP_RULE_NOTE = "\u5224\u636E\u662F\u7801\u70B9 > U+FFFF\uFF0C\u4E0D\u662F\u300C\u662F\u4E0D\u662F emoji\u300D\uFF1A\u2705 \u26A0 \u274C \u8FD9\u4E9B BMP \u7B26\u53F7 Jira \u7167\u6536";
6663
+ /** 深度遍历载荷,把每一处非 BMP 字符连同它的字段路径与位置收集出来。**一次报全**,不是发现一个就停。 */
6664
+ declare function findNonBmpChars(value: unknown, path?: string): NonBmpHit[];
6665
+ /**
6666
+ * 每处命中一行:哪个字段、第几个字符、什么码点、**该怎么改**。
6667
+ * 给调用方拼进自己的下一步用(`gap verify` 就这么用,见 {@link describeNonBmpHits} 的说明)。
6668
+ */
6669
+ declare function nonBmpHitLines(hits: NonBmpHit[]): string;
6670
+ /** 把命中渲染成完整一段:抬头 + 逐处 + next_step。直接抛给调用方的错误用这个。 */
6671
+ declare function describeNonBmpHits(hits: NonBmpHit[]): string;
6672
+ /** 请求**没有发出去**:在打到 Jira 之前拦下的,不是 Jira 返回的错误。 */
6673
+ declare class JiraNonBmpContentError extends Error {
6674
+ readonly hits: NonBmpHit[];
6675
+ constructor(hits: NonBmpHit[], method: string, path: string);
6676
+ }
6677
+
6586
6678
  interface RepoRef {
6587
6679
  repo: string;
6588
6680
  number: string;
@@ -6600,4 +6692,4 @@ type ParsedRef = {
6600
6692
  declare function parseRef(raw: string, project: string, casesSlug?: string): ParsedRef | null;
6601
6693
  declare const firstLine: (s: string) => string;
6602
6694
 
6603
- export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, type ActionEffectClass, 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 ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, type BrowserAuthorization, type BrowserAuthorizationWatch, type BrowserStatusProbe, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_STATUS_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, CONTROL_BUFFER_LIMIT, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationRejection, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EndpointNormalization, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldEnumValue, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_CONVERSATION_QUERY_PARAM, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_FIELD_RAW_KEYS, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionDecision, type InteractionOutcome, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, JiraHttpError, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraTransitionField, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, 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, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PendingInteraction, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, REJECTED_BEFORE_ROUTING_CODE, REQUIRED_SECTIONS, RESPOND_TIMEOUT_MS, RESTORE_CODES, 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, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, SERVER_ERROR_GRACE_MS, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type ServerErrorFrame, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TenantResetReceipt, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type UndeterminedReason, 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, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, assertUsableEndpoint, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, diagnoseRejectedBeforeRouting, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listPendingInteractions, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalizeAndAssertEndpoint, normalizeEndpoint, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resetTenant, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, respondToInteraction, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, watchBrowserAuthorization, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
6695
+ export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, type ActionEffectClass, 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 ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, type BrowserAuthorization, type BrowserAuthorizationWatch, type BrowserStatusProbe, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_STATUS_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, CONTROL_BUFFER_LIMIT, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationRejection, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EndpointNormalization, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldEnumValue, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_CONVERSATION_QUERY_PARAM, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_FIELD_RAW_KEYS, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionDecision, type InteractionOutcome, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, JiraHttpError, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, JiraNonBmpContentError, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraTransitionField, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, type KeyResolution, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, 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, NON_BMP_RULE_NOTE, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, type NonBmpHit, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PendingInteraction, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, REJECTED_BEFORE_ROUTING_CODE, REQUIRED_SECTIONS, RESPOND_TIMEOUT_MS, RESTORE_CODES, 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, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, SERVER_ERROR_GRACE_MS, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type ServerErrorFrame, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TenantResetReceipt, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type UndeterminedReason, 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, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, assertUsableEndpoint, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describeNonBmpHits, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, diagnoseRejectedBeforeRouting, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, findNonBmpChars, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listPendingInteractions, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, nonBmpHitLines, normalizeAndAssertEndpoint, normalizeEndpoint, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resetTenant, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveItemKeys, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, respondToInteraction, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, watchBrowserAuthorization, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
package/dist/index.js CHANGED
@@ -317,6 +317,11 @@ function normalizeActionParams(action3) {
317
317
  type: action3.paramTypes?.[index] ?? "unknown"
318
318
  }));
319
319
  }
320
+ async function fetchModelFieldKeys(http, model) {
321
+ const resp = await http.get(`/api/models/${model}/meta`);
322
+ const fields = resp.data?.fields ?? [];
323
+ return fields.map((f) => f.key).filter((k) => typeof k === "string" && k.length > 0);
324
+ }
320
325
  async function describe(http, model, _opts = {}) {
321
326
  const [metaResp, effective] = await Promise.all([
322
327
  http.get(`/api/models/${model}/meta`),
@@ -1858,6 +1863,27 @@ function camelizeKeys(obj) {
1858
1863
  }
1859
1864
  return out;
1860
1865
  }
1866
+ function resolveItemKeys(obj, knownKeys) {
1867
+ if (knownKeys === null || knownKeys.size === 0) {
1868
+ return { payload: camelizeKeys(obj), unmapped: [] };
1869
+ }
1870
+ const payload = {};
1871
+ const unmapped = [];
1872
+ for (const [k, v] of Object.entries(obj)) {
1873
+ if (knownKeys.has(k)) {
1874
+ payload[k] = v;
1875
+ continue;
1876
+ }
1877
+ const camel = snakeToCamel(k);
1878
+ if (knownKeys.has(camel)) {
1879
+ payload[camel] = v;
1880
+ continue;
1881
+ }
1882
+ payload[k] = v;
1883
+ unmapped.push(k);
1884
+ }
1885
+ return { payload, unmapped };
1886
+ }
1861
1887
 
1862
1888
  // src/import/placeholder.ts
1863
1889
  var PLACEHOLDER_RE = /^\$\{([A-Za-z0-9_]+):([^}]+)\}$/;
@@ -1948,12 +1974,29 @@ async function runImport(client, fixtures, opts = {}) {
1948
1974
  const rows = [];
1949
1975
  const tally = { created: 0, updated: 0, skipped: 0, failed: 0 };
1950
1976
  const refsFromTarget = [];
1977
+ const knownKeysOf = /* @__PURE__ */ new Map();
1978
+ const fieldNamesUnverified = [];
1951
1979
  const result = () => ({
1952
1980
  ...tally,
1953
1981
  rows,
1954
1982
  refs: store.snapshot(),
1955
- refsFromTarget: [...refsFromTarget]
1983
+ refsFromTarget: [...refsFromTarget],
1984
+ fieldNamesUnverified: [...fieldNamesUnverified]
1956
1985
  });
1986
+ const knownKeysFor = async (model) => {
1987
+ if (!knownKeysOf.has(model)) {
1988
+ let resolved = null;
1989
+ try {
1990
+ const keys = await client.fieldKeys(model);
1991
+ resolved = keys.length > 0 ? new Set(keys) : null;
1992
+ } catch {
1993
+ resolved = null;
1994
+ }
1995
+ if (resolved === null) fieldNamesUnverified.push(model);
1996
+ knownKeysOf.set(model, resolved);
1997
+ }
1998
+ return knownKeysOf.get(model) ?? null;
1999
+ };
1957
2000
  const keyFieldOf = /* @__PURE__ */ new Map();
1958
2001
  for (const fx of fixtures) {
1959
2002
  if (fx?.model && fx.key_field) keyFieldOf.set(fx.model, fx.key_field);
@@ -1984,22 +2027,23 @@ async function runImport(client, fixtures, opts = {}) {
1984
2027
  tally.skipped++;
1985
2028
  continue;
1986
2029
  }
1987
- const payload = camelizeKeys(resolved);
2030
+ const { payload, unmapped } = resolveItemKeys(resolved, await knownKeysFor(fx.model));
2031
+ const unmappedNote = unmapped.length > 0 ? { unmappedFields: unmapped } : {};
1988
2032
  try {
1989
2033
  const existingId = await client.findIdByKey(fx.model, fx.key_field, key);
1990
2034
  if (existingId && !opts.updateOnly) {
1991
2035
  store.register(fx.model, key, existingId);
1992
- rows.push({ model: fx.model, key, status: "skipped", id: existingId });
2036
+ rows.push({ model: fx.model, key, status: "skipped", id: existingId, ...unmappedNote });
1993
2037
  tally.skipped++;
1994
2038
  } else if (existingId && opts.updateOnly) {
1995
2039
  await client.update(fx.model, existingId, payload);
1996
2040
  store.register(fx.model, key, existingId);
1997
- rows.push({ model: fx.model, key, status: "updated", id: existingId });
2041
+ rows.push({ model: fx.model, key, status: "updated", id: existingId, ...unmappedNote });
1998
2042
  tally.updated++;
1999
2043
  } else {
2000
2044
  const created = await client.create(fx.model, payload);
2001
2045
  store.register(fx.model, key, created.id);
2002
- rows.push({ model: fx.model, key, status: "created", id: created.id });
2046
+ rows.push({ model: fx.model, key, status: "created", id: created.id, ...unmappedNote });
2003
2047
  tally.created++;
2004
2048
  }
2005
2049
  } catch (e) {
@@ -2153,6 +2197,13 @@ var HcmClient = class _HcmClient {
2153
2197
  remove(model, id) {
2154
2198
  return remove(this.http, model, id);
2155
2199
  }
2200
+ /**
2201
+ * 目标模型写入侧认得哪些字段键(含租户扩展字段)—— import 的字段名归一靠它。
2202
+ * 读不到就让异常上抛:runner 会退回老规则并在结果里留「未校验」标记。
2203
+ */
2204
+ fieldKeys(model) {
2205
+ return fetchModelFieldKeys(this.http, model);
2206
+ }
2156
2207
  /** 按业务键查已存在记录的 id(幂等用);命中返回 id,否则 null。 */
2157
2208
  async findIdByKey(model, keyField, keyValue) {
2158
2209
  const res = await this.query(model, { filter: { [keyField]: keyValue }, limit: 1 });
@@ -22289,6 +22340,73 @@ var JiraHttpError = class extends Error {
22289
22340
  }
22290
22341
  };
22291
22342
 
22343
+ // src/jira/non-bmp.ts
22344
+ var BMP_REPLACEMENTS = {
22345
+ "\u{1F534}": "\u26A0",
22346
+ "\u{1F7E1}": "\u26A0",
22347
+ "\u{1F7E2}": "\u2705",
22348
+ "\u{1F4CC}": "\u25B6",
22349
+ "\u{1F4CA}": "\u25A6",
22350
+ "\u{1F527}": "\u2699",
22351
+ "\u{1F6AB}": "\u26D4",
22352
+ "\u{1F511}": "\u26BF",
22353
+ "\u{1F31F}": "\u2605",
22354
+ "\u{1F41B}": "\u26A0"
22355
+ };
22356
+ var isIdeographic = (cp) => cp >= 131072 && cp <= 262143;
22357
+ var asCodePoint = (cp) => `U+${cp.toString(16).toUpperCase()}`;
22358
+ var NON_BMP_RULE_NOTE = "\u5224\u636E\u662F\u7801\u70B9 > U+FFFF\uFF0C\u4E0D\u662F\u300C\u662F\u4E0D\u662F emoji\u300D\uFF1A\u2705 \u26A0 \u274C \u8FD9\u4E9B BMP \u7B26\u53F7 Jira \u7167\u6536";
22359
+ function findNonBmpChars(value, path24 = "") {
22360
+ if (typeof value === "string") {
22361
+ const hits = [];
22362
+ let index = 0;
22363
+ for (const char of value) {
22364
+ const cp = char.codePointAt(0);
22365
+ if (cp > 65535) hits.push({ path: path24, index, char, codePoint: asCodePoint(cp) });
22366
+ index += 1;
22367
+ }
22368
+ return hits;
22369
+ }
22370
+ if (Array.isArray(value)) return value.flatMap((item, i) => findNonBmpChars(item, `${path24}[${i}]`));
22371
+ if (value && typeof value === "object") {
22372
+ return Object.entries(value).flatMap(
22373
+ ([key, item]) => findNonBmpChars(item, path24 ? `${path24}.${key}` : key)
22374
+ );
22375
+ }
22376
+ return [];
22377
+ }
22378
+ function nonBmpHitLines(hits) {
22379
+ return hits.map((hit) => {
22380
+ const where = `${hit.path || "(\u9876\u5C42)"} \u7B2C ${hit.index + 1} \u4E2A\u5B57\u7B26 ${hit.char}\uFF08${hit.codePoint}\uFF09`;
22381
+ const cp = hit.char.codePointAt(0);
22382
+ if (isIdeographic(cp)) {
22383
+ return ` ${where} \u2192 \u8FD9\u662F\u751F\u50FB\u6C49\u5B57\uFF0C**\u522B\u5220**\uFF08\u5B83\u591A\u534A\u5C31\u662F\u590D\u73B0\u8981\u7D20\uFF09\uFF1A\u5199\u6210 ${hit.codePoint}\uFF0C\u6216\u5199\u6210 &#x${cp.toString(16).toUpperCase()};\uFF0C\u6B63\u6587\u91CC\u8865\u4E00\u53E5\u8BFB\u97F3\u6216\u62C6\u89E3`;
22384
+ }
22385
+ const replacement = BMP_REPLACEMENTS[hit.char];
22386
+ return replacement ? ` ${where} \u2192 \u6362\u6210 ${replacement}` : ` ${where} \u2192 \u65E0\u767B\u8BB0\u7B49\u4EF7\u5B57\uFF0C\u8BF7\u5220\u9664\u6216\u81EA\u884C\u6362\u6210 BMP \u5B57\u7B26`;
22387
+ }).join("\n");
22388
+ }
22389
+ function describeNonBmpHits(hits) {
22390
+ if (!hits.length) return "";
22391
+ return [
22392
+ `\u8F7D\u8377\u91CC\u6709 ${hits.length} \u5904\u975E BMP \u5B57\u7B26\uFF08\u7801\u70B9 > U+FFFF\uFF09\u3002Jira \u7684\u6587\u672C\u5217\u5B58\u4E0D\u4E0B\u5B83\u4EEC\uFF0C`,
22393
+ // 🔴 不写状态码。仓内唯一一份带日期署名的实测(2026-09-17 · HCMNX-47)记的是评论端点
22394
+ // 回 500 + 一段 ofbiz GenericEntityException;建单端点回什么,没有人实测过。
22395
+ // 在这里写一个具体的数,顾问会照着它去日志里找、或者看到别的码就判「不是这个问题」。
22396
+ "\u6574\u6761\u4F1A\u88AB\u62D2\u6389\u5E76\u56DE\u6EDA\uFF0C\u4E14\u8FD4\u56DE\u91CC\u4E0D\u4F1A\u6307\u540D\u4EFB\u4F55\u5B57\u6BB5\uFF0C\u4E5F\u4E0D\u4F1A\u6307\u540D\u4EFB\u4F55\u5B57\u7B26\uFF1A",
22397
+ nonBmpHitLines(hits),
22398
+ `next_step=\u628A\u4E0A\u9762\u8FD9\u4E9B\u5B57\u7B26\u6362\u6389\u518D\u63D0\u4EA4\uFF08${NON_BMP_RULE_NOTE}\uFF09`
22399
+ ].join("\n");
22400
+ }
22401
+ var JiraNonBmpContentError = class extends Error {
22402
+ hits;
22403
+ constructor(hits, method, path24) {
22404
+ super(`Jira ${method} ${path24} \u6CA1\u6709\u53D1\u51FA\uFF1A${describeNonBmpHits(hits)}`);
22405
+ this.name = "JiraNonBmpContentError";
22406
+ this.hits = hits;
22407
+ }
22408
+ };
22409
+
22292
22410
  // src/jira/client.ts
22293
22411
  var JIRA_TOKEN_FILE = () => process.env.JIRA_TOKEN_FILE || path23.join(os4.homedir(), ".config", "hcm", "jira-token");
22294
22412
  async function jiraTokenSource() {
@@ -22347,6 +22465,10 @@ var JiraClient = class {
22347
22465
  async api(p, init = {}) {
22348
22466
  const method = init.method ?? "GET";
22349
22467
  const url = p.startsWith("http") ? p : `${this.base}${p}`;
22468
+ if (init.body !== void 0) {
22469
+ const hits = findNonBmpChars(init.body);
22470
+ if (hits.length) throw new JiraNonBmpContentError(hits, method, p);
22471
+ }
22350
22472
  const res = await this.fetchImpl(url, {
22351
22473
  method,
22352
22474
  headers: {
@@ -22643,6 +22765,7 @@ export {
22643
22765
  JOURNAL_STOP_UNKNOWN,
22644
22766
  JiraClient,
22645
22767
  JiraHttpError,
22768
+ JiraNonBmpContentError,
22646
22769
  Journal,
22647
22770
  JournalError,
22648
22771
  KIT_CARRY_OVER_KEY,
@@ -22677,6 +22800,7 @@ export {
22677
22800
  MappingError,
22678
22801
  NETWORK_GATES,
22679
22802
  NEXT_STEP,
22803
+ NON_BMP_RULE_NOTE,
22680
22804
  NOT_COVERED_LAYER1,
22681
22805
  NOT_COVERED_LAYER2,
22682
22806
  NOT_COVERED_SELF,
@@ -22825,6 +22949,7 @@ export {
22825
22949
  deleteWorkspaceFile,
22826
22950
  deliveryRunFields,
22827
22951
  deriveNamelessToolLabel,
22952
+ describeNonBmpHits,
22828
22953
  describePrincipal,
22829
22954
  describeWaiver,
22830
22955
  detectDelegationPause,
@@ -22860,6 +22985,7 @@ export {
22860
22985
  findEnvByEndpoint,
22861
22986
  findLastAssistantSeq,
22862
22987
  findLastAssistantTarget,
22988
+ findNonBmpChars,
22863
22989
  firstLine,
22864
22990
  flattenSkills,
22865
22991
  formatMetaIssues,
@@ -22934,6 +23060,7 @@ export {
22934
23060
  modelKeys,
22935
23061
  needsRefresh,
22936
23062
  newRoundId,
23063
+ nonBmpHitLines,
22937
23064
  normalizeAndAssertEndpoint,
22938
23065
  normalizeEndpoint,
22939
23066
  normalizeOrigin,
@@ -22995,6 +23122,7 @@ export {
22995
23122
  resolveChironBase,
22996
23123
  resolveCredentialStoreMode,
22997
23124
  resolveEnvContext,
23125
+ resolveItemKeys,
22998
23126
  resolveProjectEnvironment,
22999
23127
  resolveRefs,
23000
23128
  resolveSkillInstallOrder,