@marinoscar/platform-cli 0.1.0-next.24 → 0.1.0-next.25

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 (69) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +4 -3
  3. package/dist/engine/commands/node.d.ts.map +1 -1
  4. package/dist/engine/commands/node.js +65 -6
  5. package/dist/engine/commands/node.js.map +1 -1
  6. package/dist/engine/conformance.d.ts +3 -0
  7. package/dist/engine/conformance.d.ts.map +1 -1
  8. package/dist/engine/conformance.js +7 -0
  9. package/dist/engine/conformance.js.map +1 -1
  10. package/dist/engine/index.d.ts +8 -2
  11. package/dist/engine/index.d.ts.map +1 -1
  12. package/dist/engine/index.js +4 -1
  13. package/dist/engine/index.js.map +1 -1
  14. package/dist/engine/node/capabilities.d.ts +199 -4
  15. package/dist/engine/node/capabilities.d.ts.map +1 -1
  16. package/dist/engine/node/capabilities.js +292 -11
  17. package/dist/engine/node/capabilities.js.map +1 -1
  18. package/dist/engine/node/doctor.d.ts +2 -0
  19. package/dist/engine/node/doctor.d.ts.map +1 -1
  20. package/dist/engine/node/doctor.js +56 -3
  21. package/dist/engine/node/doctor.js.map +1 -1
  22. package/dist/engine/node/install-deps.d.ts +164 -6
  23. package/dist/engine/node/install-deps.d.ts.map +1 -1
  24. package/dist/engine/node/install-deps.js +251 -9
  25. package/dist/engine/node/install-deps.js.map +1 -1
  26. package/dist/engine/node/models.d.ts +195 -0
  27. package/dist/engine/node/models.d.ts.map +1 -0
  28. package/dist/engine/node/models.js +379 -0
  29. package/dist/engine/node/models.js.map +1 -0
  30. package/dist/engine/node/node-engine.d.ts +13 -1
  31. package/dist/engine/node/node-engine.d.ts.map +1 -1
  32. package/dist/engine/node/node-engine.js +18 -3
  33. package/dist/engine/node/node-engine.js.map +1 -1
  34. package/dist/engine/node/runtime-state.d.ts +1 -1
  35. package/dist/engine/node/start.d.ts.map +1 -1
  36. package/dist/engine/node/start.js +38 -2
  37. package/dist/engine/node/start.js.map +1 -1
  38. package/dist/engine/node/worker-env.d.ts +5 -0
  39. package/dist/engine/node/worker-env.d.ts.map +1 -1
  40. package/dist/engine/node/worker-env.js +5 -0
  41. package/dist/engine/node/worker-env.js.map +1 -1
  42. package/dist/engine/registries.d.ts.map +1 -1
  43. package/dist/engine/registries.js +2 -0
  44. package/dist/engine/registries.js.map +1 -1
  45. package/dist/engine/tui/conformance.d.ts +143 -0
  46. package/dist/engine/tui/conformance.d.ts.map +1 -0
  47. package/dist/engine/tui/conformance.js +423 -0
  48. package/dist/engine/tui/conformance.js.map +1 -0
  49. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  50. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  51. package/dist/engine/tui/testing/feeds.js +67 -0
  52. package/dist/engine/tui/testing/feeds.js.map +1 -0
  53. package/dist/engine/tui/testing/harness.d.ts +241 -0
  54. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  55. package/dist/engine/tui/testing/harness.js +332 -0
  56. package/dist/engine/tui/testing/harness.js.map +1 -0
  57. package/dist/node/index.d.ts +2 -2
  58. package/dist/node/index.d.ts.map +1 -1
  59. package/dist/node/index.js +1 -1
  60. package/dist/node/index.js.map +1 -1
  61. package/dist/testing/index.d.ts +2 -2
  62. package/dist/testing/index.d.ts.map +1 -1
  63. package/dist/testing/index.js +1 -1
  64. package/dist/testing/index.js.map +1 -1
  65. package/dist/tui/testing/index.d.ts +5 -0
  66. package/dist/tui/testing/index.d.ts.map +1 -0
  67. package/dist/tui/testing/index.js +12 -0
  68. package/dist/tui/testing/index.js.map +1 -0
  69. package/package.json +11 -3
