@astralform/js 8.3.0 → 8.4.0

package/README.md

@@ -320,6 +320,7 @@ const conversations = await client.getConversations();
 const messages = await client.getMessages("conversation-id");
 const agents = await client.getAgents();
 const skills = await client.getSkills();
+const commands = await client.listSkillCommands();
 
 // Job-based streaming
 const job = await client.createJob({ message: "Hello" });

package/dist/index.cjs

@@ -855,6 +855,37 @@ var AstralformClient = class {
     const raw = await this.get("/v1/skills");
     return raw.map((s) => camelizeKeys(s));
   }
+  /**
+   * List the slash commands the active agent offers — the system commands
+   * followed by its enabled skills. Backs the composer's "/" menu.
+   *
+   * @param surface Who will execute them. Omit for the server's default,
+   *   `"web"`: what `POST /v1/jobs` runs itself. `"telegram"` returns the
+   *   bot's commands under Telegram-valid names; `"all"` returns every
+   *   command, including those the other surfaces filter out — `surfaces` is
+   *   set on every row either way, and is what tells them apart here.
+   *
+   * The default surface is not sent as a query parameter. The server already
+   * defaults to `web`, so omitting it keeps the request byte-identical to
+   * what clients that call the raw path send today — same reasoning as
+   * {@link getConversationEvents}'s `toolOutputs`.
+   */
+  async listSkillCommands(surface) {
+    const query = surface && surface !== "web" ? `?surface=${surface}` : "";
+    const raw = await this.get(
+      `/v1/skills/commands${query}`
+    );
+    return raw.map((c) => {
+      const command = camelizeKeys(c);
+      return {
+        ...command,
+        displayName: command.displayName ?? "",
+        description: command.description ?? "",
+        argsHint: command.argsHint ?? "",
+        surfaces: command.surfaces ?? []
+      };
+    });
+  }
   async getConversationEvents(conversationId, jobId, options) {
     const params = new URLSearchParams();
     if (jobId) params.set("job_id", jobId);