@aeolus-fleet/common 0.7.0 → 0.9.0

package/dist/fleet/index.d.ts

@@ -13,6 +13,16 @@ export declare const scopeSchema: z.ZodEnum<{
     "fleet:manage": "fleet:manage";
 }>;
 export type Scope = z.infer<typeof scopeSchema>;
+/**
+ * The scopes commissioning may add to an agent ship, beside sending and
+ * receiving, which every agent ship has (ADR 0002).
+ */
+export declare const FLEET_SCOPES: readonly ["fleet:read", "fleet:manage"];
+export declare const fleetScopeSchema: z.ZodEnum<{
+    "fleet:read": "fleet:read";
+    "fleet:manage": "fleet:manage";
+}>;
+export type FleetScope = z.infer<typeof fleetScopeSchema>;
 /** `argo` is the one ship of kind `operator` in a fleet; every other ship is an `agent`. */
 export declare const SHIP_KINDS: readonly ["operator", "agent"];
 export declare const shipKindSchema: z.ZodEnum<{
@@ -63,7 +73,7 @@ export declare const deliveryStateSchema: z.ZodEnum<{
 }>;
 export type DeliveryState = z.infer<typeof deliveryStateSchema>;
 /** The event types written so far. Each later slice adds the ones it writes. */
-export declare const EVENT_TYPES: readonly ["FleetInitialised", "ShipCommissioned", "ShipClaimed", "LeaseRevoked", "CredentialRevoked", "StartingPromptIssued", "OperatorPasswordReset", "MessageAccepted", "DeliveryClaimed", "DeliveryAcknowledged", "DeliveryUndeliverable", "DeliveryReturned", "ShipRetired", "DeliveryAbandoned", "DeliveryDismissed", "ShipRenamed"];
+export declare const EVENT_TYPES: readonly ["FleetInitialised", "ShipCommissioned", "ShipClaimed", "LeaseRevoked", "CredentialRevoked", "StartingPromptIssued", "OperatorPasswordReset", "MessageAccepted", "DeliveryClaimed", "DeliveryAcknowledged", "DeliveryUndeliverable", "DeliveryReturned", "ShipRetired", "DeliveryAbandoned", "DeliveryDismissed", "ShipRenamed", "ShipReported"];
 export declare const eventTypeSchema: z.ZodEnum<{
     FleetInitialised: "FleetInitialised";
     ShipCommissioned: "ShipCommissioned";
@@ -81,5 +91,6 @@ export declare const eventTypeSchema: z.ZodEnum<{
     DeliveryAbandoned: "DeliveryAbandoned";
     DeliveryDismissed: "DeliveryDismissed";
     ShipRenamed: "ShipRenamed";
+    ShipReported: "ShipReported";
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;

package/dist/fleet/index.js

@@ -7,6 +7,12 @@ import { z } from 'zod';
 /** A permission of a ship, stored on the server with the ship and checked before every call. */
 export const SCOPES = ['messages:send', 'messages:receive', 'fleet:read', 'fleet:manage'];
 export const scopeSchema = z.enum(SCOPES);
+/**
+ * The scopes commissioning may add to an agent ship, beside sending and
+ * receiving, which every agent ship has (ADR 0002).
+ */
+export const FLEET_SCOPES = ['fleet:read', 'fleet:manage'];
+export const fleetScopeSchema = z.enum(FLEET_SCOPES);
 /** `argo` is the one ship of kind `operator` in a fleet; every other ship is an `agent`. */
 export const SHIP_KINDS = ['operator', 'agent'];
 export const shipKindSchema = z.enum(SHIP_KINDS);
@@ -47,6 +53,7 @@ export const EVENT_TYPES = [
     'DeliveryAbandoned',
     'DeliveryDismissed',
     'ShipRenamed',
+    'ShipReported',
 ];
 export const eventTypeSchema = z.enum(EVENT_TYPES);
 //# sourceMappingURL=index.js.map

package/dist/fleet/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fleet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,gGAAgG;AAChG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AACnG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAG1C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,OAAO,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAGzD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAGtD,2GAA2G;AAC3G,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAGzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAC5H,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAG3D,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IACjB,sBAAsB;IACtB,uBAAuB;IACvB,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,aAAa;CACL,CAAC;AACX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fleet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,gGAAgG;AAChG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AACnG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAG1C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,cAAc,CAAU,CAAC;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAGrD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,OAAO,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAGzD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAGtD,2GAA2G;AAC3G,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAGzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAC5H,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAG3D,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IACjB,sBAAsB;IACtB,uBAAuB;IACvB,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,aAAa;IACb,cAAc;CACN,CAAC;AACX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/schemas/console.d.ts

@@ -27,6 +27,17 @@ export declare const themeSchema: z.ZodEnum<{
     system: "system";
 }>;
 export type Theme = z.infer<typeof themeSchema>;
+/**
+ * Output of `console.session`: for another service the operator uses beside
+ * the console, which forwards the browser's session cookie and asks whether
+ * the operator is signed in. The fleet they signed in to, and when the
+ * session expires (ISO 8601 in UTC).
+ */
+export declare const consoleSessionOutputSchema: z.ZodObject<{
+    fleetId: z.ZodType<`flt_${string}`, unknown, z.core.$ZodTypeInternals<`flt_${string}`, unknown>>;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type ConsoleSessionOutput = z.infer<typeof consoleSessionOutputSchema>;
 /**
  * Output of `console.account`: the signed-in operator, their theme, and this
  * console session: the device it signed in from and since when.

package/dist/schemas/console.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { idSchema } from '../ids/index.js';
 /** The operator's email: at most 254 characters, the longest address mail carries. */
 export const OPERATOR_EMAIL_MAX_LENGTH = 254;
 /** One @ with something on each side, and no whitespace. */
@@ -23,6 +24,16 @@ export const THEMES = ['light', 'dark', 'system'];
 export const themeSchema = z.enum(THEMES);
 /** ISO 8601 in UTC. */
 const isoTime = z.iso.datetime();
+/**
+ * Output of `console.session`: for another service the operator uses beside
+ * the console, which forwards the browser's session cookie and asks whether
+ * the operator is signed in. The fleet they signed in to, and when the
+ * session expires (ISO 8601 in UTC).
+ */
+export const consoleSessionOutputSchema = z.object({
+    fleetId: idSchema('fleet'),
+    expiresAt: z.iso.datetime(),
+});
 /**
  * Output of `console.account`: the signed-in operator, their theme, and this
  * console session: the device it signed in from and since when.

package/dist/schemas/console.js.map

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/schemas/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC;CACrF,CAAC,CAAC;AAIH,8GAA8G;AAC9G,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAG1C,uBAAuB;AACvB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;CAC1D,CAAC,CAAC;AAIH,mCAAmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAEpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/schemas/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,sFAAsF;AACtF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC;CACrF,CAAC,CAAC;AAIH,8GAA8G;AAC9G,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAG1C,uBAAuB;AACvB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;CAC1D,CAAC,CAAC;AAIH,mCAAmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAEpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}

package/dist/schemas/fleet.d.ts

@@ -3,15 +3,27 @@ import { z } from 'zod';
  * Inputs and outputs of the fleet procedures: commission a ship, get its
  * starting prompt, release it, list the fleet, follow its events live.
  */
-/** A ship's name and its type are handles (docs/blueprint.md, "Ship"). */
+/**
+ * A ship's name and its type are handles (docs/blueprint.md, "Ship"). A colon
+ * is an ordinary character, so a prefix can group ships (`hemma:planner`); it
+ * carries no meaning for the fleet.
+ */
 export declare const SHIP_HANDLE_MAX_LENGTH = 48;
 export declare const SHIP_HANDLE_PATTERN: RegExp;
 export declare const shipHandleSchema: z.ZodString;
 export declare const SHIP_NOTE_MAX_LENGTH = 500;
-/** Input of `fleet.commission`. The note is free text for the operator; whitespace around it is dropped. */
+/**
+ * Input of `fleet.commission`. The note is free text for the operator;
+ * whitespace around it is dropped. `fleetScopes` adds fleet:read and/or
+ * fleet:manage to the scopes every agent ship has; none when left out.
+ */
 export declare const commissionShipInputSchema: z.ZodObject<{
     name: z.ZodString;
     type: z.ZodString;
+    fleetScopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "fleet:read": "fleet:read";
+        "fleet:manage": "fleet:manage";
+    }>>>;
     note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CommissionShipInput = z.infer<typeof commissionShipInputSchema>;
@@ -60,6 +72,14 @@ export declare const retireShipOutputSchema: z.ZodObject<{
 export declare const recrewShipInputSchema: z.ZodObject<{
     shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
 }, z.core.$strip>;
+/** How a ship's last ping stands: waiting for an answer, answered with pong, or received with a plain ack. */
+export declare const PING_STATES: readonly ["waiting", "answered", "received"];
+export declare const pingStateSchema: z.ZodEnum<{
+    waiting: "waiting";
+    answered: "answered";
+    received: "received";
+}>;
+export type PingState = z.infer<typeof pingStateSchema>;
 /**
  * One ship in `fleet.list`. `startingPrompt` is the prompt holding the ship's
  * valid secret, when there is one: when it was issued and whether a session
@@ -94,6 +114,30 @@ export declare const listedShipSchema: z.ZodObject<{
         description: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     lastSeenAt: z.ZodNullable<z.ZodISODateTime>;
+    ping: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            waiting: "waiting";
+            answered: "answered";
+            received: "received";
+        }>;
+        sentAt: z.ZodISODateTime;
+        answeredAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "messages:send": "messages:send";
+        "messages:receive": "messages:receive";
+        "fleet:read": "fleet:read";
+        "fleet:manage": "fleet:manage";
+    }>>;
+    report: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+            idle: "idle";
+        }>;
+        note: z.ZodNullable<z.ZodString>;
+        reportedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListedShip = z.infer<typeof listedShipSchema>;
 /** Output of `fleet.list`: every ship in the caller's fleet, `argo` included. */
@@ -124,6 +168,30 @@ export declare const fleetListOutputSchema: z.ZodArray<z.ZodObject<{
         description: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     lastSeenAt: z.ZodNullable<z.ZodISODateTime>;
+    ping: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            waiting: "waiting";
+            answered: "answered";
+            received: "received";
+        }>;
+        sentAt: z.ZodISODateTime;
+        answeredAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "messages:send": "messages:send";
+        "messages:receive": "messages:receive";
+        "fleet:read": "fleet:read";
+        "fleet:manage": "fleet:manage";
+    }>>;
+    report: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+            idle: "idle";
+        }>;
+        note: z.ZodNullable<z.ZodString>;
+        reportedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
 }, z.core.$strip>>;
 /**
  * Input of the `fleet.events` subscription: the number of the last event the
@@ -160,6 +228,7 @@ export declare const liveFleetEventSchema: z.ZodObject<{
         DeliveryAbandoned: "DeliveryAbandoned";
         DeliveryDismissed: "DeliveryDismissed";
         ShipRenamed: "ShipRenamed";
+        ShipReported: "ShipReported";
     }>;
     occurredAt: z.ZodISODateTime;
     actorShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
@@ -194,6 +263,7 @@ export declare const fleetStreamItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             DeliveryAbandoned: "DeliveryAbandoned";
             DeliveryDismissed: "DeliveryDismissed";
             ShipRenamed: "ShipRenamed";
+            ShipReported: "ShipReported";
         }>;
         occurredAt: z.ZodISODateTime;
         actorShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;

package/dist/schemas/fleet.js

@@ -1,23 +1,33 @@
 import { z } from 'zod';
-import { eventTypeSchema, locationKindSchema, shipKindSchema, shipStatusSchema } from '../fleet/index.js';
+import { eventTypeSchema, fleetScopeSchema, locationKindSchema, scopeSchema, shipKindSchema, shipStatusSchema } from '../fleet/index.js';
 import { idSchema } from '../ids/index.js';
+import { reportStateSchema } from './report.js';
 /**
  * Inputs and outputs of the fleet procedures: commission a ship, get its
  * starting prompt, release it, list the fleet, follow its events live.
  */
-/** A ship's name and its type are handles (docs/blueprint.md, "Ship"). */
+/**
+ * A ship's name and its type are handles (docs/blueprint.md, "Ship"). A colon
+ * is an ordinary character, so a prefix can group ships (`hemma:planner`); it
+ * carries no meaning for the fleet.
+ */
 export const SHIP_HANDLE_MAX_LENGTH = 48;
-export const SHIP_HANDLE_PATTERN = /^[a-z0-9-]+$/;
-const HANDLE_MESSAGE = `Use 1 to ${SHIP_HANDLE_MAX_LENGTH} lowercase letters, digits or hyphens`;
+export const SHIP_HANDLE_PATTERN = /^[a-z0-9:-]+$/;
+const HANDLE_MESSAGE = `Use 1 to ${SHIP_HANDLE_MAX_LENGTH} lowercase letters, digits, hyphens or colons`;
 export const shipHandleSchema = z
     .string()
     .max(SHIP_HANDLE_MAX_LENGTH, HANDLE_MESSAGE)
     .regex(SHIP_HANDLE_PATTERN, HANDLE_MESSAGE);
 export const SHIP_NOTE_MAX_LENGTH = 500;
-/** Input of `fleet.commission`. The note is free text for the operator; whitespace around it is dropped. */
+/**
+ * Input of `fleet.commission`. The note is free text for the operator;
+ * whitespace around it is dropped. `fleetScopes` adds fleet:read and/or
+ * fleet:manage to the scopes every agent ship has; none when left out.
+ */
 export const commissionShipInputSchema = z.object({
     name: shipHandleSchema,
     type: shipHandleSchema,
+    fleetScopes: z.array(fleetScopeSchema).optional(),
     note: z
         .string()
         .trim()
@@ -55,6 +65,9 @@ export const retireShipOutputSchema = z.object({ abandonedDeliveries: z.int().mi
  * a new starting prompt, as from `fleet.getStartingPrompt`.
  */
 export const recrewShipInputSchema = z.object({ shipId: idSchema('ship') });
+/** How a ship's last ping stands: waiting for an answer, answered with pong, or received with a plain ack. */
+export const PING_STATES = ['waiting', 'answered', 'received'];
+export const pingStateSchema = z.enum(PING_STATES);
 /**
  * One ship in `fleet.list`. `startingPrompt` is the prompt holding the ship's
  * valid secret, when there is one: when it was issued and whether a session
@@ -88,6 +101,31 @@ export const listedShipSchema = z.object({
      * observation only, nothing acts on it. Null while no session crews it.
      */
     lastSeenAt: z.iso.datetime().nullable(),
+    /**
+     * The ship's last ping (ISO 8601 in UTC): when argo sent it, how it stands,
+     * and when pong answered it. Null before any ping, or when the last one went
+     * undeliverable. Observation only.
+     */
+    ping: z
+        .object({
+        state: pingStateSchema,
+        sentAt: z.iso.datetime(),
+        answeredAt: z.iso.datetime().nullable(),
+    })
+        .nullable(),
+    /** What the ship may do, checked on every call: every agent ship sends and receives, argo has all. */
+    scopes: z.array(scopeSchema),
+    /**
+     * The crew's last report (ISO 8601 in UTC): its state, its note, and when it
+     * last reported. Null until the crew reports, and for a ship no session crews.
+     */
+    report: z
+        .object({
+        state: reportStateSchema,
+        note: z.string().nullable(),
+        reportedAt: z.iso.datetime(),
+    })
+        .nullable(),
 });
 /** Output of `fleet.list`: every ship in the caller's fleet, `argo` included. */
 export const fleetListOutputSchema = z.array(listedShipSchema);

package/dist/schemas/fleet.js.map

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

package/dist/schemas/follow.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/** The most events one follow answers, and how many it answers unless told fewer. */
+export declare const FOLLOW_MAX_LIMIT = 100;
+export declare const FOLLOW_MAX_DEFAULT = 100;
+/** The longest a follow waits while no event has come, in seconds. */
+export declare const FOLLOW_WAIT_MAX_SECONDS = 25;
+/**
+ * Input of `fleet.follow`: the number of the last event the caller has (the
+ * same commit-ordered numbers the console follows by), at most how many to
+ * answer, and how long to wait while none has come. Without a position it
+ * answers where to start from.
+ */
+export declare const followFleetInputSchema: z.ZodOptional<z.ZodObject<{
+    afterSeq: z.ZodOptional<z.ZodInt>;
+    max: z.ZodOptional<z.ZodInt>;
+    waitSeconds: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>>;
+export type FollowFleetInput = z.infer<typeof followFleetInputSchema>;
+/** Output of `fleet.follow`: the events after the position, oldest first, and the number to follow from next. */
+export declare const followFleetOutputSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        id: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+        type: z.ZodEnum<{
+            FleetInitialised: "FleetInitialised";
+            ShipCommissioned: "ShipCommissioned";
+            ShipClaimed: "ShipClaimed";
+            LeaseRevoked: "LeaseRevoked";
+            CredentialRevoked: "CredentialRevoked";
+            StartingPromptIssued: "StartingPromptIssued";
+            OperatorPasswordReset: "OperatorPasswordReset";
+            MessageAccepted: "MessageAccepted";
+            DeliveryClaimed: "DeliveryClaimed";
+            DeliveryAcknowledged: "DeliveryAcknowledged";
+            DeliveryUndeliverable: "DeliveryUndeliverable";
+            DeliveryReturned: "DeliveryReturned";
+            ShipRetired: "ShipRetired";
+            DeliveryAbandoned: "DeliveryAbandoned";
+            DeliveryDismissed: "DeliveryDismissed";
+            ShipRenamed: "ShipRenamed";
+            ShipReported: "ShipReported";
+        }>;
+        occurredAt: z.ZodISODateTime;
+        actorShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+        shipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+        messageId: z.ZodNullable<z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>>;
+        deliveryId: z.ZodNullable<z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>>;
+    }, z.core.$strip>>;
+    lastSeq: z.ZodInt;
+}, z.core.$strip>;
+export type FollowFleetOutput = z.infer<typeof followFleetOutputSchema>;

package/dist/schemas/follow.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { liveFleetEventSchema } from './fleet.js';
+/** The most events one follow answers, and how many it answers unless told fewer. */
+export const FOLLOW_MAX_LIMIT = 100;
+export const FOLLOW_MAX_DEFAULT = FOLLOW_MAX_LIMIT;
+/** The longest a follow waits while no event has come, in seconds. */
+export const FOLLOW_WAIT_MAX_SECONDS = 25;
+/**
+ * Input of `fleet.follow`: the number of the last event the caller has (the
+ * same commit-ordered numbers the console follows by), at most how many to
+ * answer, and how long to wait while none has come. Without a position it
+ * answers where to start from.
+ */
+export const followFleetInputSchema = z
+    .object({
+    afterSeq: z.int().min(0).optional(),
+    max: z.int().min(1).max(FOLLOW_MAX_LIMIT).optional(),
+    waitSeconds: z.int().min(0).max(FOLLOW_WAIT_MAX_SECONDS).optional(),
+})
+    .optional();
+/** Output of `fleet.follow`: the events after the position, oldest first, and the number to follow from next. */
+export const followFleetOutputSchema = z.object({
+    events: z.array(liveFleetEventSchema),
+    lastSeq: z.int().min(0),
+});
+//# sourceMappingURL=follow.js.map

package/dist/schemas/follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","sourceRoot":"","sources":["../../src/schemas/follow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IACpD,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC;KACD,QAAQ,EAAE,CAAC;AAId,iHAAiH;AACjH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC"}

package/dist/schemas/history.d.ts

@@ -53,6 +53,30 @@ export declare const shipDetailOutputSchema: z.ZodObject<{
         description: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     lastSeenAt: z.ZodNullable<z.ZodISODateTime>;
+    ping: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            waiting: "waiting";
+            answered: "answered";
+            received: "received";
+        }>;
+        sentAt: z.ZodISODateTime;
+        answeredAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "messages:send": "messages:send";
+        "messages:receive": "messages:receive";
+        "fleet:read": "fleet:read";
+        "fleet:manage": "fleet:manage";
+    }>>;
+    report: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+            idle: "idle";
+        }>;
+        note: z.ZodNullable<z.ZodString>;
+        reportedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
     commissionedAt: z.ZodISODateTime;
     crewedSince: z.ZodNullable<z.ZodISODateTime>;
     retiredAt: z.ZodNullable<z.ZodISODateTime>;
@@ -81,6 +105,7 @@ export declare const timelineEntrySchema: z.ZodObject<{
         DeliveryAbandoned: "DeliveryAbandoned";
         DeliveryDismissed: "DeliveryDismissed";
         ShipRenamed: "ShipRenamed";
+        ShipReported: "ShipReported";
     }>;
     occurredAt: z.ZodISODateTime;
     actor: z.ZodNullable<z.ZodObject<{
@@ -107,6 +132,7 @@ export declare const timelineEntrySchema: z.ZodObject<{
             kind: z.ZodLiteral<"type">;
             type: z.ZodString;
         }, z.core.$strip>], "kind">;
+        contentType: z.ZodString;
     }, z.core.$strip>>;
     details: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
 }, z.core.$strip>;
