@hcmai/sdk 0.4.24 → 0.4.26

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
@@ -811,14 +811,6 @@ declare function loginPairing(input: PairingLoginInput): Promise<LoginOutcome>;
811
811
  * 东西。要求他先手工削成 origin,等于把「知道后端地址」这个门槛又搬了回来。
812
812
  */
813
813
  declare function toOrigin(raw: string): string;
814
- /**
815
- * 由 origin 推一个 env 名:`https://hcm.custa.com` → `custa`。
816
- *
817
- * 取的是主域左边那一段而不是整个 hostname:`hcm.custa.com` 与 `hcm-test.custa.com`
818
- * 会推出不同的名字,而 `hcm.custa.com` 与 `www.custa.com` 也不会撞。
819
- * 推不出来时落到 `default`,由调用方处理重名。
820
- */
821
- declare function inferEnvName(origin: string): string;
822
814
 
823
815
  interface RefreshInput {
824
816
  endpoint: string;
@@ -955,6 +947,23 @@ declare function identitiesDir(): string;
955
947
  declare function identityDir(name: string): string;
956
948
  declare function identityMetaFile(name: string): string;
957
949
  declare function archiveDir(): string;
950
+ /**
951
+ * 临时环境的保留槽位名。
952
+ *
953
+ * `hcm login <url> --code …` 拿到的是一个**还没有名字**的环境:粘一行地址加码,语义是
954
+ * 「我现在要连这个」,不是「我要新建一个持久环境」。名字是之后 `hcm env save <name>`
955
+ * 才发生的事。
956
+ *
957
+ * 🔴 但「无名」不等于「不落盘」:CLI 每条命令都是独立进程,状态非持久化不可,而
958
+ * `saveIdentity` 还硬要求 `envs/<env>/env.yml` 存在。所以无名落地成**一个不占用命名
959
+ * 空间的固定槽位** —— 使用者永远不会给自己的 env 起这个名字(`envAdd` 显式拒绝),
960
+ * 于是它不参与撞名,也就不需要从地址去猜一个名字。
961
+ *
962
+ * `_` 前缀沿用既有的 `_archive` 约定。
963
+ */
964
+ declare const TEMP_ENV_NAME = "_current";
965
+ /** 是不是那个临时槽位。别在别处写 `=== '_current'` 字面量比较。 */
966
+ declare function isTempEnv(name: string): boolean;
958
967
 
959
968
  interface ProfileConfig {
960
969
  endpoint: string;
@@ -966,6 +975,29 @@ declare function loadProfile(profile: string): Promise<ProfileConfig>;
966
975
  declare function saveProfile(profile: string, cfg: ProfileConfig): Promise<void>;
967
976
  declare function listProfiles(): Promise<string[]>;
968
977
 
978
+ /**
979
+ * 凭据存到哪儿。
980
+ *
981
+ * - `auto`(缺省)—— 先试系统钥匙串,写不进就落 0600 文件。**历史行为**。
982
+ * - `file` —— 直接落 0600 文件,根本不碰钥匙串。
983
+ *
984
+ * 对标业界:git 的 `credential.helper`、docker 的 `credsStore`、kubectl 的 `exec`
985
+ * credential plugin、aws 的 `credential_process` —— 共同形态是「主配置文件只存
986
+ * 非敏感索引,敏感值交给一个**可配置**的后端,且总留一个明文兜底档」。我们的
987
+ * `TokenRecord.accessTokenRef`(`keychain:…` / `file:…`)本来就是那个「引用」,
988
+ * 这里补上的是「让人选」。
989
+ *
990
+ * 🔴 只有两档,**没有** `keychain` 强制档:`storeToken` 走到存 token 这一步时,
991
+ * 服务端那一发已经成功、配对码已经作废,此时中止是最差的一档。所以「强制 keychain」
992
+ * 无法真正强制,只会是一个骗人的名字。
993
+ *
994
+ * 为什么要有 `file`:钥匙串在几种常见场景下是负担而非保护 —— SSH 会话 / 容器 /
995
+ * `sudo` / 换 `HOME` 跑时够不着(issue #79);CI 里根本没有;Agent(Codex /
996
+ * Claude Code)跑 CLI 时弹一次授权窗就把非交互进程卡死。而这里存的多数是 24h 滑动
997
+ * 会话 token,`hcm logout` 就能吊销,与 PAT 那种长期凭据不是一个风险等级。
998
+ */
999
+ type CredentialStoreMode = 'auto' | 'file';
1000
+ declare const CREDENTIAL_STORE_MODES: readonly CredentialStoreMode[];
969
1001
  interface GlobalConfig {
970
1002
  /** Canonical: name of the active environment. */
971
1003
  activeEnv: string;
@@ -977,8 +1009,22 @@ interface GlobalConfig {
977
1009
  defaults?: {
978
1010
  output?: 'table' | 'json' | 'yaml';
979
1011
  timeout?: string;
1012
+ /** 见 {@link CredentialStoreMode}。缺省 `auto`。 */
1013
+ credentialStore?: CredentialStoreMode;
980
1014
  };
981
1015
  }
1016
+ /**
1017
+ * 定下这次到底用哪个凭据后端。优先级:`HCM_CREDENTIAL_STORE` > `config.yml` > `auto`。
1018
+ *
1019
+ * 环境变量在前,是给 CI 和一次性场景留的逃生门(与 `HCM_ENV` / `HCM_IDENTITY` 同款);
1020
+ * 但**常设值该写在配置文件里** —— 这也是 docker `credsStore` / git `credential.helper`
1021
+ * 的形态,环境变量每次都要带、容易忘。
1022
+ *
1023
+ * 🔴 **认不出的值要出声**,两个来源都是。静默落回 auto 会把一个打错的字
1024
+ * (`HCM_CREDENTIAL_STORE=fille`)变成「我以为存文件了,其实还在钥匙串」——
1025
+ * 而这两者外观完全一致,人不会发现。
1026
+ */
1027
+ declare function resolveCredentialStoreMode(cfg: GlobalConfig | null | undefined, env?: NodeJS.ProcessEnv): CredentialStoreMode;
982
1028
  declare function loadGlobalConfig(): Promise<GlobalConfig>;
983
1029
  declare function saveGlobalConfig(cfg: GlobalConfig): Promise<void>;
984
1030
  /**
@@ -1002,6 +1048,14 @@ interface EnvConfig {
1002
1048
  defaultIdentity?: string;
1003
1049
  defaultAgent?: string;
1004
1050
  }
1051
+ /**
1052
+ * 使用者不许把 env 起名成保留槽位。
1053
+ *
1054
+ * 🔴 这道守卫是「无名临时环境」能成立的前提:临时槽位之所以不参与撞名,靠的正是
1055
+ * 没有任何一个具名 env 能占住它。内部写临时槽位走 `saveEnv` 不经过这里 —— 这条
1056
+ * 是给**命令层**(`env add` / `env save`)用的。
1057
+ */
1058
+ declare function assertNotReservedEnvName(name: string): void;
1005
1059
  declare function saveEnv(name: string, cfg: EnvConfig): Promise<void>;
1006
1060
  declare function loadEnv(name: string): Promise<EnvConfig>;
1007
1061
  declare function listEnvs(): Promise<string[]>;
@@ -1041,6 +1095,21 @@ declare function saveIdentity(name: string, meta: IdentityMeta): Promise<void>;
1041
1095
  declare function loadIdentity(name: string): Promise<IdentityMeta>;
1042
1096
  declare function listIdentities(env?: string): Promise<string[]>;
1043
1097
  declare function deleteIdentity(name: string): Promise<void>;
1098
+ /**
1099
+ * 给 identity 改名(目录 + 名字里嵌的 token 引用一起搬)。
1100
+ *
1101
+ * 🔴 **为什么必须改名,而不是只改 `meta.env`**:identity 的名字是**生成**的
1102
+ * (`inferIdentityName` → `${username}@${env}`),临时槽位于是恒定生成
1103
+ * `<user>@_current`。只把 `meta.env` 改成新 env 名、名字留着不动,下一次配对登录
1104
+ * 会生成**同一个名字**并静默覆写它 —— 已保存环境的身份被夺走、token 被顶掉且
1105
+ * **不吊销**(服务端留活最多 24h),而 `env.defaultIdentity` 还指着它。
1106
+ * 「名字里没有解析逻辑依赖」对**读**成立,对**写**不成立。
1107
+ *
1108
+ * 🔴 `file:` 引用存的是**绝对路径**:目录跟着 rename 搬走了,引用还指着旧路径,
1109
+ * 不重算就是「token 文件在,但谁也读不到」。`keychain:` 引用是自洽的账户名,不用动
1110
+ * (名字里留个旧 env 的痕迹不好看,但改它要动钥匙串,代价与收益不成比例)。
1111
+ */
1112
+ declare function renameIdentity(oldName: string, newName: string): Promise<void>;
1044
1113
 
1045
1114
  interface MigrationSummary {
1046
1115
  migrated: string[];
@@ -6013,4 +6082,4 @@ interface ActiveVerifyArgs {
6013
6082
  */
6014
6083
  declare function runActiveVerify(client: MetaClient, args: ActiveVerifyArgs): Promise<VerifyResult>;
6015
6084
 
6016
- 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 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, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHANNELS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, CLASS_REASONS, CLASS_SCOPE, 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, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type ChangeState, 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_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$2 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, 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_ACLASS_NOT_DISCRIMINATIVE, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, 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 InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, 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, MappingArtifactError, MappingError, Matcher, 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_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Premise$1 as 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, RECOVERY_WORDS, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, 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, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScanOptions, type ScanResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TENANT_META_FILE_PATH, 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 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, 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, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, 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, explainJacksonError, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, find, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isCjk, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isTerminalRunStatus, 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, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, rebind, rebindPayload, refreshToken, remove, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, unguardedKinds, update, uploadDocument, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
6085
+ 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 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, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHANNELS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, CLASS_REASONS, CLASS_SCOPE, 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, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type ChangeState, 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, type CredentialStoreMode, DATA_PACKAGE_BLIND_NOTE, 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$2 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, 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_ACLASS_NOT_DISCRIMINATIVE, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, 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 InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, 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, MappingArtifactError, MappingError, Matcher, 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_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Premise$1 as 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, RECOVERY_WORDS, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, 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, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScanOptions, type ScanResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, 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 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, artifactReason, askedTheDatabase, assertNotReservedEnvName, 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, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, 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, explainJacksonError, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, find, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inGap, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isCjk, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isTempEnv, isTerminalRunStatus, 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, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, rebind, rebindPayload, refreshToken, remove, renameIdentity, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, unguardedKinds, update, uploadDocument, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
package/dist/index.js CHANGED
@@ -90,7 +90,7 @@ function createHttpClient(opts) {
90
90
  }
91
91
 
92
92
  // src/auth/token-store.ts
93
- import * as fs from "fs/promises";
93
+ import * as fs2 from "fs/promises";
94
94
 
95
95
  // src/config/paths.ts
96
96
  import * as path from "path";
@@ -140,6 +140,79 @@ function identityMetaFile(name) {
140
140
  function archiveDir() {
141
141
  return path.join(hcmConfigDir(), "_archive");
142
142
  }
143
+ var TEMP_ENV_NAME = "_current";
144
+ function isTempEnv(name) {
145
+ return name === TEMP_ENV_NAME;
146
+ }
147
+
148
+ // src/config/global-config.ts
149
+ import * as fs from "fs/promises";
150
+ import yaml from "js-yaml";
151
+ var CREDENTIAL_STORE_MODES = ["auto", "file"];
152
+ var DEFAULT_ENV = "default";
153
+ var DEFAULT_DEFAULTS = {
154
+ output: "table",
155
+ timeout: "60s",
156
+ credentialStore: "auto"
157
+ };
158
+ function resolveCredentialStoreMode(cfg, env = process.env) {
159
+ const fromEnv = normalizeCredentialStoreMode(env.HCM_CREDENTIAL_STORE, "HCM_CREDENTIAL_STORE");
160
+ if (fromEnv) return fromEnv;
161
+ const fromCfg = normalizeCredentialStoreMode(
162
+ cfg?.defaults?.credentialStore,
163
+ "config.yml defaults.credentialStore"
164
+ );
165
+ return fromCfg ?? "auto";
166
+ }
167
+ function normalizeCredentialStoreMode(raw, source) {
168
+ if (raw !== void 0 && raw !== null && typeof raw !== "string") {
169
+ process.stderr.write(
170
+ `[hcm] WARNING: ${source} \u7684\u503C\u662F ${typeof raw}\uFF08${JSON.stringify(raw)}\uFF09\uFF0C\u5E94\u4E3A\u5B57\u7B26\u4E32\uFF08${CREDENTIAL_STORE_MODES.join(" / ")}\uFF09\uFF0C\u6309 auto \u5904\u7406\u3002
171
+ `
172
+ );
173
+ return null;
174
+ }
175
+ const v = (raw ?? "").trim().toLowerCase();
176
+ if (!v) return null;
177
+ if (CREDENTIAL_STORE_MODES.includes(v)) return v;
178
+ process.stderr.write(
179
+ `[hcm] WARNING: ${source}='${raw}' \u4E0D\u662F\u53EF\u8BC6\u522B\u7684\u503C\uFF08${CREDENTIAL_STORE_MODES.join(" / ")}\uFF09\uFF0C\u6309 auto \u5904\u7406\u3002
180
+ `
181
+ );
182
+ return null;
183
+ }
184
+ async function loadGlobalConfig() {
185
+ let raw = {};
186
+ try {
187
+ const content = await fs.readFile(globalConfigFile(), "utf-8");
188
+ raw = yaml.load(content) ?? {};
189
+ } catch (e) {
190
+ if (e.code !== "ENOENT") throw e;
191
+ }
192
+ const activeEnv = raw.activeEnv ?? raw.activeProfile ?? DEFAULT_ENV;
193
+ return {
194
+ activeEnv,
195
+ activeProfile: activeEnv,
196
+ // dual-write alias
197
+ defaults: { ...DEFAULT_DEFAULTS, ...raw.defaults }
198
+ };
199
+ }
200
+ async function saveGlobalConfig(cfg) {
201
+ await fs.mkdir(hcmConfigDir(), { recursive: true });
202
+ const activeEnv = cfg.activeEnv ?? cfg.activeProfile ?? DEFAULT_ENV;
203
+ const out = {
204
+ activeEnv,
205
+ activeProfile: activeEnv,
206
+ defaults: cfg.defaults
207
+ };
208
+ await fs.writeFile(globalConfigFile(), yaml.dump(out), "utf-8");
209
+ }
210
+ function resolveActiveEnv(args, env, global) {
211
+ return args.envFlag ?? env.HCM_ENV ?? env.HCM_PROFILE ?? global.activeEnv;
212
+ }
213
+ function resolveActiveProfile(args, env, global) {
214
+ return resolveActiveEnv({ envFlag: args.flag }, env, global);
215
+ }
143
216
 
144
217
  // src/auth/token-store.ts
145
218
  function isServerSlidingSession(scheme) {
@@ -177,12 +250,12 @@ var TokenStore = class _TokenStore {
177
250
  return this.isIdentity ? `identity-${this.profile}` : this.profile;
178
251
  }
179
252
  async writeMeta(record) {
180
- await fs.mkdir(this.dataDir(), { recursive: true });
181
- await fs.writeFile(this.metaFile(), JSON.stringify(record, null, 2), { mode: 384 });
253
+ await fs2.mkdir(this.dataDir(), { recursive: true });
254
+ await fs2.writeFile(this.metaFile(), JSON.stringify(record, null, 2), { mode: 384 });
182
255
  }
183
256
  async readMeta() {
184
257
  try {
185
- const raw = await fs.readFile(this.metaFile(), "utf-8");
258
+ const raw = await fs2.readFile(this.metaFile(), "utf-8");
186
259
  return JSON.parse(raw);
187
260
  } catch (e) {
188
261
  if (e.code === "ENOENT") return null;
@@ -212,13 +285,15 @@ var TokenStore = class _TokenStore {
212
285
  * 直接写,抛了就落回文件。下面那条兜底原本**永远够不到**,现在够得到了。
213
286
  */
214
287
  async storeToken(kind, token2) {
288
+ const mode = resolveCredentialStoreMode(await loadGlobalConfig().catch(() => null));
289
+ if (mode === "file") return this.writeTokenFile(kind, token2, void 0, mode);
215
290
  const keytar = await loadKeytar();
216
- if (!keytar) return this.writeTokenFile(kind, token2);
291
+ if (!keytar) return this.writeTokenFile(kind, token2, void 0, mode);
217
292
  const account = `${this.keychainAccountPrefix()}/${kind}`;
218
293
  try {
219
294
  await keytar.setPassword(SERVICE_PREFIX, account, token2);
220
295
  } catch (e) {
221
- return this.writeTokenFile(kind, token2, e);
296
+ return this.writeTokenFile(kind, token2, e, mode);
222
297
  }
223
298
  return `keychain:${SERVICE_PREFIX}/${account}`;
224
299
  }
@@ -252,17 +327,17 @@ var TokenStore = class _TokenStore {
252
327
  const keytar = await loadKeytar();
253
328
  if (keytar) await keytar.deletePassword(SERVICE_PREFIX, account);
254
329
  } else if (meta.accessTokenRef?.startsWith("file:")) {
255
- await fs.rm(meta.accessTokenRef.slice("file:".length), { force: true });
330
+ await fs2.rm(meta.accessTokenRef.slice("file:".length), { force: true });
256
331
  }
257
332
  if (meta.refreshTokenRef?.startsWith("keychain:")) {
258
333
  const account = meta.refreshTokenRef.slice("keychain:".length).split("/").slice(1).join("/");
259
334
  const keytar = await loadKeytar();
260
335
  if (keytar) await keytar.deletePassword(SERVICE_PREFIX, account);
261
336
  } else if (meta.refreshTokenRef?.startsWith("file:")) {
262
- await fs.rm(meta.refreshTokenRef.slice("file:".length), { force: true });
337
+ await fs2.rm(meta.refreshTokenRef.slice("file:".length), { force: true });
263
338
  }
264
339
  if (!this.isIdentity) {
265
- await fs.rm(this.metaFile(), { force: true });
340
+ await fs2.rm(this.metaFile(), { force: true });
266
341
  }
267
342
  }
268
343
  async resolveRef(ref) {
@@ -274,7 +349,7 @@ var TokenStore = class _TokenStore {
274
349
  }
275
350
  if (ref.startsWith("file:")) {
276
351
  try {
277
- return await fs.readFile(ref.slice("file:".length), "utf-8");
352
+ return await fs2.readFile(ref.slice("file:".length), "utf-8");
278
353
  } catch (e) {
279
354
  if (e.code === "ENOENT") return null;
280
355
  throw e;
@@ -290,11 +365,12 @@ var TokenStore = class _TokenStore {
290
365
  * (Linux 无 libsecret 等),「有 keytar 但写不进去」是异常,顾问的下一步不同 ——
291
366
  * 后者必须把原始报错**原样转述**出来,否则他看到的还是一句没有出处的话。
292
367
  */
293
- async writeTokenFile(kind, token2, cause) {
368
+ async writeTokenFile(kind, token2, cause, mode = "auto") {
294
369
  const file = `${this.metaFile()}.${kind}`;
295
- await fs.mkdir(this.dataDir(), { recursive: true });
296
- await fs.writeFile(file, token2, { mode: 384 });
297
- if (kind === "access") {
370
+ await fs2.mkdir(this.dataDir(), { recursive: true, mode: 448 });
371
+ await fs2.writeFile(file, token2, { mode: 384 });
372
+ await fs2.chmod(file, 384);
373
+ if (kind === "access" && mode !== "file") {
298
374
  const why = cause === void 0 ? "OS keychain unavailable" : `OS keychain refused the write (${cause instanceof Error ? cause.message : String(cause)})`;
299
375
  console.warn(`[hcm] WARNING: ${why}. Token saved to ${file} (0600).`);
300
376
  }
@@ -428,35 +504,35 @@ async function ensureSessionFresh(input) {
428
504
  }
429
505
 
430
506
  // src/config/profile.ts
431
- import * as fs2 from "fs/promises";
507
+ import * as fs3 from "fs/promises";
432
508
  import * as path2 from "path";
433
- import yaml from "js-yaml";
509
+ import yaml2 from "js-yaml";
434
510
  async function loadProfile(profile) {
435
511
  const file = profileFile(profile);
436
512
  let content;
437
513
  try {
438
- content = await fs2.readFile(file, "utf-8");
514
+ content = await fs3.readFile(file, "utf-8");
439
515
  } catch (e) {
440
516
  if (e.code === "ENOENT") {
441
517
  throw new Error(`profile '${profile}' not found at ${file}`);
442
518
  }
443
519
  throw e;
444
520
  }
445
- return yaml.load(content);
521
+ return yaml2.load(content);
446
522
  }
447
523
  async function saveProfile(profile, cfg) {
448
- await fs2.mkdir(profileDir(profile), { recursive: true });
449
- await fs2.writeFile(profileFile(profile), yaml.dump(cfg), "utf-8");
524
+ await fs3.mkdir(profileDir(profile), { recursive: true });
525
+ await fs3.writeFile(profileFile(profile), yaml2.dump(cfg), "utf-8");
450
526
  }
451
527
  async function listProfiles() {
452
528
  const root = hcmConfigDir();
453
529
  try {
454
- const entries = await fs2.readdir(root, { withFileTypes: true });
530
+ const entries = await fs3.readdir(root, { withFileTypes: true });
455
531
  const result = [];
456
532
  for (const e of entries) {
457
533
  if (e.isDirectory()) {
458
534
  try {
459
- await fs2.access(path2.join(root, e.name, "profile.yml"));
535
+ await fs3.access(path2.join(root, e.name, "profile.yml"));
460
536
  result.push(e.name);
461
537
  } catch {
462
538
  }
@@ -469,44 +545,6 @@ async function listProfiles() {
469
545
  }
470
546
  }
471
547
 
472
- // src/config/global-config.ts
473
- import * as fs3 from "fs/promises";
474
- import yaml2 from "js-yaml";
475
- var DEFAULT_ENV = "default";
476
- var DEFAULT_DEFAULTS = { output: "table", timeout: "60s" };
477
- async function loadGlobalConfig() {
478
- let raw = {};
479
- try {
480
- const content = await fs3.readFile(globalConfigFile(), "utf-8");
481
- raw = yaml2.load(content) ?? {};
482
- } catch (e) {
483
- if (e.code !== "ENOENT") throw e;
484
- }
485
- const activeEnv = raw.activeEnv ?? raw.activeProfile ?? DEFAULT_ENV;
486
- return {
487
- activeEnv,
488
- activeProfile: activeEnv,
489
- // dual-write alias
490
- defaults: { ...DEFAULT_DEFAULTS, ...raw.defaults }
491
- };
492
- }
493
- async function saveGlobalConfig(cfg) {
494
- await fs3.mkdir(hcmConfigDir(), { recursive: true });
495
- const activeEnv = cfg.activeEnv ?? cfg.activeProfile ?? DEFAULT_ENV;
496
- const out = {
497
- activeEnv,
498
- activeProfile: activeEnv,
499
- defaults: cfg.defaults
500
- };
501
- await fs3.writeFile(globalConfigFile(), yaml2.dump(out), "utf-8");
502
- }
503
- function resolveActiveEnv(args, env, global) {
504
- return args.envFlag ?? env.HCM_ENV ?? env.HCM_PROFILE ?? global.activeEnv;
505
- }
506
- function resolveActiveProfile(args, env, global) {
507
- return resolveActiveEnv({ envFlag: args.flag }, env, global);
508
- }
509
-
510
548
  // src/config/env.ts
511
549
  import * as fs4 from "fs/promises";
512
550
  import yaml3 from "js-yaml";
@@ -708,6 +746,17 @@ function formatCause(cause) {
708
746
  }
709
747
 
710
748
  // src/config/env.ts
749
+ function assertNotReservedEnvName(name) {
750
+ if (isTempEnv(name)) {
751
+ throw new CliError({
752
+ code: "INVALID_ARGUMENT" /* INVALID_ARGUMENT */,
753
+ message: `'${TEMP_ENV_NAME}' \u662F\u4E34\u65F6\u73AF\u5883\u7684\u4FDD\u7559\u540D\uFF0C\u4E0D\u80FD\u7528\u4F5C env \u540D\u5B57\u3002`,
754
+ context: {
755
+ nextStep: `\u6362\u4E2A\u540D\u5B57\uFF1B\u5982\u679C\u4F60\u662F\u60F3\u628A\u5F53\u524D\u4E34\u65F6\u73AF\u5883\u5B58\u4E0B\u6765\uFF0C\u7528: hcm env save <name>`
756
+ }
757
+ });
758
+ }
759
+ }
711
760
  async function saveEnv(name, cfg) {
712
761
  if (!cfg.endpoint) {
713
762
  throw new CliError({
@@ -822,6 +871,27 @@ async function deleteIdentity(name) {
822
871
  }
823
872
  await fs5.rm(identityDir(name), { recursive: true, force: true });
824
873
  }
874
+ async function renameIdentity(oldName, newName) {
875
+ if (oldName === newName) return;
876
+ const meta = await loadIdentity(oldName);
877
+ const clash = await loadIdentity(newName).catch(() => null);
878
+ if (clash) {
879
+ throw new CliError({
880
+ code: "IDENTITY_ALREADY_EXISTS" /* IDENTITY_ALREADY_EXISTS */,
881
+ message: `identity '${newName}' \u5DF2\u5B58\u5728\uFF0C\u4E0D\u80FD\u628A '${oldName}' \u6539\u6210\u8FD9\u4E2A\u540D\u5B57\u3002`
882
+ });
883
+ }
884
+ await fs5.rename(identityDir(oldName), identityDir(newName));
885
+ const rebase = (ref, kind) => {
886
+ if (!ref?.startsWith("file:")) return ref;
887
+ return `file:${identityMetaFile(newName)}.${kind}`;
888
+ };
889
+ await saveIdentity(newName, {
890
+ ...meta,
891
+ accessTokenRef: rebase(meta.accessTokenRef, "access"),
892
+ refreshTokenRef: rebase(meta.refreshTokenRef, "refresh")
893
+ });
894
+ }
825
895
 
826
896
  // src/config/migration.ts
827
897
  import * as fs6 from "fs/promises";
@@ -1986,14 +2056,6 @@ function toOrigin(raw) {
1986
2056
  const url = new URL(withScheme);
1987
2057
  return url.origin;
1988
2058
  }
1989
- function inferEnvName(origin) {
1990
- const host = new URL(origin).hostname;
1991
- if (/^\d+(\.\d+)*$/.test(host) || host === "localhost") return "local";
1992
- const parts = host.split(".").filter(Boolean);
1993
- if (parts.length === 0) return "default";
1994
- const candidate = parts.length >= 2 ? parts[parts.length - 2] : parts[0];
1995
- return candidate || "default";
1996
- }
1997
2059
 
1998
2060
  // src/auth/change-password.ts
1999
2061
  var PASSWORD_CHANGE_REQUIRED = "AUTH_PASSWORD_CHANGE_REQUIRED";
@@ -21990,6 +22052,7 @@ export {
21990
22052
  CODE_UNBIND_READBACK_UNREADABLE,
21991
22053
  CODE_UNBIND_REFUSED,
21992
22054
  CODE_WORDS,
22055
+ CREDENTIAL_STORE_MODES,
21993
22056
  CliError,
21994
22057
  CliErrorCode,
21995
22058
  DATA_PACKAGE_BLIND_NOTE,
@@ -22141,6 +22204,7 @@ export {
22141
22204
  STEP_UNBIND,
22142
22205
  SYNTH_FOOTNOTE,
22143
22206
  SYNTH_MARK,
22207
+ TEMP_ENV_NAME,
22144
22208
  TENANT_META_FILE_PATH,
22145
22209
  CONFIG as TRIAGE_CONFIG,
22146
22210
  GAP as TRIAGE_GAP,
@@ -22181,6 +22245,7 @@ export {
22181
22245
  archiveDir,
22182
22246
  artifactReason,
22183
22247
  askedTheDatabase,
22248
+ assertNotReservedEnvName,
22184
22249
  assertSafeReferencePath,
22185
22250
  assertSafeSkillFilePath,
22186
22251
  assertSafeSkillId,
@@ -22288,7 +22353,6 @@ export {
22288
22353
  identityKnown,
22289
22354
  identityMetaFile,
22290
22355
  inGap,
22291
- inferEnvName,
22292
22356
  inferMiniWritableTemplateOptionsFromModel,
22293
22357
  initMiniAppProject,
22294
22358
  inspectRound,
@@ -22299,6 +22363,7 @@ export {
22299
22363
  isLocalName,
22300
22364
  isReadOnly,
22301
22365
  isServerSlidingSession,
22366
+ isTempEnv,
22302
22367
  isTerminalRunStatus,
22303
22368
  isZeroNetwork,
22304
22369
  journalNote,
@@ -22369,6 +22434,7 @@ export {
22369
22434
  rebindPayload,
22370
22435
  refreshToken,
22371
22436
  remove,
22437
+ renameIdentity,
22372
22438
  renderFind,
22373
22439
  renderRound,
22374
22440
  renderTriage,
@@ -22381,6 +22447,7 @@ export {
22381
22447
  resolveAllSkillsInstallOrder,
22382
22448
  resolveBaselineDir,
22383
22449
  resolveChironBase,
22450
+ resolveCredentialStoreMode,
22384
22451
  resolveRefs,
22385
22452
  resolveSkillInstallOrder,
22386
22453
  riskFromArtifacts,