@agent-native/creative-context 0.0.0-beta-20260820202238

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-design.d.ts

@@ -0,0 +1,68 @@
+import type { BrandKitData } from "@agent-native/core/brand-kit";
+import type { WebsiteDesignTokens } from "@agent-native/core/ingestion";
+import { type RenderedPageProvider, type RenderedPageRequest, type RenderedPageResult } from "./rendered-page.js";
+export type RenderedDesignExtractionStatus = "complete" | "partial" | "failed";
+export interface RenderedDesignExtraction {
+    status: RenderedDesignExtractionStatus;
+    url: string;
+    finalUrl?: string;
+    title?: string;
+    rendered: boolean;
+    method?: RenderedPageResult["method"];
+    confidence?: number;
+    designTokens?: WebsiteDesignTokens;
+    designMd?: string;
+    brandKit?: BrandKitData;
+    /** Back-compat projections for callers that consumed the old URL action. */
+    pageTitle?: string;
+    cssCustomProperties?: Record<string, string>;
+    colors?: string[];
+    fonts?: string[];
+    fontFaces?: Array<{
+        family: string;
+        weight?: string;
+    }>;
+    googleFonts?: string[];
+    stylesheetUrls?: string[];
+    assets?: RenderedPageResult["extraction"]["assets"];
+    screenshotEvidence?: Array<{
+        viewport: "desktop" | "mobile";
+        width: number;
+        height: number;
+        bytes: number;
+    }>;
+    warnings: string[];
+    diagnostics: string[];
+    error?: string;
+}
+export interface ExtractRenderedDesignOptions extends Pick<RenderedPageRequest, "timeoutMs" | "preferHosted"> {
+    provider?: RenderedPageProvider;
+}
+/**
+ * Extract a bounded visual language from a public website. Browser rendering
+ * is deliberately delegated to the layered provider so this works with
+ * Builder Browser, local Playwright, an approved attached browser, or the
+ * existing SSRF-safe static fallback without changing app code.
+ */
+export declare function extractRenderedDesignSystemFromUrl(websiteUrl: string, options?: ExtractRenderedDesignOptions): Promise<RenderedDesignExtraction>;
+/** Convert the shared browser result into the Assets style-brief vocabulary. */
+export declare function styleBriefFromRenderedDesign(extraction: RenderedDesignExtraction): Record<string, unknown>;
+export declare function brandKitDataFromExtraction(input: {
+    url: string;
+    finalUrl?: string;
+    title?: string;
+    designTokens: WebsiteDesignTokens;
+    designMd: string;
+    assets?: RenderedPageResult["extraction"]["assets"];
+}): BrandKitData;
+export declare function buildDesignMarkdown(input: {
+    url: string;
+    finalUrl: string;
+    title: string;
+    rendered: boolean;
+    method: RenderedPageResult["method"];
+    confidence: number;
+    designTokens: WebsiteDesignTokens;
+    warnings: string[];
+}): string;
+//# sourceMappingURL=rendered-design.d.ts.map

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

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