@aeolus-fleet/common 0.29.2 → 0.30.0

package/dist/schemas/index.d.ts

@@ -15,8 +15,10 @@ export * from './label.js';
 export * from './message.js';
 export * from './needs-attention.js';
 export * from './network.js';
+export * from './network-rules-file.js';
 export * from './notice.js';
 export * from './operator-inbox.js';
+export * from './page.js';
 export * from './ping.js';
 export * from './question.js';
 export * from './report.js';

package/dist/schemas/index.js

@@ -15,8 +15,10 @@ export * from './label.js';
 export * from './message.js';
 export * from './needs-attention.js';
 export * from './network.js';
+export * from './network-rules-file.js';
 export * from './notice.js';
 export * from './operator-inbox.js';
+export * from './page.js';
 export * from './ping.js';
 export * from './question.js';
 export * from './report.js';

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/schemas/label.d.ts

@@ -23,10 +23,243 @@ export declare const carriedLabelSchema: z.ZodObject<{
     valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
     value: z.ZodString;
 }, z.core.$strip>;
-/** Input of `fleet.list`: none, or the value ids a listed ship must carry: exact matches, combined with AND. */
+/**
+ * What sort of agent crews a ship (the overview's Kind filter, idea #401):
+ * the console (argo and the viewer), a ship a console plugin runs as, a
+ * machine's trierarch, or what its crewing session's harness says.
+ */
+export declare const AGENT_KINDS: readonly ["console", "claudeCode", "codex", "trierarch", "plugin", "other"];
+export declare const agentKindSchema: z.ZodEnum<{
+    plugin: "plugin";
+    console: "console";
+    trierarch: "trierarch";
+    claudeCode: "claudeCode";
+    codex: "codex";
+    other: "other";
+}>;
+export type AgentKind = z.infer<typeof agentKindSchema>;
+/**
+ * Which ships `fleet.list` and the counts read select, every filter combined
+ * with AND: the search text its name or type holds, in any case; its exact
+ * name; any of the
+ * statuses, types, ship kinds, crew request keys, ship ids and agent kinds picked; and
+ * every label value id given (exact matches, decision 0031). A filter left
+ * out selects every ship. `pluginShipIds` names the ships the console's
+ * plugins run as, which the kind filter counts as plugin.
+ */
+export declare const fleetListFilterSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        awaitingCrew: "awaitingCrew";
+        crewed: "crewed";
+        retired: "retired";
+    }>>>;
+    type: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    shipKind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        operator: "operator";
+        agent: "agent";
+        viewer: "viewer";
+        person: "person";
+        app: "app";
+        plugin: "plugin";
+    }>>>;
+    crewRequest: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        crewing: "crewing";
+        running: "running";
+        restarting: "restarting";
+        crashed: "crashed";
+        releasing: "releasing";
+        none: "none";
+        needsCrew: "needsCrew";
+        crewedByHand: "crewedByHand";
+    }>>>;
+    assignedTo: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+    needsCrew: z.ZodOptional<z.ZodEnum<{
+        withTrierarchs: "withTrierarchs";
+        withoutTrierarchs: "withoutTrierarchs";
+    }>>;
+    valueIds: z.ZodOptional<z.ZodArray<z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>>>;
+    shipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+    kind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        plugin: "plugin";
+        console: "console";
+        trierarch: "trierarch";
+        claudeCode: "claudeCode";
+        codex: "codex";
+        other: "other";
+    }>>>;
+    pluginShipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+}, z.core.$strip>;
+/** Input of `fleet.shipCounts`: count only the ships the fleet snapshot's filter selects; none counts every ship. */
+export declare const shipCountsInputSchema: z.ZodOptional<z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        query: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            awaitingCrew: "awaitingCrew";
+            crewed: "crewed";
+            retired: "retired";
+        }>>>;
+        type: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        shipKind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            operator: "operator";
+            agent: "agent";
+            viewer: "viewer";
+            person: "person";
+            app: "app";
+            plugin: "plugin";
+        }>>>;
+        crewRequest: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            crewing: "crewing";
+            running: "running";
+            restarting: "restarting";
+            crashed: "crashed";
+            releasing: "releasing";
+            none: "none";
+            needsCrew: "needsCrew";
+            crewedByHand: "crewedByHand";
+        }>>>;
+        assignedTo: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+        needsCrew: z.ZodOptional<z.ZodEnum<{
+            withTrierarchs: "withTrierarchs";
+            withoutTrierarchs: "withoutTrierarchs";
+        }>>;
+        valueIds: z.ZodOptional<z.ZodArray<z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>>>;
+        shipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+        kind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            plugin: "plugin";
+            console: "console";
+            trierarch: "trierarch";
+            claudeCode: "claudeCode";
+            codex: "codex";
+            other: "other";
+        }>>>;
+        pluginShipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+/** Input of `fleet.shipTypes`: the types of the ships of any of these statuses; none asks the active ships. */
+export declare const shipTypesInputSchema: z.ZodOptional<z.ZodObject<{
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        awaitingCrew: "awaitingCrew";
+        crewed: "crewed";
+        retired: "retired";
+    }>>>;
+}, z.core.$strip>>;
+/** Output of `fleet.shipTypes`: each type once, sorted. */
+export declare const shipTypesOutputSchema: z.ZodArray<z.ZodString>;
+/** The columns `fleet.list` sorts by, as the overview shows them. */
+export declare const SHIP_SORT_COLUMNS: readonly ["ship", "status", "report", "runsOn", "seen", "requested"];
+export type ShipSortColumn = (typeof SHIP_SORT_COLUMNS)[number];
+/**
+ * The order of `fleet.list`: a column, A to Z or Z to A (Seen: the most
+ * recent first when ascending), ships with nothing in the column last either
+ * way, ties by name. Without one: argo first, then by name.
+ */
+export declare const fleetListSortSchema: z.ZodObject<{
+    column: z.ZodEnum<{
+        ship: "ship";
+        status: "status";
+        report: "report";
+        runsOn: "runsOn";
+        seen: "seen";
+        requested: "requested";
+    }>;
+    direction: z.ZodEnum<{
+        ascending: "ascending";
+        descending: "descending";
+    }>;
+}, z.core.$strip>;
+/**
+ * Where a page of `fleet.list` starts: after the ship at this position in
+ * the order, by whether its sort value is empty, the value, its name and its
+ * id. The fleet answers it as an opaque cursor; only the fleet reads it.
+ */
+export declare const shipPositionSchema: z.ZodObject<{
+    isEmpty: z.ZodBoolean;
+    value: z.ZodString;
+    name: z.ZodString;
+    id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+}, z.core.$strip>;
+export type ShipPosition = z.infer<typeof shipPositionSchema>;
+/** A position as the opaque cursor fleet.list answers: its JSON in base64url. */
+export declare function shipCursorOf(position: ShipPosition): string;
+/** A cursor fleet.list answered, read back as its position. */
+export declare const shipCursorSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodObject<{
+    isEmpty: z.ZodBoolean;
+    value: z.ZodString;
+    name: z.ZodString;
+    id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+}, z.core.$strip>>;
+/** Input of `fleet.list`: the filter, the sort, and the page: the cursor it starts after and its size (decision 4 of the performance design). */
 export declare const fleetListInputSchema: z.ZodOptional<z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodObject<{
+        isEmpty: z.ZodBoolean;
+        value: z.ZodString;
+        name: z.ZodString;
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strip>>>;
+    limit: z.ZodOptional<z.ZodInt>;
+    sort: z.ZodOptional<z.ZodObject<{
+        column: z.ZodEnum<{
+            ship: "ship";
+            status: "status";
+            report: "report";
+            runsOn: "runsOn";
+            seen: "seen";
+            requested: "requested";
+        }>;
+        direction: z.ZodEnum<{
+            ascending: "ascending";
+            descending: "descending";
+        }>;
+    }, z.core.$strip>>;
+    query: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        awaitingCrew: "awaitingCrew";
+        crewed: "crewed";
+        retired: "retired";
+    }>>>;
+    type: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    shipKind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        operator: "operator";
+        agent: "agent";
+        viewer: "viewer";
+        person: "person";
+        app: "app";
+        plugin: "plugin";
+    }>>>;
+    crewRequest: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        crewing: "crewing";
+        running: "running";
+        restarting: "restarting";
+        crashed: "crashed";
+        releasing: "releasing";
+        none: "none";
+        needsCrew: "needsCrew";
+        crewedByHand: "crewedByHand";
+    }>>>;
+    assignedTo: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+    needsCrew: z.ZodOptional<z.ZodEnum<{
+        withTrierarchs: "withTrierarchs";
+        withoutTrierarchs: "withoutTrierarchs";
+    }>>;
     valueIds: z.ZodOptional<z.ZodArray<z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>>>;
