Update are-na extension

extensions/are-na/CHANGELOG.md

@@ -1,10 +1,23 @@
 # Are.na Changelog
 
+## [Updates] - {PR_MERGE_DATE}
+
+- Migrated API integration to Are.na `v3` with unified pagination and error handling.
+- Added new commands:
+  - `Search Everything`
+  - `My Profile`
+  - `My Channels`
+- Upgraded discovery commands (channels, blocks, users) with sort controls and incremental pagination.
+- Added saved/recent search workflow in extension storage.
+- Added block management actions: edit, connect to channels, remove from current channel, and delete.
+- Added channel management actions: edit metadata/visibility, manage collaborators, and delete safeguards.
+- Added AI Extensions support for the extension
+
 ## [Show Channel Status] - 2025-07-07
 
 - "Search Channels" has an extra _status_ accessory (ref: [Issue #20037](https://github.com/raycast/extensions/issues/20037)):
-    1. private: `Icon.EyeDisabled` in `Red`,
-    2. public: `Icon.Eye` in `Green`,
-    3. closed: `Icon.Eye`,
+  1. private: `Icon.EyeDisabled` in `Red`,
+  2. public: `Icon.Eye` in `Green`,
+  3. closed: `Icon.Eye`,
 
-## [Initial Version] - 2025-05-16
+## [Initial Version] - 2025-05-16

extensions/are-na/README.md

@@ -6,57 +6,91 @@
 
 ---
 
-This extension allows you to interact with Are.na through raycast.
+This extension allows you to interact with Are.na from Raycast.
 
 Here is a list of features currently available with this extension.
 
 ## Features
 
+### Search Everything (New)
+
+Use **Search Everything** to query channels, blocks, and users in one command.
+You can save queries and quickly rerun recent searches.
+
 ### Search for Channels on Are.na
 
-Quickly search for Are.na channels using the Search Are.na Channels command.
+Quickly search for Are.na channels using **Find Channels** with:
+
+- pagination ("Load More")
+- sort controls
+- direct channel management actions
 
 ![Search For Channels](metadata/a1.png)
 
 ### Search for Blocks on Are.na
 
-Find specific blocks effortlessly with the Search Are.na Blocks command.
+Find specific blocks effortlessly with **Find Blocks** plus:
+
+- type filters (Text/Image/Link/Attachment/Embed)
+- pagination and sorting
+- in-place block management actions
 
 ![Search Are.na Blocks](metadata/a7.png)
 
 ### Search for Users on Are.na
 
-Locate Are.na users with the Search Are.na Users command.
+Locate Are.na users with **Find Users** and load additional pages as needed.
 
 ![Search Are.na Users](metadata/a6.png)
 
 ### Create an Are.na Channel
 
-Create new channels directly to your Are.na account using the Create Are.na Channel command.
+Create new channels directly in your Are.na account using **Create Channel**.
 
 ![Create Are.na Channel](metadata/a5.png)
 
 ### View Text and Image Blocks from Raycast
 
-Easily preview text and image blocks straight from the Raycast command bar.
+Preview text and image blocks directly from Raycast.
 
 ![View Text Block](metadata/a3.png)
 
 ![View Image Block](metadata/a2.png)
 
-### Add Blocks to Channels that are Public
+### Block Management
+
+Manage block workflows directly from result/channel views:
+
+- create blocks into a channel
+- edit block title/content/description
+- connect blocks to one or more channels
+- remove a block from the current channel
+- delete blocks
+
+### Channel Management
+
+Manage channel workflows directly from Raycast:
+
+- edit title/visibility/description
+- add or remove collaborators (IDs/slugs)
+- delete channels with confirmation safeguards
+
+### Personal Workflow
+
+Two dedicated commands for account-level work:
 
-Conveniently add blocks directly to any public channel.
+- **My Profile**: your profile snapshot
+- **My Channels**: browse channels you own/manage
 
 ![Add Block to Public Channels](metadata/a4.png)
 
 ## Getting Started
 
 To use this extension, you will need an Are.na `accessToken`. Follow these steps:
 
-- Go to [Are.na Developer Applications](https://dev.are.na/oauth/applications/new).
+- Go to [Are.na Personal Access Tokens](https://www.are.na/settings/personal-access-tokens).
 
-- Create a new application to obtain your Personal Access Token.
+- Create a token with the `write` scope if you want channel/block mutations.
 
 - Enter this token in Raycast settings for the Are.na extension.
 

extensions/are-na/ai.json

@@ -0,0 +1,48 @@
+{
+  "instructions": "These tools call the Are.na v3 API for the user's connected account. Channel visibility: public = open to everyone; closed = visible but not open; private = restricted. Prefer search-arena when the user is exploring or does not have a channel/block id. Block links are always https://www.are.na/block/{id} (singular /block/). After search results, offer concise summaries with titles and URLs. For write actions, only use create-channel when the user explicitly wants a new channel; it will ask them to confirm in Raycast.",
+  "evals": [
+    {
+      "input": "@are-na Who am I on Are.na?",
+      "mocks": {
+        "get-me": {
+          "user": {
+            "id": 1,
+            "slug": "demo-user",
+            "full_name": "Demo User",
+            "username": "demo-user",
+            "channel_count": 3,
+            "url": "https://www.are.na/demo-user"
+          }
+        }
+      },
+      "expected": [{ "callsTool": "get-me" }],
+      "usedAsExample": true
+    },
+    {
+      "input": "@are-na Search Are.na for design systems",
+      "mocks": {
+        "search-arena": {
+          "query": "design systems",
+          "page": 1,
+          "per": 24,
+          "total_count": 0,
+          "has_more": false,
+          "channels": [],
+          "blocks": [],
+          "users": []
+        }
+      },
+      "expected": [
+        {
+          "callsTool": {
+            "name": "search-arena",
+            "arguments": {
+              "query": { "includes": "design" }
+            }
+          }
+        }
+      ],
+      "usedAsExample": true
+    }
+  ]
+}