@north-light/api 0.3.576 → 0.3.577

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.39";
 /** 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.39';
 /** 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/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.577",
   "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",