@wildo-ai/external-connectors-models 1.0.1 → 1.1.0

package/dist/esm/protocols/image.external-connectors-models.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/image.external-connectors-models.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\"\nimport {\n  ExternalProvider_ExchangeProtocol_Configuration_Base,\n  ExternalProvider_ExchangeProtocol_Kind,\n  ExternalProvider_ExchangeProtocol_Profile_Base,\n  ExternalProvider_ExchangeProtocol_Status_BaseSchema,\n} from \"../core/commons.external-connectors-models.schemas\"\nimport {\n  ExternalProvider_OperationContextSchema,\n  ExternalProvider_OperationDefinition_Base,\n} from \"../core/operations.external-connectors-models.schemas\"\n\n//===============================================================\n// Image Provider\n// --------\n// Text-to-image generation providers (gpt-image, DALL·E, Imagen, Flux).\n// Serves the IMAGE artifact modality of the actor-agent system. This is\n// the transport contract; the agent declares `outputModality: IMAGE` and\n// the executor resolves it to an `IMAGE_PROVIDER` binding.\n//\n// Deliberately a SEPARATE protocol from `LLM_PROVIDER` (framework mindset —\n// image generation is already a distinct `EngineCapability.AI_IMAGE_GENERATION`\n// / `BUILTIN_PROVIDER_CAPABILITY.IMAGE_GENERATION`): its I/O is image bytes,\n// and its parameters (size / quality / background) share nothing with LLM\n// sampling (temperature / topP). Overloading LLM would conflate the two.\n//===============================================================\n\nexport enum ImageProvider_Model {\n  // OpenAI — ids + parameter support verified LIVE against the images API (2026-07-16).\n  /**\n   * OpenAI's newest text-to-image model (Apr 2026). Highest quality, but\n   * does NOT support `background: transparent` (verified live: the API\n   * rejects it) — pair it with `Background.AUTO` plus the engine's\n   * `removeSolidBackground` derivation tool when transparency is needed.\n   */\n  OPEN_AI_GPT_IMAGE_2 = \"gpt-image-2\",\n  /**\n   * Transparent-capable upgrade of gpt-image-1 (verified live) — the wired\n   * default for logo generation, whose pipeline is transparent-first.\n   */\n  OPEN_AI_GPT_IMAGE_1_5 = \"gpt-image-1.5\",\n  /** Previous-generation text-to-image model. */\n  OPEN_AI_GPT_IMAGE_1 = \"gpt-image-1\",\n  /** OpenAI DALL·E 3. */\n  OPEN_AI_DALL_E_3 = \"dall-e-3\",\n}\n\nexport enum ImageProvider_OperationKey {\n  /** Text (+ optional reference images) → one or more generated images. */\n  GENERATE_IMAGE = \"image.generateImage\",\n}\n\n// ===============================================================\n// Image generation parameters (the config — NOT LLM sampling)\n// ===============================================================\n\n/**\n * Canvas size of the generated image. `AUTO` lets the provider pick the\n * best fit for the prompt. Values mirror gpt-image-1's supported sizes.\n */\nexport enum ImageProvider_Size {\n  SQUARE_1024 = \"1024x1024\",\n  PORTRAIT_1024_1536 = \"1024x1536\",\n  LANDSCAPE_1536_1024 = \"1536x1024\",\n  AUTO = \"auto\",\n}\n\n/** Rendering quality / cost tier. */\nexport enum ImageProvider_Quality {\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  HIGH = \"high\",\n  AUTO = \"auto\",\n}\n\n/**\n * Background composition. `TRANSPARENT` is the clean default for a logo\n * master — it rasterizes losslessly into favicon / monochrome / dark-light\n * derivations (see `BrandLogoBackgroundTreatment`).\n */\nexport enum ImageProvider_Background {\n  TRANSPARENT = \"transparent\",\n  OPAQUE = \"opaque\",\n  AUTO = \"auto\",\n}\n\nexport enum ImageProvider_OutputFormat {\n  PNG = \"png\",\n  JPEG = \"jpeg\",\n  WEBP = \"webp\",\n}\n\nexport const ImageProvider_OperationModelConfiguration_Schema = z.object({\n  model: z.string(),\n  providerRef: z.string(),\n  size: z.enum(ImageProvider_Size).optional(),\n  quality: z.enum(ImageProvider_Quality).optional(),\n  background: z.enum(ImageProvider_Background).optional(),\n  outputFormat: z.enum(ImageProvider_OutputFormat).optional(),\n  /** Number of images to generate per call (default 1). */\n  n: z.number().int().positive().optional(),\n  /** Random seed for deterministic output where the provider supports it. */\n  seed: z.number().optional(),\n});\nexport type ImageProvider_OperationModelConfiguration = z.infer<typeof ImageProvider_OperationModelConfiguration_Schema>;\n\n// ===============================================================\n// Image Provider Profiles and Configurations\n// ===============================================================\n\nexport type ImageProvider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {\n  baseURL?: string,\n  /** Sizes this provider supports (advertised for validation/UX). */\n  supportedSizes?: ImageProvider_Size[],\n  /** Whether the provider can render a transparent background. */\n  supportsTransparentBackground?: boolean,\n}\n\nexport type ImageProvider_Configuration = ExternalProvider_ExchangeProtocol_Configuration_Base & {\n  customLocation?: string,\n}\n\n// ===============================================================\n// Image Operations Context\n// ===============================================================\n\nexport const ImageProvider_UsageSchema = z.object({\n  /** Number of images actually returned. */\n  imageCount: z.number().int().nonnegative().optional(),\n  /** Provider-reported input tokens, when the model reports them (gpt-image does). */\n  inputTokens: z.number().optional(),\n  /** Provider-reported output (image) tokens, when reported. */\n  outputTokens: z.number().optional(),\n});\nexport type ImageProvider_Usage = z.infer<typeof ImageProvider_UsageSchema>;\n\nexport const ImageProvider_ExecutionTransportMetadataSchema = z.object({\n  protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.IMAGE_PROVIDER),\n  providerRef: z.string(),\n  model: z.string().optional(),\n});\nexport type ImageProvider_ExecutionTransportMetadata = z.infer<typeof ImageProvider_ExecutionTransportMetadataSchema>;\n\nexport const ImageProvider_OperationContext_BaseSchema = ExternalProvider_OperationContextSchema.extend({\n  usage: ImageProvider_UsageSchema.optional(),\n  executionTime: z.number().optional(),\n  finishedAt: z.string().optional(),\n  transport: ImageProvider_ExecutionTransportMetadataSchema.optional(),\n});\nexport type ImageProvider_OperationContext_Base = z.infer<typeof ImageProvider_OperationContext_BaseSchema>;\n\nexport type ImageProvider_OperationDefinitionBase = ExternalProvider_OperationDefinition_Base & {\n  imageModelConfigurationSchema?: z.ZodSchema<any>,\n  operationContextSchema: typeof ImageProvider_OperationContext_BaseSchema,\n  supportedModels?: string[],\n}\n\n// ===============================================================\n// Image I/O Schemas\n// ===============================================================\n\n/** A reference image passed as generation conditioning (URL or data URI). */\nexport const ImageProvider_ReferenceImageSchema = z.object({\n  image: z.union([\n    z.url(),\n    z.string().regex(/^data:image\\/[^;]+;base64,/),\n  ]),\n});\nexport type ImageProvider_ReferenceImage = z.infer<typeof ImageProvider_ReferenceImageSchema>;\n\n// Generate Image Operation\nexport const ImageProvider_GenerateImageInputSchema = z.object({\n  prompt: z.string(),\n  /** Optional conditioning images (edit / variation flows). */\n  referenceImages: z.array(ImageProvider_ReferenceImageSchema).optional(),\n});\nexport type ImageProvider_GenerateImageInput = z.infer<typeof ImageProvider_GenerateImageInputSchema>;\n\n/** One generated image. `base64` is the raw payload; `mediaType` its MIME. */\nexport const ImageProvider_GeneratedImageSchema = z.object({\n  base64: z.string(),\n  mediaType: z.string(),\n  width: z.number().int().positive().optional(),\n  height: z.number().int().positive().optional(),\n});\nexport type ImageProvider_GeneratedImage = z.infer<typeof ImageProvider_GeneratedImageSchema>;\n\nexport const ImageProvider_GenerateImageOutputSchema = z.object({\n  images: z.array(ImageProvider_GeneratedImageSchema),\n  /** Provider-revised prompt, when the model returns one. */\n  revisedPrompt: z.string().optional(),\n});\nexport type ImageProvider_GenerateImageOutput = z.infer<typeof ImageProvider_GenerateImageOutputSchema>;\n\n// ===============================================================\n// STATUS\n// ===============================================================\n\nexport const ImageProvider_StatusSchema = ExternalProvider_ExchangeProtocol_Status_BaseSchema.extend({\n  protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.IMAGE_PROVIDER),\n});\nexport type ImageProvider_Status = z.infer<typeof ImageProvider_StatusSchema>;\n"]}