@fnndsc/menu 0.3.1 → 0.5.0

package/dist/pacs.js

@@ -26,6 +26,14 @@ export const pacsSeriesSchema = z.object({
 /** One found study and its series. */
 export const pacsStudySchema = z.object({
     studyUID: z.string().optional(),
+    /**
+     * The PACS that answered for this study, as its canonical identifier.
+     *
+     * Present when the answer could have come from more than one server —
+     * which is when it matters, because two servers may hold the same study
+     * and a row that cannot say which one it came from cannot be acted on.
+     */
+    server: z.string().optional(),
     /** The study's VFS path under the query — a study-level pull's argument. */
     vfsPath: z.string().optional(),
     description: z.string(),
@@ -36,6 +44,91 @@ export const pacsStudySchema = z.object({
     accession: z.string(),
     series: z.array(pacsSeriesSchema),
 });
+/**
+ * Where an answer came from: the PACS just now, or a query already stored.
+ *
+ * CUBE keeps every query it has run, so a question asked before can be
+ * answered without troubling the PACS. Which of the two happened is a fact
+ * about the answer, and it belongs on the model rather than in each
+ * surface's rendering: chell says it in a sentence, argus in a pill, and
+ * anything later in whatever voice it has — but all of them from one
+ * timestamp, said once by the kernel that knows it.
+ */
+export const pacsProvenanceSchema = z.object({
+    /** True when this answer came from a stored query rather than the PACS. */
+    replayed: z.boolean(),
+    /**
+     * When the PACS actually answered, as an ISO timestamp.
+     *
+     * The age is stated and never acted on. A query naming an accession is a
+     * fact about a study that exists; one naming an MRN can gain a match
+     * tomorrow. No heuristic separates those reliably, so the surface says
+     * how old an answer is and leaves the judgement with the operator.
+     */
+    answeredAt: z.string(),
+});
+/**
+ * What became of one patient in a query.
+ *
+ * Three states, not two. A query that could not be asked is not a query
+ * that found nothing: rendering a timeout as `0` is exactly the confident
+ * stale answer the replay work exists to refuse. The MRNs that come back
+ * are by definition the ones WITH imaging, which makes the answer an
+ * operator usually wants — the ones without — the invisible half unless
+ * absence is a state the model can say.
+ */
+export const PACS_PATIENT_STATUSES = ['found', 'none', 'unasked'];
+/**
+ * Open-world, degrading to `unasked`.
+ *
+ * A status this contract does not know is one this surface cannot claim an
+ * answer for, and `unasked` is the only degrade that never reads as a
+ * confident zero.
+ */
+export const pacsPatientStatusSchema = z.enum(PACS_PATIENT_STATUSES).catch('unasked');
+/**
+ * One patient the query asked about — found, empty-handed, or unreachable.
+ *
+ * The studies themselves stay where they are, on the model, each carrying
+ * its own `patientId`. This level is not a container for them; it is the
+ * record of what was ASKED, which is why it exists at all: a miss owns no
+ * study, so a level derived from the studies could never mention it.
+ */
+export const pacsPatientSchema = z.object({
+    /** The identifier as the operator asked it, never normalized. */
+    patientId: z.string(),
+    /**
+     * The PACS this row asked. One patient asked of two servers is two rows,
+     * because the answers are two facts and one of them may be a miss.
+     */
+    server: z.string().optional(),
+    /** The name the PACS answered with, when it answered at all. */
+    patientName: z.string().optional(),
+    status: pacsPatientStatusSchema,
+    /** How many studies this patient owns in the answer; 0 for a miss. */
+    studyCount: z.number(),
+    /** How many series across those studies; 0 for a miss. */
+    seriesCount: z.number(),
+    /**
+     * The CUBE query that answered for this patient. A cohort is N queries,
+     * so the id belongs per row rather than on the model.
+     */
+    queryId: z.number().optional(),
+    /**
+     * Where this row's answer came from. A fan-out replays some rows and
+     * troubles the PACS for others, so provenance is per patient as well as
+     * per answer.
+     */
+    provenance: pacsProvenanceSchema.optional(),
+    /**
+     * Why a patient went unasked, when something said why.
+     *
+     * Carried so a surface can name the failure rather than showing an
+     * unexplained dash; never set for `found` or `none`, where there is
+     * nothing to explain.
+     */
+    error: z.string().optional(),
+});
 /**
  * The `pacs.query` model: one query's decoded result. `vfsPath` is where the
  * query lives under `/net/pacs/queries` — a query is a persistent CUBE
@@ -47,7 +140,49 @@ export const pacsQueryModelSchema = z.object({
     pacsName: z.string(),
     expression: z.string(),
     studies: z.array(pacsStudySchema),
+    /**
+     * Optional so an envelope from a daemon that predates replay still
+     * parses: a surface reads its absence as "freshly queried, age unknown",
+     * which is what such a daemon could only ever have meant.
+     */
+    provenance: pacsProvenanceSchema.optional(),
+    /**
+     * Every patient the query asked about, hits and misses alike.
+     *
+     * Optional, like `provenance`: an envelope from a daemon that predates
+     * the fan-out still parses, and a surface reads its absence as the
+     * single-question case it could only have been.
+     */
+    patients: z.array(pacsPatientSchema).optional(),
+});
+/**
+ * One registered PACS server, as a surface needs it.
+ *
+ * The identifier is what CUBE files a query under and what `--pacsserver`
+ * names, so it is the value a control lowers to; the numeric id is what
+ * `pacs connect` has always accepted and is kept for that. Liveness is NOT
+ * carried: CUBE registers servers, it does not test them, and a field that
+ * looked like health would be a claim nobody checked.
+ */
+export const pacsServerSchema = z.object({
+    id: z.number(),
+    identifier: z.string(),
+    /** True for the server this session is currently connected to. */
+    active: z.boolean(),
+});
+/**
+ * The `pacs.servers` model: every PACS registered on this CUBE.
+ *
+ * A surface offering a choice of servers has to know what there is to
+ * choose from, and asking CUBE directly would reach around the session
+ * that owns the connection. `pacs list` already asks; it now says so in
+ * data as well as in text.
+ */
+export const pacsServersModelSchema = z.object({
+    servers: z.array(pacsServerSchema),
 });
+/** The servers model's envelope kind. */
+export const PACS_SERVERS_MODEL_KIND = 'pacs.servers';
 /** The model's envelope kind. */
 export const PACS_QUERY_MODEL_KIND = 'pacs.query';
 //# sourceMappingURL=pacs.js.map

package/dist/pacs.js.map

@@ -1 +1 @@
-{"version":3,"file":"pacs.js","sourceRoot":"","sources":["../src/pacs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,4EAA4E;IAC5E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,6CAA6C;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,4EAA4E;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CAClC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;CAClC,CAAC,CAAC;AAMH,iCAAiC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAqB,CAAC"}
+{"version":3,"file":"pacs.js","sourceRoot":"","sources":["../src/pacs.ts"],"names":[],"mappings":"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"}

package/dist/plugin.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @file The plugin vocabulary: a registered plugin as a typed envelope payload.
+ *
+ * A plugin is the one-node case of the compute graph — everything a pipeline
+ * node is, without the pipeline around it. Its substance reached surfaces as
+ * a rendered manual for as long as `cat /bin/<plugin>` was the only way to
+ * ask, which meant nothing downstream could do anything with it: not a card,
+ * not a parameter list, not a form, not an export. This model is that same
+ * substance as data; the manual becomes one projection of it.
+ *
+ * Parameters are the payload that matters. They arrive complete or the model
+ * is wrong: a parameter list that quietly stops at a page boundary is worse
+ * than the paragraph it replaces, because a paragraph does not look
+ * authoritative.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * One declared parameter of a plugin.
+ *
+ * `default` is `unknown` because CUBE serves whatever the plugin declared —
+ * a string, a number, a boolean, or null for "no default" — and a surface
+ * renders it rather than computing on it.
+ */
+export declare const pluginParameterSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    optional: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodUnknown>;
+    help: z.ZodOptional<z.ZodString>;
+    /** The flag as it is typed: `--name`, or the bare name for a positional. */
+    flag: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    optional: boolean;
+    flag: string;
+    default?: unknown;
+    help?: string | undefined;
+}, {
+    type: string;
+    name: string;
+    optional: boolean;
+    flag: string;
+    default?: unknown;
+    help?: string | undefined;
+}>;
+/**
+ * The `plugin.info` model: one registered plugin, whole.
+ *
+ * Identity, the authoring facts, and every declared parameter. What a
+ * surface draws from it — a one-node graph, a parameter table, an argument
+ * form — is the surface's business; the model carries no layout and no
+ * rendering.
+ */
+export declare const pluginInfoModelSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    version: z.ZodString;
+    /** `ds`, `fs`, or `ts` — what the node consumes and produces. */
+    type: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodString>;
+    /** Where the plugin's source or docs live, when it declared them. */
+    documentation: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    /**
+     * Every declared parameter, in the order CUBE serves them.
+     *
+     * Complete, always: the builder drains the collection rather than asking
+     * for a page and calling it the answer.
+     */
+    parameters: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        optional: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodUnknown>;
+        help: z.ZodOptional<z.ZodString>;
+        /** The flag as it is typed: `--name`, or the bare name for a positional. */
+        flag: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        optional: boolean;
+        flag: string;
+        default?: unknown;
+        help?: string | undefined;
+    }, {
+        type: string;
+        name: string;
+        optional: boolean;
+        flag: string;
+        default?: unknown;
+        help?: string | undefined;
+    }>, "many">;
+    /** The `/bin` entry that runs it, so a surface can lower a click to a command. */
+    command: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    version: string;
+    parameters: {
+        type: string;
+        name: string;
+        optional: boolean;
+        flag: string;
+        default?: unknown;
+        help?: string | undefined;
+    }[];
+    id?: number | undefined;
+    title?: string | undefined;
+    command?: string | undefined;
+    description?: string | undefined;
+    authors?: string | undefined;
+    documentation?: string | undefined;
+    category?: string | undefined;
+}, {
+    type: string;
+    name: string;
+    version: string;
+    parameters: {
+        type: string;
+        name: string;
+        optional: boolean;
+        flag: string;
+        default?: unknown;
+        help?: string | undefined;
+    }[];
+    id?: number | undefined;
+    title?: string | undefined;
+    command?: string | undefined;
+    description?: string | undefined;
+    authors?: string | undefined;
+    documentation?: string | undefined;
+    category?: string | undefined;
+}>;
+export type PluginParameter = z.infer<typeof pluginParameterSchema>;
+export type PluginInfoModel = z.infer<typeof pluginInfoModelSchema>;
+/** The model's envelope kind. */
+export declare const PLUGIN_INFO_MODEL_KIND: "plugin.info";

