@decionis/agentsafe 0.5.0 → 0.7.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 (211) hide show
  1. package/README.md +62 -19
  2. package/dist/Cli.js +18 -1
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +9 -4
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +7 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +2 -0
  10. package/dist/TrustedExecutor.js.map +1 -1
  11. package/dist/adapters/AdapterActionHandler.d.ts +36 -12
  12. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
  13. package/dist/adapters/AdapterActionHandler.js +99 -100
  14. package/dist/adapters/AdapterActionHandler.js.map +1 -1
  15. package/dist/adapters/EffectAdapter.d.ts +7 -103
  16. package/dist/adapters/EffectAdapter.d.ts.map +1 -1
  17. package/dist/adapters/EffectAdapter.js +7 -18
  18. package/dist/adapters/EffectAdapter.js.map +1 -1
  19. package/dist/adapters/EffectAdapterExecutor.d.ts +93 -0
  20. package/dist/adapters/EffectAdapterExecutor.d.ts.map +1 -0
  21. package/dist/adapters/EffectAdapterExecutor.js +191 -0
  22. package/dist/adapters/EffectAdapterExecutor.js.map +1 -0
  23. package/dist/adapters/banking/BankingExecutor.d.ts +35 -0
  24. package/dist/adapters/banking/BankingExecutor.d.ts.map +1 -0
  25. package/dist/adapters/banking/BankingExecutor.js +64 -0
  26. package/dist/adapters/banking/BankingExecutor.js.map +1 -0
  27. package/dist/adapters/banking/BankingHandlers.d.ts.map +1 -1
  28. package/dist/adapters/banking/BankingHandlers.js +6 -3
  29. package/dist/adapters/banking/BankingHandlers.js.map +1 -1
  30. package/dist/adapters/cards/CardAuthorizationExecutor.d.ts +66 -0
  31. package/dist/adapters/cards/CardAuthorizationExecutor.d.ts.map +1 -0
  32. package/dist/adapters/cards/CardAuthorizationExecutor.js +116 -0
  33. package/dist/adapters/cards/CardAuthorizationExecutor.js.map +1 -0
  34. package/dist/adapters/mcp/McpGuard.d.ts +32 -3
  35. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  36. package/dist/adapters/mcp/McpGuard.js +29 -5
  37. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  38. package/dist/adapters/mcp/McpIntentBinder.d.ts +18 -3
  39. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -1
  40. package/dist/adapters/mcp/McpIntentBinder.js +48 -1
  41. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -1
  42. package/dist/adapters/mcp/McpInvocation.d.ts +9 -2
  43. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -1
  44. package/dist/adapters/mcp/McpInvocation.js.map +1 -1
  45. package/dist/cli/Actions.d.ts +14 -0
  46. package/dist/cli/Actions.d.ts.map +1 -0
  47. package/dist/cli/Actions.js +168 -0
  48. package/dist/cli/Actions.js.map +1 -0
  49. package/dist/cli/Arguments.d.ts +4 -0
  50. package/dist/cli/Arguments.d.ts.map +1 -1
  51. package/dist/cli/Arguments.js +12 -3
  52. package/dist/cli/Arguments.js.map +1 -1
  53. package/dist/cli/ConfigCommand.d.ts.map +1 -1
  54. package/dist/cli/ConfigCommand.js +5 -0
  55. package/dist/cli/ConfigCommand.js.map +1 -1
  56. package/dist/cli/Doctor.d.ts.map +1 -1
  57. package/dist/cli/Doctor.js +2 -1
  58. package/dist/cli/Doctor.js.map +1 -1
  59. package/dist/cli/Help.d.ts.map +1 -1
  60. package/dist/cli/Help.js +13 -1
  61. package/dist/cli/Help.js.map +1 -1
  62. package/dist/cli/Host.d.ts +5 -2
  63. package/dist/cli/Host.d.ts.map +1 -1
  64. package/dist/cli/Host.js +24 -2
  65. package/dist/cli/Host.js.map +1 -1
  66. package/dist/cli/Profile.d.ts +24 -0
  67. package/dist/cli/Profile.d.ts.map +1 -0
  68. package/dist/cli/Profile.js +168 -0
  69. package/dist/cli/Profile.js.map +1 -0
  70. package/dist/cli/Records.d.ts +15 -0
  71. package/dist/cli/Records.d.ts.map +1 -0
  72. package/dist/cli/Records.js +205 -0
  73. package/dist/cli/Records.js.map +1 -0
  74. package/dist/config/ConfigKeys.d.ts +2 -2
  75. package/dist/config/ConfigKeys.d.ts.map +1 -1
  76. package/dist/config/ConfigKeys.js +6 -0
  77. package/dist/config/ConfigKeys.js.map +1 -1
  78. package/dist/config/ExecutorConfig.d.ts +29 -0
  79. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  80. package/dist/config/ExecutorConfig.js +53 -1
  81. package/dist/config/ExecutorConfig.js.map +1 -1
  82. package/dist/gateway/ForwardHandler.d.ts +22 -4
  83. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  84. package/dist/gateway/ForwardHandler.js +27 -10
  85. package/dist/gateway/ForwardHandler.js.map +1 -1
  86. package/dist/gateway/Gateway.d.ts +123 -3
  87. package/dist/gateway/Gateway.d.ts.map +1 -1
  88. package/dist/gateway/Gateway.js +513 -16
  89. package/dist/gateway/Gateway.js.map +1 -1
  90. package/dist/gateway/GatewayConfig.d.ts +109 -0
  91. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  92. package/dist/gateway/GatewayConfig.js +267 -9
  93. package/dist/gateway/GatewayConfig.js.map +1 -1
  94. package/dist/gateway/GatewayReport.d.ts +6 -2
  95. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  96. package/dist/gateway/GatewayReport.js +3 -0
  97. package/dist/gateway/GatewayReport.js.map +1 -1
  98. package/dist/gateway/InterceptedRequest.d.ts +45 -1
  99. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  100. package/dist/gateway/InterceptedRequest.js +43 -1
  101. package/dist/gateway/InterceptedRequest.js.map +1 -1
  102. package/dist/gateway/PolicySelector.d.ts +5 -0
  103. package/dist/gateway/PolicySelector.d.ts.map +1 -0
  104. package/dist/gateway/PolicySelector.js +9 -0
  105. package/dist/gateway/PolicySelector.js.map +1 -0
  106. package/dist/gateway/RouteTable.d.ts +44 -7
  107. package/dist/gateway/RouteTable.d.ts.map +1 -1
  108. package/dist/gateway/RouteTable.js +58 -9
  109. package/dist/gateway/RouteTable.js.map +1 -1
  110. package/dist/gateway/SubjectSessions.d.ts +113 -0
  111. package/dist/gateway/SubjectSessions.d.ts.map +1 -0
  112. package/dist/gateway/SubjectSessions.js +219 -0
  113. package/dist/gateway/SubjectSessions.js.map +1 -0
  114. package/dist/gateway/Upstream.d.ts +11 -0
  115. package/dist/gateway/Upstream.d.ts.map +1 -1
  116. package/dist/gateway/Upstream.js +19 -2
  117. package/dist/gateway/Upstream.js.map +1 -1
  118. package/dist/hosted/TenantHost.d.ts +24 -5
  119. package/dist/hosted/TenantHost.d.ts.map +1 -1
  120. package/dist/hosted/TenantHost.js +39 -10
  121. package/dist/hosted/TenantHost.js.map +1 -1
  122. package/dist/hosted/TenantRegistry.d.ts +20 -0
  123. package/dist/hosted/TenantRegistry.d.ts.map +1 -1
  124. package/dist/hosted/TenantRegistry.js +47 -1
  125. package/dist/hosted/TenantRegistry.js.map +1 -1
  126. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  127. package/dist/http/GatewayHttpServer.js +46 -2
  128. package/dist/http/GatewayHttpServer.js.map +1 -1
  129. package/dist/identity/WorkloadJwtVerifier.d.ts +13 -0
  130. package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -1
  131. package/dist/identity/WorkloadJwtVerifier.js +40 -8
  132. package/dist/identity/WorkloadJwtVerifier.js.map +1 -1
  133. package/dist/incident/HaltSwitch.d.ts +10 -2
  134. package/dist/incident/HaltSwitch.d.ts.map +1 -1
  135. package/dist/incident/HaltSwitch.js +22 -2
  136. package/dist/incident/HaltSwitch.js.map +1 -1
  137. package/dist/incident/SecurityEvents.d.ts +18 -0
  138. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  139. package/dist/incident/SecurityEvents.js +17 -0
  140. package/dist/incident/SecurityEvents.js.map +1 -1
  141. package/dist/journal/ExecutionJournal.d.ts +5 -120
  142. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  143. package/dist/journal/ExecutionJournal.js +5 -125
  144. package/dist/journal/ExecutionJournal.js.map +1 -1
  145. package/dist/journal/FileExecutionJournal.d.ts +1 -0
  146. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  147. package/dist/journal/FileExecutionJournal.js +4 -1
  148. package/dist/journal/FileExecutionJournal.js.map +1 -1
  149. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  150. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  151. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  152. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  153. package/dist/limits/HardLimits.d.ts.map +1 -1
  154. package/dist/limits/HardLimits.js.map +1 -1
  155. package/dist/outcomes/CardOutcomeEvidence.d.ts +56 -0
  156. package/dist/outcomes/CardOutcomeEvidence.d.ts.map +1 -0
  157. package/dist/outcomes/CardOutcomeEvidence.js +211 -0
  158. package/dist/outcomes/CardOutcomeEvidence.js.map +1 -0
  159. package/dist/outcomes/CardOutcomeFact.d.ts +90 -0
  160. package/dist/outcomes/CardOutcomeFact.d.ts.map +1 -0
  161. package/dist/outcomes/CardOutcomeFact.js +76 -0
  162. package/dist/outcomes/CardOutcomeFact.js.map +1 -0
  163. package/dist/outcomes/CardOutcomeLedger.d.ts +26 -0
  164. package/dist/outcomes/CardOutcomeLedger.d.ts.map +1 -0
  165. package/dist/outcomes/CardOutcomeLedger.js +31 -0
  166. package/dist/outcomes/CardOutcomeLedger.js.map +1 -0
  167. package/dist/outcomes/CardOutcomeRecorder.d.ts +35 -0
  168. package/dist/outcomes/CardOutcomeRecorder.d.ts.map +1 -0
  169. package/dist/outcomes/CardOutcomeRecorder.js +84 -0
  170. package/dist/outcomes/CardOutcomeRecorder.js.map +1 -0
  171. package/dist/outcomes/CardOutcomes.d.ts +68 -0
  172. package/dist/outcomes/CardOutcomes.d.ts.map +1 -0
  173. package/dist/outcomes/CardOutcomes.js +191 -0
  174. package/dist/outcomes/CardOutcomes.js.map +1 -0
  175. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts +54 -0
  176. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts.map +1 -0
  177. package/dist/outcomes/CoreOutcomeEvidenceClient.js +116 -0
  178. package/dist/outcomes/CoreOutcomeEvidenceClient.js.map +1 -0
  179. package/dist/outcomes/FileCardOutcomeLedger.d.ts +36 -0
  180. package/dist/outcomes/FileCardOutcomeLedger.d.ts.map +1 -0
  181. package/dist/outcomes/FileCardOutcomeLedger.js +152 -0
  182. package/dist/outcomes/FileCardOutcomeLedger.js.map +1 -0
  183. package/dist/outcomes/OutcomeEvidence.d.ts +238 -0
  184. package/dist/outcomes/OutcomeEvidence.d.ts.map +1 -0
  185. package/dist/outcomes/OutcomeEvidence.js +130 -0
  186. package/dist/outcomes/OutcomeEvidence.js.map +1 -0
  187. package/dist/outcomes/OutcomeEvidencePublisher.d.ts +81 -0
  188. package/dist/outcomes/OutcomeEvidencePublisher.d.ts.map +1 -0
  189. package/dist/outcomes/OutcomeEvidencePublisher.js +189 -0
  190. package/dist/outcomes/OutcomeEvidencePublisher.js.map +1 -0
  191. package/dist/outcomes/OutcomeEvidenceStore.d.ts +57 -0
  192. package/dist/outcomes/OutcomeEvidenceStore.d.ts.map +1 -0
  193. package/dist/outcomes/OutcomeEvidenceStore.js +191 -0
  194. package/dist/outcomes/OutcomeEvidenceStore.js.map +1 -0
  195. package/dist/service/Requests.d.ts +6 -0
  196. package/dist/service/Requests.d.ts.map +1 -1
  197. package/dist/service/Requests.js +9 -1
  198. package/dist/service/Requests.js.map +1 -1
  199. package/dist/service/TrustedExecutorService.d.ts +21 -1
  200. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  201. package/dist/service/TrustedExecutorService.js +73 -23
  202. package/dist/service/TrustedExecutorService.js.map +1 -1
  203. package/dist/time/MonotonicClock.d.ts +4 -32
  204. package/dist/time/MonotonicClock.d.ts.map +1 -1
  205. package/dist/time/MonotonicClock.js +4 -49
  206. package/dist/time/MonotonicClock.js.map +1 -1
  207. package/dist/verify/VerifyingProvider.d.ts +32 -6
  208. package/dist/verify/VerifyingProvider.d.ts.map +1 -1
  209. package/dist/verify/VerifyingProvider.js +16 -2
  210. package/dist/verify/VerifyingProvider.js.map +1 -1
  211. package/package.json +6 -5
