@north-light/api 0.3.512 → 0.3.514

package/dist/api/command-manifest/object-kinds.js

@@ -8,7 +8,7 @@ export const MAX_KIND_EVENTS = 64;
 export const MIN_EVENT_LEVEL = 1;
 export const MAX_EVENT_LEVEL = 10;
 const KIND_KEYS = new Set(['description', 'events', 'read']);
-const EVENT_KEYS = new Set(['level', 'supersedes']);
+const EVENT_KEYS = new Set(['level', 'supersedes', 'ends_wait']);
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -25,7 +25,7 @@ export function eventCatalogReasons(events, where) {
         if (!LOCAL.test(local))
             reasons.push(`${at} is not a valid event name`);
         if (!isRecord(spec)) {
-            reasons.push(`${at} must be an object { level, supersedes? }`);
+            reasons.push(`${at} must be an object { level, supersedes?, ends_wait? }`);
             continue;
         }
         for (const key of Object.keys(spec))
@@ -36,6 +36,8 @@ export function eventCatalogReasons(events, where) {
             reasons.push(`${at} level must be an integer ${MIN_EVENT_LEVEL}-${MAX_EVENT_LEVEL}`);
         if (spec['supersedes'] !== undefined && typeof spec['supersedes'] !== 'boolean')
             reasons.push(`${at} supersedes must be a boolean`);
+        if (spec['ends_wait'] !== undefined && typeof spec['ends_wait'] !== 'boolean')
+            reasons.push(`${at} ends_wait must be a boolean`);
     }
     return reasons;
 }

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.22";
+export declare const CONTRACT_LEVEL = "1.23";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -12,7 +12,7 @@
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export const CONTRACT_LEVEL = '1.22';
+export const CONTRACT_LEVEL = '1.23';
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export const REQUIRED_CONTRACT_HEADER = 'Crouter-Required-Contract';
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/dto/canvas.d.ts

@@ -276,6 +276,18 @@ export interface RosterDTO {
     generated_at: IsoTime;
     nodes: RosterNodeDTO[];
     edges: RosterEdgeDTO[];
+    /** Every live wait a node holds on a watched canvas object (a workflow run until it completes), oldest
+     *  first per node. The attach viewer lists this node's below the editor beside its child and cron rows. */
+    object_waits?: RosterObjectWaitDTO[];
+}
+/** One node's live wait on a watched object: the object's kind (`github.run`) and name identify it to a
+ *  person; `crtr canvas read <object_id>` reads it. */
+export interface RosterObjectWaitDTO {
+    node_id: NodeIdDTO;
+    object_id: string;
+    object_type: string;
+    object_name: string;
+    created: IsoTime;
 }
 /** Browse's initial frame needs the dashboard fields and topology, not the full
  * node detail/list projection. Transported as gzip JSON (application/gzip) over

package/dist/api/dto/custom-objects.d.ts

@@ -2,6 +2,7 @@ import type { PrivacyName } from './objects.js';
 export interface CustomEventSpecDTO {
     level: number;
     supersedes?: boolean;
+    ends_wait?: boolean;
 }
 export type CustomReceiverDTO = 'queue' | {
     url: string;

package/dist/api/dto/objects.d.ts

@@ -13,6 +13,7 @@ export interface ObjectKindDeclDTO {
     events: Record<string, {
         level: number;
         supersedes?: boolean;
+        ends_wait?: boolean;
     }>;
     owner: {
         id: string;

package/dist/types.d.ts

@@ -66,6 +66,7 @@ export interface ObjectKindDeclaration {
     events: Record<string, {
         level: number;
         supersedes?: boolean;
+        ends_wait?: boolean;
     }>;
     /** A leaf path of the plugin's own commands, run to render an instance as markdown. */
     read?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.512",
+  "version": "0.3.514",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",