@withone/cli 2.8.1 → 2.9.1

package/README.md

@@ -24,7 +24,7 @@
   <a href="https://withone.ai/knowledge"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.withone.ai%2Fopen%2Fcount%2Ftools" alt="tools"></a>
 </p>
 
-One gives your AI agent authenticated access to 750+ platforms - Gmail, Slack, Shopify, HubSpot, Stripe, Notion, and everything else - through a single interface. No API keys to juggle, no OAuth flows to build, no request formats to memorize. Connect a platform once, and your agent can search for actions, read the docs, and execute API calls in seconds.
+One gives your AI agent authenticated access to 1000+ platforms - Gmail, Slack, Shopify, HubSpot, Stripe, Notion, and everything else - through a single interface. No API keys to juggle, no OAuth flows to build, no request formats to memorize. Connect a platform once, and your agent can search for actions, read the docs, and execute API calls in seconds.
 
 ## Install
 
@@ -247,7 +247,7 @@ Shows the connection details and asks for confirmation before deleting. Use `--f
 
 ### `one platforms`
 
-Browse all 750+ available platforms.
+Browse all 1000+ available platforms.
 
 ```bash
 one platforms              # all platforms
@@ -274,6 +274,8 @@ one actions find shopify "list products" -t knowledge
 
 Each intent's answer gives the action(s) to use with their docs, any actions also needed beside them, a **substitute** when the model was unsure (use one or the other, never both), and a few alternatives, then says once how to execute. Always read the docs before executing. The access settings from `one config` apply: an action they refuse is never offered.
 
+A platform name no active platform has (`clickup` for `click-up`) is answered with `selector: "unknown_platform"` and a `suggestions` list of the platforms it may have meant, closest first, instead of being searched. Find again with the right name; `one platforms` lists them all.
+
 Large documents come back as a **digest**: request-building sections in full (method/URL, headers, description, enforcement rules, required and optional parameters, sample request, gotchas, error handling), then a notice naming what was left out with the exact command to load it. In knowledge-only mode each pick comes back whole, with how to call it from code.
 
 ### `one actions load <actionId...>`

package/dist/index.js

