@adkit/cli 1.13.12 → 1.13.14

package/README.md

@@ -34,7 +34,8 @@ adkit logout                  Remove stored credentials
 
 ```bash
 adkit projects list
-adkit projects use <name>
+adkit projects create --name "Example" --website example.com
+adkit projects use <id>
 adkit projects current
 ```
 

package/dist/cli.js

@@ -1120,16 +1120,29 @@ function unwrapList(data) {
 }
 
 // src/commands/projects.ts
+async function createProject(client, options) {
+  const response = await client.post("/manage/projects", options);
+  if (!isCreateProjectResponse(response)) throw new Error("Unexpected response from AdKit project creation");
+  writeConfig({ selectedProject: response.projectId });
+  return {
+    id: response.projectId,
+    name: response.name,
+    website: response.website,
+    workspaceId: response.workspaceId,
+    current: true
+  };
+}
 async function listProjects(client, options = {}) {
   const qs = queryString({ query: options.query, limit: options.limit });
   const response = await client.get(`/manage/projects${qs}`);
   if (!isProjectsResponse(response)) throw new Error("Unexpected response from AdKit projects");
   const config = readConfig() ?? {};
-  return response.projects.map((project) => mapProjectEntry(project, config.selectedProject));
+  const projects = response.projects.map((project) => mapProjectEntry(project, config.selectedProject));
+  return { projects, workspaces: response.workspaces ?? [] };
 }
 async function useProject(client, projectId) {
-  const projects = await listProjects(client, { limit: "50" });
-  const project = projects.find((entry) => entry.id === projectId);
+  const result = await listProjects(client, { limit: "50" });
+  const project = result.projects.find((entry) => entry.id === projectId);
   if (!project) throw new Error(`Project not found: ${projectId}`);
   writeConfig({ selectedProject: projectId });
 }
@@ -1143,13 +1156,20 @@ function isProjectsResponse(value) {
   if (!("projects" in value)) return false;
   return Array.isArray(value.projects);
 }
