@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 +78 -9
- package/dist/index.js +136 -69
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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
|
|
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
|
|
181
|
-
await
|
|
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
|
|
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
|
|
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
|
|
337
|
+
await fs2.rm(meta.refreshTokenRef.slice("file:".length), { force: true });
|
|
263
338
|
}
|
|
264
339
|
if (!this.isIdentity) {
|
|
265
|
-
await
|
|
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
|
|
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
|
|
296
|
-
await
|
|
297
|
-
|
|
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
|
|
507
|
+
import * as fs3 from "fs/promises";
|
|
432
508
|
import * as path2 from "path";
|
|
433
|
-
import
|
|
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
|
|
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
|
|
521
|
+
return yaml2.load(content);
|
|
446
522
|
}
|
|
447
523
|
async function saveProfile(profile, cfg) {
|
|
448
|
-
await
|
|
449
|
-
await
|
|
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
|
|
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
|
|
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,
|