@north-light/api 0.3.587 → 0.3.589

package/dist/core/runtime/runner/types.d.ts

@@ -50,6 +50,12 @@ export type RunnerStatus = {
     state: 'unknown';
     error: string;
 };
+export interface RunnerStatusOptions {
+    /** The execution's broker has posted idle (`executions.idle_at`), so its environment may be frozen. A runner whose environment
+     *  thaws or bills on any request must then answer from its control plane alone and send nothing to the workload: the Blaxel runner
+     *  reports `running` for a sandbox that exists and `gone` for one that does not. The process and machine runners ignore it. */
+    idle?: boolean;
+}
 export type RunnerWakeResult = 'signalled' | 'no_broker';
 export interface RunnerStopOptions {
     /** Why: written to `executions.stop_reason` by the caller; carried here for the runner's diagnostics. */
@@ -91,7 +97,7 @@ export interface Runner {
     wake(execution: RunnerExecution): Promise<RunnerWakeResult>;
     /** Stop the execution's broker. Repeating it on a stopped execution confirms. */
     stop(execution: RunnerExecution, options: RunnerStopOptions): Promise<RunnerStopResult>;
-    status(execution: RunnerExecution): Promise<RunnerStatus>;
+    status(execution: RunnerExecution, options?: RunnerStatusOptions): Promise<RunnerStatus>;
     /** Remove everything the runner holds for the node: the run dir (process) or the sandbox (Blaxel). */
     delete(nodeId: string): Promise<void>;
     /** Where a viewer reaches this execution's broker. */

package/dist/core/runtime/view-socket.d.ts

@@ -53,7 +53,8 @@ export interface BrokerViewLink {
     on(event: 'close', listener: (hadError: boolean) => void): this;
 }
 /** A broker's `/view` WebSocket as a {@link BrokerViewLink}. Each broker message is one frame, delivered as one
- *  newline-terminated chunk; each line written is sent as one text message. The headers (the preview token) are
+ *  newline-terminated chunk; each line written is sent as one text message that keeps its newline: the broker reads
+ *  this WebSocket as a byte stream through its line decoder, which completes a frame only at a newline. The headers (the preview token) are
  *  sent on the handshake only and kept nowhere else. */
 export declare function connectWssView(url: string, headers: Record<string, string>): BrokerViewLink;
 /** Resolve true once the broker's `/view` WebSocket accepts a handshake within `waitMs`, retrying while it refuses;

package/dist/core/runtime/view-socket.js

@@ -103,7 +103,8 @@ export async function waitForBrokerViewSocket(nodeId, exited, waitMs = BROKER_FO
 /** The port a sandboxed broker serves `/view` on (bound to `::`; reached only through the private preview and its per-attach token). */
 export const BROKER_VIEW_PORT = 4180;
 /** A broker's `/view` WebSocket as a {@link BrokerViewLink}. Each broker message is one frame, delivered as one
- *  newline-terminated chunk; each line written is sent as one text message. The headers (the preview token) are
+ *  newline-terminated chunk; each line written is sent as one text message that keeps its newline: the broker reads
+ *  this WebSocket as a byte stream through its line decoder, which completes a frame only at a newline. The headers (the preview token) are
  *  sent on the handshake only and kept nowhere else. */
 export function connectWssView(url, headers) {
     return new WssViewLink(url, headers);
@@ -148,7 +149,7 @@ class WssViewLink extends EventEmitter {
     }
     /** Like a view.sock write before connect, a line written while the handshake is in flight is queued and sent on open. */
     write(line) {
-        const message = line.endsWith('\n') ? line.slice(0, -1) : line;
+        const message = line.endsWith('\n') ? line : `${line}\n`;
         if (this.ws.readyState === WebSocket.CONNECTING) {
             this.pending.push(message);
             return true;

package/dist/daemon/reconcilers/node-lifecycle/remote-wake.d.ts

@@ -26,7 +26,8 @@ export declare function imageForWake(environmentId: string): Promise<Environment
  *  a new attempt on the accepted one. `lost` means no broker answered: the execution is ended and the caller starts a new attempt. */
 export declare function wakeResident(execution: Execution): Promise<'woken' | 'lost'>;
 /** A `running` remote execution is live while its runner reports the broker process running, frozen or not. When the runner
- *  reports it gone (or ended non-zero), that exact execution is ended; a runner that cannot tell leaves it as it is. */
+ *  reports it gone (or ended non-zero), that exact execution is ended; a runner that cannot tell leaves it as it is. An idle
+ *  execution is asked without touching its workload (`RunnerStatusOptions.idle`), so a frozen sandbox is not woken by the question. */
 export declare function endRemoteExecutionIfGone(execution: Execution): Promise<boolean>;
 /** The recovery table for a `launching` Blaxel execution found by a claim after its starter is gone. */
 export declare function recoverLaunching(nodeId: string, now: number): Promise<void>;

package/dist/daemon/reconcilers/node-lifecycle/remote-wake.js

@@ -77,9 +77,10 @@ export async function wakeResident(execution) {
     return 'woken';
 }
 /** A `running` remote execution is live while its runner reports the broker process running, frozen or not. When the runner
- *  reports it gone (or ended non-zero), that exact execution is ended; a runner that cannot tell leaves it as it is. */
+ *  reports it gone (or ended non-zero), that exact execution is ended; a runner that cannot tell leaves it as it is. An idle
+ *  execution is asked without touching its workload (`RunnerStatusOptions.idle`), so a frozen sandbox is not woken by the question. */
 export async function endRemoteExecutionIfGone(execution) {
-    const status = await runnerForExecution(execution.runner).status(execution);
+    const status = await runnerForExecution(execution.runner).status(execution, { idle: execution.idleAt !== null });
     if (status.state !== 'gone' && status.state !== 'failed')
         return false;
     const ended = await endExecution(execution.executionId, { reason: 'lost' });

package/package.json

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