+function isCreateProjectResponse(value) {
+  if (!value || typeof value !== "object") return false;
+  if (!("projectId" in value) || typeof value.projectId !== "string") return false;
+  if (!("name" in value) || typeof value.name !== "string") return false;
+  return "website" in value && typeof value.website === "string";
+}
 function mapProjectEntry(project, selectedProject) {
   const entry = {
     id: project.projectId,
     name: project.name,
     website: project.website,
     role: project.role,
-    platforms: project.platforms
+    platforms: project.platforms,
+    workspaceId: project.workspaceId
   };
   if (selectedProject === project.projectId) entry.current = true;
   return entry;
@@ -4609,7 +4629,7 @@ Commands:
   library       Browse ads and advertisers
   studio        Create and manage Studio ads
   manage        Manage ad platforms and drafts
-  projects      Manage projects (list, use, current)
+  projects      Manage projects (list, create, use, current)
 
 Advanced:
   logout        Remove stored API key
@@ -6096,22 +6116,34 @@ ${FLAG.data}
   --campaign-ids <ids> Comma-separated campaign IDs for filtered reads
   --campaign <id>     Parent campaign ID (create only)
   --name <name>       Ad group name
-  --status <s>        active, paused
+  --status <s>        active, paused (create default: paused)
   --budget-daily <n>  Daily budget in account currency
   --budget-lifetime <n> Lifetime budget in account currency
   --start-date <value> Optional TikTok schedule datetime; omit to start now
   --end-date <value>   Optional TikTok schedule datetime; required with lifetime budget
   --billing-event <s> cpc, cpm, ocpm
   --bid-strategy <s>  bid_type_no_bid, bid_type_custom, bid_type_max_conversion
-  --optimization <s>  click, convert, lead_generation, video_view, reach
+  --optimization <s>  click, convert, lead_generation, video_view, reach, value
   --bid-amount <n>    Custom bid in account currency; conversion/OCPM maps to cost per conversion
   --event-type <s>    purchase, add_to_cart, view_content, complete_registration, lead, submit_form
   --pixel <id>        Pixel ID; falls back to account default pixel when conversion is used
   --placement <ids>   Override TikTok placement IDs (publish default: PLACEMENT_TIKTOK)
 
+Value Optimization (website):
+  --optimization value bids on purchase value. It needs --event-type purchase plus a pixel (--pixel, or the account default), and rejects --bid-strategy, --bid-amount, and any --billing-event other than ocpm.
+  targetRoas has no flag \u2014 send it with --data. targetRoas set = Minimum ROAS (0.01-1000, where 1.5 = 150%); targetRoas omitted = Highest Value.
+  update only retunes targetRoas on an ad group that already uses Value Optimization. TikTok cannot move an ordinary ad group onto it \u2014 create a new ad group instead.
+  TikTok checks account and pixel eligibility, so a valid payload can still be rejected at publish.
+
 Examples:
   adkit manage tiktok ad-groups create --campaign 1770 --name "US Broad" --budget-daily 50 --billing-event cpc --optimization click
-  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"startDate":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'`.trim(),
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"startDate":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'
+  # Highest Value
+  adkit manage tiktok ad-groups create --campaign 1770 --name "Highest value" --budget-daily 50 --optimization value --event-type purchase
+  # Minimum ROAS 1.5x
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Min ROAS 1.5x","budget":{"daily":50},"optimization":"value","targetRoas":1.5,"conversion":{"eventType":"purchase"}}]}'
+  # Retune the ROAS target on an existing Value Optimization ad group
+  adkit manage tiktok ad-groups update 1770000000000000000 --data '{"targetRoas":2}'`.trim(),
   "tiktok ads": `adkit manage tiktok ads \u2014 TikTok video ads
 
   list                List ads
@@ -6719,15 +6751,24 @@ Examples:
   projects: `adkit projects \u2014 Manage projects
 
   list                List accessible projects
+  create              Create a project and make it active
   use <id>            Switch active project
   current             Show active project
 
 Flags:
   --query <text>      Filter projects by name or website
   --limit <n>         Max results (default: 20, max: 50)
+  --name <text>       Project or business name (create)
+  --website <url>     Project website URL or domain (create)
+  --workspace <id>    Target workspace ID (create)
+  --description <t>  Optional business description (create)
+  --industry <text>   Optional business industry (create)
+  --category <text>   Optional business category (create)
+  --tags <a,b>        Optional comma-separated tags (create)
 
 Examples:
   adkit projects list
+  adkit projects create --name "Acme" --website acme.com
   adkit projects use proj_abc123`.trim()
 };
 var STUDIO_GENERATE_HELP_FULL = `adkit studio generate \u2014 Create ad images with AI
@@ -8693,13 +8734,18 @@ ${pageInfo}`);
         case void 0: {
           const query = typeof flags.query === "string" ? flags.query : void 0;
           const limit = typeof flags.limit === "string" ? flags.limit : void 0;
-          const projects = await listProjects(client, { query, limit });
-          if (projects.length === 0) console.log("No projects found.");
+          const result = await listProjects(client, { query, limit });
+          if (wantsJson(flags)) printResult(result, flags);
           else {
-            for (const p of projects) {
+            if (result.projects.length === 0) console.log("No projects found.");
+            for (const p of result.projects) {
               const marker = p.current ? "* " : "  ";
               console.log(`${marker}${p.name} (${p.id})`);
             }
+            if (result.workspaces.length > 0) {
+              console.log("\nWorkspaces:");
+              for (const workspace of result.workspaces) console.log(`  ${workspace.name} (${workspace.workspaceId})`);
+            }
           }
           break;
         }
@@ -8709,6 +8755,27 @@ ${pageInfo}`);
           else console.log(`Active project: ${project.id}`);
           break;
         }
+        case "create": {
+          const name = requireFlag(flags, "name", 'Run: adkit projects create --name "Acme" --website acme.com');
+          const website = requireFlag(flags, "website", 'Run: adkit projects create --name "Acme" --website acme.com');
+          const descriptionValues = collectFlagValues(flags, "description");
+          const description = descriptionValues.length > 0 ? descriptionValues.join(" ") : void 0;
+          const tagsFlag = typeof flags.tags === "string" ? flags.tags : void 0;
+          const tagParts = tagsFlag ? tagsFlag.split(",") : [];
+          const tags = tagParts.map((tag) => tag.trim()).filter(Boolean);
+          const project = await createProject(client, {
+            name,
+            website,
+            description,
+            industry: typeof flags.industry === "string" ? flags.industry : void 0,
+            category: typeof flags.category === "string" ? flags.category : void 0,
+            tags: tags.length > 0 ? tags : void 0,
+            workspaceId: typeof flags.workspace === "string" ? flags.workspace : void 0
+          });
+          if (wantsJson(flags)) printResult(project, flags);
+          else console.log(`Created and selected project: ${project.name} (${project.id})`);
+          break;
+        }
         case "use": {
           const projectId = args[2];
           if (!projectId) throw new CliError("MISSING_ARGUMENT", "Missing required argument: `<project-id>`", "Run: adkit projects use <project-id>");
@@ -8717,7 +8784,7 @@ ${pageInfo}`);
           break;
         }
         default:
-          throw new CliError("UNKNOWN_COMMAND", `Unknown action: projects ${action}`, "Available: list, use, current");
+          throw new CliError("UNKNOWN_COMMAND", `Unknown action: projects ${action}`, "Available: list, create, use, current");
       }
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.12",
+  "version": "1.13.14",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",
@@ -18,11 +18,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/adkit/adkit-monorepo.git",
-    "directory": "packages/cli"
-  },
+  "homepage": "https://adkit.so",
   "type": "module",
   "bin": {
     "adkit": "dist/cli.js"