@tomako/tools-runtime 0.1.0

package/src/lib/tools/app-icon-resizer-schema.ts

@@ -0,0 +1,191 @@
+import { z } from "zod";
+
+export const APP_ICON_RESIZER_META = {
+  id: "tools.app-icon-resizer.local",
+  version: "2026-06-30.1",
+  owner: "growth-tools",
+  riskLevel: "low",
+  lastReviewedAt: "2026-06-30",
+} as const;
+
+export const APPLE_APP_ICON_MIN_SOURCE_SIZE = 1024;
+export const GOOGLE_PLAY_ICON_SIZE = 512;
+export const GOOGLE_PLAY_ICON_MAX_BYTES = 1024 * 1024;
+
+export const appIconPlatformSchema = z.enum(["all", "apple", "google"]);
+export const appIconFitSchema = z.enum(["cover", "contain"]);
+
+export const appIconResizerInputSchema = z.object({
+  platform: appIconPlatformSchema.default("all"),
+  fit: appIconFitSchema.default("cover"),
+  backgroundColor: z
+    .string()
+    .trim()
+    .regex(/^#[0-9A-Fa-f]{6}$/)
+    .default("#F4F7F5"),
+  fileName: z.string().trim().min(1).max(160),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  type: z.string().trim().max(80).optional().default(""),
+});
+
+export const appIconAssetSchema = z.object({
+  id: z.string().min(1),
+  platform: z.enum(["apple", "google", "android"]),
+  group: z.string().min(1),
+  path: z.string().min(1),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  purpose: z.string().min(1),
+  required: z.boolean().default(true),
+});
+
+export const appIconResizerOutputSchema = z.object({
+  toolId: z.literal(APP_ICON_RESIZER_META.id),
+  version: z.literal(APP_ICON_RESIZER_META.version),
+  source: z.object({
+    fileName: z.string().min(1),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    type: z.string(),
+  }),
+  assetCount: z.number().int().positive(),
+  zipName: z.string().min(1),
+  assets: z.array(appIconAssetSchema).min(1),
+  warnings: z.array(z.string()),
+});
+
+export type AppIconPlatform = z.infer<typeof appIconPlatformSchema>;
+export type AppIconFit = z.infer<typeof appIconFitSchema>;
+export type AppIconResizerInput = z.infer<typeof appIconResizerInputSchema>;
+export type AppIconAsset = z.infer<typeof appIconAssetSchema>;
+export type AppIconResizerOutput = z.infer<typeof appIconResizerOutputSchema>;
+
+export type IosAppIconSlot = {
+  idiom: "iphone" | "ipad" | "ios-marketing";
+  size: string;
+  scale: "1x" | "2x" | "3x";
+  pixels: number;
+  filename: string;
+};
+
+export const IOS_APP_ICON_SLOTS: readonly IosAppIconSlot[] = [
+  { idiom: "iphone", size: "20x20", scale: "2x", pixels: 40, filename: "Icon-App-20x20@2x.png" },
+  { idiom: "iphone", size: "20x20", scale: "3x", pixels: 60, filename: "Icon-App-20x20@3x.png" },
+  { idiom: "iphone", size: "29x29", scale: "2x", pixels: 58, filename: "Icon-App-29x29@2x.png" },
+  { idiom: "iphone", size: "29x29", scale: "3x", pixels: 87, filename: "Icon-App-29x29@3x.png" },
+  { idiom: "iphone", size: "40x40", scale: "2x", pixels: 80, filename: "Icon-App-40x40@2x.png" },
+  { idiom: "iphone", size: "40x40", scale: "3x", pixels: 120, filename: "Icon-App-40x40@3x.png" },
+  { idiom: "iphone", size: "60x60", scale: "2x", pixels: 120, filename: "Icon-App-60x60@2x.png" },
+  { idiom: "iphone", size: "60x60", scale: "3x", pixels: 180, filename: "Icon-App-60x60@3x.png" },
+  { idiom: "ipad", size: "20x20", scale: "1x", pixels: 20, filename: "Icon-App-20x20@1x.png" },
+  { idiom: "ipad", size: "20x20", scale: "2x", pixels: 40, filename: "Icon-App-20x20@2x~ipad.png" },
+  { idiom: "ipad", size: "29x29", scale: "1x", pixels: 29, filename: "Icon-App-29x29@1x.png" },
+  { idiom: "ipad", size: "29x29", scale: "2x", pixels: 58, filename: "Icon-App-29x29@2x~ipad.png" },
+  { idiom: "ipad", size: "40x40", scale: "1x", pixels: 40, filename: "Icon-App-40x40@1x.png" },
+  { idiom: "ipad", size: "40x40", scale: "2x", pixels: 80, filename: "Icon-App-40x40@2x~ipad.png" },
+  { idiom: "ipad", size: "76x76", scale: "1x", pixels: 76, filename: "Icon-App-76x76@1x.png" },
+  { idiom: "ipad", size: "76x76", scale: "2x", pixels: 152, filename: "Icon-App-76x76@2x.png" },
+  { idiom: "ipad", size: "83.5x83.5", scale: "2x", pixels: 167, filename: "Icon-App-83.5x83.5@2x.png" },
+  { idiom: "ios-marketing", size: "1024x1024", scale: "1x", pixels: 1024, filename: "Icon-App-1024x1024@1x.png" },
+] as const;
+
+export const APP_ICON_ASSET_SPECS: readonly AppIconAsset[] = [
+  ...IOS_APP_ICON_SLOTS.map((slot): AppIconAsset => ({
+    id: `apple-${slot.idiom}-${slot.size}-${slot.scale}`,
+    platform: "apple",
+    group: "iOS AppIcon.appiconset",
+    path: `Apple/AppIcon.appiconset/${slot.filename}`,
+    width: slot.pixels,
+    height: slot.pixels,
+    purpose:
+      slot.idiom === "ios-marketing"
+        ? "iOS 1024pt App Store image well"
+        : `${slot.idiom} ${slot.size} ${slot.scale} Xcode slot`,
+    required: true,
+  })),
+  {
+    id: "apple-store-1024",
+    platform: "apple",
+    group: "App Store 1024 icon",
+    path: "Apple/AppStoreIcon-1024.png",
+    width: 1024,
+    height: 1024,
+    purpose: "Standalone 1024px release review icon",
+    required: true,
+  },
+  {
+    id: "google-play-512",
+    platform: "google",
+    group: "Google Play Console upload",
+    path: "GooglePlay/app-icon-512.png",
+    width: GOOGLE_PLAY_ICON_SIZE,
+    height: GOOGLE_PLAY_ICON_SIZE,
+    purpose: "512px store listing icon, PNG under 1024KB",
+    required: true,
+  },
+  {
+    id: "android-mdpi",
+    platform: "android",
+    group: "Android launcher mipmap",
+    path: "Android/res/mipmap-mdpi/ic_launcher.png",
+    width: 48,
+    height: 48,
+    purpose: "mdpi launcher icon",
+    required: true,
+  },
+  {
+    id: "android-hdpi",
+    platform: "android",
+    group: "Android launcher mipmap",
+    path: "Android/res/mipmap-hdpi/ic_launcher.png",
+    width: 72,
+    height: 72,
+    purpose: "hdpi launcher icon",
+    required: true,
+  },
+  {
+    id: "android-xhdpi",
+    platform: "android",
+    group: "Android launcher mipmap",
+    path: "Android/res/mipmap-xhdpi/ic_launcher.png",
+    width: 96,
+    height: 96,
+    purpose: "xhdpi launcher icon",
+    required: true,
+  },
+  {
+    id: "android-xxhdpi",
+    platform: "android",
+    group: "Android launcher mipmap",
+    path: "Android/res/mipmap-xxhdpi/ic_launcher.png",
+    width: 144,
+    height: 144,
+    purpose: "xxhdpi launcher icon",
+    required: true,
+  },
+  {
+    id: "android-xxxhdpi",
+    platform: "android",
+    group: "Android launcher mipmap",
+    path: "Android/res/mipmap-xxxhdpi/ic_launcher.png",
+    width: 192,
+    height: 192,
+    purpose: "xxxhdpi launcher icon",
+    required: true,
+  },
+] as const;
+
+export function getAppIconAssetSpecs(platform: AppIconPlatform): readonly AppIconAsset[] {
+  if (platform === "apple") {
+    return APP_ICON_ASSET_SPECS.filter((asset) => asset.platform === "apple");
+  }
+
+  if (platform === "google") {
+    return APP_ICON_ASSET_SPECS.filter(
+      (asset) => asset.platform === "google" || asset.platform === "android",
+    );
+  }
+
+  return APP_ICON_ASSET_SPECS;
+}

package/src/lib/tools/app-store-screenshot-generator-schema.ts

@@ -0,0 +1,185 @@
+import { z } from "zod";
+
+export const APP_STORE_SCREENSHOT_GENERATOR_PROMPT_META = {
+  id: "tools.app-store-screenshot-generator.agent",
+  version: "2026-07-03.2",
+  owner: "growth-tools",
+  riskLevel: "medium",
+  lastReviewedAt: "2026-07-01",
+} as const;
+
+export const APP_STORE_SCREENSHOT_GENERATOR_RESULT_TYPE = "app_store_screenshot_set";
+
+export const appStoreScreenshotSourceSchema = z.enum(["url", "upload", "mixed", "brief"]);
+export const appStoreScreenshotPlatformSchema = z.enum(["apple", "google"]);
+export const appStoreScreenshotStyleSchema = z.enum([
+  "clean",
+  "bold",
+  "editorial",
+  "dark",
+]);
+export const appStoreScreenshotOutputLanguageSchema = z.enum(["zh", "en"]);
+export const appStoreScreenshotPaletteSchema = z.enum([
+  "auto",
+  "brand",
+  "mono",
+  "warm",
+  "cool",
+  "vibrant",
+  "dark",
+]);
+export const appStoreScreenshotLayoutSchema = z.enum([
+  "portrait",
+  "feature",
+  "mixed",
+]);
+
+const optionalDataUrlSchema = z
+  .string()
+  .trim()
+  .refine((value) => !value || /^data:image\/(png|jpeg|jpg|webp);base64,/i.test(value), {
+    message: "Expected an image data URL.",
+  })
+  .optional()
+  .default("");
+
+export const appStoreScreenshotReferenceSchema = z.object({
+  name: z.string().trim().max(240),
+  dataUrl: optionalDataUrlSchema,
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+});
+
+export const appStoreScreenshotGeneratorInputSchema = z
+  .object({
+    source: appStoreScreenshotSourceSchema.default("url"),
+    productUrl: z.string().trim().max(180).optional().default(""),
+    hasScreenshot: z.boolean().default(false),
+    screenshotName: z.string().trim().max(2000).optional().default(""),
+    screenshotDataUrl: optionalDataUrlSchema,
+    screenshotWidth: z.number().int().positive().optional(),
+    screenshotHeight: z.number().int().positive().optional(),
+    screenshotReferences: z.array(appStoreScreenshotReferenceSchema).max(10).optional().default([]),
+    logoName: z.string().trim().max(240).optional().default(""),
+    logoDataUrl: optionalDataUrlSchema,
+    logoWidth: z.number().int().positive().optional(),
+    logoHeight: z.number().int().positive().optional(),
+    productName: z.string().trim().max(60).optional().default(""),
+    productBenefits: z.string().trim().max(1000).optional().default(""),
+    assetCount: z.number().int().min(1).max(10).optional().default(10),
+    outputLanguage: appStoreScreenshotOutputLanguageSchema.default("zh"),
+    platform: appStoreScreenshotPlatformSchema.default("apple"),
+    style: appStoreScreenshotStyleSchema.default("clean"),
+    palette: appStoreScreenshotPaletteSchema.default("auto"),
+    layout: appStoreScreenshotLayoutSchema.default("mixed"),
+    headline: z.string().trim().max(54).optional().default(""),
+    subheadline: z.string().trim().max(96).optional().default(""),
+  })
+  .superRefine((value, context) => {
+    const hasScreenshot =
+      value.hasScreenshot ||
+      Boolean(value.screenshotDataUrl) ||
+      value.screenshotReferences.length > 0;
+
+    if (!hasScreenshot) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["screenshotReferences"],
+        message: "Upload at least one UI screenshot.",
+      });
+    }
+  });
+
+export const appStoreScreenshotAssetSchema = z.object({
+  id: z.string().min(1),
+  platform: appStoreScreenshotPlatformSchema,
+  format: z.enum(["iphone", "ipad", "googlePhone", "featureGraphic"]),
+  title: z.string().trim().max(80).optional(),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  slot: z.number().int().positive().optional(),
+  setSize: z.number().int().positive().max(12).optional(),
+  imageTaskId: z.string().min(1).optional(),
+  imageUrl: z.string().url().optional(),
+  svg: z.string().min(100).optional(),
+}).superRefine((value, context) => {
+  if (!value.imageUrl && !value.svg) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["imageUrl"],
+      message: "Either imageUrl or svg is required.",
+    });
+  }
+});
+
+export const appStoreScreenshotGeneratorOutputSchema = z.object({
+  promptId: z.literal(APP_STORE_SCREENSHOT_GENERATOR_PROMPT_META.id),
+  promptVersion: z.literal(APP_STORE_SCREENSHOT_GENERATOR_PROMPT_META.version),
+  prompt: z.string().trim().min(200).max(16000),
+  assets: z.array(appStoreScreenshotAssetSchema).min(1).max(12),
+});
+
+export const appStoreScreenshotAgentAssetSchema = z.object({
+  id: z.string().min(1),
+  platform: appStoreScreenshotPlatformSchema,
+  format: z.enum(["iphone", "ipad", "googlePhone", "featureGraphic"]),
+  title: z.string().trim().max(80),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  slot: z.number().int().positive().optional(),
+  setSize: z.number().int().positive().optional(),
+  imageTaskId: z.string().min(1).optional(),
+  imageUrl: z.string().url().optional(),
+  prompt: z.string().trim().min(120).max(16000).optional(),
+  status: z.string().trim().max(80).optional(),
+  errorMessage: z.string().trim().max(600).optional(),
+});
+
+export const appStoreScreenshotAgentResultSchema = z.object({
+  promptId: z.literal(APP_STORE_SCREENSHOT_GENERATOR_PROMPT_META.id),
+  promptVersion: z.string().trim().min(1).max(80),
+  reportStatus: z.enum(["partial", "final"]).optional().default("final"),
+  summary: z.string().trim().min(1).max(800),
+  prompt: z.string().trim().min(200).max(16000),
+  assets: z.array(appStoreScreenshotAgentAssetSchema).min(1).max(12),
+  failures: z
+    .array(
+      z.object({
+        id: z.string().min(1),
+        title: z.string().trim().max(80).optional(),
+        message: z.string().trim().max(600),
+      }),
+    )
+    .optional()
+    .default([]),
+  totalAssets: z.number().int().positive().max(12).optional(),
+  completedAssets: z.number().int().nonnegative().max(12).optional(),
+  failedAssets: z.number().int().nonnegative().max(12).optional(),
+  inProgressAsset: z
+    .object({
+      id: z.string().min(1),
+      title: z.string().trim().max(80).optional(),
+      slot: z.number().int().positive().optional(),
+      setSize: z.number().int().positive().optional(),
+    })
+    .optional(),
+  estimatedRemainingSeconds: z.number().int().nonnegative().max(3600).optional(),
+  generatedAt: z.string().trim().max(80).optional(),
+});
+
+export type AppStoreScreenshotGeneratorInput = z.infer<
+  typeof appStoreScreenshotGeneratorInputSchema
+>;
+export type AppStoreScreenshotReference = z.infer<
+  typeof appStoreScreenshotReferenceSchema
+>;
+export type AppStoreScreenshotAsset = z.infer<typeof appStoreScreenshotAssetSchema>;
+export type AppStoreScreenshotGeneratorOutput = z.infer<
+  typeof appStoreScreenshotGeneratorOutputSchema
+>;
+export type AppStoreScreenshotAgentAsset = z.infer<
+  typeof appStoreScreenshotAgentAssetSchema
+>;
+export type AppStoreScreenshotAgentResult = z.infer<
+  typeof appStoreScreenshotAgentResultSchema
+>;

package/src/lib/tools/build-in-public-story-generator-schema.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+
+export const buildInPublicStages = [
+  "idea",
+  "prototype",
+  "beta",
+  "launched",
+  "postLaunch",
+] as const;
+
+export const buildInPublicBoundaries = [
+  "open",
+  "blurMetrics",
+  "avoidRoadmap",
+  "customerSafe",
+] as const;
+
+export const buildInPublicChannels = [
+  "indieHackers",
+  "reddit",
+  "xThread",
+  "linkedin",
+] as const;
+
+export const buildInPublicStoryBriefSchema = z.object({
+  productName: z.string().trim().min(2).max(80),
+  productContext: z.string().trim().min(24).max(420),
+  stage: z.enum(buildInPublicStages),
+  thisWeek: z.string().trim().min(40).max(900),
+  feedbackAsk: z.string().trim().min(16).max(260),
+  gtmStrategy: z.string().trim().max(700).optional().or(z.literal("")),
+  metrics: z.string().trim().max(500).optional().or(z.literal("")),
+  uncertainty: z.string().trim().max(500).optional().or(z.literal("")),
+  publicBoundary: z.enum(buildInPublicBoundaries),
+  language: z.enum(["zh", "en"]),
+});
+
+export type BuildInPublicStoryBrief = z.infer<
+  typeof buildInPublicStoryBriefSchema
+>;
+export type BuildInPublicStage = (typeof buildInPublicStages)[number];
+export type BuildInPublicBoundary = (typeof buildInPublicBoundaries)[number];
+export type BuildInPublicChannel = (typeof buildInPublicChannels)[number];
+
+export interface BuildInPublicDraft {
+  channel: BuildInPublicChannel;
+  title: string;
+  body: string;
+  fitNote: string;
+}
+
+export interface BuildInPublicStoryResult {
+  summary: {
+    transparencyScore: number;
+    storyAngle: string;
+    primaryRisk: string;
+    recommendedLead: string;
+  };
+  drafts: BuildInPublicDraft[];
+  checks: {
+    authenticityIssues: string[];
+    evidenceGaps: string[];
+    communityFit: string[];
+    missingInfo: string[];
+    reviewChecklist: string[];
+  };
+}