agentfootprint 9.114.2 → 9.115.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 (230) hide show
  1. package/AGENTS.md +1 -1
  2. package/CAPABILITIES.md +3 -0
  3. package/ai-instructions/claude-code/SKILL.md +1 -1
  4. package/dist/adapters/hosting/agentCoreA2A.js +5 -0
  5. package/dist/adapters/hosting/agentCoreA2A.js.map +1 -1
  6. package/dist/adapters/hosting/agentcore.js +5 -0
  7. package/dist/adapters/hosting/agentcore.js.map +1 -1
  8. package/dist/adapters/hosting/foundryResponses.js +5 -0
  9. package/dist/adapters/hosting/foundryResponses.js.map +1 -1
  10. package/dist/adapters/observability/agentcore.js +18 -5
  11. package/dist/adapters/observability/agentcore.js.map +1 -1
  12. package/dist/adapters/observability/audit.js +17 -4
  13. package/dist/adapters/observability/audit.js.map +1 -1
  14. package/dist/adapters/observability/otel.js +890 -33
  15. package/dist/adapters/observability/otel.js.map +1 -1
  16. package/dist/artifacts/capability.js +9 -3
  17. package/dist/artifacts/capability.js.map +1 -1
  18. package/dist/bridge/eventMeta.js +40 -1
  19. package/dist/bridge/eventMeta.js.map +1 -1
  20. package/dist/core/Agent.js +40 -6
  21. package/dist/core/Agent.js.map +1 -1
  22. package/dist/core/RunnerBase.js +32 -1
  23. package/dist/core/RunnerBase.js.map +1 -1
  24. package/dist/core/agent/AgentBuilder.js +13 -1
  25. package/dist/core/agent/AgentBuilder.js.map +1 -1
  26. package/dist/core/agent/stages/toolCalls.js +64 -7
  27. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  28. package/dist/core/flowchartAsTool.js +8 -2
  29. package/dist/core/flowchartAsTool.js.map +1 -1
  30. package/dist/core/runbook/runbookAsTool.js +7 -2
  31. package/dist/core/runbook/runbookAsTool.js.map +1 -1
  32. package/dist/core/toolShownArgs.js +55 -0
  33. package/dist/core/toolShownArgs.js.map +1 -0
  34. package/dist/esm/adapters/hosting/agentCoreA2A.d.ts +14 -1
  35. package/dist/esm/adapters/hosting/agentCoreA2A.js +5 -0
  36. package/dist/esm/adapters/hosting/agentCoreA2A.js.map +1 -1
  37. package/dist/esm/adapters/hosting/agentcore.d.ts +18 -2
  38. package/dist/esm/adapters/hosting/agentcore.js +5 -0
  39. package/dist/esm/adapters/hosting/agentcore.js.map +1 -1
  40. package/dist/esm/adapters/hosting/foundryResponses.d.ts +15 -1
  41. package/dist/esm/adapters/hosting/foundryResponses.js +5 -0
  42. package/dist/esm/adapters/hosting/foundryResponses.js.map +1 -1
  43. package/dist/esm/adapters/observability/agentcore.d.ts +17 -5
  44. package/dist/esm/adapters/observability/agentcore.js +18 -5
  45. package/dist/esm/adapters/observability/agentcore.js.map +1 -1
  46. package/dist/esm/adapters/observability/audit.d.ts +6 -2
  47. package/dist/esm/adapters/observability/audit.js +17 -4
  48. package/dist/esm/adapters/observability/audit.js.map +1 -1
  49. package/dist/esm/adapters/observability/otel.d.ts +240 -11
  50. package/dist/esm/adapters/observability/otel.js +890 -33
  51. package/dist/esm/adapters/observability/otel.js.map +1 -1
  52. package/dist/esm/artifacts/capability.d.ts +3 -1
  53. package/dist/esm/artifacts/capability.js +9 -3
  54. package/dist/esm/artifacts/capability.js.map +1 -1
  55. package/dist/esm/bridge/eventMeta.d.ts +32 -0
  56. package/dist/esm/bridge/eventMeta.js +38 -0
  57. package/dist/esm/bridge/eventMeta.js.map +1 -1
  58. package/dist/esm/core/Agent.d.ts +18 -5
  59. package/dist/esm/core/Agent.js +42 -8
  60. package/dist/esm/core/Agent.js.map +1 -1
  61. package/dist/esm/core/RunnerBase.d.ts +20 -0
  62. package/dist/esm/core/RunnerBase.js +32 -1
  63. package/dist/esm/core/RunnerBase.js.map +1 -1
  64. package/dist/esm/core/agent/AgentBuilder.js +13 -1
  65. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  66. package/dist/esm/core/agent/stages/toolCalls.d.ts +11 -0
  67. package/dist/esm/core/agent/stages/toolCalls.js +64 -7
  68. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  69. package/dist/esm/core/flowchartAsTool.js +8 -2
  70. package/dist/esm/core/flowchartAsTool.js.map +1 -1
  71. package/dist/esm/core/runbook/runbookAsTool.js +7 -2
  72. package/dist/esm/core/runbook/runbookAsTool.js.map +1 -1
  73. package/dist/esm/core/toolShownArgs.d.ts +62 -0
  74. package/dist/esm/core/toolShownArgs.js +49 -0
  75. package/dist/esm/core/toolShownArgs.js.map +1 -0
  76. package/dist/esm/events/payloads.d.ts +122 -6
  77. package/dist/esm/events/registry.d.ts +3 -1
  78. package/dist/esm/events/registry.js +2 -0
  79. package/dist/esm/events/registry.js.map +1 -1
  80. package/dist/esm/events/types.d.ts +7 -0
  81. package/dist/esm/hosting/artifactWire.d.ts +10 -2
  82. package/dist/esm/hosting/artifactWire.js +20 -2
  83. package/dist/esm/hosting/artifactWire.js.map +1 -1
  84. package/dist/esm/hosting/doorGuard.d.ts +280 -0
  85. package/dist/esm/hosting/doorGuard.js +499 -0
  86. package/dist/esm/hosting/doorGuard.js.map +1 -0
  87. package/dist/esm/hosting/errors.d.ts +113 -0
  88. package/dist/esm/hosting/errors.js +177 -0
  89. package/dist/esm/hosting/errors.js.map +1 -1
  90. package/dist/esm/hosting/httpHost.d.ts +32 -3
  91. package/dist/esm/hosting/httpHost.js +218 -4
  92. package/dist/esm/hosting/httpHost.js.map +1 -1
  93. package/dist/esm/hosting/index.d.ts +7 -5
  94. package/dist/esm/hosting/index.js +10 -3
  95. package/dist/esm/hosting/index.js.map +1 -1
  96. package/dist/esm/hosting/ingressRecord.d.ts +64 -10
  97. package/dist/esm/hosting/ingressRecord.js +65 -6
  98. package/dist/esm/hosting/ingressRecord.js.map +1 -1
  99. package/dist/esm/hosting/nodeHost.d.ts +32 -2
  100. package/dist/esm/hosting/nodeHost.js +10 -0
  101. package/dist/esm/hosting/nodeHost.js.map +1 -1
  102. package/dist/esm/hosting/standingAgent.js +362 -51
  103. package/dist/esm/hosting/standingAgent.js.map +1 -1
  104. package/dist/esm/hosting/turnArtifacts.d.ts +93 -0
  105. package/dist/esm/hosting/turnArtifacts.js +126 -0
  106. package/dist/esm/hosting/turnArtifacts.js.map +1 -0
  107. package/dist/esm/hosting/types.d.ts +196 -3
  108. package/dist/esm/hosting/types.js +10 -0
  109. package/dist/esm/hosting/types.js.map +1 -1
  110. package/dist/esm/hosting/webSocketConversation.d.ts +15 -1
  111. package/dist/esm/hosting/webSocketConversation.js +54 -2
  112. package/dist/esm/hosting/webSocketConversation.js.map +1 -1
  113. package/dist/esm/integrity/disposition/ledger.d.ts +8 -0
  114. package/dist/esm/integrity/disposition/ledger.js +0 -0
  115. package/dist/esm/integrity/disposition/ledger.js.map +1 -1
  116. package/dist/esm/lib/mcp/mcpServe.js +39 -2
  117. package/dist/esm/lib/mcp/mcpServe.js.map +1 -1
  118. package/dist/esm/lib/mcp/types.d.ts +30 -0
  119. package/dist/esm/recorders/observability/commentary/artifactPhrases.d.ts +4 -0
  120. package/dist/esm/recorders/observability/commentary/artifactPhrases.js +9 -0
  121. package/dist/esm/recorders/observability/commentary/artifactPhrases.js.map +1 -1
  122. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js +30 -3
  123. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js.map +1 -1
  124. package/dist/esm/recorders/observability/recordRun.d.ts +12 -0
  125. package/dist/esm/recorders/observability/recordRun.js +17 -1
  126. package/dist/esm/recorders/observability/recordRun.js.map +1 -1
  127. package/dist/esm/strategies/attach.js +87 -1
  128. package/dist/esm/strategies/attach.js.map +1 -1
  129. package/dist/events/registry.js +2 -0
  130. package/dist/events/registry.js.map +1 -1
  131. package/dist/hosting/artifactWire.js +21 -3
  132. package/dist/hosting/artifactWire.js.map +1 -1
  133. package/dist/hosting/doorGuard.js +509 -0
  134. package/dist/hosting/doorGuard.js.map +1 -0
  135. package/dist/hosting/errors.js +183 -1
  136. package/dist/hosting/errors.js.map +1 -1
  137. package/dist/hosting/httpHost.js +218 -4
  138. package/dist/hosting/httpHost.js.map +1 -1
  139. package/dist/hosting/index.js +19 -2
  140. package/dist/hosting/index.js.map +1 -1
  141. package/dist/hosting/ingressRecord.js +66 -6
  142. package/dist/hosting/ingressRecord.js.map +1 -1
  143. package/dist/hosting/nodeHost.js +11 -1
  144. package/dist/hosting/nodeHost.js.map +1 -1
  145. package/dist/hosting/standingAgent.js +359 -48
  146. package/dist/hosting/standingAgent.js.map +1 -1
  147. package/dist/hosting/turnArtifacts.js +130 -0
  148. package/dist/hosting/turnArtifacts.js.map +1 -0
  149. package/dist/hosting/types.js +11 -1
  150. package/dist/hosting/types.js.map +1 -1
  151. package/dist/hosting/webSocketConversation.js +54 -2
  152. package/dist/hosting/webSocketConversation.js.map +1 -1
  153. package/dist/integrity/disposition/ledger.js +0 -0
  154. package/dist/integrity/disposition/ledger.js.map +1 -1
  155. package/dist/lib/mcp/mcpServe.js +39 -2
  156. package/dist/lib/mcp/mcpServe.js.map +1 -1
  157. package/dist/recorders/observability/commentary/artifactPhrases.js +10 -1
  158. package/dist/recorders/observability/commentary/artifactPhrases.js.map +1 -1
  159. package/dist/recorders/observability/commentary/commentaryTemplates.js +29 -2
  160. package/dist/recorders/observability/commentary/commentaryTemplates.js.map +1 -1
  161. package/dist/recorders/observability/recordRun.js +20 -3
  162. package/dist/recorders/observability/recordRun.js.map +1 -1
  163. package/dist/strategies/attach.js +87 -1
  164. package/dist/strategies/attach.js.map +1 -1
  165. package/dist/types/adapters/hosting/agentCoreA2A.d.ts +14 -1
  166. package/dist/types/adapters/hosting/agentCoreA2A.d.ts.map +1 -1
  167. package/dist/types/adapters/hosting/agentcore.d.ts +18 -2
  168. package/dist/types/adapters/hosting/agentcore.d.ts.map +1 -1
  169. package/dist/types/adapters/hosting/foundryResponses.d.ts +15 -1
  170. package/dist/types/adapters/hosting/foundryResponses.d.ts.map +1 -1
  171. package/dist/types/adapters/observability/agentcore.d.ts +17 -5
  172. package/dist/types/adapters/observability/agentcore.d.ts.map +1 -1
  173. package/dist/types/adapters/observability/audit.d.ts +6 -2
  174. package/dist/types/adapters/observability/audit.d.ts.map +1 -1
  175. package/dist/types/adapters/observability/otel.d.ts +240 -11
  176. package/dist/types/adapters/observability/otel.d.ts.map +1 -1
  177. package/dist/types/artifacts/capability.d.ts +3 -1
  178. package/dist/types/artifacts/capability.d.ts.map +1 -1
  179. package/dist/types/bridge/eventMeta.d.ts +32 -0
  180. package/dist/types/bridge/eventMeta.d.ts.map +1 -1
  181. package/dist/types/core/Agent.d.ts +18 -5
  182. package/dist/types/core/Agent.d.ts.map +1 -1
  183. package/dist/types/core/RunnerBase.d.ts +20 -0
  184. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  185. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  186. package/dist/types/core/agent/stages/toolCalls.d.ts +11 -0
  187. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  188. package/dist/types/core/flowchartAsTool.d.ts.map +1 -1
  189. package/dist/types/core/runbook/runbookAsTool.d.ts.map +1 -1
  190. package/dist/types/core/toolShownArgs.d.ts +63 -0
  191. package/dist/types/core/toolShownArgs.d.ts.map +1 -0
  192. package/dist/types/events/payloads.d.ts +122 -6
  193. package/dist/types/events/payloads.d.ts.map +1 -1
  194. package/dist/types/events/registry.d.ts +3 -1
  195. package/dist/types/events/registry.d.ts.map +1 -1
  196. package/dist/types/events/types.d.ts +7 -0
  197. package/dist/types/events/types.d.ts.map +1 -1
  198. package/dist/types/hosting/artifactWire.d.ts +10 -2
  199. package/dist/types/hosting/artifactWire.d.ts.map +1 -1
  200. package/dist/types/hosting/doorGuard.d.ts +281 -0
  201. package/dist/types/hosting/doorGuard.d.ts.map +1 -0
  202. package/dist/types/hosting/errors.d.ts +113 -0
  203. package/dist/types/hosting/errors.d.ts.map +1 -1
  204. package/dist/types/hosting/httpHost.d.ts +32 -3
  205. package/dist/types/hosting/httpHost.d.ts.map +1 -1
  206. package/dist/types/hosting/index.d.ts +7 -5
  207. package/dist/types/hosting/index.d.ts.map +1 -1
  208. package/dist/types/hosting/ingressRecord.d.ts +64 -10
  209. package/dist/types/hosting/ingressRecord.d.ts.map +1 -1
  210. package/dist/types/hosting/nodeHost.d.ts +32 -2
  211. package/dist/types/hosting/nodeHost.d.ts.map +1 -1
  212. package/dist/types/hosting/standingAgent.d.ts.map +1 -1
  213. package/dist/types/hosting/turnArtifacts.d.ts +94 -0
  214. package/dist/types/hosting/turnArtifacts.d.ts.map +1 -0
  215. package/dist/types/hosting/types.d.ts +196 -3
  216. package/dist/types/hosting/types.d.ts.map +1 -1
  217. package/dist/types/hosting/webSocketConversation.d.ts +15 -1
  218. package/dist/types/hosting/webSocketConversation.d.ts.map +1 -1
  219. package/dist/types/integrity/disposition/ledger.d.ts +8 -0
  220. package/dist/types/integrity/disposition/ledger.d.ts.map +1 -1
  221. package/dist/types/lib/mcp/mcpServe.d.ts.map +1 -1
  222. package/dist/types/lib/mcp/types.d.ts +30 -0
  223. package/dist/types/lib/mcp/types.d.ts.map +1 -1
  224. package/dist/types/recorders/observability/commentary/artifactPhrases.d.ts +4 -0
  225. package/dist/types/recorders/observability/commentary/artifactPhrases.d.ts.map +1 -1
  226. package/dist/types/recorders/observability/commentary/commentaryTemplates.d.ts.map +1 -1
  227. package/dist/types/recorders/observability/recordRun.d.ts +12 -0
  228. package/dist/types/recorders/observability/recordRun.d.ts.map +1 -1
  229. package/dist/types/strategies/attach.d.ts.map +1 -1
  230. package/package.json +1 -1
