npm - @echomem/mcp - Versions diffs - 1.4.22 → 1.4.24 - Mend

@echomem/mcp 1.4.22 → 1.4.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/hud/web.js +3 -3
package/dist/index.js +300 -7
package/dist/migrate.js +6 -5
package/dist/package-metadata.js +3 -0
package/dist/setup-page/client-core.js +4 -1
package/dist/setup-page/client-extraction.js +20 -13
package/dist/setup-page/styles-mvp.js +103 -0
package/dist/setup-preview.js +4 -4
package/dist/setup.js +11 -0
package/dist/v1-contract.js +248 -11
package/package.json +1 -1

package/dist/hud/web.js CHANGED Viewed

@@ -1723,7 +1723,7 @@ export const HUD_HTML = String.raw `<!doctype html>
       if (previewParams.get("capture") === "1") hud.classList.add("capture-preview");
       if (previewColor === "green" || previewColor === "amber" || previewColor === "red") {
         const previewProcessingUsed = previewColor === "red" ? 200000 : previewColor === "amber" ? 163000 : 84000;
-        const previewSearchUsed = previewColor === "red" ? 100 : previewColor === "amber" ? 82 : 32;
+        const previewSearchUsed = previewColor === "red" ? 500 : previewColor === "amber" ? 410 : 160;
         billingStatus = {
           ok: true,
           state: "ok",
@@ -1731,8 +1731,8 @@ export const HUD_HTML = String.raw `<!doctype html>
           paid: true,
           pricingUrl: "https://yeahecho.com/pricing?source=hud_preview",
           memoryProcessingQuota: { used: previewProcessingUsed, limit: 200000, remaining: 200000 - previewProcessingUsed, resetAt: new Date(Date.now() + 31 * 60 * 60 * 1000).toISOString() },
-          memorySearchQuota: { used: previewSearchUsed, limit: 100, remaining: 100 - previewSearchUsed, resetAt: new Date(Date.now() + 31 * 60 * 60 * 1000).toISOString() },
-          historicalConversationQuota: { used: 191, limit: 250, remaining: 59 },
+          memorySearchQuota: { used: previewSearchUsed, limit: 500, remaining: 500 - previewSearchUsed, resetAt: new Date(Date.now() + 31 * 60 * 60 * 1000).toISOString() },
+          historicalConversationQuota: { used: 191, limit: 500, remaining: 309 },
         };
         const sample = {
           client: "codex",

package/dist/index.js CHANGED Viewed

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
 import axios from "axios";
 import { ZodError } from "zod";
-import { canonicalToolNames, deleteMemorySchema, getByContextSchema, keywordsSchema, listFriendsSchema, listToolSpecs, othersSchema, publicMemorySchema, resolveCanonicalToolName, saveConversationSchema, searchMemoriesSchema, searchUsersSchema, sendFriendRequestSchema, timeRangeSchema, } from "./v1-contract.js";
+import { canonicalToolNames, completeGroupPublicationSchema, createGroupInviteSchema, createGroupSchema, deleteMemorySchema, getByContextSchema, groupContextSchema, joinGroupSchema, keywordsSchema, listFriendsSchema, listToolSpecs, othersSchema, publishBatchToGroupSchema, publishToGroupSchema, prepareGroupPublicationSchema, publicMemorySchema, resolveCanonicalToolName, saveConversationSchema, searchMemoriesSchema, searchUsersSchema, sendFriendRequestSchema, timeRangeSchema, updateGroupProfileSchema, } from "./v1-contract.js";
 import { KeyStore } from "./keystore.js";
 import { EventLogger, hashText } from "./events.js";
 import { buildReportText } from "./report.js";
@@ -488,12 +488,20 @@ function inputAnalyticsForTool(canonicalName, args) {
                 limit: numberArg(a, "limit"),
             };
         }
-        case canonicalToolNames.publicMemory: {
+        case canonicalToolNames.publicMemory:
+        case canonicalToolNames.publishToGroup: {
             const memoryId = readString(a, "memoryId");
             return {
                 memory_id_hash: memoryId ? hashText(memoryId) : undefined,
             };
         }
+        case canonicalToolNames.publishBatchToGroup: {
+            const memoryIds = Array.isArray(a.memoryIds) ? a.memoryIds.filter((id) => typeof id === "string") : [];
+            return {
+                memory_count: memoryIds.length,
+                context_id_hash: typeof a.contextId === "string" ? hashText(a.contextId) : undefined,
+            };
+        }
         default:
             return {};
     }
@@ -944,6 +952,77 @@ class EchoMemApiClient {
             throw new Error(`get_public_memory failed against ${ECHO_API_BASE_URL}: ${describeError(error)}`);
         }
     }
