@kvell007/embed-labs-cli 0.1.0-alpha.16 → 0.1.0-alpha.18

package/README.md

@@ -81,6 +81,18 @@ embedlabs doctor
 embedlabs auth login --token <token>
 ```
 
+If a cloud or plugin command reaches a protected API before a token is
+configured, the CLI returns `auth_token_missing` with the registration URL and
+these setup options:
+
+```bash
+open https://api.embedboard.com/dashboard
+embedlabs auth login --token <your_token>
+# or for automation:
+export EMBED_API_TOKEN=<your_token>
+embedlabs auth status
+```
+
 For the current public API plus local TaishanPi verification path, see
 `docs/runbooks/PUBLIC_CLI_USER_VERIFICATION.md`.
 

package/dist/index.js

@@ -18,6 +18,7 @@ const qrcodeTerminal = require("qrcode-terminal");
 const DEFAULT_BRIDGE_URL = process.env.EMBED_BRIDGE_URL ?? "http://127.0.0.1:18083";
 const DEFAULT_CLOUD_API_URL = process.env.EMBED_CLOUD_API_URL ?? "http://127.0.0.1:18100";
 const DEFAULT_AUTH_FILE = process.env.EMBED_AUTH_FILE ?? ".embed-labs/auth.json";
+const DEFAULT_DASHBOARD_URL = process.env.EMBED_DASHBOARD_URL ?? "https://api.embedboard.com/dashboard";
 const DEFAULT_AGENT_ARTIFACT_DIR = process.env.EMBED_AGENT_ARTIFACT_DIR ?? ".embed-labs/artifacts";
 const DOCTOR_USAGE = "Usage: embed doctor [--json]";
 const DOCTOR_HTTP_TIMEOUT_MS = 8000;
@@ -27,6 +28,8 @@ const DEVICE_PROBE_USAGE = "Usage: embed device probe --host <host> --ports 22,1
 const QUERY_USAGE = "Usage: embed query <natural language request> [--account <account_id>] [--qr] [--json]";
 const DEFAULT_PLUGIN_RELEASE_URL = process.env.EMBED_PLUGIN_RELEASE_URL?.trim() || "https://api.embedboard.com/plugin-releases/agent-plugins/latest";
 const PLUGIN_LIST_USAGE = "Usage: embed plugin list [--release-dir <dir>] [--release-url <url>] [--json]";
+const CODEX_PLUGIN_NAME = "embed-labs";
+const CODEX_MARKETPLACE_NAME = "embed-labs-plugins";
 const PLUGIN_INSTALL_USAGE = "Usage: embed plugin install <codex|opencode|all> [--release-dir <dir>] [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--force] [--json]";
 const CLOUD_TASK_ARTIFACTS_USAGE = "Usage: embed cloud task artifacts <task_id> [--json]";
 const CLOUD_TASK_EVIDENCE_USAGE = "Usage: embed cloud task evidence <task_id> [--json]";
@@ -1200,7 +1203,8 @@ function authDoctorCheck(status) {
             : {
                 code: "auth_not_ready",
                 message: "No CLI auth token is configured.",
-                remediation: "Run: embed auth login --token <token>"
+                remediation: cloudAuthSetupRemediation(),
+                details: cloudAuthSetupDetails()
             }
     };
 }
@@ -1411,7 +1415,7 @@ async function cloudDownloadArtifact(artifactId, outputPath) {
         });
         if (!response.ok) {
             const parsed = await parseErrorResponse(response);
-            return parsed ?? fail("artifact_download_failed", `Artifact download failed with HTTP ${response.status}.`);
+            return parsed ? enrichCloudAuthFailure(parsed, Boolean(token)) : fail("artifact_download_failed", `Artifact download failed with HTTP ${response.status}.`);
         }
         const bytes = Buffer.from(await response.arrayBuffer());
         const expectedSha256 = response.headers.get("x-embed-artifact-sha256")?.trim();
@@ -1454,7 +1458,8 @@ async function cloudRequest(method, path, body) {
             headers: Object.keys(headers).length > 0 ? headers : undefined,
             body: body === undefined ? undefined : bodyText
         });
-        return await response.json();
+        const parsed = await response.json();
+        return enrichCloudAuthFailure(parsed, Boolean(token));
     }
     catch (error) {
         return fail("cloud_api_unreachable", error instanceof Error ? error.message : String(error), {
@@ -1462,6 +1467,39 @@ async function cloudRequest(method, path, body) {
         });
     }
 }
+function enrichCloudAuthFailure(response, hadToken) {
+    if (response.ok || response.error.code !== "unauthorized") {
+        return response;
+    }
+    if (!hadToken) {
+        return fail("auth_token_missing", "Embed Labs API Token is not configured. Register or sign in, create an API Token, then configure it locally before using cloud and plugin services.", {
+            remediation: cloudAuthSetupRemediation(),
+            details: cloudAuthSetupDetails()
+        });
+    }
+    return fail("auth_token_rejected", "The configured Embed Labs API Token was rejected by the server. Recreate or copy a fresh token from the dashboard and sign in again.", {
+        remediation: cloudAuthSetupRemediation(),
+        details: cloudAuthSetupDetails()
+    });
+}
+function cloudAuthSetupRemediation() {
+    return [
+        `1. Open ${DEFAULT_DASHBOARD_URL} and register or sign in.`,
+        "2. Create or copy your Embed Labs API Token from the user dashboard.",
+        "3. Run: embedlabs auth login --token <your_token>",
+        "4. For automation, set: EMBED_API_TOKEN=<your_token>",
+        "5. Verify with: embedlabs auth status"
+    ].join("\n");
+}
+function cloudAuthSetupDetails() {
+    return {
+        dashboard_url: DEFAULT_DASHBOARD_URL,
+        login_command: "embedlabs auth login --token <your_token>",
+        env_var: "EMBED_API_TOKEN",
+        auth_status_command: "embedlabs auth status",
+        auth_file: DEFAULT_AUTH_FILE
+    };
+}
 function addCloudRequestSignature(headers, method, pathWithQuery, bodyText, token) {
     if (process.env.EMBED_CLOUD_API_SIGNING === "0") {
         return;
@@ -1600,7 +1638,7 @@ async function installCodexPlugin(parsed, context) {
         return source;
     }
     const targetRoot = codexPluginTargetRoot(parsed, context.installingAll);
-    const targetPath = join(targetRoot, "embed-labs");
+    const targetPath = join(targetRoot, CODEX_PLUGIN_NAME);
     const legacyCleanup = await cleanupLegacyCodexPluginRemnants(targetRoot);
     if (await pathExists(targetPath) && !booleanFlag(parsed, "force")) {
         return fail("plugin_already_installed", `Codex plugin already exists at ${targetPath}.`, {
@@ -1611,17 +1649,23 @@ async function installCodexPlugin(parsed, context) {
     await mkdir(targetRoot, { recursive: true });
     await cp(source.data.sourcePath, targetPath, { recursive: true });
     const mcpRegistration = await maybeRegisterCodexMcp(parsed, targetRoot, targetPath);
+    const marketplaceRegistration = await maybeRegisterCodexMarketplace(parsed, targetRoot, targetPath);
     return ok({
         id: "codex",
         target_path: targetPath,
         source: source.data.sourceLabel,
         version: source.data.version,
         command_hint: mcpRegistration.registered
-            ? "Codex MCP was registered. Start a new Codex session to reload tools."
+            ? (marketplaceRegistration.registered
+                ? "Codex MCP and plugin marketplace entry were registered. Fully restart Codex to reload @Embed Labs."
+                : "Codex MCP was registered. Start a new Codex session to reload tools.")
             : mcpRegistration.hint,
         warning: legacyCodexCleanupWarning(legacyCleanup),
         mcp_registered: mcpRegistration.registered,
         mcp_warning: mcpRegistration.warning,
+        marketplace_registered: marketplaceRegistration.registered,
+        marketplace_path: marketplaceRegistration.marketplacePath,
+        marketplace_warning: marketplaceRegistration.warning,
         cleanup: legacyCleanup
     });
 }
@@ -1914,7 +1958,8 @@ async function cleanupLegacyCodexPluginRemnants(targetRoot) {
     ];
     legacyPaths.push(...await discoverLegacyCodexCachePaths(targetRoot));
     if (resolve(targetRoot) === resolve(defaultCodexPluginRoot())) {
-        legacyPaths.push(join(defaultCodexHome(), ".tmp", "plugins"), join(defaultCodexHome(), ".tmp", "plugins.sha"), join(defaultCodexHome(), "skills", "dbt-agent"), join(defaultCodexHome(), "skills", "development-board-toolchain-dev"), join(defaultCodexHome(), "memories", "skills", "dbt-agent-live-board-ops"), join(defaultCodexHome(), "memories", "skills", "dbt-agent-platform-plugin-maintenance"));
+        legacyPaths.push(join(defaultCodexHome(), ".tmp", "plugins"), join(defaultCodexHome(), ".tmp", "plugins.sha"), join(defaultCodexHome(), "ambient-suggestions"), join(defaultCodexHome(), "skills", "dbt-agent"), join(defaultCodexHome(), "skills", "development-board-toolchain-dev"), join(defaultCodexHome(), "memories", "skills", "dbt-agent-live-board-ops"), join(defaultCodexHome(), "memories", "skills", "dbt-agent-platform-plugin-maintenance"));
+        legacyPaths.push(...await discoverLegacyHomeAgentsMarketplacePaths(warnings), ...legacyDevelopmentBoardRuntimePluginPaths());
     }
     for (const candidate of legacyPaths) {
         try {
@@ -1986,7 +2031,56 @@ async function stopLegacyCodexPluginProcesses(warnings) {
 function isLegacyCodexPluginProcess(command) {
     const trimmed = command.trim();
     return /^\/.*\/dbt-agent-mcp-bridge(?:\s|$)/.test(trimmed)
-        || /^dbt-agent-mcp-bridge(?:\s|$)/.test(trimmed);
+        || /^dbt-agent-mcp-bridge(?:\s|$)/.test(trimmed)
+        || legacyDevelopmentBoardRuntimeProcessPatterns().some((pattern) => pattern.test(trimmed));
+}
+function legacyDevelopmentBoardRuntimeProcessPatterns() {
+    const home = escapeRegExp(homedir());
+    return [
+        new RegExp(`^${home}/Library/development-board-toolchain/agent/bin/dbt-agentd(?:\\s|$)`),
+        new RegExp(`^${home}/Library/Application Support/development-board-toolchain/agent/bin/dbt-agentd(?:\\s|$)`),
+        new RegExp(`^${home}/Library/development-board-toolchain/runtime/dbtctl\\s+status(?:\\s|$)`),
+        new RegExp(`^${home}/Library/Application Support/development-board-toolchain/runtime/dbtctl\\s+status(?:\\s|$)`),
+        new RegExp(`^${home}/.*?/DBT-Agent\\.app/Contents/MacOS/DBT-Agent(?:\\s|$)`)
+    ];
+}
+function legacyDevelopmentBoardRuntimePluginPaths() {
+    return [
+        join(homedir(), "Library", "development-board-toolchain", "runtime", "editor_plugins"),
+        join(homedir(), "Library", "development-board-toolchain", "runtime", "opencode_plugin"),
+        join(homedir(), "Library", "Application Support", "development-board-toolchain", "runtime", "editor_plugins"),
+        join(homedir(), "Library", "Application Support", "development-board-toolchain", "runtime", "opencode_plugin")
+    ];
+}
+async function discoverLegacyHomeAgentsMarketplacePaths(warnings) {
+    const paths = [];
+    const pluginRoot = join(homedir(), ".agents", "plugins");
+    try {
+        const entries = await readdir(pluginRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.startsWith("marketplace.json"))
+                continue;
+            const filePath = join(pluginRoot, entry.name);
+            try {
+                const current = await readFile(filePath, "utf8");
+                if (isLegacyHomeAgentsMarketplace(current)) {
+                    paths.push(filePath);
+                }
+            }
+            catch (error) {
+                warnings.push(`Could not inspect legacy Codex home marketplace ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    catch {
+        return paths;
+    }
+    return paths;
+}
+function isLegacyHomeAgentsMarketplace(text) {
+    return text.includes('"name" : "plugins"') || text.includes('"name": "plugins"')
+        ? text.includes('"dbt-agent"') || text.includes('"./.codex/plugins/dbt-agent"') || text.includes('"./plugins/dbt-agent"')
+        : false;
 }
 async function discoverLegacyCodexCachePaths(targetRoot) {
     const paths = [];
@@ -2074,7 +2168,8 @@ function isLegacyCodexConfigTable(table) {
         || table === "mcp_servers.dbt-agent"
         || table.startsWith("mcp_servers.dbt-agent.")
         || table === 'mcp_servers."dbt-agent"'
-        || table.startsWith('mcp_servers."dbt-agent".');
+        || table.startsWith('mcp_servers."dbt-agent".')
+        || /^projects\."[^"]*\/DBT-Agent-Project(?:\/[^"]*)?"$/.test(table);
 }
 function legacyCodexCleanupWarning(cleanup) {
     const parts = [];
@@ -2224,6 +2319,101 @@ async function maybeRegisterCodexMcp(parsed, targetRoot, targetPath) {
     const warning = await upsertCodexMcpRuntimeConfig(bridgePath);
     return warning ? { registered: true, warning } : { registered: true };
 }
+async function maybeRegisterCodexMarketplace(parsed, targetRoot, targetPath) {
+    const explicitTarget = Boolean(stringFlag(parsed, "target") || stringFlag(parsed, "codex-target"));
+    if (explicitTarget && process.env.EMBED_CODEX_MARKETPLACE_REGISTER !== "1") {
+        return {
+            registered: false,
+            warning: "Codex plugin marketplace entry was not registered because a custom target was used. Set EMBED_CODEX_MARKETPLACE_REGISTER=1 to register it anyway."
+        };
+    }
+    if (resolve(targetRoot) !== resolve(defaultCodexPluginRoot()) && process.env.EMBED_CODEX_MARKETPLACE_REGISTER !== "1") {
+        return {
+            registered: false,
+            warning: "Codex plugin marketplace entry was not registered because the install target is not the default Codex plugin root."
+        };
+    }
+    const marketplacePath = defaultCodexLocalMarketplaceRoot();
+    const marketplacePluginPath = join(marketplacePath, "plugins", CODEX_PLUGIN_NAME);
+    try {
+        if (!await pathExists(join(targetPath, ".codex-plugin", "plugin.json"))) {
+            return {
+                registered: false,
+                warning: `Codex plugin manifest was not found at ${join(targetPath, ".codex-plugin", "plugin.json")}.`
+            };
+        }
+        await rm(marketplacePluginPath, { recursive: true, force: true });
+        await mkdir(dirname(marketplacePluginPath), { recursive: true });
+        await cp(targetPath, marketplacePluginPath, { recursive: true });
+        await writeCodexLocalMarketplaceManifest(marketplacePath);
+        const warning = await upsertCodexPluginMarketplaceConfig(marketplacePath);
+        return warning ? { registered: true, marketplacePath, warning } : { registered: true, marketplacePath };
+    }
+    catch (error) {
+        return {
+            registered: false,
+            marketplacePath,
+            warning: `Could not register Codex plugin marketplace entry: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+function defaultCodexLocalMarketplaceRoot() {
+    return join(defaultCodexHome(), "local-marketplaces", CODEX_PLUGIN_NAME);
+}
+async function writeCodexLocalMarketplaceManifest(marketplacePath) {
+    const manifestPath = join(marketplacePath, ".agents", "plugins", "marketplace.json");
+    const manifest = {
+        name: CODEX_MARKETPLACE_NAME,
+        interface: {
+            displayName: "Embed Labs"
+        },
+        plugins: [
+            {
+                name: CODEX_PLUGIN_NAME,
+                source: {
+                    source: "local",
+                    path: `./plugins/${CODEX_PLUGIN_NAME}`
+                },
+                policy: {
+                    installation: "AVAILABLE",
+                    authentication: "ON_USE"
+                },
+                category: "Developer Tools"
+            }
+        ]
+    };
+    await mkdir(dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+async function upsertCodexPluginMarketplaceConfig(marketplacePath) {
+    const configPath = codexConfigPath();
+    try {
+        await mkdir(dirname(configPath), { recursive: true });
+        let text = "";
+        try {
+            text = await readFile(configPath, "utf8");
+        }
+        catch {
+            text = "";
+        }
+        text = removeLegacyCodexConfigTables(text).text;
+        let updated = upsertTomlTableKeys(text, `marketplaces.${CODEX_MARKETPLACE_NAME}`, {
+            source_type: tomlString("local"),
+            source: tomlString(marketplacePath),
+            last_updated: tomlString(new Date().toISOString().replace(/\.\d{3}Z$/, "Z"))
+        });
+        updated = upsertTomlTableKeys(updated, `plugins."${CODEX_PLUGIN_NAME}@${CODEX_MARKETPLACE_NAME}"`, {
+            enabled: "true"
+        });
+        if (updated !== text) {
+            await writeFile(configPath, updated, "utf8");
+        }
+        return undefined;
+    }
+    catch (error) {
+        return `${configPath} could not be updated with the Embed Labs plugin marketplace entry: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
 function codexMcpAlreadyRegistered(stdout, bridgePath, cloudUrl, authFile, embedCliBin) {
     try {
         const parsed = JSON.parse(stdout);
@@ -5136,6 +5326,15 @@ function renderPluginInstall(result) {
         if (item.mcp_warning) {
             lines.push(`    warning=${item.mcp_warning}`);
         }
+        if (item.marketplace_registered !== undefined) {
+            lines.push(`    codex_marketplace_registered=${item.marketplace_registered}`);
+        }
+        if (item.marketplace_path) {
+            lines.push(`    codex_marketplace=${item.marketplace_path}`);
+        }
+        if (item.marketplace_warning) {
+            lines.push(`    warning=${item.marketplace_warning}`);
+        }
     }
     return lines.join("\n");
 }