retell-sync-cli 1.1.0 → 2.0.0

package/package.json

@@ -1,30 +1,25 @@
 {
   "name": "retell-sync-cli",
-  "author": "zachsents",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "CLI tool for syncing Retell AI agents between local filesystem and API",
-  "type": "module",
-  "main": "cli.ts",
+  "keywords": [
+    "agents",
+    "ai",
+    "cli",
+    "retell",
+    "sync"
+  ],
+  "author": "zachsents",
   "bin": {
     "retell": "./dist/cli.js"
   },
+  "type": "module",
+  "main": "cli.ts",
   "scripts": {
     "check": "bunx tsc --noEmit && bun fix",
-    "fix": "biome check --write",
+    "fix": "oxlint --type-aware --fix-suggestions && prettier . --write",
     "build": "bun build ./src/cli.ts --target bun --outdir dist"
   },
-  "keywords": [
-    "retell",
-    "ai",
-    "cli",
-    "sync",
-    "agents"
-  ],
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.10",
-    "@types/bun": "latest",
-    "type-fest": "^5.3.1"
-  },
   "dependencies": {
     "@inquirer/prompts": "^8.1.0",
     "boxen": "^8.0.1",
@@ -39,5 +34,12 @@
     "retell-sdk": "^4.66.0",
     "yaml": "^2.8.2",
     "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "oxlint": "^1.35.0",
+    "oxlint-tsgolint": "^0.10.0",
+    "prettier-plugin-jsdoc": "^1.8.0",
+    "type-fest": "^5.3.1"
   }
 }

package/biome.json

@@ -1,47 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.3.10/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "ignoreUnknown": true,
-    "includes": ["**", "!test/*.json"]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "suspicious": {
-        "noArrayIndexKey": "off",
-        "noConfusingVoidType": "off"
-      },
-      "style": {
-        "noNonNullAssertion": "off"
-      },
-      "complexity": {
-        "noCommaOperator": "off"
-      }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "asNeeded"
-    }
-  },
-  "assist": {
-    "enabled": true,
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  }
-}

package/test/getBaselineState.test.ts

