aimeat 1.2.0

package/dist/src/mcp/boards.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file boards.ts
+ * @description MCP board tools and resource registrations. Provides 7 tools for board
+ *   management (list, create, subscribe, react, reply, manage members, delete) and 1
+ *   resource template for reading board posts via the MCP resource protocol.
+ * @structure
+ *   - registerBoardsTools() — registers all board tools and resources on an McpServer instance
+ * @usage
+ *   import { registerBoardsTools } from './boards.js';
+ *   registerBoardsTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 7 tools + 1 resource for board management via MCP
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare function registerBoardsTools(mcp: McpServer, storage: Storage, config: AimeatConfig, getAgentGaii: () => string, emitResourceUpdated: (agentGaii: string, uri: string) => void, emitResourceListChanged: (agentGaii: string) => void): void;
+//# sourceMappingURL=boards.d.ts.map

package/dist/src/mcp/boards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../../src/mcp/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,MAAM,EAC1B,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,EAC7D,uBAAuB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAqTN"}

package/dist/src/mcp/boards.js

@@ -0,0 +1,279 @@
+/**
+ * @file boards.ts
+ * @description MCP board tools and resource registrations. Provides 7 tools for board
+ *   management (list, create, subscribe, react, reply, manage members, delete) and 1
+ *   resource template for reading board posts via the MCP resource protocol.
+ * @structure
+ *   - registerBoardsTools() — registers all board tools and resources on an McpServer instance
+ * @usage
+ *   import { registerBoardsTools } from './boards.js';
+ *   registerBoardsTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 7 tools + 1 resource for board management via MCP
+ */
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { randomBytes } from 'node:crypto';
+import { parseGAII, isSameOwner, parseGaiiLoose } from '../utils/gaii.js';
+export function registerBoardsTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged) {
+    const agentGaii = getAgentGaii();
+    /** Check if the current agent's owner is an operator. */
+    async function isOperator() {
+        const parsed = parseGAII(agentGaii);
+        if (!parsed)
+            return false;
+        const owner = await storage.getOwner(parsed.owner);
+        return !!owner && owner.roles.includes('operator');
+    }
+    /** Check if the agent can see a board (visibility rules). */
+    function canSeeBoard(board) {
+        if (board.visibility === 'public' || board.visibility === 'system')
+            return true;
+        if (board.ownerGaii === agentGaii)
+            return true;
+        if (board.visibility === 'shared' && isSameOwner(board.ownerGaii, agentGaii))
+            return true;
+        if (board.allowedGaiis.includes(agentGaii))
+            return true;
+        return false;
+    }
+    // ── Resource: board posts ──
+    mcp.registerResource('board-posts', new ResourceTemplate('aimeat://boards/{boardId}', {
+        list: async () => {
+            const boards = await storage.listBoards();
+            const visible = boards.filter(b => canSeeBoard(b));
+            return {
+                resources: visible.map(b => ({
+                    uri: `aimeat://boards/${encodeURIComponent(b.id)}`,
+                    name: b.name,
+                    mimeType: 'application/json',
+                    description: `Board: ${b.name} (${b.visibility})`,
+                })),
+            };
+        },
+    }), { mimeType: 'application/json', description: 'Board posts' }, async (uri, variables) => {
+        const boardId = decodeURIComponent(variables.boardId);
+        const board = await storage.getBoard(boardId);
+        if (!board)
+            return { contents: [{ uri: uri.toString(), text: 'Board not found' }] };
+        if (!canSeeBoard(board))
+            return { contents: [{ uri: uri.toString(), text: 'Access denied' }] };
+        const posts = await storage.listPosts(boardId, { limit: 50 });
+        return {
+            contents: [{
+                    uri: uri.toString(),
+                    text: JSON.stringify(posts.map(p => ({
+                        id: p.id,
+                        author_gaii: p.authorGaii,
+                        title: p.title,
+                        body: p.body,
+                        category: p.category,
+                        reactions: p.reactions,
+                        reply_to: p.replyTo,
+                        created_at: p.createdAt,
+                    })), null, 2),
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    // ── Tool 1: aimeat_board_list ──
+    mcp.tool('aimeat_board_list', 'List visible boards', {}, async () => {
+        const boards = await storage.listBoards();
+        const visible = boards.filter(b => canSeeBoard(b));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(visible.map(b => ({
+                        id: b.id,
+                        name: b.name,
+                        description: b.description,
+                        visibility: b.visibility,
+                        owner_gaii: b.ownerGaii,
+                        allowed_gaiis: b.allowedGaiis,
+                        created_at: b.createdAt,
+                    })), null, 2),
+                }],
+        };
+    });
+    // ── Tool 2: aimeat_board_create ──
+    mcp.tool('aimeat_board_create', 'Create a new board', {
+        name: z.string(),
+        visibility: z.enum(['private', 'shared', 'public']),
+        description: z.string().optional(),
+        allowed_gaiis: z.array(z.string()).optional(),
+    }, async ({ name, visibility, description, allowed_gaiis }) => {
+        // public/system require operator
+        if (visibility === 'public') {
+            if (!(await isOperator())) {
+                return { content: [{ type: 'text', text: 'Operator role required for public boards' }], isError: true };
+            }
+        }
+        const id = `board-${randomBytes(8).toString('hex')}`;
+        const board = await storage.createBoard({
+            id,
+            name,
+            description,
+            visibility,
+            ownerGaii: agentGaii,
+            allowedGaiis: allowed_gaiis ?? [],
+            createdAt: new Date().toISOString(),
+        });
+        emitResourceListChanged(agentGaii);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: board.id,
+                        name: board.name,
+                        visibility: board.visibility,
+                        created_at: board.createdAt,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 3: aimeat_board_subscribe ──
+    mcp.tool('aimeat_board_subscribe', 'Subscribe to board notifications', {
+        board_id: z.string(),
+        callback_url: z.string().optional(),
+        filters: z.object({
+            categories: z.array(z.string()).optional(),
+            tags: z.array(z.string()).optional(),
+        }).optional(),
+    }, async ({ board_id, callback_url, filters }) => {
+        const board = await storage.getBoard(board_id);
+        if (!board)
+            return { content: [{ type: 'text', text: 'Board not found' }], isError: true };
+        if (!canSeeBoard(board))
+            return { content: [{ type: 'text', text: 'Access denied' }], isError: true };
+        // Check if already subscribed
+        const existing = await storage.getBoardSubscription(board_id, agentGaii);
+        if (existing)
+            return { content: [{ type: 'text', text: 'Already subscribed to this board' }], isError: true };
+        const sub = await storage.createBoardSubscription({
+            id: `sub-${randomBytes(8).toString('hex')}`,
+            boardId: board_id,
+            gaii: agentGaii,
+            callbackUrl: callback_url,
+            filters,
+            createdAt: new Date().toISOString(),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        subscription_id: sub.id,
+                        board_id: sub.boardId,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 4: aimeat_board_react ──
+    mcp.tool('aimeat_board_react', 'React to a board post with an emoji', {
+        board_id: z.string(),
+        post_id: z.string(),
+        emoji: z.string(),
+    }, async ({ board_id, post_id, emoji }) => {
+        const ok = await storage.addReaction(board_id, post_id, emoji, agentGaii);
+        if (!ok)
+            return { content: [{ type: 'text', text: 'Post not found' }], isError: true };
+        emitResourceUpdated(agentGaii, `aimeat://boards/${encodeURIComponent(board_id)}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 5: aimeat_board_reply ──
+    mcp.tool('aimeat_board_reply', 'Reply to a board post', {
+        board_id: z.string(),
+        post_id: z.string(),
+        body: z.string(),
+    }, async ({ board_id, post_id, body }) => {
+        const parent = await storage.getPost(board_id, post_id);
+        if (!parent)
+            return { content: [{ type: 'text', text: 'Post not found' }], isError: true };
+        const replyId = `reply-${randomBytes(8).toString('hex')}`;
+        const reply = await storage.createPost({
+            id: replyId,
+            boardId: board_id,
+            authorGaii: agentGaii,
+            title: `Re: ${parent.title}`,
+            body,
+            tags: [],
+            reactions: {},
+            replyTo: post_id,
+            createdAt: new Date().toISOString(),
+        });
+        emitResourceUpdated(agentGaii, `aimeat://boards/${encodeURIComponent(board_id)}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: reply.id,
+                        board_id: reply.boardId,
+                        reply_to: reply.replyTo,
+                        title: reply.title,
+                        created_at: reply.createdAt,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 6: aimeat_board_members ──
+    mcp.tool('aimeat_board_members', 'Manage board members (add/remove allowed GAIIs)', {
+        board_id: z.string(),
+        add: z.array(z.string()).optional(),
+        remove: z.array(z.string()).optional(),
+    }, async ({ board_id, add, remove }) => {
+        const board = await storage.getBoard(board_id);
+        if (!board)
+            return { content: [{ type: 'text', text: 'Board not found' }], isError: true };
+        // Auth: agent's owner must be the board owner
+        const agentOwner = parseGaiiLoose(agentGaii).owner;
+        const boardOwner = parseGaiiLoose(board.ownerGaii).owner;
+        if (agentOwner !== boardOwner) {
+            return { content: [{ type: 'text', text: 'Only the board owner can manage members' }], isError: true };
+        }
+        // Compute new member set
+        const members = new Set(board.allowedGaiis);
+        if (Array.isArray(add))
+            for (const g of add)
+                members.add(g);
+        if (Array.isArray(remove))
+            for (const g of remove)
+                members.delete(g);
+        const updated = await storage.updateBoardMembers(board_id, [...members]);
+        if (!updated)
+            return { content: [{ type: 'text', text: 'Failed to update board members' }], isError: true };
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        board_id: updated.id,
+                        allowed_gaiis: updated.allowedGaiis,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 7: aimeat_board_delete ──
+    mcp.tool('aimeat_board_delete', 'Delete a board', {
+        board_id: z.string(),
+    }, async ({ board_id }) => {
+        const board = await storage.getBoard(board_id);
+        if (!board)
+            return { content: [{ type: 'text', text: 'Board not found' }], isError: true };
+        // Auth: owner or operator
+        if (board.ownerGaii !== agentGaii && !(await isOperator())) {
+            return { content: [{ type: 'text', text: 'Only the board owner or operator can delete this board' }], isError: true };
+        }
+        await storage.deleteBoard(board_id);
+        emitResourceListChanged(agentGaii);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ deleted: true }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=boards.js.map

package/dist/src/mcp/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../../src/mcp/boards.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/catalogue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file catalogue.ts
+ * @description MCP catalogue tools. Provides 3 read-only discovery tools for browsing
+ *   the agent directory, public boards, and the people directory.
+ * @structure
+ *   - registerCatalogueTools() — registers all catalogue tools on an McpServer instance
+ * @usage
+ *   import { registerCatalogueTools } from './catalogue.js';
+ *   registerCatalogueTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 3 tools for agent directory, public boards, and people directory
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare function registerCatalogueTools(mcp: McpServer, storage: Storage, _config: AimeatConfig, _getAgentGaii: () => string, _emitResourceUpdated: (agentGaii: string, uri: string) => void, _emitResourceListChanged: (agentGaii: string) => void): void;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/src/mcp/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../../src/mcp/catalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,MAAM,MAAM,EAC3B,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,EAC9D,wBAAwB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACtD,IAAI,CAgIN"}

package/dist/src/mcp/catalogue.js

@@ -0,0 +1,114 @@
+/**
+ * @file catalogue.ts
+ * @description MCP catalogue tools. Provides 3 read-only discovery tools for browsing
+ *   the agent directory, public boards, and the people directory.
+ * @structure
+ *   - registerCatalogueTools() — registers all catalogue tools on an McpServer instance
+ * @usage
+ *   import { registerCatalogueTools } from './catalogue.js';
+ *   registerCatalogueTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 3 tools for agent directory, public boards, and people directory
+ */
+import { z } from 'zod';
+export function registerCatalogueTools(mcp, storage, _config, _getAgentGaii, _emitResourceUpdated, _emitResourceListChanged) {
+    // ── Tool 1: aimeat_catalogue_agents ──
+    mcp.tool('aimeat_catalogue_agents', 'Search the agent directory by name/description or capability category', {
+        search: z.string().optional(),
+        category: z.string().optional(),
+    }, async ({ search, category }) => {
+        const agents = await storage.listAgents();
+        const q = search?.toLowerCase();
+        const cat = category?.toLowerCase();
+        const filtered = agents.filter(a => {
+            if (q) {
+                const inName = (a.displayName ?? a.name).toLowerCase().includes(q);
+                const inDesc = (a.description ?? '').toLowerCase().includes(q);
+                const inGaii = a.gaii.toLowerCase().includes(q);
+                if (!inName && !inDesc && !inGaii)
+                    return false;
+            }
+            if (cat) {
+                const inCaps = a.capabilities.some(c => c.toLowerCase().includes(cat));
+                if (!inCaps)
+                    return false;
+            }
+            return true;
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(filtered.map(a => ({
+                        gaii: a.gaii,
+                        display_name: a.displayName ?? a.name,
+                        description: a.description,
+                        capabilities: a.capabilities,
+                        trust_score: a.trustScore,
+                        last_seen: a.lastSeen,
+                    })), null, 2),
+                }],
+        };
+    });
+    // ── Tool 2: aimeat_catalogue_boards ──
+    mcp.tool('aimeat_catalogue_boards', 'Browse all publicly visible boards on this node', {}, async () => {
+        const boards = await storage.listBoards();
+        const publicBoards = boards.filter(b => b.visibility === 'public');
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(publicBoards.map(b => ({
+                        id: b.id,
+                        name: b.name,
+                        description: b.description,
+                        created_at: b.createdAt,
+                    })), null, 2),
+                }],
+        };
+    });
+    // ── Tool 3: aimeat_catalogue_directory ──
+    mcp.tool('aimeat_catalogue_directory', 'Search the people directory. Filters by city or interest keyword. Only lists profiles that have opted in to public listing.', {
+        city: z.string().optional(),
+        interest: z.string().optional(),
+    }, async ({ city, interest }) => {
+        const ghiis = await storage.listGHIIs();
+        const cityQ = city?.toLowerCase();
+        const interestQ = interest?.toLowerCase();
+        // For each GHII, read their public location/interests from memory
+        const entries = [];
+        for (const ghii of ghiis) {
+            // Read public profile location and interests memory keys
+            const locationRecord = await storage.getMemory(ghii.ghii, 'profile.location');
+            const interestsRecord = await storage.getMemory(ghii.ghii, 'profile.interests');
+            // Skip profiles that haven't set public location/interests (not opted in to directory)
+            if (!locationRecord && !interestsRecord)
+                continue;
+            if (locationRecord && locationRecord.visibility !== 'public')
+                continue;
+            if (interestsRecord && interestsRecord.visibility !== 'public')
+                continue;
+            const loc = locationRecord?.value;
+            const interests = Array.isArray(interestsRecord?.value)
+                ? interestsRecord.value
+                : [];
+            // Apply filters
+            if (cityQ && !loc?.city?.toLowerCase().includes(cityQ))
+                continue;
+            if (interestQ && !interests.some(i => i.toLowerCase().includes(interestQ)))
+                continue;
+            entries.push({
+                ghii: ghii.ghii,
+                display_name: ghii.displayName,
+                bio: ghii.bio,
+                city: loc?.city,
+                interests,
+            });
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(entries, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/src/mcp/catalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.js","sourceRoot":"","sources":["../../../src/mcp/catalogue.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/chat-instances.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file chat-instances.ts
+ * @description MCP chat instance tools and resource registrations. Provides 3 tools for
+ *   chat instance management (list, create, status) and 1 resource template for reading
+ *   instance details via the MCP resource protocol.
+ * @structure
+ *   - registerChatInstancesTools() — registers all chat instance tools and resources on an McpServer instance
+ * @usage
+ *   import { registerChatInstancesTools } from './chat-instances.js';
+ *   registerChatInstancesTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 3 tools + 1 resource for chat instance management via MCP
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare function registerChatInstancesTools(mcp: McpServer, storage: Storage, config: AimeatConfig, getAgentGaii: () => string, emitResourceUpdated: (agentGaii: string, uri: string) => void, emitResourceListChanged: (agentGaii: string) => void): void;
+//# sourceMappingURL=chat-instances.d.ts.map

package/dist/src/mcp/chat-instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-instances.d.ts","sourceRoot":"","sources":["../../../src/mcp/chat-instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,wBAAgB,0BAA0B,CACtC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,MAAM,EAC1B,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,EAC7D,uBAAuB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAgLN"}

package/dist/src/mcp/chat-instances.js

@@ -0,0 +1,161 @@
+/**
+ * @file chat-instances.ts
+ * @description MCP chat instance tools and resource registrations. Provides 3 tools for
+ *   chat instance management (list, create, status) and 1 resource template for reading
+ *   instance details via the MCP resource protocol.
+ * @structure
+ *   - registerChatInstancesTools() — registers all chat instance tools and resources on an McpServer instance
+ * @usage
+ *   import { registerChatInstancesTools } from './chat-instances.js';
+ *   registerChatInstancesTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged);
+ * @version-history
+ *   v1.0.0 — 2026-03-21 — Initial creation: 3 tools + 1 resource for chat instance management via MCP
+ */
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { parseGaiiLoose, buildChatInstanceId } from '../utils/gaii.js';
+export function registerChatInstancesTools(mcp, storage, config, getAgentGaii, emitResourceUpdated, emitResourceListChanged) {
+    const agentGaii = getAgentGaii();
+    /** Resolve owner name from agent GAII */
+    function ownerName() {
+        return parseGaiiLoose(agentGaii).owner;
+    }
+    // ── Resource: chat instance ──
+    mcp.registerResource('chat-instance', new ResourceTemplate('aimeat://instances/{id}', {
+        list: async () => {
+            const instances = await storage.listChatInstances({ ownerName: ownerName() });
+            return {
+                resources: instances.map(inst => ({
+                    uri: `aimeat://instances/${encodeURIComponent(inst.id)}`,
+                    name: inst.appName,
+                    mimeType: 'application/json',
+                    description: `Instance: ${inst.platform} (${inst.id})`,
+                })),
+            };
+        },
+    }), { mimeType: 'application/json', description: 'Chat instance details' }, async (uri, variables) => {
+        const id = decodeURIComponent(variables.id);
+        const inst = await storage.getChatInstance(id);
+        if (!inst)
+            return { contents: [{ uri: uri.toString(), text: 'Instance not found' }] };
+        if (inst.ownerName !== ownerName()) {
+            return { contents: [{ uri: uri.toString(), text: 'Access denied' }] };
+        }
+        return {
+            contents: [{
+                    uri: uri.toString(),
+                    text: JSON.stringify({
+                        id: inst.id,
+                        platform: inst.platform,
+                        app_name: inst.appName,
+                        ghii: inst.ghii,
+                        is_anonymous: inst.isAnonymous,
+                        created_at: inst.createdAt,
+                        last_seen: inst.lastSeen,
+                        agent_gaii: inst.agentGaii ?? null,
+                    }, null, 2),
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    // ── Tool 1: aimeat_instance_list ──
+    mcp.tool('aimeat_instance_list', "List agent owner's chat instances", {}, async () => {
+        const instances = await storage.listChatInstances({ ownerName: ownerName() });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(instances.map(inst => ({
+                        id: inst.id,
+                        platform: inst.platform,
+                        app_name: inst.appName,
+                        ghii: inst.ghii,
+                        is_anonymous: inst.isAnonymous,
+                        created_at: inst.createdAt,
+                        last_seen: inst.lastSeen,
+                        agent_gaii: inst.agentGaii ?? null,
+                    })), null, 2),
+                }],
+        };
+    });
+    // ── Tool 2: aimeat_instance_create ──
+    mcp.tool('aimeat_instance_create', 'Register a new chat instance', {
+        name: z.string().describe('Application name for this instance'),
+        model: z.string().optional().describe('AI model identifier (e.g. gpt-4o, claude-3-5-sonnet)'),
+    }, async ({ name, model }) => {
+        const owner = ownerName();
+        const platform = model ? model.split('-')[0] ?? 'unknown' : 'unknown';
+        const id = buildChatInstanceId(platform, name, owner, config.nodeId);
+        const ghii = `${owner}@${config.nodeId}`;
+        const now = new Date().toISOString();
+        // Upsert: if already exists just return it
+        const existing = await storage.getChatInstance(id);
+        if (existing) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            id: existing.id,
+                            name: existing.appName,
+                            platform: existing.platform,
+                            status: 'existing',
+                            created_at: existing.createdAt,
+                        }, null, 2),
+                    }],
+            };
+        }
+        const inst = await storage.createChatInstance({
+            id,
+            platform,
+            appName: name,
+            ownerName: owner,
+            ghii,
+            nodeId: config.nodeId,
+            isAnonymous: false,
+            agentGaii: agentGaii,
+            createdAt: now,
+            lastSeen: now,
+        });
+        emitResourceListChanged(agentGaii);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: inst.id,
+                        name: inst.appName,
+                        platform: inst.platform,
+                        status: 'created',
+                        created_at: inst.createdAt,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── Tool 3: aimeat_instance_status ──
+    mcp.tool('aimeat_instance_status', 'Get chat instance status and details', {
+        instance_id: z.string().describe('Chat instance ID'),
+    }, async ({ instance_id }) => {
+        const inst = await storage.getChatInstance(instance_id);
+        if (!inst) {
+            return { content: [{ type: 'text', text: 'Instance not found' }], isError: true };
+        }
+        if (inst.ownerName !== ownerName()) {
+            return { content: [{ type: 'text', text: 'Access denied' }], isError: true };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: inst.id,
+                        platform: inst.platform,
+                        app_name: inst.appName,
+                        ghii: inst.ghii,
+                        is_anonymous: inst.isAnonymous,
+                        created_at: inst.createdAt,
+                        last_seen: inst.lastSeen,
+                        agent_gaii: inst.agentGaii ?? null,
+                        node_id: inst.nodeId,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=chat-instances.js.map