@intent-systems/nexus 2026.1.5-3 → 2026.1.5-5

package/dist/cli/skills-hub-cli.js

@@ -1,17 +1,17 @@
+import crypto from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 import os from "node:os";
-import crypto from "node:crypto";
+import path from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { fileTypeFromFile } from "file-type";
-import { buildWorkspaceSkillStatus } from "../agents/skills-status.js";
 import { getSkillMetadata, hasBinary, loadWorkspaceSkillEntries, } from "../agents/skills.js";
+import { buildWorkspaceSkillStatus } from "../agents/skills-status.js";
 import { DEFAULT_AGENT_WORKSPACE_DIR } from "../agents/workspace.js";
-import { generateSkillManifest, writeSkillManifest } from "../commands/skills-manifest.js";
+import { generateSkillManifest, writeSkillManifest, } from "../commands/skills-manifest.js";
 import { loadConfig } from "../config/config.js";
-import { runCommandWithTimeout } from "../process/exec.js";
 import { listCredentialEntries, resolveCredentialValue, } from "../credentials/store.js";
+import { runCommandWithTimeout } from "../process/exec.js";
 import { MANAGED_SKILLS_DIR, resolveUserPath } from "../utils.js";
 function getHubBaseUrl() {
     return (process.env.NEXUS_HUB_URL ||
@@ -41,7 +41,9 @@ function normalizeStringList(value) {
     return [];
 }
 function normalizeHubDependencies(value) {
-    const raw = value && typeof value === "object" ? value : {};
+    const raw = value && typeof value === "object"
+        ? value
+        : {};
     return {
         dependencies: normalizeStringList(raw.dependencies),
         tools: normalizeStringList(raw.tools),
@@ -142,16 +144,16 @@ function normalizeMetadata(value) {
     return {};
 }
 function resolveCapabilities(entry) {
+    const metadata = entry.metadata;
+    const metadataNexus = metadata && typeof metadata.nexus === "object"
+        ? metadata.nexus
+        : undefined;
     const candidates = [
         entry.capabilities,
         entry.provides,
-        entry.metadata?.nexus
-            ? entry.metadata.nexus.provides
-            : undefined,
-        entry.metadata?.nexus
-            ? entry.metadata.nexus.capabilities
-            : undefined,
-        entry.metadata?.capabilities,
+        metadataNexus?.provides,
+        metadataNexus?.capabilities,
+        metadata?.capabilities,
     ];
     for (const candidate of candidates) {
         const parsed = normalizeStringList(candidate);
@@ -456,7 +458,7 @@ async function computeArtifactInfo(filePath) {
     return { sha256: hash, bytes: stats.size };
 }
 async function resolveHubToken(input) {
-    if (input && input.trim())
+    if (input?.trim())
         return input.trim();
     const envToken = process.env.NEXUS_HUB_TOKEN ||
         process.env.NEXUS_WEBSITE_TOKEN ||
@@ -483,7 +485,9 @@ function buildManifestPayload(input) {
         (typeof frontmatter.name === "string" ? frontmatter.name : "") ||
         "";
     const description = overrides.description ||
-        (typeof frontmatter.description === "string" ? frontmatter.description : "") ||
+        (typeof frontmatter.description === "string"
+            ? frontmatter.description
+            : "") ||
         "";
     const type = overrides.type ||
         (typeof frontmatter.type === "string" ? frontmatter.type : "") ||
@@ -496,7 +500,9 @@ function buildManifestPayload(input) {
         (typeof frontmatter.license === "string" ? frontmatter.license : "") ||
         "";
     const repository = overrides.repository ||
-        (typeof frontmatter.repository === "string" ? frontmatter.repository : "") ||
+        (typeof frontmatter.repository === "string"
+            ? frontmatter.repository
+            : "") ||
         (typeof frontmatter.repo === "string" ? frontmatter.repo : "") ||
         "";
     const homepage = overrides.homepage ||
@@ -530,11 +536,15 @@ function buildManifestPayload(input) {
     const capabilities = resolveCapabilities(capabilityCandidates);
     if (capabilities.length > 0) {
         manifestEntry.capabilities = capabilities;
-        const nexus = manifestEntry.metadata;
-        nexus.nexus = {
-            ...(nexus.nexus ?? {}),
+        const metadata = (manifestEntry.metadata ?? {});
+        const existingNexus = metadata.nexus && typeof metadata.nexus === "object"
+            ? metadata.nexus
+            : {};
+        metadata.nexus = {
+            ...existingNexus,
             provides: capabilities,
         };
+        manifestEntry.metadata = metadata;
     }
     const readmeExcerpt = extractExcerpt(body || description);
     return {
@@ -595,7 +605,9 @@ async function installHubSkill(params) {
     return { installed: true, destDir };
 }
 export function registerSkillsHubCommand(program) {
-    const skills = program.command("skills").description("Search and install skills from the Nexus Hub");
+    const skills = program
+        .command("skills")
+        .description("Search and install skills from the Nexus Hub");
     skills
         .command("search <query>")
         .description("Search local skills and the Nexus Hub")
@@ -625,7 +637,10 @@ export function registerSkillsHubCommand(program) {
             config: cfg,
             managedSkillsDir,
         });
-        const metadataByName = new Map(metadataEntries.map((entry) => [entry.skill.name, getSkillMetadata(entry)]));
+        const metadataByName = new Map(metadataEntries.map((entry) => [
+            entry.skill.name,
+            getSkillMetadata(entry),
+        ]));
         const installedNames = new Set(metadataEntries.map((entry) => normalizeSkillKey(entry.skill.name)));
         const installedSlugs = await loadManagedSkillSlugs(managedSkillsDir);
         const installedIndex = {
@@ -666,7 +681,7 @@ export function registerSkillsHubCommand(program) {
         })
             .filter((skill) => skill.score > 0)
             .sort((a, b) => b.score - a.score)
-            .map(({ score, ...rest }) => rest);
+            .map(({ score: _score, ...rest }) => rest);
         let hubMatches = [];
         if (!opts.localOnly) {
             try {
@@ -801,7 +816,10 @@ export function registerSkillsHubCommand(program) {
                         console.log(`     Requires → ${deps.join(" | ")}`);
                     }
                     if (skill.install.length > 0) {
-                        console.log(`     Install → ${skill.install.map((i) => i.label).filter(Boolean).join(", ")}`);
+                        console.log(`     Install → ${skill.install
+                            .map((i) => i.label)
+                            .filter(Boolean)
+                            .join(", ")}`);
                     }
                 }
                 console.log("");
@@ -873,20 +891,32 @@ export function registerSkillsHubCommand(program) {
             const capOverrides = [
                 ...(Array.isArray(opts.capability) ? opts.capability : []),
                 ...normalizeStringList(opts.capabilities),
-            ].map((cap) => cap.trim()).filter(Boolean);
+            ]
+                .map((cap) => cap.trim())
+                .filter(Boolean);
             const overrides = {
                 path: skillDir,
                 slug: typeof opts.slug === "string" ? opts.slug.trim() : undefined,
                 name: typeof opts.name === "string" ? opts.name.trim() : undefined,
-                description: typeof opts.description === "string" ? opts.description.trim() : undefined,
+                description: typeof opts.description === "string"
+                    ? opts.description.trim()
+                    : undefined,
                 type: typeof opts.type === "string" ? opts.type.trim() : undefined,
                 version: typeof opts.version === "string" ? opts.version.trim() : undefined,
                 license: typeof opts.license === "string" ? opts.license.trim() : undefined,
-                repository: typeof opts.repository === "string" ? opts.repository.trim() : undefined,
-                homepage: typeof opts.homepage === "string" ? opts.homepage.trim() : undefined,
-                visibility: typeof opts.visibility === "string" ? opts.visibility.trim() : "public",
+                repository: typeof opts.repository === "string"
+                    ? opts.repository.trim()
+                    : undefined,
+                homepage: typeof opts.homepage === "string"
+                    ? opts.homepage.trim()
+                    : undefined,
+                visibility: typeof opts.visibility === "string"
+                    ? opts.visibility.trim()
+                    : "public",
                 capabilities: capOverrides.length > 0 ? capOverrides : undefined,
-                sourcePath: typeof opts.source === "string" ? resolveUserPath(opts.source) : undefined,
+                sourcePath: typeof opts.source === "string"
+                    ? resolveUserPath(opts.source)
+                    : undefined,
                 sourceCommit: typeof opts.sourceCommit === "string"
                     ? opts.sourceCommit.trim()
                     : undefined,

package/dist/cli/tool-connector-cli.js

@@ -1,8 +1,11 @@
 import fs from "node:fs";
 import path from "node:path";
 import { getSkillMetadata, hasBinary, loadWorkspaceSkillEntries, } from "../agents/skills.js";
-import { ensureCredentialIndexSync } from "../credentials/store.js";
-import { NEXUS_ROOT } from "../utils.js";
+import { DEFAULT_AGENT_WORKSPACE_DIR } from "../agents/workspace.js";
+import { loadConfig } from "../config/config.js";
+import { ensureCredentialIndexSync, } from "../credentials/store.js";
+import { verifyCredentials } from "../commands/credential.js";
+import { resolveUserPath } from "../utils.js";
 function resolveBinaryPath(bin) {
     const pathEnv = process.env.PATH ?? "";
     const parts = pathEnv.split(path.delimiter).filter(Boolean);
@@ -19,16 +22,29 @@ function resolveBinaryPath(bin) {
     return null;
 }
 export function registerToolConnectorCli(program) {
-    const tool = program.command("tool").description("Tool verification and paths");
-    const connector = program.command("connector").description("Connector verification and accounts");
+    const tool = program
+        .command("tool")
+        .description("Tool verification and paths");
+    const connector = program
+        .command("connector")
+        .description("Connector verification and accounts");
     tool
-        .command("verify")
+        .command("verify [name]")
         .description("Verify tool dependencies")
         .option("--json", "Output as JSON")
-        .action((opts) => {
-        const entries = loadWorkspaceSkillEntries(path.join(NEXUS_ROOT, "home"));
+        .action((name, opts) => {
+        const config = loadConfig();
+        const workspaceDir = resolveUserPath(config.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR);
+        const entries = loadWorkspaceSkillEntries(workspaceDir);
         const tools = entries.filter((entry) => getSkillMetadata(entry)?.type === "tool");
-        const results = tools.map((entry) => {
+        const scoped = name?.trim() && name.trim().length > 0
+            ? tools.filter((entry) => entry.skill.name.toLowerCase() === name.toLowerCase())
+            : tools;
+        if (name && scoped.length === 0) {
+            console.error(`Tool skill not found: ${name}`);
+            process.exit(1);
+        }
+        const results = scoped.map((entry) => {
             const meta = getSkillMetadata(entry);
             const bins = meta?.requires?.bins ?? [];
             const missing = bins.filter((bin) => !hasBinary(bin));
@@ -53,38 +69,80 @@ export function registerToolConnectorCli(program) {
         }
     });
     tool
-        .command("path <bin>")
-        .description("Resolve binary path")
-        .action((bin) => {
-        const resolved = resolveBinaryPath(bin);
+        .command("path <name>")
+        .description("Resolve binary path for a tool skill or bin")
+        .action((name) => {
+        const config = loadConfig();
+        const workspaceDir = resolveUserPath(config.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR);
+        const entries = loadWorkspaceSkillEntries(workspaceDir);
+        const match = entries.find((entry) => entry.skill.name.toLowerCase() === name.toLowerCase());
+        if (match) {
+            const meta = getSkillMetadata(match);
+            const bins = meta?.requires?.bins ?? [];
+            if (bins.length === 0) {
+                console.error(`No binaries listed for tool: ${match.skill.name}`);
+                process.exit(1);
+            }
+            const resolvedBins = bins.map((bin) => ({
+                bin,
+                path: resolveBinaryPath(bin),
+            }));
+            const missing = resolvedBins.filter((item) => !item.path);
+            if (missing.length > 0) {
+                console.error(`Missing binaries: ${missing.map((item) => item.bin).join(", ")}`);
+                process.exit(1);
+            }
+            for (const item of resolvedBins) {
+                if (item.path)
+                    console.log(item.path);
+            }
+            return;
+        }
+        const resolved = resolveBinaryPath(name);
         if (!resolved) {
-            console.error(`Binary not found: ${bin}`);
+            console.error(`Binary not found: ${name}`);
             process.exit(1);
         }
         console.log(resolved);
     });
     connector
-        .command("verify")
+        .command("verify [name]")
         .description("Verify connector credentials")
         .option("--json", "Output as JSON")
-        .action((opts) => {
-        const entries = loadWorkspaceSkillEntries(path.join(NEXUS_ROOT, "home"));
+        .action(async (name, opts) => {
+        const config = loadConfig();
+        const workspaceDir = resolveUserPath(config.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR);
+        const entries = loadWorkspaceSkillEntries(workspaceDir);
         const connectors = entries.filter((entry) => getSkillMetadata(entry)?.type === "connector");
+        const scoped = name?.trim() && name.trim().length > 0
+            ? connectors.filter((entry) => entry.skill.name.toLowerCase() === name.toLowerCase())
+            : connectors;
+        if (name && scoped.length === 0) {
+            console.error(`Connector skill not found: ${name}`);
+            process.exit(1);
+        }
         const index = ensureCredentialIndexSync();
         const services = new Set(Object.keys(index.services ?? {}).map((id) => id.toLowerCase()));
-        const results = connectors.map((entry) => {
+        const results = await Promise.all(scoped.map(async (entry) => {
             const meta = getSkillMetadata(entry);
             const provides = meta?.provides ?? [];
             const requires = meta?.requires?.credentials ?? [];
             const hints = [...requires, entry.skill.name].map((value) => value.toLowerCase());
             const hasCredential = hints.some((hint) => services.has(hint));
+            const verified = hasCredential
+                ? await Promise.all(hints.map((hint) => verifyCredentials({ service: hint }).catch(() => null)))
+                : [];
+            const ok = hasCredential
+                ? verified.every((result) => result?.ok !== false)
+                : false;
             return {
                 skill: entry.skill.name,
                 provides,
                 requires,
-                ok: hasCredential,
+                ok,
+                verified,
             };
-        });
+        }));
         if (opts.json) {
             console.log(JSON.stringify(results, null, 2));
             return;
@@ -99,17 +157,34 @@ export function registerToolConnectorCli(program) {
         }
     });
     connector
-        .command("accounts")
+        .command("accounts [service]")
         .description("List credential accounts")
         .option("--json", "Output as JSON")
-        .action((opts) => {
+        .action((service, opts) => {
         const index = ensureCredentialIndexSync();
+        const filter = service?.trim();
         if (opts.json) {
-            console.log(JSON.stringify(index, null, 2));
+            if (!filter) {
+                console.log(JSON.stringify(index, null, 2));
+                return;
+            }
+            const entry = index.services?.[filter];
+            if (!entry) {
+                console.error(`Service not found: ${filter}`);
+                process.exit(1);
+            }
+            console.log(JSON.stringify({ [filter]: entry }, null, 2));
             return;
         }
-        for (const [service, info] of Object.entries(index.services ?? {})) {
-            console.log(service);
+        const entries = filter
+            ? index.services?.[filter]
+                ? [[filter, index.services[filter]]]
+                : []
+            : Object.entries(index.services ?? {});
+        for (const [serviceId, info] of entries) {
+            if (!info)
+                continue;
+            console.log(serviceId);
             for (const account of info.accounts ?? []) {
                 console.log(`  - ${account.id}`);
             }