@plurnk/plurnk-service 1.19.3 → 1.21.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 (124) hide show
  1. package/.env.defaults +8 -5
  2. package/INSTALL.md +3 -2
  3. package/SPEC.md +221 -122
  4. package/dist/build-info.json +1 -1
  5. package/dist/content/line-anchors.d.ts.map +1 -1
  6. package/dist/content/line-anchors.js +5 -1
  7. package/dist/content/line-anchors.js.map +1 -1
  8. package/dist/core/AdmittedTurnExecutor.d.ts +2 -2
  9. package/dist/core/AdmittedTurnExecutor.d.ts.map +1 -1
  10. package/dist/core/AdmittedTurnExecutor.js +32 -27
  11. package/dist/core/AdmittedTurnExecutor.js.map +1 -1
  12. package/dist/core/BareBatchRunner.d.ts +6 -1
  13. package/dist/core/BareBatchRunner.d.ts.map +1 -1
  14. package/dist/core/BareBatchRunner.js +105 -50
  15. package/dist/core/BareBatchRunner.js.map +1 -1
  16. package/dist/core/BudgetReadout.d.ts +1 -1
  17. package/dist/core/BudgetReadout.d.ts.map +1 -1
  18. package/dist/core/BudgetReadout.js +4 -7
  19. package/dist/core/BudgetReadout.js.map +1 -1
  20. package/dist/core/Dispatcher.d.ts +2 -2
  21. package/dist/core/Dispatcher.d.ts.map +1 -1
  22. package/dist/core/Dispatcher.js +24 -58
  23. package/dist/core/Dispatcher.js.map +1 -1
  24. package/dist/core/Dispatcher.sql +7 -0
  25. package/dist/core/Engine.d.ts +1 -0
  26. package/dist/core/Engine.d.ts.map +1 -1
  27. package/dist/core/Engine.js.map +1 -1
  28. package/dist/core/KnownToxins.d.ts +5 -0
  29. package/dist/core/KnownToxins.d.ts.map +1 -0
  30. package/dist/core/KnownToxins.js +31 -0
  31. package/dist/core/KnownToxins.js.map +1 -0
  32. package/dist/core/LogBody.js +2 -2
  33. package/dist/core/LogBody.js.map +1 -1
  34. package/dist/core/LogEntryProjection.d.ts.map +1 -1
  35. package/dist/core/LogEntryProjection.js +0 -4
  36. package/dist/core/LogEntryProjection.js.map +1 -1
  37. package/dist/core/LoopDriver.d.ts.map +1 -1
  38. package/dist/core/LoopDriver.js +27 -7
  39. package/dist/core/LoopDriver.js.map +1 -1
  40. package/dist/core/LoopLifecycle.d.ts +5 -0
  41. package/dist/core/LoopLifecycle.d.ts.map +1 -1
  42. package/dist/core/LoopLifecycle.js +10 -0
  43. package/dist/core/LoopLifecycle.js.map +1 -1
  44. package/dist/core/LoopLifecycle.sql +36 -0
  45. package/dist/core/PacketBuilder.d.ts +1 -0
  46. package/dist/core/PacketBuilder.d.ts.map +1 -1
  47. package/dist/core/PacketBuilder.js +9 -11
  48. package/dist/core/PacketBuilder.js.map +1 -1
  49. package/dist/core/PacketBuilder.sql +5 -0
  50. package/dist/core/ProviderRecovery.d.ts +9 -0
  51. package/dist/core/ProviderRecovery.d.ts.map +1 -0
  52. package/dist/core/ProviderRecovery.js +22 -0
  53. package/dist/core/ProviderRecovery.js.map +1 -0
  54. package/dist/core/ReasoningView.d.ts +5 -1
  55. package/dist/core/ReasoningView.d.ts.map +1 -1
  56. package/dist/core/ReasoningView.js +9 -4
  57. package/dist/core/ReasoningView.js.map +1 -1
  58. package/dist/core/ServiceTeardown.d.ts +1 -1
  59. package/dist/core/ServiceTeardown.d.ts.map +1 -1
  60. package/dist/core/ServiceTeardown.js +4 -2
  61. package/dist/core/ServiceTeardown.js.map +1 -1
  62. package/dist/core/StrikeRail.d.ts +3 -0
  63. package/dist/core/StrikeRail.d.ts.map +1 -1
  64. package/dist/core/StrikeRail.js +16 -1
  65. package/dist/core/StrikeRail.js.map +1 -1
  66. package/dist/core/TurnDispositionHandler.d.ts +3 -2
  67. package/dist/core/TurnDispositionHandler.d.ts.map +1 -1
  68. package/dist/core/TurnDispositionHandler.js +48 -15
  69. package/dist/core/TurnDispositionHandler.js.map +1 -1
  70. package/dist/core/TurnMaterialization.d.ts.map +1 -1
  71. package/dist/core/TurnMaterialization.js +7 -1
  72. package/dist/core/TurnMaterialization.js.map +1 -1
  73. package/dist/core/TurnOps.d.ts.map +1 -1
  74. package/dist/core/TurnOps.js +4 -0
  75. package/dist/core/TurnOps.js.map +1 -1
  76. package/dist/core/TurnRunner.d.ts +0 -4
  77. package/dist/core/TurnRunner.d.ts.map +1 -1
  78. package/dist/core/TurnRunner.js +76 -101
  79. package/dist/core/TurnRunner.js.map +1 -1
  80. package/dist/core/TurnSources.sql +1 -1
  81. package/dist/core/ambient.sql +2 -2
  82. package/dist/core/packet-wire.d.ts.map +1 -1
  83. package/dist/core/packet-wire.js +67 -47
  84. package/dist/core/packet-wire.js.map +1 -1
  85. package/dist/core/results.d.ts +1 -0
  86. package/dist/core/results.d.ts.map +1 -1
  87. package/dist/core/results.js +7 -0
  88. package/dist/core/results.js.map +1 -1
  89. package/dist/core/turn-scheduler.js +1 -1
  90. package/dist/core/turn-scheduler.js.map +1 -1
  91. package/dist/core/turn-signals.d.ts +5 -0
  92. package/dist/core/turn-signals.d.ts.map +1 -1
  93. package/dist/core/turn-signals.js +6 -0
  94. package/dist/core/turn-signals.js.map +1 -1
  95. package/dist/core/unconcluded-emission.d.ts +7 -0
  96. package/dist/core/unconcluded-emission.d.ts.map +1 -0
  97. package/dist/core/unconcluded-emission.js +11 -0
  98. package/dist/core/unconcluded-emission.js.map +1 -0
  99. package/dist/core/unconcluded-emission.sql +14 -0
  100. package/dist/digest/DigestRender.d.ts +1 -0
  101. package/dist/digest/DigestRender.d.ts.map +1 -1
  102. package/dist/digest/DigestRender.js +18 -1
  103. package/dist/digest/DigestRender.js.map +1 -1
  104. package/dist/schemes/Log.d.ts.map +1 -1
  105. package/dist/schemes/Log.js +1 -0
  106. package/dist/schemes/Log.js.map +1 -1
  107. package/dist/server/Functionality.d.ts +1 -0
  108. package/dist/server/Functionality.d.ts.map +1 -1
  109. package/dist/server/Functionality.js +7 -4
  110. package/dist/server/Functionality.js.map +1 -1
  111. package/dist/server/Retention.d.ts.map +1 -1
  112. package/dist/server/Retention.js +2 -0
  113. package/dist/server/Retention.js.map +1 -1
  114. package/dist/server/Retention.sql +5 -0
  115. package/dist/server/logEntry.sql +2 -2
  116. package/dist/service.d.ts.map +1 -1
  117. package/dist/service.js +4 -1
  118. package/dist/service.js.map +1 -1
  119. package/docs/copy-move.md +6 -6
  120. package/docs/env.md +9 -14
  121. package/docs/members.md +28 -23
  122. package/docs/skills.md +22 -22
  123. package/migrations/006_log.sql +10 -4
  124. package/package.json +162 -163
