@agent-native/creative-context 0.1.0

package/dist/connectors/provider-response.d.ts

@@ -0,0 +1,20 @@
+import type { ProviderApiRequestArgs, ProviderApiRuntime } from "@agent-native/core/provider-api";
+export declare class ContextConnectorQuotaError extends Error {
+    readonly provider: string;
+    readonly retryAt: string;
+    readonly retryAfterMs: number;
+    constructor(input: {
+        provider: string;
+        retryAt: string;
+        retryAfterMs?: number;
+    });
+}
+export declare function isContextConnectorQuotaError(value: unknown): value is ContextConnectorQuotaError;
+export declare function executeConnectorProviderRequest(runtime: Pick<ProviderApiRuntime, "executeRequest"> | undefined, args: ProviderApiRequestArgs): Promise<unknown>;
+export declare function connectorConnectionId(provider: string, config: Record<string, unknown>, resolve?: (provider: string, requestedConnectionId?: string) => Promise<string | undefined>): Promise<string | undefined>;
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function stringArray(value: unknown): string[];
+export declare function positiveLimit(value: unknown, fallback?: number, max?: number): number;
+export declare function cursorOffset(cursor: string | null | undefined): number;
+//# sourceMappingURL=provider-response.d.ts.map

package/dist/connectors/provider-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-response.d.ts","sourceRoot":"","sources":["../../src/connectors/provider-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAEzC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,YAAY,KAAK,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAMA;CACF;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAErC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,GAAG,SAAS,EAC/D,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,CACR,QAAQ,EAAE,MAAM,EAChB,qBAAqB,CAAC,EAAE,MAAM,KAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4B7B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAIpD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,SAAM,EACd,GAAG,SAAQ,GACV,MAAM,CAKR;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGtE"}

package/dist/connectors/provider-response.js

@@ -0,0 +1,98 @@
+export class ContextConnectorQuotaError extends Error {
+    provider;
+    retryAt;
+    retryAfterMs;
+    constructor(input) {
+        super(`Provider quota exhausted; retry after ${input.retryAt}.`);
+        this.name = "ContextConnectorQuotaError";
+        this.provider = input.provider;
+        this.retryAt = input.retryAt;
+        this.retryAfterMs = Math.max(0, input.retryAfterMs ?? 0);
+    }
+}
+export function isContextConnectorQuotaError(value) {
+    return value instanceof ContextConnectorQuotaError;
+}
+export async function executeConnectorProviderRequest(runtime, args) {
+    if (!runtime) {
+        throw new Error(`The ${args.provider} connector requires a provider API runtime.`);
+    }
+    const raw = (await runtime.executeRequest(args));
+    const response = asRecord(raw.response);
+    if (!response)
+        return raw;
+    const quota = asRecord(response.quota);
+    if (quota?.exhausted === true) {
+        throw new ContextConnectorQuotaError({
+            provider: stringValue(quota.providerId) ?? String(args.provider),
+            retryAt: stringValue(quota.retryAt) ??
+                new Date(Date.now() + Number(quota.retryAfterMs ?? 60_000)).toISOString(),
+            retryAfterMs: Number(quota.retryAfterMs ?? 0),
+        });
+    }
+    if (response.ok !== true) {
+        const status = response.status ?? "unknown";
+        const detail = response.text ?? response.json ?? response.statusText ?? "";
+        throw new Error(`Provider request failed (${String(status)}): ${brief(detail)}`);
+    }
+    if (response.json !== undefined)
+        return response.json;
+    if (typeof response.text === "string") {
+        try {
+            return JSON.parse(response.text);
+        }
+        catch {
+            return response.text;
+        }
+    }
+    return null;
+}
+export async function connectorConnectionId(provider, config, resolve) {
+    const requested = stringValue(config.connectionId);
+    const credentialMode = stringValue(config.credentialMode);
+    if (credentialMode === "admin-token" || config.useAdminToken === true) {
+        if (provider !== "figma") {
+            throw new Error(`${provider} creative-context imports require a per-user granted workspace connection; admin-token mode is not allowed.`);
+        }
+        if (requested) {
+            throw new Error(`${provider} connector config cannot combine connectionId with admin-token credentialMode.`);
+        }
+        return undefined;
+    }
+    if (!resolve) {
+        throw new Error(`${provider} creative-context imports require a workspace connection resolver.`);
+    }
+    const resolved = await resolve(provider, requested);
+    if (!resolved) {
+        throw new Error(`${provider} creative-context imports require a granted workspace connection.`);
+    }
+    return resolved;
+}
+export function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+export function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+export function stringArray(value) {
+    return Array.isArray(value)
+        ? value.map(stringValue).filter((item) => Boolean(item))
+        : [];
+}
+export function positiveLimit(value, fallback = 100, max = 1_000) {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0
+        ? Math.min(parsed, max)
+        : fallback;
+}
+export function cursorOffset(cursor) {
+    const parsed = Number(cursor ?? 0);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : 0;
+}
+function brief(value) {
+    const text = typeof value === "string" ? value : JSON.stringify(value);
+    return (text ?? "").slice(0, 500);
+}
+//# sourceMappingURL=provider-response.js.map