package/dist/plugin.js

@@ -0,0 +1,67 @@
+/**
+ * @file The plugin vocabulary: a registered plugin as a typed envelope payload.
+ *
+ * A plugin is the one-node case of the compute graph — everything a pipeline
+ * node is, without the pipeline around it. Its substance reached surfaces as
+ * a rendered manual for as long as `cat /bin/<plugin>` was the only way to
+ * ask, which meant nothing downstream could do anything with it: not a card,
+ * not a parameter list, not a form, not an export. This model is that same
+ * substance as data; the manual becomes one projection of it.
+ *
+ * Parameters are the payload that matters. They arrive complete or the model
+ * is wrong: a parameter list that quietly stops at a page boundary is worse
+ * than the paragraph it replaces, because a paragraph does not look
+ * authoritative.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * One declared parameter of a plugin.
+ *
+ * `default` is `unknown` because CUBE serves whatever the plugin declared —
+ * a string, a number, a boolean, or null for "no default" — and a surface
+ * renders it rather than computing on it.
+ */
+export const pluginParameterSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    optional: z.boolean(),
+    default: z.unknown().optional(),
+    help: z.string().optional(),
+    /** The flag as it is typed: `--name`, or the bare name for a positional. */
+    flag: z.string(),
+});
+/**
+ * The `plugin.info` model: one registered plugin, whole.
+ *
+ * Identity, the authoring facts, and every declared parameter. What a
+ * surface draws from it — a one-node graph, a parameter table, an argument
+ * form — is the surface's business; the model carries no layout and no
+ * rendering.
+ */
+export const pluginInfoModelSchema = z.object({
+    id: z.number().optional(),
+    name: z.string(),
+    version: z.string(),
+    /** `ds`, `fs`, or `ts` — what the node consumes and produces. */
+    type: z.string(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    authors: z.string().optional(),
+    /** Where the plugin's source or docs live, when it declared them. */
+    documentation: z.string().optional(),
+    category: z.string().optional(),
+    /**
+     * Every declared parameter, in the order CUBE serves them.
+     *
+     * Complete, always: the builder drains the collection rather than asking
+     * for a page and calling it the answer.
+     */
+    parameters: z.array(pluginParameterSchema),
+    /** The `/bin` entry that runs it, so a surface can lower a click to a command. */
+    command: z.string().optional(),
+});
+/** The model's envelope kind. */
+export const PLUGIN_INFO_MODEL_KIND = 'plugin.info';
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,iEAAiE;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,qEAAqE;IACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B;;;;;OAKG;IACH,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAC1C,kFAAkF;IAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAKH,iCAAiC;AACjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAsB,CAAC"}

package/dist/proc.d.ts

@@ -26,8 +26,12 @@ export interface ProcPromptProgress {
     state?: ProcPromptState;
     /** Whether the global index sweep is what `loaded`/`total` describe; absent means yes (older daemons). */
     sweeping?: boolean;
-    /** One feed's first-visit topology load in flight, when there is one. */
+    /** The earliest feed topology load in flight, when there is one (older readers; the first of `feeds`). */
     feed?: ProcFeedPromptProgress;
+    /** Every feed topology load in flight or lately failed, earliest first. */
+    feeds?: ProcFeedPromptProgress[];
+    /** The roster's own walk in flight: the delta, or the ten-minute full walk. */
+    roster?: 'delta' | 'full';
     /** Feeds the roster gained (created or shared) in the last half minute. */
     arrived?: number[];
 }
@@ -52,6 +56,8 @@ export interface ProcFeedPromptProgress {
     id: number;
     loaded: number;
     total: number;
+    /** What the walk said when it failed; absent while it runs. */
+    failed?: string;
 }
 /**
  * Resolves the prompt state, including compatibility with contexts that only

package/dist/proc.js.map

@@ -1 +1 @@
-{"version":3,"file":"proc.js","sourceRoot":"","sources":["../src/proc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAkDxE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA4B;IAC9D,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"proc.js","sourceRoot":"","sources":["../src/proc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAwDxE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA4B;IAC9D,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/menu",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "The mise wire contract: envelope, session protocol, and result-model schemas that surfaces and the kernel both speak",
   "repository": {
     "type": "git",