@@ -132,6 +158,7 @@ export declare const shipTimelineOutputSchema: z.ZodArray<z.ZodObject<{
         DeliveryAbandoned: "DeliveryAbandoned";
         DeliveryDismissed: "DeliveryDismissed";
         ShipRenamed: "ShipRenamed";
+        ShipReported: "ShipReported";
     }>;
     occurredAt: z.ZodISODateTime;
     actor: z.ZodNullable<z.ZodObject<{
@@ -158,6 +185,7 @@ export declare const shipTimelineOutputSchema: z.ZodArray<z.ZodObject<{
             kind: z.ZodLiteral<"type">;
             type: z.ZodString;
         }, z.core.$strip>], "kind">;
+        contentType: z.ZodString;
     }, z.core.$strip>>;
     details: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
 }, z.core.$strip>>;

package/dist/schemas/history.js

@@ -44,7 +44,13 @@ export const timelineEntrySchema = z.object({
     ship: partySchema.nullable(),
     /** The message it concerns, with its sender and recipient. */
     message: z
-        .object({ id: idSchema('message'), sender: partySchema, recipient: messageRecipientSchema })
+        .object({
+        id: idSchema('message'),
+        sender: partySchema,
+        recipient: messageRecipientSchema,
+        /** As the sender gave it; a ping has the reserved ping content type. */
+        contentType: z.string(),
+    })
         .nullable(),
     details: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()])),
 });

