@agent-native/core 0.103.0 → 0.104.0

package/corpus/templates/slides/server/handlers/import/pptx-parser.ts

@@ -1,421 +1,7 @@
-import { XMLParser } from "fast-xml-parser";
-import JSZip from "jszip";
-
-export interface ParsedTextRun {
-  content: string;
-  bold?: boolean;
-  italic?: boolean;
-  fontSize?: number;
-  color?: string;
-}
-
-export interface ParsedImage {
-  data: Buffer;
-  mimeType: string;
-  name: string;
-}
-
-export interface ParsedSlide {
-  texts: ParsedTextRun[];
-  images: ParsedImage[];
-  notes?: string;
-  layoutHint?: string;
-}
-
-export interface ParsedPresentation {
-  title: string;
-  slides: ParsedSlide[];
-  theme?: { colors: string[]; fonts: string[] };
-}
-
-const parser = new XMLParser({
-  ignoreAttributes: false,
-  attributeNamePrefix: "@_",
-});
-
-/** Normalise a value into an array (handles XML single-child vs multi-child). */
-function asArray<T>(val: T | T[] | undefined | null): T[] {
-  if (val == null) return [];
-  return Array.isArray(val) ? val : [val];
-}
-
-/** Recursively collect all `a:t` text nodes from a tree. */
-function collectTexts(
-  node: unknown,
-  runs: ParsedTextRun[],
-  inheritedProps?: {
-    bold?: boolean;
-    italic?: boolean;
-    fontSize?: number;
-    color?: string;
-  },
-): void {
-  if (node == null || typeof node !== "object") return;
-
-  const obj = node as Record<string, unknown>;
-
-  // a:r — a text run with optional formatting in a:rPr
-  if (obj["a:r"] != null) {
-    for (const run of asArray(obj["a:r"])) {
-      const rObj = run as Record<string, unknown>;
-      const rPr = rObj["a:rPr"] as Record<string, unknown> | undefined;
-      const text = extractInnerText(rObj["a:t"]);
-      if (!text) continue;
-
-      const props = parseRunProps(rPr, inheritedProps);
-      runs.push({ content: text, ...props });
-    }
-  }
-
-  // a:t directly (e.g. inside a:fld)
-  if (obj["a:t"] != null && obj["a:r"] == null) {
-    const text = extractInnerText(obj["a:t"]);
-    if (text) {
-      runs.push({ content: text, ...inheritedProps });
-    }
-  }
-
-  // Recurse into child elements (skip keys we already handled to avoid
-  // double-counting text runs that were extracted from a:r above)
-  for (const key of Object.keys(obj)) {
-    if (key.startsWith("@_")) continue;
-    if (key === "a:r" || key === "a:t") continue;
-    const child = obj[key];
-    if (child != null && typeof child === "object") {
-      if (Array.isArray(child)) {
-        for (const item of child) {
-          collectTexts(item, runs, inheritedProps);
-        }
-      } else {
-        collectTexts(child, runs, inheritedProps);
-      }
-    }
-  }
-}
-
-function extractInnerText(val: unknown): string {
-  if (val == null) return "";
-  if (typeof val === "string") return val;
-  if (typeof val === "number") return String(val);
-  if (typeof val === "object" && val !== null) {
-    const obj = val as Record<string, unknown>;
-    // fast-xml-parser may wrap text in #text when attributes are present
-    if (obj["#text"] != null) return String(obj["#text"]);
-  }
-  return String(val);
-}
-
-function parseRunProps(
-  rPr: Record<string, unknown> | undefined,
-  inherited?: {
-    bold?: boolean;
-    italic?: boolean;
-    fontSize?: number;
-    color?: string;
-  },
-): { bold?: boolean; italic?: boolean; fontSize?: number; color?: string } {
-  const props: {
-    bold?: boolean;
-    italic?: boolean;
-    fontSize?: number;
-    color?: string;
-  } = {
-    ...inherited,
-  };
-  if (!rPr) return props;
-
-  if (rPr["@_b"] === "1" || rPr["@_b"] === 1 || rPr["@_b"] === true) {
-    props.bold = true;
-  }
-  if (rPr["@_i"] === "1" || rPr["@_i"] === 1 || rPr["@_i"] === true) {
-    props.italic = true;
-  }
-  // Font size in hundredths of a point — convert to pt
-  if (rPr["@_sz"] != null) {
-    const sz = Number(rPr["@_sz"]);
-    if (!isNaN(sz) && sz > 0) {
-      props.fontSize = sz / 100;
-    }
-  }
-  // Solid fill color
-  const solidFill = rPr["a:solidFill"] as Record<string, unknown> | undefined;
-  if (solidFill) {
-    const srgbClr = solidFill["a:srgbClr"] as
-      | Record<string, unknown>
-      | undefined;
-    if (srgbClr?.["@_val"]) {
-      props.color = `#${srgbClr["@_val"]}`;
-    }
-  }
-  return props;
-}
-
-/** Extract all text runs from a slide XML object. */
-function extractSlideTexts(slideObj: Record<string, unknown>): ParsedTextRun[] {
-  const runs: ParsedTextRun[] = [];
-  collectTexts(slideObj, runs);
-  return runs;
-}
-
-/** Parse relationship file to get rId -> target mappings. */
-function parseRels(
-  relsXml: string,
-): Map<string, { target: string; type: string }> {
-  const parsed = parser.parse(relsXml);
-  const map = new Map<string, { target: string; type: string }>();
-  const rels = parsed?.Relationships?.Relationship;
-  for (const rel of asArray(rels)) {
-    const r = rel as Record<string, unknown>;
-    if (r["@_Id"] && r["@_Target"]) {
-      map.set(String(r["@_Id"]), {
-        target: String(r["@_Target"]),
-        type: String(r["@_Type"] ?? ""),
-      });
-    }
-  }
-  return map;
-}
-
-/** Determine the MIME type from a file extension. */
-function mimeFromExt(name: string): string {
-  const ext = name.split(".").pop()?.toLowerCase() ?? "";
-  const map: Record<string, string> = {
-    png: "image/png",
-    jpg: "image/jpeg",
-    jpeg: "image/jpeg",
-    gif: "image/gif",
-    svg: "image/svg+xml",
-    webp: "image/webp",
-    bmp: "image/bmp",
-    tiff: "image/tiff",
-    tif: "image/tiff",
-    emf: "image/emf",
-    wmf: "image/wmf",
-  };
-  return map[ext] ?? "application/octet-stream";
-}
-
-/** Guess a layout hint from the content. */
-function guessLayoutHint(texts: ParsedTextRun[], hasImages: boolean): string {
-  if (hasImages) return "image";
-
-  // Title slide: typically 1-3 short text runs, largest font
-  const maxFontSize = Math.max(...texts.map((t) => t.fontSize ?? 0), 0);
-  const totalLength = texts.reduce((sum, t) => sum + t.content.length, 0);
-
-  if (texts.length <= 3 && totalLength < 200 && maxFontSize >= 28) {
-    return "title";
-  }
-  if (texts.length <= 2 && totalLength < 100) {
-    return "section";
-  }
-  return "content";
-}
-
-export async function parsePptx(
-  fileBuffer: Buffer,
-): Promise<ParsedPresentation> {
-  const zip = await JSZip.loadAsync(fileBuffer);
-
-  // --- Slide ordering from presentation.xml ---
-  const presentationXml = await zip
-    .file("ppt/presentation.xml")
-    ?.async("string");
-  if (!presentationXml) {
-    throw new Error("Invalid PPTX: missing ppt/presentation.xml");
-  }
-  const presentationObj = parser.parse(presentationXml);
-  const sldIdList =
-    presentationObj?.["p:presentation"]?.["p:sldIdLst"]?.["p:sldId"];
-  const slideRIds = asArray(sldIdList).map((s) =>
-    String((s as Record<string, unknown>)["@_r:id"] ?? ""),
-  );
-
-  // Resolve rIds to slide file paths via presentation.xml.rels
-  const presRelsXml = await zip
-    .file("ppt/_rels/presentation.xml.rels")
-    ?.async("string");
-  const presRels = presRelsXml
-    ? parseRels(presRelsXml)
-    : new Map<string, { target: string; type: string }>();
-
-  const slideFilenames: string[] = [];
-  for (const rId of slideRIds) {
-    const rel = presRels.get(rId);
-    if (rel) {
-      // target is relative to ppt/, e.g. "slides/slide1.xml"
-      const fullPath = rel.target.startsWith("/")
-        ? rel.target.slice(1)
-        : `ppt/${rel.target}`;
-      slideFilenames.push(fullPath);
-    }
-  }
-
-  // Fallback: if rels didn't resolve, discover slide files directly
-  if (slideFilenames.length === 0) {
-    const slideFiles = Object.keys(zip.files)
-      .filter((f) => /^ppt\/slides\/slide\d+\.xml$/.test(f))
-      .sort((a, b) => {
-        const na = parseInt(a.match(/slide(\d+)/)?.[1] ?? "0", 10);
-        const nb = parseInt(b.match(/slide(\d+)/)?.[1] ?? "0", 10);
-        return na - nb;
-      });
-    slideFilenames.push(...slideFiles);
-  }
-
-  // --- Theme extraction ---
-  let theme: { colors: string[]; fonts: string[] } | undefined;
-  const themeXml = await zip.file("ppt/theme/theme1.xml")?.async("string");
-  if (themeXml) {
-    const themeObj = parser.parse(themeXml);
-    const colors: string[] = [];
-    const fonts: string[] = [];
-
-    // Extract theme colors from a:clrScheme
-    const clrScheme =
-      themeObj?.["a:theme"]?.["a:themeElements"]?.["a:clrScheme"];
-    if (clrScheme && typeof clrScheme === "object") {
-      for (const key of Object.keys(clrScheme)) {
-        if (key.startsWith("@_")) continue;
-        const colorEl = (clrScheme as Record<string, unknown>)[key] as
-          | Record<string, unknown>
-          | undefined;
-        if (!colorEl) continue;
-        const srgb = colorEl["a:srgbClr"] as
-          | Record<string, unknown>
-          | undefined;
-        const sysClr = colorEl["a:sysClr"] as
-          | Record<string, unknown>
-          | undefined;
-        if (srgb?.["@_val"]) {
-          colors.push(`#${srgb["@_val"]}`);
-        } else if (sysClr?.["@_lastClr"]) {
-          colors.push(`#${sysClr["@_lastClr"]}`);
-        }
-      }
-    }
-
-    // Extract fonts
-    const fontScheme =
-      themeObj?.["a:theme"]?.["a:themeElements"]?.["a:fontScheme"];
-    if (fontScheme) {
-      const majorFont = (fontScheme as Record<string, unknown>)[
-        "a:majorFont"
-      ] as Record<string, unknown> | undefined;
-      const minorFont = (fontScheme as Record<string, unknown>)[
-        "a:minorFont"
-      ] as Record<string, unknown> | undefined;
-      const latin1 = majorFont?.["a:latin"] as
-        | Record<string, unknown>
-        | undefined;
-      const latin2 = minorFont?.["a:latin"] as
-        | Record<string, unknown>
-        | undefined;
-      if (latin1?.["@_typeface"]) fonts.push(String(latin1["@_typeface"]));
-      if (latin2?.["@_typeface"]) fonts.push(String(latin2["@_typeface"]));
-    }
-
-    if (colors.length > 0 || fonts.length > 0) {
-      theme = { colors, fonts };
-    }
-  }
-
-  // --- Parse each slide ---
-  const parsedSlides: ParsedSlide[] = [];
-
-  for (const slidePath of slideFilenames) {
-    const slideXml = await zip.file(slidePath)?.async("string");
-    if (!slideXml) continue;
-
-    let slideObj: Record<string, unknown>;
-    try {
-      slideObj = parser.parse(slideXml);
-    } catch {
-      // Skip slides with malformed XML rather than crashing the whole import
-      continue;
-    }
-    const texts = extractSlideTexts(slideObj);
-
-    // Extract images via slide rels
-    const images: ParsedImage[] = [];
-    const slideBasename = slidePath.split("/").pop() ?? "";
-    const relsPath = slidePath.replace(
-      /slides\/(slide\d+\.xml)/,
-      "slides/_rels/$1.rels",
-    );
-    const slideRelsXml = await zip.file(relsPath)?.async("string");
-    if (slideRelsXml) {
-      const slideRels = parseRels(slideRelsXml);
-      for (const [, rel] of slideRels) {
-        if (
-          rel.type.includes("/image") ||
-          /\.(png|jpe?g|gif|svg|webp|bmp|tiff?|emf|wmf)$/i.test(rel.target)
-        ) {
-          // Resolve relative target to full zip path
-          const imgPath = rel.target.startsWith("/")
-            ? rel.target.slice(1)
-            : rel.target.startsWith("../")
-              ? `ppt/${rel.target.replace(/^\.\.\//, "")}`
-              : `ppt/slides/${rel.target}`;
-
-          const imgFile = zip.file(imgPath);
-          if (imgFile) {
-            const imgData = await imgFile.async("nodebuffer");
-            const imgName = imgPath.split("/").pop() ?? "image";
-            images.push({
-              data: imgData,
-              mimeType: mimeFromExt(imgName),
-              name: imgName,
-            });
-          }
-        }
-      }
-    }
-
-    // Extract speaker notes
-    let notes: string | undefined;
-    const slideNum = slideBasename.match(/slide(\d+)/)?.[1];
-    if (slideNum) {
-      const notesPath = `ppt/notesSlides/notesSlide${slideNum}.xml`;
-      const notesXml = await zip.file(notesPath)?.async("string");
-      if (notesXml) {
-        const notesObj = parser.parse(notesXml);
-        const noteRuns: ParsedTextRun[] = [];
-        collectTexts(notesObj, noteRuns);
-        const noteText = noteRuns
-          .map((r) => r.content)
-          .join(" ")
-          .trim();
-        // Filter out placeholder patterns like slide number references
-        if (noteText && noteText.length > 1) {
-          notes = noteText;
-        }
-      }
-    }
-
-    const layoutHint = guessLayoutHint(texts, images.length > 0);
-
-    parsedSlides.push({
-      texts,
-      images,
-      notes,
-      layoutHint,
-    });
-  }
-
-  // Derive title from the first slide's largest text
-  let title = "Imported Presentation";
-  if (parsedSlides.length > 0 && parsedSlides[0].texts.length > 0) {
-    // Pick the text run with the largest font, or the first one
-    const firstSlideTexts = parsedSlides[0].texts;
-    const sorted = [...firstSlideTexts].sort(
-      (a, b) => (b.fontSize ?? 0) - (a.fontSize ?? 0),
-    );
-    const candidate = sorted[0]?.content?.trim();
-    if (candidate && candidate.length > 0 && candidate.length < 200) {
-      title = candidate;
-    }
-  }
-
-  return { title, slides: parsedSlides, theme };
-}
+export {
+  parsePptxPresentation as parsePptx,
+  type ParsedPptxImage as ParsedImage,
+  type ParsedPptxPresentation as ParsedPresentation,
+  type ParsedPptxSlide as ParsedSlide,
+  type ParsedPptxTextRun as ParsedTextRun,
+} from "@agent-native/core/ingestion";

