@mossbear/protocol 0.1.0-alpha.101 → 0.1.0-alpha.103

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 (53) hide show
  1. package/dist/artifact.test.js +28 -1
  2. package/dist/artifact.test.js.map +1 -1
  3. package/dist/commentAnchor.d.ts +9 -0
  4. package/dist/commentAnchor.d.ts.map +1 -1
  5. package/dist/commentAnchor.js +9 -0
  6. package/dist/commentAnchor.js.map +1 -1
  7. package/dist/datasets.d.ts +322 -0
  8. package/dist/datasets.d.ts.map +1 -0
  9. package/dist/datasets.js +290 -0
  10. package/dist/datasets.js.map +1 -0
  11. package/dist/datasets.test.d.ts +2 -0
  12. package/dist/datasets.test.d.ts.map +1 -0
  13. package/dist/datasets.test.js +77 -0
  14. package/dist/datasets.test.js.map +1 -0
  15. package/dist/frameDocument.d.ts +18 -5
  16. package/dist/frameDocument.d.ts.map +1 -1
  17. package/dist/frameDocument.js +24 -5
  18. package/dist/frameDocument.js.map +1 -1
  19. package/dist/frameDocument.test.js +31 -0
  20. package/dist/frameDocument.test.js.map +1 -1
  21. package/dist/frameProtocol.d.ts +7 -0
  22. package/dist/frameProtocol.d.ts.map +1 -1
  23. package/dist/frameProtocol.js +7 -0
  24. package/dist/frameProtocol.js.map +1 -1
  25. package/dist/frameRuntime.d.ts +84 -0
  26. package/dist/frameRuntime.d.ts.map +1 -0
  27. package/dist/frameRuntime.js +141 -0
  28. package/dist/frameRuntime.js.map +1 -0
  29. package/dist/frameRuntime.test.d.ts +2 -0
  30. package/dist/frameRuntime.test.d.ts.map +1 -0
  31. package/dist/frameRuntime.test.js +165 -0
  32. package/dist/frameRuntime.test.js.map +1 -0
  33. package/dist/index.d.ts +2 -0
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +2 -0
  36. package/dist/index.js.map +1 -1
  37. package/dist/photos.d.ts +6 -0
  38. package/dist/photos.d.ts.map +1 -1
  39. package/dist/photos.js +6 -0
  40. package/dist/photos.js.map +1 -1
  41. package/dist/schemas.d.ts +210 -7
  42. package/dist/schemas.d.ts.map +1 -1
  43. package/dist/schemas.js +124 -4
  44. package/dist/schemas.js.map +1 -1
  45. package/dist/schemas.test.js +9 -0
  46. package/dist/schemas.test.js.map +1 -1
  47. package/dist/types.d.ts +3 -1
  48. package/dist/types.d.ts.map +1 -1
  49. package/dist/types.js.map +1 -1
  50. package/dist/whatSyncs.d.ts.map +1 -1
  51. package/dist/whatSyncs.js +4 -0
  52. package/dist/whatSyncs.js.map +1 -1
  53. package/package.json +5 -1
