@oxygen-agent/cli 1.45.4

package/node_modules/@oxygen/shared/dist/file-import.js

@@ -0,0 +1,232 @@
+import { extname } from "node:path";
+import readXlsxFile from "read-excel-file/node";
+import { inferImportColumnDataType, parseDateValueToIso, } from "./column-types.js";
+import { OxygenError } from "./index.js";
+const MAX_IDENTIFIER_LENGTH = 63;
+export function inferRowsFileFormat(path) {
+    const extension = extname(path).toLowerCase();
+    if (extension === ".jsonl" || extension === ".ndjson")
+        return "jsonl";
+    if (extension === ".csv")
+        return "csv";
+    if (extension === ".xlsx" || extension === ".xlsm")
+        return "xlsx";
+    return "json";
+}
+export function normalizeRowsFormat(value, fallback) {
+    const normalized = value?.trim().toLowerCase() || fallback;
+    if (normalized === "json"
+        || normalized === "jsonl"
+        || normalized === "csv"
+        || normalized === "xlsx") {
+        return normalized;
+    }
+    throw new OxygenError("invalid_format", "Format must be json, jsonl, csv, or xlsx.", {
+        details: { format: value },
+        exitCode: 1,
+    });
+}
+export async function parseRowsFileBuffer(buffer, format, options = {}) {
+    if (format === "xlsx")
+        return await parseXlsxRows(buffer, options);
+    return parseRowsText(buffer.toString("utf8"), format);
+}
+export function parseRowsText(text, format) {
+    if (format === "json")
+        return normalizeRowObjects(parseJsonArray(text));
+    if (format === "jsonl") {
+        return normalizeRowObjects(text
+            .split(/\r?\n/)
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line)));
+    }
+    return parseCsvRows(text);
+}
+export function inferImportColumnLabels(rows) {
+    const labels = [];
+    const seen = new Set();
+    for (const row of rows) {
+        for (const key of Object.keys(row)) {
+            if (key.startsWith("_") || seen.has(key))
+                continue;
+            seen.add(key);
+            labels.push(key);
+        }
+    }
+    return labels;
+}
+export function normalizeRowsForNewTable(rows) {
+    const labels = inferImportColumnLabels(rows);
+    if (labels.length === 0) {
+        throw new OxygenError("invalid_rows", "Import rows did not contain any writable columns.", {
+            exitCode: 1,
+        });
+    }
+    const taken = new Set(["_row_id", "_created_at", "_updated_at"]);
+    const keyBySource = {};
+    const columns = labels.map((label) => {
+        const key = makeUniqueImportKey(label, taken);
+        keyBySource[label] = key;
+        const dataType = inferImportColumnDataType(label, rows.map((row) => row[label]));
+        return { label, key, data_type: dataType };
+    });
+    const dateColumnKeys = new Set(columns.filter((column) => column.data_type === "timestamptz").map((column) => column.key));
+    return {
+        columns,
+        keyBySource,
+        rows: rows.map((row) => {
+            const normalized = {};
+            for (const label of labels) {
+                if (!Object.hasOwn(row, label))
+                    continue;
+                const key = keyBySource[label] ?? label;
+                const value = row[label];
+                normalized[key] = dateColumnKeys.has(key)
+                    ? parseDateValueToIso(value, { allowExcelSerial: true })
+                    : value;
+            }
+            return normalized;
+        }),
+    };
+}
+export function normalizeImportColumnKey(value) {
+    const normalized = value
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_+/g, "_");
+    const base = normalized || "column";
+    const prefixed = /^[0-9]/.test(base) ? `c_${base}` : base;
+    return prefixed.slice(0, MAX_IDENTIFIER_LENGTH);
+}
+async function parseXlsxRows(buffer, options) {
+    let rows;
+    try {
+        rows = await readXlsxFile(buffer, options.sheet ? { sheet: options.sheet } : {});
+    }
+    catch (error) {
+        throw new OxygenError("invalid_rows", "XLSX sheet was not found.", {
+            details: {
+                sheet: options.sheet ?? null,
+                reason: error instanceof Error ? error.message : String(error),
+            },
+            exitCode: 1,
+        });
+    }
+    const [header, ...body] = rows;
+    if (!header || header.length === 0)
+        return [];
+    const labels = header
+        .map((cell, index) => ({
+        index,
+        label: cell === null || cell === undefined ? "" : String(cell).trim(),
+    }))
+        .filter((entry) => entry.label);
+    return body
+        .filter((row) => row.some((cell) => cell !== null && cell !== undefined && String(cell).trim()))
+        .map((row) => Object.fromEntries(labels.map((entry) => [entry.label, normalizeXlsxImportCell(row[entry.index])])));
+}
+function normalizeXlsxImportCell(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    return String(value);
+}
+function parseJsonArray(text) {
+    const parsed = JSON.parse(text);
+    if (!Array.isArray(parsed)) {
+        throw new OxygenError("invalid_json", "Expected a JSON array.", { exitCode: 1 });
+    }
+    return parsed;
+}
+function normalizeRowObjects(rows) {
+    return rows.map((row) => {
+        if (!row || typeof row !== "object" || Array.isArray(row)) {
+            throw new OxygenError("invalid_rows", "Rows must be JSON objects.", { exitCode: 1 });
+        }
+        return row;
+    });
+}
+function parseCsvRows(text) {
+    const records = parseCsvRecords(text);
+    const [header, ...rows] = records;
+    if (!header || header.length === 0)
+        return [];
+    return rows
+        .filter((row) => row.some((cell) => cell.trim()))
+        .map((row) => Object.fromEntries(header.map((key, index) => [key, normalizeCsvImportCell(row[index])])));
+}
+function normalizeCsvImportCell(value) {
+    if (value === undefined || value === "")
+        return null;
+    return value;
+}
+function parseCsvRecords(text) {
+    const records = [];
+    let record = [];
+    let field = "";
+    let inQuotes = false;
+    for (let index = 0; index < text.length; index += 1) {
+        const char = text[index];
+        const next = text[index + 1];
+        if (inQuotes) {
+            if (char === "\"" && next === "\"") {
+                field += "\"";
+                index += 1;
+            }
+            else if (char === "\"") {
+                inQuotes = false;
+            }
+            else {
+                field += char;
+            }
+            continue;
+        }
+        if (char === "\"") {
+            inQuotes = true;
+        }
+        else if (char === ",") {
+            record.push(field);
+            field = "";
+        }
+        else if (char === "\n") {
+            record.push(field);
+            records.push(record);
+            record = [];
+            field = "";
+        }
+        else if (char !== "\r") {
+            field += char;
+        }
+    }
+    if (field || record.length > 0) {
+        record.push(field);
+        records.push(record);
+    }
+    return records;
+}
+function makeUniqueImportKey(label, taken) {
+    const normalized = normalizeImportColumnKey(label);
+    if (!taken.has(normalized)) {
+        taken.add(normalized);
+        return normalized;
+    }
+    for (let index = 2; index < 10_000; index += 1) {
+        const suffix = `_${index}`;
+        const candidate = `${normalized.slice(0, MAX_IDENTIFIER_LENGTH - suffix.length)}${suffix}`;
+        if (!taken.has(candidate)) {
+            taken.add(candidate);
+            return candidate;
+        }
+    }
+    throw new OxygenError("identifier_exhausted", "Unable to create a unique column key.", {
+        details: { label },
+        exitCode: 1,
+    });
+}
+//# sourceMappingURL=file-import.js.map

