@aiaiai-pt/martha-cli 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https
 
 ## [Unreleased]
 
+## [0.10.0] — 2026-06-10
+
+### Added — #540 Phase 2.0/2.1 chat copilot + task operator
+- `martha init --agent` provisions a personal **chat copilot** alongside the run-as bootstrap: a `cloud` agent (no extra credentials) linked to your client, with the intent's tools granted to the **agent** surface (where agent grants fire in chat). `--agent-name` names it; `--model` overrides the model (defaults to the platform default). Persists `default_agent` to the profile.
+- `martha chat` now defaults to your bootstrapped client + copilot so its tools work out of the box; `--agent <name>` selects a specific copilot.
+- **Task operator**: with the `tasks` intent, the copilot can `create_task` / `list_tasks` / `get_task` — tasks run on Martha's task pipeline and are scoped to the copilot's own tasks. (Backend platform functions; surfaced through chat.)
+
 ## [0.9.1] — 2026-06-10
 
 ### Fixed

package/dist/index.js

@@ -11051,7 +11051,7 @@ import { createInterface as createInterface2 } from "node:readline";
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.9.1";
+var CLI_VERSION = "0.10.0";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -11204,8 +11204,13 @@ async function sendMessage(ctx, sessionId, message, opts = {}) {
     signal: opts.signal,
     timeout: opts.timeoutMs ?? DEFAULT_CHAT_TIMEOUT_MS
   };
-  if (opts.clientId) {
-    reqOpts.params = { selected_client: opts.clientId };
+  if (opts.clientId || opts.agentName) {
+    const params = {};
+    if (opts.clientId)
+      params.selected_client = opts.clientId;
+    if (opts.agentName)
+      params.selected_agent = opts.agentName;
+    reqOpts.params = params;
   }
   const res = await ctx.api.postRaw(`/api/chat/${encodeURIComponent(sessionId)}`, { content: message }, reqOpts);
   const contentType = res.headers.get("content-type") ?? "";
@@ -11375,7 +11380,7 @@ async function showHistoryPicker(ctx, rl) {
   }
   return data.items[idx].session_id;
 }
