@datalayer/agent-runtimes 1.5.95 → 1.5.97

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 (96) hide show
  1. package/dist-embed/chunks/{index.esm-zOy6kFPv.js → index.esm-BLDeC6q1.js} +1 -1
  2. package/dist-embed/datalayer-app-main.js +80 -80
  3. package/lib/apps/apps/appspec.d.ts +11 -12
  4. package/lib/apps/apps/appspec.js +45 -87
  5. package/lib/components/cards/ToolApprovalCard.js +4 -2
  6. package/lib/components/inspector/a2aSpans.d.ts +7 -0
  7. package/lib/components/inspector/a2aSpans.js +34 -2
  8. package/lib/components/inspector/agentSpans.d.ts +1 -1
  9. package/lib/components/inspector/agentSpans.js +1 -0
  10. package/lib/components/teams/HarnessIcon.d.ts +11 -0
  11. package/lib/components/teams/HarnessIcon.js +17 -0
  12. package/lib/components/teams/SceneTranscript.d.ts +1 -1
  13. package/lib/components/teams/SceneTranscript.js +12 -7
  14. package/lib/components/teams/SceneView.d.ts +7 -1
  15. package/lib/components/teams/SceneView.js +2 -2
  16. package/lib/components/teams/backdrops/hero.js +1 -1
  17. package/lib/components/teams/backdrops/minimal.js +1 -1
  18. package/lib/components/teams/backdrops/nodes.js +4 -3
  19. package/lib/components/teams/backdrops/space.js +1 -1
  20. package/lib/components/teams/backdrops/types.d.ts +9 -0
  21. package/lib/components/teams/index.d.ts +2 -0
  22. package/lib/components/teams/index.js +2 -0
  23. package/lib/components/teams/memberHarness.d.ts +16 -0
  24. package/lib/components/teams/memberHarness.js +42 -0
  25. package/lib/components/teams/sceneTranscriptRules.js +6 -1
  26. package/lib/components/teams/transcript/LineSelect.d.ts +20 -0
  27. package/lib/components/teams/transcript/LineSelect.js +20 -0
  28. package/lib/components/teams/transcript/TranscriptTable.d.ts +11 -5
  29. package/lib/components/teams/transcript/TranscriptTable.js +24 -7
  30. package/lib/components/teams/transcript/TranscriptViews.js +1 -1
  31. package/lib/components/teams/transcript/recordingPlayback.d.ts +13 -0
  32. package/lib/components/teams/transcript/recordingPlayback.js +32 -0
  33. package/lib/components/teams/transcript/useSceneRecording.d.ts +1 -1
  34. package/lib/components/teams/transcript/useSceneRecording.js +19 -11
  35. package/lib/examples/PapAccountTokensExample.d.ts +1 -1
  36. package/lib/examples/PapAccountTokensExample.js +3 -3
  37. package/lib/examples/PapSessionJwtExample.d.ts +4 -0
  38. package/lib/examples/{PapDpopProofExample.js → PapSessionJwtExample.js} +9 -9
  39. package/lib/examples/PapSessionLifecycleExample.d.ts +1 -1
  40. package/lib/examples/PapSessionLifecycleExample.js +2 -2
  41. package/lib/examples/ScenesExample.js +15 -13
  42. package/lib/examples/example-selector.js +3 -3
  43. package/lib/examples/index.d.ts +1 -1
  44. package/lib/examples/index.js +1 -1
  45. package/lib/examples/main.js +1 -1
  46. package/lib/examples/pap/PapAccountTokensView.d.ts +1 -1
  47. package/lib/examples/pap/PapAuthorizationBoundaryView.js +15 -22
  48. package/lib/examples/pap/PapGuidedJourneyView.js +61 -60
  49. package/lib/examples/pap/PapSessionJwtView.d.ts +4 -0
  50. package/lib/examples/pap/PapSessionJwtView.js +69 -0
  51. package/lib/examples/pap/PapSessionLifecycleView.js +36 -58
  52. package/lib/examples/pap/PapSignInDisplayView.d.ts +1 -1
  53. package/lib/examples/pap/PapSignInDisplayView.js +1 -1
  54. package/lib/examples/pap/PapTraceView.d.ts +1 -1
  55. package/lib/examples/pap/PapTraceView.js +1 -1
  56. package/lib/examples/pap/traces/account-tokens.json +145 -173
  57. package/lib/examples/pap/traces/conversation-control.json +118 -140
  58. package/lib/examples/pap/traces/conversation-streaming.json +114 -134
  59. package/lib/examples/pap/traces/mediated-sign-in.json +151 -166
  60. package/lib/examples/pap/traces/operations.json +613 -391
  61. package/lib/examples/pap/traces/two-companies.json +380 -990
  62. package/lib/examples/pap/traces/user-with-a-company.json +319 -207
  63. package/lib/models/environments.generated.d.ts +2 -2
  64. package/lib/models/environments.generated.js +1 -1
  65. package/lib/pap/index.d.ts +1 -1
  66. package/lib/pap/index.js +3 -3
  67. package/lib/portable/displays.d.ts +13 -22
  68. package/lib/portable/displays.js +17 -65
  69. package/lib/portable/hosts/approvalRenderers.d.ts +4 -4
  70. package/lib/portable/hosts/approvalRenderers.js +26 -13
  71. package/lib/portable/hosts/contracts.json +5 -2
  72. package/lib/portable/index.d.ts +1 -1
  73. package/lib/portable/index.js +1 -1
  74. package/lib/protocols/decks/index.d.ts +37 -0
  75. package/lib/protocols/decks/index.js +48 -0
  76. package/lib/protocols/decks/pact-a-personal-agent-at-a-business.d.ts +2 -0
  77. package/lib/protocols/decks/pact-a-personal-agent-at-a-business.js +148 -0
  78. package/lib/protocols/decks/ucp-a-purchase-approved.d.ts +2 -0
  79. package/lib/protocols/decks/ucp-a-purchase-approved.js +154 -0
  80. package/lib/specs/actions.d.ts +1 -1
  81. package/lib/specs/actions.js +2 -2
  82. package/lib/specs/agents/agents.js +3 -3
  83. package/lib/specs/apps.d.ts +1 -1
  84. package/lib/specs/apps.js +10 -11
  85. package/lib/specs/appspecSchema.js +4 -112
  86. package/lib/specs/envvars.js +2 -2
  87. package/lib/specs/harnesses.js +9 -9
  88. package/lib/specs/scenes.js +10 -33
  89. package/lib/specs/teams/teams.js +2 -2
  90. package/lib/types/agentspecs.d.ts +91 -127
  91. package/package.json +409 -409
  92. package/scripts/codegen/generate_apps.py +6 -7
  93. package/scripts/validate_pap_examples.py +1 -1
  94. package/lib/examples/PapDpopProofExample.d.ts +0 -4
  95. package/lib/examples/pap/PapDpopProofView.d.ts +0 -4
  96. package/lib/examples/pap/PapDpopProofView.js +0 -61
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "slug": "two-companies",
3
3
  "title": "Two companies working together",
4
- "description": "Ledgerly, an accounting firm, is a PAP company to Ada's agent Atlas and a PAP personal agent at Northwind Bank for her. Every approval is an Operation. This is composition: draft 0.3 defines no company-to-company protocol.",
4
+ "description": "Ledgerly, an accounting firm, is a PAP company to Ada's agent Atlas and a PAP personal agent at Northwind Bank for her. Every approval is Ada's. This is composition: draft 0.3 defines no company-to-company protocol.",
5
5
  "generator": "examples/personal-agent-protocol/traces/generate.py",
