@thatopen/services 0.29.0 → 0.29.1

package/dist/cli.js

@@ -33678,6 +33678,9 @@ function projectIdFrom(input) {
   if (/^[0-9a-f]{24}$/i.test(trimmed)) return trimmed;
   return trimmed.match(/projects?\/([0-9a-f]{24})/i)?.[1] ?? null;
 }
+function appIdFrom(input) {
+  return input.trim().match(/apps\/([0-9a-f]{24})/i)?.[1];
+}
 class ChannelConnection {
   constructor(credentials) {
     this.credentials = credentials;
@@ -33838,12 +33841,12 @@ async function startMcpServer() {
   );
   server.tool(
     "send-app-command",
-    "Sends a command to a running That Open app through the platform channel and returns its reply. The app must be open in a browser tab and listening (apps scaffolded by `thatopen create` handle `ping` and `get-loaded-models` out of the box; apps declare their own commands in src/setups/channel.ts). While the user iterates with `thatopen serve`, omit app_id — the dev channel is keyed to the account; pass it once the app is published. `delivered: 0` means no tab of the app has the channel joined, usually because the app is simply not open — ask the user to open or reload the app tab.",
+    "Sends a command to a running That Open app through the platform channel and returns its reply. To USE an app the person has open (rather than build one), pass the URL of their app tab as `project` and send `help` first: the app answers with its own commands and how to use them, and that is the manual to follow. The app must be open in a browser tab and listening (apps scaffolded by `thatopen create` handle `ping` and `get-loaded-models` out of the box; apps declare their own commands in src/setups/channel.ts). While the user iterates with `thatopen serve`, omit app_id — the dev channel is keyed to the account; pass it once the app is published. `delivered: 0` means no tab of the app has the channel joined, usually because the app is simply not open — ask the user to open or reload the app tab.",
     {
-      project: stringType().describe("The project id (24 hex characters), or the project's dashboard URL."),
+      project: stringType().describe("The project id (24 hex characters), or the dashboard URL of the app tab: a URL with `/apps/<id>` gives the app_id too."),
       command: stringType().describe('The command name the app handles, e.g. "ping" or "get-loaded-models".'),
       payload: unknownType().optional().describe("JSON payload for the command, if it takes one."),
-      app_id: stringType().regex(/^[0-9a-f]{24}$/i).optional().describe("The published app's id. Omit while the app runs under `thatopen serve`."),
+      app_id: stringType().regex(/^[0-9a-f]{24}$/i).optional().describe("The published app's id. Omit while the app runs under `thatopen serve`, or when `project` is a URL that carries it."),
       wait_for_reply: booleanType().optional().describe("Default true. Set false for fire-and-forget notifications."),
       timeout_ms: numberType().int().min(1e3).max(MAX_REPLY_TIMEOUT_MS).optional().describe(`How long to wait for the app's reply. Default ${DEFAULT_REPLY_TIMEOUT_MS}.`)
     },
@@ -33856,7 +33859,7 @@ async function startMcpServer() {
       }
       const result = await connect2().send({
         projectId,
-        appId: args.app_id,
+        appId: args.app_id ?? appIdFrom(args.project),
         type: args.command,
         payload: args.payload,
         waitForReply: args.wait_for_reply !== false,