@plurnk/plurnk-contracts 6.0.1 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/.env.defaults +5 -5
  2. package/README.md +4 -4
  3. package/SPEC.md +158 -2054
  4. package/dist/schema/{AguiDiscovery.json → AcpDiscovery.json} +4 -4
  5. package/dist/schema/ApplicationOperationEvent.json +2 -2
  6. package/dist/schema/CapabilityDescriptor.json +3 -3
  7. package/dist/schema/CapabilityPolicy.json +5 -1
  8. package/dist/schema/CapabilitySelector.json +3 -3
  9. package/dist/schema/ClientInteractionProjection.json +2 -2
  10. package/dist/schema/ClientInteractionRequest.json +26 -10
  11. package/dist/schema/ClientInteractionResolution.json +14 -6
  12. package/dist/schema/FunctionalityDefinitionState.json +3 -3
  13. package/dist/schema/FunctionalityDiscoverQuery.json +2 -1
  14. package/dist/schema/FunctionalityMutationResult.json +1 -1
  15. package/dist/schema/MatcherBody.json +2 -2
  16. package/dist/schema/McpServerDefinition.json +35 -9
  17. package/dist/schema/ModelCatalogPage.json +1 -1
  18. package/dist/schema/ModelRoute.json +2 -2
  19. package/dist/schema/Notice.json +1 -1
  20. package/dist/schema/PlurnkStatement.json +8 -8
  21. package/dist/schema/ProposalDisposition.json +1 -1
  22. package/dist/schema/ProposalPolicy.json +1 -1
  23. package/dist/schema/ProposalProjection.json +57 -6
  24. package/dist/schema/ResourceSelection.json +1 -1
  25. package/dist/schema/RollbackReport.json +1 -1
  26. package/dist/schema/{WorkerOwner.json → SessionOwner.json} +2 -2
  27. package/dist/schema/SkillDefinition.json +8 -7
  28. package/dist/src/Application.d.ts +97 -66
  29. package/dist/src/Application.d.ts.map +1 -1
  30. package/dist/src/Application.js +198 -1
  31. package/dist/src/Application.js.map +1 -1
  32. package/dist/src/ApplicationNotifications.d.ts +52 -0
  33. package/dist/src/ApplicationNotifications.d.ts.map +1 -0
  34. package/dist/src/ApplicationNotifications.js +2 -0
  35. package/dist/src/ApplicationNotifications.js.map +1 -0
  36. package/dist/src/ApplicationPort.d.ts +84 -75
  37. package/dist/src/ApplicationPort.d.ts.map +1 -1
  38. package/dist/src/ApplicationStream.d.ts +4 -4
  39. package/dist/src/ApplicationStream.d.ts.map +1 -1
  40. package/dist/src/CapabilityAdmission.d.ts +2 -0
  41. package/dist/src/CapabilityAdmission.d.ts.map +1 -1
  42. package/dist/src/CapabilityAdmission.js +14 -2
  43. package/dist/src/CapabilityAdmission.js.map +1 -1
  44. package/dist/src/Excerpt.js +1 -1
  45. package/dist/src/Excerpt.js.map +1 -1
  46. package/dist/src/Functionality.d.ts +3 -6
  47. package/dist/src/Functionality.d.ts.map +1 -1
  48. package/dist/src/HttpOrigin.d.ts +3 -3
  49. package/dist/src/HttpOrigin.js +1 -1
  50. package/dist/src/JsonDocument.js +1 -1
  51. package/dist/src/JsonDocument.js.map +1 -1
  52. package/dist/src/JsonResult.js +1 -1
  53. package/dist/src/JsonResult.js.map +1 -1
  54. package/dist/src/LogRow.d.ts +31 -0
  55. package/dist/src/LogRow.d.ts.map +1 -0
  56. package/dist/src/LogRow.js +46 -0
  57. package/dist/src/LogRow.js.map +1 -0
  58. package/dist/src/LoopLifecycle.d.ts +1 -1
  59. package/dist/src/LoopLifecycle.d.ts.map +1 -1
  60. package/dist/src/LoopLifecycle.js +2 -2
  61. package/dist/src/LoopLifecycle.js.map +1 -1
  62. package/dist/src/MessageResource.d.ts +4 -4
  63. package/dist/src/MessageResource.d.ts.map +1 -1
  64. package/dist/src/PathSyntax.js +2 -2
  65. package/dist/src/PathSyntax.js.map +1 -1
  66. package/dist/src/PlurnkParseError.js +1 -1
  67. package/dist/src/PlurnkParseError.js.map +1 -1
  68. package/dist/src/Problems.js +1 -1
  69. package/dist/src/Problems.js.map +1 -1
  70. package/dist/src/TurnDisposition.js +1 -1
  71. package/dist/src/TurnDisposition.js.map +1 -1
  72. package/dist/src/Validator.d.ts +5 -108
  73. package/dist/src/Validator.d.ts.map +1 -1
  74. package/dist/src/Validator.js +97 -518
  75. package/dist/src/Validator.js.map +1 -1
  76. package/dist/src/guards.js +1 -1
  77. package/dist/src/guards.js.map +1 -1
  78. package/dist/src/index.d.ts +6 -5
  79. package/dist/src/index.d.ts.map +1 -1
  80. package/dist/src/index.js +7 -5
  81. package/dist/src/index.js.map +1 -1
  82. package/dist/src/types.d.ts +1 -1
  83. package/dist/src/types.d.ts.map +1 -1
  84. package/dist/src/types.generated.d.ts +91 -187
  85. package/dist/src/types.generated.d.ts.map +1 -1
  86. package/dist/src/types.js +7 -7
  87. package/dist/src/types.js.map +1 -1
  88. package/package.json +5 -9
  89. package/plurnk.md +16 -16
  90. package/dist/conformance/agui-v1.json +0 -716
  91. package/dist/schema/A2aAgentDefinition.json +0 -76
  92. package/dist/schema/AguiClientConformance.json +0 -74
  93. package/dist/schema/AguiConformanceKit.json +0 -111
  94. package/dist/src/AguiConformance.d.ts +0 -11
  95. package/dist/src/AguiConformance.d.ts.map +0 -1
  96. package/dist/src/AguiConformance.js +0 -16
  97. package/dist/src/AguiConformance.js.map +0 -1