package/node_modules/@oxygen/shared/dist/file-import.js.map

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

package/node_modules/@oxygen/shared/dist/index.d.ts

@@ -0,0 +1,45 @@
+export { OXYGEN_VERSION } from "./version.js";
+export * from "./billing.js";
+export * from "./column-types.js";
+export * from "./credit-guidance.js";
+export * from "./log.js";
+export * from "./telemetry.js";
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type CliMeta = {
+    command: string;
+    version: string;
+};
+export type CliSuccess<T> = {
+    ok: true;
+    data: T;
+    meta: CliMeta;
+};
+export type CliFailure = {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    meta: CliMeta;
+};
+export type CliResult<T> = CliSuccess<T> | CliFailure;
+export declare class OxygenError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    readonly exitCode: number;
+    constructor(code: string, message: string, options?: {
+        details?: unknown;
+        exitCode?: number;
+    });
+}
+export declare function success<T>(command: string, data: T, version?: string): CliSuccess<T>;
+export declare function failure(command: string, error: {
+    code: string;
+    message: string;
+    details?: unknown;
+}, version?: string): CliFailure;
+export declare function toFailure(command: string, error: unknown, version?: string): CliFailure;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@oxygen/shared/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAE/B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;AAEtD,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;CAOlG;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,SAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAS5F;AAED,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3D,OAAO,SAAiB,GACvB,UAAU,CASZ;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,SAAiB,GAAG,UAAU,CAU/F"}

