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

package/dist/server/context.d.ts.map

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

package/dist/server/context.js

@@ -0,0 +1,63 @@
+import { createGetDb, getDbExec, isPostgres } from "@agent-native/core/db";
+import { createDefaultContextConnectorExecutionContext, createDefaultContextImportConnectorRegistry, } from "../connectors/index.js";
+import * as defaultSchema from "../schema/index.js";
+import { deletePgVectors, queryPgVectorIndex, upsertPgVector, } from "../vector/pgvector.js";
+const defaultGetDb = createGetDb(defaultSchema);
+const CONTEXT_KEY = Symbol.for("@agent-native/creative-context.context");
+function defaultVectorAdapter() {
+    if (!isPostgres())
+        return undefined;
+    return {
+        async upsert(input) {
+            const vectorKey = input.embeddingId;
+            await upsertPgVector(getDbExec(), {
+                vectorKey,
+                embeddingSetId: input.embeddingSetId,
+                dimensions: input.vector.length,
+                vector: input.vector,
+            });
+            return { vectorKey };
+        },
+        async search(input) {
+            const hits = await queryPgVectorIndex(getDbExec(), {
+                embeddingSetId: input.embeddingSetId,
+                dimensions: input.vector.length,
+                vector: input.vector,
+                limit: input.limit,
+                allowedVectorKeys: input.allowedVectorKeys,
+            });
+            return hits.map((hit) => ({
+                embeddingId: hit.vectorKey,
+                score: hit.score,
+            }));
+        },
+        async delete(input) {
+            await deletePgVectors(getDbExec(), {
+                dimensions: input.dimensions,
+                vectorKeys: [input.vectorKey],
+            });
+        },
+    };
+}
+export function configureCreativeContext(context = {}) {
+    const appId = context.connectorContext?.appId ?? "creative-context";
+    const configured = {
+        getDb: context.getDb ?? defaultGetDb,
+        schema: context.schema ?? defaultSchema,
+        vectorAdapter: context.vectorAdapter ?? defaultVectorAdapter(),
+        connectors: context.connectors ?? createDefaultContextImportConnectorRegistry(),
+        connectorContext: {
+            ...createDefaultContextConnectorExecutionContext({ appId }),
+            ...context.connectorContext,
+            appId,
+        },
+        projections: context.projections,
+        enrichment: context.enrichment,
+    };
+    globalThis[CONTEXT_KEY] = configured;
+    return configured;
+}
+export function getCreativeContext() {
+    return (globalThis[CONTEXT_KEY] ?? configureCreativeContext());
+}
+//# sourceMappingURL=context.js.map

package/dist/server/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/server/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EACL,6CAA6C,EAC7C,2CAA2C,GAC5C,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AAMpD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,uBAAuB,CAAC;AA2E/B,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAMzE,SAAS,oBAAoB;IAC3B,IAAI,CAAC,UAAU,EAAE;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;YACpC,MAAM,cAAc,CAAC,SAAS,EAAE,EAAE;gBAChC,SAAS;gBACT,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YACH,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,EAAE;gBACjD,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;aAC3C,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,WAAW,EAAE,GAAG,CAAC,SAAS;gBAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,eAAe,CAAC,SAAS,EAAE,EAAE;gBACjC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAO,GAA0C,EAAE;IAEnD,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,kBAAkB,CAAC;IACpE,MAAM,UAAU,GAAiC;QAC/C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,aAAa;QACvC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,oBAAoB,EAAE;QAC9D,UAAU,EACR,OAAO,CAAC,UAAU,IAAI,2CAA2C,EAAE;QACrE,gBAAgB,EAAE;YAChB,GAAG,6CAA6C,CAAC,EAAE,KAAK,EAAE,CAAC;YAC3D,GAAG,OAAO,CAAC,gBAAgB;YAC3B,KAAK;SACN;QACD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IACD,UAA4B,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC;IACxD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CACJ,UAA4B,CAAC,WAAW,CAAC,IAAI,wBAAwB,EAAE,CACzE,CAAC;AACJ,CAAC"}

package/dist/server/enrichment.d.ts