6
- "sdk": "personal-agent-protocol 0.27.0",
6
+ "sdk": "personal-agent-protocol 0.28.0",
7
7
  "parties": [
8
8
  {
9
9
  "id": "user",
@@ -37,7 +37,7 @@
37
37
  {
38
38
  "title": "Atlas finds Ledgerly",
39
39
  "channel": "Discovery + Session",
40
- "summary": "To Atlas, Ledgerly is an ordinary PAP company: Atlas reads its poppy.json and opens a signed-out, pairwise Session. Ledgerly verifies Atlas's keys.",
40
+ "summary": "To Atlas, Ledgerly is an ordinary PAP company: Atlas reads its protected resource metadata and poppy.json, and starts a signed-out, pairwise Session under a random sid, which sends no request.",
41
41
  "chat": [
42
42
  {
43
43
  "speaker": "user",
@@ -58,7 +58,7 @@
58
58
  },
59
59
  {
60
60
  "label": "Session",
61
- "value": "signed out · DPoP-bound"
61
+ "value": "signed out · a Session JWT on every request"
62
62
  },
63
63
  {
64
64
  "label": "Vault (host only)",
@@ -72,17 +72,12 @@
72
72
  "ledgerly": [
73
73
  {
74
74
  "label": "Verified client",
75
- "value": "atlas.example/agent.json",
75
+ "value": "None yet",
76
76
  "group": "As a company to Atlas"
77
77
  },
78
78
  {
79
79
  "label": "Sessions",
80
- "value": "1 live · 0 signed in",
81
- "group": "As a company to Atlas"
82
- },
83
- {
84
- "label": "Who is it?",
85
- "value": "A pairwise identifier only",
80
+ "value": "None",
86
81
  "group": "As a company to Atlas"
87
82
  },
88
83
  {
@@ -155,8 +150,7 @@
155
150
  },
156
151
  "extensions": {
157
152
  "operations": {
158
- "version": "1",
159
- "endpoint": "https://ledgerly.example/poppy/operations"
153
+ "version": "2"
160
154
  }
161
155
  }
162
156
  }
@@ -167,7 +161,7 @@
167
161
  "from": "atlas",
168
162
  "to": "ledgerly",
169
163
  "method": "GET",
170
- "url": "https://ledgerly.example/.well-known/oauth-authorization-server",
164
+ "url": "https://ledgerly.example/.well-known/oauth-protected-resource",
171
165
  "status": 200,
172
166
  "request": {
173
167
  "headers": {
@@ -179,21 +173,10 @@
179
173
  "content-type": "application/json"
180
174
  },
181
175
  "body": {
182
- "issuer": "https://ledgerly.example",
183
- "token_endpoint": "https://ledgerly.example/oauth/token",
184
- "revocation_endpoint": "https://ledgerly.example/oauth/revoke",
185
- "grant_types_supported": [
186
- "urn:ietf:params:oauth:grant-type:jwt-bearer",
187
- "refresh_token",
188
- "authorization_code",
189
- "urn:ietf:params:oauth:grant-type:device_code"
190
- ],
176
+ "resource": "https://ledgerly.example",
177
+ "authorization_servers": ["https://ledgerly.example"],
191
178
  "scopes_supported": ["books:read", "payments:write"],
192
- "protected_resources": ["https://ledgerly.example"],
193
- "dpop_signing_alg_values_supported": ["ES256", "RS256"],
194
- "authorization_endpoint": "https://ledgerly.example/oauth/authorize",
195
- "code_challenge_methods_supported": ["S256"],
196
- "device_1": "https://ledgerly.example/oauth/device"
179
+ "bearer_methods_supported": ["header"]
197
180
  }
198
181
  }
199
182
  },
@@ -201,72 +184,8 @@
201
184
  "kind": "http",
202
185
  "from": "atlas",
203
186
  "to": "ledgerly",
204
- "method": "POST",
205
- "url": "https://ledgerly.example/oauth/token",
206
- "status": 200,
207
- "request": {
208
- "headers": {
209
- "content-type": "application/x-www-form-urlencoded",
210
- "accept": "application/json",
211
- "dpop": "‹DPoP proof›"
212
- },
213
- "body": {
214
- "grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
215
- "assertion": "‹session assertion›",
216
- "client_id": "https://atlas.example/agent.json",
217
- "client_assertion_type": "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
218
- "client_assertion": "‹client assertion›"
219
- },
220
- "encoding": "form"
221
- },
222
- "response": {
223
- "headers": {
224
- "content-type": "application/json",
225
- "cache-control": "no-store"
226
- },
227
- "body": {
228
- "access_token": "‹session token›",
229
- "token_type": "DPoP",
230
- "expires_in": 3600
231
- }
232
- }
233
- },
234
- {
235
- "kind": "http",
236
- "from": "ledgerly",
237
- "to": "atlas",
238
- "method": "GET",
239
- "url": "https://atlas.example/agent.json",
240
- "status": 200,
241
- "request": {
242
- "headers": {
243
- "accept": "application/json"
244
- }
245
- },
246
- "response": {
247
- "headers": {
248
- "content-type": "application/json"
249
- },
250
- "body": {
251
- "client_id": "https://atlas.example/agent.json",
252
- "client_name": "Atlas",
253
- "jwks_uri": "https://atlas.example/jwks.json",
254
- "redirect_uris": ["https://atlas.example/oauth/callback"],
255
- "token_endpoint_auth_method": "private_key_jwt",
256
- "extensions": {
257
- "operations": {
258
- "version": "1"
259
- }
260
- }
261
- }
262
- }
263
- },
264
- {
265
- "kind": "http",
266
- "from": "ledgerly",
267
- "to": "atlas",
268
187
  "method": "GET",
269
- "url": "https://atlas.example/jwks.json",
188
+ "url": "https://ledgerly.example/.well-known/oauth-authorization-server",
270
189
  "status": 200,
271
190
  "request": {
272
191
  "headers": {
@@ -278,17 +197,19 @@
278
197
  "content-type": "application/json"
279
198
  },
280
199
  "body": {
281
- "keys": [
282
- {
283
- "kty": "EC",
284
- "crv": "P-256",
285
- "x": "‹public key›",
286
- "y": "‹public key›",
287
- "kid": "key-1",
288
- "use": "sig",
289
- "alg": "ES256"
290
- }
291
- ]
200
+ "issuer": "https://ledgerly.example",
201
+ "token_endpoint": "https://ledgerly.example/oauth/token",
202
+ "revocation_endpoint": "https://ledgerly.example/oauth/revoke",
203
+ "grant_types_supported": [
204
+ "refresh_token",
205
+ "authorization_code",
206
+ "urn:ietf:params:oauth:grant-type:device_code"
207
+ ],
208
+ "scopes_supported": ["books:read", "payments:write"],
209
+ "protected_resources": ["https://ledgerly.example"],
210
+ "authorization_endpoint": "https://ledgerly.example/oauth/authorize",
211
+ "code_challenge_methods_supported": ["S256"],
212
+ "device_1": "https://ledgerly.example/oauth/device"
292
213
  }
293
214
  }
294
215
  }
@@ -297,7 +218,7 @@
297
218
  {
298
219
  "title": "Ada signs in to Ledgerly",
299
220
  "channel": "Device Sign-In",
300
- "summary": "Ada approves Atlas on Ledgerly's own page. Atlas's Session at Ledgerly is signed in.",
221
+ "summary": "Ada approves Atlas on Ledgerly's own page. Atlas's Session at Ledgerly now sends her access token.",
301
222
  "chat": [
302
223
  {
303
224
  "speaker": "atlas",
@@ -319,7 +240,7 @@
319
240
  },
320
241
  {
321
242
  "label": "Session",
322
- "value": "signed in · DPoP-bound"
243
+ "value": "signed in · a Session JWT on every request"
323
244
  },
324
245
  {
325
246
  "label": "Scopes",
@@ -327,7 +248,7 @@
327
248
  },
328
249
  {
329
250
  "label": "Vault (host only)",
330
- "value": "1 Account Token by reference"
251
+ "value": "1 refresh token by reference"
331
252
  },
332
253
  {
333
254
  "label": "Model sees",
@@ -342,11 +263,11 @@
342
263
  },
343
264
  {
344
265
  "label": "Sessions",
345
- "value": "1 live · 1 signed in",
266
+ "value": "None",
346
267
  "group": "As a company to Atlas"
347
268
  },
348
269
  {
349
- "label": "Account behind the Session",
270
+ "label": "Account behind the access token",
350
271
  "value": "acct_ada_ledgerly",
351
272
  "group": "As a company to Atlas"
352
273
  },
@@ -356,7 +277,7 @@
356
277
  "group": "As a company to Atlas"
357
278
  },
358
279
  {
359
- "label": "Account Tokens issued",
280
+ "label": "Refresh tokens issued",
360
281
  "value": "1 · 1 not revoked",
361
282
  "group": "As a company to Atlas"
362
283
  },
@@ -413,6 +334,67 @@
413
334
  }
414
335
  }
415
336
  },
337
+ {
338
+ "kind": "http",
339
+ "from": "ledgerly",
340
+ "to": "atlas",
341
+ "method": "GET",
342
+ "url": "https://atlas.example/agent.json",
343
+ "status": 200,
344
+ "request": {
345
+ "headers": {
346
+ "accept": "application/json"
347
+ }
348
+ },
349
+ "response": {
350
+ "headers": {
351
+ "content-type": "application/json"
352
+ },
353
+ "body": {
354
+ "client_id": "https://atlas.example/agent.json",
355
+ "client_name": "Atlas",
356
+ "jwks_uri": "https://atlas.example/jwks.json",
357
+ "redirect_uris": ["https://atlas.example/oauth/callback"],
358
+ "token_endpoint_auth_method": "private_key_jwt",
359
+ "extensions": {
360
+ "operations": {
361
+ "version": "2"
362
+ }
363
+ }
364
+ }
365
+ }
366
+ },
367
+ {
368
+ "kind": "http",
369
+ "from": "ledgerly",
370
+ "to": "atlas",
371
+ "method": "GET",
372
+ "url": "https://atlas.example/jwks.json",
373
+ "status": 200,
374
+ "request": {
375
+ "headers": {
376
+ "accept": "application/json"
377
+ }
378
+ },
379
+ "response": {
380
+ "headers": {
381
+ "content-type": "application/json"
382
+ },
383
+ "body": {
384
+ "keys": [
385
+ {
386
+ "kty": "EC",
387
+ "crv": "P-256",
388
+ "x": "‹public key›",
389
+ "y": "‹public key›",
390
+ "kid": "key-1",
391
+ "use": "sig",
392
+ "alg": "ES256"
393
+ }
394
+ ]
395
+ }
396
+ }
397
+ },
416
398
  {
417
399
  "kind": "action",
418
400
  "from": "user",
@@ -429,8 +411,7 @@
429
411
  "request": {
430
412
  "headers": {
431
413
  "content-type": "application/x-www-form-urlencoded",
432
- "accept": "application/json",
433
- "dpop": "‹DPoP proof›"
414
+ "accept": "application/json"
434
415
  },
435
416
  "body": {
436
417
  "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
@@ -447,11 +428,10 @@
447
428
  "cache-control": "no-store"
448
429
  },
449
430
  "body": {
450
- "access_token": "‹session token›",
451
- "token_type": "DPoP",
431
+ "access_token": "‹access token›",
432
+ "token_type": "Bearer",
452
433
  "expires_in": 3600,
453
- "refresh_token": "‹account token›",
454
- "refresh_token_expires_in": 7776000
434
+ "refresh_token": "‹refresh token›"
455
435
  }
456
436
  }
457
437
  }
@@ -460,7 +440,7 @@
460
440
  {
461
441
  "title": "Ledgerly becomes a personal agent",
462
442
  "channel": "Ledgerly → Northwind",
463
- "summary": "To pay, Ledgerly needs Ada's Northwind account. It acts as a PAP personal agent with its own client_id and keys: it discovers Northwind, opens its own pairwise Session, and starts Device Sign-In there. Northwind verifies Ledgerly, not Atlas.",
443
+ "summary": "To pay, Ledgerly needs Ada's Northwind account. It acts as a PAP personal agent with its own client_id and keys: it discovers Northwind, starts its own pairwise Session, and starts Device Sign-In there. Northwind verifies Ledgerly, not Atlas.",
464
444
  "chat": [
465
445
  {
466
446
  "speaker": "user",
@@ -481,7 +461,7 @@
481
461
  },
482
462
  {
483
463
  "label": "Session",
484
- "value": "signed in · DPoP-bound"
464
+ "value": "signed in · a Session JWT on every request"
485
465
  },
486
466
  {
487
467
  "label": "Scopes",
@@ -489,7 +469,7 @@
489
469
  },
490
470
  {
491
471
  "label": "Vault (host only)",
492
- "value": "1 Account Token by reference"
472
+ "value": "1 refresh token by reference"
493
473
  },
494
474
  {
495
475
  "label": "Model sees",
@@ -504,11 +484,11 @@
504
484
  },
505
485
  {
506
486
  "label": "Sessions",
507
- "value": "1 live · 1 signed in",
487
+ "value": "1 live",
508
488
  "group": "As a company to Atlas"
509
489
  },
510
490
  {
511
- "label": "Account behind the Session",
491
+ "label": "Account behind the access token",
512
492
  "value": "acct_ada_ledgerly",
513
493
  "group": "As a company to Atlas"
514
494
  },
@@ -518,7 +498,7 @@
518
498
  "group": "As a company to Atlas"
519
499
  },
520
500
  {
521
- "label": "Account Tokens issued",
501
+ "label": "Refresh tokens issued",
522
502
  "value": "1 · 1 not revoked",
523
503
  "group": "As a company to Atlas"
524
504
  },
@@ -529,11 +509,11 @@
529
509
  },
530
510
  {
531
511
  "label": "Northwind Session",
532
- "value": "signed out · DPoP-bound",
512
+ "value": "signed out · a Session JWT on every request",
533
513
  "group": "As Ada's personal agent at Northwind"
534
514
  },
535
515
  {
536
- "label": "Northwind Account Token",
516
+ "label": "Northwind refresh token",
537
517
  "value": "Waiting for Ada on Northwind's page",
538
518
  "group": "As Ada's personal agent at Northwind"
539
519
  }
@@ -545,11 +525,7 @@
545
525
  },
546
526
  {
547
527
  "label": "Sessions",
548
- "value": "1 live · 0 signed in"
549
- },
550
- {
551
- "label": "Who is it?",
552
- "value": "A pairwise identifier only"
528
+ "value": "None"
553
529
  }
554
530
  ]
555
531
  },
@@ -565,8 +541,8 @@
565
541
  "headers": {
566
542
  "content-type": "application/json",
567
543
  "accept": "*/*",
568
- "authorization": "DPoP ‹session token›",
569
- "dpop": "‹DPoP proof›"
544
+ "authorization": "Bearer ‹access token›",
545
+ "poppy-session": "‹Session JWT›"
570
546
  },