@@ -1,4 +1,4 @@
1
- import { execFileSync } from 'node:child_process';
1
+ import { execFile, spawn } from 'node:child_process';
2
2
  import { mkdirSync, readFileSync } from 'node:fs';
3
3
  import { cliName } from '../identity.js';
4
4
  import { isWritable } from './capabilities.js';
@@ -8,6 +8,10 @@ import { isWritable } from './capabilities.js';
8
8
  * Best effort by construction: a distro nobody anticipated yields `unknown`,
9
9
  * and every step that cares reports `unsupported` rather than guessing a
10
10
  * package manager and running it.
11
+ *
12
+ * @param options - test seams: the platform and the `os-release` text.
13
+ * @returns the distro id, version and package-manager family.
14
+ * @stability experimental
11
15
  */
12
16
  export function detectDistro(options) {
13
17
  const plat = options?.platform ?? process.platform;
@@ -82,8 +86,9 @@ export const DEFAULT_INSTALL_STEPS = [
82
86
  * `--dry-run` PERFORMS NO MUTATION: `detect` still runs (it is read-only and
83
87
  * is what makes the plan accurate), `install` does not.
84
88
  */
85
- export function runInstallDeps(options) {
86
- const steps = options.steps ?? DEFAULT_INSTALL_STEPS;
89
+ export async function runInstallDeps(options) {
90
+ const all = options.steps ?? listInstallSteps();
91
+ const steps = selectInstallSteps(all, options.only);
87
92
  const dryRun = options.dryRun === true;
88
93
  const log = options.log ?? (() => { });
89
94
  const distro = options.distro ?? detectDistro();
@@ -92,9 +97,8 @@ export function runInstallDeps(options) {
92
97
  dryRun,
93
98
  stateDir: options.stateDir,
94
99
  run: options.run ??
95
- ((command, args) => {
96
- execFileSync(command, args, { stdio: 'inherit' });
97
- }),
100
+ ((command, args) => runInherited(command, args)),
101
+ capture: options.capture ?? captureStdout,
98
102
  log,
99
103
  };
100
104
  const escalating = steps.filter((step) => step.requiresSudo === true);
@@ -104,13 +108,21 @@ export function runInstallDeps(options) {
104
108
  }
105
109
  const results = [];
106
110
  for (const step of steps) {
107
- if (!step.supported(context)) {
111
+ let supported;
112
+ try {
113
+ supported = await step.supported(context);
114
+ }
115
+ catch (error) {
116
+ results.push({ id: step.id, label: step.label, outcome: 'failed', detail: messageOf(error) });
117
+ continue;
118
+ }
119
+ if (!supported) {
108
120
  results.push({ id: step.id, label: step.label, outcome: 'unsupported', detail: `Not supported on ${distro.id}` });
109
121
  continue;
110
122
  }
111
123
  let satisfied;
112
124
  try {
113
- satisfied = step.detect(context);
125
+ satisfied = await step.detect(context);
114
126
  }
115
127
  catch (error) {
116
128
  results.push({ id: step.id, label: step.label, outcome: 'failed', detail: messageOf(error) });
@@ -125,7 +137,7 @@ export function runInstallDeps(options) {
125
137
  continue;
126
138
  }
127
139
  try {
128
- step.install(context);
140
+ await step.install(context);
129
141
  results.push({ id: step.id, label: step.label, outcome: 'installed' });
130
142
  }
131
143
  catch (error) {
@@ -144,7 +156,237 @@ export function formatInstallReport(report) {
144
156
  }
145
157
  return `${lines.join('\n')}\n`;
146
158
  }
159
+ function captureStdout(command, args) {
160
+ return new Promise((resolve, reject) => {
161
+ execFile(command, args, { encoding: 'utf8', timeout: 30_000, maxBuffer: 1024 * 1024 }, (error, stdout) => {
162
+ if (error !== null)
163
+ reject(error);
164
+ else
165
+ resolve(stdout);
166
+ });
167
+ });
168
+ }
169
+ /** Runs a command with inherited stdio, rejecting on a spawn error or a non-zero exit. */
170
+ function runInherited(command, args) {
171
+ return new Promise((resolve, reject) => {
172
+ const child = spawn(command, args, { stdio: 'inherit' });
173
+ child.once('error', reject);
174
+ child.once('exit', (code, signal) => {
175
+ if (code === 0)
176
+ resolve();
177
+ else
178
+ reject(new Error(`${command} ${args.join(' ')} exited with ${code === null ? `signal ${String(signal)}` : `code ${code}`}`));
179
+ });
180
+ });
181
+ }
147
182
  function messageOf(error) {
148
183
  return error instanceof Error ? error.message : String(error);
149
184
  }
185
+ const STEP_ID_PATTERN = /^[a-z][a-z0-9._-]{0,63}$/;
186
+ const registeredSteps = [];
187
+ /**
188
+ * Declares a step `node install-deps` runs after the built-in ones. Call it at
189
+ * module scope, before the node command runs (the module that holds your
190
+ * `createCli({ nodeExecutors })` is the natural place).
191
+ *
192
+ * A step is idempotent by contract: `detect` says whether it is already
193
+ * satisfied (then the outcome is `skipped`), `install` does the work, and
194
+ * `--dry-run` runs `detect` only. A step needing `sudo` sets `requiresSudo` so
195
+ * the plan announces it, and runs its commands through
196
+ * {@link runWithSudoAnnounced}.
197
+ *
198
+ * @param step - the step, with an optional `order` or `after` placement.
199
+ * @throws Error when the id is malformed or already taken (by a built-in or an earlier registration).
200
+ *
201
+ * @example
202
+ * ```ts
203
+ * registerInstallStep({
204
+ * id: 'transcoder',
205
+ * label: 'Media transcoder',
206
+ * requiresSudo: true,
207
+ * supported: (ctx) => ctx.distro.family === 'debian',
208
+ * detect: (ctx) => ctx.capture('ffmpeg', ['-version']).then(() => true, () => false),
209
+ * install: (ctx) => ensureAptPackages(['ffmpeg'], ctx),
210
+ * });
211
+ * ```
212
+ *
213
+ * @extensionPoint registry
214
+ * @stability experimental
215
+ */
216
+ export function registerInstallStep(step) {
217
+ if (typeof step?.id !== 'string' || !STEP_ID_PATTERN.test(step.id)) {
218
+ throw new Error(`registerInstallStep: "${String(step?.id)}" is not a valid step id (${STEP_ID_PATTERN}).`);
219
+ }
220
+ if (typeof step.label !== 'string' || step.label.trim() === '')
221
+ throw new Error(`registerInstallStep("${step.id}"): a label is required.`);
222
+ for (const fn of ['supported', 'detect', 'install']) {
223
+ if (typeof step[fn] !== 'function')
224
+ throw new Error(`registerInstallStep("${step.id}"): "${fn}" must be a function.`);
225
+ }
226
+ if (step.order !== undefined && !Number.isFinite(step.order))
227
+ throw new Error(`registerInstallStep("${step.id}"): order must be a finite number.`);
228
+ if (DEFAULT_INSTALL_STEPS.some((existing) => existing.id === step.id) || registeredSteps.some((existing) => existing.id === step.id)) {
229
+ throw new Error(`registerInstallStep: a step with id "${step.id}" is already registered.`);
230
+ }
231
+ registeredSteps.push(step);
232
+ }
233
+ /**
234
+ * The steps `node install-deps` runs: the built-ins, then the registered steps.
235
+ * Throws when a step names an `after` id that does not exist, or the `after`
236
+ * links form a cycle.
237
+ *
238
+ * @returns the steps in execution order.
239
+ * @stability experimental
240
+ */
241
+ export function listInstallSteps() {
242
+ const placed = [...DEFAULT_INSTALL_STEPS];
243
+ const byOrder = registeredSteps
244
+ .filter((step) => step.after === undefined)
245
+ .map((step, index) => ({ step, index }))
246
+ .sort((a, b) => (a.step.order ?? 0) - (b.step.order ?? 0) || a.index - b.index)
247
+ .map((entry) => entry.step);
248
+ placed.push(...byOrder);
249
+ let pending = registeredSteps.filter((step) => step.after !== undefined);
250
+ while (pending.length > 0) {
251
+ const next = [];
252
+ for (const step of pending) {
253
+ let at = placed.findIndex((candidate) => candidate.id === step.after);
254
+ if (at === -1) {
255
+ next.push(step);
256
+ continue;
257
+ }
258
+ // Keep several steps that follow the same id in registration order.
259
+ while (placed[at + 1] !== undefined && registeredSteps.some((other) => other.after === step.after && other.id === placed[at + 1]?.id))
260
+ at += 1;
261
+ placed.splice(at + 1, 0, step);
262
+ }
263
+ if (next.length === pending.length) {
264
+ const stuck = next.map((step) => `${step.id} (after ${String(step.after)})`).join(', ');
265
+ throw new Error(`Install steps cannot be ordered: ${stuck}. Each "after" must name an existing step, without a cycle.`);
266
+ }
267
+ pending = next;
268
+ }
269
+ return placed;
270
+ }
271
+ function selectInstallSteps(steps, only) {
272
+ if (only === undefined || only.length === 0)
273
+ return steps;
274
+ const known = new Set(steps.map((step) => step.id));
275
+ const unknown = only.filter((id) => !known.has(id));
276
+ if (unknown.length > 0) {
277
+ throw new Error(`Unknown install step${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}. Known steps: ${[...known].join(', ')}.`);
278
+ }
279
+ const wanted = new Set(only);
280
+ return steps.filter((step) => wanted.has(step.id));
281
+ }
282
+ /** Removes one registered step. Tests only. @internal */
283
+ export function removeInstallStepForTests(id) {
284
+ const at = registeredSteps.findIndex((step) => step.id === id);
285
+ if (at !== -1)
286
+ registeredSteps.splice(at, 1);
287
+ }
288
+ /** Removes every registered step. Tests only (`resetCliRegistriesForTests` calls it). @internal */
289
+ export function resetInstallStepRegistryForTests() {
290
+ registeredSteps.length = 0;
291
+ }
292
+ /**
293
+ * Runs one privileged command: announced first, never run in `--dry-run`, and
294
+ * run without `sudo` when the process is already root.
295
+ *
296
+ * @param command - the executable to elevate (`apt-get`).
297
+ * @param args - its arguments.
298
+ * @param context - the step's context.
299
+ * @stability experimental
300
+ */
301
+ export async function runWithSudoAnnounced(command, args, context) {
302
+ const isRoot = typeof process.getuid === 'function' && process.getuid() === 0;
303
+ const line = `${isRoot ? '' : 'sudo '}${command} ${args.join(' ')}`.trim();
304
+ if (context.dryRun) {
305
+ context.log(`Would run: ${line}`);
306
+ return;
307
+ }
308
+ context.log(`Running: ${line}`);
309
+ await (isRoot ? context.run(command, args) : context.run('sudo', [command, ...args]));
310
+ }
311
+ const APT_PACKAGE_PATTERN = /^[a-z0-9][a-z0-9+.-]{0,99}$/;
312
+ /**
313
+ * Installs the Debian-family packages that are not installed yet, with one
314
+ * announced `apt-get install -y`. Nothing runs when all are present, and
315
+ * nothing in `--dry-run`.
316
+ *
317
+ * @param names - package names (`['ffmpeg']`).
318
+ * @param context - the step's context.
319
+ * @returns the packages that were (or, in a dry run, would be) installed.
320
+ * @throws Error on a non-Debian distro or a malformed package name.
321
+ * @stability experimental
322
+ */
323
+ export async function ensureAptPackages(names, context) {
324
+ if (context.distro.family !== 'debian') {
325
+ throw new Error(`apt packages (${names.join(', ')}) can only be installed on a Debian-family system; this is ${context.distro.id}.`);
326
+ }
327
+ for (const name of names) {
328
+ if (!APT_PACKAGE_PATTERN.test(name))
329
+ throw new Error(`"${name}" is not a valid apt package name.`);
330
+ }
331
+ const missing = [];
332
+ for (const name of names) {
333
+ const installed = await context.capture('dpkg', ['-s', name]).then((out) => /^Status:.*\binstall ok installed\b/m.test(out), () => false);
334
+ if (!installed)
335
+ missing.push(name);
336
+ }
337
+ if (missing.length === 0)
338
+ return [];
339
+ await runWithSudoAnnounced('apt-get', ['install', '-y', ...missing], context);
340
+ return missing;
341
+ }
342
+ const DOCKER_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/;
343
+ /**
344
+ * Makes a container exist, run and (when `verify` is given) answer: starts a
345
+ * stopped one, creates a missing one with `--restart unless-stopped`, and
346
+ * polls `verify` up to 20 times 2 s apart.
347
+ *
348
+ * @param spec - the container.
349
+ * @param context - the step's context.
350
+ * @returns what it did: `running` (already up), `started`, `created`, or `planned` (dry run).
351
+ * @throws Error when docker is missing, the name or image is malformed, or `verify` never passes.
352
+ * @stability experimental
353
+ */
354
+ export async function ensureDockerContainer(spec, context) {
355
+ if (!DOCKER_NAME_PATTERN.test(spec.name))
356
+ throw new Error(`"${spec.name}" is not a valid container name.`);
357
+ if (spec.image.trim() === '' || spec.image.startsWith('-'))
358
+ throw new Error(`"${spec.image}" is not a valid image reference.`);
359
+ await context.capture('docker', ['--version']).catch(() => {
360
+ throw new Error('Docker is not installed or not on PATH.');
361
+ });
362
+ const state = (await context.capture('docker', ['inspect', '-f', '{{.State.Running}}', spec.name]).catch(() => 'absent')).trim();
363
+ const docker = (args) => (spec.sudo === true ? runWithSudoAnnounced('docker', args, context) : Promise.resolve(context.run('docker', args)));
364
+ let outcome = 'running';
365
+ if (state !== 'true') {
366
+ if (context.dryRun) {
367
+ context.log(`Would ${state === 'false' ? 'start' : 'create'} container ${spec.name} (dry run)`);
368
+ return 'planned';
369
+ }
370
+ if (state === 'false') {
371
+ await docker(['start', spec.name]);
372
+ outcome = 'started';
373
+ }
374
+ else {
375
+ await docker(['run', '-d', '--name', spec.name, '--restart', 'unless-stopped', ...(spec.args ?? []), spec.image]);
376
+ outcome = 'created';
377
+ }
378
+ }
379
+ if (spec.verify !== undefined) {
380
+ const attempts = spec.verifyAttempts ?? 20;
381
+ const sleep = spec.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
382
+ for (let attempt = 1; attempt <= attempts; attempt += 1) {
383
+ if (await Promise.resolve(spec.verify(context)).catch(() => false))
384
+ return outcome;
385
+ if (attempt < attempts)
386
+ await sleep(spec.verifyIntervalMs ?? 2000);
387
+ }
388
+ throw new Error(`Container ${spec.name} did not become healthy after ${attempts} checks.`);
389
+ }
390
+ return outcome;
391
+ }
150
392
  //# sourceMappingURL=install-deps.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"install-deps.js","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"install-deps.js","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,195 @@
1
+ import { type InstallStep } from './install-deps.js';
2
+ /**
3
+ * A model file an app declares.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export interface ModelArtifact {
8
+ /** Unique id, `[a-z][a-z0-9._-]*`. */
9
+ id: string;
10
+ /** File name under the models directory (and `targetSubdir`). No path separators. */
11
+ fileName: string;
12
+ /** Lowercase hex sha256 of the file. */
13
+ sha256: string;
14
+ /** Exact size in bytes. Checked before the (slower) hash. */
15
+ bytes: number;
16
+ /** Static download URL. One of `url` / `resolveUrl` is required. */
17
+ url?: string | undefined;
18
+ /** Computes the URL at pull time (a versioned or signed one). Never logged beyond its origin and path. */
19
+ resolveUrl?: ((context: {
20
+ artifact: ModelArtifact;
21
+ }) => string | Promise<string>) | undefined;
22
+ /** Job types that cannot run without this file. They are not advertised while it is missing or corrupt. */
23
+ requiredBy: string[];
24
+ /** A relative subdirectory under the models directory (`tesseract`). No `..`. */
25
+ targetSubdir?: string | undefined;
26
+ }
27
+ /**
28
+ * The state of one model on disk.
29
+ *
30
+ * @stability experimental
31
+ */
32
+ export type ModelStatus = 'ok' | 'missing' | 'corrupt';
33
+ /**
34
+ * The verdict for one model.
35
+ *
36
+ * @stability experimental
37
+ */
38
+ export interface ModelVerification {
39
+ /** The model's id. */
40
+ id: string;
41
+ /** `ok`, `missing` or `corrupt`. */
42
+ status: ModelStatus;
43
+ /** Where the file is (or would be). */
44
+ path: string;
45
+ /** Why, when not `ok`. */
46
+ detail?: string | undefined;
47
+ }
48
+ /**
49
+ * Declares a model file. Call it at module scope, before the node starts. It
50
+ * also adds a `models` install step (once) that pulls every declared file, so
51
+ * `node install-deps` fetches them, and a `model:<id>` capability that shows in
52
+ * `node doctor` and the heartbeat summary.
53
+ *
54
+ * @param artifact - the file, its checksum, its source and the job types that need it.
55
+ * @throws Error when a field is malformed, the id is taken, or neither `url` nor `resolveUrl` is given.
56
+ *
57
+ * @example
58
+ * ```ts
59
+ * registerModelArtifact({
60
+ * id: 'embedding',
61
+ * fileName: 'embedding-v1.onnx',
62
+ * sha256: '…64 hex characters…',
63
+ * bytes: 87_000_000,
64
+ * url: 'https://models.example.test/embedding-v1.onnx',
65
+ * requiredBy: ['app.embed'],
66
+ * });
67
+ * ```
68
+ *
69
+ * @extensionPoint registry
70
+ * @stability experimental
71
+ */
72
+ export declare function registerModelArtifact(artifact: ModelArtifact): void;
73
+ /**
74
+ * The declared models, in registration order.
75
+ *
76
+ * @returns copies of the declarations.
77
+ * @stability experimental
78
+ */
79
+ export declare function listModelArtifacts(): ModelArtifact[];
80
+ /**
81
+ * The directory models live in: `<PREFIX>MODELS_DIR`, else `<stateDir>/models`.
82
+ *
83
+ * @param stateDir - the worker state directory.
84
+ * @param env - the environment to read the override from.
85
+ * @returns an absolute or state-relative directory.
86
+ * @stability experimental
87
+ */
88
+ export declare function resolveModelsDir(stateDir: string, env?: NodeJS.ProcessEnv): string;
89
+ /**
90
+ * Where a model's file is (or will be).
91
+ *
92
+ * @param artifact - the declaration.
93
+ * @param modelsDir - the models directory.
94
+ * @returns the full path.
95
+ * @stability experimental
96
+ */
97
+ export declare function modelArtifactPath(artifact: Pick<ModelArtifact, 'fileName' | 'targetSubdir'>, modelsDir: string): string;
98
+ /**
99
+ * Checks one model on disk: present, the declared size, the declared sha256.
100
+ * Never throws.
101
+ *
102
+ * @param artifact - the declaration.
103
+ * @param modelsDir - the models directory.
104
+ * @returns `ok`, `missing` (no file) or `corrupt` (wrong size or hash).
105
+ * @stability experimental
106
+ */
107
+ export declare function verifyModel(artifact: ModelArtifact, modelsDir: string): Promise<ModelVerification>;
108
+ /**
109
+ * Verifies the declared models.
110
+ *
111
+ * @param modelsDir - the models directory.
112
+ * @param declared - which models; defaults to every registered one.
113
+ * @returns one verdict per model.
114
+ * @stability experimental
115
+ */
116
+ export declare function verifyModels(modelsDir: string, declared?: readonly ModelArtifact[]): Promise<ModelVerification[]>;
117
+ /**
118
+ * The job types that must not be advertised because a model they need is not
119
+ * `ok`.
120
+ *
121
+ * @param verdicts - the result of {@link verifyModels}.
122
+ * @param declared - the declarations the verdicts belong to; defaults to the registry.
123
+ * @returns each withheld type with the model ids that block it.
124
+ * @stability experimental
125
+ */
126
+ export declare function withheldTypesFor(verdicts: readonly ModelVerification[], declared?: readonly ModelArtifact[]): Map<string, string[]>;
127
+ /**
128
+ * What {@link pullModels} did for one model.
129
+ *
130
+ * @stability experimental
131
+ */
132
+ export interface ModelPullResult {
133
+ /** The model's id. */
134
+ id: string;
135
+ /** `present`: already valid, nothing fetched. `downloaded`: fetched and verified. `failed`: see `detail`. */
136
+ outcome: 'present' | 'downloaded' | 'failed';
137
+ /** The file's size in bytes. */
138
+ bytes?: number | undefined;
139
+ /** How long the pull took, in milliseconds. */
140
+ durationMs?: number | undefined;
141
+ /** Whether a partial file was continued with a range request. */
142
+ resumed?: boolean | undefined;
143
+ /** Why a pull failed. */
144
+ detail?: string | undefined;
145
+ }
146
+ /**
147
+ * Options of {@link pullModels}.
148
+ *
149
+ * @stability experimental
150
+ */
151
+ export interface PullModelsOptions {
152
+ /** The directory models are stored in. */
153
+ modelsDir: string;
154
+ /** Pull only these ids. Unknown ids are an error. */
155
+ ids?: readonly string[] | undefined;
156
+ /** Download even a valid file. */
157
+ force?: boolean | undefined;
158
+ /** Declarations to pull; defaults to the registry. */
159
+ declared?: readonly ModelArtifact[] | undefined;
160
+ /** Attempts per model for network failures, resuming a partial file between them. Default 3. */
161
+ attempts?: number | undefined;
162
+ /** Receives one line per download and result. */
163
+ log?: ((message: string) => void) | undefined;
164
+ /** Test seam for the HTTP client. */
165
+ fetch?: typeof fetch | undefined;
166
+ /** Test seam for the wait between retries. */
167
+ sleep?: ((ms: number) => Promise<void>) | undefined;
168
+ }
169
+ /**
170
+ * Downloads and verifies the declared models into the models directory.
171
+ *
172
+ * Each file streams to `<file>.partial` (constant memory), is checked against
173
+ * its size and sha256, and is renamed into place atomically. A partial file
174
+ * left by an interrupted pull is continued with a `Range` request; a server
175
+ * that ignores the range restarts the file. A file that fails its sha256 is
176
+ * deleted and not retried. A valid file already in place is left alone.
177
+ * One model failing does not stop the others, and nothing throws.
178
+ *
179
+ * @param options - the directory, the selection and the test seams.
180
+ * @returns one result per model.
181
+ * @throws Error when `ids` names a model that is not registered.
182
+ * @stability experimental
183
+ */
184
+ export declare function pullModels(options: PullModelsOptions): Promise<ModelPullResult[]>;
185
+ /**
186
+ * The `models` install step: pulls every declared model, skipping the valid
187
+ * ones. Added automatically by the first {@link registerModelArtifact}.
188
+ *
189
+ * @returns the step.
190
+ * @internal
191
+ */
192
+ export declare function createModelsInstallStep(): InstallStep;
193
+ /** Empties the registry. Tests only (`resetCliRegistriesForTests` calls it). @internal */
194
+ export declare function resetModelRegistryForTests(): void;
195
+ //# sourceMappingURL=models.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/engine/node/models.ts"],"names":[],"mappings":"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"}