@aiaiai-pt/martha-cli 0.66.0 → 0.68.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project adheres to semver — `0.x` releases may include breaking changes between minor versions.
 
+## [0.68.0] — 2026-11-02
+
+### Added
+
+- `martha prompts version <name> -f <file> [-m <summary>] [--promote [environment]]` creates a new version of a prompt from the file's `content` (the server's `POST /prompts/{name}/versions`) and can promote it in the same step. Until now the CLI had no way to change a prompt's text.
+
+### Fixed
+
+- `martha prompts promote <name>` sends the version and environment the server requires (`--version`, default the newest; `--environment`, default `production`). It used to send `{}`, which the server rejects.
+- `martha prompts update -f <file>` refuses a file with `content` and points at `prompts version`. The update route only changes metadata, so the content was silently dropped while the CLI printed "Updated (v1)".
+
+## [0.67.0] — 2026-11-02
+
+### Added
+
+- `martha tasks note <id> <text>` posts a human-lane note to a task's activity log through the existing `POST /api/admin/tasks/{id}/activity` (entry type comment, author set by the server). Empty or whitespace-only text is refused before any request. `--json` prints the created entry (#2377).
+
+## [0.66.1] — 2026-11-01
+
+### Fixed
+
+- `martha runner` and `martha chat --local-exec` no longer run a host command when its gate cannot be claimed. A claim that fails with a network error or 5xx is retried twice, then the gate is skipped. Previously any non-409 failure fell through to execution, and the server, which enforces the claim, rejected the result, so the command ran with nowhere to report. This is what happened for runs Temporal no longer had (#1859).
+
 ## [0.66.0] — 2026-11-01
 
 ### Added

package/dist/index.js

@@ -11244,7 +11244,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.66.0";
+var CLI_VERSION = "0.68.0";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -13546,6 +13546,7 @@ async function resolveLocalAgent(sessionId, toolCallId, req, state) {
     log_path: result.log_path
   };
 }
