@topolo/cli 0.12.33 → 0.13.0

package/dist/index.js

@@ -1,5 +1,52 @@
 #!/usr/bin/env node
 
+// src/commands/agent-packs.ts
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+function registerAgentPacksCommand(program2) {
+  const packs = program2.command("agent-packs").description("Install and operate Topolo Agent Packs in supported local hosts").option("--store <path>", "Portable pack library (default ~/AgentPacks)");
+  const commands = [
+    "add",
+    "replace",
+    "switch",
+    "capture",
+    "build",
+    "install",
+    "export",
+    "status",
+    "list",
+    "recover",
+    "doctor",
+    "remote-recover",
+    "connect",
+    "remote-context",
+    "remember",
+    "artifact",
+    "artifact-get"
+  ];
+  for (const name of commands) {
+    packs.command(name).description(name === "add" ? "Add an installed or bundled pack, group, or agent" : `Run the pack ${name} operation`).option("--harness <name>", "Local host adapter (currently codex)", "codex").option("--adapter-help", "Show every option supported by the selected adapter").argument("[arguments...]").allowUnknownOption().allowExcessArguments().addHelpText("after", name === "add" ? "\nExamples:\n  topolo agent-packs add founder\n  topolo agent-packs add founder --group specialists\n  topolo agent-packs add founder --agent strategy\n" : "\nRun topolo agent-packs <command> --adapter-help for all adapter options. Cloud commands require explicit --environment and --context-key.\n").action((args, options) => {
+      if (options.harness !== "codex") throw new Error(`The ${options.harness} pack adapter is not available. Only Codex switching has been verified.`);
+      const here = dirname(fileURLToPath(import.meta.url));
+      const adapter = [resolve(here, "../agent-packs/topolo-agent-pack"), resolve(here, "../../agent-packs/topolo-agent-pack")].find(existsSync);
+      if (!adapter) throw new Error("This CLI installation is missing its bundled Topolo Agent Pack adapter. Reinstall @topolo/cli.");
+      const store = packs.opts().store;
+      const forwarded = (options.adapterHelp ? ["--help"] : args).map((value) => value === "--group" ? "--set" : value);
+      const result = spawnSync("python3", [
+        adapter,
+        ...store ? ["--store", store] : [],
+        name,
+        ...forwarded,
+        ...name === "add" && !options.adapterHelp ? ["--catalog"] : []
+      ], { stdio: "inherit", env: { ...process.env, PYTHONDONTWRITEBYTECODE: "1", TOPOLO_AGENT_PACK_PUBLIC_CLI: "1" } });
+      if (result.error) throw new Error(`Python 3.11 or later is required for local packs: ${result.error.message}`);
+      if (result.status !== 0) process.exitCode = result.status ?? 2;
+    });
+  }
+}
+
 // src/index.ts
 import { Command, Help } from "commander";
 
@@ -1592,7 +1639,7 @@ var TopoloClient = class _TopoloClient {
         } catch (error) {
           const transportFailure = !(error instanceof TopoloSdkError) && !opts.signal?.aborted;
           if (!transportFailure || attempt === maxAttempts) throw error;
-          await new Promise((resolve3) => setTimeout(resolve3, 250));
+          await new Promise((resolve4) => setTimeout(resolve4, 250));
         }
       }
       throw new TopoloSdkError("network_error", "Topolo read retry loop exhausted.");
