@astralform/js 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -554,6 +554,49 @@ var AstralformClient = class {
   async submitToolApproval(request) {
     await this.post("/v1/tool-approval", request);
   }
+  // --- End-user tool-permission self-service ---
+  /**
+   * List the current end user's own remembered tool-permission grants.
+   * Only `conversation`/`always` grants exist (`once` is never persisted).
+   * Paginated via `limit` (default 100, max 200) / `offset`; `total` lets you
+   * page through all of them.
+   */
+  async getMyToolPermissions(options) {
+    const params = new URLSearchParams();
+    if (options?.limit != null) {
+      const safeLimit = Math.max(
+        1,
+        Math.min(200, Math.floor(Number(options.limit)))
+      );
+      params.set("limit", String(safeLimit));
+    }
+    if (options?.offset != null) {
+      const safeOffset = Math.max(0, Math.floor(Number(options.offset)));
+      params.set("offset", String(safeOffset));
+    }
+    const qs = params.toString();
+    const raw = await this.get(`/v1/me/tool-permissions${qs ? `?${qs}` : ""}`);
+    return {
+      grants: raw.grants.map((g) => ({
+        id: g.id,
+        toolName: g.tool_name,
+        decision: g.decision,
+        scope: g.scope,
+        conversationId: g.conversation_id,
+        createdAt: g.created_at
+      })),
+      total: raw.total,
+      limit: raw.limit,
+      offset: raw.offset
+    };
+  }
+  /**
+   * Revoke one of the current end user's remembered grants by id. The agent
+   * will ask again the next time that tool is used.
+   */
+  async revokeToolPermission(id) {
+    await this.del(`/v1/me/tool-permissions/${encodeURIComponent(id)}`);
+  }
   // --- Conversation Assets ---
   mapAsset(raw) {
     return {