@aeolus-fleet/common 0.26.1 → 0.27.0

package/dist/schemas/scopes.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+/** One scope and its one-line description, as a namespace lists it. */
+export declare const declaredScopeSchema: z.ZodObject<{
+    scope: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Input of `fleet.declareScopes` (scopes:declare): the caller's plugin
+ * namespace and its whole list of scopes (decision 0046). Core checks each
+ * rule and names its refusal.
+ */
+export declare const declareScopesInputSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    scopes: z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Output of `fleet.declareScopes`: the namespace as declared. */
+export declare const declareScopesOutputSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    scopes: z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Output of `fleet.scopes` (fleet:read): every namespace of the fleet, the
+ * core ones first, declared by no ship, then each plugin's by namespace,
+ * with its declarer by id and name (decision 0046).
+ */
+export declare const scopesOutputSchema: z.ZodArray<z.ZodObject<{
+    namespace: z.ZodString;
+    declaredBy: z.ZodNullable<z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    scopes: z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+/**
+ * Input of `fleet.grantScopes` (scopes:grant): the live ship, and the scopes
+ * granted and revoked at once, each within what the caller's ship may grant
+ * (decision 0046).
+ */
+export declare const grantScopesInputSchema: z.ZodObject<{
+    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    grant: z.ZodArray<z.ZodString>;
+    revoke: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Output of `fleet.grantScopes`: every scope the ship holds now. */
+export declare const grantScopesOutputSchema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;

package/dist/schemas/scopes.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { scopeNameSchema } from '../fleet/index.js';
+import { idSchema } from '../ids/index.js';
+/** One scope and its one-line description, as a namespace lists it. */
+export const declaredScopeSchema = z.object({ scope: scopeNameSchema, description: z.string() });
+/**
+ * Input of `fleet.declareScopes` (scopes:declare): the caller's plugin
+ * namespace and its whole list of scopes (decision 0046). Core checks each
+ * rule and names its refusal.
+ */
+export const declareScopesInputSchema = z.object({
+    namespace: z.string(),
+    scopes: z.array(z.object({ scope: z.string(), description: z.string() })),
+});
+/** Output of `fleet.declareScopes`: the namespace as declared. */
+export const declareScopesOutputSchema = z.object({ namespace: z.string(), scopes: z.array(declaredScopeSchema) });
+/**
+ * Output of `fleet.scopes` (fleet:read): every namespace of the fleet, the
+ * core ones first, declared by no ship, then each plugin's by namespace,
+ * with its declarer by id and name (decision 0046).
+ */
+export const scopesOutputSchema = z.array(z.object({
+    namespace: z.string(),
+    declaredBy: z.object({ id: idSchema('ship'), name: z.string() }).nullable(),
+    scopes: z.array(declaredScopeSchema),
+}));
+/**
+ * Input of `fleet.grantScopes` (scopes:grant): the live ship, and the scopes
+ * granted and revoked at once, each within what the caller's ship may grant
+ * (decision 0046).
+ */
+export const grantScopesInputSchema = z.object({ shipId: idSchema('ship'), grant: z.array(z.string()), revoke: z.array(z.string()) });
+/** Output of `fleet.grantScopes`: every scope the ship holds now. */
+export const grantScopesOutputSchema = z.object({ scopes: z.array(scopeNameSchema) });
+//# sourceMappingURL=scopes.js.map

package/dist/schemas/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../src/schemas/scopes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEjG;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC1E,CAAC,CAAC;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAEnH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CACvC,CAAC,CAAC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,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,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACrC,CAAC,CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAEtI,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC"}

package/dist/schemas/ship.d.ts

@@ -69,6 +69,8 @@ export declare const whoamiOutputSchema: z.ZodObject<{
     fleetId: z.ZodType<`flt_${string}`, unknown, z.core.$ZodTypeInternals<`flt_${string}`, unknown>>;
     name: z.ZodString;
     type: z.ZodString;
+    ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    ownerName: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type WhoamiOutput = z.infer<typeof whoamiOutputSchema>;
 /** Output of `ship.deregister`: nothing; the OK is the answer. */

package/dist/schemas/ship.js

@@ -62,6 +62,13 @@ export const whoamiOutputSchema = z.object({
     fleetId: idSchema('fleet'),
     name: z.string(),
     type: z.string(),
+    /**
+     * Its owner's id and name, both null for argo and the viewer (decision
+     * 0045). Keys of their own: the aeolus plugin's scripts read name, shipId
+     * and type as the last such key in the answer.
+     */
+    ownerShipId: idSchema('ship').nullable(),
+    ownerName: z.string().nullable(),
 });
 /** Output of `ship.deregister`: nothing; the OK is the answer. */
 export const deregisterOutputSchema = z.strictObject({});

package/dist/schemas/ship.js.map

@@ -1 +1 @@
-{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../src/schemas/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;GAIG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACzD,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC,YAAY,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;aAC/C,GAAG,CAAC,+BAA+B,EAAE,4BAA4B,+BAA+B,aAAa,CAAC;KAClH,CAAC;CACH,CAAC,CAAC;AAIH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAEhF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,IAAI,EAAE;KACN,WAAW,EAAE;KACb,GAAG,CAAC,CAAC,EAAE,qDAAqD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KACzF,GAAG,CAAC,kBAAkB,EAAE,wBAAwB,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAE5F,8HAA8H;AAC9H,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACrD,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,aAAa;CACvB,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAIxE,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAIH,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../src/schemas/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;GAIG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACzD,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC,YAAY,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;aAC/C,GAAG,CAAC,+BAA+B,EAAE,4BAA4B,+BAA+B,aAAa,CAAC;KAClH,CAAC;CACH,CAAC,CAAC;AAIH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAEhF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,IAAI,EAAE;KACN,WAAW,EAAE;KACb,GAAG,CAAC,CAAC,EAAE,qDAAqD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KACzF,GAAG,CAAC,kBAAkB,EAAE,wBAAwB,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAE5F,8HAA8H;AAC9H,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACrD,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,aAAa;CACvB,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAIxE,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;;;OAIG;IACH,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}

package/dist/schemas/statement.d.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+/**
+ * A ship's statement (decision 0047): what it is and what it offers, stated
+ * by its crew and read by the ships that can send to it. A short summary and
+ * capabilities, each borrowing MCP's tool fields (name, title, description,
+ * inputSchema, outputSchema) and A2A's skill fields for media types
+ * (inputModes, outputModes), so a later gateway maps them as they are
+ * (decision 0048). Core checks the shape and acts on none of it.
+ */
+/** The most a statement holds: 64 KB as the UTF-8 bytes of its JSON, as a payload does (decision 0006). */
+export declare const STATEMENT_MAX_BYTES: number;
+/** The longest a statement's summary may be. */
+export declare const STATEMENT_SUMMARY_MAX_LENGTH = 1000;
+/** One thing a ship offers: MCP's tool fields and A2A's input and output modes. */
+export declare const capabilitySchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    inputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type Capability = z.infer<typeof capabilitySchema>;
+/** The size of a statement: the UTF-8 bytes of its JSON. */
+export declare function statementBytes(statement: unknown): number;
+/** A statement: a summary and capabilities, each name once, at most 64 KB. */
+export declare const statementSchema: z.ZodObject<{
+    summary: z.ZodString;
+    capabilities: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        inputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        outputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Statement = z.infer<typeof statementSchema>;
+/** Input of `setStatement`: the crew's whole statement, replacing the one it stated before. */
+export declare const setStatementInputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    capabilities: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        inputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        outputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Output of `setStatement`: the statement's version now. */
+export declare const setStatementOutputSchema: z.ZodObject<{
+    version: z.ZodInt;
+}, z.core.$strip>;
+/**
+ * A ship's statement as discovery shows it, saying who wrote it: its crew's,
+ * with its version, while one is stated; else the note it was commissioned
+ * with; else none.
+ */
+export declare const discoveredStatementSchema: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    by: z.ZodLiteral<"crew">;
+    version: z.ZodInt;
+    summary: z.ZodString;
+    capabilities: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        inputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        outputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
+    by: z.ZodLiteral<"commission">;
+    note: z.ZodString;
+}, z.core.$strip>], "by">>;
+export type DiscoveredStatement = z.infer<typeof discoveredStatementSchema>;
+/**
+ * Output of `discover` (messages:send): the ships the caller may send to now,
+ * each with its name, type, kind, status and statement, and each type with
+ * how many of its ships it reaches (decision 0047). Ships, never rules.
+ */
+export declare const discoverOutputSchema: z.ZodObject<{
+    ships: z.ZodArray<z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+        type: z.ZodString;
+        kind: z.ZodEnum<{
+            operator: "operator";
+            agent: "agent";
+            viewer: "viewer";
+            person: "person";
+            app: "app";
+        }>;
+        status: z.ZodEnum<{
+            awaitingCrew: "awaitingCrew";
+            crewed: "crewed";
+            retired: "retired";
+        }>;
+        statement: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            by: z.ZodLiteral<"crew">;
+            version: z.ZodInt;
+            summary: z.ZodString;
+            capabilities: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                inputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                outputModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>, z.ZodObject<{
+            by: z.ZodLiteral<"commission">;
+            note: z.ZodString;
+        }, z.core.$strip>], "by">>;
+    }, z.core.$strip>>;
+    types: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        reachable: z.ZodInt;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Discovered = z.infer<typeof discoverOutputSchema>;

package/dist/schemas/statement.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { shipKindSchema, shipStatusSchema } from '../fleet/index.js';
+import { idSchema } from '../ids/index.js';
+import { contentTypeSchema } from './message.js';
+/**
+ * A ship's statement (decision 0047): what it is and what it offers, stated
+ * by its crew and read by the ships that can send to it. A short summary and
+ * capabilities, each borrowing MCP's tool fields (name, title, description,
+ * inputSchema, outputSchema) and A2A's skill fields for media types
+ * (inputModes, outputModes), so a later gateway maps them as they are
+ * (decision 0048). Core checks the shape and acts on none of it.
+ */
+/** The most a statement holds: 64 KB as the UTF-8 bytes of its JSON, as a payload does (decision 0006). */
+export const STATEMENT_MAX_BYTES = 64 * 1024;
+/** The longest a statement's summary may be. */
+export const STATEMENT_SUMMARY_MAX_LENGTH = 1000;
+/** A capability's name as MCP names a tool: 1 to 128 letters, digits, `_`, `-` or `.`. */
+const CAPABILITY_NAME = /^[A-Za-z0-9_.-]{1,128}$/;
+const CAPABILITY_NAME_MESSAGE = 'A capability name is 1 to 128 letters, digits, _, - or ., as MCP names a tool';
+/** A JSON Schema as MCP's tool takes one: a JSON object, never read by the fleet. */
+const jsonSchemaSchema = z.record(z.string(), z.json());
+/** Media types, as A2A's skill lists them: at least one, the first the one to use. */
+const modesSchema = z.array(contentTypeSchema).min(1, 'Name at least one media type');
+/** One thing a ship offers: MCP's tool fields and A2A's input and output modes. */
+export const capabilitySchema = z.strictObject({
+    name: z.string().regex(CAPABILITY_NAME, CAPABILITY_NAME_MESSAGE),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    inputSchema: jsonSchemaSchema.optional(),
+    outputSchema: jsonSchemaSchema.optional(),
+    /** The media types to send it, the first the one to use (A2A's skill inputModes). */
+    inputModes: modesSchema.optional(),
+    /** The media types that come back, the first the one to expect (A2A's skill outputModes). */
+    outputModes: modesSchema.optional(),
+});
+const utf8 = new TextEncoder();
+/** The size of a statement: the UTF-8 bytes of its JSON. */
+export function statementBytes(statement) {
+    return utf8.encode(JSON.stringify(statement)).byteLength;
+}
+const STATEMENT_SIZE_MESSAGE = `A statement is at most ${String(STATEMENT_MAX_BYTES)} bytes (64 KB) as JSON in UTF-8`;
+/** A statement: a summary and capabilities, each name once, at most 64 KB. */
+export const statementSchema = z
+    .strictObject({
+    summary: z
+        .string()
+        .trim()
+        .min(1, 'A statement has a summary')
+        .max(STATEMENT_SUMMARY_MAX_LENGTH, `A summary is at most ${String(STATEMENT_SUMMARY_MAX_LENGTH)} characters`),
+    capabilities: z.array(capabilitySchema),
+})
+    .refine((statement) => new Set(statement.capabilities.map((capability) => capability.name)).size === statement.capabilities.length, {
+    message: 'A statement names each capability once',
+    path: ['capabilities'],
+})
+    .refine((statement) => statementBytes(statement) <= STATEMENT_MAX_BYTES, { message: STATEMENT_SIZE_MESSAGE });
+/** Input of `setStatement`: the crew's whole statement, replacing the one it stated before. */
+export const setStatementInputSchema = statementSchema;
+/** Output of `setStatement`: the statement's version now. */
+export const setStatementOutputSchema = z.object({ version: z.int().min(1) });
+/**
+ * A ship's statement as discovery shows it, saying who wrote it: its crew's,
+ * with its version, while one is stated; else the note it was commissioned
+ * with; else none.
+ */
+export const discoveredStatementSchema = z
+    .discriminatedUnion('by', [
+    z.object({ by: z.literal('crew'), version: z.int().min(1), summary: z.string(), capabilities: z.array(capabilitySchema) }),
+    z.object({ by: z.literal('commission'), note: z.string() }),
+])
+    .nullable();
+/**
+ * Output of `discover` (messages:send): the ships the caller may send to now,
+ * each with its name, type, kind, status and statement, and each type with
+ * how many of its ships it reaches (decision 0047). Ships, never rules.
+ */
+export const discoverOutputSchema = z.object({
+    ships: z.array(z.object({
+        id: idSchema('ship'),
+        name: z.string(),
+        type: z.string(),
+        kind: shipKindSchema,
+        status: shipStatusSchema,
+        statement: discoveredStatementSchema,
+    })),
+    types: z.array(z.object({ type: z.string(), reachable: z.int().min(1) })),
+});
+//# sourceMappingURL=statement.js.map

package/dist/schemas/statement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement.js","sourceRoot":"","sources":["../../src/schemas/statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AAEH,2GAA2G;AAC3G,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7C,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEjD,0FAA0F;AAC1F,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAElD,MAAM,uBAAuB,GAAG,+EAA+E,CAAC;AAEhH,qFAAqF;AACrF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAExD,sFAAsF;AACtF,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAC;AAEtF,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACxC,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACzC,qFAAqF;IACrF,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE;IAClC,6FAA6F;IAC7F,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAIH,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,SAAkB;IAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC3D,CAAC;AAED,MAAM,sBAAsB,GAAG,0BAA0B,MAAM,CAAC,mBAAmB,CAAC,iCAAiC,CAAC;AAEtH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,GAAG,CAAC,4BAA4B,EAAE,wBAAwB,MAAM,CAAC,4BAA4B,CAAC,aAAa,CAAC;IAC/G,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACxC,CAAC;KACD,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE;IAClI,OAAO,EAAE,wCAAwC;IACjD,IAAI,EAAE,CAAC,cAAc,CAAC;CACvB,CAAC;KACD,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,mBAAmB,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;AAIhH,+FAA+F;AAC/F,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEvD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,kBAAkB,CAAC,IAAI,EAAE;IACxB,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAC1H,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAC5D,CAAC;KACD,QAAQ,EAAE,CAAC;AAId;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,gBAAgB;QACxB,SAAS,EAAE,yBAAyB;KACrC,CAAC,CACH;IACD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAC1E,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeolus-fleet/common",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "description": "Shared schemas and ids for Aeolus packages.",
   "keywords": [
     "aeolus"