package/.env.defaults CHANGED
@@ -75,7 +75,7 @@ PLURNK_SERVICE_LOOP_TIMEOUT=86400000
75
75
  PLURNK_SERVICE_LIVE_TIMEOUT=600000
76
76
  # Shutdown settlement deadline, positive ms; abandon outstanding waits after expiry.
77
77
  PLURNK_SERVICE_STOP_TIMEOUT_MS=30000
78
- # Provider recovery window, ms; 0 = park immediately. Expiry parks until the next prompt/wake.
78
+ # Provider recovery window, ms; 0 = park immediately. Expiry parks until the next prompt/wake. Loop and BARE calls alike.
79
79
  PLURNK_SERVICE_PROVIDER_RECOVERY=900000
80
80
  # First recovery delay, ms; doubles on failure, capped at 12 times this value.
81
81
  PLURNK_SERVICE_PROVIDER_RECOVERY_BACKOFF=5000
@@ -145,6 +145,8 @@ PLURNK_SERVICE_PREVIEW_CHARS=16000
145
145
  # Turn0 reasoning READ: -1 = complete; 0 = omit; N = first N lines. Later reads are model-chosen.
146
146
  # Alias override: PLURNK_REASONING_VIEW_LINES_<alias>. Source retention/streaming are unchanged.