@@ -19,7 +19,7 @@
19
19
  * say so loudly and name the adapter it is talking about.
20
20
  */
21
21
  Object.defineProperty(exports, "__esModule", { value: true });
22
- exports.requireCapability = exports.WireRequestRefusal = exports.RequestTooLargeError = exports.SessionsNotCarriedError = exports.SessionOwnershipConflictError = exports.SessionNotFoundError = exports.SessionRetentionUnavailableError = exports.SessionIndexUnavailableError = exports.SessionOpNeedsIdentityError = exports.AdmissionRefusedError = exports.VerifierUnavailableError = exports.IdentityNotVerifiedError = exports.UnreadableEnvelopeError = exports.ArtifactNotCarriedError = exports.ArtifactNotFoundError = exports.NoArtifactStoreError = exports.ArtifactSessionRequiredError = exports.InvalidWireOpError = exports.FrameTooLargeError = exports.ConversationClosedError = exports.NoPendingAskError = exports.AwaitingDecisionError = exports.PauseNotCarriedError = exports.ConcurrentRunError = exports.HostClosedError = void 0;
22
+ exports.requireCapability = exports.InvalidSessionIdError = exports.HostNotAllowedError = exports.OriginNotAllowedError = exports.UnsupportedMediaTypeError = exports.WireRequestRefusal = exports.RequestTooLargeError = exports.SessionsNotCarriedError = exports.SessionOwnershipConflictError = exports.SessionNotFoundError = exports.SessionRetentionUnavailableError = exports.SessionIndexUnavailableError = exports.SessionOpNeedsIdentityError = exports.AdmissionRefusedError = exports.VerifierUnavailableError = exports.IdentityNotVerifiedError = exports.UnreadableEnvelopeError = exports.TurnArtifactsExpiredError = exports.ArtifactNotCarriedError = exports.ArtifactNotFoundError = exports.NoArtifactStoreError = exports.ArtifactSessionRequiredError = exports.InvalidWireOpError = exports.FrameTooLargeError = exports.ConversationClosedError = exports.NoPendingAskError = exports.AwaitingDecisionError = exports.PauseNotCarriedError = exports.ConcurrentRunError = exports.HostClosedError = void 0;
23
23
  const storedPreview_js_1 = require("../lib/storedPreview.js");
