@astramindapp/mcp-server 0.29.0 → 0.29.2

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.29.0",
+        version: "0.29.2",
     }, {
         // Returned to every client in the MCP `initialize` response — the first
         // thing any connecting agent sees about how to integrate with MIND.
@@ -3139,15 +3139,29 @@ function createMindMcpServer(client) {
     // so a client that only ever reads tool descriptions still gets it.
     server.tool("mind_sessions", "Log THIS agent's own live session into MIND Chat → Agents, so Anthony can read the transcript and reply — his reply reaches you on your next turn. Distinct from mind_remember (one durable fact) and mind_train (teaching the KG): this is the live, turn-by-turn session log, mirrored into a MIND document when you close it.\n\n" +
         "PROTOCOL (do this every session): " +
-        "1) CONNECT — as soon as mind_context succeeds, call action=open with source_key (your assigned MIND Chat toggle, e.g. \"claude-code-1\"), external_session_id (your runtime's own session id), runtime, title (first user ask, 6-10 words), machine/cwd/repo/branch/model. If `resumed` is true, read `tail` before answering, and answer everything in `pending_replies` first — those arrived while you were away. " +
+        "1) CONNECT — as soon as mind_context succeeds, call action=open with source_key (your assigned MIND Chat toggle, e.g. \"claude-code-1\"), external_session_id (your runtime's own session id), runtime, title (first user ask, 6-10 words), machine/cwd/repo/branch/model. Your real source is derived from runtime x installation (device/platform/env), never the literal source_key — the response's own `source_key` tells you what it actually resolved to. If you're a named agent within a shared runtime (a scheduled job, a persona, a bot on a shared account), pass `agent` (a bare name, or {key,label}) so sessions attribute to WHO ran them, not just where — this works for every runtime, not only shared/cloud ones. If `resumed` is true, read `tail` before answering, and answer everything in `pending_replies` first — those arrived while you were away. " +
         "2) EVERY TURN — after you finish replying, call action=append with the user's message and your final reply (role user / assistant); tool calls go in as role=tool one-line summaries, never raw payloads. Check `pending_replies` on the response and answer them next turn. action=reply is a shortcut for appending a single assistant-role message when you have no user message to log alongside it. " +
         "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)."),
@@ -3161,6 +3175,20 @@ function createMindMcpServer(client) {
         branch: zod_1.z.string().optional().describe("Git branch — open."),
         model: zod_1.z.string().optional().describe("LLM model in use — open."),
         tags: zod_1.z.array(zod_1.z.string()).optional().describe("Freeform tags — open."),
+        device: zod_1.z
+            .object({
+            kind: zod_1.z.enum(["mac", "linux", "windows", "droplet", "cloud", "container", "ci", "phone", "unknown"]).optional(),
+            label: zod_1.z.string().optional(),
+            host: zod_1.z.string().optional(),
+        })
+            .optional()
+            .describe("Explicit device declaration — open/append. Wins outright over machine/platform/env inference; an out-of-vocabulary `kind` is dropped server-side rather than passed through raw."),
+        platform: zod_1.z.string().optional().describe("Your own platform string (sys.platform / platform.system() / a mobile OS name, e.g. \"darwin\", \"linux\", \"win32\", \"ios\") — open/append. Used to infer device kind when `device` isn't supplied."),
+        env: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Environment markers you read from your OWN process (GITHUB_ACTIONS, RENDER, KUBERNETES_SERVICE_HOST, DROPLET_ID, DOCKERENV, ...) — open/append. Used to infer device kind (CI runner, cloud, container, droplet) when `device` isn't supplied."),
+        agent: zod_1.z
+            .union([zod_1.z.string(), zod_1.z.object({ key: zod_1.z.string(), label: zod_1.z.string().optional() })])
+            .optional()
+            .describe("Who is actually running this session — an attribute OF the session, never a source key, and unconditional on runtime (a claude-code cron run can carry agent=\"Chief of Staff\" exactly like a grok run carries agent=\"Dae\"). Bare string used as both key and label, or {key, label}. Falls back to a legacy alias for a bot-shaped source_key (\"dae\"→Dae, \"meter\"→Meter, \"grok-bot\"→Helm, \"n8n\"→n8n), then to the runtime's own display name — open only."),
         // append / reply
         session_id: zod_1.z.string().optional().describe("Session id returned by open — required for append/close/get/inbox/handoff."),
         messages: zod_1.z
@@ -3192,6 +3220,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 {
@@ -3214,6 +3246,10 @@ function createMindMcpServer(client) {
                         branch: args.branch,
                         model: args.model,
                         tags: args.tags,
+                        device: args.device,
+                        platform: args.platform,
+                        env: args.env,
+                        agent: args.agent,
                     }));
                 }
                 case "append": {
@@ -3317,6 +3353,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}`);