147
147
  PLURNK_REASONING_VIEW_LINES=-1
148
+ # After a turn with no operation, its reasoning is read back: same scale, same alias override.
149
+ PLURNK_REASONING_EMPTY_TURN_LINES=-1
148
150
  # Cold-start input allowance reserved for automatic prompt bodies, percentage in (0,100).
149
151
  # Alias override: PLURNK_SERVICE_PROMPT_PROJECTION_<alias>. Full prompts remain addressable.
150
152
  PLURNK_SERVICE_PROMPT_PROJECTION=25%
@@ -217,13 +219,14 @@ PLURNK_SERVICE_REQUIEM_RETRY_MAX_TOKENS=32768
217
219
  # --- Retention: information is kept; transient data is collected ({§retention-policy}) ---
218
220
  # Packet compositions kept per loop, newest first; -1 = every packet, forever.
219
221
  PLURNK_SERVICE_RETAIN_PACKET_TURNS=-1
220
- # Packet compositions kept by age, ms since the turn completed; -1 = no age limit.
221
- PLURNK_SERVICE_RETAIN_PACKET_MS=-1
222
+ # Packet compositions kept by age, ms since the turn completed; -1 = no age limit. Thirty days:
223
+ # no session reads its own packets back that late, and a daemon left running for months stops growing.
224
+ PLURNK_SERVICE_RETAIN_PACKET_MS=2592000000
222
225
  # Model response bodies kept per loop, newest first; -1 = every body, forever. The call's
223
226
  # evidence, admission and accounting always stay.
224
227
  PLURNK_SERVICE_RETAIN_RESPONSE_TURNS=-1
225
- # Model response bodies kept by age, ms since the turn completed; -1 = no age limit.
226
- PLURNK_SERVICE_RETAIN_RESPONSE_MS=-1
228
+ # Model response bodies kept by age, ms since the turn completed; -1 = no age limit. Thirty days, as above.
229
+ PLURNK_SERVICE_RETAIN_RESPONSE_MS=2592000000
227
230
  # Collect packet items no turn's composition references (1), or keep them (0).
228
231
  PLURNK_SERVICE_COLLECT_PACKET_ITEMS=1
229
232
  # Collect derivations no channel, turn source, or log row cites (1), or keep them (0).
package/INSTALL.md CHANGED
@@ -62,8 +62,9 @@ the owning declaration specifies its meaning.
62
62
  | File creation and membership | Separate policies. Creating an out-of-root file, admitting a new file, and editing an existing member are distinct decisions. |
63
63
  | User-facing behavior | Operating policy; use configuration for runtime controls. |
64
64
 
65
- The [model chapter](skill://plurnk/references/models.md) covers alias tuning,
66
- reasoning and output budgets, local endpoints, caching, and connectivity.
65
+ The `@plurnk/plurnk-providers` README covers alias tuning, reasoning and output
66
+ budgets, local endpoints, caching, and connectivity; the
67
+ [model chapter](skill://plurnk/references/models.md) is what a model is told.
67
68
  The defaults catalog groups the remaining settings by their owning subsystem:
68
69
  permissions, loop limits, residency, execution, context, indexing, MCP, A2A,
69
70
  hooks, HTTP, and content handling. Search the catalog for that subsystem instead