package/node_modules/@oxygen/shared/dist/index.js

@@ -0,0 +1,49 @@
+import { OXYGEN_VERSION } from "./version.js";
+export { OXYGEN_VERSION } from "./version.js";
+export * from "./billing.js";
+export * from "./column-types.js";
+export * from "./credit-guidance.js";
+export * from "./log.js";
+export * from "./telemetry.js";
+export class OxygenError extends Error {
+    code;
+    details;
+    exitCode;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = "OxygenError";
+        this.code = code;
+        this.details = options.details;
+        this.exitCode = options.exitCode ?? 1;
+    }
+}
+export function success(command, data, version = OXYGEN_VERSION) {
+    return {
+        ok: true,
+        data,
+        meta: {
+            command,
+            version
+        }
+    };
+}
+export function failure(command, error, version = OXYGEN_VERSION) {
+    return {
+        ok: false,
+        error,
+        meta: {
+            command,
+            version
+        }
+    };
+}
+export function toFailure(command, error, version = OXYGEN_VERSION) {
+    if (error instanceof OxygenError) {
+        return failure(command, { code: error.code, message: error.message, details: error.details }, version);
+    }
+    if (error instanceof Error) {
+        return failure(command, { code: "unexpected_error", message: error.message }, version);
+    }
+    return failure(command, { code: "unexpected_error", message: "An unexpected error occurred." }, version);
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@oxygen/shared/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAiC/B,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,OAAO,CAAW;IAClB,QAAQ,CAAS;IAE1B,YAAY,IAAY,EAAE,OAAe,EAAE,UAAoD,EAAE;QAC/F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,OAAO,CAAI,OAAe,EAAE,IAAO,EAAE,OAAO,GAAG,cAAc;IAC3E,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,IAAI,EAAE;YACJ,OAAO;YACP,OAAO;SACR;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,OAAe,EACf,KAA2D,EAC3D,OAAO,GAAG,cAAc;IAExB,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK;QACL,IAAI,EAAE;YACJ,OAAO;YACP,OAAO;SACR;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAc,EAAE,OAAO,GAAG,cAAc;IACjF,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,+BAA+B,EAAE,EAAE,OAAO,CAAC,CAAC;AAC3G,CAAC"}

package/node_modules/@oxygen/shared/dist/log.d.ts

@@ -0,0 +1,22 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type LogContext = {
+    request_id?: string | undefined;
+    trace_id?: string | undefined;
+    org_id?: string | undefined;
+    user_id?: string | undefined;
+    tool_name?: string | undefined;
+    provider?: string | undefined;
+    operation?: string | undefined;
+    tenant_database_id?: string | undefined;
+    run_id?: string | undefined;
+    chunk_id?: string | undefined;
+    item_id?: string | undefined;
+    worker_id?: string | undefined;
+    surface?: "mcp" | "cli" | "web" | "worker" | undefined;
+};
+export declare function withLogContext<T>(ctx: LogContext, fn: () => T): T;
+export declare function getLogContext(): LogContext;
+export declare function log(level: LogLevel, msg: string, fields?: Record<string, unknown>): void;
+export declare function errorId(err: unknown): string;
+export declare function errorFields(err: unknown): Record<string, unknown>;
+//# sourceMappingURL=log.d.ts.map

package/node_modules/@oxygen/shared/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxD,CAAC;AAIF,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAGjE;AAED,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAoBxF;AAKD,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAO5C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjE"}

package/node_modules/@oxygen/shared/dist/log.js

@@ -0,0 +1,58 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash } from "node:crypto";
+import { sanitizeLogFields } from "./redaction.js";
+import { OXYGEN_VERSION } from "./version.js";
+const store = new AsyncLocalStorage();
+export function withLogContext(ctx, fn) {
+    const merged = { ...(store.getStore() ?? {}), ...ctx };
+    return store.run(merged, fn);
+}
+export function getLogContext() {
+    return store.getStore() ?? {};
+}
+export function log(level, msg, fields) {
+    const line = JSON.stringify({
+        ts: new Date().toISOString(),
+        level,
+        msg,
+        service_name: process.env.OTEL_SERVICE_NAME ?? process.env.OXYGEN_SERVICE_NAME ?? null,
+        oxygen_version: OXYGEN_VERSION,
+        sha: process.env.VERCEL_GIT_COMMIT_SHA ?? null,
+        region: process.env.VERCEL_REGION ?? null,
+        env: process.env.VERCEL_ENV ?? process.env.NODE_ENV ?? null,
+        ...sanitizeLogFields({
+            ...getLogContext(),
+            ...fields,
+        }),
+    });
+    if (level === "error" || level === "warn") {
+        console.error(line);
+    }
+    else {
+        console.log(line);
+    }
+}
+// Short, deterministic id grouping similar errors. Hashes name + message +
+// the first stack frame so the same TypeError at the same location dedupes
+// to one bucket in your log drain queries.
+export function errorId(err) {
+    if (!(err instanceof Error))
+        return "non_error";
+    const firstFrame = (err.stack ?? "").split("\n").slice(1, 2).join("");
+    return createHash("sha256")
+        .update(`${err.name}:${err.message}:${firstFrame}`)
+        .digest("hex")
+        .slice(0, 12);
+}
+export function errorFields(err) {
+    if (err instanceof Error) {
+        return {
+            error_id: errorId(err),
+            error_name: err.name,
+            error_message: err.message,
+            error_stack: err.stack,
+        };
+    }
+    return { error_id: "non_error", error_message: String(err) };
+}
+//# sourceMappingURL=log.js.map

