sim 2.2.9-preview.208.1 → 2.2.9-preview.210.1

package/dist/index.js

@@ -17328,6 +17328,13 @@ var V2_OPERATIONS = {
   }
 };
 
+// src/runtime/called-operations.ts
+var CALLED_OPERATIONS = new WeakMap;
+function callsOperations(command, operations) {
+  CALLED_OPERATIONS.set(command, operations);
+  return command;
+}
+
 // src/commands/auth.ts
 var MAX_INTERACTIVE_WORKSPACES = 1000;
 function openBrowser(url) {
@@ -17848,7 +17855,7 @@ function presentVerification(verification) {
   }
 }
 function whoamiCommand() {
-  return new Command("whoami").description("Show the resolved profile, where each setting came from, and whether it works").option("--no-verify", "Skip the API check and only print the resolved settings").action(async (options, command) => {
+  const whoami = new Command("whoami").description("Show the resolved profile, where each setting came from, and whether it works").option("--no-verify", "Skip the API check and only print the resolved settings").action(async (options, command) => {
     const { client, profile } = clientFrom(command);
     const { sources } = profile;
     const authentication = presentAuthentication(sources.credential);
@@ -17897,6 +17904,7 @@ function whoamiCommand() {
     if (exitCode !== 0)
       setSoftExitCode(exitCode);
   });
+  return callsOperations(whoami, ["getMeta", "getWorkspace"]);
 }
 var PROFILE_COLUMNS = [
   { header: "", value: (row) => row.active ? styles3().green("*") : " " },
@@ -21295,7 +21303,7 @@ var UNKNOWN_OPTION_TOKEN = /^error: unknown option '(.+?)'/;
 function looksLikeAnId(token) {
   return token.length > 2 && !token.startsWith("--") && /^-[A-Za-z0-9_-]*[A-Z0-9][A-Za-z0-9_-]*$/.test(token);
 }
-function addArgumentExamples(command) {
+function addParseErrorGuidance(command) {
   const outputError = command.configureOutput().outputError;
   if (!outputError)
     throw new Error("Commander output formatter is not configured");
@@ -21309,12 +21317,16 @@ function addArgumentExamples(command) {
 `);
         return;
       }
-      if (command.registeredArguments.length === 0)
-        return;
       const token = UNKNOWN_OPTION_TOKEN.exec(message)?.[1];
-      if (!token || !looksLikeAnId(token))
+      if (!token)
         return;
-      write(`Example: ${commandPath(command)} -- ${token}
+      if (looksLikeAnId(token) && command.registeredArguments.length > 0) {
+        write(`Example: ${commandPath(command)} -- ${token}
+`);
+        return;
+      }
+      const flags = command.options.filter((option) => !option.hidden).map((option) => option.flags);
+      write(`Options for ${commandPath(command)}: ${flags.join(", ")}
 `);
     }
   });
@@ -21441,7 +21453,7 @@ function configureOperation(command, operation, spec) {
   return command;
 }
 function buildLeaf(operation, spec, leafName) {
-  return addArgumentExamples(configureOperation(new Command(leafName), operation, spec));
+  return addParseErrorGuidance(configureOperation(new Command(leafName), operation, spec));
 }
 function addRenamedCommand(groups, operation, spec, from, to) {
   const segments = from.split(" ");
@@ -21747,7 +21759,7 @@ function ignoreBrokenPipe(stream) {
   };
 }
 function attachChat(program) {
-  program.command("chat").description("Ask Sim and print the reply").argument("<message>", "What to ask Sim").allowExcessArguments(false).option("-c, --conversation <id>", "Continue the conversation with this ID").addHelpText("after", `
+  const chat = program.command("chat").description("Ask Sim and print the reply").argument("<message>", "What to ask Sim").allowExcessArguments(false).option("-c, --conversation <id>", "Continue the conversation with this ID").addHelpText("after", `
 Each turn prints the reply on stdout and the conversation ID on stderr; pass
 that ID back with -c to continue the same conversation. With --output json or
 yaml the reply is not streamed — the finished result is printed as one
@@ -21813,6 +21825,7 @@ Examples:
       restorePipeHandling?.();
     }
   });
+  callsOperations(chat, ["chat"]);
 }
 
 // src/commands/protocol/files-get.ts
@@ -22029,7 +22042,8 @@ function attachFileGet(files) {
   files.command("get").argument("<fileId>", "File whose content to read").allowExcessArguments(false).description("Download a file’s content to stdout or a local file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFile, { fileId }, options));
 }
 function attachFileVersionDownload(versions) {
-  versions.command("download").argument("<fileId>", "File identifier.").argument("<version>", "Version number.").allowExcessArguments(false).description("Download the content of one version of a file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, version, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFileVersion, { fileId, version }, options));
+  const download = versions.command("download").argument("<fileId>", "File identifier.").argument("<version>", "Version number.").allowExcessArguments(false).description("Download the content of one version of a file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, version, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFileVersion, { fileId, version }, options));
+  callsOperations(download, ["downloadFileVersion"]);
 }
 
 // src/transfer/upload-session.ts

package/dist/runtime/called-operations.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+import type { V2OperationName } from '../generated/v2-api';
+/**
+ * Records the v2 operations a hand-written command calls.
+ *
+ * A generated command is one operation and the command inventory finds it by path. A
+ * hand-written one is opaque until it says what it calls, and the inventory needs that
+ * to describe it truthfully, such as whether every call is open to a Mothership caller.
+ */
+export declare function callsOperations(command: Command, operations: readonly V2OperationName[]): Command;
+export declare function calledOperations(command: Command): readonly V2OperationName[] | undefined;

package/dist/runtime.js

@@ -17377,6 +17377,13 @@ var V2_OPERATIONS = {
   }
 };
 
+// src/runtime/called-operations.ts
+var CALLED_OPERATIONS = new WeakMap;
+function callsOperations(command, operations) {
+  CALLED_OPERATIONS.set(command, operations);
+  return command;
+}
+
 // src/commands/auth.ts
 var MAX_INTERACTIVE_WORKSPACES = 1000;
 function openBrowser(url) {
@@ -17897,7 +17904,7 @@ function presentVerification(verification) {
   }
 }
 function whoamiCommand() {
-  return new Command("whoami").description("Show the resolved profile, where each setting came from, and whether it works").option("--no-verify", "Skip the API check and only print the resolved settings").action(async (options, command) => {
+  const whoami = new Command("whoami").description("Show the resolved profile, where each setting came from, and whether it works").option("--no-verify", "Skip the API check and only print the resolved settings").action(async (options, command) => {
     const { client, profile } = clientFrom(command);
     const { sources } = profile;
     const authentication = presentAuthentication(sources.credential);
@@ -17946,6 +17953,7 @@ function whoamiCommand() {
     if (exitCode !== 0)
       setSoftExitCode(exitCode);
   });
+  return callsOperations(whoami, ["getMeta", "getWorkspace"]);
 }
 var PROFILE_COLUMNS = [
   { header: "", value: (row) => row.active ? styles3().green("*") : " " },
@@ -21344,7 +21352,7 @@ var UNKNOWN_OPTION_TOKEN = /^error: unknown option '(.+?)'/;
 function looksLikeAnId(token) {
   return token.length > 2 && !token.startsWith("--") && /^-[A-Za-z0-9_-]*[A-Z0-9][A-Za-z0-9_-]*$/.test(token);
 }
-function addArgumentExamples(command) {
+function addParseErrorGuidance(command) {
   const outputError = command.configureOutput().outputError;
   if (!outputError)
     throw new Error("Commander output formatter is not configured");
@@ -21358,12 +21366,16 @@ function addArgumentExamples(command) {
 `);
         return;
       }
-      if (command.registeredArguments.length === 0)
-        return;
       const token = UNKNOWN_OPTION_TOKEN.exec(message)?.[1];
-      if (!token || !looksLikeAnId(token))
+      if (!token)
         return;
-      write(`Example: ${commandPath(command)} -- ${token}
+      if (looksLikeAnId(token) && command.registeredArguments.length > 0) {
+        write(`Example: ${commandPath(command)} -- ${token}
+`);
+        return;
+      }
+      const flags = command.options.filter((option) => !option.hidden).map((option) => option.flags);
+      write(`Options for ${commandPath(command)}: ${flags.join(", ")}
 `);
     }
   });
@@ -21490,7 +21502,7 @@ function configureOperation(command, operation, spec) {
   return command;
 }
 function buildLeaf(operation, spec, leafName) {
-  return addArgumentExamples(configureOperation(new Command(leafName), operation, spec));
+  return addParseErrorGuidance(configureOperation(new Command(leafName), operation, spec));
 }
 function addRenamedCommand(groups, operation, spec, from, to) {
   const segments = from.split(" ");
@@ -21796,7 +21808,7 @@ function ignoreBrokenPipe(stream) {
   };
 }
 function attachChat(program) {
-  program.command("chat").description("Ask Sim and print the reply").argument("<message>", "What to ask Sim").allowExcessArguments(false).option("-c, --conversation <id>", "Continue the conversation with this ID").addHelpText("after", `
+  const chat = program.command("chat").description("Ask Sim and print the reply").argument("<message>", "What to ask Sim").allowExcessArguments(false).option("-c, --conversation <id>", "Continue the conversation with this ID").addHelpText("after", `
 Each turn prints the reply on stdout and the conversation ID on stderr; pass
 that ID back with -c to continue the same conversation. With --output json or
 yaml the reply is not streamed — the finished result is printed as one
@@ -21862,6 +21874,7 @@ Examples:
       restorePipeHandling?.();
     }
   });
+  callsOperations(chat, ["chat"]);
 }
 
 // src/commands/protocol/files-get.ts
@@ -22078,7 +22091,8 @@ function attachFileGet(files) {
   files.command("get").argument("<fileId>", "File whose content to read").allowExcessArguments(false).description("Download a file’s content to stdout or a local file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFile, { fileId }, options));
 }
 function attachFileVersionDownload(versions) {
-  versions.command("download").argument("<fileId>", "File identifier.").argument("<version>", "Version number.").allowExcessArguments(false).description("Download the content of one version of a file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, version, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFileVersion, { fileId, version }, options));
+  const download = versions.command("download").argument("<fileId>", "File identifier.").argument("<version>", "Version number.").allowExcessArguments(false).description("Download the content of one version of a file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, version, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFileVersion, { fileId, version }, options));
+  callsOperations(download, ["downloadFileVersion"]);
 }
 
 // src/transfer/upload-session.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.2.9-preview.208.1",
+  "version": "2.2.9-preview.210.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "imports": {