retell-sync-cli 3.8.1 → 3.9.0

package/dist/cli.js

@@ -134762,8 +134762,12 @@ var retell = new retell_sdk_default({
 });
 async function getRemoteState({
   draft = false,
-  agentIds = null
+  agentIds = null,
+  version: version2
 } = {}) {
+  if (version2 != null && agentIds) {
+    return getRemoteStateByVersion(agentIds, version2);
+  }
   const [allVoiceAgents, allChatAgents, llms, conversationFlows] = await Promise.all([
     retellPagination((opts) => retell.agent.list(opts), "agent_id"),
     retellPagination((opts) => retell.chatAgent.list(opts), "agent_id"),
@@ -134784,6 +134788,65 @@ async function getRemoteState({
     conversationFlows
   });
 }
+async function getRemoteStateByVersion(agentIds, version2) {
+  const results = await Promise.all(agentIds.map(async (id2) => {
+    try {
+      const agent = await retell.agent.retrieve(id2, {
+        query: { version: version2 }
+      });
+      return { type: "voice", agent };
+    } catch {
+      try {
+        const agent = await retell.chatAgent.retrieve(id2, {
+          query: { version: version2 }
+        });
+        return { type: "chat", agent };
+      } catch {
+        throw new Error(`Agent ${id2} not found at version ${version2}. ` + `Use 'retell.agent.getVersions(id)' to see available versions.`);
+      }
+    }
+  }));
+  const voiceAgents = [];
+  const chatAgents = [];
+  for (const result of results) {
+    if (result.type === "voice") {
+      voiceAgents.push(result.agent);
+    } else {
+      chatAgents.push(result.agent);
+    }
+  }
+  const llmIds = new Set;
+  const llmVersions = new Map;
+  const flowIds = new Set;
+  const flowVersions = new Map;
+  for (const agent of [...voiceAgents, ...chatAgents]) {
+    if (agent.response_engine.type === "retell-llm") {
+      llmIds.add(agent.response_engine.llm_id);
+      if (agent.response_engine.version != null) {
+        llmVersions.set(agent.response_engine.llm_id, agent.response_engine.version);
+      }
+    } else if (agent.response_engine.type === "conversation-flow") {
+      flowIds.add(agent.response_engine.conversation_flow_id);
+      if (agent.response_engine.version != null) {
+        flowVersions.set(agent.response_engine.conversation_flow_id, agent.response_engine.version);
+      }
+    }
+  }
+  const [llms, conversationFlows] = await Promise.all([
+    Promise.all([...llmIds].map((id2) => retell.llm.retrieve(id2, {
+      query: { version: llmVersions.get(id2) }
+    }))),
+    Promise.all([...flowIds].map((id2) => retell.conversationFlow.retrieve(id2, {
+      query: { version: flowVersions.get(id2) }
+    })))
+  ]);
+  return canonicalizeFromApi({
+    voiceAgents,
+    chatAgents,
+    llms,
+    conversationFlows
+  });
+}
 function canonicalizeFromApi({
   voiceAgents: voiceAgentsList,
   chatAgents: chatAgentsList,
@@ -135760,16 +135823,36 @@ async function resolveAgentIds(args, { all = false, select = false } = {}) {
 var {$: $10 } = globalThis.Bun;
 async function pullCommand(agentIdArgs, opts, cmd) {
   const globalOpts = cmd.optsWithGlobals();
+  let version2;
+  if (opts.version != null) {
+    version2 = parseInt(opts.version, 10);
+    if (Number.isNaN(version2) || version2 < 0) {
+      console.log(source_default.red("Error: --version must be a non-negative integer"));
+      process.exitCode = 1;
+      return;
+    }
+  }
+  if (version2 != null && opts.all) {
+    console.log(source_default.red("Error: --version cannot be used with --all (must specify agent IDs)"));
+    process.exitCode = 1;
+    return;
+  }
   try {
     const agentIds = await resolveAgentIds(agentIdArgs, {
       all: opts.all,
       select: opts.select
     });
+    if (version2 != null && !agentIds) {
+      console.log(source_default.red("Error: --version requires specific agent IDs"));
+      process.exitCode = 1;
+      return;
+    }
     await pull({
       agentsDir: globalOpts.agentsDir,
       configFormat: globalOpts.configFormat,
       agentIds,
       yes: opts.yes,
+      version: version2,
       tests: opts.tests ?? true
     });
   } catch (err) {
@@ -135785,10 +135868,12 @@ async function pull({
   configFormat = DEFAULT_CONFIG_FORMAT,
   agentIds = null,
   yes = false,
+  version: version2,
   tests = true
 } = {}) {
   const scopeLabel = agentIds ? `${agentIds.length} agent(s)` : "all agents";
-  console.log(source_default.bold(`Pulling ${scopeLabel} from Retell...`));
+  const versionLabel = version2 != null ? ` (version ${version2})` : "";
+  console.log(source_default.bold(`Pulling ${scopeLabel}${versionLabel} from Retell...`));
   if (!yes) {
     const { stdout } = await $10`git status --porcelain -- ${agentsDir}`.nothrow().quiet();
     const hasChanges = stdout.toString().trim().length > 0;
@@ -135805,7 +135890,7 @@ async function pull({
     }
   }
   const spinner = createSpinner("Fetching from Retell API...");
-  const remoteState = await getRemoteState({ draft: true, agentIds });
+  const remoteState = await getRemoteState({ draft: true, agentIds, version: version2 });
   const totalAgents = remoteState.voiceAgents.length + remoteState.chatAgents.length;
   spinner.stop(source_default.dim(`${pluralize("agent", totalAgents, true)} (${remoteState.voiceAgents.length} voice, ${remoteState.chatAgents.length} chat), ${pluralize("LLM", remoteState.llms.length, true)}, ${pluralize("flow", remoteState.conversationFlows.length, true)}`));
   const writeSpinner = createSpinner("Writing files...");
@@ -136523,7 +136608,7 @@ async function updatePhoneNumberVersions(publishedAgentIds, agentNames) {
 // src/cli.ts
 var program2 = new Command;
 program2.name("retell").description("Retell AI agent management CLI").option("-w, --agents-dir <dir>", "Directory for agent files", DEFAULT_AGENTS_DIR).option("-f, --config-format <format>", `Config file format (${CONFIG_FORMATS.join(", ")})`, DEFAULT_CONFIG_FORMAT);
-program2.command("pull [agentIds...]").description("Pull agents from Retell API (always pulls latest draft state)").option("-a, --all", "Pull all agents in the account").option("-s, --select", "Force interactive agent selection").option("-y, --yes", "Skip confirmation prompts").option("--no-tests", "Skip pulling test case definitions").action(pullCommand);
+program2.command("pull [agentIds...]").description("Pull agents from Retell API (pulls latest draft state by default)").option("-a, --all", "Pull all agents in the account").option("-s, --select", "Force interactive agent selection").option("-y, --yes", "Skip confirmation prompts").option("-v, --version <number>", "Pull a specific version (requires agent IDs)").option("--no-tests", "Skip pulling test case definitions").action(pullCommand);
 program2.command("deploy [agentIds...]").description("Deploy local changes to Retell draft").option("-a, --all", "Deploy all agents in the account").option("-s, --select", "Force interactive agent selection").option("-n, --dry-run", "Show changes without applying").option("-v, --verbose", "Show full diff details (use with --dry-run)").option("-q, --quiet", "Output only affected agent IDs (for piping)").action(deployCommand);
 program2.command("publish [agentIds...]").description("Publish agents with unpublished draft changes").option("-a, --all", "Publish all agents in the account").option("-s, --select", "Force interactive agent selection").option("-n, --dry-run", "Show what would be published without publishing").option("-q, --quiet", "Output only published agent IDs (for piping)").action(publishCommand);
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retell-sync-cli",
-  "version": "3.8.1",
+  "version": "3.9.0",
   "description": "CLI tool for syncing Retell AI agents between local filesystem and API",
   "keywords": [
     "agents",