aimeat 1.9.3 → 1.9.5

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

@@ -1,17 +1,216 @@
 /**
  * @file skill-bundle.ts
  * @description Download and cache the agent's skill bundle ZIP.
+ * @structure Fetches the authenticated skill bundle archive, stores the ZIP, and extracts its files locally.
+ * @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.
+ * @version-history v1.9.5 — 2026-05-28 — Extract the real SKILL.md and bundle files from the downloaded ZIP.
+ * @version-history v1.9.6 — 2026-05-28 — Print a bundle-provided BUNDLE.md guide after downloads.
+ * @version-history v1.9.7 — 2026-05-28 — Clarify serve-next and Hello Integration MCP sequence.
+ * @version-history v1.9.8 — 2026-05-28 — Include task TODO completion in Hello Integration guidance.
+ * @version-history v1.9.9 — 2026-05-28 — Clarify MCP tool names are not terminal commands.
+ * @version-history v1.9.10 — 2026-05-28 — Include required telemetry reporting in Hello Integration guidance.
+ * @version-history v1.9.11 — 2026-05-28 — State that Hello Integration is required first-run onboarding.
+ * @version-history v1.9.12 -- 2026-05-28 -- Add correct post-onboarding setup guidance for actual commands, config, and knowledge artifacts.
+ * @version-history v1.9.13 -- 2026-05-28 -- Add shared owner-memory tag guidance.
  */
