@agent-native/creative-context 0.1.0

package/dist/connectors/types.d.ts

@@ -0,0 +1,79 @@
+import type { PrivateBlobHandle, PrivateBlobPutInput, PrivateBlobReadResult } from "@agent-native/core/private-blob";
+import type { ProviderApiRuntime } from "@agent-native/core/provider-api";
+import type { NormalizedContextItem, UpstreamAccess } from "../types.js";
+import type { RenderedPageProvider } from "./rendered-page.js";
+export type ContextConnectorKind = "manual" | "upload" | "google-slides" | "figma" | "notion" | "website";
+export interface ContextConnectorInventoryItem {
+    externalId: string;
+    kind: string;
+    title: string;
+    canonicalUrl?: string;
+    mimeType?: string;
+    sourceModifiedAt?: string;
+    sizeBytes?: number;
+    upstreamAccess?: UpstreamAccess;
+    metadata?: Record<string, unknown>;
+}
+export interface ContextConnectorInventoryRequest {
+    sourceId: string;
+    config: Record<string, unknown>;
+    cursor?: string | null;
+    syncCursor?: string | null;
+    limit?: number;
+}
+export interface ContextConnectorInventoryPage {
+    items: ContextConnectorInventoryItem[];
+    nextCursor: string | null;
+    complete: boolean;
+    syncCursor?: string | null;
+    coverage: {
+        inspected: number;
+        returned: number;
+        truncated: boolean;
+    };
+}
+export interface ContextConnectorFetchRequest {
+    sourceId: string;
+    config: Record<string, unknown>;
+    item: ContextConnectorInventoryItem;
+}
+export interface ContextConnectorFetchResult {
+    items: NormalizedContextItem[];
+    warnings?: string[];
+}
+export interface ContextUploadContent {
+    text: string;
+    mimeType?: string;
+    title?: string;
+    canonicalUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ContextConnectorExecutionContext {
+    appId: string;
+    ownerEmail?: string;
+    providerApi?: Pick<ProviderApiRuntime, "executeRequest">;
+    renderedPages?: RenderedPageProvider;
+    signal?: AbortSignal;
+    now?: () => Date;
+    resolveConnection?: (provider: string, requestedConnectionId?: string) => Promise<string | undefined>;
+    loadUpload?: (item: ContextConnectorInventoryItem, config: Record<string, unknown>) => Promise<ContextUploadContent>;
+    putPrivateBlob?: (input: PrivateBlobPutInput) => Promise<PrivateBlobHandle | null>;
+    readPrivateBlob?: (handle: PrivateBlobHandle) => Promise<PrivateBlobReadResult>;
+}
+export interface ContextImportConnector {
+    readonly kind: ContextConnectorKind;
+    readonly label: string;
+    readonly supportsIncremental: boolean;
+    inventory(request: ContextConnectorInventoryRequest, context: ContextConnectorExecutionContext): Promise<ContextConnectorInventoryPage>;
+    fetch(request: ContextConnectorFetchRequest, context: ContextConnectorExecutionContext): Promise<ContextConnectorFetchResult>;
+    verifiesContainerOwner?(input: {
+        config: Record<string, unknown>;
+        inventory: ContextConnectorInventoryItem[];
+    }): boolean;
+}
+export interface ContextImportConnectorSummary {
+    kind: ContextConnectorKind;
+    label: string;
+    supportsIncremental: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/types.d.ts.map

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

package/dist/connectors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":""}

package/dist/connectors/upload.d.ts

@@ -0,0 +1,9 @@
+import type { ContextConnectorExecutionContext, ContextConnectorFetchRequest, ContextConnectorFetchResult, ContextConnectorInventoryPage, ContextConnectorInventoryRequest, ContextImportConnector } from "./types.js";
+export declare class UploadContextConnector implements ContextImportConnector {
+    readonly kind: "upload";
+    readonly label = "Uploaded files";
+    readonly supportsIncremental = false;
+    inventory(request: ContextConnectorInventoryRequest, _context: ContextConnectorExecutionContext): Promise<ContextConnectorInventoryPage>;
+    fetch(request: ContextConnectorFetchRequest, context: ContextConnectorExecutionContext): Promise<ContextConnectorFetchResult>;
+}
+//# sourceMappingURL=upload.d.ts.map

package/dist/connectors/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/connectors/upload.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,EAE3B,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAepB,qBAAa,sBAAuB,YAAW,sBAAsB;IACnE,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,oBAAoB;IAClC,QAAQ,CAAC,mBAAmB,SAAS;IAE/B,SAAS,CACb,OAAO,EAAE,gCAAgC,EACzC,QAAQ,EAAE,gCAAgC,GACzC,OAAO,CAAC,6BAA6B,CAAC,CAiCxC;IAEK,KAAK,CACT,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,2BAA2B,CAAC,CAoNtC;CACF"}

package/dist/connectors/upload.js

@@ -0,0 +1,440 @@
+import { parseUploadedDocument } from "./document-parser.js";
+import { normalizeContextItem } from "./normalize.js";
+import { fetchRemoteArtifact, parsePrivateBlobHandle, readPrivateArtifact, sanitizeProvenanceUrl, sanitizeRemoteArtifact, serializePrivateBlobHandle, storePrivateArtifact, } from "./private-artifacts.js";
+import { asRecord, cursorOffset, positiveLimit, stringValue, } from "./provider-response.js";
+export class UploadContextConnector {
+    kind = "upload";
+    label = "Uploaded files";
+    supportsIncremental = false;
+    async inventory(request, _context) {
+        const entries = parseUploadEntries(request.config);
+        const offset = cursorOffset(request.cursor);
+        const limit = positiveLimit(request.limit, 100, 1_000);
+        const slice = entries.slice(offset, offset + limit);
+        const nextOffset = offset + slice.length;
+        return {
+            items: slice.map((entry, index) => ({
+                externalId: entry.id,
+                kind: isSupportedImageUpload(entry.mimeType, entry.fileName)
+                    ? "uploaded-image"
+                    : "uploaded-document",
+                title: entry.title,
+                ...(entry.url
+                    ? { canonicalUrl: sanitizeProvenanceUrl(entry.url) }
+                    : {}),
+                ...(entry.mimeType ? { mimeType: entry.mimeType } : {}),
+                ...(entry.sourceModifiedAt
+                    ? { sourceModifiedAt: entry.sourceModifiedAt }
+                    : {}),
+                metadata: {
+                    entryIndex: offset + index,
+                    ...(entry.storageKey ? { storageKey: entry.storageKey } : {}),
+                },
+            })),
+            nextCursor: nextOffset < entries.length ? String(nextOffset) : null,
+            complete: nextOffset >= entries.length,
+            coverage: {
+                inspected: slice.length,
+                returned: slice.length,
+                truncated: nextOffset < entries.length,
+            },
+        };
+    }
+    async fetch(request, context) {
+        const entry = findUploadEntry(request.config, request.item);
+        const loaded = context.loadUpload
+            ? await context.loadUpload(request.item, request.config)
+            : await loadAndParseUpload(entry, context);
+        const loadedMetadata = loaded.metadata ?? {};
+        const storageKey = stringValue(loadedMetadata.privateBlobRef);
+        if (loadedMetadata.standaloneImage === true) {
+            if (!storageKey) {
+                throw new Error(`Uploaded image ${entry.id} must be persisted in private blob storage.`);
+            }
+            const mimeType = stringValue(loaded.mimeType) ?? entry.mimeType;
+            const contentHash = stringValue(loadedMetadata.contentHash);
+            if (!mimeType || !contentHash) {
+                throw new Error(`Uploaded image ${entry.id} is missing media metadata.`);
+            }
+            const palette = Array.isArray(loadedMetadata.palette)
+                ? loadedMetadata.palette.filter((value) => typeof value === "string")
+                : [];
+            const canonicalUrl = loaded.canonicalUrl
+                ? sanitizeProvenanceUrl(loaded.canonicalUrl)
+                : entry.url
+                    ? sanitizeProvenanceUrl(entry.url)
+                    : undefined;
+            return {
+                items: [
+                    normalizeContextItem({
+                        externalId: entry.id,
+                        kind: "uploaded-image",
+                        title: loaded.title ?? entry.title,
+                        content: "",
+                        canonicalUrl,
+                        mimeType,
+                        sourceModifiedAt: entry.sourceModifiedAt,
+                        sourceVersion: contentHash,
+                        rawSnapshotBlobRef: storageKey,
+                        thumbnailBlobRef: storageKey,
+                        parseStatus: "parsed",
+                        provenance: { provider: "upload", uploadId: entry.id },
+                        metadata: {
+                            ...entry.metadata,
+                            ...loadedMetadata,
+                            parser: "standalone-image",
+                        },
+                        media: [
+                            {
+                                kind: "image",
+                                mimeType,
+                                accessMode: "private",
+                                storageKey,
+                                ...(canonicalUrl ? { provenanceUrl: canonicalUrl } : {}),
+                                contentHash,
+                                ...(palette.length ? { palette } : {}),
+                                captionStatus: "pending",
+                                metadata: { fileName: entry.fileName },
+                            },
+                        ],
+                    }),
+                ],
+            };
+        }
+        const parsed = asParsedUpload(loaded, entry);
+        const canonicalUrl = loaded.canonicalUrl
+            ? sanitizeProvenanceUrl(loaded.canonicalUrl)
+            : entry.url
+                ? sanitizeProvenanceUrl(entry.url)
+                : undefined;
+        const originalHash = stringValue(loadedMetadata.contentHash);
+        const normalized = await Promise.all(parsed.parts.map(async (part) => {
+            const imageMedia = await Promise.all((part.images ?? []).map(async (image) => {
+                const safeMimeType = resolveSupportedImageMimeType(image.mimeType, image.name);
+                if (!safeMimeType) {
+                    throw new Error(`Embedded image ${image.name} uses an unsupported media type.`);
+                }
+                const safeData = assertSafeImageBytes(image.data, safeMimeType);
+                const stored = await storePrivateArtifact({
+                    data: safeData,
+                    filename: image.name,
+                    mimeType: safeMimeType,
+                    context,
+                    metadata: {
+                        kind: "creative-context-upload-image",
+                        externalId: entry.id,
+                        partIndex: part.index,
+                    },
+                });
+                return {
+                    kind: "image",
+                    mimeType: safeMimeType,
+                    accessMode: "private",
+                    storageKey: stored.reference,
+                    contentHash: stored.contentHash,
+                    palette: stored.palette,
+                    captionStatus: "pending",
+                    metadata: { partIndex: part.index, fileName: image.name },
+                };
+            }));
+            return normalizeContextItem({
+                externalId: `${entry.id}:${part.kind}-${part.index + 1}`,
+                kind: `uploaded-${part.kind}`,
+                title: `${parsed.title || loaded.title || entry.title} — ${part.title}`,
+                content: part.text,
+                canonicalUrl,
+                mimeType: loaded.mimeType ?? entry.mimeType,
+                sourceModifiedAt: entry.sourceModifiedAt,
+                sourceVersion: originalHash,
+                rawSnapshotBlobRef: storageKey,
+                parseStatus: "parsed",
+                provenance: {
+                    provider: "upload",
+                    uploadId: entry.id,
+                    partKind: part.kind,
+                    partIndex: part.index,
+                },
+                metadata: {
+                    ...entry.metadata,
+                    ...loadedMetadata,
+                    parser: parsed.parser,
+                    part: part.metadata,
+                    notes: part.notes,
+                    textRuns: part.textRuns,
+                },
+                media: [
+                    ...(entry.url || storageKey || entry.storageKey
+                        ? [
+                            {
+                                kind: "document",
+                                ...(entry.mimeType ? { mimeType: entry.mimeType } : {}),
+                                accessMode: storageKey || entry.storageKey
+                                    ? "private"
+                                    : "public",
+                                ...(storageKey || entry.storageKey
+                                    ? { storageKey: storageKey ?? entry.storageKey }
+                                    : {}),
+                                ...(canonicalUrl ? { provenanceUrl: canonicalUrl } : {}),
+                                ...(originalHash ? { contentHash: originalHash } : {}),
+                                captionStatus: "not-needed",
+                            },
+                        ]
+                        : []),
+                    ...imageMedia,
+                ],
+                edges: [{ relation: "part-of-upload", toExternalId: entry.id }],
+            });
+        }));
+        const parent = normalizeContextItem({
+            externalId: entry.id,
+            kind: request.item.kind,
+            title: parsed.title || loaded.title || entry.title,
+            content: normalized
+                .map((item, index) => {
+                const excerpt = item.content.slice(0, 2_000);
+                return `Part ${index + 1}: ${item.title}${excerpt ? `\n${excerpt}` : ""}`;
+            })
+                .join("\n\n")
+                .slice(0, 50_000),
+            summary: `${normalized.length} indexed document part${normalized.length === 1 ? "" : "s"}.`,
+            canonicalUrl,
+            mimeType: loaded.mimeType ?? entry.mimeType,
+            sourceModifiedAt: entry.sourceModifiedAt,
+            sourceVersion: originalHash,
+            rawSnapshotBlobRef: storageKey,
+            parseStatus: "parsed",
+            provenance: { provider: "upload", uploadId: entry.id },
+            metadata: {
+                ...entry.metadata,
+                ...loadedMetadata,
+                parser: parsed.parser,
+                partCount: normalized.length,
+                childExternalIds: normalized.map((item) => item.externalId),
+            },
+            media: canonicalUrl || storageKey || entry.storageKey
+                ? [
+                    {
+                        kind: "document",
+                        ...(entry.mimeType ? { mimeType: entry.mimeType } : {}),
+                        accessMode: storageKey || entry.storageKey ? "private" : "public",
+                        ...(storageKey || entry.storageKey
+                            ? { storageKey: storageKey ?? entry.storageKey }
+                            : { url: canonicalUrl }),
+                        ...(canonicalUrl ? { provenanceUrl: canonicalUrl } : {}),
+                        ...(originalHash ? { contentHash: originalHash } : {}),
+                        captionStatus: "not-needed",
+                    },
+                ]
+                : undefined,
+            edges: normalized.map((item) => ({
+                relation: "contains-upload-part",
+                toExternalId: item.externalId,
+            })),
+        });
+        return {
+            items: [parent, ...normalized],
+        };
+    }
+}
+function parseUploadEntries(config) {
+    if (!Array.isArray(config.items)) {
+        throw new Error("Upload connector config.items must be an array.");
+    }
+    return config.items.map((value, index) => {
+        const item = asRecord(value);
+        const id = stringValue(item?.id) ?? `upload-${index + 1}`;
+        if (stringValue(item?.data) || stringValue(item?.base64)) {
+            throw new Error(`Upload ${id} contains inline file data; persist it in blob storage and pass storageKey or url.`);
+        }
+        const storageKey = stringValue(item?.storageKey);
+        const blobHandle = asRecord(item?.blobHandle) ?? undefined;
+        const url = stringValue(item?.url);
+        const extractedText = stringValue(item?.extractedText);
+        if (!storageKey && !blobHandle && !url && !extractedText) {
+            throw new Error(`Upload ${id} requires storageKey, url, or pre-extracted text.`);
+        }
+        return {
+            id,
+            title: stringValue(item?.title) ??
+                stringValue(item?.fileName) ??
+                `Upload ${index + 1}`,
+            fileName: stringValue(item?.fileName) ?? stringValue(item?.title) ?? `${id}.bin`,
+            storageKey,
+            blobHandle,
+            url,
+            mimeType: stringValue(item?.mimeType),
+            extractedText,
+            sourceModifiedAt: stringValue(item?.sourceModifiedAt),
+            metadata: asRecord(item?.metadata) ?? undefined,
+        };
+    });
+}
+async function loadAndParseUpload(entry, context) {
+    const handle = parsePrivateBlobHandle(entry.blobHandle ?? entry.storageKey);
+    let data = null;
+    let privateBlobRef = handle ? serializePrivateBlobHandle(handle) : undefined;
+    let mimeType = entry.mimeType;
+    let canonicalUrl = entry.url;
+    if (handle) {
+        data = await readPrivateArtifact(handle, context);
+    }
+    else if (entry.url) {
+        const remote = await fetchRemoteArtifact(entry.url, context);
+        data = remote.data;
+        mimeType ??= remote.mimeType;
+        canonicalUrl = remote.finalUrl;
+    }
+    if (data) {
+        const imageMimeType = resolveSupportedImageMimeType(mimeType, entry.fileName);
+        if (imageMimeType) {
+            const safeData = assertSafeImageBytes(data, imageMimeType);
+            if (!handle || imageMimeType === "image/svg+xml") {
+                const stored = await storePrivateArtifact({
+                    data: safeData,
+                    filename: entry.fileName,
+                    mimeType: imageMimeType,
+                    context,
+                    metadata: {
+                        kind: "creative-context-upload",
+                        externalId: entry.id,
+                    },
+                });
+                privateBlobRef = stored.reference;
+            }
+            const fingerprint = fingerprintMedia(safeData, imageMimeType);
+            const palette = await extractDominantColors(safeData).catch(() => []);
+            return {
+                text: "",
+                mimeType: imageMimeType,
+                title: entry.title,
+                canonicalUrl,
+                metadata: {
+                    ...entry.metadata,
+                    standaloneImage: true,
+                    contentHash: fingerprint.sha256,
+                    palette,
+                    ...(privateBlobRef ? { privateBlobRef } : {}),
+                },
+            };
+        }
+        if (!handle) {
+            const stored = await storePrivateArtifact({
+                data,
+                filename: entry.fileName,
+                mimeType,
+                context,
+                metadata: { kind: "creative-context-upload", externalId: entry.id },
+            });
+            privateBlobRef = stored.reference;
+        }
+        const parsed = await parseUploadedDocument({
+            data,
+            fileName: entry.fileName,
+            mimeType,
+            signal: context.signal,
+        });
+        const fingerprint = fingerprintMedia(data, mimeType);
+        return {
+            text: parsed.text,
+            parts: parsed.parts,
+            parser: parsed.parser,
+            documentTitle: parsed.title,
+            mimeType,
+            title: entry.title,
+            canonicalUrl,
+            metadata: {
+                ...entry.metadata,
+                parser: parsed.parser,
+                fileType: parsed.fileType,
+                parserMetadata: parsed.metadata,
+                parserWarnings: parsed.warnings,
+                contentHash: fingerprint.sha256,
+                ...(privateBlobRef ? { privateBlobRef } : {}),
+            },
+        };
+    }
+    if (entry.extractedText) {
+        return {
+            text: entry.extractedText,
+            mimeType,
+            title: entry.title,
+            canonicalUrl,
+            metadata: { ...entry.metadata, parser: "pre-extracted-text" },
+        };
+    }
+    throw new Error(`Upload ${entry.id} could not be loaded.`);
+}
+const IMAGE_MIME_BY_EXTENSION = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+};
+function resolveSupportedImageMimeType(mimeType, fileName) {
+    const normalized = mimeType?.split(";")[0]?.trim().toLowerCase();
+    if (normalized &&
+        Object.values(IMAGE_MIME_BY_EXTENSION).includes(normalized)) {
+        return normalized;
+    }
+    const extension = fileName.toLowerCase().match(/\.[a-z0-9]+$/)?.[0];
+    return extension ? (IMAGE_MIME_BY_EXTENSION[extension] ?? null) : null;
+}
+function isSupportedImageUpload(mimeType, fileName) {
+    return resolveSupportedImageMimeType(mimeType, fileName) !== null;
+}
+function assertSafeImageBytes(data, mimeType) {
+    if (mimeType === "image/svg+xml") {
+        return sanitizeRemoteArtifact({ data, mimeType, filename: "upload.svg" });
+    }
+    const matches = mimeType === "image/png"
+        ? data.length >= 8 &&
+            [137, 80, 78, 71, 13, 10, 26, 10].every((byte, index) => data[index] === byte)
+        : mimeType === "image/jpeg"
+            ? data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff
+            : mimeType === "image/gif"
+                ? new TextDecoder().decode(data.slice(0, 6)).match(/^GIF8[79]a$/)
+                : mimeType === "image/webp"
+                    ? new TextDecoder().decode(data.slice(0, 4)) === "RIFF" &&
+                        new TextDecoder().decode(data.slice(8, 12)) === "WEBP"
+                    : false;
+    if (!matches) {
+        throw new Error(`Uploaded file does not contain a safe ${mimeType} image.`);
+    }
+    return data;
+}
+function asParsedUpload(loaded, entry) {
+    const structured = loaded;
+    if (Array.isArray(structured.parts) && structured.parts.length > 0) {
+        return {
+            parser: structured.parser ?? "plain-text",
+            title: structured.documentTitle ?? structured.title ?? entry.title,
+            parts: structured.parts,
+        };
+    }
+    const part = {
+        kind: "document",
+        index: 0,
+        title: loaded.title ?? entry.title,
+        text: loaded.text,
+    };
+    return {
+        parser: "plain-text",
+        title: loaded.title ?? entry.title,
+        parts: [part],
+    };
+}
+function findUploadEntry(config, inventoryItem) {
+    const entries = parseUploadEntries(config);
+    const index = Number(inventoryItem.metadata?.entryIndex);
+    const byIndex = Number.isInteger(index) ? entries[index] : undefined;
+    const entry = byIndex?.id === inventoryItem.externalId
+        ? byIndex
+        : entries.find((candidate) => candidate.id === inventoryItem.externalId);
+    if (!entry)
+        throw new Error(`Upload ${inventoryItem.externalId} not found.`);
+    return entry;
+}
+import { extractDominantColors, fingerprintMedia, } from "@agent-native/core/ingestion";
+//# sourceMappingURL=upload.js.map

package/dist/connectors/upload.js.map

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

package/dist/connectors/website.d.ts

@@ -0,0 +1,20 @@
+import { ssrfSafeFetch } from "@agent-native/core/extensions/url-safety";
+import type { ContextConnectorExecutionContext, ContextConnectorFetchRequest, ContextConnectorFetchResult, ContextConnectorInventoryPage, ContextConnectorInventoryRequest, ContextImportConnector } from "./types.js";
+export interface WebsiteReference {
+    url: string;
+    title: string;
+}
+export declare class WebsiteContextConnector implements ContextImportConnector {
+    #private;
+    readonly kind: "website";
+    readonly label = "Websites";
+    readonly supportsIncremental = true;
+    inventory(request: ContextConnectorInventoryRequest, context: ContextConnectorExecutionContext): Promise<ContextConnectorInventoryPage>;
+    fetch(request: ContextConnectorFetchRequest, context: ContextConnectorExecutionContext): Promise<ContextConnectorFetchResult>;
+}
+export declare function discoverWebsiteInventory(config: Record<string, unknown>, signal?: AbortSignal, fetcher?: typeof ssrfSafeFetch): Promise<{
+    references: WebsiteReference[];
+    inspected: number;
+    truncated: boolean;
+}>;
+//# sourceMappingURL=website.d.ts.map

package/dist/connectors/website.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../../src/connectors/website.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAyBzE,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,uBAAwB,YAAW,sBAAsB;;IACpE,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,KAAK,cAAc;IAC5B,QAAQ,CAAC,mBAAmB,QAAQ;IAG9B,SAAS,CACb,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,6BAA6B,CAAC,CA0BxC;IAEK,KAAK,CACT,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,2BAA2B,CAAC,CA8ItC;CACF;AAgQD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC;IACT,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAoKD"}