@agent-native/core 0.30.6 → 0.31.1

package/dist/agent/tool-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionEntry } from \"./production-agent.js\";\nimport { parseMcpToolName } from \"../mcp-client/manager.js\";\nimport { isMcpToolAllowedForRequest } from \"../mcp-client/visibility.js\";\n\nexport const TOOL_SEARCH_ACTION_NAME = \"tool-search\";\n\ntype ToolSearchArgs = {\n  query?: unknown;\n  limit?: unknown;\n  includeSchemas?: unknown;\n};\n\ntype ToolParameterSummary = {\n  name: string;\n  type?: string;\n  required: boolean;\n  description?: string;\n  enum?: string[];\n};\n\ntype ToolSearchResult = {\n  name: string;\n  kind: \"action\" | \"mcp\";\n  source?: string;\n  description: string;\n  score: number;\n  parameters: ToolParameterSummary[];\n  inputSchema?: unknown;\n};\n\ntype ToolSearchOptions = {\n  defaultLimit?: number;\n  maxLimit?: number;\n};\n\nconst DEFAULT_LIMIT = 8;\nconst MAX_LIMIT = 25;\n\nexport function createToolSearchEntry(\n  getRegistry: () => Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): ActionEntry {\n  return {\n    tool: {\n      description:\n        \"Search the live registry of callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Use this when you need a capability but are not sure which tool to call, especially after users connect new MCP servers. Returns exact tool names and parameter summaries so you can call the matching tool directly.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description:\n              \"What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`.\",\n          },\n          limit: {\n            type: \"number\",\n            description: `Maximum results to return. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}.`,\n          } as any,\n          includeSchemas: {\n            type: \"boolean\",\n            description:\n              \"When true, include each matching tool's full input schema. Default false.\",\n          } as any,\n        },\n        required: [\"query\"],\n      },\n    },\n    http: false,\n    readOnly: true,\n    run: async (args: Record<string, string>) =>\n      searchToolRegistry(getRegistry(), args, options),\n  };\n}\n\nexport function attachToolSearch(\n  registry: Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): Record<string, ActionEntry> {\n  registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(\n    () => registry,\n    options,\n  );\n  return registry;\n}\n\nexport function searchToolRegistry(\n  registry: Record<string, ActionEntry>,\n  args: ToolSearchArgs = {},\n  options: ToolSearchOptions = {},\n): {\n  query: string;\n  totalTools: number;\n  count: number;\n  results: ToolSearchResult[];\n} {\n  const query = String(args.query ?? \"\").trim();\n  const includeSchemas = parseBoolean(args.includeSchemas);\n  const limit = parseLimit(\n    args.limit,\n    options.defaultLimit ?? DEFAULT_LIMIT,\n    options.maxLimit ?? MAX_LIMIT,\n  );\n  const queryTokens = tokenize(query);\n\n  const candidates: ToolSearchResult[] = [];\n  let totalTools = 0;\n\n  for (const [name, entry] of Object.entries(registry)) {\n    if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME) continue;\n    if (name.startsWith(\"mcp__\") && !isMcpToolAllowedForRequest(name)) {\n      continue;\n    }\n\n    totalTools++;\n    const description = normalizeWhitespace(entry.tool.description ?? \"\");\n    const parameters = summarizeParameters(entry.tool.parameters);\n    const parsedMcp = parseMcpToolName(name);\n    const kind = parsedMcp ? \"mcp\" : \"action\";\n    const source = parsedMcp?.serverId;\n    const score = scoreTool({\n      query,\n      queryTokens,\n      name,\n      source,\n      description,\n      parameters,\n      kind,\n    });\n\n    if (queryTokens.length > 0 && score <= 0) continue;\n\n    candidates.push({\n      name,\n      kind,\n      ...(source ? { source } : {}),\n      description,\n      score,\n      parameters,\n      ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),\n    });\n  }\n\n  candidates.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score;\n    return a.name.localeCompare(b.name);\n  });\n\n  return {\n    query,\n    totalTools,\n    count: Math.min(candidates.length, limit),\n    results: candidates.slice(0, limit),\n  };\n}\n\nfunction parseLimit(value: unknown, fallback: number, max: number): number {\n  const n =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim()\n        ? Number(value)\n        : fallback;\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.max(1, Math.min(max, Math.floor(n)));\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value !== \"string\") return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"true\" || normalized === \"1\" || normalized === \"yes\";\n}\n\nfunction summarizeParameters(schema: unknown): ToolParameterSummary[] {\n  if (!schema || typeof schema !== \"object\") return [];\n  const obj = schema as {\n    properties?: Record<string, unknown>;\n    required?: unknown;\n  };\n  const properties = obj.properties;\n  if (!properties || typeof properties !== \"object\") return [];\n  const required = new Set(\n    Array.isArray(obj.required)\n      ? obj.required.filter(\n          (value): value is string => typeof value === \"string\",\n        )\n      : [],\n  );\n\n  return Object.entries(properties).map(([name, raw]) => {\n    const prop =\n      raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n    const enumValues = Array.isArray(prop.enum)\n      ? prop.enum.map((value) => String(value)).slice(0, 20)\n      : undefined;\n    return {\n      name,\n      type: summarizeType(prop.type),\n      required: required.has(name),\n      description:\n        typeof prop.description === \"string\"\n          ? normalizeWhitespace(prop.description)\n          : undefined,\n      ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),\n    };\n  });\n}\n\nfunction summarizeType(value: unknown): string | undefined {\n  if (typeof value === \"string\") return value;\n  if (Array.isArray(value)) {\n    const parts = value.filter((v): v is string => typeof v === \"string\");\n    return parts.length > 0 ? parts.join(\" | \") : undefined;\n  }\n  return undefined;\n}\n\nfunction scoreTool(input: {\n  query: string;\n  queryTokens: string[];\n  name: string;\n  source?: string;\n  description: string;\n  parameters: ToolParameterSummary[];\n  kind: \"action\" | \"mcp\";\n}): number {\n  if (input.queryTokens.length === 0) return 1;\n\n  const name = searchableText(input.name);\n  const source = searchableText(input.source ?? \"\");\n  const description = searchableText(input.description);\n  const params = searchableText(\n    input.parameters\n      .map((p) => `${p.name} ${p.type ?? \"\"} ${p.description ?? \"\"}`)\n      .join(\" \"),\n  );\n  const all = `${name} ${source} ${description} ${params} ${input.kind}`;\n  const phrase = searchableText(input.query);\n\n  let score = 0;\n  if (name.includes(phrase)) score += 14;\n  if (source && source.includes(phrase)) score += 10;\n  if (description.includes(phrase)) score += 8;\n  if (params.includes(phrase)) score += 5;\n\n  for (const token of input.queryTokens) {\n    if (name.split(\" \").includes(token)) score += 9;\n    else if (name.includes(token)) score += 6;\n\n    if (source) {\n      if (source.split(\" \").includes(token)) score += 6;\n      else if (source.includes(token)) score += 3;\n    }\n\n    if (description.includes(token)) score += 3;\n    if (params.includes(token)) score += 2;\n    if (all.includes(token)) score += 1;\n  }\n\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const seen = new Set<string>();\n  for (const token of searchableText(value).split(\" \")) {\n    if (token.length > 0) seen.add(token);\n  }\n  return Array.from(seen);\n}\n\nfunction searchableText(value: string): string {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n"]}
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionEntry } from \"./production-agent.js\";\nimport { parseMcpToolName } from \"../mcp-client/manager.js\";\nimport { isMcpToolAllowedForRequest } from \"../mcp-client/visibility.js\";\n\nexport const TOOL_SEARCH_ACTION_NAME = \"tool-search\";\n\ntype ToolSearchArgs = {\n  query?: unknown;\n  limit?: unknown;\n  includeSchemas?: unknown;\n};\n\ntype ToolParameterSummary = {\n  name: string;\n  type?: string;\n  required: boolean;\n  description?: string;\n  enum?: string[];\n};\n\ntype ToolSearchResult = {\n  name: string;\n  kind: \"action\" | \"mcp\";\n  source?: string;\n  description: string;\n  score: number;\n  parameters: ToolParameterSummary[];\n  inputSchema?: unknown;\n};\n\ntype ToolSearchOptions = {\n  defaultLimit?: number;\n  maxLimit?: number;\n};\n\nconst DEFAULT_LIMIT = 8;\nconst MAX_LIMIT = 25;\n\nexport function createToolSearchEntry(\n  getRegistry: () => Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): ActionEntry {\n  return {\n    tool: {\n      description:\n        \"Search the live registry of callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Use this when you need a capability but are not sure which tool to call, especially after users connect new MCP servers. Returns exact tool names and parameter summaries so you can call the matching tool directly.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description:\n              \"What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`.\",\n          },\n          limit: {\n            type: \"number\",\n            description: `Maximum results to return. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}.`,\n          },\n          includeSchemas: {\n            type: \"boolean\",\n            description:\n              \"When true, include each matching tool's full input schema. Default false.\",\n          },\n        },\n        required: [\"query\"],\n      },\n    },\n    http: false,\n    readOnly: true,\n    run: async (args: Record<string, string>) =>\n      searchToolRegistry(getRegistry(), args, options),\n  };\n}\n\nexport function attachToolSearch(\n  registry: Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): Record<string, ActionEntry> {\n  registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(\n    () => registry,\n    options,\n  );\n  return registry;\n}\n\nexport function searchToolRegistry(\n  registry: Record<string, ActionEntry>,\n  args: ToolSearchArgs = {},\n  options: ToolSearchOptions = {},\n): {\n  query: string;\n  totalTools: number;\n  count: number;\n  results: ToolSearchResult[];\n} {\n  const query = String(args.query ?? \"\").trim();\n  const includeSchemas = parseBoolean(args.includeSchemas);\n  const limit = parseLimit(\n    args.limit,\n    options.defaultLimit ?? DEFAULT_LIMIT,\n    options.maxLimit ?? MAX_LIMIT,\n  );\n  const queryTokens = tokenize(query);\n\n  const candidates: ToolSearchResult[] = [];\n  let totalTools = 0;\n\n  for (const [name, entry] of Object.entries(registry)) {\n    if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME) continue;\n    if (name.startsWith(\"mcp__\") && !isMcpToolAllowedForRequest(name)) {\n      continue;\n    }\n\n    totalTools++;\n    const description = normalizeWhitespace(entry.tool.description ?? \"\");\n    const parameters = summarizeParameters(entry.tool.parameters);\n    const parsedMcp = parseMcpToolName(name);\n    const kind = parsedMcp ? \"mcp\" : \"action\";\n    const source = parsedMcp?.serverId;\n    const score = scoreTool({\n      query,\n      queryTokens,\n      name,\n      source,\n      description,\n      parameters,\n      kind,\n    });\n\n    if (queryTokens.length > 0 && score <= 0) continue;\n\n    candidates.push({\n      name,\n      kind,\n      ...(source ? { source } : {}),\n      description,\n      score,\n      parameters,\n      ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),\n    });\n  }\n\n  candidates.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score;\n    return a.name.localeCompare(b.name);\n  });\n\n  return {\n    query,\n    totalTools,\n    count: Math.min(candidates.length, limit),\n    results: candidates.slice(0, limit),\n  };\n}\n\nfunction parseLimit(value: unknown, fallback: number, max: number): number {\n  const n =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim()\n        ? Number(value)\n        : fallback;\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.max(1, Math.min(max, Math.floor(n)));\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value !== \"string\") return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"true\" || normalized === \"1\" || normalized === \"yes\";\n}\n\nfunction summarizeParameters(schema: unknown): ToolParameterSummary[] {\n  if (!schema || typeof schema !== \"object\") return [];\n  const obj = schema as {\n    properties?: Record<string, unknown>;\n    required?: unknown;\n  };\n  const properties = obj.properties;\n  if (!properties || typeof properties !== \"object\") return [];\n  const required = new Set(\n    Array.isArray(obj.required)\n      ? obj.required.filter(\n          (value): value is string => typeof value === \"string\",\n        )\n      : [],\n  );\n\n  return Object.entries(properties).map(([name, raw]) => {\n    const prop =\n      raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n    const enumValues = Array.isArray(prop.enum)\n      ? prop.enum.map((value) => String(value)).slice(0, 20)\n      : undefined;\n    return {\n      name,\n      type: summarizeType(prop.type),\n      required: required.has(name),\n      description:\n        typeof prop.description === \"string\"\n          ? normalizeWhitespace(prop.description)\n          : undefined,\n      ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),\n    };\n  });\n}\n\nfunction summarizeType(value: unknown): string | undefined {\n  if (typeof value === \"string\") return value;\n  if (Array.isArray(value)) {\n    const parts = value.filter((v): v is string => typeof v === \"string\");\n    return parts.length > 0 ? parts.join(\" | \") : undefined;\n  }\n  return undefined;\n}\n\nfunction scoreTool(input: {\n  query: string;\n  queryTokens: string[];\n  name: string;\n  source?: string;\n  description: string;\n  parameters: ToolParameterSummary[];\n  kind: \"action\" | \"mcp\";\n}): number {\n  if (input.queryTokens.length === 0) return 1;\n\n  const name = searchableText(input.name);\n  const source = searchableText(input.source ?? \"\");\n  const description = searchableText(input.description);\n  const params = searchableText(\n    input.parameters\n      .map((p) => `${p.name} ${p.type ?? \"\"} ${p.description ?? \"\"}`)\n      .join(\" \"),\n  );\n  const all = `${name} ${source} ${description} ${params} ${input.kind}`;\n  const phrase = searchableText(input.query);\n\n  let score = 0;\n  if (name.includes(phrase)) score += 14;\n  if (source && source.includes(phrase)) score += 10;\n  if (description.includes(phrase)) score += 8;\n  if (params.includes(phrase)) score += 5;\n\n  for (const token of input.queryTokens) {\n    if (name.split(\" \").includes(token)) score += 9;\n    else if (name.includes(token)) score += 6;\n\n    if (source) {\n      if (source.split(\" \").includes(token)) score += 6;\n      else if (source.includes(token)) score += 3;\n    }\n\n    if (description.includes(token)) score += 3;\n    if (params.includes(token)) score += 2;\n    if (all.includes(token)) score += 1;\n  }\n\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const seen = new Set<string>();\n  for (const token of searchableText(value).split(\" \")) {\n    if (token.length > 0) seen.add(token);\n  }\n  return Array.from(seen);\n}\n\nfunction searchableText(value: string): string {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n"]}

package/dist/application-state/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/application-state/store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAsB9D,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAgBzC;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC,CAWjE;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/application-state/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAkC9D,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAgBzC;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC,CAWjE;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/application-state/store.js

@@ -1,6 +1,13 @@
 import { getDbExec, isConnectionError, isPostgres, intType, } from "../db/client.js";
 import { emitAppStateChange, emitAppStateDelete } from "./emitter.js";
 let _initPromise;
+// Escapes LIKE wildcards (`%`, `_`) and the escape char itself so a caller's
+// literal prefix is matched verbatim. Used with `ESCAPE '\'` in prefix queries
+// below; without this, a prefix such as `user_settings` would treat `_` as a
+// single-char wildcard and over-match (e.g. delete `userXsettings`).
+function escapeLike(s) {
+    return s.replace(/([\\%_])/g, "\\$1");
+}
 async function ensureTable() {
     if (!_initPromise) {
         _initPromise = (async () => {
@@ -14,7 +21,11 @@ async function ensureTable() {
           PRIMARY KEY (session_id, key)
         )
       `);
-        })();
+        })().catch((err) => {
+            // Retry init on the next call after a failed startup.
+            _initPromise = undefined;
+            throw err;
+        });
     }
     return _initPromise;
 }
@@ -65,8 +76,8 @@ export async function appStateList(sessionId, keyPrefix) {
     await ensureTable();
     const client = getDbExec();
     const { rows } = await client.execute({
-        sql: `SELECT key, value FROM application_state WHERE session_id = ? AND key LIKE ?`,
-        args: [sessionId, keyPrefix + "%"],
+        sql: `SELECT key, value FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\'`,
+        args: [sessionId, escapeLike(keyPrefix) + "%"],
     });
     return rows.map((row) => ({
         key: row.key,
@@ -78,14 +89,14 @@ export async function appStateDeleteByPrefix(sessionId, keyPrefix, options) {
     const client = getDbExec();
     // Get keys first so we can emit events
     const { rows } = await client.execute({
-        sql: `SELECT key FROM application_state WHERE session_id = ? AND key LIKE ?`,
-        args: [sessionId, keyPrefix + "%"],
+        sql: `SELECT key FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\'`,
+        args: [sessionId, escapeLike(keyPrefix) + "%"],
     });
     if (rows.length === 0)
         return 0;
     const result = await client.execute({
-        sql: `DELETE FROM application_state WHERE session_id = ? AND key LIKE ?`,
-        args: [sessionId, keyPrefix + "%"],
+        sql: `DELETE FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\'`,
+        args: [sessionId, escapeLike(keyPrefix) + "%"],
     });
     for (const row of rows) {
         emitAppStateDelete(row.key, options?.requestSource, sessionId);

package/dist/application-state/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/application-state/store.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getDbExec,\n  isConnectionError,\n  isPostgres,\n  intType,\n  type DbExec,\n} from \"../db/client.js\";\nimport { emitAppStateChange, emitAppStateDelete } from \"./emitter.js\";\nimport type { StoreWriteOptions } from \"../settings/store.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\nasync function ensureTable(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS application_state (\n          session_id TEXT NOT NULL,\n          key TEXT NOT NULL,\n          value TEXT NOT NULL,\n          updated_at ${intType()} NOT NULL,\n          PRIMARY KEY (session_id, key)\n        )\n      `);\n    })();\n  }\n  return _initPromise;\n}\n\nexport async function appStateGet(\n  sessionId: string,\n  key: string,\n): Promise<Record<string, unknown> | null> {\n  try {\n    await ensureTable();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT value FROM application_state WHERE session_id = ? AND key = ?`,\n      args: [sessionId, key],\n    });\n    if (rows.length === 0) return null;\n    return JSON.parse(rows[0].value as string);\n  } catch (err) {\n    // Transient WS / connection drops (Neon serverless) — caller polls every\n    // 2s and will see the value on the next tick. Swallow rather than 500.\n    if (isConnectionError(err)) return null;\n    throw err;\n  }\n}\n\nexport async function appStatePut(\n  sessionId: string,\n  key: string,\n  value: Record<string, unknown>,\n  options?: StoreWriteOptions,\n): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  await client.execute({\n    sql: isPostgres()\n      ? `INSERT INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?) ON CONFLICT (session_id, key) DO UPDATE SET value=EXCLUDED.value, updated_at=EXCLUDED.updated_at`\n      : `INSERT OR REPLACE INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?)`,\n    args: [sessionId, key, JSON.stringify(value), Date.now()],\n  });\n  emitAppStateChange(key, options?.requestSource, sessionId);\n}\n\nexport async function appStateDelete(\n  sessionId: string,\n  key: string,\n  options?: StoreWriteOptions,\n): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const result = await client.execute({\n    sql: `DELETE FROM application_state WHERE session_id = ? AND key = ?`,\n    args: [sessionId, key],\n  });\n  const deleted = result.rowsAffected > 0;\n  if (deleted) emitAppStateDelete(key, options?.requestSource, sessionId);\n  return deleted;\n}\n\nexport async function appStateList(\n  sessionId: string,\n  keyPrefix: string,\n): Promise<Array<{ key: string; value: Record<string, unknown> }>> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT key, value FROM application_state WHERE session_id = ? AND key LIKE ?`,\n    args: [sessionId, keyPrefix + \"%\"],\n  });\n  return rows.map((row) => ({\n    key: row.key as string,\n    value: JSON.parse(row.value as string),\n  }));\n}\n\nexport async function appStateDeleteByPrefix(\n  sessionId: string,\n  keyPrefix: string,\n  options?: StoreWriteOptions,\n): Promise<number> {\n  await ensureTable();\n  const client = getDbExec();\n\n  // Get keys first so we can emit events\n  const { rows } = await client.execute({\n    sql: `SELECT key FROM application_state WHERE session_id = ? AND key LIKE ?`,\n    args: [sessionId, keyPrefix + \"%\"],\n  });\n\n  if (rows.length === 0) return 0;\n\n  const result = await client.execute({\n    sql: `DELETE FROM application_state WHERE session_id = ? AND key LIKE ?`,\n    args: [sessionId, keyPrefix + \"%\"],\n  });\n\n  for (const row of rows) {\n    emitAppStateDelete(row.key as string, options?.requestSource, sessionId);\n  }\n\n  return result.rowsAffected;\n}\n"]}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/application-state/store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,OAAO,GACR,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGtE,IAAI,YAAuC,CAAC;AAE5C,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,qEAAqE;AACrE,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;;;;;uBAKJ,OAAO,EAAE;;;OAGzB,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACjB,sDAAsD;YACtD,YAAY,GAAG,SAAS,CAAC;YACzB,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACpC,GAAG,EAAE,sEAAsE;YAC3E,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAe,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,uEAAuE;QACvE,IAAI,iBAAiB,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,GAAW,EACX,KAA8B,EAC9B,OAA2B;IAE3B,MAAM,WAAW,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,UAAU,EAAE;YACf,CAAC,CAAC,yLAAyL;YAC3L,CAAC,CAAC,mGAAmG;QACvG,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;KAC1D,CAAC,CAAC;IACH,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,GAAW,EACX,OAA2B;IAE3B,MAAM,WAAW,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClC,GAAG,EAAE,gEAAgE;QACrE,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC;KACvB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;IACxC,IAAI,OAAO;QAAE,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,SAAiB;IAEjB,MAAM,WAAW,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,0FAA0F;QAC/F,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;KAC/C,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,GAAG,CAAC,GAAa;QACtB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC;KACvC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,SAAiB,EACjB,OAA2B;IAE3B,MAAM,WAAW,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,uCAAuC;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,mFAAmF;QACxF,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;KAC/C,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClC,GAAG,EAAE,+EAA+E;QACpF,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;KAC/C,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,kBAAkB,CAAC,GAAG,CAAC,GAAa,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC,YAAY,CAAC;AAC7B,CAAC","sourcesContent":["import {\n  getDbExec,\n  isConnectionError,\n  isPostgres,\n  intType,\n} from \"../db/client.js\";\nimport { emitAppStateChange, emitAppStateDelete } from \"./emitter.js\";\nimport type { StoreWriteOptions } from \"../settings/store.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\n// Escapes LIKE wildcards (`%`, `_`) and the escape char itself so a caller's\n// literal prefix is matched verbatim. Used with `ESCAPE '\\'` in prefix queries\n// below; without this, a prefix such as `user_settings` would treat `_` as a\n// single-char wildcard and over-match (e.g. delete `userXsettings`).\nfunction escapeLike(s: string): string {\n  return s.replace(/([\\\\%_])/g, \"\\\\$1\");\n}\n\nasync function ensureTable(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS application_state (\n          session_id TEXT NOT NULL,\n          key TEXT NOT NULL,\n          value TEXT NOT NULL,\n          updated_at ${intType()} NOT NULL,\n          PRIMARY KEY (session_id, key)\n        )\n      `);\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\nexport async function appStateGet(\n  sessionId: string,\n  key: string,\n): Promise<Record<string, unknown> | null> {\n  try {\n    await ensureTable();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT value FROM application_state WHERE session_id = ? AND key = ?`,\n      args: [sessionId, key],\n    });\n    if (rows.length === 0) return null;\n    return JSON.parse(rows[0].value as string);\n  } catch (err) {\n    // Transient WS / connection drops (Neon serverless) — caller polls every\n    // 2s and will see the value on the next tick. Swallow rather than 500.\n    if (isConnectionError(err)) return null;\n    throw err;\n  }\n}\n\nexport async function appStatePut(\n  sessionId: string,\n  key: string,\n  value: Record<string, unknown>,\n  options?: StoreWriteOptions,\n): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  await client.execute({\n    sql: isPostgres()\n      ? `INSERT INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?) ON CONFLICT (session_id, key) DO UPDATE SET value=EXCLUDED.value, updated_at=EXCLUDED.updated_at`\n      : `INSERT OR REPLACE INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?)`,\n    args: [sessionId, key, JSON.stringify(value), Date.now()],\n  });\n  emitAppStateChange(key, options?.requestSource, sessionId);\n}\n\nexport async function appStateDelete(\n  sessionId: string,\n  key: string,\n  options?: StoreWriteOptions,\n): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const result = await client.execute({\n    sql: `DELETE FROM application_state WHERE session_id = ? AND key = ?`,\n    args: [sessionId, key],\n  });\n  const deleted = result.rowsAffected > 0;\n  if (deleted) emitAppStateDelete(key, options?.requestSource, sessionId);\n  return deleted;\n}\n\nexport async function appStateList(\n  sessionId: string,\n  keyPrefix: string,\n): Promise<Array<{ key: string; value: Record<string, unknown> }>> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT key, value FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\\\'`,\n    args: [sessionId, escapeLike(keyPrefix) + \"%\"],\n  });\n  return rows.map((row) => ({\n    key: row.key as string,\n    value: JSON.parse(row.value as string),\n  }));\n}\n\nexport async function appStateDeleteByPrefix(\n  sessionId: string,\n  keyPrefix: string,\n  options?: StoreWriteOptions,\n): Promise<number> {\n  await ensureTable();\n  const client = getDbExec();\n\n  // Get keys first so we can emit events\n  const { rows } = await client.execute({\n    sql: `SELECT key FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\\\'`,\n    args: [sessionId, escapeLike(keyPrefix) + \"%\"],\n  });\n\n  if (rows.length === 0) return 0;\n\n  const result = await client.execute({\n    sql: `DELETE FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '\\\\'`,\n    args: [sessionId, escapeLike(keyPrefix) + \"%\"],\n  });\n\n  for (const row of rows) {\n    emitAppStateDelete(row.key as string, options?.requestSource, sessionId);\n  }\n\n  return result.rowsAffected;\n}\n"]}

package/dist/brand-kit/brand-signals.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure brand-signal extraction from a website's HTML.
+ *
+ * Shared by the `analyze-brand-assets` action across templates. DB-agnostic and
+ * framework-agnostic: it only fetches (through the SSRF-safe helper) and parses
+ * HTML. The DB access (resolving an existing Brand Kit) stays in the template's
+ * thin action wrapper.
+ */
+import type { BrandWebsiteSignals } from "./types.js";
+/**
+ * Normalize a user-supplied brand website URL: add an `https://` scheme when
+ * missing and reject anything that isn't http(s). Throws on empty input or an
+ * unsupported scheme.
+ */
+export declare function normalizeBrandWebsiteUrl(input: string): string;
+/**
+ * Parse brand signals out of a page's HTML: meta theme-color, CSS custom
+ * properties (capped), @font-face declarations (capped), title, and meta
+ * description. Pure — no network. The provided `url` is echoed back.
+ */
+export declare function extractBrandSignalsFromHtml(html: string, url: string): BrandWebsiteSignals;
+/**
+ * Fetch a brand website (SSRF-safe) and extract its brand signals. Returns the
+ * parsed signals, or an `{ url, error }` shape if the fetch/parse fails — the
+ * caller decides how to surface that to the agent.
+ */
+export declare function fetchBrandWebsiteSignals(websiteUrl: string): Promise<BrandWebsiteSignals | {
+    url: string;
+    error: string;
+}>;
+//# sourceMappingURL=brand-signals.d.ts.map

package/dist/brand-kit/brand-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-signals.d.ts","sourceRoot":"","sources":["../../src/brand-kit/brand-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,mBAAmB,CAsDrB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB/D"}

package/dist/brand-kit/brand-signals.js

@@ -0,0 +1,101 @@
+/**
+ * Pure brand-signal extraction from a website's HTML.
+ *
+ * Shared by the `analyze-brand-assets` action across templates. DB-agnostic and
+ * framework-agnostic: it only fetches (through the SSRF-safe helper) and parses
+ * HTML. The DB access (resolving an existing Brand Kit) stays in the template's
+ * thin action wrapper.
+ */
+import { ssrfSafeFetch } from "../extensions/url-safety.js";
+/**
+ * Normalize a user-supplied brand website URL: add an `https://` scheme when
+ * missing and reject anything that isn't http(s). Throws on empty input or an
+ * unsupported scheme.
+ */
+export function normalizeBrandWebsiteUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("Website URL is required");
+    const hasScheme = /^[a-z][a-z\d+.-]*:/i.test(trimmed);
+    const candidate = hasScheme ? trimmed : `https://${trimmed}`;
+    const parsed = new URL(candidate);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error("Only http and https URLs are allowed");
+    }
+    return parsed.href;
+}
+/**
+ * Parse brand signals out of a page's HTML: meta theme-color, CSS custom
+ * properties (capped), @font-face declarations (capped), title, and meta
+ * description. Pure — no network. The provided `url` is echoed back.
+ */
+export function extractBrandSignalsFromHtml(html, url) {
+    const extracted = { url };
+    // Extract meta theme-color
+    const themeColorMatch = html.match(/<meta[^>]*name=["']theme-color["'][^>]*content=["']([^"']+)["']/i);
+    if (themeColorMatch) {
+        extracted.themeColor = themeColorMatch[1];
+    }
+    // Extract CSS custom properties (--var-name: value)
+    const cssVarMatches = html.matchAll(/--([\w-]+)\s*:\s*([^;}\n]+)/g);
+    const cssVars = {};
+    for (const match of cssVarMatches) {
+        cssVars[`--${match[1]}`] = match[2].trim();
+    }
+    if (Object.keys(cssVars).length > 0) {
+        // Limit to first 50 to avoid overwhelming output
+        const entries = Object.entries(cssVars).slice(0, 50);
+        extracted.cssCustomProperties = Object.fromEntries(entries);
+    }
+    // Extract @font-face declarations
+    const fontFaceMatches = html.matchAll(/@font-face\s*\{([^}]+)\}/g);
+    const fonts = [];
+    for (const match of fontFaceMatches) {
+        const block = match[1];
+        const familyMatch = block.match(/font-family\s*:\s*["']?([^"';]+)["']?/);
+        const srcMatch = block.match(/src\s*:\s*([^;]+)/);
+        fonts.push({
+            family: familyMatch?.[1]?.trim(),
+            src: srcMatch?.[1]?.trim()?.slice(0, 200),
+        });
+    }
+    if (fonts.length > 0) {
+        extracted.fontFaces = fonts.slice(0, 20);
+    }
+    // Extract title
+    const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+    if (titleMatch) {
+        extracted.pageTitle = titleMatch[1].trim();
+    }
+    // Extract meta description
+    const descMatch = html.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["']/i);
+    if (descMatch) {
+        extracted.metaDescription = descMatch[1];
+    }
+    return extracted;
+}
+/**
+ * Fetch a brand website (SSRF-safe) and extract its brand signals. Returns the
+ * parsed signals, or an `{ url, error }` shape if the fetch/parse fails — the
+ * caller decides how to surface that to the agent.
+ */
+export async function fetchBrandWebsiteSignals(websiteUrl) {
+    try {
+        const url = normalizeBrandWebsiteUrl(websiteUrl);
+        const response = await ssrfSafeFetch(url, {
+            headers: {
+                "User-Agent": "Mozilla/5.0 (compatible; AgentNative/1.0; +https://agent-native.com)",
+            },
+            signal: AbortSignal.timeout(10000),
+        }, { maxRedirects: 3 });
+        const html = await response.text();
+        return extractBrandSignalsFromHtml(html, url);
+    }
+    catch (err) {
+        return {
+            url: websiteUrl,
+            error: `Failed to fetch: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=brand-signals.js.map

package/dist/brand-kit/brand-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-signals.js","sourceRoot":"","sources":["../../src/brand-kit/brand-signals.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure brand-signal extraction from a website's HTML.\n *\n * Shared by the `analyze-brand-assets` action across templates. DB-agnostic and\n * framework-agnostic: it only fetches (through the SSRF-safe helper) and parses\n * HTML. The DB access (resolving an existing Brand Kit) stays in the template's\n * thin action wrapper.\n */\n\nimport { ssrfSafeFetch } from \"../extensions/url-safety.js\";\nimport type { BrandWebsiteSignals } from \"./types.js\";\n\n/**\n * Normalize a user-supplied brand website URL: add an `https://` scheme when\n * missing and reject anything that isn't http(s). Throws on empty input or an\n * unsupported scheme.\n */\nexport function normalizeBrandWebsiteUrl(input: string): string {\n  const trimmed = input.trim();\n  if (!trimmed) throw new Error(\"Website URL is required\");\n\n  const hasScheme = /^[a-z][a-z\\d+.-]*:/i.test(trimmed);\n  const candidate = hasScheme ? trimmed : `https://${trimmed}`;\n  const parsed = new URL(candidate);\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(\"Only http and https URLs are allowed\");\n  }\n  return parsed.href;\n}\n\n/**\n * Parse brand signals out of a page's HTML: meta theme-color, CSS custom\n * properties (capped), @font-face declarations (capped), title, and meta\n * description. Pure — no network. The provided `url` is echoed back.\n */\nexport function extractBrandSignalsFromHtml(\n  html: string,\n  url: string,\n): BrandWebsiteSignals {\n  const extracted: BrandWebsiteSignals = { url };\n\n  // Extract meta theme-color\n  const themeColorMatch = html.match(\n    /<meta[^>]*name=[\"']theme-color[\"'][^>]*content=[\"']([^\"']+)[\"']/i,\n  );\n  if (themeColorMatch) {\n    extracted.themeColor = themeColorMatch[1];\n  }\n\n  // Extract CSS custom properties (--var-name: value)\n  const cssVarMatches = html.matchAll(/--([\\w-]+)\\s*:\\s*([^;}\\n]+)/g);\n  const cssVars: Record<string, string> = {};\n  for (const match of cssVarMatches) {\n    cssVars[`--${match[1]}`] = match[2].trim();\n  }\n  if (Object.keys(cssVars).length > 0) {\n    // Limit to first 50 to avoid overwhelming output\n    const entries = Object.entries(cssVars).slice(0, 50);\n    extracted.cssCustomProperties = Object.fromEntries(entries);\n  }\n\n  // Extract @font-face declarations\n  const fontFaceMatches = html.matchAll(/@font-face\\s*\\{([^}]+)\\}/g);\n  const fonts: { family?: string; src?: string }[] = [];\n  for (const match of fontFaceMatches) {\n    const block = match[1];\n    const familyMatch = block.match(/font-family\\s*:\\s*[\"']?([^\"';]+)[\"']?/);\n    const srcMatch = block.match(/src\\s*:\\s*([^;]+)/);\n    fonts.push({\n      family: familyMatch?.[1]?.trim(),\n      src: srcMatch?.[1]?.trim()?.slice(0, 200),\n    });\n  }\n  if (fonts.length > 0) {\n    extracted.fontFaces = fonts.slice(0, 20);\n  }\n\n  // Extract title\n  const titleMatch = html.match(/<title[^>]*>([^<]+)<\\/title>/i);\n  if (titleMatch) {\n    extracted.pageTitle = titleMatch[1].trim();\n  }\n\n  // Extract meta description\n  const descMatch = html.match(\n    /<meta[^>]*name=[\"']description[\"'][^>]*content=[\"']([^\"']+)[\"']/i,\n  );\n  if (descMatch) {\n    extracted.metaDescription = descMatch[1];\n  }\n\n  return extracted;\n}\n\n/**\n * Fetch a brand website (SSRF-safe) and extract its brand signals. Returns the\n * parsed signals, or an `{ url, error }` shape if the fetch/parse fails — the\n * caller decides how to surface that to the agent.\n */\nexport async function fetchBrandWebsiteSignals(\n  websiteUrl: string,\n): Promise<BrandWebsiteSignals | { url: string; error: string }> {\n  try {\n    const url = normalizeBrandWebsiteUrl(websiteUrl);\n    const response = await ssrfSafeFetch(\n      url,\n      {\n        headers: {\n          \"User-Agent\":\n            \"Mozilla/5.0 (compatible; AgentNative/1.0; +https://agent-native.com)\",\n        },\n        signal: AbortSignal.timeout(10000),\n      },\n      { maxRedirects: 3 },\n    );\n    const html = await response.text();\n    return extractBrandSignalsFromHtml(html, url);\n  } catch (err) {\n    return {\n      url: websiteUrl,\n      error: `Failed to fetch: ${err instanceof Error ? err.message : String(err)}`,\n    };\n  }\n}\n"]}

package/dist/brand-kit/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@agent-native/core/brand-kit`
+ *
+ * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what
+ * `design` and `slides` previously copy-pasted as a "design system": design
+ * tokens + brand assets + custom instructions, extractable from Figma, code,
+ * GitHub, a URL, or documents, and used to generate on-brand content.
+ *
+ * This module is pure (no `defineAction`, no DB, no template imports). Templates
+ * keep their own `design_systems` schema table and thin `defineAction` wrappers
+ * (which handle DB access + auto-registration), and import the reusable types
+ * and helpers from here.
+ *
+ * Re-exports the lower-level import/token-extraction helpers from
+ * `design-token-utils` so callers have a single Brand Kit entry point.
+ */
+export * from "./types.js";
+export * from "./brand-signals.js";
+export { extractDesignTokensFromUrl, validateUrl, parseOwnerRepo, fetchGitHubJson, fetchGitHubJsonResult, fetchGitHubRaw, parseTailwindConfig, parseCss, detectStylingFramework, createCodeAnalysisState, analyzeCodeFile, analyzeCssFile, analyzeTailwindConfig, analyzeJsonTheme, analyzePackageJson, analyzeThemeSourceFile, addFont, extractCssVars, extractCodeColors, extractCodeFonts, extractDocumentColors, extractDocumentFonts, classifyFile, suggestionsForType, unique, MAX_FILES, MAX_FILE_SIZE, FETCH_TIMEOUT, ROOT_PATTERNS, SECONDARY_PATHS, CODE_MAX_FILES, CODE_MAX_TOTAL_BYTES, } from "../server/design-token-utils.js";
+export type { ContentType, ParsedCss, ParsedTailwindConfig, CodeAnalysisState, UrlExtractionResult, GitHubFetchOptions, GitHubJsonResult, } from "../server/design-token-utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/brand-kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brand-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAInC,OAAO,EAEL,0BAA0B,EAC1B,WAAW,EAEX,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc,EAEd,mBAAmB,EACnB,QAAQ,EACR,sBAAsB,EAEtB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAEhB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,MAAM,EAEN,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC"}

package/dist/brand-kit/index.js

@@ -0,0 +1,34 @@
+/**
+ * `@agent-native/core/brand-kit`
+ *
+ * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what
+ * `design` and `slides` previously copy-pasted as a "design system": design
+ * tokens + brand assets + custom instructions, extractable from Figma, code,
+ * GitHub, a URL, or documents, and used to generate on-brand content.
+ *
+ * This module is pure (no `defineAction`, no DB, no template imports). Templates
+ * keep their own `design_systems` schema table and thin `defineAction` wrappers
+ * (which handle DB access + auto-registration), and import the reusable types
+ * and helpers from here.
+ *
+ * Re-exports the lower-level import/token-extraction helpers from
+ * `design-token-utils` so callers have a single Brand Kit entry point.
+ */
+export * from "./types.js";
+export * from "./brand-signals.js";
+// Import-source parsing + token extraction (Tailwind/CSS/GitHub/URL/document/
+// code analysis). These already power the import-* actions across templates.
+export { 
+// URL extraction
+extractDesignTokensFromUrl, validateUrl, 
+// GitHub helpers
+parseOwnerRepo, fetchGitHubJson, fetchGitHubJsonResult, fetchGitHubRaw, 
+// Tailwind / CSS parsing
+parseTailwindConfig, parseCss, detectStylingFramework, 
+// Code-file analysis
+createCodeAnalysisState, analyzeCodeFile, analyzeCssFile, analyzeTailwindConfig, analyzeJsonTheme, analyzePackageJson, analyzeThemeSourceFile, addFont, extractCssVars, extractCodeColors, extractCodeFonts, 
+// Document analysis
+extractDocumentColors, extractDocumentFonts, classifyFile, suggestionsForType, unique, 
+// Constants
+MAX_FILES, MAX_FILE_SIZE, FETCH_TIMEOUT, ROOT_PATTERNS, SECONDARY_PATHS, CODE_MAX_FILES, CODE_MAX_TOTAL_BYTES, } from "../server/design-token-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/brand-kit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO;AACL,iBAAiB;AACjB,0BAA0B,EAC1B,WAAW;AACX,iBAAiB;AACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc;AACd,yBAAyB;AACzB,mBAAmB,EACnB,QAAQ,EACR,sBAAsB;AACtB,qBAAqB;AACrB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB;AAChB,oBAAoB;AACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,MAAM;AACN,YAAY;AACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC","sourcesContent":["/**\n * `@agent-native/core/brand-kit`\n *\n * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what\n * `design` and `slides` previously copy-pasted as a \"design system\": design\n * tokens + brand assets + custom instructions, extractable from Figma, code,\n * GitHub, a URL, or documents, and used to generate on-brand content.\n *\n * This module is pure (no `defineAction`, no DB, no template imports). Templates\n * keep their own `design_systems` schema table and thin `defineAction` wrappers\n * (which handle DB access + auto-registration), and import the reusable types\n * and helpers from here.\n *\n * Re-exports the lower-level import/token-extraction helpers from\n * `design-token-utils` so callers have a single Brand Kit entry point.\n */\n\nexport * from \"./types.js\";\nexport * from \"./brand-signals.js\";\n\n// Import-source parsing + token extraction (Tailwind/CSS/GitHub/URL/document/\n// code analysis). These already power the import-* actions across templates.\nexport {\n  // URL extraction\n  extractDesignTokensFromUrl,\n  validateUrl,\n  // GitHub helpers\n  parseOwnerRepo,\n  fetchGitHubJson,\n  fetchGitHubJsonResult,\n  fetchGitHubRaw,\n  // Tailwind / CSS parsing\n  parseTailwindConfig,\n  parseCss,\n  detectStylingFramework,\n  // Code-file analysis\n  createCodeAnalysisState,\n  analyzeCodeFile,\n  analyzeCssFile,\n  analyzeTailwindConfig,\n  analyzeJsonTheme,\n  analyzePackageJson,\n  analyzeThemeSourceFile,\n  addFont,\n  extractCssVars,\n  extractCodeColors,\n  extractCodeFonts,\n  // Document analysis\n  extractDocumentColors,\n  extractDocumentFonts,\n  classifyFile,\n  suggestionsForType,\n  unique,\n  // Constants\n  MAX_FILES,\n  MAX_FILE_SIZE,\n  FETCH_TIMEOUT,\n  ROOT_PATTERNS,\n  SECONDARY_PATHS,\n  CODE_MAX_FILES,\n  CODE_MAX_TOTAL_BYTES,\n} from \"../server/design-token-utils.js\";\n\nexport type {\n  ContentType,\n  ParsedCss,\n  ParsedTailwindConfig,\n  CodeAnalysisState,\n  UrlExtractionResult,\n  GitHubFetchOptions,\n  GitHubJsonResult,\n} from \"../server/design-token-utils.js\";\n"]}

package/dist/brand-kit/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Shared "Brand Kit" data model.
+ *
+ * A Brand Kit is the reusable, template-agnostic brand container: design-system
+ * tokens (colors, typography, spacing, borders), brand assets (logos, reference
+ * images), and free-form custom instructions / voice. It is extracted from a
+ * Figma file, code/GitHub repo, URL, or documents and used to generate
+ * on-brand content (designs, slide themes, images).
+ *
+ * These types are intentionally pure — no framework, DB, or template imports —
+ * so every template (design, slides, …) can re-export and narrow them instead
+ * of copy-pasting their own definitions. Templates persist a Brand Kit row in
+ * their own `design_systems` table (the internal/DB identifier stays stable);
+ * the JSON stored in the `data` column conforms to {@link BrandKitData}.
+ */
+/** Brand color roles. */
+export interface BrandKitColors {
+    primary: string;
+    secondary: string;
+    accent: string;
+    background: string;
+    surface: string;
+    text: string;
+    textMuted: string;
+}
+/** Brand typography system. */
+export interface BrandKitTypography {
+    headingFont: string;
+    bodyFont: string;
+    headingWeight: string;
+    bodyWeight: string;
+    headingSizes: {
+        h1: string;
+        h2: string;
+        h3: string;
+    };
+}
+/** Spacing rhythm. The padding key is template-specific (e.g. `pagePadding`
+ * in design, `slidePadding` in slides), so it stays open while `elementGap`
+ * is shared. */
+export interface BrandKitSpacing {
+    elementGap: string;
+    [paddingKey: string]: string;
+}
+/** Corner / border character. */
+export interface BrandKitBorders {
+    radius: string;
+    accentWidth: string;
+}
+/** Surface defaults applied when generating content. The key wrapping these
+ * (`defaults` in design, `slideDefaults` in slides) is template-specific, so
+ * the shape is shared but the field name stays per-template. */
+export interface BrandKitDefaults {
+    background: string;
+    labelStyle: "uppercase" | "lowercase" | "capitalize" | "none";
+}
+/** A brand logo reference. */
+export interface BrandKitLogo {
+    url: string;
+    name: string;
+    variant: "light" | "dark" | "auto";
+}
+/** Reference imagery + a description guiding on-brand image generation. */
+export interface BrandKitImageStyle {
+    referenceUrls: string[];
+    styleDescription: string;
+}
+/**
+ * The core token shape stored in a Brand Kit's `data` JSON. Templates extend
+ * this with their domain-specific spacing-padding and defaults keys
+ * (`pagePadding`/`defaults` vs `slidePadding`/`slideDefaults`).
+ */
+export interface BrandKitData {
+    colors: BrandKitColors;
+    typography: BrandKitTypography;
+    spacing: BrandKitSpacing;
+    borders: BrandKitBorders;
+    logos: BrandKitLogo[];
+    imageStyle?: BrandKitImageStyle;
+    customCSS?: string;
+    notes?: string;
+}
+/**
+ * Back-compat alias. The internal/DB concept is still called a "design
+ * system"; the user-facing name is "Brand Kit". Both names map to the same
+ * token shape so existing `DesignSystemData` imports keep working.
+ */
+export type DesignSystemData = BrandKitData;
+/** Source a Brand Kit's tokens were extracted from. */
+export type BrandKitSource = "figma" | "figma-file" | "code" | "github" | "url" | "document" | "manual";
+/** Structured brand signals scraped from a website's HTML. */
+export interface BrandWebsiteSignals {
+    url: string;
+    themeColor?: string;
+    cssCustomProperties?: Record<string, string>;
+    fontFaces?: {
+        family?: string;
+        src?: string;
+    }[];
+    pageTitle?: string;
+    metaDescription?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/brand-kit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/brand-kit/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED;;gBAEgB;AAChB,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;gEAEgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;CAC/D;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE5C,uDAAuD;AACvD,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,KAAK,GACL,UAAU,GACV,QAAQ,CAAC;AAEb,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/brand-kit/types.js

@@ -0,0 +1,17 @@
+/**
+ * Shared "Brand Kit" data model.
+ *
+ * A Brand Kit is the reusable, template-agnostic brand container: design-system
+ * tokens (colors, typography, spacing, borders), brand assets (logos, reference
+ * images), and free-form custom instructions / voice. It is extracted from a
+ * Figma file, code/GitHub repo, URL, or documents and used to generate
+ * on-brand content (designs, slide themes, images).
+ *
+ * These types are intentionally pure — no framework, DB, or template imports —
+ * so every template (design, slides, …) can re-export and narrow them instead
+ * of copy-pasting their own definitions. Templates persist a Brand Kit row in
+ * their own `design_systems` table (the internal/DB identifier stays stable);
+ * the JSON stored in the `data` column conforms to {@link BrandKitData}.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/brand-kit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/brand-kit/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/**\n * Shared \"Brand Kit\" data model.\n *\n * A Brand Kit is the reusable, template-agnostic brand container: design-system\n * tokens (colors, typography, spacing, borders), brand assets (logos, reference\n * images), and free-form custom instructions / voice. It is extracted from a\n * Figma file, code/GitHub repo, URL, or documents and used to generate\n * on-brand content (designs, slide themes, images).\n *\n * These types are intentionally pure — no framework, DB, or template imports —\n * so every template (design, slides, …) can re-export and narrow them instead\n * of copy-pasting their own definitions. Templates persist a Brand Kit row in\n * their own `design_systems` table (the internal/DB identifier stays stable);\n * the JSON stored in the `data` column conforms to {@link BrandKitData}.\n */\n\n/** Brand color roles. */\nexport interface BrandKitColors {\n  primary: string;\n  secondary: string;\n  accent: string;\n  background: string;\n  surface: string;\n  text: string;\n  textMuted: string;\n}\n\n/** Brand typography system. */\nexport interface BrandKitTypography {\n  headingFont: string;\n  bodyFont: string;\n  headingWeight: string;\n  bodyWeight: string;\n  headingSizes: { h1: string; h2: string; h3: string };\n}\n\n/** Spacing rhythm. The padding key is template-specific (e.g. `pagePadding`\n * in design, `slidePadding` in slides), so it stays open while `elementGap`\n * is shared. */\nexport interface BrandKitSpacing {\n  elementGap: string;\n  [paddingKey: string]: string;\n}\n\n/** Corner / border character. */\nexport interface BrandKitBorders {\n  radius: string;\n  accentWidth: string;\n}\n\n/** Surface defaults applied when generating content. The key wrapping these\n * (`defaults` in design, `slideDefaults` in slides) is template-specific, so\n * the shape is shared but the field name stays per-template. */\nexport interface BrandKitDefaults {\n  background: string;\n  labelStyle: \"uppercase\" | \"lowercase\" | \"capitalize\" | \"none\";\n}\n\n/** A brand logo reference. */\nexport interface BrandKitLogo {\n  url: string;\n  name: string;\n  variant: \"light\" | \"dark\" | \"auto\";\n}\n\n/** Reference imagery + a description guiding on-brand image generation. */\nexport interface BrandKitImageStyle {\n  referenceUrls: string[];\n  styleDescription: string;\n}\n\n/**\n * The core token shape stored in a Brand Kit's `data` JSON. Templates extend\n * this with their domain-specific spacing-padding and defaults keys\n * (`pagePadding`/`defaults` vs `slidePadding`/`slideDefaults`).\n */\nexport interface BrandKitData {\n  colors: BrandKitColors;\n  typography: BrandKitTypography;\n  spacing: BrandKitSpacing;\n  borders: BrandKitBorders;\n  logos: BrandKitLogo[];\n  imageStyle?: BrandKitImageStyle;\n  customCSS?: string;\n  notes?: string;\n}\n\n/**\n * Back-compat alias. The internal/DB concept is still called a \"design\n * system\"; the user-facing name is \"Brand Kit\". Both names map to the same\n * token shape so existing `DesignSystemData` imports keep working.\n */\nexport type DesignSystemData = BrandKitData;\n\n/** Source a Brand Kit's tokens were extracted from. */\nexport type BrandKitSource =\n  | \"figma\"\n  | \"figma-file\"\n  | \"code\"\n  | \"github\"\n  | \"url\"\n  | \"document\"\n  | \"manual\";\n\n/** Structured brand signals scraped from a website's HTML. */\nexport interface BrandWebsiteSignals {\n  url: string;\n  themeColor?: string;\n  cssCustomProperties?: Record<string, string>;\n  fontFaces?: { family?: string; src?: string }[];\n  pageTitle?: string;\n  metaDescription?: string;\n}\n"]}

package/dist/browser-sessions/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/browser-sessions/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,+BAA+B,EAC/B,gCAAgC,EAGhC,2CAA2C,EAC3C,sCAAsC,EACvC,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAS,CAAC;AACjE,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAmR3D,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,sCAAsC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA2C1C;AAED,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAqB5C;AAED,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AA8CD,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,gCAAgC,CAAC,CAqC3C;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAUlD;AAED,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CA6BlD;AAED,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EACF;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAAC,gCAAgC,CAAC,CAoC3C;AAED,wBAAsB,4BAA4B,CAChD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,EAClD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAalB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/browser-sessions/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,+BAA+B,EAC/B,gCAAgC,EAGhC,2CAA2C,EAC3C,sCAAsC,EACvC,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAS,CAAC;AACjE,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAwR3D,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,sCAAsC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA2C1C;AAED,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAqB5C;AAED,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AA8CD,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,gCAAgC,CAAC,CAqC3C;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAUlD;AAED,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CA6BlD;AAED,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EACF;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAAC,gCAAgC,CAAC,CAoC3C;AAED,wBAAsB,4BAA4B,CAChD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,EAClD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/browser-sessions/store.js

@@ -58,7 +58,12 @@ async function ensureTables() {
           CREATE INDEX IF NOT EXISTS agent_native_browser_session_requests_pending_idx
           ON ${REQUEST_TABLE} (owner_email, session_id, status, created_at)
         `));
-        })();
+        })().catch((err) => {
+            // Don't cache a transient init failure — otherwise every browser-session
+            // call re-awaits the same rejected promise until the process restarts.
+            initPromise = undefined;
+            throw err;
+        });
     }
     return initPromise;
 }