24
24
  /**
25
25
  * Thrown when a request arrives at a host that is shutting down or shut down.
@@ -354,6 +354,38 @@ class ArtifactNotCarriedError extends Error {
354
354
  }
355
355
  }
356
356
  exports.ArtifactNotCarriedError = ArtifactNotCarriedError;
357
+ /**
358
+ * Refused when host code uses a turn's artifact hand-over
359
+ * (`HostReply.turnArtifacts`) after that turn ended.
360
+ *
361
+ * The hand-over is live only while the hook runs: the composer awaits the
362
+ * hook while the session's lane is held, waits for every operation the hook
363
+ * started, then revokes the binding before the reply ends. A verb called
364
+ * after that is refused by name rather than performed. The footprintjs
365
+ * `ScopeFacade · assertLive` law, one layer up: a handle held past its stage
366
+ * is refused, because a write made outside its turn lands on whatever run the
367
+ * instance is serving by then — in the shared shape, another person's — and
368
+ * makes the record lie.
369
+ *
370
+ * The fix is always the same: file INSIDE the hook (`await
371
+ * turn.artifacts.put(...)`), and carry the ticket onward from there.
372
+ */
373
+ class TurnArtifactsExpiredError extends Error {
374
+ code = 'ERR_TURN_ARTIFACTS_EXPIRED';
375
+ /** Which verb was called after the turn ended. */
376
+ op;
377
+ constructor(op) {
378
+ super(`[hosting] turnArtifacts.${op}(...) was called after its turn ended. The hand-over ` +
379
+ `is live only while reply.turnArtifacts runs: the composer awaits the hook, waits ` +
380
+ `for every operation it started, then revokes the binding before the reply ends — ` +
381
+ `a write made later would land on whatever run the agent is serving by then. File ` +
382
+ `inside the hook (await turn.artifacts.${op}(...)) and carry the result onward from ` +
383
+ `there.`);
384
+ this.name = 'TurnArtifactsExpiredError';
385
+ this.op = op;
386
+ }
387
+ }
388
+ exports.TurnArtifactsExpiredError = TurnArtifactsExpiredError;
357
389
  /**
358
390
  * An already-computed preview, so {@link UnreadableEnvelopeError.withSession}
359
391
  * can copy a refusal without being handed the stored bytes a second time. Not
@@ -797,6 +829,156 @@ class WireRequestRefusal extends Error {
797
829
  }
798
830
  }
799
831
  exports.WireRequestRefusal = WireRequestRefusal;
832
+ // ─── The door guard ──────────────────────────────────────────────────
833
+ //
834
+ // Four refusals the HOST makes before any handler sees a request — see
835
+ // `doorGuard.ts` for the rules and `docs/design/2026-09-door-hardening.md` for
836
+ // the threat. Each carries its own HTTP `status`, because the conversation door
837
+ // answers a pre-101 socket by hand and an application route calling the same
838
+ // guard answers with its own response writer; a status only `httpHost` could
839
+ // look up would leave both of them guessing.
840
+ //
841
+ // **None of them ever repeats what the caller sent.** Not the content type,
842
+ // not the Origin, not the Host, not one character of a session id — the
843
+ // refusal names the rule and the option that changes it, nothing else. A
844
+ // session id in a refusal is a session id in every log line and trace span the
845
+ // refusal reaches, which is the exposure the fourth one exists to close.
846
+ /**
847
+ * A request that changes something did not say `content-type: application/json`.
848
+ *
849
+ * The door is a JSON API, and that is only half the reason. The other half is
850
+ * the web: a page on ANY site can make a browser send `text/plain`,
851
+ * `application/x-www-form-urlencoded` or `multipart/form-data` — or no content
852
+ * type at all — without asking the server first (a CORS "simple" request). A
853
+ * browser must ask first (a preflight, which this host never approves) before
854
+ * it sends `application/json` across origins. Requiring it is what turns a
855
+ * forged request into one the browser refuses to send.
856
+ */
857
+ class UnsupportedMediaTypeError extends Error {
858
+ code = 'ERR_UNSUPPORTED_MEDIA_TYPE';
859
+ /** 415 Unsupported Media Type. */
860
+ status = 415;
861
+ constructor(hostName) {
862
+ super(`[hosting] the '${hostName}' host takes JSON: a request that changes anything must say ` +
863
+ `content-type: application/json. Other content types are refused because a web page on ` +
864
+ `any site can make a browser send them without asking first — this is the cross-site ` +
865
+ `request defence, not a parser preference. Send the header; an integration that ` +
866
+ `genuinely cannot is named on the host with requireJsonContentType: false.`);
867
+ this.name = 'UnsupportedMediaTypeError';
868
+ }
869
+ }
870
+ exports.UnsupportedMediaTypeError = UnsupportedMediaTypeError;
871
+ /**
872
+ * A browser request came from a page whose origin this door does not allow —
873
+ * or from an opaque origin (`Origin: null`), which any sandboxed frame on any
874
+ * site can produce and which is therefore never allowed — or the browser said
875
+ * outright that it was sent cross-site.
876
+ *
877
+ * Only BROWSERS send `Origin` (on every request that changes something, and on
878
+ * every WebSocket handshake), so a request without one is a script or a
879
+ * server — unless the same request carries the browser's own `Sec-Fetch-Site:
880
+ * cross-site`, which is how a stripped `Origin` still gets caught.
881
+ */
882
+ class OriginNotAllowedError extends Error {
883
+ code = 'ERR_ORIGIN_NOT_ALLOWED';
884
+ /** 403 Forbidden. */
885
+ status = 403;
886
+ /** Which browser fact refused it. */
887
+ rule;
888
+ constructor(hostName, rule) {
889
+ super(`[hosting] the '${hostName}' host refuses a request sent by a web page from an origin it ` +
890
+ `does not allow. ` +
891
+ (rule === 'listed'
892
+ ? `Only the origins listed in allowedOrigins may drive it from a browser — add the ` +
893
+ `page's origin there if it should.`
894
+ : rule === 'same-host'
895
+ ? `With allowedOrigins unset, a page may drive it only from this host's own name ` +
896
+ `(the request's Host, or X-Forwarded-Host from a proxy). Serve the page from this ` +
897
+ `host, or list its origin in allowedOrigins.`
898
+ : `The browser marked it cross-site (Sec-Fetch-Site) and its Origin is not one ` +
899
+ `allowedOrigins lists. If this is your own page, a reverse proxy in front of this ` +
900
+ `host is stripping or rewriting headers: it must forward Origin and Sec-Fetch-* ` +
901
+ `unchanged. Otherwise list the page's origin in allowedOrigins.`));
902
+ this.name = 'OriginNotAllowedError';
903
+ this.rule = rule;
904
+ }
905
+ }
906
+ exports.OriginNotAllowedError = OriginNotAllowedError;
907
+ /**
908
+ * A request named a Host this door was not configured to answer for.
909
+ *
910
+ * The DNS-rebinding defence: a page on an attacker's domain re-points its OWN
911
+ * name at this server's address, and from then on the browser treats it as
912
+ * same-origin with the door — so every other check passes, and the Host header
913
+ * (which no page can set) is the one fact that still names the attacker.
914
+ * 421 is the status HTTP defines for exactly this (RFC 9110 §15.5.20: a target
915
+ * "that does not match an origin for which the server has been configured").
916
+ */
917
+ class HostNotAllowedError extends Error {
918
+ code = 'ERR_HOST_NOT_ALLOWED';
919
+ /** 421 Misdirected Request. */
920
+ status = 421;
921
+ /**
922
+ * Where the list came from: `'listed'` — the deployment's own
923
+ * `allowedHosts`; `'loopback-default'` — nobody set one, and the door is
924
+ * bound to a loopback address, so it answers the loopback names only.
925
+ */
926
+ rule;
927
+ constructor(hostName, rule = 'listed') {
928
+ super(rule === 'loopback-default'
929
+ ? `[hosting] the '${hostName}' host is bound to a loopback address, so with allowedHosts ` +
930
+ `unset it answers only localhost, 127.0.0.1 and [::1] — the defence against a page ` +
931
+ `on another domain re-pointing its own name at this machine (DNS rebinding). Behind ` +
932
+ `a reverse proxy that forwards the public name in Host (nginx ` +
933
+ `proxy_set_header Host $host), list that name in allowedHosts.`
934
+ : `[hosting] the '${hostName}' host is not configured to answer for the name this ` +
935
+ `request was sent to. It answers only the names in allowedHosts — the defence ` +
936
+ `against a page on another domain re-pointing its own name at this server (DNS ` +
937
+ `rebinding). Reach it by one of its configured names, or add this one to ` +
938
+ `allowedHosts.`);
939
+ this.name = 'HostNotAllowedError';
940
+ this.rule = rule;
941
+ }
942
+ }
943
+ exports.HostNotAllowedError = HostNotAllowedError;
944
+ /**
945
+ * A session id the door will not carry: empty, longer than the ceiling, or
946
+ * holding anything but visible ASCII (0x21–0x7E).
947
+ *
948
+ * A session id is caller data that travels everywhere the conversation does —
949
+ * the store's key, every log line, every exported trace span of every turn.
950
+ * Unbounded, one caller with no credentials could make every span of a turn
951
+ * carry megabytes; with a control, a line separator or a bidi override, it
952
+ * could forge or disguise a line in any log that prints it; with non-ASCII,
953
+ * the same id read from a header (latin1) and from a body (UTF-8) would be two
954
+ * different conversations. So it is bounded at the door, before any of that
955
+ * happens. The refusal says how long the id was, never what it said.
956
+ */
957
+ class InvalidSessionIdError extends Error {
958
+ code = 'ERR_INVALID_SESSION_ID';
959
+ /** 400 Bad Request — the caller can send a valid id and continue. */
960
+ status = 400;
961
+ /** Which rule the id broke. Never the id. */
962
+ reason;
963
+ constructor(reason, hostName, length, limit) {
964
+ super(reason === 'too-long'
965
+ ? `[hosting] the '${hostName}' host refuses a session id of ${String(length)} ` +
966
+ `characters; the ceiling is ${String(limit)}. A session id travels into every ` +
967
+ `stored row, log line and trace span of the conversation, so it is bounded at the ` +
968
+ `door. Send a shorter one — a UUID is 36.`
969
+ : reason === 'empty'
970
+ ? `[hosting] the '${hostName}' host refuses an empty session id: every caller that ` +
971
+ `sent one would share a single conversation. Send an id, or leave the field out ` +
972
+ `to have no session.`
973
+ : `[hosting] the '${hostName}' host refuses a session id containing a character ` +
974
+ `outside visible ASCII (0x21–0x7E). A session id is printed wherever the ` +
975
+ `conversation is logged and read from headers and bodies alike, so it is limited ` +
976
+ `to characters every one of them spells the same way — a UUID fits.`);
977
+ this.name = 'InvalidSessionIdError';
978
+ this.reason = reason;
979
+ }
980
+ }
981
+ exports.InvalidSessionIdError = InvalidSessionIdError;
800
982
  function requireCapability(host, capability) {
801
983
  if (host.capabilities.includes(capability))
802
984
  return;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/hosting/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/hosting/errors.ts"],"names":[],"mappings":"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"}
@@ -64,6 +64,21 @@
64
64
  * whichever closes last; on a caller-owned one each door attaches and detaches
65
65
  * its own listener and neither touches the socket.
66
66
  *
67
+ * ── The door guard, on both doors ────────────────────────────────────────────
68
+ * Being able to reach the port is not permission: every browser inside the
69
+ * network can be steered by any page it opens. So before any handler sees a
70
+ * request, the request door and the conversation door ask one guard
71
+ * (`doorGuard.ts`): a Host this door was not configured for (421), a browser
72
+ * origin it does not allow (403), a state-changing request that does not say
73
+ * it is JSON (415) — and, once a dialect has read it, a session id over the
74
+ * bound (400). Judged on the headers alone — a refused body is never parsed,
75
+ * only drained when small so its sender reads the answer — and never invited
76
+ * with a `100 Continue` on a socket this host owns. Answered with the
77
+ * refusal's own sentence, reported to `onRefusal` listeners. Probes (the
78
+ * health GET, the HEAD probe) are never asked; routes handed to `onUnhandled`
79
+ * are the caller's. A loopback bind with `allowedHosts` unset answers the
80
+ * loopback names only.
81
+ *
67
82
  * Pattern: Template method via configuration (Strategy on the wire format).