+var CLAIM_RETRY = { delaysMs: [1000, 3000] };
 async function claimGate(sessionId, toolCallId, state, transport) {
   if (state.claimed.has(toolCallId))
     return true;
@@ -13553,19 +13554,25 @@ async function claimGate(sessionId, toolCallId, state, transport) {
   const secretHash = createHash2("sha256").update(secret).digest("hex");
   state.secrets.set(toolCallId, secret);
   await state.journal.recordSecret(sessionId, toolCallId, secret);
-  try {
-    await transport.claim(toolCallId, secretHash);
-    state.claimed.add(toolCallId);
-    return true;
-  } catch (e) {
-    if (e instanceof MarthaAPIError && e.status === 409) {
-      process.stderr.write(source_default.yellow(`[local-exec] gate ${toolCallId} is not pending (already resolved or timed out) — skipping execution
+  for (let attempt = 0;; attempt++) {
+    try {
+      await transport.claim(toolCallId, secretHash);
+      state.claimed.add(toolCallId);
+      return true;
+    } catch (e) {
+      if (e instanceof MarthaAPIError && e.status === 409) {
+        process.stderr.write(source_default.yellow(`[local-exec] gate ${toolCallId} is not pending (already resolved or timed out) — skipping execution
 `));
-      return false;
-    }
-    process.stderr.write(source_default.yellow(`[local-exec] failed to claim gate for ${toolCallId}: ${String(e)}
+        return false;
+      }
+      const final = e instanceof MarthaAPIError && e.status >= 400 && e.status < 500;
+      if (final || attempt >= CLAIM_RETRY.delaysMs.length) {
+        process.stderr.write(source_default.yellow(`[local-exec] failed to claim gate for ${toolCallId}: ${String(e)} — skipping execution
 `));
-    return true;
+        return false;
+      }
+      await new Promise((r) => setTimeout(r, CLAIM_RETRY.delaysMs[attempt]));
+    }
   }
 }
 async function postToolResult(toolCallId, result, label, transport, execSecret) {
@@ -17703,7 +17710,32 @@ var workflowsConfig = {
 };
 
 // src/commands/prompts.ts
+init_errors();
 var API_PATH2 = "/api/admin/definitions/prompts";
+var ENVIRONMENTS = ["production", "staging"];
+function promptVersionBody(file, changeSummary) {
+  const content = typeof file.content === "string" ? file.content : "";
+  if (!content.trim()) {
+    throw new CLIError("The file has no `content` to version", 4 /* Validation */, "A prompt version is the whole prompt text: put it under `content:`.");
+  }
+  return changeSummary ? { content, change_summary: changeSummary } : { content };
+}
+function promptPromoteBody(version, environment = "production") {
+  if (!Number.isInteger(version) || version < 1) {
+    throw new CLIError(`Invalid version '${version}'`, 4 /* Validation */);
+  }
+  if (!ENVIRONMENTS.includes(environment)) {
+    throw new CLIError(`Invalid environment '${environment}'`, 4 /* Validation */, `Use one of: ${ENVIRONMENTS.join(", ")}`);
+  }
+  return { version, environment };
+}
+function latestVersionNumber(data) {
+  const rows = (Array.isArray(data) ? data : data?.items) ?? [];
+  const nums = rows.map((r) => Number(r.version)).filter((n) => Number.isInteger(n) && n > 0);
+  if (!nums.length)
+    throw new CLIError("The prompt has no versions", 1 /* Error */);
+  return Math.max(...nums);
+}
 var promptsConfig = {
   typeName: "prompt",
   typeNamePlural: "prompts",
@@ -17785,16 +17817,43 @@ var promptsConfig = {
       params.is_protected = "true";
     return params;
   },
+  normalizeBody: (body) => {
+    if ("content" in body) {
+      throw new CLIError("`prompts update` changes metadata only and the server ignores `content`; change the text with " + "`martha prompts version <name> -f <file> --promote`", 4 /* Validation */);
+    }
+    return body;
+  },
   extraCommands: (parentCmd, getCtx, isJson) => {
-    parentCmd.command("promote <name>").description("Promote staging version to production").action(async (name) => {
+    const promote = async (ctx, name, version, environment) => ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/promote`, promptPromoteBody(version, environment));
+    parentCmd.command("version <name>").description("Create a new version of a prompt from a file's `content` (optionally promote it)").requiredOption("-f, --file <path>", "YAML or JSON file with a `content` field").option("-m, --summary <text>", "What changed in this version").option("--promote [environment]", "Promote the new version (default: production)").action(async (name, opts) => {
       const ctx = getCtx();
-      const result = await ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/promote`, {});
+      const body = promptVersionBody(loadDefinitionFile(opts.file), opts.summary);
+      const created = await ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/versions`, body);
+      const version = Number(created.version);
+      let promoted;
+      if (opts.promote) {
+        const env = typeof opts.promote === "string" ? opts.promote : "production";
+        promoted = await promote(ctx, name, version, env);
+      }
+      if (isJson()) {
+        console.log(JSON.stringify({ version: created, promoted }, null, 2));
+        return;
+      }
+      console.log(`Created '${name}' version ${version}`);
+      if (opts.promote) {
+        const env = typeof opts.promote === "string" ? opts.promote : "production";
+        console.log(`Promoted '${name}' version ${version} → ${env}`);
+      }
+    });
+    parentCmd.command("promote <name>").description("Promote a version (default: the newest) to an environment (default: production)").option("--version <n>", "Version number to promote", (v) => Number(v)).option("--environment <env>", "production | staging", "production").action(async (name, opts) => {
+      const ctx = getCtx();
+      const version = opts.version ?? latestVersionNumber(await ctx.api.get(`${API_PATH2}/${encodeURIComponent(name)}/versions`));
+      const result = await promote(ctx, name, version, opts.environment);
       if (isJson()) {
         console.log(JSON.stringify(result, null, 2));
         return;
       }
-      const prodVer = result.production_version_number ?? result.version;
-      console.log(`Promoted '${name}' staging → production (version ${prodVer})`);
+      console.log(`Promoted '${name}' version ${version} → ${opts.environment}`);
     });
     parentCmd.command("linked-collections <name>").description("List collections using this prompt as an extra prompt").action(async (name) => {
       const ctx = getCtx();
@@ -19262,6 +19321,13 @@ var priorityColor = (priority) => {
       return priority;
   }
 };
+function buildNoteBody(text) {
+  const content = text.trim();
+  if (!content) {
+    throw new CLIError("Note text must not be empty", 4 /* Validation */);
+  }
+  return { content };
+}
 function registerTaskCommands(program) {
   const cmd = program.command("tasks").description("Manage agent tasks");
   function getCtx() {
@@ -19418,6 +19484,15 @@ ${source_default.red("Error:")}`);
     }
     console.log(`Cancelled task ${id}`);
   });
+  cmd.command("note <id> <text>").description("Add a note to a task's activity log (human lane)").action(async (id, text) => {
+    const ctx = getCtx();
+    const entry = await ctx.api.post(`/api/admin/tasks/${encodeURIComponent(id)}/activity`, buildNoteBody(text));
+    if (isJson()) {
+      console.log(JSON.stringify(entry, null, 2));
+      return;
+    }
+    console.log(`Noted task ${id} (entry ${entry.id ?? "?"})`);
+  });
   cmd.command("poll").description("Poll for open tasks available for claiming").option("--agent <id>", "Filter by agent definition ID (human tokens only; ignored under agent auth)").option("--team <name>", "Poll a team's queue (name or UUID)").option("--limit <n>", "Max results", "10").action(async (opts) => {
     const ctx = getCtx();
     const limitN = parseInt(opts.limit, 10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/martha-cli",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "description": "Terminal-first client for the Martha AI platform",
   "homepage": "https://docs.martha.nomadriver.co",
   "repository": {