@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/flathub/apps.js

@@ -0,0 +1,220 @@
+/**
+ * @owner   src/adapters/flathub/apps.ts
+ * @does    Register agent-facing Flathub app search and detail commands.
+ * @needs   Flathub public API, AppStream id validation, bounded search limits.
+ * @feeds   surface coverage ledger, Linux app registry search rows, appstream metadata rows.
+ * @breaks  Flathub API drift, weak app id validation, or silent empty rows hide app registry data.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://flathub.org/api/v2";
+const APP_BASE = "https://flathub.org/apps";
+const APP_ID_RE = /^[A-Za-z][A-Za-z0-9_-]*(?:\.[A-Za-z0-9_][A-Za-z0-9_-]*){1,}$/;
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`flathub ${label} cannot be empty.`);
+    return text;
+}
+export function requireFlathubLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 25 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+        throw new Error("flathub limit must be an integer in [1, 100].");
+    }
+    return limit;
+}
+export function requireFlathubAppId(value) {
+    const id = String(value ?? "").trim();
+    if (!id)
+        throw new Error("flathub appId cannot be empty.");
+    if (!APP_ID_RE.test(id)) {
+        throw new Error(`flathub appId "${String(value)}" is not valid.`);
+    }
+    return id;
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+export function joinFlathubList(value, max = 10) {
+    if (!Array.isArray(value))
+        return "";
+    const items = value.filter((item) => typeof item === "string" && item.trim());
+    return items.length > max
+        ? [...items.slice(0, max), `(+${items.length - max})`].join(", ")
+        : items.join(", ");
+}
+function timestampToDate(value) {
+    const n = numberField(value);
+    if (n == null || n <= 0)
+        return null;
+    const date = new Date(n * 1000);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
+}
+export function pickLatestFlathubRelease(value) {
+    if (!Array.isArray(value))
+        return { date: null, version: null };
+    const releases = [...value].sort((a, b) => (numberField(b.timestamp) ?? 0) - (numberField(a.timestamp) ?? 0));
+    const latest = releases[0];
+    if (!latest)
+        return { date: null, version: null };
+    return {
+        version: stringField(latest.version) || null,
+        date: timestampToDate(latest.timestamp) ?? stringField(latest.date) ?? null,
+    };
+}
+export function mapFlathubSearchRows(hits, limit) {
+    return hits.slice(0, limit).map((hit, index) => {
+        const appId = stringField(hit.app_id);
+        return {
+            rank: index + 1,
+            appId,
+            name: stringField(hit.name),
+            summary: stringField(hit.summary),
+            developer: stringField(hit.developer_name),
+            license: stringField(hit.project_license),
+            isFreeLicense: hit.is_free_license === true,
+            mainCategories: stringField(hit.main_categories) ||
+                joinFlathubList(hit.main_categories),
+            installsLastMonth: numberField(hit.installs_last_month),
+            updatedAt: timestampToDate(hit.updated_at) ?? stringField(hit.updated_at),
+            url: appId ? `${APP_BASE}/${appId}` : "",
+        };
+    });
+}
+export function mapFlathubAppRow(appId, body) {
+    const urls = objectField(body.urls);
+    const release = pickLatestFlathubRelease(body.releases);
+    return {
+        appId: stringField(body.id) || appId,
+        name: stringField(body.name),
+        summary: stringField(body.summary),
+        developer: stringField(body.developer_name),
+        license: stringField(body.project_license),
+        isFreeLicense: body.is_free_license === true,
+        isEol: body.is_eol === true,
+        categories: joinFlathubList(body.categories),
+        keywords: joinFlathubList(body.keywords, 8),
+        latestVersion: release.version,
+        latestReleaseDate: release.date,
+        homepage: stringField(urls.homepage) || null,
+        bugtracker: stringField(urls.bugtracker) || null,
+        donation: stringField(urls.donation) || null,
+        url: `${APP_BASE}/${appId}`,
+    };
+}
+async function fetchJson(url, label, init) {
+    const response = await fetch(url, {
+        ...init,
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-flathub (https://github.com/olo-dot-io/Uni-CLI)",
+            ...init?.headers,
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "flathub",
+    name: "search",
+    description: "Search Flathub apps by keyword",
+    domain: "flathub.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search keyword",
+        },
+        { name: "limit", type: "int", default: 25, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "appId",
+        "name",
+        "summary",
+        "developer",
+        "license",
+        "isFreeLicense",
+        "mainCategories",
+        "installsLastMonth",
+        "updatedAt",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const limit = requireFlathubLimit(kwargs.limit);
+        const body = (await fetchJson(`${API_BASE}/search`, "flathub search", {
+            body: JSON.stringify({ hitsPerPage: limit, page: 1, query }),
+            headers: { "content-type": "application/json" },
+            method: "POST",
+        }));
+        const rows = mapFlathubSearchRows(Array.isArray(body.hits)
+            ? body.hits
+            : [], limit);
+        if (rows.length === 0)
+            throw new Error(`flathub search returned no rows for "${query}".`);
+        return rows;
+    },
+});
+cli({
+    site: "flathub",
+    name: "app",
+    description: "Fetch full Flathub appstream metadata by app id",
+    domain: "flathub.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "appId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "AppStream id",
+        },
+    ],
+    columns: [
+        "appId",
+        "name",
+        "summary",
+        "developer",
+        "license",
+        "isFreeLicense",
+        "isEol",
+        "categories",
+        "keywords",
+        "latestVersion",
+        "latestReleaseDate",
+        "homepage",
+        "bugtracker",
+        "donation",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const appId = requireFlathubAppId(kwargs.appId);
+        const body = objectField(await fetchJson(`${API_BASE}/appstream/${encodeURIComponent(appId)}`, "flathub app"));
+        if (!body.id)
+            throw new Error(`flathub app returned no row for "${appId}".`);
+        return [mapFlathubAppRow(appId, body)];
+    },
+});
+//# sourceMappingURL=apps.js.map

package/dist/adapters/flathub/apps.js.map

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

package/dist/adapters/goproxy/module.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @owner   src/adapters/goproxy/module.ts
+ * @does    Register agent-facing Go module proxy metadata and version commands.
+ * @needs   Public proxy.golang.org GOPROXY protocol, TypeScript adapter loader, Go module path validation.
+ * @feeds   surface coverage ledger, Go package registry command surface, agent-readable module rows.
+ * @breaks  GOPROXY protocol drift, weak module path validation, or silent empty rows hide module lookup failures.
+ */
+interface GoProxyLatest {
+    Version?: unknown;
+    Time?: unknown;
+    Origin?: {
+        VCS?: unknown;
+        URL?: unknown;
+        Hash?: unknown;
+        Ref?: unknown;
+    };
+}
+export declare function requireGoModulePath(value: unknown): string;
+export declare function requireGoProxyLimit(value: unknown, fallback?: number): number;
+export declare function sortGoVersionsDescending(versions: string[]): string[];
+export declare function mapGoProxyModuleRow(modulePath: string, detail: GoProxyLatest): Record<string, unknown>;
+export declare function mapGoProxyVersionRows(modulePath: string, versions: string[], limit: number): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/adapters/goproxy/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/adapters/goproxy/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAiBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CASzE;AAwDD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAIrE;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAehC"}