@@ -0,0 +1,24 @@
+export declare function projectCreativeContextMedia(mediaId: string): Promise<{
+    mediaId: string;
+    projected: false;
+} | {
+    mediaId: string;
+    projected: true;
+}>;
+export declare function enrichCreativeContextMedia(input: {
+    mediaId: string;
+    paletteLimit?: number;
+}): Promise<{
+    mediaId: string;
+    itemId: string;
+    itemVersionId: string;
+    versionAppended: boolean;
+    palette: string[] | never[];
+    caption: string | null;
+    ocrText: string | null;
+    contentHash: string;
+    embeddingId: string | null;
+    embeddingFamily: string | null;
+    embeddingSkippedReason: string | null;
+}>;
+//# sourceMappingURL=enrichment.d.ts.map

package/dist/server/enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../src/server/enrichment.ts"],"names":[],"mappings":"AAkBA,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,MAAM;;;;;;GA2BhE;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;;GAmHA"}

package/dist/server/enrichment.js

@@ -0,0 +1,138 @@
+import { randomUUID } from "node:crypto";
+import { extractDominantColors, fingerprintMedia, } from "@agent-native/core/ingestion";
+import { eq } from "drizzle-orm";
+import { availableEmbeddingFamilies } from "../embeddings/providers.js";
+import { appendMediaEnrichmentVersion, getActiveEmbeddingSet, getCreativeContextItem, recordEmbeddingMetadata, } from "../store/index.js";
+import { getCreativeContext } from "./context.js";
+import { readCreativeContextMedia } from "./media.js";
+export async function projectCreativeContextMedia(mediaId) {
+    const { getDb, schema, projections } = getCreativeContext();
+    if (!projections?.media)
+        return { mediaId, projected: false };
+    const rows = await getDb()
+        .select({
+        itemId: schema.contextMedia.itemId,
+        itemVersionId: schema.contextMedia.itemVersionId,
+    })
+        .from(schema.contextMedia)
+        .where(eq(schema.contextMedia.id, mediaId))
+        .limit(1);
+    const row = rows[0];
+    if (!row)
+        throw new Error("Creative context media was not found.");
+    const detail = await getCreativeContextItem(row.itemId, row.itemVersionId);
+    const media = detail?.media.find((entry) => entry.id === mediaId);
+    if (!detail || !media) {
+        throw new Error("Creative context media is not accessible.");
+    }
+    await projections.media.project({
+        sourceId: detail.item.sourceId,
+        itemId: detail.item.id,
+        itemVersionId: detail.version.id,
+        media,
+        sourceType: "brand-import",
+        dedupeKey: `${media.id}:${detail.version.id}`,
+    });
+    return { mediaId, projected: true };
+}
+export async function enrichCreativeContextMedia(input) {
+    const loaded = await readCreativeContextMedia({ mediaId: input.mediaId });
+    if (loaded.mimeType !== "image/png" &&
+        loaded.mimeType !== "image/jpeg" &&
+        loaded.mimeType !== "image/webp" &&
+        loaded.mimeType !== "image/gif") {
+        throw new Error("Creative context media enrichment supports PNG, JPEG, WebP, or GIF images.");
+    }
+    const { vectorAdapter, enrichment } = getCreativeContext();
+    const fingerprint = fingerprintMedia(loaded.data, loaded.mimeType);
+    const palette = await extractDominantColors(loaded.data, input.paletteLimit ?? 6).catch(() => []);
+    const [caption, ocrText] = await Promise.all([
+        enrichment?.captionImage?.({
+            data: loaded.data,
+            mimeType: loaded.mimeType,
+            itemId: loaded.itemId,
+            itemVersionId: loaded.itemVersionId,
+            mediaId: input.mediaId,
+        }) ?? Promise.resolve(null),
+        enrichment?.ocrImage?.({
+            data: loaded.data,
+            mimeType: loaded.mimeType,
+            itemId: loaded.itemId,
+            itemVersionId: loaded.itemVersionId,
+            mediaId: input.mediaId,
+        }) ?? Promise.resolve(null),
+    ]);
+    const nextCaption = caption ?? loaded.media?.caption ?? null;
+    const nextCaptionStatus = enrichment?.captionImage
+        ? caption
+            ? "complete"
+            : "failed"
+        : "pending";
+    const nextOcrText = ocrText ?? loaded.media?.ocrText ?? null;
+    const snapshot = await appendMediaEnrichmentVersion({
+        mediaId: input.mediaId,
+        palette,
+        contentHash: fingerprint.sha256,
+        caption: nextCaption,
+        captionStatus: nextCaptionStatus,
+        ocrText: nextOcrText,
+    });
+    const families = await availableEmbeddingFamilies();
+    const set = await getActiveEmbeddingSet();
+    const family = set
+        ? (families.find((candidate) => candidate.id === set.family &&
+            candidate.model === set.model &&
+            candidate.version === set.version) ?? null)
+        : null;
+    let embeddingId = null;
+    const imageMimeSupported = !family?.supportedImageMimeTypes ||
+        family.supportedImageMimeTypes.includes(loaded.mimeType);
+    if (set && family && vectorAdapter && imageMimeSupported) {
+        const [vector] = await family.embed([
+            {
+                text: [caption, ocrText].filter(Boolean).join("\n") || undefined,
+                images: [
+                    {
+                        mimeType: loaded.mimeType,
+                        base64: Buffer.from(loaded.data).toString("base64"),
+                    },
+                ],
+            },
+        ], "document");
+        if (vector) {
+            embeddingId = `ccem_${randomUUID()}`;
+            const stored = await vectorAdapter.upsert({
+                embeddingId,
+                embeddingSetId: set.id,
+                vector,
+            });
+            await recordEmbeddingMetadata({
+                embeddingSetId: set.id,
+                itemId: snapshot.itemId,
+                itemVersionId: snapshot.itemVersionId,
+                targetType: "media",
+                targetId: snapshot.mediaId,
+                vectorKey: stored.vectorKey,
+                dimensions: vector.length,
+                checksum: fingerprint.sha256,
+            });
+        }
+    }
+    await projectCreativeContextMedia(snapshot.mediaId);
+    return {
+        mediaId: snapshot.mediaId,
+        itemId: snapshot.itemId,
+        itemVersionId: snapshot.itemVersionId,
+        versionAppended: snapshot.appended,
+        palette,
+        caption: nextCaption,
+        ocrText: nextOcrText,
+        contentHash: fingerprint.sha256,
+        embeddingId,
+        embeddingFamily: family?.id ?? null,
+        embeddingSkippedReason: set && family && !imageMimeSupported
+            ? `Active embedding family ${family.id} does not accept ${loaded.mimeType}.`
+            : null,
+    };
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/server/enrichment.js.map

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

package/dist/server/generation-artifact-access.d.ts

@@ -0,0 +1,21 @@
+export interface GenerationArtifactIdentity {
+    appId: string;
+    artifactType: string;
+    artifactId: string;
+}
+export interface GenerationArtifactAccessTarget {
+    resourceType: string;
+    resourceId: string;
+}
+declare const proofBrand: unique symbol;
+export interface GenerationArtifactAccessProof {
+    readonly identityKey: string;
+    readonly minRole: "viewer" | "editor";
+    readonly [proofBrand]: true;
+}
+export declare function assertGenerationArtifactAccess(identity: GenerationArtifactIdentity, target: GenerationArtifactAccessTarget, minRole: "viewer" | "editor"): Promise<GenerationArtifactAccessProof>;
+export declare function assertGenerationArtifactAccessProof(identity: GenerationArtifactIdentity, proof: GenerationArtifactAccessProof, minRole: "viewer" | "editor"): void;
+export declare function createGenerationArtifactAccessCapability(identity: GenerationArtifactIdentity, target: GenerationArtifactAccessTarget, operation: "read" | "record"): Promise<string>;
+export declare function verifyGenerationArtifactAccessCapability(token: string, identity: GenerationArtifactIdentity, operation: "read" | "record"): Promise<GenerationArtifactAccessProof>;
+export {};
+//# sourceMappingURL=generation-artifact-access.d.ts.map

package/dist/server/generation-artifact-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-artifact-access.d.ts","sourceRoot":"","sources":["../../src/server/generation-artifact-access.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,QAAA,MAAM,UAAU,eAAwD,CAAC;AAEzE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CAC7B;AAgBD,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,8BAA8B,EACtC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAC3B,OAAO,CAAC,6BAA6B,CAAC,CAWxC;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAC3B,IAAI,CAUN;AAED,wBAAsB,wCAAwC,CAC5D,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,8BAA8B,EACtC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAC3B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,wCAAwC,CAC5D,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,0BAA0B,EACpC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAC3B,OAAO,CAAC,6BAA6B,CAAC,CAgCxC"}

package/dist/server/generation-artifact-access.js

@@ -0,0 +1,113 @@
+import { getRequestOrgId, getRequestUserEmail, } from "@agent-native/core/server/request-context";
+import { assertAccess } from "@agent-native/core/sharing";
+const proofBrand = Symbol("creative-context-generation-artifact-access");
+const CAPABILITY_LIFETIME_MS = 60_000;
+export async function assertGenerationArtifactAccess(identity, target, minRole) {
+    await assertAccess(target.resourceType, target.resourceId, minRole, undefined, {
+        skipResourceBody: true,
+    });
+    return createProof(identity, minRole);
+}
+export function assertGenerationArtifactAccessProof(identity, proof, minRole) {
+    if (proof?.[proofBrand] !== true ||
+        proof.identityKey !== generationIdentityKey(identity) ||
+        (minRole === "editor" && proof.minRole !== "editor")) {
+        throw new Error("Generation artifact access must be verified by the host application");
+    }
+}
+export async function createGenerationArtifactAccessCapability(identity, target, operation) {
+    const minRole = operation === "record" ? "editor" : "viewer";
+    await assertGenerationArtifactAccess(identity, target, minRole);
+    const actor = requireCapabilityActor();
+    const claims = {
+        version: 1,
+        operation,
+        identityKey: generationIdentityKey(identity),
+        minRole,
+        resourceType: target.resourceType,
+        resourceId: target.resourceId,
+        userEmail: actor.userEmail,
+        orgId: actor.orgId,
+        expiresAt: Date.now() + CAPABILITY_LIFETIME_MS,
+    };
+    const encoded = Buffer.from(JSON.stringify(claims), "utf8").toString("base64url");
+    const signature = await signCapability(encoded);
+    return `${encoded}.${signature}`;
+}
+export async function verifyGenerationArtifactAccessCapability(token, identity, operation) {
+    const [encoded, signature, extra] = token.split(".");
+    if (!encoded || !signature || extra) {
+        throw new Error("Invalid generation artifact access capability");
+    }
+    const valid = await verifyCapabilitySignature(encoded, signature);
+    if (!valid)
+        throw new Error("Invalid generation artifact access capability");
+    let claims;
+    try {
+        claims = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
+    }
+    catch {
+        throw new Error("Invalid generation artifact access capability");
+    }
+    const actor = requireCapabilityActor();
+    const expectedRole = operation === "record" ? "editor" : "viewer";
+    if (claims.version !== 1 ||
+        claims.operation !== operation ||
+        claims.identityKey !== generationIdentityKey(identity) ||
+        claims.minRole !== expectedRole ||
+        claims.userEmail !== actor.userEmail ||
+        claims.orgId !== actor.orgId ||
+        !Number.isSafeInteger(claims.expiresAt) ||
+        claims.expiresAt < Date.now() ||
+        claims.expiresAt > Date.now() + CAPABILITY_LIFETIME_MS) {
+        throw new Error("Invalid generation artifact access capability");
+    }
+    return createProof(identity, expectedRole);
+}
+function createProof(identity, minRole) {
+    return Object.freeze({
+        identityKey: generationIdentityKey(identity),
+        minRole,
+        [proofBrand]: true,
+    });
+}
+function generationIdentityKey(identity) {
+    return JSON.stringify([
+        identity.appId,
+        identity.artifactType,
+        identity.artifactId,
+    ]);
+}
+function requireCapabilityActor() {
+    const userEmail = getRequestUserEmail()?.trim().toLowerCase();
+    if (!userEmail)
+        throw new Error("Not authenticated");
+    return { userEmail, orgId: getRequestOrgId() ?? null };
+}
+function capabilitySecret() {
+    const secret = process.env.CREATIVE_CONTEXT_A2A_KEY?.trim() ||
+        process.env.A2A_SECRET?.trim();
+    if (!secret) {
+        throw new Error("Generation artifact access capabilities require CREATIVE_CONTEXT_A2A_KEY or A2A_SECRET");
+    }
+    return secret;
+}
+async function signCapability(encoded) {
+    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(capabilitySecret()), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(encoded));
+    return Buffer.from(signature).toString("base64url");
+}
+async function verifyCapabilitySignature(encoded, signature) {
+    let bytes;
+    try {
+        bytes = Buffer.from(signature, "base64url");
+        if (Buffer.from(bytes).toString("base64url") !== signature)
+            return false;
+    }
+    catch {
+        return false;
+    }
+    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(capabilitySecret()), { name: "HMAC", hash: "SHA-256" }, false, ["verify"]);
+    return crypto.subtle.verify("HMAC", key, bytes, new TextEncoder().encode(encoded));
+}
+//# sourceMappingURL=generation-artifact-access.js.map

