@pmate/cli 0.20.9 → 0.20.11

package/dist/index.d.ts

@@ -418,6 +418,17 @@ type AgentCommandArgs = {
     name: string;
     baseUrl?: string;
     json: boolean;
+} | {
+    type: Command.Agent;
+    action: "call";
+    namespace: string;
+    name: string;
+    payload?: Record<string, unknown>;
+    filePath?: string;
+    baseUrl?: string;
+    hubBaseUrl?: string;
+    from?: string;
+    json: boolean;
 } | {
     type: Command.Agent;
     action: "rename";

package/dist/index.js

@@ -12683,12 +12683,15 @@ var init_AgentLlmClient = __esm({
       }
       async prompt(name, payload, namespace = DEFAULT_NAMESPACE) {
         const agentId = `${namespace}:${name}`;
+        return this.call(agentId, payload);
+      }
+      async call(agentId, payload, options) {
         const client = new import_agent_sdk.AgentClient({
-          baseUrl: this.hubBaseUrl,
+          baseUrl: options?.hubBaseUrl ?? this.hubBaseUrl,
           agentService: this.agentService
         });
         try {
-          await client.login(this.from, {
+          await client.login(options?.from ?? this.from, {
             token: this.token
           });
           const result = await client.prompt({
@@ -19108,6 +19111,7 @@ function parseMessageText(raw) {
 // src/commands/AgentCommandHandler.ts
 var import_node_fs11 = require("fs");
 var import_node_path16 = __toESM(require("path"));
+init_AgentLlmClient();
 init_sessionStore();
 
 // src/storeClient.ts
@@ -19429,12 +19433,12 @@ var AgentCommandHandler = class {
         return;
       }
       case "list": {
-        const items = args.namespace ? (await this.request(
+        const items = (await this.request(
           baseUrl,
           token,
           "GET",
-          `/agents?namespace=${encodeURIComponent(args.namespace)}`
-        )).items : await this.listAgentsAcrossNamespaces(baseUrl, token);
+          args.namespace ? `/agents?namespace=${encodeURIComponent(args.namespace)}` : "/agents/all"
+        )).items;
         this.renderList(items, args.json);
         return;
       }
@@ -19476,6 +19480,25 @@ var AgentCommandHandler = class {
         this.renderJson(record, args.json);
         return;
       }
+      case "call": {
+        const payload = args.filePath ? this.readJsonObjectFile(args.filePath) : args.payload;
+        const client = this.createRuntimeClient({
+          token,
+          agentApiBaseUrl: baseUrl,
+          hubBaseUrl: args.hubBaseUrl,
+          from: args.from
+        });
+        const result = await client.call(
+          formatNamespacedDisplayId(args.namespace, args.name),
+          payload,
+          {
+            hubBaseUrl: args.hubBaseUrl,
+            from: args.from
+          }
+        );
+        this.renderCallResult(result, args.json);
+        return;
+      }
       case "delete": {
         const record = await this.request(
           baseUrl,
@@ -19547,6 +19570,14 @@ var AgentCommandHandler = class {
       throw new Error(`Invalid JSON in ${absolutePath}: ${message}`);
     }
   }
+  readJsonObjectFile(filePath) {
+    const parsed = this.readJsonFile(filePath);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      const absolutePath = import_node_path16.default.resolve(process.cwd(), filePath);
+      throw new Error(`Invalid JSON in ${absolutePath}: expected an object`);
+    }
+    return parsed;
+  }
   async request(baseUrl, token, method, pathname, body) {
     const response = await fetch(`${baseUrl}${pathname}`, {
       method,
@@ -19567,35 +19598,6 @@ var AgentCommandHandler = class {
     }
     return payload.data;
   }
-  async listAgentsAcrossNamespaces(baseUrl, token) {
-    const namespacesResponse = await this.request(
-      baseUrl,
-      token,
-      "GET",
-      "/agents/namespaces"
-    );
-    const namespaces = namespacesResponse.items.map((item) => item.namespace?.trim()).filter((value) => Boolean(value));
-    if (namespaces.length === 0) {
-      return [];
-    }
-    const listResponses = await Promise.all(
-      namespaces.map(async (namespace) => {
-        const response = await this.request(
-          baseUrl,
-          token,
-          "GET",
-          `/agents?namespace=${encodeURIComponent(namespace)}`
-        );
-        return response.items;
-      })
-    );
-    const merged = listResponses.flat();
-    const deduped = /* @__PURE__ */ new Map();
-    for (const item of merged) {
-      deduped.set(item.id, item);
-    }
-    return Array.from(deduped.values());
-  }
   renderList(items, asJson) {
     if (asJson) {
       ui.plain(JSON.stringify(items, null, 2));
@@ -19618,6 +19620,24 @@ var AgentCommandHandler = class {
     }
     ui.plain(JSON.stringify(value, null, 2));
   }
+  renderCallResult(value, asJson) {
+    if (value === null) {
+      if (asJson) {
+        this.renderJson(value, true);
+        return;
+      }
+      ui.warn("Agent returned no result.");
+      return;
+    }
+    if (typeof value === "string" && !asJson) {
+      ui.plain(value);
+      return;
+    }
+    this.renderJson(value, true);
+  }
+  createRuntimeClient(options) {
+    return new AgentLlmClient(options);
+  }
   renderNamespaces(items, asJson) {
     if (asJson) {
       ui.plain(JSON.stringify(items, null, 2));
@@ -21581,7 +21601,7 @@ function parseAgentArgs(tokens) {
   const rawAction = rest.shift();
   const action = rawAction === "view" ? "view" : rawAction;
   if (!action) {
-    throw new Error("Missing agent action. Use: agent namespaces|list|get|view|create|update|rename|delete");
+    throw new Error("Missing agent action. Use: agent namespaces|list|get|view|create|update|rename|call|delete");
   }
   let baseUrl;
   let json = false;
@@ -21745,6 +21765,62 @@ function parseAgentArgs(tokens) {
       json
     };
   }
+  if (action === "call") {
+    const ref = rest.shift();
+    if (!ref) {
+      throw new Error(
+        "Usage: agent call <ns:objectId> [--payload <json>] [--file <path>] [--base-url <url>] [--hub-base-url <url>] [--from <id>] [--json]"
+      );
+    }
+    const parsed = parseNamespacedRef(ref, { entityLabel: "agent ref" });
+    let filePath;
+    let payload;
+    let hubBaseUrl;
+    let from;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--payload":
+          if (filePath) {
+            throw new Error("Agent call accepts either --payload or --file, not both.");
+          }
+          payload = parseJsonObject(requireValue(rest, token), token);
+          break;
+        case "--file":
+          if (payload) {
+            throw new Error("Agent call accepts either --payload or --file, not both.");
+          }
+          filePath = requireValue(rest, token);
+          break;
+        case "--base-url":
+          baseUrl = requireValue(rest, token);
+          break;
+        case "--hub-base-url":
+          hubBaseUrl = requireValue(rest, token);
+          break;
+        case "--from":
+          from = requireValue(rest, token);
+          break;
+        case "--json":
+          json = true;
+          break;
+        default:
+          throw new Error(`Unknown agent call option: ${token}`);
+      }
+    }
+    return {
+      type: "agent" /* Agent */,
+      action,
+      namespace: parsed.namespace,
+      name: parsed.objectId,
+      payload,
+      filePath,
+      baseUrl,
+      hubBaseUrl,
+      from,
+      json
+    };
+  }
   if (action === "rename") {
     let namespace;
     let from;
@@ -21803,6 +21879,19 @@ function parseBareRenameId(value, entityName) {
   }
   return normalized;
 }
+function parseJsonObject(value, optionName) {
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid JSON for ${optionName}: ${message}`);
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`Invalid JSON for ${optionName}: expected an object.`);
+  }
+  return parsed;
+}
 
 // src/nsCommandParser.ts
 var DEFAULT_CHAIN = "pmate";
@@ -22806,7 +22895,7 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.cyan("collect")}          Collect threads/messages from Electron chat app via CDP`,
   `  ${import_chalk4.default.gray("                  --list [--endpoint <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  --thread <name> [--endpoint <url>] [--json]")}`,
-  `  ${import_chalk4.default.cyan("agent")}            Manage agent registry entries via agent-ui-api`,
+  `  ${import_chalk4.default.cyan("agent")}            Manage agent registry entries and call agents for debugging`,
   `  ${import_chalk4.default.gray("                  namespaces [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  list [--namespace <ns>] [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
@@ -22814,8 +22903,9 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.gray("                  create [<namespace>] --file <path> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  call <ns:objectId> [--payload <json>] [--file <path>] [--base-url <url>] [--hub-base-url <url>] [--from <id>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk4.default.gray("                  list defaults to all namespaces; create defaults to namespace: pmate; default base URL: https://agent-api.pmate.chat")}`,
+  `  ${import_chalk4.default.gray("                  list defaults to all namespaces; create defaults to namespace: pmate; default base URL: https://agent-api.pmate.chat; call uses pmate:cli session and default hub: https://hub.pmate.chat")}`,
   `  ${import_chalk4.default.cyan("ns")}               Manage registered namespaces`,
   `  ${import_chalk4.default.gray("                  list [--chain <chain>] [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  get <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/cli",
-  "version": "0.20.9",
+  "version": "0.20.11",
   "description": "CLI utilities for the pMate project",
   "license": "MIT",
   "bin": {