@gptmarket/temporal-types 0.0.1

package/client.ts

@@ -0,0 +1,223 @@
+/**
+ * Temporal client utilities for Next.js.
+ * Auto-generated - DO NOT EDIT MANUALLY
+ */
+
+import { Client, Connection, WorkflowHandle } from "@temporalio/client";
+import type { WorkflowProgress, StepProgress, WorkflowStatus } from "./types";
+
+// =============================================================================
+// Configuration
+// =============================================================================
+
+export interface TemporalConfig {
+  host: string;
+  namespace: string;
+  taskQueue: string;
+}
+
+const defaultConfig: TemporalConfig = {
+  host: process.env.TEMPORAL_HOST || "localhost:7233",
+  namespace: process.env.TEMPORAL_NAMESPACE || "default",
+  taskQueue: process.env.TEMPORAL_TASK_QUEUE || "generation-queue",
+};
+
+let _client: Client | null = null;
+let _config: TemporalConfig = defaultConfig;
+
+/**
+ * Configure the Temporal client.
+ * Call this once at app startup if you need custom settings.
+ */
+export function configureTemporalClient(config: Partial<TemporalConfig>): void {
+  _config = { ...defaultConfig, ...config };
+  _client = null; // Reset client to use new config
+}
+
+/**
+ * Get or create the Temporal client (singleton).
+ */
+export async function getTemporalClient(): Promise<Client> {
+  if (!_client) {
+    const connection = await Connection.connect({
+      address: _config.host,
+    });
+
+    _client = new Client({
+      connection,
+      namespace: _config.namespace,
+    });
+  }
+
+  return _client;
+}
+
+/**
+ * Get the current task queue.
+ */
+export function getTaskQueue(): string {
+  return _config.taskQueue;
+}
+
+// =============================================================================
+// Workflow Execution
+// =============================================================================
+
+export interface StartWorkflowResult {
+  workflowId: string;
+}
+
+/**
+ * Start a workflow and return its ID.
+ *
+ * @example
+ * ```ts
+ * const { workflowId } = await startWorkflow('RubyWorkflow', { topic: 'AI news' });
+ * ```
+ */
+export async function startWorkflow<TInput>(
+  workflowName: string,
+  input: TInput,
+  options?: { id?: string; idPrefix?: string },
+): Promise<StartWorkflowResult> {
+  const client = await getTemporalClient();
+  const workflowId =
+    options?.id ||
+    `${options?.idPrefix || workflowName.toLowerCase()}-${randomId()}`;
+
+  await client.workflow.start(workflowName, {
+    taskQueue: _config.taskQueue,
+    workflowId,
+    args: [input],
+  });
+
+  return { workflowId };
+}
+
+/**
+ * Get the current progress of a workflow.
+ */
+export async function getWorkflowProgress(
+  workflowId: string,
+): Promise<WorkflowProgress> {
+  const client = await getTemporalClient();
+  const handle = client.workflow.getHandle(workflowId);
+
+  try {
+    const description = await handle.describe();
+    const executionStatus = description.status.name;
+
+    let status: WorkflowStatus = "pending";
+    let currentStep: StepProgress | null = null;
+    let result: unknown = undefined;
+    let error: string | undefined = undefined;
+
+    if (isWorkflowRunning(executionStatus)) {
+      try {
+        status = await handle.query<WorkflowStatus>("get_status");
+        currentStep = await handle.query<StepProgress>("get_current_step");
+      } catch {
+        status = "running";
+      }
+    } else if (executionStatus === "COMPLETED") {
+      status = "completed";
+      try {
+        result = await handle.result();
+      } catch (e) {
+        error = String(e);
+      }
+    } else if (
+      executionStatus === "FAILED" ||
+      executionStatus === "TERMINATED" ||
+      executionStatus === "TIMED_OUT"
+    ) {
+      status = "failed";
+      error = `Workflow ${executionStatus.toLowerCase()}`;
+    } else if (executionStatus === "CANCELLED") {
+      status = "cancelled";
+    }
+
+    return {
+      workflowId,
+      status,
+      executionStatus,
+      currentStep,
+      result,
+      error,
+    };
+  } catch (e) {
+    return {
+      workflowId,
+      status: "failed",
+      executionStatus: "NOT_FOUND",
+      currentStep: null,
+      error: `Workflow not found: ${String(e)}`,
+    };
+  }
+}
+
+/**
+ * Wait for a workflow to complete and return its result.
+ */
+export async function waitForWorkflow<TResult>(
+  workflowId: string,
+  timeoutMs: number = 300000,
+): Promise<{ result?: TResult; error?: string; timedOut?: boolean }> {
+  const client = await getTemporalClient();
+  const handle = client.workflow.getHandle(workflowId);
+
+  try {
+    const result = await Promise.race([
+      handle.result() as Promise<TResult>,
+      new Promise<never>((_, reject) =>
+        setTimeout(() => reject(new Error("TIMEOUT")), timeoutMs),
+      ),
+    ]);
+    return { result };
+  } catch (e) {
+    const errorStr = String(e);
+    if (errorStr.includes("TIMEOUT")) {
+      return { timedOut: true };
+    }
+    return { error: errorStr };
+  }
+}
+
+/**
+ * Cancel a running workflow.
+ */
+export async function cancelWorkflow(
+  workflowId: string,
+): Promise<{ success: boolean; error?: string }> {
+  const client = await getTemporalClient();
+  const handle = client.workflow.getHandle(workflowId);
+
+  try {
+    await handle.cancel();
+    return { success: true };
+  } catch (e) {
+    return { success: false, error: String(e) };
+  }
+}
+
+/**
+ * Get a handle to an existing workflow.
+ */
+export async function getWorkflowHandle(
+  workflowId: string,
+): Promise<WorkflowHandle> {
+  const client = await getTemporalClient();
+  return client.workflow.getHandle(workflowId);
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+function randomId(): string {
+  return Math.random().toString(36).substring(2, 14);
+}
+
+function isWorkflowRunning(status: string): boolean {
+  return status === "RUNNING" || status === "CONTINUED_AS_NEW";
+}

package/index.ts

@@ -0,0 +1,43 @@
+/**
+ * GPTMarket Temporal Types
+ *
+ * Types, workflow registry, and client utilities for GPTMarket Temporal workflows.
+ *
+ * @example Start a workflow
+ * ```ts
+ * import { startWorkflow, waitForWorkflow } from '@gptmarket/temporal-types/client';
+ * import type { RubyInput, RubyOutput } from '@gptmarket/temporal-types';
+ *
+ * const { workflowId } = await startWorkflow('RubyWorkflow', { topic: 'AI news' });
+ * const { result } = await waitForWorkflow<RubyOutput>(workflowId);
+ * ```
+ *
+ * @example Dynamic form generation
+ * ```ts
+ * import { workflowRegistry } from '@gptmarket/temporal-types';
+ *
+ * const ruby = workflowRegistry.ruby;
+ * ruby.fields.forEach(field => {
+ *   console.log(field.name, field.type, field.options);
+ * });
+ * ```
+ */
+
+// Types
+export * from "./types";
+
+// Workflow registry and definitions
+export * from "./registry";
+
+// Client utilities
+export {
+  configureTemporalClient,
+  getTemporalClient,
+  getTaskQueue,
+  startWorkflow,
+  getWorkflowProgress,
+  waitForWorkflow,
+  cancelWorkflow,
+  getWorkflowHandle,
+} from "./client";
+export type { TemporalConfig, StartWorkflowResult } from "./client";

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@gptmarket/temporal-types",
+  "version": "0.0.1",
+  "description": "TypeScript types, workflow registry, and client utilities for GPTMarket Temporal workflows",
+  "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": "./index.ts",
+    "./types": "./types.ts",
+    "./registry": "./registry.ts",
+    "./client": "./client.ts"
+  },
+  "files": [
+    "index.ts",
+    "types.ts",
+    "registry.ts",
+    "client.ts",
+    "schemas/"
+  ],
+  "peerDependencies": {
+    "@temporalio/client": ">=1.0.0"
+  },
+  "keywords": [
+    "temporal",
+    "gptmarket",
+    "types",
+    "typescript",
+    "workflows"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gptmarket/gptmarket-generator.git"
+  }
+}