@@ -0,0 +1,290 @@
1
+ /**
2
+ * Named datasets: the read contract a dashboard artifact's frame is given its
3
+ * data through, and later the CLI and its MCP server.
4
+ *
5
+ * A dataset is a small, versioned, named read of the viewer's own account, not
6
+ * a query language. This file holds the contract half of each one — its name,
7
+ * version, span, parameter schema, result schemas and published sample. The
8
+ * read itself lives on the server, one resolver per dataset, run by a runner
9
+ * that binds the reader, their history window and cost withholding, so nothing
10
+ * here can widen what a read returns.
11
+ *
12
+ * A page names a dataset with its version (`usage.daily@1`). A change that
13
+ * breaks a reader adds `@2` beside `@1`; a new optional field keeps the
14
+ * version, because readers parse with the non-strict `reader` form, which drops
15
+ * keys it does not name.
16
+ *
17
+ * Each result has three forms:
18
+ *
19
+ * - `full` — strict, with cost. What the server returns to a reader who may
20
+ * see cost.
21
+ * - `locked` — strict, with no cost keys at all. What the server returns to a
22
+ * reader who may not. A strict form is the server's check on its own output:
23
+ * a read that carries cost to a locked reader fails it and errors rather
24
+ * than leaking.
25
+ * - `reader` — non-strict, cost optional. What a consumer parses with.
26
+ */
27
+ import * as v from 'valibot';
28
+ /** Every dataset, by its versioned id. */
29
+ export const DATASET_IDS = [
30
+ 'usage.daily@1',
31
+ 'usage.byModel@1',
32
+ 'sessions.daily@1',
33
+ ];
34
+ export const DatasetIdSchema = v.picklist(DATASET_IDS);
35
+ const Day = v.pipe(v.string(), v.isoDate());
36
+ const Count = v.pipe(v.number(), v.integer(), v.minValue(0));
37
+ /** Millionths of a US dollar. */
38
+ const Micros = v.pipe(v.number(), v.integer(), v.minValue(0));
39
+ const tokenEntries = {
40
+ inputTokens: Count,
41
+ outputTokens: Count,
42
+ cacheReadTokens: Count,
43
+ cacheWriteTokens: Count,
44
+ totalTokens: Count,
45
+ };
46
+ // usage.daily@1 — tokens per calendar day over the last 30 days.
47
+ const usageDayEntries = { day: Day, ...tokenEntries };
48
+ const usageTotalsEntries = {
49
+ ...tokenEntries,
50
+ /** True when some tokens belong to a model with no known price. Not a dollar figure. */
51
+ hasUnknownModelCost: v.boolean(),
52
+ };
53
+ const UsageDailyFull = v.strictObject({
54
+ days: v.array(v.strictObject({ ...usageDayEntries, costMicros: Micros })),
55
+ totals: v.strictObject({ ...usageTotalsEntries, costMicros: Micros }),
56
+ });
57
+ const UsageDailyLocked = v.strictObject({
58
+ days: v.array(v.strictObject(usageDayEntries)),
59
+ totals: v.strictObject(usageTotalsEntries),
60
+ });
61
+ const UsageDailyReader = v.object({
62
+ days: v.array(v.object({ ...usageDayEntries, costMicros: v.optional(Micros) })),
63
+ totals: v.object({ ...usageTotalsEntries, costMicros: v.optional(Micros) }),
64
+ });
65
+ // usage.byModel@1 — tokens per model over the last 30 days, largest first.
66
+ const usageModelEntries = {
67
+ // No length cap: ingest stores any non-empty model id, and one long id must
68
+ // not fail the strict parse and take the whole read down with it.
69
+ model: v.pipe(v.string(), v.minLength(1)),
70
+ /** The provider recorded for the model, or null. */
71
+ provider: v.nullable(v.string()),
72
+ ...tokenEntries,
73
+ };
74
+ /** `null` when the model has no known price, which is never a zero. */
75
+ const ModelCost = v.nullable(Micros);
76
+ const UsageByModelFull = v.strictObject({
77
+ models: v.array(v.strictObject({ ...usageModelEntries, costMicros: ModelCost })),
78
+ });
79
+ const UsageByModelLocked = v.strictObject({
80
+ models: v.array(v.strictObject(usageModelEntries)),
81
+ });
82
+ const UsageByModelReader = v.object({
83
+ models: v.array(v.object({ ...usageModelEntries, costMicros: v.optional(ModelCost) })),
84
+ });
85
+ // sessions.daily@1 — sessions per calendar day over the last year, by outcome.
86
+ const sessionDayEntries = {
87
+ day: Day,
88
+ /** Every session that started that day, whatever its outcome. */
89
+ sessions: Count,
90
+ /** All four token classes, summed over those sessions. */
91
+ tokens: Count,
92
+ /** Graded, and followed every guide it engaged. */
93
+ followed: Count,
94
+ /** Graded, and missed a guide it engaged. */
95
+ missed: Count,
96
+ /** Graded, and engaged no guide. */
97
+ noGuide: Count,
98
+ /** Not graded yet, and eligible to be. */
99
+ waiting: Count,
100
+ /** The grader turned it away, or could not grade it. */
101
+ ungradable: Count,
102
+ /** Grading was off for it. */
103
+ gradingOff: Count,
104
+ };
105
+ const sessionsDailyEntries = {
106
+ /**
107
+ * The latest day that may be missing sessions because the read was capped;
108
+ * that day and every earlier one are then partial. Null when nothing was cut.
109
+ */
110
+ truncatedThrough: v.nullable(Day),
111
+ };
112
+ const SessionsDailyFull = v.strictObject({
113
+ days: v.array(v.strictObject(sessionDayEntries)),
114
+ ...sessionsDailyEntries,
115
+ });
116
+ const SessionsDailyReader = v.object({
117
+ days: v.array(v.object(sessionDayEntries)),
118
+ ...sessionsDailyEntries,
119
+ });
120
+ /**
121
+ * Each dataset's contract. `spanDays` is how many calendar days it covers,
122
+ * ending today in the reader's time zone. `params` is an empty strict object
123
+ * for every dataset today: nothing a page declares can narrow or widen a read.
124
+ */
125
+ export const DATASETS = {
126
+ 'usage.daily@1': {
127
+ name: 'usage.daily',
128
+ version: 1,
129
+ spanDays: 30,
130
+ params: v.strictObject({}),
131
+ full: UsageDailyFull,
132
+ locked: UsageDailyLocked,
133
+ reader: UsageDailyReader,
134
+ },
135
+ 'usage.byModel@1': {
136
+ name: 'usage.byModel',
137
+ version: 1,
138
+ spanDays: 30,
139
+ params: v.strictObject({}),
140
+ full: UsageByModelFull,
141
+ locked: UsageByModelLocked,
142
+ reader: UsageByModelReader,
143
+ },
144
+ 'sessions.daily@1': {
145
+ name: 'sessions.daily',
146
+ version: 1,
147
+ spanDays: 366,
148
+ params: v.strictObject({}),
149
+ // No cost field, so both strict forms are the same schema.
150
+ full: SessionsDailyFull,
151
+ locked: SessionsDailyFull,
152
+ reader: SessionsDailyReader,
153
+ },
154
+ };
155
+ /**
156
+ * What wraps every result. The envelope is read the same whichever dataset it
157
+ * carries.
158
+ *
159
+ * - `asOf` — when the server read it, so a page can say how fresh it is.
160
+ * - `range` — the calendar days the dataset covers, in `timeZone`.
161
+ * - `historyFrom` — the first whole day inside the reader's history window when that
162
+ * window starts after `range.from`, else null. The result holds no day
163
+ * before it, and a page draws those days as outside the reader's history,
164
+ * never as zeros.
165
+ * - `costLocked` — true when the reader may not see cost; every cost key is
166
+ * then absent from `data`.
167
+ */
168
+ const envelopeEntries = {
169
+ asOf: v.pipe(v.string(), v.isoTimestamp()),
170
+ timeZone: v.pipe(v.string(), v.minLength(1), v.maxLength(100)),
171
+ range: v.object({ from: Day, to: Day }),
172
+ historyFrom: v.nullable(Day),
173
+ costLocked: v.boolean(),
174
+ };
175
+ /** The envelope schema a consumer parses one dataset's payload with. */
176
+ export function datasetPayloadSchema(id) {
177
+ return v.object({
178
+ dataset: v.literal(id),
179
+ ...envelopeEntries,
180
+ data: DATASETS[id].reader,
181
+ });
182
+ }
183
+ /**
184
+ * A dataset id from a page's manifest. Only an exact versioned id resolves: a
185
+ * bare name (`usage.daily`) would let a breaking change reach a page nobody is
186
+ * editing, so it is refused like an unknown one.
187
+ */
188
+ export function parseDatasetId(value) {
189
+ return v.is(DatasetIdSchema, value) ? value : null;
190
+ }
191
+ // Samples: what a page draws when it holds no live data. Fixed, deterministic,
192
+ // in the locked form, so a sample never shows a dollar figure.
193
+ const SAMPLE_TODAY = '2026-06-30';
194
+ const SAMPLE_AS_OF = '2026-06-30T12:00:00.000Z';
195
+ function sampleDay(offset) {
196
+ const date = new Date(`${SAMPLE_TODAY}T00:00:00.000Z`);
197
+ date.setUTCDate(date.getUTCDate() - offset);
198
+ return date.toISOString().slice(0, 10);
199
+ }
200
+ /** A smooth, repeatable wave, so a sample looks like a working week. */
201
+ function wave(index, base) {
202
+ const weekday = index % 7;
203
+ const weekend = weekday === 5 || weekday === 6 ? 0.25 : 1;
204
+ return Math.round(base * weekend * (1 + 0.4 * Math.sin(index / 3)));
205
+ }
206
+ function sampleTokens(total) {
207
+ const inputTokens = Math.round(total * 0.2);
208
+ const outputTokens = Math.round(total * 0.05);
209
+ const cacheWriteTokens = Math.round(total * 0.1);
210
+ const cacheReadTokens = total - inputTokens - outputTokens - cacheWriteTokens;
211
+ return {
212
+ inputTokens,
213
+ outputTokens,
214
+ cacheReadTokens,
215
+ cacheWriteTokens,
216
+ totalTokens: total,
217
+ };
218
+ }
219
+ function sampleRange(spanDays) {
220
+ return { from: sampleDay(spanDays - 1), to: SAMPLE_TODAY };
221
+ }
222
+ function sampleEnvelope(id) {
223
+ return {
224
+ dataset: id,
225
+ asOf: SAMPLE_AS_OF,
226
+ timeZone: 'UTC',
227
+ range: sampleRange(DATASETS[id].spanDays),
228
+ historyFrom: null,
229
+ costLocked: true,
230
+ };
231
+ }
232
+ function usageDailySample() {
233
+ const span = DATASETS['usage.daily@1'].spanDays;
234
+ const days = Array.from({ length: span }, (_, i) => ({
235
+ day: sampleDay(span - 1 - i),
236
+ ...sampleTokens(wave(i, 1_200_000)),
237
+ }));
238
+ const sum = (key) => days.reduce((total, day) => total + day[key], 0);
239
+ return {
240
+ days,
241
+ totals: {
242
+ inputTokens: sum('inputTokens'),
243
+ outputTokens: sum('outputTokens'),
244
+ cacheReadTokens: sum('cacheReadTokens'),
245
+ cacheWriteTokens: sum('cacheWriteTokens'),
246
+ totalTokens: sum('totalTokens'),
247
+ hasUnknownModelCost: false,
248
+ },
249
+ };
250
+ }
251
+ function usageByModelSample() {
252
+ return {
253
+ models: [
254
+ { model: 'sample-model-large', provider: 'sample', ...sampleTokens(21_400_000) },
255
+ { model: 'sample-model-medium', provider: 'sample', ...sampleTokens(8_900_000) },
256
+ { model: 'sample-model-small', provider: 'sample', ...sampleTokens(1_300_000) },
257
+ ],
258
+ };
259
+ }
260
+ function sessionsDailySample() {
261
+ const span = DATASETS['sessions.daily@1'].spanDays;
262
+ const days = Array.from({ length: span }, (_, i) => {
263
+ const sessions = Math.max(0, wave(i, 6) - 1);
264
+ const missed = sessions > 3 ? 1 : 0;
265
+ const noGuide = sessions > 1 ? 1 : 0;
266
+ const followed = sessions - missed - noGuide;
267
+ return {
268
+ day: sampleDay(span - 1 - i),
269
+ sessions,
270
+ tokens: sessions * 180_000,
271
+ followed,
272
+ missed,
273
+ noGuide,
274
+ waiting: 0,
275
+ ungradable: 0,
276
+ gradingOff: 0,
277
+ };
278
+ });
279
+ return { days, truncatedThrough: null };
280
+ }
281
+ /** Every dataset's published sample, as a whole payload. */
282
+ export const DATASET_SAMPLES = {
283
+ 'usage.daily@1': { ...sampleEnvelope('usage.daily@1'), data: usageDailySample() },
284
+ 'usage.byModel@1': { ...sampleEnvelope('usage.byModel@1'), data: usageByModelSample() },
285
+ 'sessions.daily@1': {
286
+ ...sampleEnvelope('sessions.daily@1'),
287
+ data: sessionsDailySample(),
288
+ },
289
+ };
290
+ //# sourceMappingURL=datasets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datasets.js","sourceRoot":"","sources":["../src/datasets.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=datasets.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datasets.test.d.ts","sourceRoot":"","sources":["../src/datasets.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,77 @@
1
+ import * as v from 'valibot';
2
+ import { describe, expect, it } from 'vitest';
3
+ import { DATASET_IDS, DATASET_SAMPLES, DATASETS, datasetPayloadSchema, parseDatasetId, } from './datasets.js';
4
+ const hasCostKey = (value) => Array.isArray(value)
5
+ ? value.some(hasCostKey)
6
+ : value !== null && typeof value === 'object'
7
+ ? Object.entries(value).some(([key, inner]) => /costMicros/i.test(key) || hasCostKey(inner))
8
+ : false;
9
+ describe('dataset contracts', () => {
10
+ it('names every dataset by its versioned id', () => {
11
+ for (const id of DATASET_IDS) {
12
+ const { name, version } = DATASETS[id];
13
+ expect(id).toBe(`${name}@${version}`);
14
+ }
15
+ });
16
+ it('refuses a bare name, an unknown version and an unknown name', () => {
17
+ expect(parseDatasetId('usage.daily@1')).toBe('usage.daily@1');
18
+ expect(parseDatasetId('usage.daily')).toBeNull();
19
+ expect(parseDatasetId('usage.daily@2')).toBeNull();
20
+ expect(parseDatasetId('usage.everything@1')).toBeNull();
21
+ expect(parseDatasetId(7)).toBeNull();
22
+ });
23
+ it('takes no parameters, so nothing a page declares changes a read', () => {
24
+ for (const id of DATASET_IDS) {
25
+ expect(v.is(DATASETS[id].params, {})).toBe(true);
26
+ expect(v.is(DATASETS[id].params, { userId: 'someone-else' })).toBe(false);
27
+ }
28
+ });
29
+ it('refuses a cost figure in the locked form', () => {
30
+ const day = {
31
+ day: '2026-06-01',
32
+ inputTokens: 1,
33
+ outputTokens: 1,
34
+ cacheReadTokens: 1,
35
+ cacheWriteTokens: 1,
36
+ totalTokens: 4,
37
+ };
38
+ const totals = { ...day, hasUnknownModelCost: false };
39
+ delete totals['day'];
40
+ const locked = { days: [day], totals };
41
+ expect(v.is(DATASETS['usage.daily@1'].locked, locked)).toBe(true);
42
+ expect(v.is(DATASETS['usage.daily@1'].locked, {
43
+ ...locked,
44
+ days: [{ ...day, costMicros: 5 }],
45
+ })).toBe(false);
46
+ expect(v.is(DATASETS['usage.daily@1'].locked, {
47
+ ...locked,
48
+ totals: { ...totals, costMicros: 5 },
49
+ })).toBe(false);
50
+ });
51
+ it('lets a reader take a field it does not know, so an older reader keeps working', () => {
52
+ const payload = structuredClone(DATASET_SAMPLES['usage.byModel@1']);
53
+ payload.data.models[0]['addedLater'] = true;
54
+ expect(v.is(datasetPayloadSchema('usage.byModel@1'), payload)).toBe(true);
55
+ });
56
+ describe.each(DATASET_IDS)('the published sample of %s', (id) => {
57
+ const sample = DATASET_SAMPLES[id];
58
+ it('parses as a payload of that dataset', () => {
59
+ expect(v.is(datasetPayloadSchema(id), sample)).toBe(true);
60
+ });
61
+ it('carries no dollar figure', () => {
62
+ expect(sample.costLocked).toBe(true);
63
+ expect(hasCostKey(sample.data)).toBe(false);
64
+ expect(v.is(DATASETS[id].locked, sample.data)).toBe(true);
65
+ });
66
+ it('covers its span, oldest day first', () => {
67
+ const days = 'days' in sample.data ? sample.data.days.map((d) => d.day) : null;
68
+ if (!days)
69
+ return;
70
+ expect(days).toHaveLength(DATASETS[id].spanDays);
71
+ expect(days[0]).toBe(sample.range.from);
72
+ expect(days.at(-1)).toBe(sample.range.to);
73
+ expect([...days].sort()).toEqual(days);
74
+ });
75
+ });
76
+ });
77
+ //# sourceMappingURL=datasets.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datasets.test.js","sourceRoot":"","sources":["../src/datasets.test.ts"],"names":[],"mappings":"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"}
@@ -17,6 +17,7 @@
17
17
  * `<script>` still apply, and a CSP `<meta>` of its own, now outside the head,