package/dist/schemas/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/schemas/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AAEH,uBAAuB;AACvB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAEjC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAIhF,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACjE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACxD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CACxD,CAAC,CAAC;AAIH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC5D,cAAc,EAAE,OAAO;IACvB,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC7B,yFAAyF;IACzF,kBAAkB,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,0EAA0E;IAC1E,cAAc,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAIH,yGAAyG;AACzG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC;IACrB,IAAI,EAAE,eAAe;IACrB,UAAU,EAAE,OAAO;IACnB,oDAAoD;IACpD,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC5B,8DAA8D;IAC9D,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,sBAAsB,EAAE,CAAC;SAC3F,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;CACxF,CAAC,CAAC;AAIH,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAErE,kHAAkH;AAClH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC;IACvB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,4FAA4F;IAC5F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC;QACxB,KAAK,EAAE,mBAAmB;QAC1B,sEAAsE;QACtE,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE;KAClC,CAAC;CACH,CAAC,CAAC;AAIH,qGAAqG;AACrG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAErE,gCAAgC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAE/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,mBAAmB;CACX,CAAC;AAEX,oHAAoH;AACpH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC;IACpC,UAAU,EAAE,OAAO;IACnB,mFAAmF;IACnF,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC5B,mDAAmD;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/F,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAIH,4GAA4G;AAC5G,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC;QACxB,KAAK,EAAE,mBAAmB;QAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACxC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE;QACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;KAC7C,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/schemas/history.ts"],"names":[],"mappings":"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"}

