@graphext/cuery 0.3.0 → 0.5.1

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/yo.js

@@ -0,0 +1,107 @@
+import * as util from "../core/util.js";
+const error = () => {
+    const Sizable = {
+        string: { unit: "àmi", verb: "ní" },
+        file: { unit: "bytes", verb: "ní" },
+        array: { unit: "nkan", verb: "ní" },
+        set: { unit: "nkan", verb: "ní" },
+    };
+    function getSizing(origin) {
+        return Sizable[origin] ?? null;
+    }
+    const FormatDictionary = {
+        regex: "ẹ̀rọ ìbáwọlé",
+        email: "àdírẹ́sì ìmẹ́lì",
+        url: "URL",
+        emoji: "emoji",
+        uuid: "UUID",
+        uuidv4: "UUIDv4",
+        uuidv6: "UUIDv6",
+        nanoid: "nanoid",
+        guid: "GUID",
+        cuid: "cuid",
+        cuid2: "cuid2",
+        ulid: "ULID",
+        xid: "XID",
+        ksuid: "KSUID",
+        datetime: "àkókò ISO",
+        date: "ọjọ́ ISO",
+        time: "àkókò ISO",
+        duration: "àkókò tó pé ISO",
+        ipv4: "àdírẹ́sì IPv4",
+        ipv6: "àdírẹ́sì IPv6",
+        cidrv4: "àgbègbè IPv4",
+        cidrv6: "àgbègbè IPv6",
+        base64: "ọ̀rọ̀ tí a kọ́ ní base64",
+        base64url: "ọ̀rọ̀ base64url",
+        json_string: "ọ̀rọ̀ JSON",
+        e164: "nọ́mbà E.164",
+        jwt: "JWT",
+        template_literal: "ẹ̀rọ ìbáwọlé",
+    };
+    const TypeDictionary = {
+        nan: "NaN",
+        number: "nọ́mbà",
+        array: "akopọ",
+    };
+    return (issue) => {
+        switch (issue.code) {
+            case "invalid_type": {
+                const expected = TypeDictionary[issue.expected] ?? issue.expected;
+                const receivedType = util.parsedType(issue.input);
+                const received = TypeDictionary[receivedType] ?? receivedType;
+                if (/^[A-Z]/.test(issue.expected)) {
+                    return `Ìbáwọlé aṣìṣe: a ní láti fi instanceof ${issue.expected}, àmọ̀ a rí ${received}`;
+                }
+                return `Ìbáwọlé aṣìṣe: a ní láti fi ${expected}, àmọ̀ a rí ${received}`;
+            }
+            case "invalid_value":
+                if (issue.values.length === 1)
+                    return `Ìbáwọlé aṣìṣe: a ní láti fi ${util.stringifyPrimitive(issue.values[0])}`;
+                return `Àṣàyàn aṣìṣe: yan ọ̀kan lára ${util.joinValues(issue.values, "|")}`;
+            case "too_big": {
+                const adj = issue.inclusive ? "<=" : "<";
+                const sizing = getSizing(issue.origin);
+                if (sizing)
+                    return `Tó pọ̀ jù: a ní láti jẹ́ pé ${issue.origin ?? "iye"} ${sizing.verb} ${adj}${issue.maximum} ${sizing.unit}`;
+                return `Tó pọ̀ jù: a ní láti jẹ́ ${adj}${issue.maximum}`;
+            }
+            case "too_small": {
+                const adj = issue.inclusive ? ">=" : ">";
+                const sizing = getSizing(issue.origin);
+                if (sizing)
+                    return `Kéré ju: a ní láti jẹ́ pé ${issue.origin} ${sizing.verb} ${adj}${issue.minimum} ${sizing.unit}`;
+                return `Kéré ju: a ní láti jẹ́ ${adj}${issue.minimum}`;
+            }
+            case "invalid_format": {
+                const _issue = issue;
+                if (_issue.format === "starts_with")
+                    return `Ọ̀rọ̀ aṣìṣe: gbọ́dọ̀ bẹ̀rẹ̀ pẹ̀lú "${_issue.prefix}"`;
+                if (_issue.format === "ends_with")
+                    return `Ọ̀rọ̀ aṣìṣe: gbọ́dọ̀ parí pẹ̀lú "${_issue.suffix}"`;
+                if (_issue.format === "includes")
+                    return `Ọ̀rọ̀ aṣìṣe: gbọ́dọ̀ ní "${_issue.includes}"`;
+                if (_issue.format === "regex")
+                    return `Ọ̀rọ̀ aṣìṣe: gbọ́dọ̀ bá àpẹẹrẹ mu ${_issue.pattern}`;
+                return `Aṣìṣe: ${FormatDictionary[_issue.format] ?? issue.format}`;
+            }
+            case "not_multiple_of":
+                return `Nọ́mbà aṣìṣe: gbọ́dọ̀ jẹ́ èyà pípín ti ${issue.divisor}`;
+            case "unrecognized_keys":
+                return `Bọtìnì àìmọ̀: ${util.joinValues(issue.keys, ", ")}`;
+            case "invalid_key":
+                return `Bọtìnì aṣìṣe nínú ${issue.origin}`;
+            case "invalid_union":
+                return "Ìbáwọlé aṣìṣe";
+            case "invalid_element":
+                return `Iye aṣìṣe nínú ${issue.origin}`;
+            default:
+                return "Ìbáwọlé aṣìṣe";
+        }
+    };
+};
+export default function () {
+    return {
+        localeError: error(),
+    };
+}

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-CN.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAC;AA8GjD,MAAM,CAAC,OAAO,cAAc;IAAE,WAAW,EAAE,MAAM,CAAC,YAAY,CAAA;CAAE,CAI/D"}

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-CN.js