package/dist/connectors/provider-response.js.map

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

package/dist/connectors/recommendations.d.ts

@@ -0,0 +1,25 @@
+import type { ContextConnectorExecutionContext } from "./types.js";
+export type ContextRootRecommendationProvider = "notion" | "google-slides" | "figma";
+export interface ContextRootRecommendation {
+    externalId: string;
+    provider: ContextRootRecommendationProvider;
+    kind: "page" | "presentation" | "file";
+    title: string;
+    canonicalUrl?: string;
+    sourceModifiedAt?: string;
+    containerRef?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function recommendContextRoots(input: {
+    provider: ContextRootRecommendationProvider;
+    connectionId?: string;
+    limit?: number;
+    figmaProjectId?: string;
+    figmaTeamId?: string;
+}, context: ContextConnectorExecutionContext): Promise<{
+    recommendations: ContextRootRecommendation[];
+    persisted: false;
+    requiresExplicitBoundary: true;
+    unavailableReason?: string;
+}>;
+//# sourceMappingURL=recommendations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../src/connectors/recommendations.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,iCAAiC,GACzC,QAAQ,GACR,eAAe,GACf,OAAO,CAAC;AAEZ,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE;IACL,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC;IACT,eAAe,EAAE,yBAAyB,EAAE,CAAC;IAC7C,SAAS,EAAE,KAAK,CAAC;IACjB,wBAAwB,EAAE,IAAI,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC,CAwKD"}

package/dist/connectors/recommendations.js

@@ -0,0 +1,172 @@
+import { asRecord, connectorConnectionId, executeConnectorProviderRequest, positiveLimit, stringValue, } from "./provider-response.js";
+export async function recommendContextRoots(input, context) {
+    const limit = positiveLimit(input.limit, 15, 50);
+    const config = input.connectionId ? { connectionId: input.connectionId } : {};
+    if (input.provider === "notion") {
+        const connectionId = await connectorConnectionId("notion", config, context.resolveConnection);
+        const payload = asRecord(await executeConnectorProviderRequest(context.providerApi, {
+            provider: "notion",
+            method: "POST",
+            path: "/search",
+            body: {
+                filter: { property: "object", value: "page" },
+                sort: { direction: "descending", timestamp: "last_edited_time" },
+                page_size: limit,
+            },
+            connectionId,
+        }));
+        const recommendations = (Array.isArray(payload?.results) ? payload.results : []).flatMap((value) => {
+            const page = asRecord(value);
+            const id = stringValue(page?.id);
+            if (!id)
+                return [];
+            return [
+                {
+                    externalId: id,
+                    provider: "notion",
+                    kind: "page",
+                    title: page
+                        ? (notionRecommendationTitle(page) ?? "Notion page")
+                        : "Notion page",
+                    ...(stringValue(page?.url)
+                        ? { canonicalUrl: stringValue(page?.url) }
+                        : {}),
+                    ...(stringValue(page?.last_edited_time)
+                        ? { sourceModifiedAt: stringValue(page?.last_edited_time) }
+                        : {}),
+                    metadata: { recommendationOnly: true },
+                },
+            ];
+        });
+        return recommendationResult(recommendations.slice(0, limit));
+    }
+    if (input.provider === "google-slides") {
+        const connectionId = await connectorConnectionId("google_drive", config, context.resolveConnection);
+        const payload = asRecord(await executeConnectorProviderRequest(context.providerApi, {
+            provider: "google_drive",
+            method: "GET",
+            path: "/files",
+            query: {
+                q: "mimeType = 'application/vnd.google-apps.presentation' and trashed = false",
+                pageSize: limit,
+                orderBy: "modifiedTime desc",
+                fields: "files(id,name,modifiedTime,webViewLink,parents,driveId,shared,ownedByMe)",
+            },
+            connectionId,
+        }));
+        const recommendations = (Array.isArray(payload?.files) ? payload.files : []).flatMap((value) => {
+            const file = asRecord(value);
+            const id = stringValue(file?.id);
+            if (!id)
+                return [];
+            return [
+                {
+                    externalId: id,
+                    provider: "google-slides",
+                    kind: "presentation",
+                    title: stringValue(file?.name) ?? id,
+                    canonicalUrl: stringValue(file?.webViewLink) ??
+                        `https://docs.google.com/presentation/d/${encodeURIComponent(id)}/edit`,
+                    ...(stringValue(file?.modifiedTime)
+                        ? { sourceModifiedAt: stringValue(file?.modifiedTime) }
+                        : {}),
+                    ...(stringValue(file?.driveId)
+                        ? { containerRef: `shared-drive:${stringValue(file?.driveId)}` }
+                        : {}),
+                    metadata: {
+                        recommendationOnly: true,
+                        shared: file?.shared === true,
+                        ownedByMe: file?.ownedByMe === true,
+                        ...(Array.isArray(file?.parents) ? { parents: file.parents } : {}),
+                    },
+                },
+            ];
+        });
+        return recommendationResult(recommendations.slice(0, limit));
+    }
+    const connectionId = await connectorConnectionId("figma", config, context.resolveConnection);
+    const projectIds = new Set();
+    if (input.figmaProjectId?.trim())
+        projectIds.add(input.figmaProjectId.trim());
+    if (input.figmaTeamId?.trim()) {
+        const projects = asRecord(await executeConnectorProviderRequest(context.providerApi, {
+            provider: "figma",
+            method: "GET",
+            path: `/teams/${encodeURIComponent(input.figmaTeamId.trim())}/projects`,
+            connectionId,
+        }));
+        for (const value of Array.isArray(projects?.projects)
+            ? projects.projects
+            : []) {
+            const id = stringValue(asRecord(value)?.id);
+            if (id)
+                projectIds.add(id);
+        }
+    }
+    if (projectIds.size === 0) {
+        return {
+            ...recommendationResult([]),
+            unavailableReason: "Figma has no global recent-files API. Choose a team or project before requesting file recommendations.",
+        };
+    }
+    const recommendations = [];
+    for (const projectId of projectIds) {
+        if (recommendations.length >= limit)
+            break;
+        const payload = asRecord(await executeConnectorProviderRequest(context.providerApi, {
+            provider: "figma",
+            method: "GET",
+            path: `/projects/${encodeURIComponent(projectId)}/files`,
+            connectionId,
+        }));
+        for (const value of Array.isArray(payload?.files) ? payload.files : []) {
+            const file = asRecord(value);
+            const key = stringValue(file?.key);
+            if (!key)
+                continue;
+            recommendations.push({
+                externalId: key,
+                provider: "figma",
+                kind: "file",
+                title: stringValue(file?.name) ?? key,
+                canonicalUrl: `https://www.figma.com/design/${encodeURIComponent(key)}`,
+                ...(stringValue(file?.last_modified)
+                    ? { sourceModifiedAt: stringValue(file?.last_modified) }
+                    : {}),
+                containerRef: `project:${projectId}`,
+                metadata: { recommendationOnly: true, projectId },
+            });
+            if (recommendations.length >= limit)
+                break;
+        }
+    }
+    recommendations.sort((left, right) => timestamp(right.sourceModifiedAt) - timestamp(left.sourceModifiedAt));
+    return recommendationResult(recommendations.slice(0, limit));
+}
+function recommendationResult(recommendations) {
+    return {
+        recommendations,
+        persisted: false,
+        requiresExplicitBoundary: true,
+    };
+}
+function notionRecommendationTitle(page) {
+    const properties = asRecord(page.properties);
+    for (const value of Object.values(properties ?? {})) {
+        const property = asRecord(value);
+        if (!Array.isArray(property?.title))
+            continue;
+        const title = property.title
+            .map((entry) => stringValue(asRecord(entry)?.plain_text) ?? "")
+            .join("")
+            .trim();
+        if (title)
+            return title;
+    }
+    return undefined;
+}
+function timestamp(value) {
+    const parsed = value ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/connectors/recommendations.js.map

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

package/dist/connectors/registry.d.ts

@@ -0,0 +1,10 @@
+import type { ContextImportConnector, ContextImportConnectorSummary } from "./types.js";
+export declare class ContextImportConnectorRegistry {
+    #private;
+    constructor(connectors?: readonly ContextImportConnector[]);
+    register(connector: ContextImportConnector): this;
+    get(kind: string): ContextImportConnector;
+    has(kind: string): boolean;
+    list(): ContextImportConnectorSummary[];
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAE9B,MAAM,YAAY,CAAC;AAEpB,qBAAa,8BAA8B;;IAMzC,YAAY,UAAU,GAAE,SAAS,sBAAsB,EAAO,EAE7D;IAED,QAAQ,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAQhD;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAMxC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,IAAI,IAAI,6BAA6B,EAAE,CAQtC;CACF"}

package/dist/connectors/registry.js

@@ -0,0 +1,34 @@
+export class ContextImportConnectorRegistry {
+    #connectors = new Map();
+    constructor(connectors = []) {
+        for (const connector of connectors)
+            this.register(connector);
+    }
+    register(connector) {
+        if (this.#connectors.has(connector.kind)) {
+            throw new Error(`Context connector ${connector.kind} is already registered.`);
+        }
+        this.#connectors.set(connector.kind, connector);
+        return this;
+    }
+    get(kind) {
+        const connector = this.#connectors.get(kind);
+        if (!connector) {
+            throw new Error(`Unknown context connector ${kind}.`);
+        }
+        return connector;
+    }
+    has(kind) {
+        return this.#connectors.has(kind);
+    }
+    list() {
+        return [...this.#connectors.values()]
+            .map((connector) => ({
+            kind: connector.kind,
+            label: connector.label,
+            supportsIncremental: connector.supportsIncremental,
+        }))
+            .sort((a, b) => a.label.localeCompare(b.label));
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/connectors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,8BAA8B;IAChC,WAAW,GAAG,IAAI,GAAG,EAG3B,CAAC;IAEJ,YAAY,UAAU,GAAsC,EAAE;QAC5D,KAAK,MAAM,SAAS,IAAI,UAAU;YAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,SAAiC;QACxC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,qBAAqB,SAAS,CAAC,IAAI,yBAAyB,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAA4B,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAA4B,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;aAClC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACnB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,mBAAmB,EAAE,SAAS,CAAC,mBAAmB;SACnD,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/connectors/rendered-page.d.ts

@@ -0,0 +1,101 @@
+import { ssrfSafeFetch } from "@agent-native/core/extensions/url-safety";
+import { type WebsiteExtraction } from "@agent-native/core/ingestion";
+export type RenderedPageMethod = "builder-browser" | "local-playwright" | "attached-chrome" | "static-html";
+export interface RenderedPageRequest {
+    url: string;
+    timeoutMs?: number;
+    waitUntil?: "load" | "domcontentloaded" | "networkidle";
+    preferHosted?: boolean;
+}
+export interface RenderedPageResult {
+    url: string;
+    finalUrl: string;
+    title: string;
+    text: string;
+    method: RenderedPageMethod;
+    rendered: boolean;
+    warnings: string[];
+    extraction: WebsiteExtraction;
+    screenshots: Array<{
+        viewport: "desktop" | "mobile";
+        width: number;
+        height: number;
+        data: Uint8Array;
+    }>;
+    confidence: number;
+    classification: "homepage" | "marketing" | "documentation" | "content" | "unknown";
+    diagnostics: string[];
+    metadata: Record<string, unknown>;
+}
+export interface RenderedPageProvider {
+    render(request: RenderedPageRequest): Promise<RenderedPageResult>;
+}
+interface PlaywrightRequestLike {
+    url(): string;
+    isNavigationRequest(): boolean;
+    resourceType(): string;
+}
+interface PlaywrightRouteLike {
+    request(): PlaywrightRequestLike;
+    continue(): Promise<void>;
+    abort(errorCode?: string): Promise<void>;
+}
+interface PlaywrightPageLike {
+    route(pattern: string, handler: (route: PlaywrightRouteLike) => Promise<void>): Promise<void>;
+    goto(url: string, options: {
+        timeout: number;
+        waitUntil: string;
+    }): Promise<unknown>;
+    title(): Promise<string>;
+    url(): string;
+    locator(selector: string): {
+        innerText(): Promise<string>;
+    };
+    setViewportSize(size: {
+        width: number;
+        height: number;
+    }): Promise<void>;
+    screenshot(options: {
+        type: "png";
+        fullPage: boolean;
+    }): Promise<Uint8Array>;
+    evaluate<T>(callback: () => T): Promise<T>;
+}
+interface PlaywrightContextLike {
+    pages(): PlaywrightPageLike[];
+    newPage(): Promise<PlaywrightPageLike>;
+}
+interface PlaywrightBrowserLike {
+    contexts(): PlaywrightContextLike[];
+    newContext(): Promise<PlaywrightContextLike>;
+    close(): Promise<void>;
+}
+interface PlaywrightLike {
+    chromium: {
+        connectOverCDP(endpoint: string): Promise<PlaywrightBrowserLike>;
+        launch(options: {
+            headless: boolean;
+        }): Promise<PlaywrightBrowserLike>;
+    };
+}
+export interface LayeredRenderedPageProviderOptions {
+    requestBuilderBrowserConnection?: (input: {
+        sessionId: string;
+    }) => Promise<Record<string, unknown>>;
+    loadPlaywright?: () => Promise<PlaywrightLike | null>;
+    requestAttachedBrowserConnection?: (input: {
+        sessionId: string;
+        url: string;
+    }) => Promise<{
+        wsUrl: string;
+    }>;
+    staticFetch?: typeof ssrfSafeFetch;
+}
+export declare class LayeredRenderedPageProvider implements RenderedPageProvider {
+    #private;
+    constructor(options?: LayeredRenderedPageProviderOptions);
+    render(request: RenderedPageRequest): Promise<RenderedPageResult>;
+}
+export declare function boundWebsiteExtraction(extraction: WebsiteExtraction): WebsiteExtraction;
+export {};
+//# sourceMappingURL=rendered-page.d.ts.map

package/dist/connectors/rendered-page.d.ts.map

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