regent-httpsig 0.5.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

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.
@@ -9,28 +9,30 @@ from regent_httpsig.budget import (
9
9
  InMemoryMeter,
10
10
  InsufficientBudget,
11
11
  InvalidBudgetClaim,
12
+ TokenRevoked,
12
13
  UnitMismatch,
13
14
  )
14
15
  from regent_httpsig.config import HttpsigConfig
15
16
  from regent_httpsig.jwk import b64url, jwk_thumbprint, load_ed25519_jwk
16
17
  from regent_httpsig.netguard import NotPublicURL, assert_public_url
18
+ from regent_httpsig.sfv import (
19
+ build_aauth_budget_header,
20
+ build_aauth_requirement,
21
+ parse_signature_agent,
22
+ )
23
+ from regent_httpsig.sign import DIRECTORY_MEDIA_TYPE, EgressSigner, generate_seed
17
24
  from regent_httpsig.usage import (
18
25
  ResponseSigner,
19
26
  UsageQueryError,
20
27
  build_usage_response,
28
+ make_revocation_endpoint,
21
29
  make_usage_endpoint,
22
30
  parse_usage_request,
23
31
  validate_budget_grant,
24
32
  )
25
- from regent_httpsig.sfv import (
26
- build_aauth_budget_header,
27
- build_aauth_requirement,
28
- parse_signature_agent,
29
- )
30
- from regent_httpsig.sign import DIRECTORY_MEDIA_TYPE, EgressSigner, generate_seed
31
33
  from regent_httpsig.verify import WBA_TAG, HttpsigVerifier, VerifiedSignature
32
34
 
33
- __version__ = "0.3.0"
35
+ __version__ = "0.6.0"
34
36
 