@@ -1127,7 +1127,7 @@ async function loginCommand() {
   console.log(pc16.cyan("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log(pc16.cyan("  \u2502"));
   console.log(pc16.cyan("  \u2502  The One CLI (`one`) is now installed on this machine. It"));
-  console.log(pc16.cyan("  \u2502  lets you interact with 750+ third-party platforms (Gmail,"));
+  console.log(pc16.cyan("  \u2502  lets you interact with 1000+ third-party platforms (Gmail,"));
   console.log(pc16.cyan("  \u2502  Slack, Shopify, HubSpot, Stripe, GitHub, etc.) through"));
   console.log(pc16.cyan("  \u2502  their APIs. Whenever you need to interact with any"));
   console.log(pc16.cyan("  \u2502  third-party platform or external service, use the `one`"));
@@ -1730,7 +1730,7 @@ function printOnboardingPrompt() {
   console.log(pc3.cyan("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log(pc3.cyan("  \u2502"));
   console.log(pc3.cyan("  \u2502  The One CLI (`one`) is now installed on this machine. It"));
-  console.log(pc3.cyan("  \u2502  lets you interact with 750+ third-party platforms (Gmail,"));
+  console.log(pc3.cyan("  \u2502  lets you interact with 1000+ third-party platforms (Gmail,"));
   console.log(pc3.cyan("  \u2502  Slack, Shopify, HubSpot, Stripe, GitHub, etc.) through"));
   console.log(pc3.cyan("  \u2502  their APIs. Whenever you need to interact with any"));
   console.log(pc3.cyan("  \u2502  third-party platform or external service, use the `one`"));
@@ -1904,7 +1904,7 @@ async function promptConnectIntegrations(apiKey, connParams) {
         label: i.label,
         hint: i.hint
       })),
-      { value: "more", label: "Browse all 750+ platforms" },
+      { value: "more", label: "Browse all 1000+ platforms" },
       { value: "skip", label: "Skip for now", hint: "you can always run one add later" }
     ];
     const message = first ? "Connect your first integration?" : "Connect another?";
@@ -3066,6 +3066,11 @@ function status(answer, narrowed) {
   if (narrowed.replaced) {
     return "The chosen action is not allowed by this CLI, so this is the next allowed candidate: check it fits before using it.";
   }
+  if (answer.selector === "unknown_platform") {
+    const opening = `No active platform is named \`${answer.platform}\`.`;
+    const suggestions = answer.suggestions ?? [];
+    return suggestions.length === 0 ? `${opening} Check the platform name: \`one platforms\` lists them all.` : `${opening} Did you mean ${suggestions.map((s) => `\`${s}\``).join(", ")}? Find again with the platform you meant.`;
+  }
   if (answer.selector === "none_fit" || answer.selected.length === 0) {
     return answer.alternatives.length === 0 ? "No action fits this intent, and nothing close was found. Rephrase it, or check the platform name." : "No action fits this intent. Rephrase it more specifically, or load one of the alternatives.";
   }
@@ -3190,7 +3195,8 @@ async function find(requests, task, deps, settings, { knowledgeCatalog = false,
       selected,
       alsoSelected: [...deferred, ...plan.deferred.map(ref)],
       ...answer.runnerUp ? { runnerUp: ref(answer.runnerUp) } : {},
-      alternatives: answer.alternatives.map(ref)
+      alternatives: answer.alternatives.map(ref),
+      ...answer.suggestions?.length ? { suggestions: answer.suggestions } : {}
     };
   });
   plans.forEach((plan, index) => {
@@ -10819,7 +10825,7 @@ Before using any feature, read its guide section first: \`one guide actions\`, \
 
 ## Features
 
-### 1. Actions \u2014 Execute API calls on 750+ platforms
+### 1. Actions \u2014 Execute API calls on 1000+ platforms
 Find the actions a task needs with their docs, in one call, then execute them. This is the core workflow.
 
 **Quick start:**
@@ -10992,7 +10998,8 @@ In \`--agent\` mode:
 - **\`alsoSelected\`** \u2014 also needed, listed rather than documented to keep the answer small: \`actions load\` them.
 - **\`runnerUp\`** \u2014 only when the model was unsure: a **substitute** for the pick. Use one or the other, **never both**.
 - **\`alternatives\`** \u2014 other candidates, undocumented.
-- **\`status\`** \u2014 why: a confidence, *no action fits* (rephrase the intent by outcome, or check the platform), *the decision model was unavailable* (top search result: check it fits), *not allowed by this CLI* (the next allowed candidate stood in), or *allow none of them* (your access settings block the operation \u2014 rephrasing won't help).
+- **\`suggestions\`** \u2014 only when \`selector\` is \`unknown_platform\`: no active platform has the name you sent, so nothing was answered. These are the platforms you may have meant, closest first (\`clickup\` \u2192 \`click-up\`). Find again with the right one; \`one platforms\` lists every name.
+- **\`status\`** \u2014 why: a confidence, *no active platform is named* (use a \`suggestions\` entry, or check \`one platforms\`), *no action fits* (rephrase the intent by outcome, or check the platform), *the decision model was unavailable* (top search result: check it fits), *not allowed by this CLI* (the next allowed candidate stood in), or *allow none of them* (your access settings block the operation \u2014 rephrasing won't help).
 - **\`guide\`** \u2014 how to execute, stated once for every action.
 - \`truncated: false\` means \`knowledge\` is the whole document; small docs are never trimmed.
 
@@ -12085,7 +12092,7 @@ function buildStep1() {
     nextCommand: "one onboard --step 2",
     message: `# One CLI \u2014 Agent Onboarding
 
-You now have access to the One CLI. It connects you to 750+ platforms
+You now have access to the One CLI. It connects you to 1000+ platforms
 (Gmail, Slack, Stripe, Notion, etc.) \u2014 you'll learn the details shortly.
 
 IMPORTANT: Your only task right now is to send the message below to the
@@ -12095,7 +12102,7 @@ Do not offer demos yet. Just send this message and wait for their reply:
 ---
 
 I just got access to the One CLI \u2014 it connects me to your platforms like
-Gmail, Slack, Stripe, and 750+ others so I can work with them directly.
+Gmail, Slack, Stripe, and 1000+ others so I can work with them directly.
 I'll show you what I can do in a moment.
 
 First, one quick setup step: right now only this conversation knows about
@@ -12124,7 +12131,7 @@ If they declined, skip this section.
 ## One CLI \u2014 Platform Integrations
 
 The One CLI (\`one\`) is installed and configured on this machine. It is a
-command-line tool that gives AI agents the ability to interact with 750+
+command-line tool that gives AI agents the ability to interact with 1000+
 third-party platforms (Gmail, Slack, Shopify, HubSpot, Stripe, GitHub,
 Notion, Salesforce, etc.) through a single, unified interface.
 
@@ -12218,7 +12225,7 @@ function buildStep3(connections) {
 The user can connect any of these popular platforms:
 Gmail, Google Calendar, Slack, Notion, Shopify, Stripe, HubSpot, GitHub,
 Salesforce, QuickBooks, Asana, Jira, Linear, Intercom, Zendesk, Twilio,
-and 750+ more. Run \`one platforms\` for the full list.`);
+and 1000+ more. Run \`one platforms\` for the full list.`);
   sections.push("## Onboarding complete!\n\nYou're all set. Use `one --agent guide` any time you need the full reference.");
   return {
     step: 3,
@@ -12249,7 +12256,7 @@ platform before you can start using actions. Suggest they run:
   one add slack
   one add <any-platform>
 
-Run \`one platforms\` to see all 750+ available platforms.`;
+Run \`one platforms\` to see all 1000+ available platforms.`;
   }
   const header = `## Current State
 
@@ -12965,7 +12972,7 @@ silenceWarningsInAgentMode();
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
-program.name("one").option("--agent", "Machine-readable JSON output (no colors, spinners, or prompts)").description(`One CLI \u2014 Connect AI agents to 750+ platforms through one interface.
+program.name("one").option("--agent", "Machine-readable JSON output (no colors, spinners, or prompts)").description(`One CLI \u2014 Connect AI agents to 1000+ platforms through one interface.
 
   Setup:
     one login                             Authenticate via browser; the consent page records where this CLI is installed
@@ -13041,7 +13048,7 @@ program.name("one").option("--agent", "Machine-readable JSON output (no colors,
         -d '{"to":"j@example.com","subject":"Hello","body":"Hi!","connectionKey":"live::gmail::default::abc123"}'
 
   Platform names are lowercase; multi-word names use dashes (e.g. hubspot, ship-station, google-calendar).
-  Run 'one platforms' to browse all 750+ available platforms.`).version(version);
+  Run 'one platforms' to browse all 1000+ available platforms.`).version(version);
 var updateCheckPromise;
 program.hook("preAction", (thisCommand, actionCommand) => {
   const opts = program.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withone/cli",
-  "version": "2.8.1",
+  "version": "2.9.1",
   "description": "CLI for managing One",
   "type": "module",
   "files": [

package/skills/one/SKILL.md

@@ -20,7 +20,7 @@ description: |
 
 # One CLI
 
-You have access to the One CLI which lets you interact with 750+ third-party platforms through their APIs. Always include the `--agent` flag right after `one` for structured JSON output.
+You have access to the One CLI which lets you interact with 1000+ third-party platforms through their APIs. Always include the `--agent` flag right after `one` for structured JSON output.
 
 If the user wants a separate API key / connections for a specific project (vs. their default), walk them through running `one init` from that project folder and picking the "project" scope — see `references/scoping.md`. For monorepo subprojects (where a parent already has `.git`/`package.json`), have them `mkdir .one` in the subproject first so the config is keyed to that dir, not the monorepo root.
 
@@ -95,7 +95,8 @@ Each entry of `answers[]` carries:
 - `alsoSelected[]` — also needed, listed rather than documented to keep the answer small: `actions load` them.
 - `runnerUp` — only when the model was unsure: a **substitute** for the pick. Use **one or the other, never both**.
 - `alternatives[]` — other candidates, undocumented.
-- `status` — why: a confidence; *no action fits* (rephrase the intent by outcome, or check the platform); *the decision model was unavailable* (the top search result — check it fits); *not allowed by this CLI* (the next allowed candidate stood in); or *allow none of them* (the access settings block the operation — tell the user, rephrasing won't help).
+- `suggestions[]` — only when `selector` is `unknown_platform`: no active platform has the name you sent, so nothing was answered. These are the platforms you may have meant, closest first (`clickup` → `click-up`). Find again with the right one; `one platforms` lists every name.
+- `status` — why: a confidence; *no active platform is named* (use a `suggestions` entry, or check `one platforms`); *no action fits* (rephrase the intent by outcome, or check the platform); *the decision model was unavailable* (the top search result — check it fits); *not allowed by this CLI* (the next allowed candidate stood in); or *allow none of them* (the access settings block the operation — tell the user, rephrasing won't help).
 
 `guide` (once, at the end) says how to execute any of them.