@sema-agent/core 7.24.1 → 7.24.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "7.24.1",
+  "version": "7.24.3",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",

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": 2398,
+  "count": 2402,
   "exports": {
     "A2ATaskState": "type",
     "A2ATaskStateReversal": "type",
@@ -654,6 +654,7 @@
     "MCP_IMAGE_MAX_BASE64": "variable",
     "MCP_INJECTION_DROP_REASONS": "variable",
     "MCP_INJECTION_DROP_TEXT": "variable",
+    "MCP_LIVENESS_STATES": "variable",
     "MCP_NAMESPACE": "variable",
     "MCP_PREFIX": "variable",
     "MEMORY_ANNOUNCEMENTS_MAX": "variable",
@@ -713,8 +714,10 @@
     "McpImageResizer": "type",
     "McpInjectionDropFacts": "interface",
     "McpInjectionDropReason": "type",
+    "McpLivenessState": "type",
     "McpReconnectResult": "interface",
     "McpRefreshResult": "interface",
+    "McpServerLiveness": "interface",
     "McpServerSpec": "interface",
     "McpServerStatus": "interface",
     "McpToolFace": "type",
@@ -2013,6 +2016,7 @@
     "isolationPermitsAutoAccept": "function",
     "jaccardDistance": "function",
     "joinFrontiers": "function",
+    "joinRequestUrl": "function",
     "joinRuleStates": "function",
     "judgeCrossSessionInbound": "function",
     "judgeParkedToolIdentity": "function",
@@ -3054,6 +3058,7 @@
     "MCP_IMAGE_MAX_BASE64": "advanced",
     "MCP_INJECTION_DROP_REASONS": "advanced",
     "MCP_INJECTION_DROP_TEXT": "advanced",
+    "MCP_LIVENESS_STATES": "advanced",
     "MCP_NAMESPACE": "advanced",
     "MCP_PREFIX": "advanced",
     "MEMORY_ANNOUNCEMENTS_MAX": "advanced",
@@ -3113,8 +3118,10 @@
     "McpImageResizer": "advanced",
     "McpInjectionDropFacts": "advanced",
     "McpInjectionDropReason": "advanced",
+    "McpLivenessState": "advanced",
     "McpReconnectResult": "advanced",
     "McpRefreshResult": "advanced",
+    "McpServerLiveness": "advanced",
     "McpServerSpec": "advanced",
     "McpServerStatus": "advanced",
     "McpToolFace": "internal",
@@ -4413,6 +4420,7 @@
     "isolationPermitsAutoAccept": "advanced",
     "jaccardDistance": "stable",
     "joinFrontiers": "advanced",
+    "joinRequestUrl": "stable",
     "joinRuleStates": "advanced",
     "judgeCrossSessionInbound": "advanced",
     "judgeParkedToolIdentity": "advanced",

package/wire-changes/core@7.24.1.json

@@ -44,21 +44,7 @@
       "criteriaCovered": false
     }
   ],
-  "closedSetsUnreadable": [
-    {
-      "set": "ModelRole",
-      "from": "literal",
-      "to": "declared",
-      "unreadable": true,
-      "at": [
-        "src/core/model-seat.ts:44",
-        "src/core/roles.ts:6",
-        "src/core/types.ts:20",
-        "src/index.ts:243"
-      ],
-      "reason": "no longer a spelled-out vocabulary (declared at src/core/model-seat.ts:44, src/core/roles.ts:6, src/core/types.ts:20, src/index.ts:243)"
-    }
-  ],
+  "closedSetsUnreadable": [],
   "typeKeys": [],
   "declarationMoves": [],
   "mintMoves": [],
@@ -77,9 +63,9 @@
     ],
     "server": [],
     "sdk": [],
-    "note": "scanned cli@ae64fcaf server@277e6a15 sdk@5ded40c — a name listed is MENTIONED there today, which is evidence of consumption, not proof of it"
+    "note": "scanned cli@6f99707c server@277e6a15 sdk@5ded40c — a name listed is MENTIONED there today, which is evidence of consumption, not proof of it"
   },
   "breakingCount": 0,
   "breakingItems": [],
-  "toResolvedAt": "d552b285c747d987758c66504ec8cba98fab04de"
+  "toResolvedAt": "f93e37f388d831881d2ebf4f9c28eca1499896a3"
 }

package/wire-changes/core@7.24.2.json

