@astralform/js 8.3.0 → 8.5.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

@@ -404,7 +404,31 @@ function toMessage(m) {
     content: m.content,
     parentId: m.parent_id,
     status: "complete",
-    createdAt: m.created_at
+    createdAt: m.created_at,
+    // Server-joined result typing. `?? undefined` rather than `?? null` so an
+    // absent field and an explicit null both read as "the server said nothing",
+    // which is the one distinction a renderer actually makes here.
+    toolCalls: m.tool_calls?.map(toToolCallRequest) ?? void 0,
+    sources: m.sources?.map(toToolSource) ?? void 0,
+    durationMs: m.duration_ms ?? void 0,
+    isError: m.is_error ?? void 0,
+    deniedBy: m.denied_by ?? void 0,
+    denialKind: m.denial_kind ?? void 0
+  };
+}
+function toToolSource(s) {
+  return { title: s.title, url: s.url, snippet: s.snippet };
+}
+function toToolCallRequest(t) {
+  return {
+    callId: t.call_id,
+    toolName: t.tool_name,
+    displayName: t.display_name,
+    description: t.description,
+    arguments: t.arguments ?? {},
+    isClientTool: t.is_client_tool ?? false,
+    toolCategory: t.tool_category,
+    iconUrl: t.icon_url
   };
 }
 var AstralformClient = class {
@@ -855,6 +879,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);