package/dist/schemas/index.d.ts

@@ -1,9 +1,12 @@
 export * from './console.js';
 export * from './delivery.js';
 export * from './fleet.js';
+export * from './follow.js';
 export * from './history.js';
 export * from './message.js';
 export * from './needs-attention.js';
 export * from './operator-inbox.js';
+export * from './ping.js';
+export * from './report.js';
 export * from './ship.js';
 export * from './system.js';

package/dist/schemas/index.js

@@ -1,10 +1,13 @@
 export * from './console.js';
 export * from './delivery.js';
 export * from './fleet.js';
+export * from './follow.js';
 export * from './history.js';
 export * from './message.js';
 export * from './needs-attention.js';
 export * from './operator-inbox.js';
+export * from './ping.js';
+export * from './report.js';
 export * from './ship.js';
 export * from './system.js';
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/schemas/ping.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * A ping: a message from argo to one crewed ship that its session answers
+ * with pong, proving the ship's model is working, not only its process. It
+ * travels as any message does, told apart by this reserved content type,
+ * which only the ping call sends.
+ */
+export declare const PING_CONTENT_TYPE = "application/vnd.aeolus.ping";
+/**
+ * Whether a content type is the ping's: media types compare without case and
+ * without their parameters (RFC 9110), so no spelling of it slips past.
+ */
+export declare function isPingContentType(contentType: string): boolean;
+/** Input of `fleet.ping`: the crewed ship to ping. */
+export declare const pingShipInputSchema: z.ZodObject<{
+    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+}, z.core.$strip>;
+export type PingShipInput = z.infer<typeof pingShipInputSchema>;
+/**
+ * Output of `fleet.ping`: the ship's open ping, when it was sent, and whether
+ * this call sent it. Pings never stack: while one is unanswered, ping answers
+ * with that one.
+ */
+export declare const pingShipOutputSchema: z.ZodObject<{
+    messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+    sentAt: z.ZodISODateTime;
+    isNew: z.ZodBoolean;
+}, z.core.$strip>;
+export type PingShipOutput = z.infer<typeof pingShipOutputSchema>;
+/** Input of `pong`: the ping delivery the ship answers. */
+export declare const pongInputSchema: z.ZodObject<{
+    deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+}, z.core.$strip>;
+export type PongInput = z.infer<typeof pongInputSchema>;
+/** Output of `pong`: nothing; the OK is the answer. */
+export declare const pongOutputSchema: z.ZodObject<{}, z.core.$strict>;
+export type PongOutput = z.infer<typeof pongOutputSchema>;

