@north-light/api 0.3.577 → 0.3.578

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.39";
+export declare const CONTRACT_LEVEL = "1.40";
 /** 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.39';
+export const CONTRACT_LEVEL = '1.40';
 /** 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/run-events.d.ts

@@ -32,10 +32,13 @@ export type RunActivityDTO = {
     };
 };
 /** Why a turn ended in error: `content_refused` when the vendor refused the
- *  model call on safety grounds, `model_error` for any other failed call. */
+ *  model call on safety grounds, `rate_limited` when every model route is
+ *  rate-limited for longer than a turn waits, `model_error` for any other failed call. */
 export interface TurnErrorDTO {
-    code: 'content_refused' | 'model_error';
+    code: 'content_refused' | 'model_error' | 'rate_limited';
     message: string;
+    /** ISO time the rate limit is expected to lift; present only when `code` is `rate_limited`. */
+    retry_at?: string;
 }
 /** The broker's stop reason for one assistant message, unchanged. */
 export type AssistantStopReasonDTO = 'stop' | 'toolUse' | 'length' | 'error' | 'aborted';
@@ -111,7 +114,10 @@ export interface NodeMessageAcceptedEvent extends RunEventBaseDTO {
 }
 export interface NodeTurnStartedEvent extends RunEventBaseDTO {
     type: 'node.turn.started';
-    /** `message_ids`: the accepted `run.message` messages this turn delivers (empty for the prompt, an answer, or a child's report). */
+    /**
+     * `message_ids`: the accepted `run.message` messages this turn delivers (empty for the prompt, an answer, or a child's report).
+     * A turn can emit more than one `node.turn.started`: each time a steered `run.message` joins the open turn at the agent's next step, another one arrives with that message's `message_ids` and its own `entry_id`. A single `node.turn.completed` ends the turn and carries every joined id.
+     */
     input: {
         text: string;
         message_ids: string[];
@@ -156,7 +162,7 @@ export interface NodeToolCallCompletedEvent extends RunEventBaseDTO, Redactable
 }
 export interface NodeTurnCompletedEvent extends RunEventBaseDTO {
     type: 'node.turn.completed';
-    /** The same as the turn's `node.turn.started` `input.message_ids`. */
+    /** Every `input.message_ids` of the turn's `node.turn.started` events, in order (more than one when messages joined the turn). */
     message_ids: string[];
     /** The run's `run.get` status when the turn ended. */
     run_status: Exclude<RunStatusDTO, 'settled'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.577",
+  "version": "0.3.578",
   "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",