package/node_modules/@oxygen/shared/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoB9C,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAElD,MAAM,UAAU,cAAc,CAAI,GAAe,EAAE,EAAW;IAC5D,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,GAAW,EAAE,MAAgC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,GAAG;QACH,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI;QACtF,cAAc,EAAE,cAAc;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI;QAC9C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI;QACzC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI;QAC3D,GAAG,iBAAiB,CAAC;YACnB,GAAG,aAAa,EAAE;YAClB,GAAG,MAAM;SACV,CAAC;KACH,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,2EAA2E;AAC3E,2CAA2C;AAC3C,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAChD,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;SAClD,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC;YACtB,UAAU,EAAE,GAAG,CAAC,IAAI;YACpB,aAAa,EAAE,GAAG,CAAC,OAAO;YAC1B,WAAW,EAAE,GAAG,CAAC,KAAK;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/node_modules/@oxygen/shared/dist/redaction.d.ts

@@ -0,0 +1,4 @@
+export type PrimitiveTelemetryAttribute = string | number | boolean | string[] | number[] | boolean[];
+export declare function sanitizeLogFields(fields: Record<string, unknown> | undefined): Record<string, unknown>;
+export declare function normalizeTelemetryAttributes(attributes: Record<string, unknown> | undefined): Record<string, PrimitiveTelemetryAttribute>;
+//# sourceMappingURL=redaction.d.ts.map

package/node_modules/@oxygen/shared/dist/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,2BAA2B,GACnC,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,MAAM,EAAE,GACR,OAAO,EAAE,CAAC;AAEd,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAU7C"}

package/node_modules/@oxygen/shared/dist/redaction.js

