@powerhousedao/switchboard 6.2.3-dev.9 → 6.2.3

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 (108) hide show
  1. package/.tsbuild/test/attachments/byte-grants.test.d.ts +2 -0
  2. package/.tsbuild/test/attachments/byte-grants.test.d.ts.map +1 -0
  3. package/.tsbuild/test/attachments/byte-routes-read-gate.integration.test.d.ts +2 -0
  4. package/.tsbuild/test/attachments/byte-routes-read-gate.integration.test.d.ts.map +1 -0
  5. package/.tsbuild/test/attachments/url-signer.test.d.ts +2 -0
  6. package/.tsbuild/test/attachments/url-signer.test.d.ts.map +1 -0
  7. package/.tsbuild/test/boot-create-signature-policy.test.d.ts +2 -0
  8. package/.tsbuild/test/boot-create-signature-policy.test.d.ts.map +1 -0
  9. package/.tsbuild/test/boot-mcp-enabled.test.d.ts +2 -0
  10. package/.tsbuild/test/boot-mcp-enabled.test.d.ts.map +1 -0
  11. package/.tsbuild/test/boot-unsupported-stored-documents.test.d.ts +2 -0
  12. package/.tsbuild/test/boot-unsupported-stored-documents.test.d.ts.map +1 -0
  13. package/.tsbuild/test/boot-without-renown.test.d.ts +2 -0
  14. package/.tsbuild/test/boot-without-renown.test.d.ts.map +1 -0
  15. package/.tsbuild/test/boot-without-require-signatures.test.d.ts +2 -0
  16. package/.tsbuild/test/boot-without-require-signatures.test.d.ts.map +1 -0
  17. package/.tsbuild/test/boot-worker-trust-policy.test.d.ts +2 -0
  18. package/.tsbuild/test/boot-worker-trust-policy.test.d.ts.map +1 -0
  19. package/.tsbuild/test/builder-defaults.test.d.ts +2 -0
  20. package/.tsbuild/test/builder-defaults.test.d.ts.map +1 -0
  21. package/.tsbuild/test/create-signature-policy.test.d.ts +2 -0
  22. package/.tsbuild/test/create-signature-policy.test.d.ts.map +1 -0
  23. package/.tsbuild/test/fatal-shutdown.test.d.ts +2 -0
  24. package/.tsbuild/test/fatal-shutdown.test.d.ts.map +1 -0
  25. package/.tsbuild/test/mcp-flag.test.d.ts +2 -0
  26. package/.tsbuild/test/mcp-flag.test.d.ts.map +1 -0
  27. package/.tsbuild/test/renown-trust-policy.test.d.ts +2 -0
  28. package/.tsbuild/test/renown-trust-policy.test.d.ts.map +1 -0
  29. package/.tsbuild/test/unsupported-stored-documents.test.d.ts +2 -0
  30. package/.tsbuild/test/unsupported-stored-documents.test.d.ts.map +1 -0
  31. package/.tsbuild/test/workflow/harness.d.ts +56 -0
  32. package/.tsbuild/test/workflow/harness.d.ts.map +1 -0
  33. package/.tsbuild/test/workflow/oauth.test.d.ts +2 -0
  34. package/.tsbuild/test/workflow/oauth.test.d.ts.map +1 -0
  35. package/.tsbuild/test/workflow/resolvers.test.d.ts +2 -0
  36. package/.tsbuild/test/workflow/resolvers.test.d.ts.map +1 -0
  37. package/.tsbuild/test/workflow/webhook-dedupe.test.d.ts +2 -0
  38. package/.tsbuild/test/workflow/webhook-dedupe.test.d.ts.map +1 -0
  39. package/.tsbuild/test/workflow/webhook-signed.test.d.ts +2 -0
  40. package/.tsbuild/test/workflow/webhook-signed.test.d.ts.map +1 -0
  41. package/.tsbuild/test/workflow/webhook-trigger-test.test.d.ts +2 -0
  42. package/.tsbuild/test/workflow/webhook-trigger-test.test.d.ts.map +1 -0
  43. package/.tsbuild/test/workflow/webhook-unsigned.test.d.ts +2 -0
  44. package/.tsbuild/test/workflow/webhook-unsigned.test.d.ts.map +1 -0
  45. package/.tsbuild/test/workflow-read-gate.test.d.ts +2 -0
  46. package/.tsbuild/test/workflow-read-gate.test.d.ts.map +1 -0
  47. package/.tsbuild/test/workflow-runtime.test.d.ts +2 -0
  48. package/.tsbuild/test/workflow-runtime.test.d.ts.map +1 -0
  49. package/.tsbuild/tsconfig.tsbuildinfo +1 -1
  50. package/.tsbuild/tsdown.config.d.ts.map +1 -1
  51. package/.tsbuild/vitest.config.d.ts.map +1 -1
  52. package/Auth.md +94 -0
  53. package/CHANGELOG.md +302 -0
  54. package/README.md +35 -0
  55. package/dist/index.d.mts +2 -1
  56. package/dist/index.mjs +10 -8
  57. package/dist/index.mjs.map +1 -1
  58. package/dist/install-packages.d.mts +2 -1
  59. package/dist/install-packages.mjs +2 -2
  60. package/dist/install-packages.mjs.map +1 -1
  61. package/dist/migrate.d.mts +2 -1
  62. package/dist/migrate.mjs +4 -3
  63. package/dist/migrate.mjs.map +1 -1
  64. package/dist/{server-CiKkVE6g.mjs → server-sQoWp21G.mjs} +1454 -70
  65. package/dist/server-sQoWp21G.mjs.map +1 -0
  66. package/dist/server.d.mts +103 -29
  67. package/dist/server.d.mts.map +1 -1
  68. package/dist/server.mjs +4 -5
  69. package/dist/{utils-Baw7rThP.mjs → utils-uaBlzyjS.mjs} +15 -9
  70. package/dist/utils-uaBlzyjS.mjs.map +1 -0
  71. package/dist/utils.d.mts +4 -5
  72. package/dist/utils.d.mts.map +1 -1
  73. package/dist/utils.mjs +3 -3
  74. package/package.json +21 -17
  75. package/test/attachments/auth.test.ts +85 -0
  76. package/test/attachments/byte-grants.test.ts +287 -0
  77. package/test/attachments/byte-routes-read-gate.integration.test.ts +314 -0
  78. package/test/attachments/download-target.test.ts +194 -31
  79. package/test/attachments/index.test.ts +34 -3
  80. package/test/attachments/routes-integration.test.ts +59 -4
  81. package/test/attachments/routes.test.ts +165 -23
  82. package/test/attachments/service-config.test.ts +13 -3
  83. package/test/attachments/url-signer.test.ts +105 -0
  84. package/test/boot-create-signature-policy.test.ts +108 -0
  85. package/test/boot-mcp-enabled.test.ts +121 -0
  86. package/test/boot-unsupported-stored-documents.test.ts +210 -0
  87. package/test/boot-without-renown.test.ts +81 -0
  88. package/test/boot-without-require-signatures.test.ts +74 -0
  89. package/test/boot-worker-trust-policy.test.ts +90 -0
  90. package/test/builder-defaults.test.ts +80 -0
  91. package/test/create-signature-policy.test.ts +69 -0
  92. package/test/fatal-shutdown.test.ts +102 -0
  93. package/test/mcp-flag.test.ts +56 -0
  94. package/test/renown-trust-policy.test.ts +315 -0
  95. package/test/unsupported-stored-documents.test.ts +72 -0
  96. package/test/workflow/harness.ts +289 -0
  97. package/test/workflow/oauth.test.ts +214 -0
  98. package/test/workflow/resolvers.test.ts +296 -0
  99. package/test/workflow/webhook-dedupe.test.ts +295 -0
  100. package/test/workflow/webhook-signed.test.ts +509 -0
  101. package/test/workflow/webhook-trigger-test.test.ts +82 -0
  102. package/test/workflow/webhook-unsigned.test.ts +345 -0
  103. package/test/workflow-read-gate.test.ts +145 -0
  104. package/test/workflow-runtime.test.ts +486 -0
  105. package/tsconfig.json +6 -0
  106. package/tsdown.config.ts +3 -1
  107. package/dist/server-CiKkVE6g.mjs.map +0 -1
  108. package/dist/utils-Baw7rThP.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"tsdown.config.d.ts","sourceRoot":"","sources":["../tsdown.config.ts"],"names":[],"mappings":";AAEA,wBAaG"}