+    shipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
+    kind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        plugin: "plugin";
+        console: "console";
+        trierarch: "trierarch";
+        claudeCode: "claudeCode";
+        codex: "codex";
+        other: "other";
+    }>>>;
+    pluginShipIds: z.ZodOptional<z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>>;
 }, z.core.$strip>>;
+/** `fleet.list`'s filter and sort as a caller writes them, ids as text. */
+export type FleetListFilter = z.input<typeof fleetListFilterSchema>;
+export type FleetListSort = z.input<typeof fleetListSortSchema>;
 /** Input of `fleet.defineLabel` (labels:define): the key, unique in the fleet, and its values. */
 export declare const defineLabelInputSchema: z.ZodObject<{
     key: z.ZodString;
@@ -103,14 +336,10 @@ export declare const listedLabelSchema: z.ZodObject<{
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>;
 export type ListedLabel = z.infer<typeof listedLabelSchema>;
-/** Output of `fleet.labels` (fleet:read): the fleet's labels by key. */
+/** Output of `fleet.labels` (fleet:read): the fleet's labels by key, each with how many active ships in the caller's read reach carry any of its values, and each value with how many carry it. */
 export declare const labelsOutputSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
     key: z.ZodString;
-    values: z.ZodArray<z.ZodObject<{
-        id: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
-        value: z.ZodString;
-    }, z.core.$strip>>;
     owner: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"ship">;
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
@@ -118,4 +347,11 @@ export declare const labelsOutputSchema: z.ZodArray<z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"installation">;
     }, z.core.$strip>], "kind">;