package/registry.ts

@@ -0,0 +1,283 @@
+/**
+ * Auto-generated workflow registry for dynamic form generation.
+ * DO NOT EDIT MANUALLY - run `make types`
+ */
+
+import type * as Types from "./types";
+
+// =============================================================================
+// Field Types
+// =============================================================================
+
+export type FieldType =
+  | "text"
+  | "textarea"
+  | "number"
+  | "select"
+  | "checkbox"
+  | "json";
+
+export interface SelectOption {
+  value: string;
+  label: string;
+}
+
+export interface FieldValidation {
+  min?: number;
+  max?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+}
+
+export interface FieldDefinition {
+  name: string;
+  type: FieldType;
+  label: string;
+  description: string;
+  required: boolean;
+  default: unknown;
+  options?: SelectOption[];
+  validation?: FieldValidation;
+  hidden?: boolean;
+}
+
+// =============================================================================
+// Workflow Definition
+// =============================================================================
+
+export interface WorkflowDefinition<TInput = unknown, TOutput = unknown> {
+  id: string;
+  name: string;
+  description: string;
+  workflowClass: string;
+  inputType: string;
+  outputType: string;
+  fields: FieldDefinition[];
+}
+
+// =============================================================================
+// Workflow Definitions
+// =============================================================================
+
+export const ruby: WorkflowDefinition<Types.RubyInput, Types.RubyOutput> = {
+  id: "ruby",
+  name: "Ruby",
+  description: "Ruby - AI Influencer for Short-form Videos.",
+  workflowClass: "RubyWorkflow",
+  inputType: "RubyInput",
+  outputType: "RubyOutput",
+  fields: [
+    {
+      name: "topic",
+      type: "text",
+      label: "Topic",
+      description: "What the influencer is reacting to",
+      required: true,
+      default: null,
+    },
+    {
+      name: "emotion",
+      type: "select",
+      label: "Emotion",
+      description: "Emotion: shocked, scared, surprised, worried, excited",
+      required: false,
+      default: "shocked",
+      options: [
+        { value: "shocked", label: "Shocked" },
+        { value: "scared", label: "Scared" },
+        { value: "surprised", label: "Surprised" },
+        { value: "worried", label: "Worried" },
+        { value: "excited", label: "Excited" },
+      ],
+    },
+    {
+      name: "hook",
+      type: "text",
+      label: "Hook",
+      description: 'Text overlay (e.g., "You won\'t believe this...")',
+      required: false,
+      default: "",
+    },
+    {
+      name: "style",
+      type: "select",
+      label: "Style",
+      description: "Style: realistic or stylized",
+      required: false,
+      default: "realistic",
+      options: [
+        { value: "realistic", label: "Realistic" },
+        { value: "stylized", label: "Stylized" },
+      ],
+    },
+    {
+      name: "gender",
+      type: "select",
+      label: "Gender",
+      description: "Gender: female or male",
+      required: false,
+      default: "female",
+      options: [
+        { value: "female", label: "Female" },
+        { value: "male", label: "Male" },
+      ],
+    },
+    {
+      name: "aspect_ratio",
+      type: "select",
+      label: "Aspect Ratio",
+      description: "Aspect ratio: 9:16, 16:9, 1:1",
+      required: false,
+      default: "9:16",
+      options: [
+        { value: "9:16", label: "9:16" },
+        { value: "16:9", label: "16:9" },
+        { value: "1:1", label: "1:1" },
+      ],
+    },
+    {
+      name: "image_model",
+      type: "text",
+      label: "Image Model",
+      description: "Image model ID from registry",
+      required: false,
+      default: "hidream-fast",
+      hidden: true,
+    },
+    {
+      name: "video_model",
+      type: "text",
+      label: "Video Model",
+      description: "Video model ID from registry",
+      required: false,
+      default: "seedance-1.5-pro",
+      hidden: true,
+    },
+    {
+      name: "image_model_params",
+      type: "json",
+      label: "Image Model Params",
+      description:
+        'Override image model params (e.g., {"speed_mode": "Extra Juiced 🚀"})',
+      required: false,
+      default: null,
+      hidden: true,
+    },
+    {
+      name: "video_model_params",
+      type: "json",
+      label: "Video Model Params",
+      description:
+        'Override video model params (e.g., {"camera_fixed": False})',
+      required: false,
+      default: null,
+      hidden: true,
+    },
+    {
+      name: "slow_motion_factor",
+      type: "number",
+      label: "Slow Motion Factor",
+      description: "Speed factor (0.5 = half speed)",
+      required: false,
+      default: 0.7,
+    },
+    {
+      name: "video_duration",
+      type: "number",
+      label: "Video Duration",
+      description: "Video duration in seconds",
+      required: false,
+      default: 5,
+    },
+  ],
+};
+
+export const slideshows_pinterest: WorkflowDefinition<
+  Types.SlideshowsPinterestInput,
+  Types.SlideshowsPinterestOutput
+> = {
+  id: "slideshows_pinterest",
+  name: "Slideshows Pinterest",
+  description: "Pinterest Slideshow Generator.",
+  workflowClass: "SlideshowsPinterestWorkflow",
+  inputType: "SlideshowsPinterestInput",
+  outputType: "SlideshowsPinterestOutput",
+  fields: [
+    {
+      name: "prompt",
+      type: "textarea",
+      label: "Prompt",
+      description: "User text describing what kind of images they want",
+      required: true,
+      default: null,
+    },
+    {
+      name: "num_images",
+      type: "number",
+      label: "Num Images",
+      description: "Number of images to return",
+      required: false,
+      default: 10,
+      validation: { min: 1, max: 50 },
+    },
+    {
+      name: "num_queries",
+      type: "number",
+      label: "Num Queries",
+      description: "Number of search queries to generate",
+      required: false,
+      default: 3,
+      validation: { min: 1, max: 5 },
+    },
+    {
+      name: "pages_per_query",
+      type: "number",
+      label: "Pages Per Query",
+      description: "Pages to scrape per query",
+      required: false,
+      default: 1,
+      validation: { min: 1, max: 3 },
+    },
+  ],
+};
+
+// =============================================================================
+// Registry
+// =============================================================================
+
+export const workflowRegistry = {
+  ruby,
+  slideshows_pinterest,
+} as const;
+
+export type WorkflowId = keyof typeof workflowRegistry;
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+export function getWorkflow<T extends WorkflowId>(
+  id: T,
+): (typeof workflowRegistry)[T] {
+  return workflowRegistry[id];
+}
+
+export function getAllWorkflows(): WorkflowDefinition[] {
+  return Object.values(workflowRegistry);
+}
+
+export function getWorkflowIds(): WorkflowId[] {
+  return Object.keys(workflowRegistry) as WorkflowId[];
+}
+
+// Type mappings
+export type WorkflowInputMap = {
+  ruby: Types.RubyInput;
+  slideshows_pinterest: Types.SlideshowsPinterestInput;
+};
+
+export type WorkflowOutputMap = {
+  ruby: Types.RubyOutput;
+  slideshows_pinterest: Types.SlideshowsPinterestOutput;
+};

package/schemas/RubyInput.json

@@ -0,0 +1,81 @@
+{
+  "description": "Input for Ruby generation.",
+  "properties": {
+    "topic": {
+      "description": "What the influencer is reacting to",
+      "title": "Topic",
+      "type": "string"
+    },
+    "emotion": {
+      "default": "shocked",
+      "description": "Emotion: shocked, scared, surprised, worried, excited",
+      "title": "Emotion",
+      "type": "string"
+    },
+    "hook": {
+      "default": "",
+      "description": "Text overlay (e.g., \"You won't believe this...\")",
+      "title": "Hook",
+      "type": "string"
+    },
+    "style": {
+      "default": "realistic",
+      "description": "Style: realistic or stylized",
+      "title": "Style",
+      "type": "string"
+    },
+    "gender": {
+      "default": "female",
+      "description": "Gender: female or male",
+      "title": "Gender",
+      "type": "string"
+    },
+    "aspect_ratio": {
+      "default": "9:16",
+      "description": "Aspect ratio: 9:16, 16:9, 1:1",
+      "title": "Aspect Ratio",
+      "type": "string"
+    },
+    "image_model": {
+      "default": "hidream-fast",
+      "description": "Image model ID from registry",
+      "title": "Image Model",
+      "type": "string"
+    },
+    "video_model": {
+      "default": "seedance-1.5-pro",
+      "description": "Video model ID from registry",
+      "title": "Video Model",
+      "type": "string"
+    },
+    "image_model_params": {
+      "additionalProperties": true,
+      "description": "Override image model params (e.g., {\"speed_mode\": \"Extra Juiced \ud83d\ude80\"})",
+      "title": "Image Model Params",
+      "type": "object"
+    },
+    "video_model_params": {
+      "additionalProperties": true,
+      "description": "Override video model params (e.g., {\"camera_fixed\": False})",
+      "title": "Video Model Params",
+      "type": "object"
+    },
+    "slow_motion_factor": {
+      "default": 0.7,
+      "description": "Speed factor (0.5 = half speed)",
+      "title": "Slow Motion Factor",
+      "type": "number"
+    },
+    "video_duration": {
+      "default": 5,
+      "description": "Video duration in seconds",
+      "title": "Video Duration",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "topic"
+  ],
+  "title": "RubyInput",
+  "type": "object"
+}

package/schemas/RubyOutput.json

@@ -0,0 +1,51 @@
+{
+  "description": "Output from Ruby generation.",
+  "properties": {
+    "face_image_url": {
+      "description": "URL of generated face image",
+      "title": "Face Image Url",
+      "type": "string"
+    },
+    "raw_video_url": {
+      "description": "URL of raw video before effects",
+      "title": "Raw Video Url",
+      "type": "string"
+    },
+    "final_video_url": {
+      "description": "URL of final video with all effects",
+      "title": "Final Video Url",
+      "type": "string"
+    },
+    "enhanced_image_prompt": {
+      "description": "The enhanced prompt used for face generation",
+      "title": "Enhanced Image Prompt",
+      "type": "string"
+    },
+    "enhanced_video_prompt": {
+      "description": "The enhanced prompt used for video generation",
+      "title": "Enhanced Video Prompt",
+      "type": "string"
+    },
+    "image_model": {
+      "description": "Image model used",
+      "title": "Image Model",
+      "type": "string"
+    },
+    "video_model": {
+      "description": "Video model used",
+      "title": "Video Model",
+      "type": "string"
+    }
+  },
+  "required": [
+    "face_image_url",
+    "raw_video_url",
+    "final_video_url",
+    "enhanced_image_prompt",
+    "enhanced_video_prompt",
+    "image_model",
+    "video_model"
+  ],
+  "title": "RubyOutput",
+  "type": "object"
+}

package/schemas/SlideshowsPinterestInput.json

@@ -0,0 +1,39 @@
+{
+  "description": "Input for Pinterest slideshow generation.",
+  "properties": {
+    "prompt": {
+      "description": "User text describing what kind of images they want",
+      "title": "Prompt",
+      "type": "string"
+    },
+    "num_images": {
+      "default": 10,
+      "description": "Number of images to return",
+      "maximum": 50,
+      "minimum": 1,
+      "title": "Num Images",
+      "type": "integer"
+    },
+    "num_queries": {
+      "default": 3,
+      "description": "Number of search queries to generate",
+      "maximum": 5,
+      "minimum": 1,
+      "title": "Num Queries",
+      "type": "integer"
+    },
+    "pages_per_query": {
+      "default": 1,
+      "description": "Pages to scrape per query",
+      "maximum": 3,
+      "minimum": 1,
+      "title": "Pages Per Query",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "prompt"
+  ],
+  "title": "SlideshowsPinterestInput",
+  "type": "object"
+}

package/schemas/SlideshowsPinterestOutput.json

@@ -0,0 +1,110 @@
+{
+  "$defs": {
+    "PinterestImage": {
+      "description": "A single Pinterest image result.",
+      "properties": {
+        "id": {
+          "description": "Pin ID",
+          "title": "Id",
+          "type": "string"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Pin title",
+          "title": "Title"
+        },
+        "description": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Pin description",
+          "title": "Description"
+        },
+        "image_url": {
+          "description": "Image URL",
+          "title": "Image Url",
+          "type": "string"
+        },
+        "aspect_ratio": {
+          "description": "Aspect ratio (e.g., 9:16)",
+          "title": "Aspect Ratio",
+          "type": "string"
+        },
+        "image_width": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Image width in pixels",
+          "title": "Image Width"
+        },
+        "image_height": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Image height in pixels",
+          "title": "Image Height"
+        }
+      },
+      "required": [
+        "id",
+        "image_url",
+        "aspect_ratio"
+      ],
+      "title": "PinterestImage",
+      "type": "object"
+    }
+  },
+  "description": "Output from Pinterest slideshow generation.",
+  "properties": {
+    "images": {
+      "description": "List of Pinterest images",
+      "items": {
+        "$ref": "#/$defs/PinterestImage"
+      },
+      "title": "Images",
+      "type": "array"
+    },
+    "queries_used": {
+      "description": "Search queries that were used",
+      "items": {
+        "type": "string"
+      },
+      "title": "Queries Used",
+      "type": "array"
+    },
+    "total_scraped": {
+      "default": 0,
+      "description": "Total pins scraped before filtering",
+      "title": "Total Scraped",
+      "type": "integer"
+    }
+  },
+  "title": "SlideshowsPinterestOutput",
+  "type": "object"
+}

package/types.ts

@@ -0,0 +1,108 @@
+/**
+ * Auto-generated TypeScript types from Pydantic schemas.
+ * DO NOT EDIT MANUALLY - run `make types`
+ */
+
+// =============================================================================
+// Common Types
+// =============================================================================
+
+export type WorkflowStatus =
+  | "pending"
+  | "running"
+  | "completed"
+  | "failed"
+  | "cancelled";
+
+export interface StepProgress {
+  step_id: string;
+  step_name: string;
+  status: WorkflowStatus;
+  progress_pct: number;
+  message: string | null;
+}
+
+export interface WorkflowProgress<TResult = unknown> {
+  workflowId: string;
+  status: WorkflowStatus;
+  executionStatus: string;
+  currentStep: StepProgress | null;
+  result?: TResult;
+  error?: string;
+}
+
+// =============================================================================
+// Workflow Schemas
+// =============================================================================
+
+export interface RubyInput {
+  /** What the influencer is reacting to */
+  topic: string;
+  /** Emotion: shocked, scared, surprised, worried, excited */
+  emotion?: string;
+  /** Text overlay (e.g., "You won't believe this...") */
+  hook?: string;
+  /** Style: realistic or stylized */
+  style?: string;
+  /** Gender: female or male */
+  gender?: string;
+  /** Aspect ratio: 9:16, 16:9, 1:1 */
+  aspect_ratio?: string;
+  /** Image model ID from registry */
+  image_model?: string;
+  /** Video model ID from registry */
+  video_model?: string;
+  /** Override image model params (e.g., {"speed_mode": "Extra Juiced 🚀"}) */
+  image_model_params?: Record<string, unknown>;
+  /** Override video model params (e.g., {"camera_fixed": False}) */
+  video_model_params?: Record<string, unknown>;
+  /** Speed factor (0.5 = half speed) */
+  slow_motion_factor?: number;
+  /** Video duration in seconds */
+  video_duration?: number;
+}
+
+export interface RubyOutput {
+  /** URL of generated face image */
+  face_image_url: string;
+  /** URL of raw video before effects */
+  raw_video_url: string;
+  /** URL of final video with all effects */
+  final_video_url: string;
+  /** The enhanced prompt used for face generation */
+  enhanced_image_prompt: string;
+  /** The enhanced prompt used for video generation */
+  enhanced_video_prompt: string;
+  /** Image model used */
+  image_model: string;
+  /** Video model used */
+  video_model: string;
+}
+
+export interface SlideshowsPinterestInput {
+  /** User text describing what kind of images they want */
+  prompt: string;
+  /** Number of images to return */
+  num_images?: number;
+  /** Number of search queries to generate */
+  num_queries?: number;
+  /** Pages to scrape per query */
+  pages_per_query?: number;
+}
+
+export interface SlideshowsPinterestOutput {
+  /** List of Pinterest images */
+  images?: {
+    id: string;
+    title?: string | null;
+    description?: string | null;
+    image_url: string;
+    aspect_ratio: string;
+    image_width?: number | null;
+    image_height?: number | null;
+  }[];
+  /** Search queries that were used */
+  queries_used?: string[];
+  /** Total pins scraped before filtering */
+  total_scraped?: number;
+}