571
547
  "body": {
572
548
  "message": {
@@ -695,13 +671,52 @@
695
671
  },
696
672
  "extensions": {
697
673
  "operations": {
674
+ "version": "2"
675
+ },
676
+ "mediated-sign-in": {
698
677
  "version": "1",
699
- "endpoint": "https://northwind.example/poppy/operations"
678
+ "fields": [
679
+ {
680
+ "name": "account_number",
681
+ "label": "Account number",
682
+ "secret": false
683
+ },
684
+ {
685
+ "name": "pin",
686
+ "label": "PIN",
687
+ "secret": true
688
+ }
689
+ ],
690
+ "scopes": ["accounts:read"]
700
691
  }
701
692
  }
702
693
  }
703
694
  }
704
695
  },
696
+ {
697
+ "kind": "http",
698
+ "from": "ledgerly",
699
+ "to": "northwind",
700
+ "method": "GET",
701
+ "url": "https://northwind.example/.well-known/oauth-protected-resource",
702
+ "status": 200,
703
+ "request": {
704
+ "headers": {
705
+ "accept": "application/json"
706
+ }
707
+ },
708
+ "response": {
709
+ "headers": {
710
+ "content-type": "application/json"
711
+ },
712
+ "body": {
713
+ "resource": "https://northwind.example",
714
+ "authorization_servers": ["https://northwind.example"],
715
+ "scopes_supported": ["accounts:read", "payments:write"],
716
+ "bearer_methods_supported": ["header"]
717
+ }
718
+ }
719
+ },
705
720
  {
706
721
  "kind": "http",
707
722
  "from": "ledgerly",
@@ -723,14 +738,13 @@
723
738
  "token_endpoint": "https://northwind.example/oauth/token",
724
739
  "revocation_endpoint": "https://northwind.example/oauth/revoke",
725
740
  "grant_types_supported": [
726
- "urn:ietf:params:oauth:grant-type:jwt-bearer",
727
741
  "refresh_token",
728
742
  "authorization_code",
729
- "urn:ietf:params:oauth:grant-type:device_code"
743
+ "urn:ietf:params:oauth:grant-type:device_code",
744
+ "https://personalagentprotocol.org/grant/mediated-sign-in"
730
745
  ],
731
746
  "scopes_supported": ["accounts:read", "payments:write"],
732
747
  "protected_resources": ["https://northwind.example"],
733
- "dpop_signing_alg_values_supported": ["ES256", "RS256"],
734
748
  "authorization_endpoint": "https://northwind.example/oauth/authorize",
735
749
  "code_challenge_methods_supported": ["S256"],
736
750
  "device_1": "https://northwind.example/oauth/device"
@@ -742,17 +756,15 @@
742
756
  "from": "ledgerly",
743
757
  "to": "northwind",
744
758
  "method": "POST",
745
- "url": "https://northwind.example/oauth/token",
759
+ "url": "https://northwind.example/oauth/device",
746
760
  "status": 200,
747
761
  "request": {
748
762
  "headers": {
749
763
  "content-type": "application/x-www-form-urlencoded",
750
- "accept": "application/json",
751
- "dpop": "‹DPoP proof›"
764
+ "accept": "application/json"
752
765
  },
753
766
  "body": {
754
- "grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
755
- "assertion": "‹session assertion›",
767
+ "scope": "accounts:read payments:write",
756
768
  "client_id": "https://ledgerly.example/poppy/agent.json",
757
769
  "client_assertion_type": "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
758
770
  "client_assertion": "‹client assertion›"
@@ -765,9 +777,12 @@
765
777
  "cache-control": "no-store"
766
778
  },
767
779
  "body": {
768
- "access_token": "‹session token›",
769
- "token_type": "DPoP",
770
- "expires_in": 3600
780
+ "device_code": "‹device code›",
781
+ "user_code": "‹user code›",
782
+ "verification_uri": "https://northwind.example/device",
783
+ "verification_uri_complete": "https://northwind.example/device?user_code=‹Northwind user code›",
784
+ "expires_in": 600,
785
+ "interval": 5
771
786
  }
772
787
  }
773
788
  },
@@ -795,7 +810,7 @@
795
810
  "token_endpoint_auth_method": "private_key_jwt",
796
811
  "extensions": {
797
812
  "operations": {
798
- "version": "1"
813
+ "version": "2"
799
814
  }
800
815
  }
801
816
  }
@@ -831,41 +846,6 @@
831
846
  ]
832
847
  }
833
848
  }
834
- },
835
- {
836
- "kind": "http",
837
- "from": "ledgerly",
838
- "to": "northwind",
839
- "method": "POST",
840
- "url": "https://northwind.example/oauth/device",
841
- "status": 200,
842
- "request": {
843
- "headers": {
844
- "content-type": "application/x-www-form-urlencoded",
845
- "accept": "application/json"
846
- },
847
- "body": {
848
- "scope": "accounts:read payments:write",
849
- "client_id": "https://ledgerly.example/poppy/agent.json",
850
- "client_assertion_type": "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
851
- "client_assertion": "‹client assertion›"
852
- },
853
- "encoding": "form"
854
- },
855
- "response": {
856
- "headers": {
857
- "content-type": "application/json",
858
- "cache-control": "no-store"
859
- },
860
- "body": {
861
- "device_code": "‹device code›",
862
- "user_code": "‹user code›",
863
- "verification_uri": "https://northwind.example/device",
864
- "verification_uri_complete": "https://northwind.example/device?user_code=‹Northwind user code›",
865
- "expires_in": 600,
866
- "interval": 5
867
- }
868
- }
869
849
  }
870
850
  ]
871
851
  },
@@ -889,7 +869,7 @@
889
869
  },
890
870
  {
891
871
  "label": "Session",
892
- "value": "signed in · DPoP-bound"
872
+ "value": "signed in · a Session JWT on every request"
893
873
  },
894
874
  {
895
875
  "label": "Scopes",
@@ -897,7 +877,7 @@
897
877
  },
898
878
  {
899
879
  "label": "Vault (host only)",
900
- "value": "1 Account Token by reference"
880
+ "value": "1 refresh token by reference"
901
881
  },
902
882
  {
903
883
  "label": "Model sees",
@@ -912,11 +892,11 @@
912
892
  },
913
893
  {
914
894
  "label": "Sessions",
915
- "value": "1 live · 1 signed in",
895
+ "value": "1 live",
916
896
  "group": "As a company to Atlas"
917
897
  },
918
898
  {
919
- "label": "Account behind the Session",
899
+ "label": "Account behind the access token",
920
900
  "value": "acct_ada_ledgerly",
921
901
  "group": "As a company to Atlas"
922
902
  },
@@ -926,7 +906,7 @@
926
906
  "group": "As a company to Atlas"
927
907
  },
928
908
  {
929
- "label": "Account Tokens issued",
909
+ "label": "Refresh tokens issued",
930
910
  "value": "1 · 1 not revoked",
931
911
  "group": "As a company to Atlas"
932
912
  },
@@ -937,11 +917,11 @@
937
917
  },
938
918
  {
939
919
  "label": "Northwind Session",
940
- "value": "signed out · DPoP-bound",
920
+ "value": "signed out · a Session JWT on every request",
941
921
  "group": "As Ada's personal agent at Northwind"
942
922
  },
943
923
  {
944
- "label": "Northwind Account Token",
924
+ "label": "Northwind refresh token",
945
925
  "value": "Waiting for Ada on Northwind's page",
946
926
  "group": "As Ada's personal agent at Northwind"
947
927
  }
@@ -953,11 +933,7 @@
953
933
  },
954
934
  {
955
935
  "label": "Sessions",
956
- "value": "1 live · 0 signed in"
957
- },
958
- {
959
- "label": "Who is it?",
960
- "value": "A pairwise identifier only"
936
+ "value": "None"
961
937
  }
962
938
  ]
963
939
  },
@@ -971,9 +947,9 @@
971
947
  ]
972
948
  },
973
949
  {
974
- "title": "Northwind proposes; Ledgerly relays",
950
+ "title": "Northwind returns the payment; Ledgerly relays it",
975
951
  "channel": "Operation relayed",
976
- "summary": "Ledgerly finishes signing in at Northwind and asks Northwind's agent to pay. Northwind proposes payments.transfer. No standing permission covers it, so Ledgerly relays it to Ada as its own operation, quoting Northwind's summary as written.",
952
+ "summary": "Ledgerly finishes signing in at Northwind and asks Northwind's agent to pay. Northwind returns payments.transfer as an operation. Ledgerly cannot approve it for Ada, so it relays it to her as its own operation, quoting Northwind's summary as written.",
977
953
  "chat": [
978
954
  {
979
955
  "speaker": "user",
@@ -983,12 +959,12 @@
983
959
  {
984
960
  "speaker": "ledgerly",
985
961
  "kind": "message",
986
- "text": "Northwind Bank proposes this payment; it needs your approval."
962
+ "text": "Northwind Bank asks approval for this payment."
987
963
  },
988
964
  {
989
965
  "speaker": "ledgerly",
990
966
  "kind": "approval",
991
- "title": "Revision 1 · needs your approval",
967
+ "title": "Revision rev_1 · needs your approval",
992
968
  "text": "At Northwind Bank: Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent."
993
969
  }
994
970
  ],
@@ -1000,7 +976,7 @@
1000
976
  },
1001
977
  {
1002
978
  "label": "Session",
1003
- "value": "signed in · DPoP-bound"
979
+ "value": "signed in · a Session JWT on every request"
1004
980
  },
1005
981
  {
1006
982
  "label": "Scopes",
@@ -1008,7 +984,7 @@
1008
984
  },
1009
985
  {
1010
986
  "label": "Vault (host only)",
1011
- "value": "1 Account Token by reference"
987
+ "value": "1 refresh token by reference"
1012
988
  },
1013
989
  {
1014
990
  "label": "Model sees",
@@ -1023,11 +999,11 @@
1023
999
  },
1024
1000
  {
1025
1001
  "label": "Sessions",
1026
- "value": "1 live · 1 signed in",
1002
+ "value": "1 live",
1027
1003
  "group": "As a company to Atlas"
1028
1004
  },
1029
1005
  {
1030
- "label": "Account behind the Session",
1006
+ "label": "Account behind the access token",
1031
1007
  "value": "acct_ada_ledgerly",
1032
1008
  "group": "As a company to Atlas"
1033
1009
  },
@@ -1037,7 +1013,7 @@
1037
1013
  "group": "As a company to Atlas"
1038
1014
  },
1039
1015
  {
1040
- "label": "Account Tokens issued",
1016
+ "label": "Refresh tokens issued",
1041
1017
  "value": "1 · 1 not revoked",
1042
1018
  "group": "As a company to Atlas"
1043
1019
  },
@@ -1048,16 +1024,16 @@
1048
1024
  },
1049
1025
  {
1050
1026
  "label": "Operation northwind.payment",
1051
- "value": "revision 1 · proposed",
1027
+ "value": "revision rev_1 · open",
1052
1028
  "group": "As a company to Atlas"
1053
1029
  },
1054
1030
  {
1055
1031
  "label": "Northwind Session",
1056
- "value": "signed in · DPoP-bound",
1032
+ "value": "signed in · a Session JWT on every request",
1057
1033
  "group": "As Ada's personal agent at Northwind"
1058
1034
  },
1059
1035
  {
1060
- "label": "Northwind Account Token",
1036
+ "label": "Northwind refresh token",
1061
1037
  "value": "in Ledgerly's vault, by reference",
1062
1038
  "group": "As Ada's personal agent at Northwind"
1063
1039
  }
