@rackbops/ac-plugin-contract 2.0.0-alpha.41 → 2.0.0-alpha.42

package/AUTHORING.md

@@ -119,8 +119,10 @@ Rules the host enforces, at validation or load time:
   doesn't (the schema itself requires only `id`, `hostApiVersion` and `kind`). `contributes` and every sub-field
   is optional in the schema — contribute only the points you use; each contribution's own required fields are
   schema-enforced.
-- **Jobs** (#137): a job's **`timeoutSec`** must be at least `1` (the schema's `minimum`; a zero or negative
-  timeout would fire at once and time out any run that awaits real I/O), and a job **`id`** must be unique
+- **Jobs** (#137, #580): a job's **`timeoutSec`** must be at least `1` and at most `2147483` (the schema's
+  `minimum` and `maximum`; a zero or negative timeout would fire at once and time out any run that awaits real
+  I/O, and about 24.8 days is the longest delay Node honours, so a longer or non-finite one would be fired at
+  once too), and a job **`id`** must be unique
   *within its plugin* -- two jobs with
   one id are rejected as `duplicate job id "<id>" within the plugin`, like a duplicate panel, card or action id.
   Job ids are plugin-scoped (a job is addressed as `<pluginId>/<jobId>`), so two different plugins may declare the
@@ -197,7 +199,7 @@ export const createPlugin: CreatePlugin = (host) => ({
   newest 200 runs of that job (per machine, for a `runOn: "agent"` job) and drops runs older than 30 days,
   though never a job's (or machine's) newest run, so `host.jobs.lastRun` still answers for a job that runs
   less often than monthly. A job that runs every minute therefore no longer grows the run history without
-  bound. `ctx.signal` aborts at `timeoutSec` seconds (at least 1, #137). `runOn: "host"` runs your `runJob`
+  bound. `ctx.signal` aborts at `timeoutSec` seconds (1 to 2147483, #137, #580). `runOn: "host"` runs your `runJob`
   once, in the host process.
   `runOn: "agent"` (#51) also runs your `runJob` in the host process — the agent itself runs no plugin
   code — but once per currently paired machine, with `ctx.machine` set to `{ id, name }`; do the

package/dist/manifest.d.ts

@@ -112,8 +112,11 @@ export interface JobContribution {
     schedule: string;
     /**
      * Per-run timeout in seconds. Must be at least 1: a zero or negative value would fire the timeout at
-     * once, timing out any run that awaits real I/O (#137).
+     * once, timing out any run that awaits real I/O (#137). And at most 2147483, about 24.8 days: Node
+     * clamps a longer or non-finite `setTimeout` delay to 1 ms, which fires it at once, the same failure
+     * (#580).
      * @minimum 1
+     * @maximum 2147483
      */
     timeoutSec: number;
     runOn: JobRunOn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rackbops/ac-plugin-contract",
-  "version": "2.0.0-alpha.41",
+  "version": "2.0.0-alpha.42",
   "private": false,
   "type": "module",
   "description": "The artifact-console plugin ABI for out-of-repo plugin authors: HostApi, the acPlugin manifest contribution points, the generated manifest JSON Schema, and the @ac/host ambient browser declaration.",
@@ -35,9 +35,9 @@
   },
   "devDependencies": {
     "@ac/contract": "0.0.0",
-    "@types/node": "^26.0.0",
+    "@types/node": "^26.6.3",
     "typescript": "^7.0.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.2"
   },
   "scripts": {
     "build": "node build.mjs",

package/schema.json

@@ -348,8 +348,9 @@
         },
         "timeoutSec": {
           "type": "number",
-          "description": "Per-run timeout in seconds. Must be at least 1: a zero or negative value would fire the timeout at once, timing out any run that awaits real I/O (#137).",
-          "minimum": 1
+          "description": "Per-run timeout in seconds. Must be at least 1: a zero or negative value would fire the timeout at once, timing out any run that awaits real I/O (#137). And at most 2147483, about 24.8 days: Node clamps a longer or non-finite `setTimeout` delay to 1 ms, which fires it at once, the same failure (#580).",
+          "minimum": 1,
+          "maximum": 2147483
         },
         "runOn": {
           "$ref": "#/definitions/JobRunOn"