@withone/cli 2.0.0 → 2.2.0

package/README.md

@@ -269,6 +269,7 @@ one actions find shopify "list products" -t knowledge
 - **`--task`** describes the whole job in one line, in general terms, which helps choose between similar actions.
 - **`-t knowledge`** searches the catalog for writing code and building flows and relays, which includes the platform's own (passthrough) endpoints; the default is the catalog for running actions now.
 - **`--ai-model`** names the model running the CLI (e.g. `claude-sonnet-5`), for tuning documentation per model later.
+- **`--no-knowledge`** lists the chosen actions (actionId, title, method, path) without fetching their documentation; load it later with `one actions load <actionId>`.
 
 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.
 

package/dist/index.js

@@ -1476,6 +1476,7 @@ var PORT_RANGE_START = 49152;
 var PORT_RANGE_END = 65535;
 var MAX_PORT_ATTEMPTS = 5;
 var MAX_KEY_NAME_LENGTH = 120;
+var MAX_GRANT_LENGTH = 4e3;
 var MAX_ERROR_LENGTH = 200;
 var CHECK_MARK = `<div style="width:48px;height:48px;border-radius:50%;background:rgba(34,197,94,0.1);display:flex;align-items:center;justify-content:center;margin:0 auto 16px">
 <svg width="24" height="24" fill="none" stroke="#22c55e" stroke-width="2" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7"/></svg>
@@ -1539,9 +1540,10 @@ function startCallbackServer(expectedState) {
             return;
           }
           const keyName = cleanParam(url.searchParams.get("name"), MAX_KEY_NAME_LENGTH);
+          const grant = cleanParam(url.searchParams.get("grant"), MAX_GRANT_LENGTH);
           res.writeHead(200, { "Content-Type": "text/html" });
           res.end(SUCCESS_HTML);
-          resolveResult({ kind: "key", apiKey, keyName });
+          resolveResult({ kind: "key", apiKey, keyName, grant });
           return;
         }
         const error2 = cleanParam(url.searchParams.get("error"), MAX_ERROR_LENGTH);
@@ -1593,6 +1595,9 @@ function noteWidth() {
   const usable = (typeof columns === "number" && columns > 0 ? columns : 80) - 8;
   return Math.max(usable, 40);
 }
+function grantNoteLines(grant, label) {
+  return grant ? wrapForNote(`${label} ${grant}`).split("\n") : [];
+}
 async function browserLogin(opts) {
   const state = crypto.randomUUID();
   const spin = createSpinner();
@@ -1650,7 +1655,7 @@ ${describeInstallContext(context)}`
     const apiBase = getApiBase();
     const api = new OneApi(outcome.apiKey, apiBase);
     const whoami = await api.whoami();