package/dist/server/generation-artifact-access.js.map

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

package/dist/server/generation-context.d.ts

@@ -0,0 +1,220 @@
+import type { CreativeContextElementProvenance, CreativeContextReuseLabel, CreativeContextSummary } from "../types.js";
+import { type GenerationArtifactAccessTarget } from "./generation-artifact-access.js";
+import { type IsolatedRecordPayload } from "./isolated-a2a.js";
+export type CreativeGenerationRole = "slides" | "design" | "assets" | "content" | "analytics";
+export type CreativeContextModeOverride = "off";
+export declare function selectSemanticSpecialty(contexts: readonly CreativeContextSummary[], query: string): CreativeContextSummary | null;
+export declare function mergeCreativeContextReuseLabels(previous: readonly CreativeContextReuseLabel[], next: readonly CreativeContextReuseLabel[]): CreativeContextReuseLabel[];
+export declare function replaceCreativeContextElementProvenance(previous: readonly CreativeContextElementProvenance[], next: readonly CreativeContextElementProvenance[]): CreativeContextElementProvenance[];
+export interface ResolveGenerationCreativeContextInput {
+    query?: string;
+    role: CreativeGenerationRole;
+    limit?: number;
+    contextPackId?: string;
+    contextPackSource?: "explicit" | "inherited";
+    /** Forwarded by isolated callers; local callers normally use app state. */
+    selectedContextId?: string | null;
+    contextModeOverride?: CreativeContextModeOverride;
+}
+export declare function validateCreativeContextReuseLabels(labels: CreativeContextReuseLabel[], options?: {
+    allowedEvidence?: ReadonlySet<string>;
+    generatedOnly?: boolean;
+}): CreativeContextReuseLabel[];
+export declare function resolveGenerationCreativeContext(input: ResolveGenerationCreativeContextInput): Promise<{
+    contextMode: "auto" | "off" | "pinned";
+    contextPackId: string | null;
+    reuseLabels: {
+        itemId?: string | undefined;
+        itemVersionId?: string | undefined;
+        kind: string;
+        label: string;
+        dataRole: "untrusted-reference";
+        elementId?: string | undefined;
+        influence?: "adapted" | "generated" | "reference-conditioned" | "reused" | undefined;
+    }[];
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        title: string;
+        excerpt: string;
+        dataRole: "untrusted-reference";
+    }[];
+} | {
+    contextMode: "auto";
+    contextPackId: string;
+    reuseLabels: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        label: string;
+        dataRole: "untrusted-reference";
+    }[];
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        chunkId: string | null;
+        sourceId: string;
+        sourceName: string;
+        kind: string;
+        canonicalUrl: string | null;
+        mimeType: string | null;
+        nativeArtifact: {
+            app: string;
+            format: string;
+        } | null;
+        chunkOrdinal: number;
+        tags: string[];
+        colors: string[];
+        updatedAt: string;
+        curationRank: import("../types.js").ContextItemSummary["curationRank"];
+        starred: boolean;
+        externalId: string;
+        indexState: import("../types.js").ContextItemSummary["indexState"];
+        inventoryOnly: boolean;
+        priorReuseCount: number;
+        helpfulFeedbackCount: number;
+        body: undefined;
+        summary: undefined;
+        dataRole: "untrusted-reference";
+        title: string;
+        excerpt: string;
+        score: number;
+        reasons: string[];
+        laneRanks: Record<string, number>;
+        laneScores: Record<string, number>;
+        pendingJobId: string | null;
+    }[];
+}>;
+export declare function resolveGenerationCreativeContextLocal(input: ResolveGenerationCreativeContextInput): Promise<{
+    contextMode: "pinned";
+    contextPackId: string;
+    reuseLabels: CreativeContextReuseLabel[];
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        title: string;
+        excerpt: string;
+        dataRole: "untrusted-reference";
+    }[];
+} | {
+    contextMode: "off";
+    contextPackId: null;
+    reuseLabels: never[];
+    results: never[];
+} | {
+    contextMode: "auto";
+    contextPackId: null;
+    reuseLabels: never[];
+    results: never[];
+} | {
+    contextMode: "auto";
+    contextPackId: string;
+    reuseLabels: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        label: string;
+        dataRole: "untrusted-reference";
+    }[];
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        chunkId: string | null;
+        sourceId: string;
+        sourceName: string;
+        kind: string;
+        canonicalUrl: string | null;
+        mimeType: string | null;
+        nativeArtifact: {
+            app: string;
+            format: string;
+        } | null;
+        chunkOrdinal: number;
+        tags: string[];
+        colors: string[];
+        updatedAt: string;
+        curationRank: import("../types.js").ContextItemSummary["curationRank"];
+        starred: boolean;
+        externalId: string;
+        indexState: import("../types.js").ContextItemSummary["indexState"];
+        inventoryOnly: boolean;
+        priorReuseCount: number;
+        helpfulFeedbackCount: number;
+        body: undefined;
+        summary: undefined;
+        dataRole: "untrusted-reference";
+        title: string;
+        excerpt: string;
+        score: number;
+        reasons: string[];
+        laneRanks: Record<string, number>;
+        laneScores: Record<string, number>;
+        pendingJobId: string | null;
+    }[];
+}>;
+export interface ValidateGenerationCreativeContextInput {
+    contextPackId?: string | null;
+    contextPackSource?: "explicit" | "inherited";
+    reuseLabels?: CreativeContextReuseLabel[];
+    reuseLabelsSource?: "explicit" | "inherited";
+    contextModeOverride?: CreativeContextModeOverride;
+}
+export declare function validateGenerationCreativeContext(input: ValidateGenerationCreativeContextInput): Promise<{
+    contextMode: "auto" | "off" | "pinned";
+    contextPackId: string | null;
+    reuseLabels: {
+        itemId?: string | undefined;
+        itemVersionId?: string | undefined;
+        kind: string;
+        label: string;
+        dataRole: "untrusted-reference";
+        elementId?: string | undefined;
+        influence?: "adapted" | "generated" | "reference-conditioned" | "reused" | undefined;
+    }[];
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        title: string;
+        excerpt: string;
+        dataRole: "untrusted-reference";
+    }[];
+}>;
+export declare function validateGenerationCreativeContextLocal(input: ValidateGenerationCreativeContextInput): Promise<{
+    contextMode: "off";
+    contextPackId: null;
+    reuseLabels: CreativeContextReuseLabel[];
+    results: never[];
+} | {
+    contextMode: "pinned";
+    contextPackId: string;
+    results: {
+        itemId: string;
+        itemVersionId: string;
+        kind: string;
+        title: string;
+        excerpt: string;
+        dataRole: "untrusted-reference";
+    }[];
+    reuseLabels: CreativeContextReuseLabel[];
+} | {
+    contextMode: "auto";
+    contextPackId: null;
+    reuseLabels: CreativeContextReuseLabel[];
+    results: never[];
+}>;
+export declare function recordGenerationCreativeContext(input: IsolatedRecordPayload, options?: {
+    db?: any;
+    artifactAccess?: GenerationArtifactAccessTarget;
+}): Promise<import("../types.js").CreativeContextGenerationRecord>;
+export declare function getGenerationCreativeContext(input: {
+    appId: string;
+    artifactType: string;
+    artifactId: string;
+}, options?: {
+    artifactAccess?: GenerationArtifactAccessTarget;
+    db?: any;
+}): Promise<import("../types.js").CreativeContextGenerationRecord | null>;
+//# sourceMappingURL=generation-context.d.ts.map

package/dist/server/generation-context.d.ts.map

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