68
83
  * Everything HTTP lives here and in the wires; `types.ts` knows none of it.
69
84
  */
@@ -93,9 +108,11 @@ var __importStar = (this && this.__importStar) || function (mod) {
93
108
  Object.defineProperty(exports, "__esModule", { value: true });
94
109
  exports.headerValue = exports.httpHost = void 0;
95
110
  const stream_js_1 = require("../stream.js");
111
+ const doorGuard_js_1 = require("./doorGuard.js");
96
112
  const errors_js_1 = require("./errors.js");
97
113
  const sessionWire_js_1 = require("./sessionWire.js");
98
114
  const headers_js_1 = require("./headers.js");
115
+ const identityVerification_js_1 = require("./identityVerification.js");
99
116
  const webSocketConversation_js_1 = require("./webSocketConversation.js");
100
117
  /**
101
118
  * Status codes mapped by refusal code. Anything else is a 500.
@@ -154,6 +171,17 @@ const STATUS_BY_CODE = {
154
171
  ERR_SESSION_INDEX_UNAVAILABLE: 501,
155
172
  ERR_SESSIONS_NOT_CARRIED: 501,
156
173
  ERR_REQUEST_TOO_LARGE: 413,
174
+ // The door guard — each refusal also carries its own `status`, which is what
175
+ // this host answers with; listed here too so a handler that fails a reply
176
+ // with one of them gets the same status and never a 500.
177
+ // 415: a request that changes something did not say it was JSON.
178
+ // 403: a browser page from an origin this door does not allow.
179
+ // 421: a Host this door was not configured to answer for (RFC 9110 §15.5.20).
180
+ // 400: a session id over the ceiling or with a control character in it.
181
+ ERR_UNSUPPORTED_MEDIA_TYPE: 415,
182
+ ERR_ORIGIN_NOT_ALLOWED: 403,
183
+ ERR_HOST_NOT_ALLOWED: 421,
184
+ ERR_INVALID_SESSION_ID: 400,
157
185
  };
158
186
  /**
159
187
  * What a run that stopped to ask a person answers with: **202 Accepted.**
@@ -235,6 +263,48 @@ function httpHost(options) {
235
263
  ...DEFAULT_CONVERSATION_LIMITS,
236
264
  ...options.conversationLimits,
237
265
  };
266
+ // ── The door guard ─────────────────────────────────────────────────
267
+ //
268
+ // Built at construction, so a configuration it could only misread (an
269
+ // `allowedOrigins` of 'null', an empty `allowedHosts`) is refused here, by
270
+ // name, before a socket exists. Both doors ask it; every refusal it makes —
271
+ // and every session id the bound refuses — goes to the listeners below,
272
+ // which is how a request no handler ever saw still reaches an ingress
273
+ // record.
274
+ //
275
+ // A LOOPBACK bind this host makes itself, with `allowedHosts` unset, answers
276
+ // the loopback names only: such a socket can be reached by no other name, so
277
+ // the default refuses nobody and closes DNS rebinding on a developer's own
278
+ // machine. (A caller-owned server's address is the caller's; it is not
279
+ // guessed.)
280
+ const guard = (0, doorGuard_js_1.doorGuard)({
281
+ name,
282
+ ...(!ownServer && { bindHost: hostname }),
283
+ ...(options.allowedOrigins !== undefined && { allowedOrigins: options.allowedOrigins }),
284
+ ...(options.allowedHosts !== undefined && { allowedHosts: options.allowedHosts }),
285
+ ...(options.requireJsonContentType !== undefined && {
286
+ requireJsonContentType: options.requireJsonContentType,
287
+ }),
288
+ });
289
+ const refusalListeners = new Set();
290
+ /** Tell every listener; a listener that throws is contained — the refusal is already answered. */
291
+ function reportRefusal(refusal) {
292
+ for (const listener of [...refusalListeners]) {
293
+ try {
294
+ listener(refusal);
295
+ }
296
+ catch {
297
+ // A broken log must not turn an answered refusal into this process's failure.
298
+ }
299
+ }
300
+ }
301
+ /** The staged default and the rules-off notice, each said once at boot (per host name, per process). */
302
+ function announceBoot() {
303
+ if (guard.allowedHostsUnset)
304
+ (0, doorGuard_js_1.warnAllowedHostsUnset)(name);
305
+ if (guard.browserRulesOff)
306
+ (0, doorGuard_js_1.warnBrowserRulesOff)(name);
307
+ }
238
308
  // ── The socket both doors stand on ─────────────────────────────────
239
309
  //
240
310
  // Refcounted, because the deployment this exists for hands a container ONE
@@ -312,6 +382,12 @@ function httpHost(options) {
312
382
  name,
313
383
  capabilities,
314
384
  conversationLimits,
385
+ onRefusal(listener) {
386
+ refusalListeners.add(listener);
387
+ return () => {
388
+ refusalListeners.delete(listener);
389
+ };
390
+ },
315
391
  async serveConversations(handler) {
316
392
  if (conversationPath === undefined) {
317
393
  throw new Error(`[hosting] the '${name}' host was built without a 'conversationPath', so it has no ` +
@@ -335,6 +411,8 @@ function httpHost(options) {
335
411
  ...(wire.readConversation && { readConversation: wire.readConversation.bind(wire) }),
336
412
  handler,
337
413
  accepting: () => accepting,
414
+ guard,
415
+ onRefusal: reportRefusal,
338
416
  });
339
417
  const onUpgrade = (request, socketOfConversation) => {
340
418
  // THE LAW again, on the other door: an `'upgrade'` listener runs on
@@ -373,6 +451,7 @@ function httpHost(options) {
373
451
  conversationsServing = false;
374
452
  throw err;
375
453
  }
454
+ announceBoot();
376
455
  server.on('upgrade', onUpgrade);
377
456
  let where;
378
457
  try {
@@ -411,6 +490,68 @@ function httpHost(options) {
411
490
  const inFlight = new Set();
412
491
  let accepting = true;
413
492
  let closing;
493
+ /**
494
+ * Answer a door-guard refusal, report it, and close the connection.
495
+ *
496
+ * The body the caller is still sending is never parsed. When it was
497
+ * INVITED (no `Expect: 100-continue`, so the client is already
498
+ * uploading) and is small — at most {@link REFUSAL_DRAIN_BYTES}, within
499
+ * {@link REFUSAL_DRAIN_MS} — it is read and discarded first, so the
500
+ * client finishes its upload and READS the refusal instead of meeting a
501
+ * reset: closing a socket with unread bytes in it makes the kernel send
502
+ * RST, which a client mid-upload reports as `ECONNRESET` and never sees
503
+ * the 415. A body announced larger than that, or one that overruns it,
504
+ * is not drained — the answer goes out at once and a client still
505
+ * sending may see the reset. That is the bound, stated.
506
+ */
507
+ const refuseAtRequestDoor = (req, res, refusal, bodyInvited) => {
508
+ reportRefusal({
509
+ door: 'request',
510
+ error: refusal,
511
+ bearerPresent: (0, identityVerification_js_1.bearerToken)((0, headers_js_1.lowerCasedHeaders)(req.headers)) !== undefined,
512
+ });
513
+ const answer = () => {
514
+ try {
515
+ if (res.headersSent || res.writableEnded)
516
+ return;
517
+ sendJson(res, refusal.status, wire.failure(refusal.message, refusal.code), {
518
+ connection: 'close',
519
+ });
520
+ }
521
+ catch (err) {
522
+ failSafely(res, wire, err);
523
+ }
524
+ };
525
+ if (bodyInvited)
526
+ drainThenAnswer(req, answer);
527
+ else
528
+ answer();
529
+ };
530
+ /**
531
+ * `Expect: 100-continue` on a socket this host owns: judge the headers
532
+ * BEFORE node would say "100 Continue", so a refused request is never
533
+ * invited to send the body it is about to be refused for. Everything
534
+ * else gets its 100 and the ordinary route, exactly as node's default.
535
+ * (On a caller-owned server node answers 100 itself before any listener
536
+ * runs — that server's `checkContinue` is the caller's to own.)
537
+ */
538
+ const onCheckContinue = (req, res) => {
539
+ try {
540
+ const path = (req.url ?? '').split('?')[0];
541
+ if (accepting && req.method === 'POST' && path === invokePath) {
542
+ const crossSite = guard.check(req);
543
+ if (crossSite !== undefined) {
544
+ refuseAtRequestDoor(req, res, crossSite, false);
545
+ return;
546
+ }
547
+ }
548
+ res.writeContinue();
549
+ route(req, res);
550
+ }
551
+ catch (err) {
552
+ failSafely(res, wire, err);
553
+ }
554
+ };
414
555
  const route = (req, res) => {
415
556
  // On a shared server an earlier listener may already have answered.
416
557
  // Writing again would corrupt its reply; there is nothing to add.
@@ -451,7 +592,15 @@ function httpHost(options) {
451
592
  sendJson(res, STATUS_BY_CODE[refusal.code] ?? 500, wire.failure(refusal.message, refusal.code));
452
593
  return;
453
594
  }
454
- const served = serveOne(req, res, handler, wire, name, maxBodyBytes);
595
+ // The door guard, on the headers alone: a forged request's body is
596
+ // never parsed. See `refuseAtRequestDoor` for what happens to the
597
+ // bytes it is still sending.
598
+ const crossSite = guard.check(req);
599
+ if (crossSite !== undefined) {
600
+ refuseAtRequestDoor(req, res, crossSite, true);
601
+ return;
602
+ }
603
+ const served = serveOne(req, res, handler, wire, name, maxBodyBytes, reportRefusal);
455
604
  inFlight.add(served);
456
605
  // `serveOne` never rejects, by construction — see its doc.
457
606
  void served.finally(() => inFlight.delete(served));
@@ -471,13 +620,17 @@ function httpHost(options) {
471
620
  }
472
621
  };
473
622
  const server = await acquireSocket();
623
+ announceBoot();
474
624
  server.on('request', onRequest);
625
+ if (!ownServer)
626
+ server.on('checkContinue', onCheckContinue);
475
627
  let where;
476
628
  try {
477
629
  where = addressOf(server);
478
630
  }
479
631
  catch (err) {
480
632
  server.off('request', onRequest);
633
+ server.off('checkContinue', onCheckContinue);
481
634
  await releaseSocket();
482
635
  throw err;
483
636
  }
@@ -503,6 +656,7 @@ function httpHost(options) {
503
656
  // thing close() promises not to do.
504
657
  await Promise.allSettled([...inFlight]);
505
658
  server.off('request', onRequest);
659
+ server.off('checkContinue', onCheckContinue);
506
660
  // The socket goes only when the LAST door lets go of it. A
507
661
  // conversation still open on this port is not this door's to end.
508
662
  await releaseSocket();
@@ -522,9 +676,9 @@ exports.httpHost = httpHost;
522
676
  * which on node's defaults is the same crash the law above forbids, reached by
523
677
  * a different road.
524
678
  */
525
- async function serveOne(req, res, handler, wire, hostName, maxBodyBytes) {
679
+ async function serveOne(req, res, handler, wire, hostName, maxBodyBytes, reportRefusal) {
526
680
  try {
527
- await dispatchOne(req, res, handler, wire, hostName, maxBodyBytes);
681
+ await dispatchOne(req, res, handler, wire, hostName, maxBodyBytes, reportRefusal);
528
682
  }
529
683
  catch (err) {
530
684
  // Everything inside answers its own failures; anything that got past them
@@ -533,7 +687,7 @@ async function serveOne(req, res, handler, wire, hostName, maxBodyBytes) {
533
687
  failSafely(res, wire, err);
534
688
  }
535
689
  }
536
- async function dispatchOne(req, res, handler, wire, hostName, maxBodyBytes) {
690
+ async function dispatchOne(req, res, handler, wire, hostName, maxBodyBytes, reportRefusal) {
537
691
  const controller = new AbortController();
538
692
  let body;
539
693
  try {
@@ -583,6 +737,20 @@ async function dispatchOne(req, res, handler, wire, hostName, maxBodyBytes) {
583
737
  }
584
738
  throw err;
585
739
  }
740
+ // The session-id bound, on whatever the dialect read it from — a body field,
741
+ // a header, a cookie — and on the id a session-history op names inside
742
+ // itself. Here, once, so no dialect can forget it, and before anything is
743
+ // framed: an id past this line rides every span of every turn it touches.
744
+ const unboundedSession = (0, doorGuard_js_1.checkSessionId)(read.sessionId, hostName) ?? (0, doorGuard_js_1.checkSessionId)(sessionOpId(read.session), hostName);
745
+ if (unboundedSession !== undefined) {
746
+ sendJson(res, unboundedSession.status, wire.failure(unboundedSession.message, unboundedSession.code, facts));
747
+ reportRefusal({
748
+ door: 'request',
749
+ error: unboundedSession,
750
+ bearerPresent: (0, identityVerification_js_1.bearerToken)(headers) !== undefined,
751
+ });
752
+ return;
753
+ }
586
754
  const { input, sessionId, userId, decision, artifact, session, responseHeaders } = read;
587
755
  // The dialect's own reply headers — a `Set-Cookie` that issues a session, and
588
756
  // nothing else so far. Stripped of `content-type` because the framing below
@@ -778,6 +946,48 @@ async function dispatchOne(req, res, handler, wire, hostName, maxBodyBytes) {
778
946
  * was found to break: a surprise this file has not imagined yet becomes THIS
779
947
  * REQUEST's 400 or 500, the failure of the thing that caused it.
780
948
  */
949
+ /** The largest refused body read-and-discarded so its sender sees the refusal. */
950
+ const REFUSAL_DRAIN_BYTES = 1_048_576;
951
+ /** How long a refused body may take to arrive before the answer goes out anyway. */
952
+ const REFUSAL_DRAIN_MS = 2_000;
953
+ /**
954
+ * Read and discard a refused request's body — bounded in bytes and in time —
955
+ * then answer. A body announced over the bound (or none at all) is answered at
956
+ * once. Every listener is wrapped by `answer` itself, so nothing here can be
957
+ * the process's failure.
958
+ */
959
+ function drainThenAnswer(req, answer) {
960
+ const declared = req.headers['content-length'];
961
+ const chunked = req.headers['transfer-encoding'] !== undefined;
962
+ const length = declared === undefined ? 0 : Number(declared);
963
+ if (!chunked && !(length > 0 && length <= REFUSAL_DRAIN_BYTES)) {
964
+ answer();
965
+ return;
966
+ }
967
+ let read = 0;
968
+ let done = false;
969
+ const finish = () => {
970
+ if (done)
971
+ return;
972
+ done = true;
973
+ clearTimeout(timer);
974
+ req.off('data', onData);
975
+ req.off('end', finish);
976
+ req.off('error', finish);
977
+ answer();
978
+ };
979
+ const onData = (chunk) => {
980
+ read += chunk.length;
981
+ if (read > REFUSAL_DRAIN_BYTES)
982
+ finish();
983
+ };
984
+ const timer = setTimeout(finish, REFUSAL_DRAIN_MS);
985
+ if (typeof timer.unref === 'function')
986
+ timer.unref();
987
+ req.on('data', onData);
988
+ req.once('end', finish);
989
+ req.once('error', finish);
990
+ }
781
991
  /**
782
992
  * Write a framing's frames, in order, as Server-Sent Events.
783
993
  *
@@ -860,6 +1070,10 @@ function readJson(req, maxBodyBytes, hostName) {
860
1070
  });
861
1071
  });
862
1072
  }
1073
+ /** The conversation a session-history op names inside itself, when it names one. */
1074
+ function sessionOpId(session) {
1075
+ return session !== undefined && 'sessionId' in session ? session.sessionId : undefined;
1076
+ }
863
1077
  function sendJson(res, status, body, extraHeaders) {
864
1078
  res.writeHead(status, { ...extraHeaders, 'content-type': 'application/json' });
865
1079
  res.end(JSON.stringify(body));