@hcmai/sdk 0.15.0 → 0.15.2

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,29 @@ 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
+ /**
1534
+ * 非 101 的握手响应 → 可判断下一步的错误。ws 库默认只给一句 `Unexpected server response: 401`,
1535
+ * 状态码、拒绝原因头、traceId、响应体全在 res 上却一个都不露(HCMNX-25 顾问两次现场只能写 NETWORK_ERROR)。
1536
+ * 401/403 归 WS_HANDSHAKE_REJECTED(退出码 2,认证类);其余状态仍是网络/网关类(退出码 4)。
1537
+ */
1538
+ declare function handshakeRejectedError(res: IncomingMessage, body: string): CliError;
1508
1539
  declare class WsClient {
1509
1540
  private opts;
1510
1541
  private ws?;
@@ -1833,7 +1864,17 @@ interface TimelineItemLite {
1833
1864
  attachments?: Array<{
1834
1865
  fileName?: string;
1835
1866
  }> | null;
1867
+ /**
1868
+ * 条目状态(后端 TimelineItemDto 的公共字段)。#2538 起 chat-text 会带
1869
+ * `SUPERSEDED`——那条终答被引擎守卫打回、并未交付给用户,回放与
1870
+ * `--regenerate-from last-assistant` 都必须跳过它。
1871
+ */
1872
+ status?: string | null;
1836
1873
  }
1874
+ /** 被引擎守卫打回的终答(后端 #2538 给 chat-text 打的 status)。 */
1875
+ declare const SUPERSEDED_STATUS = "SUPERSEDED";
1876
+ /** 该 timeline 条目是不是被打回的终答(打回的正文不是交付给用户的答案)。 */
1877
+ declare function isSupersededItem(item: Pick<TimelineItemLite, 'status'>): boolean;
1837
1878
  interface ResumeTurn {
1838
1879
  role: 'user' | 'assistant';
1839
1880
  text: string;
@@ -1859,8 +1900,39 @@ declare function fetchConversationTimelineStrict(http: AxiosInstance, conversati
1859
1900
  * timeline → 续会话摘要。取最近 maxRounds 轮:每轮 = user-msg 原文 + 该轮最后一条
1860
1901
  * chat-text 正文(中间 tools/delegation/steering 等过程条目不进摘要——回顾要的是
1861
1902
  * 「聊到哪了」不是过程重放)。文本截为单行(换行折叠 + 显示宽度截断)。
1903
+ *
1904
+ * 被引擎守卫打回的 chat-text(status=SUPERSEDED)不算该轮收尾——用户从没见过那段
1905
+ * 正文,把它当「上次聊到这」回放会误导续接。
1862
1906
  */
1863
1907
  declare function buildResumeSummary(conversationId: string, items: TimelineItemLite[], maxRounds?: number, maxWidth?: number): ResumeSummary | null;
1908
+ /**
1909
+ * `--regenerate-from last-assistant` 的目标 seq 与找不到时的自陈。
1910
+ *
1911
+ * 找不到时**不猜**:`reason` 说清是哪一种找不到,`earlierSeq` 交出更早轮次里那条真交付过的
1912
+ * seq(有的话),调用方据此给出「要跨轮回退就显式传那个 seq」的下一步。
1913
+ */
1914
+ interface LastAssistantTarget {
1915
+ /** 本轮真交付过的终答 seq;找不到为 null。 */
1916
+ seq: number | null;
1917
+ /**
1918
+ * 找不到的原因(seq 非 null 时缺席):
1919
+ * - `superseded-only` 本轮的终答被引擎守卫打回(SUPERSEDED),从未交付;
1920
+ * - `no-answer-in-turn` 本轮还没落终答(中断 / 仍在跑);
1921
+ * - `empty` 整条 timeline 没有可用条目。
1922
+ */
1923
+ reason?: 'superseded-only' | 'no-answer-in-turn' | 'empty';
1924
+ /** 更早轮次里最后一条真交付过的终答 seq(跨轮回退只能由人显式指定,不自动做)。 */
1925
+ earlierSeq?: number;
1926
+ }
1927
+ /**
1928
+ * 反向找本轮(最后一个 user-msg 之后)真交付过的终答。
1929
+ *
1930
+ * 🔴 **扫描在轮边界停住**:后端 `fromSeq` 是「自该 seq 起整段作废」的区间语义,跨过 user-msg
1931
+ * 拿上一轮的 seq 去重跑,会连这一轮的用户提问一起作废——而调用方分不出手里这条 seq 是
1932
+ * 本轮的还是两轮前的。本轮没有已交付终答就报没有(fail-closed),把跨轮的决定交回给人。
1933
+ */
1934
+ declare function findLastAssistantTarget(items: TimelineItemLite[] | null | undefined): LastAssistantTarget;
1935
+ /** {@link findLastAssistantTarget} 的薄封装(只要 seq 的调用方用它)。 */
1864
1936
  declare function findLastAssistantSeq(items: TimelineItemLite[] | null | undefined): number | null;
1865
1937
 
1866
1938
  interface ConversationListItem {
@@ -6014,6 +6086,11 @@ declare class JiraClient {
6014
6086
  private readonly timeoutMs;
6015
6087
  constructor(o: JiraClientOptions);
6016
6088
  browseUrl(key: string): string;
6089
+ /**
6090
+ * 一条评论的永久链接——Jira Server / DC 自己「永久链接」按钮给的就是这个形态
6091
+ * (`focusedCommentId` + 评论页签 + `#comment-<id>` 锚点),页面会滚到并高亮那条评论。
6092
+ */
6093
+ commentUrl(key: string, commentId: string): string;
6017
6094
  /** 一次 REST 调用。失败时把 Jira 的 errorMessages 原样带出来,不吞。 */
6018
6095
  api<T = unknown>(p: string, init?: {
6019
6096
  method?: string;
@@ -6029,6 +6106,12 @@ declare class JiraClient {
6029
6106
  max?: number;
6030
6107
  }): Promise<JiraIssue[]>;
6031
6108
  issue(key: string, fields?: string[]): Promise<JiraIssue>;
6109
+ /**
6110
+ * 全部评论,按 Jira 的返回顺序(创建时间正序)。
6111
+ *
6112
+ * 🔴 翻页翻到底:此前只取一页 50 条,50 条之后的**静默不见**——而 `gap status` 的
6113
+ * 「最新评论」恰恰要的是最后那条。Jira 的评论接口按 `startAt` 分页,`total` 说有多少。
6114
+ */
6032
6115
  comments(key: string): Promise<JiraComment[]>;
6033
6116
  addComment(key: string, body: string): Promise<JiraComment>;
6034
6117
  createIssue(fields: Record<string, unknown>): Promise<{
@@ -6079,4 +6162,4 @@ type ParsedRef = {
6079
6162
  declare function parseRef(raw: string, project: string, casesSlug?: string): ParsedRef | null;
6080
6163
  declare const firstLine: (s: string) => string;
6081
6164
 
6082
- 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, 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, 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, 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, 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 };
6165
+ 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, 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, 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,49 @@ 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
+ var HANDSHAKE_REJECT_NEXT_STEP = {
2830
+ 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',
2831
+ 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",
2832
+ 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",
2833
+ 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",
2834
+ 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",
2835
+ 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",
2836
+ 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"
2837
+ };
2838
+ function headerText(res, name) {
2839
+ const v = res.headers[name];
2840
+ const text3 = Array.isArray(v) ? v[0] : v;
2841
+ return text3 && text3.trim() ? text3.trim() : void 0;
2842
+ }
2843
+ function handshakeRejectedError(res, body) {
2844
+ const httpStatus = res.statusCode ?? 0;
2845
+ const reason = headerText(res, HANDSHAKE_AUTH_ERROR_HEADER);
2846
+ const traceId = headerText(res, "x-trace-id");
2847
+ const bodyText = body.trim().slice(0, 300);
2848
+ const isAuthReject = httpStatus === 401 || httpStatus === 403;
2849
+ 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";
2850
+ 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";
2851
+ return new CliError({
2852
+ code: isAuthReject ? "WS_HANDSHAKE_REJECTED" /* WS_HANDSHAKE_REJECTED */ : "NETWORK_ERROR" /* NETWORK_ERROR */,
2853
+ message: `WebSocket \u63E1\u624B\u88AB\u62D2 HTTP ${httpStatus}\uFF1A${rejectedBy}`,
2854
+ context: {
2855
+ httpStatus,
2856
+ ...reason ? { handshakeAuthError: reason } : {},
2857
+ ...bodyText ? { details: bodyText } : {},
2858
+ nextStep
2859
+ },
2860
+ traceId
2861
+ });
2862
+ }
2818
2863
  var WsClient = class {
2819
2864
  constructor(opts) {
2820
2865
  this.opts = opts;
@@ -2858,7 +2903,9 @@ var WsClient = class {
2858
2903
  message: "no access token; run `hcm login`"
2859
2904
  });
2860
2905
  }
2861
- this.ws = new WebSocket(this.opts.endpoint);
2906
+ this.ws = new WebSocket(buildHandshakeUrl(this.opts.endpoint, tok), {
2907
+ headers: { Authorization: `Bearer ${tok}` }
2908
+ });
2862
2909
  return new Promise((resolve6, reject2) => {
2863
2910
  const settle = (fn) => {
2864
2911
  off();
@@ -2869,6 +2916,31 @@ var WsClient = class {
2869
2916
  this.ws?.removeListener("message", onMessage);
2870
2917
  this.ws?.removeListener("error", onError);
2871
2918
  this.ws?.removeListener("close", onClose);
2919
+ this.ws?.removeListener("unexpected-response", onUnexpectedResponse);
2920
+ };
2921
+ const onUnexpectedResponse = (req, res) => {
2922
+ let done = false;
2923
+ const chunks = [];
2924
+ let size = 0;
2925
+ const socket = res.socket ?? req.socket;
2926
+ const finish = () => {
2927
+ if (done) return;
2928
+ done = true;
2929
+ clearTimeout(timer);
2930
+ req.destroy();
2931
+ res.destroy();
2932
+ socket?.destroy();
2933
+ settle(() => reject2(handshakeRejectedError(res, Buffer.concat(chunks).toString("utf8"))));
2934
+ };
2935
+ res.on("data", (chunk) => {
2936
+ if (size < HANDSHAKE_BODY_CAP) {
2937
+ chunks.push(chunk);
2938
+ size += chunk.length;
2939
+ }
2940
+ });
2941
+ res.on("end", finish);
2942
+ res.on("error", finish);
2943
+ const timer = setTimeout(finish, HANDSHAKE_BODY_WAIT_MS);
2872
2944
  };
2873
2945
  const onOpen = () => {
2874
2946
  this.ws?.send(JSON.stringify({ type: "auth", token: tok }));
@@ -2928,6 +3000,7 @@ var WsClient = class {
2928
3000
  this.ws.on("message", onMessage);
2929
3001
  this.ws.on("error", onError);
2930
3002
  this.ws.on("close", onClose);
3003
+ this.ws.on("unexpected-response", onUnexpectedResponse);
2931
3004
  });
2932
3005
  }
2933
3006
  send(cmd) {
@@ -3551,6 +3624,10 @@ async function createConversation(http, agentId = DEFAULT_AGENT_ID) {
3551
3624
  }
3552
3625
 
3553
3626
  // src/chat/resume-summary.ts
3627
+ var SUPERSEDED_STATUS = "SUPERSEDED";
3628
+ function isSupersededItem(item) {
3629
+ return item.status === SUPERSEDED_STATUS;
3630
+ }
3554
3631
  function normalizeTimelineItems(body) {
3555
3632
  if (Array.isArray(body)) return body;
3556
3633
  if (body && typeof body === "object" && Array.isArray(body.data)) {
@@ -3586,7 +3663,7 @@ function buildResumeSummary(conversationId, items, maxRounds = 2, maxWidth = 76)
3586
3663
  const atts = (it.attachments ?? []).map((a) => a?.fileName).filter(Boolean);
3587
3664
  const suffix = atts.length ? ` \u{1F4CE} ${atts.join(" \xB7 ")}` : "";
3588
3665
  rounds.push({ user: it.text + suffix, assistant: null });
3589
- } else if (it.kind === "chat-text" && it.content && it.content.trim() && rounds.length > 0) {
3666
+ } else if (it.kind === "chat-text" && !isSupersededItem(it) && it.content && it.content.trim() && rounds.length > 0) {
3590
3667
  const last = rounds[rounds.length - 1];
3591
3668
  if (last) last.assistant = it.content;
3592
3669
  }
@@ -3600,9 +3677,31 @@ function buildResumeSummary(conversationId, items, maxRounds = 2, maxWidth = 76)
3600
3677
  }
3601
3678
  return { conversationId, totalRounds: rounds.length, recent };
3602
3679
  }
3680
+ var isDeliveredAssistant = (it) => it.kind === "chat-text" && !isSupersededItem(it) && Number.isInteger(it.seq);
3681
+ function findLastAssistantTarget(items) {
3682
+ const list = [...items ?? []].reverse();
3683
+ if (list.length === 0) return { seq: null, reason: "empty" };
3684
+ let crossedTurn = false;
3685
+ let sawSuperseded = false;
3686
+ let earlierSeq;
3687
+ for (const it of list) {
3688
+ if (it.kind === "user-msg") {
3689
+ if (crossedTurn) break;
3690
+ crossedTurn = true;
3691
+ continue;
3692
+ }
3693
+ if (isDeliveredAssistant(it)) {
3694
+ if (!crossedTurn) return { seq: it.seq };
3695
+ earlierSeq = it.seq;
3696
+ break;
3697
+ }
3698
+ if (!crossedTurn && it.kind === "chat-text" && isSupersededItem(it)) sawSuperseded = true;
3699
+ }
3700
+ const reason = sawSuperseded ? "superseded-only" : crossedTurn ? "no-answer-in-turn" : "empty";
3701
+ return earlierSeq === void 0 ? { seq: null, reason } : { seq: null, reason, earlierSeq };
3702
+ }
3603
3703
  function findLastAssistantSeq(items) {
3604
- const last = [...items ?? []].reverse().find((it) => it.kind === "chat-text" && Number.isInteger(it.seq));
3605
- return last?.seq ?? null;
3704
+ return findLastAssistantTarget(items).seq;
3606
3705
  }
3607
3706
 
3608
3707
  // src/chat/conversation-list.ts
@@ -21655,6 +21754,13 @@ var JiraClient = class {
21655
21754
  browseUrl(key) {
21656
21755
  return `${this.base}/browse/${key}`;
21657
21756
  }
21757
+ /**
21758
+ * 一条评论的永久链接——Jira Server / DC 自己「永久链接」按钮给的就是这个形态
21759
+ * (`focusedCommentId` + 评论页签 + `#comment-<id>` 锚点),页面会滚到并高亮那条评论。
21760
+ */
21761
+ commentUrl(key, commentId) {
21762
+ return `${this.browseUrl(key)}?focusedCommentId=${commentId}&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-${commentId}`;
21763
+ }
21658
21764
  /** 一次 REST 调用。失败时把 Jira 的 errorMessages 原样带出来,不吞。 */
21659
21765
  async api(p, init = {}) {
21660
21766
  const method = init.method ?? "GET";
@@ -21700,11 +21806,25 @@ var JiraClient = class {
21700
21806
  issue(key, fields) {
21701
21807
  return this.api(`/rest/api/2/issue/${encodeURIComponent(key)}${fields ? `?fields=${fields.join(",")}` : ""}`);
21702
21808
  }
21809
+ /**
21810
+ * 全部评论,按 Jira 的返回顺序(创建时间正序)。
21811
+ *
21812
+ * 🔴 翻页翻到底:此前只取一页 50 条,50 条之后的**静默不见**——而 `gap status` 的
21813
+ * 「最新评论」恰恰要的是最后那条。Jira 的评论接口按 `startAt` 分页,`total` 说有多少。
21814
+ */
21703
21815
  async comments(key) {
21704
- const r = await this.api(
21705
- `/rest/api/2/issue/${encodeURIComponent(key)}/comment?maxResults=50`
21706
- );
21707
- return r.comments ?? [];
21816
+ const out = [];
21817
+ const pageSize = 50;
21818
+ for (let startAt = 0; ; startAt += pageSize) {
21819
+ const r = await this.api(
21820
+ `/rest/api/2/issue/${encodeURIComponent(key)}/comment?startAt=${startAt}&maxResults=${pageSize}`
21821
+ );
21822
+ const page = r.comments ?? [];
21823
+ out.push(...page);
21824
+ const total = typeof r.total === "number" ? r.total : out.length;
21825
+ if (page.length === 0 || out.length >= total) break;
21826
+ }
21827
+ return out;
21708
21828
  }
21709
21829
  addComment(key, body) {
21710
21830
  return this.api(`/rest/api/2/issue/${encodeURIComponent(key)}/comment`, { method: "POST", body: { body } });
@@ -21906,6 +22026,8 @@ export {
21906
22026
  FORCE_STALE_FLAG,
21907
22027
  FORCE_STALE_FLAG_TEXT,
21908
22028
  GATE_COMPONENTS,
22029
+ HANDSHAKE_AUTH_ERROR_HEADER,
22030
+ HANDSHAKE_TOKEN_QUERY_PARAM,
21909
22031
  HCM_LANG_ENV,
21910
22032
  HcmClient,
21911
22033
  IMPERSONATION_ACTIVE_PATH,
@@ -22002,6 +22124,7 @@ export {
22002
22124
  STEP_RECORD,
22003
22125
  STEP_STOP,
22004
22126
  STEP_UNBIND,
22127
+ SUPERSEDED_STATUS,
22005
22128
  SYNTH_FOOTNOTE,
22006
22129
  SYNTH_MARK,
22007
22130
  TEMP_ENV_NAME,
@@ -22056,6 +22179,7 @@ export {
22056
22179
  buildCarrierResult,
22057
22180
  buildConfirm,
22058
22181
  buildDeliveryRun,
22182
+ buildHandshakeUrl,
22059
22183
  buildInterrupt,
22060
22184
  buildMiniAppTemplateFiles,
22061
22185
  buildMiniPreviewTargets,
@@ -22127,6 +22251,7 @@ export {
22127
22251
  find,
22128
22252
  findEnvByEndpoint,
22129
22253
  findLastAssistantSeq,
22254
+ findLastAssistantTarget,
22130
22255
  firstLine,
22131
22256
  flattenSkills,
22132
22257
  formatMetaIssues,
@@ -22141,6 +22266,7 @@ export {
22141
22266
  getTenantMeta,
22142
22267
  globalConfigFile,
22143
22268
  guessMimeType,
22269
+ handshakeRejectedError,
22144
22270
  hasPendingImpersonationSessions,
22145
22271
  hcmConfigDir,
22146
22272
  hitRank,
@@ -22158,6 +22284,7 @@ export {
22158
22284
  isLocalName,
22159
22285
  isReadOnly,
22160
22286
  isServerSlidingSession,
22287
+ isSupersededItem,
22161
22288
  isTempEnv,
22162
22289
  isTerminalRunStatus,
22163
22290
  isZeroNetwork,