@@ -18,6 +18,7 @@ const COLORS = {
18
18
  EXECUTION_FAILED: `${ESC}[35m`,
19
19
  EXECUTION_INDETERMINATE: `${ESC}[35m`,
20
20
  ERROR: `${ESC}[35m`,
21
+ REFUSED: `${ESC}[31m`,
21
22
  };
22
23
  /** The label a state prints under, spaced for reading. */
23
24
  export function stateLabel(state) {
@@ -39,6 +40,8 @@ export function executionLabel(execution) {
39
40
  return "FAILED";
40
41
  case "INDETERMINATE":
41
42
  return "INDETERMINATE";
43
+ case "WITHHELD":
44
+ return "WITHHELD (answer refused)";
42
45
  }
43
46
  }
44
47
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"GatewayReport.js","sourceRoot":"","sources":["../../src/gateway/GatewayReport.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"GatewayReport.js","sourceRoot":"","sources":["../../src/gateway/GatewayReport.ts"],"names":[],"mappings":"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"}
@@ -12,7 +12,7 @@ export interface InterceptedRequest {
12
12
  readonly remoteAddress: string | null;
13
13
  readonly encrypted: boolean;
14
14
  }
15
- /** The HTTP action's parameters: exactly what the authority evaluates and the handler forwards. */
15
+ /** The held HTTP request and operator policy selectors, bound together for the authority. */
16
16
  export interface HttpActionParameters extends JsonObject {
17
17
  method: ConsequentialMethod;
18
18
  path: string;
@@ -20,6 +20,18 @@ export interface HttpActionParameters extends JsonObject {
20
20
  [key: string]: string | string[];
21
21
  };
22
22
  body?: JsonValue;
23
+ policy_id?: string;
24
+ policy_version?: string;
25
+ }
26
+ /**
27
+ * A facts-only HTTP action's parameters: the profile operation and its path
28
+ * template, never the path, query or body the request carried. The handler
29
+ * forwards the held request, bound by the keyed digest in the context.
30
+ */
31
+ export interface HttpFactsParameters extends JsonObject {
32
+ method: ConsequentialMethod;
33
+ operation: string;
34
+ path_template: string;
23
35
  }
24
36
  /** What the intent's context carries about the body: its digest, size and kind, never its bytes. */
25
37
  export interface HttpActionContext extends JsonObject {
@@ -44,6 +56,14 @@ export declare function bodyDigest(body: Uint8Array): `sha256:${string}`;
44
56
  * precedes the bytes; sorting header names makes object insertion order immaterial.
45
57
  */
46
58
  export declare function requestDigest(request: InterceptedRequest): `sha256:${string}`;
59
+ /**
60
+ * The same binding as `requestDigest`, keyed: an HMAC-SHA-256 under a key
61
+ * that never leaves the gateway process. Facts-only privacy sends this in
62
+ * place of the plain digests, which a reader holding a guess of a small body
63
+ * or a path could confirm; the keyed one confirms nothing to anyone without
64
+ * the key, and still binds the held request to the grant byte for byte.
65
+ */
66
+ export declare function keyedRequestDigest(request: InterceptedRequest, key: Uint8Array): `hmac-sha256:${string}`;
47
67
  /**
48
68
  * Turns an intercepted request into the agent's part of an intent. The
49
69
  * proposal is method, path, query and, when the body is JSON within the
@@ -52,9 +72,33 @@ export declare function requestDigest(request: InterceptedRequest): `sha256:${st
52
72
  * embedded, which is what the forwarding handler checks before dispatch.
53
73
  * Raw request headers never reach the authority. Their digest binds their
54
74
  * meaning along with the exact query and bytes for the final dispatch check.
75
+ * Policy selectors come only from the matched operator route, never from
76
+ * the caller's body, query or headers. They are bound before intent hashing
77
+ * and do not change the request forwarded to the upstream.
55
78
  */
56
79
  export declare function normalizeRequest(request: InterceptedRequest, action: string, options: {
57
80
  readonly maxEmbeddedBodyBytes: number;
58
81
  readonly principalHeader: string | null;
82
+ readonly policyId?: string;
83
+ readonly policyVersion?: string;
59
84
  }): NormalizedAction;
85
+ /**
86
+ * The agent's part of an intent in facts-only privacy: the profile operation
87
+ * that names the call, its path template, and nothing the request carried.
88
+ * The context binds the held request by its keyed digest. The client's
89
+ * idempotency key is a header value, so it is keyed too: a retry through the
90
+ * same gateway process states the same key, and the value never leaves. A
91
+ * correlation id and a principal header are not carried at all.
92
+ */
93
+ export declare function normalizeFacts(request: InterceptedRequest, action: string, operation: {
94
+ readonly id: string;
95
+ readonly path: string;
96
+ }, key: Uint8Array): NormalizedFacts;
97
+ export interface NormalizedFacts {
98
+ readonly proposal: AgentProposal;
99
+ readonly context: {
100
+ readonly request_hmac_sha256: string;
101
+ };
102
+ readonly idempotencyKey: string | null;
103
+ }
60
104
  //# sourceMappingURL=InterceptedRequest.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"InterceptedRequest.d.ts","sourceRoot":"","sources":["../../src/gateway/InterceptedRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,iGAAiG;AACjG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,mGAAmG;AACnG,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5C,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,oGAAoG;AACpG,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAcD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,MAAM,EAAE,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,MAAM,EAAE,CAY7E;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1F,gBAAgB,CA0ClB"}
1
+ {"version":3,"file":"InterceptedRequest.d.ts","sourceRoot":"","sources":["../../src/gateway/InterceptedRequest.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { createHash } from "node:crypto";
1
+ import { createHash, createHmac } from "node:crypto";
2
2
  const MAX_TARGET_LENGTH = 500;
3
3
  const MAX_IDEMPOTENCY_KEY_LENGTH = 180;
4
4
  const MAX_CORRELATION_LENGTH = 200;
@@ -32,6 +32,16 @@ export function requestDigest(request) {
32
32
  ]);
33
33
  return `sha256:${createHash("sha256").update(metadata, "utf8").update(request.body).digest("hex")}`;
34
34
  }
35
+ /**
36
+ * The same binding as `requestDigest`, keyed: an HMAC-SHA-256 under a key
37
+ * that never leaves the gateway process. Facts-only privacy sends this in
38
+ * place of the plain digests, which a reader holding a guess of a small body
39
+ * or a path could confirm; the keyed one confirms nothing to anyone without
40
+ * the key, and still binds the held request to the grant byte for byte.
41
+ */
42
+ export function keyedRequestDigest(request, key) {
43
+ return `hmac-sha256:${createHmac("sha256", key).update(requestDigest(request), "utf8").digest("hex")}`;
44
+ }
35
45
  /** Query pairs as an object: one value, or a list where a key repeats; keys sorted for stable hashing. */
36
46
  function queryObject(search) {
37
47
  const grouped = new Map();
@@ -66,6 +76,9 @@ function header(headers, name, maxLength) {
66
76
  * embedded, which is what the forwarding handler checks before dispatch.
67
77
  * Raw request headers never reach the authority. Their digest binds their
68
78
  * meaning along with the exact query and bytes for the final dispatch check.
79
+ * Policy selectors come only from the matched operator route, never from
80
+ * the caller's body, query or headers. They are bound before intent hashing
81
+ * and do not change the request forwarded to the upstream.
69
82
  */
70
83
  export function normalizeRequest(request, action, options) {
71
84
  const method = request.method.toUpperCase();
@@ -91,6 +104,8 @@ export function normalizeRequest(request, action, options) {
91
104
  path: request.path,
92
105
  query: queryObject(request.search),
93
106
  ...(body === undefined ? {} : { body }),
107
+ ...(options.policyId === undefined ? {} : { policy_id: options.policyId }),
108
+ ...(options.policyVersion === undefined ? {} : { policy_version: options.policyVersion }),
94
109
  };
95
110
  return {
96
111
  proposal: { action, target, parameters },
@@ -109,4 +124,31 @@ export function normalizeRequest(request, action, options) {
109
124
  : header(request.headers, options.principalHeader, MAX_PRINCIPAL_LENGTH),
110
125
  };
111
126
  }
127
+ /**
128
+ * The agent's part of an intent in facts-only privacy: the profile operation
129
+ * that names the call, its path template, and nothing the request carried.
130
+ * The context binds the held request by its keyed digest. The client's
131
+ * idempotency key is a header value, so it is keyed too: a retry through the
132
+ * same gateway process states the same key, and the value never leaves. A
133
+ * correlation id and a principal header are not carried at all.
134
+ */
135
+ export function normalizeFacts(request, action, operation, key) {
136
+ const method = request.method.toUpperCase();
137
+ const target = `${method} ${operation.path}`;
138
+ if (target.length > MAX_TARGET_LENGTH)
139
+ throw new Error("TARGET_TOO_LONG");
140
+ const parameters = {
141
+ method,
142
+ operation: operation.id,
143
+ path_template: operation.path,
144
+ };
145
+ const idempotency = header(request.headers, "idempotency-key", MAX_IDEMPOTENCY_KEY_LENGTH);
146
+ return {
147
+ proposal: { action, target, parameters },
148
+ context: { request_hmac_sha256: keyedRequestDigest(request, key) },
149
+ idempotencyKey: idempotency === null
150
+ ? null
151
+ : `hmac-sha256:${createHmac("sha256", key).update(idempotency, "utf8").digest("hex")}`,
152
+ };
153
+ }
112
154
  //# sourceMappingURL=InterceptedRequest.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"InterceptedRequest.js","sourceRoot":"","sources":["../../src/gateway/InterceptedRequest.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"InterceptedRequest.js","sourceRoot":"","sources":["../../src/gateway/InterceptedRequest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { z } from "zod";
2
+ /** Published bundle selectors understood by Decionis, shared by config and dispatch validation. */
3
+ export declare const PolicyIdSchema: z.ZodString;
4
+ export declare const PolicyVersionSchema: z.ZodString;
5
+ //# sourceMappingURL=PolicySelector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PolicySelector.d.ts","sourceRoot":"","sources":["../../src/gateway/PolicySelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mGAAmG;AACnG,eAAO,MAAM,cAAc,aAAoB,CAAC;AAChD,eAAO,MAAM,mBAAmB,aAIV,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { z } from "zod";
2
+ /** Published bundle selectors understood by Decionis, shared by config and dispatch validation. */
3
+ export const PolicyIdSchema = z.string().uuid();
4
+ export const PolicyVersionSchema = z
5
+ .string()
6
+ .min(1)
7
+ .max(100)
8
+ .regex(/^\P{Cc}+$/u);
9
+ //# sourceMappingURL=PolicySelector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PolicySelector.js","sourceRoot":"","sources":["../../src/gateway/PolicySelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,YAAY,CAAC,CAAC"}
@@ -1,31 +1,68 @@
1
- import { type ConsequentialMethod, type RouteConfig, type UnmatchedPolicy } from "./GatewayConfig.js";
1
+ import type { ApiProfile } from "@decionis/agent-safe-pipeline";
2
+ import { type ConsequentialMethod, type PrivacyMode, type RouteConfig, type UnmatchedPolicy } from "./GatewayConfig.js";
3
+ /**
4
+ * What the gateway does with a read. `PASSTHROUGH` is today's: never
5
+ * evaluated. `CHECK` checks a read a profile operation names against the
6
+ * session's subject and passes the rest. `REFUSE_UNKNOWN` also refuses a
7
+ * read no profile operation names.
8
+ */
9
+ export type ReadPolicy = "PASSTHROUGH" | "CHECK" | "REFUSE_UNKNOWN";
2
10
  /** What the gateway decided about one request before reading its body. */
3
11
  export type RoutePlan = {
4
12
  readonly kind: "PASSTHROUGH";
5
13
  readonly reason: "SAFE_METHOD" | "UNMATCHED" | "DISABLED";
6
14
  } | {
7
15
  readonly kind: "REFUSE";
8
- readonly code: "HTTP_METHOD_UNSUPPORTED" | "HTTP_PATH_AMBIGUOUS";
16
+ readonly code: "HTTP_METHOD_UNSUPPORTED" | "HTTP_PATH_AMBIGUOUS" | "PROFILE_OPERATION_UNMATCHED" | "READ_OPERATION_UNMATCHED";
17
+ } | {
18
+ /** A read a profile operation names: checked against the session's subject, never decided. */
19
+ readonly kind: "CHECK";
20
+ readonly action: string;
21
+ readonly operation: string;
9
22
  } | {
10
23
  readonly kind: "GOVERN";
11
24
  readonly action: string;
12
25
  readonly route: RouteConfig | null;
26
+ /** The API profile operation that named the action, when a profile did. */
27
+ readonly operation?: string;
28
+ };
29
+ /** A request's query, as the gateway reads it for planning: each name to one value or a list. */
30
+ export type PlanQuery = {
31
+ readonly [key: string]: string | readonly string[];
13
32
  };
14
33
  /** The derived action for an unsafe request no route names. */
15
34
  export declare function derivedAction(method: ConsequentialMethod): string;
16
35
  /**
17
36
  * The route table: which requests are consequential, and what each is
18
- * called. A safe method is never consequential. An unsafe request the table
19
- * does not name is governed under a derived name unless the configuration
20
- * chose passthrough, so narrowing what is governed is an explicit act.
37
+ * called. A safe method is never consequential. An explicit route is tried
38
+ * first, then the API profile's operations, when the gateway governs by one
39
+ * (`agent-safe.profile.api/1`). An unsafe request neither names is governed
40
+ * under a derived name unless the configuration chose passthrough, so
41
+ * narrowing what is governed is an explicit act. In facts-only privacy the
42
+ * profile alone names a call: what it does not name is refused, because
43
+ * governing it would send the authority its raw path.
21
44
  */
22
45
  export declare class RouteTable {
23
46
  private readonly unmatched;
24
47
  private readonly enabled;
48
+ private readonly profile;
49
+ private readonly privacy;
50
+ private readonly reads;
25
51
  private readonly routes;
26
- constructor(routes: readonly RouteConfig[], unmatched: UnmatchedPolicy, enabled?: boolean);
52
+ constructor(routes: readonly RouteConfig[], unmatched: UnmatchedPolicy, enabled?: boolean, profile?: ApiProfile | null, privacy?: PrivacyMode, reads?: ReadPolicy);
27
53
  /** Every action name this table can produce, for the registry to be sealed over. */
28
54
  actions(): readonly string[];
29
- plan(method: string, pathname: string): RoutePlan;
55
+ /**
56
+ * A read, when reads are checked. A `GET` a profile operation names is
57
+ * checked. One that only resembles an operation (another letter case, an
58
+ * encoded literal) is refused as ambiguous, since the upstream may serve
59
+ * it as that operation. A path beneath a checked read (`/$count`, a
60
+ * navigation, a media stream) answers what the read's subject rule does
61
+ * not check, and a `HEAD` or `OPTIONS` on a checked read's path has no
62
+ * answer to check while its status says whether a record exists: both are
63
+ * refused. Anything else passes, or is refused when unknown reads are.
64
+ */
65
+ private planRead;
66
+ plan(method: string, pathname: string, query?: PlanQuery): RoutePlan;
30
67
  }
31
68
  //# sourceMappingURL=RouteTable.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"RouteTable.d.ts","sourceRoot":"","sources":["../../src/gateway/RouteTable.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,GAAG,qBAAqB,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAC;AA0D7F,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAEjE;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAGhD,MAAM,EAAE,SAAS,WAAW,EAAE,EACb,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,OAAc;IAW1C,oFAAoF;IAC7E,OAAO,IAAI,SAAS,MAAM,EAAE;IAM5B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS;CAsBzD"}
1
+ {"version":3,"file":"RouteTable.d.ts","sourceRoot":"","sources":["../../src/gateway/RouteTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;CAAE,GAC3F;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EACT,yBAAyB,GACzB,qBAAqB,GACrB,6BAA6B,GAC7B,0BAA0B,CAAC;CAChC,GACD;IACE,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AA0D/E,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAEjE;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAGhD,MAAM,EAAE,SAAS,WAAW,EAAE,EACb,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,OAAc,EACvB,OAAO,GAAE,UAAU,GAAG,IAAW,EACjC,OAAO,GAAE,WAAoB,EAC7B,KAAK,GAAE,UAA0B;IAWpD,oFAAoF;IAC7E,OAAO,IAAI,SAAS,MAAM,EAAE;IAOnC;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ;IAoBT,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc,GAAG,SAAS;CA8BhF"}
@@ -53,17 +53,27 @@ export function derivedAction(method) {
53
53
  }
54
54
  /**
55
55
  * The route table: which requests are consequential, and what each is
56
- * called. A safe method is never consequential. An unsafe request the table
57
- * does not name is governed under a derived name unless the configuration
58
- * chose passthrough, so narrowing what is governed is an explicit act.
56
+ * called. A safe method is never consequential. An explicit route is tried
57
+ * first, then the API profile's operations, when the gateway governs by one
58
+ * (`agent-safe.profile.api/1`). An unsafe request neither names is governed
59
+ * under a derived name unless the configuration chose passthrough, so
60
+ * narrowing what is governed is an explicit act. In facts-only privacy the
61
+ * profile alone names a call: what it does not name is refused, because
62
+ * governing it would send the authority its raw path.
59
63
  */
60
64
  export class RouteTable {
61
65
  unmatched;
62
66
  enabled;
67
+ profile;
68
+ privacy;
69
+ reads;
63
70
  routes;
64
- constructor(routes, unmatched, enabled = true) {
71
+ constructor(routes, unmatched, enabled = true, profile = null, privacy = "FULL", reads = "PASSTHROUGH") {
65
72
  this.unmatched = unmatched;
66
73
  this.enabled = enabled;
74
+ this.profile = profile;
75
+ this.privacy = privacy;
76
+ this.reads = reads;
67
77
  this.routes = routes.map((config) => {
68
78
  const segments = routingSegments(config.path);
69
79
  // Pattern syntax is literal configuration. Encoded wildcards must not
@@ -78,15 +88,44 @@ export class RouteTable {
78
88
  const names = new Set(CONSEQUENTIAL_METHODS.map((method) => derivedAction(method)));
79
89
  for (const route of this.routes)
80
90
  names.add(route.config.action);
91
+ for (const action of this.profile?.actions() ?? [])
92
+ names.add(action);
81
93
  return [...names];
82
94
  }
83
- plan(method, pathname) {
95
+ /**
96
+ * A read, when reads are checked. A `GET` a profile operation names is
97
+ * checked. One that only resembles an operation (another letter case, an
98
+ * encoded literal) is refused as ambiguous, since the upstream may serve
99
+ * it as that operation. A path beneath a checked read (`/$count`, a
100
+ * navigation, a media stream) answers what the read's subject rule does
101
+ * not check, and a `HEAD` or `OPTIONS` on a checked read's path has no
102
+ * answer to check while its status says whether a record exists: both are
103
+ * refused. Anything else passes, or is refused when unknown reads are.
104
+ */
105
+ planRead(method, pathname, query) {
106
+ if (this.reads === "PASSTHROUGH" || this.profile === null) {
107
+ return { kind: "PASSTHROUGH", reason: "SAFE_METHOD" };
108
+ }
109
+ const operation = method === "GET" ? this.profile.operationFor("GET", pathname, query) : null;
110
+ if (operation !== null) {
111
+ return { kind: "CHECK", action: operation.action, operation: operation.id };
112
+ }
113
+ const resembles = this.profile.resembles("GET", pathname);
114
+ if (this.reads === "REFUSE_UNKNOWN" ||
115
+ (resembles && method !== "GET") ||
116
+ this.profile.beneath("GET", pathname)) {
117
+ return { kind: "REFUSE", code: "READ_OPERATION_UNMATCHED" };
118
+ }
119
+ if (resembles)
120
+ return { kind: "REFUSE", code: "HTTP_PATH_AMBIGUOUS" };
121
+ return { kind: "PASSTHROUGH", reason: "SAFE_METHOD" };
122
+ }
123
+ plan(method, pathname, query = {}) {
84
124
  if (!this.enabled)
85
125
  return { kind: "PASSTHROUGH", reason: "DISABLED" };
86
126
  const upper = method.toUpperCase();
87
- if (SAFE_METHODS.has(upper)) {
88
- return { kind: "PASSTHROUGH", reason: "SAFE_METHOD" };
89
- }
127
+ if (SAFE_METHODS.has(upper))
128
+ return this.planRead(upper, pathname, query);
90
129
  // WebDAV and extension methods can mutate state too. A method outside
91
130
  // this execution contract cannot inherit the privilege of a safe read.
92
131
  if (!CONSEQUENTIAL_METHODS.includes(upper)) {
@@ -96,11 +135,21 @@ export class RouteTable {
96
135
  const path = routingSegments(pathname);
97
136
  if (path === null)
98
137
  return { kind: "REFUSE", code: "HTTP_PATH_AMBIGUOUS" };
99
- for (const route of this.routes) {
138
+ const factsOnly = this.privacy === "FACTS";
139
+ for (const route of factsOnly ? [] : this.routes) {
100
140
  if (route.methods.has(consequential) && matches(route.segments, path)) {
101
141
  return { kind: "GOVERN", action: route.config.action, route: route.config };
102
142
  }
103
143
  }
144
+ const operation = this.profile?.operationFor(consequential, pathname, query) ?? null;
145
+ if (operation !== null) {
146
+ return { kind: "GOVERN", action: operation.action, route: null, operation: operation.id };
147
+ }
148
+ // Facts-only privacy would send the raw path; refusing unknown calls
149
+ // would relay an answer, a batch's included, that no subject rule checks.
150
+ if (factsOnly || this.reads === "REFUSE_UNKNOWN") {
151
+ return { kind: "REFUSE", code: "PROFILE_OPERATION_UNMATCHED" };
152
+ }
104
153
  if (this.unmatched === "PASSTHROUGH")
105
154
  return { kind: "PASSTHROUGH", reason: "UNMATCHED" };
106
155
  return { kind: "GOVERN", action: derivedAction(consequential), route: null };
@@ -1 +1 @@
1
- {"version":3,"file":"RouteTable.js","sourceRoot":"","sources":["../../src/gateway/RouteTable.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"RouteTable.js","sourceRoot":"","sources":["../../src/gateway/RouteTable.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ import { type WorkloadJwtVerifier } from "../identity/WorkloadJwtVerifier.js";
2
+ /** RFC 8693's grant type, and the token types a subject token may be stated as. */
3
+ export declare const TOKEN_EXCHANGE_GRANT = "urn:ietf:params:oauth:grant-type:token-exchange";
4
+ /** What the exchange issues: an opaque token for this gateway, never a bearer anywhere else. */
5
+ export declare const ISSUED_TOKEN_TYPE = "urn:ietf:params:oauth:token-type:access_token";
6
+ /** The most sessions held at once; beyond it a new one is refused rather than an old one dropped. */
7
+ export declare const MAX_SESSIONS = 10000;
8
+ /** How old a subject token may be: a short-lived token, minted for the conversation at hand. */
9
+ export declare const MAX_SUBJECT_TOKEN_AGE_SECONDS = 3600;
10
+ /** A subject the gateway has pinned: who, until when, and a short digest that names the session in evidence. */
11
+ export interface SubjectSession {
12
+ readonly subject: string;
13
+ readonly expiresAt: number;
14
+ /** `sha256:` and 12 hex characters of the token's digest; never the token. */
15
+ readonly id: string;
16
+ }
17
+ /** Why a request's session does not stand: the code a caller sees and the evidence records. */
18
+ export type SessionRefusal = "SUBJECT_SESSION_INVALID" | "SUBJECT_TOKEN_INVALID" | "SUBJECT_TOKEN_AMBIGUOUS";
19
+ /** A verified subject token: the subject it names and when it expires, in epoch milliseconds. */
20
+ export interface VerifiedSubject {
21
+ readonly subject: string;
22
+ readonly expiresAt: number;
23
+ }
24
+ /** Turns a subject token into the subject it names, or throws `JwtError`. */
25
+ export interface SubjectTokenVerifier {
26
+ verify(token: string): Promise<VerifiedSubject>;
27
+ }
28
+ /**
29
+ * The operator's identity provider: a signature from its key set, its issuer
30
+ * exactly, the gateway's audience, a token at most an hour old, and the
31
+ * subject in the configured claim, a string or a number of at most 200
32
+ * characters. Who the customer is, is the provider's statement; the gateway
33
+ * only pins it.
34
+ */
35
+ export declare class IssuerSubjectVerifier implements SubjectTokenVerifier {
36
+ private readonly jwt;
37
+ private readonly issuer;
38
+ private readonly claim;
39
+ constructor(jwt: WorkloadJwtVerifier, issuer: string, claim: string);
40
+ verify(token: string): Promise<VerifiedSubject>;
41
+ }
42
+ /** The token exchange's answer: RFC 8693 §2.2, or an RFC 6749 §5.2 error. */
43
+ export type ExchangeAnswer = {
44
+ readonly status: 200;
45
+ readonly body: {
46
+ readonly access_token: string;
47
+ readonly issued_token_type: typeof ISSUED_TOKEN_TYPE;
48
+ readonly token_type: "N_A";
49
+ readonly expires_in: number;
50
+ };
51
+ /** The session, for the evidence line; its token is in the body only. */
52
+ readonly session: SubjectSession;
53
+ } | {
54
+ readonly status: 400 | 503;
55
+ readonly body: {
56
+ readonly error: string;
57
+ readonly error_description: string;
58
+ };
59
+ };
60
+ /**
61
+ * Subject-bound sessions. The app that starts an agent (a contact centre, a
62
+ * CRM, a customer's own portal) holds a short-lived token from its identity
63
+ * provider naming the customer in context. It gives the gateway that token,
64
+ * and the gateway pins the subject for the session:
65
+ *
66
+ * - by RFC 8693 token exchange: `POST /_agentsafe/v1/sessions` returns an
67
+ * opaque session token, which the agent presents in `AgentSafe-Session`;
68
+ * the gateway keeps only the token's digest, beside the subject;
69
+ * - or per request, the provider's token itself in `AgentSafe-Subject-Token`.
70
+ *
71
+ * Either way the subject comes from the provider's signature and nothing the
72
+ * agent sends can change it: the session token maps to a subject held here,
73
+ * and the provider's token is verified on every request. Both headers end at
74
+ * the gateway. A session lasts as long as this gateway process: it is held in
75
+ * memory, so behind several replicas present the provider's token per
76
+ * request, or keep a caller on one replica.
77
+ */
78
+ export declare class SubjectSessions {
79
+ private readonly verifier;
80
+ private readonly options;
81
+ private readonly sessions;
82
+ /**
83
+ * The session each subject token was last exchanged for, by the token's
84
+ * digest: exchanging a token again replaces its session rather than add
85
+ * one, so one token cannot fill the gateway's sessions.
86
+ */
87
+ private readonly byToken;
88
+ constructor(verifier: SubjectTokenVerifier, options: {
89
+ readonly ttlSeconds: number;
90
+ readonly clock: () => number;
91
+ readonly maxSessions?: number;
92
+ });
93
+ /** The sessions held now, expired ones dropped first. */
94
+ get size(): number;
95
+ /**
96
+ * RFC 8693 token exchange: a subject token in, a session token out. The
97
+ * request is the form the RFC defines; an actor token (delegation) is not
98
+ * accepted, and the only token issued is this gateway's session token. A
99
+ * token that does not verify is `invalid_request`, as the RFC says, with
100
+ * the stable code as its description and nothing from the token.
101
+ */
102
+ exchange(form: URLSearchParams): Promise<ExchangeAnswer>;
103
+ /**
104
+ * The session a request presents: null when it presents none, the session
105
+ * when it stands, and the refusal otherwise. A request may present one of
106
+ * the two headers, never both, since two would be two answers to whose
107
+ * session it is.
108
+ */
109
+ resolve(headers: Readonly<Record<string, string>>): Promise<SubjectSession | SessionRefusal | null>;
110
+ private expire;
111
+ private static digest;
112
+ }
113
+ //# sourceMappingURL=SubjectSessions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SubjectSessions.d.ts","sourceRoot":"","sources":["../../src/gateway/SubjectSessions.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGxF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,oDAAoD,CAAC;AAMtF,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,kDAAkD,CAAC;AACjF,qGAAqG;AACrG,eAAO,MAAM,YAAY,QAAS,CAAC;AAGnC,gGAAgG;AAChG,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,gHAAgH;AAChH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,MAAM,MAAM,cAAc,GACxB,yBAAyB,GAAG,uBAAuB,GAAG,yBAAyB,CAAC;AAElF,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjD;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAE9D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM;IAGnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAe7D;AAED,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;QACrD,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E,CAAC;AAEN;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAUxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAGlC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B;IAGH,yDAAyD;IACzD,IAAW,IAAI,IAAI,MAAM,CAGxB;IAED;;;;;;OAMG;IACU,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmErE;;;;;OAKG;IACU,OAAO,CAClB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,OAAO,CAAC,cAAc,GAAG,cAAc,GAAG,IAAI,CAAC;IA8BlD,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,MAAM,CAAC,MAAM;CAGtB"}