+    async getGroupContext(args) {
+        groupContextSchema.parse(args ?? {});
+        try {
+            const response = await this.axios.get("/api/extension/social/groups/current");
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`get_group_context failed against ${ECHO_API_BASE_URL}: ${describeError(error)}`);
+        }
+    }
+    async createGroup(args) {
+        const parsed = createGroupSchema.parse(args ?? {});
+        const response = await this.axios.post("/api/extension/social/groups", parsed);
+        return response.data;
+    }
+    async createGroupInvite(args) {
+        const parsed = createGroupInviteSchema.parse(args ?? {});
+        const response = await this.axios.post("/api/extension/social/groups/current/invite", parsed);
+        return response.data;
+    }
+    async joinGroup(args) {
+        const parsed = joinGroupSchema.parse(args ?? {});
+        const response = await this.axios.post("/api/extension/social/groups/join", parsed);
+        return response.data;
+    }
+    async prepareGroupPublication(args) {
+        const parsed = prepareGroupPublicationSchema.parse(args ?? {});
+        const enc = await this.encState();
+        const response = await this.axios.post("/api/extension/social/groups/current/publications/prepare", parsed, { headers: enc.enabled && enc.key ? { "X-Encryption-Key": enc.key } : undefined });
+        return response.data;
+    }
+    async updateGroupProfile(args) {
+        const parsed = updateGroupProfileSchema.parse(args ?? {});
+        const response = await this.axios.patch("/api/extension/social/groups/current/profile", parsed);
+        return response.data;
+    }
+    async completeGroupPublication(args) {
+        const parsed = completeGroupPublicationSchema.parse(args ?? {});
+        const enc = await this.encState();
+        const response = await this.axios.post("/api/extension/social/groups/current/publications/complete", parsed, { headers: enc.enabled && enc.key ? { "X-Encryption-Key": enc.key } : undefined });
+        return response.data;
+    }
+    async publishMemoryToGroup(args) {
+        const parsed = publishToGroupSchema.parse(args ?? {});
+        const enc = await this.encState();
+        try {
+            const response = await this.axios.post(`/api/extension/social/groups/current/memories/${encodeURIComponent(parsed.memoryId)}/publish`, {}, {
+                headers: enc.enabled && enc.key ? { "X-Encryption-Key": enc.key } : undefined,
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`publish_memory_to_group failed against ${ECHO_API_BASE_URL}: ${describeError(error)}`);
+        }
+    }
+    async publishMemoriesToGroup(args) {
+        const parsed = publishBatchToGroupSchema.parse(args ?? {});
+        const enc = await this.encState();
+        try {
+            const response = await this.axios.post("/api/extension/social/groups/current/memories/publish-batch", {
+                memoryIds: parsed.memoryIds,
+                contextId: parsed.contextId,
+            }, {
+                headers: enc.enabled && enc.key ? { "X-Encryption-Key": enc.key } : undefined,
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`publish_memories_to_group failed against ${ECHO_API_BASE_URL}: ${describeError(error)}`);
+        }
+    }
 }
 const SERVER_VERSION = MCP_PACKAGE_VERSION;
 class EchoMemMCPServer {
@@ -1121,6 +1200,24 @@ class EchoMemMCPServer {
                         return await this.handleOthers(request.params.arguments);
                     case canonicalToolNames.publicMemory:
                         return await this.handlePublicMemory(request.params.arguments);
+                    case canonicalToolNames.groupContext:
+                        return await this.handleGroupContext(request.params.arguments);
+                    case canonicalToolNames.createGroup:
+                        return await this.handleCreateGroup(request.params.arguments);
+                    case canonicalToolNames.createGroupInvite:
+                        return await this.handleCreateGroupInvite(request.params.arguments);
+                    case canonicalToolNames.joinGroup:
+                        return await this.handleJoinGroup(request.params.arguments);
+                    case canonicalToolNames.prepareGroupPublication:
+                        return await this.handlePrepareGroupPublication(request.params.arguments);
+                    case canonicalToolNames.updateGroupProfile:
+                        return await this.handleUpdateGroupProfile(request.params.arguments);
+                    case canonicalToolNames.completeGroupPublication:
+                        return await this.handleCompleteGroupPublication(request.params.arguments);
+                    case canonicalToolNames.publishToGroup:
+                        return await this.handlePublishToGroup(request.params.arguments);
+                    case canonicalToolNames.publishBatchToGroup:
+                        return await this.handlePublishBatchToGroup(request.params.arguments);
                     case canonicalToolNames.delete:
                         return await this.handleDelete(request.params.arguments, rec);
                     default:
@@ -1302,7 +1399,7 @@ class EchoMemMCPServer {
             return { content: [{ type: "text", text: "No relevant memories found." }] };
         }
         const formattedResults = memories
-            .map((m, idx) => `[Result ${idx + 1}] (Similarity: ${m.similarity_score?.toFixed(3) || "N/A"})
+            .map((m, idx) => `[Result ${idx + 1}] Memory ID: ${m.id || "unknown"} (Similarity: ${m.similarity_score?.toFixed(3) || "N/A"})
 Time: ${m.time} | Location: ${m.location}
 Category: ${m.category} | Object: ${m.object} | Emotion: ${m.emotion}
 Description: ${m.description}
@@ -1504,11 +1601,11 @@ Details: ${m.details || "N/A"}`)
         const memories = payload?.memories ?? [];
         if (!memories.length) {
             const scope = parsed.ownerUserId
-                ? ` for friend ${parsed.ownerUserId}`
+                ? ` for peer ${parsed.ownerUserId}`
                 : parsed.ownerName
-                    ? ` for friend ${parsed.ownerName}`
+                    ? ` for peer ${parsed.ownerName}`
                     : parsed.target
-                        ? ` for friend ${parsed.target}`
+                        ? ` for peer ${parsed.target}`
                         : parsed.targetFriendIds?.length
                             ? ` for ${parsed.targetFriendIds.length} selected friends`
                             : parsed.targetFriendNames?.length
@@ -1521,7 +1618,12 @@ Details: ${m.details || "N/A"}`)
         }
         const metadata = [
             typeof payload?.friendCount === "number" ? `friendCount=${payload.friendCount}` : "",
-            typeof payload?.searchedFriendCount === "number" ? `searchedFriendCount=${payload.searchedFriendCount}` : "",
+            typeof payload?.groupPeerCount === "number" ? `groupPeerCount=${payload.groupPeerCount}` : "",
+            typeof payload?.searchedPeerCount === "number"
+                ? `searchedPeerCount=${payload.searchedPeerCount}`
+                : typeof payload?.searchedFriendCount === "number"
+                    ? `searchedPeerCount=${payload.searchedFriendCount}`
+                    : "",
             typeof payload?.memoryViewsInserted === "number" ? `memoryViewsInserted=${payload.memoryViewsInserted}` : "",
         ].filter(Boolean).join(", ");
         const formattedResults = memories
@@ -1674,6 +1776,197 @@ Details: ${m.details || "N/A"}`;
             content: [{ type: "text", text }],
         };
     }
+    async handleGroupContext(args) {
+        groupContextSchema.parse(args ?? {});
+        const payload = await this.client.getGroupContext(args);
+        const group = isRecord(payload?.group) ? payload.group : null;
+        const participants = Array.isArray(payload?.participants)
+            ? payload.participants.filter(isRecord)
+            : [];
+        const currentParticipant = isRecord(payload?.currentParticipant)
+            ? payload.currentParticipant
+            : null;
+        const coverage = isRecord(payload?.coverage) ? payload.coverage : {};
+        if (!group) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "You are not assigned to a company group yet. Ask an EchoMem administrator to add you before using group orientation or group publishing.",
+                    }],
+            };
+        }
+        const participantText = participants.map((participant, index) => [
+            `[${index + 1}] ${readString(participant, "displayName") ?? "Unnamed participant"}`,
+            `User ID: ${readString(participant, "userId") ?? "unknown"}`,
+            `Title: ${readString(participant, "title") ?? "Not declared"}`,
+            `Declared responsibility: ${readString(participant, "responsibilitySummary") ?? "Not provided"}`,
+            `Published memories: ${readNumber(participant, "publicMemoryCount") ?? 0}`,
+        ].join("\n")).join("\n\n");
+        const participantCount = readNumber(coverage, "participantCount") ?? participants.length;
+        const coveredCount = readNumber(coverage, "participantsWithPublishedMemories") ?? 0;
+        const totalPublished = readNumber(coverage, "totalPublishedMemories") ?? 0;
+        const text = [
+            `Company group: ${readString(group, "name") ?? "Unnamed group"}`,
+            readString(group, "description") ? `Description: ${readString(group, "description")}` : "",
+            `Coverage: ${coveredCount} of ${participantCount} participants have published memories (${totalPublished} total).`,
+            "",
+            participantText,
+            "",
+            "Declared titles and responsibilities are directory facts. Use search_others_memories for current work evidence, and label suggested contribution areas as inference that should be confirmed with the team.",
+            currentParticipant
+                && (!readString(currentParticipant, "title") || !readString(currentParticipant, "responsibilitySummary"))
+                ? "Your group profile is incomplete. Use prepare_group_publication to review your memory evidence, propose the missing fields, and save them only after confirmation with update_group_profile."
+                : "",
+        ].filter(Boolean).join("\n");
+        return { content: [{ type: "text", text }] };
+    }
+    async handlePublishToGroup(args) {
+        const parsed = publishToGroupSchema.parse(args ?? {});
+        const payload = await this.client.publishMemoryToGroup(args);
+        if (payload?.success === false) {
+            throw new Error(`EchoMem API Error: ${payload.error || "publish failed"}`);
+        }
+        const group = isRecord(payload?.group) ? payload.group : {};
+        const groupName = readString(group, "name") ?? "your company group";
+        const memberCount = typeof payload?.searchableByGroupMemberCount === "number"
+            ? payload.searchableByGroupMemberCount
+            : 0;
+        const alreadyPublished = payload?.alreadyPublished === true;
+        return {
+            content: [{
+                    type: "text",
+                    text: alreadyPublished
+                        ? `Memory ${parsed.memoryId} was already published to ${groupName}. It is searchable by up to ${memberCount} other group members.`
+                        : `Published memory ${parsed.memoryId} to ${groupName}. It is now searchable by up to ${memberCount} other group members.`,
+                }],
+        };
+    }
+    async handleCreateGroup(args) {
+        const parsed = createGroupSchema.parse(args ?? {});
+        const payload = await this.client.createGroup(parsed);
+        return { content: [{ type: "text", text: `Created company group ${payload?.group?.name ?? parsed.name}. Generate an invite code when you are ready to add teammates.` }] };
+    }
+    async handleCreateGroupInvite(args) {
+        createGroupInviteSchema.parse(args ?? {});
+        const payload = await this.client.createGroupInvite(args);
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        `Invite code for ${payload?.group?.name ?? "your group"}: ${payload?.code}`,
+                        `Expires: ${payload?.expiresAt}`,
+                        `Maximum uses: ${payload?.maxUses}`,
+                        "Share this secret code only with intended teammates.",
+                    ].join("\n"),
+                }],
+        };
+    }
+    async handleJoinGroup(args) {
+        const parsed = joinGroupSchema.parse(args ?? {});
+        const payload = await this.client.joinGroup(parsed);
+        return {
+            content: [{
+                    type: "text",
+                    text: payload?.alreadyMember
+                        ? `You are already a member of ${payload?.group?.name ?? "this group"}. No memories were published. Use prepare_group_publication to review memories and propose any missing title or responsibility fields.`
+                        : `Joined ${payload?.group?.name ?? "the company group"}. No memories were published. Next use prepare_group_publication to review candidates, infer a proposed title and responsibility summary, and ask the user to confirm that profile together with the publication preview.`,
+                }],
+        };
+    }
+    async handlePrepareGroupPublication(args) {
+        const parsed = prepareGroupPublicationSchema.parse(args ?? {});
+        const payload = await this.client.prepareGroupPublication(parsed);
+        const candidates = Array.isArray(payload?.candidates) ? payload.candidates : [];
+        const participantProfile = isRecord(payload?.participantProfile)
+            ? payload.participantProfile
+            : {};
+        const formatted = candidates.map((candidate, index) => [
+            `[${index + 1}] Memory ID: ${readString(candidate, "memoryId") ?? "unknown"}`,
+            `Created: ${readString(candidate, "createdAt") ?? "unknown"}`,
+            `Category: ${readString(candidate, "category") ?? "unknown"}`,
+            `Description: ${readString(candidate, "description") ?? ""}`,
+            readString(candidate, "details") ? `Details: ${readString(candidate, "details")}` : "",
+            `Already published: ${candidate.alreadyPublished === true ? "yes" : "no"}`,
+            `Exact content duplicate: ${candidate.exactContentDuplicate === true ? "yes" : "no"}`,
+        ].filter(Boolean).join("\n")).join("\n\n");
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        `Prepared publication scan ${payload?.scanId} for ${payload?.group?.name ?? "your group"}.`,
+                        `Window: ${payload?.windowStart ?? "context start"} → ${payload?.windowEnd}`,
+                        `Candidates: ${candidates.length}. Nothing has been published.`,
+                        `Current title: ${readString(participantProfile, "title") ?? "Not declared"}`,
+                        `Current declared responsibility: ${readString(participantProfile, "responsibilitySummary") ?? "Not provided"}`,
+                        "",
+                        formatted,
+                        "",
+                        "Select exact memory IDs matching the user's instruction. From memory evidence, draft a concise title and responsibility summary. Show the profile proposal and memory preview together, then ask for one explicit confirmation. After confirmation, call update_group_profile and complete_group_publication.",
+                    ].join("\n"),
+                }],
+        };
+    }
+    async handleUpdateGroupProfile(args) {
+        const parsed = updateGroupProfileSchema.parse(args ?? {});
+        const payload = await this.client.updateGroupProfile(parsed);
+        const participant = isRecord(payload?.participant) ? payload.participant : {};
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        "Confirmed company-group profile updated.",
+                        `Display name: ${readString(participant, "displayName") ?? parsed.displayName ?? "unchanged"}`,
+                        `Title: ${readString(participant, "title") ?? parsed.title}`,
+                        `Declared responsibility: ${readString(participant, "responsibilitySummary") ?? parsed.responsibilitySummary}`,
+                        "These fields are now declared directory facts visible to group members.",
+                    ].join("\n"),
+                }],
+        };
+    }
+    async handleCompleteGroupPublication(args) {
+        const parsed = completeGroupPublicationSchema.parse(args ?? {});
+        const payload = await this.client.completeGroupPublication(parsed);
+        const memories = Array.isArray(payload?.memories) ? payload.memories : [];
+        const published = memories.filter((memory) => memory.alreadyPublished !== true && memory.skippedDuplicate !== true).length;
+        const duplicates = memories.filter((memory) => memory.skippedDuplicate === true).length;
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        `Completed publication scan ${parsed.scanId}.`,
+                        `Newly published: ${published}.`,
+                        `Exact duplicates skipped: ${duplicates}.`,
+                        `Selected memory IDs: ${parsed.memoryIds.join(", ") || "(none)"}.`,
+                        "The scan cursor advanced; encrypted originals and global public settings were unchanged.",
+                    ].join("\n"),
+                }],
+        };
+    }
+    async handlePublishBatchToGroup(args) {
+        const parsed = publishBatchToGroupSchema.parse(args ?? {});
+        const payload = await this.client.publishMemoriesToGroup(parsed);
+        if (payload?.success === false) {
+            throw new Error(`EchoMem API Error: ${payload.error || "batch publish failed"}`);
+        }
+        const group = isRecord(payload?.group) ? payload.group : {};
+        const groupName = readString(group, "name") ?? "your company group";
+        const publishedCount = typeof payload?.publishedCount === "number" ? payload.publishedCount : 0;
+        const alreadyPublishedCount = typeof payload?.alreadyPublishedCount === "number"
+            ? payload.alreadyPublishedCount
+            : 0;
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        `Published ${publishedCount} memory snapshots to ${groupName}.`,
+                        alreadyPublishedCount ? `${alreadyPublishedCount} were already published and were refreshed.` : "",
+                        `Selected memory IDs: ${parsed.memoryIds.join(", ")}`,
+                        parsed.selectionReason ? `Selection reason: ${parsed.selectionReason}` : "",
+                        "The encrypted originals and their global public settings were not changed.",
+                    ].filter(Boolean).join("\n"),
+                }],
+        };
+    }
     async handleDelete(args, rec) {
         const parsed = deleteMemorySchema.parse(args ?? {});
         if (rec) {

package/dist/migrate.js CHANGED Viewed

@@ -4,9 +4,10 @@
  *
  * Why this lives in the bridge (client-side): the session logs exist ONLY on the user's machine
  * (~/.codex/sessions, ~/.claude/projects). The bridge discovers each session, assembles it into a
- * text-turn-only `## ` transcript, and feeds it to the EXISTING durable import queue
- * (the same one the extension uses): POST /api/extension/import-sessions creates one import_jobs row per session, then the bridge
- * POSTs each transcript to /api/extension/import-jobs/{id}/run. The web dashboard polls
+ * text-turn-only `## ` transcript, and feeds it to the shared durable import queue
+ * through MCP-owned policy entrypoints. POST /api/extension/mcp/historical-import-sessions
+ * creates one import_jobs row per session, then the bridge POSTs each transcript to
+ * /api/extension/mcp/historical-import-jobs/{id}/run. The web dashboard polls
  * GET /import-sessions/{id} for live progress — the bridge owns local-file access, the server owns the
  * queue + status. (Headless CLI also works; it just shows progress in the terminal.)
  *
@@ -1353,7 +1354,7 @@ async function createImportSession(client, sessions, bareId, userTz, signal) {
         sourceDate: s.firstTs,
         userTz,
     }));
