Sync alphalib 20250324 (#220)

* w

* w

Author: kvz

.cursor/rules/cli-scripts.mdc

@@ -0,0 +1,12 @@
+---
+description: CLI Scripts
+globs: 
+alwaysApply: false
+---
+- For CLI scripts, use TypeScript
+- Use tsx vs ts-node
+- If we need complex CLI arg parsing use Clipanion & Typanion
+- Use execa for running commands. We use version 4 because not all repo's are ESM compatible yet
+- Use dotenv to load secrets
+- Have one main() or run() method that catches fails and exit(1) the process. Then have less excessive try/catches throughout the entire script
+- Use `import { randomUUID } from 'node:crypto'` vs `import { v4 as uuidv4 } from 'uuid'`

.cursor/rules/coding-style.mdc

@@ -9,3 +9,6 @@ alwaysApply: false
 - Favor using real paths (`../lib/schemas.ts`) over aliases (`@/app/lib/schemas`).
 - Favor `for (const comment of comments) {` over `comments.forEach((comment) => {`
 - Favor named exports over default exports, with the exception of Next.js pages
+- Do not wrap each function body and function call in `try`/`catch` blocks. It pollutes the code. Assume we will always have an e.g. `main().catch((err) => { console.error(err); process.exit(1) })` to catch us.
+- Before creating new files and new code, see if we can leverage existing work, maybe slighty adapt that without breaking BC, to keep things DRY.
+- Favor early exits, so quickly `continue`, `return false` (or `throw` if needed), over nesting everything in positive conditions, creating christmas trees.

.cursor/rules/general.mdc

@@ -5,5 +5,6 @@ alwaysApply: true
 ---
 - Do not touch `.env` files!
 - Favor Yarn (4) over npm
+- Never run any dev server yourself. I have one running that auto-reloads on changes.
 - Avoid blocking the conversation with terminal commands. For example: A) most of my git commands run through pagers, so pipe their output to `cat` to avoid blocking the
-  terminal. B) Running a server in the foreground will block the conversation. Avoid it. C) You can use `tail` for logs, but be smart and use `-n` instead of `-f`, or the conversation will block
+  terminal. B) You can use `tail` for logs, but be smart and use `-n` instead of `-f`, or the conversation will block

src/alphalib/types/robots/_index.ts

@@ -92,6 +92,7 @@ import { robotGoogleImportInstructionsSchema, meta as googleImportMeta } from '.
 import { robotGoogleStoreInstructionsSchema, meta as googleStoreMeta } from './google-store.ts'
 import { robotHtmlConvertInstructionsSchema, meta as htmlConvertMeta } from './html-convert.ts'
 import { robotHttpImportInstructionsSchema, meta as httpImportMeta } from './http-import.ts'
