@mossbear/protocol 0.1.0-alpha.100
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/LICENSE +21 -0
- package/README.md +7 -0
- package/dist/agentGuidancePaths.d.ts +101 -0
- package/dist/agentGuidancePaths.d.ts.map +1 -0
- package/dist/agentGuidancePaths.js +185 -0
- package/dist/agentGuidancePaths.js.map +1 -0
- package/dist/agentGuidancePaths.test.d.ts +2 -0
- package/dist/agentGuidancePaths.test.d.ts.map +1 -0
- package/dist/agentGuidancePaths.test.js +91 -0
- package/dist/agentGuidancePaths.test.js.map +1 -0
- package/dist/aliasPaths.d.ts +100 -0
- package/dist/aliasPaths.d.ts.map +1 -0
- package/dist/aliasPaths.js +148 -0
- package/dist/aliasPaths.js.map +1 -0
- package/dist/aliasPaths.test.d.ts +2 -0
- package/dist/aliasPaths.test.d.ts.map +1 -0
- package/dist/aliasPaths.test.js +80 -0
- package/dist/aliasPaths.test.js.map +1 -0
- package/dist/artifact.test.d.ts +2 -0
- package/dist/artifact.test.d.ts.map +1 -0
- package/dist/artifact.test.js +374 -0
- package/dist/artifact.test.js.map +1 -0
- package/dist/bundleSlug.d.ts +177 -0
- package/dist/bundleSlug.d.ts.map +1 -0
- package/dist/bundleSlug.js +233 -0
- package/dist/bundleSlug.js.map +1 -0
- package/dist/bundleSlug.test.d.ts +2 -0
- package/dist/bundleSlug.test.d.ts.map +1 -0
- package/dist/bundleSlug.test.js +197 -0
- package/dist/bundleSlug.test.js.map +1 -0
- package/dist/commentAnchor.d.ts +34 -0
- package/dist/commentAnchor.d.ts.map +1 -0
- package/dist/commentAnchor.js +122 -0
- package/dist/commentAnchor.js.map +1 -0
- package/dist/commentAnchor.test.d.ts +2 -0
- package/dist/commentAnchor.test.d.ts.map +1 -0
- package/dist/commentAnchor.test.js +48 -0
- package/dist/commentAnchor.test.js.map +1 -0
- package/dist/contextKinds.d.ts +165 -0
- package/dist/contextKinds.d.ts.map +1 -0
- package/dist/contextKinds.js +148 -0
- package/dist/contextKinds.js.map +1 -0
- package/dist/contextKinds.test.d.ts +2 -0
- package/dist/contextKinds.test.d.ts.map +1 -0
- package/dist/contextKinds.test.js +137 -0
- package/dist/contextKinds.test.js.map +1 -0
- package/dist/frameDocument.d.ts +71 -0
- package/dist/frameDocument.d.ts.map +1 -0
- package/dist/frameDocument.js +140 -0
- package/dist/frameDocument.js.map +1 -0
- package/dist/frameDocument.test.d.ts +2 -0
- package/dist/frameDocument.test.d.ts.map +1 -0
- package/dist/frameDocument.test.js +84 -0
- package/dist/frameDocument.test.js.map +1 -0
- package/dist/frameProtocol.d.ts +11 -0
- package/dist/frameProtocol.d.ts.map +1 -0
- package/dist/frameProtocol.js +11 -0
- package/dist/frameProtocol.js.map +1 -0
- package/dist/index.d.ts +24 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +24 -0
- package/dist/index.js.map +1 -0
- package/dist/limits.d.ts +19 -0
- package/dist/limits.d.ts.map +1 -0
- package/dist/limits.js +19 -0
- package/dist/limits.js.map +1 -0
- package/dist/markdownSections.d.ts +58 -0
- package/dist/markdownSections.d.ts.map +1 -0
- package/dist/markdownSections.js +102 -0
- package/dist/markdownSections.js.map +1 -0
- package/dist/markdownSections.test.d.ts +2 -0
- package/dist/markdownSections.test.d.ts.map +1 -0
- package/dist/markdownSections.test.js +95 -0
- package/dist/markdownSections.test.js.map +1 -0
- package/dist/pairing.d.ts +183 -0
- package/dist/pairing.d.ts.map +1 -0
- package/dist/pairing.js +175 -0
- package/dist/pairing.js.map +1 -0
- package/dist/pairing.test.d.ts +2 -0
- package/dist/pairing.test.d.ts.map +1 -0
- package/dist/pairing.test.js +105 -0
- package/dist/pairing.test.js.map +1 -0
- package/dist/photos.d.ts +146 -0
- package/dist/photos.d.ts.map +1 -0
- package/dist/photos.js +127 -0
- package/dist/photos.js.map +1 -0
- package/dist/publicModelCatalog.d.ts +19 -0
- package/dist/publicModelCatalog.d.ts.map +1 -0
- package/dist/publicModelCatalog.generated.d.ts +2 -0
- package/dist/publicModelCatalog.generated.d.ts.map +1 -0
- package/dist/publicModelCatalog.generated.js +489 -0
- package/dist/publicModelCatalog.generated.js.map +1 -0
- package/dist/publicModelCatalog.js +68 -0
- package/dist/publicModelCatalog.js.map +1 -0
- package/dist/publicModelCatalog.test.d.ts +2 -0
- package/dist/publicModelCatalog.test.d.ts.map +1 -0
- package/dist/publicModelCatalog.test.js +88 -0
- package/dist/publicModelCatalog.test.js.map +1 -0
- package/dist/publicModelNativeAliases.d.ts +5 -0
- package/dist/publicModelNativeAliases.d.ts.map +1 -0
- package/dist/publicModelNativeAliases.js +8 -0
- package/dist/publicModelNativeAliases.js.map +1 -0
- package/dist/schemas.d.ts +10745 -0
- package/dist/schemas.d.ts.map +1 -0
- package/dist/schemas.js +4572 -0
- package/dist/schemas.js.map +1 -0
- package/dist/schemas.test.d.ts +2 -0
- package/dist/schemas.test.d.ts.map +1 -0
- package/dist/schemas.test.js +1617 -0
- package/dist/schemas.test.js.map +1 -0
- package/dist/steeringOverTime.d.ts +30 -0
- package/dist/steeringOverTime.d.ts.map +1 -0
- package/dist/steeringOverTime.js +19 -0
- package/dist/steeringOverTime.js.map +1 -0
- package/dist/types.d.ts +109 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +12 -0
- package/dist/types.js.map +1 -0
- package/dist/usageOnly.d.ts +190 -0
- package/dist/usageOnly.d.ts.map +1 -0
- package/dist/usageOnly.js +53 -0
- package/dist/usageOnly.js.map +1 -0
- package/dist/usageOnly.test.d.ts +2 -0
- package/dist/usageOnly.test.d.ts.map +1 -0
- package/dist/usageOnly.test.js +203 -0
- package/dist/usageOnly.test.js.map +1 -0
- package/dist/version.d.ts +47 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +125 -0
- package/dist/version.js.map +1 -0
- package/dist/version.test.d.ts +2 -0
- package/dist/version.test.d.ts.map +1 -0
- package/dist/version.test.js +86 -0
- package/dist/version.test.js.map +1 -0
- package/dist/whatSyncs.d.ts +62 -0
- package/dist/whatSyncs.d.ts.map +1 -0
- package/dist/whatSyncs.js +228 -0
- package/dist/whatSyncs.js.map +1 -0
- package/dist/whatSyncs.test.d.ts +2 -0
- package/dist/whatSyncs.test.d.ts.map +1 -0
- package/dist/whatSyncs.test.js +113 -0
- package/dist/whatSyncs.test.js.map +1 -0
- package/package.json +52 -0
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import * as v from 'valibot';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import { PublicModelIdSchema } from './publicModelCatalog.js';
|
|
4
|
+
import { MAX_USAGE_ONLY_TOKENS, parseUsageOnlySyncRequest, UsageOnlySyncRequestSchema, } from './usageOnly.js';
|
|
5
|
+
const payload = () => ({
|
|
6
|
+
version: 2,
|
|
7
|
+
mode: 'usage-only',
|
|
8
|
+
sessions: [
|
|
9
|
+
{
|
|
10
|
+
sessionKey: 'a'.repeat(64),
|
|
11
|
+
harness: 'codex',
|
|
12
|
+
startedAt: 1_700_000_000_000,
|
|
13
|
+
snapshotSequence: 1,
|
|
14
|
+
endedAt: 1_700_000_001_000,
|
|
15
|
+
usage: [
|
|
16
|
+
{
|
|
17
|
+
model: 'unknown',
|
|
18
|
+
inputTokens: 10,
|
|
19
|
+
outputTokens: 2,
|
|
20
|
+
cacheReadTokens: 5,
|
|
21
|
+
cacheWriteTokens: 3,
|
|
22
|
+
},
|
|
23
|
+
],
|
|
24
|
+
},
|
|
25
|
+
],
|
|
26
|
+
});
|
|
27
|
+
describe('usage-only wire boundary', () => {
|
|
28
|
+
it('preserves many distinct occurrences of one public model and rejects duplicate instants', () => {
|
|
29
|
+
const data = payload();
|
|
30
|
+
data.sessions[0].usage = Array.from({ length: 1_200 }, (_, i) => ({
|
|
31
|
+
...data.sessions[0].usage[0],
|
|
32
|
+
occurredAt: data.sessions[0].startedAt + i,
|
|
33
|
+
}));
|
|
34
|
+
expect(parseUsageOnlySyncRequest(data).sessions[0].usage).toHaveLength(1_200);
|
|
35
|
+
data.sessions[0].usage.push(data.sessions[0].usage[0]);
|
|
36
|
+
expect(() => parseUsageOnlySyncRequest(data)).toThrow('Invalid usage-only payload');
|
|
37
|
+
});
|
|
38
|
+
it.each([-1, 0.5, Infinity, NaN, 'private timestamp', 8_640_000_000_000_001])('rejects invalid occurrence %s', (occurredAt) => {
|
|
39
|
+
const data = payload();
|
|
40
|
+
Object.assign(data.sessions[0].usage[0], { occurredAt });
|
|
41
|
+
expect(() => parseUsageOnlySyncRequest(data)).toThrow('Invalid usage-only payload');
|
|
42
|
+
});
|
|
43
|
+
it('accepts open and completed snapshots without behavioral evidence', () => {
|
|
44
|
+
expect(parseUsageOnlySyncRequest(payload())).toEqual(payload());
|
|
45
|
+
const open = payload();
|
|
46
|
+
Reflect.deleteProperty(open.sessions[0], 'endedAt');
|
|
47
|
+
expect(parseUsageOnlySyncRequest(open).sessions[0]).not.toHaveProperty('endedAt');
|
|
48
|
+
});
|
|
49
|
+
it.each([
|
|
50
|
+
'actions',
|
|
51
|
+
'turns',
|
|
52
|
+
'skillUsage',
|
|
53
|
+
'ruleManifest',
|
|
54
|
+
'guideSuggestions',
|
|
55
|
+
'commitAnchor',
|
|
56
|
+
'selfReport',
|
|
57
|
+
'cliVersion',
|
|
58
|
+
'userId',
|
|
59
|
+
'workspaceId',
|
|
60
|
+
'metadata',
|
|
61
|
+
])('rejects %s on the envelope rather than stripping it', (field) => {
|
|
62
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, { ...payload(), [field]: 'secret' }).success).toBe(false);
|
|
63
|
+
});
|
|
64
|
+
it.each([
|
|
65
|
+
'agentSessionId',
|
|
66
|
+
'sessionId',
|
|
67
|
+
'repoId',
|
|
68
|
+
'projectId',
|
|
69
|
+
'summary',
|
|
70
|
+
'command',
|
|
71
|
+
'filePaths',
|
|
72
|
+
'branch',
|
|
73
|
+
'narration',
|
|
74
|
+
'metadata',
|
|
75
|
+
])('rejects %s on a session', (field) => {
|
|
76
|
+
const data = payload();
|
|
77
|
+
Object.assign(data.sessions[0], { [field]: 'secret' });
|
|
78
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
79
|
+
});
|
|
80
|
+
it.each(['provider', 'skillName', 'metadata', 'toolResult'])('rejects %s on usage', (field) => {
|
|
81
|
+
const data = payload();
|
|
82
|
+
Object.assign(data.sessions[0].usage[0], { [field]: 'secret' });
|
|
83
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
84
|
+
});
|
|
85
|
+
it('uses separate public catalog data to validate labels without a wire enum', () => {
|
|
86
|
+
for (const model of [
|
|
87
|
+
'google/gemini-2.5-pro',
|
|
88
|
+
'deepseek/deepseek-r1',
|
|
89
|
+
'qwen/qwen3-coder',
|
|
90
|
+
]) {
|
|
91
|
+
const data = payload();
|
|
92
|
+
data.sessions[0].usage[0].model = model;
|
|
93
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(true);
|
|
94
|
+
expect(parseUsageOnlySyncRequest(data)).toEqual(data);
|
|
95
|
+
}
|
|
96
|
+
// Syntax alone cannot prove that a label is public.
|
|
97
|
+
const privateLabel = payload();
|
|
98
|
+
privateLabel.sessions[0].usage[0].model = 'customer-secret-model';
|
|
99
|
+
expect(v.is(PublicModelIdSchema, privateLabel.sessions[0].usage[0].model)).toBe(true);
|
|
100
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, privateLabel).success).toBe(false);
|
|
101
|
+
expect(() => parseUsageOnlySyncRequest(privateLabel)).toThrow('Invalid usage-only payload');
|
|
102
|
+
privateLabel.sessions[0].usage[0].model = 'gpt-4o';
|
|
103
|
+
expect(() => parseUsageOnlySyncRequest(privateLabel)).toThrow('Invalid usage-only payload');
|
|
104
|
+
const custom = payload();
|
|
105
|
+
custom.sessions[0].usage[0].model = '/private/customer/model';
|
|
106
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, custom).success).toBe(false);
|
|
107
|
+
const harness = payload();
|
|
108
|
+
harness.sessions[0].harness = 'custom-secret-harness';
|
|
109
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, harness).success).toBe(false);
|
|
110
|
+
});
|
|
111
|
+
it('bounds model identifiers without embedding a catalog enum', () => {
|
|
112
|
+
for (const model of ['', 'model with spaces', 'model\nsecret', 'x'.repeat(201)]) {
|
|
113
|
+
const data = payload();
|
|
114
|
+
data.sessions[0].usage[0].model = model;
|
|
115
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
116
|
+
}
|
|
117
|
+
});
|
|
118
|
+
it('rejects invalid counts in each token class', () => {
|
|
119
|
+
for (const field of [
|
|
120
|
+
'inputTokens',
|
|
121
|
+
'outputTokens',
|
|
122
|
+
'cacheReadTokens',
|
|
123
|
+
'cacheWriteTokens',
|
|
124
|
+
]) {
|
|
125
|
+
for (const count of [
|
|
126
|
+
-1,
|
|
127
|
+
0.5,
|
|
128
|
+
NaN,
|
|
129
|
+
Infinity,
|
|
130
|
+
MAX_USAGE_ONLY_TOKENS + 1,
|
|
131
|
+
'10',
|
|
132
|
+
null,
|
|
133
|
+
]) {
|
|
134
|
+
const data = payload();
|
|
135
|
+
Object.assign(data.sessions[0].usage[0], { [field]: count });
|
|
136
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
});
|
|
140
|
+
it('rejects impossible dates, reversed dates and raw session identifiers', () => {
|
|
141
|
+
for (const startedAt of [-1, 0.5, NaN, Infinity, 8_640_000_000_000_001, 'secret']) {
|
|
142
|
+
const data = payload();
|
|
143
|
+
Object.assign(data.sessions[0], { startedAt });
|
|
144
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
145
|
+
}
|
|
146
|
+
const reversed = payload();
|
|
147
|
+
reversed.sessions[0].endedAt = reversed.sessions[0].startedAt - 1;
|
|
148
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, reversed).success).toBe(false);
|
|
149
|
+
for (const sessionKey of ['raw-session-id', 'a'.repeat(63), 'A'.repeat(64)]) {
|
|
150
|
+
const data = payload();
|
|
151
|
+
data.sessions[0].sessionKey = sessionKey;
|
|
152
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
153
|
+
}
|
|
154
|
+
});
|
|
155
|
+
it('rejects empty batches, empty usage, duplicate keys and duplicate models', () => {
|
|
156
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, { ...payload(), sessions: [] }).success).toBe(false);
|
|
157
|
+
const empty = payload();
|
|
158
|
+
empty.sessions[0].usage = [];
|
|
159
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, empty).success).toBe(false);
|
|
160
|
+
const duplicate = payload();
|
|
161
|
+
duplicate.sessions.push(structuredClone(duplicate.sessions[0]));
|
|
162
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, duplicate).success).toBe(false);
|
|
163
|
+
const models = payload();
|
|
164
|
+
models.sessions[0].usage.push({ ...models.sessions[0].usage[0] });
|
|
165
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, models).success).toBe(false);
|
|
166
|
+
});
|
|
167
|
+
it('rejects oversized batches and unsupported contract versions', () => {
|
|
168
|
+
const data = payload();
|
|
169
|
+
data.sessions = Array.from({ length: 101 }, (_, index) => ({
|
|
170
|
+
...data.sessions[0],
|
|
171
|
+
sessionKey: index.toString(16).padStart(64, '0'),
|
|
172
|
+
}));
|
|
173
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
174
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, { ...payload(), version: 1 }).success).toBe(false);
|
|
175
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, { ...payload(), mode: 'hosted' }).success).toBe(false);
|
|
176
|
+
});
|
|
177
|
+
it('requires a bounded positive integer sequence for complete snapshots', () => {
|
|
178
|
+
for (const snapshotSequence of [
|
|
179
|
+
undefined,
|
|
180
|
+
0,
|
|
181
|
+
-1,
|
|
182
|
+
0.5,
|
|
183
|
+
Infinity,
|
|
184
|
+
MAX_USAGE_ONLY_TOKENS + 1,
|
|
185
|
+
]) {
|
|
186
|
+
const data = payload();
|
|
187
|
+
Object.assign(data.sessions[0], { snapshotSequence });
|
|
188
|
+
expect(v.safeParse(UsageOnlySyncRequestSchema, data).success).toBe(false);
|
|
189
|
+
}
|
|
190
|
+
});
|
|
191
|
+
it('keeps rejected private values out of thrown validation errors', () => {
|
|
192
|
+
expect(() => parseUsageOnlySyncRequest({ ...payload(), secret: 'synthetic-private-text' })).toThrow('Invalid usage-only payload');
|
|
193
|
+
try {
|
|
194
|
+
parseUsageOnlySyncRequest({ ...payload(), secret: 'synthetic-private-text' });
|
|
195
|
+
}
|
|
196
|
+
catch (error) {
|
|
197
|
+
expect(JSON.stringify(error)).not.toContain('synthetic-private-text');
|
|
198
|
+
expect(String(error)).not.toContain('synthetic-private-text');
|
|
199
|
+
expect(error).not.toHaveProperty('issues');
|
|
200
|
+
}
|
|
201
|
+
});
|
|
202
|
+
});
|
|
203
|
+
//# sourceMappingURL=usageOnly.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"usageOnly.test.js","sourceRoot":"","sources":["../src/usageOnly.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Minimal semver parsing/comparison.
|
|
3
|
+
*
|
|
4
|
+
* Hand-rolled rather than pulling in a `semver` dependency: the only versions
|
|
5
|
+
* this ever compares are the ones the release pipeline produces — `x.y.z` and
|
|
6
|
+
* `x.y.z-<channel>.<n>`. The full semver surface (build metadata, ranges,
|
|
7
|
+
* coercion) is unused weight here.
|
|
8
|
+
*
|
|
9
|
+
* This lives in `protocol` rather than the CLI because both sides of the
|
|
10
|
+
* transport now need to order versions: the CLI to decide whether an update is
|
|
11
|
+
* available, and the server to decide whether a client is below the
|
|
12
|
+
* advertised floor (`cli-self-update-plan.md` §6). One definition so the two
|
|
13
|
+
* can never disagree about which of two releases is older.
|
|
14
|
+
*/
|
|
15
|
+
export type ParsedVersion = {
|
|
16
|
+
major: number;
|
|
17
|
+
minor: number;
|
|
18
|
+
patch: number;
|
|
19
|
+
/** Dot-separated prerelease identifiers; empty for a stable release. */
|
|
20
|
+
prerelease: string[];
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Parse `x.y.z` / `x.y.z-alpha.3` into its parts. Returns null for anything
|
|
24
|
+
* unparseable — callers treat that as "cannot compare" and stay silent rather
|
|
25
|
+
* than guessing, since a bad compare would nag the user about a nonexistent
|
|
26
|
+
* update (CLI) or refuse a sync it cannot justify refusing (server).
|
|
27
|
+
*/
|
|
28
|
+
export declare function parseVersion(value: string): ParsedVersion | null;
|
|
29
|
+
/**
|
|
30
|
+
* Compare two version strings: negative when `a` precedes `b`, 0 when equal,
|
|
31
|
+
* positive when `a` follows `b`. Unparseable versions sort as equal (0) so a
|
|
32
|
+
* malformed registry response can never be read as "an update is available",
|
|
33
|
+
* and an unparseable client version can never be read as "below the floor".
|
|
34
|
+
*/
|
|
35
|
+
export declare function compareVersions(a: string, b: string): number;
|
|
36
|
+
/**
|
|
37
|
+
* True only when `version` is *definitely* older than `floor`.
|
|
38
|
+
*
|
|
39
|
+
* Every uncertain case answers false — an absent version (older clients do not
|
|
40
|
+
* send one), an unparseable version on either side, or a floor that is itself
|
|
41
|
+
* malformed. This is the fail-open rule from `cli-self-update-plan.md` §6: the
|
|
42
|
+
* floor is a hard stop that refuses a client outright, so triggering it on
|
|
43
|
+
* uncertainty would turn one bad deploy-time constant into a total sync outage.
|
|
44
|
+
* Block only on a comparison that actually ordered.
|
|
45
|
+
*/
|
|
46
|
+
export declare function isBelowVersionFloor(version: string | undefined | null, floor: string | undefined | null): boolean;
|
|
47
|
+
//# sourceMappingURL=version.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAUD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoBhE;AA8BD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC/B,OAAO,CAIT"}
|
package/dist/version.js
ADDED
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Minimal semver parsing/comparison.
|
|
3
|
+
*
|
|
4
|
+
* Hand-rolled rather than pulling in a `semver` dependency: the only versions
|
|
5
|
+
* this ever compares are the ones the release pipeline produces — `x.y.z` and
|
|
6
|
+
* `x.y.z-<channel>.<n>`. The full semver surface (build metadata, ranges,
|
|
7
|
+
* coercion) is unused weight here.
|
|
8
|
+
*
|
|
9
|
+
* This lives in `protocol` rather than the CLI because both sides of the
|
|
10
|
+
* transport now need to order versions: the CLI to decide whether an update is
|
|
11
|
+
* available, and the server to decide whether a client is below the
|
|
12
|
+
* advertised floor (`cli-self-update-plan.md` §6). One definition so the two
|
|
13
|
+
* can never disagree about which of two releases is older.
|
|
14
|
+
*/
|
|
15
|
+
const VERSION_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
|
|
16
|
+
/** A semver numeric identifier: digits with no leading zero (bare `0` is fine). */
|
|
17
|
+
function isNumericIdentifier(value) {
|
|
18
|
+
if (!value)
|
|
19
|
+
return false;
|
|
20
|
+
return value === '0' || !value.startsWith('0');
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Parse `x.y.z` / `x.y.z-alpha.3` into its parts. Returns null for anything
|
|
24
|
+
* unparseable — callers treat that as "cannot compare" and stay silent rather
|
|
25
|
+
* than guessing, since a bad compare would nag the user about a nonexistent
|
|
26
|
+
* update (CLI) or refuse a sync it cannot justify refusing (server).
|
|
27
|
+
*/
|
|
28
|
+
export function parseVersion(value) {
|
|
29
|
+
const match = VERSION_RE.exec(value.trim());
|
|
30
|
+
if (!match)
|
|
31
|
+
return null;
|
|
32
|
+
// Semver forbids leading zeros in numeric identifiers, and accepting them
|
|
33
|
+
// here would quietly read a typo as a real version: `01.0.0` would parse as
|
|
34
|
+
// 1.0.0 and a floor mistyped that way would refuse every 0.x client instead
|
|
35
|
+
// of failing open the way a malformed floor is documented to.
|
|
36
|
+
if (!isNumericIdentifier(match[1]) || !isNumericIdentifier(match[2]))
|
|
37
|
+
return null;
|
|
38
|
+
if (!isNumericIdentifier(match[3]))
|
|
39
|
+
return null;
|
|
40
|
+
const prerelease = match[4] ? match[4].split('.') : [];
|
|
41
|
+
// A prerelease segment must not be empty ("1.0.0-" or "1.0.0-a..b"), and a
|
|
42
|
+
// numeric one is subject to the same no-leading-zeros rule.
|
|
43
|
+
if (prerelease.some((id) => id === ''))
|
|
44
|
+
return null;
|
|
45
|
+
if (prerelease.some((id) => /^\d+$/.test(id) && !isNumericIdentifier(id)))
|
|
46
|
+
return null;
|
|
47
|
+
return {
|
|
48
|
+
major: Number(match[1]),
|
|
49
|
+
minor: Number(match[2]),
|
|
50
|
+
patch: Number(match[3]),
|
|
51
|
+
prerelease,
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
/** Compare two prerelease identifier lists per semver §11: numeric < alphanumeric. */
|
|
55
|
+
function comparePrerelease(a, b) {
|
|
56
|
+
// A version WITHOUT a prerelease outranks one with (1.0.0 > 1.0.0-alpha.1).
|
|
57
|
+
if (a.length === 0 && b.length === 0)
|
|
58
|
+
return 0;
|
|
59
|
+
if (a.length === 0)
|
|
60
|
+
return 1;
|
|
61
|
+
if (b.length === 0)
|
|
62
|
+
return -1;
|
|
63
|
+
for (let i = 0; i < Math.max(a.length, b.length); i++) {
|
|
64
|
+
const idA = a[i];
|
|
65
|
+
const idB = b[i];
|
|
66
|
+
// A shorter set of identifiers ranks lower when all preceding are equal.
|
|
67
|
+
if (idA === undefined)
|
|
68
|
+
return -1;
|
|
69
|
+
if (idB === undefined)
|
|
70
|
+
return 1;
|
|
71
|
+
const numA = /^\d+$/.test(idA) ? Number(idA) : null;
|
|
72
|
+
const numB = /^\d+$/.test(idB) ? Number(idB) : null;
|
|
73
|
+
if (numA !== null && numB !== null) {
|
|
74
|
+
if (numA !== numB)
|
|
75
|
+
return numA < numB ? -1 : 1;
|
|
76
|
+
}
|
|
77
|
+
else if (numA !== null) {
|
|
78
|
+
return -1; // numeric identifiers always rank lower than alphanumeric
|
|
79
|
+
}
|
|
80
|
+
else if (numB !== null) {
|
|
81
|
+
return 1;
|
|
82
|
+
}
|
|
83
|
+
else if (idA !== idB) {
|
|
84
|
+
return idA < idB ? -1 : 1;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return 0;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Compare two version strings: negative when `a` precedes `b`, 0 when equal,
|
|
91
|
+
* positive when `a` follows `b`. Unparseable versions sort as equal (0) so a
|
|
92
|
+
* malformed registry response can never be read as "an update is available",
|
|
93
|
+
* and an unparseable client version can never be read as "below the floor".
|
|
94
|
+
*/
|
|
95
|
+
export function compareVersions(a, b) {
|
|
96
|
+
const pa = parseVersion(a);
|
|
97
|
+
const pb = parseVersion(b);
|
|
98
|
+
if (!pa || !pb)
|
|
99
|
+
return 0;
|
|
100
|
+
if (pa.major !== pb.major)
|
|
101
|
+
return pa.major < pb.major ? -1 : 1;
|
|
102
|
+
if (pa.minor !== pb.minor)
|
|
103
|
+
return pa.minor < pb.minor ? -1 : 1;
|
|
104
|
+
if (pa.patch !== pb.patch)
|
|
105
|
+
return pa.patch < pb.patch ? -1 : 1;
|
|
106
|
+
return comparePrerelease(pa.prerelease, pb.prerelease);
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* True only when `version` is *definitely* older than `floor`.
|
|
110
|
+
*
|
|
111
|
+
* Every uncertain case answers false — an absent version (older clients do not
|
|
112
|
+
* send one), an unparseable version on either side, or a floor that is itself
|
|
113
|
+
* malformed. This is the fail-open rule from `cli-self-update-plan.md` §6: the
|
|
114
|
+
* floor is a hard stop that refuses a client outright, so triggering it on
|
|
115
|
+
* uncertainty would turn one bad deploy-time constant into a total sync outage.
|
|
116
|
+
* Block only on a comparison that actually ordered.
|
|
117
|
+
*/
|
|
118
|
+
export function isBelowVersionFloor(version, floor) {
|
|
119
|
+
if (!version || !floor)
|
|
120
|
+
return false;
|
|
121
|
+
if (!parseVersion(version) || !parseVersion(floor))
|
|
122
|
+
return false;
|
|
123
|
+
return compareVersions(version, floor) < 0;
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=version.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.test.d.ts","sourceRoot":"","sources":["../src/version.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { describe, expect, it } from 'vitest';
|
|
2
|
+
import { compareVersions, isBelowVersionFloor, parseVersion } from './version.js';
|
|
3
|
+
describe('parseVersion', () => {
|
|
4
|
+
it('parses a stable release', () => {
|
|
5
|
+
expect(parseVersion('1.2.3')).toEqual({
|
|
6
|
+
major: 1,
|
|
7
|
+
minor: 2,
|
|
8
|
+
patch: 3,
|
|
9
|
+
prerelease: [],
|
|
10
|
+
});
|
|
11
|
+
});
|
|
12
|
+
it('parses a prerelease into its identifiers', () => {
|
|
13
|
+
expect(parseVersion('0.1.0-alpha.3')).toEqual({
|
|
14
|
+
major: 0,
|
|
15
|
+
minor: 1,
|
|
16
|
+
patch: 0,
|
|
17
|
+
prerelease: ['alpha', '3'],
|
|
18
|
+
});
|
|
19
|
+
});
|
|
20
|
+
it('returns null for unparseable input', () => {
|
|
21
|
+
for (const bad of ['', 'v1.2.3', '1.2', 'latest', '1.2.3-', '1.2.3-a..b']) {
|
|
22
|
+
expect(parseVersion(bad)).toBeNull();
|
|
23
|
+
}
|
|
24
|
+
});
|
|
25
|
+
// Semver forbids leading zeros. Accepting them would read a typo as a real
|
|
26
|
+
// version — `01.0.0` as 1.0.0 — so a floor mistyped that way would refuse
|
|
27
|
+
// every 0.x client instead of failing open.
|
|
28
|
+
it('rejects leading zeros in numeric identifiers', () => {
|
|
29
|
+
for (const bad of ['01.0.0', '1.02.0', '1.0.03', '1.0.0-alpha.01']) {
|
|
30
|
+
expect(parseVersion(bad)).toBeNull();
|
|
31
|
+
}
|
|
32
|
+
});
|
|
33
|
+
it('still accepts a bare zero in any position', () => {
|
|
34
|
+
expect(parseVersion('0.0.0')).not.toBeNull();
|
|
35
|
+
expect(parseVersion('1.0.0-alpha.0')).not.toBeNull();
|
|
36
|
+
});
|
|
37
|
+
});
|
|
38
|
+
describe('compareVersions', () => {
|
|
39
|
+
it('orders by major, minor, then patch', () => {
|
|
40
|
+
expect(compareVersions('1.0.0', '2.0.0')).toBeLessThan(0);
|
|
41
|
+
expect(compareVersions('1.2.0', '1.1.0')).toBeGreaterThan(0);
|
|
42
|
+
expect(compareVersions('1.1.1', '1.1.2')).toBeLessThan(0);
|
|
43
|
+
expect(compareVersions('1.1.1', '1.1.1')).toBe(0);
|
|
44
|
+
});
|
|
45
|
+
it('ranks a prerelease below its own stable release', () => {
|
|
46
|
+
expect(compareVersions('1.0.0-alpha.1', '1.0.0')).toBeLessThan(0);
|
|
47
|
+
expect(compareVersions('1.0.0', '1.0.0-alpha.1')).toBeGreaterThan(0);
|
|
48
|
+
});
|
|
49
|
+
it('orders prerelease identifiers numerically, not lexically', () => {
|
|
50
|
+
expect(compareVersions('1.0.0-alpha.2', '1.0.0-alpha.10')).toBeLessThan(0);
|
|
51
|
+
});
|
|
52
|
+
it('treats an unparseable version as equal so it never reads as newer', () => {
|
|
53
|
+
expect(compareVersions('not-a-version', '1.0.0')).toBe(0);
|
|
54
|
+
expect(compareVersions('1.0.0', 'not-a-version')).toBe(0);
|
|
55
|
+
});
|
|
56
|
+
});
|
|
57
|
+
describe('isBelowVersionFloor', () => {
|
|
58
|
+
it('is true only when the version is definitely older than the floor', () => {
|
|
59
|
+
expect(isBelowVersionFloor('0.9.0', '1.0.0')).toBe(true);
|
|
60
|
+
expect(isBelowVersionFloor('1.0.0-alpha.1', '1.0.0')).toBe(true);
|
|
61
|
+
});
|
|
62
|
+
it('is false at or above the floor', () => {
|
|
63
|
+
expect(isBelowVersionFloor('1.0.0', '1.0.0')).toBe(false);
|
|
64
|
+
expect(isBelowVersionFloor('1.0.1', '1.0.0')).toBe(false);
|
|
65
|
+
});
|
|
66
|
+
// The fail-open rule: a hard stop must never trigger on a comparison that
|
|
67
|
+
// did not actually order, or one bad constant becomes a total sync outage.
|
|
68
|
+
it('fails open when no floor is configured', () => {
|
|
69
|
+
expect(isBelowVersionFloor('0.0.1', undefined)).toBe(false);
|
|
70
|
+
expect(isBelowVersionFloor('0.0.1', '')).toBe(false);
|
|
71
|
+
expect(isBelowVersionFloor('0.0.1', null)).toBe(false);
|
|
72
|
+
});
|
|
73
|
+
it('fails open when the client sends no version', () => {
|
|
74
|
+
expect(isBelowVersionFloor(undefined, '1.0.0')).toBe(false);
|
|
75
|
+
expect(isBelowVersionFloor('', '1.0.0')).toBe(false);
|
|
76
|
+
expect(isBelowVersionFloor(null, '1.0.0')).toBe(false);
|
|
77
|
+
});
|
|
78
|
+
it('fails open when either side is unparseable', () => {
|
|
79
|
+
expect(isBelowVersionFloor('garbage', '1.0.0')).toBe(false);
|
|
80
|
+
expect(isBelowVersionFloor('0.0.1', 'garbage')).toBe(false);
|
|
81
|
+
});
|
|
82
|
+
it('fails open on a floor mistyped with a leading zero', () => {
|
|
83
|
+
expect(isBelowVersionFloor('0.5.0', '01.0.0')).toBe(false);
|
|
84
|
+
});
|
|
85
|
+
});
|
|
86
|
+
//# sourceMappingURL=version.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.test.js","sourceRoot":"","sources":["../src/version.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEjF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;SACf,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;SAC3B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1E,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QACtC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,2EAA2E;IAC3E,0EAA0E;IAC1E,4CAA4C;IAC5C,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,CAAC;YACnE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QACtC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC5C,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;IACtD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QAC5D,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACjE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,0EAA0E;IAC1E,2EAA2E;IAC3E,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { DashboardSyncRequest } from './types.js';
|
|
2
|
+
/** Top-level keys of the CLI→server sync payload, derived from the wire type. */
|
|
3
|
+
export type SyncedPayloadKey = keyof DashboardSyncRequest;
|
|
4
|
+
/** The wire keys actually present on the schema at runtime. */
|
|
5
|
+
export declare const SYNCED_PAYLOAD_KEYS: SyncedPayloadKey[];
|
|
6
|
+
export interface SyncedCategory {
|
|
7
|
+
/** Matches a top-level key of `DashboardSyncRequestSchema`. */
|
|
8
|
+
key: SyncedPayloadKey;
|
|
9
|
+
/** What this category is, in the reader's words. */
|
|
10
|
+
label: string;
|
|
11
|
+
/** The wire field names within this payload that leave the machine. */
|
|
12
|
+
fields: string[];
|
|
13
|
+
}
|
|
14
|
+
/** What leaves the machine, in display order. */
|
|
15
|
+
export declare const SYNCED_CATEGORIES: SyncedCategory[];
|
|
16
|
+
/** Full transcript files are read locally to prepare session evidence. */
|
|
17
|
+
export type LocalOnlyKey = 'transcripts';
|
|
18
|
+
export interface LocalOnlyItem {
|
|
19
|
+
key: LocalOnlyKey;
|
|
20
|
+
label: string;
|
|
21
|
+
}
|
|
22
|
+
/** What session sync does not upload, in display order. */
|
|
23
|
+
export declare const LOCAL_ONLY_ITEMS: LocalOnlyItem[];
|
|
24
|
+
export declare const LOCAL_ONLY_KEYS: LocalOnlyKey[];
|
|
25
|
+
export interface TranscriptRule {
|
|
26
|
+
title: string;
|
|
27
|
+
body: string;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* The three rules for what is taken from a transcript, in full. These are the
|
|
31
|
+
* whole of the promise: a fourth content class would need a fourth rule here
|
|
32
|
+
* before it could ship.
|
|
33
|
+
*/
|
|
34
|
+
export declare const TRANSCRIPT_RULES: TranscriptRule[];
|
|
35
|
+
/**
|
|
36
|
+
* The framing sentences around the three lists, so the two surfaces introduce
|
|
37
|
+
* them in the same words. Product-name sentences carry the name spelled out;
|
|
38
|
+
* the dashboard substitutes its own constant when it renders them.
|
|
39
|
+
*/
|
|
40
|
+
export declare const WHAT_SYNCS_COPY: {
|
|
41
|
+
readonly intro: "Mossbear grades your sessions in the cloud, from evidence prepared on your machine. Session sync sends action metadata and redacted transcript text. Separately, linking guidance or publishing context uploads selected content, including skill member files. When a session ends in a repo subscribed to a document bundle, a subscribed document you edited locally can also be pushed back, unless other recent session activity or the bundle write settings block it. A repo that declares published paths in its current config can also publish their committed contents after a local commit that touches them. These uploads are not filtered by the transcript rules below.";
|
|
42
|
+
readonly synced: {
|
|
43
|
+
readonly title: "Leaves your machine";
|
|
44
|
+
readonly lead: "Session evidence synced to your account. Action summaries can include secret-redacted, length-capped shell command text. The field list below covers session sync, not separate guidance and context uploads.";
|
|
45
|
+
};
|
|
46
|
+
readonly transcript: {
|
|
47
|
+
readonly title: "What we take from your transcript";
|
|
48
|
+
readonly lead: "Redacted excerpts travel with actions. When a session closes, redacted user turns and the agent's closing summary can also sync. These use the same repository narration setting.";
|
|
49
|
+
readonly caveats: "Redaction uses patterns, so it is not a guarantee. Our servers can read synced content; it is not end-to-end encrypted. Run mossbear narration off in a repository to stop preparing new transcript excerpts, user turns and closing summaries there. Pending user turns from that repository are discarded. Older queued turns without repository identity are also discarded before delivery. An upload already started cannot be recalled. Update the CLI before relying on queued-turn deletion. Action metadata and selected content uploads are unaffected.";
|
|
50
|
+
};
|
|
51
|
+
readonly localOnly: {
|
|
52
|
+
readonly title: "Stays local during session sync";
|
|
53
|
+
readonly lead: "Session sync reads these files locally and sends the excerpts and usage described above, not the full files.";
|
|
54
|
+
};
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Wire-schema keys that leave the machine but aren't described in
|
|
58
|
+
* {@link SYNCED_CATEGORIES}. Non-empty means the disclosure has drifted from the
|
|
59
|
+
* protocol and must be updated. Pure — safe to assert on in tests.
|
|
60
|
+
*/
|
|
61
|
+
export declare function missingSyncDisclosureKeys(): string[];
|
|
62
|
+
//# sourceMappingURL=whatSyncs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"whatSyncs.d.ts","sourceRoot":"","sources":["../src/whatSyncs.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,MAAM,oBAAoB,CAAA;AAEzD,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,EAEpB,gBAAgB,EAAE,CAAA;AAE9B,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,GAAG,EAAE,gBAAgB,CAAA;IACrB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AA8ID,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAEL,CAAA;AAEzC,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GAAG,aAAa,CAAA;AAExC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAK3C,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,YAAY,EAA6C,CAAA;AAEvF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAa5C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAiBlB,CAAA;AAEV;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAGpD"}
|