@designcrowd/library.brand-page 5.17.6 → 5.17.7

package/src/metadata-builder/metadata-executor.ts

@@ -10,6 +10,26 @@ import {
 } from './models';
 import { UpdateContentTextBuilder } from './builders/update-content-text-builder';
 import { UpdateContentTextStyleBuilder } from './builders/update-content-text-style-builder';
+import {
+  BannerSectionBuilder,
+  AboutSectionBuilder,
+  ContactFormBuilder,
+  DividerSectionBuilder,
+  TextSectionBuilder,
+  TestimonialSectionBuilder,
+  ImagesSectionBuilder,
+  ShapesSectionBuilder,
+  SocialLinksBuilder,
+  ImageGalleryBuilder,
+  ProfileSectionBuilder,
+  MailingListSectionBuilder,
+  ImageSectionBuilder,
+  ButtonSectionBuilder,
+  DeleteSectionBuilder,
+  MoveSectionBuilder,
+} from './builders/section-builders';
+import { AddPageBuilder } from './builders/add-page-builder';
+import { RemovePageBuilder } from './builders/remove-page-builder';
 import type { Logger } from './logger';
 
 type BuilderConstructor = new (
@@ -21,6 +41,68 @@ type BuilderConstructor = new (
 const getBuilderRegistry = (): Record<BuilderType, BuilderConstructor> => ({
   [BUILDER_TYPES.UPDATE_CONTENT_TEXT]: UpdateContentTextBuilder,
   [BUILDER_TYPES.UPDATE_CONTENT_TEXT_STYLE]: UpdateContentTextStyleBuilder,
+
+  // Section builders (create)
+  [BUILDER_TYPES.CREATE_BANNER_SECTION]: BannerSectionBuilder,
+  [BUILDER_TYPES.CREATE_ABOUT_SECTION]: AboutSectionBuilder,
+  [BUILDER_TYPES.CREATE_CONTACT_FORM]: ContactFormBuilder,
+  [BUILDER_TYPES.CREATE_DIVIDER_SECTION]: DividerSectionBuilder,
+  [BUILDER_TYPES.CREATE_TEXT]: TextSectionBuilder,
+  [BUILDER_TYPES.CREATE_TESTIMONIAL_SECTION]: TestimonialSectionBuilder,
+  [BUILDER_TYPES.CREATE_IMAGES_SECTION]: ImagesSectionBuilder,
+  [BUILDER_TYPES.CREATE_SHAPES_SECTION]: ShapesSectionBuilder,
+  [BUILDER_TYPES.CREATE_SOCIAL_LINKS]: SocialLinksBuilder,
+  [BUILDER_TYPES.CREATE_IMAGE_GALLERY]: ImageGalleryBuilder,
+  [BUILDER_TYPES.CREATE_PROFILE]: ProfileSectionBuilder,
+  [BUILDER_TYPES.CREATE_MAILING_LIST]: MailingListSectionBuilder,
+  [BUILDER_TYPES.CREATE_IMAGE]: ImageSectionBuilder,
+  [BUILDER_TYPES.CREATE_GENERAL_LINK]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_WEBSITE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_EMAIL]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_PHONE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_FACEBOOK]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_X]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_INSTAGRAM]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_YOUTUBE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_LINKEDIN]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_PINTEREST]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_TWITCH]: ButtonSectionBuilder,
+  [BUILDER_TYPES.CREATE_TIKTOK]: ButtonSectionBuilder,
+
+  // Section builders (update)
+  [BUILDER_TYPES.UPDATE_BANNER_SECTION]: BannerSectionBuilder,
+  [BUILDER_TYPES.UPDATE_ABOUT_SECTION]: AboutSectionBuilder,
+  [BUILDER_TYPES.UPDATE_CONTACT_FORM]: ContactFormBuilder,
+  [BUILDER_TYPES.UPDATE_DIVIDER_SECTION]: DividerSectionBuilder,
+  [BUILDER_TYPES.UPDATE_TEXT]: TextSectionBuilder,
+  [BUILDER_TYPES.UPDATE_TESTIMONIAL_SECTION]: TestimonialSectionBuilder,
+  [BUILDER_TYPES.UPDATE_IMAGES_SECTION]: ImagesSectionBuilder,
+  [BUILDER_TYPES.UPDATE_SHAPES_SECTION]: ShapesSectionBuilder,
+  [BUILDER_TYPES.UPDATE_SOCIAL_LINKS]: SocialLinksBuilder,
+  [BUILDER_TYPES.UPDATE_IMAGE_GALLERY]: ImageGalleryBuilder,
+  [BUILDER_TYPES.UPDATE_PROFILE]: ProfileSectionBuilder,
+  [BUILDER_TYPES.UPDATE_MAILING_LIST]: MailingListSectionBuilder,
+  [BUILDER_TYPES.UPDATE_IMAGE]: ImageSectionBuilder,
+  [BUILDER_TYPES.UPDATE_GENERAL_LINK]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_WEBSITE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_EMAIL]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_PHONE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_FACEBOOK]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_X]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_INSTAGRAM]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_YOUTUBE]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_LINKEDIN]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_PINTEREST]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_TWITCH]: ButtonSectionBuilder,
+  [BUILDER_TYPES.UPDATE_TIKTOK]: ButtonSectionBuilder,
+
+  // Section-level operations
+  [BUILDER_TYPES.DELETE_SECTION]: DeleteSectionBuilder,
+  [BUILDER_TYPES.MOVE_SECTION]: MoveSectionBuilder,
+
+  // Page-level operations
+  [BUILDER_TYPES.ADD_PAGE]: AddPageBuilder,
+  [BUILDER_TYPES.REMOVE_PAGE]: RemovePageBuilder,
 });
 
 let builderRegistry: Record<BuilderType, BuilderConstructor> | null = null;