package/dist/schemas/ping.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { idSchema } from '../ids/index.js';
+/**
+ * A ping: a message from argo to one crewed ship that its session answers
+ * with pong, proving the ship's model is working, not only its process. It
+ * travels as any message does, told apart by this reserved content type,
+ * which only the ping call sends.
+ */
+export const PING_CONTENT_TYPE = 'application/vnd.aeolus.ping';
+/**
+ * Whether a content type is the ping's: media types compare without case and
+ * without their parameters (RFC 9110), so no spelling of it slips past.
+ */
+export function isPingContentType(contentType) {
+    const [essence = ''] = contentType.split(';');
+    return essence.trim().toLowerCase() === PING_CONTENT_TYPE;
+}
+/** Input of `fleet.ping`: the crewed ship to ping. */
+export const pingShipInputSchema = z.object({ shipId: idSchema('ship') });
+/**
+ * Output of `fleet.ping`: the ship's open ping, when it was sent, and whether
+ * this call sent it. Pings never stack: while one is unanswered, ping answers
+ * with that one.
+ */
+export const pingShipOutputSchema = z.object({
+    messageId: idSchema('message'),
+    sentAt: z.iso.datetime(),
+    isNew: z.boolean(),
+});
+/** Input of `pong`: the ping delivery the ship answers. */
+export const pongInputSchema = z.object({ deliveryId: idSchema('delivery') });
+/** Output of `pong`: nothing; the OK is the answer. */
+export const pongOutputSchema = z.strictObject({});
+//# sourceMappingURL=ping.js.map

