@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/wikidata/entities.js

@@ -0,0 +1,219 @@
+/**
+ * @owner   src/adapters/wikidata/entities.ts
+ * @does    Register agent-facing Wikidata entity search and detail commands.
+ * @needs   Wikidata public APIs, language validation, Q/P/L entity id validation.
+ * @feeds   surface coverage ledger, Wikidata search rows, entity summary rows.
+ * @breaks  Wikidata API drift, weak id validation, or silent empty rows hide entity lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://www.wikidata.org";
+const ENTITY_ID_RE = /^[QPL]\d+$/;
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`wikidata ${label} cannot be empty.`);
+    return text;
+}
+export function requireWikidataLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 20 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+        throw new Error("wikidata limit must be an integer in [1, 50].");
+    }
+    return limit;
+}
+export function requireWikidataLanguage(value) {
+    const language = String(value ?? "en")
+        .trim()
+        .toLowerCase();
+    if (!/^[a-z]{2,3}(-[a-z]{2,8})?$/.test(language)) {
+        throw new Error(`wikidata language "${String(value)}" is not valid.`);
+    }
+    return language;
+}
+export function requireWikidataEntityId(value) {
+    const raw = String(value ?? "")
+        .trim()
+        .toUpperCase();
+    if (!raw)
+        throw new Error("wikidata entity id cannot be empty.");
+    const id = raw.replace(/^HTTPS?:\/\/[^/]+\/WIKI\//i, "");
+    if (!ENTITY_ID_RE.test(id)) {
+        throw new Error(`wikidata entity id "${String(value)}" is not valid.`);
+    }
+    return id;
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function pickLocalizedValue(map, language) {
+    const values = objectField(map);
+    const direct = objectField(values[language]);
+    if (stringField(direct.value))
+        return stringField(direct.value);
+    const english = objectField(values.en);
+    return stringField(english.value) || null;
+}
+export function joinLocalizedAliases(value, language, max = 5) {
+    const aliases = objectField(value);
+    const direct = Array.isArray(aliases[language]) ? aliases[language] : [];
+    const fallback = Array.isArray(aliases.en) ? aliases.en : [];
+    const list = direct.length > 0 ? direct : fallback;
+    const names = list
+        .map((item) => stringField(objectField(item).value))
+        .filter(Boolean);
+    return names.length > max
+        ? [...names.slice(0, max), `(+${names.length - max})`].join(", ")
+        : names.join(", ");
+}
+export function mapWikidataSearchRows(rows, limit) {
+    return rows.slice(0, limit).map((row, index) => {
+        const qid = stringField(row.id);
+        const match = objectField(row.match);
+        return {
+            rank: index + 1,
+            qid,
+            label: stringField(row.label),
+            description: stringField(row.description),
+            matchType: stringField(match.type),
+            matchText: stringField(match.text),
+            url: qid ? `${API_BASE}/wiki/${qid}` : "",
+        };
+    });
+}
+export function mapWikidataEntityRow(id, entity, language) {
+    const claims = objectField(entity.claims);
+    const sitelinks = objectField(entity.sitelinks);
+    const enwiki = objectField(sitelinks.enwiki);
+    return {
+        qid: id,
+        type: stringField(entity.type),
+        label: pickLocalizedValue(entity.labels, language),
+        description: pickLocalizedValue(entity.descriptions, language),
+        aliases: joinLocalizedAliases(entity.aliases, language),
+        claimPropertyCount: Object.keys(claims).length,
+        sitelinkCount: Object.keys(sitelinks).length,
+        enwikiTitle: stringField(enwiki.title) || null,
+        modified: stringField(entity.modified) || null,
+        url: `${API_BASE}/wiki/${id}`,
+    };
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-wikidata (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    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: "wikidata",
+    name: "search",
+    description: "Search Wikidata items by keyword",
+    domain: "www.wikidata.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search keyword",
+        },
+        {
+            name: "language",
+            type: "str",
+            default: "en",
+            description: "Language code",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "qid",
+        "label",
+        "description",
+        "matchType",
+        "matchText",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const language = requireWikidataLanguage(kwargs.language);
+        const limit = requireWikidataLimit(kwargs.limit);
+        const url = new URL(`${API_BASE}/w/api.php`);
+        url.searchParams.set("action", "wbsearchentities");
+        url.searchParams.set("search", query);
+        url.searchParams.set("language", language);
+        url.searchParams.set("uselang", language);
+        url.searchParams.set("type", "item");
+        url.searchParams.set("format", "json");
+        url.searchParams.set("limit", String(limit));
+        url.searchParams.set("origin", "*");
+        const body = (await fetchJson(url, "wikidata search"));
+        const rows = mapWikidataSearchRows(Array.isArray(body.search)
+            ? body.search
+            : [], limit);
+        if (rows.length === 0) {
+            throw new Error(`wikidata search returned no rows for "${query}".`);
+        }
+        return rows;
+    },
+});
+cli({
+    site: "wikidata",
+    name: "entity",
+    description: "Fetch a Wikidata entity by Q/P/L id",
+    domain: "www.wikidata.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Entity id",
+        },
+        {
+            name: "language",
+            type: "str",
+            default: "en",
+            description: "Language code",
+        },
+    ],
+    columns: [
+        "qid",
+        "type",
+        "label",
+        "description",
+        "aliases",
+        "claimPropertyCount",
+        "sitelinkCount",
+        "enwikiTitle",
+        "modified",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireWikidataEntityId(kwargs.id);
+        const language = requireWikidataLanguage(kwargs.language);
+        const body = objectField(await fetchJson(`${API_BASE}/wiki/Special:EntityData/${encodeURIComponent(id)}.json`, "wikidata entity"));
+        const entity = objectField(objectField(body.entities)[id]);
+        if (!entity.id && !entity.type) {
+            throw new Error(`wikidata entity returned no row for "${id}".`);
+        }
+        return [mapWikidataEntityRow(id, entity, language)];
+    },
+});
+//# sourceMappingURL=entities.js.map

package/dist/adapters/wikidata/entities.js.map

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

package/dist/adapters/wikipedia/page.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner   src/adapters/wikipedia/page.ts
+ * @does    Register agent-facing full Wikipedia page extract command.
+ * @needs   MediaWiki Action API, language validation, explicit paragraph caps.
+ * @feeds   surface coverage ledger, encyclopedia article reading workflow.
+ * @breaks  MediaWiki envelope drift or silent extract truncation hides article content.
+ */
+interface WikiPage {
+    title?: unknown;
+    description?: unknown;
+    pageid?: unknown;
+    extract?: unknown;
+    fullurl?: unknown;
+    missing?: unknown;
+}
+export declare function requireWikiTitle(value: unknown): string;
+export declare function requireWikiLang(value: unknown): string;
+export declare function requireParagraphCap(value: unknown): number;
+export declare function mapWikipediaPageRow(page: WikiPage | undefined, lang: string, requestedTitle: string, paragraphCap: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=page.d.ts.map

package/dist/adapters/wikipedia/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/adapters/wikipedia/page.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIvD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO1D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}

