@actionway/cli-dev 0.0.0-dev.38532746006.a574f5d68a15 → 0.0.0-dev.39573884835.24133c7753db

package/assets/skill/actionway/SKILL.md

@@ -99,6 +99,7 @@ Right after a successful `actionway init`, run `actionway account wallet` once a
 - Route from the references first. Once the user picks a variant (or exactly one fits, or they already named a tool, model, or price tier), run `actionway tools inspect <tool_ref>` on that one choice before calling. Inspect is the authority for the current input Schema, variants, effects, guidance, and Actionway USD price; if it disagrees with the reference, follow Inspect and tell the user the updated price before proceeding.
 - When you had to fall back to `actionway tools search "<natural-language intent>"`, use its filters only when the task supplies real constraints, and inspect at most three of the supported candidates — include the cheapest and the highest-quality — then present those options neutrally and let the user choose before any call — never recommend one for them.
 - `actionway search` is the Web Search business capability. Capability discovery is always `actionway tools search`.
+- For Web Search through Actionway, use `actionway search "search terms" --k 5`. Omit `--provider` for the existing automatic routing; pin a provider only for an explicit provider-specific requirement. Legacy `--query="search terms"` still works; never combine it with positional search terms. Enum flags accept plain values such as `--freshness pw` and `--resource-type image`; extra JSON quoting is unnecessary (old JSON-quoted values still work). This syntax does not change the host-search, pricing, or confirmation rules above.
 - Use a high-frequency typed command only when `actionway --help` exposes an exact fit. Read `actionway <command> --help` and, when available, `--print-schema`; typed commands are parameter/file conveniences over the same Tool Call, confirmation, billing, and Job path.
 - When the signed-in user asks to generate, show, copy, or share their invitation, run `actionway account invitation --locale <zh-cn|zh-tw|en|ja>` using the conversation language. Return the server-provided `code`, `url`, and `message`; do not invent reward amounts or rewrite promotion terms. The first request creates one permanent code and later requests return that same code.
 - For other account questions, use only the requested read command: `actionway account usage`, `actionway account wallet`, or `actionway account transactions`.

package/assets/skill/actionway-dev/SKILL.md

@@ -22,6 +22,8 @@ Use only the `actionway-dev` executable. Never substitute the stable `actionway`
 
 Use typed commands only when `actionway-dev --help` exposes an exact fit. Read command help and `--print-schema`, then run `--dry-run` before a real typed call.
 
+For Web Search, use `actionway-dev search "search terms" --k 5`; omit `--provider` for automatic routing unless testing a specific provider. Legacy `--query="search terms"` is still accepted, but do not combine it with positional search terms. Enum flags accept plain values such as `--freshness pw`; old JSON-quoted enum values remain supported. Capability discovery is `actionway-dev tools search`, not `actionway-dev search`.
+
 ## Boundaries
 
 - Treat the development Gateway as the authority for Schema, price, confirmation, and results.

package/dist/index.js

