@sulala/agent-os 0.1.24 → 0.1.26

package/dist/cli.js

@@ -8451,6 +8451,28 @@ var init_skill_tools = () => {};
 import { readFile as readFile5, readdir as readdir3, cp, mkdir as mkdir3, writeFile as writeFile3, rm } from "fs/promises";
 import { join as join5, resolve as resolve2, basename } from "path";
 import { tmpdir } from "os";
+async function readSkillMeta(skillDir, subEntries) {
+  if (!subEntries.includes(SULALA_META_FILE))
+    return null;
+  try {
+    const raw = await readFile5(join5(skillDir, SULALA_META_FILE), "utf-8");
+    const data = JSON.parse(raw);
+    return typeof data.version === "string" && data.version.trim() !== "" ? { version: data.version.trim() } : null;
+  } catch {
+    return null;
+  }
+}
+async function writeSkillMeta(skillId, meta) {
+  const skillDir = join5(getSkillsDir(), skillId);
+  const payload = {};
+  if (meta.version?.trim())
+    payload.version = meta.version.trim();
+  if (meta.source?.trim())
+    payload.source = meta.source.trim();
+  if (Object.keys(payload).length === 0)
+    return;
+  await writeFile3(join5(skillDir, SULALA_META_FILE), JSON.stringify(payload, null, 0), "utf-8");
+}
 async function loadSkill(name) {
   const dir = join5(getSkillsDir(), name);
   let entries;
@@ -8693,10 +8715,14 @@ async function listSkills() {
       continue;
     const skillName = doc.name ?? name;
     const requiredEnv = await getRequiredEnvForSkill(skillDir, subEntries, doc);
+    const docVersion = doc.version?.trim() || undefined;
+    const meta = await readSkillMeta(skillDir, subEntries);
+    const version = docVersion ?? meta?.version;
     results.push({
       id: name,
       name: skillName,
       description: doc.description,
+      version,
       tools: (doc.tools ?? []).map((t) => ({ id: t.id, description: t.description })),
       required_env: requiredEnv.length ? requiredEnv : undefined,
       system: SYSTEM_SKILL_IDS.has(name)
@@ -8766,7 +8792,7 @@ async function installSystemSkills() {
   }
   return { installed };
 }
-async function installSkillFromUrl(url, explicitId) {
+async function installSkillFromUrl(url, explicitId, meta) {
   const urlLower = url.toLowerCase();
   const isStoreSkillContentUrl = urlLower.includes("/api/sulalahub/skills/") && !urlLower.includes("/download") && !urlLower.endsWith(".zip");
   const headers = isStoreSkillContentUrl ? { Accept: "application/zip" } : {};
@@ -8781,31 +8807,35 @@ async function installSkillFromUrl(url, explicitId) {
   const tmpDir = join5(tmpdir(), `agent-os-skill-${Date.now()}`);
   await mkdir3(tmpDir, { recursive: true });
   try {
+    let destId;
     if (isZip) {
       const zipPath = join5(tmpDir, "archive.zip");
       await writeFile3(zipPath, new Uint8Array(buf));
-      const proc2 = Bun.spawn({ cmd: ["unzip", "-q", "-o", zipPath, "-d", tmpDir], stdout: "ignore", stderr: "pipe" });
-      const exit2 = await proc2.exited;
-      if (exit2 !== 0) {
-        const err = await new Response(proc2.stderr).text();
+      const proc = Bun.spawn({ cmd: ["unzip", "-q", "-o", zipPath, "-d", tmpDir], stdout: "ignore", stderr: "pipe" });
+      const exit = await proc.exited;
+      if (exit !== 0) {
+        const err = await new Response(proc.stderr).text();
         throw new Error(`unzip failed: ${err}`);
       }
-      const { id: id2, sourcePath: sourcePath2 } = await chooseSkillRootFromExtract(tmpDir, "archive.zip");
-      const destId2 = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id2;
-      await cp(sourcePath2, join5(skillsDir, destId2), { recursive: true });
-      return { id: destId2 };
-    }
-    const tarPath = join5(tmpDir, "archive.tar.gz");
-    await writeFile3(tarPath, new Uint8Array(buf));
-    const proc = Bun.spawn({ cmd: ["tar", "-xzf", tarPath, "-C", tmpDir], stdout: "ignore", stderr: "pipe" });
-    const exit = await proc.exited;
-    if (exit !== 0) {
-      const err = await new Response(proc.stderr).text();
-      throw new Error(`tar extract failed: ${err}`);
-    }
-    const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.tar.gz");
-    const destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
-    await cp(sourcePath, join5(skillsDir, destId), { recursive: true });
+      const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.zip");
+      destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
+      await cp(sourcePath, join5(skillsDir, destId), { recursive: true });
+    } else {
+      const tarPath = join5(tmpDir, "archive.tar.gz");
+      await writeFile3(tarPath, new Uint8Array(buf));
+      const proc = Bun.spawn({ cmd: ["tar", "-xzf", tarPath, "-C", tmpDir], stdout: "ignore", stderr: "pipe" });
+      const exit = await proc.exited;
+      if (exit !== 0) {
+        const err = await new Response(proc.stderr).text();
+        throw new Error(`tar extract failed: ${err}`);
+      }
+      const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.tar.gz");
+      destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
+      await cp(sourcePath, join5(skillsDir, destId), { recursive: true });
+    }
+    if (meta?.version?.trim() || meta?.source?.trim()) {
+      await writeSkillMeta(destId, { version: meta.version, source: meta.source ?? (explicitId ? "hub" : undefined) });
+    }
     return { id: destId };
   } finally {
     await rm(tmpDir, { recursive: true, force: true });
@@ -8864,7 +8894,7 @@ async function installSkillFromSkillMd(buffer, filename, explicitId) {
   await writeFile3(join5(destDir, "SKILL.md"), text, "utf-8");
   return { id };
 }
-var SYSTEM_SKILL_IDS, DEFAULT_SYSTEM_SKILL_IDS;
+var SYSTEM_SKILL_IDS, DEFAULT_SYSTEM_SKILL_IDS, SULALA_META_FILE = ".sulala-meta.json";
 var init_loader = __esm(() => {
   init_config();
   init_tool_registry();
@@ -26095,8 +26125,10 @@ async function handleSkillInstall(req) {
     return jsonResponse({ error: "Provide path or url" }, 400);
   }
   const slug = typeof body.slug === "string" && body.slug.trim() !== "" ? body.slug.trim() : undefined;
+  const version2 = typeof body.version === "string" && body.version.trim() !== "" ? body.version.trim() : undefined;
+  const meta = version2 || slug ? { version: version2, source: slug ? "hub" : undefined } : undefined;
   try {
-    const result = hasPath ? await installSkillFromPath(body.path.trim()) : await installSkillFromUrl(body.url.trim(), slug);
+    const result = hasPath ? await installSkillFromPath(body.path.trim()) : await installSkillFromUrl(body.url.trim(), slug, meta);
     return jsonResponse({ skill: result }, 201);
   } catch (err) {
     const msg = errorMessage(err);
@@ -30389,6 +30421,7 @@ Commands:
   onboard              First-time setup: create config, seed agents & skills, open dashboard
   update               Update package from npm and system agents/skills
   run <agent_id> <task>  Run an agent with a one-off task
+  skill install <slug> Install a skill from the store by slug (e.g. crm-hubspot)
   dashboard-token [--regenerate]  Show or regenerate dashboard login token (copy to log in)
 
 Examples:
@@ -30399,6 +30432,7 @@ Examples:
   sulala onboard
   sulala update
   sulala run echo_agent What is 2+2?
+  sulala skill install crm-hubspot
   sulala dashboard-token
   sulala dashboard-token --regenerate
 `);
@@ -30520,14 +30554,21 @@ async function cmdOnboard() {
   const started = await startServerDaemonIfNeeded();
   if (started) {
     console.log("Server starting in background. Use 'sulala stop' to stop.");
-    await new Promise((r) => setTimeout(r, 1500));
   }
-  openDashboard();
   const token = await getDashboardSecret();
   console.log("");
   console.log("Dashboard login token (copy and paste in the dashboard):");
   console.log(token);
   console.log("");
+  const readline = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve5) => rl.question("Go to dashboard? (y/n): ", resolve5));
+  rl.close();
+  if (/^y(es)?$/i.test(answer.trim())) {
+    if (started)
+      await new Promise((r) => setTimeout(r, 1500));
+    openDashboard();
+  }
 }
 var NPM_PACKAGE = "@sulala/agent-os";
 async function cmdUpdate() {
@@ -30605,6 +30646,57 @@ async function cmdRun(args) {
     process.exit(1);
   }
 }
+async function cmdSkill(args) {
+  const sub = args[0]?.toLowerCase();
+  const rest = args.slice(1);
+  if (sub === "install") {
+    await cmdSkillInstall(rest);
+    return;
+  }
+  if (!sub || sub === "help" || sub === "-h" || sub === "--help") {
+    console.log("Usage: sulala skill install <slug>");
+    console.log("  Install a skill from the store by slug (e.g. crm-hubspot).");
+    console.log("  Installs the latest version; you can pin a specific version in your skill config if needed.");
+    console.log("");
+    console.log("Example: sulala skill install crm-hubspot");
+    return;
+  }
+  console.error(`Unknown subcommand: skill ${sub}`);
+  console.error("Usage: sulala skill install <slug>");
+  process.exit(1);
+}
+async function cmdSkillInstall(args) {
+  const slug = args[0]?.trim();
+  if (!slug) {
+    console.error("Usage: sulala skill install <slug>");
+    console.error("Example: sulala skill install crm-hubspot");
+    process.exit(1);
+  }
+  const { skills, storeBase } = await getStoreRegistry();
+  if (!storeBase) {
+    console.error("Could not reach the skills store. Check config (skills_registry_url) or run 'sulala onboard' first.");
+    process.exit(1);
+  }
+  const entry = skills.find((s) => s.slug === slug);
+  if (!entry) {
+    console.error(`Skill '${slug}' not found in the store. Check the slug at hub.sulala.ai or install from the dashboard (Skills page).`);
+    process.exit(1);
+  }
+  const downloadUrl = entry.downloadUrl ?? `${storeBase}/api/sulalahub/skills/${encodeURIComponent(slug)}/download`;
+  const version2 = entry.version;
+  try {
+    const { id } = await installSkillFromUrl(downloadUrl, slug, {
+      version: version2 ?? undefined,
+      source: "hub"
+    });
+    const verStr = version2 ? ` (v${version2})` : "";
+    console.log(`Installed ${id}${verStr}. Add it to your agent in the dashboard (Edit agent \u2192 Skills).`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error("Install failed:", msg);
+    process.exit(1);
+  }
+}
 async function main() {
   if (!process.versions.bun) {
     console.error("Sulala CLI requires Bun. Use: bun run src/cli.ts");
@@ -30634,6 +30726,9 @@ async function main() {
     case "run":
       await cmdRun(rest);
       break;
+    case "skill":
+      await cmdSkill(rest);
+      break;
     case "dashboard-token":
       await cmdDashboardToken(rest);
       break;

package/dist/index.js

@@ -19606,6 +19606,29 @@ function createTokenRequestTool(skillId, toolId, baseUrl, description) {
 init_config();
 var SYSTEM_SKILL_IDS = new Set(["memory"]);
 var DEFAULT_SYSTEM_SKILL_IDS = ["memory", "date", "fetch", "jq", "file-search"];
+var SULALA_META_FILE = ".sulala-meta.json";
+async function readSkillMeta(skillDir, subEntries) {
+  if (!subEntries.includes(SULALA_META_FILE))
+    return null;
+  try {
+    const raw = await readFile5(join6(skillDir, SULALA_META_FILE), "utf-8");
+    const data = JSON.parse(raw);
+    return typeof data.version === "string" && data.version.trim() !== "" ? { version: data.version.trim() } : null;
+  } catch {
+    return null;
+  }
+}
+async function writeSkillMeta(skillId, meta) {
+  const skillDir = join6(getSkillsDir(), skillId);
+  const payload = {};
+  if (meta.version?.trim())
+    payload.version = meta.version.trim();
+  if (meta.source?.trim())
+    payload.source = meta.source.trim();
+  if (Object.keys(payload).length === 0)
+    return;
+  await writeFile3(join6(skillDir, SULALA_META_FILE), JSON.stringify(payload, null, 0), "utf-8");
+}
 async function loadSkill(name) {
   const dir = join6(getSkillsDir(), name);
   let entries;
@@ -19848,10 +19871,14 @@ async function listSkills() {
       continue;
     const skillName = doc.name ?? name;
     const requiredEnv = await getRequiredEnvForSkill(skillDir, subEntries, doc);
+    const docVersion = doc.version?.trim() || undefined;
+    const meta = await readSkillMeta(skillDir, subEntries);
+    const version = docVersion ?? meta?.version;
     results.push({
       id: name,
       name: skillName,
       description: doc.description,
+      version,
       tools: (doc.tools ?? []).map((t) => ({ id: t.id, description: t.description })),
       required_env: requiredEnv.length ? requiredEnv : undefined,
       system: SYSTEM_SKILL_IDS.has(name)
@@ -19921,7 +19948,7 @@ async function installSystemSkills() {
   }
   return { installed };
 }
-async function installSkillFromUrl(url, explicitId) {
+async function installSkillFromUrl(url, explicitId, meta) {
   const urlLower = url.toLowerCase();
   const isStoreSkillContentUrl = urlLower.includes("/api/sulalahub/skills/") && !urlLower.includes("/download") && !urlLower.endsWith(".zip");
   const headers = isStoreSkillContentUrl ? { Accept: "application/zip" } : {};
@@ -19936,31 +19963,35 @@ async function installSkillFromUrl(url, explicitId) {
   const tmpDir = join6(tmpdir(), `agent-os-skill-${Date.now()}`);
   await mkdir3(tmpDir, { recursive: true });
   try {
+    let destId;
     if (isZip) {
       const zipPath = join6(tmpDir, "archive.zip");
       await writeFile3(zipPath, new Uint8Array(buf));
-      const proc2 = Bun.spawn({ cmd: ["unzip", "-q", "-o", zipPath, "-d", tmpDir], stdout: "ignore", stderr: "pipe" });
-      const exit2 = await proc2.exited;
-      if (exit2 !== 0) {
-        const err = await new Response(proc2.stderr).text();
+      const proc = Bun.spawn({ cmd: ["unzip", "-q", "-o", zipPath, "-d", tmpDir], stdout: "ignore", stderr: "pipe" });
+      const exit = await proc.exited;
+      if (exit !== 0) {
+        const err = await new Response(proc.stderr).text();
         throw new Error(`unzip failed: ${err}`);
       }
-      const { id: id2, sourcePath: sourcePath2 } = await chooseSkillRootFromExtract(tmpDir, "archive.zip");
-      const destId2 = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id2;
-      await cp(sourcePath2, join6(skillsDir, destId2), { recursive: true });
-      return { id: destId2 };
-    }
-    const tarPath = join6(tmpDir, "archive.tar.gz");
-    await writeFile3(tarPath, new Uint8Array(buf));
-    const proc = Bun.spawn({ cmd: ["tar", "-xzf", tarPath, "-C", tmpDir], stdout: "ignore", stderr: "pipe" });
-    const exit = await proc.exited;
-    if (exit !== 0) {
-      const err = await new Response(proc.stderr).text();
-      throw new Error(`tar extract failed: ${err}`);
-    }
-    const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.tar.gz");
-    const destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
-    await cp(sourcePath, join6(skillsDir, destId), { recursive: true });
+      const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.zip");
+      destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
+      await cp(sourcePath, join6(skillsDir, destId), { recursive: true });
+    } else {
+      const tarPath = join6(tmpDir, "archive.tar.gz");
+      await writeFile3(tarPath, new Uint8Array(buf));
+      const proc = Bun.spawn({ cmd: ["tar", "-xzf", tarPath, "-C", tmpDir], stdout: "ignore", stderr: "pipe" });
+      const exit = await proc.exited;
+      if (exit !== 0) {
+        const err = await new Response(proc.stderr).text();
+        throw new Error(`tar extract failed: ${err}`);
+      }
+      const { id, sourcePath } = await chooseSkillRootFromExtract(tmpDir, "archive.tar.gz");
+      destId = explicitId != null && explicitId.trim() !== "" ? slugToSkillId(explicitId) : id;
+      await cp(sourcePath, join6(skillsDir, destId), { recursive: true });
+    }
+    if (meta?.version?.trim() || meta?.source?.trim()) {
+      await writeSkillMeta(destId, { version: meta.version, source: meta.source ?? (explicitId ? "hub" : undefined) });
+    }
     return { id: destId };
   } finally {
     await rm(tmpDir, { recursive: true, force: true });
@@ -27926,8 +27957,10 @@ async function handleSkillInstall(req) {
     return jsonResponse({ error: "Provide path or url" }, 400);
   }
   const slug = typeof body.slug === "string" && body.slug.trim() !== "" ? body.slug.trim() : undefined;
+  const version2 = typeof body.version === "string" && body.version.trim() !== "" ? body.version.trim() : undefined;
+  const meta = version2 || slug ? { version: version2, source: slug ? "hub" : undefined } : undefined;
   try {
-    const result = hasPath ? await installSkillFromPath(body.path.trim()) : await installSkillFromUrl(body.url.trim(), slug);
+    const result = hasPath ? await installSkillFromPath(body.path.trim()) : await installSkillFromUrl(body.url.trim(), slug, meta);
     return jsonResponse({ skill: result }, 201);
   } catch (err) {
     const msg = errorMessage(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sulala/agent-os",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "publishConfig": {
     "access": "public"
   },