@north-light/api 0.3.576 → 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.38";
+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.38';
+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/core/io.js

@@ -360,7 +360,7 @@ export function apiErrorToCliError(err, next, options = {}) {
                     ? `Wait ${provider.retryAfterS}s, then retry; do not retry sooner.`
                     : err.status >= 500
                         ? 'This is a crtr bug, not a bad call. Retry; if it persists, report it (the daemon log holds the full cause).'
-                        : err.status === 404
+                        : err.status === 404 && provider.code === undefined
                             ? 'List nodes with `crtr node inspect list`.'
                             : 'Inspect the error and adjust the call. See -h for the schema.'),
         };

package/dist/core/runtime/broker/daemon-ops.d.ts

@@ -44,6 +44,10 @@ export declare function acknowledgeBrokerMail(nodeId: string, deliveries: MailRe
 export declare function recordBrokerTurn(nodeId: string, request: Omit<BrokerTurnRequest, 'expected_execution_id'>): Promise<BrokerTurnResultDTO>;
 export declare function mutateBrokerProviderRetry(nodeId: string, request: Omit<BrokerProviderRetryRequest, 'expected_execution_id'>): Promise<BrokerProviderRetryResultDTO>;
 export declare function mutateBrokerFault(nodeId: string, request: Omit<BrokerFaultRequest, 'expected_execution_id'>): Promise<BrokerFaultResultDTO>;
+/** A conversation store that refused writes past its deadline: the node's durable fault, written (execution-fenced) before the broker
+ *  exits so the control plane and a harness read the cause. The record is capped at 5 s: a failed or slow record is logged and the
+ *  exit proceeds. */
+export declare function recordConversationWriteFault(nodeId: string, error: unknown): Promise<void>;
 export declare function brokerRecovery(nodeId: string): Promise<RecoveryStateDTO>;
 /** Node-scoped fault writes are for non-broker clients such as attach transport.
  * Broker-owned recovery mutations use the execution-fenced wrappers above. */

package/dist/core/runtime/broker/daemon-ops.js

@@ -7,6 +7,7 @@ import { localClient } from '../../../api/node-transport.js';
 import { ApiError } from '../../../api/errors.js';
 import { envExecutionId } from '../../../shared/env.js';
 import { brokerSignalClient } from './signal-stream.js';
+import { emitEvent } from '../../events/emit.js';
 import { cachedBrokerNodeFields } from '../../../daemon/broker-signals/bus.js';
 import { fetchRunAttachments } from './attachments-fetch.js';
 import { reportRefNodeId } from '../../../shared/inbox-entry-body.js';
@@ -153,6 +154,17 @@ export function mutateBrokerProviderRetry(nodeId, request) {
 export function mutateBrokerFault(nodeId, request) {
     return daemonClient().mutateBrokerFault(nodeId, { ...request, expected_execution_id: brokerExecutionId() });
 }
+/** A conversation store that refused writes past its deadline: the node's durable fault, written (execution-fenced) before the broker
+ *  exits so the control plane and a harness read the cause. The record is capped at 5 s: a failed or slow record is logged and the
+ *  exit proceeds. */
+export async function recordConversationWriteFault(nodeId, error) {
+    const record = mutateBrokerFault(nodeId, {
+        op: 'record',
+        input: { link: 'daemon→node', op: 'conversation_write_failed', kind: 'other', retry: { disposition: 'manual' }, message: error instanceof Error ? error.message : String(error) },
+    });
+    await Promise.race([record, new Promise((_, reject) => setTimeout(() => reject(new Error('conversation_write_failed fault record timed out')), 5_000).unref())])
+        .catch((faultError) => emitEvent({ level: 'error', event: 'broker.daemon.operation.failed', node_id: nodeId, error: faultError, fields: { operation: 'conversation_write_fault_record' } }));
+}
 export function brokerRecovery(nodeId) {
     return daemonClient().getBrokerRecovery(nodeId, brokerExecutionId());
 }

package/package.json

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