@@ -9236,6 +9236,7 @@ function isStringOrStringArray(prop) {
   return hasString && hasStringArray;
 }
 function usesJsonEncoding(prop) {
+  if (extractEnumValues(prop)) return false;
   if (isStringOrStringArray(prop)) return false;
   if (prop.type === void 0 || prop.type === "object") return true;
   if (prop.type !== "array") return false;
@@ -9917,6 +9918,18 @@ function emitOutcome(outcome) {
 function registerOption(cmd, f) {
   const flagName = `--${f.flag}`;
   const summary = describeFlag(f);
+  const choices = f.enum;
+  if (choices) {
+    cmd.option(`${flagName} <value>`, summary, (raw) => {
+      if (choices.includes(raw)) return raw;
+      if (raw.trimStart().startsWith('"')) {
+        const value = parseJsonFlag(flagName, raw);
+        if (typeof value === "string" && choices.includes(value)) return value;
+      }
+      throw new Error(`${flagName} must be one of: ${choices.join(", ")}`);
+    });
+    return;
+  }
   if (f.scalarOrArray === true) {
     cmd.option(`${flagName} <value>`, `${summary}; repeatable`, (v, prev) => {
       if (prev === void 0) return v;
@@ -9962,12 +9975,17 @@ function describeFlag(f) {
 function registerActionCommand(program2, spec, deps) {
   const flags = [...deriveFlags(spec.schema), ...spec.extraFlags ?? []];
   const cmd = program2.command(spec.name).description(spec.summary);
+  if (spec.positionalFlag) {
+    cmd.argument(`[${spec.positionalFlag}]`, `alternative to --${spec.positionalFlag}; use only one form`);
+    cmd.allowExcessArguments(false).exitOverride();
+  }
   for (const f of flags) registerOption(cmd, f);
   cmd.option("--print-schema", "emit JSON schema for this verb's single-call shape and exit");
   cmd.option("--dry-run", "validate input and show the request projection without submitting work");
   if (spec.helpText) cmd.addHelpText("after", `
 ${spec.helpText}`);
-  cmd.action(async (rawOpts) => {
+  cmd.action(async () => {
+    const rawOpts = cmd.opts();
     if (rawOpts.printSchema === true) {
       process.stdout.write(
         `${JSON.stringify(renderPrintSchema({ verb: spec.name, summary: spec.summary, flags }), null, 2)}
@@ -9976,6 +9994,13 @@ ${spec.helpText}`);
       process.exit(0);
     }
     const params = collectParams(flags, rawOpts);
+    if (spec.positionalFlag && cmd.args[0] !== void 0) {
+      const flag = flags.find((candidate) => candidate.flag === spec.positionalFlag);
+      if (params[flag.jsonName] !== void 0) {
+        throw new Error(`Use either positional ${spec.positionalFlag} or --${spec.positionalFlag}, not both`);
+      }
+      params[flag.jsonName] = cmd.args[0];
+    }
     const outcome = await executeAction(spec, params, { dryRun: rawOpts.dryRun === true }, deps);
     emitOutcome(outcome);
   });
@@ -10903,7 +10928,7 @@ async function readImage(path, extras) {
 async function prepareSearch(params) {
   const provider = String(params.provider ?? "auto");
   const query = typeof params.query === "string" ? params.query : "";
-  if (provider !== "baidu-image" && !query.trim()) throw new CliError("E_SCHEMA", "--query is required");
+  if (provider !== "baidu-image" && !query.trim()) throw new CliError("E_SCHEMA", 'A query is required: search "search terms" or search --query="search terms"');
   const k = typeof params.k === "number" ? params.k : 10;
   const extras = await parseExtras(params);
   const freshness = typeof params.freshness === "string" ? params.freshness : void 0;
@@ -11038,16 +11063,26 @@ function normalizeSearch(result, params) {
 }
 var search_default = defineActionCommand({
   name: "search",
+  positionalFlag: "query",
   summary: "Web search with automatic Parallel/Serper routing or an explicit provider.",
   helpText: [
+    'Usage: actionway search "search terms" [options]',
+    'Legacy --query="search terms" is still supported; do not combine the two query forms.',
+    "Enums use plain values, e.g. --freshness pw; legacy JSON-quoted values are still accepted.",
+    "",
     "`--provider` is optional; omitted or auto uses Parallel Fast with Serper fallback on retryable failures.",
     "Explicit baidu, baidu-image, parallel, serper, tavily, and brave keep their provider-specific behavior.",
     "For Baidu image/video discovery, use `--provider=baidu --resource-type=image|video`.",
     "For Baidu similar-image search, use `--provider=baidu-image --image-file=<jpg|png>`.",
     "For URL fetch (not a query), use `actionway fetch` instead.",
     "",
-    "Example (stdin):",
-    '  cat <<EOF | actionway search --query="cats" --provider=tavily --params-file=-',
+    "Examples:",
+    '  actionway search "latest AI news" --k 5',
+    '  actionway search "latest AI news" --freshness pw',
+    '  actionway search --query="latest AI news" --k 5',
+    "",
+    "Advanced provider-specific extras (stdin):",
+    '  cat <<EOF | actionway search "cats" --provider=serper --params-file=-',
     '  {"safe":"strict"}',
     "  EOF"
   ].join("\n"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actionway/cli-dev",
-  "version": "0.0.0-dev.38532746006.a574f5d68a15",
+  "version": "0.0.0-dev.39573884835.24133c7753db",
   "description": "Actionway development CLI for dev.actionway.ai",
   "type": "module",
   "bin": {
@@ -36,9 +36,9 @@
   },
   "actionway": {
     "channel": "development",
-    "source_sha": "a574f5d68a157d54106f5c3fefe4b6545b8c107b",
-    "run_id": 38532746006,
-    "run_url": "https://github.com/PawLogic/actionway/actions/runs/38532746006",
+    "source_sha": "24133c7753db10d5341fa052c5d34ad542b281d5",
+    "run_id": 39573884835,
+    "run_url": "https://github.com/PawLogic/actionway/actions/runs/39573884835",
     "gateway_url": "https://dev.actionway.ai"
   }
 }