@seriousgaming/sdk-tools 1.5.0 → 1.6.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/bundling/ui-bundler.d.ts +12 -0
- package/dist/cli-25RWY5BQ.js +41 -0
- package/dist/cli-272KBNJH.js +97 -0
- package/dist/cli-2BH7FX27.js +52 -0
- package/dist/cli-2GOFEW26.js +81 -0
- package/dist/cli-3E3MD5U4.js +21 -0
- package/dist/cli-3HE4AVZG.js +115 -0
- package/dist/cli-4AKVLEC4.js +1387 -0
- package/dist/cli-4BV45LBH.js +126 -0
- package/dist/cli-4LKXZQ2B.js +48 -0
- package/dist/cli-4UWFQNGF.js +54 -0
- package/dist/cli-4YB3ROVR.js +78 -0
- package/dist/cli-57RXC3HQ.js +36 -0
- package/dist/cli-5JEGTVTG.js +96 -0
- package/dist/cli-6AMT3BUO.js +97 -0
- package/dist/cli-6RRVEGFB.js +80 -0
- package/dist/cli-6WXLXJVX.js +36 -0
- package/dist/cli-7OGYADZ3.js +97 -0
- package/dist/cli-AK7OIPWY.js +229 -0
- package/dist/cli-B4TN6PJP.js +124 -0
- package/dist/cli-B6YHEKIJ.js +248 -0
- package/dist/cli-BPYMTOUL.js +89 -0
- package/dist/cli-BWX5E7TQ.js +23 -0
- package/dist/cli-BYJWFFCF.js +37 -0
- package/dist/cli-C3NVCKO6.js +43 -0
- package/dist/cli-C47GJATR.js +42 -0
- package/dist/cli-C5QOJJWX.js +46 -0
- package/dist/cli-C6TH5S7K.js +6417 -0
- package/dist/cli-DL2CVMRF.js +89 -0
- package/dist/cli-DMW2OQIJ.js +76 -0
- package/dist/cli-DZW3XD5F.js +143 -0
- package/dist/cli-E2NLWIFE.js +1331 -0
- package/dist/cli-E33CJRRQ.js +36 -0
- package/dist/cli-E6DJIMYD.js +142 -0
- package/dist/cli-EEFJKIGL.js +151 -0
- package/dist/cli-EVFS55WN.js +185 -0
- package/dist/cli-F2D4GGUA.js +549 -0
- package/dist/cli-FBTRTIZJ.js +226 -0
- package/dist/cli-FWFRKQNE.js +11 -0
- package/dist/cli-FYINNRML.js +760 -0
- package/dist/cli-G522CPRL.js +88 -0
- package/dist/cli-G6KELFSX.js +2847 -0
- package/dist/cli-G6UE5NL4.js +90 -0
- package/dist/cli-GBFM76BF.js +16 -0
- package/dist/cli-GDQ6ILJY.js +101 -0
- package/dist/cli-GFBGYFYD.js +50 -0
- package/dist/cli-GGPDQNM3.js +35 -0
- package/dist/cli-GTSGLN3Z.js +307 -0
- package/dist/cli-GUXKQMJ7.js +13641 -0
- package/dist/cli-GXD36NF2.js +60 -0
- package/dist/cli-HCRTYQQS.js +16 -0
- package/dist/cli-HYY64SUD.js +185 -0
- package/dist/cli-I355WTAF.js +463 -0
- package/dist/cli-IDKYF5XB.js +59 -0
- package/dist/cli-ILKCQNM6.js +8 -0
- package/dist/cli-IRZ5KB7D.js +36 -0
- package/dist/cli-IUS2YCD3.js +31 -0
- package/dist/cli-J4DKUUTK.js +138 -0
- package/dist/cli-JFU22EJ2.js +187 -0
- package/dist/cli-JMZLT65J.js +226 -0
- package/dist/cli-JZM7XTNV.js +89 -0
- package/dist/cli-K2B6WHKA.js +81 -0
- package/dist/cli-KL3756X6.js +126 -0
- package/dist/cli-KNOOKGYW.js +88 -0
- package/dist/cli-LFGRFIEO.js +226 -0
- package/dist/cli-LFM7GJHI.js +0 -0
- package/dist/cli-LMDJCHHD.js +304 -0
- package/dist/cli-LXYPE3L5.js +99 -0
- package/dist/cli-M6BCQRID.js +153 -0
- package/dist/cli-MBNMPVDC.js +367 -0
- package/dist/cli-MJUYJIEP.js +13 -0
- package/dist/cli-MMN4BPO4.js +145 -0
- package/dist/cli-MYJGMA6U.js +40 -0
- package/dist/cli-N6H6T2E2.js +616 -0
- package/dist/cli-O5KP4OVN.js +61 -0
- package/dist/cli-O6PWMJTZ.js +25 -0
- package/dist/cli-ORIG557O.js +141 -0
- package/dist/cli-PFFCNGHI.js +243 -0
- package/dist/cli-PNLYX6R6.js +131 -0
- package/dist/cli-PQBXVLEU.js +649 -0
- package/dist/cli-PTT5RGKO.js +62 -0
- package/dist/cli-Q2XJF5AS.js +127 -0
- package/dist/cli-QEVDDBNO.js +60 -0
- package/dist/cli-QEVE5HUM.js +167 -0
- package/dist/cli-QUIJCBYB.js +391 -0
- package/dist/cli-QUNIRH7A.js +57 -0
- package/dist/cli-QVASWX2A.js +187 -0
- package/dist/cli-QWQMPCL6.js +253 -0
- package/dist/cli-R4PCG5YX.js +131 -0
- package/dist/cli-RA673NGF.js +53 -0
- package/dist/cli-RN6IWTL2.js +36 -0
- package/dist/cli-ROT3DRKU.js +145 -0
- package/dist/cli-RZITKPJX.js +367 -0
- package/dist/cli-S5IVGDDD.js +32 -0
- package/dist/cli-S5QDONIQ.js +218 -0
- package/dist/cli-SIPDUBFL.js +36 -0
- package/dist/cli-SMFSZF2G.js +4009 -0
- package/dist/cli-SRHBXZCN.js +159 -0
- package/dist/cli-TCY5LJ7E.js +88 -0
- package/dist/cli-TDSQSCX4.js +131 -0
- package/dist/cli-TIDQ4WUE.js +257 -0
- package/dist/cli-TLLA6KAP.js +79 -0
- package/dist/cli-TPU4TUR6.js +132 -0
- package/dist/cli-U2UE7I7J.js +30 -0
- package/dist/cli-UELGBQG7.js +101 -0
- package/dist/cli-UHSZBKYO.js +97 -0
- package/dist/cli-UJ4UCL2Z.js +38 -0
- package/dist/cli-UKQYZYFK.js +31 -0
- package/dist/cli-UMFFURZ7.js +81 -0
- package/dist/cli-UNAJ2OTE.js +15 -0
- package/dist/cli-UNJ5X6BU.js +89 -0
- package/dist/cli-UTJU4IYG.js +117 -0
- package/dist/cli-V4GHRWOV.js +1837 -0
- package/dist/cli-VCI3CG36.js +73 -0
- package/dist/cli-VCKOC2EV.js +256 -0
- package/dist/cli-VL2P354N.js +46 -0
- package/dist/cli-WAE26SVW.js +72 -0
- package/dist/cli-WOGIAU2E.js +100 -0
- package/dist/cli-WU43JT4T.js +52 -0
- package/dist/cli-XCO2VQOH.js +122 -0
- package/dist/cli-XSVGKI3R.js +39 -0
- package/dist/cli-YOTGR3NB.js +82 -0
- package/dist/cli-YVVXUD2G.js +197 -0
- package/dist/cli-ZISJ36MM.js +89 -0
- package/dist/cli-ZTWOE3ZT.js +65 -0
- package/dist/cli-ZVSFYDPQ.js +205 -0
- package/dist/cli-ZWPYIXNI.js +68 -0
- package/dist/cli.js +148 -43093
- package/dist/client/build-surfaces.d.ts +33 -0
- package/dist/client/dev-server.d.ts +6 -0
- package/dist/client/index.d.ts +1 -0
- package/dist/client/playwright.d.ts +62 -0
- package/dist/client.js +228 -48
- package/dist/core/session.d.ts +15 -1
- package/dist/dev/console/assets/{index-BVF8exas.js → index-CuMOOH9m.js} +1 -1
- package/dist/dev/console/index.html +1 -1
- package/dist/dev/shell.d.ts +19 -0
- package/dist/dev/surfaces.d.ts +7 -0
- package/dist/docs/api/index.md +14 -12
- package/dist/docs/api/sdk-tools-client.md +29 -0
- package/dist/docs/api/sdk-tools-playwright.md +104 -0
- package/dist/docs/changelog.md +19 -0
- package/dist/docs/cli-and-dev-server.md +21 -0
- package/dist/docs/cli-reference.md +45 -31
- package/dist/docs/environment-variables.md +6 -0
- package/dist/docs/guides/designing-a-game.md +29 -4
- package/dist/docs/guides/starter-game.md +2 -2
- package/dist/docs/guides/testing.md +33 -18
- package/dist/docs/page-index.md +8 -7
- package/dist/docs/recipes/e2e-testing.md +19 -20
- package/dist/playwright.js +32232 -0
- package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
- package/dist/templates/package/global-setup.ts.template +7 -18
- package/dist/templates/package/playwright.config.ts.liquid +8 -11
- package/dist/templates/starter-game/playwright.config.ts +8 -11
- package/dist/templates/starter-game/testing/e2e/game.spec.ts +1 -1
- package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
- package/dist/utils/prompt.d.ts +5 -5
- package/dist/utils/resource-scan.d.ts +39 -0
- package/package.json +7 -3
|
@@ -0,0 +1,367 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
confirm,
|
|
4
|
+
input,
|
|
5
|
+
select
|
|
6
|
+
} from "./cli-ZTWOE3ZT.js";
|
|
7
|
+
|
|
8
|
+
// cli/prompts/validators.ts
|
|
9
|
+
var PASCAL_CASE_PATTERN = /^[A-Z][a-zA-Z0-9]*$/;
|
|
10
|
+
function validatePropertyName(name, existingNames) {
|
|
11
|
+
if (!name.trim()) {
|
|
12
|
+
return "Property name is required";
|
|
13
|
+
}
|
|
14
|
+
if (!PASCAL_CASE_PATTERN.test(name.trim())) {
|
|
15
|
+
return "Property name must be in PascalCase (start with uppercase letter, no spaces or special characters)";
|
|
16
|
+
}
|
|
17
|
+
if (existingNames.includes(name.trim())) {
|
|
18
|
+
return "A property with this name already exists";
|
|
19
|
+
}
|
|
20
|
+
return true;
|
|
21
|
+
}
|
|
22
|
+
function validateNumberValue(value, constraints) {
|
|
23
|
+
if (isNaN(Number(value))) {
|
|
24
|
+
return "Value must be a valid number";
|
|
25
|
+
}
|
|
26
|
+
const numValue = Number(value);
|
|
27
|
+
if (constraints?.min !== void 0 && numValue < constraints.min) {
|
|
28
|
+
return `Value must be greater than or equal to ${constraints.min}`;
|
|
29
|
+
}
|
|
30
|
+
if (constraints?.max !== void 0 && numValue > constraints.max) {
|
|
31
|
+
return `Value must be less than or equal to ${constraints.max}`;
|
|
32
|
+
}
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
function validateMaximumValue(maximum, minimum) {
|
|
36
|
+
const baseValidation = validateNumberValue(maximum);
|
|
37
|
+
if (baseValidation !== true) {
|
|
38
|
+
return baseValidation;
|
|
39
|
+
}
|
|
40
|
+
if (minimum !== void 0 && Number(maximum) < minimum) {
|
|
41
|
+
return "Maximum must be greater than or equal to minimum";
|
|
42
|
+
}
|
|
43
|
+
return true;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// cli/prompts/schema-builder.ts
|
|
47
|
+
async function promptNumberProperties(currentDefaults) {
|
|
48
|
+
const defaultValue = await input({
|
|
49
|
+
message: "Default value (number):",
|
|
50
|
+
default: currentDefaults?.default !== void 0 ? String(currentDefaults.default) : "0",
|
|
51
|
+
validate: (value) => validateNumberValue(value)
|
|
52
|
+
});
|
|
53
|
+
const defaults = {
|
|
54
|
+
default: Number(defaultValue)
|
|
55
|
+
};
|
|
56
|
+
const currentHasMin = currentDefaults?.minimum !== void 0;
|
|
57
|
+
const hasMinimum = await confirm({
|
|
58
|
+
message: "Add minimum value constraint?",
|
|
59
|
+
default: currentHasMin
|
|
60
|
+
});
|
|
61
|
+
if (hasMinimum) {
|
|
62
|
+
const minimum = await input({
|
|
63
|
+
message: "Minimum value:",
|
|
64
|
+
default: currentHasMin ? String(currentDefaults.minimum) : "",
|
|
65
|
+
validate: (value) => validateNumberValue(value)
|
|
66
|
+
});
|
|
67
|
+
defaults.minimum = Number(minimum);
|
|
68
|
+
}
|
|
69
|
+
const currentHasMax = currentDefaults?.maximum !== void 0;
|
|
70
|
+
const hasMaximum = await confirm({
|
|
71
|
+
message: "Add maximum value constraint?",
|
|
72
|
+
default: currentHasMax
|
|
73
|
+
});
|
|
74
|
+
if (hasMaximum) {
|
|
75
|
+
const maximum = await input({
|
|
76
|
+
message: "Maximum value:",
|
|
77
|
+
default: currentHasMax ? String(currentDefaults.maximum) : "",
|
|
78
|
+
validate: (value) => validateMaximumValue(value, defaults.minimum)
|
|
79
|
+
});
|
|
80
|
+
defaults.maximum = Number(maximum);
|
|
81
|
+
}
|
|
82
|
+
return defaults;
|
|
83
|
+
}
|
|
84
|
+
async function promptStringProperties(currentDefaults) {
|
|
85
|
+
const defaultValue = await input({
|
|
86
|
+
message: "Default value (string):",
|
|
87
|
+
default: currentDefaults?.default ?? ""
|
|
88
|
+
});
|
|
89
|
+
return { default: defaultValue };
|
|
90
|
+
}
|
|
91
|
+
async function promptBooleanProperties(currentDefaults) {
|
|
92
|
+
const defaultValue = await confirm({
|
|
93
|
+
message: "Default value:",
|
|
94
|
+
default: currentDefaults?.default ?? false
|
|
95
|
+
});
|
|
96
|
+
return { default: defaultValue };
|
|
97
|
+
}
|
|
98
|
+
var CONTEXT_COPY = {
|
|
99
|
+
variable: {
|
|
100
|
+
label: "Variable",
|
|
101
|
+
singular: "variable",
|
|
102
|
+
plural: "variables",
|
|
103
|
+
intro: "Variables define the state this capability holds."
|
|
104
|
+
},
|
|
105
|
+
setting: {
|
|
106
|
+
label: "Setting",
|
|
107
|
+
singular: "setting",
|
|
108
|
+
plural: "settings",
|
|
109
|
+
intro: "Settings are the values a game plays with, which scenarios can override."
|
|
110
|
+
},
|
|
111
|
+
property: { label: "Property", singular: "property", plural: "properties" }
|
|
112
|
+
};
|
|
113
|
+
async function promptForSchemaProperty(options) {
|
|
114
|
+
const contextLabel = CONTEXT_COPY[options.context || "variable"].label;
|
|
115
|
+
const propertyName = await input({
|
|
116
|
+
message: `${contextLabel} name (PascalCase, e.g., "Price", "TotalCost"):`,
|
|
117
|
+
validate: (value) => validatePropertyName(value, options.existingNames)
|
|
118
|
+
});
|
|
119
|
+
const propertyType = await select({
|
|
120
|
+
message: `${contextLabel} type:`,
|
|
121
|
+
choices: [
|
|
122
|
+
{ name: "Number", value: "number" },
|
|
123
|
+
{ name: "String", value: "string" },
|
|
124
|
+
{ name: "Boolean", value: "boolean" }
|
|
125
|
+
]
|
|
126
|
+
});
|
|
127
|
+
const propertyDescription = await input({
|
|
128
|
+
message: `${contextLabel} description:`,
|
|
129
|
+
validate: (value) => {
|
|
130
|
+
if (!value.trim()) {
|
|
131
|
+
return "Description is required";
|
|
132
|
+
}
|
|
133
|
+
return true;
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
const propertySchema = {
|
|
137
|
+
type: propertyType,
|
|
138
|
+
description: propertyDescription
|
|
139
|
+
};
|
|
140
|
+
if (propertyType === "number") {
|
|
141
|
+
const numberDefaults = await promptNumberProperties();
|
|
142
|
+
propertySchema.default = numberDefaults.default;
|
|
143
|
+
if (numberDefaults.minimum !== void 0) {
|
|
144
|
+
propertySchema.minimum = numberDefaults.minimum;
|
|
145
|
+
}
|
|
146
|
+
if (numberDefaults.maximum !== void 0) {
|
|
147
|
+
propertySchema.maximum = numberDefaults.maximum;
|
|
148
|
+
}
|
|
149
|
+
} else if (propertyType === "string") {
|
|
150
|
+
const stringDefaults = await promptStringProperties();
|
|
151
|
+
propertySchema.default = stringDefaults.default;
|
|
152
|
+
} else if (propertyType === "boolean") {
|
|
153
|
+
const booleanDefaults = await promptBooleanProperties();
|
|
154
|
+
propertySchema.default = booleanDefaults.default;
|
|
155
|
+
}
|
|
156
|
+
return {
|
|
157
|
+
name: propertyName.trim(),
|
|
158
|
+
schema: propertySchema
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
async function promptForSchemaProperties(options = {}) {
|
|
162
|
+
const context = options.context || "variable";
|
|
163
|
+
const copy = CONTEXT_COPY[context];
|
|
164
|
+
const properties = {
|
|
165
|
+
...options.existingProperties
|
|
166
|
+
};
|
|
167
|
+
const existingNames = Object.keys(properties);
|
|
168
|
+
if (existingNames.length === 0) {
|
|
169
|
+
console.log(`Now let's add ${copy.plural}.`);
|
|
170
|
+
if (copy.intro) console.log(`${copy.intro}
|
|
171
|
+
`);
|
|
172
|
+
}
|
|
173
|
+
let addingProperties = true;
|
|
174
|
+
while (addingProperties) {
|
|
175
|
+
const result = await promptForSchemaProperty({
|
|
176
|
+
existingNames: Object.keys(properties),
|
|
177
|
+
context
|
|
178
|
+
});
|
|
179
|
+
if (result) {
|
|
180
|
+
properties[result.name] = result.schema;
|
|
181
|
+
console.log(`
|
|
182
|
+
\u2713 Added ${copy.singular}: ${result.name} (${result.schema.type})
|
|
183
|
+
`);
|
|
184
|
+
}
|
|
185
|
+
if (options.minProperties !== void 0 && Object.keys(properties).length < options.minProperties) {
|
|
186
|
+
console.log(`At least ${options.minProperties} ${copy.plural} required.
|
|
187
|
+
`);
|
|
188
|
+
continue;
|
|
189
|
+
}
|
|
190
|
+
addingProperties = await confirm({
|
|
191
|
+
message: `Add another ${copy.singular}?`,
|
|
192
|
+
default: Object.keys(properties).length === 0
|
|
193
|
+
});
|
|
194
|
+
if (addingProperties) {
|
|
195
|
+
console.log("");
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
return properties;
|
|
199
|
+
}
|
|
200
|
+
async function editSchemaProperty(name, currentSchema) {
|
|
201
|
+
const modifiedChanges = [];
|
|
202
|
+
const newDescription = await input({
|
|
203
|
+
message: "Property description:",
|
|
204
|
+
default: currentSchema.description || "",
|
|
205
|
+
validate: (value) => {
|
|
206
|
+
if (!value.trim()) {
|
|
207
|
+
return "Description is required";
|
|
208
|
+
}
|
|
209
|
+
return true;
|
|
210
|
+
}
|
|
211
|
+
});
|
|
212
|
+
const editedSchema = {
|
|
213
|
+
type: currentSchema.type,
|
|
214
|
+
description: newDescription
|
|
215
|
+
};
|
|
216
|
+
if (newDescription !== currentSchema.description) {
|
|
217
|
+
modifiedChanges.push("description");
|
|
218
|
+
}
|
|
219
|
+
if (currentSchema.type === "number") {
|
|
220
|
+
const numberDefaults = await promptNumberProperties({
|
|
221
|
+
default: currentSchema.default,
|
|
222
|
+
minimum: currentSchema.minimum,
|
|
223
|
+
maximum: currentSchema.maximum
|
|
224
|
+
});
|
|
225
|
+
editedSchema.default = numberDefaults.default;
|
|
226
|
+
if (numberDefaults.default !== currentSchema.default) {
|
|
227
|
+
modifiedChanges.push("default");
|
|
228
|
+
}
|
|
229
|
+
if (numberDefaults.minimum !== void 0) {
|
|
230
|
+
editedSchema.minimum = numberDefaults.minimum;
|
|
231
|
+
if (numberDefaults.minimum !== currentSchema.minimum) {
|
|
232
|
+
modifiedChanges.push("minimum");
|
|
233
|
+
}
|
|
234
|
+
} else if (currentSchema.minimum !== void 0) {
|
|
235
|
+
modifiedChanges.push("minimum removed");
|
|
236
|
+
}
|
|
237
|
+
if (numberDefaults.maximum !== void 0) {
|
|
238
|
+
editedSchema.maximum = numberDefaults.maximum;
|
|
239
|
+
if (numberDefaults.maximum !== currentSchema.maximum) {
|
|
240
|
+
modifiedChanges.push("maximum");
|
|
241
|
+
}
|
|
242
|
+
} else if (currentSchema.maximum !== void 0) {
|
|
243
|
+
modifiedChanges.push("maximum removed");
|
|
244
|
+
}
|
|
245
|
+
} else if (currentSchema.type === "string") {
|
|
246
|
+
const stringDefaults = await promptStringProperties({
|
|
247
|
+
default: currentSchema.default
|
|
248
|
+
});
|
|
249
|
+
editedSchema.default = stringDefaults.default;
|
|
250
|
+
if (stringDefaults.default !== currentSchema.default) {
|
|
251
|
+
modifiedChanges.push("default");
|
|
252
|
+
}
|
|
253
|
+
} else if (currentSchema.type === "boolean") {
|
|
254
|
+
const booleanDefaults = await promptBooleanProperties({
|
|
255
|
+
default: currentSchema.default
|
|
256
|
+
});
|
|
257
|
+
editedSchema.default = booleanDefaults.default;
|
|
258
|
+
if (booleanDefaults.default !== currentSchema.default) {
|
|
259
|
+
modifiedChanges.push("default");
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
if (modifiedChanges.length > 0) {
|
|
263
|
+
return {
|
|
264
|
+
action: "edit",
|
|
265
|
+
schema: editedSchema,
|
|
266
|
+
changes: modifiedChanges
|
|
267
|
+
};
|
|
268
|
+
} else {
|
|
269
|
+
return {
|
|
270
|
+
action: "keep",
|
|
271
|
+
schema: currentSchema,
|
|
272
|
+
changes: []
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
async function reviewSchemaProperties(existingProperties, options = {}) {
|
|
277
|
+
const newProperties = {};
|
|
278
|
+
const changes = {
|
|
279
|
+
kept: [],
|
|
280
|
+
modified: [],
|
|
281
|
+
deleted: [],
|
|
282
|
+
added: []
|
|
283
|
+
};
|
|
284
|
+
const existingEntries = Object.entries(existingProperties);
|
|
285
|
+
if (existingEntries.length > 0) {
|
|
286
|
+
console.log("Let's review your existing properties.\n");
|
|
287
|
+
for (const [propName, propSchema] of existingEntries) {
|
|
288
|
+
console.log(`Property: ${propName}`);
|
|
289
|
+
console.log(` Type: ${propSchema.type}`);
|
|
290
|
+
console.log(` Description: ${propSchema.description || "(none)"}`);
|
|
291
|
+
if (propSchema.default !== void 0) {
|
|
292
|
+
console.log(` Default: ${propSchema.default}`);
|
|
293
|
+
}
|
|
294
|
+
if (propSchema.minimum !== void 0) {
|
|
295
|
+
console.log(` Minimum: ${propSchema.minimum}`);
|
|
296
|
+
}
|
|
297
|
+
if (propSchema.maximum !== void 0) {
|
|
298
|
+
console.log(` Maximum: ${propSchema.maximum}`);
|
|
299
|
+
}
|
|
300
|
+
console.log("");
|
|
301
|
+
const actionChoices = [
|
|
302
|
+
{ name: "Keep unchanged", value: "keep" },
|
|
303
|
+
{ name: "Edit", value: "edit" }
|
|
304
|
+
];
|
|
305
|
+
if (options.allowDelete) {
|
|
306
|
+
actionChoices.push({ name: "Delete", value: "delete" });
|
|
307
|
+
}
|
|
308
|
+
const action = await select({
|
|
309
|
+
message: `What do you want to do with "${propName}"?`,
|
|
310
|
+
choices: actionChoices
|
|
311
|
+
});
|
|
312
|
+
if (action === "keep") {
|
|
313
|
+
newProperties[propName] = propSchema;
|
|
314
|
+
changes.kept.push(propName);
|
|
315
|
+
console.log(`\u2713 Keeping ${propName} unchanged
|
|
316
|
+
`);
|
|
317
|
+
} else if (action === "delete") {
|
|
318
|
+
changes.deleted.push(propName);
|
|
319
|
+
console.log(`\u2713 Will delete ${propName}
|
|
320
|
+
`);
|
|
321
|
+
} else {
|
|
322
|
+
const result = await editSchemaProperty(propName, propSchema);
|
|
323
|
+
newProperties[propName] = result.schema;
|
|
324
|
+
if (result.changes && result.changes.length > 0) {
|
|
325
|
+
changes.modified.push({
|
|
326
|
+
name: propName,
|
|
327
|
+
changes: result.changes.join(", ")
|
|
328
|
+
});
|
|
329
|
+
console.log(`\u2713 Modified ${propName} (${result.changes.join(", ")})
|
|
330
|
+
`);
|
|
331
|
+
} else {
|
|
332
|
+
changes.kept.push(propName);
|
|
333
|
+
console.log(`\u2713 No changes to ${propName}
|
|
334
|
+
`);
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
if (options.allowAdd) {
|
|
340
|
+
const addNew = await confirm({
|
|
341
|
+
message: "Add new properties?",
|
|
342
|
+
default: false
|
|
343
|
+
});
|
|
344
|
+
if (addNew) {
|
|
345
|
+
console.log("");
|
|
346
|
+
const newProps = await promptForSchemaProperties({
|
|
347
|
+
existingProperties: newProperties,
|
|
348
|
+
context: options.context
|
|
349
|
+
});
|
|
350
|
+
for (const propName of Object.keys(newProps)) {
|
|
351
|
+
if (!newProperties[propName]) {
|
|
352
|
+
changes.added.push(propName);
|
|
353
|
+
}
|
|
354
|
+
newProperties[propName] = newProps[propName];
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
return {
|
|
359
|
+
properties: newProperties,
|
|
360
|
+
changes
|
|
361
|
+
};
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
export {
|
|
365
|
+
promptForSchemaProperties,
|
|
366
|
+
reviewSchemaProperties
|
|
367
|
+
};
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// cli/utils/json-patch.ts
|
|
4
|
+
import * as rfc6902 from "rfc6902";
|
|
5
|
+
function applyJsonPatch(obj, operations) {
|
|
6
|
+
let result = structuredClone(obj);
|
|
7
|
+
const realmSafeOperations = structuredClone(operations);
|
|
8
|
+
try {
|
|
9
|
+
const errors = rfc6902.applyPatch(result, realmSafeOperations);
|
|
10
|
+
if (errors && errors.length > 0) {
|
|
11
|
+
const actualErrors = errors.filter((e) => e !== null);
|
|
12
|
+
if (actualErrors.length > 0) {
|
|
13
|
+
const errorMessages = actualErrors.map((e) => e?.message || String(e)).join("; ");
|
|
14
|
+
throw new Error(`Patch failed: ${errorMessages}`);
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
return result;
|
|
18
|
+
} catch (error) {
|
|
19
|
+
const message = error.message;
|
|
20
|
+
if (message.includes("out of range")) {
|
|
21
|
+
throw new Error("Array index out of range");
|
|
22
|
+
}
|
|
23
|
+
if (message.includes("undefined") || message.includes("Cannot read")) {
|
|
24
|
+
throw new Error("Path does not exist");
|
|
25
|
+
}
|
|
26
|
+
throw error;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export {
|
|
31
|
+
applyJsonPatch
|
|
32
|
+
};
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
guessMimeType
|
|
4
|
+
} from "./cli-2BH7FX27.js";
|
|
5
|
+
import {
|
|
6
|
+
resolveSession
|
|
7
|
+
} from "./cli-GTSGLN3Z.js";
|
|
8
|
+
import "./cli-WU43JT4T.js";
|
|
9
|
+
import {
|
|
10
|
+
blobLinks
|
|
11
|
+
} from "./cli-BWX5E7TQ.js";
|
|
12
|
+
import {
|
|
13
|
+
OUTCOME_CODES,
|
|
14
|
+
emit,
|
|
15
|
+
environmentHint,
|
|
16
|
+
logicDiagnostic,
|
|
17
|
+
staleError,
|
|
18
|
+
staleOf,
|
|
19
|
+
teamIndexFromArgument
|
|
20
|
+
} from "./cli-PFFCNGHI.js";
|
|
21
|
+
import "./cli-LFM7GJHI.js";
|
|
22
|
+
import "./cli-C6TH5S7K.js";
|
|
23
|
+
import "./cli-TDSQSCX4.js";
|
|
24
|
+
import "./cli-SRHBXZCN.js";
|
|
25
|
+
import "./cli-GUXKQMJ7.js";
|
|
26
|
+
import "./cli-4LKXZQ2B.js";
|
|
27
|
+
import "./cli-MMN4BPO4.js";
|
|
28
|
+
import {
|
|
29
|
+
resolveInputSource
|
|
30
|
+
} from "./cli-4UWFQNGF.js";
|
|
31
|
+
import "./cli-QUNIRH7A.js";
|
|
32
|
+
import {
|
|
33
|
+
logicErrorOf
|
|
34
|
+
} from "./cli-E2NLWIFE.js";
|
|
35
|
+
import "./cli-25RWY5BQ.js";
|
|
36
|
+
import {
|
|
37
|
+
readBlob
|
|
38
|
+
} from "./cli-QWQMPCL6.js";
|
|
39
|
+
import "./cli-SMFSZF2G.js";
|
|
40
|
+
import "./cli-F2D4GGUA.js";
|
|
41
|
+
import "./cli-4YB3ROVR.js";
|
|
42
|
+
import {
|
|
43
|
+
CliError
|
|
44
|
+
} from "./cli-N6H6T2E2.js";
|
|
45
|
+
|
|
46
|
+
// cli/commands/endpoint-call.ts
|
|
47
|
+
import { existsSync } from "fs";
|
|
48
|
+
import { mkdir, readFile, writeFile } from "fs/promises";
|
|
49
|
+
import { basename, join, resolve } from "path";
|
|
50
|
+
function describeStep(step) {
|
|
51
|
+
switch (step.kind) {
|
|
52
|
+
case "capabilities":
|
|
53
|
+
return "its write";
|
|
54
|
+
case "teams":
|
|
55
|
+
return `its write to team "${step.teamId}"`;
|
|
56
|
+
case "action":
|
|
57
|
+
return `action ${step.index} ("${step.type}")`;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
function describeEndpointFailure(identifier, failure) {
|
|
61
|
+
const { outcome, applied, failedStep } = failure;
|
|
62
|
+
const message = "message" in outcome && outcome.message ? `: ${outcome.message}` : "";
|
|
63
|
+
const lines = [`Endpoint "${identifier}" failed (${outcome.kind})${message}`];
|
|
64
|
+
lines.push(
|
|
65
|
+
applied.length === 0 ? "Nothing was applied." : `Applied before the failure: ${applied.map(describeStep).join(", ")}`
|
|
66
|
+
);
|
|
67
|
+
if (failedStep) lines.push(`Failed at: ${describeStep(failedStep)}`);
|
|
68
|
+
return lines.join("\n");
|
|
69
|
+
}
|
|
70
|
+
var ENDPOINT_CODES = {
|
|
71
|
+
"invalid-request": "INVALID_REQUEST",
|
|
72
|
+
"handler-error": "HANDLER_ERROR",
|
|
73
|
+
"invalid-response": "INVALID_RESPONSE"
|
|
74
|
+
};
|
|
75
|
+
function endpointFailureCode(failure) {
|
|
76
|
+
const kind = failure.outcome.kind;
|
|
77
|
+
return kind in ENDPOINT_CODES ? ENDPOINT_CODES[kind] : OUTCOME_CODES[kind];
|
|
78
|
+
}
|
|
79
|
+
function parsePrincipal(value) {
|
|
80
|
+
const [kind, id, ...rest] = value.split(":");
|
|
81
|
+
if (!kind || !id) {
|
|
82
|
+
throw new CliError(
|
|
83
|
+
"USAGE_BAD_FLAG",
|
|
84
|
+
`--principal takes kind:id or kind:id:name, e.g. agent:claude-7:Claude (got "${value}")`
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
return { kind, id, ...rest.length > 0 ? { name: rest.join(":") } : {} };
|
|
88
|
+
}
|
|
89
|
+
async function attachFiles(request, attachments, workingDir) {
|
|
90
|
+
if (attachments.length === 0) return request;
|
|
91
|
+
if (typeof request !== "object" || request === null || Array.isArray(request)) {
|
|
92
|
+
throw new CliError("INPUT_INVALID", "--attach needs the request to be a JSON object");
|
|
93
|
+
}
|
|
94
|
+
const result = structuredClone(request);
|
|
95
|
+
for (const attachment of attachments) {
|
|
96
|
+
const split = attachment.indexOf("=");
|
|
97
|
+
if (split <= 0) {
|
|
98
|
+
throw new CliError("USAGE_BAD_FLAG", `--attach takes field=path (got "${attachment}")`);
|
|
99
|
+
}
|
|
100
|
+
const field = attachment.slice(0, split);
|
|
101
|
+
const path = resolve(workingDir, attachment.slice(split + 1));
|
|
102
|
+
if (!existsSync(path))
|
|
103
|
+
throw new CliError("FILE_NOT_FOUND", `--attach: file not found: ${path}`);
|
|
104
|
+
const name = basename(path);
|
|
105
|
+
const uri = `data:${guessMimeType(name)};name=${encodeURIComponent(name)};base64,` + (await readFile(path)).toString("base64");
|
|
106
|
+
const keys = field.split(".");
|
|
107
|
+
let target = result;
|
|
108
|
+
for (const key of keys.slice(0, -1)) {
|
|
109
|
+
const next = target[key];
|
|
110
|
+
target[key] = typeof next === "object" && next !== null ? next : {};
|
|
111
|
+
target = target[key];
|
|
112
|
+
}
|
|
113
|
+
target[keys[keys.length - 1]] = uri;
|
|
114
|
+
}
|
|
115
|
+
return result;
|
|
116
|
+
}
|
|
117
|
+
async function saveBlobs(response, dir, workingDir) {
|
|
118
|
+
const references = Object.keys(blobLinks(response, (id) => id));
|
|
119
|
+
if (references.length === 0) {
|
|
120
|
+
console.error("The response names no blobs to save.");
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
123
|
+
const target = resolve(workingDir, dir);
|
|
124
|
+
await mkdir(target, { recursive: true });
|
|
125
|
+
const taken = /* @__PURE__ */ new Set();
|
|
126
|
+
for (const reference of references) {
|
|
127
|
+
const blob = await readBlob(workingDir, reference.slice("blob:".length));
|
|
128
|
+
let name = basename(blob.name) || "blob";
|
|
129
|
+
for (let n = 2; taken.has(name); n += 1) name = `${n}-${basename(blob.name)}`;
|
|
130
|
+
taken.add(name);
|
|
131
|
+
await writeFile(join(target, name), blob.data);
|
|
132
|
+
console.error(`Saved ${reference} to ${join(target, name)}`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
async function endpointCallCommand(identifier, options) {
|
|
136
|
+
const source = await resolveInputSource(options.request, options.file);
|
|
137
|
+
let request = {};
|
|
138
|
+
if (source.kind === "json") {
|
|
139
|
+
try {
|
|
140
|
+
request = JSON.parse(source.json);
|
|
141
|
+
} catch (error) {
|
|
142
|
+
throw new CliError(
|
|
143
|
+
"INPUT_INVALID",
|
|
144
|
+
`The request is not valid JSON
|
|
145
|
+
` + (error instanceof Error ? error.message : "Unknown error")
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
if (options.principal !== void 0 && !options.external) {
|
|
150
|
+
throw new CliError(
|
|
151
|
+
"USAGE_BAD_FLAG",
|
|
152
|
+
"--principal stands in for the identity a platform vouches for on a call from outside the game, so it needs --external"
|
|
153
|
+
);
|
|
154
|
+
}
|
|
155
|
+
const principal = options.principal === void 0 ? void 0 : parsePrincipal(options.principal);
|
|
156
|
+
if (options.draft !== void 0 && options.team !== void 0) {
|
|
157
|
+
throw new CliError(
|
|
158
|
+
"USAGE_BAD_FLAG",
|
|
159
|
+
"--team names a team in the session, and a scenario draft has none, so it cannot go with --draft"
|
|
160
|
+
);
|
|
161
|
+
}
|
|
162
|
+
const scenarioId = options.draft === void 0 || options.draft === false ? void 0 : options.draft === true ? null : options.draft;
|
|
163
|
+
request = await attachFiles(request, options.attach ?? [], options.workingDir);
|
|
164
|
+
const session = await resolveSession({
|
|
165
|
+
packagePath: options.workingDir,
|
|
166
|
+
...options.walkthrough ? { runKind: "walkthrough" } : {},
|
|
167
|
+
...options.server === false ? { noServer: true } : {}
|
|
168
|
+
});
|
|
169
|
+
try {
|
|
170
|
+
const state = await session.state();
|
|
171
|
+
const teamIndex = teamIndexFromArgument(state, options.team);
|
|
172
|
+
const result = await session.send({
|
|
173
|
+
type: "callEndpoint",
|
|
174
|
+
endpointIdentifier: identifier,
|
|
175
|
+
request,
|
|
176
|
+
// Unless it stands in for an outside caller, the caller is the
|
|
177
|
+
// terminal, not a surface, so it names none (§6.12).
|
|
178
|
+
...options.external ? { external: true } : {},
|
|
179
|
+
...principal ? { principal } : {},
|
|
180
|
+
...teamIndex === void 0 ? {} : { teamIndex },
|
|
181
|
+
...scenarioId === void 0 ? {} : { scenarioId }
|
|
182
|
+
});
|
|
183
|
+
if ("type" in result && result.type === "endpointFailure") {
|
|
184
|
+
const stale = staleOf(result);
|
|
185
|
+
if (stale) throw staleError(stale);
|
|
186
|
+
const logicError = logicErrorOf(result);
|
|
187
|
+
throw new CliError(
|
|
188
|
+
logicError?.errorCode ?? endpointFailureCode(result.failure),
|
|
189
|
+
describeEndpointFailure(identifier, result.failure),
|
|
190
|
+
{
|
|
191
|
+
...environmentHint(logicError),
|
|
192
|
+
details: { ...result.failure },
|
|
193
|
+
diagnostics: logicError ? [logicDiagnostic(logicError)] : []
|
|
194
|
+
}
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
if (!("type" in result) || result.type !== "endpoint") {
|
|
198
|
+
throw new CliError(
|
|
199
|
+
"DEV_SERVER_OUTDATED",
|
|
200
|
+
`Endpoint "${identifier}" returned no response`
|
|
201
|
+
);
|
|
202
|
+
}
|
|
203
|
+
emit(result.response);
|
|
204
|
+
for (const [reference, url] of Object.entries(result.blobs ?? {})) {
|
|
205
|
+
console.error(`${reference} ${url}`);
|
|
206
|
+
}
|
|
207
|
+
if (options.saveBlobs !== void 0) {
|
|
208
|
+
await saveBlobs(result.response, options.saveBlobs, options.workingDir);
|
|
209
|
+
}
|
|
210
|
+
} finally {
|
|
211
|
+
await session.close();
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
export {
|
|
215
|
+
describeEndpointFailure,
|
|
216
|
+
endpointCallCommand,
|
|
217
|
+
endpointFailureCode
|
|
218
|
+
};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
deleteSettingsEditor
|
|
4
|
+
} from "./cli-AK7OIPWY.js";
|
|
5
|
+
import "./cli-GGPDQNM3.js";
|
|
6
|
+
import "./cli-UJ4UCL2Z.js";
|
|
7
|
+
import "./cli-S5IVGDDD.js";
|
|
8
|
+
import "./cli-YVVXUD2G.js";
|
|
9
|
+
import "./cli-4UWFQNGF.js";
|
|
10
|
+
import "./cli-FYINNRML.js";
|
|
11
|
+
import "./cli-IUS2YCD3.js";
|
|
12
|
+
import "./cli-QUNIRH7A.js";
|
|
13
|
+
import "./cli-BYJWFFCF.js";
|
|
14
|
+
import "./cli-XSVGKI3R.js";
|
|
15
|
+
import "./cli-MBNMPVDC.js";
|
|
16
|
+
import "./cli-GFBGYFYD.js";
|
|
17
|
+
import "./cli-UELGBQG7.js";
|
|
18
|
+
import "./cli-ZTWOE3ZT.js";
|
|
19
|
+
import "./cli-4BV45LBH.js";
|
|
20
|
+
import "./cli-4AKVLEC4.js";
|
|
21
|
+
import "./cli-VCKOC2EV.js";
|
|
22
|
+
import "./cli-E2NLWIFE.js";
|
|
23
|
+
import "./cli-25RWY5BQ.js";
|
|
24
|
+
import "./cli-QWQMPCL6.js";
|
|
25
|
+
import "./cli-SMFSZF2G.js";
|
|
26
|
+
import "./cli-F2D4GGUA.js";
|
|
27
|
+
import "./cli-4YB3ROVR.js";
|
|
28
|
+
import "./cli-N6H6T2E2.js";
|
|
29
|
+
|
|
30
|
+
// cli/commands/resources/scenario-editor/delete.ts
|
|
31
|
+
function deleteScenarioEditor(options) {
|
|
32
|
+
return deleteSettingsEditor("scenario_editor", options);
|
|
33
|
+
}
|
|
34
|
+
export {
|
|
35
|
+
deleteScenarioEditor
|
|
36
|
+
};
|