@@ -0,0 +1,106 @@
+const SECRET_KEY_PATTERN = /(api[_-]?key|x[_-]?key|authorization|bearer|cookie|password|secret|token|ciphertext|connection[_-]?string|connection[_-]?uri|database[_-]?url|dsn)/i;
+const OMITTED_KEY_PATTERN = /^(body|payload|prompt|prompts|raw_prompt|raw_prompts|row|rows|input|inputs|output|outputs|request|response|provider_payload|provider_response|customer_data)$/i;
+const MAX_LOG_STRING_LENGTH = 8_000;
+const MAX_TELEMETRY_STRING_LENGTH = 500;
+const MAX_ARRAY_LENGTH = 20;
+const MAX_OBJECT_KEYS = 40;
+const MAX_REDACTION_DEPTH = 5;
+export function sanitizeLogFields(fields) {
+    if (!fields)
+        return {};
+    const output = {};
+    for (const [key, value] of Object.entries(fields).slice(0, MAX_OBJECT_KEYS)) {
+        output[key] = sanitizeValueForLog(value, key, 0);
+    }
+    return output;
+}
+export function normalizeTelemetryAttributes(attributes) {
+    if (!attributes)
+        return {};
+    const output = {};
+    for (const [rawKey, value] of Object.entries(attributes).slice(0, MAX_OBJECT_KEYS)) {
+        const key = sanitizeAttributeKey(rawKey);
+        if (!key || value === undefined || value === null)
+            continue;
+        const normalized = normalizeTelemetryValue(value, rawKey);
+        if (normalized !== undefined)
+            output[key] = normalized;
+    }
+    return output;
+}
+function sanitizeValueForLog(value, key, depth) {
+    if (SECRET_KEY_PATTERN.test(key))
+        return "[redacted]";
+    if (OMITTED_KEY_PATTERN.test(key))
+        return "[omitted]";
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "string")
+        return truncateString(value, MAX_LOG_STRING_LENGTH);
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === "boolean")
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        if (depth >= MAX_REDACTION_DEPTH)
+            return "[truncated]";
+        return value
+            .slice(0, MAX_ARRAY_LENGTH)
+            .map((entry) => sanitizeValueForLog(entry, key, depth + 1));
+    }
+    if (typeof value === "object") {
+        if (depth >= MAX_REDACTION_DEPTH)
+            return "[truncated]";
+        const output = {};
+        for (const [childKey, childValue] of Object.entries(value).slice(0, MAX_OBJECT_KEYS)) {
+            output[childKey] = sanitizeValueForLog(childValue, childKey, depth + 1);
+        }
+        return output;
+    }
+    return String(value);
+}
+function normalizeTelemetryValue(value, key) {
+    if (SECRET_KEY_PATTERN.test(key))
+        return "[redacted]";
+    if (OMITTED_KEY_PATTERN.test(key))
+        return "[omitted]";
+    if (typeof value === "string")
+        return truncateString(value, MAX_TELEMETRY_STRING_LENGTH);
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value === "boolean")
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        const primitive = value
+            .slice(0, MAX_ARRAY_LENGTH)
+            .filter((entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean");
+        if (primitive.length === 0)
+            return undefined;
+        if (primitive.every((entry) => typeof entry === "string")) {
+            return primitive.map((entry) => truncateString(String(entry), MAX_TELEMETRY_STRING_LENGTH));
+        }
+        if (primitive.every((entry) => typeof entry === "number" && Number.isFinite(entry))) {
+            return primitive;
+        }
+        if (primitive.every((entry) => typeof entry === "boolean")) {
+            return primitive;
+        }
+        return primitive.map((entry) => truncateString(String(entry), MAX_TELEMETRY_STRING_LENGTH));
+    }
+    if (typeof value === "object" && value) {
+        return truncateString(JSON.stringify(sanitizeValueForLog(value, key, 0)), MAX_TELEMETRY_STRING_LENGTH);
+    }
+    return truncateString(String(value), MAX_TELEMETRY_STRING_LENGTH);
+}
+function sanitizeAttributeKey(key) {
+    const normalized = key.trim().replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 120);
+    return normalized || null;
+}
+function truncateString(value, maxLength) {
+    return value.length > maxLength ? `${value.slice(0, maxLength)}...` : value;
+}
+//# sourceMappingURL=redaction.js.map

package/node_modules/@oxygen/shared/dist/redaction.js.map

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

package/node_modules/@oxygen/shared/dist/telemetry.d.ts

@@ -0,0 +1,9 @@
+export type TelemetryAttributes = Record<string, unknown>;
+export declare function withTelemetrySpan<T>(tracerName: string, name: string, attributes: TelemetryAttributes | undefined, fn: () => Promise<T>): Promise<T>;
+export declare function setActiveTelemetryAttributes(attributes: TelemetryAttributes): void;
+export declare function markActiveTelemetryError(message: string, attributes?: TelemetryAttributes): void;
+export declare function addTelemetryEvent(name: string, attributes?: TelemetryAttributes): void;
+export declare function recordTelemetryCounter(name: string, value?: number, attributes?: TelemetryAttributes): void;
+export declare function recordTelemetryHistogram(name: string, value: number, attributes?: TelemetryAttributes): void;
+export declare function commonTelemetryAttributes(attributes?: TelemetryAttributes): TelemetryAttributes;
+//# sourceMappingURL=telemetry.d.ts.map

package/node_modules/@oxygen/shared/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAK1D,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAIlF;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,mBAAmB,GAC/B,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAItF;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,UAAU,CAAC,EAAE,mBAAmB,GAC/B,IAAI,CAIN;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,mBAAmB,GAC/B,IAAI,CAIN;AAED,wBAAgB,yBAAyB,CACvC,UAAU,CAAC,EAAE,mBAAmB,GAC/B,mBAAmB,CAQrB"}