+import { robotImageBgremoveInstructionsSchema } from './image-bgremove.ts'
 import {
   robotImageDescribeInstructionsSchema,
   meta as imageDescribeMeta,
@@ -110,12 +111,7 @@ import {
   robotImageOptimizeInstructionsSchema,
   meta as imageOptimizeMeta,
 } from './image-optimize.ts'
-import { robotImageRemoveBackgroundInstructionsSchema } from './image-remove-background.ts'
 import { robotImageResizeInstructionsSchema, meta as imageResizeMeta } from './image-resize.ts'
-import {
-  robotMediaPlaylistInstructionsSchema,
-  meta as mediaPlaylistMeta,
-} from './media-playlist.ts'
 import { robotMetaWriteInstructionsSchema, meta as metaWriteMeta } from './meta-write.ts'
 import { robotMinioImportInstructionsSchema, meta as minioImportMeta } from './minio-import.ts'
 import { robotMinioStoreInstructionsSchema, meta as minioStoreMeta } from './minio-store.ts'
@@ -208,13 +204,13 @@ const robotStepsInstructions = [
   robotGoogleStoreInstructionsSchema,
   robotHtmlConvertInstructionsSchema,
   robotHttpImportInstructionsSchema,
+  robotImageBgremoveInstructionsSchema,
   robotImageDescribeInstructionsSchema,
   robotImageFacedetectInstructionsSchema,
   robotImageMergeInstructionsSchema,
   robotImageOcrInstructionsSchema,
   robotImageOptimizeInstructionsSchema,
   robotImageResizeInstructionsSchema,
-  robotMediaPlaylistInstructionsSchema,
   robotMetaWriteInstructionsSchema,
   robotMinioImportInstructionsSchema,
   robotMinioStoreInstructionsSchema,
@@ -294,7 +290,6 @@ const robotStepsInstructionsWithHiddenFields = [
   robotImageOcrInstructionsSchema,
   robotImageOptimizeInstructionsSchema,
   robotImageResizeInstructionsSchema,
-  robotMediaPlaylistInstructionsSchema,
   robotMetaWriteInstructionsSchema,
   robotMinioImportInstructionsSchema,
   robotMinioStoreInstructionsSchema,
@@ -342,14 +337,12 @@ export const robotsWithHiddenBotsSchema = z.discriminatedUnion('robot', [
   ...robotStepsInstructions,
   robotFileWatermarkInstructionsSchema,
   robotImageGenerateInstructionsSchema,
-  robotImageRemoveBackgroundInstructionsSchema,
   robotProgressSimulateInstructionsSchema,
 ])
 export const robotsWithHiddenBotsAndFieldsSchema = z.discriminatedUnion('robot', [
   ...robotStepsInstructionsWithHiddenFields,
   robotFileWatermarkInstructionsSchema,
   robotImageGenerateInstructionsWithHiddenFieldsSchema,
-  robotImageRemoveBackgroundInstructionsSchema,
   robotProgressSimulateInstructionsSchema,
 ])
 
@@ -403,7 +396,6 @@ export const robotsMeta = {
   imageOcrMeta,
   imageOptimizeMeta,
   imageResizeMeta,
-  mediaPlaylistMeta,
   metaWriteMeta,
   minioImportMeta,
   minioStoreMeta,

src/alphalib/types/robots/_instructions-primitives.ts

@@ -55,6 +55,7 @@ export interface RobotMeta {
     | 'transcribe'
     | 'translate'
     | 'verify'
+    | 'remove'
     | 'write'
 
   purpose_word: string

src/alphalib/types/robots/image-bgremove.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod'
+
+import type { RobotMeta } from './_instructions-primitives.ts'
+import { robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMeta = {
+  allowed_for_url_transform: true,
+  discount_factor: 1,
+  bytescount: 1,
+  discount_pct: 0,
+  docs_redirect_from: ['/docs/image-bgremove/'],
+  example_code: {
+    steps: {
+      remove_background: {
+        robot: '/image/bgremove',
+        use: ':original',
+      },
+    },
+  },
+  example_code_description: 'Remove the background from the uploaded image:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  override_lvl1: 'Image Manipulation',
+  purpose_sentence: 'removes the background from images',
+  purpose_verb: 'remove',
+  purpose_word: 'remove',
+  purpose_words: 'Remove the background from images',
+  service_slug: 'image-manipulation',
+  slot_count: 10,
+  title: 'Remove the background from images',
+  typical_file_size_mb: 0.8,
+  typical_file_type: 'image',
+}
+
+export const robotImageBgremoveInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/image/bgremove'),
+    select: z
+      .enum(['foreground', 'background'])
+      .optional()
+      .describe('Region to select and keep in the image. The other region is removed.'),
+    format: z.enum(['png', 'gif', 'webp']).optional().describe('Format of the generated image.'),
+    provider: z
+      .enum(['transloadit', 'replicate', 'fal'])
+      .optional()
+      .describe('Provider to use for removing the background.'),
+  })
+  .strict()
+
+export type RobotImageBgremoveInstructions = z.infer<typeof robotImageBgremoveInstructionsSchema>

src/alphalib/types/robots/image-remove-background.ts

@@ -101,9 +101,6 @@ Splits the video into multiple chunks so that each chunk can be encoded in paral
 `),
     chunk_duration: z.number().int().min(1).optional().describe(`
 Allows you to specify the duration of each chunk when \`turbo\` is set to \`true\`. This means you can take advantage of that feature while using fewer <dfn>Priority Job Slots</dfn>. For instance, the longer each chunk is, the fewer <dfn>Encoding Jobs</dfn> will need to be used.
-`),
-    freeze_detect: z.boolean().default(false).describe(`
-Examines the transcoding result file for video freeze frames and re-transcodes the video a second time if they are found. This is useful when you are using \`turbo: true\` because freeze frames can sometimes happen there. The re-transcode would then happen without turbo mode.
 `),
     watermark_url: z.string().default('').describe(`
 A URL indicating a PNG image to be overlaid above this image. You can also [supply the watermark via another Assembly Step](/docs/transcoding/video-encoding/video-encode/#watermark-parameters-video-encode).