package/corpus/templates/slides/server/plugins/creative-context.ts

@@ -0,0 +1,166 @@
+import { registerOnboardingStep } from "@agent-native/core/onboarding";
+import {
+  getRequestOrgId,
+  getRequestUserEmail,
+} from "@agent-native/core/server/request-context";
+import {
+  setupCreativeContext,
+  type CreativeContextProjectionAdapters,
+} from "@agent-native/creative-context/server";
+import { listContextSources } from "@agent-native/creative-context/store";
+import { desc, eq } from "drizzle-orm";
+import { nanoid } from "nanoid";
+
+import { getDb, schema } from "../db/index.js";
+
+type ProjectedLayoutTemplate = {
+  id: string;
+  type: "layout-template";
+  name: string;
+  sourceType: "brand-import";
+  htmlSnapshot: string | null;
+  creativeContext: {
+    suggestionId: string;
+    itemId: string;
+    itemVersionId: string;
+    projectionItemId: string;
+  };
+};
+
+function parseAssets(value: string | null): unknown[] {
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+
+function isProjectedLayout(value: unknown): value is ProjectedLayoutTemplate {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const candidate = value as Partial<ProjectedLayoutTemplate>;
+  return (
+    candidate.type === "layout-template" &&
+    candidate.sourceType === "brand-import" &&
+    typeof candidate.creativeContext?.projectionItemId === "string"
+  );
+}
+
+async function ownedDesignSystems() {
+  const ownerEmail = getRequestUserEmail();
+  if (!ownerEmail) throw new Error("no authenticated user");
+  return getDb()
+    .select()
+    .from(schema.designSystems)
+    .where(eq(schema.designSystems.ownerEmail, ownerEmail))
+    .orderBy(
+      desc(schema.designSystems.isDefault),
+      desc(schema.designSystems.updatedAt),
+    );
+}
+
+async function ensureLayoutTarget() {
+  const existing = await ownedDesignSystems();
+  if (existing[0]) return existing[0];
+  const ownerEmail = getRequestUserEmail();
+  if (!ownerEmail) throw new Error("no authenticated user");
+  const now = new Date().toISOString();
+  const row = {
+    id: nanoid(),
+    title: "Creative context layouts",
+    description: "Approved reusable layouts promoted from Creative Context.",
+    data: "{}",
+    assets: "[]",
+    customInstructions:
+      "Prefer approved Creative Context layout templates unchanged before adapting or generating a new layout.",
+    isDefault: true,
+    ownerEmail,
+    orgId: getRequestOrgId(),
+    createdAt: now,
+    updatedAt: now,
+  };
+  await getDb().insert(schema.designSystems).values(row);
+  return row;
+}
+
+const projections: CreativeContextProjectionAdapters = {
+  layoutTemplate: {
+    promote: async (input) => {
+      const designSystem = await ensureLayoutTarget();
+      const assets = parseAssets(designSystem.assets).filter(
+        (asset) =>
+          !isProjectedLayout(asset) ||
+          asset.creativeContext.projectionItemId !== input.projectionItemId,
+      );
+      const projection: ProjectedLayoutTemplate = {
+        id: `creative-context-layout:${input.projectionItemId}`,
+        type: "layout-template",
+        name: `Approved layout ${assets.filter(isProjectedLayout).length + 1}`,
+        sourceType: "brand-import",
+        htmlSnapshot: input.htmlSnapshot,
+        creativeContext: {
+          suggestionId: input.suggestionId,
+          itemId: input.itemId,
+          itemVersionId: input.itemVersionId,
+          projectionItemId: input.projectionItemId,
+        },
+      };
+      await getDb()
+        .update(schema.designSystems)
+        .set({
+          assets: JSON.stringify([...assets, projection]),
+          updatedAt: new Date().toISOString(),
+        })
+        .where(eq(schema.designSystems.id, designSystem.id));
+    },
+    demote: async ({ projectionItemId }) => {
+      if (!projectionItemId) return;
+      const designSystems = await ownedDesignSystems();
+      for (const designSystem of designSystems) {
+        const assets = parseAssets(designSystem.assets);
+        const filtered = assets.filter(
+          (asset) =>
+            !isProjectedLayout(asset) ||
+            asset.creativeContext.projectionItemId !== projectionItemId,
+        );
+        if (filtered.length === assets.length) continue;
+        await getDb()
+          .update(schema.designSystems)
+          .set({
+            assets: JSON.stringify(filtered),
+            updatedAt: new Date().toISOString(),
+          })
+          .where(eq(schema.designSystems.id, designSystem.id));
+      }
+    },
+  },
+};
+
+registerOnboardingStep({
+  id: "creative-context-library",
+  order: 18,
+  required: false,
+  title: "Connect your creative library",
+  description:
+    "Connect prior work and reference sources so agents can reuse approved creative context.",
+  methods: [
+    {
+      id: "library",
+      kind: "link",
+      primary: true,
+      label: "Open Library",
+      payload: { url: "/agent#library", external: false },
+    },
+  ],
+  isComplete: async () => {
+    try {
+      const result = await listContextSources({ limit: 1 });
+      return result.sources.length > 0;
+    } catch {
+      return false;
+    }
+  },
+});
+
+export default setupCreativeContext({ appId: "slides", projections });

package/dist/agent/engine/credential-errors.d.ts

@@ -1,5 +1,5 @@
 export declare const LLM_MISSING_CREDENTIALS_ERROR_CODE = "missing_credentials";
-export declare const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Agent settings > LLM, then connect Builder.io or add a provider key.";
+export declare const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Agent workspace > LLM, then connect Builder.io or add a provider key.";
 export declare function isLlmCredentialError(error: unknown, errorCode?: string | null): boolean;
 export declare function formatLlmCredentialErrorMessage(options?: {
     agentName?: string;

package/dist/agent/engine/credential-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credential-errors.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/credential-errors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AAExE,eAAO,MAAM,+BAA+B,uHAC0E,CAAC;AAevH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAiBT;AAED,wBAAgB,+BAA+B,CAAC,OAAO,CAAC,EAAE;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAMT;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,MAAM,GAAG,IAAI,CAIf"}
+{"version":3,"file":"credential-errors.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/credential-errors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AAExE,eAAO,MAAM,+BAA+B,wHAC2E,CAAC;AAexH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAiBT;AAED,wBAAgB,+BAA+B,CAAC,OAAO,CAAC,EAAE;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAMT;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,MAAM,GAAG,IAAI,CAIf"}

package/dist/agent/engine/credential-errors.js

@@ -1,6 +1,6 @@
 import { PROVIDER_ENV_VARS } from "./provider-env-vars.js";
 export const LLM_MISSING_CREDENTIALS_ERROR_CODE = "missing_credentials";
-export const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Agent settings > LLM, then connect Builder.io or add a provider key.";
+export const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Agent workspace > LLM, then connect Builder.io or add a provider key.";
 const LLM_CREDENTIAL_KEYS = new Set([
     ...PROVIDER_ENV_VARS,
     "BUILDER_PRIVATE_KEY",
@@ -30,7 +30,7 @@ export function isLlmCredentialError(error, errorCode) {
 export function formatLlmCredentialErrorMessage(options) {
     const agentName = options?.agentName?.trim();
     if (agentName) {
-        return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent settings > LLM, then connect Builder.io or add a provider key.`;
+        return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent workspace > LLM, then connect Builder.io or add a provider key.`;
     }
     return LLM_MISSING_CREDENTIALS_MESSAGE;
 }

package/dist/agent/engine/credential-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"credential-errors.js","sourceRoot":"","sources":["../../../src/agent/engine/credential-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,qBAAqB,CAAC;AAExE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,oHAAoH,CAAC;AAEvH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,GAAG,iBAAiB;IACpB,qBAAqB;IACrB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG;IAClC,kGAAkG;IAClG,kGAAkG;IAClG,8FAA8F;IAC9F,8FAA8F;CAC/F,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,SAAyB;IAEzB,MAAM,IAAI,GACR,SAAS;QACT,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,WAAW,IAAI,KAAK;YACzD,CAAC,CAAC,MAAM,CAAE,KAAiC,CAAC,SAAS,IAAI,EAAE,CAAC;YAC5D,CAAC,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,IAAI,KAAK,kCAAkC;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,0BAA0B,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACvE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CACtB,CAAC;IACF,IAAI,0BAA0B;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,OAE/C;IACC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,OAAO,SAAS,uFAAuF,SAAS,yEAAyE,CAAC;IACnM,CAAC;IACD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,OAAgC;IAEhC,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,+BAA+B,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAE,KAA+B,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import { PROVIDER_ENV_VARS } from \"./provider-env-vars.js\";\n\nexport const LLM_MISSING_CREDENTIALS_ERROR_CODE = \"missing_credentials\";\n\nexport const LLM_MISSING_CREDENTIALS_MESSAGE =\n  \"No LLM provider is connected. Open this app's Agent settings > LLM, then connect Builder.io or add a provider key.\";\n\nconst LLM_CREDENTIAL_KEYS = new Set([\n  ...PROVIDER_ENV_VARS,\n  \"BUILDER_PRIVATE_KEY\",\n  \"BUILDER_PUBLIC_KEY\",\n]);\n\nconst MISSING_CREDENTIAL_PATTERNS = [\n  /\\b(?:llm|model provider|ai engine)\\b.*\\b(?:missing|not set|not configured|required|connected)\\b/i,\n  /\\b(?:missing|not set|not configured|required|connected)\\b.*\\b(?:llm|model provider|ai engine)\\b/i,\n  /\\b(?:llm|model provider|ai engine)\\b.*\\b(?:api\\s*key|credential|credentials|provider key)\\b/i,\n  /\\b(?:api\\s*key|credential|credentials|provider key)\\b.*\\b(?:llm|model provider|ai engine)\\b/i,\n];\n\nexport function isLlmCredentialError(\n  error: unknown,\n  errorCode?: string | null,\n): boolean {\n  const code =\n    errorCode ??\n    (typeof error === \"object\" && error && \"errorCode\" in error\n      ? String((error as { errorCode?: unknown }).errorCode ?? \"\")\n      : \"\");\n  if (code === LLM_MISSING_CREDENTIALS_ERROR_CODE) return true;\n\n  const message = getErrorMessage(error);\n  if (!message) return false;\n\n  const mentionsKnownLlmCredential = [...LLM_CREDENTIAL_KEYS].some((key) =>\n    message.includes(key),\n  );\n  if (mentionsKnownLlmCredential) return true;\n\n  return MISSING_CREDENTIAL_PATTERNS.some((pattern) => pattern.test(message));\n}\n\nexport function formatLlmCredentialErrorMessage(options?: {\n  agentName?: string;\n}): string {\n  const agentName = options?.agentName?.trim();\n  if (agentName) {\n    return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent settings > LLM, then connect Builder.io or add a provider key.`;\n  }\n  return LLM_MISSING_CREDENTIALS_MESSAGE;\n}\n\nexport function userFacingLlmCredentialError(\n  error: unknown,\n  options?: { agentName?: string },\n): string | null {\n  return isLlmCredentialError(error)\n    ? formatLlmCredentialErrorMessage(options)\n    : null;\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (typeof error === \"string\") return error;\n  if (error instanceof Error) return error.message;\n  if (typeof error === \"object\" && error && \"message\" in error) {\n    return String((error as { message?: unknown }).message ?? \"\");\n  }\n  return \"\";\n}\n"]}
+{"version":3,"file":"credential-errors.js","sourceRoot":"","sources":["../../../src/agent/engine/credential-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,qBAAqB,CAAC;AAExE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,qHAAqH,CAAC;AAExH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,GAAG,iBAAiB;IACpB,qBAAqB;IACrB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG;IAClC,kGAAkG;IAClG,kGAAkG;IAClG,8FAA8F;IAC9F,8FAA8F;CAC/F,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,SAAyB;IAEzB,MAAM,IAAI,GACR,SAAS;QACT,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,WAAW,IAAI,KAAK;YACzD,CAAC,CAAC,MAAM,CAAE,KAAiC,CAAC,SAAS,IAAI,EAAE,CAAC;YAC5D,CAAC,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,IAAI,KAAK,kCAAkC;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,0BAA0B,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACvE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CACtB,CAAC;IACF,IAAI,0BAA0B;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,OAE/C;IACC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,OAAO,SAAS,uFAAuF,SAAS,0EAA0E,CAAC;IACpM,CAAC;IACD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,OAAgC;IAEhC,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,+BAA+B,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAE,KAA+B,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import { PROVIDER_ENV_VARS } from \"./provider-env-vars.js\";\n\nexport const LLM_MISSING_CREDENTIALS_ERROR_CODE = \"missing_credentials\";\n\nexport const LLM_MISSING_CREDENTIALS_MESSAGE =\n  \"No LLM provider is connected. Open this app's Agent workspace > LLM, then connect Builder.io or add a provider key.\";\n\nconst LLM_CREDENTIAL_KEYS = new Set([\n  ...PROVIDER_ENV_VARS,\n  \"BUILDER_PRIVATE_KEY\",\n  \"BUILDER_PUBLIC_KEY\",\n]);\n\nconst MISSING_CREDENTIAL_PATTERNS = [\n  /\\b(?:llm|model provider|ai engine)\\b.*\\b(?:missing|not set|not configured|required|connected)\\b/i,\n  /\\b(?:missing|not set|not configured|required|connected)\\b.*\\b(?:llm|model provider|ai engine)\\b/i,\n  /\\b(?:llm|model provider|ai engine)\\b.*\\b(?:api\\s*key|credential|credentials|provider key)\\b/i,\n  /\\b(?:api\\s*key|credential|credentials|provider key)\\b.*\\b(?:llm|model provider|ai engine)\\b/i,\n];\n\nexport function isLlmCredentialError(\n  error: unknown,\n  errorCode?: string | null,\n): boolean {\n  const code =\n    errorCode ??\n    (typeof error === \"object\" && error && \"errorCode\" in error\n      ? String((error as { errorCode?: unknown }).errorCode ?? \"\")\n      : \"\");\n  if (code === LLM_MISSING_CREDENTIALS_ERROR_CODE) return true;\n\n  const message = getErrorMessage(error);\n  if (!message) return false;\n\n  const mentionsKnownLlmCredential = [...LLM_CREDENTIAL_KEYS].some((key) =>\n    message.includes(key),\n  );\n  if (mentionsKnownLlmCredential) return true;\n\n  return MISSING_CREDENTIAL_PATTERNS.some((pattern) => pattern.test(message));\n}\n\nexport function formatLlmCredentialErrorMessage(options?: {\n  agentName?: string;\n}): string {\n  const agentName = options?.agentName?.trim();\n  if (agentName) {\n    return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent workspace > LLM, then connect Builder.io or add a provider key.`;\n  }\n  return LLM_MISSING_CREDENTIALS_MESSAGE;\n}\n\nexport function userFacingLlmCredentialError(\n  error: unknown,\n  options?: { agentName?: string },\n): string | null {\n  return isLlmCredentialError(error)\n    ? formatLlmCredentialErrorMessage(options)\n    : null;\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (typeof error === \"string\") return error;\n  if (error instanceof Error) return error.message;\n  if (typeof error === \"object\" && error && \"message\" in error) {\n    return String((error as { message?: unknown }).message ?? \"\");\n  }\n  return \"\";\n}\n"]}