package/.env.defaults CHANGED
@@ -7,8 +7,8 @@ PLURNK_HOST=127.0.0.1
7
7
  # The daemon's TCP port, shared by all client interfaces.
8
8
  PLURNK_PORT=1066
9
9
  # The whole URL a client dials instead: a remote portal, or a daemon bound to an address no
10
- # client can dial (0.0.0.0). Unset = http://$PLURNK_HOST:$PLURNK_PORT/agui.
11
- # PLURNK_AGUI_URL=
10
+ # client can dial (0.0.0.0). Unset = http://$PLURNK_HOST:$PLURNK_PORT/acp.
11
+ # PLURNK_ACP_URL=
12
12
 
13
13
  # Whether the daemon authenticates ({§credential-authority}): 1 = every request to the client
14
14
  # interface and to the hosted agent presents a credential this daemon issued, and the daemon serves
@@ -16,13 +16,13 @@ PLURNK_PORT=1066
16
16
  # anonymous, for a harness driving a daemon of its own. The posture is this value, never inferred
17
17
  # from what else is set.
18
18
  PLURNK_AUTH=1
19
- # The operator's client secret ({§agui-oauth-clients}): what the terminal client and every other
19
+ # The operator's client secret ({§auth-oauth-clients}): what the terminal client and every other
20
20
  # tool of yours exchanges for access tokens. Unset, the daemon mints one at every boot into the
21
21
  # file `secret` beside its database (0600), where a tool running as you reads it. Set it here, and
22
22
  # the same value in the tool's environment, for a tool on another host or under another user.
23
23
  # PLURNK_SECRET=
24
- # The operator's browser sign-in ({§agui-oauth-login}): the password a browser signs in with,
24
+ # The operator's browser sign-in ({§auth-oauth-clients}): the password a browser signs in with,
25
25
  # compared in constant time at the authorization endpoint. No browser is the operator without it:
26
26
  # while it is empty, the sign-in page says so and where to set it, and admits nobody
27
- # ({§agui-oauth-session}). The terminal client and your other tools use PLURNK_SECRET instead.
27
+ # ({§auth-oauth-clients}). The terminal client and your other tools use PLURNK_SECRET instead.
28
28
  PLURNK_PASS=
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  The single authority for PLURNK's model-facing language contract, its AST,
4
4
  shared schemas and types, runtime-neutral Problems, operation results,
5
- Notices, and text coordinates. See SPEC {§root-value-api}.
5
+ Notices, and text coordinates. See SPEC {§whitespace-contract}.
6
6
 
7
7
  ## Install
8
8
 
@@ -18,7 +18,7 @@ Requires Node.js 26 or newer.
18
18
  |---------------------------------|------------------------------------------------------|
19
19
  | Concise model language teaching | [`plurnk.md`](plurnk.md) |
20
20
  | Stable behavioral contract | [`SPEC.md`](SPEC.md) |
21
- | Accepted language syntax | `SPEC.md` ({§canonical-statement}); implemented by `@plurnk/plurnk-parser` |
21
+ | Accepted language syntax | `SPEC.md` ({§operation-fences}); implemented by `@plurnk/plurnk-parser` |
22
22
  | Shared wire shapes | `schema/*.json` |
23
23
  | JavaScript and TypeScript API | `@plurnk/plurnk-contracts` |
24
24
  | Published JSON Schemas | `@plurnk/plurnk-contracts/schema/*.json` |
@@ -51,10 +51,10 @@ Validator.assertOperationResult(result);
51
51
  ```
52
52
 
53
53
  Generated wire types, constructors, and validators share the package root entry
54
- point described by SPEC {§wire-entrypoint}. Owning JSON Schemas use the published
54
+ point described by SPEC {§text-region}. Owning JSON Schemas use the published
55
55
  `@plurnk/plurnk-contracts/schema/*.json` subpaths. The root is runtime-neutral, so
56
56
  a browser type-checks it without Node; the application port that modules consume,
57
- which names Node's HTTP types, is `@plurnk/plurnk-contracts/port` ({§runtime-neutral-root}).
57
+ which names Node's HTTP types, is `@plurnk/plurnk-contracts/port` ({§whitespace-contract}).
58
58
 
59
59
  ## Development
60
60