@@ -3582,7 +3629,7 @@ function createTopolo(options) {
 async function pollUntilApproved(params) {
   let interval = Math.max(params.intervalSeconds ?? 5, 1);
   while (Date.now() < params.expiresAtMs) {
-    await new Promise((resolve3) => setTimeout(resolve3, Math.min(interval * 1e3, params.expiresAtMs - Date.now())));
+    await new Promise((resolve4) => setTimeout(resolve4, Math.min(interval * 1e3, params.expiresAtMs - Date.now())));
     if (Date.now() >= params.expiresAtMs) break;
     try {
       return await params.oauth.pollDeviceToken({
@@ -3617,11 +3664,11 @@ import { homedir as homedir2, platform } from "os";
 import { dirname as dirname2, join as join3 } from "path";
 import { createHash, randomUUID } from "crypto";
 import { join as join2 } from "path";
-import { spawnSync } from "child_process";
+import { spawnSync as spawnSync2 } from "child_process";
 import { mkdir, readFile, readdir, rename, rm, writeFile, chmod } from "fs/promises";
-import { existsSync } from "fs";
+import { existsSync as existsSync3 } from "fs";
 import { homedir, platform as hostPlatform } from "os";
-import { dirname, join } from "path";
+import { dirname as dirname3, join } from "path";
 var TopoloSdkError2 = class extends Error {
   code;
   constructor(code, message2) {
@@ -4068,7 +4115,7 @@ function runOrThrow(result, operation) {
 }
 function createPlatformInstallationSecretBackend(options = {}) {
   const platform22 = options.platform ?? hostPlatform();
-  const spawn3 = options.spawn ?? ((command, args, spawnOptions) => spawnSync(command, args, spawnOptions));
+  const spawn3 = options.spawn ?? ((command, args, spawnOptions) => spawnSync2(command, args, spawnOptions));
   const root = options.root ?? installationStorePath();
   const service = options.service ?? KEYCHAIN_SERVICE;
   if (platform22 === "darwin") {
@@ -4187,13 +4234,13 @@ function createPlatformInstallationSecretBackend(options = {}) {
     return {
       async set(account, value) {
         const path = secretPath(account);
-        await mkdir(dirname(path), { recursive: true });
+        await mkdir(dirname3(path), { recursive: true });
         const script = "$p=$env:TOPOLO_SECRET_PATH;$v=[Console]::In.ReadToEnd();$b=[Text.Encoding]::UTF8.GetBytes($v);$e=[Security.Cryptography.ProtectedData]::Protect($b,$null,[Security.Cryptography.DataProtectionScope]::CurrentUser);[IO.File]::WriteAllBytes($p,$e)";
         runOrThrow(powershell(script, path, value), "Windows DPAPI write");
       },
       async get(account) {
         const path = secretPath(account);
-        if (!existsSync(path)) return null;
+        if (!existsSync3(path)) return null;
         const script = "$p=$env:TOPOLO_SECRET_PATH;$b=[IO.File]::ReadAllBytes($p);$d=[Security.Cryptography.ProtectedData]::Unprotect($b,$null,[Security.Cryptography.DataProtectionScope]::CurrentUser);[Console]::Out.Write([Text.Encoding]::UTF8.GetString($d))";
         return runOrThrow(powershell(script, path), "Windows DPAPI read");
       },
@@ -4209,7 +4256,7 @@ async function writeExternalAgentInstallation(installation, secret, backend = cr
   await backend.set(accountName(installation.environment, installation.id), JSON.stringify(secret));
   const temporary = `${path}.${process.pid}.tmp`;
   try {
-    await mkdir(dirname(path), { recursive: true, mode: 448 });
+    await mkdir(dirname3(path), { recursive: true, mode: 448 });
     await writeFile(temporary, `${JSON.stringify(installation, null, 2)}
 `, { encoding: "utf8", mode: 384 });
     await rename(temporary, path);
@@ -4222,7 +4269,7 @@ async function writeExternalAgentInstallation(installation, secret, backend = cr
 }
 async function listExternalAgentInstallations(environment) {
   const directory = join(installationStorePath(), environment);
-  if (!existsSync(directory)) return [];
+  if (!existsSync3(directory)) return [];
   const entries = await readdir(directory, { withFileTypes: true });
   const installations = await Promise.all(entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map(async (entry) => JSON.parse(await readFile(join(directory, entry.name), "utf8"))));
   return installations.sort((left, right) => left.createdAt.localeCompare(right.createdAt));
@@ -4493,7 +4540,7 @@ async function withConfigWriteLock(operation) {
       if (Date.now() - startedAt >= CONFIG_LOCK_TIMEOUT_MS) {
         throw new Error(`Timed out waiting for credential configuration lock at ${lockPath}.`);
       }
-      await new Promise((resolve3) => setTimeout(resolve3, CONFIG_LOCK_RETRY_MS));
+      await new Promise((resolve4) => setTimeout(resolve4, CONFIG_LOCK_RETRY_MS));
     }
   }
   try {
@@ -4765,11 +4812,11 @@ function normalizeError(err) {
 
 // src/version.ts
 import { readFileSync } from "fs";
-import { dirname as dirname3, join as join4 } from "path";
-import { fileURLToPath } from "url";
+import { dirname as dirname4, join as join4 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 function readCliVersion() {
   try {
-    const here = dirname3(fileURLToPath(import.meta.url));
+    const here = dirname4(fileURLToPath2(import.meta.url));
     const candidates = [
       join4(here, "package.json"),
       join4(here, "..", "package.json")
@@ -6076,17 +6123,17 @@ function formatCheckResult(result) {
 }
 
 // src/commands/skills.ts
-import { spawnSync as spawnSync3 } from "child_process";
-import { existsSync as existsSync5 } from "fs";
+import { spawnSync as spawnSync4 } from "child_process";
+import { existsSync as existsSync6 } from "fs";
 import { readFile as readFile6, rm as rm3 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname5, join as join7, resolve } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname6, join as join7, resolve as resolve2 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import { createRequire } from "module";
 
 // src/commands/agent-host.ts
-import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync3 } from "fs";
+import { spawnSync as spawnSync3 } from "child_process";
+import { existsSync as existsSync4 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
 import { homedir as homedir3 } from "os";
 import { isAbsolute, join as join6 } from "path";
@@ -6138,7 +6185,7 @@ function selectStableNodeCommand(whichOutput, fallback = process.execPath) {
   return candidate && isAbsolute(candidate) ? candidate : fallback;
 }
 function stableNodeCommand() {
-  const probe = spawnSync2(process.platform === "win32" ? "where" : "which", ["node"], {
+  const probe = spawnSync3(process.platform === "win32" ? "where" : "which", ["node"], {
     encoding: "utf8",
     stdio: ["ignore", "pipe", "ignore"]
   });
@@ -6229,7 +6276,7 @@ function agentConfigPaths(agent, homeDir = homedir3(), projectDir) {
         return [{ path: join6(projectDir, ".amazonq", "mcp.json"), format: "json", rootKey: "mcpServers" }];
       }
       return [{
-        path: existsSync3(join6(homeDir, ".aws", "amazonq", "mcp.json")) ? join6(homeDir, ".aws", "amazonq", "mcp.json") : join6(homeDir, ".aws", "amazonq", "default.json"),
+        path: existsSync4(join6(homeDir, ".aws", "amazonq", "mcp.json")) ? join6(homeDir, ".aws", "amazonq", "mcp.json") : join6(homeDir, ".aws", "amazonq", "default.json"),
         format: "json",
         rootKey: "mcpServers"
       }];
@@ -6262,7 +6309,7 @@ function agentCliNames(agent) {
   }
 }
 function agentConfigExists(agent, homeDir = homedir3(), projectDir) {
-  return agentConfigPaths(agent, homeDir, projectDir).some((config) => existsSync3(config.path));
+  return agentConfigPaths(agent, homeDir, projectDir).some((config) => existsSync4(config.path));
 }
 function claudeDesktopConfigPath(homeDir) {
   if (process.platform === "darwin") return join6(homeDir, "Library", "Application Support", "Claude", "claude_desktop_config.json");
@@ -6277,7 +6324,7 @@ function vscodeUserConfigPath(homeDir) {
 async function readAgentRegistrations(agent, homeDir = homedir3(), projectDir) {
   const registrations = [];
   for (const config of agentConfigPaths(agent, homeDir, projectDir)) {
-    if (!existsSync3(config.path)) continue;
+    if (!existsSync4(config.path)) continue;
     if (config.format === "json") {
       registrations.push(...await readJsonRegistrations(config.path, config.rootKey ?? "mcpServers", agent));
     } else if (config.format === "toml") {
@@ -6538,9 +6585,9 @@ function message(error) {
 }
 
 // src/commands/agent-config.ts
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { mkdir as mkdir3, readFile as readFile5, rename as rename2, writeFile as writeFile3 } from "fs/promises";
-import { dirname as dirname4 } from "path";
+import { dirname as dirname5 } from "path";
 async function installAgentSkill(agent, source, homeDir, projectDir) {
   const path = agentSkillPath(agent, homeDir, projectDir);
   if (!path) return { installed: false };
@@ -6561,7 +6608,7 @@ async function registerAgentConfig(agent, mcp, homeDir, registration, projectDir
 }
 async function unregisterAgentConfig(agent, homeDir, name, projectDir) {
   for (const config of agentConfigPaths(agent, homeDir, projectDir)) {
-    if (!existsSync4(config.path)) continue;
+    if (!existsSync5(config.path)) continue;
     if (config.format === "json") {
       await unregisterJson(config, agent, name);
     } else if (config.format === "toml") {
@@ -6581,7 +6628,7 @@ function registrationEnvironment(agent, registration) {
 }
 async function registerJson(config, agent, mcp, registration) {
   let parsed = {};
-  if (existsSync4(config.path)) {
+  if (existsSync5(config.path)) {
     try {
       parsed = JSON.parse(await readFile5(config.path, "utf8"));
     } catch (error) {
@@ -6626,7 +6673,7 @@ async function unregisterJson(config, agent, name) {
   await atomicWrite(config.path, JSON.stringify(parsed, null, 2) + "\n");
 }
 async function registerToml(path, agent, mcp, registration) {
-  const existing = existsSync4(path) ? await readFile5(path, "utf8") : "";
+  const existing = existsSync5(path) ? await readFile5(path, "utf8") : "";
   const text2 = withoutMcpServerSections(existing, registration.name);
   const args = mcp.args.length ? "\nargs = [" + mcp.args.map((item) => JSON.stringify(item)).join(", ") + "]" : "";
   const environment = registrationEnvironment(agent, registration);
@@ -6635,7 +6682,7 @@ async function registerToml(path, agent, mcp, registration) {
   await atomicWrite(path, text2 + block);
 }
 async function registerGoose(path, mcp, registration) {
-  const existing = existsSync4(path) ? await readFile5(path, "utf8") : "";
+  const existing = existsSync5(path) ? await readFile5(path, "utf8") : "";
   const withoutTopolo = removeGooseExtension(existing, registration.name);
   const environment = registrationEnvironment("goose", registration);
   const block = [
@@ -6703,7 +6750,7 @@ function formatSkillForAgent(agent, source) {
   return "---\ntrigger: model_decision\ndescription: Use Topolo MCP for Topolo platform operations.\n---\n\n" + body;
 }
 async function atomicWrite(path, contents) {
-  await mkdir3(dirname4(path), { recursive: true });
+  await mkdir3(dirname5(path), { recursive: true });
   const temporaryPath = path + ".topolo-" + process.pid + ".tmp";
   await writeFile3(temporaryPath, contents, { encoding: "utf8", mode: 384 });
   await rename2(temporaryPath, path);
@@ -6726,11 +6773,11 @@ function withoutMcpServerSections(text2, name) {
 // src/commands/skills.ts
 var AGENT_LABELS2 = AGENT_LABELS;
 function skillsSourceDir() {
-  const here = dirname5(fileURLToPath2(import.meta.url));
-  const distCandidate = resolve(here, "../skills");
-  const srcCandidate = resolve(here, "../../skills");
+  const here = dirname6(fileURLToPath3(import.meta.url));
+  const distCandidate = resolve2(here, "../skills");
+  const srcCandidate = resolve2(here, "../../skills");
   for (const candidate of [distCandidate, srcCandidate]) {
-    if (existsSync5(join7(candidate, "topolo", "SKILL.md"))) return candidate;
+    if (existsSync6(join7(candidate, "topolo", "SKILL.md"))) return candidate;
   }
   return distCandidate;
 }
@@ -6740,7 +6787,7 @@ function resolveMcpCommand() {
 }
 function agentBinaryExists(agent) {
   return agentCliNames(agent).some((bin) => {
-    const probe = spawnSync3(process.platform === "win32" ? "where" : "which", [bin], {
+    const probe = spawnSync4(process.platform === "win32" ? "where" : "which", [bin], {
       stdio: "ignore"
     });
     return probe.status === 0;
@@ -6839,7 +6886,7 @@ function registerSkillsCommand(program2) {
     const mode = resolveOutputMode(opts.json);
     try {
       const rows = await agentSurfaceStatus({
-        homeDir: opts.agentHome ? resolve(opts.agentHome) : void 0,
+        homeDir: opts.agentHome ? resolve2(opts.agentHome) : void 0,
         name: opts.name,
         agent: opts.agent,
         all: opts.all,
@@ -6855,7 +6902,7 @@ function registerSkillsCommand(program2) {
     try {
       const removed = await uninstallAgentSurfaces({
         ...opts,
-        homeDir: opts.agentHome ? resolve(opts.agentHome) : void 0
+        homeDir: opts.agentHome ? resolve2(opts.agentHome) : void 0
       });
       emit(
         { removed },
@@ -6869,7 +6916,7 @@ function registerSkillsCommand(program2) {
 }
 async function installAgentSurfaces(opts) {
   const sourceDir = skillsSourceDir();
-  if (!existsSync5(join7(sourceDir, "topolo", "SKILL.md"))) {
+  if (!existsSync6(join7(sourceDir, "topolo", "SKILL.md"))) {
     throw new Error("Bundled skill file not found. Reinstall the CLI: npm install -g @topolo/cli");
   }
   const mcp = resolveMcpCommand();
@@ -6919,7 +6966,7 @@ async function agentSurfaceStatus(options = {}) {
   });
   return Promise.all(agents.map(async (agent) => {
     const skillPath = agentSkillPath(agent, homeDir, options.project);
-    const installedSkill = skillPath && existsSync5(skillPath) ? await readFile6(skillPath, "utf8") : void 0;
+    const installedSkill = skillPath && existsSync6(skillPath) ? await readFile6(skillPath, "utf8") : void 0;
     const registrations = (await readAgentRegistrations(agent, homeDir, options.project)).filter((registration) => !options.name || registration.name === options.name);
     return {
       agent,
@@ -6943,8 +6990,8 @@ async function uninstallAgentSurfaces(options) {
     await unregisterAgentConfig(agent, homeDir, name, options.project);
     const remaining = await readAgentRegistrations(agent, homeDir, options.project);
     const skillPath = agentSkillPath(agent, homeDir, options.project);
-    const skillRemoved = remaining.length === 0 && Boolean(skillPath && existsSync5(skillPath));
-    if (skillRemoved && skillPath) await rm3(dirname5(skillPath), { recursive: true, force: true });
+    const skillRemoved = remaining.length === 0 && Boolean(skillPath && existsSync6(skillPath));
+    if (skillRemoved && skillPath) await rm3(dirname6(skillPath), { recursive: true, force: true });
     removed.push({ agent, name, registrationRemoved, skillRemoved });
   }
   return removed;
@@ -6975,7 +7022,7 @@ function formatStatus(rows) {
 // src/commands/doctor.ts
 import { access } from "fs/promises";
 import { homedir as homedir5 } from "os";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 var defaultDependencies = {
@@ -7037,7 +7084,7 @@ async function verifyMcpProtocol(command, args, env = definedEnvironment(process
 }
 async function resolveInstalledDoctorTarget(options) {
   const name = options.name?.trim() || "topolo";
-  const homeDir = options.agentHome ? resolve2(options.agentHome) : homedir5();
+  const homeDir = options.agentHome ? resolve3(options.agentHome) : homedir5();
   const expected = resolveMcpCommand();
   const requestedAgents = resolveTargets({
     ...options,
@@ -7700,6 +7747,9 @@ program.hook("preAction", async (thisCommand, actionCommand) => {
   const opts = thisCommand.opts();
   if (opts.env) process.env.TOPOLO_ENV = normalizeEnvironment(opts.env);
   if (opts.env || environmentWasStated) return;
+  for (let node = actionCommand; node; node = node.parent) {
+    if (node.name() === "agent-packs") return;
+  }
   const authenticated = await authenticatedEnvironments();
   if (authenticated.length < 2) return;
   const path = [];
@@ -7733,6 +7783,7 @@ registerContextCommand(program);
 registerResourcesCommand(program);
 registerWorkspacesCommand(program);
 registerInstallationsCommand(program);
+registerAgentPacksCommand(program);
 var helpCommands = [program];
 for (const command of helpCommands) {
   command.configureHelp({

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@topolo/cli",
   "packageManager": "pnpm@10.17.1",
-  "version": "0.12.33",
-  "topoloPublishedVersion": "0.12.33",
+  "version": "0.13.0",
+  "topoloPublishedVersion": "0.13.0",
   "description": "Public command-line interface for Topolo customer organizations, developers, and agents.",
   "license": "UNLICENSED",
   "author": "Topolo",
@@ -14,7 +14,8 @@
   "files": [
     "dist",
     "skills",
-    "postinstall.mjs"
+    "postinstall.mjs",
+    "agent-packs"
   ],
   "scripts": {
     "postinstall": "node postinstall.mjs",
@@ -24,7 +25,9 @@
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "coverage": "vitest run --coverage"
+    "coverage": "pnpm run coverage:node && pnpm run coverage:adapter",
+    "coverage:node": "vitest run --coverage",
+    "coverage:adapter": "python3 -m venv node_modules/.cache/agent-pack-test && node_modules/.cache/agent-pack-test/bin/python -m pip install --disable-pip-version-check --quiet --timeout 15 --retries 0 -r agent-packs/requirements-test.txt && PYTHONPATH=agent-packs/src COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage run --branch --source=topolo_agent_pack.topolo -m unittest discover -s agent-packs/tests && COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage report --fail-under=100"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",