@north-light/api 0.3.570 → 0.3.572

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.36";
+export declare const CONTRACT_LEVEL = "1.37";
 /** 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.36';
+export const CONTRACT_LEVEL = '1.37';
 /** 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/broker-ops.d.ts

@@ -27,6 +27,9 @@ export interface BrokerExecutionRequest {
 export interface BrokerSettleRequest extends BrokerExecutionRequest {
     stopReason: string;
     pushedFinal: boolean;
+    /** Set only by the broker once it has recorded the settled turn's fatal provider fault and armed no retry or model fallback:
+     *  the daemon may then idle a resident Blaxel broker. A settle without it never idles on an error. */
+    faultSettled?: boolean;
 }
 /** `POST /v1/nodes/{id}/broker/telemetry` body. Tokens are cumulative within
  * the broker's current Pi session; null context/activity values preserve the

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

@@ -48,6 +48,13 @@ export interface ExecutionExitDiagnosticDTO {
         routes: string[];
     };
 }
+/** The diagnostic the daemon itself writes when a launch fails before the broker reports; it never crosses `/v1` as a request. */
+export interface ExecutionLaunchFailureDiagnostic {
+    schema: 'crtr.execution-exit-diagnostic/v1';
+    launch_failure: {
+        message: string;
+    };
+}
 export interface BrokerTurnResultDTO {
     applied: boolean;
     fault_link: FaultLink | null;

package/dist/api/errors.d.ts

@@ -43,5 +43,8 @@ export { APIError as ApiError };
 /** A local API transport failure has stable status/code identity, independent
  * of message prose. */
 export declare function isDaemonTransportApiError(error: unknown): error is APIError;
+/** The daemon refused the caller's node token. A teardown revokes the broker's token before its process stops, so a broker
+ *  that sees this on a poll is being shut down, not hitting a corrupt state. */
+export declare function isTokenRevokedApiError(error: unknown): error is APIError;
 /** Type guard for an `ErrorBody`-shaped parsed payload. */
 export declare function isErrorBody(value: unknown): value is ErrorBody;

package/dist/api/errors.js

@@ -54,6 +54,11 @@ export function isDaemonTransportApiError(error) {
         || error.code === 'daemon_request_interrupted')) || (error.status === 504 && (error.code === 'request_timeout' || error.code === 'deadline_exceeded'))
         || (error.status >= 500 && error.code === 'daemon_health_unavailable');
 }
+/** The daemon refused the caller's node token. A teardown revokes the broker's token before its process stops, so a broker
+ *  that sees this on a poll is being shut down, not hitting a corrupt state. */
+export function isTokenRevokedApiError(error) {
+    return error instanceof APIError && error.status === 401;
+}
 /** Type guard for an `ErrorBody`-shaped parsed payload. */
 export function isErrorBody(value) {
     if (typeof value !== 'object' || value === null)

package/package.json

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