-    const res = await client.post("/api/extension/import-sessions", { items }, signal ? { signal } : undefined);
+    const res = await client.post("/api/extension/mcp/historical-import-sessions", { items }, signal ? { signal } : undefined);
     const data = res.data || {};
     const serverConcurrency = Number(data.session?.concurrency);
     return {
@@ -1378,7 +1379,7 @@ async function runImportJob(client, jobId, s, userTz, encKey) {
     const cfg = encKey ? { headers: { "X-Encryption-Key": encKey } } : undefined;
     for (let attempt = 0;; attempt++) {
         try {
-            const res = await client.post(`/api/extension/import-jobs/${jobId}/run`, body, cfg);
+            const res = await client.post(`/api/extension/mcp/historical-import-jobs/${jobId}/run`, body, cfg);
             const data = res.data || {};
             if (data.claimed === false) {
                 // Already completed on a prior run → idempotent, not an error; otherwise it didn't start.

package/dist/package-metadata.js CHANGED Viewed

@@ -28,6 +28,9 @@ export const MCP_SERVER_INSTRUCTIONS = [
     `If the user or local config expects a newer EchoMem MCP version than ${MCP_PACKAGE_VERSION}, update once with \`${MCP_UPDATE_ALL_COMMAND}\` and start a new MCP session.`,
     "Use echomem_update_status to check whether npm has a newer bridge; it is cached and non-blocking during normal tool listing.",
     "Do not auto-update on every MCP startup; this bridge is intentionally stable between explicit updates.",
+    "For company-group sharing, use get_group_context for orientation; create_memory_group/create_group_invite/join_memory_group for membership; and prepare_group_publication as a no-publication preview.",
+    "After joining or when profile fields are missing, use candidate memory evidence to propose a title and responsibility summary. Ask the user to confirm that proposal together with the publication preview, then call update_group_profile and complete_group_publication.",
+    "Never save an inferred group profile or complete a group publication without explicit confirmation, and never store or log an echo_grp_ invite code.",
 ].join(" ");
 export function withMcpVersion(description) {
     return `${description}\n\nEchoMem MCP bridge: ${MCP_PACKAGE_LABEL}. If this version is stale, update once with \`${MCP_UPDATE_ALL_COMMAND}\` (or add \`--client cursor|windsurf|claude-desktop|claude-code|codex\` for a single client), then start a new MCP session. Do not run updates repeatedly or on every startup.`;

package/dist/setup-page/client-core.js CHANGED Viewed

@@ -131,7 +131,10 @@ export const SETUP_PAGE_CLIENT_CORE = String.raw `      var params = new URLSear
       }
       async function getJson(path) {
         var sep = path.indexOf("?") >= 0 ? "&" : "?";
-        var res = await fetch(path + sep + "nonce=" + encodeURIComponent(nonce), { credentials: "omit" });
+        var res = await fetch(path + sep + "nonce=" + encodeURIComponent(nonce), {
+          credentials: "omit",
+          cache: "no-store"
+        });
         if (!res.ok) throw new Error(await res.text() || ("HTTP " + res.status));
         return await res.json();
       }

package/dist/setup-page/client-extraction.js CHANGED Viewed

@@ -627,8 +627,8 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           return Math.max(0, Math.floor(quota.remaining));
         }
         var plan = String(billingStatus && billingStatus.plan || "").toLowerCase();
-        if (plan === "power" || plan === "enterprise") return 500;
-        if (paidRecallPlan(plan)) return 250;
+        if (plan === "power" || plan === "enterprise") return 2000;
+        if (paidRecallPlan(plan)) return 500;
         return 100;
       }
       function selectedSessionKeyList() {
@@ -912,7 +912,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           homeName: "Power",
           promise: "More room. More agents. Much more Echo.",
           price: "$100",
-          cadence: "per month · cancel anytime",
+          cadence: "per month · 14-day trial",
           sticker: "/hud-assets/echo-pricing-power-sticker.png",
           stickerAlt: "Power Echo arrives with a gold key and a crew of notebook helpers.",
           features: ["2,000 past chats", "agent-heavy memory", "2,000 context returns / week"]
@@ -923,7 +923,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           homeName: "Pro",
           promise: "A room for the work you return to every day.",
           price: "$20",
-          cadence: "per month · cancel anytime",
+          cadence: "per month · 14-day trial",
           sticker: "/hud-assets/echo-pricing-pro-sticker.png",
           stickerAlt: "Pro Echo organizes tabbed notebooks and a daily refresh control.",
           popular: true,
@@ -960,6 +960,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           return '<li>' + setupIcon("check") + '<span>' + esc(feature) + '</span></li>';
         }).join("");
         var chooseId = plan.id === "free" ? "chooseFreePlan" : (plan.id === "power" ? "choosePowerPlan" : "chooseProPlan");
+        var chooseLabel = plan.id === "free" ? "Take " + plan.homeName + " home" : "Start 14-day trial";
         var discovery = discovered > 0
           ? '<p class="mvpPricingDiscovery">Echo found <strong>' + esc(number(discovered)) + '</strong> new coding session' + (discovered === 1 ? "" : "s") + ' on this Mac.</p>'
           : "";
@@ -980,7 +981,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
               '<div class="mvpPlanPrice"><strong>' + esc(plan.price) + '</strong><span>' + esc(plan.cadence) + '</span></div>' +
               '<p class="mvpPacksLabel">Echo packs</p>' +
               '<ul class="mvpPlanFacts">' + facts + '</ul>' +
-              '<button type="button" class="primary mvpPlanCta" id="' + chooseId + '">Take ' + esc(plan.homeName) + ' home <span aria-hidden="true">→</span></button>' +
+              '<button type="button" class="primary mvpPlanCta" id="' + chooseId + '">' + esc(chooseLabel) + ' <span aria-hidden="true">→</span></button>' +
             '</div>' +
           '</article>' +
           '<p class="mvpPlanStatus" id="setupPlanStatus" role="status"></p>' +
@@ -1022,7 +1023,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
         if (!canExtract) {
           slot.innerHTML = "";
           slot.classList.add("is-hidden");
-          if (readySettings) readySettings.classList.remove("is-plan-open");
+          if (readySettings) readySettings.classList.remove("is-plan-open", "is-checkout-pending");
           return;
         }
         slot.classList.remove("is-hidden");
@@ -1035,7 +1036,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
             renderDashboard();
             return;
           }
-          if (readySettings) readySettings.classList.remove("is-plan-open");
+          if (readySettings) readySettings.classList.remove("is-plan-open", "is-checkout-pending");
           rememberSetupPlanChoice("");
           setupPlanChoice = "paid";
           var planLabel = plan.charAt(0).toUpperCase() + plan.slice(1);
@@ -1046,7 +1047,7 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
             ? paidHistory.used + " / " + paidHistory.limit + " bulk history imports used."
             : "Your bulk history import and weekly new-chat allowance are ready.";
           if (checkoutJustConfirmed) document.title = "Echo plan active — continue setup";
-          slot.innerHTML = '<div class="setupPlanConfirmed' + (checkoutJustConfirmed ? ' is-checkout-confirmed' : '') + '"><span class="setupPlanConfirmedIcon" aria-hidden="true">' + setupIcon("check") + '</span><span class="setupPlanConfirmedCopy"><strong>' + (checkoutJustConfirmed ? 'Payment confirmed. ' : '') + esc(planLabel) + ' Echo</strong><span>' + esc(checkoutJustConfirmed ? "Your plan is ready. Continue below—checkout never needed access to this localhost page." : paidUsage) + '</span></span><button type="button" class="textButton" id="changeActivePlan">Change</button></div>';
+          slot.innerHTML = '<div class="setupPlanConfirmed' + (checkoutJustConfirmed ? ' is-checkout-confirmed' : '') + '"><span class="setupPlanConfirmedIcon" aria-hidden="true">' + setupIcon("check") + '</span><span class="setupPlanConfirmedCopy"><strong>' + (checkoutJustConfirmed ? 'Your Echo is ready. ' : '') + esc(planLabel) + ' Echo</strong><span>' + esc(checkoutJustConfirmed ? "Continue below." : paidUsage) + '</span></span><button type="button" class="textButton" id="changeActivePlan">Change</button></div>';
           var changeActivePlan = document.getElementById("changeActivePlan");
           if (changeActivePlan) changeActivePlan.onclick = openHostedPlanOptions;
           renderSessionSelection(true);
@@ -1054,8 +1055,8 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           return;
         }
         if (setupPlanChoice === "free") {
-          if (readySettings) readySettings.classList.remove("is-plan-open");
-          slot.innerHTML = '<div class="setupPlanConfirmed"><span class="setupPlanConfirmedIcon" aria-hidden="true">' + setupIcon("check") + '</span><span class="setupPlanConfirmedCopy"><strong>Original Echo</strong><span>100 bulk history imports, 25K new-chat tokens each week, and 10 memory searches each week.</span></span><button type="button" class="textButton" id="changeSetupPlan">Change</button></div>';
+          if (readySettings) readySettings.classList.remove("is-plan-open", "is-checkout-pending");
+          slot.innerHTML = '<div class="setupPlanConfirmed"><span class="setupPlanConfirmedIcon" aria-hidden="true">' + setupIcon("check") + '</span><span class="setupPlanConfirmedCopy"><strong>Original Echo</strong><span>100 bulk history imports, 25K new-chat tokens each week, and 100 memory searches each week.</span></span><button type="button" class="textButton" id="changeSetupPlan">Change</button></div>';
           var changeBtn = document.getElementById("changeSetupPlan");
           if (changeBtn) changeBtn.onclick = function () {
             rememberSetupPlanChoice("");
@@ -1068,11 +1069,14 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           ? "power"
           : (setupPlanChoice === "pro" || billingActivationPendingPlan === "pro" ? "pro" : "");
         if (pendingPaidPlan) {
-          if (readySettings) readySettings.classList.remove("is-plan-open");
+          if (readySettings) {
+            readySettings.classList.remove("is-plan-open");
+            readySettings.classList.add("is-checkout-pending");
+          }
           var selectedPaidPlan = pendingPaidPlan === "power" ? "Power" : "Pro";
           slot.innerHTML =
             '<section class="setupPlanChoice setupPlanCheckout" aria-labelledby="setupPlanHeading">' +
-              '<div class="setupPlanIntro"><h3 id="setupPlanHeading">' + selectedPaidPlan + ' checkout is open.</h3><p>Finish in the secure Stripe tab. This page will notice automatically when your plan becomes active.</p></div>' +
+              '<div class="setupPlanIntro"><h3 id="setupPlanHeading">Start your 14-day trial.</h3><p>Finish in the secure Stripe tab, then return here. Echo will update automatically.</p></div>' +
               '<button type="button" class="primary" id="continueSelectedPaidPlan">Reopen secure checkout</button>' +
               '<div class="setupPlanFoot"><button type="button" class="textButton" id="changeSelectedPaidPlan">Choose another Echo</button><span id="setupPlanStatus" role="status"></span></div>' +
             '</section>';
@@ -1090,7 +1094,10 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
           renderSessionSelection(true);
           return;
         }
-        if (readySettings) readySettings.classList.add("is-plan-open");
+        if (readySettings) {
+          readySettings.classList.remove("is-checkout-pending");
+          readySettings.classList.add("is-plan-open");
+        }
         slot.innerHTML = renderPlanHabitat();
         bindPlanHabitat();
         if (migrateBtn) migrateBtn.disabled = true;

package/dist/setup-page/styles-mvp.js CHANGED Viewed

@@ -807,6 +807,95 @@ export const SETUP_PAGE_STYLES_MVP = String.raw `
       padding: 0 8px;
       font-size: 11px;
     }
+    .extractionReady .readySettings.is-checkout-pending {
+      align-items: flex-start;
+    }
+    .extractionReady .readySettings.is-checkout-pending .readyPlanSetting {
+      display: block;
+      width: min(680px, calc(100vw - 260px));
+      overflow: visible;
+      border: 0;
+      border-radius: 0;
+      background: transparent;
+      padding: 0;
+      box-shadow: none;
+      backdrop-filter: none;
+    }
+    .extractionReady .readySettings.is-checkout-pending .readyPlanSetting > .readySettingLabel {
+      position: absolute;
+      width: 1px;
+      height: 1px;
+      overflow: hidden;
+      clip: rect(0 0 0 0);
+      clip-path: inset(50%);
+      white-space: nowrap;
+    }
+    .extractionReady .readySettings.is-checkout-pending .setupPlanSlot {
+      margin: 0;
+    }
+    .extractionReady .setupPlanCheckout {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      grid-template-rows: auto auto;
+      column-gap: 18px;
+      row-gap: 2px;
+      align-items: center;
+      margin: 0;
+      overflow: hidden;
+      border: 1px solid rgba(26,58,143,0.16);
+      border-radius: 18px;
+      background: rgba(255,255,255,0.94);
+      padding: 13px 15px 12px 18px;
+      box-shadow: 0 12px 32px rgba(26,58,143,0.12);
+      backdrop-filter: blur(16px);
+    }
+    .extractionReady .setupPlanCheckout::before {
+      display: block;
+      position: absolute;
+      inset: 0 auto 0 0;
+      width: 4px;
+      height: auto;
+      background: var(--echo-ink-primary);
+      opacity: 1;
+    }
+    .extractionReady .setupPlanCheckout .setupPlanIntro {
+      min-width: 0;
+      padding: 0;
+    }
+    .extractionReady .setupPlanCheckout .setupPlanIntro h3 {
+      font-size: 16px;
+      line-height: 1.2;
+      letter-spacing: -0.01em;
+    }
+    .extractionReady .setupPlanCheckout .setupPlanIntro p {
+      margin-top: 3px;
+      font-size: 11px;
+      line-height: 1.35;
+    }
+    .extractionReady .setupPlanCheckout > .primary {
+      grid-column: 2;
+      grid-row: 1 / span 2;
+      min-height: 42px;
+      border-radius: 999px;
+      padding: 0 18px;
+      white-space: nowrap;
+      box-shadow: 0 7px 18px rgba(26,58,143,0.18);
+    }
+    .extractionReady .setupPlanCheckout .setupPlanFoot {
+      justify-content: flex-start;
+      gap: 8px;
+      margin-top: 1px;
+    }
+    .extractionReady .setupPlanCheckout .setupPlanFoot .textButton {
+      min-height: 0;
+      padding: 2px 0;
+      color: var(--echo-ink-mute);
+      font-size: 10px;
+      font-weight: 700;
+    }
+    .extractionReady .setupPlanCheckout .setupPlanFoot span {
+      font-size: 10px;
+    }
     .extractionReady .readyFoot {
       width: min(620px, 100%);
       margin: 12px auto 0;
@@ -954,6 +1043,20 @@ export const SETUP_PAGE_STYLES_MVP = String.raw `
       .mvpHabitatDetails { padding: 28px 24px 34px; }
       .mvpHabitatEcho { width: min(66%, 360px); }
       .extractionReady .readySettings { flex-direction: column; gap: 9px; }
+      body.readyMode:has(.readySettings.is-checkout-pending) main {
+        padding-top: 190px;
+      }
+      .extractionReady .readySettings.is-checkout-pending .readyAccountSetting { display: none; }
+      .extractionReady .readySettings.is-checkout-pending .readyPlanSetting { width: 100%; }
+      .extractionReady .setupPlanCheckout {
+        grid-template-columns: 1fr;
+        gap: 9px;
+      }
+      .extractionReady .setupPlanCheckout > .primary {
+        grid-column: 1;
+        grid-row: auto;
+        width: 100%;
+      }
       .exHero.exHeroActive { grid-template-columns: 1fr; }
       .exHeroActive .exPlate { min-height: 440px; }
     }

package/dist/setup-preview.js CHANGED Viewed

@@ -339,22 +339,22 @@ export function renderSetupPreviewBootstrap(state) {
     if (state === "extract-pro-active")
         return `${watermark}${extractionPreviewBootstrap({
             plan: "pro", paid: true, trialAvailable: false, trialUsed: true,
-            subscriptionStatus: "active", quotaLimit: 250, quotaRemaining: 250,
+            subscriptionStatus: "active", quotaLimit: 500, quotaRemaining: 500,
         })}`;
     if (state === "extract-power-active")
         return `${watermark}${extractionPreviewBootstrap({
             plan: "power", paid: true, trialAvailable: false, trialUsed: true,
-            subscriptionStatus: "active", quotaLimit: 500, quotaRemaining: 500,
+            subscriptionStatus: "active", quotaLimit: 2_000, quotaRemaining: 2_000,
         })}`;
     if (state === "extract-team-active")
         return `${watermark}${extractionPreviewBootstrap({
             plan: "team", paid: true, trialAvailable: false, trialUsed: true,
-            subscriptionStatus: "active", quotaLimit: 250, quotaRemaining: 250,
+            subscriptionStatus: "active", quotaLimit: 500, quotaRemaining: 500,
         })}`;
     if (state === "extract-enterprise-active")
         return `${watermark}${extractionPreviewBootstrap({
             plan: "enterprise", paid: true, trialAvailable: false, trialUsed: true,
-            subscriptionStatus: "active", quotaLimit: 500, quotaRemaining: 500,
+            subscriptionStatus: "active", quotaLimit: 2_000, quotaRemaining: 2_000,
         })}`;
     if (state === "extract-unknown")
         return `${watermark}${extractionPreviewBootstrap({

package/dist/setup.js CHANGED Viewed

@@ -391,6 +391,16 @@ function echomemGuidanceBlock() {
         "- Before re-deriving past decisions, project context, or anything the user likely settled before: call `search_memories` first.",
         "- When meaningful work wraps up (a decision, a fix, a milestone) or the user asks to remember something: call `save_conversation`.",
         "- If the user pastes a session carryover/checkpoint: it may reference `get_checkpoint_by_context` — use it to pull the checkpoint/decision trail when you need more than the snapshot.",
+        "",
+        "### Company group memory",
+        "- Use `get_group_context` when the user asks who is in their company group, what teammates are responsible for, or what work is already covered. Treat declared participant fields as facts and published-memory conclusions as evidence or inference.",
+        "- A group publication is separate from a globally public memory: publishing to a group creates a group-scoped snapshot and must not change the encrypted original or its global `is_public` setting.",
+        "- If a user asks to create a group, call `create_memory_group`; if they ask for a code to share, call `create_group_invite` and return the secret invite code only to that user. Never save the invite code to memory or include it in logs, analytics, summaries, or unrelated output.",
+        "- If a user supplies an `echo_grp_...` code and explicitly asks to join, call `join_memory_group`. Joining never authorizes publishing by itself and must not move a user out of another group. After joining, continue into the profile-and-publication preview instead of leaving title or responsibility blank.",
+        "- For requests such as “prepare my recent work memories,” “upload work from this ticket,” or “publish work since my last sync,” call `prepare_group_publication` first. This is a no-publication preview. For encrypted accounts, tell the user to run `echomem-mcp unlock` locally if the tool reports that the key is required.",
+        "- After preparing, select only exact candidate memory IDs that match the user's stated scope and exclude already-published or exact-content duplicates. Use the candidate evidence to draft a concise title and responsibility summary for the current member, but label both as proposals rather than facts.",
+        "- Present the proposed title/responsibility and the memory publication preview together and ask for one explicit confirmation. Never save an inferred profile or publish memories before confirmation.",
+        "- On confirmation, call `update_group_profile` with the confirmed title, responsibility summary, and `confirmed: true`, then call `complete_group_publication` with the exact `scanId`, selected memory IDs, and `confirmed: true`. If the user edits either proposal, use their wording. An explicit request to join and upload still requires this combined preview and confirmation.",
         "- If the user asks to show, reopen, restart, or bring back the EchoMem HUD (the context-health overlay), run the shell command `echomem-hud app --client auto`.",
         "- If the user wants the HUD to come back after a computer restart, run the shell command `echomem-hud autostart on --client auto`.",
         AGENTS_MD_END,
@@ -1716,6 +1726,7 @@ export function startCallbackServer(opts = {}) {
                     return;
                 }
                 if (route === "/billing-status" && req.method === "GET") {
+                    res.setHeader("Cache-Control", "no-store, max-age=0");
                     if (!checkNonce(url.searchParams.get("nonce") || undefined))
                         return void text(res, 403, "bad nonce");
                     if (requiresReportConsent && !reportConsentGranted) {

package/dist/v1-contract.js CHANGED Viewed

@@ -10,6 +10,15 @@ export const canonicalToolNames = {
     sendFriendRequest: "send_friend_request",
     others: "search_others_memories",
     publicMemory: "get_public_memory",
+    groupContext: "get_group_context",
+    createGroup: "create_memory_group",
+    createGroupInvite: "create_group_invite",
+    joinGroup: "join_memory_group",
+    prepareGroupPublication: "prepare_group_publication",
+    updateGroupProfile: "update_group_profile",
+    completeGroupPublication: "complete_group_publication",
+    publishToGroup: "publish_memory_to_group",
+    publishBatchToGroup: "publish_memories_to_group",
     report: "echomem_usage_report",
     updateStatus: "echomem_update_status",
     contextHealth: "echo_context_health",
@@ -59,9 +68,17 @@ export const timeRangeSchema = z.object({
     endDate: z.string(),
     limit: z.number().optional().default(50),
 });
+const keywordListSchema = z.preprocess((value) => {
+    if (typeof value !== "string")
+        return value;
+    return value
+        .split(",")
+        .map((keyword) => keyword.trim())
+        .filter(Boolean);
+}, z.array(z.string().trim().min(1)).min(1).max(50));
 export const keywordsSchema = z.object({
     ...triggerMetadataSchema,
-    keywords: z.array(z.string()),
+    keywords: keywordListSchema,
     limit: z.number().optional().default(10),
 });
 export const listFriendsSchema = z.object({
@@ -94,6 +111,63 @@ export const publicMemorySchema = z.object({
     ...triggerMetadataSchema,
     memoryId: z.string().min(1),
 });
+export const groupContextSchema = z.object({
+    ...triggerMetadataSchema,
+});
+export const createGroupSchema = z.object({
+    ...triggerMetadataSchema,
+    name: z.string().min(1).max(120),
+    description: z.string().max(1000).optional(),
+    displayName: z.string().min(1).max(120),
+    title: z.string().max(160).optional(),
+    responsibilitySummary: z.string().max(1000).optional(),
+});
+export const createGroupInviteSchema = z.object({
+    ...triggerMetadataSchema,
+    expiresInDays: z.number().int().min(1).max(30).optional(),
+    maxUses: z.number().int().min(1).max(100).optional(),
+});
+export const joinGroupSchema = z.object({
+    ...triggerMetadataSchema,
+    code: z.string().min(30),
+    displayName: z.string().min(1).max(120),
+    title: z.string().max(160).optional(),
+    responsibilitySummary: z.string().max(1000).optional(),
+});
+export const prepareGroupPublicationSchema = z.object({
+    ...triggerMetadataSchema,
+    scope: z.enum(["bootstrap", "since_last_scan", "context", "time_range"]).default("since_last_scan"),
+    contextId: z.string().min(1).optional(),
+    startAt: z.string().optional(),
+    endAt: z.string().optional(),
+    lookbackDays: z.number().int().min(1).max(365).optional(),
+    limit: z.number().int().min(1).max(50).optional(),
+    instruction: z.string().max(500).optional(),
+});
+export const updateGroupProfileSchema = z.object({
+    ...triggerMetadataSchema,
+    displayName: z.string().min(1).max(120).optional(),
+    title: z.string().min(1).max(160),
+    responsibilitySummary: z.string().min(1).max(1000),
+    confirmed: z.literal(true),
+});
+export const completeGroupPublicationSchema = z.object({
+    ...triggerMetadataSchema,
+    scanId: z.string().min(1),
+    memoryIds: z.array(z.string().min(1)).max(50),
+    confirmed: z.literal(true),
+    selectionReason: z.string().max(500).optional(),
+});
+export const publishToGroupSchema = z.object({
+    ...triggerMetadataSchema,
+    memoryId: z.string().min(1),
+});
+export const publishBatchToGroupSchema = z.object({
+    ...triggerMetadataSchema,
+    memoryIds: z.array(z.string().min(1)).min(1).max(50),
+    contextId: z.string().min(1).optional(),
+    selectionReason: z.string().max(500).optional(),
+});
 export const deleteMemorySchema = z.object({
     memoryId: z.string().min(1),
     confirmed: z.boolean().optional().default(false),
@@ -108,7 +182,7 @@ export function listToolSpecs(opts = {}) {
     const currentTime = new Date().toISOString();
     const map = opts.map?.trim();
     const updateNotice = opts.updateNotice?.trim();
-    const recallPlanNote = "Available on every plan: Free includes 10 searches each week, Pro includes 100, and Power includes 250.";
+    const recallPlanNote = "Available on every plan: Free includes 100 searches each week, Pro includes 500, and Power includes 2,000.";
     const searchBillingReplyInstruction = "If search returns an ACTION REQUIRED subscription message, tell the user to start their trial or subscription and include the exact URL from that result verbatim. Do not respond only with \"connect\" or \"upgrade\".";
     const updateSection = updateNotice ? `\n\nUPDATE NOTICE: ${updateNotice}` : "";
     const mapSection = map
@@ -204,11 +278,27 @@ export function listToolSpecs(opts = {}) {
         },
         {
             name: canonicalToolNames.keywords,
-            description: `Search memories based on keywords in keys field. ${recallPlanNote}`,
+            description: `Search memories based on keywords in keys field. Pass keywords as valid JSON: preferably an array of quoted strings, for example {"keywords":["flow-lab","flow.html","Rive"],"limit":8}. A comma-separated JSON string is also accepted as a compatibility fallback. Never emit bare comma-separated tokens. ${recallPlanNote}`,
             inputSchema: {
                 type: "object",
                 properties: {
-                    keywords: { type: "array", items: { type: "string" } },
+                    keywords: {
+                        oneOf: [
+                            {
+                                type: "array",
+                                minItems: 1,
+                                maxItems: 50,
+                                items: { type: "string", minLength: 1 },
+                            },
+                            {
+                                type: "string",
+                                minLength: 1,
+                                description: "Compatibility form: one comma-separated JSON string, such as \"flow-lab, flow.html, Rive\".",
+                            },
+                        ],
+                        description: "Use a JSON array of quoted strings. Do not pass unquoted comma-separated tokens.",
+                        examples: [["flow-lab", "flow.html", "Rive"]],
+                    },
                     limit: { type: "number", default: 10 },
                     triggerMessage: {
                         type: "string",
@@ -274,7 +364,7 @@ export function listToolSpecs(opts = {}) {
         },
         {
             name: canonicalToolNames.others,
-            description: "Search accepted friends' public memories. Returned memories are recorded in the existing memory_views pipeline for the memory owners.",
+            description: "Search public memories from accepted friends or people who share your company group. For onboarding and division-of-work questions, call get_group_context first, then use this tool for current evidence. Returned memories are recorded in memory_views for the owners.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -282,25 +372,25 @@ export function listToolSpecs(opts = {}) {
                     limit: { type: "number", default: 10 },
                     target: {
                         type: "string",
-                        description: "Accepted-friend user id or exact display name/username. Prefer this for @Name asks.",
+                        description: "Accessible friend or group-member user id or exact display name. Prefer this for @Name asks.",
                     },
                     ownerUserId: {
                         type: "string",
-                        description: "Optional accepted-friend user id to scope the search to one friend.",
+                        description: "Optional accessible user id to scope the search to one person.",
                     },
                     ownerName: {
                         type: "string",
-                        description: "Optional accepted-friend display name/username to scope the search to one friend.",
+                        description: "Optional accessible friend or group-member display name to scope the search.",
                     },
                     targetFriendIds: {
                         type: "array",
                         items: { type: "string" },
-                        description: "Optional accepted-friend user ids to scope the search.",
+                        description: "Legacy field for optional accessible friend or group-member user ids.",
                     },
                     targetFriendNames: {
                         type: "array",
                         items: { type: "string" },
-                        description: "Optional accepted-friend display names/usernames to scope the search.",
+                        description: "Legacy field for optional accessible friend or group-member display names.",
                     },
                     recordAccess: {
                         type: "boolean",
@@ -319,7 +409,7 @@ export function listToolSpecs(opts = {}) {
         },
         {
             name: canonicalToolNames.publicMemory,
-            description: "Fetch one accepted friend's public memory by id. If the caller is not the owner, EchoMem records the access in the existing memory_views pipeline.",
+            description: "Fetch one public memory by id when its owner is an accepted friend or shares your company group. If the caller is not the owner, EchoMem records the access in memory_views.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -336,6 +426,153 @@ export function listToolSpecs(opts = {}) {
                 required: ["memoryId"],
             },
         },
+        {
+            name: canonicalToolNames.groupContext,
+            description: "Get your current company group, its participant directory, declared titles and responsibilities, and published-memory coverage. Use this before answering who works on what or suggesting where a new group member could contribute. Treat declared profile fields as facts and memory-derived work as evidence or inference.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional user message that caused this group-orientation lookup.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
+                },
+            },
+        },
+        {
+            name: canonicalToolNames.createGroup,
+            description: "Create one company memory group for the current user. The MVP allows at most one group per user. Call only after the user explicitly asks to create a group.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                    description: { type: "string" },
+                    displayName: { type: "string" },
+                    title: { type: "string" },
+                    responsibilitySummary: { type: "string" },
+                },
+                required: ["name", "displayName"],
+            },
+        },
+        {
+            name: canonicalToolNames.createGroupInvite,
+            description: "Generate a secret, expiring invite code for the current group. Only the group creator may call this in the MVP. Return the code only to the user so they can share it intentionally; never log it.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    expiresInDays: { type: "number", default: 7 },
+                    maxUses: { type: "number", default: 20 },
+                },
+            },
+        },
+        {
+            name: canonicalToolNames.joinGroup,
+            description: "Join a company memory group using an invite code after the user explicitly asks to join. Joining never publishes memories. Next call prepare_group_publication, infer a proposed title and responsibility summary from the user's own candidate memories, and ask the user to confirm the profile together with the publication preview.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    code: { type: "string" },
+                    displayName: { type: "string" },
+                    title: { type: "string" },
+                    responsibilitySummary: { type: "string" },
+                },
+                required: ["code", "displayName"],
+            },
+        },
+        {
+            name: canonicalToolNames.prepareGroupPublication,
+            description: "Prepare a no-publication preview of up to 50 owned memories for group publication. For encrypted accounts the local bridge must be unlocked. The host agent selects exact work-related memory ids, drafts a concise title and responsibility summary from memory evidence, and asks the user to confirm both the profile and publication selection together. This tool never publishes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    scope: { type: "string", enum: ["bootstrap", "since_last_scan", "context", "time_range"], default: "since_last_scan" },
+                    contextId: { type: "string" },
+                    startAt: { type: "string" },
+                    endAt: { type: "string" },
+                    lookbackDays: { type: "number", default: 30 },
+                    limit: { type: "number", default: 50 },
+                    instruction: { type: "string", default: "work-related" },
+                },
+            },
+        },
+        {
+            name: canonicalToolNames.updateGroupProfile,
+            description: "Save the current member's declared group title and responsibility summary only after the user explicitly confirms the agent's proposal. These become directory facts visible to group members; never save an unconfirmed inference.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    displayName: { type: "string" },
+                    title: { type: "string" },
+                    responsibilitySummary: { type: "string" },
+                    confirmed: { type: "boolean", const: true },
+                },
+                required: ["title", "responsibilitySummary", "confirmed"],
+            },
+        },
+        {
+            name: canonicalToolNames.completeGroupPublication,
+            description: "Publish only the exact memory ids from a prepared scan after the user explicitly confirms the preview. confirmed must be true. Completing an empty selection safely advances the scan cursor without publishing.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    scanId: { type: "string" },
+                    memoryIds: { type: "array", maxItems: 50, items: { type: "string" } },
+                    confirmed: { type: "boolean", const: true },
+                    selectionReason: { type: "string" },
+                },
+                required: ["scanId", "memoryIds", "confirmed"],
+            },
+        },
+        {
+            name: canonicalToolNames.publishToGroup,
+            description: "Publish one exact memory snapshot to your current company group without changing the memory's global is_public or encryption state. Call only after the user explicitly asks to publish or push that memory. The operation is idempotent.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    memoryId: {
+                        type: "string",
+                        description: "Exact id of a memory owned by the current user.",
+                    },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional user message that explicitly requested publication.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
+                },
+                required: ["memoryId"],
+            },
+        },
+        {
+            name: canonicalToolNames.publishBatchToGroup,
+            description: "Publish up to 50 exact memory snapshots to your current company group without changing global is_public or the encrypted originals. For a session request, first call get_memories_by_context, select the exact ids that match the user's instruction, then pass those ids with the same contextId. Call only after explicit group-publication intent; report what was selected when the user delegates work-related filtering.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    memoryIds: {
+                        type: "array",
+                        minItems: 1,
+                        maxItems: 50,
+                        items: { type: "string" },
+                        description: "Exact ids owned by the current user.",
+                    },
+                    contextId: {
+                        type: "string",
+                        description: "Optional session context that every supplied memory must belong to.",
+                    },
+                    selectionReason: {
+                        type: "string",
+                        description: "Short explanation to return when the agent selected a subset, such as work-related memories.",
+                    },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional user message that explicitly requested publication.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
+                },
+                required: ["memoryIds"],
+            },
+        },
         {
             name: canonicalToolNames.delete,
             description: "Delete one of the user's EchoMem memories only after explicit user confirmation. First call with memoryId and confirmed omitted/false to preview the target and receive a confirmationToken; this first call never deletes. Only call again with confirmed=true and that exact confirmationToken after the user explicitly confirms deletion. Deletes the memory row only; raw source_of_truth conversation records are preserved.",

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.4.22",
+  "version": "1.4.24",
   "description": "EchoMem MCP bridge: cloud-first memory tools, local context HUD, and the Agent Doctor workspace forensics report (cost ledger + 3D repo city)",
   "main": "dist/index.js",
   "type": "module",