@slopmachine/core 0.1.25 → 0.2.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type ImageAspectRatio =\n  | \"1:1\"\n  | \"2:3\"\n  | \"3:2\"\n  | \"3:4\"\n  | \"4:3\"\n  | \"4:5\"\n  | \"5:4\"\n  | \"9:16\"\n  | \"16:9\"\n  | \"21:9\";\n\nexport interface SlopImageOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   */\n  bucketId: string;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated image\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * The aspect ratio of the generated image. Defaults to \"1:1\".\n   * Common values: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\".\n   */\n  aspectRatio?: ImageAspectRatio;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A photo of a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The target quality (\"fast\" or \"high\"). Only affects new generations and is ignored for caching.\n   * Ignored if `model` is provided.\n   * Defaults to \"fast\".\n   */\n  quality?: \"fast\" | \"high\";\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * If `true` (or `?raw=true`), bypasses the WebP optimized media and returns the original generated file (e.g., PNG/JPEG).\n   * Defaults to false.\n   */\n  original?: boolean;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\nexport function interpolatePrompt(\n  prompt?: string,\n  variables?: Record<string, string | number | undefined | null>,\n): string {\n  if (!prompt) return \"\";\n  let text = prompt;\n  if (!variables) return text;\n\n  Object.keys(variables).forEach((key) => {\n    const value = variables[key];\n    if (value !== undefined && value !== null) {\n      text = text.replace(new RegExp(`\\\\{${key}\\\\}`, \"g\"), String(value));\n    }\n  });\n  return text;\n}\n\n/**\n * Builds a URL to render or retrieve an image from Slop Machine.\n *\n * @param options - Configuration options for the image generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildImageUrl(options: SlopImageOptions): string {\n  const {\n    bucketId,\n    version,\n    resultId,\n    aspectRatio = \"1:1\",\n    quality = \"fast\",\n    variables = {},\n    baseUrl = \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderImage\",\n    original,\n    attachments,\n  } = options;\n\n  const params = new URLSearchParams();\n  params.set(\"bucketId\", bucketId);\n\n  if (!resultId) {\n    if (aspectRatio) {\n      params.set(\"aspectRatio\", aspectRatio);\n    }\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (quality && quality !== \"fast\") {\n      params.set(\"quality\", quality);\n    } else if (quality === \"fast\") {\n      params.set(\"quality\", \"fast\");\n    }\n\n    if (original) {\n      params.set(\"original\", \"true\");\n    }\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${baseUrl}?${params.toString()}`;\n}\n\n/**\n * Preloads an image from Slop Machine into the browser's cache.\n * Useful for ensuring images are ready before displaying them.\n *\n * @param options - Configuration options for the image generation.\n * @returns A promise that resolves when the image has been loaded.\n */\nexport function preloadImage(options: SlopImageOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    const img = new Image();\n    img.onload = () => resolve();\n    img.onerror = (err) => reject(err);\n    img.src = buildImageUrl(options);\n  });\n}\n\nexport type VideoAspectRatio = \"9:16\" | \"16:9\";\n\nexport interface SlopVideoOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   */\n  bucketId: string;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated video\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * The aspect ratio of the generated video. Defaults to \"16:9\".\n   * Common values: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\".\n   */\n  aspectRatio?: VideoAspectRatio;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A video of a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The duration of the generated video in seconds.\n   * Must be between 4 and 8. Defaults to 4.\n   */\n  duration?: number;\n  /**\n   * The target quality (\"fast\" or \"high\"). Only affects new generations and is ignored for caching.\n   * Ignored if `model` is provided.\n   * Defaults to \"fast\".\n   */\n  quality?: \"fast\" | \"high\";\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * If `true` (or `?raw=true`), bypasses the WebP optimized media and returns the original generated file.\n   * Defaults to false.\n   */\n  original?: boolean;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\n/**\n * Builds a URL to render or retrieve a video from Slop Machine.\n *\n * @param options - Configuration options for the video generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildVideoUrl(options: SlopVideoOptions): string {\n  const {\n    bucketId,\n    version,\n    resultId,\n    aspectRatio = \"16:9\",\n    quality = \"fast\",\n    variables = {},\n    duration = 4,\n    baseUrl = \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderVideo\",\n    original,\n    attachments,\n  } = options;\n\n  const params = new URLSearchParams();\n  params.set(\"bucketId\", bucketId);\n\n  if (!resultId) {\n    if (aspectRatio) {\n      params.set(\"aspectRatio\", aspectRatio);\n    }\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (duration) {\n      params.set(\"duration\", String(duration));\n    }\n    if (quality) {\n      params.set(\"quality\", quality);\n    }\n\n    if (original) {\n      params.set(\"original\", \"true\");\n    }\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${baseUrl}?${params.toString()}`;\n}\n\n/**\n * Preloads a video from Slop Machine into the browser's cache.\n * Useful for ensuring videos are ready before displaying them.\n *\n * @param options - Configuration options for the video generation.\n * @returns A promise that resolves when the video preload request has been initiated.\n */\nexport function preloadVideo(options: SlopVideoOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    // We can just fetch the URL to preload it into the browser's cache.\n    // We use no-cors to avoid CORS errors for simple preloads\n    fetch(buildVideoUrl(options), { mode: \"no-cors\" })\n      .then(() => resolve())\n      .catch((err) => reject(err));\n  });\n}\n\nexport interface SlopTextOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   */\n  bucketId: string;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated text\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A story about a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\n/**\n * Builds a URL to render or retrieve text from Slop Machine.\n *\n * @param options - Configuration options for the text generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildTextUrl(options: SlopTextOptions): string {\n  const {\n    bucketId,\n    version,\n    resultId,\n    variables = {},\n    baseUrl = \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderText\",\n    attachments,\n  } = options;\n\n  const params = new URLSearchParams();\n  params.set(\"bucketId\", bucketId);\n\n  if (!resultId) {\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (resultId) {\n      params.set(\"resultId\", resultId);\n    }\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${baseUrl}?${params.toString()}`;\n}\n\n/**\n * Preloads text from Slop Machine into the browser's cache.\n * Useful for ensuring text is ready before displaying it.\n *\n * @param options - Configuration options for the text generation.\n * @returns A promise that resolves when the text preload request has been initiated.\n */\nexport function preloadText(options: SlopTextOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    // Fetch the URL to preload it into the browser's cache.\n    // We use no-cors to avoid CORS errors for simple preloads\n    fetch(buildTextUrl(options), { mode: \"no-cors\" })\n      .then(() => resolve())\n      .catch((err) => reject(err));\n  });\n}\n\n/**\n * Uploads a base64 encoded file as a temporary attachment to be used in generation requests.\n *\n * @param base64 - The base64 encoded file data (without the data:mime/type;base64, prefix).\n * @param mimeType - The MIME type of the file.\n * @returns A promise that resolves to an object containing the URL of the uploaded attachment.\n */\nexport async function uploadTempAttachment(\n  base64: string,\n  mimeType: string,\n): Promise<{ url: string }> {\n  const response = await fetch(\n    \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/uploadTempAttachment\",\n    {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ data: { base64, mimeType } }),\n    },\n  );\n  if (!response.ok) {\n    throw new Error(`Failed to upload attachment: ${response.statusText}`);\n  }\n  const json = await response.json();\n  if (json.error) {\n    throw new Error(\n      `Failed to upload attachment: ${json.error.message || JSON.stringify(json.error)}`,\n    );\n  }\n  return { url: json.result.url };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { AspectRatio as ImageAspectRatio, VideoAspectRatio } from \"@pixerate/schemas\";\nexport type { ImageAspectRatio, VideoAspectRatio };\n\nexport interface PipelineStepResult {\n  stepId: string;\n  stepName?: string;\n  type: string;\n  outputUrl?: string;\n  outputText?: string;\n  outputData?: any;\n  computeTimeMs?: number;\n  fuelCost?: number;\n  error?: string;\n}\n\nexport interface PipelineResult {\n  id: string;\n  pipelineId: string;\n  siloId: string;\n  url?: string;\n  text?: string;\n  data?: any;\n  resultType: string;\n  status: \"completed\" | \"failed\" | \"pending\";\n  stepResults: PipelineStepResult[];\n  totalComputeTimeMs: number;\n  totalFuelCost: number;\n  metadata?: Record<string, any>;\n  timestamp: any;\n  error?: string;\n}\n\nexport interface SlopPipelineOptions {\n  /**\n   * The unique identifier of the pipeline to execute.\n   */\n  pipelineId: string;\n  /**\n   * Optional silo identifier for direct pipeline path resolution.\n   */\n  siloId?: string;\n  /**\n   * Dynamic runtime prompt to feed into the pipeline.\n   */\n  prompt?: string;\n  /**\n   * Variables to interpolate into prompt or step configs.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * Arbitrary user metadata to attach to the pipeline result document.\n   */\n  metadata?: Record<string, any>;\n  /**\n   * Whether to wait for full execution (default true) or return a job ID immediately.\n   */\n  sync?: boolean;\n  /**\n   * Whether to redirect to the primary media output URL upon completion.\n   */\n  redirect?: boolean;\n  /**\n   * Result ID to retrieve a specific previously generated result.\n   */\n  resultId?: string;\n  /**\n   * Base URL for the renderPipeline cloud function endpoint.\n   */\n  baseUrl?: string;\n}\n\nexport interface ExecutePipelineOptions {\n  /**\n   * The unique identifier of the pipeline to execute.\n   */\n  pipelineId: string;\n  /**\n   * Optional silo identifier for direct pipeline path resolution.\n   */\n  siloId?: string;\n  /**\n   * Dynamic runtime prompt to feed into the pipeline.\n   */\n  prompt?: string;\n  /**\n   * Variables to interpolate into prompt or step configs.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * Arbitrary user metadata to attach to the pipeline result document.\n   */\n  metadata?: Record<string, any>;\n  /**\n   * Base URL for the renderPipeline cloud function endpoint.\n   */\n  baseUrl?: string;\n}\n\nexport interface SlopImageOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   * Required when using a bucket unless pipelineId is provided.\n   */\n  bucketId?: string;\n  /**\n   * The unique identifier of your Slop Machine pipeline.\n   * Required when targeting a pipeline instead of a bucket.\n   */\n  pipelineId?: string;\n  /**\n   * Optional silo identifier.\n   */\n  siloId?: string;\n  /**\n   * Dynamic runtime prompt (used when targeting a pipeline).\n   */\n  prompt?: string;\n  /**\n   * Arbitrary user metadata to attach to the generation request / result document.\n   */\n  metadata?: Record<string, any>;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated image\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * The aspect ratio of the generated image. Defaults to \"1:1\".\n   * Common values: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\".\n   */\n  aspectRatio?: ImageAspectRatio;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A photo of a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The target quality (\"fast\" or \"high\"). Only affects new generations and is ignored for caching.\n   * Ignored if `model` is provided.\n   * Defaults to \"fast\".\n   */\n  quality?: \"fast\" | \"high\";\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * If `true` (or `?raw=true`), bypasses the WebP optimized media and returns the original generated file (e.g., PNG/JPEG).\n   * Defaults to false.\n   */\n  original?: boolean;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\nexport function interpolatePrompt(\n  prompt?: string,\n  variables?: Record<string, string | number | undefined | null>,\n): string {\n  if (!prompt) return \"\";\n  let text = prompt;\n  if (!variables) return text;\n\n  Object.keys(variables).forEach((key) => {\n    const value = variables[key];\n    if (value !== undefined && value !== null) {\n      text = text.replace(new RegExp(`\\\\{${key}\\\\}`, \"g\"), String(value));\n    }\n  });\n  return text;\n}\n\n/**\n * Builds a URL to render or retrieve an image from Slop Machine.\n *\n * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).\n *\n * @param options - Configuration options for the image generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildImageUrl(options: SlopImageOptions): string {\n  const {\n    bucketId,\n    pipelineId,\n    siloId,\n    prompt,\n    metadata,\n    version,\n    resultId,\n    aspectRatio = \"1:1\",\n    quality = \"fast\",\n    variables = {},\n    baseUrl,\n    original,\n    attachments,\n  } = options;\n\n  if (pipelineId) {\n    const endpoint =\n      baseUrl ||\n      \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline\";\n    const params = new URLSearchParams();\n    params.set(\"pipelineId\", pipelineId);\n    params.set(\"redirect\", \"true\");\n\n    if (siloId) params.set(\"siloId\", siloId);\n    if (prompt) params.set(\"prompt\", prompt);\n    if (resultId) params.set(\"resultId\", resultId);\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n\n    return `${endpoint}?${params.toString()}`;\n  }\n\n  const endpoint =\n    baseUrl ||\n    \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderImage\";\n  const params = new URLSearchParams();\n  if (bucketId) {\n    params.set(\"bucketId\", bucketId);\n  }\n\n  if (!resultId) {\n    if (aspectRatio) {\n      params.set(\"aspectRatio\", aspectRatio);\n    }\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (quality && quality !== \"fast\") {\n      params.set(\"quality\", quality);\n    } else if (quality === \"fast\") {\n      params.set(\"quality\", \"fast\");\n    }\n\n    if (original) {\n      params.set(\"original\", \"true\");\n    }\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${endpoint}?${params.toString()}`;\n}\n\n/**\n * Preloads an image from Slop Machine into the browser's cache.\n * Useful for ensuring images are ready before displaying them.\n *\n * @param options - Configuration options for the image generation.\n * @returns A promise that resolves when the image has been loaded.\n */\nexport function preloadImage(options: SlopImageOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    const img = new Image();\n    img.onload = () => resolve();\n    img.onerror = (err) => reject(err);\n    img.src = buildImageUrl(options);\n  });\n}\n\nexport interface SlopVideoOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   * Required when using a bucket unless pipelineId is provided.\n   */\n  bucketId?: string;\n  /**\n   * The unique identifier of your Slop Machine pipeline.\n   * Required when targeting a pipeline instead of a bucket.\n   */\n  pipelineId?: string;\n  /**\n   * Optional silo identifier.\n   */\n  siloId?: string;\n  /**\n   * Dynamic runtime prompt (used when targeting a pipeline).\n   */\n  prompt?: string;\n  /**\n   * Arbitrary user metadata to attach to the generation request / result document.\n   */\n  metadata?: Record<string, any>;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated video\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * The aspect ratio of the generated video. Defaults to \"16:9\".\n   * Common values: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\".\n   */\n  aspectRatio?: VideoAspectRatio;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A video of a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The duration of the generated video in seconds.\n   * Must be between 4 and 8. Defaults to 4.\n   */\n  duration?: number;\n  /**\n   * The target quality (\"fast\" or \"high\"). Only affects new generations and is ignored for caching.\n   * Ignored if `model` is provided.\n   * Defaults to \"fast\".\n   */\n  quality?: \"fast\" | \"high\";\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * If `true` (or `?raw=true`), bypasses the WebP optimized media and returns the original generated file.\n   * Defaults to false.\n   */\n  original?: boolean;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\n/**\n * Builds a URL to render or retrieve a video from Slop Machine.\n *\n * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).\n *\n * @param options - Configuration options for the video generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildVideoUrl(options: SlopVideoOptions): string {\n  const {\n    bucketId,\n    pipelineId,\n    siloId,\n    prompt,\n    metadata,\n    version,\n    resultId,\n    aspectRatio = \"16:9\",\n    quality = \"fast\",\n    variables = {},\n    duration = 4,\n    baseUrl,\n    original,\n    attachments,\n  } = options;\n\n  if (pipelineId) {\n    const endpoint =\n      baseUrl ||\n      \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline\";\n    const params = new URLSearchParams();\n    params.set(\"pipelineId\", pipelineId);\n    params.set(\"redirect\", \"true\");\n\n    if (siloId) params.set(\"siloId\", siloId);\n    if (prompt) params.set(\"prompt\", prompt);\n    if (resultId) params.set(\"resultId\", resultId);\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n\n    return `${endpoint}?${params.toString()}`;\n  }\n\n  const endpoint =\n    baseUrl ||\n    \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderVideo\";\n  const params = new URLSearchParams();\n  if (bucketId) {\n    params.set(\"bucketId\", bucketId);\n  }\n\n  if (!resultId) {\n    if (aspectRatio) {\n      params.set(\"aspectRatio\", aspectRatio);\n    }\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (duration) {\n      params.set(\"duration\", String(duration));\n    }\n    if (quality) {\n      params.set(\"quality\", quality);\n    }\n\n    if (original) {\n      params.set(\"original\", \"true\");\n    }\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${endpoint}?${params.toString()}`;\n}\n\n/**\n * Preloads a video from Slop Machine into the browser's cache.\n * Useful for ensuring videos are ready before displaying them.\n *\n * @param options - Configuration options for the video generation.\n * @returns A promise that resolves when the video preload request has been initiated.\n */\nexport function preloadVideo(options: SlopVideoOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    fetch(buildVideoUrl(options), { mode: \"no-cors\" })\n      .then(() => resolve())\n      .catch((err) => reject(err));\n  });\n}\n\nexport interface SlopTextOptions {\n  /**\n   * The unique identifier of your Slop Machine bucket.\n   * Required when using a bucket unless pipelineId is provided.\n   */\n  bucketId?: string;\n  /**\n   * The unique identifier of your Slop Machine pipeline.\n   * Required when targeting a pipeline instead of a bucket.\n   */\n  pipelineId?: string;\n  /**\n   * Optional silo identifier.\n   */\n  siloId?: string;\n  /**\n   * Dynamic runtime prompt (used when targeting a pipeline).\n   */\n  prompt?: string;\n  /**\n   * Arbitrary user metadata to attach to the generation request / result document.\n   */\n  metadata?: Record<string, any>;\n  /**\n   * The specific version of the prompt/settings to use.\n   * If omitted, the latest version will be used.\n   */\n  version?: number;\n  /**\n   * Result ID to retrieve a specific previously generated text\n   * instead of generating a new one.\n   */\n  resultId?: string;\n  /**\n   * Dynamic variables to interpolate into the prompt.\n   * E.g., if prompt is \"A story about a {color} dog\", pass { color: \"brown\" }.\n   */\n  variables?: Record<string, string | number | undefined | null>;\n  /**\n   * The base URL for the Slop Machine API.\n   * Defaults to the production URL. Useful for testing against local deployments.\n   */\n  baseUrl?: string;\n  /**\n   * Array of attachment URLs to include with the request.\n   */\n  attachments?: string[];\n}\n\n/**\n * Builds a URL to render or retrieve text from Slop Machine.\n *\n * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).\n *\n * @param options - Configuration options for the text generation.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildTextUrl(options: SlopTextOptions): string {\n  const {\n    bucketId,\n    pipelineId,\n    siloId,\n    prompt,\n    metadata,\n    version,\n    resultId,\n    variables = {},\n    baseUrl,\n    attachments,\n  } = options;\n\n  if (pipelineId) {\n    const endpoint =\n      baseUrl ||\n      \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline\";\n    const params = new URLSearchParams();\n    params.set(\"pipelineId\", pipelineId);\n    params.set(\"sync\", \"true\");\n\n    if (siloId) params.set(\"siloId\", siloId);\n    if (prompt) params.set(\"prompt\", prompt);\n    if (resultId) params.set(\"resultId\", resultId);\n\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n\n    return `${endpoint}?${params.toString()}`;\n  }\n\n  const endpoint =\n    baseUrl ||\n    \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderText\";\n  const params = new URLSearchParams();\n  if (bucketId) {\n    params.set(\"bucketId\", bucketId);\n  }\n\n  if (!resultId) {\n    if (version) {\n      params.set(\"version\", String(version));\n    }\n    if (Object.keys(variables).length > 0) {\n      params.set(\"variables\", JSON.stringify(variables));\n    }\n    if (metadata && Object.keys(metadata).length > 0) {\n      params.set(\"metadata\", JSON.stringify(metadata));\n    }\n    if (attachments && attachments.length > 0) {\n      params.set(\"attachments\", JSON.stringify(attachments));\n    }\n  } else {\n    params.set(\"resultId\", resultId);\n  }\n\n  return `${endpoint}?${params.toString()}`;\n}\n\n/**\n * Preloads text from Slop Machine into the browser's cache.\n * Useful for ensuring text is ready before displaying it.\n *\n * @param options - Configuration options for the text generation.\n * @returns A promise that resolves when the text preload request has been initiated.\n */\nexport function preloadText(options: SlopTextOptions): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof window === \"undefined\") {\n      resolve();\n      return;\n    }\n\n    fetch(buildTextUrl(options), { mode: \"no-cors\" })\n      .then(() => resolve())\n      .catch((err) => reject(err));\n  });\n}\n\n/**\n * Builds a URL to execute or inspect a multi-step Pipeline from Slop Machine.\n *\n * @param options - Configuration options for the pipeline execution.\n * @returns A string containing the fully constructed URL.\n */\nexport function buildPipelineUrl(options: SlopPipelineOptions): string {\n  const {\n    pipelineId,\n    siloId,\n    prompt,\n    variables = {},\n    metadata = {},\n    sync = true,\n    redirect = false,\n    resultId,\n    baseUrl = \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline\",\n  } = options;\n\n  const params = new URLSearchParams();\n  params.set(\"pipelineId\", pipelineId);\n\n  if (siloId) params.set(\"siloId\", siloId);\n  if (prompt) params.set(\"prompt\", prompt);\n  if (resultId) params.set(\"resultId\", resultId);\n  if (sync !== undefined) params.set(\"sync\", String(sync));\n  if (redirect) params.set(\"redirect\", \"true\");\n\n  if (Object.keys(variables).length > 0) {\n    params.set(\"variables\", JSON.stringify(variables));\n  }\n  if (Object.keys(metadata).length > 0) {\n    params.set(\"metadata\", JSON.stringify(metadata));\n  }\n\n  return `${baseUrl}?${params.toString()}`;\n}\n\n/**\n * Executes a Slop Machine multi-step Pipeline programmatically and returns the full typed result payload.\n *\n * @param options - Execution parameters including the pipelineId and runtime prompt/variables/metadata.\n * @returns A promise resolving to the completed PipelineResult document.\n */\nexport async function executePipeline(\n  options: ExecutePipelineOptions,\n): Promise<PipelineResult> {\n  const {\n    pipelineId,\n    siloId,\n    prompt,\n    variables,\n    metadata,\n    baseUrl = \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline\",\n  } = options;\n\n  const response = await fetch(baseUrl, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      pipelineId,\n      ...(siloId ? { siloId } : {}),\n      ...(prompt ? { prompt } : {}),\n      variables,\n      metadata,\n      sync: true,\n    }),\n  });\n\n  if (!response.ok) {\n    let errorDetail = response.statusText;\n    try {\n      const errorJson = await response.json();\n      if (errorJson.error) {\n        errorDetail = errorJson.error;\n      }\n    } catch {\n      // Use statusText\n    }\n    throw new Error(\n      `Pipeline execution failed (${response.status}): ${errorDetail}`,\n    );\n  }\n\n  return (await response.json()) as PipelineResult;\n}\n\n/**\n * Uploads a base64 encoded file as a temporary attachment to be used in generation requests.\n *\n * @param base64 - The base64 encoded file data (without the data:mime/type;base64, prefix).\n * @param mimeType - The MIME type of the file.\n * @returns A promise that resolves to an object containing the URL of the uploaded attachment.\n */\nexport async function uploadTempAttachment(\n  base64: string,\n  mimeType: string,\n): Promise<{ url: string }> {\n  const response = await fetch(\n    \"https://us-central1-slopmachine-12bfb.cloudfunctions.net/uploadTempAttachment\",\n    {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ data: { base64, mimeType } }),\n    },\n  );\n  if (!response.ok) {\n    throw new Error(`Failed to upload attachment: ${response.statusText}`);\n  }\n  const json = await response.json();\n  if (json.error) {\n    throw new Error(\n      `Failed to upload attachment: ${json.error.message || JSON.stringify(json.error)}`,\n    );\n  }\n  return { url: json.result.url };\n}\n"],"mappings":"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","names":["endpoint","params"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slopmachine/core",
-  "version": "0.1.25",
+  "version": "0.2.0",
   "description": "The official Core / VanillaJS SDK for Slop Machine",
   "llms": "https://docs.slopmachine.dev/llms.txt",
   "llmsFull": "https://docs.slopmachine.dev/llms-full.txt",
@@ -27,5 +27,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },
+  "dependencies": {
+    "@pixerate/schemas": "^1.1.0"
+  },
   "license": "MIT"
 }

