@hcmai/sdk 0.15.1 → 0.15.3

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
@@ -1,4 +1,5 @@
1
1
  import { AxiosInstance } from 'axios';
2
+ import { IncomingMessage } from 'node:http';
2
3
 
3
4
  interface EnvironmentSafety {
4
5
  name: string;
@@ -506,6 +507,13 @@ declare enum CliErrorCode {
506
507
  AUTH_EXPIRED = "AUTH_EXPIRED",
507
508
  AUTH_REFRESH_FAILED = "AUTH_REFRESH_FAILED",
508
509
  WS_AUTH_ERROR = "WS_AUTH_ERROR",
510
+ /**
511
+ * WebSocket 的 HTTP Upgrade 握手就被服务端以 401/403 拒了——连接根本没建起来,
512
+ * 还没到连后 `auth` 消息那一步(那一步被拒才是 WS_AUTH_ERROR)。两者分开:
513
+ * 前者是「token 没送到 / 被网关剥掉 / 握手拦截器不认」,后者是「token 本身不对」。
514
+ * HCMNX-25:生产档要求握手带 token,CLI 一直没带,报出来的却是 NETWORK_ERROR。
515
+ */
516
+ WS_HANDSHAKE_REJECTED = "WS_HANDSHAKE_REJECTED",
509
517
  SCOPE_FORBIDDEN = "SCOPE_FORBIDDEN",
510
518
  BUSINESS_RULE_VIOLATION = "BUSINESS_RULE_VIOLATION",
511
519
  MODEL_NOT_FOUND = "MODEL_NOT_FOUND",
@@ -1505,6 +1513,35 @@ interface WsClientOpts {
1505
1513
  onTokenExpiring?: () => Promise<void>;
1506
1514
  heartbeatMs?: number;
1507
1515
  }
1516
+ /**
1517
+ * 握手阶段带 token 的两个落点,都是 Core `SecurityProperties.WebSocket` 定的:
1518
+ * - query 参数名 = `tokenQueryParam`(默认 `token`,application-prod.yml 也显式钉成 `token`)
1519
+ * - `Authorization: Bearer` = `allowAuthorizationHeader`(默认 true,javadoc 写明「非浏览器客户端」)
1520
+ *
1521
+ * 🔴 生产档 `require-handshake-token: true`:HTTP Upgrade 请求里两处都没有 token,
1522
+ * `WebSocketHandshakeAuthInterceptor` 直接回 401 + `X-WebSocket-Auth-Error: missing_token`,
1523
+ * 连接根本建不起来,连后那条 `auth` 消息永远发不出去。HCMNX-25 的 401 就是这一条:
1524
+ * 本地开发档默认 false,所以训练期一直没露;cnpc-demo 跑生产档,第一次打就 401。
1525
+ * 两处同时带:query 是浏览器前端走通了生产网关的那条路,头是 Core 给非浏览器客户端设计的那条路,
1526
+ * 网关剥掉任何一处另一处仍在。
1527
+ */
1528
+ declare const HANDSHAKE_TOKEN_QUERY_PARAM = "token";
1529
+ /** Core 拒绝握手时写的响应头,值是拒绝原因码;网关拒的响应里没有它——这是分辨「谁拒的」的唯一指纹。 */
1530
+ declare const HANDSHAKE_AUTH_ERROR_HEADER = "x-websocket-auth-error";
1531
+ /** 把 token 放进握手 URL 的 query;endpoint 自带的 query(如 locale)原样保留。 */
1532
+ declare function buildHandshakeUrl(endpoint: string, token: string): string;
1533
+ /** 对话入口由交互 chat、单次 chat 与 doctor 共用,保留部署的路径前缀。 */
1534
+ declare function conversationWebSocketEndpoint(endpoint: string): string;
1535
+ /** 只核 HTTP Upgrade;收到 101 就关闭,不发送 auth 消息、不创建会话。 */
1536
+ declare function probeConversationHandshake(opts: Pick<WsClientOpts, 'endpoint' | 'getAccessToken'> & {
1537
+ timeoutMs?: number;
1538
+ }): Promise<void>;
1539
+ /**
1540
+ * 非 101 的握手响应 → 可判断下一步的错误。ws 库默认只给一句 `Unexpected server response: 401`,
1541
+ * 状态码、拒绝原因头、traceId、响应体全在 res 上却一个都不露(HCMNX-25 顾问两次现场只能写 NETWORK_ERROR)。
1542
+ * 401/403 归 WS_HANDSHAKE_REJECTED(退出码 2,认证类);其余状态仍是网络/网关类(退出码 4)。
1543
+ */
1544
+ declare function handshakeRejectedError(res: IncomingMessage, body: string): CliError;
1508
1545
  declare class WsClient {
1509
1546
  private opts;
1510
1547
  private ws?;
@@ -2906,13 +2943,16 @@ declare class LayoutContainmentError extends Error {
2906
2943
  constructor(message: string);
2907
2944
  }
2908
2945
 
2909
- type DoctorAnchor = 'connectivity' | 'identity' | 'config-admin' | 'layer';
2910
- /** 四条锚点的顺序是固定的:连通 → 我是谁 → 有没有权限 → 站在哪一层。 */
2946
+ type DoctorAnchor = 'connectivity' | 'identity' | 'config-admin' | 'layer' | 'websocket-handshake';
2947
+ /** 五条锚点的顺序固定,REST 连通不能替对话握手背书。 */
2911
2948
  declare const DOCTOR_ANCHORS: readonly DoctorAnchor[];
2912
2949
  interface DoctorCheck {
2913
2950
  anchor: DoctorAnchor;
2914
2951
  ok: boolean;
2915
2952
  detail: string;
2953
+ nextStep?: string;
2954
+ httpStatus?: number;
2955
+ handshakeAuthError?: string;
2916
2956
  }
2917
2957
  interface DoctorReport {
2918
2958
  ok: boolean;
@@ -2930,7 +2970,7 @@ interface ReconIdentity {
2930
2970
  username?: string;
2931
2971
  roles?: string[];
2932
2972
  }
2933
- declare function runDoctor(probe: ReconProbe, identity: ReconIdentity | null): Promise<DoctorReport>;
2973
+ declare function runDoctor(probe: ReconProbe, identity: ReconIdentity | null, handshake?: () => Promise<void>): Promise<DoctorReport>;
2934
2974
  /** `GET /api/auth/info` —— 服务端认定的 token 归属从这里来。 */
2935
2975
  declare const AUTH_INFO_PATH = "/api/auth/info";
2936
2976
  /**
@@ -6055,6 +6095,11 @@ declare class JiraClient {
6055
6095
  private readonly timeoutMs;
6056
6096
  constructor(o: JiraClientOptions);
6057
6097
  browseUrl(key: string): string;
6098
+ /**
6099
+ * 一条评论的永久链接——Jira Server / DC 自己「永久链接」按钮给的就是这个形态
6100
+ * (`focusedCommentId` + 评论页签 + `#comment-<id>` 锚点),页面会滚到并高亮那条评论。
6101
+ */
6102
+ commentUrl(key: string, commentId: string): string;
6058
6103
  /** 一次 REST 调用。失败时把 Jira 的 errorMessages 原样带出来,不吞。 */
6059
6104
  api<T = unknown>(p: string, init?: {
6060
6105
  method?: string;
@@ -6070,6 +6115,12 @@ declare class JiraClient {
6070
6115
  max?: number;
6071
6116
  }): Promise<JiraIssue[]>;
6072
6117
  issue(key: string, fields?: string[]): Promise<JiraIssue>;
6118
+ /**
6119
+ * 全部评论,按 Jira 的返回顺序(创建时间正序)。
6120
+ *
6121
+ * 🔴 翻页翻到底:此前只取一页 50 条,50 条之后的**静默不见**——而 `gap status` 的
6122
+ * 「最新评论」恰恰要的是最后那条。Jira 的评论接口按 `startAt` 分页,`total` 说有多少。
6123
+ */
6073
6124
  comments(key: string): Promise<JiraComment[]>;
6074
6125
  addComment(key: string, body: string): Promise<JiraComment>;
6075
6126
  createIssue(fields: Record<string, unknown>): Promise<{
@@ -6120,4 +6171,4 @@ type ParsedRef = {
6120
6171
  declare function parseRef(raw: string, project: string, casesSlug?: string): ParsedRef | null;
6121
6172
  declare const firstLine: (s: string) => string;
6122
6173
 
6123
- 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, 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_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, 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 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 EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, 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 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, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type 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, 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, 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, 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 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 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, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, 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, 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, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, 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, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, 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, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
6174
+ 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, 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_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, 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 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 EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_TOKEN_QUERY_PARAM, 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 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, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingError, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type 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, 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, 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, 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 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 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, 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, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, 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, 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, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, 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, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
package/dist/index.js CHANGED
@@ -76,6 +76,7 @@ var CliErrorCode = /* @__PURE__ */ ((CliErrorCode2) => {
76
76
  CliErrorCode2["AUTH_EXPIRED"] = "AUTH_EXPIRED";
77
77
  CliErrorCode2["AUTH_REFRESH_FAILED"] = "AUTH_REFRESH_FAILED";
78
78
  CliErrorCode2["WS_AUTH_ERROR"] = "WS_AUTH_ERROR";
79
+ CliErrorCode2["WS_HANDSHAKE_REJECTED"] = "WS_HANDSHAKE_REJECTED";
79
80
  CliErrorCode2["SCOPE_FORBIDDEN"] = "SCOPE_FORBIDDEN";
80
81
  CliErrorCode2["BUSINESS_RULE_VIOLATION"] = "BUSINESS_RULE_VIOLATION";
81
82
  CliErrorCode2["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
@@ -110,6 +111,7 @@ var CODE_TO_EXIT = {
110
111
  ["AUTH_EXPIRED" /* AUTH_EXPIRED */]: 2 /* AUTH_ERROR */,
111
112
  ["AUTH_REFRESH_FAILED" /* AUTH_REFRESH_FAILED */]: 2 /* AUTH_ERROR */,
112
113
  ["WS_AUTH_ERROR" /* WS_AUTH_ERROR */]: 2 /* AUTH_ERROR */,
114
+ ["WS_HANDSHAKE_REJECTED" /* WS_HANDSHAKE_REJECTED */]: 2 /* AUTH_ERROR */,
113
115
  ["SCOPE_FORBIDDEN" /* SCOPE_FORBIDDEN */]: 2 /* AUTH_ERROR */,
114
116
  ["BUSINESS_RULE_VIOLATION" /* BUSINESS_RULE_VIOLATION */]: 3 /* BUSINESS_ERROR */,
115
117
  ["MODEL_NOT_FOUND" /* MODEL_NOT_FOUND */]: 3 /* BUSINESS_ERROR */,
@@ -2815,6 +2817,97 @@ function classifyMessage(parsed) {
2815
2817
  if (parsed?.streamId && typeof parsed.seq === "number") return "event";
2816
2818
  return "connection";
2817
2819
  }
2820
+ var HANDSHAKE_TOKEN_QUERY_PARAM = "token";
2821
+ var HANDSHAKE_AUTH_ERROR_HEADER = "x-websocket-auth-error";
2822
+ var HANDSHAKE_BODY_CAP = 4096;
2823
+ var HANDSHAKE_BODY_WAIT_MS = 2e3;
2824
+ function buildHandshakeUrl(endpoint, token) {
2825
+ const url = new URL(endpoint);
2826
+ url.searchParams.set(HANDSHAKE_TOKEN_QUERY_PARAM, token);
2827
+ return url.toString();
2828
+ }
2829
+ function conversationWebSocketEndpoint(endpoint) {
2830
+ const url = new URL(endpoint);
2831
+ url.protocol = url.protocol === "https:" ? "wss:" : url.protocol === "http:" ? "ws:" : url.protocol;
2832
+ url.pathname = url.pathname.replace(/\/$/, "") + "/ws/conversation";
2833
+ return url.toString();
2834
+ }
2835
+ function createHandshakeSocket(endpoint, token, handshakeTimeout) {
2836
+ return new WebSocket(buildHandshakeUrl(endpoint, token), {
2837
+ headers: { Authorization: `Bearer ${token}` },
2838
+ ...handshakeTimeout === void 0 ? {} : { handshakeTimeout }
2839
+ });
2840
+ }
2841
+ async function probeConversationHandshake(opts) {
2842
+ const token = await opts.getAccessToken();
2843
+ if (!token) throw new CliError({ code: "AUTH_FAILED" /* AUTH_FAILED */, message: "\u6CA1\u6709\u53EF\u7528 token\uFF0C\u672A\u53D1\u9001 WebSocket \u63E1\u624B\uFF1B\u8BF7\u8FD0\u884C hcm login" });
2844
+ const ws = createHandshakeSocket(opts.endpoint, token, opts.timeoutMs ?? 1e4);
2845
+ await new Promise((resolve6, reject2) => {
2846
+ let settled = false;
2847
+ let upgraded = false;
2848
+ const finish = (error) => {
2849
+ if (settled) return;
2850
+ settled = true;
2851
+ if (error) reject2(error);
2852
+ else resolve6();
2853
+ };
2854
+ ws.once("open", () => {
2855
+ upgraded = true;
2856
+ ws.close(1e3);
2857
+ const closeTimer = setTimeout(() => ws.terminate(), 1e3);
2858
+ closeTimer.unref();
2859
+ ws.once("close", () => clearTimeout(closeTimer));
2860
+ });
2861
+ ws.once("unexpected-response", (req, res) => {
2862
+ const socket = res.socket ?? req.socket;
2863
+ finish(handshakeRejectedError(res, ""));
2864
+ req.destroy();
2865
+ res.destroy();
2866
+ socket?.destroy();
2867
+ });
2868
+ ws.on("error", (error) => {
2869
+ if (!upgraded) finish(new CliError({
2870
+ code: "NETWORK_ERROR" /* NETWORK_ERROR */,
2871
+ message: error.message.replaceAll(token, "[redacted]").replaceAll(encodeURIComponent(token), "[redacted]")
2872
+ }));
2873
+ });
2874
+ ws.once("close", () => finish(upgraded ? void 0 : new CliError({ code: "NETWORK_ERROR" /* NETWORK_ERROR */, message: "WebSocket \u5728 HTTP 101 \u524D\u5173\u95ED" })));
2875
+ });
2876
+ }
2877
+ var HANDSHAKE_REJECT_NEXT_STEP = {
2878
+ missing_token: '\u672C\u7248 CLI \u63E1\u624B\u5DF2\u540C\u65F6\u5E26 ?token= \u4E0E Authorization \u5934\uFF0C\u4ECD\u62A5 missing_token \u8BF4\u660E\u4E2D\u95F4\u7F51\u5173\u628A\u4E24\u5904\u90FD\u5265\u6389\u4E86\uFF1B\u7528 curl --http1.1 -H "Upgrade: websocket" \u76F4\u63A5\u6253\u540E\u7AEF\u4E0E\u6253\u7F51\u5173\u5404\u4E00\u6B21\uFF0C\u5BF9\u7167 X-WebSocket-Auth-Error \u5B9A\u4F4D',
2879
+ invalid_token: "token \u65E0\u6548\u6216\u5DF2\u8FC7\u671F\uFF1Ahcm identity list \u770B\u8EAB\u4EFD\u72B6\u6001\uFF0Chcm login --env <\u73AF\u5883> \u91CD\u65B0\u767B\u5F55",
2880
+ temporary_token_not_allowed: "\u4E34\u65F6 token \u4E0D\u80FD\u7528\u4E8E\u4F1A\u8BDD\u8FDE\u63A5\uFF1A\u7528\u6B63\u5F0F\u767B\u5F55\u8EAB\u4EFD\uFF08hcm login\uFF09\u91CD\u8DD1",
2881
+ token_subject_not_found: "token \u6240\u5C5E\u7528\u6237\u5DF2\u4E0D\u5B58\u5728\uFF1Ahcm login --env <\u73AF\u5883> \u7528\u73B0\u5B58\u8D26\u53F7\u91CD\u65B0\u767B\u5F55",
2882
+ credential_version_mismatch: "\u8BA4\u8BC1\u4F1A\u8BDD\u5DF2\u5931\u6548\uFF08\u53E3\u4EE4/\u51ED\u636E\u7248\u672C\u53D8\u4E86\uFF09\uFF1Ahcm login --env <\u73AF\u5883> \u91CD\u65B0\u767B\u5F55",
2883
+ impersonation_token_revoked: "\u4EE3\u7406\u4F1A\u8BDD\u5DF2\u64A4\u9500\uFF1A\u7528\u539F\u59CB\u7BA1\u7406\u5458\u8EAB\u4EFD\u91CD\u65B0\u6267\u884C\u5E26 --as \u7684\u547D\u4EE4",
2884
+ impersonation_actor_not_found: "\u4EE3\u7406\u64CD\u4F5C\u8005\u5DF2\u4E0D\u5B58\u5728\uFF1A\u6362\u4E00\u4E2A\u73B0\u5B58\u7BA1\u7406\u5458\u8EAB\u4EFD\u91CD\u65B0\u6267\u884C --as"
2885
+ };
2886
+ function headerText(res, name) {
2887
+ const v = res.headers[name];
2888
+ const text3 = Array.isArray(v) ? v[0] : v;
2889
+ return text3 && text3.trim() ? text3.trim() : void 0;
2890
+ }
2891
+ function handshakeRejectedError(res, body) {
2892
+ const httpStatus = res.statusCode ?? 0;
2893
+ const reason = headerText(res, HANDSHAKE_AUTH_ERROR_HEADER);
2894
+ const traceId = headerText(res, "x-trace-id");
2895
+ const bodyText = body.trim().slice(0, 300);
2896
+ const isAuthReject = httpStatus === 401 || httpStatus === 403;
2897
+ const rejectedBy = reason ? `HCM \u540E\u7AEF\u63E1\u624B\u62E6\u622A\u5668\u62D2\u7EDD\uFF08X-WebSocket-Auth-Error: ${reason}\uFF09` : "\u54CD\u5E94\u91CC\u6CA1\u6709 X-WebSocket-Auth-Error\uFF0C\u62D2\u7EDD\u65B9\u4E0D\u662F HCM \u540E\u7AEF\u7684\u63E1\u624B\u62E6\u622A\u5668\uFF08\u591A\u534A\u662F\u7F51\u5173 / \u53CD\u5411\u4EE3\u7406\uFF0C\u6216\u8DEF\u5F84\u6CA1\u8DEF\u7531\u5230\u540E\u7AEF\uFF09";
2898
+ const nextStep = reason ? HANDSHAKE_REJECT_NEXT_STEP[reason] ?? `\u540E\u7AEF\u62D2\u7EDD\u539F\u56E0 ${reason} \u672A\u6536\u5F55\uFF1A\u6309\u539F\u56E0\u7801\u5728 Core WebSocketHandshakeAuthInterceptor \u91CC\u67E5\u5904\u7F6E` : isAuthReject ? 'hcm version --env <\u73AF\u5883> \u786E\u8BA4\u540E\u7AEF\u5728\u7EBF\uFF1B\u518D\u7528 curl --http1.1 -H "Upgrade: websocket" \u6253\u540C\u4E00 URL\uFF0C\u770B 401 \u662F\u5426\u5E26 X-WebSocket-Auth-Error \u5934' : "hcm version --env <\u73AF\u5883> \u786E\u8BA4\u540E\u7AEF\u5728\u7EBF\uFF0C\u5E76\u786E\u8BA4 /ws/conversation \u8DEF\u5F84\u88AB\u7F51\u5173\u8DEF\u7531\u5230\u4E86\u540E\u7AEF";
2899
+ return new CliError({
2900
+ code: isAuthReject ? "WS_HANDSHAKE_REJECTED" /* WS_HANDSHAKE_REJECTED */ : "NETWORK_ERROR" /* NETWORK_ERROR */,
2901
+ message: `WebSocket \u63E1\u624B\u88AB\u62D2 HTTP ${httpStatus}\uFF1A${rejectedBy}`,
2902
+ context: {
2903
+ httpStatus,
2904
+ ...reason ? { handshakeAuthError: reason } : {},
2905
+ ...bodyText ? { details: bodyText } : {},
2906
+ nextStep
2907
+ },
2908
+ traceId
2909
+ });
2910
+ }
2818
2911
  var WsClient = class {
2819
2912
  constructor(opts) {
2820
2913
  this.opts = opts;
@@ -2858,7 +2951,7 @@ var WsClient = class {
2858
2951
  message: "no access token; run `hcm login`"
2859
2952
  });
2860
2953
  }
2861
- this.ws = new WebSocket(this.opts.endpoint);
2954
+ this.ws = createHandshakeSocket(this.opts.endpoint, tok);
2862
2955
  return new Promise((resolve6, reject2) => {
2863
2956
  const settle = (fn) => {
2864
2957
  off();
@@ -2869,6 +2962,31 @@ var WsClient = class {
2869
2962
  this.ws?.removeListener("message", onMessage);
2870
2963
  this.ws?.removeListener("error", onError);
2871
2964
  this.ws?.removeListener("close", onClose);
2965
+ this.ws?.removeListener("unexpected-response", onUnexpectedResponse);
2966
+ };
2967
+ const onUnexpectedResponse = (req, res) => {
2968
+ let done = false;
2969
+ const chunks = [];
2970
+ let size = 0;
2971
+ const socket = res.socket ?? req.socket;
2972
+ const finish = () => {
2973
+ if (done) return;
2974
+ done = true;
2975
+ clearTimeout(timer);
2976
+ req.destroy();
2977
+ res.destroy();
2978
+ socket?.destroy();
2979
+ settle(() => reject2(handshakeRejectedError(res, Buffer.concat(chunks).toString("utf8"))));
2980
+ };
2981
+ res.on("data", (chunk) => {
2982
+ if (size < HANDSHAKE_BODY_CAP) {
2983
+ chunks.push(chunk);
2984
+ size += chunk.length;
2985
+ }
2986
+ });
2987
+ res.on("end", finish);
2988
+ res.on("error", finish);
2989
+ const timer = setTimeout(finish, HANDSHAKE_BODY_WAIT_MS);
2872
2990
  };
2873
2991
  const onOpen = () => {
2874
2992
  this.ws?.send(JSON.stringify({ type: "auth", token: tok }));
@@ -2928,6 +3046,7 @@ var WsClient = class {
2928
3046
  this.ws.on("message", onMessage);
2929
3047
  this.ws.on("error", onError);
2930
3048
  this.ws.on("close", onClose);
3049
+ this.ws.on("unexpected-response", onUnexpectedResponse);
2931
3050
  });
2932
3051
  }
2933
3052
  send(cmd) {
@@ -10517,9 +10636,10 @@ var DOCTOR_ANCHORS = [
10517
10636
  "connectivity",
10518
10637
  "identity",
10519
10638
  "config-admin",
10520
- "layer"
10639
+ "layer",
10640
+ "websocket-handshake"
10521
10641
  ];
10522
- async function runDoctor(probe, identity) {
10642
+ async function runDoctor(probe, identity, handshake) {
10523
10643
  const checks = [];
10524
10644
  const modelsOut = await probe.get(MODELS_PATH);
10525
10645
  const connected = modelsOut.error === "ok";
@@ -10550,6 +10670,27 @@ async function runDoctor(probe, identity) {
10550
10670
  ok: Boolean(p.sourceKey),
10551
10671
  detail: layerDetail(p, connected)
10552
10672
  });
10673
+ try {
10674
+ 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");
10675
+ await handshake();
10676
+ checks.push({
10677
+ anchor: "websocket-handshake",
10678
+ ok: true,
10679
+ httpStatus: 101,
10680
+ 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",
10681
+ 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"
10682
+ });
10683
+ } catch (error) {
10684
+ const context = error instanceof CliError ? error.context : void 0;
10685
+ checks.push({
10686
+ anchor: "websocket-handshake",
10687
+ ok: false,
10688
+ detail: error instanceof Error ? error.message : String(error),
10689
+ ...typeof context?.httpStatus === "number" ? { httpStatus: context.httpStatus } : {},
10690
+ ...typeof context?.handshakeAuthError === "string" ? { handshakeAuthError: context.handshakeAuthError } : {},
10691
+ 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")
10692
+ });
10693
+ }
10553
10694
  return { ok: checks.every((c) => c.ok), checks };
10554
10695
  }
10555
10696
  function judgeIdentity(ident) {
@@ -21681,6 +21822,13 @@ var JiraClient = class {
21681
21822
  browseUrl(key) {
21682
21823
  return `${this.base}/browse/${key}`;
21683
21824
  }
21825
+ /**
21826
+ * 一条评论的永久链接——Jira Server / DC 自己「永久链接」按钮给的就是这个形态
21827
+ * (`focusedCommentId` + 评论页签 + `#comment-<id>` 锚点),页面会滚到并高亮那条评论。
21828
+ */
21829
+ commentUrl(key, commentId) {
21830
+ return `${this.browseUrl(key)}?focusedCommentId=${commentId}&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-${commentId}`;
21831
+ }
21684
21832
  /** 一次 REST 调用。失败时把 Jira 的 errorMessages 原样带出来,不吞。 */
21685
21833
  async api(p, init = {}) {
21686
21834
  const method = init.method ?? "GET";
@@ -21726,11 +21874,25 @@ var JiraClient = class {
21726
21874
  issue(key, fields) {
21727
21875
  return this.api(`/rest/api/2/issue/${encodeURIComponent(key)}${fields ? `?fields=${fields.join(",")}` : ""}`);
21728
21876
  }
21877
+ /**
21878
+ * 全部评论,按 Jira 的返回顺序(创建时间正序)。
21879
+ *
21880
+ * 🔴 翻页翻到底:此前只取一页 50 条,50 条之后的**静默不见**——而 `gap status` 的
21881
+ * 「最新评论」恰恰要的是最后那条。Jira 的评论接口按 `startAt` 分页,`total` 说有多少。
21882
+ */
21729
21883
  async comments(key) {
21730
- const r = await this.api(
21731
- `/rest/api/2/issue/${encodeURIComponent(key)}/comment?maxResults=50`
21732
- );
21733
- return r.comments ?? [];
21884
+ const out = [];
21885
+ const pageSize = 50;
21886
+ for (let startAt = 0; ; startAt += pageSize) {
21887
+ const r = await this.api(
21888
+ `/rest/api/2/issue/${encodeURIComponent(key)}/comment?startAt=${startAt}&maxResults=${pageSize}`
21889
+ );
21890
+ const page = r.comments ?? [];
21891
+ out.push(...page);
21892
+ const total = typeof r.total === "number" ? r.total : out.length;
21893
+ if (page.length === 0 || out.length >= total) break;
21894
+ }
21895
+ return out;
21734
21896
  }
21735
21897
  addComment(key, body) {
21736
21898
  return this.api(`/rest/api/2/issue/${encodeURIComponent(key)}/comment`, { method: "POST", body: { body } });
@@ -21932,6 +22094,8 @@ export {
21932
22094
  FORCE_STALE_FLAG,
21933
22095
  FORCE_STALE_FLAG_TEXT,
21934
22096
  GATE_COMPONENTS,
22097
+ HANDSHAKE_AUTH_ERROR_HEADER,
22098
+ HANDSHAKE_TOKEN_QUERY_PARAM,
21935
22099
  HCM_LANG_ENV,
21936
22100
  HcmClient,
21937
22101
  IMPERSONATION_ACTIVE_PATH,
@@ -22083,6 +22247,7 @@ export {
22083
22247
  buildCarrierResult,
22084
22248
  buildConfirm,
22085
22249
  buildDeliveryRun,
22250
+ buildHandshakeUrl,
22086
22251
  buildInterrupt,
22087
22252
  buildMiniAppTemplateFiles,
22088
22253
  buildMiniPreviewTargets,
@@ -22106,6 +22271,7 @@ export {
22106
22271
  computeReconSourceKey,
22107
22272
  contentHash,
22108
22273
  conversationStateFile,
22274
+ conversationWebSocketEndpoint,
22109
22275
  create,
22110
22276
  createConversation,
22111
22277
  createHttpClient,
@@ -22169,6 +22335,7 @@ export {
22169
22335
  getTenantMeta,
22170
22336
  globalConfigFile,
22171
22337
  guessMimeType,
22338
+ handshakeRejectedError,
22172
22339
  hasPendingImpersonationSessions,
22173
22340
  hcmConfigDir,
22174
22341
  hitRank,
@@ -22251,6 +22418,7 @@ export {
22251
22418
  pollDeviceAuthorization,
22252
22419
  printResolvedEnvironment,
22253
22420
  probeAll,
22421
+ probeConversationHandshake,
22254
22422
  probeExtensionSource,
22255
22423
  profileDir,
22256
22424
  profileFile,