@poping/yome 0.0.2 → 0.0.4

package/dist/skills/runner/applescript.js

@@ -0,0 +1,100 @@
+// cli/src/skills/runner/applescript.ts
+//
+// Spawn /usr/bin/osascript and friends. Mirror of Yome/macOS/Bridge/
+// AppleScriptRunner.swift so the CLI gets the same execution semantics
+// the macOS app uses (including the Launch Services trick that bypasses
+// app-sandbox prompts for opening files).
+import { spawnSync } from 'node:child_process';
+/**
+ * Run an AppleScript source string via `osascript -e`.
+ *
+ * The Swift sibling does some preflight automation-permission checks via
+ * AEDeterminePermissionToAutomateTarget. CLI doesn't have a UI to drive
+ * the system prompt, so we just let osascript surface error -1743 — the
+ * caller can decide whether to message the user.
+ */
+export function runOsascript(source, opts = {}) {
+    const r = spawnSync('/usr/bin/osascript', ['-e', source], {
+        encoding: 'utf-8',
+        timeout: opts.timeoutMs ?? 30_000,
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    if (r.error) {
+        return { ok: false, stdout: '', stderr: String(r.error.message), exitCode: -1 };
+    }
+    const code = r.status ?? -1;
+    return {
+        ok: code === 0,
+        stdout: (r.stdout ?? '').replace(/\n+$/, ''),
+        stderr: (r.stderr ?? '').trim(),
+        exitCode: code,
+    };
+}
+/**
+ * Same as `runOsascript`, but reads the script from a file path instead
+ * of inline `-e`. Useful for very long scripts or when keeping a single
+ * authoritative `.applescript` file in the skill bundle.
+ */
+export function runOsascriptFile(path, opts = {}) {
+    const r = spawnSync('/usr/bin/osascript', [path], {
+        encoding: 'utf-8',
+        timeout: opts.timeoutMs ?? 30_000,
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    if (r.error) {
+        return { ok: false, stdout: '', stderr: String(r.error.message), exitCode: -1 };
+    }
+    const code = r.status ?? -1;
+    return {
+        ok: code === 0,
+        stdout: (r.stdout ?? '').replace(/\n+$/, ''),
+        stderr: (r.stderr ?? '').trim(),
+        exitCode: code,
+    };
+}
+/**
+ * Open a file via macOS Launch Services (`/usr/bin/open -a`) so the
+ * receiving app gets sandbox-implicit access without us having to fight
+ * automation prompts, then poll an AppleScript until the file shows up
+ * inside that app.
+ *
+ * Returns the poll script's last output on success, or null on timeout.
+ */
+export function openViaLaunchServices(args) {
+    const open = spawnSync('/usr/bin/open', ['-a', args.appName, args.filePath], { encoding: 'utf-8' });
+    if (open.status !== 0) {
+        return {
+            ok: false,
+            stdout: '',
+            stderr: open.stderr || `open -a "${args.appName}" exited ${open.status}`,
+        };
+    }
+    const max = args.maxWaitSec ?? 30;
+    const interval = args.pollIntervalMs ?? 1000;
+    for (let i = 0; i < max; i++) {
+        sleepSync(interval);
+        const r = runOsascript(args.pollScript);
+        if (r.ok && r.stdout.trim().length > 0) {
+            return { ok: true, stdout: r.stdout, stderr: '' };
+        }
+    }
+    return { ok: false, stdout: '', stderr: `timed out waiting for ${args.appName} to load ${args.filePath}` };
+}
+/** Quote a string so it's safe to embed inside an AppleScript string literal. */
+export function asString(s) {
+    return '"' + s.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+/** Quote a POSIX path for AppleScript ("POSIX file" wrapping is the caller's job). */
+export function asPosixPath(p) {
+    return asString(p);
+}
+function sleepSync(ms) {
+    const end = Date.now() + ms;
+    // Atomics-based sleep — works in Node ≥16 without spawning a child.
+    const sab = new SharedArrayBuffer(4);
+    const view = new Int32Array(sab);
+    while (Date.now() < end) {
+        Atomics.wait(view, 0, 0, Math.max(1, end - Date.now()));
+    }
+}
+//# sourceMappingURL=applescript.js.map

package/dist/skills/runner/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../../src/skills/runner/applescript.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAU/C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAA+B,EAAE;IAC5E,MAAM,CAAC,GAAG,SAAS,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;QACxD,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;QACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC5B,OAAO;QACL,EAAE,EAAE,IAAI,KAAK,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAA+B,EAAE;IAC9E,MAAM,CAAC,GAAG,SAAS,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,EAAE;QAChD,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;QACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC5B,OAAO;QACL,EAAE,EAAE,IAAI,KAAK,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAMrC;IACC,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACpG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,MAAM,EAAE;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,yBAAyB,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC7G,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC;AACnE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAC5B,oEAAoE;IACpE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/skills/runner/dispatcher.d.ts

@@ -0,0 +1,128 @@
+export interface BackendArgSpec {
+    name: string;
+    from: string;
+    type?: 'string' | 'bool' | 'number';
+    default?: string | boolean | number;
+    required?: boolean;
+}
+export interface BackendActionSpec {
+    script: string;
+    args?: BackendArgSpec[];
+    openViaLaunchServices?: boolean;
+    pollScript?: string;
+    uses?: string[];
+    /** Per-action timeout override in ms. */
+    timeoutMs?: number;
+}
+export interface MacosBackendManifest {
+    appBundleId?: string;
+    appName?: string;
+    actions: Record<string, BackendActionSpec>;
+}
+export interface SkillCall {
+    positionals: string[];
+    flags: Record<string, string | boolean | number | undefined>;
+}
+export interface DispatchResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare const NAMED_COLORS: Record<string, [number, number, number]>;
+export interface ColorParseFailure {
+    input: string;
+    reason: string;
+}
+/**
+ * Parse a color spec into an AppleScript RGB literal `{r, g, b}`.
+ *
+ * Accepted forms (case- and whitespace-insensitive):
+ *   • `#RRGGBB` or bare `RRGGBB`
+ *   • `R,G,B`  with each channel in 0..255
+ *   • Named color from NAMED_COLORS (CSS-ish + CN aliases)
+ *
+ * Returns `{ ok: true, literal }` on success, or `{ ok: false, error }` with
+ * a precise reason on failure. Callers MUST surface the error rather than
+ * silently emitting an empty literal — silent fallbacks were the root cause
+ * of the historical "bg disappeared from the format result" class of bugs.
+ */
+export type ColorParseResult = {
+    ok: true;
+    literal: string;
+    rgb: [number, number, number];
+} | {
+    ok: false;
+    error: ColorParseFailure;
+};
+export declare function parseColor(input: string): ColorParseResult;
+/**
+ * Back-compat wrapper that returns the literal or null. New code should use
+ * `parseColor()` so the failure reason can be surfaced to the user.
+ */
+export declare function parseColorToAppleScriptRGB(input: string): string | null;
+/**
+ * `--type` alias → AppleScript `MsoAutoShapeType` enum literal. Unknown
+ * aliases degrade to `autoshape rectangle` so the template never emits
+ * broken AppleScript.
+ */
+export declare function parseAutoshapeToAppleScript(input: string): string;
+/**
+ * `--align` parser → AppleScript `paragraph align ...` enum.
+ * Defaults silently to `paragraph align left` for unknown values; that
+ * matches the Swift bridge behaviour and avoids breaking the script render.
+ */
+export declare function parseAlignToAppleScript(input: string): string;
+export interface RenderError {
+    arg: string;
+    filter?: string;
+    reason: string;
+}
+export interface RenderResult {
+    source: string;
+    errors: RenderError[];
+}
+/**
+ * Render an AppleScript template.
+ *
+ * Two failure modes exist:
+ *  - "soft": the filter accepts any input and just renders something
+ *    (`json`, `posix`, `bool`, `as_int`, `align`, `autoshape`). These never
+ *    populate `errors`.
+ *  - "hard": the filter validates input and can reject it (`rgb`). When
+ *    rejected we emit a syntactically VALID placeholder (`missing value`)
+ *    so the rendered AppleScript still parses, AND we record the error
+ *    in `errors[]`. The dispatcher checks `errors` BEFORE running osascript
+ *    and refuses to run with a structured message — no more silent failure
+ *    where `bg=深蓝` quietly emitted broken AppleScript.
+ *
+ * `{{name}}` / `{{name|filter}}` is the substitution syntax.
+ * `{{#if name}}…{{/if}}` is the conditional block (greedy, not nestable).
+ * Substitution happens AFTER conditionals, so a `{{#if bg}}…{{bg|rgb}}…{{/if}}`
+ * block whose `bg` was stripped never reaches the filter.
+ */
+export declare function renderTemplate(tpl: string, ctx: Record<string, string | boolean | number | null>): RenderResult;
+export declare function loadMacosBackend(skillDir: string): MacosBackendManifest | null;
+/**
+ * Run an action on a macOS-backed skill. Returns the osascript outcome
+ * verbatim (caller decides how to render).
+ */
+export declare function dispatchMacos(skillDir: string, action: string, call: SkillCall): DispatchResult;
+export interface MergedBatchEntry {
+    action: string;
+    call: SkillCall;
+}
+export interface MergedBatchOptions {
+    keepGoing: boolean;
+}
+export declare function dispatchMacosBatchMerged(skillDir: string, entries: MergedBatchEntry[], opts: MergedBatchOptions): Promise<DispatchResult>;
+/**
+ * Demux the "<okList>|<failList>" convention used by partial-success-aware
+ * AppleScript templates (xl/ppt/doc `fmt`, `cf`, …). Returns null when the
+ * payload doesn't look like that shape — callers should treat null as
+ * "ordinary opaque message, leave it alone".
+ */
+export declare function parsePartialOkFail(msg: string): {
+    ok: string;
+    fail: string;
+} | null;