@isomorph.ai/app-sdk 1.4.0 → 1.4.1

package/dist/runtime.d.ts

@@ -39,6 +39,8 @@ export declare class Runs {
     private readonly client;
     constructor(client: IsomorphClient);
     private table;
+    /** The cheapest read the runs table answers; rejects while the gateway's data path is down. */
+    ready(): Promise<void>;
     enqueue(job: string, input: unknown, owner: string): Promise<{
         id: string;
     }>;
@@ -86,10 +88,11 @@ export declare class Runtime {
      * `--run-job <name>`: one scheduled run of one job, as a CronJob pod runs it.
      * The run is the scheduler's own (`runScheduled`, the current minute as its
      * tick), so it is loaded, run and recorded exactly as an in-process tick
-     * would have been. False when the app has no such job or the handler threw;
-     * the log names which.
+     * would have been. False when the app has no such job, the gateway's data
+     * path never answered, or the handler threw; the log names which.
      */
     runJobOnce(name: string, now?: Date): Promise<boolean>;
+    private awaitDataPath;
     stop(): Promise<void>;
     private every;
     private refreshToken;

package/dist/runtime.js

@@ -54,6 +54,10 @@ const LEASE_MS = 5 * 60_000;
 const QUEUE_POLL_MS = 2_000;
 const TOKEN_REFRESH_MS = 60_000;
 const DEFAULT_MAX_ATTEMPTS = 3;
+// A CronJob pod may start while the app's database is still waking: --run-job
+// waits this long for the gateway's data path, probing every retry interval.
+const DATA_PATH_WAIT_MS = 90_000;
+const DATA_PATH_RETRY_MS = 3_000;
 /** Every `actions/<name>.ts` and `jobs/<name>.ts` the app carries, by logical name. */
 export async function discover(root) {
     const list = async (dir) => {
@@ -150,6 +154,10 @@ export class Runs {
         this.client = client;
     }
     table() { return this.client.data.from(RUNS_TABLE); }
+    /** The cheapest read the runs table answers; rejects while the gateway's data path is down. */
+    async ready() {
+        await this.table().select('id').limit(1);
+    }
     async enqueue(job, input, owner) {
         const { data } = await this.table().insert({ job, input: input ?? null, status: 'queued', attempt: 0, max_attempts: DEFAULT_MAX_ATTEMPTS, progress: 0, owner_subject: owner, cancel_requested: false }).select('id').single();
         return { id: data.id };
@@ -232,8 +240,8 @@ export class Runtime {
      * `--run-job <name>`: one scheduled run of one job, as a CronJob pod runs it.
      * The run is the scheduler's own (`runScheduled`, the current minute as its
      * tick), so it is loaded, run and recorded exactly as an in-process tick
-     * would have been. False when the app has no such job or the handler threw;
-     * the log names which.
+     * would have been. False when the app has no such job, the gateway's data
+     * path never answered, or the handler threw; the log names which.
      */
     async runJobOnce(name, now = new Date()) {
         this.inventory = await discover(this.options.root);
@@ -242,8 +250,32 @@ export class Runtime {
             this.log(`this app has no ${JOBS_DIR}/${name}.ts`);
             return false;
         }
+        if (this.options.gatewayUrl && !(await this.awaitDataPath()))
+            return false;
         return this.runScheduled(name, new Date(Math.floor(now.getTime() / 60_000) * 60_000));
     }
+    // The pod is scheduled by the cluster clock, not by the app's readiness: its
+    // database may be paused or waking (plan §5.3) and the gateway answers 5xx
+    // until it is up. The handler runs once the cheapest read answers; when it
+    // never does within the wait, the run fails with one line naming the last error.
+    async awaitDataPath() {
+        const deadline = Date.now() + DATA_PATH_WAIT_MS;
+        for (;;) {
+            try {
+                await this.runs.ready();
+                return true;
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                if (Date.now() + DATA_PATH_RETRY_MS > deadline) {
+                    this.log(`the data path did not answer within ${DATA_PATH_WAIT_MS / 1000} s: ${reason}`);
+                    return false;
+                }
+                this.log(`waiting for the data path: ${reason}`);
+                await new Promise((wake) => setTimeout(wake, DATA_PATH_RETRY_MS));
+            }
+        }
+    }
     async stop() {
         this.stopped = true;
         for (const timer of this.timers)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isomorph.ai/app-sdk",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "type": "module",
   "repository": {
     "type": "git",