@@ -1069,10 +1045,10 @@
1069
1045
  },
1070
1046
  {
1071
1047
  "label": "Sessions",
1072
- "value": "1 live · 1 signed in"
1048
+ "value": "1 live"
1073
1049
  },
1074
1050
  {
1075
- "label": "Account behind the Session",
1051
+ "label": "Account behind the access token",
1076
1052
  "value": "acct_ada_northwind"
1077
1053
  },
1078
1054
  {
@@ -1080,7 +1056,7 @@
1080
1056
  "value": "accounts:read payments:write"
1081
1057
  },
1082
1058
  {
1083
- "label": "Account Tokens issued",
1059
+ "label": "Refresh tokens issued",
1084
1060
  "value": "1 · 1 not revoked"
1085
1061
  },
1086
1062
  {
@@ -1089,7 +1065,7 @@
1089
1065
  },
1090
1066
  {
1091
1067
  "label": "Operation payments.transfer",
1092
- "value": "revision 1 · proposed"
1068
+ "value": "revision rev_2 · open"
1093
1069
  }
1094
1070
  ]
1095
1071
  },
@@ -1105,8 +1081,8 @@
1105
1081
  "headers": {
1106
1082
  "content-type": "application/json",
1107
1083
  "accept": "*/*",
1108
- "authorization": "DPoP ‹session token›",
1109
- "dpop": "‹DPoP proof›"
1084
+ "authorization": "Bearer ‹access token›",
1085
+ "poppy-session": "‹Session JWT›"
1110
1086
  },
1111
1087
  "body": {
1112
1088
  "message": {
@@ -1155,15 +1131,14 @@
1155
1131
  "type": "agent"
1156
1132
  },
1157
1133
  "role": "company",
1158
- "text": "Northwind Bank proposes this payment; it needs your approval.",
1134
+ "text": "Northwind Bank asks approval for this payment.",
1159
1135
  "operation": {
1160
1136
  "operation_id": "op_1",
1161
- "revision": 1,
1162
- "state": "proposed",
1137
+ "revision": "rev_1",
1163
1138
  "summary": "At Northwind Bank: Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1164
1139
  "terms": {
1165
1140
  "northwind_operation_id": "op_2",
1166
- "northwind_revision": 1,
1141
+ "northwind_revision": "rev_2",
1167
1142
  "amount": {
1168
1143
  "amount": "1250.00",
1169
1144
  "currency": "EUR"
@@ -1172,11 +1147,7 @@
1172
1147
  "reference": "INV-0042",
1173
1148
  "from_account": "DE89 3704 0044 0532 0130 00"
1174
1149
  },
1175
- "expires_at": "2026-10-11T09:15:10Z",
1176
- "user_approval_required": true,
1177
- "url": "https://ledgerly.example/operations/op_1",
1178
- "confirmation": null,
1179
- "result": null
1150
+ "expires_at": "2026-10-11T09:15:10Z"
1180
1151
  }
1181
1152
  }
1182
1153
  },
@@ -1205,8 +1176,7 @@
1205
1176
  "request": {
1206
1177
  "headers": {
1207
1178
  "content-type": "application/x-www-form-urlencoded",
1208
- "accept": "application/json",
1209
- "dpop": "‹DPoP proof›"
1179
+ "accept": "application/json"
1210
1180
  },
1211
1181
  "body": {
1212
1182
  "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
@@ -1223,11 +1193,10 @@
1223
1193
  "cache-control": "no-store"
1224
1194
  },
1225
1195
  "body": {
1226
- "access_token": "‹session token›",
1227
- "token_type": "DPoP",
1196
+ "access_token": "‹access token›",
1197
+ "token_type": "Bearer",
1228
1198
  "expires_in": 3600,
1229
- "refresh_token": "‹account token›",
1230
- "refresh_token_expires_in": 7776000
1199
+ "refresh_token": "‹refresh token›"
1231
1200
  }
1232
1201
  }
1233
1202
  },
@@ -1242,8 +1211,8 @@
1242
1211
  "headers": {
1243
1212
  "content-type": "application/json",
1244
1213
  "accept": "*/*",
1245
- "authorization": "DPoP ‹session token›",
1246
- "dpop": "‹DPoP proof›"
1214
+ "authorization": "Bearer ‹access token›",
1215
+ "poppy-session": "‹Session JWT›"
1247
1216
  },
1248
1217
  "body": {
1249
1218
  "message": {
@@ -1295,8 +1264,7 @@
1295
1264
  "text": "Ready to pay INV-0042.",
1296
1265
  "operation": {
1297
1266
  "operation_id": "op_2",
1298
- "revision": 1,
1299
- "state": "proposed",
1267
+ "revision": "rev_2",
1300
1268
  "summary": "Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1301
1269
  "terms": {
1302
1270
  "amount": {
@@ -1307,11 +1275,7 @@
1307
1275
  "reference": "INV-0042",
1308
1276
  "from_account": "DE89 3704 0044 0532 0130 00"
1309
1277
  },
1310
- "expires_at": "2026-10-11T09:15:10Z",
1311
- "user_approval_required": false,
1312
- "url": "https://northwind.example/operations/op_2",
1313
- "confirmation": null,
1314
- "result": null
1278
+ "expires_at": "2026-10-11T09:15:10Z"
1315
1279
  }
1316
1280
  }
1317
1281
  },
@@ -1334,13 +1298,13 @@
1334
1298
  },
1335
1299
  {
1336
1300
  "title": "Ada approves; Northwind pays",
1337
- "channel": "approved_by: user",
1338
- "summary": "Atlas confirms Ledgerly's operation. Ledgerly checks Northwind's revision is unchanged and confirms it at Northwind with approved_by: user. Northwind's result becomes Ledgerly's, as written.",
1301
+ "channel": "Each approval sent on",
1302
+ "summary": "Atlas sends Ada's approval of Ledgerly's operation. Ledgerly checks Northwind's revision is unchanged and sends Northwind her approval of it. Northwind's answer becomes Ledgerly's, as written.",
1339
1303
  "chat": [
1340
1304
  {
1341
1305
  "speaker": "user",
1342
1306
  "kind": "approval",
1343
- "title": "Revision 1 · approved",
1307
+ "title": "Revision rev_1 · approved",
1344
1308
  "text": "At Northwind Bank: Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent."
1345
1309
  },
1346
1310
  {
@@ -1358,7 +1322,7 @@
1358
1322
  },
1359
1323
  {
1360
1324
  "label": "Session",
1361
- "value": "signed in · DPoP-bound"
1325
+ "value": "signed in · a Session JWT on every request"
1362
1326
  },
1363
1327
  {
1364
1328
  "label": "Scopes",
@@ -1366,7 +1330,7 @@
1366
1330
  },
1367
1331
  {
1368
1332
  "label": "Vault (host only)",
1369
- "value": "1 Account Token by reference"
1333
+ "value": "1 refresh token by reference"
1370
1334
  },
1371
1335
  {
1372
1336
  "label": "Model sees",
@@ -1381,11 +1345,11 @@
1381
1345
  },
1382
1346
  {
1383
1347
  "label": "Sessions",
1384
- "value": "1 live · 1 signed in",
1348
+ "value": "1 live",
1385
1349
  "group": "As a company to Atlas"
1386
1350
  },
1387
1351
  {
1388
- "label": "Account behind the Session",
1352
+ "label": "Account behind the access token",
1389
1353
  "value": "acct_ada_ledgerly",
1390
1354
  "group": "As a company to Atlas"
1391
1355
  },
@@ -1395,27 +1359,27 @@
1395
1359
  "group": "As a company to Atlas"
1396
1360
  },
1397
1361
  {
1398
- "label": "Account Tokens issued",
1362
+ "label": "Refresh tokens issued",
1399
1363
  "value": "1 · 1 not revoked",
1400
1364
  "group": "As a company to Atlas"
1401
1365
  },
1402
1366
  {
1403
1367
  "label": "Conversation",
1404
- "value": "idle · agent · 8 events",
1368
+ "value": "idle · agent · 12 events",
1405
1369
  "group": "As a company to Atlas"
1406
1370
  },
1407
1371
  {
1408
1372
  "label": "Operation northwind.payment",
1409
- "value": "revision 1 · succeeded · approved by user",
1373
+ "value": "revision rev_1 · performed",
1410
1374
  "group": "As a company to Atlas"
1411
1375
  },
1412
1376
  {
1413
1377
  "label": "Northwind Session",
1414
- "value": "signed in · DPoP-bound",
1378
+ "value": "signed in · a Session JWT on every request",
1415
1379
  "group": "As Ada's personal agent at Northwind"
1416
1380
  },
1417
1381
  {
1418
- "label": "Northwind Account Token",
1382
+ "label": "Northwind refresh token",
1419
1383
  "value": "in Ledgerly's vault, by reference",
1420
1384
  "group": "As Ada's personal agent at Northwind"
1421
1385
  }
@@ -1427,10 +1391,10 @@
1427
1391
  },
1428
1392
  {
1429
1393
  "label": "Sessions",
1430
- "value": "1 live · 1 signed in"
1394
+ "value": "1 live"
1431
1395
  },
1432
1396
  {
1433
- "label": "Account behind the Session",
1397
+ "label": "Account behind the access token",
1434
1398
  "value": "acct_ada_northwind"
1435
1399
  },
1436
1400
  {
@@ -1438,16 +1402,16 @@
1438
1402
  "value": "accounts:read payments:write"
1439
1403
  },
1440
1404
  {
1441
- "label": "Account Tokens issued",
1405
+ "label": "Refresh tokens issued",
1442
1406
  "value": "1 · 1 not revoked"
1443
1407
  },
1444
1408
  {
1445
1409
  "label": "Conversation",
1446
- "value": "idle · agent · 4 events"
1410
+ "value": "idle · agent · 8 events"
1447
1411
  },
1448
1412
  {
1449
1413
  "label": "Operation payments.transfer",
1450
- "value": "revision 1 · succeeded · approved by user"
1414
+ "value": "revision rev_2 · performed"
1451
1415
  }
1452
1416
  ]
1453
1417
  },
@@ -1456,573 +1420,33 @@
1456
1420
  "kind": "action",
1457
1421
  "from": "user",
1458
1422
  "to": "atlas",
1459
- "label": "Approves Ledgerly's revision 1"
1423
+ "label": "Approves Ledgerly's revision rev_1"
1460
1424
  },
