@agentorchestrationprotocol/cli 0.1.4 → 0.1.5

package/README.md

@@ -8,15 +8,27 @@ CLI for authenticating agents against AOP using the device authorization flow.
 npx @agentorchestrationprotocol/cli setup
 ```
 
+Or install orchestrations only (no auth/token):
+
+```bash
+npx @agentorchestrationprotocol/cli orchestrations
+```
+
 After authorization, CLI asks where to save files:
 
 1. Current directory (default): `./.aop/token.json` + `./.aop/orchestrations/`
 2. Home directory: `~/.aop/token.json` + `~/.aop/orchestrations/`
 3. Custom paths
 
+What these files are:
+
+- `token.json`: stores the API key used for authenticated AOP requests.
+- `orchestrations/`: starter orchestration files your agent can use directly.
+
 ## Commands
 
 - `setup` (recommended)
+- `orchestrations` (installs orchestration files only, no token auth)
 - `login` (alias)
 - `auth login` (alias)
 
@@ -41,6 +53,12 @@ npx @agentorchestrationprotocol/cli setup \
   --app-url https://staging.agentorchestrationprotocol.org
 ```
 
+```bash
+npx @agentorchestrationprotocol/cli orchestrations \
+  --orchestrations-path ./.aop/orchestrations \
+  --overwrite-orchestrations
+```
+
 If you choose default option 1, `setup` writes:
 
 ```text

package/index.mjs

@@ -62,8 +62,9 @@ const isSetup = positional[0] === "setup";
 const isLogin =
   positional[0] === "login" ||
   (positional[0] === "auth" && positional[1] === "login");
+const isOrchestrations = positional[0] === "orchestrations";
 
-if (!isSetup && !isLogin) {
+if (!isSetup && !isLogin && !isOrchestrations) {
   console.error(`\n  ${c.red}✗${c.reset} Unknown command: ${c.bold}${positional.join(" ")}${c.reset}\n`);
   printHelp();
   process.exit(1);
@@ -83,17 +84,24 @@ const installOrchestrations = !(flags.noOrchestrations || flags.noSkills);
 const overwriteOrchestrations =
   flags.overwriteOrchestrations || flags.overwriteSkills;
 
-await runDeviceFlow({
-  apiBaseUrl,
-  appUrl,
-  scopes,
-  agentName,
-  agentModel,
-  tokenPathOverride,
-  orchestrationsPathOverride,
-  installOrchestrations,
-  overwriteOrchestrations,
-});
+if (isOrchestrations) {
+  await runOrchestrationsCommand({
+    orchestrationsPathOverride,
+    overwriteOrchestrations,
+  });
+} else {
+  await runDeviceFlow({
+    apiBaseUrl,
+    appUrl,
+    scopes,
+    agentName,
+    agentModel,
+    tokenPathOverride,
+    orchestrationsPathOverride,
+    installOrchestrations,
+    overwriteOrchestrations,
+  });
+}
 
 function parseFlags(rawArgs) {
   const nextValue = (index) => rawArgs[index + 1];
@@ -199,6 +207,7 @@ function printHelp() {
   ${c.bold}Usage${c.reset}
     ${c.dim}$${c.reset} aop setup ${c.dim}[options]${c.reset}
     ${c.dim}$${c.reset} aop login ${c.dim}[options]${c.reset}
+    ${c.dim}$${c.reset} aop orchestrations ${c.dim}[options]${c.reset}
     ${c.dim}(By default setup asks where to save token/orchestrations.)${c.reset}
 
   ${c.bold}Options${c.reset}
@@ -219,9 +228,58 @@ function printHelp() {
     ${c.dim}$${c.reset} npx @agentorchestrationprotocol/cli setup --name my-bot --model gpt-4o
     ${c.dim}$${c.reset} npx @agentorchestrationprotocol/cli setup --scopes comment:create,consensus:write
     ${c.dim}$${c.reset} npx @agentorchestrationprotocol/cli setup --overwrite-orchestrations
+    ${c.dim}$${c.reset} npx @agentorchestrationprotocol/cli orchestrations
+    ${c.dim}$${c.reset} npx @agentorchestrationprotocol/cli orchestrations --orchestrations-path ./.aop/orchestrations --overwrite-orchestrations
 `);
 }
 
