@sema-agent/client-core 0.110.0 → 0.112.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/CHANGELOG.md +244 -0
  2. package/README.md +59 -18
  3. package/dist/abortableSleep.d.ts +7 -0
  4. package/dist/abortableSleep.js +37 -0
  5. package/dist/adapt/arms.js +25 -4
  6. package/dist/adapt/toolCards.d.ts +3 -1
  7. package/dist/adapt/toolCards.js +4 -2
  8. package/dist/adapter/activeRunSelfHeal.d.ts +39 -0
  9. package/dist/adapter/activeRunSelfHeal.js +171 -3
  10. package/dist/adapter/downstream/eventToSdkMessage.js +10 -10
  11. package/dist/adapter/downstream/terminalToSdkResult.d.ts +2 -0
  12. package/dist/adapter/downstream/terminalToSdkResult.js +11 -0
  13. package/dist/adapter/runStream.d.ts +5 -0
  14. package/dist/adapter/runStream.js +15 -3
  15. package/dist/agentSession/engineSessionBackgroundStop.js +2 -2
  16. package/dist/attachmentRoute.d.ts +20 -0
  17. package/dist/attachmentRoute.js +39 -0
  18. package/dist/attachmentsWireCaps.js +1 -1
  19. package/dist/builtinOutputStyles.d.ts +12 -0
  20. package/dist/builtinOutputStyles.js +147 -0
  21. package/dist/checkpointRowVerdict.d.ts +3 -0
  22. package/dist/checkpointRowVerdict.js +14 -1
  23. package/dist/compactionStatus.d.ts +9 -0
  24. package/dist/compactionStatus.js +29 -5
  25. package/dist/consoleCaPin.d.ts +136 -0
  26. package/dist/consoleCaPin.js +827 -0
  27. package/dist/controlRouter.js +2 -1
  28. package/dist/coreValuePorts.d.ts +39 -1
  29. package/dist/coreValuePorts.js +10 -0
  30. package/dist/decideReceipt.d.ts +2 -1
  31. package/dist/deviceRebind.js +3 -3
  32. package/dist/displayUntrusted.d.ts +1 -0
  33. package/dist/displayUntrusted.js +6 -0
  34. package/dist/effectiveFacts.d.ts +9 -0
  35. package/dist/effectiveFacts.js +33 -0
  36. package/dist/engineAddress.d.ts +1 -0
  37. package/dist/engineAddress.js +4 -1
  38. package/dist/engineCredentialRelease.d.ts +54 -0
  39. package/dist/engineCredentialRelease.js +146 -0
  40. package/dist/engineErrorCodes.d.ts +1 -0
  41. package/dist/engineErrorCodes.js +1 -0
  42. package/dist/engineHealthProbeVerdict.d.ts +24 -0
  43. package/dist/engineHealthProbeVerdict.js +123 -0
  44. package/dist/engineNoticeCodes.js +5 -7
  45. package/dist/engineRepoint.d.ts +12 -5
  46. package/dist/engineRepoint.js +44 -19
  47. package/dist/engineRowRef.d.ts +3 -0
  48. package/dist/engineRowRef.js +11 -1
  49. package/dist/engineSwapCrossing.d.ts +57 -0
  50. package/dist/engineSwapCrossing.js +297 -0
  51. package/dist/engineUnavailable.d.ts +45 -0
  52. package/dist/engineUnavailable.js +496 -0
  53. package/dist/engineUrl.js +4 -2
  54. package/dist/eventLeg.js +3 -3
  55. package/dist/gateFailureCodes.js +2 -2
  56. package/dist/generated/sdkFactTables.d.ts +2 -1
  57. package/dist/generated/sdkFactTables.js +14 -0
  58. package/dist/generated/settingsSchemaFns.d.ts +1 -0
  59. package/dist/generated/settingsSchemaFns.js +3 -0
  60. package/dist/generated/settingsSchemaHooksClassifier.js +38 -9
  61. package/dist/generated/settingsSchemaTables.d.ts +56 -0
  62. package/dist/generated/settingsSchemaTables.js +19 -0
  63. package/dist/generated/settingsSchemaTypes.d.ts +23 -13
  64. package/dist/generated/settingsSchemaUrlShape.d.ts +1 -0
  65. package/dist/generated/settingsSchemaUrlShape.js +17 -0
  66. package/dist/hitl/approvalDelivery.d.ts +1 -0
  67. package/dist/hitl/approvalDelivery.js +1 -1
  68. package/dist/hitl/approvalResolution.d.ts +1 -1
  69. package/dist/hitl/approvalResolution.js +2 -1
  70. package/dist/hitl/askGateWire.js +5 -6
  71. package/dist/hitl/decisionRefusal.d.ts +6 -0
  72. package/dist/hitl/decisionRefusal.js +19 -10
  73. package/dist/hitl/decisionRefusalCarrier.d.ts +3 -0
  74. package/dist/hitl/decisionRefusalCarrier.js +348 -0
  75. package/dist/hitl/decisionSend.d.ts +7 -0
  76. package/dist/hitl/decisionSend.js +34 -12
  77. package/dist/hitl/editedApprovalAcceptance.js +1 -1
  78. package/dist/hitl/elicitationRefusal.d.ts +4 -0
  79. package/dist/hitl/elicitationRefusal.js +23 -0
  80. package/dist/hitl/frameRouter.d.ts +2 -2
  81. package/dist/hitl/frameRouter.js +8 -15
  82. package/dist/hitl/gateIdentity.d.ts +5 -0
  83. package/dist/hitl/gateIdentity.js +23 -0
  84. package/dist/hitl/hitlBridge.d.ts +6 -0
  85. package/dist/hitl/hitlBridge.js +10 -4
  86. package/dist/hitl/hitlHostSurface.d.ts +2 -1
  87. package/dist/hitl/hitlHostSurface.js +7 -2
  88. package/dist/hitl/localAllowRedemption.d.ts +70 -0
  89. package/dist/hitl/localAllowRedemption.js +276 -0
  90. package/dist/hitl/parkOwnership.js +2 -1
  91. package/dist/hitl/parkResolver.js +14 -4
  92. package/dist/hitl/persistedRulesWire.d.ts +16 -0
  93. package/dist/hitl/persistedRulesWire.js +70 -0
  94. package/dist/hitl/planReviewWire.d.ts +3 -0
  95. package/dist/hitl/planReviewWire.js +23 -6
  96. package/dist/hitl/policyDenyCause.d.ts +1 -1
  97. package/dist/hitl/policyDenyCause.js +1 -1
  98. package/dist/hitl/resumeRunningCard.d.ts +1 -0
  99. package/dist/hitl/resumeRunningCard.js +1 -0
  100. package/dist/hitl/screenCardCarriers.d.ts +15 -0
  101. package/dist/hitl/screenCardCarriers.js +41 -0
  102. package/dist/hitl/screenDecisionCards.d.ts +98 -0
  103. package/dist/hitl/screenDecisionCards.js +363 -0
  104. package/dist/hitl/sessionPolicyWire.js +2 -2
  105. package/dist/hitl/standingRows.d.ts +6 -2
  106. package/dist/hitl/standingRows.js +27 -2
  107. package/dist/hitl/toolApprovalWire.d.ts +30 -8
  108. package/dist/hitl/toolApprovalWire.js +264 -121
  109. package/dist/hooksReaderGenerations.js +1 -1
  110. package/dist/hooksWireCaps.js +3 -3
  111. package/dist/hostSettingNoticeArm.d.ts +3 -0
  112. package/dist/hostSettingNoticeArm.js +12 -0
  113. package/dist/hostTurnSettings.d.ts +3 -0
  114. package/dist/hostTurnSettings.js +38 -5
  115. package/dist/humanTurnRead.js +11 -1
  116. package/dist/i18n/messages.en.d.ts +292 -0
  117. package/dist/i18n/messages.en.js +298 -7
  118. package/dist/i18n/messages.zh.js +316 -6
  119. package/dist/i18n/translate.d.ts +3 -0
  120. package/dist/i18n/translate.js +78 -10
  121. package/dist/i18n/zh.d.ts +1 -0
  122. package/dist/i18n/zh.js +1 -0
  123. package/dist/index.d.ts +71 -20
  124. package/dist/index.js +44 -13
  125. package/dist/interactiveHalt.js +2 -1
  126. package/dist/interactiveInterrupt.js +20 -2
  127. package/dist/liveModelCatalog.d.ts +4 -0
  128. package/dist/liveModelCatalog.js +12 -3
  129. package/dist/localConfig/documents.d.ts +61 -0
  130. package/dist/localConfig/documents.js +51 -0
  131. package/dist/localConfig/kernel.d.ts +149 -0
  132. package/dist/localConfig/kernel.js +597 -0
  133. package/dist/localConfig/mcp/edit.d.ts +161 -0
  134. package/dist/localConfig/mcp/edit.js +846 -0
  135. package/dist/localConfig/mcp/servers.d.ts +165 -0
  136. package/dist/localConfig/mcp/servers.js +776 -0
  137. package/dist/localConfig/mcp/views.d.ts +170 -0
  138. package/dist/localConfig/mcp/views.js +429 -0
  139. package/dist/localConfig/modelPool.d.ts +262 -0
  140. package/dist/localConfig/modelPool.js +1489 -0
  141. package/dist/localConfig/modelPoolWords.d.ts +13 -0
  142. package/dist/localConfig/modelPoolWords.js +20 -0
  143. package/dist/localConfig/receiptShape.d.ts +7 -0
  144. package/dist/localConfig/receiptShape.js +135 -0
  145. package/dist/localConfig/settingsWrite.d.ts +127 -0
  146. package/dist/localConfig/settingsWrite.js +237 -0
  147. package/dist/localConfig/skills.d.ts +124 -0
  148. package/dist/localConfig/skills.js +397 -0
  149. package/dist/localConfig/skillsWords.d.ts +10 -0
  150. package/dist/localConfig/skillsWords.js +5 -0
  151. package/dist/localEngineSeatReading.d.ts +2 -2
  152. package/dist/localEngineSeatReading.js +5 -3
  153. package/dist/localEngineSpawn.d.ts +0 -7
  154. package/dist/localEngineSpawn.js +0 -92
  155. package/dist/localEngineStep.d.ts +2 -2
  156. package/dist/localEngineStep.js +2 -0
  157. package/dist/mcpProbeWire.js +2 -1
  158. package/dist/mcpReconnect.js +3 -3
  159. package/dist/mcpWireCaps.js +1 -1
  160. package/dist/memoryVerbsWire.js +3 -2
  161. package/dist/model/engineModelWords.d.ts +3 -0
  162. package/dist/model/engineModelWords.js +13 -0
  163. package/dist/model/onboardJudgement.d.ts +14 -4
  164. package/dist/model/onboardJudgement.js +91 -139
  165. package/dist/model/subagentModelWord.d.ts +21 -2
  166. package/dist/model/subagentModelWord.js +100 -29
  167. package/dist/modelCapabilityProbe.js +3 -40
  168. package/dist/modelConfigGapNotice.d.ts +20 -0
  169. package/dist/modelConfigGapNotice.js +102 -0
  170. package/dist/modsKernelIdentity.js +2 -47
  171. package/dist/notifications.d.ts +19 -0
  172. package/dist/notifications.js +114 -12
  173. package/dist/ownKey.d.ts +7 -0
  174. package/dist/ownKey.js +71 -8
  175. package/dist/pendingUserRow.d.ts +4 -0
  176. package/dist/pendingUserRow.js +16 -0
  177. package/dist/permissionsDeclaration.d.ts +3 -1
  178. package/dist/permissionsDeclaration.js +33 -9
  179. package/dist/planReviewCardFacts.d.ts +3 -0
  180. package/dist/planReviewCardFacts.js +52 -2
  181. package/dist/pluginHooksWire.d.ts +9 -1
  182. package/dist/pluginHooksWire.js +40 -6
  183. package/dist/printToolResultFrame.js +4 -2
  184. package/dist/promptBlockedCopy.js +12 -7
  185. package/dist/promptSuggestionBatch.d.ts +7 -0
  186. package/dist/promptSuggestionBatch.js +9 -0
  187. package/dist/promptSuggestionsTail.d.ts +39 -0
  188. package/dist/promptSuggestionsTail.js +116 -0
  189. package/dist/request/taskRequest.js +10 -6
  190. package/dist/requestCoordinate.d.ts +1 -0
  191. package/dist/requestCoordinate.js +13 -0
  192. package/dist/resumeRefusalCopy.d.ts +3 -1
  193. package/dist/resumeRefusalCopy.js +12 -4
  194. package/dist/rewindArchiveReading.js +4 -4
  195. package/dist/runCancelContext.d.ts +2 -1
  196. package/dist/runCancelContext.js +1 -0
  197. package/dist/runLedgerSnapshot.js +3 -3
  198. package/dist/runPermissionModeSwitch.js +3 -4
  199. package/dist/scenarioRefusal.js +11 -13
  200. package/dist/scenarioSkills.js +11 -6
  201. package/dist/seam.d.ts +16 -2
  202. package/dist/seam.js +10 -0
  203. package/dist/seatContract.d.ts +259 -9
  204. package/dist/seatContract.js +444 -15
  205. package/dist/sessionCostReading.d.ts +70 -0
  206. package/dist/sessionCostReading.js +150 -0
  207. package/dist/sessionHooksRoster.d.ts +4 -0
  208. package/dist/sessionHooksRoster.js +158 -0
  209. package/dist/sessionIdSegment.d.ts +1 -0
  210. package/dist/sessionIdSegment.js +4 -1
  211. package/dist/sessionMemoryErase.js +2 -1
  212. package/dist/sessionMemoryStatus.js +2 -2
  213. package/dist/sessionReadRedaction.d.ts +7 -0
  214. package/dist/sessionReadRedaction.js +26 -0
  215. package/dist/sessionSyncFileHistory.js +8 -9
  216. package/dist/settingsHooksSalvage.js +2 -1
  217. package/dist/sha256Bytes.d.ts +1 -0
  218. package/dist/sha256Bytes.js +46 -0
  219. package/dist/skillOverrideChain.d.ts +83 -0
  220. package/dist/skillOverrideChain.js +378 -0
  221. package/dist/skillsWireCaps.d.ts +3 -0
  222. package/dist/skillsWireCaps.js +16 -1
  223. package/dist/sseIdleTriage.js +2 -1
  224. package/dist/storeDurabilityWord.d.ts +15 -0
  225. package/dist/storeDurabilityWord.js +18 -0
  226. package/dist/storePostureCapability.d.ts +7 -3
  227. package/dist/storePostureCapability.js +69 -39
  228. package/dist/subagent/engineSubagentResume.js +2 -2
  229. package/dist/subagent/engineSubagentTail.js +2 -1
  230. package/dist/subagentContentStore.d.ts +11 -0
  231. package/dist/subagentContentStore.js +28 -2
  232. package/dist/toolResult.d.ts +1 -0
  233. package/dist/toolResult.js +2 -0
  234. package/dist/turnFailurePresentation.js +4 -10
  235. package/dist/userAttachmentEnvelope.d.ts +2 -1
  236. package/dist/userAttachmentEnvelope.js +10 -0
  237. package/dist/wireErrorTriage.js +2 -1
  238. package/dist/wireFailureShape.d.ts +4 -0
  239. package/dist/wireFailureShape.js +141 -19
  240. package/dist/wireRefusalCopy.d.ts +6 -5
  241. package/dist/wireRefusalCopy.js +49 -92
  242. package/docs/INTEGRATION-CLIENTS.md +2718 -17
  243. package/package.json +7 -3