1461
1425
  {
1462
1426
  "kind": "http",
1463
1427
  "from": "atlas",
1464
1428
  "to": "ledgerly",
1465
1429
  "method": "POST",
1466
- "url": "https://ledgerly.example/poppy/operations/op_1/confirm",
1467
- "status": 200,
1430
+ "url": "https://ledgerly.example/poppy/conversations/cnv_1/messages?cursor=evt_8&wait=0",
1431
+ "status": 202,
1468
1432
  "request": {
1469
1433
  "headers": {
1470
1434
  "content-type": "application/json",
1471
- "accept": "application/json",
1472
- "authorization": "DPoP ‹session token›",
1473
- "dpop": "‹DPoP proof›"
1435
+ "accept": "*/*",
1436
+ "authorization": "Bearer ‹access token›",
1437
+ "poppy-session": "‹Session JWT›"
1474
1438
  },
1475
1439
  "body": {
1476
- "revision": 1,
1477
- "approved_by": "user"
1478
- }
1479
- },
1480
- "response": {
1481
- "headers": {
1482
- "content-type": "application/json"
1483
- },
1484
- "body": {
1485
- "operation_id": "op_1",
1486
- "revision": 1,
1487
- "state": "succeeded",
1488
- "summary": "At Northwind Bank: Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1489
- "terms": {
1490
- "northwind_operation_id": "op_2",
1491
- "northwind_revision": 1,
1492
- "amount": {
1493
- "amount": "1250.00",
1494
- "currency": "EUR"
1495
- },
1496
- "payee": "Acme GmbH",
1497
- "reference": "INV-0042",
1498
- "from_account": "DE89 3704 0044 0532 0130 00"
1499
- },
1500
- "user_approval_required": true,
1501
- "url": "https://ledgerly.example/operations/op_1",
1502
- "confirmation": {
1503
- "revision": 1,
1504
- "approved_by": "user",
1505
- "confirmed_at": "2026-10-11T09:00:10Z"
1506
- },
1507
- "result": {
1508
- "summary": "Northwind Bank: Sent EUR 1250.00 to Acme GmbH for INV-0042 from DE89 3704 0044 0532 0130 00. Bank reference NW-0001.",
1509
- "data": {
1510
- "bank_reference": "NW-0001"
1511
- }
1512
- }
1513
- }
1514
- }
1515
- },
1516
- {
1517
- "kind": "http",
1518
- "from": "ledgerly",
1519
- "to": "northwind",
1520
- "method": "POST",
1521
- "url": "https://northwind.example/poppy/operations/op_2/confirm",
1522
- "status": 200,
1523
- "request": {
1524
- "headers": {
1525
- "content-type": "application/json",
1526
- "accept": "application/json",
1527
- "authorization": "DPoP ‹session token›",
1528
- "dpop": "‹DPoP proof›"
1529
- },
1530
- "body": {
1531
- "revision": 1,
1532
- "approved_by": "user"
1533
- }
1534
- },
1535
- "response": {
1536
- "headers": {
1537
- "content-type": "application/json"
1538
- },
1539
- "body": {
1540
- "operation_id": "op_2",
1541
- "revision": 1,
1542
- "state": "succeeded",
1543
- "summary": "Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1544
- "terms": {
1545
- "amount": {
1546
- "amount": "1250.00",
1547
- "currency": "EUR"
1548
- },
1549
- "payee": "Acme GmbH",
1550
- "reference": "INV-0042",
1551
- "from_account": "DE89 3704 0044 0532 0130 00"
1552
- },
1553
- "user_approval_required": false,
1554
- "url": "https://northwind.example/operations/op_2",
1555
- "confirmation": {
1556
- "revision": 1,
1557
- "approved_by": "user",
1558
- "confirmed_at": "2026-10-11T09:00:10Z"
1559
- },
1560
- "result": {
1561
- "summary": "Sent EUR 1250.00 to Acme GmbH for INV-0042 from DE89 3704 0044 0532 0130 00. Bank reference NW-0001.",
1562
- "data": {
1563
- "bank_reference": "NW-0001"
1564
- }
1565
- }
1566
- }
1567
- }
1568
- }
1569
- ]
1570
- },
1571
- {
1572
- "title": "A standing permission, approved",
1573
- "channel": "ledgerly.standing_permission",
1574
- "summary": "The permission is itself an operation Ada approves. Ledgerly records it in its pap.standingPermissionStore, bounded by payee, amount, currency, uses, and time.",
1575
- "chat": [
1576
- {
1577
- "speaker": "user",
1578
- "kind": "message",
1579
- "text": "Allow Ledgerly to pay Acme invoices up to EUR 2000 without asking."
1580
- },
1581
- {
1582
- "speaker": "ledgerly",
1583
- "kind": "approval",
1584
- "title": "Revision 1 · approved",
1585
- "text": "Let Ledgerly pay Acme GmbH from your Northwind account without asking, up to EUR 2000.00 each, at most 5 payments, for 30 days."
1586
- },
1587
- {
1588
- "speaker": "ledgerly",
1589
- "kind": "result",
1590
- "title": "Result",
1591
- "text": "Ledgerly may pay Acme GmbH from your Northwind account without asking, up to EUR 2000.00 each, at most 5 payments, for 30 days."
1592
- }
1593
- ],
1594
- "views": {
1595
- "atlas": [
1596
- {
1597
- "label": "Company",
1598
- "value": "Ledgerly · discovery verified"
1599
- },
1600
- {
1601
- "label": "Session",
1602
- "value": "signed in · DPoP-bound"
1603
- },
1604
- {
1605
- "label": "Scopes",
1606
- "value": "books:read payments:write"
1607
- },
1608
- {
1609
- "label": "Vault (host only)",
1610
- "value": "1 Account Token by reference"
1611
- },
1612
- {
1613
- "label": "Model sees",
1614
- "value": "Summaries and statuses, never a credential"
1615
- }
1616
- ],
1617
- "ledgerly": [
1618
- {
1619
- "label": "Verified client",
1620
- "value": "atlas.example/agent.json",
1621
- "group": "As a company to Atlas"
1622
- },
1623
- {
1624
- "label": "Sessions",
1625
- "value": "1 live · 1 signed in",
1626
- "group": "As a company to Atlas"
1627
- },
1628
- {
1629
- "label": "Account behind the Session",
1630
- "value": "acct_ada_ledgerly",
1631
- "group": "As a company to Atlas"
1632
- },
1633
- {
1634
- "label": "Granted scopes",
1635
- "value": "books:read payments:write",
1636
- "group": "As a company to Atlas"
1637
- },
1638
- {
1639
- "label": "Account Tokens issued",
1640
- "value": "1 · 1 not revoked",
1641
- "group": "As a company to Atlas"
1642
- },
1643
- {
1644
- "label": "Conversation",
1645
- "value": "idle · agent · 12 events",
1646
- "group": "As a company to Atlas"
1647
- },
1648
- {
1649
- "label": "Operation northwind.payment",
1650
- "value": "revision 1 · succeeded · approved by user",
1651
- "group": "As a company to Atlas"
1652
- },
1653
- {
1654
- "label": "Operation ledgerly.standing_permission",
1655
- "value": "revision 1 · succeeded · approved by user",
1656
- "group": "As a company to Atlas"
1657
- },
1658
- {
1659
- "label": "Northwind Session",
1660
- "value": "signed in · DPoP-bound",
1661
- "group": "As Ada's personal agent at Northwind"
1662
- },
1663
- {
1664
- "label": "Northwind Account Token",
1665
- "value": "in Ledgerly's vault, by reference",
1666
- "group": "As Ada's personal agent at Northwind"
1667
- },
1668
- {
1669
- "label": "Standing permission",
1670
- "value": "payments.transfer · 5 uses left · payee = Acme GmbH, amount.amount ≤ 2000.00, amount.currency = EUR",
1671
- "group": "As Ada's personal agent at Northwind"
1672
- }
1673
- ],
1674
- "northwind": [
1675
- {
1676
- "label": "Verified client",
1677
- "value": "ledgerly.example/poppy/agent.json"
1678
- },
1679
- {
1680
- "label": "Sessions",
1681
- "value": "1 live · 1 signed in"
1682
- },
1683
- {
1684
- "label": "Account behind the Session",
1685
- "value": "acct_ada_northwind"
1686
- },
1687
- {
1688
- "label": "Granted scopes",
1689
- "value": "accounts:read payments:write"
1690
- },
1691
- {
1692
- "label": "Account Tokens issued",
1693
- "value": "1 · 1 not revoked"
1694
- },
1695
- {
1696
- "label": "Conversation",
1697
- "value": "idle · agent · 4 events"
1698
- },
1699
- {
1700
- "label": "Operation payments.transfer",
1701
- "value": "revision 1 · succeeded · approved by user"
1702
- }
1703
- ]
1704
- },
1705
- "sequence": [
1706
- {
1707
- "kind": "http",
1708
- "from": "atlas",
1709
- "to": "ledgerly",
1710
- "method": "POST",
1711
- "url": "https://ledgerly.example/poppy/conversations/cnv_1/messages?cursor=evt_8&wait=0",
1712
- "status": 202,
1713
- "request": {
1714
- "headers": {
1715
- "content-type": "application/json",
1716
- "accept": "*/*",
1717
- "authorization": "DPoP ‹session token›",
1718
- "dpop": "‹DPoP proof›"
1719
- },
1720
- "body": {
1721
- "message": {
1722
- "id": "msg_7",
1723
- "author": {
1724
- "type": "human"
1725
- },
1726
- "text": "Allow Ledgerly to pay Acme invoices up to EUR 2000 without asking"
1727
- }
1728
- }
1729
- },
1730
- "response": {
1731
- "headers": {
1732
- "content-type": "application/json"
1733
- },
1734
- "body": {
1735
- "conversation_id": "cnv_1",
1736
- "events": [
1737
- {
1738
- "id": "evt_13",
1739
- "created_at": "2026-10-11T09:00:10Z",
1740
- "type": "message",
1741
- "message": {
1742
- "id": "msg_7",
1743
- "author": {
1744
- "type": "human"
1745
- },
1746
- "text": "Allow Ledgerly to pay Acme invoices up to EUR 2000 without asking",
1747
- "role": "user"
1748
- }
1749
- },
1750
- {
1751
- "id": "evt_14",
1752
- "created_at": "2026-10-11T09:00:10Z",
1753
- "type": "state",
1754
- "status": "working",
1755
- "responder": "agent"
1756
- },
1757
- {
1758
- "id": "evt_15",
1759
- "created_at": "2026-10-11T09:00:10Z",
1760
- "type": "message",
1761
- "message": {
1762
- "id": "msg_8",
1763
- "author": {
1764
- "type": "agent"
1765
- },
1766
- "role": "company",
1767
- "text": "Here is the permission, to approve.",
1768
- "operation": {
1769
- "operation_id": "op_3",
1770
- "revision": 1,
1771
- "state": "proposed",
1772
- "summary": "Let Ledgerly pay Acme GmbH from your Northwind account without asking, up to EUR 2000.00 each, at most 5 payments, for 30 days.",
1773
- "terms": {
1774
- "company": "Northwind Bank",
1775
- "action": "payments.transfer",
1776
- "payee": "Acme GmbH",
1777
- "maximum": {
1778
- "amount": "2000.00",
1779
- "currency": "EUR"
1780
- },
1781
- "uses": 5,
1782
- "days": 30
1783
- },
1784
- "expires_at": "2026-10-11T09:15:10Z",
1785
- "user_approval_required": true,
1786
- "url": "https://ledgerly.example/operations/op_3",
1787
- "confirmation": null,
1788
- "result": null
1789
- }
1790
- }
1791
- },
1792
- {
1793
- "id": "evt_16",
1794
- "created_at": "2026-10-11T09:00:10Z",
1795
- "type": "state",
1796
- "status": "idle",
1797
- "responder": "agent"
1798
- }
1799
- ],
1800
- "cursor": "evt_16",
1801
- "has_more": false,
1802
- "status": "idle",
1803
- "responder": "agent"
1804
- }
1805
- }
1806
- },
1807
- {
1808
- "kind": "action",
1809
- "from": "user",
1810
- "to": "atlas",
1811
- "label": "Approves the standing permission"
1812
- },
1813
- {
1814
- "kind": "http",
1815
- "from": "atlas",
1816
- "to": "ledgerly",
1817
- "method": "POST",
1818
- "url": "https://ledgerly.example/poppy/operations/op_3/confirm",
1819
- "status": 200,
1820
- "request": {
1821
- "headers": {
1822
- "content-type": "application/json",
1823
- "accept": "application/json",
1824
- "authorization": "DPoP ‹session token›",
1825
- "dpop": "‹DPoP proof›"
1826
- },
1827
- "body": {
1828
- "revision": 1,
1829
- "approved_by": "user"
1830
- }
1831
- },
1832
- "response": {
1833
- "headers": {
1834
- "content-type": "application/json"
1835
- },
1836
- "body": {
1837
- "operation_id": "op_3",
1838
- "revision": 1,
1839
- "state": "succeeded",
1840
- "summary": "Let Ledgerly pay Acme GmbH from your Northwind account without asking, up to EUR 2000.00 each, at most 5 payments, for 30 days.",
1841
- "terms": {
1842
- "company": "Northwind Bank",
1843
- "action": "payments.transfer",
1844
- "payee": "Acme GmbH",
1845
- "maximum": {
1846
- "amount": "2000.00",
1847
- "currency": "EUR"
1848
- },
1849
- "uses": 5,
1850
- "days": 30
1851
- },
1852
- "user_approval_required": true,
1853
- "url": "https://ledgerly.example/operations/op_3",
1854
- "confirmation": {
1855
- "revision": 1,
1856
- "approved_by": "user",
1857
- "confirmed_at": "2026-10-11T09:00:10Z"
1858
- },
1859
- "result": {
1860
- "summary": "Ledgerly may pay Acme GmbH from your Northwind account without asking, up to EUR 2000.00 each, at most 5 payments, for 30 days.",
1861
- "data": null
1862
- }
1863
- }
1864
- }
1865
- }
1866
- ]
1867
- },
1868
- {
1869
- "title": "Within the bounds",
1870
- "channel": "approved_by: standing_permission",
1871
- "summary": "Northwind proposes the next payment; it is within the permission, so Ledgerly confirms it at Northwind with approved_by: standing_permission and tells Ada what was done.",
1872
- "chat": [
1873
- {
1874
- "speaker": "user",
1875
- "kind": "message",
1876
- "text": "Pay INV-0043."
1877
- },
1878
- {
1879
- "speaker": "ledgerly",
1880
- "kind": "message",
1881
- "text": "Paid under your standing permission. Northwind Bank: Sent EUR 980.00 to Acme GmbH for INV-0043 from DE89 3704 0044 0532 0130 00. Bank reference NW-0002."
1882
- }
1883
- ],
1884
- "views": {
1885
- "atlas": [
1886
- {
1887
- "label": "Company",
1888
- "value": "Ledgerly · discovery verified"
1889
- },
1890
- {
1891
- "label": "Session",
1892
- "value": "signed in · DPoP-bound"
1893
- },
1894
- {
1895
- "label": "Scopes",
1896
- "value": "books:read payments:write"
1897
- },
1898
- {
1899
- "label": "Vault (host only)",
1900
- "value": "1 Account Token by reference"
1901
- },
1902
- {
1903
- "label": "Model sees",
1904
- "value": "Summaries and statuses, never a credential"
1905
- }
1906
- ],
1907
- "ledgerly": [
1908
- {
1909
- "label": "Verified client",
1910
- "value": "atlas.example/agent.json",
1911
- "group": "As a company to Atlas"
1912
- },
1913
- {
1914
- "label": "Sessions",
1915
- "value": "1 live · 1 signed in",
1916
- "group": "As a company to Atlas"
1917
- },
1918
- {
1919
- "label": "Account behind the Session",
1920
- "value": "acct_ada_ledgerly",
1921
- "group": "As a company to Atlas"
1922
- },
1923
- {
1924
- "label": "Granted scopes",
1925
- "value": "books:read payments:write",
1926
- "group": "As a company to Atlas"
1927
- },
1928
- {
1929
- "label": "Account Tokens issued",
1930
- "value": "1 · 1 not revoked",
1931
- "group": "As a company to Atlas"
1932
- },
1933
- {
1934
- "label": "Conversation",
1935
- "value": "idle · agent · 16 events",
1936
- "group": "As a company to Atlas"
1937
- },
1938
- {
1939
- "label": "Operation northwind.payment",
1940
- "value": "revision 1 · succeeded · approved by user",
1941
- "group": "As a company to Atlas"
1942
- },
1943
- {
1944
- "label": "Operation ledgerly.standing_permission",
1945
- "value": "revision 1 · succeeded · approved by user",
1946
- "group": "As a company to Atlas"
1947
- },
1948
- {
1949
- "label": "Northwind Session",
1950
- "value": "signed in · DPoP-bound",
1951
- "group": "As Ada's personal agent at Northwind"
1952
- },
1953
- {
1954
- "label": "Northwind Account Token",
1955
- "value": "in Ledgerly's vault, by reference",
1956
- "group": "As Ada's personal agent at Northwind"
1957
- },
1958
- {
1959
- "label": "Standing permission",
1960
- "value": "payments.transfer · 4 uses left · payee = Acme GmbH, amount.amount ≤ 2000.00, amount.currency = EUR",
1961
- "group": "As Ada's personal agent at Northwind"
1962
- }
1963
- ],
1964
- "northwind": [
1965
- {
1966
- "label": "Verified client",
1967
- "value": "ledgerly.example/poppy/agent.json"
1968
- },
1969
- {
1970
- "label": "Sessions",
1971
- "value": "1 live · 1 signed in"
1972
- },
1973
- {
1974
- "label": "Account behind the Session",
1975
- "value": "acct_ada_northwind"
1976
- },
1977
- {
1978
- "label": "Granted scopes",
1979
- "value": "accounts:read payments:write"
1980
- },
1981
- {
1982
- "label": "Account Tokens issued",
1983
- "value": "1 · 1 not revoked"
1984
- },
1985
- {
1986
- "label": "Conversation",
1987
- "value": "idle · agent · 4 events"
1988
- },
1989
- {
1990
- "label": "Conversation",
1991
- "value": "idle · agent · 4 events"
1992
- },
1993
- {
1994
- "label": "Operation payments.transfer",
1995
- "value": "revision 1 · succeeded · approved by user"
1996
- },
1997
- {
1998
- "label": "Operation payments.transfer",
1999
- "value": "revision 1 · succeeded · approved by standing_permission"
2000
- }
2001
- ]
2002
- },
2003
- "sequence": [
2004
- {
2005
- "kind": "http",
2006
- "from": "atlas",
2007
- "to": "ledgerly",
2008
- "method": "POST",
2009
- "url": "https://ledgerly.example/poppy/conversations/cnv_1/messages?cursor=evt_16&wait=0",
2010
- "status": 202,
2011
- "request": {
2012
- "headers": {
2013
- "content-type": "application/json",
2014
- "accept": "*/*",
2015
- "authorization": "DPoP ‹session token›",
2016
- "dpop": "‹DPoP proof›"
2017
- },
2018
- "body": {
2019
- "message": {
2020
- "id": "msg_9",
2021
- "author": {
2022
- "type": "human"
2023
- },
2024
- "text": "Pay INV-0043"
2025
- }
1440
+ "message": {
1441
+ "id": "msg_7",
1442
+ "author": {
1443
+ "type": "agent"
1444
+ },
1445
+ "approval": {
1446
+ "operation_id": "op_1",
1447
+ "revision": "rev_1"
1448
+ }
1449
+ }
2026
1450
  }
2027
1451
  },
2028
1452
  "response": {
@@ -2033,50 +1457,53 @@
2033
1457
  "conversation_id": "cnv_1",
2034
1458
  "events": [
2035
1459
  {
2036
- "id": "evt_17",
1460
+ "id": "evt_13",
2037
1461
  "created_at": "2026-10-11T09:00:10Z",
2038
1462
  "type": "message",
2039
1463
  "message": {
2040
- "id": "msg_9",
1464
+ "id": "msg_7",
2041
1465
  "author": {
2042
- "type": "human"
1466
+ "type": "agent"
1467
+ },
1468
+ "approval": {
1469
+ "operation_id": "op_1",
1470
+ "revision": "rev_1"
2043
1471
  },
2044
- "text": "Pay INV-0043",
2045
1472
  "role": "user"
2046
1473
  }
2047
1474
  },
2048
1475
  {
2049
- "id": "evt_18",
1476
+ "id": "evt_14",
2050
1477
  "created_at": "2026-10-11T09:00:10Z",
2051
1478
  "type": "state",
2052
1479
  "status": "working",
2053
1480
  "responder": "agent"
2054
1481
  },
2055
1482
  {
2056
- "id": "evt_19",
1483
+ "id": "evt_15",
2057
1484
  "created_at": "2026-10-11T09:00:10Z",
2058
1485
  "type": "message",
2059
1486
  "message": {
2060
- "id": "msg_10",
1487
+ "id": "msg_8",
2061
1488
  "author": {
2062
1489
  "type": "agent"
2063
1490
  },
2064
1491
  "role": "company",
2065
- "text": "Paid under your standing permission. Northwind Bank: Sent EUR 980.00 to Acme GmbH for INV-0043 from DE89 3704 0044 0532 0130 00. Bank reference NW-0002.",
1492
+ "text": "Northwind Bank: Sent EUR 1250.00 to Acme GmbH for INV-0042 from DE89 3704 0044 0532 0130 00. Bank reference NW-0001.",
2066
1493
  "data": {
2067
- "northwind_operation_id": "op_4"
1494
+ "bank_reference": "NW-0001"
2068
1495
  }
2069
1496
  }
2070
1497
  },
2071
1498
  {
2072
- "id": "evt_20",
1499
+ "id": "evt_16",
2073
1500
  "created_at": "2026-10-11T09:00:10Z",
2074
1501
  "type": "state",
2075
1502
  "status": "idle",
2076
1503
  "responder": "agent"
2077
1504
  }
2078
1505
  ],
2079
- "cursor": "evt_20",
1506
+ "cursor": "evt_16",
2080
1507
  "has_more": false,
2081
1508
  "status": "idle",
2082
1509
  "responder": "agent"
@@ -2088,22 +1515,25 @@
2088
1515
  "from": "ledgerly",
2089
1516
  "to": "northwind",
2090
1517
  "method": "POST",
2091
- "url": "https://northwind.example/poppy/conversations?wait=0",
2092
- "status": 201,
1518
+ "url": "https://northwind.example/poppy/conversations/cnv_2/messages?wait=0",
1519
+ "status": 202,
2093
1520
  "request": {
2094
1521
  "headers": {
2095
1522
  "content-type": "application/json",
2096
1523
  "accept": "*/*",
2097
- "authorization": "DPoP ‹session token›",
2098
- "dpop": "‹DPoP proof›"
1524
+ "authorization": "Bearer ‹access token›",
1525
+ "poppy-session": "‹Session JWT›"
2099
1526
  },
2100
1527
  "body": {
2101
1528
  "message": {
2102
- "id": "msg_11",
1529
+ "id": "msg_9",
2103
1530
  "author": {
2104
1531
  "type": "agent"
2105
1532
  },
2106
- "text": "Pay INV-0043: EUR 980.00 to Acme GmbH"
1533
+ "approval": {
1534
+ "operation_id": "op_2",
1535
+ "revision": "rev_2"
1536
+ }
2107
1537
  }
2108
1538
  }
2109
1539
  },
@@ -2112,151 +1542,139 @@
2112
1542
  "content-type": "application/json"
2113
1543
  },
2114
1544
  "body": {
2115
- "conversation_id": "cnv_3",
1545
+ "conversation_id": "cnv_2",
2116
1546
  "events": [
2117
1547
  {
2118
- "id": "evt_21",
1548
+ "id": "evt_9",
2119
1549
  "created_at": "2026-10-11T09:00:10Z",
2120
1550
  "type": "message",
2121
1551
  "message": {
2122
- "id": "msg_11",
1552
+ "id": "msg_5",
2123
1553
  "author": {
2124
1554
  "type": "agent"
2125
1555
  },
2126
- "text": "Pay INV-0043: EUR 980.00 to Acme GmbH",
1556
+ "text": "Pay INV-0042: EUR 1250.00 to Acme GmbH",
2127
1557
  "role": "user"
2128
1558
  }
2129
1559
  },
2130
1560
  {
2131
- "id": "evt_22",
1561
+ "id": "evt_10",
2132
1562
  "created_at": "2026-10-11T09:00:10Z",
2133
1563
  "type": "state",
2134
1564
  "status": "working",
2135
1565
  "responder": "agent"
2136
1566
  },
2137
1567
  {
2138
- "id": "evt_23",
1568
+ "id": "evt_11",
2139
1569
  "created_at": "2026-10-11T09:00:10Z",
2140
1570
  "type": "message",
2141
1571
  "message": {
2142
- "id": "msg_12",
1572
+ "id": "msg_6",
2143
1573
  "author": {
2144
1574
  "type": "agent"
2145
1575
  },
2146
1576
  "role": "company",
2147
- "text": "Ready to pay INV-0043.",
1577
+ "text": "Ready to pay INV-0042.",
2148
1578
  "operation": {
2149
- "operation_id": "op_4",
2150
- "revision": 1,
2151
- "state": "proposed",
2152
- "summary": "Pay EUR 980.00 to Acme GmbH for INV-0043 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1579
+ "operation_id": "op_2",
1580
+ "revision": "rev_2",
1581
+ "summary": "Pay EUR 1250.00 to Acme GmbH for INV-0042 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
2153
1582
  "terms": {
2154
1583
  "amount": {
2155
- "amount": "980.00",
1584
+ "amount": "1250.00",
2156
1585
  "currency": "EUR"
2157
1586
  },
2158
1587
  "payee": "Acme GmbH",
2159
- "reference": "INV-0043",
1588
+ "reference": "INV-0042",
2160
1589
  "from_account": "DE89 3704 0044 0532 0130 00"
2161
1590
  },
2162
- "expires_at": "2026-10-11T09:15:10Z",
2163
- "user_approval_required": false,
2164
- "url": "https://northwind.example/operations/op_4",
2165
- "confirmation": null,
2166
- "result": null
1591
+ "expires_at": "2026-10-11T09:15:10Z"
2167
1592
  }
2168
1593
  }
2169
1594
  },
2170
1595
  {
2171
- "id": "evt_24",
1596
+ "id": "evt_12",
1597
+ "created_at": "2026-10-11T09:00:10Z",
1598
+ "type": "state",
1599
+ "status": "idle",
1600
+ "responder": "agent"
1601
+ },
1602
+ {
1603
+ "id": "evt_17",
1604
+ "created_at": "2026-10-11T09:00:10Z",
1605
+ "type": "message",
1606
+ "message": {
1607
+ "id": "msg_9",
1608
+ "author": {
1609
+ "type": "agent"
1610
+ },
1611
+ "approval": {
1612
+ "operation_id": "op_2",
1613
+ "revision": "rev_2"
1614
+ },
1615
+ "role": "user"
1616
+ }
1617
+ },
1618
+ {
1619
+ "id": "evt_18",
1620
+ "created_at": "2026-10-11T09:00:10Z",
1621
+ "type": "state",
1622
+ "status": "working",
1623
+ "responder": "agent"
1624
+ },
1625
+ {
1626
+ "id": "evt_19",
1627
+ "created_at": "2026-10-11T09:00:10Z",
1628
+ "type": "message",
1629
+ "message": {
1630
+ "id": "msg_10",
1631
+ "author": {
1632
+ "type": "agent"
1633
+ },
1634
+ "role": "company",
1635
+ "text": "Sent EUR 1250.00 to Acme GmbH for INV-0042 from DE89 3704 0044 0532 0130 00. Bank reference NW-0001.",
1636
+ "data": {
1637
+ "bank_reference": "NW-0001"
1638
+ }
1639
+ }
1640
+ },
1641
+ {
1642
+ "id": "evt_20",
2172
1643
  "created_at": "2026-10-11T09:00:10Z",
2173
1644
  "type": "state",
2174
1645
  "status": "idle",
2175
1646
  "responder": "agent"
2176
1647
  }
2177
1648
  ],
2178
- "cursor": "evt_24",
1649
+ "cursor": "evt_20",
2179
1650
  "has_more": false,
2180
1651
  "status": "idle",
2181
1652
  "responder": "agent"
2182
1653
  }
2183
1654
  }
2184
- },
2185
- {
2186
- "kind": "http",
2187
- "from": "ledgerly",
2188
- "to": "northwind",
2189
- "method": "POST",
2190
- "url": "https://northwind.example/poppy/operations/op_4/confirm",
2191
- "status": 200,
2192
- "request": {
2193
- "headers": {
2194
- "content-type": "application/json",
2195
- "accept": "application/json",
2196
- "authorization": "DPoP ‹session token›",
2197
- "dpop": "‹DPoP proof›"
2198
- },
2199
- "body": {
2200
- "revision": 1,
2201
- "approved_by": "standing_permission"
2202
- }
2203
- },
2204
- "response": {
2205
- "headers": {
2206
- "content-type": "application/json"
2207
- },
2208
- "body": {
2209
- "operation_id": "op_4",
2210
- "revision": 1,
2211
- "state": "succeeded",
2212
- "summary": "Pay EUR 980.00 to Acme GmbH for INV-0043 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
2213
- "terms": {
2214
- "amount": {
2215
- "amount": "980.00",
2216
- "currency": "EUR"
2217
- },
2218
- "payee": "Acme GmbH",
2219
- "reference": "INV-0043",
2220
- "from_account": "DE89 3704 0044 0532 0130 00"
2221
- },
2222
- "user_approval_required": false,
2223
- "url": "https://northwind.example/operations/op_4",
2224
- "confirmation": {
2225
- "revision": 1,
2226
- "approved_by": "standing_permission",
2227
- "confirmed_at": "2026-10-11T09:00:10Z"
2228
- },
2229
- "result": {
2230
- "summary": "Sent EUR 980.00 to Acme GmbH for INV-0043 from DE89 3704 0044 0532 0130 00. Bank reference NW-0002.",
2231
- "data": {
2232
- "bank_reference": "NW-0002"
2233
- }
2234
- }
2235
- }
2236
- }
2237
1655
  }
2238
1656
  ]