@@ -0,0 +1,81 @@
+{
+  "repo": "core",
+  "version": "7.24.2",
+  "from": "f93e37f388d831881d2ebf4f9c28eca1499896a3",
+  "to": "v7.24.2",
+  "added": [
+    {
+      "name": "joinRequestUrl",
+      "kind": "function",
+      "tier": "stable",
+      "at": [
+        "src/brain/route-adjudicator.ts:370",
+        "src/index.ts:3212"
+      ],
+      "criteriaCovered": false,
+      "breaking": false
+    }
+  ],
+  "removed": [],
+  "changed": [],
+  "narrowed": [
+    {
+      "id": "F1",
+      "source": "behaviorFlips.summary",
+      "text": "NARROWING of a rendered string (#974, P1): `displayUrlOf` speaks query NAMES only where the query is PURE — every `name=value` pair decoded to its fixed point (≤3 rounds; a malformed escape leaves its `%`) is plain text `[A-Za-z0-9._~[\\]-+,*!'()$ ]`; any impure pair (a value carrying an un-encoded URL, an e-mail, a bare segment with `@`/`:`/`/`, residual `%`) collapses the WHOLE query to one `«redacted»`. WHO NEEDS IT: a deployment whose gateway root carries a query value with an embedded URL whose password contains `&` — the fragment after `&` and before `=` landed in the NAME position and was rendered verbatim (server report, main reproduced 8 forms, test 3 boundaries). WHO IS AFFECTED: operators reading refusals for roots with a legitimate structured value (`?redirect_uri=https://…`, `?email=a@b.com`) now get the differing SEGMENT position instead of its name."
+    },
+    {
+      "id": "F2",
+      "source": "behaviorFlips.summary",
+      "text": "NARROWING at construction (#961, P2): a request root may no longer carry a `#fragment` — `assertServableRequestRoot` and `joinRequestUrl` refuse it with a `displayUrlOf`-rendered message that names `#…` without its content; and joining an endpoint onto the root is a URL operation: the suffix joins the PATH, the query rides byte-preserved after it. WHO NEEDS IT: Azure-style gateways (`?api-version=`) whose requests previously went out as `…/v1?api-version=x/chat/completions`. WHO IS AFFECTED: a deployment whose `baseUrl` carried a fragment now fails loudly at construction instead of silently calling the root path."
+    }
+  ],
+  "closedSetMembers": [],
+  "closedSetsUnreadable": [],
+  "typeKeys": [],
+  "declarationMoves": [],
+  "mintMoves": [],
+  "criteriaObserves": [
+    {
+      "kind": "taskEventField",
+      "name": "tool_end.structured",
+      "assertions": [
+        "G3.a"
+      ]
+    },
+    {
+      "kind": "typeMember",
+      "name": "Checkpoint.version",
+      "assertions": [
+        "G4.a",
+        "G4.b"
+      ]
+    },
+    {
+      "kind": "typeMember",
+      "name": "Model.baseUrl",
+      "assertions": [
+        "G2.a",
+        "G2.b"
+      ]
+    },
+    {
+      "kind": "typeMember",
+      "name": "RouteRefusalDetail.requestBaseUrl",
+      "assertions": [
+        "G1.a",
+        "G1.b",
+        "G1.c"
+      ]
+    }
+  ],
+  "consumersHint": {
+    "cli": [],
+    "server": [],
+    "sdk": [],
+    "note": "scanned cli@9405bc53 server@5ad9cfda sdk@6fe2f08 — a name listed is MENTIONED there today, which is evidence of consumption, not proof of it"
+  },
+  "breakingCount": 0,
+  "breakingItems": [],
+  "toResolvedAt": "111dfebb7ef8517bbb3d2217dfb60277488a010d"
+}

package/wire-changes/core@7.24.3.json

@@ -0,0 +1,244 @@
+{
+  "repo": "core",
+  "version": "7.24.3",
+  "from": "800729adecdc333ea7b87007593b24c96714f6e3",
+  "to": "v7.24.3",
+  "added": [
+    {
+      "name": "MCP_LIVENESS_STATES",
+      "kind": "variable",
+      "tier": "advanced",
+      "at": [
+        "src/core/mcp-failure.ts:96",
+        "src/index.ts:351"
+      ],
+      "criteriaCovered": false,
+      "breaking": false
+    },
+    {
+      "name": "McpLivenessState",
+      "kind": "type",
+      "tier": "advanced",
+      "at": [
+        "src/core/mcp-failure.ts:97",
+        "src/index.ts:351"
+      ],
+      "criteriaCovered": false,
+      "breaking": false
+    },
+    {
+      "name": "McpServerLiveness",
+      "kind": "interface",
+      "tier": "advanced",
+      "at": [
+        "src/core/mcp-failure.ts:111",
+        "src/index.ts:351"
+      ],
+      "criteriaCovered": false,
+      "breaking": false
+    }
+  ],
+  "removed": [],
+  "changed": [],
+  "narrowed": [],
+  "closedSetMembers": [
+    {
+      "set": "MCP_LIVENESS_STATES",
+      "at": [
+        "src/core/mcp-failure.ts:96"
+      ],
+      "newSet": true,
+      "added": [
+        "reachable",
+        "unknown",
+        "unreachable"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "set": "McpExchangeOutcome",
+      "at": [
+        "src/core/mcp-failure.ts:150"
+      ],
+      "newSet": true,
+      "added": [
+        "completed",
+        "connect_refused",
+        "connection_closed",
+        "connection_failed",
+        "http_status",
+        "invalid_config",
+        "not_mcp_response",
+        "protocol",
+        "spawn_failed",
+        "timeout",
+        "unknown"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "set": "McpLivenessState",
+      "at": [
+        "src/core/mcp-failure.ts:97",
+        "src/index.ts:351"
+      ],
+      "newSet": true,
+      "added": [
+        "reachable",
+        "unknown",
+        "unreachable"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "set": "OptionValueKind",
+      "at": [
+        "src/tools/fs/bash-readonly-classifier.ts:1477"
+      ],
+      "newSet": true,
+      "added": [
+        "count",
+        "delimiter",
+        "form",
+        "header",
+        "indirect",
+        "label",
+        "name-pattern",
+        "path",
+        "pattern",
+        "script",
+        "url"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "set": "READ_CANDIDATE_PROVENANCES",
+      "at": [
+        "src/tools/fs/shell-read-plan.ts:79"
+      ],
+      "newSet": true,
+      "added": [
+        "cd_target",
+        "env_assignment",
+        "operand",
+        "option_value",
+        "program_path",
+        "script_slot_file",
+        "stdin_redirect",
+        "traversal_root",
+        "unlisted_word",
+        "write_redirect_target"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "set": "ReadCandidateProvenance",
+      "at": [
+        "src/tools/fs/shell-read-plan.ts:91"
+      ],
+      "newSet": true,
+      "added": [
+        "cd_target",
+        "env_assignment",
+        "operand",
+        "option_value",
+        "program_path",
+        "script_slot_file",
+        "stdin_redirect",
+        "traversal_root",
+        "unlisted_word",
+        "write_redirect_target"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    }
+  ],
+  "closedSetsUnreadable": [],
+  "typeKeys": [
+    {
+      "type": "McpServerStatus",
+      "at": [
+        "src/core/mcp.ts:394"
+      ],
+      "added": [
+        "liveness"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": false
+    },
+    {
+      "type": "WiringManifestMcpEntry",
+      "at": [
+        "src/core/wiring-manifest.ts:128"
+      ],
+      "added": [
+        "liveness"
+      ],
+      "removed": [],
+      "breaking": false,
+      "criteriaCovered": true
+    }
+  ],
+  "declarationMoves": [],
+  "mintMoves": [],
+  "criteriaObserves": [
+    {
+      "kind": "taskEventField",
+      "name": "tool_end.isError",
+      "assertions": [
+        "G3.a"
+      ]
+    },
+    {
+      "kind": "taskEventField",
+      "name": "wiring_manifest.manifest",
+      "assertions": [
+        "G1.b"
+      ]
+    },
+    {
+      "kind": "typeMember",
+      "name": "TaskSpec.sessionId",
+      "assertions": [
+        "G2.a"
+      ]
+    },
+    {
+      "kind": "typeMember",
+      "name": "WiringManifestMcpEntry.liveness",
+      "assertions": [
+        "G1.a"
+      ]
+    }
+  ],
+  "consumersHint": {
+    "cli": [
+      "McpServerStatus",
+      "WiringManifestMcpEntry"
+    ],
+    "server": [
+      "McpServerStatus",
+      "WiringManifestMcpEntry"
+    ],
+    "sdk": [
+      "McpServerStatus",
+      "WiringManifestMcpEntry"
+    ],
+    "note": "scanned cli@547c2c31 server@02807610 sdk@9b6bcaa — a name listed is MENTIONED there today, which is evidence of consumption, not proof of it"
+  },
+  "breakingCount": 0,
+  "breakingItems": [],
+  "toResolvedAt": "aa2335b2f9223c8e838c8a496564058bdf972870"
+}