@tomako/tools-runtime 0.1.0

package/src/lib/tools/social-platform-asset-adapter-schema.ts

@@ -0,0 +1,152 @@
+import { z } from "zod";
+
+export const SOCIAL_PLATFORM_ASSET_ADAPTER_SCENE =
+  "social_platform_asset_adapter";
+export const SOCIAL_PLATFORM_ASSET_ADAPTER_RESULT_TYPE =
+  "social_platform_asset_adapter";
+
+export const socialAssetPlatformSchema = z.enum([
+  "x",
+  "linkedin",
+  "instagram",
+  "tiktok",
+  "youtubeShorts",
+  "facebook",
+]);
+
+export const socialAssetGoalSchema = z.enum([
+  "launch",
+  "education",
+  "community",
+  "leadGeneration",
+  "retention",
+]);
+
+export const socialAssetToneSchema = z.enum([
+  "clear",
+  "bold",
+  "warm",
+  "expert",
+  "playful",
+]);
+
+export const socialAssetMaterialCoverageSchema = z.enum([
+  "provided",
+  "inferred",
+  "missing",
+]);
+
+export const socialAssetDesignAssetSchema = z.object({
+  id: z.string().trim().min(1).max(80),
+  name: z.string().trim().min(1).max(180),
+  type: z.enum(["image/png", "image/jpeg", "image/webp"]),
+  size: z.number().int().nonnegative().max(800_000),
+  width: z.number().int().positive().max(2400),
+  height: z.number().int().positive().max(2400),
+  dataUrl: z
+    .string()
+    .max(700_000)
+    .refine((value) => value.startsWith("data:image/"), {
+      message: "Design asset must be an image data URL.",
+    }),
+});
+
+const materialPlaceholderPattern =
+  /^(test|demo|sample|example|asdf|qwer|lorem ipsum|123+|111+|222+|xxx+)$/i;
+
+const optionalMaterialTextSchema = z.string().trim().max(2400).default("");
+
+export function hasUsableSocialAssetMaterial(input: {
+  sourceTitle?: string;
+  sourceCopy?: string;
+  designAssets?: readonly unknown[];
+  tags?: string;
+}) {
+  if (input.designAssets && input.designAssets.length > 0) return true;
+
+  return [
+    input.sourceTitle,
+    input.sourceCopy,
+    input.tags,
+  ].some((value) => {
+    const text = value?.trim() ?? "";
+    if (!text) return false;
+    if (materialPlaceholderPattern.test(text)) return false;
+    if (/^\d+$/.test(text)) return false;
+    if (text.length >= 18) return true;
+    if (text.startsWith("#") && text.split(/[,\s]+/).filter(Boolean).length >= 2) {
+      return true;
+    }
+    return false;
+  });
+}
+
+export const socialPlatformAssetAdapterInputSchema = z
+  .object({
+    sourceTitle: optionalMaterialTextSchema,
+    sourceCopy: optionalMaterialTextSchema,
+    designAssets: z.array(socialAssetDesignAssetSchema).max(3).default([]),
+    tags: optionalMaterialTextSchema,
+    platforms: z.array(socialAssetPlatformSchema).min(1).max(6),
+    campaignGoal: socialAssetGoalSchema.default("launch"),
+    tone: socialAssetToneSchema.default("clear"),
+    audience: z.string().trim().max(1200).optional().default(""),
+    constraints: z.string().trim().max(1600).optional().default(""),
+    language: z.enum(["zh", "en"]).default("zh"),
+  })
+  .superRefine((value, ctx) => {
+    if (!hasUsableSocialAssetMaterial(value)) {
+      ctx.addIssue({
+        code: "custom",
+        message:
+          "Provide at least one real material field: title, copy, design assets, or tags.",
+        path: ["sourceTitle"],
+      });
+    }
+  });
+
+export const socialAssetMaterialInventorySchema = z.object({
+  title: socialAssetMaterialCoverageSchema,
+  copy: socialAssetMaterialCoverageSchema,
+  designMaterials: socialAssetMaterialCoverageSchema,
+  tags: socialAssetMaterialCoverageSchema,
+});
+
+export const adaptedPlatformAssetSchema = z.object({
+  platform: socialAssetPlatformSchema,
+  title: z.string(),
+  caption: z.string(),
+  designBrief: z.string(),
+  hashtags: z.array(z.string()),
+  sourceBasis: socialAssetMaterialInventorySchema,
+  formatNotes: z.array(z.string()).default([]),
+  riskNotes: z.array(z.string()).default([]),
+});
+
+export const socialPlatformAssetAdapterResultSchema = z.object({
+  currentRead: z.object({
+    sourceSummary: z.string(),
+    materialCoverage: socialAssetMaterialInventorySchema,
+    audience: z.string().optional(),
+    campaignGoal: z.string(),
+    assumptions: z.array(z.string()).default([]),
+  }),
+  platformAssets: z.array(adaptedPlatformAssetSchema).min(1),
+  contentAngles: z.array(z.string()).default([]),
+  missingInfo: z.array(z.string()).default([]),
+  reviewChecklist: z.array(z.string()).default([]),
+  exportNotes: z.array(z.string()).default([]),
+  promptVersion: z.string().optional(),
+  generatedAt: z.string().optional(),
+});
+
+export type SocialAssetPlatform = z.infer<typeof socialAssetPlatformSchema>;
+export type SocialAssetGoal = z.infer<typeof socialAssetGoalSchema>;
+export type SocialAssetTone = z.infer<typeof socialAssetToneSchema>;
+export type SocialPlatformAssetAdapterInput = z.infer<
+  typeof socialPlatformAssetAdapterInputSchema
+>;
+export type AdaptedPlatformAsset = z.infer<typeof adaptedPlatformAssetSchema>;
+export type SocialPlatformAssetAdapterResult = z.infer<
+  typeof socialPlatformAssetAdapterResultSchema
+>;

package/src/lib/tools/social-profile-kit.constants.ts

@@ -0,0 +1,12 @@
+export {
+  SOCIAL_PROFILE_AVATAR_POLICY,
+  SOCIAL_PROFILE_DEFAULT_COLORS,
+  SOCIAL_PROFILE_PLATFORM_SPECS,
+  SOCIAL_PROFILE_PLATFORMS,
+  SOCIAL_PROFILE_V1_PLATFORMS,
+} from "../../constants/social-profile-kit";
+export type {
+  SocialProfileImageSpec,
+  SocialProfilePlatformSpec,
+  SocialProfileSafeAreaBox,
+} from "../../constants/social-profile-kit";

package/src/lib/tools/social-profile-kit.generation.ts

@@ -0,0 +1,257 @@
+import {
+  SOCIAL_PROFILE_PLATFORM_SPECS,
+  SOCIAL_PROFILE_V1_PLATFORMS,
+  type SocialProfileSafeAreaBox,
+} from "./social-profile-kit.constants";
+import type {
+  SocialProfileMode,
+  SocialProfilePlatform,
+} from "./social-profile-kit.schema";
+
+export type PlatformGenerationStatus =
+  | "idle"
+  | "queued"
+  | "generating"
+  | "ready"
+  | "failed";
+
+export type PlatformGenerationState = Record<
+  SocialProfilePlatform,
+  PlatformGenerationStatus
+>;
+
+export type SocialProfileAssetGenerationMode =
+  | "userProvided"
+  | "logoGenerator"
+  | "placeholder"
+  | "generate"
+  | "crop"
+  | "regenerateVariant";
+
+export type SocialProfileAssetGroup = {
+  id: string;
+  label: string;
+  assetKind: "avatar" | "banner";
+  generationMode: SocialProfileAssetGenerationMode;
+  requiredForV1: boolean;
+  master: {
+    width: number;
+    height: number;
+    note: string;
+    safeAreaBox?: SocialProfileSafeAreaBox;
+  };
+  platforms: SocialProfilePlatform[];
+  outputs: Array<{
+    platform: SocialProfilePlatform;
+    kind: "avatar" | "banner";
+    width: number;
+    height: number;
+    generationMode: SocialProfileAssetGenerationMode;
+    cropFrom?: string;
+    safeAreaBox?: SocialProfileSafeAreaBox;
+  }>;
+};
+
+export const SOCIAL_PROFILE_PRIMARY_PLATFORMS = [
+  "x",
+  "bluesky",
+  "threads",
+  "linkedin",
+  "linkedin-company",
+  "instagram",
+  "tiktok",
+  "youtube",
+  "facebook",
+] as const satisfies readonly SocialProfilePlatform[];
+
+export function createPlatformGenerationState(
+  status: PlatformGenerationStatus,
+): PlatformGenerationState {
+  return {
+    x: status,
+    bluesky: status,
+    threads: status,
+    linkedin: status,
+    "linkedin-company": status,
+    instagram: status,
+    tiktok: status,
+    youtube: status,
+    facebook: status,
+  };
+}
+
+export function getPrimaryGenerationPlatforms(
+  mode: SocialProfileMode,
+): SocialProfilePlatform[] {
+  void mode;
+  return [...SOCIAL_PROFILE_PRIMARY_PLATFORMS];
+}
+
+export function createQueuedGenerationState(
+  platforms: readonly SocialProfilePlatform[],
+): PlatformGenerationState {
+  const state = createPlatformGenerationState("idle");
+  for (const platform of platforms) {
+    state[platform] = "queued";
+  }
+  return state;
+}
+
+function avatarOutput(platform: SocialProfilePlatform) {
+  const avatar = SOCIAL_PROFILE_PLATFORM_SPECS[platform].avatar;
+  return {
+    platform,
+    kind: "avatar" as const,
+    width: avatar.width,
+    height: avatar.height,
+    generationMode: "crop" as const,
+    cropFrom: "avatar-source-master",
+  };
+}
+
+function bannerOutput(platform: SocialProfilePlatform) {
+  const banner = SOCIAL_PROFILE_PLATFORM_SPECS[platform].banner;
+  if (!banner) return null;
+  return {
+    platform,
+    kind: "banner" as const,
+    width: banner.width,
+    height: banner.height,
+    generationMode: "crop" as const,
+    safeAreaBox: banner.safeAreaBox,
+  };
+}
+
+function requiredBannerOutput(platform: SocialProfilePlatform) {
+  const output = bannerOutput(platform);
+  if (!output) {
+    throw new Error(`${platform} does not support profile banners`);
+  }
+  return output;
+}
+
+export const SOCIAL_PROFILE_ASSET_GROUPS: SocialProfileAssetGroup[] = [
+  {
+    id: "avatar-source-master",
+    label: "Uploaded avatar, logo, or neutral monogram source",
+    assetKind: "avatar",
+    generationMode: "userProvided",
+    requiredForV1: true,
+    master: {
+      width: 1024,
+      height: 1024,
+      note: "Do not generate a human portrait by default. Use an uploaded founder photo, uploaded brand logo, or neutral monogram placeholder, then crop/export to each platform avatar size.",
+    },
+    platforms: [...SOCIAL_PROFILE_V1_PLATFORMS],
+    outputs: SOCIAL_PROFILE_V1_PLATFORMS.map((platform) => avatarOutput(platform)),
+  },
+  {
+    id: "x-header-master",
+    label: "Shared social banner master",
+    assetKind: "banner",
+    generationMode: "generate",
+    requiredForV1: true,
+    master: {
+      width: 3000,
+      height: 1000,
+      safeAreaBox: SOCIAL_PROFILE_PLATFORM_SPECS.x.banner?.safeAreaBox,
+      note: "Generate one coherent master banner visual with key identity inside the center band, then crop it into every banner-capable V1 platform.",
+    },
+    platforms: ["x", "bluesky", "linkedin", "linkedin-company", "youtube", "facebook"],
+    outputs: [
+      {
+        ...requiredBannerOutput("x"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+      {
+        ...requiredBannerOutput("bluesky"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+      {
+        ...requiredBannerOutput("linkedin"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+      {
+        ...requiredBannerOutput("linkedin-company"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+      {
+        ...requiredBannerOutput("youtube"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+      {
+        ...requiredBannerOutput("facebook"),
+        generationMode: "crop",
+        cropFrom: "x-header-master",
+      },
+    ],
+  },
+  {
+    id: "linkedin-personal-background",
+    label: "LinkedIn personal background",
+    assetKind: "banner",
+    generationMode: "regenerateVariant",
+    requiredForV1: false,
+    master: {
+      width: 1584,
+      height: 396,
+      safeAreaBox: SOCIAL_PROFILE_PLATFORM_SPECS.linkedin.banner?.safeAreaBox,
+      note: "Create a LinkedIn personal background variant. Do not simply crop the X header because the avatar overlap and 4:1 ratio need a different layout.",
+    },
+    platforms: ["linkedin"],
+    outputs: [
+      {
+        ...requiredBannerOutput("linkedin"),
+        generationMode: "regenerateVariant",
+        cropFrom: "linkedin-personal-background",
+      },
+    ],
+  },
+  {
+    id: "linkedin-company-cover",
+    label: "LinkedIn company cover",
+    assetKind: "banner",
+    generationMode: "regenerateVariant",
+    requiredForV1: false,
+    master: {
+      width: 4200,
+      height: 700,
+      safeAreaBox: SOCIAL_PROFILE_PLATFORM_SPECS["linkedin-company"].banner?.safeAreaBox,
+      note: "Create a separate 6:1 company cover variant. This is not a safe crop from the personal LinkedIn background.",
+    },
+    platforms: ["linkedin-company"],
+    outputs: [
+      {
+        ...requiredBannerOutput("linkedin-company"),
+        generationMode: "regenerateVariant",
+        cropFrom: "linkedin-company-cover",
+      },
+    ],
+  },
+  {
+    id: "youtube-channel-banner",
+    label: "YouTube channel banner",
+    assetKind: "banner",
+    generationMode: "regenerateVariant",
+    requiredForV1: false,
+    master: {
+      width: 2560,
+      height: 1440,
+      safeAreaBox: SOCIAL_PROFILE_PLATFORM_SPECS.youtube.banner?.safeAreaBox,
+      note: "Create a YouTube-specific 16:9 banner with all text and logos inside the center safe area.",
+    },
+    platforms: ["youtube"],
+    outputs: [
+      {
+        ...requiredBannerOutput("youtube"),
+        generationMode: "regenerateVariant",
+        cropFrom: "youtube-channel-banner",
+      },
+    ],
+  },
+];

package/src/lib/tools/social-profile-kit.input.ts

@@ -0,0 +1,290 @@
+import {
+  getDefaultOutputLanguageForMarket,
+  type SocialProfileInput,
+  type SocialProfileOutputLanguage,
+  type SocialProfileTargetMarket,
+} from "./social-profile-kit.schema";
+
+const DEFAULT_NAMES = new Set(["novadesk"]);
+const DEFAULT_POSITIONING = new Set([
+  "ai workspace for solo founders",
+  "面向独立创始人的 ai 工作台",
+]);
+const DEFAULT_AUDIENCES = new Set([
+  "creators, indie hackers",
+  "创作者、独立开发者",
+]);
+
+const INLINE_LABELS = [
+  "account\\s*type",
+  "account\\s*shape",
+  "product\\s*name",
+  "brand\\s*name",
+  "name",
+  "website",
+  "positioning",
+  "audience",
+  "target\\s*users?",
+  "target\\s*market",
+  "market",
+  "region",
+  "country",
+  "language",
+  "output\\s*language",
+  "tone",
+  "existing\\s*avatar",
+  "existing\\s*logo",
+  "priority\\s*platforms",
+  "extra",
+  "账号类型",
+  "产品名称",
+  "品牌名称",
+  "名称",
+  "官网",
+  "定位",
+  "目标用户",
+  "目标受众",
+  "受众",
+  "目标市场",
+  "市场",
+  "地区",
+  "国家",
+  "语言",
+  "输出语言",
+  "语气",
+  "风格",
+].join("|");
+
+function compact(value: string | undefined) {
+  return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+
+function clamp(value: string, max: number) {
+  return value.length > max ? value.slice(0, max).trim() : value;
+}
+
+function isDefaultish(value: string, defaults: Set<string>) {
+  return defaults.has(compact(value).toLowerCase());
+}
+
+function cleanExtractedValue(value: string) {
+  return compact(value)
+    .replace(/^["'“”‘’]+|["'“”‘’]+$/g, "")
+    .replace(/[.。!！?？;；,，:：]+$/g, "")
+    .trim();
+}
+
+export function extractSocialProfileWebsite(prompt: string | undefined) {
+  const source = compact(prompt);
+  const match = source.match(
+    /(?:https?:\/\/)?(?:www\.)?([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z]{2,})+)/i,
+  );
+  return match?.[1]?.toLowerCase();
+}
+
+function titleFromDomain(domain: string) {
+  const root = domain.split(".")[0] ?? "";
+  if (!root) return undefined;
+  return root
+    .split(/[-_]+/)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function matchLabeledValue(prompt: string, labels: string[]) {
+  for (const label of labels) {
+    const inlinePattern = new RegExp(
+      `${label}\\s*[:：]\\s*([^\\n。；;]+?)(?=\\s+(?:${INLINE_LABELS})\\s*[:：]|$)`,
+      "i",
+    );
+    const match = compact(prompt).match(inlinePattern);
+    if (match?.[1]) return cleanExtractedValue(match[1]);
+
+    const linePattern = new RegExp(`^\\s*${label}\\s*[:：]\\s*(.+?)\\s*$`, "i");
+    for (const line of prompt.split(/\r?\n/)) {
+      const lineMatch = line.match(linePattern);
+      if (lineMatch?.[1]) return cleanExtractedValue(lineMatch[1]);
+    }
+  }
+  return undefined;
+}
+
+function extractName(prompt: string, website?: string) {
+  const labeled = matchLabeledValue(prompt, [
+    "product\\s*name",
+    "brand\\s*name",
+    "name",
+    "产品名称",
+    "产品名",
+    "品牌名称",
+    "品牌名",
+    "名称",
+  ]);
+  if (labeled) return labeled;
+
+  const founderMatch = prompt.match(/我是\s*([A-Za-z0-9][\w.-]{1,50})\s*的/u);
+  if (founderMatch?.[1]) return founderMatch[1];
+
+  const productDomainMatch = prompt.match(
+    /产品是\s*(?:https?:\/\/)?(?:www\.)?([a-z0-9][\w-]*(?:\.[a-z]{2,})+)/iu,
+  );
+  if (productDomainMatch?.[1]) return titleFromDomain(productDomainMatch[1]);
+
+  return website ? titleFromDomain(website) : undefined;
+}
+
+function extractPositioning(prompt: string) {
+  const labeled = matchLabeledValue(prompt, [
+    "positioning",
+    "one\\s*line\\s*positioning",
+    "what\\s*do\\s*you\\s*do",
+    "一句话定位",
+    "定位",
+    "你是做什么的",
+  ]);
+  if (labeled) return labeled;
+
+  const chineseProduct = prompt.match(/产品是[^，。?.]+[，,]\s*([^。?\n]+)/u);
+  if (chineseProduct?.[1]) return compact(chineseProduct[1]);
+
+  const englishPositioning = prompt.match(
+    /\b(?:[A-Z][\w.-]{1,50}|it|this|product)\s+is\s+(?:an?\s+)?([^.\n]+?)(?=\.\s*(?:audience|target\s*users?|tone|priority\s*platforms|website|official|has\s+brand\s+logo)|[.\n]|$)/i,
+  );
+  if (englishPositioning?.[1]) return cleanExtractedValue(englishPositioning[1]);
+
+  const firstUsefulLine = prompt
+    .split(/\r?\n|。|；|;/)
+    .map(compact)
+    .find(
+      (line) =>
+        line &&
+        !/^(account\s*type|product\s*name|brand\s*name|website|官网|产品名称|名称)\s*[:：]/i.test(
+          line,
+        ),
+    );
+
+  return firstUsefulLine;
+}
+
+function extractAudience(prompt: string) {
+  const labeled = matchLabeledValue(prompt, [
+    "audience",
+    "target\\s*users?",
+    "目标用户",
+    "目标受众",
+    "受众",
+    "面向",
+  ]);
+  if (labeled) return labeled;
+
+  const chineseAudience = prompt.match(/面向(?:于)?\s*([^。?\n]+?)(?:，|,|。|\.|$)/u);
+  if (chineseAudience?.[1]) return compact(chineseAudience[1]);
+
+  return undefined;
+}
+
+function extractTone(prompt: string): SocialProfileInput["tone"] | undefined {
+  const labeled = matchLabeledValue(prompt, ["tone", "语气", "风格"]);
+  const source = compact(labeled || prompt).toLowerCase();
+
+  if (/friendly|warm|亲和|轻松|友好/.test(source)) return "friendly";
+  if (/professional|credible|专业|可信|稳重/.test(source)) return "professional";
+  if (/bold|sharp|鲜明|冲击|大胆/.test(source)) return "bold";
+  if (/minimal|restrained|极简|克制|简洁/.test(source)) return "minimal";
+  if (/modern|clear|现代|清晰/.test(source)) return "modern";
+  return undefined;
+}
+
+function extractTargetMarket(
+  prompt: string,
+): SocialProfileTargetMarket | undefined {
+  const labeled = matchLabeledValue(prompt, [
+    "target\\s*market",
+    "market",
+    "region",
+    "country",
+    "目标市场",
+    "市场",
+    "地区",
+    "国家",
+  ]);
+  const source = compact(labeled || prompt).toLowerCase();
+
+  if (/china|mainland|chinese|中文|中国|国内|大陆|简体中文/.test(source)) {
+    return "china";
+  }
+  if (/japan|japanese|日本|日文|日语/.test(source)) return "japan";
+  if (/europe|eu|uk|英国|欧洲/.test(source)) return "europe";
+  if (/north\s*america|usa|us|united\s*states|canada|america|美国|加拿大|北美/.test(source)) {
+    return "northAmerica";
+  }
+  if (/global|international|worldwide|全球|国际|海外/.test(source)) return "global";
+  return undefined;
+}
+
+function extractOutputLanguage(
+  prompt: string,
+): SocialProfileOutputLanguage | undefined {
+  const labeled = matchLabeledValue(prompt, [
+    "language",
+    "output\\s*language",
+    "语言",
+    "输出语言",
+  ]);
+  const source = compact(labeled || prompt).toLowerCase();
+
+  if (/chinese|zh|中文|汉语|简体/.test(source)) return "zh";
+  if (/japanese|ja|日文|日语/.test(source)) return "ja";
+  if (/english|en|英文|英语/.test(source)) return "en";
+  return undefined;
+}
+
+export function normalizeSocialProfileInputForSubmission(
+  input: SocialProfileInput,
+): SocialProfileInput {
+  if (input.inputMode !== "prompt") return input;
+
+  const rawPrompt = String(input.prompt ?? "").trim();
+  const prompt = compact(rawPrompt);
+  const extractionSource = rawPrompt || prompt;
+  const website = extractSocialProfileWebsite(extractionSource);
+  const name = extractName(extractionSource, website);
+  const positioning = extractPositioning(extractionSource);
+  const audience = extractAudience(extractionSource);
+  const targetMarket = extractTargetMarket(extractionSource);
+  const outputLanguage = extractOutputLanguage(extractionSource);
+  const tone = extractTone(extractionSource);
+
+  const nextMarket = targetMarket || input.targetMarket;
+
+  return {
+    ...input,
+    prompt: clamp(prompt, 1200),
+    name: clamp(
+      name ||
+        (isDefaultish(input.name, DEFAULT_NAMES) && website
+          ? titleFromDomain(website)
+          : undefined) ||
+        input.name,
+      80,
+    ),
+    positioning: clamp(
+      positioning && isDefaultish(input.positioning, DEFAULT_POSITIONING)
+        ? positioning
+        : positioning || input.positioning,
+      180,
+    ),
+    audience: clamp(
+      audience && isDefaultish(input.audience, DEFAULT_AUDIENCES)
+        ? audience
+        : audience || input.audience,
+      120,
+    ),
+    targetMarket: nextMarket,
+    outputLanguage:
+      outputLanguage ||
+      (targetMarket ? getDefaultOutputLanguageForMarket(targetMarket) : input.outputLanguage),
+    tone: tone || input.tone,
+  };
+}