2239
1657
  },
2240
1658
  {
2241
- "title": "Beyond the bounds",
2242
- "channel": "Ask again",
2243
- "summary": "EUR 3400.00 is over the permission's limit: Ledgerly does not confirm it and relays Northwind's proposal to Ada again. Nothing is paid until she approves.",
1659
+ "title": "The next payment is asked about too",
1660
+ "channel": "No approval in advance",
1661
+ "summary": "An approval says nothing of the next operation: Northwind returns INV-0043, Ledgerly relays it, and nothing is paid until Ada approves that one as well.",
2244
1662
  "chat": [
2245
1663
  {
2246
1664
  "speaker": "user",
2247
1665
  "kind": "message",
2248
- "text": "Pay INV-0044."
1666
+ "text": "Pay INV-0043."
2249
1667
  },
2250
1668
  {
2251
1669
  "speaker": "ledgerly",
2252
1670
  "kind": "message",
2253
- "text": "Northwind Bank proposes this payment; it needs your approval."
1671
+ "text": "Northwind Bank asks approval for this payment."
2254
1672
  },
2255
1673
  {
2256
1674
  "speaker": "ledgerly",
2257
1675
  "kind": "approval",
2258
- "title": "Revision 1 · needs your approval",
2259
- "text": "At Northwind Bank: Pay EUR 3400.00 to Acme GmbH for INV-0044 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent."
1676
+ "title": "Revision rev_3 · needs your approval",
1677
+ "text": "At Northwind Bank: Pay EUR 980.00 to Acme GmbH for INV-0043 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent."
2260
1678
  }
2261
1679
  ],
2262
1680
  "views": {
@@ -2267,7 +1685,7 @@
2267
1685
  },
2268
1686
  {
2269
1687
  "label": "Session",
2270
- "value": "signed in · DPoP-bound"
1688
+ "value": "signed in · a Session JWT on every request"
2271
1689
  },
2272
1690
  {
2273
1691
  "label": "Scopes",
@@ -2275,7 +1693,7 @@
2275
1693
  },
2276
1694
  {
2277
1695
  "label": "Vault (host only)",
2278
- "value": "1 Account Token by reference"
1696
+ "value": "1 refresh token by reference"
2279
1697
  },
2280
1698
  {
2281
1699
  "label": "Model sees",
@@ -2290,11 +1708,11 @@
2290
1708
  },
2291
1709
  {
2292
1710
  "label": "Sessions",
2293
- "value": "1 live · 1 signed in",
1711
+ "value": "1 live",
2294
1712
  "group": "As a company to Atlas"
2295
1713
  },
2296
1714
  {
2297
- "label": "Account behind the Session",
1715
+ "label": "Account behind the access token",
2298
1716
  "value": "acct_ada_ledgerly",
2299
1717
  "group": "As a company to Atlas"
2300
1718
  },
@@ -2304,44 +1722,34 @@
2304
1722
  "group": "As a company to Atlas"
2305
1723
  },