-import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { writeFileSync, mkdirSync, existsSync, readFileSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import yauzl from 'yauzl';
 import { getConfigDir } from './config.js';
+const MAX_EXTRACTED_FILES = 100;
+const MAX_EXTRACTED_BYTES = 20 * 1024 * 1024;
+const MAX_SINGLE_FILE_BYTES = 5 * 1024 * 1024;
+const MANAGED_EXTRACTED_PATHS = ['SKILL.md', 'BUNDLE.md', 'references', 'scripts', 'config'];
+function clearExtractedBundle(bundleDir) {
+    for (const relativePath of MANAGED_EXTRACTED_PATHS) {
+        rmSync(join(bundleDir, relativePath), { recursive: true, force: true });
+    }
+}
+function normalizeBundleEntry(fileName) {
+    const normalized = fileName.replace(/\\/g, '/');
+    if (!normalized || normalized.endsWith('/'))
+        return null;
+    if (normalized.startsWith('/') || normalized.includes('../') || /^[a-zA-Z]:/.test(normalized)) {
+        throw new Error(`Unsafe bundle path: ${fileName}`);
+    }
+    const parts = normalized.split('/').filter(Boolean);
+    if (parts.length === 0 || parts.includes('..'))
+        throw new Error(`Unsafe bundle path: ${fileName}`);
+    if (parts.length > 1 && /^aimeat-[a-z0-9-]+$/i.test(parts[0]))
+        parts.shift();
+    return parts.join('/');
+}
+async function extractSkillBundle(buffer, bundleDir) {
+    return new Promise((resolve, reject) => {
+        yauzl.fromBuffer(buffer, { lazyEntries: true }, (openError, zipfile) => {
+            if (openError) {
+                reject(openError);
+                return;
+            }
+            if (!zipfile) {
+                reject(new Error('Could not open skill bundle ZIP'));
+                return;
+            }
+            let fileCount = 0;
+            let extractedBytes = 0;
+            let skillPath = null;
+            let guidePath = null;
+            const extractedFiles = [];
+            zipfile.on('error', reject);
+            zipfile.on('entry', (entry) => {
+                let relativePath;
+                try {
+                    relativePath = normalizeBundleEntry(entry.fileName);
+                }
+                catch (pathError) {
+                    zipfile.close();
+                    reject(pathError);
+                    return;
+                }
+                if (!relativePath) {
+                    zipfile.readEntry();
+                    return;
+                }
+                fileCount += 1;
+                if (fileCount > MAX_EXTRACTED_FILES) {
+                    zipfile.close();
+                    reject(new Error(`Skill bundle contains more than ${MAX_EXTRACTED_FILES} files`));
+                    return;
+                }
+                if (entry.uncompressedSize > MAX_SINGLE_FILE_BYTES) {
+                    zipfile.close();
+                    reject(new Error(`Skill bundle file is too large: ${entry.fileName}`));
+                    return;
+                }
+                zipfile.openReadStream(entry, (streamError, stream) => {
+                    if (streamError) {
+                        zipfile.close();
+                        reject(streamError);
+                        return;
+                    }
+                    if (!stream) {
+                        zipfile.close();
+                        reject(new Error(`Could not read bundle file: ${entry.fileName}`));
+                        return;
+                    }
+                    const chunks = [];
+                    stream.on('data', (chunk) => {
+                        extractedBytes += chunk.length;
+                        if (extractedBytes > MAX_EXTRACTED_BYTES) {
+                            zipfile.close();
+                            reject(new Error('Skill bundle extracted size limit exceeded'));
+                            return;
+                        }
+                        chunks.push(chunk);
+                    });
+                    stream.on('end', () => {
+                        const outputPath = join(bundleDir, relativePath);
+                        mkdirSync(dirname(outputPath), { recursive: true });
+                        writeFileSync(outputPath, Buffer.concat(chunks));
+                        extractedFiles.push(relativePath);
+                        if (relativePath === 'SKILL.md')
+                            skillPath = outputPath;
+                        if (relativePath === 'BUNDLE.md')
+                            guidePath = outputPath;
+                        zipfile.readEntry();
+                    });
+                    stream.on('error', (streamReadError) => { zipfile.close(); reject(streamReadError); });
+                });
+            });
+            zipfile.on('end', () => {
+                if (!skillPath) {
+                    reject(new Error('Skill bundle ZIP did not contain SKILL.md'));
+                    return;
+                }
+                resolve({ skillPath, guidePath, extractedFiles });
+            });
+            zipfile.readEntry();
+        });
+    });
+}
+function renderCompatibilityBundleGuide(client, agentName, extractedFiles) {
+    const hasReferences = extractedFiles.some(file => file.startsWith('references/'));
+    const hasScripts = extractedFiles.some(file => file.startsWith('scripts/'));
+    const hasConfig = extractedFiles.some(file => file.startsWith('config/'));
+    const sections = [
+        '- `BUNDLE.md` - this guide. Newer nodes include it in the ZIP; this connector generated it for an older bundle.',
+        '- `SKILL.md` - the main instruction file for the connected agent/runtime. Read this first.',
+    ];
+    if (hasReferences)
+        sections.push('- `references/` - deeper protocol notes: API overview, task lifecycle, messages, telemetry, capabilities, and errors.');
+    if (hasScripts)
+        sections.push('- `scripts/` - runtime helper scripts for platforms that support them.');
+    if (hasConfig)
+        sections.push('- `config/` - runtime configuration snippets, hooks, or routes for platforms that support local config files.');
+    return `# AIMEAT Skill Bundle
+
+## What This Is
+
+This folder contains the local AIMEAT skill bundle for agent \`${agentName}\` from ${client.getBaseUrl()}. If you are the connected AI agent using this runtime, \`${agentName}\` is your assigned AIMEAT agent name.
+
+When downloaded with the connector, the original ZIP is kept as \`skill-bundle.zip\` and the useful files are extracted into the same directory.
+
+## Files
+
+${sections.join('\n')}
+
+## What To Do Next
+
+1. Start the connector MCP server as the next terminal command and leave it running:
+
+   \`\`\`bash
+   npx aimeat connect serve
+   \`\`\`
+
+2. After that MCP server is attached to the connected AI agent/runtime, ask the agent to use its AIMEAT tools. Hello Integration is AIMEAT's required first-run onboarding handshake for every newly connected agent:
+
+   \`\`\`text
+  Use your AIMEAT tools. Hello Integration is required AIMEAT first-run onboarding. Read the AIMEAT handbook, check onboarding status, propose TODOs for the onboarding verification task, complete Hello Integration, then publish your actual supported commands, runtime configuration, and any produced knowledge package artifacts before normal autonomous work.
+   \`\`\`
+
+3. The agent must complete Hello Integration with these MCP tools. These names appear inside the AI runtime after MCP is attached; they are not terminal commands:
+
+  \`\`\`text
+  aimeat_handbook_get
+  aimeat_onboarding_status
+  aimeat_onboarding_identify_platform
+  aimeat_onboarding_confirm_skill_installed
+  aimeat_agent_capabilities_report
+  aimeat_onboarding_confirm_directives_read
+  aimeat_message_send
+  aimeat_agent_telemetry_report
+  aimeat_task_list
+  aimeat_task_propose_todos
+  aimeat_onboarding_status
+  aimeat_task_event
+  aimeat_task_todo
+  aimeat_task_complete
+  aimeat_onboarding_status
+  \`\`\`
+
+Use \`generic\` as the installed skill platform unless your runtime has a more specific platform name. For the bundle version field, use \`local\` when no version is shown by the runtime.
+
+4. After Hello Integration completes, publish real post-onboarding setup:
+
+  - Commands: write \`agents.${agentName}.commands\` with the full owner-facing slash command catalogue this agent can actually handle. Use a flat array of \`{ name, description, category }\`. Do not copy examples or list internal MCP tools as message commands.
+  - Config: write actual runtime/config artifacts under \`agents.config.*\`. If this setup only uses \`aimeat connect serve\`, describe that connector accurately; do not invent a watchdog file.
+  - Shared memory: if the owner assigned shared tags in Data Access/directives, use \`agents.tag.<tag>.*\` with visibility \`owner\` and tags \`["<tag>"]\` for same-owner handoff notes, project state, queues, and team context. List shared areas with \`owner_scope=true\` plus prefix \`agents.tag.<tag>.\`.
+  - Knowledge: when you produce research, docs, datasets, or reusable knowledge, create or update a real knowledge package with \`POST /v1/knowledge/import\` from \`/llms.txt\`, \`aimeat_knowledge_contribute\`, and \`aimeat_storage_upload\` as appropriate. Do not use a placeholder \`research.*\` memory key as a substitute.
+
+5. Run \`npx aimeat connect refresh\` later to download updated bundle content.
+`;
+}
+export function readSkillBundleGuide(bundle) {
+    return readFileSync(bundle.guidePath, 'utf-8').trim();
+}
 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 = {};
+    const headers = { Connection: 'close' };
     if (token)
         headers['Authorization'] = `Bearer ${token}`;
     const res = await fetch(url, { headers });
@@ -20,6 +219,14 @@ export async function downloadSkillBundle(client, agentName) {
     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`);
+    clearExtractedBundle(bundleDir);
+    const extracted = await extractSkillBundle(buffer, bundleDir);
+    let guidePath = extracted.guidePath;
+    if (!guidePath) {
+        guidePath = join(bundleDir, 'BUNDLE.md');
+        writeFileSync(guidePath, renderCompatibilityBundleGuide(client, agentName, extracted.extractedFiles), 'utf-8');
+        extracted.extractedFiles.unshift('BUNDLE.md');
+    }
+    return { bundleDir, zipPath, skillPath: extracted.skillPath, guidePath, extractedFiles: extracted.extractedFiles };
 }
 //# sourceMappingURL=skill-bundle.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"skill-bundle.js","sourceRoot":"","sources":["../../../../src/cli/connect/skill-bundle.ts"],"names":[],"mappings":"AAAA;;;GAGG;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,CAAC;IAC3C,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"}
+{"version":3,"file":"skill-bundle.js","sourceRoot":"","sources":["../../../../src/cli/connect/skill-bundle.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/status.ts"],"names":[],"mappings":"AAOA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB/C"}
+{"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

@@ -1,13 +1,16 @@
 /**
  * @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');
+        console.log('Not configured. Run: npx aimeat connect');
         return;
     }
     console.log(`Agent: ${config.agent}`);
@@ -20,7 +23,7 @@ export async function runStatus() {
             const wallet = resp.data;
             console.log(`Balance: ${wallet.balance ?? 'unknown'} morsels`);
         }
-        const me = await client.get('/v1/agents/me/inbox');
+        const me = await client.get(`/v1/agents/${encodeURIComponent(config.agent)}/inbox`);
         console.log(`Status: ${me.ok ? 'Connected' : 'Token invalid'}`);
     }
     catch {

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

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/cli/connect/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;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,0CAA0C,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACjF,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,qBAAqB,CAAC,CAAC;QACnD,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"}
+{"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.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tasks.ts"],"names":[],"mappings":"AAOA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9C"}
+{"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

@@ -1,22 +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() {
-    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);
-        return;
+    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));
     }
-    const tasks = resp.data?.tasks ?? [];
-    if (tasks.length === 0) {
-        console.log('No tasks.');
-        return;
+    catch (e) {
+        console.error(e.message);
+        process.exitCode = 1;
     }
-    console.log(JSON.stringify(tasks, null, 2));
 }
 //# sourceMappingURL=tasks.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/cli/connect/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,EAAG,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC9E,MAAM,KAAK,GAAI,IAAI,CAAC,IAA8B,EAAE,KAAK,IAAI,EAAE,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}
+{"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/cli/connect/tool-call.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @file tool-call.ts
+ * @description Shell fallback for connector tools. Provides `aimeat connect tools`,
+ *   `aimeat connect schema`, and `aimeat connect call` for runtimes that can run
+ *   commands but cannot use MCP directly.
+ * @structure
+ *   - CONNECT_CLI_TOOLS -- initial REST-backed tool catalog for Hello Integration
+ *   - runToolList() -- prints CLI-callable tool names
+ *   - runToolSchema() -- prints plain JSON input schema metadata
+ *   - runToolCall() -- loads JSON input and invokes the matching REST-backed handler
+ * @usage
+ *   aimeat connect tools
+ *   aimeat connect schema aimeat_onboarding_status
+ *   aimeat connect call aimeat_message_send --json input.json
+ * @version-history
+ *   v1.0.0 -- 2026-05-28 -- Add initial shell fallback for agent lifecycle tools
+ *   v1.1.0 -- 2026-05-28 -- Read public tool metadata from the shared MCP catalog
+ *   v1.2.0 -- 2026-05-28 -- Add app, extension, and cortex CLI fallback handlers
+ *   v1.3.0 -- 2026-05-28 -- Add core memory, work, wallet, board, storage, and admin handlers
+ *   v1.4.0 -- 2026-05-28 -- Add remaining connector MCP handlers to CLI fallback
+ *   v1.5.0 -- 2026-05-28 -- Add memory tags and owner-scope listing support
+ */
+import { type ToolInputField } from '../../mcp/catalog/definitions.js';
+import type { AimeatClient, ApiResponse } from './api-client.js';
+import { type AimeatConnectConfig } from './config.js';
+type JsonObject = Record<string, unknown>;
+interface ConnectCliToolDefinition {
+    name: string;
+    description?: string;
+    input?: Record<string, ToolInputField>;
+    handler: (ctx: ToolCallContext, input: JsonObject) => Promise<ApiResponse>;
+}
+interface ToolCallContext {
+    client: AimeatClient;
+    config: AimeatConnectConfig;
+    agentPath: string;
+}
+export declare const CONNECT_CLI_TOOLS: ConnectCliToolDefinition[];
+export declare function runToolList(flags: Record<string, string>): void;
+export declare function runToolSchema(toolName: string | undefined): void;
+export declare function runToolCall(toolName: string | undefined, flags: Record<string, string>): Promise<void>;
+export {};
+//# sourceMappingURL=tool-call.d.ts.map

package/dist/src/cli/connect/tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,wBAAwB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,UAAU,eAAe;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACrB;AA+FD,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EA+oBvD,CAAC;AAyDF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAahE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5G"}