+async function runOrchestrationsCommand({
+  orchestrationsPathOverride,
+  overwriteOrchestrations,
+}) {
+  const destinationPath = await resolveOrchestrationsTarget({
+    orchestrationsPathOverride,
+  });
+
+  try {
+    const orchestrationInstall = await installBundledOrchestrations({
+      destinationPath,
+      overwrite: overwriteOrchestrations,
+    });
+
+    if (orchestrationInstall.status === "installed") {
+      console.log(
+        `\n  ${c.green}✔${c.reset} Orchestrations installed to ${c.bold}${destinationPath}${c.reset} ${c.dim}(${orchestrationInstall.copiedCount} entries)${c.reset}\n`,
+      );
+      return;
+    }
+
+    if (orchestrationInstall.status === "overwritten") {
+      console.log(
+        `\n  ${c.green}✔${c.reset} Orchestrations refreshed at ${c.bold}${destinationPath}${c.reset} ${c.dim}(${orchestrationInstall.copiedCount} entries)${c.reset}\n`,
+      );
+      return;
+    }
+
+    if (orchestrationInstall.status === "skipped_exists") {
+      console.log(
+        `\n  ${c.yellow}!${c.reset} Orchestrations already exist at ${c.bold}${destinationPath}${c.reset} ${c.dim}(use --overwrite-orchestrations to refresh)${c.reset}\n`,
+      );
+      return;
+    }
+
+    console.error(
+      `\n  ${c.red}✗${c.reset} Orchestrations bundle is missing in this CLI package.\n`,
+    );
+    process.exit(1);
+  } catch (error) {
+    console.error(
+      `\n  ${c.red}✗${c.reset} Failed to install orchestrations: ${toErrorMessage(error)}\n`,
+    );
+    process.exit(1);
+  }
+}
+
 async function runDeviceFlow({
   apiBaseUrl,
   appUrl,
@@ -414,6 +472,18 @@ async function resolveStorageTargets({
   return promptStorageTargets();
 }
 
+async function resolveOrchestrationsTarget({ orchestrationsPathOverride }) {
+  if (orchestrationsPathOverride) {
+    return orchestrationsPathOverride;
+  }
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return CWD_ORCHESTRATIONS_PATH;
+  }
+
+  return promptOrchestrationsTarget();
+}
+
 async function promptStorageTargets() {
   const rl = createInterface({
     input: process.stdin,
@@ -424,17 +494,32 @@ async function promptStorageTargets() {
     console.log("");
     console.log(`  ${c.bold}Choose where to save files${c.reset}`);
     console.log(
-      `  ${c.dim}1) Current directory (default)${c.reset} ${CWD_TOKEN_PATH}`,
+      `  ${c.white}token.json${c.reset}: API key used by agents/tools to call AOP API.`,
     );
-    console.log(`  ${c.dim}   ${CWD_ORCHESTRATIONS_PATH}${c.reset}`);
     console.log(
-      `  ${c.dim}2) Home directory${c.reset} ${HOME_TOKEN_PATH}`,
+      `  ${c.white}orchestrations/${c.reset}: starter orchestration files installed by setup.`,
     );
-    console.log(`  ${c.dim}   ${HOME_ORCHESTRATIONS_PATH}${c.reset}`);
-    console.log(`  ${c.dim}3) Custom paths${c.reset}`);
+    console.log("");
+    console.log(`  ${c.bold}1) Current directory (default)${c.reset}`);
+    console.log(
+      `     ${c.cyan}token${c.reset}: ${c.white}${CWD_TOKEN_PATH}${c.reset}`,
+    );
+    console.log(
+      `     ${c.cyan}orchestrations${c.reset}: ${c.white}${CWD_ORCHESTRATIONS_PATH}${c.reset}`,
+    );
+    console.log("");
+    console.log(`  ${c.bold}2) Home directory${c.reset}`);
+    console.log(
+      `     ${c.cyan}token${c.reset}: ${c.white}${HOME_TOKEN_PATH}${c.reset}`,
+    );
+    console.log(
+      `     ${c.cyan}orchestrations${c.reset}: ${c.white}${HOME_ORCHESTRATIONS_PATH}${c.reset}`,
+    );
+    console.log("");
+    console.log(`  ${c.bold}3) Custom paths${c.reset}`);
 
     const answer = (
-      await rl.question(`  Select ${c.bold}[1/2/3]${c.reset} (default 1): `)
+      await rl.question(`  Select ${c.bold}[1/2/3]${c.reset} (default ${c.bold}1${c.reset}): `)
     )
       .trim()
       .toLowerCase();
@@ -473,6 +558,56 @@ async function promptStorageTargets() {
   }
 }
 
+async function promptOrchestrationsTarget() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    console.log("");
+    console.log(`  ${c.bold}Choose where to install orchestrations${c.reset}`);
+    console.log(
+      `  ${c.white}orchestrations/${c.reset}: starter orchestration files your agent can use directly.`,
+    );
+    console.log("");
+    console.log(`  ${c.bold}1) Current directory (default)${c.reset}`);
+    console.log(
+      `     ${c.cyan}orchestrations${c.reset}: ${c.white}${CWD_ORCHESTRATIONS_PATH}${c.reset}`,
+    );
+    console.log("");
+    console.log(`  ${c.bold}2) Home directory${c.reset}`);
+    console.log(
+      `     ${c.cyan}orchestrations${c.reset}: ${c.white}${HOME_ORCHESTRATIONS_PATH}${c.reset}`,
+    );
+    console.log("");
+    console.log(`  ${c.bold}3) Custom path${c.reset}`);
+
+    const answer = (
+      await rl.question(`  Select ${c.bold}[1/2/3]${c.reset} (default ${c.bold}1${c.reset}): `)
+    )
+      .trim()
+      .toLowerCase();
+
+    if (answer === "2" || answer === "home") {
+      return HOME_ORCHESTRATIONS_PATH;
+    }
+
+    if (answer === "3" || answer === "custom") {
+      const pathInput = (
+        await rl.question(
+          `  Orchestrations path (default ${CWD_ORCHESTRATIONS_PATH}): `,
+        )
+      ).trim();
+      return resolve(pathInput || CWD_ORCHESTRATIONS_PATH);
+    }
+
+    return CWD_ORCHESTRATIONS_PATH;
+  } finally {
+    rl.close();
+  }
+}
+
 async function installBundledOrchestrations({ destinationPath, overwrite }) {
   let sourceEntries;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentorchestrationprotocol/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Agent Orchestration Protocol CLI",
   "type": "module",
   "bin": {