@sema-agent/client-core 0.93.0 → 0.94.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 (156) hide show
  1. package/CHANGELOG.md +261 -0
  2. package/README.md +31 -18
  3. package/dist/adapt/arms.js +8 -5
  4. package/dist/adapter/downstream/terminalToSdkResult.js +2 -3
  5. package/dist/agentSession/engineSessionBackgroundStop.js +2 -1
  6. package/dist/agentsWireCaps.d.ts +15 -0
  7. package/dist/agentsWireCaps.js +111 -1
  8. package/dist/approvalReachWire.d.ts +18 -0
  9. package/dist/approvalReachWire.js +58 -0
  10. package/dist/approvalsStreamLiveCapability.js +16 -11
  11. package/dist/callerCwdCapability.d.ts +16 -0
  12. package/dist/callerCwdCapability.js +47 -0
  13. package/dist/controlRouter.js +3 -10
  14. package/dist/coreValuePorts.d.ts +64 -1
  15. package/dist/coreValuePorts.js +30 -0
  16. package/dist/detachWire.d.ts +1 -4
  17. package/dist/detachWire.js +1 -1
  18. package/dist/deviceExecutorManagementCapability.js +39 -34
  19. package/dist/deviceFlowPolling.d.ts +5 -0
  20. package/dist/deviceFlowPolling.js +28 -0
  21. package/dist/displayUntrusted.js +652 -21
  22. package/dist/engineErrorCodes.d.ts +5 -1
  23. package/dist/engineErrorCodes.js +9 -12
  24. package/dist/engineNoticeCodes.d.ts +22 -2
  25. package/dist/engineNoticeCodes.js +73 -6
  26. package/dist/engineRefusedToolName.d.ts +1 -0
  27. package/dist/engineRefusedToolName.js +8 -0
  28. package/dist/executionLaneCapability.js +14 -9
  29. package/dist/fileHistoryCaptureCapability.js +14 -9
  30. package/dist/fileHistoryLegNotice.d.ts +11 -0
  31. package/dist/fileHistoryLegNotice.js +50 -13
  32. package/dist/fleet/fleetLedger.js +5 -0
  33. package/dist/gateOutcome.d.ts +2 -1
  34. package/dist/gateOutcome.js +3 -0
  35. package/dist/gateVocabulary.js +1 -1
  36. package/dist/generated/engineAskFaceTables.d.ts +3 -0
  37. package/dist/generated/engineAskFaceTables.js +12 -0
  38. package/dist/generated/engineFactTables.d.ts +4 -2
  39. package/dist/generated/engineFactTables.js +13 -0
  40. package/dist/generated/engineNoticeTables.d.ts +5 -0
  41. package/dist/generated/engineNoticeTables.js +7 -0
  42. package/dist/generated/sdkFactTables.d.ts +3 -0
  43. package/dist/generated/sdkFactTables.js +17 -0
  44. package/dist/generated/settingsSchemaTables.d.ts +3 -0
  45. package/dist/generated/settingsSchemaTables.js +3 -0
  46. package/dist/headlessPermissionModeWire.d.ts +2 -2
  47. package/dist/headlessPermissionModeWire.js +11 -21
  48. package/dist/hitl/approvalHolds.d.ts +36 -0
  49. package/dist/hitl/approvalHolds.js +89 -0
  50. package/dist/hitl/approvalOutcomeNote.js +2 -1
  51. package/dist/hitl/approvalResolution.d.ts +3 -2
  52. package/dist/hitl/approvalResolution.js +21 -0
  53. package/dist/hitl/approvalsFeed.js +5 -0
  54. package/dist/hitl/askGateWire.js +3 -0
  55. package/dist/hitl/automaticAnswerVerdict.d.ts +8 -2
  56. package/dist/hitl/automaticAnswerVerdict.js +69 -21
  57. package/dist/hitl/decisionRefusal.d.ts +19 -0
  58. package/dist/hitl/decisionRefusal.js +63 -0
  59. package/dist/hitl/frameRouter.d.ts +10 -0
  60. package/dist/hitl/frameRouter.js +59 -3
  61. package/dist/hitl/gateLedger.d.ts +3 -0
  62. package/dist/hitl/gateLedger.js +17 -0
  63. package/dist/hitl/hitlBridge.d.ts +2 -2
  64. package/dist/hitl/hitlBridge.js +8 -10
  65. package/dist/hitl/hitlHostSurface.d.ts +6 -0
  66. package/dist/hitl/hitlHostSurface.js +25 -4
  67. package/dist/hitl/localAllowRule.js +2 -1
  68. package/dist/hitl/noAllowCause.d.ts +9 -0
  69. package/dist/hitl/noAllowCause.js +26 -0
  70. package/dist/hitl/parkResolver.js +6 -3
  71. package/dist/hitl/parkRowBirthWait.js +2 -1
  72. package/dist/hitl/persistedRulesWire.d.ts +6 -1
  73. package/dist/hitl/persistedRulesWire.js +12 -4
  74. package/dist/hitl/planReviewWire.d.ts +0 -1
  75. package/dist/hitl/planReviewWire.js +30 -9
  76. package/dist/hitl/sessionPolicyDeliverable.d.ts +1 -1
  77. package/dist/hitl/sessionPolicyDeliverable.js +3 -8
  78. package/dist/hitl/sessionPolicyWire.js +1 -1
  79. package/dist/hitl/toolApprovalWire.d.ts +37 -2
  80. package/dist/hitl/toolApprovalWire.js +392 -13
  81. package/dist/humanTurnRead.d.ts +15 -1
  82. package/dist/humanTurnRead.js +28 -2
  83. package/dist/index.d.ts +18 -6
  84. package/dist/index.js +14 -5
  85. package/dist/limitsWire.d.ts +0 -1
  86. package/dist/limitsWire.js +2 -10
  87. package/dist/liveModelCatalog.d.ts +14 -0
  88. package/dist/liveModelCatalog.js +61 -0
  89. package/dist/mcpProbeCapability.js +14 -9
  90. package/dist/mcpReconnect.js +13 -8
  91. package/dist/memoryComplianceCapability.js +15 -10
  92. package/dist/memoryOriginCapability.js +15 -10
  93. package/dist/modelIdentityResolvability.d.ts +4 -2
  94. package/dist/modelIdentityResolvability.js +31 -4
  95. package/dist/outputStyleSeatCapability.d.ts +16 -0
  96. package/dist/outputStyleSeatCapability.js +47 -0
  97. package/dist/ownKey.d.ts +1 -0
  98. package/dist/ownKey.js +10 -0
  99. package/dist/peerLaneCapability.js +16 -11
  100. package/dist/permissionRuleIssue.js +1 -1
  101. package/dist/permissionRulesWriteCapability.js +16 -11
  102. package/dist/permissionsAllowGrantCapability.d.ts +2 -0
  103. package/dist/permissionsAllowGrantCapability.js +38 -16
  104. package/dist/permissionsDeclaration.d.ts +10 -1
  105. package/dist/permissionsDeclaration.js +97 -15
  106. package/dist/protocolSegment.d.ts +1 -0
  107. package/dist/protocolSegment.js +13 -1
  108. package/dist/request/taskRequest.d.ts +11 -3
  109. package/dist/request/taskRequest.js +13 -1
  110. package/dist/resultFrameKeys.d.ts +4 -0
  111. package/dist/resultFrameKeys.js +13 -0
  112. package/dist/resumeRefusalCopy.js +6 -16
  113. package/dist/retryStatus.js +6 -4
  114. package/dist/rewindArchiveCapability.js +13 -8
  115. package/dist/{hitl/rosterMountedNames.d.ts → rosterMountedNames.d.ts} +1 -1
  116. package/dist/runCancelContext.js +2 -1
  117. package/dist/sealedKeyCapability.js +19 -14
  118. package/dist/seatContract.d.ts +33 -5
  119. package/dist/seatContract.js +143 -2
  120. package/dist/sessionPolicyCapability.js +15 -10
  121. package/dist/sessionReadRedactionCapability.d.ts +16 -0
  122. package/dist/sessionReadRedactionCapability.js +47 -0
  123. package/dist/sessionSyncFileHistoryCapability.js +14 -9
  124. package/dist/skillToolListsCapability.js +14 -9
  125. package/dist/sqlEngineCapability.js +18 -13
  126. package/dist/steerPriorityCapability.js +21 -16
  127. package/dist/subagent/agentStateDetail.d.ts +1 -0
  128. package/dist/subagent/agentStateDetail.js +41 -0
  129. package/dist/subagent/engineCompactWire.d.ts +15 -0
  130. package/dist/subagent/engineCompactWire.js +75 -13
  131. package/dist/supportFloor.js +1 -1
  132. package/dist/taskRequestWords.d.ts +2 -4
  133. package/dist/taskRequestWords.js +3 -2
  134. package/dist/types/engineState.d.ts +1 -1
  135. package/dist/userAttachmentEnvelope.d.ts +22 -1
  136. package/dist/userAttachmentEnvelope.js +90 -2
  137. package/dist/userInvokedSkillsCapability.js +14 -9
  138. package/dist/webSearchBackendCapability.js +21 -16
  139. package/dist/wireErrorTriage.d.ts +11 -0
  140. package/dist/wireErrorTriage.js +35 -0
  141. package/dist/wireFailureShape.d.ts +6 -0
  142. package/dist/wireFailureShape.js +30 -3
  143. package/dist/wireRefusalCopy.d.ts +6 -1
  144. package/dist/wireRefusalCopy.js +22 -8
  145. package/dist/wiringInstructionsAttribution.d.ts +10 -0
  146. package/dist/wiringInstructionsAttribution.js +67 -0
  147. package/dist/workflowClient.js +22 -1
  148. package/dist/workflowsJournalCapability.js +14 -9
  149. package/dist/writeProtectionCapability.js +28 -23
  150. package/docs/INTEGRATION-CLIENTS.md +817 -45
  151. package/package.json +5 -5
  152. package/dist/askSurvivesStandingAnswer.d.ts +0 -13
  153. package/dist/askSurvivesStandingAnswer.js +0 -53
  154. package/dist/hitl/askSurvivesPosture.d.ts +0 -20
  155. package/dist/hitl/askSurvivesPosture.js +0 -48
  156. /package/dist/{hitl/rosterMountedNames.js → rosterMountedNames.js} +0 -0