-async function runRepl(ctx, initialSessionId, clientId, showTools, timeoutMs) {
+async function runRepl(ctx, initialSessionId, clientId, agentName, showTools, timeoutMs) {
   let sessionId = initialSessionId;
   process.stderr.write(source_default.dim(`martha v${CLI_VERSION} | session: ${sessionId.slice(0, 8)}...
 `));
@@ -11483,7 +11488,8 @@ async function runRepl(ctx, initialSessionId, clientId, showTools, timeoutMs) {
         onClear: showTools ? () => process.stderr.write(source_default.dim(`  --- tool iteration ---
 `)) : undefined,
         signal: activeAbort.signal,
-        clientId
+        clientId,
+        agentName
       });
       if (!result.aborted) {
         process.stdout.write(`
@@ -11511,7 +11517,7 @@ Error: ${err instanceof Error ? err.message : String(err)}
   process.stderr.write(`
 `);
 }
-async function runOneShot(ctx, sessionId, message, isJson, clientId, showTools, timeoutMs) {
+async function runOneShot(ctx, sessionId, message, isJson, clientId, agentName, showTools, timeoutMs) {
   const toolCalls = [];
   function recordToolStatus(data) {
     try {
@@ -11533,6 +11539,7 @@ async function runOneShot(ctx, sessionId, message, isJson, clientId, showTools,
   }
   const { response } = await sendMessage(ctx, sessionId, message, {
     clientId,
+    agentName,
     timeoutMs,
     onToolStatus: isJson ? recordToolStatus : showTools ? (data) => {
       recordToolStatus(data);
@@ -11557,7 +11564,7 @@ async function runOneShot(ctx, sessionId, message, isJson, clientId, showTools,
   }
 }
 function registerChatCommand(program2) {
-  program2.command("chat").description("Chat with a Martha agent").option("--session <id>", "Resume an existing session").option("--client <nameOrId>", "Use a specific client (name or ID)").option("--message <text>", "Send a single message (non-interactive)").option("--show-tools", "Show tool calls and results during chat").option("--timeout <seconds>", "Per-message HTTP timeout in seconds (default: 600)").action(async (opts) => {
+  program2.command("chat").description("Chat with a Martha agent").option("--session <id>", "Resume an existing session").option("--client <nameOrId>", "Use a specific client (name or ID)").option("--agent <name>", "Drive the chat with a specific copilot agent (defaults to profile.default_agent)").option("--message <text>", "Send a single message (non-interactive)").option("--show-tools", "Show tool calls and results during chat").option("--timeout <seconds>", "Per-message HTTP timeout in seconds (default: 600)").action(async (opts) => {
     const ctx = createContext({
       profileOverride: program2.opts().profile,
       verbose: program2.opts().verbose
@@ -11580,6 +11587,10 @@ function registerChatCommand(program2) {
         clientId = String(match.id);
       }
     }
+    if (!clientId && ctx.profile.default_client) {
+      clientId = ctx.profile.default_client;
+    }
+    const agentName = opts.agent ?? ctx.profile.default_agent;
     let sessionId;
     if (opts.session) {
       sessionId = opts.session;
@@ -11589,12 +11600,12 @@ function registerChatCommand(program2) {
     const showTools = !!opts.showTools;
     const timeoutMs = opts.timeout ? parseTimeoutSeconds(opts.timeout) * 1000 : undefined;
     if (opts.message) {
-      await runOneShot(ctx, sessionId, opts.message, isJson, clientId, showTools, timeoutMs);
+      await runOneShot(ctx, sessionId, opts.message, isJson, clientId, agentName, showTools, timeoutMs);
     } else {
       if (isJson) {
         throw new CLIError("The --json flag requires --message for non-interactive mode.", 4 /* Validation */, 'Example: martha --json chat --message "hello"');
       }
-      await runRepl(ctx, sessionId, clientId, showTools, timeoutMs);
+      await runRepl(ctx, sessionId, clientId, agentName, showTools, timeoutMs);
     }
   });
 }
@@ -17732,26 +17743,36 @@ Provision an access principal now so calls just work?`, true);
   if (intents.length === 0 && workflows.length === 0 && functions.length === 0) {
     throw new CLIError("Nothing to grant: declare at least one --intent (rag/documents/workflows/custom) or a --workflow/--function.", 4 /* Validation */);
   }
+  let wantAgent = mode === "human" && !!opts.agent;
+  if (mode === "human" && !opts.agent && interactive) {
+    wantAgent = await askYesNo(`
+  Also set up a chat copilot you can talk to (martha chat)?`, true);
+  }
   const ctx = createContext({ profileOverride: profileName });
   if (opts.apiUrl)
     ctx.profile.api_url = opts.apiUrl;
   await ensureAuthenticated(ctx, interactive, jsonMode);
   if (!jsonMode) {
     console.log();
-    console.log(source_default.dim(`  Provisioning ${mode === "integration" ? "an integration service account" : "your access principal"}…`));
+    console.log(source_default.dim(`  Provisioning ${mode === "integration" ? "an integration service account" : "your access principal"}${wantAgent ? " + copilot" : ""}…`));
   }
   const body = {
     mode,
     intents,
     workflows,
     functions,
-    ...opts.label ? { label: opts.label } : {}
+    ...opts.label ? { label: opts.label } : {},
+    ...wantAgent ? { agent: true } : {},
+    ...wantAgent && opts.agentName ? { agent_name: opts.agentName } : {},
+    ...wantAgent && opts.model ? { model: opts.model } : {}
   };
   const resp = await ctx.api.post("/api/admin/definitions/principals/bootstrap", body);
   if (mode === "human" && resp.client_key) {
     const cfg = loadConfig();
     if (cfg.profiles[profileName]) {
       cfg.profiles[profileName].default_client = resp.client_key;
+      if (resp.agent)
+        cfg.profiles[profileName].default_agent = resp.agent.name;
       saveConfig(cfg);
     }
   }
@@ -17799,6 +17820,15 @@ function printBootstrapResult(resp, profileName) {
   for (const s of resp.skipped) {
     console.log(source_default.yellow(`  Skipped ${s.name} — ${s.reason}`));
   }
+  if (resp.agent) {
+    const a = resp.agent;
+    console.log();
+    const averb = a.adopted ? "Using existing" : "Created";
+    console.log(source_default.green(`  ${averb} copilot ${source_default.bold(a.name)}.`));
+    if (a.granted_functions.length > 0) {
+      console.log(`    Copilot tools: ${source_default.cyan(a.granted_functions.join(", "))}`);
+    }
+  }
   if (resp.service_account) {
     const sa = resp.service_account;
     console.log();
@@ -17813,6 +17843,9 @@ function printBootstrapResult(resp, profileName) {
     console.log(source_default.dim(`  Profile ${source_default.cyan(profileName)} will now run as this client.`));
     console.log();
     console.log(source_default.dim("  Next:"));
+    if (resp.agent) {
+      console.log(source_default.dim('    martha chat "what can you do?"'));
+    }
     console.log(source_default.dim("    martha workflows list"));
     console.log(source_default.dim("    martha workflows execute <name> --inputs '{}'"));
   }
@@ -17869,7 +17902,7 @@ async function askIntents() {
   return parseIntents(raw);
 }
 function registerInitCommand(program2) {
-  program2.command("init").description("Create or update a profile, and optionally bootstrap an access principal").option("--preset <name>", "Preset: cloud or local", "cloud").option("--name <name>", "Profile name (defaults to preset name)").option("--force", "Overwrite an existing profile").option("--api-url <url>", "Override the API URL").option("--keycloak-url <url>", "Override the Keycloak URL").option("--keycloak-realm <realm>", "Override the Keycloak realm").option("--no-interactive", "Skip prompts; use defaults / overrides only").option("--bootstrap", "Provision an intent-scoped principal + grants after saving the profile").option("--mode <mode>", "Bootstrap mode: 'human' (your own client) or 'integration' (service account)").option("--intent <intents...>", "Usage buckets to grant: rag, documents, workflows, custom").option("--workflow <names...>", "Workflow name(s) to grant (workflows/custom intent)").option("--function <names...>", "Extra function name(s) to grant (custom intent)").option("--label <name>", "Integration mode: label for the SA client id").option("--yes", "Acknowledge non-interactive bootstrap side effects").action(async (opts, command) => {
+  program2.command("init").description("Create or update a profile, and optionally bootstrap an access principal").option("--preset <name>", "Preset: cloud or local", "cloud").option("--name <name>", "Profile name (defaults to preset name)").option("--force", "Overwrite an existing profile").option("--api-url <url>", "Override the API URL").option("--keycloak-url <url>", "Override the Keycloak URL").option("--keycloak-realm <realm>", "Override the Keycloak realm").option("--no-interactive", "Skip prompts; use defaults / overrides only").option("--bootstrap", "Provision an intent-scoped principal + grants after saving the profile").option("--mode <mode>", "Bootstrap mode: 'human' (your own client) or 'integration' (service account)").option("--intent <intents...>", "Usage buckets to grant: rag, documents, workflows, custom").option("--workflow <names...>", "Workflow name(s) to grant (workflows/custom intent)").option("--function <names...>", "Extra function name(s) to grant (custom intent)").option("--label <name>", "Integration mode: label for the SA client id").option("--agent", "Also provision a personal chat copilot (human mode) and set it as the default").option("--agent-name <name>", "Copilot agent name (defaults to copilot-{user})").option("--model <id>", "Copilot LLM model id (defaults to the platform default)").option("--yes", "Acknowledge non-interactive bootstrap side effects").action(async (opts, command) => {
     const globals = command.parent?.opts() ?? {};
     await initCommand({ ...opts, json: !!globals.json });
   });

package/package.json

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