1
+ {"version":3,"file":"tsdown.config.d.ts","sourceRoot":"","sources":["../tsdown.config.ts"],"names":[],"mappings":""}
@@ -1 +1 @@
1
- {"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAQG"}
1
+ {"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":""}
package/Auth.md CHANGED
@@ -133,6 +133,57 @@ interface AuthConfig {
133
133
  - **Document Owners**: implicit ADMIN on documents they create
134
134
  - **Per-Document Grants**: READ / WRITE / ADMIN granted to users or groups, inherited from protected ancestors
135
135
 
136
+ #### Attachments
137
+
138
+ An attachment is readable by whoever may read the document that references it.
139
+ `GET /attachments/:hash/download-target` decides that twice over: the caller
140
+ must be able to read the document's `global` scope, and the reference index
141
+ must confirm that the document really does reference this hash. A denial is a
142
+ single generic `404` either way, so it never tells the caller which of the two
143
+ failed.
144
+
145
+ Which model answers the first half is the deployment's choice, and by default it
146
+ is the permission tables above — unchanged.
147
+
148
+ ```bash
149
+ # Decide an attachment read with the referencing document's own policy
150
+ export ATTACHMENT_READS_FOLLOW_DOCUMENT_POLICY=true
151
+ ```
152
+
153
+ With it on, the document's **own policy** decides, evaluated for the caller's
154
+ subject: their address *and* the `did:key` of the app instance whose token
155
+ authenticated them, because a grant can name either and a document's creator is
156
+ recorded by key. It needs a policy model to evaluate, which auth enforcement is
157
+ what supplies, and refuses to boot without one rather than leave the tables
158
+ deciding while the configuration says otherwise.
159
+
160
+ Why a deployment would want it: one whose documents carry policies keeps no rows
161
+ in the permission tables, so asking those tables about such a document returns
162
+ whatever the host-wide policy says — under `OPEN`, `true`, for every caller
163
+ including an anonymous one. Handing out bytes on that answer gives the file to
164
+ anyone who learns its hash, which the document's own state may well have told
165
+ them before their access was taken away.
166
+
167
+ Two things to know before turning it on. A document that carries **no** policy
168
+ stays readable, because an uninitialized policy is not a denial — unless the
169
+ host also sets `DEFAULT_PROTECTION`, which tells the gate to withhold what it
170
+ cannot decide, and then attachments on unpolicied documents are refused along
171
+ with everything else about them. And every non-browser client that downloads
172
+ bytes — an extraction worker, an indexer — needs a read grant of its own on the
173
+ documents it fetches, or it stops working the moment this is enabled.
174
+
175
+ The presigned URL a target carries is short-lived by design: the authorization
176
+ behind it is decided once, when it is issued, and the URL keeps working until it
177
+ expires however the policy changes in between. The default ceiling is **300
178
+ seconds**, and it applies whether or not the caller asked for a lifetime —
179
+ otherwise omitting `expiresIn` would be a way to opt out of it.
180
+
181
+ ```bash
182
+ # Raise it if a deployment genuinely needs longer; still bounded by the
183
+ # 7-day maximum a SigV4 signature can carry.
184
+ export ATTACHMENT_DOWNLOAD_TARGET_MAX_TTL_SECONDS=1800
185
+ ```
186
+
136
187
  ### 6. **Session Management**
137
188
 
138
189
  Advanced session handling with multiple active sessions:
@@ -221,6 +272,49 @@ It requires a caller to be resolvable at all, so it refuses to boot without
221
272
  resolution off, no bearer is ever read and it would reject every caller,
222
273
  including authenticated ones.
223
274
 
275
+ It also covers the attachment routes, which are mounted on the HTTP adapter and
276
+ never pass the GraphQL fetch chain. Their own 401 keys on `AUTH_ENABLED`, so
277
+ without this switch a deployment running `OPEN` serves them to anyone; with it,
278
+ every attachment route refuses a caller it cannot name — `download-target` and
279
+ the `GET`/`HEAD /attachments/:hash` byte routes included, even though they
280
+ decide per document (or by a signed URL) on their own. A filesystem signed
281
+ download URL therefore needs a bearer too while this switch is on.
282
+
283
+ ##### Serving one path anonymously
284
+
285
+ Some products have a flow that runs *before* sign-in: previewing an invitation
286
+ from the code in its e-mail, for instance, so the screen can say who the
287
+ invitation is for. That flow has no caller by definition, and the floor above
288
+ would answer it a `401`.
289
+
290
+ ```bash
291
+ export REQUIRE_AUTHENTICATED_CALLER=true
292
+ export REQUIRE_AUTHENTICATED_CALLER_EXEMPT_PATHS=/graphql/public
293
+ ```
294
+
295
+ Comma-separated, so several paths are one variable:
296
+
297
+ ```bash
298
+ export REQUIRE_AUTHENTICATED_CALLER_EXEMPT_PATHS=/graphql/public,/graphql/invites
299
+ ```
300
+
301
+ Each entry is matched against the request's **pathname, in full** — never as a
302
+ prefix, so `/graphql/public` does not also exempt `/graphql/public-admin`. A
303
+ trailing slash on either side is ignored; a leading slash is required, and a
304
+ path without one is refused at boot rather than left as an exemption that
305
+ silently never applies. Configuring exemptions while the floor is off is
306
+ refused too: it would describe a protection the server is not applying.
307
+
308
+ The exempt paths are named in the boot log, because the one question worth
309
+ asking about this floor is what is still open.
310
+
311
+ Every entry is a hole in it. Only ever name a path that serves operations which
312
+ are safe without a caller, and prefer a route mounted for exactly that purpose
313
+ over exempting one that also serves something else. Note what this switch does
314
+ **not** reach, in either configuration: routes registered directly on the HTTP
315
+ adapter (`/health`, `/ready`, `/explorer`, `/d/:drive`) and package HTTP routes,
316
+ which declare their own `auth` per route.
317
+
224
318
  #### Configuration File Method
225
319
 
226
320
  ```json
package/CHANGELOG.md CHANGED
@@ -1,3 +1,305 @@
1
+ ## 6.2.3 (2026-09-30)
2
+
3
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
4
+
5
+ ## 6.2.3-staging.0 (2026-09-30)
6
+
7
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
8
+
9
+ ## 6.2.3-dev.34 (2026-09-30)
10
+
11
+ ### 🚀 Features
12
+
13
+ - **switchboard:** let MCP_ENABLED=false keep the MCP server unmounted ([#3146](https://github.com/powerhouse-inc/powerhouse/pull/3146))
14
+
15
+ ### ❤️ Thank You
16
+
17
+ - Guillermo Puente Sandoval @gpuente
18
+
19
+ ## 6.2.3-dev.33 (2026-09-30)
20
+
21
+ ### 🚀 Features
22
+
23
+ - **switchboard:** expose the stored-protocol startup check ([de2bf4836](https://github.com/powerhouse-inc/powerhouse/commit/de2bf4836))
24
+ - **reactor:** add catch-up operator tools and observability ([5722d7836](https://github.com/powerhouse-inc/powerhouse/commit/5722d7836))
25
+
26
+ ### 🩹 Fixes
27
+
28
+ - **reactor:** claim a batch for each read model as it queues ([c09b1de2a](https://github.com/powerhouse-inc/powerhouse/commit/c09b1de2a))
29
+ - **reactor:** settle a probe on its own xid, not on an empty xip ([4e0f0dab9](https://github.com/powerhouse-inc/powerhouse/commit/4e0f0dab9))
30
+ - **reactor:** leave a stream to the next sweep while its live pass runs ([53112bad4](https://github.com/powerhouse-inc/powerhouse/commit/53112bad4))
31
+ - **reactor:** start a head registration at the sequence head ([e06581849](https://github.com/powerhouse-inc/powerhouse/commit/e06581849))
32
+ - **switchboard:** resolve packages it brings from its own dependencies in dev ([7c9c55d98](https://github.com/powerhouse-inc/powerhouse/commit/7c9c55d98))
33
+
34
+ ### ❤️ Thank You
35
+
36
+ - acaldas
37
+ - Benjamin Jordan
38
+ - Claude Opus 5.5
39
+
40
+ ## 6.2.3-dev.32 (2026-09-29)
41
+
42
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
43
+
44
+ ## 6.2.3-dev.31 (2026-09-29)
45
+
46
+ ### 🚀 Features
47
+
48
+ - **ph-cli:** seed a Workflows drive in vetra when workflows are on ([6e855808e](https://github.com/powerhouse-inc/powerhouse/commit/6e855808e))
49
+ - **workflow:** sign connections in with OAuth2 using their own app ([b03b33bf0](https://github.com/powerhouse-inc/powerhouse/commit/b03b33bf0))
50
+ - **reactor-workflow:** keyset-paginate the run listing through the subgraph and runs views ([d22a4eea5](https://github.com/powerhouse-inc/powerhouse/commit/d22a4eea5))
51
+ - **reactor-workflow:** renew webhook trigger subscriptions ([4fc6bfea6](https://github.com/powerhouse-inc/powerhouse/commit/4fc6bfea6))
52
+ - ⚠️ **switchboard:** block inputs, step and trigger tests, and version resolutions in the workflow API ([58b43b249](https://github.com/powerhouse-inc/powerhouse/commit/58b43b249))
53
+
54
+ ### 🩹 Fixes
55
+
56
+ - **reactor-workflow:** order runs by a key that doesn't change when they start ([f15425dd8](https://github.com/powerhouse-inc/powerhouse/commit/f15425dd8))
57
+ - **reactor-workflow:** disarm a workflow's trigger when its document is deleted ([866427bc6](https://github.com/powerhouse-inc/powerhouse/commit/866427bc6))
58
+
59
+ ### 🔥 Performance
60
+
61
+ - **reactor-workflow:** batch run listing step and document reads ([c33a42f7d](https://github.com/powerhouse-inc/powerhouse/commit/c33a42f7d))
62
+
63
+ ### ⚠️ Breaking Changes
64
+
65
+ - **switchboard:** block inputs, step and trigger tests, and version resolutions in the workflow API ([58b43b249](https://github.com/powerhouse-inc/powerhouse/commit/58b43b249))
66
+
67
+ ### ❤️ Thank You
68
+
69
+ - acaldas
70
+
71
+ ## 6.2.3-dev.30 (2026-09-29)
72
+
73
+ ### 🩹 Fixes
74
+
75
+ - **deps:** load cmd-ts's ESM build under bun, which fails to require chalk from its CJS build ([749528c71](https://github.com/powerhouse-inc/powerhouse/commit/749528c71))
76
+
77
+ ### ❤️ Thank You
78
+
79
+ - acaldas
80
+
81
+ ## 6.2.3-dev.29 (2026-09-28)
82
+
83
+ ### 🩹 Fixes
84
+
85
+ - **reactor-workflow:** refuse a secrets master key other than the one secrets were stored with ([87cfde0f5](https://github.com/powerhouse-inc/powerhouse/commit/87cfde0f5))
86
+
87
+ ### ❤️ Thank You
88
+
89
+ - acaldas
90
+
91
+ ## 6.2.3-dev.28 (2026-09-28)
92
+
93
+ ### 🚀 Features
94
+
95
+ - **reactor-workflow:** carry Activepieces layout hints, property groups and search to the editor ([4eca1e1bd](https://github.com/powerhouse-inc/powerhouse/commit/4eca1e1bd))
96
+
97
+ ### ❤️ Thank You
98
+
99
+ - acaldas
100
+
101
+ ## 6.2.3-dev.27 (2026-09-28)
102
+
103
+ ### 🚀 Features
104
+
105
+ - ⚠️ **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
106
+ - **switchboard:** sign short-lived attachment byte-route URLs ([18e09cdb5](https://github.com/powerhouse-inc/powerhouse/commit/18e09cdb5))
107
+
108
+ ### 🩹 Fixes
109
+
110
+ - **switchboard:** sign byte-route URLs under main's download-target TTL cap ([d503b4f67](https://github.com/powerhouse-inc/powerhouse/commit/d503b4f67))
111
+ - **reactor-workflow:** serve workflow reads and runs as the caller ([b2ddd126a](https://github.com/powerhouse-inc/powerhouse/commit/b2ddd126a))
112
+ - **reactor-drive:** gate the reactor-drive subgraph as the caller ([7041635f4](https://github.com/powerhouse-inc/powerhouse/commit/7041635f4))
113
+ - **reactor-api:** gate attachment reads through the reactor's read gate ([d6c3b4df1](https://github.com/powerhouse-inc/powerhouse/commit/d6c3b4df1))
114
+
115
+ ### ⚠️ Breaking Changes
116
+
117
+ - **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
118
+
119
+ ### ❤️ Thank You
120
+
121
+ - Benjamin Jordan
122
+ - Claude Opus 5.5
123
+
124
+ ## 6.2.3-dev.26 (2026-09-26)
125
+
126
+ ### 🚀 Features
127
+
128
+ - ⚠️ **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
129
+ - **switchboard:** sign short-lived attachment byte-route URLs ([18e09cdb5](https://github.com/powerhouse-inc/powerhouse/commit/18e09cdb5))
130
+
131
+ ### 🩹 Fixes
132
+
133
+ - **switchboard:** sign byte-route URLs under main's download-target TTL cap ([d503b4f67](https://github.com/powerhouse-inc/powerhouse/commit/d503b4f67))
134
+ - **reactor-workflow:** serve workflow reads and runs as the caller ([b2ddd126a](https://github.com/powerhouse-inc/powerhouse/commit/b2ddd126a))
135
+ - **reactor-drive:** gate the reactor-drive subgraph as the caller ([7041635f4](https://github.com/powerhouse-inc/powerhouse/commit/7041635f4))
136
+ - **reactor-api:** gate attachment reads through the reactor's read gate ([d6c3b4df1](https://github.com/powerhouse-inc/powerhouse/commit/d6c3b4df1))
137
+
138
+ ### ⚠️ Breaking Changes
139
+
140
+ - **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
141
+
142
+ ### ❤️ Thank You
143
+
144
+ - Benjamin Jordan
145
+ - Claude Opus 5.5
146
+
147
+ ## 6.2.3-dev.25 (2026-09-25)
148
+
149
+ ### 🚀 Features
150
+
151
+ - **workflow:** show run data in a lazy-loaded tree with copyable references, and scope the connection picker to the drive ([1d286f4a6](https://github.com/powerhouse-inc/powerhouse/commit/1d286f4a6))
152
+ - **reactor-workflow:** record when each step starts and ends ([6f6d8a233](https://github.com/powerhouse-inc/powerhouse/commit/6f6d8a233))
153
+ - **reactor-api:** serve an attachment only to callers who may read its document ([#3109](https://github.com/powerhouse-inc/powerhouse/pull/3109))
154
+
155
+ ### 🩹 Fixes
156
+
157
+ - **ci:** let the release skip the transpiler TypeScript 7 broke ([#36306](https://github.com/powerhouse-inc/powerhouse/issues/36306))
158
+
159
+ ### ❤️ Thank You
160
+
161
+ - acaldas
162
+ - Guillermo Puente
163
+ - Guillermo Puente Sandoval
164
+
165
+ ## 6.2.3-dev.24 (2026-09-25)
166
+
167
+ ### 🚀 Features
168
+
169
+ - **reactor-api:** exempt named paths from the authenticated-caller floor, and carry it to the attachment routes ([#3108](https://github.com/powerhouse-inc/powerhouse/pull/3108))
170
+ - **reactor:** action signature integrity ([#3088](https://github.com/powerhouse-inc/powerhouse/pull/3088), [#2894](https://github.com/powerhouse-inc/powerhouse/issues/2894), [#7](https://github.com/powerhouse-inc/powerhouse/issues/7))
171
+ - **reactor-workflow:** refuse the auth and trigger features the engine can't run ([7ce03d28f](https://github.com/powerhouse-inc/powerhouse/commit/7ce03d28f))
172
+ - type-safe piece authoring, upstream connection hooks, and a ph build that typechecks first ([#3082](https://github.com/powerhouse-inc/powerhouse/pull/3082))
173
+
174
+ ### 🩹 Fixes
175
+
176
+ - **workflow:** build after powerhouse-vetra-packages so their tsc --build runs never overlap ([#3101](https://github.com/powerhouse-inc/powerhouse/pull/3101))
177
+
178
+ ### ❤️ Thank You
179
+
180
+ - acaldas
181
+ - Benjamin Jordan
182
+ - Claude Fable 5.1
183
+ - Guillermo Puente Sandoval @gpuente
184
+
185
+ ## 6.2.3-dev.23 (2026-09-24)
186
+
187
+ ### 🩹 Fixes
188
+
189
+ - **switchboard:** leave unhandled rejections to Sentry when it listens ([c6a40108e](https://github.com/powerhouse-inc/powerhouse/commit/c6a40108e))
190
+ - **switchboard:** flush PGlite before exiting on an uncaught error ([#3077](https://github.com/powerhouse-inc/powerhouse/issues/3077))
191
+ - **switchboard:** escape non-ASCII file names in attachment metadata headers ([#3077](https://github.com/powerhouse-inc/powerhouse/issues/3077))
192
+
193
+ ### ❤️ Thank You
194
+
195
+ - Benjamin Jordan
196
+ - Claude Opus 5.5
197
+
198
+ ## 6.2.3-dev.22 (2026-09-23)
199
+
200
+ ### 🩹 Fixes
201
+
202
+ - **ci:** slice the duration-watch baseline in jq, not through head ([73db497e0](https://github.com/powerhouse-inc/powerhouse/commit/73db497e0))
203
+
204
+ ### ❤️ Thank You
205
+
206
+ - acaldas
207
+
208
+ ## 6.2.3-dev.21 (2026-09-22)
209
+
210
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
211
+
212
+ ## 6.2.3-dev.20 (2026-09-22)
213
+
214
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
215
+
216
+ ## 6.2.3-dev.19 (2026-09-21)
217
+
218
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
219
+
220
+ ## 6.2.3-dev.18 (2026-09-21)
221
+
222
+ ### 🚀 Features
223
+
224
+ - **workflow:** read pieces from a Powerhouse registry ([f1467e0b0](https://github.com/powerhouse-inc/powerhouse/commit/f1467e0b0))
225
+
226
+ ### 🩹 Fixes
227
+
228
+ - **switchboard:** load the workflow package like any other package ([7629bf71f](https://github.com/powerhouse-inc/powerhouse/commit/7629bf71f))
229
+
230
+ ### ❤️ Thank You
231
+
232
+ - acaldas
233
+
234
+ ## 6.2.3-dev.17 (2026-09-21)
235
+
236
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
237
+
238
+ ## 6.2.3-dev.16 (2026-09-21)
239
+
240
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
241
+
242
+ ## 6.2.3-dev.15 (2026-09-20)
243
+
244
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
245
+
246
+ ## 6.2.3-dev.14 (2026-09-19)
247
+
248
+ ### 🚀 Features
249
+
250
+ - **ph-cli:** build pieces on ph build ([3913b0796](https://github.com/powerhouse-inc/powerhouse/commit/3913b0796))
251
+ - **doc-harness:** serve rendered reports and transcripts from mastra studio ([fd64a4661](https://github.com/powerhouse-inc/powerhouse/commit/fd64a4661))
252
+ - **doc-harness:** workflows, steps, and the run/resume/inspect commands ([0e116d226](https://github.com/powerhouse-inc/powerhouse/commit/0e116d226))
253
+ - **doc-harness:** pilot task catalog with pinned recipe inputs ([74bc26129](https://github.com/powerhouse-inc/powerhouse/commit/74bc26129))
254
+ - **doc-harness:** workspace wiring and core schemas for the docs-validation harness ([5c591ac69](https://github.com/powerhouse-inc/powerhouse/commit/5c591ac69))
255
+
256
+ ### ❤️ Thank You
257
+
258
+ - acaldas
259
+ - Benjamin Jordan
260
+ - Claude Fable 5.1
261
+
262
+ ## 6.2.3-dev.13 (2026-09-18)
263
+
264
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
265
+
266
+ ## 6.2.3-dev.12 (2026-09-17)
267
+
268
+ ### 🚀 Features
269
+
270
+ - **switchboard:** own the workflow runtime, feed it through a read model, and take workflows out of reactor-api ([#3042](https://github.com/powerhouse-inc/powerhouse/issues/3042))
271
+ - **reactor-workflow:** the workflow engine, composed in reactor-api behind the workflows flag ([cb807bf5d](https://github.com/powerhouse-inc/powerhouse/commit/cb807bf5d))
272
+ - **workflow:** the Connect-loaded workflow package, and the workflows flag in reactor-api ([0953fc254](https://github.com/powerhouse-inc/powerhouse/commit/0953fc254))
273
+ - **pieces-framework:** vendor the Activepieces piece framework as a Powerhouse package ([3da5dbea8](https://github.com/powerhouse-inc/powerhouse/commit/3da5dbea8))
274
+
275
+ ### ❤️ Thank You
276
+
277
+ - acaldas
278
+
279
+ ## 6.2.3-dev.11 (2026-09-17)
280
+
281
+ ### 🚀 Features
282
+
283
+ - **reactor-browser,design-system:** keep the legacy useDocumentOperations and RevisionHistory shapes as deprecated aliases ([6de05e632](https://github.com/powerhouse-inc/powerhouse/commit/6de05e632))
284
+
285
+ ### 🩹 Fixes
286
+
287
+ - **design-system,connect:** end the history walk on a failed page and show what loaded ([95f815b46](https://github.com/powerhouse-inc/powerhouse/commit/95f815b46))
288
+ - hold the timeline revision until the global history is loaded, default to the global scope, hide paging mid-load ([80c3b1289](https://github.com/powerhouse-inc/powerhouse/commit/80c3b1289))
289
+ - **reactor-browser:** page operations through nextCursor and invalidate alias keys ([ccb965869](https://github.com/powerhouse-inc/powerhouse/commit/ccb965869))
290
+
291
+ ### 🔥 Performance
292
+
293
+ - **design-system,connect:** wait for the whole history before rendering the timeline, yield between pages, fetch 500 per page ([86435721c](https://github.com/powerhouse-inc/powerhouse/commit/86435721c))
294
+
295
+ ### ❤️ Thank You
296
+
297
+ - Frank Pfeift
298
+
299
+ ## 6.2.3-dev.10 (2026-09-16)
300
+
301
+ This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
302
+
1
303
  ## 6.2.3-dev.9 (2026-09-15)
2
304
 
3
305
  This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
package/README.md CHANGED
@@ -110,6 +110,7 @@ pnpm add -g @powerhousedao/switchboard
110
110
  | `REDIS_TLS_URL` | Redis TLS connection URL | - |
111
111
  | `PYROSCOPE_SERVER_ADDRESS` | Pyroscope server address | - |
112
112
  | `FEATURE_REACTORV2_ENABLED` | Enable Reactor v2 subgraph feature | `false` |
113
+ | `MCP_ENABLED` | `false` keeps `/mcp` unmounted | `true` |
113
114
 
114
115
  See [Observability](#observability) below for Sentry and OpenTelemetry variables.
115
116
 
@@ -186,6 +187,40 @@ exits non-zero instead of waiting out the init timeout.
186
187
 
187
188
  Programmatically: `startSwitchboard({ projectionWorker: { enabled, dbPoolSize } })`.
188
189
 
190
+ ### Creation Signature Policy
191
+
192
+ | Variable | Description | Default |
193
+ | ------------------------- | ------------------------------------------------------------ | ------------- |
194
+ | `CREATE_SIGNATURE_POLICY` | What new documents are created as: `legacy` or `v2-required` | `v2-required` |
195
+
196
+ A v2-required document accepts only v2 action signatures and takes a
197
+ content-addressed id. Set `legacy` while any reactor that syncs with this one
198
+ predates v2-required documents. It only decides what new documents are born
199
+ as; existing documents keep their policy, and it does not change what the
200
+ switchboard accepts. Without a Renown identity the switchboard has no signer,
201
+ so it creates legacy documents and logs a warning. A default drive configured
202
+ with a fixed `id` is always created legacy.
203
+
204
+ ### Stored Documents This Build Does Not Run
205
+
206
+ | Variable | Description | Default |
207
+ | -------------------------------------- | -------------------------------------------------------------------------------------- | -------- |
208
+ | `REACTOR_UNSUPPORTED_STORED_DOCUMENTS` | Stored documents at protocol versions this build does not run: `refuse` or `read-only` | `refuse` |
209
+
210
+ Before it starts, the reactor reads the protocol versions its stored documents
211
+ were created with. If this build does not run one of them, for example after a
212
+ rollback, switchboard logs this and exits with code 1:
213
+
214
+ ```
215
+ Refusing to start: 12 stored document(s) require base-reducer 3, which this switchboard does not run. Either start a switchboard build that runs base-reducer 3, or set REACTOR_UNSUPPORTED_STORED_DOCUMENTS=read-only to start with those documents read-only.
216
+ ```
217
+
218
+ With `read-only` it starts and logs a warning. Every write into those documents
219
+ and every operation received for them is refused; the rest of the store works
220
+ as usual. The check runs once on the host, so it covers the executor worker
221
+ pool too. Any other value fails the boot. Programmatically:
222
+ `startSwitchboard({ unsupportedStoredDocuments: "read-only" })`.
223
+
189
224
  ### Reactor Enforcement Flags
190
225
 
191
226
  | Variable | Description | Default |
package/dist/index.d.mts CHANGED
@@ -1,2 +1,3 @@
1
1
  import { NodeSDK } from "@opentelemetry/sdk-node";
2
- import { MeterProvider } from "@opentelemetry/sdk-metrics";
2
+ import { MeterProvider } from "@opentelemetry/sdk-metrics";
3
+ export {};
package/dist/index.mjs CHANGED
@@ -1,8 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c6c10af1-f4cc-56a5-abf6-fa35cf0de956")}catch(e){}}();
4
- import { a as parseForcePgVersion, r as startSwitchboard } from "./server-CiKkVE6g.mjs";
5
- import "./utils-Baw7rThP.mjs";
3
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="691165f8-a729-5658-bf22-e7b2440e6156")}catch(e){}}();
4
+ import { i as StoredDocumentsRefusedError, r as startSwitchboard, s as parseForcePgVersion } from "./server-sQoWp21G.mjs";
6
5
  import { metrics } from "@opentelemetry/api";
7
6
  import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
8
7
  import { ExpressInstrumentation } from "@opentelemetry/instrumentation-express";
@@ -201,7 +200,7 @@ async function initProfilerFromEnv(env) {
201
200
  collectCpuTime: true
202
201
  },
203
202
  heap: {
204
- samplingIntervalBytes: 512 * 1024,
203
+ samplingIntervalBytes: 524288,
205
204
  stackDepth: 64
206
205
  }
207
206
  }, {
@@ -246,11 +245,14 @@ try {
246
245
  await startSwitchboard({
247
246
  ...config,
248
247
  migratePglite: cliMigratePglite || config.migratePglite,
249
- forcePgVersion: config.forcePgVersion ?? void 0
248
+ forcePgVersion: config.forcePgVersion ?? void 0,
249
+ fatalErrorShutdown: true
250
250
  });
251
251
  } catch (e) {
252
- Sentry.captureException(e);
253
- logger.error("Switchboard failed to start: @error", e);
252
+ if (!StoredDocumentsRefusedError.isError(e)) {
253
+ Sentry.captureException(e);
254
+ logger.error("Switchboard failed to start: @error", e);
255
+ }
254
256
  await Sentry.flush(2e3).catch(() => void 0);
255
257
  process.exit(1);
256
258
  }
@@ -258,4 +260,4 @@ try {
258
260
  export {};
259
261
 
260
262
  //# sourceMappingURL=index.mjs.map
261
- //# debugId=c6c10af1-f4cc-56a5-abf6-fa35cf0de956
263
+ //# debugId=691165f8-a729-5658-bf22-e7b2440e6156