@@ -0,0 +1,109 @@
+import * as util from "../core/util.js";
+const error = () => {
+    const Sizable = {
+        string: { unit: "字符", verb: "包含" },
+        file: { unit: "字节", verb: "包含" },
+        array: { unit: "项", verb: "包含" },
+        set: { unit: "项", verb: "包含" },
+    };
+    function getSizing(origin) {
+        return Sizable[origin] ?? null;
+    }
+    const FormatDictionary = {
+        regex: "输入",
+        email: "电子邮件",
+        url: "URL",
+        emoji: "表情符号",
+        uuid: "UUID",
+        uuidv4: "UUIDv4",
+        uuidv6: "UUIDv6",
+        nanoid: "nanoid",
+        guid: "GUID",
+        cuid: "cuid",
+        cuid2: "cuid2",
+        ulid: "ULID",
+        xid: "XID",
+        ksuid: "KSUID",
+        datetime: "ISO日期时间",
+        date: "ISO日期",
+        time: "ISO时间",
+        duration: "ISO时长",
+        ipv4: "IPv4地址",
+        ipv6: "IPv6地址",
+        cidrv4: "IPv4网段",
+        cidrv6: "IPv6网段",
+        base64: "base64编码字符串",
+        base64url: "base64url编码字符串",
+        json_string: "JSON字符串",
+        e164: "E.164号码",
+        jwt: "JWT",
+        template_literal: "输入",
+    };
+    const TypeDictionary = {
+        nan: "NaN",
+        number: "数字",
+        array: "数组",
+        null: "空值(null)",
+    };
+    return (issue) => {
+        switch (issue.code) {
+            case "invalid_type": {
+                const expected = TypeDictionary[issue.expected] ?? issue.expected;
+                const receivedType = util.parsedType(issue.input);
+                const received = TypeDictionary[receivedType] ?? receivedType;
+                if (/^[A-Z]/.test(issue.expected)) {
+                    return `无效输入：期望 instanceof ${issue.expected}，实际接收 ${received}`;
+                }
+                return `无效输入：期望 ${expected}，实际接收 ${received}`;
+            }
+            case "invalid_value":
+                if (issue.values.length === 1)
+                    return `无效输入：期望 ${util.stringifyPrimitive(issue.values[0])}`;
+                return `无效选项：期望以下之一 ${util.joinValues(issue.values, "|")}`;
+            case "too_big": {
+                const adj = issue.inclusive ? "<=" : "<";
+                const sizing = getSizing(issue.origin);
+                if (sizing)
+                    return `数值过大：期望 ${issue.origin ?? "值"} ${adj}${issue.maximum.toString()} ${sizing.unit ?? "个元素"}`;
+                return `数值过大：期望 ${issue.origin ?? "值"} ${adj}${issue.maximum.toString()}`;
+            }
+            case "too_small": {
+                const adj = issue.inclusive ? ">=" : ">";
+                const sizing = getSizing(issue.origin);
+                if (sizing) {
+                    return `数值过小：期望 ${issue.origin} ${adj}${issue.minimum.toString()} ${sizing.unit}`;
+                }
+                return `数值过小：期望 ${issue.origin} ${adj}${issue.minimum.toString()}`;
+            }
+            case "invalid_format": {
+                const _issue = issue;
+                if (_issue.format === "starts_with")
+                    return `无效字符串：必须以 "${_issue.prefix}" 开头`;
+                if (_issue.format === "ends_with")
+                    return `无效字符串：必须以 "${_issue.suffix}" 结尾`;
+                if (_issue.format === "includes")
+                    return `无效字符串：必须包含 "${_issue.includes}"`;
+                if (_issue.format === "regex")
+                    return `无效字符串：必须满足正则表达式 ${_issue.pattern}`;
+                return `无效${FormatDictionary[_issue.format] ?? issue.format}`;
+            }
+            case "not_multiple_of":
+                return `无效数字：必须是 ${issue.divisor} 的倍数`;
+            case "unrecognized_keys":
+                return `出现未知的键(key): ${util.joinValues(issue.keys, ", ")}`;
+            case "invalid_key":
+                return `${issue.origin} 中的键(key)无效`;
+            case "invalid_union":
+                return "无效输入";
+            case "invalid_element":
+                return `${issue.origin} 中包含无效值(value)`;
+            default:
+                return `无效输入`;
+        }
+    };
+};
+export default function () {
+    return {
+        localeError: error(),
+    };
+}

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-TW.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-TW.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAC;AA6GjD,MAAM,CAAC,OAAO,cAAc;IAAE,WAAW,EAAE,MAAM,CAAC,YAAY,CAAA;CAAE,CAI/D"}

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/locales/zh-TW.js