2306
1724
  {
2307
- "label": "Account Tokens issued",
1725
+ "label": "Refresh tokens issued",
2308
1726
  "value": "1 · 1 not revoked",
2309
1727
  "group": "As a company to Atlas"
2310
1728
  },
2311
1729
  {
2312
1730
  "label": "Conversation",
2313
- "value": "idle · agent · 20 events",
1731
+ "value": "idle · agent · 16 events",
2314
1732
  "group": "As a company to Atlas"
2315
1733
  },
2316
1734
  {
2317
1735
  "label": "Operation northwind.payment",
2318
- "value": "revision 1 · succeeded · approved by user",
2319
- "group": "As a company to Atlas"
2320
- },
2321
- {
2322
- "label": "Operation ledgerly.standing_permission",
2323
- "value": "revision 1 · succeeded · approved by user",
1736
+ "value": "revision rev_1 · performed",
2324
1737
  "group": "As a company to Atlas"
2325
1738
  },
2326
1739
  {
2327
1740
  "label": "Operation northwind.payment",
2328
- "value": "revision 1 · proposed",
1741
+ "value": "revision rev_3 · open",
2329
1742
  "group": "As a company to Atlas"
2330
1743
  },
2331
1744
  {
2332
1745
  "label": "Northwind Session",
2333
- "value": "signed in · DPoP-bound",
1746
+ "value": "signed in · a Session JWT on every request",
2334
1747
  "group": "As Ada's personal agent at Northwind"
2335
1748
  },
