@zenalexa/unicli 0.213.1 → 0.215.0

package/dist/types.d.ts

@@ -30,6 +30,32 @@ export interface AdapterArg {
     positional?: boolean;
     choices?: string[];
     description?: string;
+    /**
+     * JSON Schema draft-2020-12 `format:` vocabulary (standard). Validated
+     * fail-closed via ajv's format-assertion vocabulary — a declared `format`
+     * is a hard precondition, not an annotation. See v0.213.3 spec §D5.
+     */
+    format?: "uri" | "uuid" | "date-time" | "email" | "hostname" | "ipv4" | "ipv6" | "regex";
+    /**
+     * Bespoke `x-unicli-kind:` extension — dispatches to the harden-step
+     * validators that have no standard JSON Schema equivalent.
+     *
+     * - `path`          → filesystem sandbox (no traversal, NUL, or CWD/$HOME escape)
+     * - `adapter-ref`   → `<site>/<command>` shaped token
+     * - `selector`      → CSS/XPath-ish; reject `<script` or unescaped backtick
+     * - `shell-safe`    → reject `$` `` ` `` `;` `|` `&` `>` (command-injection vector)
+     * - `id`            → bare resource token (no URL punctuation `?` `#` or
+     *                     `%XX` percent-escapes); pair with `x-unicli-accepts:
+     *                     [url]` on adapters (zhihu, douban, jike…) whose `id`
+     *                     arg also accepts a full URL.
+     */
+    "x-unicli-kind"?: "path" | "adapter-ref" | "selector" | "shell-safe" | "id";
+    /**
+     * Dual-accept fallback — if the primary kind fails validation, try each
+     * listed secondary kind before rejecting. Used by adapters whose `id` arg
+     * legitimately accepts URL slugs (zhihu, twitter) or vice versa.
+     */
+    "x-unicli-accepts"?: Array<"url" | "id">;
 }
 export interface OutputSchema {
     type?: "array" | "object" | "string";
@@ -61,6 +87,12 @@ export interface AdapterCommand {
      * future runtime dispatcher for capability-aware routing.
      */
     minimum_capability?: string;
+    /**
+     * When true, the command accepts `--cursor <next_cursor>` for pagination
+     * and surfaces `meta.pagination.next_cursor` in its envelope. The kernel
+     * uses this flag to add a pagination hint to the success `next_actions`.
+     */
+    paginated?: boolean;
     pipeline?: PipelineStep[];
     adapterArgs?: AdapterArg[];
     func?: (page: IPage, kwargs: Record<string, unknown>) => Promise<unknown>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAiPD,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AA0RD,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.213.1",
+  "version": "0.215.0",
   "description": "The universal interface between AI agents and the world's software",
   "type": "module",
   "main": "dist/main.js",
@@ -118,7 +118,7 @@
     "dev": "tsx src/main.ts",
     "build": "tsc && tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts && npx prettier --write AGENTS.md",
     "postbuild": "node -e \"require('fs').chmodSync('dist/main.js', 0o755)\"",
-    "stats": "tsx scripts/count-stats.ts && tsx scripts/build-readme.ts",
+    "stats": "tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts",
     "stats:check": "tsx scripts/count-consistency.ts",
     "build:agents": "tsx scripts/build-agents.ts",
     "test": "vitest run --project unit",
@@ -157,6 +157,9 @@
     "preversion": "npm run verify",
     "postversion": "npm run build && tsx scripts/release.ts",
     "bench": "tsx bench/report.ts",
+    "bench:quick": "tsx bench/agent/report.ts",
+    "bench:agent": "tsx bench/agent/sdk-runner.ts",
+    "bench:gate": "node scripts/bench/check-ship-gate.js",
     "refs:verify": "tsx scripts/verify-refs.ts",
     "sync:ref": "bash scripts/sync-ref.sh"
   },
@@ -186,27 +189,35 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
     "js-yaml": "^4.1.0",
+    "jsonpath-plus": "^10.4.0",
     "turndown": "^7.2.4",
     "undici": "^8.0.2",
     "ws": "^8.18.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.41",
     "@changesets/cli": "^2.30.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.6.0",
+    "@types/shell-quote": "^1.7.5",
     "@types/turndown": "^5.0.6",
     "@types/ws": "^8.5.14",
+    "ai": "^6.0.168",
     "lefthook": "^2.1.5",
     "oxlint": "^1.0.0",
     "prettier": "^3.5.0",
+    "shell-quote": "^1.8.3",
     "tsx": "^4.19.0",
     "typescript": "^6.0.2",
     "vitepress": "^1.6.0",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "yaml": "^2.8.3"
   }
 }

