aimeat 1.9.4 → 1.10.0

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

@@ -1,13 +1,220 @@
 /**
  * @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.
+ * @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.
+ * @version-history v1.9.14 -- 2026-05-28 -- Pull MCP tool sequence from shared onboarding-prompt.ts (removes hardcoded duplicate).
  */
-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';
+import { HELLO_INTEGRATION_TOOL_SEQUENCE } from './onboarding-prompt.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
+
+There are two ways to drive Hello Integration:
+
+### Option A -- MCP stdio (recommended when supported)
+
+1. Start the connector MCP server and leave it running:
+
+   \`\`\`bash
+   aimeat connect serve
+   \`\`\`
+
+2. Once the MCP server is attached to the connected AI agent/runtime (Claude
+   Desktop, MCP-aware IDEs, OpenClaw with mcp config, etc.), paste this into
+   the 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.
+   \`\`\`
+
+### Option B -- Shell fallback (when MCP stdio cannot attach)
+
+For CLI-only agents or runtimes where \`aimeat connect serve\` would just block
+without exposing tools, every MCP tool is callable directly as a one-shot
+command. Walk through the same sequence with:
+
+\`\`\`bash
+aimeat connect tools                              # list available tool names
+aimeat connect schema <tool-name>                 # inspect a tool's input
+aimeat connect call <tool-name> --json '<input>'  # invoke a tool
+\`\`\`
+
+Start with: \`aimeat connect call aimeat_handbook_get --json '{}'\`
+
+### The Hello Integration sequence
+
+The agent must complete these tools in order. Names are MCP tool names (also
+accepted by \`aimeat connect call <name>\`):
+
+  \`\`\`text
+${HELLO_INTEGRATION_TOOL_SEQUENCE.map(tool => `  ${tool}`).join('\n')}
+  \`\`\`
+
+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))
@@ -23,6 +230,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;;;;;;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"}
+{"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/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"}