package/dist/schemas/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/schemas/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,iBAAiB,CAAC;AAC5D,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IACxB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAIH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAI9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}

package/dist/schemas/report.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+/** What a crew says it is doing: working, blocked or idle. Plain data: nothing acts on it. */
+export declare const REPORT_STATES: readonly ["working", "blocked", "idle"];
+export declare const reportStateSchema: z.ZodEnum<{
+    working: "working";
+    blocked: "blocked";
+    idle: "idle";
+}>;
+export type ReportState = z.infer<typeof reportStateSchema>;
+/** The longest a report's note may be. */
+export declare const REPORT_NOTE_MAX_LENGTH = 200;
+/** Whether a note fits on one line. */
+export declare function isOneLine(text: string): boolean;
+/** Input of `report`: the crew's state and a short note on what it is doing, trimmed. Calling it is a check-in. */
+export declare const reportInputSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        working: "working";
+        blocked: "blocked";
+        idle: "idle";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReportInput = z.infer<typeof reportInputSchema>;
+/** Output of `report`: nothing; the OK is the answer. */
+export declare const reportOutputSchema: z.ZodObject<{}, z.core.$strict>;

package/dist/schemas/report.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/** What a crew says it is doing: working, blocked or idle. Plain data: nothing acts on it. */
+export const REPORT_STATES = ['working', 'blocked', 'idle'];
+export const reportStateSchema = z.enum(REPORT_STATES);
+/** The longest a report's note may be. */
+export const REPORT_NOTE_MAX_LENGTH = 200;
+const NOTE_MESSAGE = `A note is one line of at most ${String(REPORT_NOTE_MAX_LENGTH)} characters`;
+/** Whether a note fits on one line. */
+export function isOneLine(text) {
+    return !/[\r\n]/.test(text);
+}
+/** Input of `report`: the crew's state and a short note on what it is doing, trimmed. Calling it is a check-in. */
+export const reportInputSchema = z.object({
+    state: reportStateSchema,
+    note: z.string().trim().max(REPORT_NOTE_MAX_LENGTH, NOTE_MESSAGE).refine(isOneLine, NOTE_MESSAGE).optional(),
+});
+/** Output of `report`: nothing; the OK is the answer. */
+export const reportOutputSchema = z.strictObject({});
+//# sourceMappingURL=report.js.map

package/dist/schemas/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/schemas/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAGvD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,YAAY,GAAG,iCAAiC,MAAM,CAAC,sBAAsB,CAAC,aAAa,CAAC;AAElG,uCAAuC;AACvC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,mHAAmH;AACnH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,QAAQ,EAAE;CAC7G,CAAC,CAAC;AAIH,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeolus-fleet/common",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Aeolus shared schemas, prefixed ids and types.",
   "license": "Apache-2.0",
   "type": "module",