@north-light/api 0.3.577 → 0.3.579

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/dist/shared/env.d.ts

@@ -11,6 +11,11 @@ export declare function launchSnapshotFile(dir: string): string | undefined;
 export declare function sandboxCliNodeId(): string | undefined;
 /** A Linux app command uses its mounted launch snapshot, not host user stores. */
 export declare function isSandboxedNode(): boolean;
+/** True when this CLI reaches `/v1` through its broker's CLI relay to a remote control plane: the broker exports `CRTR_API_URL` (an
+ *  http(s) URL, the fleet launcher's) and `CRTR_API_SOCKET` (the relay it serves). It chooses only where this process gets provider command
+ *  descriptions (`GET /v1/providers/tools` through that relay); the relay's node token stays the authority. It is not `isSandboxedNode()`,
+ *  which gates owner-only commands and launch-snapshot reads on a Linux launcher mount. */
+export declare function providerProjectionOverBrokerRelay(): boolean;
 /** The app that owns the current node, supplied in its broker launch identity. */
 export declare function envGrantee(): string | undefined;
 /** Set to '1' by `nodeEnv` for an app-started run's brokers, which admit inbox

package/dist/shared/env.js

@@ -64,6 +64,13 @@ export function sandboxCliNodeId() {
 export function isSandboxedNode() {
     return sandboxCliNodeId() !== undefined;
 }
+/** True when this CLI reaches `/v1` through its broker's CLI relay to a remote control plane: the broker exports `CRTR_API_URL` (an
+ *  http(s) URL, the fleet launcher's) and `CRTR_API_SOCKET` (the relay it serves). It chooses only where this process gets provider command
+ *  descriptions (`GET /v1/providers/tools` through that relay); the relay's node token stays the authority. It is not `isSandboxedNode()`,
+ *  which gates owner-only commands and launch-snapshot reads on a Linux launcher mount. */
+export function providerProjectionOverBrokerRelay() {
+    return /^https?:\/\//.test(process.env['CRTR_API_URL'] ?? '') && (process.env['CRTR_API_SOCKET'] ?? '') !== '';
+}
 /** The app that owns the current node, supplied in its broker launch identity. */
 export function envGrantee() {
     return process.env['CRTR_GRANTEE'];

package/package.json

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