@yjjeong/omg 0.1.0

package/dist/core/usageCache.js

@@ -0,0 +1,157 @@
+// Phase 112: opt-in usage cache reader.
+//
+// omg never touches a provider OAuth token — it delegates to the CLIs
+// (claude-cli / codex-cli / gemini-cli), and the CLI stream exposes
+// no plan-quota numbers (only a reset deadline + allow/deny status).
+// So omg can't compute a real 5h/wk/sn usage percentage on its own.
+//
+// But other tools (e.g. the oh-my-claudecode statusline) already call
+// the provider's usage endpoint with their own token and cache the
+// result to a JSON file. Point omg at that file via OMG_USAGE_CACHE
+// and it reads the cap + used numbers from it — credential-free,
+// fully opt-in.
+//
+// Canonical omg schema (the form we document):
+//
+//   {
+//     "five_hour": { "used": 34000, "limit": 100000, "resetsAt": <ms-epoch> },
+//     "weekly":    { "used": 1500000, "limit": 5000000 },
+//     "session":   { "used": 0, "limit": 50000 }
+//   }
+//
+// The reader is tolerant: window keys accept aliases (5h / fiveHour /
+// five_hour, wk / week / weekly, sn / session), each window accepts
+// either used+limit OR a direct percentage field (utilization /
+// percent / used_pct), and resetsAt may be ms or seconds.
+import { existsSync, readFileSync, statSync } from "node:fs";
+const WINDOW_ALIASES = {
+    fiveHour: ["five_hour", "fiveHour", "5h", "fivehour"],
+    weekly: ["weekly", "week", "wk"],
+    session: ["session", "sn"],
+};
+function num(v) {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+/** Normalise a possibly-seconds epoch to ms. Values below ~1e12 are
+ *  treated as seconds. */
+function toMs(v) {
+    const n = num(v);
+    if (n === undefined || n <= 0)
+        return undefined;
+    return n < 1e12 ? Math.round(n * 1000) : Math.round(n);
+}
+/** Pull a window's usage out of a record, trying used+limit first,
+ *  then a direct percentage (mapped to used=pct, limit=100). */
+function parseWindow(obj) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    const o = obj;
+    const resetsAt = toMs(o.resetsAt ?? o.resets_at ?? o.reset ?? o.resetTime);
+    const used = num(o.used ?? o.consumed ?? o.tokensUsed ?? o.tokens_used);
+    const limit = num(o.limit ?? o.cap ?? o.max ?? o.quota);
+    if (used !== undefined && limit !== undefined && limit > 0) {
+        return { used, limit, resetsAt };
+    }
+    // Direct percentage form.
+    const pct = num(o.utilization ?? o.percent ?? o.used_pct ?? o.usedPct ?? o.pct);
+    if (pct !== undefined) {
+        return { used: Math.max(0, Math.min(100, pct)), limit: 100, resetsAt };
+    }
+    // Reset-only (no usage) still useful for the countdown.
+    if (resetsAt !== undefined)
+        return { resetsAt };
+    return undefined;
+}
+function findWindow(root, aliases) {
+    for (const a of aliases) {
+        if (a in root)
+            return root[a];
+    }
+    // Some caches nest windows under a "windows" key.
+    const nested = root.windows;
+    if (nested && typeof nested === "object") {
+        const n = nested;
+        for (const a of aliases) {
+            if (a in n)
+                return n[a];
+        }
+    }
+    return undefined;
+}
+/** Phase 214 (F4.5): cache file is considered stale (and the snapshot
+ *  is dropped) when mtime is older than this many milliseconds.
+ *  10 minutes is the audit's recommended default — long enough for a
+ *  cooperating tool to refresh on a normal cadence, short enough that
+ *  the user doesn't make decisions on usage numbers from an hour ago
+ *  if the producer crashed. Override via OMG_USAGE_CACHE_TTL_MS for
+ *  tools with a different refresh cycle. */
+const DEFAULT_TTL_MS = 10 * 60 * 1000;
+function resolvedTtlMs() {
+    const raw = process.env.OMG_USAGE_CACHE_TTL_MS;
+    if (!raw)
+        return DEFAULT_TTL_MS;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : DEFAULT_TTL_MS;
+}
+/** Read the usage cache pointed to by OMG_USAGE_CACHE (or the explicit
+ *  path). Returns null when the env var is unset, the file is missing,
+ *  the JSON is unparseable, or the file's mtime is older than the TTL
+ *  — callers fall back to raw "~" usage instead of rendering a stale
+ *  percentage from a dead producer. */
+export function loadUsageCache(path = process.env.OMG_USAGE_CACHE) {
+    if (!path)
+        return null;
+    if (!existsSync(path))
+        return null;
+    // Phase 214: drop snapshots whose producer hasn't refreshed within
+    // the TTL window — a stale chip ("ctx 67%") is worse than no chip
+    // because the user might make decisions on it.
+    try {
+        const st = statSync(path);
+        if (Date.now() - st.mtimeMs > resolvedTtlMs())
+            return null;
+    }
+    catch {
+        // stat failed — let the read path handle the error; if statSync
+        // fails the read almost certainly will too.
+    }
+    try {
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const snap = {};
+        for (const key of Object.keys(WINDOW_ALIASES)) {
+            const w = parseWindow(findWindow(parsed, WINDOW_ALIASES[key]));
+            if (w)
+                snap[key] = w;
+        }
+        return Object.keys(snap).length > 0 ? snap : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Flatten a UsageSnapshot into the status-bar fields the gauge reads. */
+export function usageStatusFields(snap) {
+    const out = {};
+    const map = [
+        ["fiveHour", "tokensUsed5h", "capFiveHour", "fiveHourResetsAt"],
+        ["weekly", "tokensUsedWeekly", "capWeekly", "weeklyResetsAt"],
+        ["session", "tokensUsedSession", "capSession", "sessionResetsAt"],
+    ];
+    for (const [key, usedField, capField, resetField] of map) {
+        const w = snap[key];
+        if (!w)
+            continue;
+        if (w.used !== undefined)
+            out[usedField] = w.used;
+        if (w.limit !== undefined)
+            out[capField] = w.limit;
+        if (w.resetsAt !== undefined)
+            out[resetField] = w.resetsAt;
+    }
+    return out;
+}
+//# sourceMappingURL=usageCache.js.map

package/dist/core/usageCache.js.map

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

package/dist/core/usageWindow.d.ts

@@ -0,0 +1,19 @@
+export declare class RollingUsage {
+    private readonly windowMs;
+    /** Entries of [ms-epoch, tokens] — old ones drop on prune. */
+    private entries;
+    constructor(windowMs: number);
+    record(ts: number, tokens: number): void;
+    /** Total tokens within the trailing windowMs ending at `now`. */
+    sum(now: number): number;
+    /** Visible for tests. */
+    get size(): number;
+    private prune;
+}
+/** Resolve a user-supplied plan cap. Env vars override the persisted
+ *  ~/.omg/plan.json (Phase 82); both override "no cap". Returns
+ *  undefined when neither is set, so the bar falls back to raw
+ *  "Nk used" with no percent. */
+export declare function planCapFor(kind: "five_hour" | "weekly" | "session"): number | undefined;
+export declare function setPlanCapResolver(fn: (kind: "five_hour" | "weekly" | "session") => number | undefined): void;
+//# sourceMappingURL=usageWindow.d.ts.map

package/dist/core/usageWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageWindow.d.ts","sourceRoot":"","sources":["../../src/core/usageWindow.ts"],"names":[],"mappings":"AAaA,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,8DAA8D;IAC9D,OAAO,CAAC,OAAO,CAA+B;gBAEjB,QAAQ,EAAE,MAAM;IAI7C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMxC,iEAAiE;IACjE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOxB,yBAAyB;IACzB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,KAAK;CAMd;AAED;;;iCAGiC;AACjC,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GACvC,MAAM,GAAG,SAAS,CAGpB;AAoBD,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,GACnE,IAAI,CAEN"}

package/dist/core/usageWindow.js

@@ -0,0 +1,73 @@
+// Phase 45: rolling token-usage windows.
+//
+// claude's rate_limit_event tells us *when* the next 5h / weekly /
+// session reset lands, but not *how much* of the quota is left.
+// omg can't read the user's actual plan limits, so the best we can
+// do is track tokens spent in each rolling window and surface them
+// as an approximate number. If the caller knows their plan's cap
+// (via env vars), the bar also shows a percent.
+//
+// Metric: model output_tokens (additive, one number per turn). We
+// could use input_tokens, but those grow with conversation history
+// and double-count every turn — output_tokens reads as "model work".
+export class RollingUsage {
+    windowMs;
+    /** Entries of [ms-epoch, tokens] — old ones drop on prune. */
+    entries = [];
+    constructor(windowMs) {
+        this.windowMs = windowMs;
+        if (windowMs <= 0)
+            throw new Error("windowMs must be positive");
+    }
+    record(ts, tokens) {
+        if (tokens <= 0)
+            return;
+        this.entries.push([ts, tokens]);
+        this.prune(ts);
+    }
+    /** Total tokens within the trailing windowMs ending at `now`. */
+    sum(now) {
+        this.prune(now);
+        let total = 0;
+        for (const [, t] of this.entries)
+            total += t;
+        return total;
+    }
+    /** Visible for tests. */
+    get size() {
+        return this.entries.length;
+    }
+    prune(now) {
+        const cutoff = now - this.windowMs;
+        while (this.entries.length > 0 && this.entries[0][0] < cutoff) {
+            this.entries.shift();
+        }
+    }
+}
+/** Resolve a user-supplied plan cap. Env vars override the persisted
+ *  ~/.omg/plan.json (Phase 82); both override "no cap". Returns
+ *  undefined when neither is set, so the bar falls back to raw
+ *  "Nk used" with no percent. */
+export function planCapFor(kind) {
+    // Lazy import to avoid a node:fs dependency cycle.
+    return planCapResolvedRef(kind);
+}
+// Default resolver: env-only, identical to the pre-Phase-82 behaviour.
+// cli.ts overrides via setPlanCapResolver() to also consult
+// ~/.omg/plan.json (Phase 82). Tests that don't import planConfig
+// still see the original env semantics.
+let planCapResolvedRef = (kind) => {
+    const env = kind === "five_hour"
+        ? process.env.OMG_PLAN_5H_TOKENS
+        : kind === "weekly"
+            ? process.env.OMG_PLAN_WEEKLY_TOKENS
+            : process.env.OMG_PLAN_SESSION_TOKENS;
+    if (!env)
+        return undefined;
+    const n = Number(env);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+};
+export function setPlanCapResolver(fn) {
+    planCapResolvedRef = fn;
+}
+//# sourceMappingURL=usageWindow.js.map

package/dist/core/usageWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageWindow.js","sourceRoot":"","sources":["../../src/core/usageWindow.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,mEAAmE;AACnE,gEAAgE;AAChE,mEAAmE;AACnE,mEAAmE;AACnE,iEAAiE;AACjE,gDAAgD;AAChD,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,qEAAqE;AAErE,MAAM,OAAO,YAAY;IAIM;IAH7B,8DAA8D;IACtD,OAAO,GAA4B,EAAE,CAAC;IAE9C,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAC3C,IAAI,QAAQ,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAc;QAC/B,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,iEAAiE;IACjE,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,KAAK,IAAI,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yBAAyB;IACzB,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;YAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED;;;iCAGiC;AACjC,MAAM,UAAU,UAAU,CACxB,IAAwC;IAExC,mDAAmD;IACnD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,4DAA4D;AAC5D,kEAAkE;AAClE,wCAAwC;AACxC,IAAI,kBAAkB,GAEI,CAAC,IAAI,EAAE,EAAE;IACjC,MAAM,GAAG,GACP,IAAI,KAAK,WAAW;QAClB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAChC,CAAC,CAAC,IAAI,KAAK,QAAQ;YACjB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB;YACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,EAAoE;IAEpE,kBAAkB,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/dist/core/util/bgProtocol.d.ts

@@ -0,0 +1,5 @@
+export declare const BG_DONE_MARKER = "__OMG_BG_DONE__";
+/** True when a background task's output (or its tail) shows the explicit
+ *  completion marker — definitive proof the command finished. */
+export declare function outputSignalsCompletion(text: string): boolean;
+//# sourceMappingURL=bgProtocol.d.ts.map

package/dist/core/util/bgProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgProtocol.d.ts","sourceRoot":"","sources":["../../../src/core/util/bgProtocol.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD;iEACiE;AACjE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/core/util/bgProtocol.js

@@ -0,0 +1,20 @@
+// Phase 315: background-task completion protocol.
+//
+// omg auto-continues a turn when a `run_in_background` Bash task finishes
+// (Phase 257). The watcher's default signal is "output file size stable
+// for STABLE_MS" — a heuristic that a deploy's silent phases (a long
+// `next build`, a detached `compose up -d`) can mis-trigger or stall on.
+//
+// This marker is the precise alternative: the claude-cli nudge tells the
+// model to echo it as the LAST line of a backgrounded command, and the
+// watcher fires the instant it appears — faster (no STABLE_MS wait) and
+// exact (no false positive from quiet output). Kept in core so both the
+// adapter (core, owns the nudge) and the watcher (cli) can import it
+// without crossing the core → cli layering boundary.
+export const BG_DONE_MARKER = "__OMG_BG_DONE__";
+/** True when a background task's output (or its tail) shows the explicit
+ *  completion marker — definitive proof the command finished. */
+export function outputSignalsCompletion(text) {
+    return text.includes(BG_DONE_MARKER);
+}
+//# sourceMappingURL=bgProtocol.js.map

package/dist/core/util/bgProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgProtocol.js","sourceRoot":"","sources":["../../../src/core/util/bgProtocol.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,qDAAqD;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD;iEACiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/util/clipboard.d.ts

@@ -0,0 +1,4 @@
+/** Copy `text` to the clipboard. Resolves with the utility that
+ *  succeeded (e.g. "pbcopy"); rejects when no candidate works. */
+export declare function copyToClipboard(text: string): Promise<string>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/core/util/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/core/util/clipboard.ts"],"names":[],"mappings":"AAoCA;kEACkE;AAClE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBnE"}

package/dist/core/util/clipboard.js

@@ -0,0 +1,46 @@
+// Phase 172: copy text to the system clipboard via the platform's
+// native utility. macOS uses pbcopy; Linux tries the common
+// wayland/X11 tools; Windows uses clip. Each candidate is piped the
+// text on stdin and we take the first one that exits cleanly.
+import { spawn } from "node:child_process";
+/** Ordered list of `argv` candidates per platform. The first one that
+ *  runs without erroring wins, so a machine missing wl-copy can still
+ *  fall through to xclip / xsel. */
+const CANDIDATES = {
+    darwin: [["pbcopy"]],
+    linux: [
+        ["wl-copy"],
+        ["xclip", "-selection", "clipboard"],
+        ["xsel", "--clipboard", "--input"],
+    ],
+    win32: [["clip"]],
+};
+function pipeToCommand(bin, args, text) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ["pipe", "ignore", "ignore"] });
+        child.on("error", reject);
+        child.on("close", (code) => code === 0 ? resolve() : reject(new Error(`${bin} exited ${code}`)));
+        child.stdin.on("error", reject);
+        child.stdin.end(text);
+    });
+}
+/** Copy `text` to the clipboard. Resolves with the utility that
+ *  succeeded (e.g. "pbcopy"); rejects when no candidate works. */
+export async function copyToClipboard(text) {
+    const candidates = CANDIDATES[process.platform] ?? [];
+    if (candidates.length === 0) {
+        throw new Error(`no clipboard utility known for platform ${process.platform}`);
+    }
+    let lastErr;
+    for (const [bin, ...args] of candidates) {
+        try {
+            await pipeToCommand(bin, args, text);
+            return bin;
+        }
+        catch (e) {
+            lastErr = e;
+        }
+    }
+    throw new Error(`clipboard copy failed (tried ${candidates.map((c) => c[0]).join(", ")}): ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/core/util/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../src/core/util/clipboard.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,4DAA4D;AAC5D,oEAAoE;AACpE,8DAA8D;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;oCAEoC;AACpC,MAAM,UAAU,GAA+B;IAC7C,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpB,KAAK,EAAE;QACL,CAAC,SAAS,CAAC;QACX,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC;QACpC,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC;KACnC;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;CAClB,CAAC;AAEF,SAAS,aAAa,CACpB,GAAW,EACX,IAAc,EACd,IAAY;IAEZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,WAAW,IAAI,EAAE,CAAC,CAAC,CACpE,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;kEACkE;AAClE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,QAAQ,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,OAAgB,CAAC;IACrB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MACpE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAC7D,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/core/util/clipboardImage.d.ts

@@ -0,0 +1,3 @@
+/** Capture a clipboard image to a temp PNG. Returns its path or null. */
+export declare function captureClipboardImage(): string | null;
+//# sourceMappingURL=clipboardImage.d.ts.map

package/dist/core/util/clipboardImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardImage.d.ts","sourceRoot":"","sources":["../../../src/core/util/clipboardImage.ts"],"names":[],"mappings":"AA8BA,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CA6BrD"}

package/dist/core/util/clipboardImage.js

@@ -0,0 +1,58 @@
+// Phase 340: capture an image sitting on the OS clipboard to a temp file so
+// it can be attached to a turn (codex `-i`, claude Read reference).
+//
+// Terminals don't deliver image bytes on Cmd+V — the paste keystroke yields
+// nothing (or an empty bracketed paste). So omg can't receive the image
+// inline; instead, when a paste looks empty, it PROBES the clipboard here.
+// macOS only for now: `pngpaste` if installed (fast), else AppleScript via
+// `osascript` reading `«class PNGf»` (no dependency). Returns the temp file
+// path, or null when there's no image / not macOS / capture failed — callers
+// treat null as "nothing to attach" and fall back to the `@path` flow.
+import { execFileSync } from "node:child_process";
+import { existsSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+let seq = 0;
+function tmpPngPath() {
+    seq += 1;
+    // pid + seq avoids collisions across concurrent omg processes without
+    // needing Date.now()/random (kept deterministic-ish; uniqueness is enough).
+    return join(tmpdir(), `omg-clip-${process.pid}-${seq}.png`);
+}
+/** True only on macOS — the only platform we have a clipboard-image path for. */
+function isMac() {
+    return process.platform === "darwin";
+}
+/** Capture a clipboard image to a temp PNG. Returns its path or null. */
+export function captureClipboardImage() {
+    if (!isMac())
+        return null;
+    const out = tmpPngPath();
+    // Fast path: pngpaste writes the clipboard image straight to a file and
+    // exits non-zero when the clipboard holds no image.
+    try {
+        execFileSync("pngpaste", [out], { stdio: "ignore", timeout: 4000 });
+        if (existsSync(out) && statSync(out).size > 0)
+            return out;
+    }
+    catch {
+        /* pngpaste missing or no image — fall through to osascript */
+    }
+    // Dependency-free path: AppleScript pulls the PNG representation and we
+    // write the raw bytes. `the clipboard as «class PNGf»` throws when the
+    // clipboard has no image, which osascript surfaces as a non-zero exit.
+    try {
+        const script = `set thePNG to (the clipboard as «class PNGf»)\nset fh to open for access POSIX file ${JSON.stringify(out)} with write permission\nwrite thePNG to fh\nclose access fh`;
+        execFileSync("osascript", ["-e", script], {
+            stdio: "ignore",
+            timeout: 4000,
+        });
+        if (existsSync(out) && statSync(out).size > 0)
+            return out;
+    }
+    catch {
+        /* no image on the clipboard, or osascript unavailable */
+    }
+    return null;
+}
+//# sourceMappingURL=clipboardImage.js.map

package/dist/core/util/clipboardImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardImage.js","sourceRoot":"","sources":["../../../src/core/util/clipboardImage.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,GAAG,GAAG,CAAC,CAAC;AAEZ,SAAS,UAAU;IACjB,GAAG,IAAI,CAAC,CAAC;IACT,sEAAsE;IACtE,4EAA4E;IAC5E,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,iFAAiF;AACjF,SAAS,KAAK;IACZ,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IAEzB,wEAAwE;IACxE,oDAAoD;IACpD,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uFAAuF,IAAI,CAAC,SAAS,CAClH,GAAG,CACJ,6DAA6D,CAAC;QAC/D,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACxC,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/util/langHint.d.ts

@@ -0,0 +1,9 @@
+/** Best-effort script detection → a human language name, or null when we
+ *  can't confidently name it (Latin text covers many languages, so we
+ *  fall back to the generic "same language" instruction). */
+export declare function languageOf(text: string): string | null;
+/** The system-prompt directive to append for a given task. Always asks
+ *  the model to mirror the user's language; when the script is
+ *  recognizable, it also names it concretely (more reliable). */
+export declare function languageDirective(task: string): string;
+//# sourceMappingURL=langHint.d.ts.map

package/dist/core/util/langHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langHint.d.ts","sourceRoot":"","sources":["../../../src/core/util/langHint.ts"],"names":[],"mappings":"AASA;;6DAE6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtD;AAED;;iEAEiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD"}

package/dist/core/util/langHint.js

@@ -0,0 +1,33 @@
+// Phase 141: derive a "respond in the user's language" directive for
+// team role system prompts.
+//
+// Team roles (implementer / reviewer / director / pm) otherwise reply in
+// whatever language their policy/context biases them toward — so a Korean
+// request got English reviews. We bake a language directive into each
+// role's adapter system prompt at construction; for claude-cli that lands
+// as `--append-system-prompt`, for API adapters as the `system` field.
+/** Best-effort script detection → a human language name, or null when we
+ *  can't confidently name it (Latin text covers many languages, so we
+ *  fall back to the generic "same language" instruction). */
+export function languageOf(text) {
+    if (/[가-힯ᄀ-ᇿ]/.test(text))
+        return "Korean";
+    if (/[぀-ヿ]/.test(text))
+        return "Japanese"; // kana
+    if (/[一-鿿]/.test(text))
+        return "Chinese"; // CJK ideographs (no kana)
+    if (/[Ѐ-ӿ]/.test(text))
+        return "Russian";
+    return null;
+}
+/** The system-prompt directive to append for a given task. Always asks
+ *  the model to mirror the user's language; when the script is
+ *  recognizable, it also names it concretely (more reliable). */
+export function languageDirective(task) {
+    const base = "Always respond in the same language the user used in their request.";
+    const lang = languageOf(task);
+    return lang
+        ? `${base} The user's request is in ${lang}; respond in ${lang}.`
+        : base;
+}
+//# sourceMappingURL=langHint.js.map

package/dist/core/util/langHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langHint.js","sourceRoot":"","sources":["../../../src/core/util/langHint.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,4BAA4B;AAC5B,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,0EAA0E;AAC1E,uEAAuE;AAEvE;;6DAE6D;AAC7D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,OAAO;IAClD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,2BAA2B;IACrE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;iEAEiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GACR,qEAAqE,CAAC;IACxE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,IAAI;QACT,CAAC,CAAC,GAAG,IAAI,6BAA6B,IAAI,gBAAgB,IAAI,GAAG;QACjE,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/core/util/slugify.d.ts

@@ -0,0 +1,2 @@
+export declare function slugify(text: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/core/util/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../src/core/util/slugify.ts"],"names":[],"mappings":"AAMA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB5C"}

package/dist/core/util/slugify.js

@@ -0,0 +1,28 @@
+// Phase 53: derive a tab name from a free-form string (typically
+// the first user message). The output is ASCII alnum + dashes,
+// lowercased, capped at 32 chars, never empty. Non-ASCII
+// characters get stripped — if the message is entirely non-ASCII
+// (Korean / Japanese / etc.) we return the placeholder "tab".
+export function slugify(text) {
+    const normalized = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_-]+/g, "")
+        .trim()
+        .replace(/[\s_]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    // Phase 286: collapse repeated tokens so a message that mentions the
+    // same word several times ("UI … UI … UI") yields "ui", not
+    // "ui-ui-ui-ui". First-occurrence order is preserved.
+    const seen = new Set();
+    const tokens = [];
+    for (const tok of normalized.split("-")) {
+        if (!tok || seen.has(tok))
+            continue;
+        seen.add(tok);
+        tokens.push(tok);
+    }
+    const slug = tokens.join("-").slice(0, 32).replace(/-+$/, "");
+    return slug || "tab";
+}
+//# sourceMappingURL=slugify.js.map

package/dist/core/util/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../../src/core/util/slugify.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,+DAA+D;AAC/D,yDAAyD;AACzD,iEAAiE;AACjE,8DAA8D;AAE9D,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,UAAU,GAAG,IAAI;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;SAC9B,IAAI,EAAE;SACN,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,qEAAqE;IACrE,4DAA4D;IAC5D,sDAAsD;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,IAAI,IAAI,KAAK,CAAC;AACvB,CAAC"}