aimeat 1.9.2 → 1.9.4

package/dist/src/cli/connect/mcp/tools/memory-ext.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function registerMemoryExtTools(mcp, client) {
+    mcp.tool('aimeat_memory_read_public', 'Read another agent\'s public memory entry', {
+        gaii: z.string().describe('Target agent or owner GAII/GHII'),
+        key: z.string().describe('Memory entry key'),
+    }, async ({ gaii, key }) => {
+        const resp = await client.get(`/v1/memory/${encodeURIComponent(gaii)}/${encodeURIComponent(key)}`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+}
+//# sourceMappingURL=memory-ext.js.map

package/dist/src/cli/connect/mcp/tools/memory-ext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ext.js","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/memory-ext.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,sBAAsB,CAAC,GAAc,EAAE,MAAoB;IAEzE,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,2CAA2C,EAAE;QACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC5D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KAC7C,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CACpE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/cli/connect/mcp/tools/organisms.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file organisms.ts
+ * @description MCP tool registrations for organism (collective) management --
+ *   listing, viewing, joining, leaving, and member listing.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatClient } from '../../api-client.js';
+export declare function registerOrganismsTools(mcp: McpServer, client: AimeatClient): void;
+//# sourceMappingURL=organisms.d.ts.map

package/dist/src/cli/connect/mcp/tools/organisms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organisms.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/organisms.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCjF"}

package/dist/src/cli/connect/mcp/tools/organisms.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export function registerOrganismsTools(mcp, client) {
+    mcp.tool('aimeat_organism_list', 'List organisms', {}, async () => {
+        const resp = await client.get('/v1/organisms');
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+    mcp.tool('aimeat_organism_get', 'Get organism detail', {
+        id: z.string().describe('Organism identifier'),
+    }, async ({ id }) => {
+        const resp = await client.get(`/v1/organisms/${encodeURIComponent(id)}`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+    mcp.tool('aimeat_organism_join', 'Join an organism', {
+        id: z.string().describe('Organism identifier'),
+    }, async ({ id }) => {
+        const resp = await client.post(`/v1/organisms/${encodeURIComponent(id)}/join`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+    mcp.tool('aimeat_organism_leave', 'Leave an organism', {
+        id: z.string().describe('Organism identifier'),
+    }, async ({ id }) => {
+        const resp = await client.post(`/v1/organisms/${encodeURIComponent(id)}/leave`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+    mcp.tool('aimeat_organism_members', 'List organism members', {
+        id: z.string().describe('Organism identifier'),
+    }, async ({ id }) => {
+        const resp = await client.get(`/v1/organisms/${encodeURIComponent(id)}/members`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+}
+//# sourceMappingURL=organisms.js.map

package/dist/src/cli/connect/mcp/tools/organisms.js.map

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

package/dist/src/cli/connect/mcp/tools/wallet-ext.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file wallet-ext.ts
+ * @description MCP tool registration for wallet transaction history.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatClient } from '../../api-client.js';
+export declare function registerWalletExtTools(mcp: McpServer, client: AimeatClient): void;
+//# sourceMappingURL=wallet-ext.d.ts.map

package/dist/src/cli/connect/mcp/tools/wallet-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-ext.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/wallet-ext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CASjF"}

package/dist/src/cli/connect/mcp/tools/wallet-ext.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function registerWalletExtTools(mcp, client) {
+    mcp.tool('aimeat_wallet_transactions', 'View morsel wallet transaction history', {
+        limit: z.number().optional().describe('Maximum transactions to return'),
+    }, async ({ limit }) => {
+        const qs = limit !== undefined ? `?limit=${limit}` : '';
+        const resp = await client.get(`/v1/wallet/transactions${qs}`);
+        return { content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }] };
+    });
+}
+//# sourceMappingURL=wallet-ext.js.map

package/dist/src/cli/connect/mcp/tools/wallet-ext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-ext.js","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/wallet-ext.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,sBAAsB,CAAC,GAAc,EAAE,MAAoB;IAEzE,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,wCAAwC,EAAE;QAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KACxE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/cli/connect/mcp/wakeup.d.ts

@@ -0,0 +1,3 @@
+import type { AimeatConnectConfig } from '../config.js';
+export declare function wakeAgent(config: AimeatConnectConfig, event: string, detail: string): Promise<void>;
+//# sourceMappingURL=wakeup.d.ts.map

package/dist/src/cli/connect/mcp/wakeup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/mcp/wakeup.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,wBAAsB,SAAS,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCzG"}

package/dist/src/cli/connect/mcp/wakeup.js

@@ -0,0 +1,59 @@
+/**
+ * @file wakeup.ts
+ * @description Agent wake-up via shell command or webhook POST.
+ */
+import { exec } from 'node:child_process';
+export async function wakeAgent(config, event, detail) {
+    const wake = config.wake;
+    if (!wake)
+        return;
+    const strategy = wake.strategy ?? 'command_first';
+    const command = wake.command?.replace('{{agent}}', config.agent);
+    const webhook = wake.webhook;
+    if ((strategy === 'command_only' || strategy === 'command_first') && command) {
+        try {
+            await execCommand(command);
+            console.error(`[wake] Command succeeded: ${command}`);
+            return;
+        }
+        catch (err) {
+            console.error(`[wake] Command failed: ${err.message}`);
+            if (strategy === 'command_only')
+                return;
+        }
+    }
+    if ((strategy === 'webhook_only' || strategy === 'webhook_first' || strategy === 'command_first') && webhook) {
+        try {
+            await fetch(webhook, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ event, agent: config.agent, detail }),
+            });
+            console.error(`[wake] Webhook POST succeeded: ${webhook}`);
+            return;
+        }
+        catch (err) {
+            console.error(`[wake] Webhook failed: ${err.message}`);
+        }
+    }
+    if (strategy === 'webhook_first' && command) {
+        try {
+            await execCommand(command);
+            console.error(`[wake] Command fallback succeeded: ${command}`);
+        }
+        catch (err) {
+            console.error(`[wake] Command fallback failed: ${err.message}`);
+        }
+    }
+}
+function execCommand(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, { timeout: 10_000 }, (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+//# sourceMappingURL=wakeup.js.map

package/dist/src/cli/connect/mcp/wakeup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup.js","sourceRoot":"","sources":["../../../../../src/cli/connect/mcp/wakeup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA2B,EAAE,KAAa,EAAE,MAAc;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAE7B,IAAI,CAAC,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,eAAe,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7E,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,0BAA2B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClE,IAAI,QAAQ,KAAK,cAAc;gBAAE,OAAO;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,eAAe,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7G,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,EAAE;gBACnB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;aAC7D,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,0BAA2B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,eAAe,IAAI,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,mCAAoC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;YACrC,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/cli/connect/send.d.ts

@@ -0,0 +1,2 @@
+export declare function runSend(flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=send.d.ts.map

package/dist/src/cli/connect/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/send.ts"],"names":[],"mappings":"AAUA,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB1E"}

package/dist/src/cli/connect/send.js

@@ -0,0 +1,35 @@
+/**
+ * @file send.ts
+ * @description CLI subcommand: send a message
+ * @structure Validates message flags and posts an agent message through the authenticated connector client.
+ * @usage Called by `aimeat connect send --to <GAII> --body <message>`.
+ * @version-history v1.9.4 — 2026-05-28 — Update connector guidance and fail missing arguments with a nonzero exit.
+ */
+import { AimeatClient } from './api-client.js';
+import { loadConfig } from './config.js';
+export async function runSend(flags) {
+    if (!flags.to || !flags.body) {
+        console.error('Usage: npx aimeat connect send --to GAII --body "message"');
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const client = await AimeatClient.fromConfig();
+        const config = loadConfig();
+        const resp = await client.post(`/v1/agents/${encodeURIComponent(config.agent)}/messages`, {
+            to: flags.to,
+            body: flags.body,
+        });
+        if (!resp.ok) {
+            console.error('Failed to send:', resp.error);
+            process.exitCode = 1;
+            return;
+        }
+        console.log('Message sent.');
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/src/cli/connect/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../../src/cli/connect/send.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAA6B;IACzD,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC3E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,EAAG,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE;YACxF,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/cli/connect/skill-bundle.d.ts

@@ -0,0 +1,3 @@
+import type { AimeatClient } from './api-client.js';
+export declare function downloadSkillBundle(client: AimeatClient, agentName: string): Promise<void>;
+//# sourceMappingURL=skill-bundle.d.ts.map

package/dist/src/cli/connect/skill-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/skill-bundle.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhG"}

package/dist/src/cli/connect/skill-bundle.js

@@ -0,0 +1,28 @@
+/**
+ * @file skill-bundle.ts
+ * @description Download and cache the agent's skill bundle ZIP.
+ * @structure Fetches the authenticated skill bundle archive and stores the ZIP plus a local SKILL.md pointer.
+ * @usage Called after `aimeat connect` auth and by `aimeat connect refresh`.
+ * @version-history v1.9.4 — 2026-05-28 — Close one-shot CLI HTTP connections after bundle downloads.
+ */
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir } from './config.js';
+export async function downloadSkillBundle(client, agentName) {
+    const bundleDir = join(getConfigDir(), agentName);
+    if (!existsSync(bundleDir))
+        mkdirSync(bundleDir, { recursive: true });
+    const url = `${client.getBaseUrl()}/v1/agents/${encodeURIComponent(agentName)}/skill-bundle`;
+    const token = client.getTokenValue();
+    const headers = { Connection: 'close' };
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
+    const res = await fetch(url, { headers });
+    if (!res.ok)
+        throw new Error(`Skill bundle download failed: ${res.status}`);
+    const buffer = Buffer.from(await res.arrayBuffer());
+    const zipPath = join(bundleDir, 'skill-bundle.zip');
+    writeFileSync(zipPath, buffer);
+    writeFileSync(join(bundleDir, 'SKILL.md'), `# Skill Bundle\n\nDownloaded from ${client.getBaseUrl()}\nExtract skill-bundle.zip for full reference.\n`);
+}
+//# sourceMappingURL=skill-bundle.js.map

package/dist/src/cli/connect/skill-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle.js","sourceRoot":"","sources":["../../../../src/cli/connect/skill-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAoB,EAAE,SAAiB;IAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,cAAc,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC;IAC7F,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,MAAM,OAAO,GAA2B,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAChE,IAAI,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IAExD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACpD,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EACvC,qCAAqC,MAAM,CAAC,UAAU,EAAE,kDAAkD,CAAC,CAAC;AAChH,CAAC"}

package/dist/src/cli/connect/status.d.ts

@@ -0,0 +1,2 @@
+export declare function runStatus(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/cli/connect/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/status.ts"],"names":[],"mappings":"AAUA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB/C"}

package/dist/src/cli/connect/status.js

@@ -0,0 +1,33 @@
+/**
+ * @file status.ts
+ * @description CLI subcommand: show agent status
+ * @structure Loads connector config, verifies the stored token, and prints the current agent identity.
+ * @usage Called by `aimeat connect status` and `aimeat connect whoami`.
+ * @version-history v1.9.4 — 2026-05-28 — Update connector guidance and use the name-based inbox endpoint.
+ */
+import { AimeatClient } from './api-client.js';
+import { loadConfig } from './config.js';
+export async function runStatus() {
+    const config = loadConfig();
+    if (!config) {
+        console.log('Not configured. Run: npx aimeat connect');
+        return;
+    }
+    console.log(`Agent: ${config.agent}`);
+    console.log(`Owner: ${config.owner}`);
+    console.log(`Node:  ${config.node_url}`);
+    try {
+        const client = await AimeatClient.fromConfig();
+        const resp = await client.get('/v1/wallet');
+        if (resp.ok) {
+            const wallet = resp.data;
+            console.log(`Balance: ${wallet.balance ?? 'unknown'} morsels`);
+        }
+        const me = await client.get(`/v1/agents/${encodeURIComponent(config.agent)}/inbox`);
+        console.log(`Status: ${me.ok ? 'Connected' : 'Token invalid'}`);
+    }
+    catch {
+        console.log('Status: Not connected');
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/src/cli/connect/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/cli/connect/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,IAA4B,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,IAAI,SAAS,UAAU,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAAC,CAAC;AACnD,CAAC"}

package/dist/src/cli/connect/tasks.d.ts

@@ -0,0 +1,2 @@
+export declare function runTasks(): Promise<void>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/src/cli/connect/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tasks.ts"],"names":[],"mappings":"AAUA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB9C"}

package/dist/src/cli/connect/tasks.js

@@ -0,0 +1,32 @@
+/**
+ * @file tasks.ts
+ * @description CLI subcommand: list assigned tasks
+ * @structure Loads connector credentials, fetches agent tasks, and prints them as JSON.
+ * @usage Called by `aimeat connect tasks`.
+ * @version-history v1.9.4 — 2026-05-28 — Handle missing config and request failures without stack traces.
+ */
+import { AimeatClient } from './api-client.js';
+import { loadConfig } from './config.js';
+export async function runTasks() {
+    try {
+        const client = await AimeatClient.fromConfig();
+        const config = loadConfig();
+        const resp = await client.get(`/v1/agents/${encodeURIComponent(config.agent)}/tasks`);
+        if (!resp.ok) {
+            console.error('Failed to fetch tasks:', resp.error);
+            process.exitCode = 1;
+            return;
+        }
+        const tasks = resp.data?.tasks ?? [];
+        if (tasks.length === 0) {
+            console.log('No tasks.');
+            return;
+        }
+        console.log(JSON.stringify(tasks, null, 2));
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/src/cli/connect/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/cli/connect/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,EAAG,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAI,IAAI,CAAC,IAA8B,EAAE,KAAK,IAAI,EAAE,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/index.js

@@ -1,4 +1,11 @@
 #!/usr/bin/env node
+/**
+ * @file index.ts
+ * @description Main AIMEAT CLI entry point, including node management commands and agent connector dispatch.
+ * @structure Parses top-level CLI flags, routes subcommands, starts the server, and delegates connector commands.
+ * @usage Executed through the published `aimeat` binary.
+ * @version-history v1.9.4 — 2026-05-28 — Allow agent connector flags and drain async auth handles before exit.
+ */
 import { parseArgs } from 'node:util';
 import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -29,6 +36,11 @@ const { values, positionals } = parseArgs({
         format: { type: 'string' },
         file: { type: 'string' },
         from: { type: 'string' },
+        url: { type: 'string' },
+        owner: { type: 'string' },
+        agent: { type: 'string' },
+        to: { type: 'string' },
+        body: { type: 'string' },
         help: { type: 'boolean', short: 'h' },
         version: { type: 'boolean', short: 'v' },
     },
@@ -50,6 +62,15 @@ USAGE
   aimeat maintenance on [MSG]    Enable maintenance mode (optional message)
   aimeat maintenance off         Disable maintenance mode
   aimeat maintenance             Show maintenance status
+  aimeat connect [opts]          Connect an AI agent (device auth flow)
+  aimeat connect serve           Start MCP server for connected agent
+  aimeat connect status          Show agent connection status
+  aimeat connect inbox           Check message inbox
+  aimeat connect tasks           List assigned tasks
+  aimeat connect send [opts]     Send a message (--to GAII --body "text")
+  aimeat connect docs [module]   View agent handbook / module docs
+  aimeat connect refresh         Re-download skill bundle
+  aimeat connect logout          Remove stored credentials
   aimeat seed                    Seed example packages (digital signage, etc.)
   aimeat backup  [FILE]          Export all data to JSON
   aimeat restore <FILE>          Import data from JSON backup
@@ -352,6 +373,97 @@ else if (subcommand === 'restore') {
         }
     });
 }
+else if (subcommand === 'connect') {
+    const connectAction = positionals[1];
+    let shouldExitAfterConnect = true;
+    let connectExitDelayMs = 0;
+    // Parse --url, --owner, --agent, --to, --body from raw argv
+    const rawArgs = process.argv.slice(2);
+    const connectFlags = {};
+    for (let i = 0; i < rawArgs.length; i++) {
+        if (rawArgs[i].startsWith('--') && rawArgs[i + 1] && !rawArgs[i + 1].startsWith('--')) {
+            connectFlags[rawArgs[i].slice(2)] = rawArgs[++i];
+        }
+    }
+    if (connectAction === 'serve') {
+        const { runServe } = await import('./cli/connect/mcp/server.js');
+        await runServe(connectFlags);
+        shouldExitAfterConnect = false;
+    }
+    else if (connectAction === 'inbox') {
+        const { runInbox } = await import('./cli/connect/inbox.js');
+        await runInbox();
+    }
+    else if (connectAction === 'tasks') {
+        const { runTasks } = await import('./cli/connect/tasks.js');
+        await runTasks();
+    }
+    else if (connectAction === 'send') {
+        const { runSend } = await import('./cli/connect/send.js');
+        await runSend(connectFlags);
+    }
+    else if (connectAction === 'status' || connectAction === 'whoami') {
+        const { runStatus } = await import('./cli/connect/status.js');
+        await runStatus();
+    }
+    else if (connectAction === 'docs') {
+        const { runDocs } = await import('./cli/connect/docs.js');
+        await runDocs(positionals[2]);
+    }
+    else if (connectAction === 'refresh') {
+        const { AimeatClient } = await import('./cli/connect/api-client.js');
+        const { downloadSkillBundle } = await import('./cli/connect/skill-bundle.js');
+        const { loadConfig, getConfigDir } = await import('./cli/connect/config.js');
+        const cfg = loadConfig();
+        if (!cfg) {
+            console.error('Not configured. Run: npx aimeat connect');
+            process.exit(1);
+        }
+        try {
+            const cl = await AimeatClient.fromConfig();
+            await downloadSkillBundle(cl, cfg.agent);
+            console.log(`Skill bundle refreshed at ${getConfigDir()}/${cfg.agent}/`);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+    }
+    else if (connectAction === 'logout') {
+        const { deleteToken } = await import('./cli/connect/keychain.js');
+        const { loadConfig } = await import('./cli/connect/config.js');
+        const cfg = loadConfig();
+        if (cfg) {
+            await deleteToken(cfg.agent, cfg.owner);
+            console.log('Credentials removed.');
+        }
+        else
+            console.log('Not configured.');
+    }
+    else if (connectAction === 'config') {
+        const { loadConfig, getConfigDir } = await import('./cli/connect/config.js');
+        const c = loadConfig();
+        if (c)
+            console.log(JSON.stringify(c, null, 2));
+        else
+            console.log(`No config found. Expected at: ${getConfigDir()}/config.yaml`);
+    }
+    else {
+        // Default: run auth
+        const { runAuth } = await import('./cli/connect/auth.js');
+        await runAuth({
+            url: connectFlags.url,
+            owner: connectFlags.owner,
+            agent: connectFlags.agent,
+        });
+        connectExitDelayMs = 250;
+    }
+    if (shouldExitAfterConnect) {
+        if (connectExitDelayMs > 0)
+            await new Promise(resolve => setTimeout(resolve, connectExitDelayMs));
+        process.exit(process.exitCode ?? 0);
+    }
+}
 else if (subcommand === 'seed') {
     const baseUrl = `http://localhost:${config.port}`;
     const adminPw = config.adminPassword ?? '';