package/src/index.ts

@@ -1,20 +1,124 @@
-export type ImageAspectRatio =
-  | "1:1"
-  | "2:3"
-  | "3:2"
-  | "3:4"
-  | "4:3"
-  | "4:5"
-  | "5:4"
-  | "9:16"
-  | "16:9"
-  | "21:9";
+import { AspectRatio as ImageAspectRatio, VideoAspectRatio } from "@pixerate/schemas";
+export type { ImageAspectRatio, VideoAspectRatio };
+
+export interface PipelineStepResult {
+  stepId: string;
+  stepName?: string;
+  type: string;
+  outputUrl?: string;
+  outputText?: string;
+  outputData?: any;
+  computeTimeMs?: number;
+  fuelCost?: number;
+  error?: string;
+}
+
+export interface PipelineResult {
+  id: string;
+  pipelineId: string;
+  siloId: string;
+  url?: string;
+  text?: string;
+  data?: any;
+  resultType: string;
+  status: "completed" | "failed" | "pending";
+  stepResults: PipelineStepResult[];
+  totalComputeTimeMs: number;
+  totalFuelCost: number;
+  metadata?: Record<string, any>;
+  timestamp: any;
+  error?: string;
+}
+
+export interface SlopPipelineOptions {
+  /**
+   * The unique identifier of the pipeline to execute.
+   */
+  pipelineId: string;
+  /**
+   * Optional silo identifier for direct pipeline path resolution.
+   */
+  siloId?: string;
+  /**
+   * Dynamic runtime prompt to feed into the pipeline.
+   */
+  prompt?: string;
+  /**
+   * Variables to interpolate into prompt or step configs.
+   */
+  variables?: Record<string, string | number | undefined | null>;
+  /**
+   * Arbitrary user metadata to attach to the pipeline result document.
+   */
+  metadata?: Record<string, any>;
+  /**
+   * Whether to wait for full execution (default true) or return a job ID immediately.
+   */
+  sync?: boolean;
+  /**
+   * Whether to redirect to the primary media output URL upon completion.
+   */
+  redirect?: boolean;
+  /**
+   * Result ID to retrieve a specific previously generated result.
+   */
+  resultId?: string;
+  /**
+   * Base URL for the renderPipeline cloud function endpoint.
+   */
+  baseUrl?: string;
+}
+
+export interface ExecutePipelineOptions {
+  /**
+   * The unique identifier of the pipeline to execute.
+   */
+  pipelineId: string;
+  /**
+   * Optional silo identifier for direct pipeline path resolution.
+   */
+  siloId?: string;
+  /**
+   * Dynamic runtime prompt to feed into the pipeline.
+   */
+  prompt?: string;
+  /**
+   * Variables to interpolate into prompt or step configs.
+   */
+  variables?: Record<string, string | number | undefined | null>;
+  /**
+   * Arbitrary user metadata to attach to the pipeline result document.
+   */
+  metadata?: Record<string, any>;
+  /**
+   * Base URL for the renderPipeline cloud function endpoint.
+   */
+  baseUrl?: string;
+}
 
 export interface SlopImageOptions {
   /**
    * The unique identifier of your Slop Machine bucket.
+   * Required when using a bucket unless pipelineId is provided.
+   */
+  bucketId?: string;
+  /**
+   * The unique identifier of your Slop Machine pipeline.
+   * Required when targeting a pipeline instead of a bucket.
+   */
+  pipelineId?: string;
+  /**
+   * Optional silo identifier.
    */
-  bucketId: string;
+  siloId?: string;
+  /**
+   * Dynamic runtime prompt (used when targeting a pipeline).
+   */
+  prompt?: string;
+  /**
+   * Arbitrary user metadata to attach to the generation request / result document.
+   */
+  metadata?: Record<string, any>;
   /**
    * The specific version of the prompt/settings to use.
    * If omitted, the latest version will be used.
@@ -77,24 +181,57 @@ export function interpolatePrompt(
 /**
  * Builds a URL to render or retrieve an image from Slop Machine.
  *
+ * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).
+ *
  * @param options - Configuration options for the image generation.
  * @returns A string containing the fully constructed URL.
  */
 export function buildImageUrl(options: SlopImageOptions): string {
   const {
     bucketId,
+    pipelineId,
+    siloId,
+    prompt,
+    metadata,
     version,
     resultId,
     aspectRatio = "1:1",
     quality = "fast",
     variables = {},
-    baseUrl = "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderImage",
+    baseUrl,
     original,
     attachments,
   } = options;
 
+  if (pipelineId) {
+    const endpoint =
+      baseUrl ||
+      "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline";
+    const params = new URLSearchParams();
+    params.set("pipelineId", pipelineId);
+    params.set("redirect", "true");
+
+    if (siloId) params.set("siloId", siloId);
+    if (prompt) params.set("prompt", prompt);
+    if (resultId) params.set("resultId", resultId);
+
+    if (Object.keys(variables).length > 0) {
+      params.set("variables", JSON.stringify(variables));
+    }
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
+
+    return `${endpoint}?${params.toString()}`;
+  }
+
+  const endpoint =
+    baseUrl ||
+    "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderImage";
   const params = new URLSearchParams();
-  params.set("bucketId", bucketId);
+  if (bucketId) {
+    params.set("bucketId", bucketId);
+  }
 
   if (!resultId) {
     if (aspectRatio) {
@@ -117,6 +254,10 @@ export function buildImageUrl(options: SlopImageOptions): string {
       params.set("variables", JSON.stringify(variables));
     }
 
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
+
     if (attachments && attachments.length > 0) {
       params.set("attachments", JSON.stringify(attachments));
     }
@@ -124,7 +265,7 @@ export function buildImageUrl(options: SlopImageOptions): string {
     params.set("resultId", resultId);
   }
 
-  return `${baseUrl}?${params.toString()}`;
+  return `${endpoint}?${params.toString()}`;
 }
 
 /**
@@ -148,13 +289,29 @@ export function preloadImage(options: SlopImageOptions): Promise<void> {
   });
 }
 
-export type VideoAspectRatio = "9:16" | "16:9";
-
 export interface SlopVideoOptions {
   /**
    * The unique identifier of your Slop Machine bucket.
+   * Required when using a bucket unless pipelineId is provided.
+   */
+  bucketId?: string;
+  /**
+   * The unique identifier of your Slop Machine pipeline.
+   * Required when targeting a pipeline instead of a bucket.
+   */
+  pipelineId?: string;
+  /**
+   * Optional silo identifier.
+   */
+  siloId?: string;
+  /**
+   * Dynamic runtime prompt (used when targeting a pipeline).
+   */
+  prompt?: string;
+  /**
+   * Arbitrary user metadata to attach to the generation request / result document.
    */
-  bucketId: string;
+  metadata?: Record<string, any>;
   /**
    * The specific version of the prompt/settings to use.
    * If omitted, the latest version will be used.
@@ -205,25 +362,58 @@ export interface SlopVideoOptions {
 /**
  * Builds a URL to render or retrieve a video from Slop Machine.
  *
+ * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).
+ *
  * @param options - Configuration options for the video generation.
  * @returns A string containing the fully constructed URL.
  */
 export function buildVideoUrl(options: SlopVideoOptions): string {
   const {
     bucketId,
+    pipelineId,
+    siloId,
+    prompt,
+    metadata,
     version,
     resultId,
     aspectRatio = "16:9",
     quality = "fast",
     variables = {},
     duration = 4,
-    baseUrl = "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderVideo",
+    baseUrl,
     original,
     attachments,
   } = options;
 
+  if (pipelineId) {
+    const endpoint =
+      baseUrl ||
+      "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline";
+    const params = new URLSearchParams();
+    params.set("pipelineId", pipelineId);
+    params.set("redirect", "true");
+
+    if (siloId) params.set("siloId", siloId);
+    if (prompt) params.set("prompt", prompt);
+    if (resultId) params.set("resultId", resultId);
+
+    if (Object.keys(variables).length > 0) {
+      params.set("variables", JSON.stringify(variables));
+    }
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
+
+    return `${endpoint}?${params.toString()}`;
+  }
+
+  const endpoint =
+    baseUrl ||
+    "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderVideo";
   const params = new URLSearchParams();
-  params.set("bucketId", bucketId);
+  if (bucketId) {
+    params.set("bucketId", bucketId);
+  }
 
   if (!resultId) {
     if (aspectRatio) {
@@ -247,6 +437,10 @@ export function buildVideoUrl(options: SlopVideoOptions): string {
       params.set("variables", JSON.stringify(variables));
     }
 
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
+
     if (attachments && attachments.length > 0) {
       params.set("attachments", JSON.stringify(attachments));
     }
@@ -254,7 +448,7 @@ export function buildVideoUrl(options: SlopVideoOptions): string {
     params.set("resultId", resultId);
   }
 
-  return `${baseUrl}?${params.toString()}`;
+  return `${endpoint}?${params.toString()}`;
 }
 
 /**
@@ -271,8 +465,6 @@ export function preloadVideo(options: SlopVideoOptions): Promise<void> {
       return;
     }
 
-    // We can just fetch the URL to preload it into the browser's cache.
-    // We use no-cors to avoid CORS errors for simple preloads
     fetch(buildVideoUrl(options), { mode: "no-cors" })
       .then(() => resolve())
       .catch((err) => reject(err));
@@ -282,8 +474,26 @@ export function preloadVideo(options: SlopVideoOptions): Promise<void> {
 export interface SlopTextOptions {
   /**
    * The unique identifier of your Slop Machine bucket.
+   * Required when using a bucket unless pipelineId is provided.
    */
-  bucketId: string;
+  bucketId?: string;
+  /**
+   * The unique identifier of your Slop Machine pipeline.
+   * Required when targeting a pipeline instead of a bucket.
+   */
+  pipelineId?: string;
+  /**
+   * Optional silo identifier.
+   */
+  siloId?: string;
+  /**
+   * Dynamic runtime prompt (used when targeting a pipeline).
+   */
+  prompt?: string;
+  /**
+   * Arbitrary user metadata to attach to the generation request / result document.
+   */
+  metadata?: Record<string, any>;
   /**
    * The specific version of the prompt/settings to use.
    * If omitted, the latest version will be used.
@@ -313,34 +523,65 @@ export interface SlopTextOptions {
 /**
  * Builds a URL to render or retrieve text from Slop Machine.
  *
+ * Supports both standard Buckets (via `bucketId`) and multi-step Pipelines (via `pipelineId`).
+ *
  * @param options - Configuration options for the text generation.
  * @returns A string containing the fully constructed URL.
  */
 export function buildTextUrl(options: SlopTextOptions): string {
   const {
     bucketId,
+    pipelineId,
+    siloId,
+    prompt,
+    metadata,
     version,
     resultId,
     variables = {},
-    baseUrl = "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderText",
+    baseUrl,
     attachments,
   } = options;
 
+  if (pipelineId) {
+    const endpoint =
+      baseUrl ||
+      "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline";
+    const params = new URLSearchParams();
+    params.set("pipelineId", pipelineId);
+    params.set("sync", "true");
+
+    if (siloId) params.set("siloId", siloId);
+    if (prompt) params.set("prompt", prompt);
+    if (resultId) params.set("resultId", resultId);
+
+    if (Object.keys(variables).length > 0) {
+      params.set("variables", JSON.stringify(variables));
+    }
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
+
+    return `${endpoint}?${params.toString()}`;
+  }
+
+  const endpoint =
+    baseUrl ||
+    "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderText";
   const params = new URLSearchParams();
-  params.set("bucketId", bucketId);
+  if (bucketId) {
+    params.set("bucketId", bucketId);
+  }
 
   if (!resultId) {
     if (version) {
       params.set("version", String(version));
     }
-    if (resultId) {
-      params.set("resultId", resultId);
-    }
-
     if (Object.keys(variables).length > 0) {
       params.set("variables", JSON.stringify(variables));
     }
-
+    if (metadata && Object.keys(metadata).length > 0) {
+      params.set("metadata", JSON.stringify(metadata));
+    }
     if (attachments && attachments.length > 0) {
       params.set("attachments", JSON.stringify(attachments));
     }
@@ -348,7 +589,7 @@ export function buildTextUrl(options: SlopTextOptions): string {
     params.set("resultId", resultId);
   }
 
-  return `${baseUrl}?${params.toString()}`;
+  return `${endpoint}?${params.toString()}`;
 }
 
 /**
@@ -365,14 +606,101 @@ export function preloadText(options: SlopTextOptions): Promise<void> {
       return;
     }
 
-    // Fetch the URL to preload it into the browser's cache.
-    // We use no-cors to avoid CORS errors for simple preloads
     fetch(buildTextUrl(options), { mode: "no-cors" })
       .then(() => resolve())
       .catch((err) => reject(err));
   });
 }
 
+/**
+ * Builds a URL to execute or inspect a multi-step Pipeline from Slop Machine.
+ *
+ * @param options - Configuration options for the pipeline execution.
+ * @returns A string containing the fully constructed URL.
+ */
+export function buildPipelineUrl(options: SlopPipelineOptions): string {
+  const {
+    pipelineId,
+    siloId,
+    prompt,
+    variables = {},
+    metadata = {},
+    sync = true,
+    redirect = false,
+    resultId,
+    baseUrl = "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline",
+  } = options;
+
+  const params = new URLSearchParams();
+  params.set("pipelineId", pipelineId);
+
+  if (siloId) params.set("siloId", siloId);
+  if (prompt) params.set("prompt", prompt);
+  if (resultId) params.set("resultId", resultId);
+  if (sync !== undefined) params.set("sync", String(sync));
+  if (redirect) params.set("redirect", "true");
+
+  if (Object.keys(variables).length > 0) {
+    params.set("variables", JSON.stringify(variables));
+  }
+  if (Object.keys(metadata).length > 0) {
+    params.set("metadata", JSON.stringify(metadata));
+  }
+
+  return `${baseUrl}?${params.toString()}`;
+}
+
+/**
+ * Executes a Slop Machine multi-step Pipeline programmatically and returns the full typed result payload.
+ *
+ * @param options - Execution parameters including the pipelineId and runtime prompt/variables/metadata.
+ * @returns A promise resolving to the completed PipelineResult document.
+ */
+export async function executePipeline(
+  options: ExecutePipelineOptions,
+): Promise<PipelineResult> {
+  const {
+    pipelineId,
+    siloId,
+    prompt,
+    variables,
+    metadata,
+    baseUrl = "https://us-central1-slopmachine-12bfb.cloudfunctions.net/renderPipeline",
+  } = options;
+
+  const response = await fetch(baseUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      pipelineId,
+      ...(siloId ? { siloId } : {}),
+      ...(prompt ? { prompt } : {}),
+      variables,
+      metadata,
+      sync: true,
+    }),
+  });
+
+  if (!response.ok) {
+    let errorDetail = response.statusText;
+    try {
+      const errorJson = await response.json();
+      if (errorJson.error) {
+        errorDetail = errorJson.error;
+      }
+    } catch {
+      // Use statusText
+    }
+    throw new Error(
+      `Pipeline execution failed (${response.status}): ${errorDetail}`,
+    );
+  }
+
+  return (await response.json()) as PipelineResult;
+}
+
 /**
  * Uploads a base64 encoded file as a temporary attachment to be used in generation requests.
  *