35
37
  __all__ = [
36
38
  "DIRECTORY_MEDIA_TYPE",
@@ -40,6 +42,7 @@ __all__ = [
40
42
  "HttpsigVerifier",
41
43
  "InMemoryMeter",
42
44
  "InsufficientBudget",
45
+ "TokenRevoked",
43
46
  "InvalidBudgetClaim",
44
47
  "NotPublicURL",
45
48
  "UnitMismatch",
@@ -51,6 +54,7 @@ __all__ = [
51
54
  "ResponseSigner",
52
55
  "UsageQueryError",
53
56
  "build_usage_response",
57
+ "make_revocation_endpoint",
54
58
  "make_usage_endpoint",
55
59
  "parse_usage_request",
56
60
  "validate_budget_grant",
regent_httpsig/budget.py CHANGED
@@ -33,8 +33,8 @@ import asyncio
33
33
  import itertools
34
34
  import time
35
35
  from collections.abc import Mapping
36
- from datetime import UTC, datetime, timedelta
37
36
  from dataclasses import dataclass, field
37
+ from datetime import UTC, datetime, timedelta
38
38
  from typing import Any
39
39
 
40
40
  __all__ = [
@@ -43,6 +43,7 @@ __all__ = [
43
43
  "InsufficientBudget",
44
44
  "InvalidBudgetClaim",
45
45
  "Reservation",
46
+ "TokenRevoked",
46
47
  "UnitMismatch",
47
48
  ]
48
49
 
@@ -112,6 +113,17 @@ class InsufficientBudget:
112
113
  exhausted: bool
113
114
 
114
115
 
116
+ @dataclass(frozen=True)
117
+ class TokenRevoked:
118
+ """Refusal: the presented token was revoked (base protocol §Token
119
+ Revocation, budgets §Token Scope). The budget ended with the token — no
120
+ new spend — while requests already in flight complete. ``drained`` says
121
+ whether those have all settled: only then may the resource state the
122
+ token's consumption record, which is then FINAL (AAuth issue #151)."""
123
+
124
+ drained: bool
125
+
126
+
115
127
  @dataclass
116
128
  class _Pool:
117
129
  unit: str
@@ -120,6 +132,7 @@ class _Pool:
120
132
  consumed: dict[str, int] = field(default_factory=dict) # jti -> total committed
121
133
  jkt_of: dict[str, str] = field(default_factory=dict) # jti -> presenting key thumbprint
122
134
  reservations: dict[int, tuple[str, int, float]] = field(default_factory=dict)
135
+ revoked: dict[str, float] = field(default_factory=dict) # jti -> wall time of revocation
123
136
  last_activity: float = 0.0
124
137
 
125
138
 
@@ -178,6 +191,7 @@ class InMemoryMeter:
178
191
  retention_seconds: float = 7200.0,
179
192
  usage_key_retention: float = 86400.0) -> None:
180
193
  self._pools: dict[MeterKey, _Pool] = {}
194
+ self._jti_index: dict[tuple[str, str], MeterKey] = {} # (iss, jti) -> ledger key
181
195
  self._lock = asyncio.Lock()
182
196
  self._rids = itertools.count(1)
183
197
  self._reservation_ttl = reservation_ttl
@@ -190,7 +204,8 @@ class InMemoryMeter:
190
204
  # request" — so a key in continuous use is never pruned.
191
205
  self._usage_key_retention = usage_key_retention
192
206
  self._scope_usage: dict[tuple[str, str], _ScopeCounters] = {} # (iss, sub)
193
- self._key_usage: dict[tuple[str, str], tuple[int, float]] = {} # (iss, jkt) -> (total, last_wall)
207
+ # (iss, jkt) -> (total, last_wall)
208
+ self._key_usage: dict[tuple[str, str], tuple[int, float]] = {}
194
209
  self._metering_unit: tuple[str, int] | None = None
195
210
 
196
211
  # ── internals (call under lock) ──────────────────────────────────────────
@@ -213,9 +228,16 @@ class InMemoryMeter:
213
228
  if (not pool.grants and not pool.reservations
214
229
  and now - pool.last_activity > self._retention):
215
230
  del self._pools[key]
231
+ for pair in [p for p, k in self._jti_index.items() if k == key]:
232
+ del self._jti_index[pair]
216
233
  return None
217
234
  return pool
218
235
 
236
+ @staticmethod
237
+ def _drained(pool: _Pool, jti: str) -> bool:
238
+ """No request is in flight on this token any more."""
239
+ return not any(j == jti for j, _, _ in pool.reservations.values())
240
+
219
241
  @staticmethod
220
242
  def _remaining(pool: _Pool, jti: str) -> int:
221
243
  """The presented token's balance: its grant minus what was committed
@@ -251,14 +273,17 @@ class InMemoryMeter:
251
273
  pool.last_activity = now
252
274
  if jkt:
253
275
  pool.jkt_of.setdefault(jti, jkt)
254
- if jti not in pool.grants and wall_delta > 0:
276
+ self._jti_index.setdefault((key[0], jti), key)
277
+ if jti not in pool.grants and wall_delta > 0 and jti not in pool.revoked:
255
278
  pool.grants[jti] = (claim.amount, now + wall_delta)
256
279
 
257
280
  async def reserve(self, key: MeterKey, jti: str,
258
- max_cost: int) -> Reservation | InsufficientBudget:
281
+ max_cost: int) -> Reservation | InsufficientBudget | TokenRevoked:
259
282
  async with self._lock:
260
283
  now = time.monotonic()
261
284
  pool = self._purge(key, now)
285
+ if pool is not None and jti in pool.revoked:
286
+ return TokenRevoked(drained=self._drained(pool, jti))
262
287
  if pool is None or jti not in pool.grants:
263
288
  return InsufficientBudget(remaining=0, exhausted=True)
264
289
  remaining = self._remaining(pool, jti)
@@ -301,6 +326,33 @@ class InMemoryMeter:
301
326
  pool = self._purge(key, time.monotonic())
302
327
  return 0 if pool is None else self._remaining(pool, jti)
303
328
 
329
+ async def revoke(self, iss: str, jti: str) -> bool:
330
+ """Revoke an auth token by ``(iss, jti)`` — the base protocol's
331
+ revocation identifier. The grant is withdrawn so no new request can
332
+ reserve against it; requests already in flight complete and are
333
+ committed as usual. ``False`` when the pair is unknown here (the
334
+ endpoint answers 404). Idempotent."""
335
+ async with self._lock:
336
+ key = self._jti_index.get((iss, jti))
337
+ if key is None:
338
+ return False
339
+ pool = self._purge(key, time.monotonic())
340
+ if pool is None:
341
+ return False
342
+ pool.revoked.setdefault(jti, time.time())
343
+ pool.grants.pop(jti, None)
344
+ pool.last_activity = time.monotonic()
345
+ return True
346
+
347
+ async def revocation_state(self, key: MeterKey, jti: str) -> TokenRevoked | None:
348
+ """``TokenRevoked`` (with its drain state) if the token was revoked
349
+ here, else ``None``."""
350
+ async with self._lock:
351
+ pool = self._purge(key, time.monotonic())
352
+ if pool is None or jti not in pool.revoked:
353
+ return None
354
+ return TokenRevoked(drained=self._drained(pool, jti))
355
+
304
356
  def _record_usage(self, key: MeterKey, pool: _Pool, jti: str,
305
357
  amount: int) -> None:
306
358
  """Post a committed cost to the usage counters (call under lock).
@@ -351,6 +403,10 @@ class InMemoryMeter:
351
403
  pool = self._purge(key, time.monotonic())
352
404
  if pool is None:
353
405
  return None
406
+ if jti in pool.revoked and not self._drained(pool, jti):
407
+ # §Token Scope + AAuth #151: a revoked token's record is FINAL,
408
+ # so it is stated only once nothing is in flight on it.
409
+ return None
354
410
  total = pool.consumed.get(jti, 0)
355
411
  return {"jti": jti, "consumed": total} if total > 0 else None
356
412
 
regent_httpsig/fastapi.py CHANGED
@@ -41,6 +41,7 @@ from regent_httpsig.budget import (
41
41
  InvalidBudgetClaim,
42
42
  MeterKey,
43
43
  Reservation,
44
+ TokenRevoked,
44
45
  UnitMismatch,
45
46
  )
46
47
  from regent_httpsig.sfv import build_aauth_budget_header, build_aauth_requirement
@@ -191,6 +192,13 @@ class BudgetMiddleware(BaseHTTPMiddleware):
191
192
  return await call_next(request)
192
193
 
193
194
  sig = await self._verified(request)
195
+ if sig is not None and sig.expired:
196
+ # §Budget Exhaustion, "auth token expired": the base protocol's plain
197
+ # 401 — and the resource token we attach carries the presented
198
+ # token's FINAL consumption record (stated at/after its exp), which
199
+ # is what lets its issuer settle the allocation exactly. Without
200
+ # this challenge an issuer never sees a final figure at all.
201
+ return await self._expired_challenge(sig)
194
202
  envelope: BudgetClaim | None = None
195
203
  if sig is not None:
196
204
  try:
@@ -222,6 +230,11 @@ class BudgetMiddleware(BaseHTTPMiddleware):
222
230
  remaining=0, key=key)
223
231
 
224
232
  outcome = await self._meter.reserve(key, jti, int(max_cost))
233
+ if isinstance(outcome, TokenRevoked):
234
+ # §Token Scope: the budget ended with the token. The challenge is
235
+ # the base protocol's plain one; the resource token on it carries
236
+ # the token's FINAL record once nothing is in flight (AAuth #151).
237
+ return await self._revoked_challenge(key, jti, outcome.drained)
225
238
  if isinstance(outcome, InsufficientBudget):
226
239
  reason = "budget-exhausted" if outcome.exhausted else "insufficient-budget"
227
240
  return await self._refusal_with_token(
@@ -307,11 +320,63 @@ class BudgetMiddleware(BaseHTTPMiddleware):
307
320
  result = None
308
321
  if "signature" in request.headers:
309
322
  result = await self._verifier.verify(
310
- request.method, _public_url(request), dict(request.headers)
323
+ request.method, _public_url(request), dict(request.headers),
324
+ allow_expired_auth_token=True,
311
325
  )
312
- request.state.regent_httpsig_result = result
326
+ # An expired token is never handed to the app: the middleware answers
327
+ # it with the final-record challenge and nothing downstream runs. The
328
+ # per-request cache still must not carry it — a later dependency
329
+ # reading the cache would otherwise see a token that is not valid.
330
+ request.state.regent_httpsig_result = (
331
+ None if result is not None and result.expired else result)
313
332
  return result
314
333
 
334
+ async def _revoked_challenge(self, key: MeterKey, jti: str, drained: bool) -> Response:
335
+ token: str | None = None
336
+ if self._resource_token is not None:
337
+ try:
338
+ record = await self._meter.consumed_record(key, jti) if drained else None
339
+ token = await _maybe_await(self._resource_token(key, record))
340
+ except Exception: # noqa: BLE001 — the challenge must not fail on the extras
341
+ logger.warning("resource_token_provider failed", exc_info=True)
342
+ return JSONResponse(
343
+ status_code=401,
344
+ content={
345
+ "code": "AUTH_TOKEN_REVOKED",
346
+ "message": "This auth token was revoked by its issuer. Take the resource "
347
+ "token in AAuth-Requirement to your PS for a fresh one."
348
+ + ("" if drained else " Its final consumption record follows once "
349
+ "in-flight requests settle."),
350
+ },
351
+ headers={"AAuth-Requirement": build_aauth_requirement(
352
+ reason=None, resource_token=token)},
353
+ )
354
+
355
+ async def _expired_challenge(self, sig: VerifiedSignature) -> Response:
356
+ jti = str(sig.claims.get("jti") or "")
357
+ key: MeterKey = (
358
+ str(sig.claims.get("iss", "")),
359
+ str(sig.claims.get("sub", "")),
360
+ str(sig.claims.get("aud", "")),
361
+ )
362
+ token: str | None = None
363
+ if self._resource_token is not None and jti:
364
+ try:
365
+ record = await self._meter.consumed_record(key, jti)
366
+ token = await _maybe_await(self._resource_token(key, record))
367
+ except Exception: # noqa: BLE001 — the challenge must not fail on the extras
368
+ logger.warning("resource_token_provider failed", exc_info=True)
369
+ return JSONResponse(
370
+ status_code=401,
371
+ content={
372
+ "code": "AUTH_TOKEN_EXPIRED",
373
+ "message": "The auth token has expired. Take the resource token in "
374
+ "AAuth-Requirement to your PS for a fresh one.",
375
+ },
376
+ headers={"AAuth-Requirement": build_aauth_requirement(
377
+ reason=None, resource_token=token)},
378
+ )
379
+
315
380
  async def _refusal_with_token(
316
381
  self, *, reason: str, envelope: BudgetClaim,
317
382
  remaining: int, key: MeterKey, jti: str,
regent_httpsig/sfv.py CHANGED
@@ -176,13 +176,18 @@ def build_aauth_budget_header(
176
176
  return ", ".join(members)
177
177
 
178
178
 
179
- def build_aauth_requirement(*, reason: str, resource_token: str | None = None) -> str:
180
- """Serialize ``AAuth-Requirement`` for a budget refusal:
179
+ def build_aauth_requirement(*, reason: str | None,
180
+ resource_token: str | None = None) -> str:
181
+ """Serialize ``AAuth-Requirement`` for a budget challenge:
181
182
  ``requirement=auth-token;resource-token="eyJ…";reason=insufficient-budget``.
182
- ``reason`` is an sf-token (``insufficient-budget`` | ``budget-exhausted``);
183
- the resource token (when the resource issues one) rides as an sf-string."""
183
+ ``reason`` is an sf-token (``insufficient-budget`` | ``budget-exhausted``)
184
+ for an exhaustion refusal, or ``None`` for the base protocol's plain
185
+ challenge (an EXPIRED auth token — the budget did not run out, the token
186
+ did); the resource token (when the resource issues one) rides as an
187
+ sf-string."""
184
188
  out = "requirement=auth-token"
185
189
  if resource_token:
186
190
  out += f";resource-token={_sf_string(resource_token)}"
187
- out += f";reason={reason}"
191
+ if reason:
192
+ out += f";reason={reason}"
188
193
  return out
regent_httpsig/usage.py CHANGED
@@ -221,3 +221,51 @@ def validate_budget_grant(unit: str, decimals: int,
221
221
  f"(declared in budget_units), got {decimals}")
222
222
  return
223
223
  raise ValueError(f"unit {unit!r} is not declared in budget_units")
224
+
225
+
226
+ def make_revocation_endpoint(
227
+ meter: Any,
228
+ *,
229
+ authenticate_ps: Callable[[Any], Awaitable[str | None]],
230
+ ) -> Callable[[Any], Awaitable[Any]]:
231
+ """The base protocol's revocation endpoint (§Token Revocation) for the
232
+ budgets meter: a signed ``POST`` identifying an auth token by
233
+ ``{"iss", "jti"}`` — both REQUIRED, keyed together because a jti is unique
234
+ only within its issuer. ``200`` when the token was revoked or is already
235
+ invalid here, ``404`` when the pair is not recognized. The body is
236
+ deliberately empty on success: the response must not vary with what the
237
+ recipient holds.
238
+
239
+ ``authenticate_ps`` is the same pinned-PS check the usage endpoint uses.
240
+ The issuer named in the body must be the caller: a PS revokes tokens it
241
+ issued, never another issuer's. What revocation does to the meter is in
242
+ :meth:`InMemoryMeter.revoke` — no new spend, in-flight requests complete,
243
+ and the token's consumption record is withheld until they have (AAuth
244
+ issue #151: a record issued after the revocation is then final)."""
245
+ from starlette.responses import JSONResponse, Response
246
+
247
+ async def handler(request: Any) -> Response:
248
+ caller = await authenticate_ps(request)
249
+ if caller is None:
250
+ return JSONResponse(status_code=401, content={
251
+ "code": "PS_AUTH_REQUIRED",
252
+ "message": "Sign the revocation as the person server that issued the token.",
253
+ })
254
+ try:
255
+ payload = json.loads(await request.body() or b"{}")
256
+ iss, jti = payload.get("iss"), payload.get("jti")
257
+ if not isinstance(iss, str) or not isinstance(jti, str) or not iss or not jti:
258
+ raise ValueError("iss and jti are REQUIRED strings")
259
+ except (ValueError, json.JSONDecodeError) as exc:
260
+ return JSONResponse(status_code=400, content={
261
+ "code": "INVALID_REVOCATION", "message": str(exc)})
262
+ if iss.rstrip("/") != caller.rstrip("/"):
263
+ return JSONResponse(status_code=403, content={
264
+ "code": "NOT_YOUR_TOKEN",
265
+ "message": "A person server may revoke only tokens it issued."})
266
+ if not await meter.revoke(iss, jti):
267
+ return JSONResponse(status_code=404, content={
268
+ "code": "TOKEN_UNKNOWN", "message": "No such (iss, jti) here."})
269
+ return Response(status_code=200)
270
+
271
+ return handler
regent_httpsig/verify.py CHANGED
@@ -61,6 +61,10 @@ AAUTH_PERSON_TYP = "aa-person+jwt"
61
61
  AAUTH_AUTH_TYP = "aa-auth+jwt" # PS-issued auth tokens — the budget carrier
62
62
  # -11: person and auth tokens live at most one hour — enforced with tolerance.
63
63
  PERSON_TOKEN_MAX_LIFETIME = 3600 + 90
64
+ # How long after its exp an auth token still earns the budgets "final record"
65
+ # challenge (opt-in, BudgetMiddleware only): the meter retains consumption for
66
+ # about this long after last activity; beyond it there is no figure to carry.
67
+ EXPIRED_AUTH_TOKEN_GRACE = 7200
64
68
 
65
69
 
66
70
  def _register_fully_specified_algs() -> None:
@@ -86,6 +90,11 @@ class VerifiedSignature:
86
90
  sub: str | None = None # AAuth agent id (token `sub`)
87
91
  label: str = ""
88
92
  claims: dict[str, Any] = field(default_factory=dict) # AAuth token claims (redacted)
93
+ # Set only when ``verify(..., allow_expired_auth_token=True)`` accepted an
94
+ # auth token PAST its exp: genuine (issuer signature + proof of possession
95
+ # verified) but NOT valid for access. BudgetMiddleware uses it to answer
96
+ # with the final-record challenge; nothing else should ever see it True.
97
+ expired: bool = False
89
98
 
90
99
  def context(self) -> dict[str, Any]:
91
100
  """A flat dict suitable for logging / policy engines / audit trails."""
@@ -164,18 +173,28 @@ class HttpsigVerifier:
164
173
  self._cache: dict[str, tuple[float, dict[str, Any] | None]] = {}
165
174
 
166
175
  async def verify(
167
- self, method: str, url: str, headers: Mapping[str, str]
176
+ self, method: str, url: str, headers: Mapping[str, str],
177
+ *, allow_expired_auth_token: bool = False,
168
178
  ) -> VerifiedSignature | None:
169
179
  """Verify the request's agent signature. Returns ``None`` when there is
170
180
  no ``Signature`` header, the signature is invalid, or the signer's keys
171
- cannot be (safely) fetched — never raises on untrusted input."""
181
+ cannot be (safely) fetched — never raises on untrusted input.
182
+
183
+ ``allow_expired_auth_token`` (default False — leave it so for access
184
+ decisions) lets a genuine ``aa-auth+jwt`` past its ``exp`` come back
185
+ with ``expired=True`` instead of ``None``, for up to
186
+ :data:`EXPIRED_AUTH_TOKEN_GRACE` seconds. Budgets need this: the
187
+ resource owes the holder of an expired token a challenge carrying that
188
+ token's final consumption record (draft §Budget Exhaustion), and it
189
+ cannot build one for a token it refused to look at."""
172
190
  hdrs = {str(k): str(v) for k, v in headers.items()}
173
191
  if not any(k.lower() == "signature" for k in hdrs):
174
192
  return None
175
193
  result: VerifiedSignature | None = None
176
194
  try:
177
195
  if any(k.lower() == "signature-key" for k in hdrs):
178
- result = await self._verify_aauth(method, url, hdrs)
196
+ result = await self._verify_aauth(
197
+ method, url, hdrs, allow_expired_auth_token=allow_expired_auth_token)
179
198
  if result is None:
180
199
  result = await self._verify_web_bot_auth(method, url, hdrs)
181
200
  except Exception as exc: # noqa: BLE001 — belt and braces
@@ -288,7 +307,8 @@ class HttpsigVerifier:
288
307
  # ── AAuth (identity-based mode) ──────────────────────────────────────────
289
308
 
290
309
  async def _verify_aauth(
291
- self, method: str, url: str, headers: dict[str, str]
310
+ self, method: str, url: str, headers: dict[str, str],
311
+ *, allow_expired_auth_token: bool = False,
292
312
  ) -> VerifiedSignature | None:
293
313
  try:
294
314
  import jwt as pyjwt # the [aauth] extra
@@ -387,6 +407,7 @@ class HttpsigVerifier:
387
407
  continue
388
408
  if issuer_key is None:
389
409
  return None
410
+ tolerate_exp = allow_expired_auth_token and typ == AAUTH_AUTH_TYP
390
411
  try:
391
412
  claims = pyjwt.decode(
392
413
  token,
@@ -396,11 +417,20 @@ class HttpsigVerifier:
396
417
  options={
397
418
  "require": ["iss", "sub", "exp", "iat"],
398
419
  "verify_aud": audience is not None,
420
+ "verify_exp": not tolerate_exp,
399
421
  },
400
422
  )
401
423
  except Exception as exc: # noqa: BLE001
402
424
  logger.info("aauth token invalid iss=%s: %s", iss, str(exc)[:200])
403
425
  return None
426
+ expired = False
427
+ if tolerate_exp:
428
+ overdue = int(time.time()) - int(claims.get("exp", 0))
429
+ expired = overdue >= 0
430
+ if overdue > EXPIRED_AUTH_TOKEN_GRACE:
431
+ logger.info("aauth auth token expired %ss ago — past grace iss=%s",
432
+ overdue, iss)
433
+ return None
404
434
 
405
435
  # -11: person and auth tokens live at most one hour.
406
436
  if typ in (AAUTH_PERSON_TYP, AAUTH_AUTH_TYP):
@@ -456,4 +486,5 @@ class HttpsigVerifier:
456
486
  "budget") # budgets: the envelope rides in the token
457
487
  if k in claims
458
488
  },
489
+ expired=expired,
459
490
  )
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: regent-httpsig
3
- Version: 0.5.0
3
+ Version: 0.6.0
4
4
  Summary: Verify and sign AI agent HTTP traffic in Python — RFC 9421 HTTP Message Signatures: Web Bot Auth (what OpenAI ships) and AAuth.
5
5
  Project-URL: Homepage, https://github.com/regent-protocol/regent-httpsig
6
6
  Project-URL: Repository, https://github.com/regent-protocol/regent-httpsig
@@ -174,6 +174,14 @@ production on [get4agent.com](https://get4agent.com).
174
174
 
175
175
  - `insufficient-budget` refusals carry **`required`** — the refused request's
176
176
  maximum cost — so the agent lowers its bound and retries instead of guessing.
177
+ - **Revocation**: `make_revocation_endpoint(meter, authenticate_ps=…)` is the
178
+ base protocol's endpoint; a revoked token stops spending at once, in-flight
179
+ requests complete, and its final record rides on the next challenge.
180
+ - An **expired** auth token gets the base protocol's plain challenge with a
181
+ resource token carrying that token's **final** consumption record — the
182
+ figure its issuer needs to settle the allocation (a record stated at or
183
+ after `exp` is final; one on a live token is a snapshot and releases
184
+ nothing).
177
185
  - **Streaming** responses run in the draft's cost-omitted mode: `reserved` in
178
186
  the header, commit when the stream ends (set `request.state.budget_cost`
179
187
  mid-stream if you learn the actual), and the agent recovers the exact cost
@@ -0,0 +1,16 @@
1
+ regent_httpsig/__init__.py,sha256=VDo7Yj7LvJ8newfCUpSFZbcncfLFAazMPbyw7MaQQsQ,1809
2
+ regent_httpsig/budget.py,sha256=5yPRdai8ZTLp4lV-cn8y5kbsTtqE06XUhvT3JjJD_Ys,19667
3
+ regent_httpsig/cli.py,sha256=WUSLQ2WuEX4E85L2C2EgoUfu5cWpj6MRSG1UVNHpzcw,2005
4
+ regent_httpsig/config.py,sha256=_xAIFYAyNbXzKg-famXLAs7eNdYwuvNA7NHQxcno0G4,2439
5
+ regent_httpsig/fastapi.py,sha256=-JKatY8RCVJm5el5zyPjnhwLbWYYje5iHQO9HpRmLqg,19220
6
+ regent_httpsig/jwk.py,sha256=h4vgnIgpnyKeWdWpm7g_hEyXZOPVREWn-bD4JN07tT0,1637
7
+ regent_httpsig/netguard.py,sha256=Sqg08mdC94RWvnQLJaH4weZW0nN2VlTJF5wVF8VYGHY,2121
8
+ regent_httpsig/sfv.py,sha256=-nUUjyqyAMOSGro9Z0AIXiuchqsIAVaJWbKuIIO4fB0,7624
9
+ regent_httpsig/sign.py,sha256=B5ChxFxuuKL0i10bGrgFImzyh8GMjWIqNDECXehBWTA,4397
10
+ regent_httpsig/usage.py,sha256=094CwFHZVDIwmDf8WDg1p4nYlVCBkpi2DrZXdFbFzEo,11889
11
+ regent_httpsig/verify.py,sha256=p9VtHZz9HWHIstDBxNvVrc_xJdubbRA_pN9DjQQDzpk,21716
12
+ regent_httpsig-0.6.0.dist-info/METADATA,sha256=LBGeQCM6nfJ3f0hcQRTDjQKB2Our30hMhPMmwqCVZXQ,12725
13
+ regent_httpsig-0.6.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
14
+ regent_httpsig-0.6.0.dist-info/entry_points.txt,sha256=SgZdmc27V14IAmwOjbBoCYLsbrALaqdTUHNHLbil2dU,59
15
+ regent_httpsig-0.6.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
16
+ regent_httpsig-0.6.0.dist-info/RECORD,,
@@ -1,16 +0,0 @@
1
- regent_httpsig/__init__.py,sha256=Ch-PdsMDo_uKG4U5A4xklU3jbCWdJTWXHG86n5VA7dc,1709
2
- regent_httpsig/budget.py,sha256=sjNJiFyfqLHEdnbh8e4bmqZr2gPveYynZ5eXUYpES_k,16967
3
- regent_httpsig/cli.py,sha256=WUSLQ2WuEX4E85L2C2EgoUfu5cWpj6MRSG1UVNHpzcw,2005
4
- regent_httpsig/config.py,sha256=_xAIFYAyNbXzKg-famXLAs7eNdYwuvNA7NHQxcno0G4,2439
5
- regent_httpsig/fastapi.py,sha256=IijwDjnDKntRzavFzj2o6HM3XqvCHi2VZOv_xL_MLTA,15660
6
- regent_httpsig/jwk.py,sha256=h4vgnIgpnyKeWdWpm7g_hEyXZOPVREWn-bD4JN07tT0,1637
7
- regent_httpsig/netguard.py,sha256=Sqg08mdC94RWvnQLJaH4weZW0nN2VlTJF5wVF8VYGHY,2121
8
- regent_httpsig/sfv.py,sha256=O8eK3Xyw-lewSepLJQcBKfPZAIBZCYatw4zDNDsxxYo,7407
9
- regent_httpsig/sign.py,sha256=B5ChxFxuuKL0i10bGrgFImzyh8GMjWIqNDECXehBWTA,4397
10
- regent_httpsig/usage.py,sha256=PSIPXCtUZyh5cjn4SzwOgrXuJrwDIWu-kffJ-4NFeS0,9453
11
- regent_httpsig/verify.py,sha256=8z-x3trF5B8P8D1aDYoqzF4R5h8BVv91CKiubFKFIiI,19915
12
- regent_httpsig-0.5.0.dist-info/METADATA,sha256=9_2zaZrS2LBdENWDPnYVWrJhtIh9vgbG_7e7J5f3X_s,12187
13
- regent_httpsig-0.5.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
14
- regent_httpsig-0.5.0.dist-info/entry_points.txt,sha256=SgZdmc27V14IAmwOjbBoCYLsbrALaqdTUHNHLbil2dU,59
15
- regent_httpsig-0.5.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
16
- regent_httpsig-0.5.0.dist-info/RECORD,,