2336
1749
  {
2337
- "label": "Northwind Account Token",
1750
+ "label": "Northwind refresh token",
2338
1751
  "value": "in Ledgerly's vault, by reference",
2339
1752
  "group": "As Ada's personal agent at Northwind"
2340
- },
2341
- {
2342
- "label": "Standing permission",
2343
- "value": "payments.transfer · 4 uses left · payee = Acme GmbH, amount.amount ≤ 2000.00, amount.currency = EUR",
2344
- "group": "As Ada's personal agent at Northwind"
2345
1753
  }
2346
1754
  ],
2347
1755
  "northwind": [
@@ -2351,10 +1759,10 @@
2351
1759
  },
2352
1760
  {
2353
1761
  "label": "Sessions",
2354
- "value": "1 live · 1 signed in"
1762
+ "value": "1 live"
2355
1763
  },
2356
1764
  {
2357
- "label": "Account behind the Session",
1765
+ "label": "Account behind the access token",
2358
1766
  "value": "acct_ada_northwind"
2359
1767
  },
2360
1768
  {
@@ -2362,16 +1770,12 @@
2362
1770
  "value": "accounts:read payments:write"
2363
1771
  },
2364
1772
  {
2365
- "label": "Account Tokens issued",
1773
+ "label": "Refresh tokens issued",
2366
1774
  "value": "1 · 1 not revoked"
2367
1775
  },
2368
1776
  {
2369
1777
  "label": "Conversation",
2370
- "value": "idle · agent · 4 events"
2371
- },
2372
- {
2373
- "label": "Conversation",
2374
- "value": "idle · agent · 4 events"
1778
+ "value": "idle · agent · 8 events"
2375
1779
  },
2376
1780
  {
2377
1781
  "label": "Conversation",
@@ -2379,15 +1783,11 @@
2379
1783
  },
2380
1784
  {
2381
1785
  "label": "Operation payments.transfer",
2382
- "value": "revision 1 · succeeded · approved by user"
2383
- },
2384
- {
2385
- "label": "Operation payments.transfer",
2386
- "value": "revision 1 · succeeded · approved by standing_permission"
1786
+ "value": "revision rev_2 · performed"
2387
1787
  },
2388
1788
  {
2389
1789
  "label": "Operation payments.transfer",
2390
- "value": "revision 1 · proposed"
1790
+ "value": "revision rev_4 · open"
2391
1791
  }
2392
1792
  ]
2393
1793
  },
@@ -2397,22 +1797,22 @@
2397
1797
  "from": "atlas",
2398
1798
  "to": "ledgerly",
2399
1799
  "method": "POST",
2400
- "url": "https://ledgerly.example/poppy/conversations/cnv_1/messages?cursor=evt_20&wait=0",
1800
+ "url": "https://ledgerly.example/poppy/conversations/cnv_1/messages?cursor=evt_16&wait=0",
2401
1801
  "status": 202,
2402
1802
  "request": {
2403
1803
  "headers": {
2404
1804
  "content-type": "application/json",
2405
1805
  "accept": "*/*",
2406
- "authorization": "DPoP ‹session token›",
2407
- "dpop": "‹DPoP proof›"
1806
+ "authorization": "Bearer ‹access token›",
1807
+ "poppy-session": "‹Session JWT›"
2408
1808
  },
2409
1809
  "body": {
2410
1810
  "message": {
2411
- "id": "msg_13",
1811
+ "id": "msg_11",
2412
1812
  "author": {
2413
1813
  "type": "human"
2414
1814
  },
2415
- "text": "Pay INV-0044"
1815
+ "text": "Pay INV-0043"
2416
1816
  }
2417
1817
  }
2418
1818
  },
@@ -2424,69 +1824,64 @@
2424
1824
  "conversation_id": "cnv_1",
2425
1825
  "events": [
2426
1826
  {
2427
- "id": "evt_25",
1827
+ "id": "evt_21",
2428
1828
  "created_at": "2026-10-11T09:00:10Z",
2429
1829
  "type": "message",
2430
1830
  "message": {
2431
- "id": "msg_13",
1831
+ "id": "msg_11",
2432
1832
  "author": {
2433
1833
  "type": "human"
2434
1834
  },
2435
- "text": "Pay INV-0044",
1835
+ "text": "Pay INV-0043",
2436
1836
  "role": "user"
2437
1837
  }
2438
1838
  },
2439
1839
  {
2440
- "id": "evt_26",
1840
+ "id": "evt_22",
2441
1841
  "created_at": "2026-10-11T09:00:10Z",
2442
1842
  "type": "state",
2443
1843
  "status": "working",
2444
1844
  "responder": "agent"
2445
1845
  },
2446
1846
  {
2447
- "id": "evt_27",
1847
+ "id": "evt_23",
2448
1848
  "created_at": "2026-10-11T09:00:10Z",
2449
1849
  "type": "message",
2450
1850
  "message": {
2451
- "id": "msg_14",
1851
+ "id": "msg_12",
2452
1852
  "author": {
2453
1853
  "type": "agent"
2454
1854
  },
2455
1855
  "role": "company",
2456
- "text": "Northwind Bank proposes this payment; it needs your approval.",
1856
+ "text": "Northwind Bank asks approval for this payment.",
2457
1857
  "operation": {
2458
- "operation_id": "op_5",
2459
- "revision": 1,
2460
- "state": "proposed",
2461
- "summary": "At Northwind Bank: Pay EUR 3400.00 to Acme GmbH for INV-0044 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1858
+ "operation_id": "op_3",
1859
+ "revision": "rev_3",
1860
+ "summary": "At Northwind Bank: Pay EUR 980.00 to Acme GmbH for INV-0043 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
2462
1861
  "terms": {
2463
- "northwind_operation_id": "op_6",
2464
- "northwind_revision": 1,
1862
+ "northwind_operation_id": "op_4",
1863
+ "northwind_revision": "rev_4",
2465
1864
  "amount": {
2466
- "amount": "3400.00",
1865
+ "amount": "980.00",
2467
1866
  "currency": "EUR"
2468
1867
  },
2469
1868
  "payee": "Acme GmbH",
2470
- "reference": "INV-0044",
1869
+ "reference": "INV-0043",
2471
1870
  "from_account": "DE89 3704 0044 0532 0130 00"
2472
1871
  },
2473
- "expires_at": "2026-10-11T09:15:10Z",
2474
- "user_approval_required": true,
2475
- "url": "https://ledgerly.example/operations/op_5",
2476
- "confirmation": null,
2477
- "result": null
1872
+ "expires_at": "2026-10-11T09:15:10Z"
2478
1873
  }
2479
1874
  }
2480
1875
  },
2481
1876
  {
2482
- "id": "evt_28",
1877
+ "id": "evt_24",
2483
1878
  "created_at": "2026-10-11T09:00:10Z",
2484
1879
  "type": "state",
2485
1880
  "status": "idle",
2486
1881
  "responder": "agent"
2487
1882
  }
2488
1883
  ],
2489
- "cursor": "evt_28",
1884
+ "cursor": "evt_24",
2490
1885
  "has_more": false,
2491
1886
  "status": "idle",
2492
1887
  "responder": "agent"
@@ -2504,16 +1899,16 @@
2504
1899
  "headers": {
2505
1900
  "content-type": "application/json",
2506
1901
  "accept": "*/*",
2507
- "authorization": "DPoP ‹session token›",
2508
- "dpop": "‹DPoP proof›"
1902
+ "authorization": "Bearer ‹access token›",
1903
+ "poppy-session": "‹Session JWT›"
2509
1904
  },
2510
1905
  "body": {
2511
1906
  "message": {
2512
- "id": "msg_15",
1907
+ "id": "msg_13",
2513
1908
  "author": {
2514
1909
  "type": "agent"
2515
1910
  },
2516
- "text": "Pay INV-0044: EUR 3400.00 to Acme GmbH"
1911
+ "text": "Pay INV-0043: EUR 980.00 to Acme GmbH"
2517
1912
  }
2518
1913
  }
2519
1914
  },
@@ -2522,70 +1917,65 @@
2522
1917
  "content-type": "application/json"
2523
1918
  },
2524
1919
  "body": {
2525
- "conversation_id": "cnv_4",
1920
+ "conversation_id": "cnv_3",
2526
1921
  "events": [
2527
1922
  {
2528
- "id": "evt_29",
1923
+ "id": "evt_25",
2529
1924
  "created_at": "2026-10-11T09:00:10Z",
2530
1925
  "type": "message",
2531
1926
  "message": {
2532
- "id": "msg_15",
1927
+ "id": "msg_13",
2533
1928
  "author": {
2534
1929
  "type": "agent"
2535
1930
  },
2536
- "text": "Pay INV-0044: EUR 3400.00 to Acme GmbH",
1931
+ "text": "Pay INV-0043: EUR 980.00 to Acme GmbH",
2537
1932
  "role": "user"
2538
1933
  }
2539
1934
  },
2540
1935
  {
2541
- "id": "evt_30",
1936
+ "id": "evt_26",
2542
1937
  "created_at": "2026-10-11T09:00:10Z",
2543
1938
  "type": "state",
2544
1939
  "status": "working",
2545
1940
  "responder": "agent"
2546
1941
  },
2547
1942
  {
2548
- "id": "evt_31",
1943
+ "id": "evt_27",
2549
1944
  "created_at": "2026-10-11T09:00:10Z",
2550
1945
  "type": "message",
2551
1946
  "message": {
2552
- "id": "msg_16",
1947
+ "id": "msg_14",
2553
1948
  "author": {
2554
1949
  "type": "agent"
2555
1950
  },
2556
1951
  "role": "company",
2557
- "text": "Ready to pay INV-0044.",
1952
+ "text": "Ready to pay INV-0043.",
2558
1953
  "operation": {
2559
- "operation_id": "op_6",
2560
- "revision": 1,
2561
- "state": "proposed",
2562
- "summary": "Pay EUR 3400.00 to Acme GmbH for INV-0044 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
1954
+ "operation_id": "op_4",
1955
+ "revision": "rev_4",
1956
+ "summary": "Pay EUR 980.00 to Acme GmbH for INV-0043 from the current account DE89 3704 0044 0532 0130 00, today. Payments cannot be recalled once sent.",
2563
1957
  "terms": {
2564
1958
  "amount": {
2565
- "amount": "3400.00",
1959
+ "amount": "980.00",
2566
1960
  "currency": "EUR"
2567
1961
  },
2568
1962
  "payee": "Acme GmbH",
2569
- "reference": "INV-0044",
1963
+ "reference": "INV-0043",
2570
1964
  "from_account": "DE89 3704 0044 0532 0130 00"
2571
1965
  },
2572
- "expires_at": "2026-10-11T09:15:10Z",
2573
- "user_approval_required": false,
2574
- "url": "https://northwind.example/operations/op_6",
2575
- "confirmation": null,
2576
- "result": null
1966
+ "expires_at": "2026-10-11T09:15:10Z"
2577
1967
  }
2578
1968
  }
2579
1969
  },
2580
1970
  {
2581
- "id": "evt_32",
1971
+ "id": "evt_28",
2582
1972
  "created_at": "2026-10-11T09:00:10Z",
2583
1973
  "type": "state",
2584
1974
  "status": "idle",
2585
1975
  "responder": "agent"
2586
1976
  }
2587
1977
  ],
2588
- "cursor": "evt_32",
1978
+ "cursor": "evt_28",
2589
1979
  "has_more": false,
2590
1980
  "status": "idle",
2591
1981
  "responder": "agent"