@@ -1,450 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test"
-import fs from "node:fs/promises"
-import os from "node:os"
-import path from "node:path"
-import { $ } from "bun"
-import { getBaselineState } from "../src/lib/agents"
-
-describe("getBaselineState", () => {
-  let tmpDir: string
-  let originalCwd: string
-
-  beforeEach(async () => {
-    originalCwd = process.cwd()
-    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "retell-sync-test-"))
-    process.chdir(tmpDir)
-
-    // Initialize git repo
-    await $`git init`.quiet()
-    await $`git config user.email "test@test.com"`.quiet()
-    await $`git config user.name "Test"`.quiet()
-  })
-
-  afterEach(async () => {
-    process.chdir(originalCwd)
-    await fs.rm(tmpDir, { recursive: true, force: true })
-  })
-
-  test("hydrates retell-llm agent with file placeholders resolved", async () => {
-    const agentsDir = "agents"
-    const agentDir = `${agentsDir}/test_llm_agent_abc123`
-
-    // Create agent files
-    await fs.mkdir(path.join(tmpDir, agentDir), { recursive: true })
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_abc123456789",
-        version: 1,
-        responseEngineVersion: 1,
-      }),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "config.json"),
-      JSON.stringify(
-        {
-          channel: "voice",
-          agent_name: "Test LLM Agent",
-          response_engine: {
-            type: "retell-llm",
-            llm_id: "llm_test123",
-            version: 1,
-          },
-          voice_id: "11labs-Chloe",
-        },
-        null,
-        2,
-      ),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "llm.json"),
-      JSON.stringify(
-        {
-          model: "gpt-4.1",
-          general_prompt: "file://./general_prompt.md",
-          begin_message: "Hello!",
-        },
-        null,
-        2,
-      ),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "general_prompt.md"),
-      `---
-some_meta: value
----
-
-You are a helpful assistant.
-
-Be friendly and professional.
-`,
-    )
-
-    // Commit the files
-    await $`git add .`.quiet()
-    await $`git commit -m "Add test agent"`.quiet()
-    const { stdout } = await $`git rev-parse HEAD`.quiet()
-    const commitHash = stdout.toString().trim()
-
-    // Create .sync.json
-    await Bun.write(
-      path.join(tmpDir, ".sync.json"),
-      JSON.stringify({ baseline: { commitHash } }, null, 2),
-    )
-
-    // Run getBaselineState
-    const result = await getBaselineState({ agentsDir })
-
-    // Verify results
-    expect(result.voiceAgents).toHaveLength(1)
-    expect(result.llms).toHaveLength(1)
-    expect(result.conversationFlows).toHaveLength(0)
-
-    const agent = result.voiceAgents[0]!
-    expect(agent.agent_name).toBe("Test LLM Agent")
-    expect(agent.response_engine.type).toBe("retell-llm")
-    expect(agent.voice_id).toBe("11labs-Chloe")
-
-    const llm = result.llms[0]!
-    expect(llm.model).toBe("gpt-4.1")
-    expect(llm.begin_message).toBe("Hello!")
-    // Verify file placeholder was resolved
-    expect(llm.general_prompt).toContain("You are a helpful assistant.")
-    expect(llm.general_prompt).toContain("Be friendly and professional.")
-    // Frontmatter should be stripped
-    expect(llm.general_prompt).not.toContain("some_meta")
-  })
-
-  test("hydrates conversation-flow agent with nested file placeholders", async () => {
-    const agentsDir = "agents"
-    const agentDir = `${agentsDir}/test_flow_agent_def456`
-
-    // Create agent files
-    await fs.mkdir(path.join(tmpDir, agentDir, "nodes"), { recursive: true })
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_def456789012",
-        version: 2,
-        responseEngineVersion: 2,
-      }),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "config.json"),
-      JSON.stringify(
-        {
-          channel: "voice",
-          agent_name: "Test Flow Agent",
-          response_engine: {
-            type: "conversation-flow",
-            conversation_flow_id: "flow_test456",
-            version: 2,
-          },
-          voice_id: "openai-Alloy",
-        },
-        null,
-        2,
-      ),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "conversation-flow.json"),
-      JSON.stringify(
-        {
-          global_prompt: "file://./global_prompt.md",
-          nodes: [
-            {
-              id: "start-node",
-              name: "Welcome",
-              type: "conversation",
-              instruction: {
-                type: "static_text",
-                text: "Hello, welcome!",
-              },
-              edges: [],
-            },
-            {
-              id: "node-inquiry",
-              name: "Handle Inquiry",
-              type: "conversation",
-              instruction: {
-                type: "prompt",
-                text: "file://./nodes/inquiry_abc123.md",
-              },
-              edges: [],
-            },
-          ],
-        },
-        null,
-        2,
-      ),
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "global_prompt.md"),
-      `---
-version: 1
----
-
-You are a professional receptionist.
-
-Always be polite and helpful.
-`,
-    )
-
-    await Bun.write(
-      path.join(tmpDir, agentDir, "nodes", "inquiry_abc123.md"),
-      `---
-nodeId: "node-inquiry"
-name: "Handle Inquiry"
----
-
-Answer the caller's question to the best of your ability.
-
-If you don't know, offer to transfer them.
-`,
-    )
-
-    // Commit the files
-    await $`git add .`.quiet()
-    await $`git commit -m "Add flow agent"`.quiet()
-    const { stdout } = await $`git rev-parse HEAD`.quiet()
-    const commitHash = stdout.toString().trim()
-
-    // Create .sync.json
-    await Bun.write(
-      path.join(tmpDir, ".sync.json"),
-      JSON.stringify({ baseline: { commitHash } }, null, 2),
-    )
-
-    // Run getBaselineState
-    const result = await getBaselineState({ agentsDir })
-
-    // Verify results
-    expect(result.voiceAgents).toHaveLength(1)
-    expect(result.llms).toHaveLength(0)
-    expect(result.conversationFlows).toHaveLength(1)
-
-    const agent = result.voiceAgents[0]!
-    expect(agent.agent_name).toBe("Test Flow Agent")
-    expect(agent.response_engine.type).toBe("conversation-flow")
-
-    const flow = result.conversationFlows[0]!
-    // Global prompt placeholder should be resolved
-    expect(flow.global_prompt).toContain("You are a professional receptionist.")
-    expect(flow.global_prompt).toContain("Always be polite and helpful.")
-    expect(flow.global_prompt).not.toContain("version: 1")
-
-    // Node instruction placeholder should be resolved
-    const inquiryNode = flow.nodes?.find((n) => n.id === "node-inquiry")
-    expect(inquiryNode).toBeDefined()
-    expect(
-      inquiryNode?.type === "conversation" && inquiryNode.instruction.text,
-    ).toContain("Answer the caller's question")
-    expect(
-      inquiryNode?.type === "conversation" && inquiryNode.instruction.text,
-    ).toContain("offer to transfer them")
-    // Frontmatter should be stripped from node
-    expect(
-      inquiryNode?.type === "conversation" && inquiryNode.instruction.text,
-    ).not.toContain("nodeId")
-  })
-
-  test("handles multiple agents of different types", async () => {
-    const agentsDir = "agents"
-
-    // Create LLM agent
-    const llmAgentDir = `${agentsDir}/llm_agent_111111`
-    await fs.mkdir(path.join(tmpDir, llmAgentDir), { recursive: true })
-    await Bun.write(
-      path.join(tmpDir, llmAgentDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_llm_1",
-        version: 1,
-        responseEngineVersion: 1,
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, llmAgentDir, "config.json"),
-      JSON.stringify({
-        agent_name: "LLM Agent",
-        response_engine: { type: "retell-llm", llm_id: "llm_1", version: 1 },
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, llmAgentDir, "llm.json"),
-      JSON.stringify({ model: "gpt-4" }),
-    )
-
-    // Create Flow agent
-    const flowAgentDir = `${agentsDir}/flow_agent_222222`
-    await fs.mkdir(path.join(tmpDir, flowAgentDir), { recursive: true })
-    await Bun.write(
-      path.join(tmpDir, flowAgentDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_flow_1",
-        version: 1,
-        responseEngineVersion: 1,
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, flowAgentDir, "config.json"),
-      JSON.stringify({
-        agent_name: "Flow Agent",
-        response_engine: {
-          type: "conversation-flow",
-          conversation_flow_id: "flow_1",
-          version: 1,
-        },
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, flowAgentDir, "conversation-flow.json"),
-      JSON.stringify({ nodes: [] }),
-    )
-
-    // Commit
-    await $`git add .`.quiet()
-    await $`git commit -m "Add multiple agents"`.quiet()
-    const { stdout } = await $`git rev-parse HEAD`.quiet()
-    const commitHash = stdout.toString().trim()
-
-    await Bun.write(
-      path.join(tmpDir, ".sync.json"),
-      JSON.stringify({ baseline: { commitHash } }),
-    )
-
-    const result = await getBaselineState({ agentsDir })
-
-    expect(result.voiceAgents).toHaveLength(2)
-    expect(result.llms).toHaveLength(1)
-    expect(result.conversationFlows).toHaveLength(1)
-
-    const agentNames = result.voiceAgents.map((a) => a.agent_name).sort()
-    expect(agentNames).toEqual(["Flow Agent", "LLM Agent"])
-  })
-
-  test("reads from specific git commit, not working directory", async () => {
-    const agentsDir = "agents"
-    const agentDir = `${agentsDir}/versioned_agent_xyz789`
-
-    // Create initial version
-    await fs.mkdir(path.join(tmpDir, agentDir), { recursive: true })
-    await Bun.write(
-      path.join(tmpDir, agentDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_versioned",
-        version: 1,
-        responseEngineVersion: 1,
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, agentDir, "config.json"),
-      JSON.stringify({
-        agent_name: "Original Name",
-        response_engine: { type: "retell-llm", llm_id: "llm_v", version: 1 },
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, agentDir, "llm.json"),
-      JSON.stringify({ model: "gpt-3.5" }),
-    )
-
-    // Commit v1
-    await $`git add .`.quiet()
-    await $`git commit -m "v1"`.quiet()
-    const { stdout } = await $`git rev-parse HEAD`.quiet()
-    const v1CommitHash = stdout.toString().trim()
-
-    // Modify files (v2 - not committed or committed separately)
-    await Bun.write(
-      path.join(tmpDir, agentDir, "config.json"),
-      JSON.stringify({
-        agent_name: "Updated Name",
-        response_engine: { type: "retell-llm", llm_id: "llm_v", version: 1 },
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, agentDir, "llm.json"),
-      JSON.stringify({ model: "gpt-4" }),
-    )
-    await $`git add .`.quiet()
-    await $`git commit -m "v2"`.quiet()
-
-    // Point .sync.json to v1 commit
-    await Bun.write(
-      path.join(tmpDir, ".sync.json"),
-      JSON.stringify({ baseline: { commitHash: v1CommitHash } }),
-    )
-
-    const result = await getBaselineState({ agentsDir })
-
-    // Should get v1 data, not v2
-    expect(result.voiceAgents[0]!.agent_name).toBe("Original Name")
-    expect(result.llms[0]!.model as string).toBe("gpt-3.5")
-  })
-
-  test("throws error when .sync.json is missing", async () => {
-    const agentsDir = "agents"
-
-    await expect(getBaselineState({ agentsDir })).rejects.toThrow(
-      ".sync.json file not found",
-    )
-  })
-
-  test("skips directories without .agent.json file", async () => {
-    const agentsDir = "agents"
-
-    // Create valid agent
-    const validDir = `${agentsDir}/valid_agent_aaa111`
-    await fs.mkdir(path.join(tmpDir, validDir), { recursive: true })
-    await Bun.write(
-      path.join(tmpDir, validDir, ".agent.json"),
-      JSON.stringify({
-        id: "agent_valid",
-        version: 1,
-        responseEngineVersion: 1,
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, validDir, "config.json"),
-      JSON.stringify({
-        agent_name: "Valid Agent",
-        response_engine: { type: "retell-llm", llm_id: "llm_v", version: 1 },
-      }),
-    )
-    await Bun.write(
-      path.join(tmpDir, validDir, "llm.json"),
-      JSON.stringify({ model: "gpt-4" }),
-    )
-
-    // Create directory without .agent.json (should be skipped)
-    const invalidDir = `${agentsDir}/not_an_agent`
-    await fs.mkdir(path.join(tmpDir, invalidDir), { recursive: true })
-    await Bun.write(
-      path.join(tmpDir, invalidDir, "config.json"),
-      JSON.stringify({ agent_name: "Invalid" }),
-    )
-
-    await $`git add .`.quiet()
-    await $`git commit -m "mixed dirs"`.quiet()
-    const { stdout } = await $`git rev-parse HEAD`.quiet()
-    const commitHash = stdout.toString().trim()
-
-    await Bun.write(
-      path.join(tmpDir, ".sync.json"),
-      JSON.stringify({ baseline: { commitHash } }),
-    )
-
-    const result = await getBaselineState({ agentsDir })
-
-    expect(result.voiceAgents).toHaveLength(1)
-    expect(result.voiceAgents[0]!.agent_name).toBe("Valid Agent")
-  })
-})