@transloadit/node 4.1.3

package/src/alphalib/types/robots/s3-store.ts

@@ -0,0 +1,198 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse, s3Base } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  allowed_for_url_transform: true,
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  example_code: {
+    steps: {
+      exported: {
+        robot: '/s3/store',
+        use: ':original',
+        credentials: 'YOUR_AWS_CREDENTIALS',
+        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
+      },
+    },
+  },
+  example_code_description: 'Export uploaded files to `my_target_folder` in an S3 bucket:',
+  has_small_icon: true,
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Exporting',
+  purpose_sentence: 'exports encoding results to Amazon S3',
+  purpose_verb: 'export',
+  purpose_word: 'Amazon S3',
+  purpose_words: 'Export files to Amazon S3',
+  service_slug: 'file-exporting',
+  slot_count: 2,
+  title: 'Export files to Amazon S3',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'S3StoreRobot',
+  priceFactor: 10,
+  queueSlotCount: 2,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  stage: 'ga',
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+}
+
+export const robotS3StoreInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(s3Base)
+  .extend({
+    robot: z.literal('/s3/store').describe(`
+If you are new to Amazon S3, see our tutorial on [using your own S3 bucket](/docs/faq/how-to-set-up-an-amazon-s3-bucket/).
+
+The URL to the result file in your S3 bucket will be returned in the <dfn>Assembly Status JSON</dfn>. If your S3 bucket has versioning enabled, the version ID of the file will be returned within \`meta.version_id\`
+
+> [!Warning]
+> **Avoid permission errors.** By default, \`acl\` is set to \`"public"\`. AWS S3 has a bucket setting called "Block new public ACLs and uploading public objects". Set this to <strong>False</strong> in your bucket if you intend to leave \`acl\` as \`"public"\`. Otherwise, you’ll receive permission errors in your Assemblies despite your S3 credentials being configured correctly.
+
+> [!Warning]
+> **Use DNS-compliant bucket names.** Your bucket name [must be DNS-compliant](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html) and must not contain uppercase letters. Any non-alphanumeric characters in the file names will be replaced with an underscore, and spaces will be replaced with dashes. If your existing S3 bucket contains uppercase letters or is otherwise not DNS-compliant, rewrite the result URLs using the <dfn>Robot</dfn>’s \`url_prefix\` parameter.
+
+<span id="minimum-s3-iam-permissions" aria-hidden="true"></span>
+
+## Limit access
+
+You will also need to add permissions to your bucket so that Transloadit can access it properly. Here is an example IAM policy that you can use. Following the [principle of least privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege), it contains the **minimum required permissions** to export a file to your S3 bucket using Transloadit. You may require more permissions (especially viewing permissions) depending on your application.
+
+Please change \`{BUCKET_NAME}\` in the values for \`Sid\` and \`Resource\` accordingly. Also, this policy will grant the minimum required permissions to all your users. We advise you to create a separate Amazon IAM user, and use its User ARN (can be found in the "Summary" tab of a user [here](https://console.aws.amazon.com/iam/home#users)) for the \`Principal\` value. More information about this can be found [here](https://docs.aws.amazon.com/AmazonS3/latest/dev/AccessPolicyLanguage_UseCases_s3_a.html).
+
+\`\`\`json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "AllowTransloaditToStoreFilesIn{BUCKET_NAME}Bucket",
+      "Effect": "Allow",
+      "Action": ["s3:GetBucketLocation", "s3:ListBucket", "s3:PutObject", "s3:PutObjectAcl"],
+      "Resource": ["arn:aws:s3:::{BUCKET_NAME}", "arn:aws:s3:::{BUCKET_NAME}/*"]
+    }
+  ]
+}
+\`\`\`
+
+The \`Sid\` value is just an identifier for you to recognize the rule later. You can name it anything you like.
+
+The policy needs to be separated into two parts, because the \`ListBucket\` action requires permissions on the bucket while the other actions require permissions on the objects in the bucket. When targeting the objects there's a trailing slash and an asterisk in the \`Resource\` parameter, whereas when the policy targets the bucket, the slash and the asterisk are omitted.
+
+Please note that if you give the <dfn>Robot</dfn>'s \`acl\` parameter a value of \`"bucket-default"\`, then you do not need the \`"s3:PutObjectAcl"\` permission in your bucket policy.
+
+In order to build proper result URLs we need to know the region in which your S3 bucket resides. For this we require the \`GetBucketLocation\` permission. Figuring out your bucket's region this way will also slow down your Assemblies. To make this much faster and to also not require the \`GetBucketLocation\` permission, we have added the \`bucket_region\` parameter to the /s3/store and /s3/import Robots. We recommend using them at all times.
+
+Please keep in mind that if you use bucket encryption you may also need to add \`"sts:*"\` and \`"kms:*"\` to the bucket policy. Please read [here](https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html) and [here](https://aws.amazon.com/blogs/security/how-to-restrict-amazon-s3-bucket-access-to-a-specific-iam-role/) in case you run into trouble with our example bucket policy.
+`),
+    path: z
+      .string()
+      .default('${unique_prefix}/${file.url_name}')
+      .describe(`
+The path at which the file is to be stored. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables). The path must not be a directory.
+`),
+    url_prefix: z
+      .string()
+      .default('http://{bucket}.s3.amazonaws.com/')
+      .describe(`
+The URL prefix used for the returned URL, such as \`"http://my.cdn.com/some/path/"\`.
+`),
+    acl: z
+      .enum(['bucket-default', 'private', 'public', 'public-read'])
+      .default('public-read')
+      .describe(`
+The permissions used for this file.
+
+Please keep in mind that the default value \`"public-read"\` can lead to permission errors due to the \`"Block all public access"\` checkbox that is checked by default when creating a new Amazon S3 Bucket in the AWS console.
+`),
+    check_integrity: z
+      .boolean()
+      .default(false)
+      .describe(`
+Calculate and submit the file's checksum in order for S3 to verify its integrity after uploading, which can help with occasional file corruption issues.
+
+Enabling this option adds to the overall execution time, as integrity checking can be CPU intensive, especially for larger files.
+`),
+    headers: z
+      .record(z.string())
+      .default({ 'Content-Type': '${file.mime}' })
+      .describe(`
+An object containing a list of headers to be set for this file on S3, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly Variables](/docs/topics/assembly-instructions/#assembly-variables). You can find a list of available headers [here](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html).
+
+Object Metadata can be specified using \`x-amz-meta-*\` headers. Note that these headers [do not support non-ASCII metadata values](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#UserMetadata).
+`),
+    tags: z
+      .record(z.string())
+      .default({})
+      .describe(`
+Object tagging allows you to categorize storage. You can associate up to 10 tags with an object. Tags that are associated with an object must have unique tag keys.
+`),
+    host: z
+      .string()
+      .default('s3.amazonaws.com')
+      .describe(`
+The host of the storage service used. This only needs to be set when the storage service used is not Amazon S3, but has a compatible API (such as hosteurope.de). The default protocol used is HTTP, for anything else the protocol needs to be explicitly specified. For example, prefix the host with \`https://\` or \`s3://\` to use either respective protocol.
+`),
+    no_vhost: z
+      .boolean()
+      .default(false)
+      .describe(`
+Set to \`true\` if you use a custom host and run into access denied errors.
+`),
+    sign_urls_for: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe(`
+This parameter provides signed URLs in the result JSON (in the \`signed_url\` and \`signed_ssl_url\` properties). The number that you set this parameter to is the URL expiry time in seconds. If this parameter is not used, no URL signing is done.
+`),
+    session_token: z
+      .string()
+      .optional()
+      .describe(`
+The session token to use for the S3 store. This is only used if the credentials are from an IAM user with the \`sts:AssumeRole\` permission.
+`),
+  })
+  .strict()
+
+export const robotS3StoreInstructionsWithHiddenFieldsSchema = robotS3StoreInstructionsSchema.extend(
+  {
+    result: z.union([z.literal('debug'), robotS3StoreInstructionsSchema.shape.result]).optional(),
+    skip_region_lookup: z
+      .boolean()
+      .optional()
+      .describe(`
+Internal parameter to skip region lookup for testing purposes.
+`),
+  },
+)
+
+export type RobotS3StoreInstructions = z.infer<typeof robotS3StoreInstructionsSchema>
+export type RobotS3StoreInstructionsInput = z.input<typeof robotS3StoreInstructionsSchema>
+export type RobotS3StoreInstructionsWithHiddenFields = z.infer<
+  typeof robotS3StoreInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotS3StoreInstructionsSchema = interpolateRobot(
+  robotS3StoreInstructionsSchema,
+)
+export type InterpolatableRobotS3StoreInstructions = InterpolatableRobotS3StoreInstructionsInput
+
+export type InterpolatableRobotS3StoreInstructionsInput = z.input<
+  typeof interpolatableRobotS3StoreInstructionsSchema
+>
+
+export const interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotS3StoreInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotS3StoreInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotS3StoreInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/script-run.ts

