@north-light/api 0.3.511 → 0.3.513

package/dist/api/client.d.ts

@@ -1,6 +1,6 @@
 import { ApiError } from './errors.js';
 import type { AppLimitsChangeDTO, LimitsDTO, SetAppLimitsRequest } from './dto/limits.js';
-import type { DaemonAdmitDTO, DaemonRestartDTO, DueDTO, HealthDTO, MigrateStateDTO, MigrateStateRequest, StatusDTO } from './dto/health.js';
+import type { DaemonAdmitDTO, DaemonRestartDTO, DueDTO, HealthDTO, ReadyDTO, MigrateStateDTO, MigrateStateRequest, StatusDTO } from './dto/health.js';
 import type { BashJobStatusDTO, BashJobStopResultDTO } from './dto/bash-jobs.js';
 import type { ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSubjectDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
 import type { NodeOutcomeResponseDTO, OutcomeDeliveryDTO, RegisterOutcomeDeliveryRequest } from './dto/node-outcomes.js';
@@ -123,6 +123,8 @@ export declare class CrtrClient {
     /** One `/healthz` observation without cold-socket recovery. Availability
      * waiters own retry policy and pass their remaining wall-clock budget here. */
     probeHealthz(timeoutMs: number): Promise<HealthDTO>;
+    /** `GET /v1/ready`: 200 ready, 503 not yet; both answer a `ReadyDTO`. */
+    ready(): Promise<ReadyDTO>;
     status(): Promise<StatusDTO>;
     /** Busy and next-due state, the truth behind sandbox sleep and wake. */
     due(): Promise<DueDTO>;

package/dist/api/client.js

@@ -107,6 +107,19 @@ export class CrtrClient {
         }
         return parse(response);
     }
+    /** `GET /v1/ready`: 200 ready, 503 not yet; both answer a `ReadyDTO`. */
+    async ready() {
+        const response = await this.transport('GET', routes.ready(), undefined, {});
+        if (response.status === 503) {
+            try {
+                const body = await response.clone().json();
+                if (body.ready === false)
+                    return body;
+            }
+            catch { /* `parse` reports a malformed 503 normally */ }
+        }
+        return parse(response);
+    }
     status() {
         return this.request('GET', routes.status());
     }

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.21";
+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.21';
+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/health.d.ts

@@ -13,6 +13,14 @@ export interface HealthDTO {
     /** Always present; only `ready` admits normal daemon work. */
     startup_phase: StartupPhaseDTO;
 }
+/** `GET /v1/ready` — whether this listener can admit ordinary work (200) or not (503, with `reason`). Reveals nothing else. */
+export type ReadyDTO = {
+    ready: true;
+} | {
+    ready: false;
+    reason: 'startup_pending' | 'jwks_pending' | 'grant_snapshot_missing';
+    message: string;
+};
 /** `GET /v1/status` — daemon status snapshot. Backs `crtr sys daemon status`
  *  state and the `crtr canvas dashboard` header. `runtime_version` is also
  *  checked by Core's minimum-runtime capability gate. */

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/api/routes.d.ts

@@ -3,6 +3,7 @@ export declare const API_VERSION = "v1";
 /** Route path builders. Keys mirror the spec §6 route table. */
 export declare const routes: {
     readonly healthz: () => string;
+    readonly ready: () => string;
     readonly status: () => string;
     readonly due: () => string;
     readonly daemonRestart: () => string;

package/dist/api/routes.js

@@ -17,6 +17,7 @@ const V = `/${API_VERSION}`;
 export const routes = {
     // Health / status
     healthz: () => '/healthz',
+    ready: () => `${V}/ready`,
     status: () => `${V}/status`,
     due: () => `${V}/due`,
     daemonRestart: () => `${V}/daemon/restart`,

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.511",
+  "version": "0.3.513",
   "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",