@@ -11,17 +11,30 @@ import type { ModelApiWord } from "./model/providerPresets.js";
11
11
  import type { LiveModelCatalog } from "./liveModelCatalog.js";
12
12
  import { type RewindMode } from "./rewindWireCaps.js";
13
13
  import { type ProbeVerdictWord } from "./modelCapabilityProbe.js";
14
+ import { type ModelPoolChannelSource } from "./localConfig/modelPoolWords.js";
15
+ import { type LocalConfigPreview, type LocalConfigReceipt } from "./localConfig/kernel.js";
16
+ import type { ModelPoolPlannedEntry, ModelPoolProblem, ModelPoolView } from "./localConfig/modelPool.js";
17
+ import type { PoolDeleteWarning } from "./model/modelSupplyRules.js";
18
+ import { type Tier } from "./model/tierVocabulary.js";
14
19
  import type { SubagentContentEvent } from "./subagentContentStore.js";
15
20
  import type { DeviceEnrollTokenOutcome, DeviceListOutcome, DeviceRebindOutcome, DeviceRevokeOutcome, DeviceSessionBindingOutcome, DeviceTransport, DeviceUnarmed, DeviceUnreadable } from "./deviceRebind.js";
16
21
  import type { McpPanelView } from "./mcpPanel.js";