@@ -0,0 +1,122 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  allowed_for_url_transform: true,
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'Code Evaluation',
+  purpose_sentence: 'runs scripts in Assemblies',
+  purpose_verb: 'run',
+  purpose_word: 'script',
+  purpose_words: 'Run scripts in Assemblies',
+  service_slug: 'code-evaluation',
+  slot_count: 5,
+  title: 'Run Scripts',
+  typical_file_size_mb: 0.0001,
+  typical_file_type: 'file',
+  name: 'ScriptRunRobot',
+  priceFactor: 10,
+  queueSlotCount: 5,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotScriptRunInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/script/run').describe(`
+This <dfn>Robot</dfn> allows you to run arbitrary \`JavaScript\` as part of the <dfn>Assembly</dfn>
+execution process. The <dfn>Robot</dfn> is invoked automatically when there are <dfn>Assembly
+Instructions</dfn> containing \`\${...}\`:
+
+\`\`\`json
+{
+  "robot": "/image/resize",
+  "width": "\${Math.max(file.meta.width, file.meta.height)}"
+}
+\`\`\`
+
+You can also invoke this <dfn>Robot</dfn> directly, leaving out the \`\${...}\`:
+
+\`\`\`json
+{
+  "robot": "/script/run",
+  "script": "Math.max(file.meta.width, file.meta.height)"
+}
+\`\`\`
+
+When accessing arrays, the syntax is the same as in any JavaScript program:
+
+\`\`\`json
+{
+  "robot": "/image/resize",
+  "width": "\${file.meta.faces[0].width * 2}"
+}
+\`\`\`
+
+Compared to only accessing an <dfn>Assembly Variable</dfn>:
+
+\`\`\`json
+{
+  "robot": "/image/resize",
+  "width": "\${file.meta.faces[0].width}"
+}
+\`\`\`
+
+For more information, see [Dynamic Evaluation](/docs/topics/dynamic-evaluation/).
+`),
+    script: z.string().describe(`
+A string of JavaScript to evaluate. It has access to all JavaScript features available in a modern browser environment.
+
+The script is expected to return a \`JSON.stringify\`-able value in the same tick, so no \`await\` or callbacks are allowed (yet).
+
+If the script does not finish within 1000ms it times out with an error. The return value or error is exported as \`file.meta.result\`. If there was an error, \`file.meta.isError\` is \`true\`. Note that the <dfn>Assembly</dfn> will not crash in this case. If you need it to crash, you can check this value with a [🤖/file/filter](/docs/robots/file-filter/) <dfn>Step</dfn>, setting \`error_on_decline\` to \`true\`.
+
+You can check whether evaluating this script was free by inspecting \`file.meta.isFree\`. It is recommended to do this during development as to not see sudden unexpected costs in production.
+`),
+  })
+  .strict()
+
+export const robotScriptRunInstructionsWithHiddenFieldsSchema =
+  robotScriptRunInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotScriptRunInstructionsSchema.shape.result]).optional(),
+    contextJSON: z
+      .string()
+      .optional()
+      .describe(`
+A JSON string that provides additional context data to the script. This will be parsed and made available to the script as a \`context\` variable. For example, if you pass \`'{"foo":{"bar":"baz"}}'\`, the script can access \`context.foo.bar\` to get the value \`"baz"\`.
+`),
+  })
+
+export type RobotScriptRunInstructions = z.infer<typeof robotScriptRunInstructionsSchema>
+export type RobotScriptRunInstructionsWithHiddenFields = z.infer<
+  typeof robotScriptRunInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotScriptRunInstructionsSchema = interpolateRobot(
+  robotScriptRunInstructionsSchema,
+)
+export type InterpolatableRobotScriptRunInstructions = InterpolatableRobotScriptRunInstructionsInput
+
+export type InterpolatableRobotScriptRunInstructionsInput = z.input<
+  typeof interpolatableRobotScriptRunInstructionsSchema
+>
+
+export const interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotScriptRunInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotScriptRunInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotScriptRunInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/sftp-import.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotImport, sftpBase } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  allowed_for_url_transform: true,
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  example_code: {
+    steps: {
+      imported: {
+        robot: '/sftp/import',
+        credentials: 'YOUR_SFTP_CREDENTIALS',
+        path: 'path/to/files/',
+      },
+    },
+  },
+  example_code_description:
+    'Import files from the `path/to/files` directory and its subdirectories:',
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Importing',
+  purpose_sentence:
+    'imports whole libraries of files from your SFTP servers into Transloadit. This Robot relies on public key authentication',
+  purpose_verb: 'import',
+  purpose_word: 'SFTP servers',
+  purpose_words: 'Import files from SFTP servers',
+  service_slug: 'file-importing',
+  slot_count: 20,
+  title: 'Import files from SFTP servers',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'SftpImportRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
+  stage: 'ga',
+}
+
+export const robotSftpImportInstructionsSchema = robotBase
+  .merge(robotImport)
+  .merge(sftpBase)
+  .extend({
+    robot: z.literal('/sftp/import'),
+    path: z.string().describe(`
+The path on your SFTP server where to search for files.
+`),
+  })
+  .strict()
+
+export const robotSftpImportInstructionsWithHiddenFieldsSchema =
+  robotSftpImportInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotSftpImportInstructionsSchema.shape.result])
+      .optional(),
+    allowNetwork: z
+      .string()
+      .optional()
+      .describe(`
+Network access permission for the SFTP connection. This is used to control which networks the SFTP robot can access.
+`),
+  })
+
+export type RobotSftpImportInstructions = z.infer<typeof robotSftpImportInstructionsSchema>
+export type RobotSftpImportInstructionsWithHiddenFields = z.infer<
+  typeof robotSftpImportInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotSftpImportInstructionsSchema = interpolateRobot(
+  robotSftpImportInstructionsSchema,
+)
+export type InterpolatableRobotSftpImportInstructions =
+  InterpolatableRobotSftpImportInstructionsInput
+
+export type InterpolatableRobotSftpImportInstructionsInput = z.input<
+  typeof interpolatableRobotSftpImportInstructionsSchema
+>
+
+export const interpolatableRobotSftpImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotSftpImportInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotSftpImportInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotSftpImportInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotSftpImportInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotSftpImportInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/sftp-store.ts