-    return { apiKey: outcome.apiKey, whoami, keyName: outcome.keyName };
+    return { apiKey: outcome.apiKey, whoami, keyName: outcome.keyName, grant: outcome.grant };
   } catch (err) {
     spin.stop("Authentication failed.");
     if (err instanceof Error && err.message === "timeout") {
@@ -1709,7 +1714,7 @@ async function loginCommand() {
   }
   const result = await browserLogin({ scope: targetScope });
   if (!result) return;
-  const { apiKey, whoami, keyName } = result;
+  const { apiKey, whoami, keyName, grant } = result;
   saveCredentials(apiKey, targetScope, { keyName, whoami });
   const pc16 = (await import("picocolors")).default;
   const env = getEnvFromApiKey(apiKey);
@@ -1724,6 +1729,7 @@ async function loginCommand() {
     `${whoami.user.name} ${pc16.dim(`(${whoami.user.email})`)}`
   ];
   if (keyName) infoLines.push(`${pc16.dim("Key:")} ${keyName}`);
+  infoLines.push(...grantNoteLines(grant, pc16.dim("Access:")));
   if (whoami.organization) infoLines.push(`${pc16.dim("Org:")} ${whoami.organization.name}`);
   if (whoami.project) infoLines.push(`${pc16.dim("Project:")} ${whoami.project.name}`);
   infoLines.push("");
@@ -1780,6 +1786,7 @@ async function nonInteractiveInit(options) {
   const scope = options.global ? "global" : options.project ? "project" : "global";
   let apiKey;
   let keyName;
+  let grant;
   let whoami;
   if (auth === "browser") {
     const result = await browserLogin({ scope });
@@ -1788,6 +1795,7 @@ async function nonInteractiveInit(options) {
     }
     apiKey = result.apiKey;
     keyName = result.keyName;
+    grant = result.grant;
     whoami = result.whoami;
   } else {
     const key = options.apiKey?.trim();
@@ -1834,6 +1842,7 @@ async function nonInteractiveInit(options) {
         env: getEnvFromApiKey(apiKey)
       },
       keyName,
+      grant,
       skillInstalled: installed,
       skillFailed: failed
     });
@@ -1851,6 +1860,7 @@ async function nonInteractiveInit(options) {
   console.log(`  ${pc4.dim("Account:")} ${scopeDisplay} ${pc4.dim("\xB7")} ${envLabel}`);
   console.log(`  ${pc4.dim("User:")}    ${whoami.user.name} ${pc4.dim(`(${whoami.user.email})`)}`);
   if (keyName) console.log(`  ${pc4.dim("Key:")}     ${keyName}`);
+  if (grant) console.log(`  ${pc4.dim("Access:")}  ${grant}`);
   console.log(`  ${pc4.dim("Config:")}  ${tildify(configPath)}`);
   if (installed.length > 0) {
     console.log(`  ${pc4.dim("Skill:")}   ${pc4.green("installed")} ${pc4.dim("\xB7 " + installed.join(", "))}`);
@@ -2046,6 +2056,7 @@ async function handleUpdateKey(statuses, scope) {
   }
   let newKey;
   let keyName;
+  let grant;
   let whoamiResult;
   if (authMethod === "browser") {
     const result = await browserLogin({ scope });
@@ -2055,6 +2066,7 @@ async function handleUpdateKey(statuses, scope) {
     }
     newKey = result.apiKey;
     keyName = result.keyName;
+    grant = result.grant;
     whoamiResult = result.whoami;
   } else {
     p3.note(`Get your API key at:
@@ -2108,7 +2120,8 @@ ${pc4.cyan(getApiKeyUrl())}`, `API Key ${scopeLabel(scope)}`);
     [
       `${scopeDisplay} ${pc4.dim("\xB7")} ${envLabel}`,
       `${whoamiResult.user.name} ${pc4.dim(`(${whoamiResult.user.email})`)}`,
-      ...keyName ? [`${pc4.dim("Key:")} ${keyName}`] : []
+      ...keyName ? [`${pc4.dim("Key:")} ${keyName}`] : [],
+      ...grantNoteLines(grant, pc4.dim("Access:"))
     ].join("\n"),
     "Account"
   );
@@ -2370,7 +2383,8 @@ async function freshSetup(scope, options) {
       [
         `${scopeDisplay} ${pc4.dim("\xB7")} ${envLabel}`,
         `${result.whoami.user.name} ${pc4.dim(`(${result.whoami.user.email})`)}`,
-        ...result.keyName ? [`${pc4.dim("Key:")} ${result.keyName}`] : []
+        ...result.keyName ? [`${pc4.dim("Key:")} ${result.keyName}`] : [],
+        ...grantNoteLines(result.grant, pc4.dim("Access:"))
       ].join("\n"),
       "Account"
     );
@@ -3580,7 +3594,7 @@ function document(action, details, platform, settings) {
     truncated: true
   };
 }
-async function find(requests, task, deps, settings, knowledgeCatalog = false) {
+async function find(requests, task, deps, settings, { knowledgeCatalog = false, knowledge = true } = {}) {
   if (requests.length === 0 || requests.length > FIND_MAX_INTENTS) {
     throw new FindArgsError(`Send between 1 and ${FIND_MAX_INTENTS} platform and intent pairs.`);
   }
@@ -3600,19 +3614,19 @@ async function find(requests, task, deps, settings, knowledgeCatalog = false) {
     if (!reaches(intent.platform)) return { intent, unreachable: true };
     const narrowed = narrow(answers[next++], settings);
     const { answer } = narrowed;
-    const picks = settings.knowledgeAgent ? answer.selected.slice(0, 1) : answer.selected;
+    const picks = knowledge && settings.knowledgeAgent ? answer.selected.slice(0, 1) : answer.selected;
     return {
       intent,
       unreachable: false,
       narrowed,
       picks,
       deferred: [...answer.selected.slice(picks.length), ...answer.alsoSelected ?? []],
-      runnerUpDocumented: !settings.knowledgeAgent && answer.runnerUp !== void 0
+      runnerUpDocumented: knowledge && !settings.knowledgeAgent && answer.runnerUp !== void 0
     };
   });
   const ids = /* @__PURE__ */ new Set();
   for (const plan of plans) {
-    if (plan.unreachable) continue;
+    if (plan.unreachable || !knowledge) continue;
     plan.picks.forEach((a) => ids.add(a.systemId));
     if (plan.runnerUpDocumented && plan.narrowed.answer.runnerUp) ids.add(plan.narrowed.answer.runnerUp.systemId);
   }
@@ -3646,9 +3660,9 @@ async function find(requests, task, deps, settings, knowledgeCatalog = false) {
       };
     }
     const { answer } = plan.narrowed;
-    const selected = [];
+    const selected = knowledge ? [] : plan.picks.map(ref);
     const deferred = [];
-    for (const [index, pick] of plan.picks.entries()) {
+    for (const [index, pick] of (knowledge ? plan.picks : []).entries()) {
       const doc = document(ref(pick), details.get(pick.systemId) ?? new Error("not fetched"), plan.intent.platform, settings);
       if (!admit(doc)) {
         deferred.push(...plan.picks.slice(index).map(ref));
@@ -3676,7 +3690,7 @@ async function find(requests, task, deps, settings, knowledgeCatalog = false) {
       result[index].runnerUp = doc;
     }
   });
-  const documented = result.some((a) => a.selected.length > 0 || a.runnerUp && "knowledge" in a.runnerUp);
+  const documented = result.some((a) => a.selected.some((s) => "knowledge" in s) || a.runnerUp && "knowledge" in a.runnerUp);
   return { answers: result, ...documented ? { guide: closingGuide(settings) } : {} };
 }
 async function load(actionIds, options, deps, settings) {
@@ -3844,7 +3858,9 @@ ${doc.knowledge}`;
     const parts = [`## ${answer.platform}: ${answer.intent}
 
 ${answer.status}`];
-    parts.push(...answer.selected.map(shown));
+    const documented = answer.selected.filter((s) => "knowledge" in s);
+    parts.push(...documented.map(shown));
+    parts.push(...listing("Chosen for this intent", answer.selected.filter((s) => !("knowledge" in s))));
     parts.push(
       ...listing(
         answer.selected.length === 0 ? "Chosen for this intent, documentation left out to keep the answer small" : "Also chosen for this intent, documentation left out to keep the answer small",
@@ -3931,7 +3947,7 @@ async function actionsFindCommand(pairs, options) {
       options.task,
       findDeps(api, connectionKeys, options.cache !== false),
       settings,
-      options.type === "knowledge"
+      { knowledgeCatalog: options.type === "knowledge", knowledge: options.knowledge !== false }
     );
     if (isAgentMode()) {
       json(result);
@@ -11427,6 +11443,7 @@ One call for the whole task: one platform and intent pair per operation, on any
 - **\`--task\`** (optional) is the whole job in one line, **in general terms**: what it does, without names, addresses, IDs, or message text. It helps choose between similar actions.
 - **\`-t knowledge\`** searches the catalog for writing code and building flows and relays, which includes the platform's own (passthrough) endpoints; the default, \`-t execute\`, is the catalog for running actions now. Knowledge-only mode always uses \`knowledge\`.
 - **\`--ai-model\`** (optional) names the model running the CLI (e.g. \`claude-sonnet-5\`); it will be used to tune documentation per model.
+- **\`--no-knowledge\`** (optional) lists the chosen actions without their documentation, when only the actionIds are needed. Load the documentation with \`actions load\` before executing.
 
 In \`--agent\` mode:
 
@@ -13176,7 +13193,7 @@ program.command("platforms").alias("p").description("List available platforms").
   await platformsCommand(options);
 });
 var actions = program.command("actions").alias("a").description("Find, read, and execute platform actions (workflow: find \u2192 execute)");
-actions.command("find <pairs...>").alias("f").description('Find the action for every operation a task needs, across platforms, with its documentation, in one call: one actions find <platform> "<intent>" [<platform> "<intent>" ...] (up to 10 pairs). Each intent names the operation alone ("send an email"), without its data. Large documents come back as a digest; each names the exact `actions load` command for what it left out').option("--task <task>", 'The whole task in one line, in general terms (e.g. "email a report to a contact"): what it does, without names, addresses, IDs or message text. Helps choose between similar actions').option("-t, --type <type>", "execute (default: actions to run now) or knowledge (the catalog for writing code and building flows and relays, with the platform's own endpoints). Knowledge-only mode always uses knowledge").option("--ai-model <model>", "The AI model running the CLI (e.g. claude-sonnet-5), which helps optimize the documentation returned. Optional").option("--no-cache", "Bypass the cache for action documentation and re-fetch it (the fresh response still refreshes the cache)").action(async (pairs, options) => {
+actions.command("find <pairs...>").alias("f").description('Find the action for every operation a task needs, across platforms, with its documentation, in one call: one actions find <platform> "<intent>" [<platform> "<intent>" ...] (up to 10 pairs). Each intent names the operation alone ("send an email"), without its data. Large documents come back as a digest; each names the exact `actions load` command for what it left out').option("--task <task>", 'The whole task in one line, in general terms (e.g. "email a report to a contact"): what it does, without names, addresses, IDs or message text. Helps choose between similar actions').option("-t, --type <type>", "execute (default: actions to run now) or knowledge (the catalog for writing code and building flows and relays, with the platform's own endpoints). Knowledge-only mode always uses knowledge").option("--ai-model <model>", "The AI model running the CLI (e.g. claude-sonnet-5), which helps optimize the documentation returned. Optional").option("--no-cache", "Bypass the cache for action documentation and re-fetch it (the fresh response still refreshes the cache)").option("--no-knowledge", "List the chosen actions (actionId, title, method, path) without their documentation; load it with `one actions load <actionId>`").action(async (pairs, options) => {
   await actionsFindCommand(pairs, options);
 });
 actions.command("load <actionIds...>").alias("l").description("More of an action's documentation (up to 10 actions): the digest by default, --section for one a digest left out, --full for the whole document, --toc for its contents. Also how to read an alternative from a find answer").option("--section <name>", 'Return only the named section(s) \u2014 by heading, id, or alias (e.g. "Response Fields", response, optional). Repeatable or comma-separated', collect, []).option("--full", "Return the whole document instead of the digest").option("--toc", "List every section (id, heading, size) without the document").option("--no-cache", "Bypass the cache and re-fetch from the API (the fresh response still refreshes the cache)").option("--cache-status", "Print cache metadata without fetching").action(async (actionIds, options) => {

package/package.json

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

package/skills/one/SKILL.md

@@ -83,6 +83,7 @@ one --agent actions find <platform> "<intent>" [<platform> "<intent>" ...] --tas
 - **`--task`** (optional) is the whole job in one line, **in general terms**: `"email a weather report to a contact"`, without names, addresses, IDs, or message text. It helps choose between similar actions.
 - **`-t knowledge`** searches the catalog for writing code and building flows and relays (it includes the platform's own passthrough endpoints); the default, `-t execute`, is the catalog for running actions now.
 - **`--ai-model`** (optional): the model you are running as (e.g. `claude-sonnet-5`), used to tune documentation per model.
+- **`--no-knowledge`** (optional): list the chosen actions without their documentation, when you only need the actionIds. Load the documentation with `actions load` before executing.
 - Platform names are lowercase; multi-word names use dashes: `gmail`, `hubspot`, `ship-station`, `google-calendar`.
 
 Each entry of `answers[]` carries: