@aiaiai-pt/martha-cli 0.50.0 → 0.51.2

package/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https
 
 ## [Unreleased]
 
+## [0.51.2] — 2026-07-19
+
+### Fixed — selected-client local execution (#968)
+
+- `martha chat --client <non-default> --local-exec` now carries the selected
+  client through tool claims, tool results, and local screenshot/browser
+  artifact uploads, while chats without a selected client keep the existing
+  auth-default behavior.
+
+## [0.51.1] — 2026-07-17
+
+### Fixed — hosted embed cache migration (#955)
+
+- Hosted bundle URLs and generated HTML snippets now use the one-time `0.3.0`
+  cache key needed to escape the former immutable stable-file policy.
+- HTML snippets apply the same key to `stylesheet-url`, because the loader
+  query is not inherited by the sibling CSS request.
+
+## [0.51.0] — 2026-07-17
+
+### Added — customer-configurable agent display names (#951)
+
+- `martha agents create --display-name <name>` sets the customer-facing chat
+  identity without changing the stable technical agent key.
+- Agent YAML/JSON create and update files round-trip `display_name`; list and
+  detail output now show both the display name and technical key.
+
 ## [0.49.0] — 2026-07-15
 
 ### Added — UMS-gated second-party approval governance (#583 G1+G2)

package/dist/index.js

