@mostra/protocol 0.1.0 → 0.3.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/dist/artifact.d.ts.map +1 -1
- package/dist/artifact.js +8 -3
- package/dist/artifact.js.map +1 -1
- package/dist/diagnostics/codes/env.d.ts +1 -1
- package/dist/diagnostics/codes/env.d.ts.map +1 -1
- package/dist/diagnostics/codes/env.js +12 -1
- package/dist/diagnostics/codes/env.js.map +1 -1
- package/dist/diagnostics/codes/host.d.ts +1 -1
- package/dist/diagnostics/codes/host.d.ts.map +1 -1
- package/dist/diagnostics/codes/host.js +12 -1
- package/dist/diagnostics/codes/host.js.map +1 -1
- package/dist/diagnostics/codes/platform.js +2 -2
- package/dist/diagnostics/codes/platform.js.map +1 -1
- package/dist/index.d.ts +4 -3
- package/dist/index.js +3 -2
- package/dist/method.d.ts +12 -0
- package/dist/method.d.ts.map +1 -1
- package/dist/method.js.map +1 -1
- package/dist/methods/artifact/create.d.ts.map +1 -1
- package/dist/methods/artifact/create.js +2 -1
- package/dist/methods/artifact/create.js.map +1 -1
- package/dist/methods/index.d.ts +3 -1
- package/dist/methods/index.d.ts.map +1 -1
- package/dist/methods/index.js +22 -4
- package/dist/methods/index.js.map +1 -1
- package/dist/methods/mostra/initialize.d.ts +1 -1
- package/dist/methods/mostra/initialize.js.map +1 -1
- package/dist/methods/port/identity-resolve.d.ts +36 -0
- package/dist/methods/port/identity-resolve.d.ts.map +1 -0
- package/dist/methods/port/identity-resolve.js +35 -0
- package/dist/methods/port/identity-resolve.js.map +1 -0
- package/package.json +3 -3
- package/schemas/protocol.draft-07.json +416 -3
- package/schemas/protocol.schema.json +416 -3
- package/src/artifact.ts +7 -2
- package/src/diagnostics/codes/env.ts +12 -0
- package/src/diagnostics/codes/host.ts +12 -0
- package/src/diagnostics/codes/platform.ts +2 -2
- package/src/index.ts +9 -1
- package/src/method.ts +14 -0
- package/src/methods/artifact/create.ts +2 -1
- package/src/methods/index.ts +13 -3
- package/src/methods/mostra/initialize.ts +1 -1
- package/src/methods/port/identity-resolve.ts +67 -0
|
@@ -4,6 +4,381 @@
|
|
|
4
4
|
"x-mostra-revisions": {
|
|
5
5
|
"host-protocol": "2026-10-10"
|
|
6
6
|
},
|
|
7
|
+
"x-mostra-methods": {
|
|
8
|
+
"artifact/create": {
|
|
9
|
+
"direction": "client-to-instance",
|
|
10
|
+
"mutating": true,
|
|
11
|
+
"params": {
|
|
12
|
+
"$ref": "#/$defs/ArtifactCreateParams"
|
|
13
|
+
},
|
|
14
|
+
"result": {
|
|
15
|
+
"$ref": "#/$defs/ArtifactCreateResult"
|
|
16
|
+
}
|
|
17
|
+
},
|
|
18
|
+
"artifact/get": {
|
|
19
|
+
"direction": "client-to-instance",
|
|
20
|
+
"mutating": false,
|
|
21
|
+
"params": {
|
|
22
|
+
"$ref": "#/$defs/ArtifactGetParams"
|
|
23
|
+
},
|
|
24
|
+
"result": {
|
|
25
|
+
"$ref": "#/$defs/ArtifactDetail"
|
|
26
|
+
}
|
|
27
|
+
},
|
|
28
|
+
"artifact/list": {
|
|
29
|
+
"direction": "client-to-instance",
|
|
30
|
+
"mutating": false,
|
|
31
|
+
"params": {
|
|
32
|
+
"$ref": "#/$defs/ArtifactListParams"
|
|
33
|
+
},
|
|
34
|
+
"result": {
|
|
35
|
+
"$ref": "#/$defs/ArtifactListResult"
|
|
36
|
+
}
|
|
37
|
+
},
|
|
38
|
+
"artifact/publish": {
|
|
39
|
+
"direction": "client-to-instance",
|
|
40
|
+
"mutating": true,
|
|
41
|
+
"params": {
|
|
42
|
+
"$ref": "#/$defs/ArtifactPublishParams"
|
|
43
|
+
},
|
|
44
|
+
"result": {
|
|
45
|
+
"$ref": "#/$defs/PublishReceipt"
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"artifact/verify": {
|
|
49
|
+
"direction": "client-to-instance",
|
|
50
|
+
"mutating": false,
|
|
51
|
+
"params": {
|
|
52
|
+
"$ref": "#/$defs/ArtifactVerifyParams"
|
|
53
|
+
},
|
|
54
|
+
"result": {
|
|
55
|
+
"$ref": "#/$defs/VerifyVerdict"
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
"deps/add": {
|
|
59
|
+
"direction": "client-to-instance",
|
|
60
|
+
"mutating": true,
|
|
61
|
+
"params": {
|
|
62
|
+
"$ref": "#/$defs/DepsAddParams"
|
|
63
|
+
},
|
|
64
|
+
"result": {
|
|
65
|
+
"$ref": "#/$defs/DepsAddResult"
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
"dev/start": {
|
|
69
|
+
"direction": "client-to-instance",
|
|
70
|
+
"mutating": true,
|
|
71
|
+
"params": {
|
|
72
|
+
"$ref": "#/$defs/DevStartParams"
|
|
73
|
+
},
|
|
74
|
+
"result": {
|
|
75
|
+
"$ref": "#/$defs/DevStartResult"
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
"dev/stop": {
|
|
79
|
+
"direction": "client-to-instance",
|
|
80
|
+
"mutating": true,
|
|
81
|
+
"params": {
|
|
82
|
+
"$ref": "#/$defs/DevStopParams"
|
|
83
|
+
},
|
|
84
|
+
"result": {
|
|
85
|
+
"$ref": "#/$defs/DevStopResult"
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
"events/ack": {
|
|
89
|
+
"direction": "client-to-instance",
|
|
90
|
+
"mutating": true,
|
|
91
|
+
"params": {
|
|
92
|
+
"$ref": "#/$defs/EventsAckParams"
|
|
93
|
+
},
|
|
94
|
+
"result": {
|
|
95
|
+
"$ref": "#/$defs/EventsAckResult"
|
|
96
|
+
}
|
|
97
|
+
},
|
|
98
|
+
"events/read": {
|
|
99
|
+
"direction": "client-to-instance",
|
|
100
|
+
"mutating": false,
|
|
101
|
+
"params": {
|
|
102
|
+
"$ref": "#/$defs/EventsReadParams"
|
|
103
|
+
},
|
|
104
|
+
"result": {
|
|
105
|
+
"$ref": "#/$defs/EventsReadResult"
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
"events/subscribe": {
|
|
109
|
+
"direction": "client-to-instance",
|
|
110
|
+
"mutating": false,
|
|
111
|
+
"params": {
|
|
112
|
+
"$ref": "#/$defs/EventsSubscribeParams"
|
|
113
|
+
},
|
|
114
|
+
"result": {
|
|
115
|
+
"$ref": "#/$defs/EventsSubscribeResult"
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
"events/unsubscribe": {
|
|
119
|
+
"direction": "client-to-instance",
|
|
120
|
+
"mutating": false,
|
|
121
|
+
"params": {
|
|
122
|
+
"$ref": "#/$defs/EventsUnsubscribeParams"
|
|
123
|
+
},
|
|
124
|
+
"result": {
|
|
125
|
+
"$ref": "#/$defs/EventsUnsubscribeResult"
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
"gc/run": {
|
|
129
|
+
"direction": "client-to-instance",
|
|
130
|
+
"mutating": true,
|
|
131
|
+
"params": {
|
|
132
|
+
"$ref": "#/$defs/GcRunParams"
|
|
133
|
+
},
|
|
134
|
+
"result": {
|
|
135
|
+
"$ref": "#/$defs/GcRunResult"
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
"instance/check": {
|
|
139
|
+
"direction": "client-to-instance",
|
|
140
|
+
"mutating": false,
|
|
141
|
+
"params": {
|
|
142
|
+
"$ref": "#/$defs/InstanceCheckParams"
|
|
143
|
+
},
|
|
144
|
+
"result": {
|
|
145
|
+
"$ref": "#/$defs/InstanceCheckResult"
|
|
146
|
+
}
|
|
147
|
+
},
|
|
148
|
+
"instance/status": {
|
|
149
|
+
"direction": "client-to-instance",
|
|
150
|
+
"mutating": false,
|
|
151
|
+
"params": {
|
|
152
|
+
"$ref": "#/$defs/InstanceStatusParams"
|
|
153
|
+
},
|
|
154
|
+
"result": {
|
|
155
|
+
"$ref": "#/$defs/InstanceStatusResult"
|
|
156
|
+
}
|
|
157
|
+
},
|
|
158
|
+
"live/push": {
|
|
159
|
+
"direction": "client-to-instance",
|
|
160
|
+
"mutating": true,
|
|
161
|
+
"params": {
|
|
162
|
+
"$ref": "#/$defs/LivePushParams"
|
|
163
|
+
},
|
|
164
|
+
"result": {
|
|
165
|
+
"$ref": "#/$defs/LivePushResult"
|
|
166
|
+
}
|
|
167
|
+
},
|
|
168
|
+
"mostra/initialize": {
|
|
169
|
+
"direction": "client-to-instance",
|
|
170
|
+
"mutating": false,
|
|
171
|
+
"params": {
|
|
172
|
+
"$ref": "#/$defs/MostraInitializeParams"
|
|
173
|
+
},
|
|
174
|
+
"result": {
|
|
175
|
+
"$ref": "#/$defs/MostraInitializeResult"
|
|
176
|
+
}
|
|
177
|
+
},
|
|
178
|
+
"mostra/shutdown": {
|
|
179
|
+
"direction": "client-to-instance",
|
|
180
|
+
"mutating": false,
|
|
181
|
+
"params": {
|
|
182
|
+
"$ref": "#/$defs/MostraShutdownParams"
|
|
183
|
+
},
|
|
184
|
+
"result": {
|
|
185
|
+
"$ref": "#/$defs/MostraShutdownResult"
|
|
186
|
+
}
|
|
187
|
+
},
|
|
188
|
+
"port/drafts.mirror": {
|
|
189
|
+
"direction": "instance-to-host",
|
|
190
|
+
"mutating": false,
|
|
191
|
+
"params": {
|
|
192
|
+
"$ref": "#/$defs/DraftMirror"
|
|
193
|
+
},
|
|
194
|
+
"result": {}
|
|
195
|
+
},
|
|
196
|
+
"port/identity.resolve": {
|
|
197
|
+
"direction": "instance-to-host",
|
|
198
|
+
"mutating": false,
|
|
199
|
+
"params": {
|
|
200
|
+
"$ref": "#/$defs/PortIdentityResolveParams"
|
|
201
|
+
},
|
|
202
|
+
"result": {
|
|
203
|
+
"$ref": "#/$defs/PortIdentityResolveResult"
|
|
204
|
+
}
|
|
205
|
+
},
|
|
206
|
+
"port/secrets.get": {
|
|
207
|
+
"direction": "instance-to-host",
|
|
208
|
+
"mutating": false,
|
|
209
|
+
"params": {
|
|
210
|
+
"$ref": "#/$defs/PortSecretsGetParams"
|
|
211
|
+
},
|
|
212
|
+
"result": {
|
|
213
|
+
"$ref": "#/$defs/PortSecretsGetResult"
|
|
214
|
+
}
|
|
215
|
+
},
|
|
216
|
+
"port/submissions.deliver": {
|
|
217
|
+
"direction": "instance-to-host",
|
|
218
|
+
"mutating": false,
|
|
219
|
+
"params": {
|
|
220
|
+
"$ref": "#/$defs/SubmissionEnvelope"
|
|
221
|
+
},
|
|
222
|
+
"result": {
|
|
223
|
+
"$ref": "#/$defs/PortSubmissionsDeliverResult"
|
|
224
|
+
}
|
|
225
|
+
},
|
|
226
|
+
"port/trustedControls.activated": {
|
|
227
|
+
"direction": "instance-to-host",
|
|
228
|
+
"mutating": false,
|
|
229
|
+
"params": {
|
|
230
|
+
"$ref": "#/$defs/PortTrustedControlsActivatedParams"
|
|
231
|
+
},
|
|
232
|
+
"result": {}
|
|
233
|
+
},
|
|
234
|
+
"port/trustedControls.policy": {
|
|
235
|
+
"direction": "instance-to-host",
|
|
236
|
+
"mutating": false,
|
|
237
|
+
"params": {
|
|
238
|
+
"$ref": "#/$defs/PortTrustedControlsPolicyParams"
|
|
239
|
+
},
|
|
240
|
+
"result": {
|
|
241
|
+
"$ref": "#/$defs/ControlsPolicy"
|
|
242
|
+
}
|
|
243
|
+
},
|
|
244
|
+
"results/get": {
|
|
245
|
+
"direction": "client-to-instance",
|
|
246
|
+
"mutating": false,
|
|
247
|
+
"params": {
|
|
248
|
+
"$ref": "#/$defs/ResultsGetParams"
|
|
249
|
+
},
|
|
250
|
+
"result": {
|
|
251
|
+
"$ref": "#/$defs/ResultsGetResult"
|
|
252
|
+
}
|
|
253
|
+
},
|
|
254
|
+
"secret/delete": {
|
|
255
|
+
"direction": "client-to-instance",
|
|
256
|
+
"mutating": false,
|
|
257
|
+
"params": {
|
|
258
|
+
"$ref": "#/$defs/SecretDeleteParams"
|
|
259
|
+
},
|
|
260
|
+
"result": {
|
|
261
|
+
"$ref": "#/$defs/SecretDeleteResult"
|
|
262
|
+
}
|
|
263
|
+
},
|
|
264
|
+
"secret/list": {
|
|
265
|
+
"direction": "client-to-instance",
|
|
266
|
+
"mutating": false,
|
|
267
|
+
"params": {
|
|
268
|
+
"$ref": "#/$defs/SecretListParams"
|
|
269
|
+
},
|
|
270
|
+
"result": {
|
|
271
|
+
"$ref": "#/$defs/SecretListResult"
|
|
272
|
+
}
|
|
273
|
+
},
|
|
274
|
+
"secret/set": {
|
|
275
|
+
"direction": "client-to-instance",
|
|
276
|
+
"mutating": false,
|
|
277
|
+
"params": {
|
|
278
|
+
"$ref": "#/$defs/SecretSetParams"
|
|
279
|
+
},
|
|
280
|
+
"result": {
|
|
281
|
+
"$ref": "#/$defs/SecretEntry"
|
|
282
|
+
}
|
|
283
|
+
},
|
|
284
|
+
"state/get": {
|
|
285
|
+
"direction": "client-to-instance",
|
|
286
|
+
"mutating": false,
|
|
287
|
+
"params": {
|
|
288
|
+
"$ref": "#/$defs/StateGetParams"
|
|
289
|
+
},
|
|
290
|
+
"result": {
|
|
291
|
+
"$ref": "#/$defs/StateGetResult"
|
|
292
|
+
}
|
|
293
|
+
},
|
|
294
|
+
"state/patch": {
|
|
295
|
+
"direction": "client-to-instance",
|
|
296
|
+
"mutating": true,
|
|
297
|
+
"params": {
|
|
298
|
+
"$ref": "#/$defs/StatePatchParams"
|
|
299
|
+
},
|
|
300
|
+
"result": {
|
|
301
|
+
"$ref": "#/$defs/MutationResult"
|
|
302
|
+
}
|
|
303
|
+
},
|
|
304
|
+
"view/default": {
|
|
305
|
+
"direction": "client-to-instance",
|
|
306
|
+
"mutating": true,
|
|
307
|
+
"params": {
|
|
308
|
+
"$ref": "#/$defs/ViewDefaultParams"
|
|
309
|
+
},
|
|
310
|
+
"result": {
|
|
311
|
+
"$ref": "#/$defs/CapabilityLink"
|
|
312
|
+
}
|
|
313
|
+
},
|
|
314
|
+
"view/launch": {
|
|
315
|
+
"direction": "client-to-instance",
|
|
316
|
+
"mutating": true,
|
|
317
|
+
"params": {
|
|
318
|
+
"$ref": "#/$defs/ViewLaunchParams"
|
|
319
|
+
},
|
|
320
|
+
"result": {
|
|
321
|
+
"$ref": "#/$defs/ViewLaunchResult"
|
|
322
|
+
}
|
|
323
|
+
},
|
|
324
|
+
"view/revoke": {
|
|
325
|
+
"direction": "client-to-instance",
|
|
326
|
+
"mutating": true,
|
|
327
|
+
"params": {
|
|
328
|
+
"$ref": "#/$defs/ViewRevokeParams"
|
|
329
|
+
},
|
|
330
|
+
"result": {
|
|
331
|
+
"$ref": "#/$defs/ViewRevokeResult"
|
|
332
|
+
}
|
|
333
|
+
},
|
|
334
|
+
"view/rotate": {
|
|
335
|
+
"direction": "client-to-instance",
|
|
336
|
+
"mutating": true,
|
|
337
|
+
"params": {
|
|
338
|
+
"$ref": "#/$defs/ViewRotateParams"
|
|
339
|
+
},
|
|
340
|
+
"result": {
|
|
341
|
+
"$ref": "#/$defs/CapabilityLink"
|
|
342
|
+
}
|
|
343
|
+
},
|
|
344
|
+
"view/url": {
|
|
345
|
+
"direction": "client-to-instance",
|
|
346
|
+
"mutating": true,
|
|
347
|
+
"params": {
|
|
348
|
+
"$ref": "#/$defs/ViewUrlParams"
|
|
349
|
+
},
|
|
350
|
+
"result": {
|
|
351
|
+
"$ref": "#/$defs/CapabilityLink"
|
|
352
|
+
}
|
|
353
|
+
},
|
|
354
|
+
"wait": {
|
|
355
|
+
"direction": "client-to-instance",
|
|
356
|
+
"mutating": false,
|
|
357
|
+
"params": {
|
|
358
|
+
"$ref": "#/$defs/WaitParams"
|
|
359
|
+
},
|
|
360
|
+
"result": {
|
|
361
|
+
"$ref": "#/$defs/WaitResult"
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
},
|
|
365
|
+
"x-mostra-notifications": {
|
|
366
|
+
"artifact/progress": {
|
|
367
|
+
"params": {
|
|
368
|
+
"$ref": "#/$defs/ArtifactProgressParams"
|
|
369
|
+
}
|
|
370
|
+
},
|
|
371
|
+
"dev/notify": {
|
|
372
|
+
"params": {
|
|
373
|
+
"$ref": "#/$defs/DevNotifyParams"
|
|
374
|
+
}
|
|
375
|
+
},
|
|
376
|
+
"events/notify": {
|
|
377
|
+
"params": {
|
|
378
|
+
"$ref": "#/$defs/EventsNotifyParams"
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
},
|
|
7
382
|
"$defs": {
|
|
8
383
|
"ActionError": {
|
|
9
384
|
"type": "object",
|
|
@@ -74,7 +449,7 @@
|
|
|
74
449
|
"properties": {
|
|
75
450
|
"dir": {
|
|
76
451
|
"type": "string",
|
|
77
|
-
"pattern": "
|
|
452
|
+
"pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
|
|
78
453
|
},
|
|
79
454
|
"template": {
|
|
80
455
|
"type": "string",
|
|
@@ -504,7 +879,7 @@
|
|
|
504
879
|
"properties": {
|
|
505
880
|
"path": {
|
|
506
881
|
"type": "string",
|
|
507
|
-
"pattern": "
|
|
882
|
+
"pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
|
|
508
883
|
}
|
|
509
884
|
},
|
|
510
885
|
"required": [
|
|
@@ -2890,6 +3265,44 @@
|
|
|
2890
3265
|
],
|
|
2891
3266
|
"description": "A long-poll answer: the cursor, the events after the asked one, and a snapshot."
|
|
2892
3267
|
},
|
|
3268
|
+
"PortIdentityResolveParams": {
|
|
3269
|
+
"type": "object",
|
|
3270
|
+
"properties": {
|
|
3271
|
+
"artifactId": {
|
|
3272
|
+
"$ref": "#/$defs/ArtifactId"
|
|
3273
|
+
},
|
|
3274
|
+
"via": {
|
|
3275
|
+
"type": "string",
|
|
3276
|
+
"minLength": 1
|
|
3277
|
+
},
|
|
3278
|
+
"headers": {
|
|
3279
|
+
"type": "object",
|
|
3280
|
+
"propertyNames": {
|
|
3281
|
+
"type": "string"
|
|
3282
|
+
},
|
|
3283
|
+
"additionalProperties": {
|
|
3284
|
+
"type": "string"
|
|
3285
|
+
}
|
|
3286
|
+
}
|
|
3287
|
+
},
|
|
3288
|
+
"required": [
|
|
3289
|
+
"artifactId",
|
|
3290
|
+
"via",
|
|
3291
|
+
"headers"
|
|
3292
|
+
],
|
|
3293
|
+
"description": "A browser opening a link without a viewer: the artifact, how the request arrived and its headers (no cookies, no Mostra headers)."
|
|
3294
|
+
},
|
|
3295
|
+
"PortIdentityResolveResult": {
|
|
3296
|
+
"anyOf": [
|
|
3297
|
+
{
|
|
3298
|
+
"$ref": "#/$defs/ViewerSpec"
|
|
3299
|
+
},
|
|
3300
|
+
{
|
|
3301
|
+
"type": "null"
|
|
3302
|
+
}
|
|
3303
|
+
],
|
|
3304
|
+
"description": "The person the session acts for, by the host's stable key, or null for the default."
|
|
3305
|
+
},
|
|
2893
3306
|
"PortName": {
|
|
2894
3307
|
"type": "string",
|
|
2895
3308
|
"pattern": "^[a-z][a-zA-Z0-9]*$",
|
|
@@ -3982,7 +4395,7 @@
|
|
|
3982
4395
|
"properties": {
|
|
3983
4396
|
"path": {
|
|
3984
4397
|
"type": "string",
|
|
3985
|
-
"pattern": "
|
|
4398
|
+
"pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
|
|
3986
4399
|
}
|
|
3987
4400
|
},
|
|
3988
4401
|
"required": [
|
package/src/artifact.ts
CHANGED
|
@@ -7,8 +7,13 @@ import { ArtifactId, Cursor, TokenId, VersionId } from "./ids.ts";
|
|
|
7
7
|
import { ArtifactLink, ArtifactManifest, SubmissionPolicy } from "./manifest.ts";
|
|
8
8
|
import { wireRegistry } from "./wire-registry.ts";
|
|
9
9
|
|
|
10
|
-
/**
|
|
11
|
-
|
|
10
|
+
/**
|
|
11
|
+
* An absolute file system path: the client resolves relative paths against its own directory.
|
|
12
|
+
* POSIX `/…`, and on Windows a drive path (`C:\…`, `C:/…`) or a UNC path (`\\server\share\…`,
|
|
13
|
+
* WP-W1, D150); a drive-relative `C:x` or a root-relative `\x` isn't absolute. The Windows forms
|
|
14
|
+
* are alternatives beside the POSIX one, which the schema gate reads as a widening (D32).
|
|
15
|
+
*/
|
|
16
|
+
export const AbsolutePath: z.ZodString = z.string().regex(/^(?:\/|[A-Za-z]:[\\/]|\\\\[^\\])/);
|
|
12
17
|
|
|
13
18
|
/**
|
|
14
19
|
* Where to build an artifact from: a source path (a `.tsx`, `.jsx` or `.mdx` file, or a directory
|
|
@@ -16,6 +16,7 @@ export const envDiagnosticCodes = [
|
|
|
16
16
|
"MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED",
|
|
17
17
|
"MOSTRA_ENV_BUNDLE_UNAVAILABLE",
|
|
18
18
|
"MOSTRA_ENV_NODE_UNSUPPORTED",
|
|
19
|
+
"MOSTRA_ENV_HELPER_MISSING",
|
|
19
20
|
// gen:codes
|
|
20
21
|
] as const;
|
|
21
22
|
|
|
@@ -145,5 +146,16 @@ export const envDiagnostics: AreaCatalog<EnvDiagnosticCode> = {
|
|
|
145
146
|
fix: "Upgrade the machine's Node.js to 22.19 or later, or run Mostra without npm: download the runtime bundle for your platform from the GitHub release, check it against `SHA256SUMS`, extract it, run its `bin/mostra-setup` once, then use its `bin/mostra`.",
|
|
146
147
|
},
|
|
147
148
|
},
|
|
149
|
+
MOSTRA_ENV_HELPER_MISSING: {
|
|
150
|
+
severity: "error",
|
|
151
|
+
phase: "platform",
|
|
152
|
+
title: "Windows helper missing",
|
|
153
|
+
hint: "Reinstall Mostra, or set `MOSTRA_WIN_HELPER` to its `mostra-win.exe`.",
|
|
154
|
+
docs: {
|
|
155
|
+
explanation:
|
|
156
|
+
"On Windows the runtime runs `mostra-win.exe`, a helper that ships with it, for what Node.js can't do there: owner-only access to the home, the home's control pipe, and every child process in a Job Object. The runtime looked for it at `MOSTRA_WIN_HELPER`, in its runtime bundle, and in a development checkout's Cargo build, and found none, so it stopped before touching the home.",
|
|
157
|
+
fix: "Reinstall Mostra so the runtime bundle is complete. In a development checkout, build the helper with `cargo build -p mostra-win`. A custom layout can point the runtime at the helper with `MOSTRA_WIN_HELPER`.",
|
|
158
|
+
},
|
|
159
|
+
},
|
|
148
160
|
// gen:entries
|
|
149
161
|
};
|
|
@@ -20,6 +20,7 @@ export const hostDiagnosticCodes = [
|
|
|
20
20
|
"MOSTRA_HOST_SUBSCRIPTION_UNKNOWN",
|
|
21
21
|
"MOSTRA_HOST_NOTIFICATION_UNSUPPORTED",
|
|
22
22
|
"MOSTRA_HOST_MESSAGE_TOO_LARGE",
|
|
23
|
+
"MOSTRA_HOST_IDENTITY_UNAVAILABLE",
|
|
23
24
|
// gen:codes
|
|
24
25
|
] as const;
|
|
25
26
|
|
|
@@ -193,5 +194,16 @@ export const hostDiagnostics: AreaCatalog<HostDiagnosticCode> = {
|
|
|
193
194
|
fix: "Read less per request (`events/read` with a smaller `limit`, `results/get` for one submission), and keep artifacts' values within the field and document limits.",
|
|
194
195
|
},
|
|
195
196
|
},
|
|
197
|
+
MOSTRA_HOST_IDENTITY_UNAVAILABLE: {
|
|
198
|
+
severity: "error",
|
|
199
|
+
phase: "host",
|
|
200
|
+
title: "The host that identifies viewers didn't answer",
|
|
201
|
+
hint: "Start the host that serves this home's identity port, then open the link again.",
|
|
202
|
+
docs: {
|
|
203
|
+
explanation:
|
|
204
|
+
"A host registered the `identity` port, so it decides who opens this home's links. When a link minted without a viewer was opened, that host failed, didn't answer within 5 seconds, gave an answer its schema refuses, or is expected (it lists `identity` in `HomeConfig.ports`) but not connected. Mostra refuses the link rather than let the session act as someone else.",
|
|
205
|
+
fix: "Start or reconnect the host, then open the link again. A link minted with `view/url`'s `viewer` names its person itself and never needs the port. To return the home to Mostra's own identity, have the host register without the port and clear its expected ports (`HomeConfig.ports: []`).",
|
|
206
|
+
},
|
|
207
|
+
},
|
|
196
208
|
// gen:entries
|
|
197
209
|
};
|
|
@@ -22,8 +22,8 @@ export const platformDiagnostics: AreaCatalog<PlatformDiagnosticCode> = {
|
|
|
22
22
|
hint: "Run Mostra on macOS or Linux, on an x64 or arm64 machine.",
|
|
23
23
|
docs: {
|
|
24
24
|
explanation:
|
|
25
|
-
"Mostra
|
|
26
|
-
fix: "Run Mostra on a macOS or Linux machine with an x64 or arm64 processor. Windows support
|
|
25
|
+
"Mostra runs on macOS and Linux, on x64 and arm64. On any other operating system or architecture every entry point stops with this code before it creates or changes anything, because the process model, the control endpoint and storage are built and tested only there. Windows on x64 and arm64 is being added and runs only in Mostra's own development builds until it is complete; a release stops there with this code too. The message names the platform that was detected.",
|
|
26
|
+
fix: "Run Mostra on a macOS or Linux machine with an x64 or arm64 processor. Windows support arrives in a 1.0 release.",
|
|
27
27
|
},
|
|
28
28
|
},
|
|
29
29
|
// gen:entries
|
package/src/index.ts
CHANGED
|
@@ -280,9 +280,11 @@ export {
|
|
|
280
280
|
} from "./manifest.ts";
|
|
281
281
|
export {
|
|
282
282
|
type AnyMethod,
|
|
283
|
+
type AnyNotification,
|
|
283
284
|
defineMethod,
|
|
284
285
|
type MethodDefinition,
|
|
285
286
|
type MethodDirection,
|
|
287
|
+
type NotificationDefinition,
|
|
286
288
|
} from "./method.ts";
|
|
287
289
|
export {
|
|
288
290
|
type ArtifactCreateParams,
|
|
@@ -357,7 +359,7 @@ export {
|
|
|
357
359
|
type GcVersion,
|
|
358
360
|
gcRunMethod,
|
|
359
361
|
} from "./methods/gc/run.ts";
|
|
360
|
-
export { hostMethods } from "./methods/index.ts";
|
|
362
|
+
export { hostMethods, hostNotifications } from "./methods/index.ts";
|
|
361
363
|
export {
|
|
362
364
|
type InstanceCheck,
|
|
363
365
|
type InstanceCheckParams,
|
|
@@ -397,6 +399,12 @@ export {
|
|
|
397
399
|
type DraftsMirrorResult,
|
|
398
400
|
portDraftsMirrorMethod,
|
|
399
401
|
} from "./methods/port/drafts-mirror.ts";
|
|
402
|
+
export {
|
|
403
|
+
type IdentityVia,
|
|
404
|
+
type PortIdentityResolveParams,
|
|
405
|
+
type PortIdentityResolveResult,
|
|
406
|
+
portIdentityResolveMethod,
|
|
407
|
+
} from "./methods/port/identity-resolve.ts";
|
|
400
408
|
export {
|
|
401
409
|
type PortSecretsGetParams,
|
|
402
410
|
type PortSecretsGetResult,
|
package/src/method.ts
CHANGED
|
@@ -40,3 +40,17 @@ export function defineMethod<Params, Result>(
|
|
|
40
40
|
}
|
|
41
41
|
return definition;
|
|
42
42
|
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* One notification of the host protocol: a message without an answer, sent by the instance to a
|
|
46
|
+
* client that accepted it in `mostra/initialize` (`ClientCapabilities.notifications`).
|
|
47
|
+
*/
|
|
48
|
+
export interface NotificationDefinition<Params> {
|
|
49
|
+
/** The JSON-RPC method name, such as `events/notify`. */
|
|
50
|
+
readonly method: string;
|
|
51
|
+
/** The schema of its `params`. */
|
|
52
|
+
readonly params: z.ZodType<Params>;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** A notification of any params type. */
|
|
56
|
+
export type AnyNotification = NotificationDefinition<unknown>;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
|
+
import { AbsolutePath } from "../../artifact.ts";
|
|
2
3
|
import { ArtifactId } from "../../ids.ts";
|
|
3
4
|
import { defineMethod, type MethodDefinition } from "../../method.ts";
|
|
4
5
|
import { wireRegistry } from "../../wire-registry.ts";
|
|
@@ -27,7 +28,7 @@ export interface ArtifactCreateResult {
|
|
|
27
28
|
|
|
28
29
|
const params: z.ZodType<ArtifactCreateParams> = z
|
|
29
30
|
.object({
|
|
30
|
-
dir:
|
|
31
|
+
dir: AbsolutePath,
|
|
31
32
|
template: z.string().min(1).exactOptional(),
|
|
32
33
|
title: z.string().min(1).exactOptional(),
|
|
33
34
|
requestId: z.string().min(1).exactOptional(),
|
package/src/methods/index.ts
CHANGED
|
@@ -2,18 +2,19 @@
|
|
|
2
2
|
* Every host protocol method this package defines. `pnpm gen protocol-method` adds entries at the
|
|
3
3
|
* markers; the method itself lives in its own module under `methods/<group>/`.
|
|
4
4
|
*/
|
|
5
|
-
import type { AnyMethod } from "../method.ts";
|
|
5
|
+
import type { AnyMethod, AnyNotification } from "../method.ts";
|
|
6
|
+
import { ARTIFACT_PROGRESS, ArtifactProgressParams } from "../verify.ts";
|
|
6
7
|
import { artifactCreateMethod } from "./artifact/create.ts";
|
|
7
8
|
import { artifactGetMethod } from "./artifact/get.ts";
|
|
8
9
|
import { artifactListMethod } from "./artifact/list.ts";
|
|
9
10
|
import { artifactPublishMethod } from "./artifact/publish.ts";
|
|
10
11
|
import { artifactVerifyMethod } from "./artifact/verify.ts";
|
|
11
12
|
import { depsAddMethod } from "./deps/add.ts";
|
|
12
|
-
import { devStartMethod } from "./dev/start.ts";
|
|
13
|
+
import { DEV_NOTIFY, DevNotifyParams, devStartMethod } from "./dev/start.ts";
|
|
13
14
|
import { devStopMethod } from "./dev/stop.ts";
|
|
14
15
|
import { eventsAckMethod } from "./events/ack.ts";
|
|
15
16
|
import { eventsReadMethod } from "./events/read.ts";
|
|
16
|
-
import { eventsSubscribeMethod } from "./events/subscribe.ts";
|
|
17
|
+
import { EVENTS_NOTIFY, EventsNotifyParams, eventsSubscribeMethod } from "./events/subscribe.ts";
|
|
17
18
|
import { eventsUnsubscribeMethod } from "./events/unsubscribe.ts";
|
|
18
19
|
import { gcRunMethod } from "./gc/run.ts";
|
|
19
20
|
import { instanceCheckMethod } from "./instance/check.ts";
|
|
@@ -22,6 +23,7 @@ import { livePushMethod } from "./live/push.ts";
|
|
|
22
23
|
import { mostraInitializeMethod } from "./mostra/initialize.ts";
|
|
23
24
|
import { mostraShutdownMethod } from "./mostra/shutdown.ts";
|
|
24
25
|
import { portDraftsMirrorMethod } from "./port/drafts-mirror.ts";
|
|
26
|
+
import { portIdentityResolveMethod } from "./port/identity-resolve.ts";
|
|
25
27
|
import { portSecretsGetMethod } from "./port/secrets-get.ts";
|
|
26
28
|
import { portSubmissionsDeliverMethod } from "./port/submissions-deliver.ts";
|
|
27
29
|
import { portTrustedControlsActivatedMethod } from "./port/trusted-controls-activated.ts";
|
|
@@ -77,5 +79,13 @@ export const hostMethods: readonly AnyMethod[] = [
|
|
|
77
79
|
instanceCheckMethod,
|
|
78
80
|
devStartMethod,
|
|
79
81
|
devStopMethod,
|
|
82
|
+
portIdentityResolveMethod,
|
|
80
83
|
// gen:methods
|
|
81
84
|
];
|
|
85
|
+
|
|
86
|
+
/** Every notification the instance sends to its clients (INTERFACES §6). */
|
|
87
|
+
export const hostNotifications: readonly AnyNotification[] = [
|
|
88
|
+
{ method: EVENTS_NOTIFY, params: EventsNotifyParams as AnyNotification["params"] },
|
|
89
|
+
{ method: ARTIFACT_PROGRESS, params: ArtifactProgressParams as AnyNotification["params"] },
|
|
90
|
+
{ method: DEV_NOTIFY, params: DevNotifyParams as AnyNotification["params"] },
|
|
91
|
+
];
|
|
@@ -43,7 +43,7 @@ export const CLI_CLIENT_NAME = "mostra-cli";
|
|
|
43
43
|
|
|
44
44
|
/** The client that opens a connection. */
|
|
45
45
|
export interface ClientInfo {
|
|
46
|
-
/** The client's name, for logs and status (`mostra-cli`, `
|
|
46
|
+
/** The client's name, for logs and status (`mostra-cli`, `my-host`). */
|
|
47
47
|
readonly name: string;
|
|
48
48
|
/** The client's own version. */
|
|
49
49
|
readonly version: string;
|