package/src/adapters/1688/item.yaml

@@ -12,6 +12,7 @@ args:
     required: true
     positional: true
     description: Offer/product ID
+    x-unicli-kind: id
 
 pipeline:
   - navigate:

package/src/adapters/1688/store.yaml

@@ -11,6 +11,7 @@ args:
     required: true
     positional: true
     description: Store member ID
+    x-unicli-kind: id
   limit:
     type: int
     default: 20

package/src/adapters/36kr/article.yaml

@@ -10,6 +10,7 @@ args:
     required: true
     positional: true
     description: Article ID
+    x-unicli-kind: id
   limit:
     type: int
     default: 1

package/src/adapters/_electron/desktop-shared.ts

@@ -0,0 +1,383 @@
+import { cli, Strategy } from "../../registry.js";
+import {
+  getElectronApp,
+  resolveAppControlPolicy,
+} from "../../electron-apps.js";
+import { launchElectronApp } from "../../browser/launcher.js";
+import { connectElectronApp } from "./shared.js";
+import type { BrowserPage } from "../../browser/page.js";
+
+export interface ElectronMediaProfile {
+  likedText: string;
+  playAllText: string;
+}
+
+export interface ElectronDesktopCommandProfile {
+  displayName?: string;
+  media?: ElectronMediaProfile;
+}
+
+export const ELECTRON_DESKTOP_BASE_COMMANDS = [
+  "open-app",
+  "status-app",
+  "dump",
+  "snapshot-app",
+  "click-text",
+  "type-text",
+  "press",
+] as const;
+
+export const ELECTRON_DESKTOP_MEDIA_COMMANDS = [
+  "play-liked",
+  "play",
+  "pause",
+  "toggle",
+  "next",
+  "prev",
+] as const;
+
+export function registerElectronDesktopCommands(
+  site: string,
+  profile: ElectronDesktopCommandProfile = {},
+): void {
+  const app = getElectronApp(site);
+  const displayName = profile.displayName ?? app?.displayName ?? site;
+
+  cli({
+    site,
+    name: "open-app",
+    description: `Open ${displayName} desktop Electron app with CDP enabled for AI control. 打开${displayName}桌面版并启用 CDP 控制。`,
+    strategy: Strategy.PUBLIC,
+    func: async () => {
+      const endpoint = await launchElectronApp(site);
+      return [
+        {
+          app: displayName,
+          site,
+          port: endpoint.port,
+          wsUrl: endpoint.wsUrl,
+          policy: resolveAppControlPolicy(site),
+        },
+      ];
+    },
+  });
+
+  cli({
+    site,
+    name: "status-app",
+    description: `Inspect current ${displayName} desktop app page, title, URL, visible controls, and text summary. 查看${displayName}桌面版当前状态和可见内容。`,
+    strategy: Strategy.PUBLIC,
+    func: async () => [await readDesktopStatus(site, displayName)],
+  });
+
+  cli({
+    site,
+    name: "dump",
+    description: `Dump visible text from the ${displayName} desktop Electron app via CDP DOM. 读取${displayName}桌面版可见文本。`,
+    strategy: Strategy.PUBLIC,
+    args: [
+      {
+        name: "limit",
+        required: false,
+        positional: false,
+        description: "Maximum text characters to return",
+      },
+    ],
+    func: async (_page: unknown, kwargs: Record<string, unknown>) => {
+      const p = await connectElectronApp(site);
+      const limit = readInt(kwargs.limit, 2000);
+      return [await dumpVisibleText(p, displayName, limit)];
+    },
+  });
+
+  cli({
+    site,
+    name: "snapshot-app",
+    description: `List visible clickable text, buttons, inputs, and regions in ${displayName}. 枚举${displayName}桌面版可交互内容。`,
+    strategy: Strategy.PUBLIC,
+    func: async () => {
+      const p = await connectElectronApp(site);
+      return (await p.evaluate(visibleInteractivesJs())) as unknown[];
+    },
+  });
+
+  cli({
+    site,
+    name: "click-text",
+    description: `Click visible text, aria-label, title, or button content in ${displayName}. 按文本点击${displayName}桌面版控件。`,
+    strategy: Strategy.PUBLIC,
+    args: [
+      {
+        name: "text",
+        required: true,
+        positional: true,
+        description: "Visible text, aria-label, or title to click",
+      },
+    ],
+    func: async (_page: unknown, kwargs: Record<string, unknown>) => {
+      const p = await connectElectronApp(site);
+      return [await clickVisibleText(p, String(kwargs.text), displayName)];
+    },
+  });
+
+  cli({
+    site,
+    name: "type-text",
+    description: `Type text into the focused field or a text-matched target in ${displayName}. 向${displayName}桌面版输入文本。`,
+    strategy: Strategy.PUBLIC,
+    args: [
+      {
+        name: "text",
+        required: true,
+        positional: true,
+        description: "Text to type",
+      },
+      {
+        name: "target",
+        required: false,
+        positional: false,
+        description: "Optional visible text to click before typing",
+      },
+    ],
+    func: async (_page: unknown, kwargs: Record<string, unknown>) => {
+      const p = await connectElectronApp(site);
+      if (kwargs.target !== undefined) {
+        await clickVisibleText(p, String(kwargs.target), displayName);
+      }
+      await p.insertText(String(kwargs.text));
+      return [{ app: displayName, typed: true }];
+    },
+  });
+
+  cli({
+    site,
+    name: "press",
+    description: `Press a key in ${displayName}, with optional comma-separated modifiers. 在${displayName}桌面版发送按键。`,
+    strategy: Strategy.PUBLIC,
+    args: [
+      {
+        name: "key",
+        required: true,
+        positional: true,
+        description: "Key name",
+      },
+      {
+        name: "modifiers",
+        required: false,
+        positional: false,
+        description: "Comma-separated modifiers such as meta,shift",
+      },
+    ],
+    func: async (_page: unknown, kwargs: Record<string, unknown>) => {
+      const p = await connectElectronApp(site);
+      const modifiers =
+        typeof kwargs.modifiers === "string"
+          ? kwargs.modifiers
+              .split(",")
+              .map((s) => s.trim())
+              .filter(Boolean)
+          : undefined;
+      await p.press(String(kwargs.key), modifiers);
+      return [{ app: displayName, key: String(kwargs.key), modifiers }];
+    },
+  });
+
+  if (profile.media) {
+    registerMediaCommands(site, displayName, profile.media);
+  }
+}
+
+function registerMediaCommands(
+  site: string,
+  displayName: string,
+  media: ElectronMediaProfile,
+): void {
+  cli({
+    site,
+    name: "play-liked",
+    description: `Open ${displayName} liked songs and play the liked playlist. 打开${displayName}我喜欢的音乐/喜欢的歌曲并播放。`,
+    strategy: Strategy.PUBLIC,
+    func: async () => {
+      const p = await connectElectronApp(site);
+      const liked = await clickVisibleText(p, media.likedText, displayName);
+      await p.wait(1);
+      const play = await clickVisibleText(p, media.playAllText, displayName);
+      await p.wait(1.5);
+      return [{ app: displayName, liked, play, status: await mediaStatus(p) }];
+    },
+  });
+
+  for (const action of ["play", "pause", "toggle", "next", "prev"] as const) {
+    cli({
+      site,
+      name: action,
+      description: `${action} playback in the ${displayName} desktop app. 控制${displayName}桌面版播放：${action}。`,
+      strategy: Strategy.PUBLIC,
+      func: async () => {
+        const p = await connectElectronApp(site);
+        const clicked = await clickMediaControl(p, action, displayName);
+        await p.wait(0.8);
+        return [
+          { app: displayName, action, clicked, status: await mediaStatus(p) },
+        ];
+      },
+    });
+  }
+}
+
+async function readDesktopStatus(
+  site: string,
+  displayName: string,
+): Promise<Record<string, unknown>> {
+  const endpoint = await launchElectronApp(site);
+  const p = await connectElectronApp(site);
+  return {
+    app: displayName,
+    site,
+    port: endpoint.port,
+    title: await p.title(),
+    url: await p.url(),
+    policy: resolveAppControlPolicy(site),
+    content: await dumpVisibleText(p, displayName, 700),
+    controls: await p.evaluate(visibleInteractivesJs(20)),
+  };
+}
+
+async function dumpVisibleText(
+  p: BrowserPage,
+  app: string,
+  limit: number,
+): Promise<Record<string, unknown>> {
+  const text = (await p.evaluate(
+    `document.body.innerText.slice(0, ${Math.max(1, limit)})`,
+  )) as string;
+  return { app, text };
+}
+
+async function clickVisibleText(
+  p: BrowserPage,
+  text: string,
+  app: string,
+): Promise<Record<string, unknown>> {
+  const result = (await p.evaluate(clickTextJs(text))) as {
+    found: boolean;
+    x?: number;
+    y?: number;
+    text?: string;
+  };
+  if (!result.found || result.x === undefined || result.y === undefined) {
+    return { app, clicked: false, text, reason: "text_not_found" };
+  }
+  await p.nativeClick(result.x, result.y);
+  return { app, clicked: true, match: result.text, x: result.x, y: result.y };
+}
+
+async function clickMediaControl(
+  p: BrowserPage,
+  action: "play" | "pause" | "toggle" | "next" | "prev",
+  app: string,
+): Promise<Record<string, unknown>> {
+  const target = (await p.evaluate(mediaControlJs(action))) as {
+    found: boolean;
+    x?: number;
+    y?: number;
+    label?: string;
+  };
+  if (!target.found || target.x === undefined || target.y === undefined) {
+    return { app, clicked: false, action, reason: "control_not_found" };
+  }
+  await p.nativeClick(target.x, target.y);
+  return { app, clicked: true, action, label: target.label };
+}
+
+async function mediaStatus(p: BrowserPage): Promise<unknown> {
+  return p.evaluate(`
+    (() => {
+      const pause = Array.from(document.querySelectorAll('button[title="暂停"]'))
+        .find(el => el.getBoundingClientRect().y < innerHeight - 90);
+      const row = pause?.closest('.tr');
+      return {
+        playing: !!pause,
+        currentRow: (row?.innerText || '').trim().replace(/\\s+/g, ' ').slice(0, 200),
+        bodyTail: document.body.innerText.slice(-300)
+      };
+    })()
+  `);
+}
+
+function clickTextJs(text: string): string {
+  return `
+    (() => {
+      const needle = ${JSON.stringify(text)}.trim().toLowerCase();
+      const nodes = Array.from(document.querySelectorAll('button,a,[role],div,span,input,textarea'));
+      for (const el of nodes) {
+        const raw = (el.innerText || el.textContent || el.getAttribute('aria-label') || el.title || el.placeholder || '').trim();
+        if (!raw) continue;
+        const hay = raw.toLowerCase();
+        if (hay !== needle && !hay.includes(needle)) continue;
+        const target = el.closest('button,a,[role="button"],.ItemContainer_ijv59hq,.tr') || el;
+        const r = target.getBoundingClientRect();
+        if (r.width < 1 || r.height < 1 || r.x < -5 || r.y < -5) continue;
+        return { found: true, text: raw.slice(0, 160), x: r.x + r.width / 2, y: r.y + r.height / 2 };
+      }
+      return { found: false };
+    })()
+  `;
+}
+
+function mediaControlJs(action: string): string {
+  return `
+    (() => {
+      const bottom = Array.from(document.querySelectorAll('button')).map((el, index) => {
+        const r = el.getBoundingClientRect();
+        const label = [el.title, el.getAttribute('aria-label'), el.innerText, el.textContent].filter(Boolean).join(' ').trim();
+        return { el, index, label, cls: String(el.className || ''), x: r.x, y: r.y, w: r.width, h: r.height };
+      }).filter(b => b.w > 0 && b.h > 0 && b.y > innerHeight - 90).sort((a, b) => a.x - b.x);
+      const pick = (b) => ({ found: true, label: b.label || b.cls, x: b.x + b.w / 2, y: b.y + b.h / 2 });
+      const rx = {
+        next: /下一首|下一个|next/i,
+        prev: /上一首|上一个|previous|prev/i,
+        play: /播放|play/i,
+        pause: /暂停|pause/i
+      }[${JSON.stringify(action)}];
+      if (rx) {
+        const labeled = bottom.find(b => rx.test(b.label));
+        if (labeled) return pick(labeled);
+      }
+      const center = bottom.find(b => b.cls.includes('play-pause-btn')) ||
+        bottom.slice().sort((a, b) => Math.abs((a.x + a.w / 2) - innerWidth / 2) - Math.abs((b.x + b.w / 2) - innerWidth / 2))[0];
+      if (!center) return { found: false };
+      if (${JSON.stringify(action)} === 'toggle' || ${JSON.stringify(action)} === 'play' || ${JSON.stringify(action)} === 'pause') return pick(center);
+      const idx = bottom.indexOf(center);
+      const neighbor = ${JSON.stringify(action)} === 'next' ? bottom[idx + 1] : bottom[idx - 1];
+      return neighbor ? pick(neighbor) : { found: false };
+    })()
+  `;
+}
+
+function visibleInteractivesJs(limit = 80): string {
+  return `
+    (() => {
+      const out = [];
+      const nodes = document.querySelectorAll('button,a,input,textarea,[role="button"],[role="textbox"],[contenteditable="true"]');
+      for (const el of nodes) {
+        const r = el.getBoundingClientRect();
+        if (r.width < 1 || r.height < 1 || r.y < -5 || r.y > innerHeight + 5) continue;
+        const text = (el.innerText || el.textContent || el.getAttribute('aria-label') || el.title || el.placeholder || '').trim().replace(/\\s+/g, ' ');
+        out.push({ tag: el.tagName, role: el.getAttribute('role'), text: text.slice(0, 120), title: el.title, rect: { x: r.x, y: r.y, w: r.width, h: r.height } });
+        if (out.length >= ${limit}) break;
+      }
+      return out;
+    })()
+  `;
+}
+
+function readInt(value: unknown, fallback: number): number {
+  const n =
+    typeof value === "number"
+      ? value
+      : typeof value === "string"
+        ? Number.parseInt(value, 10)
+        : Number.NaN;
+  return Number.isFinite(n) && n > 0 ? Math.trunc(n) : fallback;
+}

