@holokai/neuron-sdk 0.4.0 → 0.5.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { J as JsonSchema, C as Capability, a as CapabilityHandleOptions, S as ServerToNeuronFrame, N as NeuronLogger, T as Transport, A as AuthCallback, H as Handler, b as CapabilityRegistration, c as TransportCallbacks, d as ClientFrame, P as PostPath } from './transport-Cs5tY2IO.mjs';
-export { e as HandlerContext, f as HeartbeatInFlightEntry, L as LeasePayload, g as TaskPayload } from './transport-Cs5tY2IO.mjs';
+import { J as JsonSchema, C as Capability, a as CapabilityHandleOptions, S as ServerToNeuronFrame, N as NeuronLogger, T as Transport, A as AuthCallback, H as Handler, b as CapabilityRegistration, c as TransportCallbacks, d as ClientFrame, P as PostPath } from './transport-Ckcwj-Do.mjs';
+export { e as HandlerContext, f as HeartbeatInFlightEntry, L as LeasePayload, g as TaskPayload } from './transport-Ckcwj-Do.mjs';
 import { EventEmitter } from 'eventemitter3';
 import { z } from 'zod';
 import { ErrorObject } from 'ajv';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { J as JsonSchema, C as Capability, a as CapabilityHandleOptions, S as ServerToNeuronFrame, N as NeuronLogger, T as Transport, A as AuthCallback, H as Handler, b as CapabilityRegistration, c as TransportCallbacks, d as ClientFrame, P as PostPath } from './transport-Cs5tY2IO.js';
-export { e as HandlerContext, f as HeartbeatInFlightEntry, L as LeasePayload, g as TaskPayload } from './transport-Cs5tY2IO.js';
+import { J as JsonSchema, C as Capability, a as CapabilityHandleOptions, S as ServerToNeuronFrame, N as NeuronLogger, T as Transport, A as AuthCallback, H as Handler, b as CapabilityRegistration, c as TransportCallbacks, d as ClientFrame, P as PostPath } from './transport-Ckcwj-Do.js';
+export { e as HandlerContext, f as HeartbeatInFlightEntry, L as LeasePayload, g as TaskPayload } from './transport-Ckcwj-Do.js';
 import { EventEmitter } from 'eventemitter3';
 import { z } from 'zod';
 import { ErrorObject } from 'ajv';

package/dist/index.js

@@ -558,6 +558,7 @@ var TerminalFailure = class extends Error {
     this.name = "TerminalFailure";
   }
 };
+var DEFAULT_PROGRESS_TIMEOUT_MS = 5e3;
 function validateInput(zod, validator, jsonSchema, data) {
   if (zod) {
     const result = zod.safeParse(data);
@@ -580,7 +581,8 @@ async function runLease(opts) {
     transport,
     validator,
     logger,
-    signal
+    signal,
+    progressTimeoutMs = DEFAULT_PROGRESS_TIMEOUT_MS
   } = opts;
   const inputCheck = validateInput(zodInput, validator, inputSchema, lease.task.input);
   if (!inputCheck.ok) {
@@ -595,13 +597,13 @@ async function runLease(opts) {
     return;
   }
   const parsedInput = inputCheck.value;
-  const progressFn = makeProgressFn(transport, lease.leaseId, logger);
+  const reporter = makeProgressReporter(transport, lease.leaseId, logger, signal, progressTimeoutMs);
   const ctx = {
     task: lease.task,
     leaseId: lease.leaseId,
     signal,
     log: scopedLogger(logger, lease),
-    progress: progressFn,
+    progress: reporter.progress,
     fail: (reason, opts2) => {
       throw new TerminalFailure(reason, opts2?.code);
     }
@@ -610,7 +612,9 @@ async function runLease(opts) {
   try {
     output = await handler(parsedInput, ctx);
   } catch (err) {
-    if (signal.aborted || err.name === "AbortError") {
+    const cancelled = signal.aborted || err.name === "AbortError";
+    if (!cancelled) await reporter.drained();
+    if (cancelled) {
       await sendNack(
         transport,
         lease.leaseId,
@@ -644,6 +648,7 @@ async function runLease(opts) {
     );
     return;
   }
+  await reporter.drained();
   const outputCheck = validateInput(zodOutput, validator, outputSchema, output);
   if (!outputCheck.ok) {
     await sendNack(
@@ -685,20 +690,37 @@ async function sendNack(transport, leaseId, kind, reason, extras = {}, logger) {
     );
   });
 }
-function makeProgressFn(transport, leaseId, logger) {
-  return (update) => {
-    void transport.post(POST_PATH.progress, {
-      type: "progress",
-      leaseId,
-      percent: update.percent,
-      message: update.message,
-      data: update.data,
-      sentAt: (/* @__PURE__ */ new Date()).toISOString()
-    }).catch((err) => {
-      logger.warn({ err, leaseId }, "progress POST failed; continuing");
-    });
+function makeProgressReporter(transport, leaseId, logger, signal, timeoutMs) {
+  let tail = Promise.resolve();
+  return {
+    progress: (update) => {
+      const frame = {
+        type: "progress",
+        leaseId,
+        percent: update.percent,
+        message: update.message,
+        data: update.data,
+        sentAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      tail = tail.then(async () => {
+        if (signal.aborted) return;
+        try {
+          await withTimeout(transport.post(POST_PATH.progress, frame), timeoutMs);
+        } catch (err) {
+          logger.warn({ err, leaseId }, "progress POST failed; continuing");
+        }
+      });
+    },
+    drained: () => tail
   };
 }
+function withTimeout(work, ms) {
+  let timer;
+  const timeout = new Promise((_resolve, reject) => {
+    timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
+  });
+  return Promise.race([work, timeout]).finally(() => clearTimeout(timer));
+}
 function scopedLogger(logger, lease) {
   const scope = { leaseId: lease.leaseId, taskId: lease.task.taskId };
   return {