@astramindapp/mcp-server 0.28.0 → 0.29.1

package/dist/server.js

@@ -86,7 +86,7 @@ const apiDetail = (e) => {
 function createMindMcpServer(client) {
     const server = new mcp_js_1.McpServer({
         name: "mind",
-        version: "0.28.0",
+        version: "0.29.1",
     }, {
         // Returned to every client in the MCP `initialize` response — the first
         // thing any connecting agent sees about how to integrate with MIND.
@@ -3144,10 +3144,24 @@ function createMindMcpServer(client) {
         "3) IDLE — MIND marks the session idle after 30 minutes with no append; the next append revives it, nothing to do meanwhile. " +
         "4) TERMINATE — on exit, compaction, or \"done\", call action=close with a summary (what was asked, what shipped with ids/PR numbers, what is still undone); MIND mirrors the transcript into your Sessions folder as a document. " +
         "5) HANDOFF — to pass the conversation to another agent, call action=handoff with to_source_key=<their toggle>; they see it in their session list with the transcript as context. " +
+        "6) SHARE — to let another MIND user follow this session, call action=share with grantee_username and role (\"viewer\" read-only, the default, or \"replier\" which also lets them reply — a reply is a live action that wakes your process via wake_url, so grant it deliberately). It's a live mirror, never a copy: they always see the current transcript, and revoking (action=revoke_share) removes their access immediately. Never share a session with anyone who shouldn't see its full transcript.\n" +
         "Never claim a session is synced without the session_id MIND returned. Never log secrets or raw tool payloads.\n\n" +
-        "Actions: open, append, close, list, get, reply (alias for append of one assistant message), inbox (undelivered mind-origin replies), handoff, sources (source_action=list|create|update|delete manages the MIND Chat sidebar toggles — auto-created on first open with an unknown source_key).", {
+        "Actions: open, append, close, list, get, reply (alias for append of one assistant message), inbox (undelivered mind-origin replies), handoff, sources (source_action=list|create|update|delete manages the MIND Chat sidebar toggles — auto-created on first open with an unknown source_key), share (grant another MIND account viewer or replier access — owner only), list_shares (owner only), revoke_share (owner only).", {
         action: zod_1.z
-            .enum(["open", "append", "close", "list", "get", "reply", "inbox", "handoff", "sources"])
+            .enum([
+            "open",
+            "append",
+            "close",
+            "list",
+            "get",
+            "reply",
+            "inbox",
+            "handoff",
+            "sources",
+            "share",
+            "list_shares",
+            "revoke_share",
+        ])
             .describe("Which agent-session operation to perform."),
         // open
         source_key: zod_1.z.string().optional().describe("Your assigned MIND Chat sidebar toggle slug, e.g. \"claude-code-1\" — required for open; also filters list; also required for sources action=create (as the new source's key)."),
@@ -3192,6 +3206,10 @@ function createMindMcpServer(client) {
         color: zod_1.z.string().optional().describe("Sidebar chip color — sources action=create/update."),
         wake_url: zod_1.z.string().optional().describe("Optional push endpoint MIND POSTs {session_id, reply} to (fire-and-forget, 5s timeout) when the user replies — sources action=create/update."),
         force: zod_1.z.boolean().optional().describe("sources action=delete: also delete the source's sessions instead of failing 409 when sessions exist."),
+        // share / list_shares / revoke_share
+        grantee_username: zod_1.z.string().optional().describe("MIND username to share with — required for share."),
+        role: zod_1.z.enum(["viewer", "replier"]).optional().describe("Role to grant — share (default \"viewer\"). \"replier\" additionally allows the grantee to reply, which reaches you via wake_url."),
+        share_id: zod_1.z.string().optional().describe("Share grant id (from share or list_shares) — required for revoke_share."),
     }, async (args) => {
         const { action } = args;
         try {
@@ -3317,6 +3335,32 @@ function createMindMcpServer(client) {
                         }
                     }
                 }
+                case "share": {
+                    const { session_id, grantee_username } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for share.");
+                    if (!grantee_username)
+                        return err("Error: 'grantee_username' is required for share.");
+                    return ok(await client.createAgentSessionShare(session_id, {
+                        grantee_username,
+                        role: args.role,
+                    }));
+                }
+                case "list_shares": {
+                    const { session_id } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for list_shares.");
+                    return ok(await client.listAgentSessionShares(session_id));
+                }
+                case "revoke_share": {
+                    const { session_id, share_id } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for revoke_share.");
+                    if (!share_id)
+                        return err("Error: 'share_id' is required for revoke_share.");
+                    await client.revokeAgentSessionShare(session_id, share_id);
+                    return ok({ ok: true, session_id, share_id });
+                }
                 default: {
                     const _exhaustive = action;
                     return err(`Unknown action: ${_exhaustive}`);
@@ -4259,10 +4303,10 @@ function createMindMcpServer(client) {
     // Multi-MIND accounts: discover the MINDs this key's owner can access,
     // create new ones, and manage owners / viewers. Requires the server to
     // have MULTI_MIND_ACCOUNTS_ENABLED set.
-    server.tool("mind_accounts", "Manage multi-MIND accounts. A 'MIND' is a knowledge-graph account; one person can own or be granted access to many. Use to discover every MIND you can access (list), spin up a new one (create), permanently delete one (delete), see who can access a MIND (members), grant an existing user access (grant), or email an invitation (invite).", {
+    server.tool("mind_accounts", "Manage multi-MIND accounts. A 'MIND' is a knowledge-graph account; one person can own or be granted access to many. Use to discover every MIND you can access (list), spin up a new one (create), permanently delete one (delete), see who can access a MIND (members), grant an existing user access (grant), email an invitation (invite), or switch into a granted MIND (switch — POST /developer/v1/accounts/switch; returns access_token JWT). Protocol: AstraAI=HQ, MIND=product, anthonyjconti=personal.", {
         action: zod_1.z
-            .enum(["list", "create", "delete", "members", "grant", "invite"])
-            .describe("list (every MIND you can access), create (a new MIND you own), delete (permanently delete a MIND you own), members (owners/viewers of a MIND), grant (give an existing user access), invite (email an invitation)"),
+            .enum(["list", "create", "delete", "members", "grant", "invite", "switch"])
+            .describe("list (every MIND you can access), create (a new MIND you own), delete (permanently delete a MIND you own), members (owners/viewers of a MIND), grant (give an existing user access), invite (email an invitation), switch (activate/enter a granted MIND — requires mind_username; returns access_token)"),
         label: zod_1.z
             .string()
             .optional()
@@ -4270,7 +4314,7 @@ function createMindMcpServer(client) {
         mind_username: zod_1.z
             .string()
             .optional()
-            .describe("Username of the MIND to manage (required for delete/members/grant/invite)"),
+            .describe("Username of the MIND to manage (required for delete/members/grant/invite/switch)"),
         grantee_username: zod_1.z
             .string()
             .optional()
@@ -4411,6 +4455,29 @@ function createMindMcpServer(client) {
                         ],
                     };
                 }
+                case "switch": {
+                    if (!mind_username) {
+                        return {
+                            content: [{ type: "text", text: "Error: mind_username is required for switch" }],
+                            isError: true,
+                        };
+                    }
+                    const res = await client.switchMind(mind_username);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    switched: true,
+                                    account: res.account,
+                                    access_token: res.access_token,
+                                    token_type: res.token_type,
+                                    note: "Bearer access_token operates as this MIND for session JWT paths. Hosted API-key MCP remains the key owner unless the host applies the token.",
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
             }
         }
         catch (err) {