@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/espacenet/family.js

@@ -0,0 +1,118 @@
+/**
+ * @owner       src::adapters::espacenet::family
+ * @does        Browser-driven Espacenet family lookup — DOCDB simple-family rows visible on the family tab of the detail page; alternative to EPO OPS keyed family broker.
+ * @needs       src/engine/transport/mcp-browser.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.family)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output rows carry publication_number + jurisdiction + relationship per PatentFamilyMember shape
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (transport-error shared path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { espacenetEnvelope, espacenetNavigateAndExtract, transportErrorToEspacenetEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/espacenet/family.ts";
+const FAMILY_EXTRACTOR = `(() => {
+  const rows = Array.from(
+    document.querySelectorAll('[data-test="family-row"], .familyRow, tr.family-member')
+  ).map((el) => {
+    const text = (sel) => {
+      const node = el.querySelector(sel);
+      return node ? (node.textContent || '').trim() : '';
+    };
+    return {
+      publication_number: text('[data-test="publication-number"], .publicationNumber'),
+      jurisdiction: text('[data-test="country"], .country'),
+      publication_date: text('[data-test="publication-date"], .publicationDate'),
+    };
+  });
+  return { rows };
+})()`;
+function familyUrlFor(pubNo) {
+    return `https://worldwide.espacenet.com/patent/search/family/${encodeURIComponent(pubNo)}`;
+}
+export async function runEspacenetFamily(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "espacenet family requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = familyUrlFor(pubNo);
+    let extract;
+    try {
+        const result = await espacenetNavigateAndExtract(url, FAMILY_EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: espacenetEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "espacenet family evaluate returned no data"),
+                },
+            ];
+        }
+        extract = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEspacenetEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (extract.rows.length === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `espacenet found no family members for "${pubNo}"`, ["epo"]),
+            },
+        ];
+    }
+    return extract.rows
+        .filter((row) => row.publication_number)
+        .map((row) => ({
+        publication_number: row.publication_number,
+        jurisdiction: row.jurisdiction || row.publication_number.slice(0, 2).toUpperCase(),
+        relationship: "simple_family",
+        publication_date: row.publication_date || undefined,
+        source_adapter: "espacenet",
+    }));
+}
+cli({
+    site: "espacenet",
+    name: "family",
+    description: "Espacenet DOCDB simple-family lookup (browser)",
+    domain: "worldwide.espacenet.com",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number",
+        },
+    ],
+    columns: [
+        "publication_number",
+        "jurisdiction",
+        "relationship",
+        "publication_date",
+    ],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.family",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runEspacenetFamily(kwargs),
+});
+//# sourceMappingURL=family.js.map

package/dist/adapters/espacenet/family.js.map

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

package/dist/adapters/espacenet/get.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::espacenet::get
+ * @does        Browser-driven retrieval of a single Espacenet publication detail page; extracts bibliographic fields and emits a PatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.get)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED with MCP_BUS_MISSING
+ * @invariants  output is a single PatentRecord row when upstream answers; never returns a stub
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runEspacenetGet(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=get.d.ts.map

package/dist/adapters/espacenet/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/adapters/espacenet/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmDH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA6FrB"}

package/dist/adapters/espacenet/get.js

@@ -0,0 +1,130 @@
+/**
+ * @owner       src::adapters::espacenet::get
+ * @does        Browser-driven retrieval of a single Espacenet publication detail page; extracts bibliographic fields and emits a PatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.get)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED with MCP_BUS_MISSING
+ * @invariants  output is a single PatentRecord row when upstream answers; never returns a stub
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { espacenetEnvelope, espacenetNavigateAndExtract, transportErrorToEspacenetEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/espacenet/get.ts";
+const DETAIL_EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-test="publication-number"], .publicationNumber'),
+    application_number: text('[data-test="application-number"], .applicationNumber'),
+    title: text('[data-test="title"], h1.title, .invention-title'),
+    abstract: text('[data-test="abstract"], .abstract'),
+    applicant: text('[data-test="applicant"], .applicantName'),
+    inventor: text('[data-test="inventor"], .inventorName'),
+    publication_date: text('[data-test="publication-date"], .publicationDate'),
+    filing_date: text('[data-test="filing-date"], .filingDate'),
+    source_url: location.href,
+    html_marker: document.body && document.body.innerText
+      ? document.body.innerText.slice(0, 200)
+      : '',
+  };
+})()`;
+function detailUrlFor(pubNo) {
+    return `https://worldwide.espacenet.com/patent/search/publication/${encodeURIComponent(pubNo)}`;
+}
+export async function runEspacenetGet(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "espacenet get requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = detailUrlFor(pubNo);
+    let detail;
+    try {
+        const result = await espacenetNavigateAndExtract(url, DETAIL_EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: espacenetEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "espacenet detail evaluate returned no data"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEspacenetEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    const fieldCount = [detail.publication_number, detail.title].filter(Boolean).length;
+    if (fieldCount === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `espacenet detail page for "${pubNo}" yielded no bibliographic fields`, ["epo", "uspto"]),
+            },
+        ];
+    }
+    const canonicalPubNo = detail.publication_number || pubNo;
+    try {
+        return [
+            assemblePatentRecord({
+                publication_number: canonicalPubNo,
+                application_number: detail.application_number || undefined,
+                title: detail.title || undefined,
+                abstract: detail.abstract || undefined,
+                assignees: detail.applicant ? [{ name: detail.applicant }] : undefined,
+                inventors: detail.inventor ? [{ name: detail.inventor }] : undefined,
+                publication_date: detail.publication_date || undefined,
+                filing_date: detail.filing_date || undefined,
+                source_adapter: "espacenet",
+                source_url: detail.source_url || url,
+            }),
+        ];
+    }
+    catch {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", `espacenet detail page for "${pubNo}" did not yield a valid publication_number`, ["epo"]),
+            },
+        ];
+    }
+}
+cli({
+    site: "espacenet",
+    name: "get",
+    description: "Retrieve a single Espacenet publication detail (browser, no key)",
+    domain: "worldwide.espacenet.com",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number (e.g. EP4123456A1)",
+        },
+    ],
+    columns: ["publication_number", "title", "publication_date", "source_url"],
+    capabilities: ["mcp-browser.navigate", "mcp-browser.evaluate", "patent.get"],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runEspacenetGet(kwargs),
+});
+//# sourceMappingURL=get.js.map

package/dist/adapters/espacenet/get.js.map

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

package/dist/adapters/espacenet/legal-status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::espacenet::legal-status
+ * @does        Browser-driven Espacenet legal-status lookup — INPADOC events table on the legal-status tab.
+ * @needs       src/engine/transport/mcp-browser.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output row carries legal_status as the most-recent INPADOC event verbatim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runEspacenetLegalStatus(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=legal-status.d.ts.map

package/dist/adapters/espacenet/legal-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal-status.d.ts","sourceRoot":"","sources":["../../../src/adapters/espacenet/legal-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoCH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuErB"}

package/dist/adapters/espacenet/legal-status.js

@@ -0,0 +1,110 @@
+/**
+ * @owner       src::adapters::espacenet::legal-status
+ * @does        Browser-driven Espacenet legal-status lookup — INPADOC events table on the legal-status tab.
+ * @needs       src/engine/transport/mcp-browser.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output row carries legal_status as the most-recent INPADOC event verbatim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { espacenetEnvelope, espacenetNavigateAndExtract, transportErrorToEspacenetEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/espacenet/legal-status.ts";
+const EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-test="publication-number"], .publicationNumber'),
+    legal_status: text('[data-test="legal-status"] tr:first-child td:nth-child(2), .legalStatus__currentStatus'),
+    status_date: text('[data-test="legal-status"] tr:first-child td:nth-child(1), .legalStatus__currentDate'),
+    source_url: location.href,
+  };
+})()`;
+function legalUrlFor(pubNo) {
+    return `https://worldwide.espacenet.com/patent/search/legal-status/${encodeURIComponent(pubNo)}`;
+}
+export async function runEspacenetLegalStatus(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "espacenet legal-status requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = legalUrlFor(pubNo);
+    let detail;
+    try {
+        const result = await espacenetNavigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: espacenetEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "espacenet legal-status evaluate returned no data"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEspacenetEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (!detail.legal_status) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `espacenet returned no legal_status for "${pubNo}"`, ["epo"]),
+            },
+        ];
+    }
+    return [
+        {
+            publication_number: detail.publication_number || pubNo,
+            legal_status: detail.legal_status,
+            status_date: detail.status_date,
+            source_adapter: "espacenet",
+            source_url: detail.source_url || url,
+            retrieved_at: new Date().toISOString(),
+        },
+    ];
+}
+cli({
+    site: "espacenet",
+    name: "legal-status",
+    description: "Espacenet INPADOC legal-status lookup (browser)",
+    domain: "worldwide.espacenet.com",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number",
+        },
+    ],
+    columns: ["publication_number", "legal_status", "status_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.legal-status",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runEspacenetLegalStatus(kwargs),
+});
+//# sourceMappingURL=legal-status.js.map

package/dist/adapters/espacenet/legal-status.js.map

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

package/dist/adapters/espacenet/search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @owner       src::adapters::espacenet::search
+ * @does        Browser-driven Espacenet front-end search at worldwide.espacenet.com/patent/search — the EPO public no-key fallback for global patent search; complements the keyed EPO OPS adapter at src/adapters/epo/*.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.search)
+ * @breaks      PATENT_API_DEPRECATED with MCP_BUS_MISSING when no outbound MCP transport; PATENT_NOT_FOUND on empty result; PATENT_BROWSER_CAPTCHA on EPO's anti-bot challenge
+ * @invariants  output rows are canonical PatentRecord; source_adapter='espacenet'
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only (distinct from EPO OPS which is keyed REST)
+ */
+export declare function runEspacenetSearch(kwargs: {
+    query: string;
+    limit?: number;
+}): Promise<unknown[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/espacenet/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/espacenet/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+DH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAkHrB"}

package/dist/adapters/espacenet/search.js

@@ -0,0 +1,165 @@
+/**
+ * @owner       src::adapters::espacenet::search
+ * @does        Browser-driven Espacenet front-end search at worldwide.espacenet.com/patent/search — the EPO public no-key fallback for global patent search; complements the keyed EPO OPS adapter at src/adapters/epo/*.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.search)
+ * @breaks      PATENT_API_DEPRECATED with MCP_BUS_MISSING when no outbound MCP transport; PATENT_NOT_FOUND on empty result; PATENT_BROWSER_CAPTCHA on EPO's anti-bot challenge
+ * @invariants  output rows are canonical PatentRecord; source_adapter='espacenet'
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only (distinct from EPO OPS which is keyed REST)
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { espacenetEnvelope, espacenetNavigateAndExtract, transportErrorToEspacenetEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/espacenet/search.ts";
+const ESPACENET_SEARCH_URL = "https://worldwide.espacenet.com/patent/search";
+const EXTRACTOR = `(() => {
+  const rows = Array.from(
+    document.querySelectorAll('article.publication, .item--ezfpdY, [data-test="result"]')
+  ).map((el) => {
+    const text = (sel) => {
+      const node = el.querySelector(sel);
+      return node ? (node.textContent || '').trim() : '';
+    };
+    const linkEl = el.querySelector('a[href*="/patent/search/family"], a[href*="/patent/search/publication"], a[href]');
+    return {
+      publication_number: text('[data-test="publication-number"], .publicationNumber, .publication__id'),
+      title: text('[data-test="title"], .publicationTitle, h3'),
+      applicant: text('[data-test="applicant"], .applicantName'),
+      inventor: text('[data-test="inventor"], .inventorName'),
+      publication_date: text('[data-test="publication-date"], .publicationDate, .publication__date'),
+      source_url: linkEl ? linkEl.href : '',
+    };
+  });
+  const html_marker = (document.body && document.body.innerText
+    ? document.body.innerText.slice(0, 200)
+    : '');
+  return { rows, html_marker };
+})()`;
+function buildSearchUrl(query, limit) {
+    // Espacenet smart-search query — `q` is the CQL-lite syntax accepted by
+    // the front-end search box. Limit is enforced client-side; Espacenet
+    // paginates server-side via the `?p=` page parameter.
+    const params = new URLSearchParams({ q: query });
+    // Espacenet shows ~25 rows per page; cap requested limit at one page so
+    // the browser does not paginate by default.
+    if (limit > 25)
+        params.set("ps", String(Math.min(100, limit)));
+    return `${ESPACENET_SEARCH_URL}?${params.toString()}`;
+}
+export async function runEspacenetSearch(kwargs) {
+    const limit = typeof kwargs.limit === "number" && Number.isFinite(kwargs.limit)
+        ? Math.max(1, Math.min(100, Math.floor(kwargs.limit)))
+        : 25;
+    const query = String(kwargs.query ?? "").trim();
+    if (query.length === 0) {
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_UNSUPPORTED_QUERY", ADAPTER_PATH, "validate", "espacenet search requires a non-empty query"),
+            },
+        ];
+    }
+    const url = buildSearchUrl(query, limit);
+    let extract;
+    try {
+        const result = await espacenetNavigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: espacenetEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "espacenet evaluate returned no data; selector schema likely changed"),
+                },
+            ];
+        }
+        extract = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEspacenetEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (extract.rows.length === 0) {
+        const marker = (extract.html_marker ?? "").toLowerCase();
+        if (marker.includes("captcha") ||
+            marker.includes("challenge") ||
+            marker.includes("are you a human")) {
+            return [
+                {
+                    envelope: espacenetEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "espacenet served an anti-bot challenge; solve it in the open browser tab and re-run", ["epo"]),
+                },
+            ];
+        }
+        return [
+            {
+                envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `espacenet returned no rows for query "${query}"`, ["epo", "uspto"]),
+            },
+        ];
+    }
+    const out = [];
+    for (const row of extract.rows.slice(0, limit)) {
+        if (!row.publication_number)
+            continue;
+        try {
+            out.push(assemblePatentRecord({
+                publication_number: row.publication_number,
+                title: row.title || undefined,
+                assignees: row.applicant ? [{ name: row.applicant }] : undefined,
+                inventors: row.inventor ? [{ name: row.inventor }] : undefined,
+                publication_date: row.publication_date || undefined,
+                source_adapter: "espacenet",
+                source_url: row.source_url || url,
+            }));
+        }
+        catch {
+            // Skip rows that fail canonicalization rather than synthesize.
+        }
+    }
+    if (out.length === 0) {
+        out.push({
+            envelope: espacenetEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", "espacenet returned rows but none carried a valid publication_number", ["epo"]),
+        });
+    }
+    return out;
+}
+cli({
+    site: "espacenet",
+    name: "search",
+    description: "Search Espacenet (EPO public no-key front end) for worldwide patents",
+    domain: "worldwide.espacenet.com",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Espacenet smart-search query (CQL-lite syntax)",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Max results (1-100)",
+        },
+    ],
+    columns: ["publication_number", "title", "publication_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.search",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runEspacenetSearch(kwargs),
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/espacenet/search.js.map

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

package/dist/adapters/facebook/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Facebook subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public Facebook video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Social video evidence gathering without browser-security bypasses.
+ * @breaks  Facebook or yt-dlp extractor changes can alter subtitle availability.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/facebook/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/facebook/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}