@powerhousedao/switchboard 6.2.3-dev.8 → 6.2.3-staging.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.
- package/.tsbuild/test/attachments/byte-grants.test.d.ts +2 -0
- package/.tsbuild/test/attachments/byte-grants.test.d.ts.map +1 -0
- package/.tsbuild/test/attachments/byte-routes-read-gate.integration.test.d.ts +2 -0
- package/.tsbuild/test/attachments/byte-routes-read-gate.integration.test.d.ts.map +1 -0
- package/.tsbuild/test/attachments/url-signer.test.d.ts +2 -0
- package/.tsbuild/test/attachments/url-signer.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-create-signature-policy.test.d.ts +2 -0
- package/.tsbuild/test/boot-create-signature-policy.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-mcp-enabled.test.d.ts +2 -0
- package/.tsbuild/test/boot-mcp-enabled.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-unsupported-stored-documents.test.d.ts +2 -0
- package/.tsbuild/test/boot-unsupported-stored-documents.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-without-renown.test.d.ts +2 -0
- package/.tsbuild/test/boot-without-renown.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-without-require-signatures.test.d.ts +2 -0
- package/.tsbuild/test/boot-without-require-signatures.test.d.ts.map +1 -0
- package/.tsbuild/test/boot-worker-trust-policy.test.d.ts +2 -0
- package/.tsbuild/test/boot-worker-trust-policy.test.d.ts.map +1 -0
- package/.tsbuild/test/builder-defaults.test.d.ts +2 -0
- package/.tsbuild/test/builder-defaults.test.d.ts.map +1 -0
- package/.tsbuild/test/create-signature-policy.test.d.ts +2 -0
- package/.tsbuild/test/create-signature-policy.test.d.ts.map +1 -0
- package/.tsbuild/test/fatal-shutdown.test.d.ts +2 -0
- package/.tsbuild/test/fatal-shutdown.test.d.ts.map +1 -0
- package/.tsbuild/test/mcp-flag.test.d.ts +2 -0
- package/.tsbuild/test/mcp-flag.test.d.ts.map +1 -0
- package/.tsbuild/test/renown-trust-policy.test.d.ts +2 -0
- package/.tsbuild/test/renown-trust-policy.test.d.ts.map +1 -0
- package/.tsbuild/test/unsupported-stored-documents.test.d.ts +2 -0
- package/.tsbuild/test/unsupported-stored-documents.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/harness.d.ts +56 -0
- package/.tsbuild/test/workflow/harness.d.ts.map +1 -0
- package/.tsbuild/test/workflow/oauth.test.d.ts +2 -0
- package/.tsbuild/test/workflow/oauth.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/resolvers.test.d.ts +2 -0
- package/.tsbuild/test/workflow/resolvers.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/webhook-dedupe.test.d.ts +2 -0
- package/.tsbuild/test/workflow/webhook-dedupe.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/webhook-signed.test.d.ts +2 -0
- package/.tsbuild/test/workflow/webhook-signed.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/webhook-trigger-test.test.d.ts +2 -0
- package/.tsbuild/test/workflow/webhook-trigger-test.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow/webhook-unsigned.test.d.ts +2 -0
- package/.tsbuild/test/workflow/webhook-unsigned.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow-read-gate.test.d.ts +2 -0
- package/.tsbuild/test/workflow-read-gate.test.d.ts.map +1 -0
- package/.tsbuild/test/workflow-runtime.test.d.ts +2 -0
- package/.tsbuild/test/workflow-runtime.test.d.ts.map +1 -0
- package/.tsbuild/tsconfig.tsbuildinfo +1 -1
- package/.tsbuild/tsdown.config.d.ts.map +1 -1
- package/.tsbuild/vitest.config.d.ts.map +1 -1
- package/Auth.md +94 -0
- package/CHANGELOG.md +302 -0
- package/README.md +35 -0
- package/dist/index.d.mts +2 -1
- package/dist/index.mjs +10 -8
- package/dist/index.mjs.map +1 -1
- package/dist/install-packages.d.mts +2 -1
- package/dist/install-packages.mjs +2 -2
- package/dist/install-packages.mjs.map +1 -1
- package/dist/migrate.d.mts +2 -1
- package/dist/migrate.mjs +4 -3
- package/dist/migrate.mjs.map +1 -1
- package/dist/{server-CiKkVE6g.mjs → server-sQoWp21G.mjs} +1454 -70
- package/dist/server-sQoWp21G.mjs.map +1 -0
- package/dist/server.d.mts +103 -29
- package/dist/server.d.mts.map +1 -1
- package/dist/server.mjs +4 -5
- package/dist/{utils-Baw7rThP.mjs → utils-uaBlzyjS.mjs} +15 -9
- package/dist/utils-uaBlzyjS.mjs.map +1 -0
- package/dist/utils.d.mts +4 -5
- package/dist/utils.d.mts.map +1 -1
- package/dist/utils.mjs +3 -3
- package/package.json +21 -17
- package/test/attachments/auth.test.ts +85 -0
- package/test/attachments/byte-grants.test.ts +287 -0
- package/test/attachments/byte-routes-read-gate.integration.test.ts +314 -0
- package/test/attachments/download-target.test.ts +194 -31
- package/test/attachments/index.test.ts +34 -3
- package/test/attachments/routes-integration.test.ts +59 -4
- package/test/attachments/routes.test.ts +165 -23
- package/test/attachments/service-config.test.ts +13 -3
- package/test/attachments/url-signer.test.ts +105 -0
- package/test/boot-create-signature-policy.test.ts +108 -0
- package/test/boot-mcp-enabled.test.ts +121 -0
- package/test/boot-unsupported-stored-documents.test.ts +210 -0
- package/test/boot-without-renown.test.ts +81 -0
- package/test/boot-without-require-signatures.test.ts +74 -0
- package/test/boot-worker-trust-policy.test.ts +90 -0
- package/test/builder-defaults.test.ts +80 -0
- package/test/create-signature-policy.test.ts +69 -0
- package/test/fatal-shutdown.test.ts +102 -0
- package/test/mcp-flag.test.ts +56 -0
- package/test/renown-trust-policy.test.ts +315 -0
- package/test/unsupported-stored-documents.test.ts +72 -0
- package/test/workflow/harness.ts +289 -0
- package/test/workflow/oauth.test.ts +214 -0
- package/test/workflow/resolvers.test.ts +296 -0
- package/test/workflow/webhook-dedupe.test.ts +295 -0
- package/test/workflow/webhook-signed.test.ts +509 -0
- package/test/workflow/webhook-trigger-test.test.ts +82 -0
- package/test/workflow/webhook-unsigned.test.ts +345 -0
- package/test/workflow-read-gate.test.ts +145 -0
- package/test/workflow-runtime.test.ts +486 -0
- package/tsconfig.json +6 -0
- package/tsdown.config.ts +3 -1
- package/dist/server-CiKkVE6g.mjs.map +0 -1
- 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":"
|
|
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":"
|
|
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-staging.0 (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-dev.34 (2026-09-30)
|
|
6
|
+
|
|
7
|
+
### 🚀 Features
|
|
8
|
+
|
|
9
|
+
- **switchboard:** let MCP_ENABLED=false keep the MCP server unmounted ([#3146](https://github.com/powerhouse-inc/powerhouse/pull/3146))
|
|
10
|
+
|
|
11
|
+
### ❤️ Thank You
|
|
12
|
+
|
|
13
|
+
- Guillermo Puente Sandoval @gpuente
|
|
14
|
+
|
|
15
|
+
## 6.2.3-dev.33 (2026-09-30)
|
|
16
|
+
|
|
17
|
+
### 🚀 Features
|
|
18
|
+
|
|
19
|
+
- **switchboard:** expose the stored-protocol startup check ([de2bf4836](https://github.com/powerhouse-inc/powerhouse/commit/de2bf4836))
|
|
20
|
+
- **reactor:** add catch-up operator tools and observability ([5722d7836](https://github.com/powerhouse-inc/powerhouse/commit/5722d7836))
|
|
21
|
+
|
|
22
|
+
### 🩹 Fixes
|
|
23
|
+
|
|
24
|
+
- **reactor:** claim a batch for each read model as it queues ([c09b1de2a](https://github.com/powerhouse-inc/powerhouse/commit/c09b1de2a))
|
|
25
|
+
- **reactor:** settle a probe on its own xid, not on an empty xip ([4e0f0dab9](https://github.com/powerhouse-inc/powerhouse/commit/4e0f0dab9))
|
|
26
|
+
- **reactor:** leave a stream to the next sweep while its live pass runs ([53112bad4](https://github.com/powerhouse-inc/powerhouse/commit/53112bad4))
|
|
27
|
+
- **reactor:** start a head registration at the sequence head ([e06581849](https://github.com/powerhouse-inc/powerhouse/commit/e06581849))
|
|
28
|
+
- **switchboard:** resolve packages it brings from its own dependencies in dev ([7c9c55d98](https://github.com/powerhouse-inc/powerhouse/commit/7c9c55d98))
|
|
29
|
+
|
|
30
|
+
### ❤️ Thank You
|
|
31
|
+
|
|
32
|
+
- acaldas
|
|
33
|
+
- Benjamin Jordan
|
|
34
|
+
- Claude Opus 5.5
|
|
35
|
+
|
|
36
|
+
## 6.2.3-dev.32 (2026-09-29)
|
|
37
|
+
|
|
38
|
+
This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
|
|
39
|
+
|
|
40
|
+
## 6.2.3-dev.31 (2026-09-29)
|
|
41
|
+
|
|
42
|
+
### 🚀 Features
|
|
43
|
+
|
|
44
|
+
- **ph-cli:** seed a Workflows drive in vetra when workflows are on ([6e855808e](https://github.com/powerhouse-inc/powerhouse/commit/6e855808e))
|
|
45
|
+
- **workflow:** sign connections in with OAuth2 using their own app ([b03b33bf0](https://github.com/powerhouse-inc/powerhouse/commit/b03b33bf0))
|
|
46
|
+
- **reactor-workflow:** keyset-paginate the run listing through the subgraph and runs views ([d22a4eea5](https://github.com/powerhouse-inc/powerhouse/commit/d22a4eea5))
|
|
47
|
+
- **reactor-workflow:** renew webhook trigger subscriptions ([4fc6bfea6](https://github.com/powerhouse-inc/powerhouse/commit/4fc6bfea6))
|
|
48
|
+
- ⚠️ **switchboard:** block inputs, step and trigger tests, and version resolutions in the workflow API ([58b43b249](https://github.com/powerhouse-inc/powerhouse/commit/58b43b249))
|
|
49
|
+
|
|
50
|
+
### 🩹 Fixes
|
|
51
|
+
|
|
52
|
+
- **reactor-workflow:** order runs by a key that doesn't change when they start ([f15425dd8](https://github.com/powerhouse-inc/powerhouse/commit/f15425dd8))
|
|
53
|
+
- **reactor-workflow:** disarm a workflow's trigger when its document is deleted ([866427bc6](https://github.com/powerhouse-inc/powerhouse/commit/866427bc6))
|
|
54
|
+
|
|
55
|
+
### 🔥 Performance
|
|
56
|
+
|
|
57
|
+
- **reactor-workflow:** batch run listing step and document reads ([c33a42f7d](https://github.com/powerhouse-inc/powerhouse/commit/c33a42f7d))
|
|
58
|
+
|
|
59
|
+
### ⚠️ Breaking Changes
|
|
60
|
+
|
|
61
|
+
- **switchboard:** block inputs, step and trigger tests, and version resolutions in the workflow API ([58b43b249](https://github.com/powerhouse-inc/powerhouse/commit/58b43b249))
|
|
62
|
+
|
|
63
|
+
### ❤️ Thank You
|
|
64
|
+
|
|
65
|
+
- acaldas
|
|
66
|
+
|
|
67
|
+
## 6.2.3-dev.30 (2026-09-29)
|
|
68
|
+
|
|
69
|
+
### 🩹 Fixes
|
|
70
|
+
|
|
71
|
+
- **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))
|
|
72
|
+
|
|
73
|
+
### ❤️ Thank You
|
|
74
|
+
|
|
75
|
+
- acaldas
|
|
76
|
+
|
|
77
|
+
## 6.2.3-dev.29 (2026-09-28)
|
|
78
|
+
|
|
79
|
+
### 🩹 Fixes
|
|
80
|
+
|
|
81
|
+
- **reactor-workflow:** refuse a secrets master key other than the one secrets were stored with ([87cfde0f5](https://github.com/powerhouse-inc/powerhouse/commit/87cfde0f5))
|
|
82
|
+
|
|
83
|
+
### ❤️ Thank You
|
|
84
|
+
|
|
85
|
+
- acaldas
|
|
86
|
+
|
|
87
|
+
## 6.2.3-dev.28 (2026-09-28)
|
|
88
|
+
|
|
89
|
+
### 🚀 Features
|
|
90
|
+
|
|
91
|
+
- **reactor-workflow:** carry Activepieces layout hints, property groups and search to the editor ([4eca1e1bd](https://github.com/powerhouse-inc/powerhouse/commit/4eca1e1bd))
|
|
92
|
+
|
|
93
|
+
### ❤️ Thank You
|
|
94
|
+
|
|
95
|
+
- acaldas
|
|
96
|
+
|
|
97
|
+
## 6.2.3-dev.27 (2026-09-28)
|
|
98
|
+
|
|
99
|
+
### 🚀 Features
|
|
100
|
+
|
|
101
|
+
- ⚠️ **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
|
|
102
|
+
- **switchboard:** sign short-lived attachment byte-route URLs ([18e09cdb5](https://github.com/powerhouse-inc/powerhouse/commit/18e09cdb5))
|
|
103
|
+
|
|
104
|
+
### 🩹 Fixes
|
|
105
|
+
|
|
106
|
+
- **switchboard:** sign byte-route URLs under main's download-target TTL cap ([d503b4f67](https://github.com/powerhouse-inc/powerhouse/commit/d503b4f67))
|
|
107
|
+
- **reactor-workflow:** serve workflow reads and runs as the caller ([b2ddd126a](https://github.com/powerhouse-inc/powerhouse/commit/b2ddd126a))
|
|
108
|
+
- **reactor-drive:** gate the reactor-drive subgraph as the caller ([7041635f4](https://github.com/powerhouse-inc/powerhouse/commit/7041635f4))
|
|
109
|
+
- **reactor-api:** gate attachment reads through the reactor's read gate ([d6c3b4df1](https://github.com/powerhouse-inc/powerhouse/commit/d6c3b4df1))
|
|
110
|
+
|
|
111
|
+
### ⚠️ Breaking Changes
|
|
112
|
+
|
|
113
|
+
- **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
|
|
114
|
+
|
|
115
|
+
### ❤️ Thank You
|
|
116
|
+
|
|
117
|
+
- Benjamin Jordan
|
|
118
|
+
- Claude Opus 5.5
|
|
119
|
+
|
|
120
|
+
## 6.2.3-dev.26 (2026-09-26)
|
|
121
|
+
|
|
122
|
+
### 🚀 Features
|
|
123
|
+
|
|
124
|
+
- ⚠️ **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
|
|
125
|
+
- **switchboard:** sign short-lived attachment byte-route URLs ([18e09cdb5](https://github.com/powerhouse-inc/powerhouse/commit/18e09cdb5))
|
|
126
|
+
|
|
127
|
+
### 🩹 Fixes
|
|
128
|
+
|
|
129
|
+
- **switchboard:** sign byte-route URLs under main's download-target TTL cap ([d503b4f67](https://github.com/powerhouse-inc/powerhouse/commit/d503b4f67))
|
|
130
|
+
- **reactor-workflow:** serve workflow reads and runs as the caller ([b2ddd126a](https://github.com/powerhouse-inc/powerhouse/commit/b2ddd126a))
|
|
131
|
+
- **reactor-drive:** gate the reactor-drive subgraph as the caller ([7041635f4](https://github.com/powerhouse-inc/powerhouse/commit/7041635f4))
|
|
132
|
+
- **reactor-api:** gate attachment reads through the reactor's read gate ([d6c3b4df1](https://github.com/powerhouse-inc/powerhouse/commit/d6c3b4df1))
|
|
133
|
+
|
|
134
|
+
### ⚠️ Breaking Changes
|
|
135
|
+
|
|
136
|
+
- **switchboard:** serve attachment bytes only under a document grant ([275e88da0](https://github.com/powerhouse-inc/powerhouse/commit/275e88da0))
|
|
137
|
+
|
|
138
|
+
### ❤️ Thank You
|
|
139
|
+
|
|
140
|
+
- Benjamin Jordan
|
|
141
|
+
- Claude Opus 5.5
|
|
142
|
+
|
|
143
|
+
## 6.2.3-dev.25 (2026-09-25)
|
|
144
|
+
|
|
145
|
+
### 🚀 Features
|
|
146
|
+
|
|
147
|
+
- **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))
|
|
148
|
+
- **reactor-workflow:** record when each step starts and ends ([6f6d8a233](https://github.com/powerhouse-inc/powerhouse/commit/6f6d8a233))
|
|
149
|
+
- **reactor-api:** serve an attachment only to callers who may read its document ([#3109](https://github.com/powerhouse-inc/powerhouse/pull/3109))
|
|
150
|
+
|
|
151
|
+
### 🩹 Fixes
|
|
152
|
+
|
|
153
|
+
- **ci:** let the release skip the transpiler TypeScript 7 broke ([#36306](https://github.com/powerhouse-inc/powerhouse/issues/36306))
|
|
154
|
+
|
|
155
|
+
### ❤️ Thank You
|
|
156
|
+
|
|
157
|
+
- acaldas
|
|
158
|
+
- Guillermo Puente
|
|
159
|
+
- Guillermo Puente Sandoval
|
|
160
|
+
|
|
161
|
+
## 6.2.3-dev.24 (2026-09-25)
|
|
162
|
+
|
|
163
|
+
### 🚀 Features
|
|
164
|
+
|
|
165
|
+
- **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))
|
|
166
|
+
- **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))
|
|
167
|
+
- **reactor-workflow:** refuse the auth and trigger features the engine can't run ([7ce03d28f](https://github.com/powerhouse-inc/powerhouse/commit/7ce03d28f))
|
|
168
|
+
- type-safe piece authoring, upstream connection hooks, and a ph build that typechecks first ([#3082](https://github.com/powerhouse-inc/powerhouse/pull/3082))
|
|
169
|
+
|
|
170
|
+
### 🩹 Fixes
|
|
171
|
+
|
|
172
|
+
- **workflow:** build after powerhouse-vetra-packages so their tsc --build runs never overlap ([#3101](https://github.com/powerhouse-inc/powerhouse/pull/3101))
|
|
173
|
+
|
|
174
|
+
### ❤️ Thank You
|
|
175
|
+
|
|
176
|
+
- acaldas
|
|
177
|
+
- Benjamin Jordan
|
|
178
|
+
- Claude Fable 5.1
|
|
179
|
+
- Guillermo Puente Sandoval @gpuente
|
|
180
|
+
|
|
181
|
+
## 6.2.3-dev.23 (2026-09-24)
|
|
182
|
+
|
|
183
|
+
### 🩹 Fixes
|
|
184
|
+
|
|
185
|
+
- **switchboard:** leave unhandled rejections to Sentry when it listens ([c6a40108e](https://github.com/powerhouse-inc/powerhouse/commit/c6a40108e))
|
|
186
|
+
- **switchboard:** flush PGlite before exiting on an uncaught error ([#3077](https://github.com/powerhouse-inc/powerhouse/issues/3077))
|
|
187
|
+
- **switchboard:** escape non-ASCII file names in attachment metadata headers ([#3077](https://github.com/powerhouse-inc/powerhouse/issues/3077))
|
|
188
|
+
|
|
189
|
+
### ❤️ Thank You
|
|
190
|
+
|
|
191
|
+
- Benjamin Jordan
|
|
192
|
+
- Claude Opus 5.5
|
|
193
|
+
|
|
194
|
+
## 6.2.3-dev.22 (2026-09-23)
|
|
195
|
+
|
|
196
|
+
### 🩹 Fixes
|
|
197
|
+
|
|
198
|
+
- **ci:** slice the duration-watch baseline in jq, not through head ([73db497e0](https://github.com/powerhouse-inc/powerhouse/commit/73db497e0))
|
|
199
|
+
|
|
200
|
+
### ❤️ Thank You
|
|
201
|
+
|
|
202
|
+
- acaldas
|
|
203
|
+
|
|
204
|
+
## 6.2.3-dev.21 (2026-09-22)
|
|
205
|
+
|
|
206
|
+
This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
|
|
207
|
+
|
|
208
|
+
## 6.2.3-dev.20 (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.19 (2026-09-21)
|
|
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.18 (2026-09-21)
|
|
217
|
+
|
|
218
|
+
### 🚀 Features
|
|
219
|
+
|
|
220
|
+
- **workflow:** read pieces from a Powerhouse registry ([f1467e0b0](https://github.com/powerhouse-inc/powerhouse/commit/f1467e0b0))
|
|
221
|
+
|
|
222
|
+
### 🩹 Fixes
|
|
223
|
+
|
|
224
|
+
- **switchboard:** load the workflow package like any other package ([7629bf71f](https://github.com/powerhouse-inc/powerhouse/commit/7629bf71f))
|
|
225
|
+
|
|
226
|
+
### ❤️ Thank You
|
|
227
|
+
|
|
228
|
+
- acaldas
|
|
229
|
+
|
|
230
|
+
## 6.2.3-dev.17 (2026-09-21)
|
|
231
|
+
|
|
232
|
+
This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
|
|
233
|
+
|
|
234
|
+
## 6.2.3-dev.16 (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.15 (2026-09-20)
|
|
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.14 (2026-09-19)
|
|
243
|
+
|
|
244
|
+
### 🚀 Features
|
|
245
|
+
|
|
246
|
+
- **ph-cli:** build pieces on ph build ([3913b0796](https://github.com/powerhouse-inc/powerhouse/commit/3913b0796))
|
|
247
|
+
- **doc-harness:** serve rendered reports and transcripts from mastra studio ([fd64a4661](https://github.com/powerhouse-inc/powerhouse/commit/fd64a4661))
|
|
248
|
+
- **doc-harness:** workflows, steps, and the run/resume/inspect commands ([0e116d226](https://github.com/powerhouse-inc/powerhouse/commit/0e116d226))
|
|
249
|
+
- **doc-harness:** pilot task catalog with pinned recipe inputs ([74bc26129](https://github.com/powerhouse-inc/powerhouse/commit/74bc26129))
|
|
250
|
+
- **doc-harness:** workspace wiring and core schemas for the docs-validation harness ([5c591ac69](https://github.com/powerhouse-inc/powerhouse/commit/5c591ac69))
|
|
251
|
+
|
|
252
|
+
### ❤️ Thank You
|
|
253
|
+
|
|
254
|
+
- acaldas
|
|
255
|
+
- Benjamin Jordan
|
|
256
|
+
- Claude Fable 5.1
|
|
257
|
+
|
|
258
|
+
## 6.2.3-dev.13 (2026-09-18)
|
|
259
|
+
|
|
260
|
+
This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
|
|
261
|
+
|
|
262
|
+
## 6.2.3-dev.12 (2026-09-17)
|
|
263
|
+
|
|
264
|
+
### 🚀 Features
|
|
265
|
+
|
|
266
|
+
- **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))
|
|
267
|
+
- **reactor-workflow:** the workflow engine, composed in reactor-api behind the workflows flag ([cb807bf5d](https://github.com/powerhouse-inc/powerhouse/commit/cb807bf5d))
|
|
268
|
+
- **workflow:** the Connect-loaded workflow package, and the workflows flag in reactor-api ([0953fc254](https://github.com/powerhouse-inc/powerhouse/commit/0953fc254))
|
|
269
|
+
- **pieces-framework:** vendor the Activepieces piece framework as a Powerhouse package ([3da5dbea8](https://github.com/powerhouse-inc/powerhouse/commit/3da5dbea8))
|
|
270
|
+
|
|
271
|
+
### ❤️ Thank You
|
|
272
|
+
|
|
273
|
+
- acaldas
|
|
274
|
+
|
|
275
|
+
## 6.2.3-dev.11 (2026-09-17)
|
|
276
|
+
|
|
277
|
+
### 🚀 Features
|
|
278
|
+
|
|
279
|
+
- **reactor-browser,design-system:** keep the legacy useDocumentOperations and RevisionHistory shapes as deprecated aliases ([6de05e632](https://github.com/powerhouse-inc/powerhouse/commit/6de05e632))
|
|
280
|
+
|
|
281
|
+
### 🩹 Fixes
|
|
282
|
+
|
|
283
|
+
- **design-system,connect:** end the history walk on a failed page and show what loaded ([95f815b46](https://github.com/powerhouse-inc/powerhouse/commit/95f815b46))
|
|
284
|
+
- 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))
|
|
285
|
+
- **reactor-browser:** page operations through nextCursor and invalidate alias keys ([ccb965869](https://github.com/powerhouse-inc/powerhouse/commit/ccb965869))
|
|
286
|
+
|
|
287
|
+
### 🔥 Performance
|
|
288
|
+
|
|
289
|
+
- **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))
|
|
290
|
+
|
|
291
|
+
### ❤️ Thank You
|
|
292
|
+
|
|
293
|
+
- Frank Pfeift
|
|
294
|
+
|
|
295
|
+
## 6.2.3-dev.10 (2026-09-16)
|
|
296
|
+
|
|
297
|
+
This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
|
|
298
|
+
|
|
299
|
+
## 6.2.3-dev.9 (2026-09-15)
|
|
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.8 (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
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]="
|
|
4
|
-
import {
|
|
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:
|
|
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
|
-
|
|
253
|
-
|
|
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=
|
|
263
|
+
//# debugId=691165f8-a729-5658-bf22-e7b2440e6156
|