package/src/adapters/amazon/bestsellers.yaml

@@ -10,6 +10,8 @@ args:
     type: str
     default: ""
     description: "Best sellers URL or category path (default: top-level)"
+    x-unicli-kind: path
+    x-unicli-accepts: [url]
   limit:
     type: int
     default: 20

package/src/adapters/amazon/movers-shakers.yaml

@@ -10,6 +10,8 @@ args:
     type: str
     default: ""
     description: "Movers & Shakers URL or category path"
+    x-unicli-kind: path
+    x-unicli-accepts: [url]
   limit:
     type: int
     default: 20

package/src/adapters/amazon/new-releases.yaml

@@ -10,6 +10,8 @@ args:
     type: str
     default: ""
     description: "New releases URL or category path"
+    x-unicli-kind: path
+    x-unicli-accepts: [url]
   limit:
     type: int
     default: 20

package/src/adapters/amazon/rankings.yaml

@@ -11,6 +11,7 @@ args:
     required: true
     positional: true
     description: "Rankings page URL"
+    format: uri
   limit:
     type: int
     default: 20

package/src/adapters/apple-podcasts/episodes.yaml

@@ -11,6 +11,7 @@ args:
     required: true
     positional: true
     description: Podcast ID (collectionId from search output)
+    x-unicli-kind: id
   limit:
     type: int
     default: 15

