@dashai/cli 0.31.0 → 0.32.0

package/dist/bin.js

@@ -548,7 +548,7 @@ async function introspectWorkspaceTable(_installationId, tableNameOrId, options
     const message = `"${ref}" is not a numeric table id. Pass the workspace table's numeric id (find it in the Dashwise UI URL, or via \`GET /api/tables/application/:applicationId\`). Resolving a table by name is not yet supported by this command.`;
     throw new ApiError(0, { code: "NON_NUMERIC_TABLE_REF", message }, message);
   }
-  const table = await apiRequest(
+  const table2 = await apiRequest(
     "GET",
     `/api/tables/${asNumber}`,
     void 0,
@@ -568,9 +568,9 @@ async function introspectWorkspaceTable(_installationId, tableNameOrId, options
     ...f.is_required !== void 0 ? { required: f.is_required } : {}
   }));
   return {
-    table_id: table.id,
-    name: table.name,
-    slug: slugifyFieldName(table.name),
+    table_id: table2.id,
+    name: table2.name,
+    slug: slugifyFieldName(table2.name),
     fields
   };
 }
@@ -639,6 +639,66 @@ async function getRuntimeLogs(installationId, opts = {}, options = {}) {
     options
   );
 }
+async function getModuleSchedules(installationId, options = {}) {
+  return apiRequest(
+    "GET",
+    `/api/modules/installations/${installationId}/schedules`,
+    void 0,
+    options
+  );
+}
+async function listJobRuns(installationId, opts = {}, options = {}) {
+  const params = new URLSearchParams();
+  if (opts.kind) params.set("kind", opts.kind);
+  if (opts.key) params.set("key", opts.key);
+  if (opts.cursor !== void 0) params.set("cursor", String(opts.cursor));
+  if (opts.limit !== void 0) params.set("limit", String(opts.limit));
+  const qs = params.toString();
+  return apiRequest(
+    "GET",
+    `/api/modules/installations/${installationId}/job-runs${qs ? `?${qs}` : ""}`,
+    void 0,
+    options
+  );
+}
+async function runModuleSchedule(installationId, key, options = {}) {
+  return apiRequest(
+    "POST",
+    `/api/modules/installations/${installationId}/schedules/${encodeURIComponent(key)}/run`,
+    {},
+    options
+  );
+}
+async function getModuleWebhooks(installationId, options = {}) {
+  return apiRequest(
+    "GET",
+    `/api/modules/installations/${installationId}/webhooks`,
+    void 0,
+    options
+  );
+}
+async function listWebhookDeliveries(installationId, opts = {}, options = {}) {
+  const params = new URLSearchParams();
+  if (opts.key) params.set("key", opts.key);
+  if (opts.status) params.set("status", opts.status);
+  if (opts.cursor !== void 0) params.set("cursor", String(opts.cursor));
+  if (opts.limit !== void 0) params.set("limit", String(opts.limit));
+  const qs = params.toString();
+  return apiRequest(
+    "GET",
+    `/api/modules/installations/${installationId}/webhook-deliveries${qs ? `?${qs}` : ""}`,
+    void 0,
+    options
+  );
+}
+async function redeliverWebhookDelivery(installationId, deliveryId, options = {}) {
+  return apiRequest(
+    "POST",
+    `/api/modules/installations/${installationId}/webhook-deliveries/${deliveryId}/redeliver`,
+    {},
+    options
+  );
+}
 async function getInstallationRuntime(installationId, options = {}) {
   return apiRequest(
     "GET",
@@ -1017,9 +1077,9 @@ function mergeRemoteManifest(local, remote) {
   }
   return { merged, preserved };
 }
-function fieldSlugs(table) {
+function fieldSlugs(table2) {
   const set = /* @__PURE__ */ new Set();
-  const fields = table?.fields;
+  const fields = table2?.fields;
   if (!Array.isArray(fields)) return set;
   for (const f of fields) {
     if (f && typeof f === "object" && typeof f.slug === "string") {
@@ -14512,17 +14572,17 @@ function referenceFieldWarnings(manifest) {
   const tables = manifest?.owns?.tables;
   if (!Array.isArray(tables)) return [];
   const warnings = [];
-  for (const table of tables) {
-    if (typeof table?.slug !== "string" || !Array.isArray(table.fields)) continue;
-    for (const field of table.fields) {
+  for (const table2 of tables) {
+    if (typeof table2?.slug !== "string" || !Array.isArray(table2.fields)) continue;
+    for (const field of table2.fields) {
       if (typeof field?.slug !== "string" || typeof field.type !== "string") continue;
       if (field.slug === "id" || !REFERENCE_NAME.test(field.slug)) continue;
       if (!PLAIN_TYPES.has(field.type)) continue;
       warnings.push({
-        table: table.slug,
+        table: table2.slug,
         field: field.slug,
         type: field.type,
-        message: `${table.slug}.${field.slug} is a ${field.type} field named like a reference. If it points at a row in Dashwise, use a link_row field: plain ids break silently when data is copied to another installation. Ignore this for ids from outside systems.`
+        message: `${table2.slug}.${field.slug} is a ${field.type} field named like a reference. If it points at a row in Dashwise, use a link_row field: plain ids break silently when data is copied to another installation. Ignore this for ids from outside systems.`
       });
     }
   }
@@ -15156,9 +15216,9 @@ function printApplySummary(applied) {
     const message = strProp(warning, "message");
     if (!message) continue;
     const warningCode = strProp(warning, "code");
-    const table = strProp(warning, "table");
+    const table2 = strProp(warning, "table");
     const field = strProp(warning, "field");
-    const location = table ? `${table}${field ? `.${field}` : ""}` : field;
+    const location = table2 ? `${table2}${field ? `.${field}` : ""}` : field;
     const prefix = [warningCode, location].filter(Boolean).join(" ");
     warn(`${prefix ? `${code(prefix)}: ` : ""}${message}`);
   }
@@ -15277,8 +15337,8 @@ var init_push = __esm({
 });
 
 // ../sdk/dist/index.js
-function primaryDeclarationIssues(table) {
-  const invalid = table.fields.findIndex(
+function primaryDeclarationIssues(table2) {
+  const invalid = table2.fields.findIndex(
     (field2) => field2.primary !== void 0 && field2.primary !== true
   );
   if (invalid !== -1) {
@@ -15286,17 +15346,17 @@ function primaryDeclarationIssues(table) {
       { path: ["fields", invalid, "primary"], message: "primary must be literal true or omitted" }
     ];
   }
-  const marked = table.fields.filter((field2) => field2.primary === true);
+  const marked = table2.fields.filter((field2) => field2.primary === true);
   if (marked.length !== 1) {
     return [
       {
         path: ["fields"],
-        message: `Table ${table.slug}: mark exactly one field as primary: true (the row's label in links, pickers, titles)`
+        message: `Table ${table2.slug}: mark exactly one field as primary: true (the row's label in links, pickers, titles)`
       }
     ];
   }
   const field = marked[0];
-  const path = ["fields", table.fields.indexOf(field), "primary"];
+  const path = ["fields", table2.fields.indexOf(field), "primary"];
   if (field.type === "formula") {
     return [{ path, message: "formula fields cannot be the primary of a module table yet" }];
   }
@@ -15304,14 +15364,14 @@ function primaryDeclarationIssues(table) {
     return [
       {
         path,
-        message: `Table ${table.slug}: mark a field that can be the primary with primary: true (${field.slug} of type ${field.type} cannot be primary)`
+        message: `Table ${table2.slug}: mark a field that can be the primary with primary: true (${field.slug} of type ${field.type} cannot be primary)`
       }
     ];
   }
   return [];
 }
-function weakPrimaryWarning(table) {
-  const field = table.fields.find((field2) => field2.primary === true);
+function weakPrimaryWarning(table2) {
+  const field = table2.fields.find((field2) => field2.primary === true);
   if (!field || !WEAK_PRIMARY_TYPES.has(field.type)) return void 0;
   return `${field.slug} is a weak row label; prefer a short text field such as a name or title`;
 }
@@ -15529,14 +15589,14 @@ async function tableCreateCommand(slug, options) {
     }
     seen.add(f.slug);
   }
-  const table = { slug, fields };
-  const issues = primaryDeclarationIssues(table);
+  const table2 = { slug, fields };
+  const issues = primaryDeclarationIssues(table2);
   if (issues.length > 0) {
     for (const issue of issues) fail(issue.message);
     info("Mark the row name explicitly, e.g. --field title:text:primary.");
     return 1;
   }
-  const primaryWarning = weakPrimaryWarning(table);
+  const primaryWarning = weakPrimaryWarning(table2);
   if (primaryWarning) warn(primaryWarning);
   let ctx;
   try {
@@ -18910,7 +18970,13 @@ async function moduleGenerateCommand(options) {
       {
         manifest,
         generation: options.generation ?? 0
-      }
+      },
+      // The installed @dashai/sdk decides the client's bootstrap (backend
+      // generator 3.3.0): from 2.13.0 it reads DASHWISE_API_KEY_FILE (a
+      // Workbench's key); older or none, the client every 2.x SDK links. A
+      // header, not a body field: an older backend refuses unknown body
+      // fields (forbidNonWhitelisted) but ignores an unknown header.
+      { headers: sdkVersionHeader(projectRoot) }
     );
   } catch (err) {
     if (err instanceof ApiError && err.status === 401) {
@@ -18964,6 +19030,12 @@ async function moduleGenerateCommand(options) {
   );
   return 0;
 }
+var SDK_VERSION_HEADER = "Dashwise-Sdk-Version";
+var SDK_VERSION_PATTERN = /^v?\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/;
+function sdkVersionHeader(projectRoot) {
+  const version = readInstalledSdk(projectRoot)?.version;
+  return version !== void 0 && version.length <= 64 && SDK_VERSION_PATTERN.test(version) ? { [SDK_VERSION_HEADER]: version } : {};
+}
 function declaresUses(manifest) {
   const uses = manifest?.uses;
   return Array.isArray(uses?.tables) && uses.tables.length > 0;
@@ -23349,13 +23421,13 @@ async function buildFieldMap(ctx, candidate, overrides) {
   if (overrideKeys.length === 0) {
     return Object.keys(candidate.auto_field_map).length > 0 ? { ...candidate.auto_field_map } : void 0;
   }
-  const table = await introspectWorkspaceTable(
+  const table2 = await introspectWorkspaceTable(
     ctx.installationId,
     String(candidate.table_id),
     ctx.requestOptions
   );
   const byName = /* @__PURE__ */ new Map();
-  for (const f of table.fields) {
+  for (const f of table2.fields) {
     byName.set(f.slug, f.id);
     if (f.name) byName.set(f.name, f.id);
   }
@@ -23363,9 +23435,9 @@ async function buildFieldMap(ctx, candidate, overrides) {
   for (const [usesField, physicalName] of Object.entries(overrides)) {
     const id = byName.get(physicalName);
     if (id === void 0) {
-      const available = table.fields.map((f) => f.name && f.name !== f.slug ? `${f.slug} (${f.name})` : f.slug).join(", ");
+      const available = table2.fields.map((f) => f.name && f.name !== f.slug ? `${f.slug} (${f.name})` : f.slug).join(", ");
       throw new Error(
-        `--map ${usesField}=${physicalName}: table "${table.name}" has no field named "${physicalName}". Available: ${available}.`
+        `--map ${usesField}=${physicalName}: table "${table2.name}" has no field named "${physicalName}". Available: ${available}.`
       );
     }
     merged[usesField] = id;
@@ -23604,9 +23676,9 @@ async function usesAddCommand(options) {
   }
   const scopeExit = await assertTableInInstallWorkspace(ctx, options.fromTable);
   if (scopeExit !== 0) return scopeExit;
-  let table;
+  let table2;
   try {
-    table = await introspectWorkspaceTable(
+    table2 = await introspectWorkspaceTable(
       ctx.installationId,
       options.fromTable,
       ctx.requestOptions
@@ -23614,27 +23686,27 @@ async function usesAddCommand(options) {
   } catch (err) {
     return surfaceIntrospectError(err, options.fromTable);
   }
-  const slotSlug = options.slug ?? slugifyUsesName(table.name);
+  const slotSlug = options.slug ?? slugifyUsesName(table2.name);
   if (!isUsesSlug(slotSlug)) {
     fail(
       `Slot slug ${code(slotSlug || "(empty)")} doesn't match ${code(USES_SLUG_RULE)}. Pass ${code("--slug <snake_case_slug>")} explicitly.`
     );
     return 1;
   }
-  const { fields, skipped } = generateFields(table.fields);
+  const { fields, skipped } = generateFields(table2.fields);
   if (fields.length === 0) {
     fail(
-      `Table ${code(table.name)} has no fields representable as a v1 ${code("uses")} contract (all are link_row / formula / ai / file). Nothing to declare.`
+      `Table ${code(table2.name)} has no fields representable as a v1 ${code("uses")} contract (all are link_row / formula / ai / file). Nothing to declare.`
     );
     return 1;
   }
   const badFields = fields.filter((f) => !isUsesSlug(f.slug));
   if (badFields.length > 0) {
     fail(
-      `${badFields.length} field name(s) on ${code(table.name)} don't fold into a legal ${code("uses")} field slug (${code(USES_SLUG_RULE)}):`
+      `${badFields.length} field name(s) on ${code(table2.name)} don't fold into a legal ${code("uses")} field slug (${code(USES_SLUG_RULE)}):`
     );
     for (const f of badFields) {
-      const physical = table.fields.find((p) => p.slug === f.slug);
+      const physical = table2.fields.find((p) => p.slug === f.slug);
       const name = physical?.name ?? f.slug;
       out(`    ${dim("-")} ${code(name)} \u2192 ${code(f.slug || "(empty)")}`);
     }
@@ -23648,10 +23720,10 @@ async function usesAddCommand(options) {
   const collidingSlugs = [...slugCounts.entries()].filter(([, n]) => n > 1).map(([slug]) => slug);
   if (collidingSlugs.length > 0) {
     fail(
-      `${collidingSlugs.length} generated ${code("uses")} field slug(s) on ${code(table.name)} collide \u2014 the backend refuses a contract with a duplicate field slug:`
+      `${collidingSlugs.length} generated ${code("uses")} field slug(s) on ${code(table2.name)} collide \u2014 the backend refuses a contract with a duplicate field slug:`
     );
     for (const slug of collidingSlugs) {
-      const names = table.fields.filter((p) => p.slug === slug && abstractTypeForPhysical(p.type) !== null).map((p) => p.name ?? p.slug);
+      const names = table2.fields.filter((p) => p.slug === slug && abstractTypeForPhysical(p.type) !== null).map((p) => p.name ?? p.slug);
       out(`    ${dim("-")} ${names.map((n) => code(n)).join(" + ")} \u2192 ${code(slug)}`);
     }
     info(
@@ -23667,7 +23739,7 @@ async function usesAddCommand(options) {
   };
   if (options.purpose) slot.purpose = options.purpose;
   info(
-    `Generated a ${code("uses")} contract ${code(slotSlug)} from table ${code(table.name)} ${dim(`(id ${table.table_id})`)}:`
+    `Generated a ${code("uses")} contract ${code(slotSlug)} from table ${code(table2.name)} ${dim(`(id ${table2.table_id})`)}:`
   );
   out(`    ${dim("ops:")} ${ops.join(", ")}`);
   for (const f of fields) {
@@ -23713,24 +23785,24 @@ async function usesAddCommand(options) {
   );
   if (!pushed.ok) {
     info(
-      `The manifest edit is saved locally. Push it (${code("dashwise dev")} watches + applies, or re-run once the backend is reachable), then ${code(`dashwise bind ${slotSlug} --table ${table.table_id}`)}.`
+      `The manifest edit is saved locally. Push it (${code("dashwise dev")} watches + applies, or re-run once the backend is reachable), then ${code(`dashwise bind ${slotSlug} --table ${table2.table_id}`)}.`
     );
     return 1;
   }
   if (options.noBind) {
     info(
-      `Skipped auto-bind (${code("--no-bind")}). Connect it when ready: ${code(`dashwise bind ${slotSlug} --table ${table.table_id}`)}.`
+      `Skipped auto-bind (${code("--no-bind")}). Connect it when ready: ${code(`dashwise bind ${slotSlug} --table ${table2.table_id}`)}.`
     );
     return 0;
   }
-  info(`Binding ${code(slotSlug)} to ${code(table.name)}\u2026`);
+  info(`Binding ${code(slotSlug)} to ${code(table2.name)}\u2026`);
   const bindExit = await bindCommand(slotSlug, {
     ...ctx.dir !== void 0 ? { dir: ctx.dir } : {},
-    table: String(table.table_id)
+    table: String(table2.table_id)
   });
   if (bindExit !== 0) {
     warn(
-      `The ${code("uses")} slot was declared + pushed, but the auto-bind didn't complete. Retry with ${code(`dashwise bind ${slotSlug} --table ${table.table_id}`)}.`
+      `The ${code("uses")} slot was declared + pushed, but the auto-bind didn't complete. Retry with ${code(`dashwise bind ${slotSlug} --table ${table2.table_id}`)}.`
     );
     return bindExit;
   }
@@ -25877,7 +25949,10 @@ async function moduleLogsCommand(slugArg, options) {
   }
   return runOnce3(installationId, label, options, since, auth);
 }
-async function resolveInstallationFromSlug(slugArg, options, cfg, auth) {
+async function resolveInstallationFromSlug(slugArg, options, cfg, auth, wording = {
+  command: "module logs",
+  purpose: "read logs from"
+}) {
   let slug = slugArg;
   if (!slug) {
     try {
@@ -25890,7 +25965,7 @@ async function resolveInstallationFromSlug(slugArg, options, cfg, auth) {
   }
   if (!slug) {
     fail(
-      `No module slug \u2014 pass one (${code("dashwise module logs <slug>")}), run from a directory with a valid module.json, or target an install directly with ${code("--install <id>")}.`
+      `No module slug \u2014 pass one (${code(`dashwise ${wording.command} <slug>`)}), run from a directory with a valid module.json, or target an install directly with ${code("--install <id>")}.`
     );
     return 1;
   }
@@ -25932,7 +26007,7 @@ async function resolveInstallationFromSlug(slugArg, options, cfg, auth) {
   }
   if (!row) {
     info(
-      `${code(modSlug)} is not installed in workspace ${code(workspace2.slug)} \u2014 nothing to read logs from. Deploy it with ${code(`dashwise module install ${modSlug} --workspace ${workspace2.slug}`)}.`
+      `${code(modSlug)} is not installed in workspace ${code(workspace2.slug)} \u2014 nothing to ${wording.purpose}. Deploy it with ${code(`dashwise module install ${modSlug} --workspace ${workspace2.slug}`)}.`
     );
     return 0;
   }
@@ -26125,6 +26200,432 @@ async function sleep3(ms, aborted) {
   }
 }
 
+// src/commands/jobs.ts
+init_api_client();
+init_config();
+init_output();
+var KINDS = ["schedule", "webhook", "manual", "migration", "replay"];
+var CONTROL = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/g;
+function safeExcerpt(text4) {
+  return text4 === null ? null : text4.replace(CONTROL, " ");
+}
+function safeRun(run) {
+  return run ? { ...run, error_excerpt: safeExcerpt(run.error_excerpt) } : run;
+}
+var KEY = /^[a-z0-9][a-z0-9-]{0,39}$/;
+async function resolveJobsTarget(slugArg, options, command, purpose = "run jobs on") {
+  if (!isLoggedIn()) {
+    fail(`Not logged in. Run ${code("dashwise login")} first.`);
+    return 1;
+  }
+  const cfg = readConfig();
+  if (!cfg) {
+    fail(`CLI config missing. Run ${code("dashwise login")}.`);
+    return 1;
+  }
+  const auth = { baseUrl: resolveApiUrl(), auth: { token: cfg.token } };
+  if (options.install !== void 0) {
+    if (!Number.isInteger(options.install) || options.install <= 0) {
+      fail(`--install expects a positive integer installation id (got "${options.install}").`);
+      return 1;
+    }
+    return { installationId: options.install, label: `install #${options.install}`, auth };
+  }
+  const resolved = await resolveInstallationFromSlug(slugArg, options, cfg, auth, {
+    command,
+    purpose
+  });
+  if (typeof resolved === "number") return resolved;
+  return { ...resolved, auth };
+}
+async function jobsListCommand(slugArg, options) {
+  const t = await resolveJobsTarget(slugArg, options, "jobs list");
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await getModuleSchedules(t.installationId, t.auth);
+  } catch (err) {
+    return mapJobsError(err, options.json, "read the schedules");
+  }
+  if (options.json) {
+    out(
+      JSON.stringify({
+        ...body,
+        schedules: body.schedules.map((s) => ({ ...s, last_run: safeRun(s.last_run) }))
+      })
+    );
+    return 0;
+  }
+  if (body.schedules.length === 0) {
+    info(`The installed version of ${t.label} declares no schedules.`);
+    return 0;
+  }
+  if (!body.enabled) {
+    warn("Schedules do not run on this platform yet (not enabled, or no job queue). Manual runs may still work.");
+  } else if (!body.active) {
+    warn("This installation does not run its schedules now (offline, held, without a runtime, or on a Workbench).");
+  }
+  const rows = body.schedules.map((s) => [
+    s.key,
+    s.interval ? `every ${s.interval}` : `${s.pattern} UTC`,
+    s.route,
+    s.next_run_at ? formatTs2(s.next_run_at) : "\u2014",
+    s.last_run ? `${colorStatus(s.last_run.status)} ${dim(formatTs2(s.last_run.created_at))}` : dim("never"),
+    s.running ? pc.yellow("running") : ""
+  ]);
+  table(["KEY", "SCHEDULE", "ROUTE", "NEXT RUN", "LAST RUN", ""], rows);
+  out("");
+  info(`${body.schedules.length} ${body.schedules.length === 1 ? "schedule" : "schedules"} (${t.label}).`);
+  return 0;
+}
+async function jobsRunsCommand(slugArg, options) {
+  if (options.kind !== void 0 && !KINDS.includes(options.kind)) {
+    fail(`--kind must be one of ${KINDS.join(", ")} (got "${options.kind}").`);
+    return 1;
+  }
+  if (options.key !== void 0 && !KEY.test(options.key)) {
+    fail(`--key must be a schedule key like ${code("lease-sweep")} (got "${options.key}").`);
+    return 1;
+  }
+  if (options.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > 200)) {
+    fail(`--limit must be between 1 and 200 (got "${options.limit}").`);
+    return 1;
+  }
+  const t = await resolveJobsTarget(slugArg, options, "jobs runs");
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await listJobRuns(
+      t.installationId,
+      {
+        ...options.kind ? { kind: options.kind } : {},
+        ...options.key ? { key: options.key } : {},
+        ...options.before !== void 0 ? { cursor: options.before } : {},
+        ...options.limit !== void 0 ? { limit: options.limit } : {}
+      },
+      t.auth
+    );
+  } catch (err) {
+    return mapJobsError(err, options.json, "read the run log");
+  }
+  if (options.json) {
+    out(JSON.stringify({ ...body, runs: body.runs.map((r) => safeRun(r)) }));
+    return 0;
+  }
+  if (body.runs.length === 0) {
+    info(`No runs for ${t.label}${options.key ? ` (${options.key})` : ""}.`);
+    return 0;
+  }
+  table(
+    ["TIME", "KEY", "KIND", "TRY", "STATUS", "HTTP", "MS", "ERROR"],
+    body.runs.map((r) => [
+      formatTs2(r.created_at),
+      r.key,
+      r.kind,
+      String(r.attempt),
+      colorStatus(r.status),
+      r.http_status === null ? "" : String(r.http_status),
+      r.duration_ms === null ? "" : String(r.duration_ms),
+      r.error_code ?? ""
+    ])
+  );
+  out("");
+  info(
+    `${body.runs.length} ${body.runs.length === 1 ? "run" : "runs"} (${t.label}).` + (body.next_cursor !== null ? ` Older: ${code(`--before ${body.next_cursor}`)}.` : "")
+  );
+  return 0;
+}
+async function jobsRunCommand(key, slugArg, options) {
+  if (!KEY.test(key)) {
+    fail(`"${key}" is not a schedule key (expected ${KEY.source}).`);
+    return 1;
+  }
+  const t = await resolveJobsTarget(slugArg, options, `jobs run ${key}`);
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await runModuleSchedule(t.installationId, key, t.auth);
+  } catch (err) {
+    return mapJobsError(err, options.json, `run ${key}`);
+  }
+  if (options.json) {
+    out(JSON.stringify({ ...body, run: safeRun(body.run) }));
+    return body.run && body.run.status !== "ok" ? 2 : 0;
+  }
+  if (body.queued) {
+    success(`Queued a run of ${code(key)} on ${t.label} (invocation ${body.invocation_id}).`);
+    info(`Follow it with ${code(`dashwise jobs runs --key ${key}`)}.`);
+    return 0;
+  }
+  const run = body.run;
+  if (!run) {
+    warn(`The run of ${code(key)} left no log row (invocation ${body.invocation_id}).`);
+    return 2;
+  }
+  const detail = [
+    run.http_status !== null ? `HTTP ${run.http_status}` : null,
+    run.duration_ms !== null ? `${run.duration_ms} ms` : null,
+    run.error_code
+  ].filter(Boolean).join(", ");
+  if (run.status === "ok") {
+    success(`Ran ${code(key)} on ${t.label}: ok${detail ? ` (${detail})` : ""}.`);
+    return 0;
+  }
+  fail(`Ran ${code(key)} on ${t.label}: ${run.status}${detail ? ` (${detail})` : ""}.`);
+  const excerpt = safeExcerpt(run.error_excerpt);
+  if (excerpt) out(dim(excerpt));
+  return 2;
+}
+function formatTs2(iso) {
+  const d = new Date(iso);
+  return Number.isNaN(d.getTime()) ? iso : d.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "Z");
+}
+function colorStatus(status) {
+  switch (status) {
+    case "ok":
+      return pc.green(status);
+    case "skipped":
+      return pc.dim(status);
+    default:
+      return pc.red(status);
+  }
+}
+function table(head, rows) {
+  const visible = (s) => s.replace(/\u001b\[[0-9;]*m/g, "").length;
+  const widths = head.map((h, i) => Math.max(visible(h), ...rows.map((r) => visible(r[i] ?? ""))));
+  const line = (cells) => cells.map((c2, i) => c2 + " ".repeat(Math.max(0, widths[i] - visible(c2)))).join("  ").trimEnd();
+  out(dim(line(head)));
+  for (const r of rows) out(line(r));
+}
+function mapJobsError(err, json, what) {
+  const emit = (c2, message2) => {
+    if (json) out(JSON.stringify({ ok: false, error: { code: c2, message: message2 } }));
+    else fail(message2);
+  };
+  if (err instanceof ApiError) {
+    if (err.status === 401 || err.code === "UNAUTHENTICATED") {
+      emit("NOT_LOGGED_IN", `Not logged in. Run ${code("dashwise login")} first.`);
+      return 1;
+    }
+    if (err.code === "SCHEDULE_NOT_FOUND") {
+      emit(err.code, `${err.message} See ${code("dashwise jobs list")}.`);
+      return 1;
+    }
+    if (err.status === 404 || err.code === "INSTALLATION_NOT_FOUND") {
+      emit(
+        "INSTALLATION_NOT_FOUND",
+        `Installation not found, or you may not open it. Check the id (${code("dashwise module status <slug>")}).`
+      );
+      return 1;
+    }
+    if (err.status === 403) {
+      emit(
+        err.code || "FORBIDDEN",
+        `You may not ${what} on this installation: reading needs its logs permission, running needs its settings permission (an installation manager or a company admin).`
+      );
+      return 1;
+    }
+    if (err.code === "FEATURE_NOT_ENABLED" || err.code === "COPY_NOT_RUNNING_JOBS") {
+      emit(err.code, err.message);
+      return 1;
+    }
+    emit(err.code, `Could not ${what}: ${err.code} ${err.status} \u2014 ${err.message}`);
+    return 1;
+  }
+  const message = `Could not ${what}: ${err.message}`;
+  emit("FETCH_FAILED", message);
+  return 1;
+}
+
+// src/commands/webhooks.ts
+init_api_client();
+init_output();
+var STATUSES = [
+  "pending",
+  "forwarding",
+  "delivered",
+  "failed",
+  "skipped",
+  "ignored"
+];
+var KEY2 = /^[a-z0-9][a-z0-9-]{0,39}$/;
+async function webhooksListCommand(slugArg, options) {
+  const t = await resolveJobsTarget(slugArg, options, "webhooks list", "read the webhooks of");
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await getModuleWebhooks(t.installationId, t.auth);
+  } catch (err) {
+    return mapWebhooksError(err, options.json, "read the webhooks");
+  }
+  if (options.json) {
+    out(JSON.stringify(body));
+    return 0;
+  }
+  if (body.webhooks.length === 0) {
+    info(`The installed version of ${t.label} declares no webhooks.`);
+    return 0;
+  }
+  if (!body.enabled) {
+    warn("Webhooks are not received on this platform yet (not enabled): there is no URL to give a provider.");
+  } else if (!body.active) {
+    warn("This installation does not receive webhooks now (offline, held, without a runtime, or on a Workbench).");
+  }
+  table(
+    ["KEY", "PROVIDER", "EVENTS", "ROUTE", "LAST DELIVERY"],
+    body.webhooks.map((w) => [
+      w.key,
+      w.provider,
+      w.events ? w.events.join(",") : dim("all"),
+      w.route,
+      w.last_delivery ? `${colorStatus2(w.last_delivery.status)} ${dim(formatTs2(w.last_delivery.received_at))}` : dim("never")
+    ])
+  );
+  out("");
+  for (const w of body.webhooks) {
+    if (w.url) out(`${w.key}: ${w.url}  ${dim(`(signed with ${w.secret})`)}`);
+  }
+  info(`${body.webhooks.length} ${body.webhooks.length === 1 ? "webhook" : "webhooks"} (${t.label}).`);
+  return 0;
+}
+async function webhooksDeliveriesCommand(slugArg, options) {
+  if (options.status !== void 0 && !STATUSES.includes(options.status)) {
+    fail(`--status must be one of ${STATUSES.join(", ")} (got "${options.status}").`);
+    return 1;
+  }
+  if (options.key !== void 0 && !KEY2.test(options.key)) {
+    fail(`--key must be a webhook key like ${code("github")} (got "${options.key}").`);
+    return 1;
+  }
+  if (options.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > 200)) {
+    fail(`--limit must be between 1 and 200 (got "${options.limit}").`);
+    return 1;
+  }
+  const t = await resolveJobsTarget(slugArg, options, "webhooks deliveries", "read the webhooks of");
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await listWebhookDeliveries(
+      t.installationId,
+      {
+        ...options.key ? { key: options.key } : {},
+        ...options.status ? { status: options.status } : {},
+        ...options.before !== void 0 ? { cursor: options.before } : {},
+        ...options.limit !== void 0 ? { limit: options.limit } : {}
+      },
+      t.auth
+    );
+  } catch (err) {
+    return mapWebhooksError(err, options.json, "read the deliveries");
+  }
+  if (options.json) {
+    out(JSON.stringify(body));
+    return 0;
+  }
+  if (body.deliveries.length === 0) {
+    info(`No deliveries for ${t.label}${options.key ? ` (${options.key})` : ""}.`);
+    return 0;
+  }
+  table(
+    ["RECEIVED", "ID", "KEY", "EVENT", "STATUS", "KIND", "TRIES", "HTTP", "ERROR"],
+    body.deliveries.map((d) => [
+      formatTs2(d.received_at),
+      String(d.id),
+      d.webhook_key,
+      d.event ?? "",
+      colorStatus2(d.status),
+      d.kind,
+      String(d.attempts),
+      d.last_http_status === null ? "" : String(d.last_http_status),
+      d.last_error_code ?? ""
+    ])
+  );
+  out("");
+  info(
+    `${body.deliveries.length} ${body.deliveries.length === 1 ? "delivery" : "deliveries"} (${t.label}).` + (body.next_cursor !== null ? ` Older: ${code(`--before ${body.next_cursor}`)}.` : "")
+  );
+  return 0;
+}
+async function webhooksRedeliverCommand(deliveryId, slugArg, options) {
+  if (!/^[1-9][0-9]{0,15}$/.test(deliveryId)) {
+    fail(`"${deliveryId}" is not a delivery id (the ID column of ${code("dashwise webhooks deliveries")}).`);
+    return 1;
+  }
+  const t = await resolveJobsTarget(slugArg, options, `webhooks redeliver ${deliveryId}`, "redeliver webhooks on");
+  if (typeof t === "number") return t;
+  let body;
+  try {
+    body = await redeliverWebhookDelivery(t.installationId, Number(deliveryId), t.auth);
+  } catch (err) {
+    return mapWebhooksError(err, options.json, `redeliver ${deliveryId}`);
+  }
+  if (options.json) {
+    out(JSON.stringify(body));
+    return 0;
+  }
+  success(
+    `Redelivering #${body.delivery.id} (${body.delivery.webhook_key}${body.delivery.event ? `, ${body.delivery.event}` : ""}) to ${t.label} as a replay (invocation ${body.delivery.invocation_id}).`
+  );
+  info(`Follow it with ${code(`dashwise webhooks deliveries --key ${body.delivery.webhook_key}`)}.`);
+  return 0;
+}
+function colorStatus2(status) {
+  switch (status) {
+    case "delivered":
+      return pc.green(status);
+    case "pending":
+    case "forwarding":
+      return pc.yellow(status);
+    case "ignored":
+    case "skipped":
+      return pc.dim(status);
+    default:
+      return pc.red(status);
+  }
+}
+var PASS_THROUGH = /* @__PURE__ */ new Set([
+  "FEATURE_NOT_ENABLED",
+  "COPY_NOT_RUNNING_JOBS",
+  "WEBHOOK_DELIVERY_NOT_STORED",
+  "WEBHOOK_DELIVERY_IN_PROGRESS",
+  "WEBHOOK_DELIVERY_NOT_FOUND",
+  "WEBHOOK_REDELIVERY_IMPERSONATION_REFUSED"
+]);
+function mapWebhooksError(err, json, what) {
+  const emit = (c2, message) => {
+    if (json) out(JSON.stringify({ ok: false, error: { code: c2, message } }));
+    else fail(message);
+  };
+  if (err instanceof ApiError) {
+    if (err.status === 401 || err.code === "UNAUTHENTICATED") {
+      emit("NOT_LOGGED_IN", `Not logged in. Run ${code("dashwise login")} first.`);
+      return 1;
+    }
+    if (PASS_THROUGH.has(err.code)) {
+      emit(err.code, err.message);
+      return 1;
+    }
+    if (err.status === 404 || err.code === "INSTALLATION_NOT_FOUND") {
+      emit(
+        "INSTALLATION_NOT_FOUND",
+        `Installation not found, or you may not open it. Check the id (${code("dashwise module status <slug>")}).`
+      );
+      return 1;
+    }
+    if (err.status === 403) {
+      emit(
+        err.code || "FORBIDDEN",
+        `You may not ${what} on this installation: reading needs its logs permission, a redelivery its settings permission (an installation manager or a company admin).`
+      );
+      return 1;
+    }
+    emit(err.code, `Could not ${what}: ${err.code} ${err.status} \u2014 ${err.message}`);
+    return 1;
+  }
+  emit("FETCH_FAILED", `Could not ${what}: ${err.message}`);
+  return 1;
+}
+
 // src/commands/module/rebuild.ts
 init_api_client();
 init_config();
@@ -26994,6 +27495,69 @@ moduleCmd.command("clone <slug>").description("Clone a published module locally.
     });
   }
 );
+var jobsCmd = program.command("jobs").description(
+  "A module installation's scheduled jobs (`schedules[]` in module.json): `list` the schedules with their next and last run, read the `runs` log, or `run` one now. The installation is resolved like `module logs`: the slug (argument or module.json) and the workspace, or `--install <id>`."
+);
+var jobsTargetFlags = (cmd) => cmd.option("--dir <path>", "Project root for the module.json slug lookup (default: current directory).").option("--workspace <slug-or-id>", "Target workspace (default: cached module workspace, config default, or interactive picker).").option("--install <id>", "Target an installation id directly (skips slug + workspace resolution).", parseIntOption).option("--json", "Emit the raw JSON response.");
+var jobsTarget = (o) => ({
+  ...o.dir !== void 0 ? { dir: o.dir } : {},
+  ...o.workspace !== void 0 ? { workspace: o.workspace } : {},
+  ...o.install !== void 0 ? { install: o.install } : {},
+  ...o.json !== void 0 ? { json: o.json } : {}
+});
+jobsTargetFlags(
+  jobsCmd.command("list [slug]").description("List the schedules the installed version declares: cron (UTC), route, next run, last run.")
+).action(async (slug, cmdOpts) => {
+  process.exitCode = await jobsListCommand(slug, jobsTarget(cmdOpts));
+});
+jobsTargetFlags(
+  jobsCmd.command("runs [slug]").description("The run log, newest first: one line per attempt (status, HTTP status, duration, error code).").option("--key <key>", "Only this schedule key.").option("--kind <kind>", "Only this kind: schedule, manual, webhook, migration or replay.").option("--limit <n>", "Rows per page (1-200, default 50).", parseIntOption).option("--before <id>", "Older rows: the id the previous page printed.", parseIntOption)
+).action(
+  async (slug, cmdOpts) => {
+    process.exitCode = await jobsRunsCommand(slug, {
+      ...jobsTarget(cmdOpts),
+      ...cmdOpts.key !== void 0 ? { key: cmdOpts.key } : {},
+      ...cmdOpts.kind !== void 0 ? { kind: cmdOpts.kind } : {},
+      ...cmdOpts.limit !== void 0 ? { limit: cmdOpts.limit } : {},
+      ...cmdOpts.before !== void 0 ? { before: cmdOpts.before } : {}
+    });
+  }
+);
+jobsTargetFlags(
+  jobsCmd.command("run <key> [slug]").description(
+    "Run schedule <key> now, outside its cron (audited). Needs the installation settings permission. Exit 2 when the run did not succeed."
+  )
+).action(async (key, slug, cmdOpts) => {
+  process.exitCode = await jobsRunCommand(key, slug, jobsTarget(cmdOpts));
+});
+var webhooksCmd = program.command("webhooks").description(
+  "A module installation's webhooks (`webhooks[]` in module.json): `list` them with the URL to give each provider, read the stored `deliveries`, or `redeliver` one. The platform verifies, deduplicates and stores each delivery before forwarding it to your route."
+);
+jobsTargetFlags(
+  webhooksCmd.command("list [slug]").description("List the webhooks the installed version declares: provider, events, route, last delivery, URL.")
+).action(async (slug, cmdOpts) => {
+  process.exitCode = await webhooksListCommand(slug, jobsTarget(cmdOpts));
+});
+jobsTargetFlags(
+  webhooksCmd.command("deliveries [slug]").description("The stored deliveries, newest first (kept 7 days): event, status, kind, tries, last HTTP status.").option("--key <key>", "Only this webhook key.").option("--status <status>", "Only this status: pending, forwarding, delivered, failed, skipped or ignored.").option("--limit <n>", "Rows per page (1-200, default 50).", parseIntOption).option("--before <id>", "Older rows: the id the previous page printed.", parseIntOption)
+).action(
+  async (slug, cmdOpts) => {
+    process.exitCode = await webhooksDeliveriesCommand(slug, {
+      ...jobsTarget(cmdOpts),
+      ...cmdOpts.key !== void 0 ? { key: cmdOpts.key } : {},
+      ...cmdOpts.status !== void 0 ? { status: cmdOpts.status } : {},
+      ...cmdOpts.limit !== void 0 ? { limit: cmdOpts.limit } : {},
+      ...cmdOpts.before !== void 0 ? { before: cmdOpts.before } : {}
+    });
+  }
+);
+jobsTargetFlags(
+  webhooksCmd.command("redeliver <delivery-id> [slug]").description(
+    "Forward a stored delivery again (a replay with a new invocation id; audited). Needs the installation settings permission."
+  )
+).action(async (deliveryId, slug, cmdOpts) => {
+  process.exitCode = await webhooksRedeliverCommand(deliveryId, slug, jobsTarget(cmdOpts));
+});
 var depsCmd = program.command("deps").description(
   "Cross-module dependency commands. Bare `dashwise deps` shows the live connect status (resolved / unbound) of each declared dep on your installation; the subcommands manage module.json#dependencies (add / remove / list / check) and the connect lifecycle (bind / unbind)."
 ).option("--dir <path>", "Project root (default: current directory).").option("--json", "Emit the connect-status list as JSON instead of the human-readable view.").action(async (cmdOpts) => {
@@ -27817,7 +28381,7 @@ fieldCmd.command("set-type <table-slug> <field-slug> <new-type>").description(
   }
 );
 function getVersion() {
-  return "0.31.0";
+  return "0.32.0";
 }
 function parsePositiveIdOption(value) {
   if (!/^[1-9][0-9]*$/.test(value.trim())) {