@@ -11119,7 +11119,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.50.0";
+var CLI_VERSION = "0.51.2";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -11549,12 +11549,19 @@ var agentsConfig = {
   },
   normalizeBody: normalizeAgentBody,
   extraCreateOptions: (cmd) => {
-    cmd.option("--name <name>", "Agent name").option("--reasoning <mode>", "Where the agent reasons: 'martha' (Martha-hosted, default) or " + "'self-hosted' (your service; reached via webhook)").option("--enable-host-runner", "Enable a host runner + mint a runner key: attach `martha runner` as this " + "agent's host executor (channel tool.* only). Alias: --runner-key").option("--runner-key", "Alias for --enable-host-runner").option("--model <model>", "LLM model (e.g. anthropic/claude-sonnet-4-6)").option("--provider <provider>", "LLM provider (anthropic, openai)").option("--prompt <text>", "System prompt").option("--description <text>", "Agent description").option("--temperature <n>", "Temperature (0-1)").option("--max-tokens <n>", "Max output tokens").option("--tags <tags>", "Capability domains (comma-separated)").option("--local-tools <tools>", "Local tools (comma-separated)").option("--type <type>", "Deprecated: use --reasoning. cloud=Martha-hosted, external=self-hosted").option("--auth <method>", "Deprecated: use --enable-host-runner. service-account (self-hosted only) or api-key");
+    cmd.option("--name <name>", "Stable technical agent key").option("--display-name <name>", "Customer-facing name shown in chat").option("--reasoning <mode>", "Where the agent reasons: 'martha' (Martha-hosted, default) or " + "'self-hosted' (your service; reached via webhook)").option("--enable-host-runner", "Enable a host runner + mint a runner key: attach `martha runner` as this " + "agent's host executor (channel tool.* only). Alias: --runner-key").option("--runner-key", "Alias for --enable-host-runner").option("--model <model>", "LLM model (e.g. anthropic/claude-sonnet-4-6)").option("--provider <provider>", "LLM provider (anthropic, openai)").option("--prompt <text>", "System prompt").option("--description <text>", "Agent description").option("--temperature <n>", "Temperature (0-1)").option("--max-tokens <n>", "Max output tokens").option("--tags <tags>", "Capability domains (comma-separated)").option("--local-tools <tools>", "Local tools (comma-separated)").option("--type <type>", "Deprecated: use --reasoning. cloud=Martha-hosted, external=self-hosted").option("--auth <method>", "Deprecated: use --enable-host-runner. service-account (self-hosted only) or api-key");
   },
   buildInlineBody: (opts) => {
     if (!opts.name)
       return null;
     const body = { name: opts.name };
+    if (opts.displayName !== undefined) {
+      const displayName = String(opts.displayName).trim();
+      if (!displayName) {
+        throw new CLIError("--display-name must contain visible text", 4 /* Validation */);
+      }
+      body.display_name = displayName;
+    }
     if (opts.description)
       body.description = opts.description;
     if (opts.prompt)
@@ -11607,6 +11614,10 @@ var agentsConfig = {
   },
   listColumns: [
     { header: "NAME", accessor: (item) => String(item.name ?? "") },
+    {
+      header: "DISPLAY NAME",
+      accessor: (item) => String(item.display_name ?? "-")
+    },
     {
       header: "MODEL",
       accessor: (item) => {
@@ -11621,8 +11632,11 @@ var agentsConfig = {
     { header: "VER", accessor: (item) => String(item.version ?? 1) }
   ],
   renderDetail: (agent) => {
-    console.log(source_default.bold(`Agent: ${agent.name}
+    console.log(source_default.bold(`Agent: ${agent.display_name ?? agent.name}
 `));
+    console.log(`  Technical key: ${agent.name}`);
+    if (agent.display_name)
+      console.log(`  Display name:  ${agent.display_name}`);
     if (agent.description)
       console.log(`  ${agent.description}
 `);
@@ -13064,11 +13078,12 @@ function parseJobToolRequests(data, toolName) {
 }
 
 // src/lib/local-tool-runner.ts
-async function uploadImageArtifact(ctx, sessionId, png) {
+function selectedClientOptions(clientId) {
+  return clientId ? { params: { selected_client: clientId } } : undefined;
+}
+async function uploadImageArtifact(ctx, sessionId, png, clientId) {
   try {
-    const mint = await ctx.api.post(`/api/chat/${encodeURIComponent(sessionId)}/local-artifact-upload`, {
-      content_type: "image/png"
-    });
+    const mint = await ctx.api.post(`/api/chat/${encodeURIComponent(sessionId)}/local-artifact-upload`, { content_type: "image/png" }, selectedClientOptions(clientId));
     const put = await fetch(mint.upload_url, {
       method: "PUT",
       headers: { "Content-Type": "image/png" },
@@ -13184,7 +13199,7 @@ async function resolveHostScreenshot(ctx, sessionId, req, state) {
   } catch (e) {
     return { error: true, message: `screenshot failed: ${String(e)}` };
   }
-  const uploaded = await uploadImageArtifact(ctx, sessionId, png);
+  const uploaded = await uploadImageArtifact(ctx, sessionId, png, state.clientId);
   if ("error" in uploaded)
     return { error: true, message: uploaded.error };
   return {
@@ -13211,7 +13226,7 @@ async function resolveHostBrowser(ctx, sessionId, req, state) {
   if ("error" in result)
     return { error: true, message: result.message };
   if ("png" in result) {
-    const uploaded = await uploadImageArtifact(ctx, sessionId, result.png);
+    const uploaded = await uploadImageArtifact(ctx, sessionId, result.png, state.clientId);
     if ("error" in uploaded)
       return { error: true, message: uploaded.error };
     return {
@@ -13438,27 +13453,29 @@ function createLocalExecState(opts) {
     cwd: opts.cwd,
     autoYes: opts.autoYes,
     localAgent: opts.localAgent,
+    clientId: opts.clientId,
     handled: new Set,
     journal: new Journal(opts.cwd),
     secrets: new Map,
     claimed: new Set
   };
 }
-function makeChatTransport(ctx, sessionId) {
+function makeChatTransport(ctx, sessionId, clientId) {
   const base = `/api/chat/${encodeURIComponent(sessionId)}`;
+  const requestOptions = selectedClientOptions(clientId);
   return {
     async claim(toolCallId, secretHash) {
       await ctx.api.post(`${base}/tool-claim`, {
         tool_call_id: toolCallId,
         secret_hash: secretHash
-      });
+      }, requestOptions);
     },
     async postResult(toolCallId, result, execSecret) {
       await ctx.api.post(`${base}/tool-result`, {
         tool_call_id: toolCallId,
         result,
         ...execSecret !== undefined ? { exec_secret: execSecret } : {}
-      });
+      }, requestOptions);
     }
   };
 }
@@ -13559,7 +13576,8 @@ async function sendMessage(ctx, sessionId, message, opts = {}) {
   const localExecState = opts.localExec ? createLocalExecState({
     cwd: opts.localExec.cwd,
     autoYes: opts.localExec.autoYes,
-    localAgent: opts.localExec.agent
+    localAgent: opts.localExec.agent,
+    clientId: opts.clientId
   }) : null;
   const reqBody = { content: message };
   if (opts.localExec)
@@ -13613,7 +13631,7 @@ async function sendMessage(ctx, sessionId, message, opts = {}) {
             if (opts.onToolStatus)
               opts.onToolStatus(event.data);
             if (localExecState) {
-              await handleToolStatusData(ctx, sessionId, event.data, localExecState, makeChatTransport(ctx, sessionId));
+              await handleToolStatusData(ctx, sessionId, event.data, localExecState, makeChatTransport(ctx, sessionId, opts.clientId));
             }
             break;
           case "clear":
@@ -18877,6 +18895,7 @@ init_errors();
 
 // src/lib/embed.ts
 init_errors();
+var HOSTED_EMBED_CACHE_KEY = "0.3.0";
 var EMBED_FEATURE_KEYS = [
   "uploads",
   "history",
@@ -18943,12 +18962,13 @@ function getEmbedAssetBaseUrl(apiUrl, override) {
 }
 function bundleUrls(assetBaseUrl) {
   const base = normalizeAssetBaseUrl(assetBaseUrl);
+  const asset = (filename) => `${base}${filename}?v=${HOSTED_EMBED_CACHE_KEY}`;
   return {
-    webComponent: `${base}martha-chat.ce.js`,
-    esm: `${base}martha-chat.es.js`,
-    react: `${base}martha-chat.react.js`,
-    svelte: `${base}martha-chat.svelte.js`,
-    css: `${base}martha-chat.css`
+    webComponent: asset("martha-chat.ce.js"),
+    esm: asset("martha-chat.es.js"),
+    react: asset("martha-chat.react.js"),
+    svelte: asset("martha-chat.svelte.js"),
+    css: asset("martha-chat.css")
   };
 }
 function normalizeOrigin(input) {
@@ -19130,7 +19150,8 @@ function renderHtmlSnippet(options) {
   const urls = bundleUrls(options.assetBaseUrl);
   const attrs = [
     `api-url=${jsString(options.apiUrl)}`,
-    `client-key=${jsString(options.clientKey)}`
+    `client-key=${jsString(options.clientKey)}`,
+    `stylesheet-url=${jsString(urls.css)}`
   ];
   if (options.mode === "launcher")
     attrs.push("launcher");

package/package.json

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