@aeolus-fleet/common 0.8.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

@@ -12,10 +12,18 @@ 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>;
@@ -115,6 +123,21 @@ export declare const listedShipSchema: z.ZodObject<{
         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. */
@@ -154,6 +177,21 @@ export declare const fleetListOutputSchema: z.ZodArray<z.ZodObject<{
         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
@@ -190,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>>>;
@@ -224,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,6 +1,7 @@
 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.
@@ -18,10 +19,15 @@ export const shipHandleSchema = z
     .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()
@@ -107,6 +113,19 @@ export const listedShipSchema = z.object({
         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

@@ -62,6 +62,21 @@ export declare const shipDetailOutputSchema: z.ZodObject<{
         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>;
@@ -90,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<{
@@ -142,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<{

package/dist/schemas/index.d.ts

@@ -1,10 +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,11 +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,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/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.8.0",
+  "version": "0.9.0",
   "description": "Aeolus shared schemas, prefixed ids and types.",
   "license": "Apache-2.0",
   "type": "module",