@@ -0,0 +1,107 @@
+import * as util from "../core/util.js";
+const error = () => {
+    const Sizable = {
+        string: { unit: "字元", verb: "擁有" },
+        file: { unit: "位元組", verb: "擁有" },
+        array: { unit: "項目", verb: "擁有" },
+        set: { unit: "項目", verb: "擁有" },
+    };
+    function getSizing(origin) {
+        return Sizable[origin] ?? null;
+    }
+    const FormatDictionary = {
+        regex: "輸入",
+        email: "郵件地址",
+        url: "URL",
+        emoji: "emoji",
+        uuid: "UUID",
+        uuidv4: "UUIDv4",
+        uuidv6: "UUIDv6",
+        nanoid: "nanoid",
+        guid: "GUID",
+        cuid: "cuid",
+        cuid2: "cuid2",
+        ulid: "ULID",
+        xid: "XID",
+        ksuid: "KSUID",
+        datetime: "ISO 日期時間",
+        date: "ISO 日期",
+        time: "ISO 時間",
+        duration: "ISO 期間",
+        ipv4: "IPv4 位址",
+        ipv6: "IPv6 位址",
+        cidrv4: "IPv4 範圍",
+        cidrv6: "IPv6 範圍",
+        base64: "base64 編碼字串",
+        base64url: "base64url 編碼字串",
+        json_string: "JSON 字串",
+        e164: "E.164 數值",
+        jwt: "JWT",
+        template_literal: "輸入",
+    };
+    const TypeDictionary = {
+        nan: "NaN",
+    };
+    return (issue) => {
+        switch (issue.code) {
+            case "invalid_type": {
+                const expected = TypeDictionary[issue.expected] ?? issue.expected;
+                const receivedType = util.parsedType(issue.input);
+                const received = TypeDictionary[receivedType] ?? receivedType;
+                if (/^[A-Z]/.test(issue.expected)) {
+                    return `無效的輸入值：預期為 instanceof ${issue.expected}，但收到 ${received}`;
+                }
+                return `無效的輸入值：預期為 ${expected}，但收到 ${received}`;
+            }
+            case "invalid_value":
+                if (issue.values.length === 1)
+                    return `無效的輸入值：預期為 ${util.stringifyPrimitive(issue.values[0])}`;
+                return `無效的選項：預期為以下其中之一 ${util.joinValues(issue.values, "|")}`;
+            case "too_big": {
+                const adj = issue.inclusive ? "<=" : "<";
+                const sizing = getSizing(issue.origin);
+                if (sizing)
+                    return `數值過大：預期 ${issue.origin ?? "值"} 應為 ${adj}${issue.maximum.toString()} ${sizing.unit ?? "個元素"}`;
+                return `數值過大：預期 ${issue.origin ?? "值"} 應為 ${adj}${issue.maximum.toString()}`;
+            }
+            case "too_small": {
+                const adj = issue.inclusive ? ">=" : ">";
+                const sizing = getSizing(issue.origin);
+                if (sizing) {
+                    return `數值過小：預期 ${issue.origin} 應為 ${adj}${issue.minimum.toString()} ${sizing.unit}`;
+                }
+                return `數值過小：預期 ${issue.origin} 應為 ${adj}${issue.minimum.toString()}`;
+            }
+            case "invalid_format": {
+                const _issue = issue;
+                if (_issue.format === "starts_with") {
+                    return `無效的字串：必須以 "${_issue.prefix}" 開頭`;
+                }
+                if (_issue.format === "ends_with")
+                    return `無效的字串：必須以 "${_issue.suffix}" 結尾`;
+                if (_issue.format === "includes")
+                    return `無效的字串：必須包含 "${_issue.includes}"`;
+                if (_issue.format === "regex")
+                    return `無效的字串：必須符合格式 ${_issue.pattern}`;
+                return `無效的 ${FormatDictionary[_issue.format] ?? issue.format}`;
+            }
+            case "not_multiple_of":
+                return `無效的數字：必須為 ${issue.divisor} 的倍數`;
+            case "unrecognized_keys":
+                return `無法識別的鍵值${issue.keys.length > 1 ? "們" : ""}：${util.joinValues(issue.keys, "、")}`;
+            case "invalid_key":
+                return `${issue.origin} 中有無效的鍵值`;
+            case "invalid_union":
+                return "無效的輸入值";
+            case "invalid_element":
+                return `${issue.origin} 中有無效的值`;
+            default:
+                return `無效的輸入值`;
+        }
+    };
+};
+export default function () {
+    return {
+        localeError: error(),
+    };
+}

package/esm/mod.d.ts

@@ -3,19 +3,23 @@
  *
  * @module
  */
+export * from './src/llm.js';
+export { BatchResponse } from './src/response.js';
+export { getProvider, getProviderForModel, getModelPricing, getModelInfo, calculateCost, type ModelPricing, type ModelInfo, } from './src/providers/index.js';
 export * from './src/tools/keywords.js';
 export * from './src/tools/classifier.js';
 export * from './src/tools/funnel.js';
 export * from './src/tools/personas.js';
 export * from './src/tools/search.js';
 export * from './src/tools/topics.js';
-export * from './src/utils.js';
+export * from './src/helpers/utils.js';
 export * from './src/tools/brands.js';
 export * from './src/tools/translate.js';
 export * from './src/tools/sentiment.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
-export * from './src/tools/seedKeywords.js';
+export * from './src/helpers/seedKeywords.js';
+export * from './src/tools/generic.js';
 export * from './src/api.js';
 export * from './src/apis/chatgptScraper/index.js';
 export * from './src/apis/googleAds/keywordPlanner.js';

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/esm/mod.js

@@ -3,19 +3,25 @@
  *
  * @module
  */
+// Core LLM interface and types
+export * from './src/llm.js';
+export { BatchResponse } from './src/response.js';
+export { getProvider, getProviderForModel, getModelPricing, getModelInfo, calculateCost, } from './src/providers/index.js';
+// Tools
 export * from './src/tools/keywords.js';
 export * from './src/tools/classifier.js';
 export * from './src/tools/funnel.js';
 export * from './src/tools/personas.js';
 export * from './src/tools/search.js';
 export * from './src/tools/topics.js';
-export * from './src/utils.js';
+export * from './src/helpers/utils.js';
 export * from './src/tools/brands.js';
 export * from './src/tools/translate.js';
 export * from './src/tools/sentiment.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
-export * from './src/tools/seedKeywords.js';
+export * from './src/helpers/seedKeywords.js';
+export * from './src/tools/generic.js';
 export * from './src/api.js';
 export * from './src/apis/chatgptScraper/index.js';
 export * from './src/apis/googleAds/keywordPlanner.js';

package/esm/src/api.d.ts

@@ -1,5 +1,4 @@
 import { type JobId } from './apis/chatgptScraper/index.js';
-import { ModelId } from './models.js';
 import { type Entity } from './schemas/entity.schema.js';
 import { type Funnel } from './schemas/funnel.schema.js';
 import type { ModelIdentifier } from './schemas/models.schema.js';
@@ -24,7 +23,7 @@ export type EnrichedModelResponse = {
     rankedBrandsInSourceTitles: Array<string>;
     rankedBrandsInSourceDomains: Array<string>;
 };
-export declare function queryModel(prompts: Array<string | JobId>, model: ModelIdentifier | ModelId, searchCountry?: string | null): Promise<Array<ModelResponse>>;
+export declare function queryModel(prompts: Array<string | JobId>, model: ModelIdentifier, searchCountry?: string | null): Promise<Array<ModelResponse>>;
 export declare function classifyIntent(texts: Array<string>): Promise<Array<string | null>>;
 export declare function extractAndAssignTopics(texts: Array<string>): Promise<Array<{
     topic: string | null;
@@ -36,7 +35,7 @@ export declare function assignFunnelStages(texts: Array<string>, funnel: Funnel)
 }>>;
 export declare function classifyIntoPersonas(texts: Array<string>, personas: Array<Persona>): Promise<Array<Array<string> | null>>;
 export declare function classifyBrandedNonBranded(texts: Array<string>): Promise<Array<string | null>>;
-export declare function extractEntities(texts: Array<string>): Promise<Array<Array<Entity>>>;
-export declare function scorePurchaseProbability(texts: Array<string>, numDays?: number): Promise<Array<number>>;
-export declare function scoreRelevance(prompts: Array<string>, context: BrandContext): Promise<Array<number>>;
+export declare function extractEntities(texts: Array<string>): Promise<Array<Array<Entity> | null>>;
+export declare function scorePurchaseProbability(texts: Array<string>, numDays?: number): Promise<Array<number | null>>;
+export declare function scoreRelevance(prompts: Array<string>, context: BrandContext): Promise<Array<number | null>>;
 //# sourceMappingURL=api.d.ts.map

package/esm/src/api.d.ts.map

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

package/esm/src/api.js

@@ -2,23 +2,22 @@
 import { fetchAIMBatch } from './apis/hasdata/aim.js';
 import { fetchAIOBatch } from './apis/hasdata/aio.js';
 import { downloadGPTSnapshots, scrapeGPTBatch } from './apis/chatgptScraper/index.js';
-import { classifyBatch, labelBatch } from './tools/classifier.js';
-import { extractEntitiesBatch } from './tools/entities.js';
+import { Classifier, Labeler } from './tools/classifier.js';
+import { EntityExtractor } from './tools/entities.js';
 import { funnelToTopics } from './tools/funnel.js';
-import { ModelId } from './models.js';
-import { scoreBatch } from './tools/scorer.js';
-import { extractTopics, assignTopics } from './tools/topics.js';
-import { dedent } from './utils.js';
+import { cleanColumnName } from './helpers/utils.js';
+import { Scorer } from './tools/scorer.js';
+import { TopicExtractor, TopicAssigner } from './tools/topics.js';
+import { dedent } from './helpers/utils.js';
 export async function queryModel(prompts, model, searchCountry = null) {
-    const modelId = model instanceof ModelId ? model : new ModelId(model);
     let searchResults;
-    if (modelId.equals('google/ai-overview')) {
+    if (model === 'google/ai-overview') {
         searchResults = await fetchAIOBatch(prompts, searchCountry, null);
     }
-    else if (modelId.equals('google/ai-mode')) {
+    else if (model === 'google/ai-mode') {
         searchResults = await fetchAIMBatch(prompts, searchCountry, null);
     }
-    else if (modelId.provider == 'openai' || modelId.name.includes('gpt-') || modelId.name.includes('chatgpt')) {
+    else if (model.startsWith('openai/') || model.includes('chatgpt')) {
         // JobIds are alphanumeric strings without spaces
         // (e.g., "7420410504197219329" for Oxylabs, "s_xxxxx" for Brightdata)
         // Prompts are natural language text with spaces
@@ -35,13 +34,15 @@ export async function queryModel(prompts, model, searchCountry = null) {
         }
     }
     else {
-        throw new Error(`Unsupported model: ${modelId}`);
+        throw new Error(`Unsupported model: ${model}`);
     }
+    // Convert model identifier to column name (e.g., "google/ai-overview" -> "ai_overview")
+    const modelColumnName = cleanColumnName(model.split('/').pop() ?? model);
     const responses = searchResults.map((sr, i) => ({
         answer: sr.answer,
         sources: sr.sources,
         prompt: sr.prompt ?? (typeof prompts[i] === 'string' ? prompts[i] : ''),
-        model: modelId.columnName(),
+        model: modelColumnName,
         searchQueries: sr.searchQueries ?? [],
         searchSources: sr.searchSources ?? []
     }));
@@ -54,20 +55,27 @@ const intentLabels = {
 };
 export async function classifyIntent(texts) {
     console.log('Classifying prompt intents...');
+    const classifier = new Classifier({
+        labels: intentLabels,
+        instructions: 'Classify the search query into one of the following intents: informational, navigational, transactional.'
+    }, { model: 'gpt-4.1-mini' });
     const textRecords = texts.map(text => ({ text }));
-    const intents = await classifyBatch(textRecords, intentLabels, 'Classify the search query into one of the following intents: informational, navigational, transactional.', 'gpt-4.1-mini');
-    return intents;
+    const intents = await classifier.batch(textRecords);
+    return intents.toArray();
 }
 export async function extractAndAssignTopics(texts) {
     console.log('Identifying topics...');
     const textRecords = texts.map(text => ({ text }));
-    const taxonomy = await extractTopics({
-        records: textRecords,
-        maxSamples: 500
-    });
+    const extractor = new TopicExtractor({ maxSamples: 500 }, { model: 'gpt-4.1' });
+    const taxonomyResult = await extractor.invoke(textRecords);
+    const taxonomy = taxonomyResult.parsed;
+    if (taxonomy == null) {
+        return texts.map(() => ({ topic: null, subtopic: null }));
+    }
     console.log('Assigning topics...');
-    const topicLabels = await assignTopics(texts, taxonomy);
-    return topicLabels.map(label => ({
+    const assigner = new TopicAssigner({ taxonomy }, { model: 'gpt-4.1-mini' });
+    const topicLabels = await assigner.batch(texts);
+    return topicLabels.toArray().map(label => ({
         topic: label?.topic ?? null,
         subtopic: label?.subtopic ?? null
     }));
@@ -75,8 +83,9 @@ export async function extractAndAssignTopics(texts) {
 export async function assignFunnelStages(texts, funnel) {
     console.log('Assigning funnel stages...');
     const funnelTopics = funnelToTopics(funnel);
-    const funnelLabels = await assignTopics(texts, funnelTopics);
-    return funnelLabels.map(label => ({
+    const assigner = new TopicAssigner({ taxonomy: funnelTopics }, { model: 'gpt-4.1-mini' });
+    const funnelLabels = await assigner.batch(texts);
+    return funnelLabels.toArray().map(label => ({
         funnelStage: label?.topic ?? null,
         funnelCategory: label?.subtopic ?? null
     }));
@@ -87,9 +96,13 @@ export async function classifyIntoPersonas(texts, personas) {
     personas.forEach(persona => {
         personaLabels[persona.name] = persona.description;
     });
+    const labeler = new Labeler({
+        labels: personaLabels,
+        instructions: 'Classify the search query into one or more customer personas based on the language, intent, and context.'
+    }, { model: 'gpt-4.1-mini' });
     const textRecords = texts.map(text => ({ text }));
-    const personaAssignments = await labelBatch(textRecords, personaLabels, 'Classify the search query into one or more customer personas based on the language, intent, and context.', 'gpt-4.1-mini');
-    return personaAssignments;
+    const personaAssignments = await labeler.batch(textRecords);
+    return personaAssignments.toArray();
 }
 export async function classifyBrandedNonBranded(texts) {
     console.log('Classifying prompts into branded/non-branded...');
@@ -97,18 +110,25 @@ export async function classifyBrandedNonBranded(texts) {
         'branded': 'The query explicitly mentions a specific brand name, company name, product name, or trademark. It shows clear brand awareness and intent to find information about that particular brand.',
         'non-branded': 'The query is generic and does not mention any specific brand names. It focuses on product categories, features, problems, or general information without brand specificity.'
     };
+    const classifier = new Classifier({
+        labels: brandedLabels,
+        instructions: 'Classify whether the search query mentions specific brands or is generic/category-based.'
+    }, { model: 'gpt-4.1-mini' });
     const textRecords = texts.map(text => ({ text }));
-    const brandedClassifications = await classifyBatch(textRecords, brandedLabels, 'Classify whether the search query mentions specific brands or is generic/category-based.', 'gpt-4.1-mini');
-    return brandedClassifications;
+    const brandedClassifications = await classifier.batch(textRecords);
+    return brandedClassifications.toArray();
 }
 export async function extractEntities(texts) {
-    const entityDefinitions = `
-		- brands: Any brand or companies mentioned
-		- products: Any products or services mentioned
-		- features: Specific features or attributes of products/services
-		- issues: Problems or issues mentioned
-	`;
-    return extractEntitiesBatch(texts, entityDefinitions, '', 'gpt-4.1-mini');
+    const extractor = new EntityExtractor({
+        entityDefinitions: {
+            brands: 'Any brand or companies mentioned',
+            products: 'Any products or services mentioned',
+            features: 'Specific features or attributes of products/services',
+            issues: 'Problems or issues mentioned'
+        }
+    }, { model: 'gpt-4.1-mini' });
+    const result = await extractor.batch(texts);
+    return result.toArray();
 }
 export async function scorePurchaseProbability(texts, numDays = 30) {
     console.log('Scoring purchase probability...');
@@ -118,8 +138,9 @@ export async function scorePurchaseProbability(texts, numDays = 30) {
 		in the next ${numDays} days. The input record is a text query representing a search
 		that a user may perform using a traditional search engine or LLM chat.
 	`);
-    const scores = await scoreBatch(records, 'Purchase Probability', description, 'integer', 0, 100, 'gpt-4.1-mini');
-    return scores;
+    const scorer = new Scorer({ name: 'Purchase Probability', description: description, type: 'integer', min: 0, max: 100 }, { model: 'gpt-4.1-mini' });
+    const scores = await scorer.batch(records);
+    return scores.toArray();
 }
 export async function scoreRelevance(prompts, context) {
     console.log('Scoring prompt relevance...');
@@ -156,6 +177,7 @@ export async function scoreRelevance(prompts, context) {
 		1.0 means the keyword/prompt is highly relevant and specific to the context, e.g.
 		"best CRM software for small business" for a brand selling CRM software.
 	`);
-    const scores = await scoreBatch(records, 'Prompt Relevance', description, 'number', 0.0, 1.0, 'gpt-4.1-mini');
-    return scores;
+    const scorer = new Scorer({ name: 'Prompt Relevance', description: description, type: 'number', min: 0.0, max: 1.0 }, { model: 'gpt-4.1-mini' });
+    const scores = await scorer.batch(records);
+    return scores.toArray();
 }

package/esm/src/apis/chatgptScraper/brightdata.js

@@ -8,7 +8,7 @@
  * 3. Download: GET /datasets/v3/snapshot/{snapshot_id}
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import { withRetries, sleep } from '../../async.js';
+import { withRetries, sleep } from '../../helpers/async.js';
 import { getAbortSignal, cleanAnswer, buildSources, buildSearchSources } from './scraper.js';
 // ============================================================================
 // Constants

package/esm/src/apis/chatgptScraper/oxy.js

@@ -8,7 +8,7 @@
  * 3. Download: GET /v1/queries/{id}/results
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import { withRetries, sleep } from '../../async.js';
+import { withRetries, sleep } from '../../helpers/async.js';
 import { getAbortSignal, cleanAnswer, buildSources } from './scraper.js';
 // ============================================================================
 // Constants

package/esm/src/apis/chatgptScraper/scraper.js

@@ -5,8 +5,8 @@
  * Uses composition: providers supply functions, this module orchestrates them.
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import { mapParallel } from '../../async.js';
-import { extractDomain } from '../../urls.js';
+import { mapParallel } from '../../helpers/async.js';
+import { extractDomain } from '../../helpers/urls.js';
 // ============================================================================
 // Shared Utilities
 // ============================================================================

package/esm/src/apis/hasdata/aim.js

@@ -1,5 +1,5 @@
 /* eslint no-console: ["warn", { allow: ["log", "warn", "error"] }] */
-import { mapParallel } from '../../async.js';
+import { mapParallel } from '../../helpers/async.js';
 import { fetchHasDataWithRetry, HASDATA_CONCURRENCY, parseAIM } from './helpers.js';
 export async function fetchAIM(prompt, country = null, language = null, location = null) {
     const aimEndpoint = 'https://api.hasdata.com/scrape/google/ai-mode';