@withone/cli 2.8.1 → 2.9.0

package/README.md

@@ -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

@@ -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) => {
@@ -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.
 

package/package.json

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

package/skills/one/SKILL.md

@@ -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.