@@ -28,7 +110,7 @@ let builderRegistry: Record<BuilderType, BuilderConstructor> | null = null;
 const resolveBuilder = (
   request: MetadataBuilderRequest,
   logger?: Logger,
-): BaseMetadataBuilder => {
+): BaseMetadataBuilder | null => {
   if (!builderRegistry) {
     builderRegistry = getBuilderRegistry();
   }
@@ -36,9 +118,9 @@ const resolveBuilder = (
   const BuilderClass = builderRegistry[request.type];
 
   if (!BuilderClass) {
-    throw new Error(
-      `No builder registered for request type: "${request.type}"`,
-    );
+    console.error(`No builder registered for request type: "${request.type}"`);
+
+    return null;
   }
 
   return new BuilderClass(request, logger);
@@ -57,6 +139,16 @@ export class MetadataExecutor {
     for (const request of requests) {
       const builder = resolveBuilder(request, logger);
 
+      if (!builder) {
+        results.push({
+          request,
+          model,
+          errors: [`No builder found for request type: "${request.type}"`],
+        });
+
+        continue;
+      }
+
       const result = await builder.buildAsync(model);
 
       results.push(result);

package/src/metadata-builder/models.ts

@@ -4,6 +4,68 @@ import type { Logger } from './logger';
 export const BUILDER_TYPES = {
   UPDATE_CONTENT_TEXT: 'update-content-text',
   UPDATE_CONTENT_TEXT_STYLE: 'update-content-text-style',
+
+  // Per-section builder types (create)
+  CREATE_BANNER_SECTION: 'create-banner-section',
+  CREATE_ABOUT_SECTION: 'create-about-section',
+  CREATE_CONTACT_FORM: 'create-contact-form',
+  CREATE_DIVIDER_SECTION: 'create-divider-section',
+  CREATE_TEXT: 'create-text',
+  CREATE_TESTIMONIAL_SECTION: 'create-testimonial-section',
+  CREATE_IMAGES_SECTION: 'create-images-section',
+  CREATE_SHAPES_SECTION: 'create-shapes-section',
+  CREATE_SOCIAL_LINKS: 'create-social-links',
+  CREATE_IMAGE_GALLERY: 'create-image-gallery',
+  CREATE_PROFILE: 'create-profile',
+  CREATE_MAILING_LIST: 'create-mailing-list',
+  CREATE_IMAGE: 'create-image',
+  CREATE_GENERAL_LINK: 'create-general-link',
+  CREATE_WEBSITE: 'create-website',
+  CREATE_EMAIL: 'create-email',
+  CREATE_PHONE: 'create-phone',
+  CREATE_FACEBOOK: 'create-facebook',
+  CREATE_X: 'create-x',
+  CREATE_INSTAGRAM: 'create-instagram',
+  CREATE_YOUTUBE: 'create-youtube',
+  CREATE_LINKEDIN: 'create-linkedin',
+  CREATE_PINTEREST: 'create-pinterest',
+  CREATE_TWITCH: 'create-twitch',
+  CREATE_TIKTOK: 'create-tiktok',
+
+  // Per-section builder types (update)
+  UPDATE_BANNER_SECTION: 'update-banner-section',
+  UPDATE_ABOUT_SECTION: 'update-about-section',
+  UPDATE_CONTACT_FORM: 'update-contact-form',
+  UPDATE_DIVIDER_SECTION: 'update-divider-section',
+  UPDATE_TEXT: 'update-text',
+  UPDATE_TESTIMONIAL_SECTION: 'update-testimonial-section',
+  UPDATE_IMAGES_SECTION: 'update-images-section',
+  UPDATE_SHAPES_SECTION: 'update-shapes-section',
+  UPDATE_SOCIAL_LINKS: 'update-social-links',
+  UPDATE_IMAGE_GALLERY: 'update-image-gallery',
+  UPDATE_PROFILE: 'update-profile',
+  UPDATE_MAILING_LIST: 'update-mailing-list',
+  UPDATE_IMAGE: 'update-image',
+  UPDATE_GENERAL_LINK: 'update-general-link',
+  UPDATE_WEBSITE: 'update-website',
+  UPDATE_EMAIL: 'update-email',
+  UPDATE_PHONE: 'update-phone',
+  UPDATE_FACEBOOK: 'update-facebook',
+  UPDATE_X: 'update-x',
+  UPDATE_INSTAGRAM: 'update-instagram',
+  UPDATE_YOUTUBE: 'update-youtube',
+  UPDATE_LINKEDIN: 'update-linkedin',
+  UPDATE_PINTEREST: 'update-pinterest',
+  UPDATE_TWITCH: 'update-twitch',
+  UPDATE_TIKTOK: 'update-tiktok',
+
+  // Section-level operations
+  DELETE_SECTION: 'delete-section',
+  MOVE_SECTION: 'move-section',
+
+  // Page-level operations
+  ADD_PAGE: 'add-page',
+  REMOVE_PAGE: 'remove-page',
 } as const;
 
 export type BuilderType = (typeof BUILDER_TYPES)[keyof typeof BUILDER_TYPES];

package/src/metadata-builder/parsers/ai-toolcall-parser.ts

@@ -1,19 +1,61 @@
 import type { AiAssistantToolCall } from '../../clients/ai-assistant-client';
+import type { SectionType } from './section-tool-arguments';
 
-// Tool names
+// Tool names — must match the function names generated by the AI pipeline.
+// Text element tools use camelCase names.
+// Section tools follow the pattern: build_{sectionType}_section
+// where sectionType matches the ContentType value (e.g. 'banner-section', 'profile').
+// The mode ('create' | 'update') is a field in the tool arguments, not the tool name.
 export const AI_ASSISTANT_TOOL_NAMES = {
+  // Text element agent tools
   UPDATE_TEXT: 'updateText',
   UPDATE_STYLE: 'updateStyle',
+
+  // Website builder agent tools — unified build
+  BUILD_PROFILE_SECTION: 'build_profile_section',
+  BUILD_TEXT_SECTION: 'build_text_section',
+  BUILD_IMAGE_SECTION: 'build_image_section',
+  BUILD_IMAGE_GALLERY_SECTION: 'build_image-gallery_section',
+  BUILD_GENERAL_LINK_SECTION: 'build_general-link_section',
+  BUILD_WEBSITE_SECTION: 'build_website_section',
+  BUILD_EMAIL_SECTION: 'build_email_section',
+  BUILD_PHONE_SECTION: 'build_phone_section',
+  BUILD_FACEBOOK_SECTION: 'build_facebook_section',
+  BUILD_X_SECTION: 'build_x_section',
+  BUILD_INSTAGRAM_SECTION: 'build_instagram_section',
+  BUILD_YOUTUBE_SECTION: 'build_youtube_section',
+  BUILD_LINKEDIN_SECTION: 'build_linkedin_section',
+  BUILD_PINTEREST_SECTION: 'build_pinterest_section',
+  BUILD_TWITCH_SECTION: 'build_twitch_section',
+  BUILD_TIKTOK_SECTION: 'build_tiktok_section',
+  BUILD_SOCIAL_LINKS_SECTION: 'build_social-links_section',
+  BUILD_MAILING_LIST_SECTION: 'build_mailing-list_section',
+  BUILD_CONTACT_FORM_SECTION: 'build_contact-form_section',
+  BUILD_BANNER_SECTION: 'build_banner_section',
+  BUILD_ABOUT_SECTION: 'build_about_section',
+  BUILD_IMAGES_SECTION: 'build_images_section',
+  BUILD_SHAPES_SECTION: 'build_shapes_section',
+  BUILD_TESTIMONIAL_SECTION: 'build_testimonial_section',
+  BUILD_DIVIDER_SECTION: 'build_divider_section',
+
+  // Section-level operation tools
+  DELETE_SECTION: 'delete_section',
+  MOVE_SECTION: 'move_section',
+
+  // Page-level operation tools
+  ADD_PAGE: 'add_page',
+  REMOVE_PAGE: 'remove_page',
 } as const;
 
 export type AiAssistantToolName =
   (typeof AI_ASSISTANT_TOOL_NAMES)[keyof typeof AI_ASSISTANT_TOOL_NAMES];
 
-// Parsed tool call arguments after JSON.parse
+// Unified parsed tool call — covers both text element and section tool calls.
+// The `function` name is the primary identity and routing mechanism.
 export interface ParsedToolCall {
   toolId: string;
-  function: AiAssistantToolName;
-  arguments: UpdateTextToolArguments | UpdateStyleToolArguments;
+  function: string;
+  arguments: Record<string, unknown>;
   usage_type?: 'free' | 'paid';
 }
 
@@ -39,23 +81,105 @@ export interface UpdateStyleToolArguments extends BaseArguments {
   };
 }
 
-const parseToolCall = (toolCall: AiAssistantToolCall): ParsedToolCall => {
-  return {
-    toolId: toolCall.toolId,
-    function: toolCall.function as AiAssistantToolName,
-    arguments: JSON.parse(toolCall.arguments),
-    usage_type: toolCall.usage_type,
-  };
+// Maps each section tool name to its SectionType.
+// Mode is now determined from the tool arguments, not the tool name.
+export const SECTION_TOOL_MAP: Record<string, { sectionType: SectionType }> = {
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_PROFILE_SECTION]: { sectionType: 'profile' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_TEXT_SECTION]: { sectionType: 'text' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_IMAGE_SECTION]: { sectionType: 'image' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_IMAGE_GALLERY_SECTION]: {
+    sectionType: 'image-gallery',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_GENERAL_LINK_SECTION]: {
+    sectionType: 'general-link',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_WEBSITE_SECTION]: { sectionType: 'website' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_EMAIL_SECTION]: { sectionType: 'email' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_PHONE_SECTION]: { sectionType: 'phone' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_FACEBOOK_SECTION]: { sectionType: 'facebook' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_X_SECTION]: { sectionType: 'x' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_INSTAGRAM_SECTION]: {
+    sectionType: 'instagram',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_YOUTUBE_SECTION]: { sectionType: 'youtube' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_LINKEDIN_SECTION]: { sectionType: 'linkedin' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_PINTEREST_SECTION]: {
+    sectionType: 'pinterest',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_TWITCH_SECTION]: { sectionType: 'twitch' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_TIKTOK_SECTION]: { sectionType: 'tiktok' },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_SOCIAL_LINKS_SECTION]: {
+    sectionType: 'social-links',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_MAILING_LIST_SECTION]: {
+    sectionType: 'mailing-list',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_CONTACT_FORM_SECTION]: {
+    sectionType: 'contact-form',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_BANNER_SECTION]: {
+    sectionType: 'banner-section',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_ABOUT_SECTION]: {
+    sectionType: 'about-section',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_IMAGES_SECTION]: {
+    sectionType: 'images-section',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_SHAPES_SECTION]: {
+    sectionType: 'shapes-section',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_TESTIMONIAL_SECTION]: {
+    sectionType: 'testimonial-section',
+  },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_DIVIDER_SECTION]: {
+    sectionType: 'divider-section',
+  },
 };
 
-export const parseAiToolcall = (
-  aiToolcallResponse: AiAssistantToolCall[],
+export interface DeleteSectionArguments {
+  content_id: string;
+}
+
+export interface MoveSectionArguments {
+  content_id: string;
+  position: number;
+  target_page_id?: string;
+}
+
+export interface AddPageArguments {
+  page_id: string;
+  page_name: string;
+}
+
+export interface RemovePageArguments {
+  page_id: string;
+}
+
+export const parseToolCalls = (
+  toolCalls: AiAssistantToolCall[],
 ): ParsedToolCall[] => {
-  if (!aiToolcallResponse || aiToolcallResponse.length === 0) {
+  if (!toolCalls || toolCalls.length === 0) {
     return [];
   }
 
-  return aiToolcallResponse.map((toolCall) => {
-    return parseToolCall(toolCall);
-  });
+  return toolCalls
+    .map((toolCall): ParsedToolCall | null => {
+      try {
+        return {
+          toolId: toolCall.toolId,
+          function: toolCall.function,
+          arguments: JSON.parse(toolCall.arguments) as Record<string, unknown>,
+          usage_type: toolCall.usage_type,
+        };
+      } catch (error) {
+        console.warn(
+          `[parseToolCalls] Failed to parse arguments for ${toolCall.function} (${toolCall.toolId}):`,
+          error,
+        );
+
+        return null;
+      }
+    })
+    .filter((tc): tc is ParsedToolCall => tc !== null);
 };