18
18
  * cannot loosen ours (a later policy can only ever add restrictions anyway).
19
19
  */
20
+ import { type FrameRuntimeData } from './frameRuntime.js';
20
21
  /**
21
22
  * The `sandbox` attribute of every frame that runs one of these documents.
22
23
  * Scripts and nothing else: no `allow-same-origin`, so the frame's origin is
@@ -43,11 +44,15 @@ export declare const FRAME_SCRIPT_HOSTS: readonly ["https://cdnjs.cloudflare.com
43
44
  *
44
45
  * - `connect-src 'none'` (by `default-src`): a page loads code but cannot fetch,
45
46
  * XHR, open a WebSocket or send a beacon. Images are limited to inline data
46
- * for the same reason: a remote `<img>` is a request. **CSP does not govern
47
- * navigation**, so a page that navigates itself can still carry its own
48
- * content out in the URL; the dashboard ends the frame when that load lands,
49
- * and the live HTML frames plan's *Navigation ends the frame* states that
50
- * residual window. The frame holds nothing of the dashboard's to carry.
47
+ * for the same reason: a remote `<img>` is a request.
48
+ * - `frame-src 'none'`, stated rather than left to `default-src`: it is what
49
+ * stops a page navigating *itself*. A browser checks a nested frame's every
50
+ * navigation, its own included, against its embedder's `frame-src`, so a
51
+ * frame mounted by a document carrying this policy (the frame relay) can
52
+ * navigate nowhere that needs a request, before or after it has loaded. A
53
+ * frame mounted by a page without it can still carry its own content out in
54
+ * a URL; the live HTML frames plan's *Navigation ends the frame* states that
55
+ * window. A page's own nested frames are refused the same way.
51
56
  * - `'unsafe-eval'` beside `'unsafe-inline'`: inline script is the whole point
52
57
  * of a prototype, and in-browser JSX and template compilers need eval. Eval
53
58
  * grants nothing inline script did not.
@@ -65,6 +70,14 @@ export type FrameDocumentOptions = {
65
70
  * contain a `</script` (the layer's generator refuses one).
66
71
  */