package/dist/adapters/wikipedia/page.js

@@ -0,0 +1,116 @@
+/**
+ * @owner   src/adapters/wikipedia/page.ts
+ * @does    Register agent-facing full Wikipedia page extract command.
+ * @needs   MediaWiki Action API, language validation, explicit paragraph caps.
+ * @feeds   surface coverage ledger, encyclopedia article reading workflow.
+ * @breaks  MediaWiki envelope drift or silent extract truncation hides article content.
+ */
+import { cli, Strategy } from "../../registry.js";
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+export function requireWikiTitle(value) {
+    const title = String(value ?? "").trim();
+    if (!title)
+        throw new Error("wikipedia page title cannot be empty.");
+    return title;
+}
+export function requireWikiLang(value) {
+    const lang = String(value ?? "en")
+        .trim()
+        .toLowerCase();
+    if (!/^[a-z]{2,3}(?:-[a-z0-9]+)?$/.test(lang)) {
+        throw new Error(`wikipedia lang must be a language code, got "${String(value)}".`);
+    }
+    return lang;
+}
+export function requireParagraphCap(value) {
+    if (value === undefined || value === null || value === "")
+        return 0;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error("paragraphs must be a non-negative integer.");
+    }
+    return n;
+}
+export function mapWikipediaPageRow(page, lang, requestedTitle, paragraphCap) {
+    if (!page || page.missing) {
+        throw new Error(`No Wikipedia article "${requestedTitle}" on ${lang}.wikipedia.org.`);
+    }
+    const fullExtract = stringField(page.extract);
+    if (!fullExtract.trim()) {
+        throw new Error(`Wikipedia article "${stringField(page.title) || requestedTitle}" has no plain-text extract.`);
+    }
+    const paragraphs = fullExtract
+        .split(/\n{2,}/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const selected = paragraphCap > 0 ? paragraphs.slice(0, paragraphCap) : paragraphs;
+    const title = stringField(page.title) || requestedTitle;
+    return {
+        title,
+        description: stringField(page.description),
+        pageId: page.pageid ?? null,
+        paragraphs: selected.length,
+        extract: selected.join("\n\n"),
+        url: stringField(page.fullurl) ||
+            `https://${lang}.wikipedia.org/wiki/${encodeURIComponent(title.replace(/ /g, "_"))}`,
+    };
+}
+async function fetchWikipediaPage(lang, title) {
+    const url = new URL(`https://${lang}.wikipedia.org/w/api.php`);
+    url.searchParams.set("action", "query");
+    url.searchParams.set("format", "json");
+    url.searchParams.set("formatversion", "2");
+    url.searchParams.set("prop", "extracts|info|description");
+    url.searchParams.set("inprop", "url");
+    url.searchParams.set("explaintext", "1");
+    url.searchParams.set("redirects", "1");
+    url.searchParams.set("titles", title);
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": "unicli-wikipedia/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (!response.ok)
+        throw new Error(`wikipedia page returned HTTP ${response.status}.`);
+    const data = (await response.json());
+    if (data.error) {
+        throw new Error(`wikipedia API error: ${stringField(data.error.info) || stringField(data.error.code)}`);
+    }
+    return Array.isArray(data.query?.pages) ? data.query.pages[0] : {};
+}
+cli({
+    site: "wikipedia",
+    name: "page",
+    description: "Full plain-text extract of a Wikipedia article",
+    domain: "wikipedia.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "title",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Article title",
+        },
+        { name: "lang", type: "str", default: "en", description: "Language code" },
+        {
+            name: "paragraphs",
+            type: "int",
+            default: 0,
+            description: "Paragraph cap, 0 means full",
+        },
+    ],
+    columns: ["title", "description", "pageId", "paragraphs", "extract", "url"],
+    func: async (_page, kwargs) => {
+        const title = requireWikiTitle(kwargs.title);
+        const lang = requireWikiLang(kwargs.lang);
+        const paragraphCap = requireParagraphCap(kwargs.paragraphs);
+        return [
+            mapWikipediaPageRow(await fetchWikipediaPage(lang, title), lang, title, paragraphCap),
+        ];
+    },
+});
+//# sourceMappingURL=page.js.map

