@frankieai/core 0.2.6 → 0.2.7

package/dist/index.d.cts

@@ -309,6 +309,8 @@ declare const personaProfileSchema: z.ZodObject<{
     publishableKey: z.ZodString;
     pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
     allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+    scope: z.ZodOptional<z.ZodString>;
+    contactUrl: z.ZodOptional<z.ZodString>;
     branding: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         tagline: z.ZodOptional<z.ZodString>;
@@ -583,6 +585,8 @@ declare const frankieConfigSchema: z.ZodObject<{
         publishableKey: z.ZodString;
         pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
         allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+        scope: z.ZodOptional<z.ZodString>;
+        contactUrl: z.ZodOptional<z.ZodString>;
         branding: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             tagline: z.ZodOptional<z.ZodString>;
@@ -681,6 +685,13 @@ declare function defineFrankieConfig(config: FrankieConfigInput): FrankieConfigI
  * key returns null.
  */
 declare function resolvePersonaConfig(config: FrankieConfig, publishableKey: string): FrankieConfig | null;
+/**
+ * A persona's instructions as the agent runs them: its role instructions,
+ * then what it helps with and the boundary that follows from it. Off-topic
+ * questions get a short "not here" (and a hand-off when the agent escalates)
+ * rather than a guess.
+ */
+declare function personaInstructions(persona: PersonaProfile): string;
 /**
  * Whether a Next.js `usePathname()` value matches an App-Router path glob:
  * `**` matches any depth (including `/`), `*` matches within one segment, and a
@@ -1212,4 +1223,4 @@ declare function normalizeColor(raw: string): string | undefined;
  */
 declare function inferTheme(files: Record<string, string>, root?: string): InferredTheme | undefined;
 
-export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InferredTheme, type InstallPlan, type InstallProject, type KnowledgeBaseConfig, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PersonaProfile, type PublicFeatures, type PublicWidgetConfig, SKILL_TOOL_NAME, STANDARD_AGENT_IDS, STARTER_PROMPT_ICONS, type StarterPrompt, type StarterPromptIcon, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, inferTheme, insertImport, installAgentIds, installBranch, installTitle, knowledgeBaseSchema, knowledgeSourceSchema, limitsConfigSchema, matchPath, matchesAnyPagePattern, matchesInstallBranch, matchesPagePattern, mcpServerSchema, modelChoiceSchema, modelConfigSchema, moduleImporter, mountWidget, normalizeColor, operationId, parseFrankieConfig, personaEnvKey, personaProfileSchema, plainText, planHostedInstall, renderJson, resolvePersonaConfig, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema, withDependencies };
+export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InferredTheme, type InstallPlan, type InstallProject, type KnowledgeBaseConfig, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PersonaProfile, type PublicFeatures, type PublicWidgetConfig, SKILL_TOOL_NAME, STANDARD_AGENT_IDS, STARTER_PROMPT_ICONS, type StarterPrompt, type StarterPromptIcon, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, inferTheme, insertImport, installAgentIds, installBranch, installTitle, knowledgeBaseSchema, knowledgeSourceSchema, limitsConfigSchema, matchPath, matchesAnyPagePattern, matchesInstallBranch, matchesPagePattern, mcpServerSchema, modelChoiceSchema, modelConfigSchema, moduleImporter, mountWidget, normalizeColor, operationId, parseFrankieConfig, personaEnvKey, personaInstructions, personaProfileSchema, plainText, planHostedInstall, renderJson, resolvePersonaConfig, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema, withDependencies };

package/dist/index.d.ts