@@ -15,7 +15,7 @@ export interface SessionPolicyDeliverability {
15
15
  export interface SessionPolicyDeliverableOptions {
16
16
  readonly roster?: ToolRosterView;
17
17
  }
18
- export declare function isEngineRefusedToolName(name: string): boolean;
18
+ export { isEngineRefusedToolName } from '../engineRefusedToolName.js';
19
19
  export declare function sessionPolicyDeliverable(behavior: 'deny' | 'ask', rules: readonly string[], opts?: SessionPolicyDeliverableOptions): SessionPolicyDeliverability;
20
20
  export declare function sessionPolicyWithheldNotice(why: SessionPolicyWithheldWhy): string;
21
21
  export declare function legacyToolNameFailureNoteOf(code: string | undefined): string | undefined;
@@ -1,9 +1,10 @@
1
1
  import { CONFIG_LEGACY_TOOL_NAME, RULES_LEGACY_TOOL_NAME } from '../engineErrorCodes.js';
2
- import { rosterMountedNames } from './rosterMountedNames.js';
2
+ import { rosterMountedNames } from '../rosterMountedNames.js';
3
3
  import { ruleCompileVerdict } from '../ruleCompileVerdict.js';
4
4
  import { protocolSegmentOf } from '../protocolSegment.js';
5
5
  import { PREFIXES_IN_PROSE, REFUSED_NAME_CLASSES, REFUSED_NAME_FIX, RULES_LEGACY_TOOL_NAME_WRITE_NOTE } from './refusedToolNameProse.js';
6
6
  import { CORE_PROTOCOL_PREFIXES, CORE_RETIRED_TOOL_CURRENT_NAMES } from '../generated/toolNameTables.js';
7
+ import { isEngineRefusedToolName } from '../engineRefusedToolName.js';
7
8
  const COVERING_NAMESPACE_PREFIXES = CORE_PROTOCOL_PREFIXES;
8
9
  const ENGINE_RETIRED_TOOL_NAMES = CORE_RETIRED_TOOL_CURRENT_NAMES;
9
10
  const WITHHELD_NOTICE = {
@@ -40,13 +41,7 @@ function withheldWhyOf(rule) {
40
41
  return 'legacy_tool_name';
41
42
  return undefined;
42
43
  }
43
- export function isEngineRefusedToolName(name) {
44
- if (typeof name !== 'string')
45
- return false;
46
- if (ENGINE_RETIRED_TOOL_NAMES.has(name))
47
- return true;
48
- return name.includes('__') && !COVERING_NAMESPACE_PREFIXES.some((prefix) => name.startsWith(prefix));
49
- }
44
+ export { isEngineRefusedToolName } from '../engineRefusedToolName.js';
50
45
  function suppliedRosterNames(opts) {
51
46
  if (opts === undefined || opts === null)
52
47
  return 'absent';
@@ -3,7 +3,7 @@ import { hostLog } from '../host.js';
3
3
  import { isEngineRefusedToolName } from './sessionPolicyDeliverable.js';
4
4
  import { RULES_LEGACY_TOOL_NAME_WRITE_NOTE } from './refusedToolNameProse.js';
5
5
  import { RULES_LEGACY_TOOL_NAME, isRulesRefusalCode } from '../engineErrorCodes.js';
6
- import { rosterMountedNames } from './rosterMountedNames.js';
6
+ import { rosterMountedNames } from '../rosterMountedNames.js';
7
7
  import { CORE_RULE_TOOL_NAME_VERDICTS } from '../generated/engineFactTables.js';
8
8
  function isLegacyToolNameVerdict(v) {
9
9
  return typeof v === 'string' && v !== 'current' && CORE_RULE_TOOL_NAME_VERDICTS.includes(v);
@@ -6,7 +6,7 @@ import { type DenyAttributionRefusalDetail } from '../wireRefusalCopy.js';
6
6
  import { type ApprovalDecidedByReading } from '../approvalDecidedByCapability.js';
7
7
  import { type DecideReceiptView } from '../decideReceipt.js';
8
8
  import { RULE_OFFER_MATCHES, RULE_OFFER_BATCH_MEMBER_KINDS, RULE_OFFER_UNCOVERED_REASONS, RULE_OFFERS_ABSENCE_REASONS } from '@sema-agent/sdk';
9
- import type { ToolApprovalRespondAck, PersistedRuleAnchor as SdkPersistedRuleAnchor, RuleOfferMatch as SdkRuleOfferMatch, RuleOfferBatchMember as SdkRuleOfferBatchMember, RuleOfferUncoveredDetail as SdkRuleOfferUncoveredDetail, RuleOfferUncoveredReason as SdkRuleOfferUncoveredReason, AskOrigin as SdkAskOrigin, RuleOffersAbsence as SdkRuleOffersAbsence, DenialLimitKind as SdkDenialLimitKind, DenialLimitFallback as SdkDenialLimitFallback } from '@sema-agent/sdk';
9
+ import type { ApprovalDecidedBy, ToolApprovalRespondAck, PersistedRuleAnchor as SdkPersistedRuleAnchor, RuleOfferMatch as SdkRuleOfferMatch, RuleOfferBatchMember as SdkRuleOfferBatchMember, RuleOfferUncoveredDetail as SdkRuleOfferUncoveredDetail, RuleOfferUncoveredReason as SdkRuleOfferUncoveredReason, AskOrigin as SdkAskOrigin, RuleOffersAbsence as SdkRuleOffersAbsence, DenialLimitKind as SdkDenialLimitKind, DenialLimitFallback as SdkDenialLimitFallback } from '@sema-agent/sdk';
10
10
  export declare function isFsApprovalGate(gate: {
11
11
  kind?: unknown;
12
12
  toolName?: unknown;
@@ -26,12 +26,15 @@ export type FsApprovalOutcome = {
26
26
  denyAttributionDropped?: true;
27
27
  denyAttributionRenamed?: true;
28
28
  receipt?: DecideReceiptView | undefined;
29
+ joinedInFlight?: true;
29
30
  } | {
30
31
  kind: 'aborted';
31
32
  gatedCallId?: string | undefined;
33
+ joinedInFlight?: true;
32
34
  } | {
33
35
  kind: 'retracted';
34
36
  gatedCallId?: string | undefined;
37
+ joinedInFlight?: true;
35
38
  } | {
36
39
  kind: 'failed';
37
40
  stage: HitlFailureStage;
@@ -45,6 +48,7 @@ export type FsApprovalOutcome = {
45
48
  currentPending?: GateCurrentPending | undefined;
46
49
  denyAttributionRefusal?: DenyAttributionRefusalDetail | undefined;
47
50
  editRefused?: true;
51
+ joinedInFlight?: true;
48
52
  };
49
53
  export interface FsApprovalWireDeps {
50
54
  client: HitlClientLike;
@@ -153,6 +157,15 @@ export interface ApprovalCardRequest {
153
157
  origin?: string;
154
158
  askClass?: string;
155
159
  classes?: readonly string[];
160
+ boundGrants?: BoundSkillGrantsWire;
161
+ classifierNoRuling?: string;
162
+ priorCardsForCall?: readonly ApprovalPriorCard[];
163
+ }
164
+ export interface ApprovalPriorCard {
165
+ readonly approvalId?: string;
166
+ readonly origin?: string;
167
+ readonly mandate?: ApprovalMandateWord;
168
+ readonly outcome?: 'allowed' | 'denied';
156
169
  }
157
170
  export type ApprovalCardPort = (req: ApprovalCardRequest) => Promise<ApprovalCardDecision>;
158
171
  export declare function installApprovalCardPort(port: ApprovalCardPort | null): () => void;
@@ -240,12 +253,25 @@ export interface RespondToolApprovalOpts {
240
253
  persistRuleBatchOfferIndex?: number;
241
254
  note?: string;
242
255
  settledBy?: 'policy';
243
- decidedBy?: 'policy';
256
+ decidedBy?: Extract<ApprovalDecidedBy, 'policy'>;
244
257
  }
245
258
  export type RespondToolApprovalFn = (approvalId: string, decision: ToolApprovalRespondDecision, opts?: RespondToolApprovalOpts) => Promise<ToolApprovalRespondAck | void>;
246
259
  export type ToolApprovalRespondAckView = ToolApprovalRespondAck;
247
260
  export type PersistedRuleAnchor = SdkPersistedRuleAnchor;
248
261
  export declare function readToolApprovalRespondAck(v: unknown): ToolApprovalRespondAckView | undefined;
262
+ export interface ToolApprovalRespondParkingView {
263
+ readonly approvalId: string;
264
+ readonly retryAfterMs?: number;
265
+ readonly decidePath?: string;
266
+ readonly message?: string;
267
+ }
268
+ export type ToolApprovalParkingBodyReading = {
269
+ readonly kind: 'parking';
270
+ readonly view: ToolApprovalRespondParkingView;
271
+ } | {
272
+ readonly kind: 'claimed_unreadable';
273
+ };
274
+ export declare function readToolApprovalRespondParking(v: unknown): ToolApprovalParkingBodyReading | undefined;
249
275
  export declare function decisionAttributionKeyOf(reading: ApprovalDecidedByReading | undefined, denySettledBy: ApprovalDenySettledBy | undefined): {
250
276
  decidedBy: 'policy';
251
277
  } | {
@@ -257,11 +283,14 @@ export interface ToolApprovalFrameOutcome {
257
283
  respondRefusal?: ToolApprovalRespondRefusal;
258
284
  editRefused?: true;
259
285
  retracted?: true;
286
+ aborted?: true;
287
+ joinedInFlight?: true;
260
288
  denySettledBy?: ApprovalDenySettledBy;
261
289
  denyReason?: string;
262
290
  denyAttributionRefusal?: DenyAttributionRefusalDetail;
263
291
  denyAttributionDropped?: true;
264
292
  denyAttributionRenamed?: true;
293
+ parking?: ToolApprovalRespondParkingView;
265
294
  }
266
295
  interface ToolApprovalRespondRefusalFields {
267
296
  status?: number;
@@ -277,6 +306,12 @@ export type ToolApprovalRespondRefusal = (ToolApprovalRespondRefusalFields & {
277
306
  });
278
307
  export declare function readToolApprovalRespondRefusal(err: unknown): ToolApprovalRespondRefusal | undefined;
279
308
  export declare function isToolApprovalFrame(ev: unknown): ev is ToolApprovalFrame;
309
+ export declare function askProbeReasonDetail(card: Pick<ApprovalCardRequest, 'probeReason' | 'probeCause'> | null | undefined): string | undefined;
310
+ export declare function readApprovalBoundGrants(v: unknown): BoundSkillGrantsWire | undefined;
311
+ export declare function readApprovalClassifierNoRuling(v: unknown): string | undefined;
312
+ export declare function classifierNoRulingDetail(word: string | undefined): string;
313
+ export declare function approvalBoundGrantsDetail(grants: BoundSkillGrantsWire | null | undefined): string | undefined;
314
+ export declare function approvalPriorCardsDetail(card: Pick<ApprovalCardRequest, 'priorCardsForCall' | 'origin'> | null | undefined): string | undefined;
280
315
  export declare function readDenialLimitFallback(v: unknown): DenialLimitFallback | undefined;
281
316
  export declare function readRuleOffers(v: unknown): RuleOffer[] | undefined;
282
317
  export declare function readRuleOfferSupply(offers: unknown): RuleOffer[] | undefined;