17
22
  import type { WiringManifestModView } from "./adapter/downstream/eventToSdkMessage.js";
18
23
  import type { McpToolToggleKey } from "./mcpToolToggles.js";
24
+ import { type McpServerReportView, type McpServerEditOutcomeView, type McpServerProbeView } from "./localConfig/mcp/views.js";
25
+ import type { McpServerEdit } from "./localConfig/mcp/edit.js";
19
26
  import { type ThinkingLatchEvent, type ThinkingLatchRowWord } from "./thinkingLatchWords.js";
27
+ import type { SkillsEdit, SkillsView } from "./localConfig/skills.js";
20
28
  import type { SessionRowPatchFields, SessionRowUnreadable } from "./sessionRowTag.js";
21
29
  import { type SessionEngineKind, type SessionEngineView } from "./sessionEngine.js";
22
30
  import type { ParkedUnresumableRow } from "./hitl/parkedUnresumable.js";
23
31
  import { type EngineSwapCard } from "./localEngineSwapCard.js";
24
32
  import type { ToolPermissionSettledElsewhere } from "./hitl/approvalResolution.js";
33
+ import { type HookEntryTypeWord, type HookSettingsSource, type HooksWirePlan, type PluginHookExclusionReason, type PluginHookReason, type SettingsHookDropReason } from "./pluginHooksWire.js";
34
+ import { type HttpPolicyDropReason } from "./httpHookPolicy.js";
35
+ import { type HooksSalvageDropCode, type HooksSalvageRejectionCode } from "./settingsHooksSalvage.js";
36
+ import { SETTINGS_HOOK_EVENTS } from "./generated/settingsSchemaFns.js";
37
+ import type { ToolPermissionUnconfirmed, ToolPermissionUnconfirmedCause } from "./hitl/decisionSend.js";
25
38
  export interface SeatValidationFailure {
26
39
  reason: string;
27
40
  field?: string;
@@ -121,6 +134,8 @@ declare const CHROME_ARM_SEAT_ROUTE: {
121
134
  readonly engine_notice: "seat";
122
135
  readonly subagent_alias: "seat";
123
136
  readonly session_box_notice: "seat";
137
+ readonly resupply_truncated: "seat";
138
+ readonly host_setting_notice: "seat";
124
139
  readonly workflow_notification_enqueue: "host";
125
140
  readonly plan_review_park: "host";
126
141
  readonly approval_request: "host";
@@ -216,7 +231,7 @@ export type SeatStreamReading = {
216
231
  };
217
232
  export declare function seatStreamDeltaMessage(event: SeatStreamDeltaSource, ids: SeatStreamDeltaIds): SeatStreamEventMessage | undefined;
218
233
  export declare function readSeatStreamDelta(message: object): SeatStreamReading;
219
- export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView"];
234
+ export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster", "mcpServers", "mcpServerEdit", "skills", "skillsEdit", "modelPool", "modelPoolEdit"];
220
235
  export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
221
236
  export interface SeatCapabilitiesState {
222
237
  pickFolder?: boolean;
@@ -233,6 +248,14 @@ export interface SeatCapabilitiesState {
233
248
  seatActions?: boolean;
234
249
  notificationLevels?: boolean;
235
250
  modsView?: boolean;
251
+ quickEntryShortcut?: boolean;
252
+ hooksRoster?: boolean;
253
+ mcpServers?: boolean;
254
+ mcpServerEdit?: boolean;
255
+ skills?: boolean;
256
+ skillsEdit?: boolean;
257
+ modelPool?: boolean;
258
+ modelPoolEdit?: boolean;
236
259
  }
237
260
  export type SeatCapabilityReading = {
238
261
  readonly kind: "reported";
@@ -345,6 +368,11 @@ export interface SetThinkingLatchRequest {
345
368
  readonly sessionId: string;
346
369
  readonly event: ThinkingLatchEvent;
347
370
  }
371
+ export interface McpServerEditRequest {
372
+ readonly sessionId?: string;
373
+ readonly edit: McpServerEdit;
374
+ readonly dryRun?: true;
375
+ }
348
376
  export interface AttachmentUploadReceipt {
349
377
  id: string;
350
378
  name: string;
@@ -400,9 +428,29 @@ export interface StopAck {
400
428
  export interface OkAck {
401
429
  ok: boolean;
402
430
  }
403
- export interface ToolPermissionAck extends OkAck {
431
+ export type ToolPermissionAck = ToolPermissionAckSettled | ToolPermissionAckUnconfirmed;
432
+ export interface ToolPermissionAckSettled extends OkAck {
404
433
  settledElsewhere?: ToolPermissionSettledElsewhere;
434
+ unconfirmed?: never;
435
+ }
436
+ export interface ToolPermissionAckUnconfirmed extends OkAck {
437
+ ok: false;
438
+ unconfirmed: ToolPermissionUnconfirmed;
439
+ settledElsewhere?: never;
405
440
  }
441
+ export type ToolPermissionAckState = {
442
+ readonly kind: "applied";
443
+ } | {
444
+ readonly kind: "not_applied";
445
+ } | {
446
+ readonly kind: "unconfirmed";
447
+ readonly cause: ToolPermissionUnconfirmedCause;
448
+ };
449
+ export interface DecisionRefusalCarrier {
450
+ readonly [key: string]: DecisionRefusalCarrierValue;
451
+ }
452
+ export type DecisionRefusalCarrierValue = string | number | boolean | null | undefined | readonly DecisionRefusalCarrierValue[] | DecisionRefusalCarrier;
453
+ export type ToolPermissionRefusal = DecisionRefusalCarrier;
406
454
  export interface SessionsState {
407
455
  sessions: LocalSessionRecord[];
408
456
  }
@@ -502,7 +550,7 @@ export type SeatLocalMcpReading = {
502
550
  readAt: string;
503
551
  restartRequired?: true;
504
552
  };
505
- export declare const LOCAL_ENGINE_DOWN_REASONS: readonly ["lock-unavailable", "spawn-failed", "spawn-refused", "stop-failed", "crash-loop", "high-water-unreadable", "principal-unknown"];
553
+ export declare const LOCAL_ENGINE_DOWN_REASONS: readonly ["lock-unavailable", "spawn-failed", "spawn-refused", "stop-failed", "crash-loop", "high-water-unreadable", "exited-once", "principal-unknown"];
506
554
  export type LocalEngineDownReason = (typeof LOCAL_ENGINE_DOWN_REASONS)[number];
507
555
  export declare const LOCAL_ENGINE_WAITING_REASONS: readonly ["starting", "dormant", "draining", "unanswered", "peer"];
508
556
  export type LocalEngineWaitingReason = (typeof LOCAL_ENGINE_WAITING_REASONS)[number];
@@ -541,7 +589,7 @@ export interface EngineTargetState {
541
589
  mode: "local" | "cloud";
542
590
  generation: number;
543
591
  cloud: EngineTargetCloud;
544
- local: EngineTargetLocal;
592
+ local?: EngineTargetLocal;
545
593
  }
546
594
  export interface EngineTargetRefused {
547
595
  ok: false;
@@ -615,6 +663,7 @@ export interface OnboardProbeResult {
615
663
  verdict: OnboardProbeVerdict;
616
664
  detail: string;
617
665
  thinking?: string;
666
+ firstOutputMs?: number;
618
667
  }
619
668
  export interface OnboardCatalogIssue {
620
669
  name: string;
@@ -650,6 +699,7 @@ export interface OnboardProviderRow {
650
699
  authEnv: string;
651
700
  models: OnboardProviderModel[];
652
701
  consoleUrl?: string;
702
+ signupUrl?: string;
653
703
  }
654
704
  export interface OnboardImportableProfile {
655
705
  id: string;
@@ -666,9 +716,153 @@ export interface OnboardProvidersResult {
666
716
  }
667
717
  export declare const checkOnboardEntryRequest: (v: unknown) => SeatValidation;
668
718
  export declare const checkOnboardApplyRequest: (v: unknown) => SeatValidation;
719
+ export interface SeatModelPoolEntry {
720
+ modelId: string;
721
+ api: ModelApiWord;
722
+ baseUrl: string;
723
+ credential: {
724
+ kind: "key";
725
+ apiKey: string;
726
+ } | {
727
+ kind: "none";
728
+ };
729
+ label?: string;
730
+ vision?: boolean;
731
+ contextWindow?: number;
732
+ maxTokens?: number;
733
+ channel?: string;
734
+ acceptUnverified?: boolean;
735
+ }
736
+ export type SeatModelPoolEdit = {
737
+ kind: "add";
738
+ entries: SeatModelPoolEntry[];
739
+ defaultIndex?: number;
740
+ } | {
741
+ kind: "update";
742
+ name: string;
743
+ label?: string | null;
744
+ vision?: boolean | null;
745
+ contextWindow?: number;
746
+ maxTokens?: number;
747
+ } | {
748
+ kind: "remove";
749
+ name: string;
750
+ } | {
751
+ kind: "setDefault";
752
+ name: string;
753
+ } | {
754
+ kind: "importEnvModels";
755
+ } | {
756
+ kind: "importChannel";
757
+ source: ModelPoolChannelSource;
758
+ profileId: string;
759
+ modelIds: string[];
760
+ defaultIndex?: number;
761
+ acceptUnverified?: boolean;
762
+ } | {
763
+ kind: "bindTier";
764
+ group: string;
765
+ tier: Tier;
766
+ name: string | null;
767
+ } | {
768
+ kind: "switchTierGroup";
769
+ group: string;
770
+ } | {
771
+ kind: "addTierGroup";
772
+ group: string;
773
+ tiers?: Partial<Record<Tier, string>>;
774
+ } | {
775
+ kind: "removeTierGroup";
776
+ group: string;
777
+ } | {
778
+ kind: "migrateTierGroups";
779
+ } | {
780
+ kind: "sweepOrphanKeySlots";
781
+ };
782
+ export interface ModelPoolEditRequest {
783
+ edit: SeatModelPoolEdit;
784
+ dryRun?: boolean;
785
+ }
786
+ export interface ModelPoolEditResult {
787
+ receipt: LocalConfigReceipt | LocalConfigPreview;
788
+ problems?: ModelPoolProblem[];
789
+ entries?: ModelPoolPlannedEntry[];
790
+ warnings?: PoolDeleteWarning[];
791
+ otherIssues?: OnboardCatalogIssue[];
792
+ engine?: EngineRestartOutcome;
793
+ }
794
+ export type ModelPoolListResult = ModelPoolView | Extract<LocalConfigReceipt, {
795
+ readonly kind: "unavailable";
796
+ }>;
797
+ export interface ModelDiscoveryRequest {
798
+ source: OnboardSource;
799
+ baseUrl?: string;
800
+ api?: ModelApiWord;
801
+ apiKey?: string;
802
+ }
803
+ export interface ModelDiscoveryCandidate {
804
+ id: string;
805
+ contextWindow?: number;
806
+ maxTokens?: number;
807
+ }
808
+ export type ModelDiscoveryResult = {
809
+ ok: true;
810
+ candidates: ModelDiscoveryCandidate[];
811
+ } | {
812
+ ok: false;
813
+ verdict: OnboardProbeVerdict;
814
+ detail: string;
815
+ };
816
+ export declare const checkModelPoolEditRequest: (v: unknown) => SeatValidation;
817
+ export declare const checkModelDiscoveryRequest: (v: unknown) => SeatValidation;
669
818
  export interface SessionModsView {
670
819
  readonly rows: readonly WiringManifestModView[];
671
820
  }
821
+ export declare const SESSION_HOOKS_ROSTER_STATUSES: readonly ["engine", "shell", "not_run"];
822
+ export type SessionHooksRosterStatus = (typeof SESSION_HOOKS_ROSTER_STATUSES)[number];
823
+ export type SessionHooksRosterEvent = (typeof SETTINGS_HOOK_EVENTS)[number];
824
+ export interface SessionHooksRosterRow {
825
+ readonly source: HookSettingsSource;
826
+ readonly event: SessionHooksRosterEvent;
827
+ readonly groupIndex: number;
828
+ readonly hookIndex: number;
829
+ readonly type?: HookEntryTypeWord;
830
+ readonly status: SessionHooksRosterStatus;
831
+ readonly reason: PluginHookReason | PluginHookExclusionReason | SettingsHookDropReason;
832
+ }
833
+ export type SessionHooksRosterLayer = {
834
+ readonly source: HookSettingsSource;
835
+ readonly state: "loaded-partial";
836
+ readonly codes: readonly HooksSalvageDropCode[];
837
+ } | {
838
+ readonly source: HookSettingsSource;
839
+ readonly state: "rejected";
840
+ readonly codes: readonly HooksSalvageRejectionCode[];
841
+ } | {
842
+ readonly source: HookSettingsSource;
843
+ readonly state: "trust_withheld";
844
+ };
845
+ export interface SessionHooksRosterHttpRow {
846
+ readonly source: HookSettingsSource;
847
+ readonly event: SessionHooksRosterEvent;
848
+ readonly reason: HttpPolicyDropReason;
849
+ }
850
+ export interface SessionHooksRoster {
851
+ readonly closedBy: HooksWirePlan["closedBy"];
852
+ readonly sources?: readonly HookSettingsSource[];
853
+ readonly rows: readonly SessionHooksRosterRow[];
854
+ readonly layers: readonly SessionHooksRosterLayer[];
855
+ readonly http: readonly SessionHooksRosterHttpRow[];
856
+ readonly unlisted: number;
857
+ }
858
+ export interface ListSkillsRequest {
859
+ readonly sessionId?: string;
860
+ }
861
+ export interface EditSkillsRequest {
862
+ readonly sessionId?: string;
863
+ readonly edit: SkillsEdit;
864
+ readonly dryRun?: boolean;
865
+ }
672
866
  export declare const checkMcpToolToggleKey: (v: unknown) => SeatValidation;
673
867
  export interface McpToolTogglesResult {
674
868
  off: McpToolToggleKey[];
@@ -736,7 +930,35 @@ export type SetNotificationLevelPlan = {
736
930
  readonly reason: Exclude<NotificationLevelRefusalReason, "write-failed">;
737
931
  };
738
932
  export declare function planSetNotificationLevel(type: {} | null | undefined, level: {} | null | undefined, supported: readonly NotificationLevel[]): SetNotificationLevelPlan;
739
- export declare const SEAT_ACTION_NAMES: readonly ["new-project", "prefill-composer"];
933
+ export declare const QUICK_ENTRY_SHORTCUT_FAILURES: readonly ["invalid-accelerator", "registration-failed"];
934
+ export type QuickEntryShortcutFailure = (typeof QUICK_ENTRY_SHORTCUT_FAILURES)[number];
935
+ export declare const QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS: readonly ["invalid-request", "invalid-accelerator", "registration-failed", "write-failed"];
936
+ export type QuickEntryShortcutRefusalReason = (typeof QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS)[number];
937
+ export type QuickEntryShortcut = "off" | {
938
+ readonly accelerator: string;
939
+ };
940
+ export interface QuickEntryShortcutState {
941
+ saved: QuickEntryShortcut;
942
+ active: string | null;
943
+ savedFailure: QuickEntryShortcutFailure | null;
944
+ }
945
+ export type SetQuickEntryShortcutResult = {
946
+ ok: true;
947
+ state: QuickEntryShortcutState;
948
+ } | {
949
+ ok: false;
950
+ reason: QuickEntryShortcutRefusalReason;
951
+ state: QuickEntryShortcutState;
952
+ };
953
+ export type SetQuickEntryShortcutPlan = {
954
+ readonly kind: "apply";
955
+ readonly next: QuickEntryShortcut;
956
+ } | {
957
+ readonly kind: "refused";
958
+ readonly reason: "invalid-request";
959
+ };
960
+ export declare function planSetQuickEntryShortcut(request: {} | null | undefined): SetQuickEntryShortcutPlan;
961
+ export declare const SEAT_ACTION_NAMES: readonly ["new-project", "prefill-composer", "open-local-setup"];
740
962
  export type SeatActionName = (typeof SEAT_ACTION_NAMES)[number];
741
963
  export type SeatAction = {
742
964
  readonly action: "new-project";
@@ -744,6 +966,8 @@ export type SeatAction = {
744
966
  readonly action: "prefill-composer";
745
967
  readonly text: string;
746
968
  readonly cwd?: string;
969
+ } | {
970
+ readonly action: "open-local-setup";
747
971
  };
748
972
  export interface SeatActionsClaim {
749
973
  readonly actions: readonly string[];
@@ -798,6 +1022,9 @@ export interface LocalSessionsApi {
798
1022
  listOnboardProviders(): Promise<OnboardProvidersResult>;
799
1023
  probeOnboardEntry(req: OnboardEntryRequest): Promise<OnboardProbeResult>;
800
1024
  applyOnboardEntry(req: OnboardApplyRequest): Promise<OnboardApplyResult>;
1025
+ listModelPool(): Promise<ModelPoolListResult>;
1026
+ editModelPool(req: ModelPoolEditRequest): Promise<ModelPoolEditResult>;
1027
+ discoverModels(req: ModelDiscoveryRequest): Promise<ModelDiscoveryResult>;
801
1028
  readSessionMcpPanel(sessionId: string): Promise<McpPanelView | DeviceUnreadable | DeviceTransport | DeviceUnarmed>;
802
1029
  listMcpToolToggles(): Promise<McpToolTogglesResult>;
803
1030
  setMcpToolToggle(key: McpToolToggleKey, enabled: boolean): Promise<OkAck>;
@@ -806,8 +1033,27 @@ export interface LocalSessionsApi {
806
1033
  setComputerUse(req: SetComputerUseRequest): Promise<SetComputerUseResult>;
807
1034
  getNotificationLevels(): Promise<NotificationLevelsState>;
808
1035
  setNotificationLevel(type: NotificationLevelType, level: NotificationLevel): Promise<SetNotificationLevelResult>;
1036
+ getQuickEntryShortcut(): Promise<QuickEntryShortcutState>;
1037
+ setQuickEntryShortcut(next: QuickEntryShortcut): Promise<SetQuickEntryShortcutResult>;
809
1038
  claimSeatActions(req: SeatActionsClaim): Promise<OkAck>;
1039
+ listMcpServers(req: {
1040
+ readonly sessionId?: string;
1041
+ }): Promise<McpServerReportView | Extract<LocalConfigReceipt, {
1042
+ readonly kind: "unavailable";
1043
+ }>>;
1044
+ probeMcpServerEntry(req: {
1045
+ readonly sessionId?: string;
1046
+ readonly edit: McpServerEdit;
1047
+ }): Promise<McpServerProbeView>;
1048
+ editMcpServer(req: McpServerEditRequest): Promise<McpServerEditOutcomeView>;
810
1049
  readSessionMods(sessionId: string): Promise<SessionModsView | DeviceUnreadable | DeviceUnarmed>;
1050
+ readSessionHooksRoster(sessionId: string): Promise<SessionHooksRoster | DeviceUnreadable | DeviceUnarmed>;
1051
+ listSkills(req: ListSkillsRequest): Promise<SkillsView | Extract<LocalConfigReceipt, {
1052
+ readonly kind: "unavailable";
1053
+ }>>;
1054
+ editSkills(req: EditSkillsRequest): Promise<{
1055
+ receipt: LocalConfigReceipt | LocalConfigPreview;
1056
+ }>;
811
1057
  onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
812
1058
  onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
813
1059
  onSeatAction(cb: (action: SeatAction) => void): () => void;
@@ -857,8 +1103,9 @@ export declare const checkStartSessionOptions: (v: unknown) => SeatValidation;
857
1103
  export declare const checkSeatResourceScope: (v: unknown) => SeatValidation;
858
1104
  export declare function isSendMessageAck(v: unknown): v is SendMessageAck;
859
1105
  export declare function readToolPermissionSettledElsewhere(ack: object | null | undefined): ToolPermissionSettledElsewhere | undefined;
1106
+ export declare function readToolPermissionAckState(ack: ToolPermissionAck | null | undefined): ToolPermissionAckState | undefined;
860
1107
  export declare const LOCAL_SESSIONS_SPEC: EipcServiceSpec;
861
- export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "answerEngineSwap", "beginSelfUpgrade", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "getNotificationLevels", "setNotificationLevel", "claimSeatActions", "readSessionMods", "onEvent", "onToolPermissionRequest", "onSeatAction"];
1108
+ export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "answerEngineSwap", "beginSelfUpgrade", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "listModelPool", "editModelPool", "discoverModels", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "getNotificationLevels", "setNotificationLevel", "getQuickEntryShortcut", "setQuickEntryShortcut", "claimSeatActions", "readSessionMods", "readSessionHooksRoster", "listMcpServers", "probeMcpServerEntry", "editMcpServer", "listSkills", "editSkills", "onEvent", "onToolPermissionRequest", "onSeatAction"];
862
1109
  export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
863
1110
  export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest", "onSeatAction"];
864
1111
  export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure", "subagentContent"];
@@ -1003,6 +1250,9 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
1003
1250
  }, {
1004
1251
  readonly key: "aliases";
1005
1252
  readonly why: "受理面(0.108.0 CC-944;除行名之外引擎还认的模型词),读法归 modelAcceptanceOf(缺席 = 更早的服务端,照旧判;在场而坏形 ⇒ 没找到行的词读 catalog_unreadable);出站门为它拒掉整份目录 = 选单为一份受理数据整个消失。";
1253
+ }, {
1254
+ readonly key: "unreadableRows";
1255
+ readonly why: "完整性面(0.112.0 CC-1229;回体读口丢掉的行数,`> 0` 才在场),读法归 modelAcceptanceOf 的读不全判(非正数 / 非数一律不算丢行);出站门为它拒掉整份目录 = 选单为一个计数整个消失。";
1006
1256
  }];
1007
1257
  };
1008
1258
  readonly SendMessageRequest: {
@@ -1066,7 +1316,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
1066
1316
  };
1067
1317
  readonly ToolPermissionAck: {
1068
1318
  readonly check: (v: unknown) => SeatValidation;
1069
- readonly validated: readonly ["ok", "settledElsewhere"];
1319
+ readonly validated: readonly ["ok", "settledElsewhere", "unconfirmed"];
1070
1320
  readonly unchecked: readonly [];
1071
1321
  };
1072
1322
  readonly GetTranscriptResult: {
@@ -1096,7 +1346,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
1096
1346
  };
1097
1347
  readonly SeatCapabilitiesState: {
1098
1348
  readonly check: (v: unknown) => SeatValidation;
1099
- readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView"];
1349
+ readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster", "mcpServers", "mcpServerEdit", "skills", "skillsEdit", "modelPool", "modelPoolEdit"];
1100
1350
  readonly unchecked: readonly [];
1101
1351
  };
1102
1352
  readonly RecentFoldersResult: {
@@ -1136,7 +1386,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
1136
1386
  };
1137
1387
  };
1138
1388
  export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [...{
1139
- label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "NotificationLevelsState" | "SetNotificationLevelResult" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome" | "SessionModsResult";
1389
+ label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "NotificationLevelsState" | "SetNotificationLevelResult" | "ModelPoolListResult" | "ModelPoolEditResult" | "ModelDiscoveryResult" | "ModelPoolEditRequest" | "ModelDiscoveryRequest" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome" | "SessionModsResult" | "QuickEntryShortcutState" | "SetQuickEntryShortcutResult" | "SessionHooksRosterResult" | "McpServersListResult" | "McpServerProbeResult" | "McpServerEditResult" | "ListSkillsResult" | "EditSkillsResult";
1140
1390
  check: (v: unknown) => SeatValidation;
1141
1391
  why: string;
1142
1392
  }[], {