@@ -309,6 +309,8 @@ declare const personaProfileSchema: z.ZodObject<{
     publishableKey: z.ZodString;
     pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
     allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+    scope: z.ZodOptional<z.ZodString>;
+    contactUrl: z.ZodOptional<z.ZodString>;
     branding: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         tagline: z.ZodOptional<z.ZodString>;
@@ -583,6 +585,8 @@ declare const frankieConfigSchema: z.ZodObject<{
         publishableKey: z.ZodString;
         pagePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
         allowAnonymous: z.ZodOptional<z.ZodBoolean>;
+        scope: z.ZodOptional<z.ZodString>;
+        contactUrl: z.ZodOptional<z.ZodString>;
         branding: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             tagline: z.ZodOptional<z.ZodString>;
@@ -681,6 +685,13 @@ declare function defineFrankieConfig(config: FrankieConfigInput): FrankieConfigI
  * key returns null.
  */
 declare function resolvePersonaConfig(config: FrankieConfig, publishableKey: string): FrankieConfig | null;
+/**
+ * A persona's instructions as the agent runs them: its role instructions,
+ * then what it helps with and the boundary that follows from it. Off-topic
+ * questions get a short "not here" (and a hand-off when the agent escalates)
+ * rather than a guess.
+ */
+declare function personaInstructions(persona: PersonaProfile): string;
 /**
  * Whether a Next.js `usePathname()` value matches an App-Router path glob:
  * `**` matches any depth (including `/`), `*` matches within one segment, and a
@@ -1212,4 +1223,4 @@ declare function normalizeColor(raw: string): string | undefined;
  */
 declare function inferTheme(files: Record<string, string>, root?: string): InferredTheme | undefined;
 
-export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InferredTheme, type InstallPlan, type InstallProject, type KnowledgeBaseConfig, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PersonaProfile, type PublicFeatures, type PublicWidgetConfig, SKILL_TOOL_NAME, STANDARD_AGENT_IDS, STARTER_PROMPT_ICONS, type StarterPrompt, type StarterPromptIcon, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, inferTheme, insertImport, installAgentIds, installBranch, installTitle, knowledgeBaseSchema, knowledgeSourceSchema, limitsConfigSchema, matchPath, matchesAnyPagePattern, matchesInstallBranch, matchesPagePattern, mcpServerSchema, modelChoiceSchema, modelConfigSchema, moduleImporter, mountWidget, normalizeColor, operationId, parseFrankieConfig, personaEnvKey, personaProfileSchema, plainText, planHostedInstall, renderJson, resolvePersonaConfig, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema, withDependencies };
+export { type AgentConfig, type ApiCapability, type ApiDocument, type ApiSourceConfig, type ApiToolInventory, type AuthConfig, type AuthStrategy, type BrandingConfig, type ChatAttachment, type ChatRequestBody, type CreateSessionBody, type CreateSessionResponse, FIREWORKS_MODELS, type FeaturesConfig, type FrankieConfig, type FrankieConfigInput, type FrankieErrorCode, type FrankieServerEvent, type HostToolRequest, type HostToolResult, type InferredTheme, type InstallPlan, type InstallProject, type KnowledgeBaseConfig, type LimitsConfig, type LoadedSkill, type McpServerConfig, type ModelChoice, type ModelConfig, type PersonaProfile, type PublicFeatures, type PublicWidgetConfig, SKILL_TOOL_NAME, STANDARD_AGENT_IDS, STARTER_PROMPT_ICONS, type StarterPrompt, type StarterPromptIcon, type StopReason, type ThinkingLevel, type ToolDecision, type ToolPolicy, type ToolResultBody, type UsageSummary, type WidgetTheme, type WidgetThemeConfig, type WorkspaceSkill, activeSkills, agentConfigSchema, apiCapabilitySchema, apiMethods, apiOperations, apiSourceSchema, approvedSkillTools, assertNoCommittedFrankieKeys, authConfigSchema, brandingConfigSchema, canonicalJson, compareApiDocuments, defineFrankieConfig, describeTool, draftSkill, evaluateToolPolicy, featuresConfigSchema, frankieConfigSchema, inferTheme, insertImport, installAgentIds, installBranch, installTitle, knowledgeBaseSchema, knowledgeSourceSchema, limitsConfigSchema, matchPath, matchesAnyPagePattern, matchesInstallBranch, matchesPagePattern, mcpServerSchema, modelChoiceSchema, modelConfigSchema, moduleImporter, mountWidget, normalizeColor, operationId, parseFrankieConfig, personaEnvKey, personaInstructions, personaProfileSchema, plainText, planHostedInstall, renderJson, resolvePersonaConfig, sdkUpdateWorkflow, skillSchema, starterPromptSchema, suggestedPromptsFromSkills, thinkingLevelSchema, toolDescriptions, toolPolicySchema, validateApiDocument, widgetThemeSchema, withDependencies };

package/dist/index.js

@@ -529,6 +529,18 @@ var personaProfileSchema = z2.object({
    * sign in.
    */
   allowAnonymous: z2.boolean().optional(),
+  /**
+   * What this agent helps with, in the team's own words ("pricing, plans,
+   * getting started"). The one thing a team needs to write; the agent's role,
+   * greeting and instructions come from defaults. It is added to the agent's
+   * instructions at runtime (see `personaInstructions`).
+   */
+  scope: z2.string().trim().max(2e3).optional(),
+  /**
+   * Where to send people when the agent can't answer and it doesn't hand the
+   * chat to the team itself: a contact page (https) or an email (mailto:).
+   */
+  contactUrl: z2.string().trim().max(500).regex(/^(?:https:\/\/[^\s]+|mailto:[^\s@]+@[^\s@]+)$/, "Use an https:// link or a mailto: address.").optional(),
   /**
    * Shallow-merged over the workspace branding. Each field is optional with no
    * default, so only the keys the persona sets override the workspace's — an
@@ -595,11 +607,20 @@ function resolvePersonaConfig(config, publishableKey) {
     branding: { ...config.branding, ...persona.branding ?? {} },
     auth: { ...config.auth, publishableKey: persona.publishableKey, allowAnonymous: persona.allowAnonymous ?? config.auth.allowAnonymous },
     pagePatterns: persona.pagePatterns,
-    agent: persona.agent,
+    agent: { ...persona.agent, systemPrompt: personaInstructions(persona) },
     features: persona.features,
     knowledgeBase: persona.knowledgeBase
   });
 }
+function personaInstructions(persona) {
+  const base = persona.agent.systemPrompt.trim();
+  const scope = persona.scope?.trim();
+  const handsOff = persona.features.escalation.enabled;
+  const contact = !handsOff ? persona.contactUrl?.trim() : void 0;
+  const fallback = handsOff ? "" : contact ? `When you can't answer from what you know, or someone asks for a person, say so briefly and point them to ${contact} to reach the team. Never guess.` : "When you can't answer from what you know, say so plainly. Never guess, and never promise that someone will follow up.";
+  const boundary = "Stay within this. If someone asks about something outside it, say briefly that it isn't something you can help with here" + (handsOff ? ", and offer to connect them with the team." : contact ? ", and share the contact link." : ".");
+  return [base, scope ? "What you help with, in the team's own words:\n" + scope + "\n\n" + boundary : "", fallback].filter(Boolean).join("\n\n");
+}
 function normalizeRoutePath(value) {
   let path = (value || "/").split(/[?#]/)[0].trim();
   if (!path.startsWith("/")) path = "/" + path;
@@ -1519,6 +1540,7 @@ function oklchToHex(l, c, hDeg) {
 var NUMBER = String.raw`-?\d*\.?\d+`;
 var parts = (body) => body.replace(/\/.*$/, "").split(/[\s,]+/).filter(Boolean);
 function normalizeColor(raw) {
+  if (raw.length > 200) return void 0;
   const value = raw.trim().replace(/\s*!important$/, "").toLowerCase();
   let match = value.match(/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/);
   if (match) {
@@ -1545,20 +1567,58 @@ function normalizeColor(raw) {
   }
   return void 0;
 }
+function cssBlocks(source) {
+  const blocks = [];
+  let segmentStart = 0;
+  for (let at = 0; at < source.length; ) {
+    const open = source.indexOf("{", at);
+    if (open === -1) break;
+    const nextOpen = source.indexOf("{", open + 1);
+    const close = source.indexOf("}", open + 1);
+    if (close === -1) break;
+    if (nextOpen !== -1 && nextOpen < close) {
+      segmentStart = open + 1;
+      at = open + 1;
+      continue;
+    }
+    blocks.push([source.slice(segmentStart, open), source.slice(open + 1, close)]);
+    segmentStart = close + 1;
+    at = close + 1;
+  }
+  return blocks;
+}
+function customProperty(declaration) {
+  const colon = declaration.indexOf(":");
+  if (colon === -1) return void 0;
+  const name = declaration.slice(0, colon).trim();
+  const value = declaration.slice(colon + 1).trim();
+  return name.length <= 100 && value.length <= 200 && /^--[\w-]+$/.test(name) && value ? [name, value] : void 0;
+}
 function rootVariables(css) {
   const vars = /* @__PURE__ */ new Map();
-  const source = css.replace(/\/\*[\s\S]*?\*\//g, "");
-  const blocks = /([^{}]*)\{([^{}]*)\}/g;
-  for (let block = blocks.exec(source); block; block = blocks.exec(source)) {
-    const selector = block[1].split(";").pop().trim();
+  const source = stripComments(css);
+  for (const [rawSelector, body] of cssBlocks(source)) {
+    const selector = rawSelector.split(";").pop().trim();
+    if (selector.length > 1e3) continue;
     if (!/(?:^|[\s,]):root\b(?![^,]*\.dark)|^@theme\b/.test(selector) || /\.dark|\[data-theme/.test(selector)) continue;
-    for (const declaration of block[2].split(";")) {
-      const found = declaration.match(/^\s*(--[\w-]+)\s*:\s*([\s\S]+?)\s*$/);
-      if (found && !vars.has(found[1])) vars.set(found[1], found[2]);
+    for (const declaration of body.split(";")) {
+      const found = customProperty(declaration);
+      if (found && !vars.has(found[0])) vars.set(found[0], found[1]);
     }
   }
   return vars;
 }
+function stripComments(css) {
+  let out = "";
+  for (let at = 0; ; ) {
+    const start = css.indexOf("/*", at);
+    if (start === -1) return out + css.slice(at);
+    out += css.slice(at, start);
+    const end = css.indexOf("*/", start + 2);
+    if (end === -1) return out;
+    at = end + 2;
+  }
+}
 function resolve(value, vars, depth = 0) {
   if (depth > 4) return void 0;
   const reference = value.match(/^(?:(hsla?|oklch|rgba?)\(\s*)?var\(\s*(--[\w-]+)\s*(?:,[^)]*)?\)\s*\)?$/i);
@@ -1670,6 +1730,7 @@ export {
   operationId,
   parseFrankieConfig,
   personaEnvKey,
+  personaInstructions,
   personaProfileSchema,
   plainText,
   planHostedInstall,