@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 +55 -4
- package/dist/index.js +175 -7
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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 =
|
|
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
|
|
21731
|
-
|
|
21732
|
-
)
|
|
21733
|
-
|
|
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,
|