@@ -0,0 +1,110 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse, sftpBase } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  allowed_for_url_transform: true,
+  bytescount: 6,
+  discount_factor: 0.15000150001500018,
+  discount_pct: 84.99984999849998,
+  example_code: {
+    steps: {
+      exported: {
+        robot: '/sftp/store',
+        use: ':original',
+        credentials: 'YOUR_SFTP_CREDENTIALS',
+        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
+      },
+    },
+  },
+  example_code_description: 'Export uploaded files to `my_target_folder` on an SFTP server:',
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Exporting',
+  purpose_sentence: 'exports encoding results to your own SFTP server',
+  purpose_verb: 'export',
+  purpose_word: 'SFTP servers',
+  purpose_words: 'Export files to SFTP servers',
+  service_slug: 'file-exporting',
+  slot_count: 10,
+  title: 'Export files to SFTP servers',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'SftpStoreRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 10,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotSftpStoreInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(sftpBase)
+  .extend({
+    robot: z.literal('/sftp/store'),
+    path: z
+      .string()
+      .default('${unique_prefix}/${file.url_name}')
+      .describe(`
+The path at which the file is to be stored. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
+`),
+    url_template: z
+      .string()
+      .default('http://host/path')
+      .describe(`
+The URL of the file in the result JSON. This may include any of the following supported [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
+`),
+    ssl_url_template: z
+      .string()
+      .default('https://{HOST}/{PATH}')
+      .describe(`
+  The SSL URL of the file in the result JSON. The following [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables) are supported.
+`),
+    file_chmod: z
+      .string()
+      .regex(/([0-7]{3}|auto)/)
+      .default('auto')
+      .describe(`
+This optional parameter controls how an uploaded file's permission bits are set. You can use any string format that the \`chmod\` command would accept, such as \`"755"\`. If you don't specify this option, the file's permission bits aren't changed at all, meaning it's up to your server's configuration (e.g. umask).
+      `),
+  })
+  .strict()
+
+export const robotSftpStoreInstructionsWithHiddenFieldsSchema =
+  robotSftpStoreInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotSftpStoreInstructionsSchema.shape.result]).optional(),
+    allowNetwork: z
+      .string()
+      .optional()
+      .describe(`
+Network access permission for the SFTP connection. This is used to control which networks the SFTP robot can access.
+`),
+  })
+
+export type RobotSftpStoreInstructions = z.infer<typeof robotSftpStoreInstructionsSchema>
+export type RobotSftpStoreInstructionsWithHiddenFields = z.infer<
+  typeof robotSftpStoreInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotSftpStoreInstructionsSchema = interpolateRobot(
+  robotSftpStoreInstructionsSchema,
+)
+export type InterpolatableRobotSftpStoreInstructions = InterpolatableRobotSftpStoreInstructionsInput
+
+export type InterpolatableRobotSftpStoreInstructionsInput = z.input<
+  typeof interpolatableRobotSftpStoreInstructionsSchema
+>
+
+export const interpolatableRobotSftpStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotSftpStoreInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotSftpStoreInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotSftpStoreInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotSftpStoreInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotSftpStoreInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/speech-transcribe.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  aiProviderSchema,
+  granularitySchema,
+  interpolateRobot,
+  robotBase,
+  robotUse,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  allowed_for_url_transform: true,
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      transcribed: {
+        robot: '/speech/transcribe',
+        use: ':original',
+        provider: 'aws',
+        source_language: 'fr-FR',
+        format: 'text',
+      },
+    },
+  },
+  example_code_description:
+    'Transcribe speech in French from uploaded audio or video, and save it to a text file:',
+  extended_description: `
+> [!Warning]
+> Transloadit aims to be deterministic, but this <dfn>Robot</dfn> uses third-party AI services. The providers (AWS, GCP) will evolve their models over time, giving different responses for the same input media. Avoid relying on exact responses in your tests and application.
+`,
+  minimum_charge: 1048576,
+  output_factor: 0.05,
+  override_lvl1: 'Artificial Intelligence',
+  purpose_sentence: 'transcribes speech in audio or video files',
+  purpose_verb: 'transcribe',
+  purpose_word: 'transcribe speech',
+  purpose_words: 'Transcribe speech in audio or video files',
+  service_slug: 'artificial-intelligence',
+  slot_count: 10,
+  title: 'Transcribe speech in audio or video files',
+  typical_file_size_mb: 2.4,
+  typical_file_type: 'audio or video file',
+  name: 'SpeechTranscribeRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumChargeUsdPerSpeechTranscribeMinute: {
+    aws: 0.024,
+    gcp: 0.016,
+  },
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotSpeechTranscribeInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/speech/transcribe').describe(`
+You can use the text that we return in your application, or you can pass the text down to other <dfn>Robots</dfn> to filter audio or video files that contain (or do not contain) certain content, or burn the text into images or video for example.
+
+Another common use case is automatically subtitling videos, or making audio searchable.
+`),
+    provider: aiProviderSchema.describe(`
+Which AI provider to leverage.
+
+Transloadit outsources this task and abstracts the interface so you can expect the same data structures, but different latencies and information being returned. Different cloud vendors have different areas they shine in, and we recommend to try out and see what yields the best results for your use case.
+`),
+    granularity: granularitySchema.describe(`
+Whether to return a full response (\`"full"\`), or a flat list of descriptions (\`"list"\`).
+`),
+    format: z
+      .enum(['json', 'meta', 'srt', 'meta', 'text', 'webvtt'])
+      .default('json')
+      .describe(`
+Output format for the transcription.
+
+- \`"text"\` outputs a plain text file that you can store and process.
+- \`"json"\` outputs a JSON file containing timestamped words.
+- \`"srt"\` and \`"webvtt"\` output subtitle files of those respective file types, which can be stored separately or used in other encoding <dfn>Steps</dfn>.
+- \`"meta"\` does not return a file, but stores the data inside  Transloadit's file object (under \`\${file.meta.transcription.text}\`) that's passed around between encoding <dfn>Steps</dfn>, so that you can use the values to burn the data into videos, filter on them, etc.
+`),
+    // TODO determine the list of languages
+    source_language: z
+      .string()
+      .default('en-US')
+      .describe(`
+The spoken language of the audio or video. This will also be the language of the transcribed text.
+
+The language should be specified in the [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) format, such as \`"en-GB"\`, \`"de-DE"\` or \`"fr-FR"\`. Please also consult the list of supported languages for [the \`gcp\` provider](https://cloud.google.com/speech-to-text/docs/languages) and the [the \`aws\` provider](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html).
+`),
+    // TODO determine the list of languages
+    target_language: z
+      .string()
+      .default('en-US')
+      .describe(`
+      This will also be the language of the written text.
+
+      The language should be specified in the [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) format, such as \`"en-GB"\`, \`"de-DE"\` or \`"fr-FR"\`. Please consult the list of supported languages and voices.
+    `),
+  })
+  .strict()
+
+export const robotSpeechTranscribeInstructionsWithHiddenFieldsSchema =
+  robotSpeechTranscribeInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotSpeechTranscribeInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotSpeechTranscribeInstructions = z.infer<
+  typeof robotSpeechTranscribeInstructionsSchema
+>
+export type RobotSpeechTranscribeInstructionsWithHiddenFields = z.infer<
+  typeof robotSpeechTranscribeInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotSpeechTranscribeInstructionsSchema = interpolateRobot(
+  robotSpeechTranscribeInstructionsSchema,
+)
+export type InterpolatableRobotSpeechTranscribeInstructions =
+  InterpolatableRobotSpeechTranscribeInstructionsInput
+
+export type InterpolatableRobotSpeechTranscribeInstructionsInput = z.input<
+  typeof interpolatableRobotSpeechTranscribeInstructionsSchema
+>
+
+export const interpolatableRobotSpeechTranscribeInstructionsWithHiddenFieldsSchema =
+  interpolateRobot(robotSpeechTranscribeInstructionsWithHiddenFieldsSchema)
+export type InterpolatableRobotSpeechTranscribeInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotSpeechTranscribeInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotSpeechTranscribeInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotSpeechTranscribeInstructionsWithHiddenFieldsSchema
+>