@fnndsc/brasa 0.56.1 → 0.56.3

package/dist/chris/pacsResources.d.ts

@@ -0,0 +1,259 @@
+import { type CommandGrammar } from '../core/commandDeclaration.js';
+/** A parsed line, as the chili writer reads it. */
+interface ChiliLine {
+    /** The subcommand. */
+    readonly subcommand: string | null;
+    /** The operands, by name. */
+    readonly operands: Readonly<Record<string, unknown>>;
+    /** The options, by property. */
+    readonly options: Readonly<Record<string, unknown>>;
+}
+/**
+ * A parsed line written back as chili's words: the subcommand, each option
+ * given (`--long`, with its value), then the operands in order.
+ *
+ * @param grammar - The command's grammar.
+ * @param line - The line, parsed.
+ * @returns chili's words after the command.
+ *
+ * @example
+ * ```ts
+ * chiliWords_write(PACSQUERIES_GRAMMAR, { subcommand: 'decode', operands: { queryId: 7 }, options: { raw: true } }); // ['decode', '--raw', '7']
+ * ```
+ */
+export declare function chiliWords_write(grammar: CommandGrammar, line: ChiliLine): string[];
+/**
+ * `pacsservers <list [options] | fieldslist>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsserversCommand] }, 'backend');
+ * ```
+ */
+export declare const pacsserversCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly subcommands: {
+        readonly list: {
+            readonly summary: "List the PACS servers CUBE registers";
+            readonly options: {
+                readonly page: {
+                    readonly short: "p";
+                    readonly long: "page";
+                    readonly summary: "Page size (default 20)";
+                    readonly value: {
+                        readonly name: "size";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly fields: {
+                    readonly short: "f";
+                    readonly long: "fields";
+                    readonly summary: "Comma-separated fields to display";
+                    readonly value: {
+                        readonly name: "fields";
+                        readonly kind: "word";
+                    };
+                };
+                readonly search: {
+                    readonly short: "s";
+                    readonly long: "search";
+                    readonly summary: "Search by comma-separated key:value pairs";
+                    readonly value: {
+                        readonly name: "terms";
+                        readonly kind: "word";
+                    };
+                };
+                readonly sort: {
+                    readonly long: "sort";
+                    readonly summary: "Sort by field (name, size, date, owner, …)";
+                    readonly value: {
+                        readonly name: "field";
+                        readonly kind: "word";
+                    };
+                };
+                readonly reverse: {
+                    readonly short: "r";
+                    readonly long: "reverse";
+                    readonly summary: "Reverse the sort order";
+                };
+                readonly table: {
+                    readonly long: "table";
+                    readonly summary: "Tabular output, with headers";
+                };
+                readonly csv: {
+                    readonly long: "csv";
+                    readonly summary: "CSV output (over --table)";
+                };
+            };
+        };
+        readonly fieldslist: {
+            readonly summary: "List the fields a PACS server has";
+        };
+    };
+}>;
+/**
+ * `pacsqueries <list | fieldslist | create <query> | decode <queryId>>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsqueriesCommand] }, 'backend');
+ * ```
+ */
+export declare const pacsqueriesCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly subcommands: {
+        readonly list: {
+            readonly summary: "List the queries asked of the PACS server";
+            readonly options: {
+                readonly pacsserver: {
+                    readonly long: "pacsserver";
+                    readonly summary: "The PACS server, by id or identifier (default: the context's)";
+                    readonly value: {
+                        readonly name: "id";
+                        readonly kind: "word";
+                    };
+                };
+                readonly page: {
+                    readonly short: "p";
+                    readonly long: "page";
+                    readonly summary: "Page size (default 20)";
+                    readonly value: {
+                        readonly name: "size";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly fields: {
+                    readonly short: "f";
+                    readonly long: "fields";
+                    readonly summary: "Comma-separated fields to display";
+                    readonly value: {
+                        readonly name: "fields";
+                        readonly kind: "word";
+                    };
+                };
+                readonly search: {
+                    readonly short: "s";
+                    readonly long: "search";
+                    readonly summary: "Search by comma-separated key:value pairs";
+                    readonly value: {
+                        readonly name: "terms";
+                        readonly kind: "word";
+                    };
+                };
+                readonly sort: {
+                    readonly long: "sort";
+                    readonly summary: "Sort by field (name, size, date, owner, …)";
+                    readonly value: {
+                        readonly name: "field";
+                        readonly kind: "word";
+                    };
+                };
+                readonly reverse: {
+                    readonly short: "r";
+                    readonly long: "reverse";
+                    readonly summary: "Reverse the sort order";
+                };
+                readonly table: {
+                    readonly long: "table";
+                    readonly summary: "Tabular output, with headers";
+                };
+                readonly csv: {
+                    readonly long: "csv";
+                    readonly summary: "CSV output (over --table)";
+                };
+            };
+        };
+        readonly fieldslist: {
+            readonly summary: "List the fields a PACS query has";
+        };
+        readonly create: {
+            readonly summary: "Create a PACS query against the current or given server";
+            readonly operands: readonly [{
+                readonly name: "query";
+                readonly kind: "word";
+                readonly summary: "The question: JSON, or comma-separated Key:Value pairs";
+            }];
+            readonly options: {
+                readonly title: {
+                    readonly long: "title";
+                    readonly summary: "Title for the query";
+                    readonly value: {
+                        readonly name: "title";
+                        readonly kind: "word";
+                    };
+                };
+                readonly description: {
+                    readonly long: "description";
+                    readonly summary: "A description for the query";
+                    readonly value: {
+                        readonly name: "description";
+                        readonly kind: "word";
+                    };
+                };
+                readonly pacsserver: {
+                    readonly long: "pacsserver";
+                    readonly summary: "The PACS server, by id or identifier (default: the context's)";
+                    readonly value: {
+                        readonly name: "id";
+                        readonly kind: "word";
+                    };
+                };
+            };
+        };
+        readonly decode: {
+            readonly summary: "Decode the result payload of a PACS query";
+            readonly operands: readonly [{
+                readonly name: "queryId";
+                readonly kind: "int";
+                readonly min: 1;
+                readonly summary: "The query's id";
+            }];
+            readonly options: {
+                readonly raw: {
+                    readonly long: "raw";
+                    readonly summary: "Print the raw decoded JSON";
+                };
+            };
+        };
+    };
+}>;
+/**
+ * `pacsretrieve <pull <queryId> | report <queryId> | cancel <retrieveId>>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsretrieveCommand] }, 'backend');
+ * ```
+ */
+export declare const pacsretrieveCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly subcommands: {
+        readonly pull: {
+            readonly summary: "Retrieve a query's DICOM data into ChRIS";
+            readonly operands: readonly [{
+                readonly name: "queryId";
+                readonly kind: "int";
+                readonly min: 1;
+                readonly summary: "The query's id";
+            }];
+        };
+        readonly report: {
+            readonly summary: "Show the status of a query's retrieve";
+            readonly operands: readonly [{
+                readonly name: "queryId";
+                readonly kind: "int";
+                readonly min: 1;
+                readonly summary: "The query's id";
+            }];
+        };
+        readonly cancel: {
+            readonly summary: "Cancel (delete) a retrieve";
+            readonly operands: readonly [{
+                readonly name: "retrieveId";
+                readonly kind: "int";
+                readonly min: 1;
+                readonly summary: "The retrieve's id";
+            }];
+        };
+    };
+}>;
+export {};

package/dist/chris/pacsResources.js

@@ -0,0 +1,168 @@
+import { command_declare } from '../core/commandDeclaration.js';
+import { chiliCommand_run } from './chiliDelegate.js';
+/** A resource listing's options, as chili's `list` takes them. */
+const LIST_OPTIONS = {
+    page: { short: 'p', long: 'page', summary: 'Page size (default 20)', value: { name: 'size', kind: 'int', min: 1 } },
+    fields: { short: 'f', long: 'fields', summary: 'Comma-separated fields to display', value: { name: 'fields', kind: 'word' } },
+    search: { short: 's', long: 'search', summary: 'Search by comma-separated key:value pairs', value: { name: 'terms', kind: 'word' } },
+    sort: { long: 'sort', summary: 'Sort by field (name, size, date, owner, …)', value: { name: 'field', kind: 'word' } },
+    reverse: { short: 'r', long: 'reverse', summary: 'Reverse the sort order' },
+    table: { long: 'table', summary: 'Tabular output, with headers' },
+    csv: { long: 'csv', summary: 'CSV output (over --table)' },
+};
+/** A PACS server, as `--pacsserver` names one. */
+const PACSSERVER_OPTION = { long: 'pacsserver', summary: 'The PACS server, by id or identifier (default: the context\'s)', value: { name: 'id', kind: 'word' } };
+/**
+ * A parsed line written back as chili's words: the subcommand, each option
+ * given (`--long`, with its value), then the operands in order.
+ *
+ * @param grammar - The command's grammar.
+ * @param line - The line, parsed.
+ * @returns chili's words after the command.
+ *
+ * @example
+ * ```ts
+ * chiliWords_write(PACSQUERIES_GRAMMAR, { subcommand: 'decode', operands: { queryId: 7 }, options: { raw: true } }); // ['decode', '--raw', '7']
+ * ```
+ */
+export function chiliWords_write(grammar, line) {
+    const scope = line.subcommand === null ? undefined : grammar.subcommands?.[line.subcommand];
+    const words = line.subcommand === null ? [] : [line.subcommand];
+    const options = Object.entries({ ...(scope?.options ?? {}), ...(grammar.options ?? {}) });
+    for (const [key, option] of options) {
+        const value = line.options[key];
+        const name = option.long !== undefined ? `--${option.long}` : `-${option.short ?? ''}`;
+        if (value === true)
+            words.push(name);
+        else if (typeof value === 'string' || typeof value === 'number')
+            words.push(name, String(value));
+    }
+    for (const operand of scope?.operands ?? grammar.operands ?? []) {
+        const value = line.operands[operand.name];
+        if (Array.isArray(value))
+            words.push(...value.map(String));
+        else if (value !== undefined)
+            words.push(String(value));
+    }
+    return words;
+}
+/**
+ * Runs a declared line through chili.
+ *
+ * @param name - The chili command.
+ * @param grammar - Its grammar.
+ * @param line - The line, parsed.
+ * @returns chili's captured output.
+ */
+function chiliLine_run(name, grammar, line) {
+    return chiliCommand_run(name, ['-s', ...chiliWords_write(grammar, line)]);
+}
+/** What a `pacsservers` line may hold. */
+const PACSSERVERS_GRAMMAR = {
+    subcommands: {
+        list: { summary: 'List the PACS servers CUBE registers', options: LIST_OPTIONS },
+        fieldslist: { summary: 'List the fields a PACS server has' },
+    },
+};
+/**
+ * `pacsservers <list [options] | fieldslist>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsserversCommand] }, 'backend');
+ * ```
+ */
+export const pacsserversCommand = command_declare({
+    name: 'pacsservers',
+    grammar: PACSSERVERS_GRAMMAR,
+    help: {
+        summary: 'List or inspect available PACS servers (context-aware)',
+        description: 'The PACS servers CUBE registers, as a resource listing: list them, or list the fields a server has.',
+        category: 'PACS',
+        examples: [
+            'pacsservers list         # List PACS servers',
+            'pacsservers list --table # Table view',
+            'pacsservers fieldslist   # Show fields',
+        ],
+    },
+    // Listing servers changes nothing of the session.
+    holds: [],
+    handler: (line) => chiliLine_run('pacsservers', PACSSERVERS_GRAMMAR, line),
+});
+/** What a `pacsqueries` line may hold. */
+const PACSQUERIES_GRAMMAR = {
+    subcommands: {
+        list: { summary: 'List the queries asked of the PACS server', options: { ...LIST_OPTIONS, pacsserver: PACSSERVER_OPTION } },
+        fieldslist: { summary: 'List the fields a PACS query has' },
+        create: {
+            summary: 'Create a PACS query against the current or given server',
+            operands: [{ name: 'query', kind: 'word', summary: 'The question: JSON, or comma-separated Key:Value pairs' }],
+            options: {
+                title: { long: 'title', summary: 'Title for the query', value: { name: 'title', kind: 'word' } },
+                description: { long: 'description', summary: 'A description for the query', value: { name: 'description', kind: 'word' } },
+                pacsserver: PACSSERVER_OPTION,
+            },
+        },
+        decode: {
+            summary: 'Decode the result payload of a PACS query',
+            operands: [{ name: 'queryId', kind: 'int', min: 1, summary: 'The query\'s id' }],
+            options: { raw: { long: 'raw', summary: 'Print the raw decoded JSON' } },
+        },
+    },
+};
+/**
+ * `pacsqueries <list | fieldslist | create <query> | decode <queryId>>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsqueriesCommand] }, 'backend');
+ * ```
+ */
+export const pacsqueriesCommand = command_declare({
+    name: 'pacsqueries',
+    grammar: PACSQUERIES_GRAMMAR,
+    help: {
+        summary: 'Create or list PACS queries (uses current pacsserver context unless overridden)',
+        description: 'The queries asked of a PACS, as a resource listing: list them (for the context\'s server unless --pacsserver names one), list their fields, create one, or decode one\'s answer.',
+        category: 'PACS',
+        examples: [
+            'pacsqueries list                          # List for current pacsserver',
+            'pacsqueries list --pacsserver PACSDCM     # Override server',
+            'pacsqueries create "PatientID:1234" --title "PID 1234"',
+            'pacsqueries decode <id>                   # Decode a query result',
+        ],
+    },
+    handler: (line) => chiliLine_run('pacsqueries', PACSQUERIES_GRAMMAR, line),
+});
+/** What a `pacsretrieve` line may hold. */
+const PACSRETRIEVE_GRAMMAR = {
+    subcommands: {
+        pull: { summary: 'Retrieve a query\'s DICOM data into ChRIS', operands: [{ name: 'queryId', kind: 'int', min: 1, summary: 'The query\'s id' }] },
+        report: { summary: 'Show the status of a query\'s retrieve', operands: [{ name: 'queryId', kind: 'int', min: 1, summary: 'The query\'s id' }] },
+        cancel: { summary: 'Cancel (delete) a retrieve', operands: [{ name: 'retrieveId', kind: 'int', min: 1, summary: 'The retrieve\'s id' }] },
+    },
+};
+/**
+ * `pacsretrieve <pull <queryId> | report <queryId> | cancel <retrieveId>>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsretrieveCommand] }, 'backend');
+ * ```
+ */
+export const pacsretrieveCommand = command_declare({
+    name: 'pacsretrieve',
+    grammar: PACSRETRIEVE_GRAMMAR,
+    help: {
+        summary: 'Pull or inspect DICOM retrieves for PACS queries',
+        description: 'A PACS query\'s retrieves: pull its DICOM data into ChRIS, report how far a retrieve has come, or cancel one.',
+        category: 'PACS',
+        examples: [
+            'pacsretrieve pull <queryId>       # Pull data for a query',
+            'pacsretrieve report <queryId>     # Show retrieve status',
+            'pacsretrieve cancel <retrieveId> # Cancel a retrieve',
+        ],
+    },
+    handler: (line) => chiliLine_run('pacsretrieve', PACSRETRIEVE_GRAMMAR, line),
+});
+//# sourceMappingURL=pacsResources.js.map

package/dist/chris/pacsResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacsResources.js","sourceRoot":"","sources":["../../src/chris/pacsResources.ts"],"names":[],"mappings":"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"}

package/dist/chris/promptContext.d.ts

@@ -43,6 +43,12 @@ export interface SessionPromptContext {
      * that left the boot gate has no other way to be heard.
      */
     warmupFailures?: WarmupFailure[];
+    /**
+     * Warm-up steps still running behind the prompt, by label. A daemon
+     * listens before its warm-up ends, so a surface that attaches early is
+     * told what the session is still warming.
+     */
+    warmupPending?: string[];
 }
 /**
  * Inputs the caller knows that the session state does not.

package/dist/chris/promptContext.js

@@ -12,7 +12,7 @@
  */
 import { jobsState_derive } from './jobsState.js';
 import { session } from '../session/index.js';
-import { warmupFailures_list } from '../core/warmupFailures.js';
+import { warmupFailures_list, warmupPending_list } from '../core/warmupFailures.js';
 import { context_getSingle } from '@fnndsc/salsa';
 import { pace_get, procCache_get } from '@fnndsc/cumin';
 /**
@@ -62,6 +62,7 @@ export async function sessionPromptContext_build(options = {}) {
     const roster = procCache_get().rosterSync_get();
     const sweeping = warmupRaw.active || lifecycle.state === 'reconciling' || lifecycle.state === 'failed';
     const warmupFailures = warmupFailures_list();
+    const warmupPending = warmupPending_list();
     const procWarmup = sweeping || feedLoad !== null || arrived.length > 0 || landed.length > 0 || roster !== null
         ? {
             loaded: warmupRaw.loaded,
@@ -93,6 +94,7 @@ export async function sessionPromptContext_build(options = {}) {
         lastCommandDurationMs: options.lastCommandDurationMs ?? 0,
         procWarmup,
         ...(warmupFailures.length > 0 ? { warmupFailures } : {}),
+        ...(warmupPending.length > 0 ? { warmupPending } : {}),
         procIndex,
     };
 }

package/dist/chris/promptContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptContext.js","sourceRoot":"","sources":["../../src/chris/promptContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"promptContext.js","sourceRoot":"","sources":["../../src/chris/promptContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAsB,MAAM,2BAA2B,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAiB,QAAQ,EAAyD,aAAa,EAAmJ,MAAM,eAAe,CAAC;AAgD/Q;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAoB,QAAQ,EAAE,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,MAAM;QACvC,KAAK,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,KAAK;QAC1C,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAWD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAuC,EAAE;IAEzC,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IACzD,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAY,OAAO,CAAC,OAAO,CAAC;IAE3C,MAAM,SAAS,GAAuB,aAAa,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAuB,aAAa,EAAE,CAAC,aAAa,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAY,SAAS,CAAC,YAAY,KAAK,SAAS,CAAC;IAC/D,MAAM,SAAS,GAAoB,SAAS,CAAC,KAAK,KAAK,QAAQ;QAC7D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACjC,uEAAuE;IACvE,qEAAqE;IACrE,uDAAuD;IACvD,MAAM,SAAS,GAA2B,aAAa,EAAE,CAAC,aAAa,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAgC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACnE,MAAM,KAAK,GAA6B,SAAS,CAAC,GAAG,CAAC,CAAC,IAA0B,EAA0B,EAAE,CAAC,CAAC;QAC7G,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvH,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAa,aAAa,EAAE,CAAC,eAAe,EAAE,CAAC;IAC5D,sEAAsE;IACtE,yEAAyE;IACzE,MAAM,MAAM,GAAqB,aAAa,EAAE,CAAC,qBAAqB,EAAE,CAAC;IACzE,MAAM,MAAM,GAA8B,aAAa,EAAE,CAAC,cAAc,EAAE,CAAC;IAC3E,MAAM,QAAQ,GACZ,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,KAAK,aAAa,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC;IACxF,MAAM,cAAc,GAAoB,mBAAmB,EAAE,CAAC;IAC9D,MAAM,aAAa,GAAa,kBAAkB,EAAE,CAAC;IACrD,MAAM,UAAU,GACd,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,IAAI;QACzF,CAAC,CAAC;YACE,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,QAAQ;YACR,KAAK,EAAE,SAAS;YAChB,QAAQ;YACR,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,0EAA0E;IAC1E,iEAAiE;IACjE,MAAM,SAAS,GACb,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;QACvF,CAAC,CAAC;YACE,IAAI,EAAE,SAAS,CAAC,MAAM;YACtB,KAAK,EAAE,aAAa,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK;SACrE;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,IAAI,EAAmB,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;QACpF,GAAG,EAAoB,SAAS,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAK,SAAS,CAAC;QAC/E,GAAG,EAAoB,SAAS,CAAC,CAAC,CAAC,GAAG,CAAY,CAAC,CAAC,GAAG;QACvD,UAAU,EAAa,OAAO,CAAC,UAAU,IAAI,IAAI;QACjD,YAAY,EAAW,OAAO,CAAC,gBAAgB,EAAE;QACjD,YAAY,EAAW,OAAO,CAAC,YAAY,IAAI,CAAC;QAChD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,CAAC;QACzD,UAAU;QACV,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/core/argumentKinds.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import type { ShellWord } from '../lib/parser.js';
+import type { ArgumentGrammar } from './commandDeclaration.js';
+/** What checking a word came to: its value, or why it is not one, in a few words (`valid: a, b`). */
+export type ArgumentCheck = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** What expanding a word came to: its words, or why it could not be expanded. */
+export type ArgumentExpansion = {
+    readonly ok: true;
+    readonly words: ShellWord[];
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * One kind of argument.
+ *
+ * @example
+ * ```ts
+ * const colour: ArgumentKind = {
+ *   name: 'colour',
+ *   summary: 'A colour name',
+ *   word_read: (word: string): ArgumentCheck => ({ ok: true, value: word }),
+ *   schema_make: (): z.ZodType => z.string(),
+ * };
+ * ```
+ */
+export interface ArgumentKind {
+    /** The name an argument gives as its `kind`. */
+    readonly name: string;
+    /** What it is, in a few words, for help and the schema. */
+    readonly summary: string;
+    /** A word that looks like a negative number is this kind's operand, not an option. */
+    readonly numeric?: boolean;
+    /** It is a path, so an argument of it may declare `glob`. */
+    readonly path?: boolean;
+    /**
+     * Turns a word into its value, or says why it is not one.
+     *
+     * @param word - The word as the line gave it.
+     * @param argument - The argument's grammar (an enum's values, a number's bounds).
+     * @returns The value, or the reason.
+     */
+    word_read(word: string, argument: ArgumentGrammar): ArgumentCheck;
+    /**
+     * The schema of the value, for a tool's input.
+     *
+     * @param argument - The argument's grammar.
+     * @returns The zod schema.
+     */
+    schema_make(argument: ArgumentGrammar): z.ZodType;
+    /**
+     * Completes a word typed so far.
+     *
+     * @param partial - The word so far.
+     * @param argument - The argument's grammar.
+     * @returns The candidates that start with it.
+     */
+    words_complete?(partial: string, argument: ArgumentGrammar): Promise<string[]>;
+    /**
+     * Pathname expansion: the words a wildcard matches.
+     *
+     * @param words - The words, quoting kept.
+     * @returns The expanded words, a word matching nothing left as written.
+     */
+    words_expand?(words: readonly ShellWord[]): Promise<ArgumentExpansion>;
+}
+/** The core's kind names, which a core command may use and no other. */
+export declare const CORE_KIND_NAMES: ReadonlyArray<string>;
+/**
+ * The candidates among some words that start with what was typed.
+ *
+ * @param words - The words.
+ * @param partial - What was typed.
+ * @returns Those that start with it.
+ */
+export declare function candidates_filter(words: ReadonlyArray<string>, partial: string): string[];
+/**
+ * Finds a kind: the core's, then the installed backend's.
+ *
+ * @param name - The kind's name.
+ * @returns The kind, or null when neither has it.
+ *
+ * @example
+ * ```ts
+ * argumentKind_get('cfsPath')?.path; // true
+ * ```
+ */
+export declare function argumentKind_get(name: string): ArgumentKind | null;
+/**
+ * Checks one word against its argument's kind.
+ *
+ * @param argument - The argument's grammar.
+ * @param word - The word.
+ * @returns The value, or why the word is not one (an unregistered kind says so).
+ *
+ * @example
+ * ```ts
+ * argumentWord_check({ kind: 'enum', values: ['a', 'b'] }, 'c'); // { ok: false, reason: 'valid: a, b' }
+ * ```
+ */
+export declare function argumentWord_check(argument: ArgumentGrammar, word: string): ArgumentCheck;