@sema-agent/core 7.9.2 → 7.10.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 (60) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/dist/agents/child-model-seat.d.ts +31 -1
  3. package/dist/agents/child-model-seat.js +12 -0
  4. package/dist/agents/subagent.d.ts +2 -2
  5. package/dist/agents/subagent.js +6 -4
  6. package/dist/core/ask-unresolvable-notice.d.ts +52 -0
  7. package/dist/core/ask-unresolvable-notice.js +25 -0
  8. package/dist/core/auto-mode.d.ts +62 -3
  9. package/dist/core/auto-mode.js +31 -0
  10. package/dist/core/checkpoint-store.d.ts +14 -0
  11. package/dist/core/checkpoint-store.js +2 -1
  12. package/dist/core/engine-notice.d.ts +28 -7
  13. package/dist/core/gate-lanes.js +15 -0
  14. package/dist/core/governance-codes.d.ts +1 -1
  15. package/dist/core/governance-codes.js +4 -0
  16. package/dist/core/hooks.d.ts +24 -1
  17. package/dist/core/hooks.js +2 -0
  18. package/dist/core/permission-rule-model.d.ts +51 -16
  19. package/dist/core/permission-rule-model.js +55 -21
  20. package/dist/core/permission-rules.d.ts +6 -4
  21. package/dist/core/permission-rules.js +14 -14
  22. package/dist/core/runner/contracts.d.ts +26 -2
  23. package/dist/core/runner/denial-limit-arms.d.ts +14 -3
  24. package/dist/core/runner/denial-limit-arms.js +15 -5
  25. package/dist/core/runner/permission-rule-lanes.d.ts +7 -1
  26. package/dist/core/runner/permission-rule-lanes.js +9 -3
  27. package/dist/core/runner/prepare-caps-and-workflow.d.ts +1 -1
  28. package/dist/core/runner/prepare-caps-and-workflow.js +13 -3
  29. package/dist/core/runner/prepare-gate-stations.d.ts +3 -2
  30. package/dist/core/runner/prepare-gate-stations.js +3 -0
  31. package/dist/core/runner/prepare-policy-chain.js +7 -6
  32. package/dist/core/runner/prepare-wiring-manifest.d.ts +1 -1
  33. package/dist/core/runner/prepare-wiring-manifest.js +8 -1
  34. package/dist/core/runner/runtask.d.ts +33 -32
  35. package/dist/core/runner/runtask.js +63 -33
  36. package/dist/core/runner-deps.d.ts +9 -2
  37. package/dist/core/swappable-deps.d.ts +90 -0
  38. package/dist/core/swappable-deps.js +55 -0
  39. package/dist/core/tool-policy.d.ts +26 -0
  40. package/dist/core/tool-policy.js +5 -1
  41. package/dist/core/wiring-manifest.d.ts +15 -1
  42. package/dist/core/wiring-manifest.js +10 -2
  43. package/dist/core/workflow-journal-store.d.ts +21 -2
  44. package/dist/core/workflow-journal-store.js +1 -1
  45. package/dist/engine/execution-env/node-execution-env.d.ts +2 -0
  46. package/dist/engine/execution-env/node-execution-env.js +2 -1
  47. package/dist/engine/harness/types.d.ts +11 -0
  48. package/dist/index.d.ts +5 -3
  49. package/dist/index.js +5 -3
  50. package/dist/orchestration/run-workflow-tool.d.ts +17 -0
  51. package/dist/orchestration/run-workflow-tool.js +12 -0
  52. package/dist/orchestration/workflow-observe.d.ts +1 -1
  53. package/dist/orchestration/workflow-observe.js +2 -0
  54. package/dist/orchestration/workflow-types.d.ts +37 -2
  55. package/dist/orchestration/workflow-types.js +16 -0
  56. package/dist/orchestration/workflow.d.ts +41 -2
  57. package/dist/orchestration/workflow.js +295 -44
  58. package/dist/stores/file/workflow-journal-store.js +10 -3
  59. package/package.json +1 -1
  60. package/test/export-surface.snapshot.json +51 -5
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "_comment": "design/87 L3 — frozen public export surface of src/index.ts (name -> kind). DO NOT edit by hand to silence a red test. A removed/changed entry = a SemVer-BREAKING change; bump MAJOR and update this fixture in the SAME commit (design/87 §4.2 / §5.2). Regenerate via REGEN in test/export-surface.test.ts.",
3
3
  "_tierComment": "#435 v1 — machine-readable layering of the public surface: stable = demonstrated by README.md / src/examples; internal = an `Internal`-marked name or a runner/engine deep-subtree declaration (the model seam src/engine/llm is excluded — it is the BYOM contract, not an engine internal); advanced = a supported export the front door does not walk you through. THIS IS AN INITIAL HEURISTIC, derived mechanically and expected to be refined ticket by ticket: no human reviewed these 1700+ entries one by one, and nothing here claims otherwise. Known bias: a short or English-word export name (ok, err, Result, Usage) can match ordinary prose in README.md and land `stable` on a coincidence. Every export MUST carry a tier — a new export with no row fails the gate in export-surface.test.ts.",
