@aeolus-fleet/common 0.33.0 → 0.35.0

package/dist/rules/index.d.ts

@@ -4,6 +4,8 @@
  * no schema. Common's schemas are built on the same rules, and the server
  * stays the authority on submit.
  */
+export * from './activity.js';
+export * from './alert.js';
 export * from './duration.js';
 export * from './label-handle.js';
 export * from './page-size.js';

package/dist/rules/index.js

@@ -4,6 +4,8 @@
  * no schema. Common's schemas are built on the same rules, and the server
  * stays the authority on submit.
  */
+export * from './activity.js';
+export * from './alert.js';
 export * from './duration.js';
 export * from './label-handle.js';
 export * from './page-size.js';

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,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/rules/payload.d.ts

@@ -1,5 +1,5 @@
 /**
- * A payload is at most 64 KB (ADR 0006): a message carries a reference and an
+ * A payload is at most 256 KB (decision 0006): a message carries a reference and an
  * instruction, not the content itself.
  */
 export declare const PAYLOAD_MAX_BYTES: number;

package/dist/rules/payload.js

@@ -1,8 +1,8 @@
 /**
- * A payload is at most 64 KB (ADR 0006): a message carries a reference and an
+ * A payload is at most 256 KB (decision 0006): a message carries a reference and an
  * instruction, not the content itself.
  */
-export const PAYLOAD_MAX_BYTES = 64 * 1024;
+export const PAYLOAD_MAX_BYTES = 256 * 1024;
 const utf8 = new TextEncoder();
 /**
  * The size of a payload serialized: the bytes of its text in UTF-8, as the

package/dist/rules/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/rules/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;AACzC,CAAC"}
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/rules/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE5C,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;AACzC,CAAC"}

package/dist/schemas/activity.d.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+/**
+ * The kind of a session's latest event as its trierarch observes it
+ * (headless design, H14): text, a tool call, a tool result or an error. No
+ * content: the fleet holds none of a transcript.
+ */
+export declare const ACTIVITY_KINDS: readonly ["text", "tool", "result", "error"];
+export declare const activityKindSchema: z.ZodEnum<{
+    error: "error";
+    text: "text";
+    tool: "tool";
+    result: "result";
+}>;
+export type ActivityKind = z.infer<typeof activityKindSchema>;
+/** The longest a tool call's tool name may be. */
+export declare const ACTIVITY_TOOL_MAX_LENGTH = 100;
+/** The most ships one `fleet.reportActivity` writes. */
+export declare const ACTIVITY_SHIPS_MAX = 100;
+/** The longest report interval a trierarch may state, in seconds: a day. */
+export declare const ACTIVITY_INTERVAL_MAX_SECONDS: number;
+/**
+ * Input of `fleet.reportActivity` (crew:run): the report interval the
+ * trierarch writes at, in seconds, and per crewed ship it runs its session's
+ * latest event: when, its kind, and for a tool call the tool's name
+ * (docs/design/monitoring, 4.3).
+ */
+export declare const reportActivityInputSchema: z.ZodObject<{
+    intervalSeconds: z.ZodInt;
+    activities: z.ZodArray<z.ZodObject<{
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        at: z.ZodISODateTime;
+        kind: z.ZodEnum<{
+            error: "error";
+            text: "text";
+            tool: "tool";
+            result: "result";
+        }>;
+        tool: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReportActivityInput = z.infer<typeof reportActivityInputSchema>;
+/**
+ * Output of `fleet.reportActivity`: the entries refused, each with its ship,
+ * the refusal's code and message; every other entry was taken.
+ */
+export declare const reportActivityOutputSchema: z.ZodObject<{
+    refused: z.ZodArray<z.ZodObject<{
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReportActivityOutput = z.infer<typeof reportActivityOutputSchema>;
+/**
+ * A crewed ship's activity as the fleet shows it (ISO 8601 in UTC): its
+ * session's latest event, when its trierarch wrote it and the report interval
+ * it stated, so a reader tells when it reads unknown (`isActivityUnknown`).
+ */
+export declare const listedActivitySchema: z.ZodObject<{
+    at: z.ZodISODateTime;
+    kind: z.ZodEnum<{
+        error: "error";
+        text: "text";
+        tool: "tool";
+        result: "result";
+    }>;
+    tool: z.ZodNullable<z.ZodString>;
+    reportedAt: z.ZodISODateTime;
+    intervalSeconds: z.ZodInt;
+}, z.core.$strip>;
+export type ListedActivity = z.infer<typeof listedActivitySchema>;

package/dist/schemas/activity.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { idSchema } from '../ids/index.js';
+/**
+ * The kind of a session's latest event as its trierarch observes it
+ * (headless design, H14): text, a tool call, a tool result or an error. No
+ * content: the fleet holds none of a transcript.
+ */
+export const ACTIVITY_KINDS = ['text', 'tool', 'result', 'error'];
+export const activityKindSchema = z.enum(ACTIVITY_KINDS);
+/** The longest a tool call's tool name may be. */
+export const ACTIVITY_TOOL_MAX_LENGTH = 100;
+/** The most ships one `fleet.reportActivity` writes. */
+export const ACTIVITY_SHIPS_MAX = 100;
+/** The longest report interval a trierarch may state, in seconds: a day. */
+export const ACTIVITY_INTERVAL_MAX_SECONDS = 24 * 60 * 60;
+/**
+ * Input of `fleet.reportActivity` (crew:run): the report interval the
+ * trierarch writes at, in seconds, and per crewed ship it runs its session's
+ * latest event: when, its kind, and for a tool call the tool's name
+ * (docs/design/monitoring, 4.3).
+ */
+export const reportActivityInputSchema = z.object({
+    intervalSeconds: z.int().min(1).max(ACTIVITY_INTERVAL_MAX_SECONDS),
+    activities: z
+        .array(z.object({
+        shipId: idSchema('ship'),
+        at: z.iso.datetime(),
+        kind: activityKindSchema,
+        tool: z.string().trim().min(1).max(ACTIVITY_TOOL_MAX_LENGTH).optional(),
+    }))
+        .min(1)
+        .max(ACTIVITY_SHIPS_MAX),
+});
+/**
+ * Output of `fleet.reportActivity`: the entries refused, each with its ship,
+ * the refusal's code and message; every other entry was taken.
+ */
+export const reportActivityOutputSchema = z.object({
+    refused: z.array(z.object({ shipId: idSchema('ship'), code: z.string(), message: z.string() })),
+});
+/**
+ * A crewed ship's activity as the fleet shows it (ISO 8601 in UTC): its
+ * session's latest event, when its trierarch wrote it and the report interval
+ * it stated, so a reader tells when it reads unknown (`isActivityUnknown`).
+ */
+export const listedActivitySchema = z.object({
+    at: z.iso.datetime(),
+    kind: activityKindSchema,
+    tool: z.string().nullable(),
+    reportedAt: z.iso.datetime(),
+    intervalSeconds: z.int().min(1),
+});
+//# sourceMappingURL=activity.js.map

package/dist/schemas/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/schemas/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAGzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAClE,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QACxB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;QACpB,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;KACxE,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,kBAAkB,CAAC;CAC3B,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAChG,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IACpB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAChC,CAAC,CAAC"}