@aeolus-fleet/common 0.26.1 → 0.27.1

package/dist/fleet/core-version.d.ts

@@ -0,0 +1,20 @@
+/** Where core says its version, without authentication. */
+export declare const CORE_VERSION_PATH = "/api/version";
+/** The part of `fetch` the check uses, so a test hands in its own core. */
+export type VersionFetch = (url: string, init: {
+    signal: AbortSignal;
+}) => Promise<{
+    status: number;
+    json(): Promise<unknown>;
+}>;
+/**
+ * Why the package may not start against the fleet's core, or none when it
+ * may: core is at least `minimum`, or is `0.0.0`.
+ */
+export declare function coreVersionRefusal(input: {
+    packageName: string;
+    version: string;
+    minimum: string;
+    fleetUrl: string;
+    fetch: VersionFetch;
+}): Promise<string | undefined>;

package/dist/fleet/core-version.js

@@ -0,0 +1,59 @@
+/**
+ * The minimum core version check (decision 0049, docs/compatibility.md): a
+ * package of another release train reads core's version at start and refuses
+ * to run against an older core, saying both versions.
+ */
+import { z } from 'zod';
+/** Where core says its version, without authentication. */
+export const CORE_VERSION_PATH = '/api/version';
+/** How long a package waits for core's version before it counts the fleet as not answering. */
+const CORE_VERSION_TIMEOUT_MS = 10_000;
+/** The HTTP statuses that answer a version. */
+const HTTP_OK_FIRST = 200;
+const HTTP_OK_LAST = 299;
+/** A plain release version; core `0.0.0` is a build from main. */
+const VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+/** Core's version as `/api/version` answers it. */
+const coreVersionAnswerSchema = z.object({ server: z.string() });
+function versionOf(text) {
+    const match = VERSION_PATTERN.exec(text);
+    return match === null ? undefined : [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isOlder(version, than) {
+    const differing = version.findIndex((part, index) => part !== than[index]);
+    return differing !== -1 && (version[differing] ?? 0) < (than[differing] ?? 0);
+}
+/** Core's version, or why it could not be read. */
+async function readCoreVersion(fleetUrl, fetch) {
+    try {
+        const response = await fetch(`${fleetUrl.replace(/\/+$/, '')}${CORE_VERSION_PATH}`, { signal: AbortSignal.timeout(CORE_VERSION_TIMEOUT_MS) });
+        if (response.status < HTTP_OK_FIRST || response.status > HTTP_OK_LAST) {
+            return { unread: `HTTP ${String(response.status)}` };
+        }
+        const answer = coreVersionAnswerSchema.safeParse(await response.json());
+        const parsed = answer.success ? versionOf(answer.data.server) : undefined;
+        return answer.success && parsed !== undefined ? { core: answer.data.server, parsed } : { unread: `its ${CORE_VERSION_PATH} answered no core version` };
+    }
+    catch (error) {
+        return { unread: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Why the package may not start against the fleet's core, or none when it
+ * may: core is at least `minimum`, or is `0.0.0`.
+ */
+export async function coreVersionRefusal(input) {
+    const { packageName, version, minimum, fleetUrl, fetch } = input;
+    const needs = `${packageName} ${version} needs core ${minimum} or later`;
+    const minimumVersion = versionOf(minimum);
+    if (minimumVersion === undefined) {
+        throw new Error(`${packageName}'s minimum core version ${minimum} is not MAJOR.MINOR.PATCH`);
+    }
+    const read = await readCoreVersion(fleetUrl, fetch);
+    if ('unread' in read) {
+        return `${needs}, and could not read the version of the fleet at ${fleetUrl}: ${read.unread}`;
+    }
+    const isMainBuild = read.parsed.every((part) => part === 0);
+    return isMainBuild || !isOlder(read.parsed, minimumVersion) ? undefined : `${needs}; the fleet at ${fleetUrl} runs core ${read.core}: upgrade core first`;
+}
+//# sourceMappingURL=core-version.js.map

package/dist/fleet/core-version.js.map

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

package/dist/fleet/index.d.ts

@@ -4,48 +4,100 @@ import { z } from 'zod';
  * scopes, ship kinds, ship statuses, lease locations, selector kinds, delivery
  * states and event types. Core and console use the same words.
  */
-/** A permission of a ship, stored on the server with the ship and checked before every call. */
-export declare const SCOPES: readonly ["messages:send", "messages:receive", "fleet:read", "fleet:manage", "crew:assign", "crew:run", "labels:define", "labels:assign", "fleet:network"];
+/**
+ * A core scope: a permission of a ship, stored on the server with the ship
+ * and checked by core before every call. `messages:force` sends a forced
+ * message, one that comes first (decision 0040); `fleet:on-behalf` reads on
+ * behalf of a named ship (decision 0034); `scopes:declare` takes up a
+ * plugin namespace and `scopes:grant` grants and revokes on a live ship
+ * (decision 0046).
+ */
+export declare const SCOPES: readonly ["messages:send", "messages:receive", "messages:force", "messages:resend", "fleet:read", "fleet:commission", "fleet:manage", "crew:assign", "crew:run", "labels:define", "labels:assign", "fleet:network", "fleet:on-behalf", "scopes:declare", "scopes:grant"];
 export declare const scopeSchema: z.ZodEnum<{
     "messages:send": "messages:send";
     "messages:receive": "messages:receive";
+    "messages:force": "messages:force";
+    "messages:resend": "messages:resend";
     "fleet:read": "fleet:read";
+    "fleet:commission": "fleet:commission";
     "fleet:manage": "fleet:manage";
     "crew:assign": "crew:assign";
     "crew:run": "crew:run";
     "labels:define": "labels:define";
     "labels:assign": "labels:assign";
     "fleet:network": "fleet:network";
+    "fleet:on-behalf": "fleet:on-behalf";
+    "scopes:declare": "scopes:declare";
+    "scopes:grant": "scopes:grant";
 }>;
 export type Scope = z.infer<typeof scopeSchema>;
+/** What each core scope allows, on one line (decision 0046). */
+export declare const CORE_SCOPE_DESCRIPTIONS: Readonly<Record<Scope, string>>;
+/** The namespaces core reserves and enforces; every other one is a plugin's (decision 0046). */
+export declare const CORE_NAMESPACES: readonly ["messages", "fleet", "crew", "labels", "scopes"];
+export declare const SCOPE_NAMESPACE_PATTERN: RegExp;
+export declare const SCOPE_NAME_PATTERN: RegExp;
+/** The most scopes a plugin declares in its namespace (decision 0046). */
+export declare const NAMESPACE_SCOPES_MAX = 20;
+/** The longest one-line description of a declared scope. */
+export declare const SCOPE_DESCRIPTION_MAX_LENGTH = 200;
+/** Whether the namespace is one core reserves. */
+export declare function isCoreNamespace(namespace: string): boolean;
+/**
+ * Any scope a ship may hold (decision 0046): `<namespace>:<action>`, a core
+ * scope when its namespace is a core one, else a plugin's.
+ */
+export declare const scopeNameSchema: z.ZodString;
+export type ScopeName = z.infer<typeof scopeNameSchema>;
 /**
  * The scopes commissioning may add to an agent ship, beside sending and
- * receiving, which every agent ship has (ADR 0002). `crew:assign` writes crew
+ * receiving, which every agent ship has (ADR 0002). `messages:resend`
+ * resends or dismisses a stuck delivery; `fleet:commission` commissions
+ * agent ships; `fleet:manage` manages the ships in its manage reach (decision
+ * 0046). `crew:assign` writes crew
  * request assignments; `crew:run` crews the ships whose requests are assigned
  * to its ship (decision 0029). `labels:define` defines labels and changes
  * their values; `labels:assign` assigns and unassigns the labels its ship owns
  * (decision 0031). `fleet:network` sets the fleet's network rules (decision
- * 0034).
+ * 0034). `fleet:on-behalf` reads on behalf of a named ship (decision 0034).
  */
-export declare const FLEET_SCOPES: readonly ["fleet:read", "fleet:manage", "crew:assign", "crew:run", "labels:define", "labels:assign", "fleet:network"];
+export declare const FLEET_SCOPES: readonly ["messages:resend", "fleet:read", "fleet:commission", "fleet:manage", "crew:assign", "crew:run", "labels:define", "labels:assign", "fleet:network", "fleet:on-behalf"];
 export declare const fleetScopeSchema: z.ZodEnum<{
+    "messages:resend": "messages:resend";
     "fleet:read": "fleet:read";
+    "fleet:commission": "fleet:commission";
     "fleet:manage": "fleet:manage";
     "crew:assign": "crew:assign";
     "crew:run": "crew:run";
     "labels:define": "labels:define";
     "labels:assign": "labels:assign";
     "fleet:network": "fleet:network";
+    "fleet:on-behalf": "fleet:on-behalf";
 }>;
 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", "viewer"];
+/**
+ * What a ship is (decision 0044): `argo` is the one `operator`, the console's
+ * door is the `viewer`, an `agent` is a session, a `person` a human's ship
+ * crewed by their own app or a chat, and an `app` an application or an
+ * outside party, crewed by its adapter.
+ */
+export declare const SHIP_KINDS: readonly ["operator", "agent", "viewer", "person", "app"];
 export declare const shipKindSchema: z.ZodEnum<{
     operator: "operator";
     agent: "agent";
     viewer: "viewer";
+    person: "person";
+    app: "app";
 }>;
 export type ShipKind = z.infer<typeof shipKindSchema>;
+/** The kinds a commission makes; argo and the viewer ship come with the fleet. */
+export declare const COMMISSIONED_SHIP_KINDS: readonly ["agent", "person", "app"];
+export declare const commissionedShipKindSchema: z.ZodEnum<{
+    agent: "agent";
+    person: "person";
+    app: "app";
+}>;
+export type CommissionedShipKind = z.infer<typeof commissionedShipKindSchema>;
 /** Where the session crewing a ship runs. `OTHER` carries a short description. */
 export declare const LOCATION_KINDS: readonly ["DEVICE", "CLOUD", "SERVER", "OTHER"];
 export declare const locationKindSchema: z.ZodEnum<{
@@ -69,8 +121,8 @@ export type ShipStatus = z.infer<typeof shipStatusSchema>;
 /** Who a message is for: one ship (by id or by name) or any ship of a type. Group and fleet come later. */
 export declare const SELECTOR_KINDS: readonly ["ship", "type"];
 export declare const selectorKindSchema: z.ZodEnum<{
-    ship: "ship";
     type: "type";
+    ship: "ship";
 }>;
 export type SelectorKind = z.infer<typeof selectorKindSchema>;
 /**
@@ -96,10 +148,12 @@ 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", "LeasePushed", "DeliveryReceived", "DeliveryHanded", "DeliveryAcknowledged", "DeliveryHandled", "DeliveryNotHandled", "DeliveryOverdue", "DeliveryUndeliverable", "DeliveryReturned", "ShipRetired", "DeliveryAbandoned", "DeliveryDismissed", "ShipRenamed", "ShipReported", "TurnReported", "SignInTicketIssued", "FleetLimitsChanged", "ViewerSessionStarted", "CrewRequested", "CrewRequestRemoved", "CrewAssigned", "CrewStatusChanged", "CrewRequestExplained", "CrewRequestGivenBack", "LabelDefined", "LabelValuesChanged", "LabelRetired", "LabelAssigned", "LabelUnassigned", "LabelDeleted", "WorktreeClearRequested", "WorktreeCleared", "WorktreeClearRemoved", "NetworkRulesSet", "NetworkRulesDeclared", "NetworkPluginRegistered", "NetworkPluginUnregistered"];
+export declare const EVENT_TYPES: readonly ["FleetInitialised", "ShipCommissioned", "OwnerSet", "OwnerChanged", "ShipClaimed", "LeaseRevoked", "CredentialRevoked", "StartingPromptIssued", "OperatorPasswordReset", "MessageAccepted", "LeasePushed", "DeliveryReceived", "DeliveryHanded", "DeliveryAcknowledged", "DeliveryHandled", "DeliveryNotHandled", "DeliveryOverdue", "DeliveryUndeliverable", "DeliveryReturned", "ShipRetired", "DeliveryAbandoned", "DeliveryDismissed", "ShipRenamed", "ShipReported", "StatementSet", "TurnReported", "SignInTicketIssued", "FleetLimitsChanged", "ViewerSessionStarted", "CrewRequested", "CrewRequestRemoved", "CrewAssigned", "CrewStatusChanged", "CrewRequestExplained", "CrewRequestGivenBack", "LabelDefined", "LabelValuesChanged", "LabelRetired", "LabelAssigned", "LabelUnassigned", "LabelDeleted", "WorktreeClearRequested", "WorktreeCleared", "WorktreeClearRemoved", "NetworkRulesSet", "NetworkRulesDeclared", "NetworkPluginRegistered", "NetworkPluginUnregistered", "BuiltInRuleChanged", "ScopesDeclared", "ScopesChanged", "PluginConnected", "PluginDisconnected"];
 export declare const eventTypeSchema: z.ZodEnum<{
     FleetInitialised: "FleetInitialised";
     ShipCommissioned: "ShipCommissioned";
+    OwnerSet: "OwnerSet";
+    OwnerChanged: "OwnerChanged";
     ShipClaimed: "ShipClaimed";
     LeaseRevoked: "LeaseRevoked";
     CredentialRevoked: "CredentialRevoked";
@@ -120,6 +174,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
     DeliveryDismissed: "DeliveryDismissed";
     ShipRenamed: "ShipRenamed";
     ShipReported: "ShipReported";
+    StatementSet: "StatementSet";
     TurnReported: "TurnReported";
     SignInTicketIssued: "SignInTicketIssued";
     FleetLimitsChanged: "FleetLimitsChanged";
@@ -143,10 +198,16 @@ export declare const eventTypeSchema: z.ZodEnum<{
     NetworkRulesDeclared: "NetworkRulesDeclared";
     NetworkPluginRegistered: "NetworkPluginRegistered";
     NetworkPluginUnregistered: "NetworkPluginUnregistered";
+    BuiltInRuleChanged: "BuiltInRuleChanged";
+    ScopesDeclared: "ScopesDeclared";
+    ScopesChanged: "ScopesChanged";
+    PluginConnected: "PluginConnected";
+    PluginDisconnected: "PluginDisconnected";
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;
 export * from './argo-message.js';
 export * from './busy-wait.js';
+export * from './core-version.js';
 export * from './mcp-url.js';
 export * from './no-terminal-questions.js';
 /**

package/dist/fleet/index.js

@@ -4,23 +4,97 @@ import { z } from 'zod';
  * scopes, ship kinds, ship statuses, lease locations, selector kinds, delivery
  * states and event types. Core and console use the same words.
  */
-/** 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', 'crew:assign', 'crew:run', 'labels:define', 'labels:assign', 'fleet:network'];
+/**
+ * A core scope: a permission of a ship, stored on the server with the ship
+ * and checked by core before every call. `messages:force` sends a forced
+ * message, one that comes first (decision 0040); `fleet:on-behalf` reads on
+ * behalf of a named ship (decision 0034); `scopes:declare` takes up a
+ * plugin namespace and `scopes:grant` grants and revokes on a live ship
+ * (decision 0046).
+ */
+export const SCOPES = [
+    'messages:send',
+    'messages:receive',
+    'messages:force',
+    'messages:resend',
+    'fleet:read',
+    'fleet:commission',
+    'fleet:manage',
+    'crew:assign',
+    'crew:run',
+    'labels:define',
+    'labels:assign',
+    'fleet:network',
+    'fleet:on-behalf',
+    'scopes:declare',
+    'scopes:grant',
+];
 export const scopeSchema = z.enum(SCOPES);
+/** What each core scope allows, on one line (decision 0046). */
+export const CORE_SCOPE_DESCRIPTIONS = {
+    'messages:send': 'Send, answer and ask other ships',
+    'messages:receive': 'Receive and confirm the deliveries to its own ship',
+    'messages:force': 'Send a forced message, which comes first',
+    'messages:resend': 'Resend or dismiss a stuck delivery of a message its ship reads',
+    'fleet:read': 'Read ships, timelines, messages, labels, events and fleet-wide views',
+    'fleet:commission': 'Commission agent ships, granting only what its ship may grant',
+    'fleet:manage': 'Rename, release, recrew and retire the ships it manages; starting prompts, pings, crew requests and worktree clears',
+    'crew:assign': 'Assign crew requests to trierarchs and explain why none fits',
+    'crew:run': 'Crew the ships whose crew requests are assigned to its ship',
+    'labels:define': 'Define labels, change their values and declare network rules on them',
+    'labels:assign': 'Assign and unassign the values of labels its ship owns',
+    'fleet:network': "The networking plugin's calls: the fleet's network rules",
+    'fleet:on-behalf': "Read on behalf of a named ship, with that ship's read reach",
+    'scopes:declare': 'Take up one plugin namespace and declare its scopes',
+    'scopes:grant': 'Grant and revoke scopes on a live ship, within what its ship may grant',
+};
+/** The namespaces core reserves and enforces; every other one is a plugin's (decision 0046). */
+export const CORE_NAMESPACES = ['messages', 'fleet', 'crew', 'labels', 'scopes'];
+/** A namespace or an action: lowercase letters, digits and hyphens, starting with a letter, 1 to 32 characters (decision 0046). */
+const SCOPE_PART = '[a-z][a-z0-9-]{0,31}';
+export const SCOPE_NAMESPACE_PATTERN = new RegExp(`^${SCOPE_PART}$`);
+export const SCOPE_NAME_PATTERN = new RegExp(`^${SCOPE_PART}:${SCOPE_PART}$`);
+/** The most scopes a plugin declares in its namespace (decision 0046). */
+export const NAMESPACE_SCOPES_MAX = 20;
+/** The longest one-line description of a declared scope. */
+export const SCOPE_DESCRIPTION_MAX_LENGTH = 200;
+/** Whether the namespace is one core reserves. */
+export function isCoreNamespace(namespace) {
+    return CORE_NAMESPACES.some((core) => core === namespace);
+}
+/**
+ * Any scope a ship may hold (decision 0046): `<namespace>:<action>`, a core
+ * scope when its namespace is a core one, else a plugin's.
+ */
+export const scopeNameSchema = z
+    .string()
+    .regex(SCOPE_NAME_PATTERN, 'A scope is <namespace>:<action>')
+    .refine((scope) => !isCoreNamespace(scope.slice(0, scope.indexOf(':'))) || scopeSchema.safeParse(scope).success, 'No such core scope');
 /**
  * The scopes commissioning may add to an agent ship, beside sending and
- * receiving, which every agent ship has (ADR 0002). `crew:assign` writes crew
+ * receiving, which every agent ship has (ADR 0002). `messages:resend`
+ * resends or dismisses a stuck delivery; `fleet:commission` commissions
+ * agent ships; `fleet:manage` manages the ships in its manage reach (decision
+ * 0046). `crew:assign` writes crew
  * request assignments; `crew:run` crews the ships whose requests are assigned
  * to its ship (decision 0029). `labels:define` defines labels and changes
  * their values; `labels:assign` assigns and unassigns the labels its ship owns
  * (decision 0031). `fleet:network` sets the fleet's network rules (decision
- * 0034).
+ * 0034). `fleet:on-behalf` reads on behalf of a named ship (decision 0034).
  */
-export const FLEET_SCOPES = ['fleet:read', 'fleet:manage', 'crew:assign', 'crew:run', 'labels:define', 'labels:assign', 'fleet:network'];
+export const FLEET_SCOPES = ['messages:resend', 'fleet:read', 'fleet:commission', 'fleet:manage', 'crew:assign', 'crew:run', 'labels:define', 'labels:assign', 'fleet:network', 'fleet:on-behalf'];
 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', 'viewer'];
+/**
+ * What a ship is (decision 0044): `argo` is the one `operator`, the console's
+ * door is the `viewer`, an `agent` is a session, a `person` a human's ship
+ * crewed by their own app or a chat, and an `app` an application or an
+ * outside party, crewed by its adapter.
+ */
+export const SHIP_KINDS = ['operator', 'agent', 'viewer', 'person', 'app'];
 export const shipKindSchema = z.enum(SHIP_KINDS);
+/** The kinds a commission makes; argo and the viewer ship come with the fleet. */
+export const COMMISSIONED_SHIP_KINDS = ['agent', 'person', 'app'];
+export const commissionedShipKindSchema = z.enum(COMMISSIONED_SHIP_KINDS);
 /** Where the session crewing a ship runs. `OTHER` carries a short description. */
 export const LOCATION_KINDS = ['DEVICE', 'CLOUD', 'SERVER', 'OTHER'];
 export const locationKindSchema = z.enum(LOCATION_KINDS);
@@ -58,6 +132,8 @@ export const deliveryStateSchema = z.enum(DELIVERY_STATES);
 export const EVENT_TYPES = [
     'FleetInitialised',
     'ShipCommissioned',
+    'OwnerSet',
+    'OwnerChanged',
     'ShipClaimed',
     'LeaseRevoked',
     'CredentialRevoked',
@@ -78,6 +154,7 @@ export const EVENT_TYPES = [
     'DeliveryDismissed',
     'ShipRenamed',
     'ShipReported',
+    'StatementSet',
     'TurnReported',
     'SignInTicketIssued',
     'FleetLimitsChanged',
@@ -101,10 +178,16 @@ export const EVENT_TYPES = [
     'NetworkRulesDeclared',
     'NetworkPluginRegistered',
     'NetworkPluginUnregistered',
+    'BuiltInRuleChanged',
+    'ScopesDeclared',
+    'ScopesChanged',
+    'PluginConnected',
+    'PluginDisconnected',
 ];
 export const eventTypeSchema = z.enum(EVENT_TYPES);
 export * from './argo-message.js';
 export * from './busy-wait.js';
+export * from './core-version.js';
 export * from './mcp-url.js';
 export * from './no-terminal-questions.js';
 /**

package/dist/fleet/index.js.map

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

package/dist/fleet/no-terminal-questions.d.ts

@@ -4,4 +4,4 @@
  * trierarch adds it to its first and every wake prompt, and the aeolus
  * plugin's crew skills say the same.
  */
-export declare const NO_TERMINAL_QUESTIONS = "No human reads this terminal. Never ask here; ask over the fleet. A question only the operator can answer goes to argo.";
+export declare const NO_TERMINAL_QUESTIONS = "No human reads this terminal. Never ask here; ask over the fleet. A question only a human can answer goes to your ship's owner (argo when argo owns your ship).";

package/dist/fleet/no-terminal-questions.js

@@ -4,5 +4,5 @@
  * trierarch adds it to its first and every wake prompt, and the aeolus
  * plugin's crew skills say the same.
  */
-export const NO_TERMINAL_QUESTIONS = 'No human reads this terminal. Never ask here; ask over the fleet. A question only the operator can answer goes to argo.';
+export const NO_TERMINAL_QUESTIONS = "No human reads this terminal. Never ask here; ask over the fleet. A question only a human can answer goes to your ship's owner (argo when argo owns your ship).";
 //# sourceMappingURL=no-terminal-questions.js.map

package/dist/fleet/no-terminal-questions.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-terminal-questions.js","sourceRoot":"","sources":["../../src/fleet/no-terminal-questions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,yHAAyH,CAAC"}
+{"version":3,"file":"no-terminal-questions.js","sourceRoot":"","sources":["../../src/fleet/no-terminal-questions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iKAAiK,CAAC"}

package/dist/rules/index.d.ts

@@ -7,5 +7,6 @@
 export * from './label-handle.js';
 export * from './payload.js';
 export * from './plain-http.js';
+export * from './read-reach.js';
 export * from './ship-handle.js';
 export * from './sign-in.js';

package/dist/rules/index.js

@@ -7,6 +7,7 @@
 export * from './label-handle.js';
 export * from './payload.js';
 export * from './plain-http.js';
+export * from './read-reach.js';
 export * from './ship-handle.js';
 export * from './sign-in.js';
 //# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/rules/read-reach.d.ts

@@ -0,0 +1,4 @@
+/** Whether the caller reads the ship whole, rather than its name, type and status only (decision 0034). */
+export declare function isInReadReach<Ship extends object>(ship: Ship): ship is Exclude<Ship, {
+    isInReadReach: false;
+}>;

package/dist/rules/read-reach.js

@@ -0,0 +1,5 @@
+/** Whether the caller reads the ship whole, rather than its name, type and status only (decision 0034). */
+export function isInReadReach(ship) {
+    return !('isInReadReach' in ship);
+}
+//# sourceMappingURL=read-reach.js.map

package/dist/rules/read-reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-reach.js","sourceRoot":"","sources":["../../src/rules/read-reach.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,UAAU,aAAa,CAAsB,IAAU;IAC3D,OAAO,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/schemas/console.d.ts

@@ -50,13 +50,19 @@ export declare const consoleSessionOutputSchema: z.ZodObject<{
     scopes: z.ZodArray<z.ZodEnum<{
         "messages:send": "messages:send";
         "messages:receive": "messages:receive";
+        "messages:force": "messages:force";
+        "messages:resend": "messages:resend";
         "fleet:read": "fleet:read";
+        "fleet:commission": "fleet:commission";
         "fleet:manage": "fleet:manage";
         "crew:assign": "crew:assign";
         "crew:run": "crew:run";
         "labels:define": "labels:define";
         "labels:assign": "labels:assign";
         "fleet:network": "fleet:network";
+        "fleet:on-behalf": "fleet:on-behalf";
+        "scopes:declare": "scopes:declare";
+        "scopes:grant": "scopes:grant";
     }>>;
 }, z.core.$strip>;
 export type ConsoleSessionOutput = z.infer<typeof consoleSessionOutputSchema>;

package/dist/schemas/crew-request.d.ts

@@ -165,6 +165,8 @@ export declare const assignedCrewRequestsOutputSchema: z.ZodArray<z.ZodObject<{
         releasing: "releasing";
     }>>;
     isFinal: z.ZodBoolean;
+    ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    ownerName: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>;
 /**
  * Input of `fleet.explainCrewRequest` (crew:assign): why no trierarch can

package/dist/schemas/crew-request.js

@@ -99,6 +99,9 @@ export const assignedCrewRequestsOutputSchema = z.array(z.object({
     status: crewStatusSchema.nullable(),
     /** Whether its crew is final (decision 0029): kept whatever status follows, cleared on every new settings version. */
     isFinal: z.boolean(),
+    /** Its ship's owner as it is now, by id and name, where the trierarch sends its trouble (decision 0045); both null for a ship with none. */
+    ownerShipId: idSchema('ship').nullable(),
+    ownerName: z.string().nullable(),
 }));
 /**
  * Input of `fleet.explainCrewRequest` (crew:assign): why no trierarch can

package/dist/schemas/crew-request.js.map

@@ -1 +1 @@
-{"version":3,"file":"crew-request.js","sourceRoot":"","sources":["../../src/schemas/crew-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,uFAAuF;AACvF,MAAM,UAAU,wBAAwB,CAAC,QAA6B;IACpE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAIxE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC;AACnG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAGtD,iGAAiG;AACjG,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,MAAM,cAAc,GAAG,mCAAmC,MAAM,CAAC,8BAA8B,CAAC,aAAa,CAAC;AAE9G,sGAAsG;AACtG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,QAAQ,EAAE,yBAAyB;CACpC,CAAC,CAAC;AAIH,sGAAsG;AACtG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAErF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEnF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC7B,yFAAyF;IACzF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3E,kEAAkE;IAClE,MAAM,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACnC,8FAA8F;IAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,yIAAyI;IACzI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzE,2HAA2H;IAC3H,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,8FAA8F;IAC9F,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,2JAA2J;IAC3J,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAClK;CACF,CAAC,CAAC;AAEH,gGAAgG;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,yBAAyB,EAAE,CAAC,CAAC;AAEzG,yHAAyH;AACzH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/G,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEzD,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,gBAAgB;IACxB,8HAA8H;IAC9H,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,oGAAoG;IACpG,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAE/D,yFAAyF;AACzF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACrD,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,QAAQ,EAAE,yBAAyB;IACnC,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACnC,sHAAsH;IACtH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,8BAA8B,EAAE,cAAc,CAAC;SACnD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;SAC1D,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;SACtB,GAAG,CAAC,8BAA8B,EAAE,cAAc,CAAC;SACnD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAC9D,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"crew-request.js","sourceRoot":"","sources":["../../src/schemas/crew-request.ts"],"names":[],"mappings":"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"}