@hcmai/sdk 0.16.0 → 0.17.0

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
@@ -1511,6 +1511,9 @@ declare function startImpersonation(input: {
1511
1511
  actorUsername?: string;
1512
1512
  target: string;
1513
1513
  targetLabel?: string;
1514
+ /** Optional bounded transport for read-only diagnostics; business defaults remain 30s. */
1515
+ timeoutMs?: number;
1516
+ signal?: AbortSignal;
1514
1517
  }): Promise<ClientAuthContext>;
1515
1518
 
1516
1519
  declare function hasPendingImpersonationSessions(): boolean;
@@ -3427,25 +3430,6 @@ declare class LayoutContainmentError extends Error {
3427
3430
  constructor(message: string);
3428
3431
  }
3429
3432
 
3430
- type DoctorAnchor = 'connectivity' | 'identity' | 'config-admin' | 'layer' | 'websocket-handshake';
3431
- /** 五条锚点的顺序固定,REST 连通不能替对话握手背书。 */
3432
- declare const DOCTOR_ANCHORS: readonly DoctorAnchor[];
3433
- interface DoctorCheck {
3434
- anchor: DoctorAnchor;
3435
- ok: boolean;
3436
- detail: string;
3437
- nextStep?: string;
3438
- httpStatus?: number;
3439
- handshakeAuthError?: string;
3440
- }
3441
- interface DoctorReport {
3442
- ok: boolean;
3443
- checks: DoctorCheck[];
3444
- }
3445
- /**
3446
- * 登录身份。`null` 表示**本工具没有经手登录**——那与「登录了但服务端没给 user」
3447
- * 是两种状态,处置不同,不许合并。
3448
- */
3449
3433
  interface ReconIdentity {
3450
3434
  /** token 实际归属的租户(服务端登录响应里的 `user.tenantId`)。 */
3451
3435
  tenantId?: string;
@@ -3454,7 +3438,20 @@ interface ReconIdentity {
3454
3438
  username?: string;
3455
3439
  roles?: string[];
3456
3440
  }
3457
- declare function runDoctor(probe: ReconProbe, identity: ReconIdentity | null, handshake?: () => Promise<void>): Promise<DoctorReport>;
3441
+ declare function probeDoctorEndpoint(probe: ReconProbe, kind: 'version' | 'identity' | 'config-admin' | 'health-api' | 'exposure'): Promise<Outcome>;
3442
+ declare function probeDoctorLayer(probe: ReconProbe): Promise<{
3443
+ models: Outcome;
3444
+ layer: null;
3445
+ } | {
3446
+ models: Outcome;
3447
+ layer: ProbeResult;
3448
+ }>;
3449
+ declare function layerDetail(p: {
3450
+ sourceKey: string;
3451
+ probeModelKey: string;
3452
+ attempted: number;
3453
+ answered: number;
3454
+ }, connected: boolean): string;
3458
3455
  /** `GET /api/auth/info` —— 服务端认定的 token 归属从这里来。 */
3459
3456
  declare const AUTH_INFO_PATH = "/api/auth/info";
3460
3457
  /**
@@ -6490,12 +6487,35 @@ interface JiraTokenSource {
6490
6487
  token: string;
6491
6488
  from: string;
6492
6489
  }
6490
+ type JiraTokenLookup = {
6491
+ kind: 'token';
6492
+ source: JiraTokenSource;
6493
+ } | {
6494
+ kind: 'missing';
6495
+ noKeychain: boolean;
6496
+ }
6497
+ /** 读不到≠没有:`where` 说清卡在令牌文件还是钥匙串,下一步各不相同。 */
6498
+ | {
6499
+ kind: 'unreadable';
6500
+ where: 'file' | 'keychain';
6501
+ reason: 'timeout' | 'error';
6502
+ };
6493
6503
  /**
6494
6504
  * 令牌:环境变量 → 文件 → 钥匙串。
6495
6505
  * 🔴 只判「拿不拿得到」与「从哪来」,绝不回传到输出里。文件对其他用户可读时明说但不拦——
6496
6506
  * 拦了使用者只会把令牌塞进更差的地方。
6497
6507
  */
6498
- declare function jiraTokenSource(): Promise<JiraTokenSource | null>;
6508
+ declare function jiraTokenSource(opts?: {
6509
+ keychainTimeoutMs?: number;
6510
+ }): Promise<JiraTokenLookup>;
6511
+ /** 令牌读不到时的一句话与下一步:令牌文件与钥匙串分开说,不把文件读错指向「解锁钥匙串」。 */
6512
+ declare function jiraTokenUnreadable(l: {
6513
+ where: 'file' | 'keychain';
6514
+ reason: 'timeout' | 'error';
6515
+ }): {
6516
+ reason: string;
6517
+ nextStep: string;
6518
+ };
6499
6519
  declare function jiraTokenHelp(): string;
6500
6520
  interface JiraUser {
6501
6521
  name?: string;
@@ -6737,4 +6757,4 @@ type ParsedRef = {
6737
6757
  declare function parseRef(raw: string, project: string, casesSlug?: string): ParsedRef | null;
6738
6758
  declare const firstLine: (s: string) => string;
6739
6759
 
6740
- export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, type ActionEffectClass, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, type BrowserAuthorization, type BrowserAuthorizationWatch, type BrowserStatusProbe, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_STATUS_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, CONTROL_BUFFER_LIMIT, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationRejection, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EndpointNormalization, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldEnumValue, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_CONVERSATION_QUERY_PARAM, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_FIELD_RAW_KEYS, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionDecision, type InteractionOutcome, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, JiraHttpError, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, JiraNonBmpContentError, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraTransitionField, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, type KeyResolution, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, METHOD_REPO_DISPLAY, METHOD_REPO_SLUG, METHOD_REPO_URL, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NON_BMP_RULE_NOTE, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, type NonBmpHit, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PendingInteraction, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, REJECTED_BEFORE_ROUTING_CODE, REQUIRED_SECTIONS, RESPOND_TIMEOUT_MS, RESTORE_CODES, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, SERVER_ERROR_GRACE_MS, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type ServerErrorFrame, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TenantResetReceipt, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type UndeterminedReason, type V4RenderSink, type V4StreamEventType, VALUE_CELL_MISSING, VALUE_FOOTNOTE, VALUE_STATE_DISABLED, VALUE_STATE_FOOTNOTE, VALUE_STATE_UNKNOWN, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, assertUsableEndpoint, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describeNonBmpHits, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, diagnoseRejectedBeforeRouting, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, findNonBmpChars, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listPendingInteractions, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, nonBmpHitLines, normalizeAndAssertEndpoint, normalizeEndpoint, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resetTenant, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveItemKeys, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, respondToInteraction, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, watchBrowserAuthorization, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
6760
+ export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, type ActionEffectClass, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, type BrowserAuthorization, type BrowserAuthorizationWatch, type BrowserStatusProbe, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_STATUS_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, CONTROL_BUFFER_LIMIT, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationRejection, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EndpointNormalization, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldEnumValue, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_CONVERSATION_QUERY_PARAM, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_FIELD_RAW_KEYS, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionDecision, type InteractionOutcome, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, JiraHttpError, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, JiraNonBmpContentError, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenLookup, type JiraTokenSource, type JiraTransition, type JiraTransitionField, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, type KeyResolution, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, METHOD_REPO_DISPLAY, METHOD_REPO_SLUG, METHOD_REPO_URL, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NON_BMP_RULE_NOTE, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, type NonBmpHit, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PendingInteraction, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, REJECTED_BEFORE_ROUTING_CODE, REQUIRED_SECTIONS, RESPOND_TIMEOUT_MS, RESTORE_CODES, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, SERVER_ERROR_GRACE_MS, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type ServerErrorFrame, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TenantResetReceipt, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type UndeterminedReason, type V4RenderSink, type V4StreamEventType, VALUE_CELL_MISSING, VALUE_FOOTNOTE, VALUE_STATE_DISABLED, VALUE_STATE_FOOTNOTE, VALUE_STATE_UNKNOWN, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, assertUsableEndpoint, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describeNonBmpHits, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, diagnoseRejectedBeforeRouting, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, findNonBmpChars, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, jiraTokenUnreadable, journalNote, judgeDrift, layerDetail, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listPendingInteractions, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, nonBmpHitLines, normalizeAndAssertEndpoint, normalizeEndpoint, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeDoctorEndpoint, probeDoctorLayer, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resetTenant, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveItemKeys, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, respondToInteraction, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, watchBrowserAuthorization, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
package/dist/index.js CHANGED
@@ -3079,7 +3079,8 @@ async function startImpersonation(input) {
3079
3079
  }
3080
3080
  const http = axios4.create({
3081
3081
  baseURL: input.actor.endpoint,
3082
- timeout: 3e4,
3082
+ timeout: input.timeoutMs ?? 3e4,
3083
+ ...input.signal ? { signal: input.signal } : {},
3083
3084
  headers: { Authorization: `Bearer ${input.accessToken}` }
3084
3085
  });
3085
3086
  const principal = await readSessionPrincipal(http);
@@ -3133,15 +3134,46 @@ async function startImpersonation(input) {
3133
3134
  }
3134
3135
  targetUserId = row.id;
3135
3136
  }
3136
- const { data } = await http.post(IMPERSONATION_START_PATH, { targetUserId });
3137
+ let data;
3138
+ try {
3139
+ ({ data } = await http.post(IMPERSONATION_START_PATH, { targetUserId }));
3140
+ } catch (error) {
3141
+ if ((input.timeoutMs !== void 0 || input.signal) && axios4.isAxiosError(error) && ["ERR_CANCELED", "ECONNABORTED", "ETIMEDOUT"].includes(error.code ?? "")) {
3142
+ throw new CliError({
3143
+ code: "NETWORK_ERROR" /* NETWORK_ERROR */,
3144
+ message: "\u4EE3\u7406\u7B7E\u53D1\u8BF7\u6C42\u88AB\u4E2D\u6B62\u6216\u8D85\u65F6\uFF1B\u670D\u52A1\u7AEF\u53EF\u80FD\u5DF2\u7B7E\u53D1\uFF0C\u5BA2\u6237\u7AEF\u672A\u53D6\u5F97\u4F1A\u8BDD\uFF0C\u65E0\u6CD5\u4E3B\u52A8\u6536\u5C3E\uFF0C\u670D\u52A1\u7AEF\u6309\u6709\u6548\u671F\u81EA\u7136\u8FC7\u671F",
3145
+ context: { issuance: "unconfirmed", nextStep: "\u68C0\u67E5\u7F51\u7EDC\u4E0E\u670D\u52A1\u7AEF\u4EE3\u7406\u4F1A\u8BDD\u72B6\u6001\uFF1B\u4E0D\u8981\u81EA\u52A8\u91CD\u8BD5\u7B7E\u53D1" }
3146
+ });
3147
+ }
3148
+ throw error;
3149
+ }
3137
3150
  if (data?.impersonationToken === input.accessToken) {
3138
3151
  throw protocolError("\u4EE3\u7406\u63A5\u53E3\u8FD4\u56DE\u4E86\u7BA1\u7406\u5458\u539F\u51ED\u636E\uFF0C\u5DF2\u62D2\u7EDD\u4F7F\u7528\u4E0E\u6CE8\u9500\u8BE5\u51ED\u636E");
3139
3152
  }
3140
- const closeEphemeralSession = typeof data?.impersonationToken === "string" && data.impersonationToken ? registerImpersonationSession(input.actor.endpoint, data.impersonationToken, async (tokenPrefix) => {
3141
- const { data: active } = await http.get(IMPERSONATION_ACTIVE_PATH);
3142
- if (!Array.isArray(active)) return false;
3153
+ let quotaUnverified = false;
3154
+ const release = typeof data?.impersonationToken === "string" && data.impersonationToken ? registerImpersonationSession(input.actor.endpoint, data.impersonationToken, async (tokenPrefix) => {
3155
+ const cleanupHttp = input.timeoutMs !== void 0 || input.signal ? axios4.create({
3156
+ baseURL: input.actor.endpoint,
3157
+ timeout: 5e3,
3158
+ headers: { Authorization: `Bearer ${input.accessToken}` }
3159
+ }) : http;
3160
+ let active;
3161
+ try {
3162
+ ({ data: active } = await cleanupHttp.get(IMPERSONATION_ACTIVE_PATH));
3163
+ } catch (error) {
3164
+ quotaUnverified = true;
3165
+ throw error;
3166
+ }
3167
+ if (!Array.isArray(active)) {
3168
+ quotaUnverified = true;
3169
+ return false;
3170
+ }
3143
3171
  return active.some((row) => !!row && typeof row === "object" && row.tokenPrefix === tokenPrefix);
3144
3172
  }) : void 0;
3173
+ const closeEphemeralSession = release && (input.timeoutMs !== void 0 || input.signal) ? async () => {
3174
+ await release();
3175
+ if (quotaUnverified) throw new CliError({ code: "NETWORK_ERROR" /* NETWORK_ERROR */, message: "\u4EE3\u7406\u6CE8\u9500\u5DF2\u8BF7\u6C42\uFF0C\u4F46\u9000\u51FA\u540E\u914D\u989D\u590D\u6838\u672A\u786E\u8BA4", context: { cleanup: "unconfirmed" } });
3176
+ } : release;
3145
3177
  if (!data || typeof data.impersonationToken !== "string" || !data.impersonationToken || data.targetUser?.id !== targetUserId || typeof data.targetUser?.username !== "string" || !data.targetUser.username || typeof data.expiresAt !== "string" || !Number.isFinite(Date.parse(data.expiresAt)) || Date.parse(data.expiresAt) <= Date.now()) {
3146
3178
  const failure = protocolError("\u4EE3\u7406\u63A5\u53E3\u672A\u8FD4\u56DE\u6709\u6548 token / \u76EE\u6807\u7528\u6237 / expiresAt\uFF0C\u5DF2\u505C\u6B62\u672C\u6B21\u547D\u4EE4");
3147
3179
  try {
@@ -11208,95 +11240,21 @@ var LayoutContainmentError = class extends Error {
11208
11240
  };
11209
11241
 
11210
11242
  // src/fde/doctor.ts
11211
- var DOCTOR_ANCHORS = [
11212
- "connectivity",
11213
- "identity",
11214
- "config-admin",
11215
- "layer",
11216
- "websocket-handshake"
11217
- ];
11218
- async function runDoctor(probe, identity, handshake) {
11219
- const checks = [];
11220
- const modelsOut = await probe.get(MODELS_PATH);
11221
- const connected = modelsOut.error === "ok";
11222
- const modelsBody = isObj(modelsOut.body) ? modelsOut.body : {};
11223
- checks.push({
11224
- anchor: "connectivity",
11225
- ok: connected,
11226
- detail: connected ? `\u6A21\u578B\u6E05\u5355\u53EF\u8FBE\uFF0C\u5171 ${modelsBody.totalCount ?? 0} \u4E2A\u6A21\u578B` : `\u4E0D\u53EF\u8FBE\uFF1A${modelsOut.error}\uFF08status=${modelsOut.status ?? "?"}\uFF09`
11227
- });
11228
- const keys = modelKeys(modelsOut.body);
11229
- const p = await probeExtensionSource(probe, keys);
11230
- checks.push({ anchor: "identity", ...judgeIdentity(identity) });
11231
- const manifestOut = await probe.get(MANIFEST_PATH, { page: 0, pageSize: 1 });
11232
- const caOk = manifestOut.error === "ok";
11233
- const manifestBody = isObj(manifestOut.body) ? manifestOut.body : {};
11234
- const total = caOk ? manifestBody.total ?? "?" : "?";
11235
- let caDetail;
11236
- if (caOk) {
11237
- caDetail = `\u79DF\u6237 meta \u6E05\u5355\u53EF\u8BFB\uFF0C\u5171 ${total} \u6761\uFF080 \u6761\u662F\u5408\u6CD5\u72B6\u6001\uFF1A\u514B\u9686\u5E93\u5E26\u5F97\u8D70 workspace \u7ED1\u5B9A\uFF0C\u5E26\u4E0D\u8D70 workspace \u6587\u4EF6\uFF09`;
11238
- } else if (manifestOut.status === 401 || manifestOut.status === 403) {
11239
- caDetail = `HTTP ${manifestOut.status}\uFF1A\u5F53\u524D\u8D26\u53F7**\u6CA1\u6709 configAdmin \u6743\u9650**\u3002\u627E\u5BA2\u6237\u7BA1\u7406\u5458\u52A0\u89D2\u8272\uFF1B\u8FD9\u4E0D\u662F\u7F51\u7EDC\u95EE\u9898`;
11240
- } else {
11241
- caDetail = `\u4E0D\u53EF\u8BFB\uFF1A${manifestOut.error}\uFF08status=${manifestOut.status ?? "?"}\uFF09\u3002\u5148\u6392\u8FDE\u901A/\u7F51\u5173\uFF0C\u518D\u8C08\u6743\u9650\u3002\u7F3A configAdmin \u65F6\u4E3B\u951A\u70B9\u7B97\u4E0D\u51FA\u6765`;
11242
- }
11243
- checks.push({ anchor: "config-admin", ok: caOk, detail: caDetail });
11244
- checks.push({
11245
- anchor: "layer",
11246
- ok: Boolean(p.sourceKey),
11247
- detail: layerDetail(p, connected)
11248
- });
11249
- try {
11250
- if (!handshake) throw new Error("\u672A\u63D0\u4F9B WebSocket \u63E1\u624B\u63A2\u9488\uFF0C\u65E0\u6CD5\u5224\u65AD hcm chat \u7684\u63E1\u624B\u5165\u53E3\u662F\u5426\u53EF\u7528\uFF08\u672A\u6267\u884C\uFF09");
11251
- await handshake();
11252
- checks.push({
11253
- anchor: "websocket-handshake",
11254
- ok: true,
11255
- httpStatus: 101,
11256
- detail: "WebSocket HTTP 101\uFF1A\u5F53\u524D\u8EAB\u4EFD\u7684\u5BF9\u8BDD\u63E1\u624B\u901A\u8FC7\uFF0C\u8FDE\u63A5\u5DF2\u5173\u95ED\uFF08\u53EA\u9A8C\u8BC1\u63E1\u624B\uFF09",
11257
- nextStep: "hcm chat \u7684\u63E1\u624B\u5165\u53E3\u53EF\u7528\uFF1B\u4F1A\u8BDD\u8BA4\u8BC1\u3001\u6743\u9650\u4E0E\u6A21\u578B\u54CD\u5E94\u4ECD\u9700\u5B9E\u9645\u8FD0\u884C hcm chat \u9A8C\u8BC1"
11258
- });
11259
- } catch (error) {
11260
- const context = error instanceof CliError ? error.context : void 0;
11261
- checks.push({
11262
- anchor: "websocket-handshake",
11263
- ok: false,
11264
- detail: error instanceof Error ? error.message : String(error),
11265
- ...typeof context?.httpStatus === "number" ? { httpStatus: context.httpStatus } : {},
11266
- ...typeof context?.handshakeAuthError === "string" ? { handshakeAuthError: context.handshakeAuthError } : {},
11267
- nextStep: "hcm chat \u7684\u63E1\u624B\u5165\u53E3\u4E0D\u53EF\u7528\uFF1B" + (typeof context?.nextStep === "string" ? context.nextStep : "\u5148\u68C0\u67E5\u7F51\u7EDC\u4E0E\u5F53\u524D\u767B\u5F55\u8EAB\u4EFD\uFF0C\u518D\u8FD0\u884C hcm chiron doctor\uFF1B\u672C\u9879\u53EA\u9A8C\u8BC1\u63E1\u624B")
11268
- });
11269
- }
11270
- return { ok: checks.every((c) => c.ok), checks };
11271
- }
11272
- function judgeIdentity(ident) {
11273
- if (ident === null) {
11274
- return { ok: false, detail: "\u672A\u7ECF\u672C\u5DE5\u5177\u767B\u5F55\uFF0C\u65E0\u6CD5\u6838\u5BF9 token \u5F52\u5C5E\u7684\u79DF\u6237" };
11275
- }
11276
- const want = String(ident.requestedTenantId ?? "").trim();
11277
- const got = String(ident.tenantId ?? "").trim();
11278
- if (!want) {
11279
- return {
11280
- ok: false,
11281
- detail: `\u672C\u5DE5\u5177\u6CA1\u6709\u8BB0\u4E0B\u300C\u4F60\u8981\u7684\u79DF\u6237\u300D\uFF08\u547D\u4EE4\u5C42\u672A\u586B requestedTenantId\uFF09\uFF0C\u65E0\u6CD5\u4E0E token \u5F52\u5C5E\u7684\u79DF\u6237 ${got || "(\u672A\u77E5)"} \u6838\u5BF9 \u2014\u2014 \u8FD9\u662F\u5DE5\u5177\u63A5\u7EBF\u95EE\u9898\uFF0C\u4E0D\u662F\u73AF\u5883\u95EE\u9898`
11282
- };
11283
- }
11284
- if (!got) {
11285
- return {
11286
- ok: false,
11287
- detail: `\u670D\u52A1\u7AEF\u767B\u5F55\u54CD\u5E94\u91CC\u6CA1\u6709 user.tenantId\uFF0C\u65E0\u6CD5\u6838\u5BF9\uFF08\u4F60\u8981\u7684\u662F ${want}\uFF09`
11288
- };
11289
- }
11290
- if (want !== got) {
11291
- return {
11292
- ok: false,
11293
- detail: `\u{1F534} **token \u5F52\u5C5E\u79DF\u6237 ${got}\uFF0C\u800C\u4F60\u8981\u7684\u662F ${want}** \u2014\u2014 \u4F60\u6B63\u5728\u722C\u53E6\u4E00\u4E2A\u79DF\u6237\uFF0C\u5148\u505C\u4E0B\u6765\u3002\u8FD9\u4E00\u5BF9\u8EAB\u4EFD\u4F1A\u968F\u8EAB\u4EFD\u6BB5\u843D\u8FDB\u4EA7\u7269\u7D22\u5F15\uFF0C\u6240\u4EE5\u722C\u5B8C\u4E4B\u540E\u5728\u4EA7\u7269\u91CC\u4E5F\u5BF9\u5F97\u51FA\u6765\uFF1B\u4F46**\u843D\u76D8\u8DEF\u5F84**\u4E0A\u90A3\u4E2A\u79DF\u6237\u6BB5\u53D6\u81EA\u4F60\u7ED9\u7684 \`--tenant\` \u2014\u2014 \u76EE\u5F55\u540D\u7167\u65E7\u662F\u4F60\u8981\u7684\u90A3\u4E2A\u53F7\u3002`
11294
- };
11295
- }
11296
- return {
11297
- ok: true,
11298
- detail: `\u79DF\u6237 ${got} \u6838\u5BF9\u4E00\u81F4\uFF1B\u767B\u5F55\u8EAB\u4EFD ${ident.username || "(\u672A\u77E5)"}\uFF0C\u89D2\u8272 ${JSON.stringify(ident.roles ?? [])}`
11243
+ function probeDoctorEndpoint(probe, kind) {
11244
+ const paths = {
11245
+ version: VERSION_PATH,
11246
+ identity: AUTH_INFO_PATH,
11247
+ "config-admin": MANIFEST_PATH,
11248
+ "health-api": "/api/system/health/checks",
11249
+ exposure: "/actuator/health"
11299
11250
  };
11251
+ return probe.get(paths[kind], kind === "config-admin" ? { page: 0, pageSize: 1 } : void 0);
11252
+ }
11253
+ async function probeDoctorLayer(probe) {
11254
+ const models = await probe.get(MODELS_PATH);
11255
+ if (models.error !== "ok") return { models, layer: null };
11256
+ const layer = await probeExtensionSource(probe, modelKeys(models.body));
11257
+ return { models, layer };
11300
11258
  }
11301
11259
  function layerDetail(p, connected) {
11302
11260
  if (p.sourceKey) {
@@ -11310,9 +11268,6 @@ function layerDetail(p, connected) {
11310
11268
  }
11311
11269
  return `\u8BD5\u4E86 ${p.attempted} \u4E2A\u6A21\u578B\u7684 meta\uFF0C**\u4E00\u4E2A\u90FD\u6CA1\u7B54\u5E94** \u21D2 \u5148\u67E5\u8FDE\u901A\u4E0E\u6743\u9650\uFF0C\u518D\u770B\u6A21\u578B\u6E05\u5355\u662F\u4E0D\u662F\u7A7A\u7684\u3002\u26A0\uFE0F \u672C\u5DE5\u5177\u53EA\u77E5\u9053\u300C\u4E00\u4E2A\u90FD\u6CA1\u7B54\u5E94\u300D\uFF0C**\u5206\u4E0D\u51FA**\u662F\u8FDE\u901A\u3001\u6743\u9650\u8FD8\u662F\u4E2D\u95F4\u6709\u4EBA\u6321\u4E86 \u2014\u2014 \u4E0A\u4E00\u6863\uFF08\u7B54\u5E94\u4E86\u4F46\u6CA1\u56DE\u663E X-HCM-* \u5934\uFF09\u624D\u6307\u5F97\u52A8\u53CD\u4EE3\uFF0C\u8FD9\u4E00\u6863\u6307\u4E0D\u52A8\u4EFB\u4F55\u4E00\u65B9`;
11312
11270
  }
11313
- function isObj(v) {
11314
- return typeof v === "object" && v !== null && !Array.isArray(v);
11315
- }
11316
11271
  var AUTH_INFO_PATH = "/api/auth/info";
11317
11272
  async function fetchReconIdentity(probe, requestedTenantId) {
11318
11273
  const out = await probe.get(AUTH_INFO_PATH);
@@ -22363,7 +22318,8 @@ var repoIssueUrl = (repo, number) => `${CNB_ORIGIN}/${repo}/-/issues/${number}`;
22363
22318
  var CNB_FAVICON_URL = `${CNB_ORIGIN}/favicon.ico`;
22364
22319
 
22365
22320
  // src/jira/client.ts
22366
- import { execFileSync } from "child_process";
22321
+ import { execFile } from "child_process";
22322
+ import { promisify } from "util";
22367
22323
  import { promises as fs12 } from "fs";
22368
22324
  import os4 from "os";
22369
22325
  import path23 from "path";
@@ -22451,8 +22407,8 @@ var JiraNonBmpContentError = class extends Error {
22451
22407
 
22452
22408
  // src/jira/client.ts
22453
22409
  var JIRA_TOKEN_FILE = () => process.env.JIRA_TOKEN_FILE || path23.join(os4.homedir(), ".config", "hcm", "jira-token");
22454
- async function jiraTokenSource() {
22455
- if (process.env.JIRA_TOKEN?.trim()) return { token: process.env.JIRA_TOKEN.trim(), from: "\u73AF\u5883\u53D8\u91CF JIRA_TOKEN" };
22410
+ async function jiraTokenSource(opts = {}) {
22411
+ if (process.env.JIRA_TOKEN?.trim()) return { kind: "token", source: { token: process.env.JIRA_TOKEN.trim(), from: "\u73AF\u5883\u53D8\u91CF JIRA_TOKEN" } };
22456
22412
  const file = JIRA_TOKEN_FILE();
22457
22413
  try {
22458
22414
  const stat = await fs12.stat(file);
@@ -22460,19 +22416,30 @@ async function jiraTokenSource() {
22460
22416
  if (value) {
22461
22417
  if (stat.mode & 63) process.stderr.write(`[jira] \u8B66\u544A\uFF1A${file} \u5BF9\u5176\u4ED6\u7528\u6237\u53EF\u8BFB\uFF08chmod 600 \u6536\u7D27\uFF09
22462
22418
  `);
22463
- return { token: value, from: file };
22419
+ return { kind: "token", source: { token: value, from: file } };
22464
22420
  }
22465
- } catch {
22421
+ } catch (e) {
22422
+ if (e.code !== "ENOENT") return { kind: "unreadable", where: "file", reason: "error" };
22466
22423
  }
22467
22424
  try {
22468
- const out = execFileSync("security", ["find-generic-password", "-s", JIRA_KEYCHAIN, "-w"], {
22425
+ const pending2 = promisify(execFile)("security", ["find-generic-password", "-s", JIRA_KEYCHAIN, "-w"], {
22469
22426
  encoding: "utf8",
22470
- stdio: ["ignore", "pipe", "ignore"]
22471
- }).trim();
22472
- if (out) return { token: out, from: `\u94A5\u5319\u4E32 ${JIRA_KEYCHAIN}` };
22473
- } catch {
22427
+ timeout: opts.keychainTimeoutMs ?? 5e3
22428
+ });
22429
+ pending2.child.stdin?.end();
22430
+ const { stdout } = await pending2;
22431
+ if (stdout.trim()) return { kind: "token", source: { token: stdout.trim(), from: `\u94A5\u5319\u4E32 ${JIRA_KEYCHAIN}` } };
22432
+ return { kind: "missing", noKeychain: false };
22433
+ } catch (e) {
22434
+ const error = e;
22435
+ if (error.code === "ENOENT") return { kind: "missing", noKeychain: true };
22436
+ if (error.code === 44) return { kind: "missing", noKeychain: false };
22437
+ if (error.killed || error.signal === "SIGTERM" || error.code === "ETIMEDOUT") return { kind: "unreadable", where: "keychain", reason: "timeout" };
22438
+ return { kind: "unreadable", where: "keychain", reason: "error" };
22474
22439
  }
22475
- return null;
22440
+ }
22441
+ function jiraTokenUnreadable(l) {
22442
+ return l.where === "file" ? { reason: `\u4EE4\u724C\u6587\u4EF6 ${JIRA_TOKEN_FILE()} \u8BFB\u4E0D\u5230\uFF08\u51FA\u9519\uFF09`, nextStep: "\u68C0\u67E5\u5B83\u662F\u4E0D\u662F\u6743\u9650 600 \u7684\u666E\u901A\u6587\u4EF6\uFF0C\u6216\u6539\u7528\u73AF\u5883\u53D8\u91CF JIRA_TOKEN" } : { reason: `\u94A5\u5319\u4E32\u8BFB\u4E0D\u5230\uFF08${l.reason === "timeout" ? "\u8D85\u65F6" : "\u51FA\u9519"}\uFF09`, nextStep: "\u89E3\u9501\u94A5\u5319\u4E32\u540E\u91CD\u8BD5\uFF0C\u6216\u6539\u7528\u73AF\u5883\u53D8\u91CF JIRA_TOKEN" };
22476
22443
  }
22477
22444
  function jiraTokenHelp() {
22478
22445
  return `\u62FF\u4E0D\u5230 Jira \u4EE4\u724C\u3002next_step=\u5148\u5728 ${JIRA_BASE} \u53F3\u4E0A\u89D2\u5934\u50CF \u2192 \u4E2A\u4EBA\u8BBE\u7F6E \u2192 Personal Access Tokens \u5EFA\u4E00\u4E2A\uFF0C\u518D\u9009\u4E00\u79CD\u5B58\u6CD5\uFF08\u90FD\u4E0D\u4F1A\u8FDB\u4ED3\u5E93\uFF09\uFF1A
@@ -22671,9 +22638,13 @@ function fieldByName(typeMeta, name) {
22671
22638
  return (typeMeta.fields ?? []).find((f) => f.name === name) ?? null;
22672
22639
  }
22673
22640
  async function createJiraClient(opts = {}) {
22674
- const src = opts.token ? { token: opts.token, from: "\u53C2\u6570" } : await jiraTokenSource();
22675
- if (!src) throw new Error(jiraTokenHelp());
22676
- return new JiraClient({ ...opts, token: src.token });
22641
+ const lookup = opts.token ? { kind: "token", source: { token: opts.token, from: "\u53C2\u6570" } } : await jiraTokenSource();
22642
+ if (lookup.kind === "unreadable") {
22643
+ const t = jiraTokenUnreadable(lookup);
22644
+ throw new Error(`Jira ${t.reason}\u3002next_step=${t.nextStep}`);
22645
+ }
22646
+ if (lookup.kind === "missing") throw new Error(jiraTokenHelp());
22647
+ return new JiraClient({ ...opts, token: lookup.source.token });
22677
22648
  }
22678
22649
 
22679
22650
  // src/jira/refs.ts
@@ -22769,7 +22740,6 @@ export {
22769
22740
  PREMISE_CODES4 as DELIVERY_PREMISE_CODES,
22770
22741
  DEV_MODE_PATH,
22771
22742
  DIMENSION_LABELS,
22772
- DOCTOR_ANCHORS,
22773
22743
  DRY_RUN_NOTE,
22774
22744
  DRY_RUN_TAIL,
22775
22745
  DriftDetected,
@@ -23069,8 +23039,10 @@ export {
23069
23039
  isZeroNetwork,
23070
23040
  jiraTokenHelp,
23071
23041
  jiraTokenSource,
23042
+ jiraTokenUnreadable,
23072
23043
  journalNote,
23073
23044
  judgeDrift,
23045
+ layerDetail,
23074
23046
  ledgerOnlySignpost,
23075
23047
  linkedRepoRefs,
23076
23048
  listEnvs,
@@ -23133,6 +23105,8 @@ export {
23133
23105
  printResolvedEnvironment,
23134
23106
  probeAll,
23135
23107
  probeConversationHandshake,
23108
+ probeDoctorEndpoint,
23109
+ probeDoctorLayer,
23136
23110
  probeExtensionSource,
23137
23111
  profileDir,
23138
23112
  profileFile,
@@ -23176,7 +23150,6 @@ export {
23176
23150
  roundAge,
23177
23151
  roundWarning,
23178
23152
  runActiveVerify,
23179
- runDoctor,
23180
23153
  runImport,
23181
23154
  runMetaChange,
23182
23155
  runMiniSmokeChecks,