clauder-hub 0.1.15 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clauder-hub",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "A local dashboard that runs, watches and automates the Claude Code sessions of every project on the machine",
   "license": "MIT",
   "author": "goldyndevs <goldyndevs@gmail.com>",

package/server/dist/index.js

@@ -1389,7 +1389,7 @@ var require_ms = __commonJS({
 var require_debug = __commonJS({
   "node_modules/debug/src/debug.js"(exports, module) {
     exports = module.exports = createDebug.debug = createDebug["default"] = createDebug;
-    exports.coerce = coerce;
+    exports.coerce = coerce2;
     exports.disable = disable;
     exports.enable = enable;
     exports.enabled = enabled;
@@ -1483,7 +1483,7 @@ var require_debug = __commonJS({
       }
       return false;
     }
-    function coerce(val) {
+    function coerce2(val) {
       if (val instanceof Error) return val.stack || val.message;
       return val;
     }
@@ -27216,6 +27216,8 @@ CREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status, created_at);
   ensureColumn("channel_threads", "project_id", "TEXT");
   ensureColumn("runs", "resume", "INTEGER NOT NULL DEFAULT 0");
   ensureColumn("runs", "queued_at", "TEXT");
+  ensureColumn("jobs", "params", "TEXT");
+  ensureColumn("runs", "params", "TEXT");
 }
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
@@ -36469,7 +36471,7 @@ function currentValue(purpose) {
   switch (purpose.kind) {
     case "edit-job": {
       const job = getJob(purpose.targetId);
-      return job && { name: job.name, kind: job.kind, schedule: job.schedule, prompt: job.prompt, category: job.category, presetId: job.presetId, enabled: job.enabled };
+      return job && { name: job.name, kind: job.kind, schedule: job.schedule, prompt: job.prompt, category: job.category, presetId: job.presetId, params: job.params, enabled: job.enabled };
     }
     case "edit-category": {
       const category = listCategories().find((item) => item.id === purpose.targetId);
@@ -36571,6 +36573,13 @@ var init_purposes = __esm({
       },
       { name: "category", type: "string", required: false, description: '"auto" (Claude picks) or a task category name; decides what the run must deliver before it closes. Default "auto".', example: "bugfix" },
       { name: "presetId", type: "string | null", required: false, description: "Toolset preset id from GET /api/presets; null uses the default preset.", example: "null" },
+      {
+        name: "params",
+        type: "array",
+        required: false,
+        description: 'Values the prompt takes as {{name}}: [{ name, label?, type: "number" | "string" | "boolean", default, description? }]. Run now asks for them (defaults filled in), cron runs use the defaults, POST /api/jobs/<id>/run and the webhook take {"params": {...}}; a wrong type is refused. Left out on a PUT, the job keeps its params; [] clears them.',
+        example: '[{ "name": "count", "label": "Episodes", "type": "number", "default": 5 }]'
+      },
       { name: "enabled", type: "boolean", required: false, description: "Default true.", example: "true" }
     ];
     CATEGORY_PARAMS = [
@@ -36872,6 +36881,47 @@ function getJob(id) {
   const row = db.prepare("SELECT * FROM jobs WHERE id = ?").get(id);
   return row ? toJob(row) : null;
 }
+function checkParams(input) {
+  if (input == null) return [];
+  if (!Array.isArray(input)) throw new Error("params is a list of { name, label?, type, default, description? }.");
+  const seen = /* @__PURE__ */ new Set();
+  return input.map((item) => {
+    const name = String(item?.name ?? "").trim();
+    if (!/^[A-Za-z_]\w*$/.test(name)) throw new Error(`Parameter name '${name}' must be letters, digits and _, not starting with a digit.`);
+    if (RESERVED2.includes(name)) throw new Error(`Parameter name '${name}' is reserved.`);
+    if (seen.has(name)) throw new Error(`Parameter '${name}' is listed twice.`);
+    seen.add(name);
+    if (!PARAM_TYPES.includes(item.type)) throw new Error(`Parameter '${name}': type is number, string or boolean.`);
+    const fallback = item.type === "number" ? 0 : item.type === "boolean" ? false : "";
+    const param = { name, type: item.type, default: coerce({ name, type: item.type }, item.default ?? fallback) };
+    if (item.label) param.label = String(item.label);
+    if (item.description) param.description = String(item.description);
+    return param;
+  });
+}
+function coerce(param, value) {
+  if (param.type === "number") {
+    const number = typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : NaN;
+    if (!Number.isFinite(number)) throw new Error(`Parameter '${param.name}' must be a number, got ${JSON.stringify(value)}.`);
+    return number;
+  }
+  if (param.type === "boolean") {
+    if (value === true || value === "true") return true;
+    if (value === false || value === "false") return false;
+    throw new Error(`Parameter '${param.name}' must be true or false, got ${JSON.stringify(value)}.`);
+  }
+  if (typeof value === "object" && value !== null) throw new Error(`Parameter '${param.name}' must be a string.`);
+  return String(value);
+}
+function resolveParams(job, given) {
+  if (given != null && (typeof given !== "object" || Array.isArray(given))) throw new Error("params is an object of name: value.");
+  const values = given ?? {};
+  const unknown = Object.keys(values).filter((name) => !job.params.some((param) => param.name === name));
+  if (unknown.length) throw new Error(`Unknown parameter${unknown.length > 1 ? "s" : ""}: ${unknown.join(", ")}. This job takes: ${job.params.map((p2) => p2.name).join(", ") || "none"}.`);
+  const result = {};
+  for (const param of job.params) result[param.name] = values[param.name] == null ? param.default : coerce(param, values[param.name]);
+  return result;
+}
 function saveJob(input) {
   if (!input.name.trim()) throw new Error("A job needs a name.");
   if (!input.prompt.trim()) throw new Error("A job needs a prompt.");
@@ -36885,12 +36935,14 @@ function saveJob(input) {
     }
   }
   const id = input.id ?? nanoid(10);
-  const token = getJob(id)?.token ?? nanoid(32);
+  const existing = getJob(id);
+  const params = input.params === void 0 && existing ? existing.params : checkParams(input.params);
+  const token = existing?.token ?? nanoid(32);
   db.prepare(
-    `INSERT INTO jobs (id, name, kind, schedule, prompt, category, preset_id, token, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `INSERT INTO jobs (id, name, kind, schedule, prompt, category, preset_id, params, token, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
      ON CONFLICT(id) DO UPDATE SET name = excluded.name, kind = excluded.kind, schedule = excluded.schedule, prompt = excluded.prompt,
-       category = excluded.category, preset_id = excluded.preset_id, enabled = excluded.enabled, updated_at = excluded.updated_at`
-  ).run(id, input.name.trim(), input.kind, schedule, input.prompt, input.category ?? "auto", input.presetId || null, token, input.enabled === false ? 0 : 1, now(), now());
+       category = excluded.category, preset_id = excluded.preset_id, params = excluded.params, enabled = excluded.enabled, updated_at = excluded.updated_at`
+  ).run(id, input.name.trim(), input.kind, schedule, input.prompt, input.category ?? "auto", input.presetId || null, JSON.stringify(params), token, input.enabled === false ? 0 : 1, now(), now());
   schedule_(id);
   broadcast("jobs", {});
   return getJob(id);
@@ -36935,8 +36987,9 @@ function stopScheduler() {
     crons.delete(key);
   }
 }
-function renderJobPrompt(template, payload) {
+function renderJobPrompt(template, payload, params) {
   const values = { now: now(), payload: JSON.stringify(payload ?? {}, null, 2) };
+  for (const [name, value] of Object.entries(params)) values[name] = String(value);
   const walk = (value, prefix) => {
     if (value && typeof value === "object" && !Array.isArray(value)) {
       for (const [key, inner] of Object.entries(value)) walk(inner, `${prefix}.${key}`);
@@ -36950,15 +37003,17 @@ function listRuns(limit = 100) {
   return db.prepare("SELECT runs.*, jobs.name AS job_name FROM runs LEFT JOIN jobs ON jobs.id = runs.job_id ORDER BY runs.created_at DESC LIMIT ?").all(limit).map(toRun);
 }
 function enqueue(input) {
-  const prompt = input.job ? renderJobPrompt(input.job.prompt, input.payload) : input.prompt ?? "";
+  const params = input.job ? resolveParams(input.job, input.params) : {};
+  const prompt = input.job ? renderJobPrompt(input.job.prompt, input.payload, params) : input.prompt ?? "";
   if (!prompt.trim()) throw new Error("Nothing to run: the prompt is empty.");
   const id = nanoid(10);
-  db.prepare("INSERT INTO runs (id, job_id, source, prompt, category, status, created_at) VALUES (?, ?, ?, ?, ?, 'queued', ?)").run(
+  db.prepare("INSERT INTO runs (id, job_id, source, prompt, category, status, params, created_at) VALUES (?, ?, ?, ?, ?, 'queued', ?, ?)").run(
     id,
     input.job?.id ?? null,
     input.source,
     prompt,
     input.category ?? input.job?.category ?? "auto",
+    Object.keys(params).length ? JSON.stringify(params) : null,
     now()
   );
   if (input.job) db.prepare("UPDATE jobs SET last_run_at = ? WHERE id = ?").run(now(), input.job.id);
@@ -37073,7 +37128,7 @@ function recoverRuns() {
   db.prepare("UPDATE interactions SET status = 'closed', answered_by = 'hub restart' WHERE status = 'open'").run();
   return stranded;
 }
-var crons, cronKey, toJob, toRun, IN_LINE, advancing, waitingForClaude;
+var crons, cronKey, toJob, PARAM_TYPES, RESERVED2, toRun, IN_LINE, advancing, waitingForClaude;
 var init_jobs = __esm({
   "server/src/jobs.ts"() {
     "use strict";
@@ -37098,12 +37153,15 @@ var init_jobs = __esm({
       prompt: row.prompt,
       category: row.category,
       presetId: row.preset_id,
+      params: parseJson(row.params, []),
       token: row.token,
       enabled: Boolean(row.enabled),
       lastRunAt: row.last_run_at,
       nextRunAt: crons.get(cronKey(row.id))?.nextRun()?.toISOString() ?? null,
       createdAt: row.created_at
     });
+    PARAM_TYPES = ["number", "string", "boolean"];
+    RESERVED2 = ["now", "payload"];
     toRun = (row) => ({
       id: row.id,
       jobId: row.job_id,
@@ -37114,6 +37172,7 @@ var init_jobs = __esm({
       status: row.status,
       sessionId: row.session_id,
       resume: Boolean(row.resume),
+      params: parseJson(row.params, null),
       createdAt: row.created_at,
       startedAt: row.started_at,
       finishedAt: row.finished_at
@@ -38176,7 +38235,7 @@ api.post(
   wrap2((req) => {
     const job = getJob(req.params.id);
     if (!job) throw new Error("No such job.");
-    return enqueue({ job, source: "manual", payload: req.body?.payload ?? {} });
+    return enqueue({ job, source: "manual", payload: req.body?.payload ?? {}, params: req.body?.params });
   })
 );
 api.post(
@@ -38192,7 +38251,7 @@ api.post(
       res.status(409).json({ error: "This trigger is disabled." });
       return;
     }
-    const { run: run4, position } = enqueue({ job, source: "webhook", payload: req.body ?? {} });
+    const { run: run4, position } = enqueue({ job, source: "webhook", payload: req.body ?? {}, params: req.body?.params });
     return { runId: run4.id, status: run4.status, position };
   })
 );