@gptmarket/temporal-types 0.0.32 → 0.0.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gptmarket/temporal-types",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "TypeScript types and workflow registry for GPTMarket Temporal workflows",
   "main": "index.ts",
   "types": "index.ts",

package/registry.ts

@@ -968,6 +968,233 @@ export const saa_s_video: WorkflowDefinition<
   ],
 };
 
+export const screenshot_generator: WorkflowDefinition<
+  Types.ScreenshotGeneratorInput,
+  Types.ScreenshotGeneratorOutput
+> = {
+  id: "screenshot_generator",
+  name: "Screenshot Generator",
+  description: "Screenshot Generator Workflow.",
+  workflowClass: "ScreenshotGeneratorWorkflow",
+  inputType: "ScreenshotGeneratorInput",
+  outputType: "ScreenshotGeneratorOutput",
+  fields: [
+    {
+      name: "secret_key",
+      type: "text",
+      label: "Secret Key",
+      description:
+        "Secret key for authentication (required when WORKFLOW_SECRET_ENABLED=True)",
+      required: false,
+      default: null,
+    },
+    {
+      name: "rewrite_enabled",
+      type: "checkbox",
+      label: "Rewrite Enabled",
+      description:
+        "Make your content appear as fresh, original uploads. Bypasses duplicate detection and AI content filters on social platforms.",
+      required: false,
+      default: false,
+    },
+    {
+      name: "rewrite_device",
+      type: "select",
+      label: "Rewrite Device",
+      description:
+        "Make media appear as if created on this device. Adds authenticity and helps bypass platform detection. Random device if not specified.",
+      required: false,
+      default: null,
+      options: [
+        { value: "iPhone 17 Pro Max", label: "Iphone 17 Pro Max" },
+        { value: "iPhone 17 Pro", label: "Iphone 17 Pro" },
+        { value: "iPhone 17 Plus", label: "Iphone 17 Plus" },
+        { value: "iPhone 17", label: "Iphone 17" },
+        { value: "iPhone 16 Pro Max", label: "Iphone 16 Pro Max" },
+        { value: "iPhone 16 Pro", label: "Iphone 16 Pro" },
+        { value: "iPhone 16 Plus", label: "Iphone 16 Plus" },
+        { value: "iPhone 16", label: "Iphone 16" },
+        { value: "iPhone 15 Pro Max", label: "Iphone 15 Pro Max" },
+        { value: "iPhone 15 Pro", label: "Iphone 15 Pro" },
+        { value: "iPhone 15 Plus", label: "Iphone 15 Plus" },
+        { value: "iPhone 15", label: "Iphone 15" },
+        { value: "iPhone 14 Pro Max", label: "Iphone 14 Pro Max" },
+        { value: "iPhone 14 Pro", label: "Iphone 14 Pro" },
+        { value: "iPhone 14 Plus", label: "Iphone 14 Plus" },
+        { value: "iPhone 14", label: "Iphone 14" },
+        { value: "iPhone 13 Pro Max", label: "Iphone 13 Pro Max" },
+        { value: "iPhone 13 Pro", label: "Iphone 13 Pro" },
+        { value: "iPhone 13", label: "Iphone 13" },
+        { value: "iPhone 13 mini", label: "Iphone 13 Mini" },
+        {
+          value: "Ray-Ban Meta Smart Glasses",
+          label: "Ray-Ban Meta Smart Glasses",
+        },
+      ],
+    },
+    {
+      name: "app_url",
+      type: "text",
+      label: "App Url",
+      description: "App Store URL",
+      required: false,
+      default: null,
+    },
+    {
+      name: "app_id",
+      type: "text",
+      label: "App Id",
+      description: "Numeric App Store ID",
+      required: false,
+      default: null,
+    },
+    {
+      name: "country",
+      type: "text",
+      label: "Country",
+      description: "Country code for App Store lookup",
+      required: false,
+      default: "us",
+    },
+    {
+      name: "app_title",
+      type: "text",
+      label: "App Title",
+      description: "App title (overrides fetched)",
+      required: false,
+      default: null,
+    },
+    {
+      name: "app_subtitle",
+      type: "text",
+      label: "App Subtitle",
+      description: "App subtitle / tagline",
+      required: false,
+      default: null,
+    },
+    {
+      name: "app_description",
+      type: "textarea",
+      label: "App Description",
+      description: "App description (overrides fetched)",
+      required: false,
+      default: null,
+    },
+    {
+      name: "primary_color",
+      type: "text",
+      label: "Primary Color",
+      description: 'Primary brand color hex (e.g. "#4A90D9")',
+      required: false,
+      default: null,
+    },
+    {
+      name: "secondary_color",
+      type: "text",
+      label: "Secondary Color",
+      description: "Secondary brand color hex",
+      required: false,
+      default: null,
+    },
+    {
+      name: "accent_color",
+      type: "text",
+      label: "Accent Color",
+      description: "Accent color hex",
+      required: false,
+      default: null,
+    },
+    {
+      name: "background_style",
+      type: "text",
+      label: "Background Style",
+      description:
+        "Background style: gradient, solid, abstract, blurred, minimal, dark, light",
+      required: false,
+      default: null,
+    },
+    {
+      name: "design_style",
+      type: "text",
+      label: "Design Style",
+      description:
+        "Overall design style: modern, bold, playful, corporate, elegant, minimal, vibrant",
+      required: false,
+      default: null,
+    },
+    {
+      name: "brand_keywords",
+      type: "json",
+      label: "Brand Keywords",
+      description:
+        'Keywords describing the brand aesthetic (e.g. ["clean", "premium"])',
+      required: false,
+      default: null,
+    },
+    {
+      name: "target_audience",
+      type: "text",
+      label: "Target Audience",
+      description: 'Target audience (e.g. "young professionals", "parents")',
+      required: false,
+      default: null,
+    },
+    {
+      name: "app_screenshots",
+      type: "json",
+      label: "App Screenshots",
+      description:
+        "The app's own existing screenshots (MUST be provided to be placed inside the device mockup)",
+      required: true,
+      default: null,
+      validation: { minLength: 1 },
+    },
+    {
+      name: "batches",
+      type: "json",
+      label: "Batches",
+      description: "Reference screenshot batches — one per screenshot position",
+      required: false,
+      default: null,
+    },
+    {
+      name: "num_screenshots",
+      type: "number",
+      label: "Num Screenshots",
+      description: "",
+      required: false,
+      default: 6,
+      validation: { min: 1, max: 10 },
+    },
+    {
+      name: "aspect_ratio",
+      type: "text",
+      label: "Aspect Ratio",
+      description: "Aspect ratio (9:16 for iPhone)",
+      required: false,
+      default: "9:16",
+    },
+    {
+      name: "image_model",
+      type: "text",
+      label: "Image Model",
+      description: "Image model ID from registry",
+      required: false,
+      default: "nano-banana-2",
+      hidden: true,
+    },
+    {
+      name: "image_model_params",
+      type: "json",
+      label: "Image Model Params",
+      description: "",
+      required: false,
+      default: null,
+      hidden: true,
+    },
+  ],
+};
+
 export const slideshow_to_video: WorkflowDefinition<
   Types.SlideshowToVideoInput,
   Types.SlideshowToVideoOutput