67
72
  layer?: string;
73
+ /**
74
+ * What a dashboard page runs against (`frameRuntime.ts`): the locale and,
75
+ * when the host's gate let this page hold them, the viewer's live datasets.
76
+ * Read only for a page that pins a runtime this build serves, which then
77
+ * gets `window.mossbear` whether or not this is passed: without it, every
78
+ * declared dataset reads as its sample, as in the CLI's preview.
79
+ */
80
+ data?: FrameRuntimeData;
68
81
  };
69
82
  /** Wrap an agent-written page in the frame's fixed head. Pure: same in, same out. */
70
83
  export declare function buildFrameDocument(html: string, options: FrameDocumentOptions): string;
@@ -1 +1 @@
1
- {"version":3,"file":"frameDocument.d.ts","sourceRoot":"","sources":["../src/frameDocument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAE5C,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2JAMrB,CAAA;AAEV;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,QASV,CAAA;AA2DZ,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,CAAA;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAWtF"}
1
+ {"version":3,"file":"frameDocument.d.ts","sourceRoot":"","sources":["../src/frameDocument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAE5C,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2JAMrB,CAAA;AAEV;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,QAUV,CAAA;AAsEZ,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,CAAA;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB,CAAA;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAatF"}
@@ -18,6 +18,7 @@
18
18
  * cannot loosen ours (a later policy can only ever add restrictions anyway).
19
19
  */
20
20
  import { FRAME_HOST_MESSAGE_SOURCE, FRAME_MESSAGE_SOURCE } from './frameProtocol.js';
21
+ import { frameRuntimeScript, readFrameManifest, } from './frameRuntime.js';
21
22
  /**
22
23
  * The `sandbox` attribute of every frame that runs one of these documents.
23
24
  * Scripts and nothing else: no `allow-same-origin`, so the frame's origin is
@@ -50,11 +51,15 @@ export const FRAME_SCRIPT_HOSTS = [
50
51
  *
51
52
  * - `connect-src 'none'` (by `default-src`): a page loads code but cannot fetch,
52
53
  * XHR, open a WebSocket or send a beacon. Images are limited to inline data
53
- * for the same reason: a remote `<img>` is a request. **CSP does not govern
54
- * navigation**, so a page that navigates itself can still carry its own
55
- * content out in the URL; the dashboard ends the frame when that load lands,
56
- * and the live HTML frames plan's *Navigation ends the frame* states that
57
- * residual window. The frame holds nothing of the dashboard's to carry.
54
+ * for the same reason: a remote `<img>` is a request.
55
+ * - `frame-src 'none'`, stated rather than left to `default-src`: it is what
56
+ * stops a page navigating *itself*. A browser checks a nested frame's every
57
+ * navigation, its own included, against its embedder's `frame-src`, so a
58
+ * frame mounted by a document carrying this policy (the frame relay) can
59
+ * navigate nowhere that needs a request, before or after it has loaded. A
60
+ * frame mounted by a page without it can still carry its own content out in
61
+ * a URL; the live HTML frames plan's *Navigation ends the frame* states that
62
+ * window. A page's own nested frames are refused the same way.
58
63
  * - `'unsafe-eval'` beside `'unsafe-inline'`: inline script is the whole point
59
64
  * of a prototype, and in-browser JSX and template compilers need eval. Eval
60
65
  * grants nothing inline script did not.
@@ -68,6 +73,7 @@ export const FRAME_CSP = [
68
73
  'font-src data: https://fonts.gstatic.com',
69
74
  'img-src data: blob:',
70
75
  'media-src data: blob:',
76
+ "frame-src 'none'",
71
77
  "base-uri 'none'",
72
78
  "form-action 'none'",
73
79
  ].join('; ');
@@ -95,8 +101,19 @@ const BASE_CSS = [
95
101
  * than the frame's own height and so could only ever grow it.
96
102
  * - **The theme arrives as a message** from the parent window, so a theme
97
103
  * change flips `data-theme` without restarting the page.
104
+ * - **WebRTC's constructors are removed.** No CSP directive governs WebRTC in
105
+ * a shipping browser, so a page could otherwise reach any STUN or TURN
106
+ * server, by name, past `connect-src 'none'`. Deleting every `RTC…` global
107
+ * before the page runs is defence in depth, not a boundary: it is code in the
108
+ * page's own window, and the live HTML frames plan records WebRTC as an open
109
+ * channel whether or not this holds. The relay's browser check sweeps the
110
+ * ways back to a constructor it knows of.
98
111
  */
99
112
  const SHELL_SCRIPT = `(function(){
113
+ Object.getOwnPropertyNames(window).concat(['RTCPeerConnection','webkitRTCPeerConnection','mozRTCPeerConnection']).forEach(function(n){
114
+ if(!/^(webkit|moz)?RTC/.test(n)||!(n in window))return;
115
+ try{delete window[n]}catch(e){}
116
+ if(n in window)try{Object.defineProperty(window,n,{value:undefined,configurable:false,writable:false})}catch(e){}});
100
117
  var S=${JSON.stringify(FRAME_MESSAGE_SOURCE)};
101
118
  function post(m){m.source=S;try{parent.postMessage(m,'*')}catch(e){}}
102
119
  function memory(){var d=Object.create(null);return{
@@ -128,12 +145,14 @@ window.addEventListener('load',report);
128
145
  })();`;
129
146
  /** Wrap an agent-written page in the frame's fixed head. Pure: same in, same out. */
130
147
  export function buildFrameDocument(html, options) {
148
+ const runtime = frameRuntimeScript(readFrameManifest(html), options.data);
131
149
  return (`<!doctype html><html data-theme="${options.theme}"><head>` +
132
150
  `<meta http-equiv="Content-Security-Policy" content="${FRAME_CSP}">` +
133
151
  '<meta charset="utf-8">' +
134
152
  '<meta name="viewport" content="width=device-width, initial-scale=1">' +
135
153
  `<style>${BASE_CSS}</style>` +
136
154
  `<script>${SHELL_SCRIPT}</script>` +
155
+ (runtime ? `<script>${runtime}</script>` : '') +
137
156
  (options.layer ? `<script>${options.layer}</script>` : '') +
138
157
  `</head><body>${html}</body></html>`);
139
158
  }
@@ -1 +1 @@
1
- {"version":3,"file":"frameDocument.js","sourceRoot":"","sources":["../src/frameDocument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAA;AAE5C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAA;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,8BAA8B;IAC9B,+BAA+B;IAC/B,mBAAmB;IACnB,6BAA6B;IAC7B,yBAAyB;CACjB,CAAA;AAEV;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,oBAAoB;IACpB,4CAA4C,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IAC1E,wDAAwD;IACxD,0CAA0C;IAC1C,qBAAqB;IACrB,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;CACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;GAGG;AACH,MAAM,QAAQ,GAAG;IACf,2BAA2B;IAC3B,6CAA6C;IAC7C,oGAAoG;CACrG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAEV;;;;;;;;;;;;;;;GAeG;AACH,MAAM,YAAY,GAAG;QACb,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;QAqBpC,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC;;;;;;;MAO3C,CAAA;AAeN,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAA6B;IAC5E,OAAO,CACL,oCAAoC,OAAO,CAAC,KAAK,UAAU;QAC3D,uDAAuD,SAAS,IAAI;QACpE,wBAAwB;QACxB,sEAAsE;QACtE,UAAU,QAAQ,UAAU;QAC5B,WAAW,YAAY,WAAW;QAClC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,gBAAgB,IAAI,gBAAgB,CACrC,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"frameDocument.js","sourceRoot":"","sources":["../src/frameDocument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAA;AAE5C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAA;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,8BAA8B;IAC9B,+BAA+B;IAC/B,mBAAmB;IACnB,6BAA6B;IAC7B,yBAAyB;CACjB,CAAA;AAEV;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,oBAAoB;IACpB,4CAA4C,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IAC1E,wDAAwD;IACxD,0CAA0C;IAC1C,qBAAqB;IACrB,uBAAuB;IACvB,kBAAkB;IAClB,iBAAiB;IACjB,oBAAoB;CACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;GAGG;AACH,MAAM,QAAQ,GAAG;IACf,2BAA2B;IAC3B,6CAA6C;IAC7C,oGAAoG;CACrG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAEV;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,YAAY,GAAG;;;;;QAKb,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;QAqBpC,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC;;;;;;;MAO3C,CAAA;AAuBN,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAA6B;IAC5E,MAAM,OAAO,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,OAAO,CACL,oCAAoC,OAAO,CAAC,KAAK,UAAU;QAC3D,uDAAuD,SAAS,IAAI;QACpE,wBAAwB;QACxB,sEAAsE;QACtE,UAAU,QAAQ,UAAU;QAC5B,WAAW,YAAY,WAAW;QAClC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,gBAAgB,IAAI,gBAAgB,CACrC,CAAA;AACH,CAAC"}
@@ -1,3 +1,4 @@
1
+ import { runInNewContext } from 'node:vm';
1
2
  import { describe, expect, it } from 'vitest';
2
3
  import { FRAME_CSP, FRAME_REFERRER_POLICY, FRAME_SANDBOX, FRAME_SCRIPT_HOSTS, buildFrameDocument, } from './frameDocument.js';
3
4
  import { FRAME_HOST_MESSAGE_SOURCE, FRAME_MESSAGE_SOURCE } from './frameProtocol.js';
@@ -14,6 +15,33 @@ describe('buildFrameDocument', () => {
14
15
  const doc = buildFrameDocument(page, { theme: 'light' });
15
16
  expect(doc.indexOf("'localStorage','sessionStorage'")).toBeLessThan(doc.indexOf(page));
16
17
  });
18
+ it('leaves the page no WebRTC constructor and keeps every other global', () => {
19
+ const doc = buildFrameDocument(page, { theme: 'light' });
20
+ const shell = doc.slice(doc.indexOf('<script>') + '<script>'.length, doc.indexOf('</script>'));
21
+ expect(doc.indexOf('</script>')).toBeLessThan(doc.indexOf(page));
22
+ const noop = () => { };
23
+ const frame = {
24
+ RTCPeerConnection: noop,
25
+ webkitRTCPeerConnection: noop,
26
+ RTCDataChannel: noop,
27
+ RTCIceCandidate: noop,
28
+ Request: noop,
29
+ addEventListener: noop,
30
+ parent: { postMessage: noop },
31
+ document: {
32
+ readyState: 'complete',
33
+ addEventListener: noop,
34
+ documentElement: {
35
+ getBoundingClientRect: () => ({ height: 0 }),
36
+ setAttribute: noop,
37
+ },
38
+ },
39
+ };
40
+ frame['window'] = frame;
41
+ runInNewContext(shell, frame);
42
+ expect(Object.keys(frame).filter((name) => /RTC/.test(name))).toEqual([]);
43
+ expect(frame['Request']).toBe(noop);
44
+ });
17
45
  it('runs the comment layer after the shell and before any of the page', () => {
18
46
  const layer = 'window.layerRan=1';
19
47
  const doc = buildFrameDocument(page, { theme: 'light', layer });
@@ -53,6 +81,9 @@ describe('FRAME_CSP', () => {
53
81
  expect(directive('form-action')).toBe("form-action 'none'");
54
82
  expect(directive('base-uri')).toBe("base-uri 'none'");
55
83
  });
84
+ it('lets a frame it governs navigate nowhere, whatever default-src becomes', () => {
85
+ expect(directive('frame-src')).toBe("frame-src 'none'");
86
+ });
56
87
  it('loads scripts from exactly the CDNs Claude artifacts allow', () => {
57
88
  expect([...FRAME_SCRIPT_HOSTS]).toEqual([
58
89
  'https://cdnjs.cloudflare.com',
@@ -1 +1 @@
1
- {"version":3,"file":"frameDocument.test.js","sourceRoot":"","sources":["../src/frameDocument.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"frameDocument.test.js","sourceRoot":"","sources":["../src/frameDocument.test.ts"],"names":[],"mappings":"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"}
@@ -8,4 +8,11 @@
8
8
  export declare const FRAME_MESSAGE_SOURCE = "mossbear-frame";
9
9
  /** Tag on every message the host posts into the frame. */
10
10
  export declare const FRAME_HOST_MESSAGE_SOURCE = "mossbear-host";
11
+ /** The path the frame relay page is served at, on its own origin. */
12
+ export declare const FRAME_RELAY_PATH = "/frame";
13
+ /**
14
+ * The longest accessible name a host may send with `render`; the relay
15
+ * refuses a longer one, and a blank one.
16
+ */
17
+ export declare const FRAME_RELAY_MAX_TITLE_CHARS = 300;
11
18
  //# sourceMappingURL=frameProtocol.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"frameProtocol.d.ts","sourceRoot":"","sources":["../src/frameProtocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,mBAAmB,CAAA;AAEpD,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,kBAAkB,CAAA"}
1
+ {"version":3,"file":"frameProtocol.d.ts","sourceRoot":"","sources":["../src/frameProtocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,mBAAmB,CAAA;AAEpD,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AAExD,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAA"}
@@ -8,4 +8,11 @@
8
8
  export const FRAME_MESSAGE_SOURCE = 'mossbear-frame';
9
9
  /** Tag on every message the host posts into the frame. */
10
10
  export const FRAME_HOST_MESSAGE_SOURCE = 'mossbear-host';
11
+ /** The path the frame relay page is served at, on its own origin. */
12
+ export const FRAME_RELAY_PATH = '/frame';
13
+ /**
14
+ * The longest accessible name a host may send with `render`; the relay
15
+ * refuses a longer one, and a blank one.
16
+ */
17
+ export const FRAME_RELAY_MAX_TITLE_CHARS = 300;
11
18
  //# sourceMappingURL=frameProtocol.js.map