@withone/cli 2.0.0 → 2.1.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

@@ -3580,7 +3580,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 +3600,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 +3646,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 +3676,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 +3844,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 +3933,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 +11429,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 +13179,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.1.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: