Output Dev Types File

// CORRECTimport { z } from '@outputai/core';
// WRONG - will cause runtime errorsimport { z } from 'zod';

import { z } from '@outputai/core';
// 1. Workflow Input Schemaexport const WorkflowInputSchema = z.object( {  // Define input fields} );
// 2. Workflow Output Typeexport type WorkflowInput = z.infer<typeof WorkflowInputSchema>;export type WorkflowOutput = /* output type */;
// 3. Step Schemas (for each step)export const StepNameInputSchema = z.object( {  // Step input fields} );
export const StepNameOutputSchema = z.object( {  // Step output fields} );
// 4. Type Exportsexport type StepNameInput = z.infer<typeof StepNameInputSchema>;export type StepNameOutput = z.infer<typeof StepNameOutputSchema>;

// LLM output schema (sent to provider via aiSdk.Output.object()) -- .describe() ONLYconst llmOutputSchema = z.object( {  score: z.number().describe( 'Quality score 0-100' ),  confidence: z.number().describe( 'Confidence 0-1' ),  predictions: z.array( predictionSchema ).describe( 'Exactly 3 predictions' )} );
// Workflow/step validation schema (Zod-only, NOT sent to LLM) -- .min()/.max()/.length() OKconst workflowOutputSchema = z.object( {  score: z.number().min( 0 ).max( 100 ).describe( 'Quality score 0-100' ),  confidence: z.number().min( 0 ).max( 1 ).describe( 'Confidence 0-1' ),  predictions: z.array( predictionSchema ).length( 3 ).describe( 'Exactly 3 predictions' )} );

import { z } from '@outputai/core';
// Stringsconst stringField = z.string();const optionalString = z.string().optional();const stringWithDefault = z.string().default( 'default value' );const describedString = z.string().describe( 'Field description' );
// Numbersconst numberField = z.number();const integerField = z.number().int();const rangedNumber = z.number().min( 1 ).max( 100 ); // runtime only — NOT safe for aiSdk.Output.object() schemas
// Booleansconst booleanField = z.boolean();const defaultBoolean = z.boolean().default( false );
// Enumsconst enumField = z.enum( [ 'option1', 'option2', 'option3' ] );const enumWithDefault = z.enum( [ 'small', 'medium', 'large' ] ).default( 'medium' );

import { z } from '@outputai/core';
// Arraysconst stringArray = z.array( z.string() );const objectArray = z.array( z.object( { id: z.string(), name: z.string() } ) );
// Objectsconst nestedObject = z.object( {  user: z.object( {    id: z.string(),    email: z.string().email()  } ),  settings: z.object( {    notifications: z.boolean()  } )} );
// Union Typesconst flexibleInput = z.union( [  z.string(),  z.array( z.string() )] );
// Recordsconst keyValueMap = z.record( z.string(), z.number() );

import { z } from '@outputai/core';
// String Validationsconst emailField = z.string().email();const urlField = z.string().url();const uuidField = z.string().uuid();const minLengthString = z.string().min( 1 );const maxLengthString = z.string().max( 1000 );
// Number Validationsconst positiveNumber = z.number().positive();const nonNegativeNumber = z.number().nonnegative();const percentageNumber = z.number().min( 0 ).max( 100 );
// Array Validations (runtime only — NOT safe for aiSdk.Output.object() schemas)const nonEmptyArray = z.array( z.string() ).min( 1 );const limitedArray = z.array( z.string() ).max( 10 );const fixedLengthArray = z.array( z.string() ).length( 3 );

import { z } from '@outputai/core';
// ============================================// Workflow Schemas// ============================================
export const WorkflowInputSchema = z.object( {  content: z.string().describe( 'Text content to generate image ideas from' ),  mode: z.enum( [ 'infographic' ] ).default( 'infographic' ).describe( 'Type of image to generate' ),  colorPalette: z.string().optional().describe( 'Color palette preference for the images' ),  artDirection: z.string().optional().describe( 'Art direction or style preference' ),  numberOfIdeas: z.number().min( 1 ).max( 10 ).default( 1 ).describe( 'Number of image concepts to generate' ),  referenceImageUrls: z.union( [    z.string(),    z.array( z.string() )  ] ).optional().describe( 'Reference image URLs for style guidance (max 14)' ),  aspectRatio: z.enum( [ '1:1', '16:9', '9:16', '4:3', '3:4' ] ).default( '1:1' ).describe( 'Aspect ratio for generated images' ),  resolution: z.enum( [ '1K', '2K', '4K' ] ).default( '1K' ).describe( 'Resolution for generated images' ),  numberOfGenerations: z.number().min( 1 ).max( 10 ).default( 1 ).describe( 'Number of images to generate per concept' ),  storageNamespace: z.string().optional().describe( 'S3 folder path for storing images' )} );
export type WorkflowInput = z.infer<typeof WorkflowInputSchema>;export type WorkflowOutput = string[];
// ============================================// Step Schemas// ============================================
export const ValidateReferenceImagesInputSchema = z.object( {  referenceImageUrls: z.array( z.string() ).optional()} );
export const GenerateImageIdeasInputSchema = z.object( {  content: z.string(),  numberOfIdeas: z.number(),  colorPalette: z.string().optional(),  artDirection: z.string().optional()} );
export const GenerateImagesInputSchema = z.object( {  input: z.object( {    referenceImageUrls: z.union( [ z.string(), z.array( z.string() ) ] ).optional(),    aspectRatio: z.enum( [ '1:1', '16:9', '9:16', '4:3', '3:4' ] ),    resolution: z.enum( [ '1K', '2K', '4K' ] ),    numberOfGenerations: z.number(),    storageNamespace: z.string().optional()  } ),  prompt: z.string()} );
// Schema for LLM response validationexport const ImageIdeasSchema = z.object( {  ideas: z.array( z.string() ).describe( 'Array of detailed image prompts for Gemini' )} );
// ============================================// Type Exports// ============================================
export type ValidateReferenceImagesInput = z.infer<typeof ValidateReferenceImagesInputSchema>;export type GenerateImageIdeasInput = z.infer<typeof GenerateImageIdeasInputSchema>;export type GenerateImagesInput = z.infer<typeof GenerateImagesInputSchema>;export type ImageIdeas = z.infer<typeof ImageIdeasSchema>;

// Good - helps with documentation and error messagesz.string().describe( 'User email address for notifications' )
// Avoid - no context for errorsz.string()

// Good - workflow works without optional fieldsnumberOfIdeas: z.number().min( 1 ).max( 10 ).default( 1 )
// Avoid - forces users to provide every fieldnumberOfIdeas: z.number().min( 1 ).max( 10 )

// Workflow input schema (what the user provides)export const WorkflowInputSchema = z.object( { ... } );
// Step schemas (internal data shapes)export const StepNameInputSchema = z.object( { ... } );

// Export schema for runtime validationexport const UserSchema = z.object( { ... } );
// Export type for TypeScript type checkingexport type User = z.infer<typeof UserSchema>;