package/dist/adapters/goproxy/module.js

@@ -0,0 +1,221 @@
+/**
+ * @owner   src/adapters/goproxy/module.ts
+ * @does    Register agent-facing Go module proxy metadata and version commands.
+ * @needs   Public proxy.golang.org GOPROXY protocol, TypeScript adapter loader, Go module path validation.
+ * @feeds   surface coverage ledger, Go package registry command surface, agent-readable module rows.
+ * @breaks  GOPROXY protocol drift, weak module path validation, or silent empty rows hide module lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const GOPROXY_BASE = "https://proxy.golang.org";
+const MODULE_PATH_RE = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,199}$/;
+const VERSION_TAG_RE = /^v[0-9]+(\.[0-9]+)*([-+][A-Za-z0-9._-]+)?$/;
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function trimDate(value) {
+    const text = stringField(value).trim();
+    if (!text)
+        return null;
+    const noFraction = text.replace(/\.\d+/, "");
+    return noFraction.endsWith("Z")
+        ? noFraction
+        : text.length >= 10
+            ? text.slice(0, 10)
+            : null;
+}
+export function requireGoModulePath(value) {
+    const modulePath = String(value ?? "").trim();
+    if (!modulePath)
+        throw new Error("goproxy module path is required.");
+    if (!MODULE_PATH_RE.test(modulePath) || !modulePath.includes("/")) {
+        throw new Error(`goproxy module path "${String(value)}" is not recognised.`);
+    }
+    return modulePath;
+}
+export function requireGoProxyLimit(value, fallback = 30) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 200) {
+        throw new Error(`goproxy limit must be an integer in [1, 200]. Got: ${String(value)}`);
+    }
+    return n;
+}
+function encodeModulePath(modulePath) {
+    return modulePath.split("/").map(encodeURIComponent).join("/");
+}
+function parseSemver(tag) {
+    const stripped = tag.replace(/^v/, "");
+    const noBuild = stripped.split("+")[0] ?? stripped;
+    const dash = noBuild.indexOf("-");
+    const head = dash >= 0 ? noBuild.slice(0, dash) : noBuild;
+    const pre = dash >= 0 ? noBuild.slice(dash + 1) : "";
+    return {
+        numbers: head.split(".").map((part) => {
+            const n = Number.parseInt(part, 10);
+            return Number.isFinite(n) ? n : 0;
+        }),
+        pre,
+    };
+}
+function comparePrerelease(left, right) {
+    const leftParts = left.split(".");
+    const rightParts = right.split(".");
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let i = 0; i < length; i += 1) {
+        const a = leftParts[i];
+        const b = rightParts[i];
+        if (a == null)
+            return -1;
+        if (b == null)
+            return 1;
+        const aNum = /^\d+$/.test(a);
+        const bNum = /^\d+$/.test(b);
+        if (aNum && bNum) {
+            const diff = Number(a) - Number(b);
+            if (diff !== 0)
+                return diff;
+            continue;
+        }
+        if (aNum !== bNum)
+            return aNum ? -1 : 1;
+        if (a !== b)
+            return a < b ? -1 : 1;
+    }
+    return 0;
+}
+function compareSemver(left, right) {
+    const a = parseSemver(left);
+    const b = parseSemver(right);
+    const length = Math.max(a.numbers.length, b.numbers.length);
+    for (let i = 0; i < length; i += 1) {
+        const diff = (a.numbers[i] ?? 0) - (b.numbers[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    if (a.pre === "" && b.pre !== "")
+        return 1;
+    if (a.pre !== "" && b.pre === "")
+        return -1;
+    return comparePrerelease(a.pre, b.pre);
+}
+export function sortGoVersionsDescending(versions) {
+    return versions
+        .filter((version) => VERSION_TAG_RE.test(version))
+        .sort((a, b) => compareSemver(b, a));
+}
+export function mapGoProxyModuleRow(modulePath, detail) {
+    if (!detail.Version) {
+        throw new Error(`proxy.golang.org returned no @latest entry for "${modulePath}".`);
+    }
+    const origin = detail.Origin ?? {};
+    const encoded = encodeModulePath(modulePath);
+    return {
+        module: modulePath,
+        version: stringField(detail.Version),
+        publishedAt: trimDate(detail.Time),
+        vcs: stringField(origin.VCS).trim(),
+        repository: stringField(origin.URL).trim(),
+        commit: stringField(origin.Hash).trim(),
+        ref: stringField(origin.Ref).trim(),
+        pkgGoDevUrl: `https://pkg.go.dev/${modulePath}`,
+        url: `${GOPROXY_BASE}/${encoded}/@latest`,
+    };
+}
+export function mapGoProxyVersionRows(modulePath, versions, limit) {
+    const encoded = encodeModulePath(modulePath);
+    const sorted = sortGoVersionsDescending(versions).slice(0, limit);
+    if (sorted.length === 0) {
+        throw new Error(`"${modulePath}" has no semver-shaped tags on proxy.golang.org.`);
+    }
+    return sorted.map((version, index) => ({
+        rank: index + 1,
+        module: modulePath,
+        version,
+        publishedAt: null,
+        url: `${GOPROXY_BASE}/${encoded}/@v/${encodeURIComponent(version)}.info`,
+    }));
+}
+async function fetchGoProxy(url, label) {
+    const response = await fetch(url, {
+        headers: { "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)" },
+    });
+    if (response.status === 404 || response.status === 410)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response;
+}
+cli({
+    site: "goproxy",
+    name: "module",
+    description: "Latest version and VCS origin metadata for a Go module",
+    domain: "proxy.golang.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "module",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Go module path",
+        },
+    ],
+    columns: [
+        "module",
+        "version",
+        "publishedAt",
+        "vcs",
+        "repository",
+        "commit",
+        "ref",
+        "pkgGoDevUrl",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const modulePath = requireGoModulePath(kwargs.module);
+        const response = await fetchGoProxy(`${GOPROXY_BASE}/${encodeModulePath(modulePath)}/@latest`, `goproxy module ${modulePath}`);
+        return [
+            mapGoProxyModuleRow(modulePath, (await response.json())),
+        ];
+    },
+});
+cli({
+    site: "goproxy",
+    name: "versions",
+    description: "Published version tags for a Go module",
+    domain: "proxy.golang.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "module",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Go module path",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 30,
+            description: "Max rows",
+        },
+    ],
+    columns: ["rank", "module", "version", "publishedAt", "url"],
+    func: async (_page, kwargs) => {
+        const modulePath = requireGoModulePath(kwargs.module);
+        const limit = requireGoProxyLimit(kwargs.limit);
+        const response = await fetchGoProxy(`${GOPROXY_BASE}/${encodeModulePath(modulePath)}/@v/list`, `goproxy versions ${modulePath}`);
+        const versions = (await response.text())
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        if (versions.length === 0) {
+            throw new Error(`proxy.golang.org returned no published versions for "${modulePath}".`);
+        }
+        return mapGoProxyVersionRows(modulePath, versions, limit);
+    },
+});
+//# sourceMappingURL=module.js.map

package/dist/adapters/goproxy/module.js.map

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

package/dist/adapters/grok/web.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @owner   src/adapters/grok/web.ts
+ * @does    Register agent-facing Grok web commands implemented with site-specific safety checks.
+ * @needs   Logged-in grok.com browser session, Grok chat DOM, optional local image output directory.
+ * @feeds   surface coverage ledger and Grok read/history/detail/send/new/status/image workflows.
+ * @breaks  Grok DOM drift or weak UUID validation can miss or target the wrong conversation.
+ */
+interface GrokBubble {
+    id?: unknown;
+    role?: unknown;
+    text?: unknown;
+    html?: unknown;
+}
+interface GrokImage {
+    src: string;
+    w: number;
+    h: number;
+}
+export declare function normalizeGrokBoolean(value: unknown, fallback?: boolean): boolean;
+export declare function parseGrokSessionId(value: unknown): string;
+export declare function grokHtmlToMarkdown(value: unknown): string;
+export declare function mapGrokBubbles(bubbles: GrokBubble[], wantMarkdown: boolean): Record<string, unknown>[];
+export declare function mapGrokSessions(sessions: {
+    id?: unknown;
+    title?: unknown;
+}[]): Record<string, unknown>[];
+export declare function pickLatestGrokImages(bubbleImageSets: GrokImage[][], baselineCount: number): GrokImage[];
+export {};
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/grok/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/grok/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,UAAQ,GACf,OAAO,CAIT;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgCzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAezD;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,EACrB,YAAY,EAAE,OAAO,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,SAAS,EAAE,EAAE,EAC9B,aAAa,EAAE,MAAM,GACpB,SAAS,EAAE,CAMb"}