4
- "count": 2234,
4
+ "count": 2257,
5
5
  "exports": {
6
6
  "A2ATaskState": "type",
7
7
  "A2ATaskStateReversal": "type",
@@ -33,11 +33,13 @@
33
33
  "AUTO_MODE_ARMING_RECIPE_VERSION": "variable",
34
34
  "AUTO_MODE_ARM_REASONS": "variable",
35
35
  "AUTO_MODE_BASE_PROMPT": "variable",
36
+ "AUTO_MODE_BREAKER_CAUSES": "variable",
36
37
  "AUTO_MODE_CLASSIFIER_MAX_TOKENS": "variable",
37
38
  "AUTO_MODE_DEFAULTS_SENTINEL": "variable",
38
39
  "AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS": "variable",
39
40
  "AUTO_MODE_DENIAL_LIMIT_DEFAULTS": "variable",
40
41
  "AUTO_MODE_PERMISSIONS_EXTERNAL": "variable",
42
+ "AUTO_MODE_UNAVAILABLE_CAUSES": "variable",
41
43
  "AcquiredSession": "interface",
42
44
  "ActiveWorktreeSession": "interface",
43
45
  "ActorAssertion": "interface",
@@ -79,6 +81,7 @@
79
81
  "AskRequest": "interface",
80
82
  "AskRuleEvidence": "interface",
81
83
  "AskSeamForm": "type",
84
+ "AskUnresolvableFacts": "interface",
82
85
  "AskUserQuestionToolOptions": "interface",
83
86
  "AssertOracleIsolationOptions": "interface",
84
87
  "AssistantMessage": "interface",
@@ -87,6 +90,9 @@
87
90
  "AutoModeArmingFace": "interface",
88
91
  "AutoModeArmingFold": "type",
89
92
  "AutoModeArmingRecipe": "interface",
93
+ "AutoModeBreakerCause": "type",
94
+ "AutoModeBreakerLedger": "class",
95
+ "AutoModeBreakerTrip": "interface",
90
96
  "AutoModeClassified": "interface",
91
97
  "AutoModeClassifierCompletion": "type",
92
98
  "AutoModeClassifyFn": "type",
@@ -99,6 +105,7 @@
99
105
  "AutoModeRebuildRefusal": "type",
100
106
  "AutoModeRebuildResult": "type",
101
107
  "AutoModeRules": "interface",
108
+ "AutoModeUnavailableCause": "type",
102
109
  "AutoModeVerdict": "type",
103
110
  "AutoModeWindowOptions": "interface",
104
111
  "AutoPromoteInputs": "interface",
@@ -766,6 +773,8 @@
766
773
  "OutputChunk": "type",
767
774
  "OwnOrgAdmissionVerdict": "interface",
768
775
  "PARK_SELFCHECK_SCOPE_PREFIX": "variable",
776
+ "PATH_RULE_BASES": "variable",
777
+ "PATH_RULE_BASE_LABEL": "variable",
769
778
  "PAUSE_REGISTRY": "variable",
770
779
  "PEER_ADDRESS_PREFIXES": "variable",
771
780
  "PEER_ADMISSION_DEFAULTS": "variable",
@@ -819,7 +828,8 @@
819
828
  "ParsedRule": "interface",
820
829
  "ParsedScopeKey": "type",
821
830
  "PatchReport": "interface",
822
- "PathRuleBases": "interface",
831
+ "PathRuleBase": "type",
832
+ "PathRuleBases": "type",
823
833
  "PausedCause": "type",
824
834
  "PeerAdmission": "interface",
825
835
  "PeerAdmissionConfig": "interface",
@@ -1145,6 +1155,8 @@
1145
1155
  "SUBAGENT_TRANSCRIPT_RETENTION_DAYS_DEFAULT": "variable",
1146
1156
  "SUMMARIZE_TOOL_RESULTS": "variable",
1147
1157
  "SUPERVISOR_PROMPT": "variable",
1158
+ "SWAPPABLE_DEP_SEATS": "variable",
1159
+ "SWAP_SEAT_NOTICE": "variable",
1148
1160
  "SYSTEM_INJECTION_PRIORITIES": "variable",
1149
1161
  "SafetyAxis": "interface",
1150
1162
  "SafetyMergeVector": "interface",
@@ -1269,6 +1281,8 @@
1269
1281
  "SubagentToolOptions": "interface",
1270
1282
  "SubagentTranscriptTier": "type",
1271
1283
  "SummarizableFinding": "interface",
1284
+ "SwappableDepSeat": "type",
1285
+ "SwappableDeps": "type",
1272
1286
  "SyncMemoryScopeOptions": "interface",
1273
1287
  "SyntheticContinuationReason": "type",
1274
1288
  "SystemInjection": "interface",
@@ -1424,6 +1438,7 @@
1424
1438
  "WEBFETCH_SUMMARY_MAX_CONTENT": "variable",
1425
1439
  "WEB_FETCH_TOOL_NAME": "variable",
1426
1440
  "WORKFLOW_AGENT_MAX_RETRIES": "variable",
1441
+ "WORKFLOW_AGENT_PARKED_ERROR_CODE": "variable",
1427
1442
  "WORKFLOW_AGENT_STALL_MS": "variable",
1428
1443
  "WORKFLOW_AGENT_THROTTLE_BACKOFF_MS": "variable",
1429
1444
  "WORKFLOW_SPAWN_BLOCKED_ERROR_CODE": "variable",
@@ -1443,6 +1458,7 @@
1443
1458
  "WorkflowAgentBlockedError": "class",
1444
1459
  "WorkflowAgentHandle": "interface",
1445
1460
  "WorkflowAgentOptions": "interface",
1461
+ "WorkflowAgentParkedError": "class",
1446
1462
  "WorkflowAgentRun": "interface",
1447
1463
  "WorkflowAgentSchemaError": "class",
1448
1464
  "WorkflowAgentSpec": "interface",
@@ -1458,7 +1474,7 @@
1458
1474
  "WorkflowHandle": "interface",
1459
1475
  "WorkflowInternals": "interface",
1460
1476
  "WorkflowItemStatus": "type",
1461
- "WorkflowJournalEntry": "interface",
1477
+ "WorkflowJournalEntry": "type",
1462
1478
  "WorkflowJournalIncompatibleError": "class",
1463
1479
  "WorkflowJournalStore": "interface",
1464
1480
  "WorkflowLimits": "interface",
@@ -1466,6 +1482,7 @@
1466
1482
  "WorkflowMeta": "interface",
1467
1483
  "WorkflowModelNotAllowedError": "class",
1468
1484
  "WorkflowNestingError": "class",
1485
+ "WorkflowParkedResume": "interface",
1469
1486
  "WorkflowPhase": "interface",
1470
1487
  "WorkflowPrimitives": "interface",
1471
1488
  "WorkflowResultTooLargeError": "class",
@@ -1512,6 +1529,7 @@
1512
1529
  "applyTombstones": "function",
1513
1530
  "archiveDistillerPlan": "function",
1514
1531
  "artifactDeclarations": "function",
1532
+ "askUnresolvableNotice": "function",
1515
1533
  "assembleCodeTools": "function",
1516
1534
  "assertAdoptionBootGate": "function",
1517
1535
  "assertDeleteDeltaCarriesNoAdd": "function",
@@ -1823,6 +1841,8 @@
1823
1841
  "inspectDegenerate": "function",
1824
1842
  "isAliasModelId": "function",
1825
1843
  "isAskOrigin": "function",
1844
+ "isAutoModeBreakerCause": "function",
1845
+ "isAutoModeUnavailableCause": "function",
1826
1846
  "isCanonicalPeerAddress": "function",
1827
1847
  "isCrossSessionInboundSetting": "function",
1828
1848
  "isDeclaredWrite": "function",
@@ -1853,6 +1873,7 @@
1853
1873
  "isSessionConflict": "function",
1854
1874
  "isSettlementKind": "function",
1855
1875
  "isSuspendable": "function",
1876
+ "isSwappableDepSeat": "function",
1856
1877
  "isSystemInjectionPriority": "function",
1857
1878
  "isTerminalTaskNotification": "function",
1858
1879
  "isTerminalWorkflowStatus": "function",
@@ -1963,7 +1984,7 @@
1963
1984
  "parseTeacherAdvice": "function",
1964
1985
  "parseWorkflowMeta": "function",
1965
1986
  "pathConfinableWriteToolNames": "function",
1966
- "pathRuleReaches": "function",
1987
+ "pathRuleReachOf": "function",
1967
1988
  "pathTargetBaseOf": "function",
1968
1989
  "pathTargetOf": "function",
1969
1990
  "pathTargetSlotOnly": "function",
@@ -2106,6 +2127,7 @@
2106
2127
  "routePeerIdleNotice": "function",
2107
2128
  "routeRefusalText": "function",
2108
2129
  "ruleAdmitsCommand": "function",
2130
+ "ruleBasesNeeded": "function",
2109
2131
  "ruleFaceOfInstance": "function",
2110
2132
  "ruleFacesFromRoster": "function",
2111
2133
  "ruleOffersOfRecord": "function",
@@ -2152,6 +2174,7 @@
2152
2174
  "screenGateOutcome": "function",
2153
2175
  "screenInboundEntries": "function",
2154
2176
  "screenRuleSyncState": "function",
2177
+ "screenSwappableDeps": "function",
2155
2178
  "scrubSecretEnv": "function",
2156
2179
  "seedStrategies": "function",
2157
2180
  "selectModel": "function",
@@ -2269,11 +2292,13 @@
2269
2292
  "AUTO_MODE_ARMING_RECIPE_VERSION": "advanced",
2270
2293
  "AUTO_MODE_ARM_REASONS": "advanced",
2271
2294
  "AUTO_MODE_BASE_PROMPT": "advanced",
2295
+ "AUTO_MODE_BREAKER_CAUSES": "advanced",
2272
2296
  "AUTO_MODE_CLASSIFIER_MAX_TOKENS": "advanced",
2273
2297
  "AUTO_MODE_DEFAULTS_SENTINEL": "advanced",
2274
2298
  "AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS": "advanced",
2275
2299
  "AUTO_MODE_DENIAL_LIMIT_DEFAULTS": "advanced",
2276
2300
  "AUTO_MODE_PERMISSIONS_EXTERNAL": "advanced",
2301
+ "AUTO_MODE_UNAVAILABLE_CAUSES": "advanced",
2277
2302
  "AcquiredSession": "advanced",
2278
2303
  "ActiveWorktreeSession": "internal",
2279
2304
  "ActorAssertion": "advanced",
@@ -2315,6 +2340,7 @@
2315
2340
  "AskRequest": "stable",
2316
2341
  "AskRuleEvidence": "advanced",
2317
2342
  "AskSeamForm": "advanced",
2343
+ "AskUnresolvableFacts": "advanced",
2318
2344
  "AskUserQuestionToolOptions": "advanced",
2319
2345
  "AssertOracleIsolationOptions": "advanced",
2320
2346
  "AssistantMessage": "stable",
@@ -2323,6 +2349,9 @@
2323
2349
  "AutoModeArmingFace": "advanced",
2324
2350
  "AutoModeArmingFold": "advanced",
2325
2351
  "AutoModeArmingRecipe": "advanced",
2352
+ "AutoModeBreakerCause": "advanced",
2353
+ "AutoModeBreakerLedger": "advanced",
2354
+ "AutoModeBreakerTrip": "advanced",
2326
2355
  "AutoModeClassified": "advanced",
2327
2356
  "AutoModeClassifierCompletion": "advanced",
2328
2357
  "AutoModeClassifyFn": "advanced",
@@ -2335,6 +2364,7 @@
2335
2364
  "AutoModeRebuildRefusal": "advanced",
2336
2365
  "AutoModeRebuildResult": "advanced",
2337
2366
  "AutoModeRules": "advanced",
2367
+ "AutoModeUnavailableCause": "advanced",
2338
2368
  "AutoModeVerdict": "advanced",
2339
2369
  "AutoModeWindowOptions": "advanced",
2340
2370
  "AutoPromoteInputs": "advanced",
@@ -3002,6 +3032,8 @@
3002
3032
  "OutputChunk": "advanced",
3003
3033
  "OwnOrgAdmissionVerdict": "advanced",
3004
3034
  "PARK_SELFCHECK_SCOPE_PREFIX": "advanced",
3035
+ "PATH_RULE_BASES": "advanced",
3036
+ "PATH_RULE_BASE_LABEL": "advanced",
3005
3037
  "PAUSE_REGISTRY": "advanced",
3006
3038
  "PEER_ADDRESS_PREFIXES": "advanced",
3007
3039
  "PEER_ADMISSION_DEFAULTS": "advanced",
@@ -3055,6 +3087,7 @@
3055
3087
  "ParsedRule": "advanced",
3056
3088
  "ParsedScopeKey": "advanced",
3057
3089
  "PatchReport": "stable",
3090
+ "PathRuleBase": "advanced",
3058
3091
  "PathRuleBases": "advanced",
3059
3092
  "PausedCause": "advanced",
3060
3093
  "PeerAdmission": "advanced",
@@ -3381,6 +3414,8 @@
3381
3414
  "SUBAGENT_TRANSCRIPT_RETENTION_DAYS_DEFAULT": "advanced",
3382
3415
  "SUMMARIZE_TOOL_RESULTS": "advanced",
3383
3416
  "SUPERVISOR_PROMPT": "advanced",
3417
+ "SWAPPABLE_DEP_SEATS": "advanced",
3418
+ "SWAP_SEAT_NOTICE": "advanced",
3384
3419
  "SYSTEM_INJECTION_PRIORITIES": "advanced",
3385
3420
  "SafetyAxis": "advanced",
3386
3421
  "SafetyMergeVector": "advanced",
@@ -3505,6 +3540,8 @@
3505
3540
  "SubagentToolOptions": "advanced",
3506
3541
  "SubagentTranscriptTier": "advanced",
3507
3542
  "SummarizableFinding": "advanced",
3543
+ "SwappableDepSeat": "advanced",
3544
+ "SwappableDeps": "advanced",
3508
3545
  "SyncMemoryScopeOptions": "advanced",
3509
3546
  "SyntheticContinuationReason": "advanced",
3510
3547
  "SystemInjection": "advanced",
@@ -3660,6 +3697,7 @@
3660
3697
  "WEBFETCH_SUMMARY_MAX_CONTENT": "advanced",
3661
3698
  "WEB_FETCH_TOOL_NAME": "advanced",
3662
3699
  "WORKFLOW_AGENT_MAX_RETRIES": "advanced",
3700
+ "WORKFLOW_AGENT_PARKED_ERROR_CODE": "advanced",
3663
3701
  "WORKFLOW_AGENT_STALL_MS": "advanced",
3664
3702
  "WORKFLOW_AGENT_THROTTLE_BACKOFF_MS": "advanced",
3665
3703
  "WORKFLOW_SPAWN_BLOCKED_ERROR_CODE": "advanced",
@@ -3679,6 +3717,7 @@
3679
3717
  "WorkflowAgentBlockedError": "advanced",
3680
3718
  "WorkflowAgentHandle": "advanced",
3681
3719
  "WorkflowAgentOptions": "advanced",
3720
+ "WorkflowAgentParkedError": "advanced",
3682
3721
  "WorkflowAgentRun": "advanced",
3683
3722
  "WorkflowAgentSchemaError": "advanced",
3684
3723
  "WorkflowAgentSpec": "advanced",
@@ -3702,6 +3741,7 @@
3702
3741
  "WorkflowMeta": "advanced",
3703
3742
  "WorkflowModelNotAllowedError": "advanced",
3704
3743
  "WorkflowNestingError": "advanced",
3744
+ "WorkflowParkedResume": "advanced",
3705
3745
  "WorkflowPhase": "advanced",
3706
3746
  "WorkflowPrimitives": "advanced",
3707
3747
  "WorkflowResultTooLargeError": "advanced",
@@ -3748,6 +3788,7 @@
3748
3788
  "applyTombstones": "advanced",
3749
3789
  "archiveDistillerPlan": "advanced",
3750
3790
  "artifactDeclarations": "advanced",
3791
+ "askUnresolvableNotice": "advanced",
3751
3792
  "assembleCodeTools": "advanced",
3752
3793
  "assertAdoptionBootGate": "advanced",
3753
3794
  "assertDeleteDeltaCarriesNoAdd": "advanced",
@@ -4059,6 +4100,8 @@
4059
4100
  "inspectDegenerate": "advanced",
4060
4101
  "isAliasModelId": "advanced",
4061
4102
  "isAskOrigin": "advanced",
4103
+ "isAutoModeBreakerCause": "advanced",
4104
+ "isAutoModeUnavailableCause": "advanced",
4062
4105
  "isCanonicalPeerAddress": "advanced",
4063
4106
  "isCrossSessionInboundSetting": "advanced",
4064
4107
  "isDeclaredWrite": "advanced",
@@ -4089,6 +4132,7 @@
4089
4132
  "isSessionConflict": "stable",
4090
4133
  "isSettlementKind": "advanced",
4091
4134
  "isSuspendable": "advanced",
4135
+ "isSwappableDepSeat": "advanced",
4092
4136
  "isSystemInjectionPriority": "advanced",
4093
4137
  "isTerminalTaskNotification": "advanced",
4094
4138
  "isTerminalWorkflowStatus": "advanced",
@@ -4199,7 +4243,7 @@
4199
4243
  "parseTeacherAdvice": "advanced",
4200
4244
  "parseWorkflowMeta": "advanced",
4201
4245
  "pathConfinableWriteToolNames": "advanced",
4202
- "pathRuleReaches": "advanced",
4246
+ "pathRuleReachOf": "advanced",
4203
4247
  "pathTargetBaseOf": "advanced",
4204
4248
  "pathTargetOf": "advanced",
4205
4249
  "pathTargetSlotOnly": "advanced",
@@ -4342,6 +4386,7 @@
4342
4386
  "routePeerIdleNotice": "advanced",
4343
4387
  "routeRefusalText": "advanced",
4344
4388
  "ruleAdmitsCommand": "advanced",
4389
+ "ruleBasesNeeded": "advanced",
4345
4390
  "ruleFaceOfInstance": "advanced",
4346
4391
  "ruleFacesFromRoster": "advanced",
4347
4392
  "ruleOffersOfRecord": "advanced",
@@ -4388,6 +4433,7 @@
4388
4433
  "screenGateOutcome": "advanced",
4389
4434
  "screenInboundEntries": "advanced",
4390
4435
  "screenRuleSyncState": "advanced",
4436
+ "screenSwappableDeps": "advanced",
4391
4437
  "scrubSecretEnv": "advanced",
4392
4438
  "seedStrategies": "advanced",
4393
4439
  "selectModel": "advanced",