@@ -2272,6 +2499,7 @@ export const workflowRegistry = {
   ruby,
   saa_s_loom,
   saa_s_video,
+  screenshot_generator,
   slideshow_to_video,
   slideshows_pinterest,
   speaking_doctor,
@@ -2305,6 +2533,7 @@ export type WorkflowInputMap = {
   ruby: Types.RubyInput;
   saa_s_loom: Types.SaaSLoomInput;
   saa_s_video: Types.SaaSVideoInput;
+  screenshot_generator: Types.ScreenshotGeneratorInput;
   slideshow_to_video: Types.SlideshowToVideoInput;
   slideshows_pinterest: Types.SlideshowsPinterestInput;
   speaking_doctor: Types.SpeakingDoctorInput;
@@ -2317,6 +2546,7 @@ export type WorkflowOutputMap = {
   ruby: Types.RubyOutput;
   saa_s_loom: Types.SaaSLoomOutput;
   saa_s_video: Types.SaaSVideoOutput;
+  screenshot_generator: Types.ScreenshotGeneratorOutput;
   slideshow_to_video: Types.SlideshowToVideoOutput;
   slideshows_pinterest: Types.SlideshowsPinterestOutput;
   speaking_doctor: Types.SpeakingDoctorOutput;

package/schemas/ScreenshotGeneratorInput.json

@@ -0,0 +1,329 @@
+{
+  "$defs": {
+    "ScreenshotBatch": {
+      "description": "Reference screenshots for a single screenshot position.",
+      "properties": {
+        "position": {
+          "description": "Screenshot position (1-based)",
+          "maximum": 10,
+          "minimum": 1,
+          "title": "Position",
+          "type": "integer"
+        },
+        "headline": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Headline text to display on this screenshot",
+          "title": "Headline"
+        },
+        "sub_headline": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Supporting text below the headline",
+          "title": "Sub Headline"
+        },
+        "feature_description": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "What feature or benefit this screenshot should highlight",
+          "title": "Feature Description"
+        },
+        "reference_urls": {
+          "description": "Reference screenshot URLs from similar apps for this position",
+          "items": {
+            "type": "string"
+          },
+          "title": "Reference Urls",
+          "type": "array"
+        }
+      },
+      "required": [
+        "position"
+      ],
+      "title": "ScreenshotBatch",
+      "type": "object"
+    }
+  },
+  "description": "Input for App Store screenshot generation.",
+  "properties": {
+    "secret_key": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Secret key for authentication (required when WORKFLOW_SECRET_ENABLED=True)",
+      "title": "Secret Key"
+    },
+    "rewrite_enabled": {
+      "default": false,
+      "description": "Make your content appear as fresh, original uploads. Bypasses duplicate detection and AI content filters on social platforms.",
+      "title": "Rewrite Enabled",
+      "type": "boolean"
+    },
+    "rewrite_device": {
+      "anyOf": [
+        {
+          "enum": [
+            "iPhone 17 Pro Max",
+            "iPhone 17 Pro",
+            "iPhone 17 Plus",
+            "iPhone 17",
+            "iPhone 16 Pro Max",
+            "iPhone 16 Pro",
+            "iPhone 16 Plus",
+            "iPhone 16",
+            "iPhone 15 Pro Max",
+            "iPhone 15 Pro",
+            "iPhone 15 Plus",
+            "iPhone 15",
+            "iPhone 14 Pro Max",
+            "iPhone 14 Pro",
+            "iPhone 14 Plus",
+            "iPhone 14",
+            "iPhone 13 Pro Max",
+            "iPhone 13 Pro",
+            "iPhone 13",
+            "iPhone 13 mini",
+            "Ray-Ban Meta Smart Glasses"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Make media appear as if created on this device. Adds authenticity and helps bypass platform detection. Random device if not specified.",
+      "title": "Rewrite Device"
+    },
+    "app_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "App Store URL",
+      "title": "App Url"
+    },
+    "app_id": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Numeric App Store ID",
+      "title": "App Id"
+    },
+    "country": {
+      "default": "us",
+      "description": "Country code for App Store lookup",
+      "title": "Country",
+      "type": "string"
+    },
+    "app_title": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "App title (overrides fetched)",
+      "title": "App Title"
+    },
+    "app_subtitle": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "App subtitle / tagline",
+      "title": "App Subtitle"
+    },
+    "app_description": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "App description (overrides fetched)",
+      "title": "App Description"
+    },
+    "primary_color": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Primary brand color hex (e.g. \"#4A90D9\")",
+      "title": "Primary Color"
+    },
+    "secondary_color": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Secondary brand color hex",
+      "title": "Secondary Color"
+    },
+    "accent_color": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Accent color hex",
+      "title": "Accent Color"
+    },
+    "background_style": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Background style: gradient, solid, abstract, blurred, minimal, dark, light",
+      "title": "Background Style"
+    },
+    "design_style": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Overall design style: modern, bold, playful, corporate, elegant, minimal, vibrant",
+      "title": "Design Style"
+    },
+    "brand_keywords": {
+      "description": "Keywords describing the brand aesthetic (e.g. [\"clean\", \"premium\"])",
+      "items": {
+        "type": "string"
+      },
+      "title": "Brand Keywords",
+      "type": "array"
+    },
+    "target_audience": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Target audience (e.g. \"young professionals\", \"parents\")",
+      "title": "Target Audience"
+    },
+    "app_screenshots": {
+      "description": "The app's own existing screenshots (MUST be provided to be placed inside the device mockup)",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "title": "App Screenshots",
+      "type": "array"
+    },
+    "batches": {
+      "description": "Reference screenshot batches \u2014 one per screenshot position",
+      "items": {
+        "$ref": "#/$defs/ScreenshotBatch"
+      },
+      "title": "Batches",
+      "type": "array"
+    },
+    "num_screenshots": {
+      "default": 6,
+      "maximum": 10,
+      "minimum": 1,
+      "title": "Num Screenshots",
+      "type": "integer"
+    },
+    "aspect_ratio": {
+      "default": "9:16",
+      "description": "Aspect ratio (9:16 for iPhone)",
+      "title": "Aspect Ratio",
+      "type": "string"
+    },
+    "image_model": {
+      "default": "nano-banana-2",
+      "description": "Image model ID from registry",
+      "title": "Image Model",
+      "type": "string"
+    },
+    "image_model_params": {
+      "additionalProperties": true,
+      "title": "Image Model Params",
+      "type": "object"
+    }
+  },
+  "required": [
+    "app_screenshots"
+  ],
+  "title": "ScreenshotGeneratorInput",
+  "type": "object"
+}

package/schemas/ScreenshotGeneratorOutput.json

@@ -0,0 +1,118 @@
+{
+  "$defs": {
+    "GeneratedScreenshot": {
+      "description": "A single generated App Store screenshot.",
+      "properties": {
+        "position": {
+          "description": "Screenshot position (1-based)",
+          "title": "Position",
+          "type": "integer"
+        },
+        "image_url": {
+          "description": "Generated screenshot URL",
+          "title": "Image Url",
+          "type": "string"
+        },
+        "headline": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Headline used",
+          "title": "Headline"
+        },
+        "prompt_used": {
+          "default": "",
+          "description": "Image generation prompt used",
+          "title": "Prompt Used",
+          "type": "string"
+        }
+      },
+      "required": [
+        "position",
+        "image_url"
+      ],
+      "title": "GeneratedScreenshot",
+      "type": "object"
+    }
+  },
+  "description": "Output from the screenshot generator workflow.",
+  "properties": {
+    "screenshots": {
+      "items": {
+        "$ref": "#/$defs/GeneratedScreenshot"
+      },
+      "title": "Screenshots",
+      "type": "array"
+    },
+    "app_title": {
+      "default": "",
+      "title": "App Title",
+      "type": "string"
+    },
+    "app_description": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "App Description"
+    },
+    "total_generated": {
+      "default": 0,
+      "title": "Total Generated",
+      "type": "integer"
+    },
+    "prompts": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Prompts",
+      "type": "array"
+    },
+    "best_reference_app": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Title of the best-rated reference app",
+      "title": "Best Reference App"
+    },
+    "reference_screenshots_used": {
+      "description": "URLs of the screenshots used as visual inspiration",
+      "items": {
+        "type": "string"
+      },
+      "title": "Reference Screenshots Used",
+      "type": "array"
+    },
+    "llm_prompt_sent": {
+      "default": "",
+      "description": "The exact prompt sent to the LLM",
+      "title": "Llm Prompt Sent",
+      "type": "string"
+    },
+    "llm_response_raw": {
+      "default": "",
+      "description": "The raw JSON response from the LLM",
+      "title": "Llm Response Raw",
+      "type": "string"
+    }
+  },
+  "title": "ScreenshotGeneratorOutput",
+  "type": "object"
+}

package/types.ts

@@ -493,6 +493,100 @@ export interface SaaSVideoOutput {
   generation_context?: Record<string, unknown>;
 }
 
+export interface ScreenshotGeneratorInput {
+  /** Secret key for authentication (required when WORKFLOW_SECRET_ENABLED=True) */
+  secret_key?: string | null;
+  /** Make your content appear as fresh, original uploads. Bypasses duplicate detection and AI content filters on social platforms. */
+  rewrite_enabled?: boolean;
+  /** Make media appear as if created on this device. Adds authenticity and helps bypass platform detection. Random device if not specified. */
+  rewrite_device?:
+    | "iPhone 17 Pro Max"
+    | "iPhone 17 Pro"
+    | "iPhone 17 Plus"
+    | "iPhone 17"
+    | "iPhone 16 Pro Max"
+    | "iPhone 16 Pro"
+    | "iPhone 16 Plus"
+    | "iPhone 16"
+    | "iPhone 15 Pro Max"
+    | "iPhone 15 Pro"
+    | "iPhone 15 Plus"
+    | "iPhone 15"
+    | "iPhone 14 Pro Max"
+    | "iPhone 14 Pro"
+    | "iPhone 14 Plus"
+    | "iPhone 14"
+    | "iPhone 13 Pro Max"
+    | "iPhone 13 Pro"
+    | "iPhone 13"
+    | "iPhone 13 mini"
+    | "Ray-Ban Meta Smart Glasses"
+    | null;
+  /** App Store URL */
+  app_url?: string | null;
+  /** Numeric App Store ID */
+  app_id?: string | null;
+  /** Country code for App Store lookup */
+  country?: string;
+  /** App title (overrides fetched) */
+  app_title?: string | null;
+  /** App subtitle / tagline */
+  app_subtitle?: string | null;
+  /** App description (overrides fetched) */
+  app_description?: string | null;
+  /** Primary brand color hex (e.g. "#4A90D9") */
+  primary_color?: string | null;
+  /** Secondary brand color hex */
+  secondary_color?: string | null;
+  /** Accent color hex */
+  accent_color?: string | null;
+  /** Background style: gradient, solid, abstract, blurred, minimal, dark, light */
+  background_style?: string | null;
+  /** Overall design style: modern, bold, playful, corporate, elegant, minimal, vibrant */
+  design_style?: string | null;
+  /** Keywords describing the brand aesthetic (e.g. ["clean", "premium"]) */
+  brand_keywords?: string[];
+  /** Target audience (e.g. "young professionals", "parents") */
+  target_audience?: string | null;
+  /** The app's own existing screenshots (MUST be provided to be placed inside the device mockup) */
+  app_screenshots: string[];
+  /** Reference screenshot batches — one per screenshot position */
+  batches?: {
+    position: number;
+    headline?: string | null;
+    sub_headline?: string | null;
+    feature_description?: string | null;
+    reference_urls?: string[];
+  }[];
+  num_screenshots?: number;
+  /** Aspect ratio (9:16 for iPhone) */
+  aspect_ratio?: string;
+  /** Image model ID from registry */
+  image_model?: string;
+  image_model_params?: Record<string, unknown>;
+}
+
+export interface ScreenshotGeneratorOutput {
+  screenshots?: {
+    position: number;
+    image_url: string;
+    headline?: string | null;
+    prompt_used?: string;
+  }[];
+  app_title?: string;
+  app_description?: string | null;
+  total_generated?: number;
+  prompts?: string[];
+  /** Title of the best-rated reference app */
+  best_reference_app?: string | null;
+  /** URLs of the screenshots used as visual inspiration */
+  reference_screenshots_used?: string[];
+  /** The exact prompt sent to the LLM */
+  llm_prompt_sent?: string;
+  /** The raw JSON response from the LLM */
+  llm_response_raw?: string;
+}
+
 export interface SlideshowToVideoInput {
   /** Secret key for authentication (required when WORKFLOW_SECRET_ENABLED=True) */
   secret_key?: string | null;