package/dist/adapters/wikipedia/page.js.map

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

package/dist/adapters/wttr/weather.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @owner   src/adapters/wttr/weather.ts
+ * @does    Register agent-facing wttr current weather and forecast commands.
+ * @needs   wttr.in JSON endpoint, bounded forecast days, explicit empty-result errors.
+ * @feeds   surface coverage ledger, weather lookup rows, global public weather coverage.
+ * @breaks  wttr.in schema drift, non-JSON unknown-location responses, or silent empty rows hide weather failures.
+ */
+export declare function requireWttrDays(value: unknown): number;
+export declare function pickWeatherDescription(value: unknown): string;
+export declare function mapCurrentWeatherRow(body: Record<string, unknown>, fallbackLocation: string): Record<string, unknown>;
+export declare function mapForecastRows(body: Record<string, unknown>, days: number, fallbackLocation: string): Array<Record<string, unknown>>;
+//# sourceMappingURL=weather.d.ts.map

package/dist/adapters/wttr/weather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.d.ts","sourceRoot":"","sources":["../../../src/adapters/wttr/weather.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAgBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7D;AAQD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GACvB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgChC"}

package/dist/adapters/wttr/weather.js

@@ -0,0 +1,207 @@
+/**
+ * @owner   src/adapters/wttr/weather.ts
+ * @does    Register agent-facing wttr current weather and forecast commands.
+ * @needs   wttr.in JSON endpoint, bounded forecast days, explicit empty-result errors.
+ * @feeds   surface coverage ledger, weather lookup rows, global public weather coverage.
+ * @breaks  wttr.in schema drift, non-JSON unknown-location responses, or silent empty rows hide weather failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://wttr.in";
+function requireLocation(value) {
+    const location = String(value ?? "").trim();
+    if (!location)
+        throw new Error("wttr location cannot be empty.");
+    return location;
+}
+export function requireWttrDays(value) {
+    const raw = value === undefined || value === null || value === "" ? 3 : value;
+    const days = Number(raw);
+    if (!Number.isInteger(days) || days < 1 || days > 3) {
+        throw new Error("wttr days must be an integer in [1, 3].");
+    }
+    return days;
+}
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+export function pickWeatherDescription(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return "";
+    const first = value[0];
+    return typeof first.value === "string" ? first.value.trim() : "";
+}
+function firstArrayItem(value) {
+    return Array.isArray(value) && value[0] && typeof value[0] === "object"
+        ? value[0]
+        : null;
+}
+export function mapCurrentWeatherRow(body, fallbackLocation) {
+    const current = firstArrayItem(body.current_condition);
+    if (!current)
+        throw new Error(`wttr current returned no conditions for "${fallbackLocation}".`);
+    const area = firstArrayItem(body.nearest_area);
+    return {
+        location: pickWeatherDescription(area?.areaName) || fallbackLocation,
+        region: pickWeatherDescription(area?.region),
+        country: pickWeatherDescription(area?.country),
+        latitude: stringField(area?.latitude),
+        longitude: stringField(area?.longitude),
+        observedAt: stringField(current.localObsDateTime),
+        tempC: numberField(current.temp_C),
+        tempF: numberField(current.temp_F),
+        feelsLikeC: numberField(current.FeelsLikeC),
+        feelsLikeF: numberField(current.FeelsLikeF),
+        description: pickWeatherDescription(current.weatherDesc),
+        humidity: numberField(current.humidity),
+        cloudCover: numberField(current.cloudcover),
+        pressure: numberField(current.pressure),
+        precipMm: numberField(current.precipMM),
+        visibilityKm: numberField(current.visibility),
+        uvIndex: numberField(current.uvIndex),
+        windKmph: numberField(current.windspeedKmph),
+        windDirection: stringField(current.winddir16Point),
+        windDirectionDegree: numberField(current.winddirDegree),
+    };
+}
+export function mapForecastRows(body, days, fallbackLocation) {
+    const list = Array.isArray(body.weather)
+        ? body.weather
+        : [];
+    if (list.length === 0) {
+        throw new Error(`wttr forecast returned no rows for "${fallbackLocation}".`);
+    }
+    return list.slice(0, days).map((day, index) => {
+        const hourly = Array.isArray(day.hourly)
+            ? day.hourly
+            : [];
+        const noon = hourly[4] ?? hourly[0] ?? {};
+        const astro = firstArrayItem(day.astronomy);
+        return {
+            rank: index + 1,
+            date: stringField(day.date),
+            minTempC: numberField(day.mintempC),
+            maxTempC: numberField(day.maxtempC),
+            avgTempC: numberField(day.avgtempC),
+            minTempF: numberField(day.mintempF),
+            maxTempF: numberField(day.maxtempF),
+            avgTempF: numberField(day.avgtempF),
+            sunHour: numberField(day.sunHour),
+            totalSnowCm: numberField(day.totalSnow_cm),
+            uvIndex: numberField(day.uvIndex),
+            description: pickWeatherDescription(noon.weatherDesc),
+            sunrise: stringField(astro?.sunrise),
+            sunset: stringField(astro?.sunset),
+        };
+    });
+}
+async function fetchWeather(location, label) {
+    const url = new URL(`${API_BASE}/${encodeURIComponent(location)}`);
+    url.searchParams.set("format", "j1");
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-wttr (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    try {
+        return (await response.json());
+    }
+    catch {
+        throw new Error(`${label} returned non-JSON weather data for "${location}".`);
+    }
+}
+cli({
+    site: "wttr",
+    name: "current",
+    description: "Current weather conditions for a location",
+    domain: "wttr.in",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "location",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "City, lat/lon, airport code, or domain location",
+        },
+    ],
+    columns: [
+        "location",
+        "region",
+        "country",
+        "latitude",
+        "longitude",
+        "observedAt",
+        "tempC",
+        "tempF",
+        "feelsLikeC",
+        "feelsLikeF",
+        "description",
+        "humidity",
+        "cloudCover",
+        "pressure",
+        "precipMm",
+        "visibilityKm",
+        "uvIndex",
+        "windKmph",
+        "windDirection",
+        "windDirectionDegree",
+    ],
+    func: async (_page, kwargs) => {
+        const location = requireLocation(kwargs.location);
+        return [
+            mapCurrentWeatherRow(await fetchWeather(location, "wttr current"), location),
+        ];
+    },
+});
+cli({
+    site: "wttr",
+    name: "forecast",
+    description: "Multi-day weather forecast for a location",
+    domain: "wttr.in",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "location",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "City, lat/lon, airport code, or domain location",
+        },
+        { name: "days", type: "int", default: 3, description: "Forecast days" },
+    ],
+    columns: [
+        "rank",
+        "date",
+        "minTempC",
+        "maxTempC",
+        "avgTempC",
+        "minTempF",
+        "maxTempF",
+        "avgTempF",
+        "sunHour",
+        "totalSnowCm",
+        "uvIndex",
+        "description",
+        "sunrise",
+        "sunset",
+    ],
+    func: async (_page, kwargs) => {
+        const location = requireLocation(kwargs.location);
+        const days = requireWttrDays(kwargs.days);
+        return mapForecastRows(await fetchWeather(location, "wttr forecast"), days, location);
+    },
+});
+//# sourceMappingURL=weather.js.map

package/dist/adapters/wttr/weather.js.map

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

package/dist/adapters/xianyu/publish.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @owner   src/adapters/xianyu/publish.ts
+ * @does    Register agent-facing Xianyu publish automation implemented with site-specific safety checks.
+ * @needs   Logged-in goofish.com browser session, stable publish form selectors, and optional local image files.
+ * @feeds   surface coverage ledger and Xianyu listing publishing workflows.
+ * @breaks  Goofish publish-form DOM drift, category chooser changes, or upload input changes.
+ */
+interface XianyuPublishArgs {
+    title: string;
+    description: string;
+    price: string;
+    condition: string;
+    category: string;
+    originalPrice: string | null;
+    location: string;
+    images: string[];
+}
+export declare function buildXianyuPublishUrl(): string;
+export declare function requireXianyuText(value: unknown, label: string): string;
+export declare function parseXianyuPositivePrice(value: unknown, label: string): string | null;
+export declare function validateXianyuCondition(value: unknown): string;
+export declare function validateXianyuImagePaths(value: unknown): string[];
+export declare function normalizeXianyuPublishArgs(kwargs: Record<string, unknown>): XianyuPublishArgs;
+export declare function buildXianyuPageStateScript(): string;
+export declare function buildXianyuFillFormScript(data: XianyuPublishArgs): string;
+export declare function buildXianyuSelectCategoryScript(categoryName: string): string;
+export declare function buildXianyuFindFileInputScript(): string;
+export declare function buildXianyuSubmitScript(): string;
+export declare function buildXianyuDetectSuccessScript(): string;
+export {};
+//# sourceMappingURL=publish.d.ts.map

package/dist/adapters/xianyu/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/adapters/xianyu/publish.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAeD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAaf;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBjE;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAkBnB;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAOnD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAoEzE;AAED,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA4B5E;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAUvD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAahD;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAmBvD"}