@sema-agent/core 7.2.0 → 7.3.0

package/test/export-surface.snapshot.json

@@ -1,7 +1,7 @@
 {
   "_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.",
   "_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.",
-  "count": 1904,
+  "count": 1958,
   "exports": {
     "A2ATaskState": "type",
     "A2ATaskStateReversal": "type",
@@ -155,6 +155,7 @@
     "CONSOLIDATION_SYSTEM_PROMPT": "variable",
     "CONTRACT_KIT_ENGINE_VERSION": "variable",
     "COORDINATOR_ROLE_PROMPT": "variable",
+    "CROSS_SESSION_CLASSIFIER_RULE": "variable",
     "CROSS_SESSION_HOLD_CAUSES": "variable",
     "CROSS_SESSION_INBOUND_SETTINGS": "variable",
     "CROSS_SESSION_MESSAGE_NOTICE": "variable",
@@ -453,6 +454,7 @@
     "InMemoryFileHistoryStoreOptions": "interface",
     "InMemoryMailboxStore": "class",
     "InMemoryMemoryStore": "class",
+    "InMemoryPeerDirectory": "interface",
     "InMemoryPermissionRuleStore": "class",
     "InMemoryRuleApprovalRecordStore": "class",
     "InMemorySessionPolicyStore": "class",
@@ -472,6 +474,9 @@
     "KillProcessTreeOptions": "type",
     "LEGACY_PENDING_STEER_INPUT_ID": "variable",
     "LINEAGE_FILE": "variable",
+    "LIST_AGENTS_MAX_RESULT_CHARS": "variable",
+    "LIST_AGENTS_TOOL_ALIAS": "variable",
+    "LIST_AGENTS_TOOL_NAME": "variable",
     "LLM_DISTILLER_CONTRACT": "variable",
     "LLM_DISTILLER_CONTRACTS": "variable",
     "LLM_DISTILLER_CONTRACT_DL2": "variable",
@@ -485,6 +490,8 @@
     "LayeredRecallResult": "type",
     "LineagePendingTxn": "interface",
     "LineagePromotion": "interface",
+    "ListAgentsRow": "interface",
+    "ListAgentsToolOptions": "interface",
     "LlmConsolidationPlan": "interface",
     "LlmConsolidationPlanArm": "interface",
     "LlmConsolidationPlanProduct": "interface",
@@ -509,6 +516,10 @@
     "LspToolOptions": "interface",
     "LspTransport": "interface",
     "MAILBOX_CONTRACT_SCOPE": "variable",
+    "MAILBOX_CROSS_PROCESS_UNSAFE_CODE": "variable",
+    "MAILBOX_INVALID_PEER_META_CODE": "variable",
+    "MAILBOX_PEER_FROM_MODES": "variable",
+    "MAILBOX_PEER_RECORD_KINDS": "variable",
     "MAILBOX_TOMBSTONED_RECIPIENT_CODE": "variable",
     "MASS_DELETION_FUSE_RATIO": "variable",
     "MAX_ACTOR_FIELD_CHARS": "variable",
@@ -552,10 +563,17 @@
     "MONITOR_DEFAULT_TIMEOUT_MS": "variable",
     "MONITOR_MAX_BATCHES_PER_MINUTE": "variable",
     "MONITOR_MAX_TIMEOUT_MS": "variable",
+    "MailboxAppendMessage": "interface",
+    "MailboxCrossProcessContractHooks": "interface",
+    "MailboxCrossProcessVerdict": "type",
     "MailboxLease": "interface",
     "MailboxMessage": "interface",
+    "MailboxPeerFromMode": "type",
+    "MailboxPeerMeta": "interface",
+    "MailboxPeerRecordKind": "type",
     "MailboxStore": "interface",
     "MailboxStoreError": "class",
+    "MailboxStoreErrorCode": "type",
     "MailboxTombstonedRecipientContractHooks": "interface",
     "ManagedRetentionCapability": "interface",
     "ManifestDurability": "type",
@@ -702,6 +720,10 @@
     "PEER_REF_MIN": "variable",
     "PEER_REF_RE": "variable",
     "PEER_SEND_VERDICT_CODES": "variable",
+    "PEER_SESSION_ID_GRAMMAR": "variable",
+    "PEER_SESSION_ID_UNGRAMMATICAL_CODE": "variable",
+    "PEER_SESSION_RECORD_MAX_BYTES": "variable",
+    "PEER_SESSION_RECORD_SCHEMA_VERSION": "variable",
     "PENDING_STEER_FROZEN_FIELDS": "variable",
     "PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES": "variable",
     "PERMISSION_MODE_CLASSES": "variable",
@@ -731,15 +753,29 @@
     "PeerAdmissionOptions": "interface",
     "PeerAdmissionRefusal": "type",
     "PeerAdmissionRequest": "interface",
+    "PeerAdmissionStage": "type",
     "PeerAdmissionVerdict": "type",
     "PeerAxisTag": "type",
+    "PeerDirectory": "interface",
+    "PeerDirectoryAccess": "interface",
     "PeerIdentity": "interface",
     "PeerInboundChainRef": "interface",
+    "PeerLaneMountVerdict": "type",
+    "PeerLivenessProbe": "interface",
     "PeerRefEntry": "interface",
     "PeerRefusalCode": "type",
+    "PeerRegistryDirectoryRefusal": "type",
+    "PeerRegistryDirectoryVerdict": "type",
     "PeerSelfRef": "interface",
     "PeerSendVerdict": "type",
     "PeerSendVerdictCode": "type",
+    "PeerSessionCandidate": "interface",
+    "PeerSessionLiveness": "type",
+    "PeerSessionRecord": "interface",
+    "PeerSessionRecordRead": "type",
+    "PeerSessionRecordRefusal": "type",
+    "PeerSessionResolution": "type",
+    "PeerSessionTempo": "type",
     "PendingAction": "type",
     "PendingSteerEntry": "interface",
     "PendingSteerInput": "interface",
@@ -972,6 +1008,7 @@
     "SCOPE_SEGMENT_MAX_ENCODED": "variable",
     "SEMA_DEFAULT_PACK": "variable",
     "SEND_MESSAGE_TOOL_NAME": "variable",
+    "SESSION_BOX_PREFIX": "variable",
     "SESSION_CAPTURE_OPTOUT_DIR": "variable",
     "SESSION_LOG_DIGEST_SCHEME": "variable",
     "SHARED_MEMORY_LIST_PAGE_SIZE": "variable",
@@ -1424,6 +1461,8 @@
     "createFsWriteGatePolicy": "function",
     "createHookEnvCapabilities": "function",
     "createImageDownsampler": "function",
+    "createInMemoryPeerDirectory": "function",
+    "createListAgentsTool": "function",
     "createLspTool": "function",
     "createMemoryTaskListStore": "function",
     "createMonitorTool": "function",
@@ -1463,6 +1502,7 @@
     "decodeScopeAttribute": "function",
     "decodeScopeSegment": "function",
     "defaultLspSpawn": "variable",
+    "defaultPeerLivenessProbe": "variable",
     "defaultPromptProvider": "variable",
     "defaultTaskRegistry": "variable",
     "defineAgent": "function",
@@ -1582,6 +1622,8 @@
     "isIsolated": "function",
     "isModelGatedForClass": "function",
     "isNamespacedCoveringRuleName": "function",
+    "isPeerSessionId": "function",
+    "isPeerSessionProcessAlive": "function",
     "isPermissionModeClass": "function",
     "isPersonalScope": "function",
     "isQuestionUnavailable": "function",
@@ -1607,6 +1649,7 @@
     "joinRuleStates": "function",
     "judgeCrossSessionInbound": "function",
     "judgePeerAdmission": "function",
+    "judgePeerRecordFile": "function",
     "killProcessTree": "function",
     "languageFor": "function",
     "leafIdAfterEntry": "function",
@@ -1624,6 +1667,8 @@
     "lspFailureOf": "function",
     "mailboxAckOwnershipContract": "function",
     "mailboxBundledOnlyContract": "function",
+    "mailboxCrossProcessContract": "function",
+    "mailboxCrossProcessMountVerdict": "function",
     "mailboxStoreContract": "function",
     "mailboxTombstonedRecipientContract": "function",
     "markSessionCaptureOptOut": "function",
@@ -1651,6 +1696,7 @@
     "mintExposurePartitionedPlan": "function",
     "mintLlmConsolidationPlan": "function",
     "mintPeerRef": "function",
+    "mintPeerSessionCandidates": "function",
     "mintReminderMark": "function",
     "mintRuleTicket": "function",
     "mintSystemReminder": "function",
@@ -1684,6 +1730,7 @@
     "parseLeadingCommandName": "function",
     "parseModelMention": "function",
     "parsePeerNameRef": "function",
+    "parsePeerSessionAddress": "function",
     "parsePermissionRule": "function",
     "parseProjectMarker": "function",
     "parseResult": "function",
@@ -1698,6 +1745,7 @@
     "peerAdmissionFor": "function",
     "peerAxisToken": "function",
     "peerSendVerdictSeverity": "function",
+    "peerSessionBoxHandle": "function",
     "permissionRuleSyncContract": "function",
     "pgQuery": "function",
     "planParseRepairs": "function",
@@ -1722,6 +1770,8 @@
     "readDegradation": "function",
     "readIntentCredentials": "function",
     "readJsonlRecords": "function",
+    "readMailboxPeerMeta": "function",
+    "readPeerSessionRecord": "function",
     "readPendingSteerQueue": "function",
     "readRootAdoptionFile": "function",
     "readSessionCaptureOptOut": "function",
@@ -1747,6 +1797,7 @@
     "renderAnnouncements": "function",
     "renderAutoModeAction": "function",
     "renderAutoModeWindow": "function",
+    "renderCrossSessionMessageFrame": "function",
     "renderNamedWorkflowListing": "function",
     "renderTaskNotificationXml": "function",
     "renderUntrustedCommandText": "function",
@@ -1774,6 +1825,7 @@
     "resolveMemoryEngineRoot": "function",
     "resolveModel": "function",
     "resolvePeerAdmissionConfig": "function",
+    "resolvePeerSessions": "function",
     "resolveProjectId": "function",
     "resolveQuestionSeam": "function",
     "resolveReadDenyBuiltins": "function",
@@ -1854,6 +1906,7 @@
     "sqliteQuery": "function",
     "startWorkflow": "function",
     "stripEngineMetadata": "function",
+    "stripFormatCharacters": "function",
     "stripRev": "function",
     "subscribeWorkflow": "function",
     "suggestRulesForCommand": "function",
@@ -1891,6 +1944,7 @@
     "validateSelectedIds": "function",
     "verifyCompleted": "function",
     "verifyPromptArtifact": "function",
+    "vetPeerRegistryDirectory": "function",
     "warmResume": "function",
     "webFetchToolSpec": "function",
     "wildcardMatch": "function",
@@ -2061,6 +2115,7 @@
     "CONSOLIDATION_SYSTEM_PROMPT": "internal",
     "CONTRACT_KIT_ENGINE_VERSION": "advanced",
     "COORDINATOR_ROLE_PROMPT": "advanced",
+    "CROSS_SESSION_CLASSIFIER_RULE": "advanced",
     "CROSS_SESSION_HOLD_CAUSES": "advanced",
     "CROSS_SESSION_INBOUND_SETTINGS": "advanced",
     "CROSS_SESSION_MESSAGE_NOTICE": "advanced",
@@ -2359,6 +2414,7 @@
     "InMemoryFileHistoryStoreOptions": "advanced",
     "InMemoryMailboxStore": "advanced",
     "InMemoryMemoryStore": "stable",
+    "InMemoryPeerDirectory": "advanced",
     "InMemoryPermissionRuleStore": "advanced",
     "InMemoryRuleApprovalRecordStore": "advanced",
     "InMemorySessionPolicyStore": "advanced",
@@ -2378,6 +2434,9 @@
     "KillProcessTreeOptions": "internal",
     "LEGACY_PENDING_STEER_INPUT_ID": "advanced",
     "LINEAGE_FILE": "advanced",
+    "LIST_AGENTS_MAX_RESULT_CHARS": "advanced",
+    "LIST_AGENTS_TOOL_ALIAS": "advanced",
+    "LIST_AGENTS_TOOL_NAME": "advanced",
     "LLM_DISTILLER_CONTRACT": "advanced",
     "LLM_DISTILLER_CONTRACTS": "advanced",
     "LLM_DISTILLER_CONTRACT_DL2": "advanced",
@@ -2391,6 +2450,8 @@
     "LayeredRecallResult": "advanced",
     "LineagePendingTxn": "advanced",
     "LineagePromotion": "advanced",
+    "ListAgentsRow": "advanced",
+    "ListAgentsToolOptions": "advanced",
     "LlmConsolidationPlan": "advanced",
     "LlmConsolidationPlanArm": "advanced",
     "LlmConsolidationPlanProduct": "advanced",
@@ -2415,6 +2476,10 @@
     "LspToolOptions": "advanced",
     "LspTransport": "advanced",
     "MAILBOX_CONTRACT_SCOPE": "advanced",
+    "MAILBOX_CROSS_PROCESS_UNSAFE_CODE": "advanced",
+    "MAILBOX_INVALID_PEER_META_CODE": "advanced",
+    "MAILBOX_PEER_FROM_MODES": "advanced",
+    "MAILBOX_PEER_RECORD_KINDS": "advanced",
     "MAILBOX_TOMBSTONED_RECIPIENT_CODE": "advanced",
     "MASS_DELETION_FUSE_RATIO": "advanced",
     "MAX_ACTOR_FIELD_CHARS": "advanced",
@@ -2458,10 +2523,17 @@
     "MONITOR_DEFAULT_TIMEOUT_MS": "advanced",
     "MONITOR_MAX_BATCHES_PER_MINUTE": "advanced",
     "MONITOR_MAX_TIMEOUT_MS": "advanced",
+    "MailboxAppendMessage": "advanced",
+    "MailboxCrossProcessContractHooks": "advanced",
+    "MailboxCrossProcessVerdict": "advanced",
     "MailboxLease": "advanced",
     "MailboxMessage": "advanced",
+    "MailboxPeerFromMode": "advanced",
+    "MailboxPeerMeta": "advanced",
+    "MailboxPeerRecordKind": "advanced",
     "MailboxStore": "advanced",
     "MailboxStoreError": "advanced",
+    "MailboxStoreErrorCode": "advanced",
     "MailboxTombstonedRecipientContractHooks": "advanced",
     "ManagedRetentionCapability": "advanced",
     "ManifestDurability": "advanced",
@@ -2608,6 +2680,10 @@
     "PEER_REF_MIN": "advanced",
     "PEER_REF_RE": "advanced",
     "PEER_SEND_VERDICT_CODES": "advanced",
+    "PEER_SESSION_ID_GRAMMAR": "advanced",
+    "PEER_SESSION_ID_UNGRAMMATICAL_CODE": "advanced",
+    "PEER_SESSION_RECORD_MAX_BYTES": "advanced",
+    "PEER_SESSION_RECORD_SCHEMA_VERSION": "advanced",
     "PENDING_STEER_FROZEN_FIELDS": "advanced",
     "PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES": "advanced",
     "PERMISSION_MODE_CLASSES": "advanced",
@@ -2637,15 +2713,29 @@
     "PeerAdmissionOptions": "advanced",
     "PeerAdmissionRefusal": "advanced",
     "PeerAdmissionRequest": "advanced",
+    "PeerAdmissionStage": "advanced",
     "PeerAdmissionVerdict": "advanced",
     "PeerAxisTag": "advanced",
+    "PeerDirectory": "advanced",
+    "PeerDirectoryAccess": "advanced",
     "PeerIdentity": "advanced",
     "PeerInboundChainRef": "advanced",
+    "PeerLaneMountVerdict": "advanced",
+    "PeerLivenessProbe": "advanced",
     "PeerRefEntry": "advanced",
     "PeerRefusalCode": "advanced",
+    "PeerRegistryDirectoryRefusal": "advanced",
+    "PeerRegistryDirectoryVerdict": "advanced",
     "PeerSelfRef": "advanced",
     "PeerSendVerdict": "advanced",
     "PeerSendVerdictCode": "advanced",
+    "PeerSessionCandidate": "advanced",
+    "PeerSessionLiveness": "advanced",
+    "PeerSessionRecord": "advanced",
+    "PeerSessionRecordRead": "advanced",
+    "PeerSessionRecordRefusal": "advanced",
+    "PeerSessionResolution": "advanced",
+    "PeerSessionTempo": "advanced",
     "PendingAction": "advanced",
     "PendingSteerEntry": "stable",
     "PendingSteerInput": "stable",
@@ -2878,6 +2968,7 @@
     "SCOPE_SEGMENT_MAX_ENCODED": "advanced",
     "SEMA_DEFAULT_PACK": "advanced",
     "SEND_MESSAGE_TOOL_NAME": "advanced",
+    "SESSION_BOX_PREFIX": "advanced",
     "SESSION_CAPTURE_OPTOUT_DIR": "advanced",
     "SESSION_LOG_DIGEST_SCHEME": "internal",
     "SHARED_MEMORY_LIST_PAGE_SIZE": "advanced",
@@ -3330,6 +3421,8 @@
     "createFsWriteGatePolicy": "advanced",
     "createHookEnvCapabilities": "advanced",
     "createImageDownsampler": "advanced",
+    "createInMemoryPeerDirectory": "advanced",
+    "createListAgentsTool": "advanced",
     "createLspTool": "advanced",
     "createMemoryTaskListStore": "advanced",
     "createMonitorTool": "advanced",
@@ -3369,6 +3462,7 @@
     "decodeScopeAttribute": "advanced",
     "decodeScopeSegment": "advanced",
     "defaultLspSpawn": "internal",
+    "defaultPeerLivenessProbe": "advanced",
     "defaultPromptProvider": "advanced",
     "defaultTaskRegistry": "advanced",
     "defineAgent": "stable",
@@ -3488,6 +3582,8 @@
     "isIsolated": "advanced",
     "isModelGatedForClass": "advanced",
     "isNamespacedCoveringRuleName": "advanced",
+    "isPeerSessionId": "advanced",
+    "isPeerSessionProcessAlive": "advanced",
     "isPermissionModeClass": "advanced",
     "isPersonalScope": "advanced",
     "isQuestionUnavailable": "advanced",
@@ -3513,6 +3609,7 @@
     "joinRuleStates": "advanced",
     "judgeCrossSessionInbound": "advanced",
     "judgePeerAdmission": "advanced",
+    "judgePeerRecordFile": "advanced",
     "killProcessTree": "internal",
     "languageFor": "internal",
     "leafIdAfterEntry": "internal",
@@ -3530,6 +3627,8 @@
     "lspFailureOf": "advanced",
     "mailboxAckOwnershipContract": "advanced",
     "mailboxBundledOnlyContract": "advanced",
+    "mailboxCrossProcessContract": "advanced",
+    "mailboxCrossProcessMountVerdict": "advanced",
     "mailboxStoreContract": "advanced",
     "mailboxTombstonedRecipientContract": "advanced",
     "markSessionCaptureOptOut": "advanced",
@@ -3557,6 +3656,7 @@
     "mintExposurePartitionedPlan": "advanced",
     "mintLlmConsolidationPlan": "advanced",
     "mintPeerRef": "advanced",
+    "mintPeerSessionCandidates": "advanced",
     "mintReminderMark": "advanced",
     "mintRuleTicket": "advanced",
     "mintSystemReminder": "advanced",
@@ -3590,6 +3690,7 @@
     "parseLeadingCommandName": "advanced",
     "parseModelMention": "advanced",
     "parsePeerNameRef": "advanced",
+    "parsePeerSessionAddress": "advanced",
     "parsePermissionRule": "advanced",
     "parseProjectMarker": "advanced",
     "parseResult": "advanced",
@@ -3604,6 +3705,7 @@
     "peerAdmissionFor": "advanced",
     "peerAxisToken": "advanced",
     "peerSendVerdictSeverity": "advanced",
+    "peerSessionBoxHandle": "advanced",
     "permissionRuleSyncContract": "advanced",
     "pgQuery": "advanced",
     "planParseRepairs": "advanced",
@@ -3628,6 +3730,8 @@
     "readDegradation": "advanced",
     "readIntentCredentials": "advanced",
     "readJsonlRecords": "advanced",
+    "readMailboxPeerMeta": "advanced",
+    "readPeerSessionRecord": "advanced",
     "readPendingSteerQueue": "advanced",
     "readRootAdoptionFile": "advanced",
     "readSessionCaptureOptOut": "advanced",
@@ -3653,6 +3757,7 @@
     "renderAnnouncements": "advanced",
     "renderAutoModeAction": "advanced",
     "renderAutoModeWindow": "advanced",
+    "renderCrossSessionMessageFrame": "advanced",
     "renderNamedWorkflowListing": "advanced",
     "renderTaskNotificationXml": "advanced",
     "renderUntrustedCommandText": "advanced",
@@ -3680,6 +3785,7 @@
     "resolveMemoryEngineRoot": "advanced",
     "resolveModel": "advanced",
     "resolvePeerAdmissionConfig": "advanced",
+    "resolvePeerSessions": "advanced",
     "resolveProjectId": "advanced",
     "resolveQuestionSeam": "advanced",
     "resolveReadDenyBuiltins": "advanced",
@@ -3760,6 +3866,7 @@
     "sqliteQuery": "advanced",
     "startWorkflow": "advanced",
     "stripEngineMetadata": "advanced",
+    "stripFormatCharacters": "advanced",
     "stripRev": "advanced",
     "subscribeWorkflow": "advanced",
     "suggestRulesForCommand": "advanced",
@@ -3797,6 +3904,7 @@
     "validateSelectedIds": "advanced",
     "verifyCompleted": "advanced",
     "verifyPromptArtifact": "advanced",
+    "vetPeerRegistryDirectory": "advanced",
     "warmResume": "advanced",
     "webFetchToolSpec": "advanced",
     "wildcardMatch": "advanced",