package/src/adapters/arxiv/paper.yaml

@@ -11,6 +11,7 @@ args:
     required: true
     positional: true
     description: "arXiv paper ID (e.g. 1706.03762)"
+    x-unicli-kind: id
 
 pipeline:
   - fetch_text:

package/src/adapters/audacity/convert.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output file path (format inferred from extension)
+    x-unicli-kind: path
 
 pipeline:
   - exec:

package/src/adapters/audacity/effects.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output file path
+    x-unicli-kind: path
   effect:
     type: str
     required: true

package/src/adapters/audacity/info.yaml

@@ -12,6 +12,7 @@ args:
     required: true
     positional: true
     description: Path to audio file
+    x-unicli-kind: path
 
 pipeline:
   - exec:

package/src/adapters/audacity/mix.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output file path
+    x-unicli-kind: path
 
 pipeline:
   - exec:

package/src/adapters/audacity/normalize.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output file path
+    x-unicli-kind: path
   level:
     type: float
     default: -1.0

package/src/adapters/audacity/spectrogram.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output PNG file path
+    x-unicli-kind: path
   title:
     type: str
     default: ""

package/src/adapters/audacity/split-channels.yaml

@@ -16,6 +16,7 @@ args:
     type: str
     required: true
     description: Output file path prefix (will append _left/_right)
+    x-unicli-kind: path
 
 pipeline:
   - exec: