@things-factory/integration-openai 10.1.236 → 10.1.241

package/dist-server/engine/connector/index.d.ts

@@ -0,0 +1 @@
+import './openai-admin-connector';

package/dist-server/engine/connector/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./openai-admin-connector");
+//# sourceMappingURL=index.js.map

package/dist-server/engine/connector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/connector/index.ts"],"names":[],"mappings":";;AAAA,oCAAiC","sourcesContent":["import './openai-admin-connector'\n"]}

package/dist-server/engine/connector/openai-admin-client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The OpenAI organization Costs API (ADR-0177 개정 6) - what an organization's API usage cost, day by day. An Admin key
+ * (`sk-admin-...`) only; a project key is refused by these endpoints. Amounts come in dollars.
+ */
+export interface OpenAICostBucket {
+    start_time: number;
+    results: {
+        amount?: {
+            value: number;
+            currency: string;
+        };
+        line_item?: string | null;
+        project_id?: string | null;
+    }[];
+}
+export declare class OpenAIAdminClient {
+    private readonly fetcher;
+    private readonly origin;
+    private readonly key;
+    constructor(adminKey: string, origin?: string | null, fetcher?: typeof fetch);
+    /** The cost, day by day from `start` to `end` (unix seconds), by line item - every page. */
+    costs(start: number, end: number): Promise<OpenAICostBucket[]>;
+}

package/dist-server/engine/connector/openai-admin-client.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * The OpenAI organization Costs API (ADR-0177 개정 6) - what an organization's API usage cost, day by day. An Admin key
+ * (`sk-admin-...`) only; a project key is refused by these endpoints. Amounts come in dollars.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAdminClient = void 0;
+const DEFAULT_ORIGIN = 'https://api.openai.com';
+class OpenAIAdminClient {
+    constructor(adminKey, origin, fetcher = fetch) {
+        this.fetcher = fetcher;
+        if (!adminKey)
+            throw new Error('the OpenAI connection has no Admin key');
+        /* An Admin key - never a project key, which these endpoints refuse. The value itself is never said. */
+        if (!adminKey.trim().startsWith('sk-admin-'))
+            throw new Error('the key is no OpenAI Admin key - create one under Organization settings > Admin keys (sk-admin-...)');
+        this.key = adminKey.trim();
+        this.origin = (origin || DEFAULT_ORIGIN).replace(/\/+$/, '');
+    }
+    /** The cost, day by day from `start` to `end` (unix seconds), by line item - every page. */
+    async costs(start, end) {
+        const buckets = [];
+        let page;
+        do {
+            const url = new URL(`${this.origin}/v1/organization/costs`);
+            url.searchParams.set('start_time', String(start));
+            url.searchParams.set('end_time', String(end));
+            url.searchParams.set('bucket_width', '1d');
+            url.searchParams.append('group_by', 'line_item');
+            url.searchParams.set('limit', '180');
+            if (page)
+                url.searchParams.set('page', page);
+            const response = await this.fetcher(url.toString(), { headers: { authorization: `Bearer ${this.key}`, 'content-type': 'application/json' } });
+            const body = await response.json().catch(() => ({}));
+            if (!response.ok)
+                throw new Error(`/v1/organization/costs (${response.status}): ${body?.error?.message ?? response.statusText}`);
+            buckets.push(...(body.data ?? []));
+            page = body.has_more ? body.next_page : undefined;
+        } while (page);
+        return buckets;
+    }
+}
+exports.OpenAIAdminClient = OpenAIAdminClient;
+//# sourceMappingURL=openai-admin-client.js.map

package/dist-server/engine/connector/openai-admin-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-admin-client.js","sourceRoot":"","sources":["../../../server/engine/connector/openai-admin-client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAO/C,MAAa,iBAAiB;IAI5B,YAAY,QAAgB,EAAE,MAAsB,EAAmB,UAAwB,KAAK;QAA7B,YAAO,GAAP,OAAO,CAAsB;QAClG,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QACxE,uGAAuG;QACvG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAA;QACpK,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,4FAA4F;IAC5F,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,GAAW;QACpC,MAAM,OAAO,GAAuB,EAAE,CAAA;QACtC,IAAI,IAAwB,CAAA;QAC5B,GAAG,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,wBAAwB,CAAC,CAAA;YAC3D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;YAC1C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;YAChD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YACpC,IAAI,IAAI;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;YAC7I,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACzD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAChI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;YAClC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;QACnD,CAAC,QAAQ,IAAI,EAAC;QACd,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAhCD,8CAgCC","sourcesContent":["/**\n * The OpenAI organization Costs API (ADR-0177 개정 6) - what an organization's API usage cost, day by day. An Admin key\n * (`sk-admin-...`) only; a project key is refused by these endpoints. Amounts come in dollars.\n */\n\nconst DEFAULT_ORIGIN = 'https://api.openai.com'\n\nexport interface OpenAICostBucket {\n  start_time: number\n  results: { amount?: { value: number; currency: string }; line_item?: string | null; project_id?: string | null }[]\n}\n\nexport class OpenAIAdminClient {\n  private readonly origin: string\n  private readonly key: string\n\n  constructor(adminKey: string, origin?: string | null, private readonly fetcher: typeof fetch = fetch) {\n    if (!adminKey) throw new Error('the OpenAI connection has no Admin key')\n    /* An Admin key - never a project key, which these endpoints refuse. The value itself is never said. */\n    if (!adminKey.trim().startsWith('sk-admin-')) throw new Error('the key is no OpenAI Admin key - create one under Organization settings > Admin keys (sk-admin-...)')\n    this.key = adminKey.trim()\n    this.origin = (origin || DEFAULT_ORIGIN).replace(/\\/+$/, '')\n  }\n\n  /** The cost, day by day from `start` to `end` (unix seconds), by line item - every page. */\n  async costs(start: number, end: number): Promise<OpenAICostBucket[]> {\n    const buckets: OpenAICostBucket[] = []\n    let page: string | undefined\n    do {\n      const url = new URL(`${this.origin}/v1/organization/costs`)\n      url.searchParams.set('start_time', String(start))\n      url.searchParams.set('end_time', String(end))\n      url.searchParams.set('bucket_width', '1d')\n      url.searchParams.append('group_by', 'line_item')\n      url.searchParams.set('limit', '180')\n      if (page) url.searchParams.set('page', page)\n      const response = await this.fetcher(url.toString(), { headers: { authorization: `Bearer ${this.key}`, 'content-type': 'application/json' } })\n      const body: any = await response.json().catch(() => ({}))\n      if (!response.ok) throw new Error(`/v1/organization/costs (${response.status}): ${body?.error?.message ?? response.statusText}`)\n      buckets.push(...(body.data ?? []))\n      page = body.has_more ? body.next_page : undefined\n    } while (page)\n    return buckets\n  }\n}\n"]}

package/dist-server/engine/connector/openai-admin-connector.d.ts

@@ -0,0 +1,19 @@
+import { Connector } from '@things-factory/integration-base';
+/**
+ * OpenAI Admin connector (ADR-0177 개정 6) - one connection an organization: its Admin key (a secret) and its id
+ * (`org-...`, Organization settings > General), which the subscription account names as its identifier.
+ */
+export declare class OpenAIAdminConnector implements Connector {
+    ready(connectionConfigs: any): Promise<void>;
+    connect(connection: any): Promise<void>;
+    disconnect(connection: any): Promise<void>;
+    get parameterSpec(): {
+        type: string;
+        name: string;
+        label: string;
+        useDomainAttribute: boolean;
+    }[];
+    get taskPrefixes(): string[];
+    get help(): string;
+    get description(): string;
+}

package/dist-server/engine/connector/openai-admin-connector.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAdminConnector = void 0;
+const integration_base_1 = require("@things-factory/integration-base");
+const openai_admin_client_1 = require("./openai-admin-client");
+/**
+ * OpenAI Admin connector (ADR-0177 개정 6) - one connection an organization: its Admin key (a secret) and its id
+ * (`org-...`, Organization settings > General), which the subscription account names as its identifier.
+ */
+class OpenAIAdminConnector {
+    async ready(connectionConfigs) {
+        await Promise.all(connectionConfigs.map(this.connect.bind(this)));
+        integration_base_1.ConnectionManager.logger.info('openai-admin-connector connections are ready');
+    }
+    async connect(connection) {
+        const { endpoint, params } = connection;
+        if (!String(params?.organizationId ?? '').trim().startsWith('org-'))
+            throw new Error('the connection names no OpenAI organization id (org-...) - Organization settings > General');
+        integration_base_1.ConnectionManager.addConnectionInstance(connection, { client: new openai_admin_client_1.OpenAIAdminClient(params?.adminKey, endpoint), organizationId: params.organizationId.trim() });
+        integration_base_1.ConnectionManager.logger.info(`openai-admin-connector connection(${connection.name}) is connected`);
+    }
+    async disconnect(connection) {
+        integration_base_1.ConnectionManager.removeConnectionInstance(connection);
+        integration_base_1.ConnectionManager.logger.info(`openai-admin-connector connection(${connection.name}) is disconnected`);
+    }
+    get parameterSpec() {
+        return [
+            { type: 'secret', name: 'adminKey', label: 'admin-key', useDomainAttribute: true },
+            { type: 'string', name: 'organizationId', label: 'organization-id', useDomainAttribute: true }
+        ];
+    }
+    get taskPrefixes() {
+        return ['openai-cost'];
+    }
+    get help() {
+        return 'integration/connector/openai-admin-connector';
+    }
+    get description() {
+        return 'OpenAI Admin Connector';
+    }
+}
+exports.OpenAIAdminConnector = OpenAIAdminConnector;
+integration_base_1.ConnectionManager.registerConnector('openai-admin-connector', new OpenAIAdminConnector());
+//# sourceMappingURL=openai-admin-connector.js.map

package/dist-server/engine/connector/openai-admin-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-admin-connector.js","sourceRoot":"","sources":["../../../server/engine/connector/openai-admin-connector.ts"],"names":[],"mappings":";;;AAAA,uEAA+E;AAE/E,+DAAyD;AAEzD;;;GAGG;AACH,MAAa,oBAAoB;IAC/B,KAAK,CAAC,KAAK,CAAC,iBAAiB;QAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjE,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;IAC/E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;QACvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAA;QAClL,oCAAiB,CAAC,qBAAqB,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,uCAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAChK,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,UAAU,CAAC,IAAI,gBAAgB,CAAC,CAAA;IACrG,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAU;QACzB,oCAAiB,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAA;QACtD,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,UAAU,CAAC,IAAI,mBAAmB,CAAC,CAAA;IACxG,CAAC;IAED,IAAI,aAAa;QACf,OAAO;YACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE;YAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,IAAI,EAAE;SAC/F,CAAA;IACH,CAAC;IAED,IAAI,YAAY;QACd,OAAO,CAAC,aAAa,CAAC,CAAA;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,8CAA8C,CAAA;IACvD,CAAC;IAED,IAAI,WAAW;QACb,OAAO,wBAAwB,CAAA;IACjC,CAAC;CACF;AApCD,oDAoCC;AAED,oCAAiB,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,IAAI,oBAAoB,EAAE,CAAC,CAAA","sourcesContent":["import { ConnectionManager, Connector } from '@things-factory/integration-base'\n\nimport { OpenAIAdminClient } from './openai-admin-client'\n\n/**\n * OpenAI Admin connector (ADR-0177 개정 6) - one connection an organization: its Admin key (a secret) and its id\n * (`org-...`, Organization settings > General), which the subscription account names as its identifier.\n */\nexport class OpenAIAdminConnector implements Connector {\n  async ready(connectionConfigs) {\n    await Promise.all(connectionConfigs.map(this.connect.bind(this)))\n    ConnectionManager.logger.info('openai-admin-connector connections are ready')\n  }\n\n  async connect(connection) {\n    const { endpoint, params } = connection\n    if (!String(params?.organizationId ?? '').trim().startsWith('org-')) throw new Error('the connection names no OpenAI organization id (org-...) - Organization settings > General')\n    ConnectionManager.addConnectionInstance(connection, { client: new OpenAIAdminClient(params?.adminKey, endpoint), organizationId: params.organizationId.trim() })\n    ConnectionManager.logger.info(`openai-admin-connector connection(${connection.name}) is connected`)\n  }\n\n  async disconnect(connection) {\n    ConnectionManager.removeConnectionInstance(connection)\n    ConnectionManager.logger.info(`openai-admin-connector connection(${connection.name}) is disconnected`)\n  }\n\n  get parameterSpec() {\n    return [\n      { type: 'secret', name: 'adminKey', label: 'admin-key', useDomainAttribute: true },\n      { type: 'string', name: 'organizationId', label: 'organization-id', useDomainAttribute: true }\n    ]\n  }\n\n  get taskPrefixes() {\n    return ['openai-cost']\n  }\n\n  get help() {\n    return 'integration/connector/openai-admin-connector'\n  }\n\n  get description() {\n    return 'OpenAI Admin Connector'\n  }\n}\n\nConnectionManager.registerConnector('openai-admin-connector', new OpenAIAdminConnector())\n"]}

package/dist-server/engine/index.d.ts

@@ -1 +1,2 @@
+import './connector';
 import './task';

package/dist-server/engine/index.js

@@ -1,4 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+require("./connector");
 require("./task");
 //# sourceMappingURL=index.js.map

package/dist-server/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;AAAA,kBAAe","sourcesContent":["import './task'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;AAAA,uBAAoB;AACpB,kBAAe","sourcesContent":["import './connector'\nimport './task'\n"]}

package/dist-server/engine/task/index.d.ts

@@ -1 +1,2 @@
 import './openai-completion';
+import './openai-cost-report';

package/dist-server/engine/task/index.js

@@ -1,4 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 require("./openai-completion");
+require("./openai-cost-report");
 //# sourceMappingURL=index.js.map

package/dist-server/engine/task/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/task/index.ts"],"names":[],"mappings":";;AAAA,+BAA4B","sourcesContent":["import './openai-completion'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/task/index.ts"],"names":[],"mappings":";;AAAA,+BAA4B;AAC5B,gCAA6B","sourcesContent":["import './openai-completion'\nimport './openai-cost-report'\n"]}

package/dist-server/engine/task/openai-cost-report.d.ts

@@ -0,0 +1,16 @@
+import type { OpenAICostBucket } from '../connector/openai-admin-client';
+/** The closed months to read, as unix seconds: the first day, and the first day of this month (exclusive). */
+export declare function windowOf(today: Date, months: number): {
+    start: number;
+    end: number;
+};
+export declare function costsByMonth(buckets: OpenAICostBucket[]): {
+    currency: string;
+    months: {
+        month: string;
+        lines: {
+            label: string;
+            amount: number;
+        }[];
+    }[];
+};

package/dist-server/engine/task/openai-cost-report.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.windowOf = windowOf;
+exports.costsByMonth = costsByMonth;
+const integration_base_1 = require("@things-factory/integration-base");
+/*
+ * What an OpenAI organization's API usage cost in the closed months before this one, a line a line item (a model and
+ * what it was used for) - in the shape an Anthropic organization's come in, so saas `syncSaasCosts` writes its bills
+ * (ADR-0177 개정 6).
+ */
+/** The closed months to read, as unix seconds: the first day, and the first day of this month (exclusive). */
+function windowOf(today, months) {
+    const start = Date.UTC(today.getUTCFullYear(), today.getUTCMonth() - months, 1) / 1000;
+    const end = Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), 1) / 1000;
+    return { start, end };
+}
+function costsByMonth(buckets) {
+    const months = new Map();
+    let currency = 'USD';
+    for (const bucket of buckets) {
+        const month = new Date(bucket.start_time * 1000).toISOString().slice(0, 7);
+        const lines = months.get(month) ?? new Map();
+        for (const one of bucket.results ?? []) {
+            if (one.amount?.currency)
+                currency = one.amount.currency.toUpperCase();
+            const label = one.line_item || 'usage';
+            lines.set(label, (lines.get(label) ?? 0) + Number(one.amount?.value ?? 0));
+        }
+        months.set(month, lines);
+    }
+    return {
+        currency,
+        months: [...months.entries()]
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([month, lines]) => ({
+            month,
+            lines: [...lines.entries()]
+                .map(([label, amount]) => ({ label, amount: Math.round(amount * 100) / 100 }))
+                .filter(line => line.amount)
+                .sort((a, b) => b.amount - a.amount)
+        }))
+            .filter(one => one.lines.length)
+    };
+}
+async function OpenAICostReport(step, context) {
+    const { connection: connectionName, params } = step;
+    const instance = await integration_base_1.ConnectionManager.getConnectionInstanceByName(context.domain, connectionName);
+    const client = instance?.client;
+    if (!client)
+        throw new Error(`no connection '${connectionName}'`);
+    const months = Math.min(Math.max(Number(params?.months) || 3, 1), 12);
+    const { start, end } = windowOf(new Date(), months);
+    return { data: { vendorAccount: instance.organizationId, vendorName: null, ...costsByMonth(await client.costs(start, end)) } };
+}
+OpenAICostReport.parameterSpec = [{ type: 'number', name: 'months', label: 'months', placeholder: '3 (1-12)' }];
+OpenAICostReport.help = 'integration/task/openai-cost-report';
+integration_base_1.TaskRegistry.registerTaskHandler('openai-cost-report', OpenAICostReport);
+//# sourceMappingURL=openai-cost-report.js.map

package/dist-server/engine/task/openai-cost-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-cost-report.js","sourceRoot":"","sources":["../../../server/engine/task/openai-cost-report.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConnectionManager, TaskRegistry } from '@things-factory/integration-base'\n\nimport type { OpenAIAdminClient, OpenAICostBucket } from '../connector/openai-admin-client'\n\n/*\n * What an OpenAI organization's API usage cost in the closed months before this one, a line a line item (a model and\n * what it was used for) - in the shape an Anthropic organization's come in, so saas `syncSaasCosts` writes its bills\n * (ADR-0177 개정 6).\n */\n\n/** The closed months to read, as unix seconds: the first day, and the first day of this month (exclusive). */\nexport function windowOf(today: Date, months: number): { start: number; end: number } {\n  const start = Date.UTC(today.getUTCFullYear(), today.getUTCMonth() - months, 1) / 1000\n  const end = Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), 1) / 1000\n  return { start, end }\n}\n\nexport function costsByMonth(buckets: OpenAICostBucket[]) {\n  const months = new Map<string, Map<string, number>>()\n  let currency = 'USD'\n  for (const bucket of buckets) {\n    const month = new Date(bucket.start_time * 1000).toISOString().slice(0, 7)\n    const lines = months.get(month) ?? new Map<string, number>()\n    for (const one of bucket.results ?? []) {\n      if (one.amount?.currency) currency = one.amount.currency.toUpperCase()\n      const label = one.line_item || 'usage'\n      lines.set(label, (lines.get(label) ?? 0) + Number(one.amount?.value ?? 0))\n    }\n    months.set(month, lines)\n  }\n  return {\n    currency,\n    months: [...months.entries()]\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([month, lines]) => ({\n        month,\n        lines: [...lines.entries()]\n          .map(([label, amount]) => ({ label, amount: Math.round(amount * 100) / 100 }))\n          .filter(line => line.amount)\n          .sort((a, b) => b.amount - a.amount)\n      }))\n      .filter(one => one.lines.length)\n  }\n}\n\nasync function OpenAICostReport(step, context) {\n  const { connection: connectionName, params } = step\n  const instance = await ConnectionManager.getConnectionInstanceByName(context.domain, connectionName)\n  const client: OpenAIAdminClient | undefined = instance?.client\n  if (!client) throw new Error(`no connection '${connectionName}'`)\n  const months = Math.min(Math.max(Number(params?.months) || 3, 1), 12)\n  const { start, end } = windowOf(new Date(), months)\n  return { data: { vendorAccount: instance.organizationId, vendorName: null, ...costsByMonth(await client.costs(start, end)) } }\n}\n\nOpenAICostReport.parameterSpec = [{ type: 'number', name: 'months', label: 'months', placeholder: '3 (1-12)' }]\nOpenAICostReport.help = 'integration/task/openai-cost-report'\n\nTaskRegistry.registerTaskHandler('openai-cost-report', OpenAICostReport)\n"]}