+    shipCount: z.ZodInt;
+    values: z.ZodArray<z.ZodObject<{
+        id: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
+        value: z.ZodString;
+        shipCount: z.ZodInt;
+    }, z.core.$strip>>;
 }, z.core.$strip>>;
+export type CountedLabel = z.infer<typeof labelsOutputSchema>[number];

package/dist/schemas/label.js

@@ -1,5 +1,8 @@
 import { z } from 'zod';
+import { shipKindSchema, shipStatusSchema } from '../fleet/index.js';
 import { idSchema } from '../ids/index.js';
+import { crewRequestKeySchema } from './crew-request.js';
+import { pageInputOf } from './page.js';
 /**
  * Labels (decision 0031): an owned vocabulary for selecting ships. A label is
  * a key with a defined set of values, the label and each value with its own
@@ -21,8 +24,82 @@ const labelTextSchema = z.string();
 export const labelValueSchema = z.object({ id: idSchema('labelValue'), value: z.string() });
 /** One value a ship carries, with its label: ids and texts. */
 export const carriedLabelSchema = z.object({ labelId: idSchema('label'), key: z.string(), valueId: idSchema('labelValue'), value: z.string() });
-/** Input of `fleet.list`: none, or the value ids a listed ship must carry: exact matches, combined with AND. */
-export const fleetListInputSchema = z.object({ valueIds: z.array(idSchema('labelValue')).optional() }).optional();
+/**
+ * What sort of agent crews a ship (the overview's Kind filter, idea #401):
+ * the console (argo and the viewer), a ship a console plugin runs as, a
+ * machine's trierarch, or what its crewing session's harness says.
+ */
+export const AGENT_KINDS = ['console', 'claudeCode', 'codex', 'trierarch', 'plugin', 'other'];
+export const agentKindSchema = z.enum(AGENT_KINDS);
+/**
+ * Which ships `fleet.list` and the counts read select, every filter combined
+ * with AND: the search text its name or type holds, in any case; its exact
+ * name; any of the
+ * statuses, types, ship kinds, crew request keys, ship ids and agent kinds picked; and
+ * every label value id given (exact matches, decision 0031). A filter left
+ * out selects every ship. `pluginShipIds` names the ships the console's
+ * plugins run as, which the kind filter counts as plugin.
+ */
+export const fleetListFilterSchema = z.object({
+    query: z.string().optional(),
+    name: z.string().optional(),
+    status: z.array(shipStatusSchema).optional(),
+    type: z.array(z.string()).optional(),
+    shipKind: z.array(shipKindSchema).optional(),
+    crewRequest: z.array(crewRequestKeySchema).optional(),
+    assignedTo: z.array(idSchema('ship')).optional(),
+    needsCrew: z.enum(['withTrierarchs', 'withoutTrierarchs']).optional(),
+    valueIds: z.array(idSchema('labelValue')).optional(),
+    shipIds: z.array(idSchema('ship')).optional(),
+    kind: z.array(agentKindSchema).optional(),
+    pluginShipIds: z.array(idSchema('ship')).optional(),
+});
+/** Input of `fleet.shipCounts`: count only the ships the fleet snapshot's filter selects; none counts every ship. */
+export const shipCountsInputSchema = z.object({ filter: fleetListFilterSchema.optional() }).optional();
+/** Input of `fleet.shipTypes`: the types of the ships of any of these statuses; none asks the active ships. */
+export const shipTypesInputSchema = z.object({ status: z.array(shipStatusSchema).optional() }).optional();
+/** Output of `fleet.shipTypes`: each type once, sorted. */
+export const shipTypesOutputSchema = z.array(z.string());
+/** The columns `fleet.list` sorts by, as the overview shows them. */
+export const SHIP_SORT_COLUMNS = ['ship', 'status', 'report', 'runsOn', 'seen', 'requested'];
+/**
+ * The order of `fleet.list`: a column, A to Z or Z to A (Seen: the most
+ * recent first when ascending), ships with nothing in the column last either
+ * way, ties by name. Without one: argo first, then by name.
+ */
+export const fleetListSortSchema = z.object({ column: z.enum(SHIP_SORT_COLUMNS), direction: z.enum(['ascending', 'descending']) });
+/**
+ * Where a page of `fleet.list` starts: after the ship at this position in
+ * the order, by whether its sort value is empty, the value, its name and its
+ * id. The fleet answers it as an opaque cursor; only the fleet reads it.
+ */
+export const shipPositionSchema = z.object({ isEmpty: z.boolean(), value: z.string(), name: z.string(), id: idSchema('ship') });
+/** The most characters a cursor may have: a position with a long report note fits. */
+const SHIP_CURSOR_MAX_LENGTH = 4096;
+/** A position as the opaque cursor fleet.list answers: its JSON in base64url. */
+export function shipCursorOf(position) {
+    const bytes = new TextEncoder().encode(JSON.stringify(position));
+    return btoa(String.fromCharCode(...bytes)).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/, '');
+}
+function jsonOfCursor(cursor) {
+    try {
+        const binary = atob(cursor.replaceAll('-', '+').replaceAll('_', '/'));
+        return JSON.parse(new TextDecoder().decode(Uint8Array.from(binary, (character) => character.charCodeAt(0))));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A cursor fleet.list answered, read back as its position. */
+export const shipCursorSchema = z
+    .string()
+    .max(SHIP_CURSOR_MAX_LENGTH)
+    .transform(jsonOfCursor)
+    .pipe(shipPositionSchema);
+/** Input of `fleet.list`: the filter, the sort, and the page: the cursor it starts after and its size (decision 4 of the performance design). */
+export const fleetListInputSchema = pageInputOf(shipCursorSchema)
+    .extend({ ...fleetListFilterSchema.shape, sort: fleetListSortSchema.optional() })
+    .optional();
 /** Input of `fleet.defineLabel` (labels:define): the key, unique in the fleet, and its values. */
 export const defineLabelInputSchema = z.object({ key: labelTextSchema, values: z.array(labelTextSchema) });
 /** Output of `fleet.defineLabel`: the label's id and each value with its id. */
@@ -55,6 +132,6 @@ export const listedLabelSchema = z.object({
     values: z.array(labelValueSchema),
     owner: labelOwnerSchema,
 });
-/** Output of `fleet.labels` (fleet:read): the fleet's labels by key. */
-export const labelsOutputSchema = z.array(listedLabelSchema);
+/** Output of `fleet.labels` (fleet:read): the fleet's labels by key, each with how many active ships in the caller's read reach carry any of its values, and each value with how many carry it. */
+export const labelsOutputSchema = z.array(listedLabelSchema.extend({ shipCount: z.int().min(0), values: z.array(labelValueSchema.extend({ shipCount: z.int().min(0) })) }));
 //# sourceMappingURL=label.js.map

package/dist/schemas/label.js.map

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

package/dist/schemas/needs-attention.d.ts

@@ -1,4 +1,9 @@
 import { z } from 'zod';
+/** The states Needs attention lists. Undeliverable: handed again and again, never acknowledged. Not handled: acknowledged, and its turn died twice (decision 0040). */
+export declare const needsAttentionStateSchema: z.ZodEnum<{
+    notHandled: "notHandled";
+    undeliverable: "undeliverable";
+}>;
 /** One delivery in Needs attention: its state, its claims, since when, and its whole message. */
 export declare const needsAttentionDeliverySchema: z.ZodObject<{
     deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
@@ -38,44 +43,57 @@ export declare const needsAttentionDeliverySchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type NeedsAttentionDelivery = z.infer<typeof needsAttentionDeliverySchema>;
-/** Output of `fleet.needsAttention`: every undeliverable or not handled delivery of the fleet, oldest first. */
-export declare const needsAttentionOutputSchema: z.ZodArray<z.ZodObject<{
-    deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
-    state: z.ZodEnum<{
+/** Input of `fleet.needsAttention`: the fleet's, or one ship's for its page, in either state or one, and the cursor and size of a page. */
+export declare const needsAttentionInputSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>>;
+    limit: z.ZodOptional<z.ZodInt>;
+    shipId: z.ZodOptional<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    state: z.ZodOptional<z.ZodEnum<{
         notHandled: "notHandled";
         undeliverable: "undeliverable";
-    }>;
-    attempts: z.ZodInt;
-    isPushed: z.ZodBoolean;
-    since: z.ZodISODateTime;
-    reason: z.ZodNullable<z.ZodString>;
-    ship: z.ZodObject<{
-        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
-        name: z.ZodString;
-    }, z.core.$strip>;
-    message: z.ZodObject<{
-        id: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
-        sender: z.ZodObject<{
+    }>>;
+}, z.core.$strip>;
+/** Output of `fleet.needsAttention`: a page of the undeliverable or not handled deliveries, oldest first by since when. */
+export declare const needsAttentionOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            notHandled: "notHandled";
+            undeliverable: "undeliverable";
+        }>;
+        attempts: z.ZodInt;
+        isPushed: z.ZodBoolean;
+        since: z.ZodISODateTime;
+        reason: z.ZodNullable<z.ZodString>;
+        ship: z.ZodObject<{
             id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
             name: z.ZodString;
         }, z.core.$strip>;
-        recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"ship">;
-            ship: z.ZodObject<{
+        message: z.ZodObject<{
+            id: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+            sender: z.ZodObject<{
                 id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
                 name: z.ZodString;
             }, z.core.$strip>;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"type">;
-            type: z.ZodString;
-        }, z.core.$strip>], "kind">;
-        inReplyTo: z.ZodNullable<z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>>;
-        sentAt: z.ZodISODateTime;
-        contentType: z.ZodString;
-        isPing: z.ZodBoolean;
-        payload: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>>;
+            recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"ship">;
+                ship: z.ZodObject<{
+                    id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                    name: z.ZodString;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"type">;
+                type: z.ZodString;
+            }, z.core.$strip>], "kind">;
+            inReplyTo: z.ZodNullable<z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>>;
+            sentAt: z.ZodISODateTime;
+            contentType: z.ZodString;
+            isPing: z.ZodBoolean;
+            payload: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>>;
+}, z.core.$strip>;
 /** Input of `fleet.dismiss`: the undeliverable or not handled delivery the operator lets go. It stays in history, dismissed. */
 export declare const dismissDeliveryInputSchema: z.ZodObject<{
     deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;

package/dist/schemas/needs-attention.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { idSchema } from '../ids/index.js';
 import { messageRecipientSchema, partySchema } from './history.js';
+import { pageInputOf, pageOutputOf } from './page.js';
 /**
  * Inputs and outputs of Needs attention (docs/blueprint.md, 'Domain events'):
  * the undeliverable and not handled deliveries, oldest first, which the
@@ -9,11 +10,12 @@ import { messageRecipientSchema, partySchema } from './history.js';
  */
 /** ISO 8601 in UTC. */
 const isoTime = z.iso.datetime();
+/** The states Needs attention lists. Undeliverable: handed again and again, never acknowledged. Not handled: acknowledged, and its turn died twice (decision 0040). */
+export const needsAttentionStateSchema = z.enum(['undeliverable', 'notHandled']);
 /** One delivery in Needs attention: its state, its claims, since when, and its whole message. */
 export const needsAttentionDeliverySchema = z.object({
     deliveryId: idSchema('delivery'),
-    /** Undeliverable: handed again and again, never acknowledged. Not handled: acknowledged, and its turn died twice (decision 0040). */
-    state: z.enum(['undeliverable', 'notHandled']),
+    state: needsAttentionStateSchema,
     /** The claims counted. */
     attempts: z.int().min(0),
     /** A pushed crew's computer side handed it over, with numbers; false when plain receives handed it (pulled). */
@@ -36,8 +38,10 @@ export const needsAttentionDeliverySchema = z.object({
         payload: z.string(),
     }),
 });
-/** Output of `fleet.needsAttention`: every undeliverable or not handled delivery of the fleet, oldest first. */
-export const needsAttentionOutputSchema = z.array(needsAttentionDeliverySchema);
+/** Input of `fleet.needsAttention`: the fleet's, or one ship's for its page, in either state or one, and the cursor and size of a page. */
+export const needsAttentionInputSchema = z.object({ shipId: idSchema('ship').optional(), state: needsAttentionStateSchema.optional(), ...pageInputOf(idSchema('delivery')).shape });
+/** Output of `fleet.needsAttention`: a page of the undeliverable or not handled deliveries, oldest first by since when. */
+export const needsAttentionOutputSchema = pageOutputOf(needsAttentionDeliverySchema, idSchema('delivery'));
 /** Input of `fleet.dismiss`: the undeliverable or not handled delivery the operator lets go. It stays in history, dismissed. */
 export const dismissDeliveryInputSchema = z.object({
     deliveryId: idSchema('delivery'),

package/dist/schemas/needs-attention.js.map

@@ -1 +1 @@
-{"version":3,"file":"needs-attention.js","sourceRoot":"","sources":["../../src/schemas/needs-attention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;GAKG;AAEH,uBAAuB;AACvB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAEjC,iGAAiG;AACjG,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;IAChC,qIAAqI;IACrI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC9C,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,gHAAgH;IAChH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,iEAAiE;IACjE,KAAK,EAAE,OAAO;IACd,0HAA0H;IAC1H,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,6GAA6G;IAC7G,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC;QACvB,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,8EAA8E;QAC9E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;CACH,CAAC,CAAC;AAIH,gHAAgH;AAChH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;AAEhF,gIAAgI;AAChI,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;CACjC,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;CACjC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;CAC/B,CAAC,CAAC"}
+{"version":3,"file":"needs-attention.js","sourceRoot":"","sources":["../../src/schemas/needs-attention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;GAKG;AAEH,uBAAuB;AACvB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAEjC,uKAAuK;AACvK,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjF,iGAAiG;AACjG,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,yBAAyB;IAChC,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,gHAAgH;IAChH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,iEAAiE;IACjE,KAAK,EAAE,OAAO;IACd,0HAA0H;IAC1H,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,6GAA6G;IAC7G,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC;QACvB,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,8EAA8E;QAC9E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;CACH,CAAC,CAAC;AAIH,2IAA2I;AAC3I,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,yBAAyB,CAAC,QAAQ,EAAE,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAEpL,2HAA2H;AAC3H,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CAAC,4BAA4B,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;AAE3G,gIAAgI;AAChI,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;CACjC,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;CACjC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;CAC/B,CAAC,CAAC"}