@inquir/compute 0.4.2 → 0.4.4

package/dist/system-packages.d.ts

@@ -0,0 +1,441 @@
+import { z } from 'zod';
+/**
+ * System packages (OS packages such as ffmpeg) are declared in inquir.yaml —
+ * the one config format for every language — and applied by a deploy:
+ *
+ *   build:
+ *     system:
+ *       presets: [ffmpeg]
+ *       packages: [poppler-utils, chromium]
+ *   functions:
+ *     transcode:           # per-function override; replaces the default (no merge)
+ *       build:
+ *         system:
+ *           presets: [ffmpeg]
+ *
+ * This module only reads and validates that schema (INQUIR_YAML_JSON_SCHEMA
+ * is what editors use for completion); it is never a second config source.
+ * The platform is the authority: GET /functions/system-presets lists its
+ * catalog, and the deploy validates the block again.
+ */
+/** Presets of catalog v1 (Debian bookworm). */
+export declare const SYSTEM_PRESET_NAMES: readonly ["ffmpeg", "fonts", "ghostscript", "imagemagick", "libvips", "poppler", "tesseract"];
+export type SystemPresetName = (typeof SYSTEM_PRESET_NAMES)[number];
+/** tesseract `langs` values (tesseract-ocr-<lang> packages in bookworm). */
+export declare const TESSERACT_LANGS: readonly ["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"];
+/** Debian package name with an optional apt `=version` pin (the platform applies the same rule). */
+export declare const SYSTEM_PACKAGE_NAME_PATTERN = "^(?!.*\\.\\.)[a-z0-9](?:[a-z0-9+.-]{0,61}[a-z0-9])?(=[A-Za-z0-9.+~:_-]{1,64})?$";
+export type SystemPresetRef = SystemPresetName | {
+    name: SystemPresetName;
+    langs?: string[];
+};
+/** The `build.system` block of inquir.yaml. */
+export interface FunctionSystemConfig {
+    presets?: SystemPresetRef[];
+    /** Debian bookworm package names, optionally pinned with apt's `name=version`. */
+    packages?: string[];
+}
+/** The free-form package cap the platform applies by default (the Free plan figure). */
+export declare const SYSTEM_MAX_PACKAGES = 10;
+/** At most this many presets per block. */
+export declare const SYSTEM_MAX_PRESETS = 8;
+/** Presets that take options (an object entry); every other preset is a plain name. */
+export declare const SYSTEM_PRESETS_WITH_OPTIONS: readonly ["tesseract"];
+/**
+ * Package names a function image refuses (daemons, privilege tools, kernels,
+ * package tooling); an optional `=version` pin does not change that. The
+ * platform's validator uses the same list (a test keeps them in step).
+ */
+export declare const SYSTEM_PACKAGE_DENYLIST_PATTERN = "^(systemd.*|init|sudo|sudo-ldap|doas|openssh-server|docker.*|containerd.*|podman.*|runc|crun|linux-image-.*|linux-headers-.*|.*-dkms|apt-transport-.*|apt|dpkg|cron|anacron|rsyslog|udev|dbus)(=.*)?$";
+/** zod twin of INQUIR_YAML_JSON_SCHEMA's system block. */
+export declare const functionSystemConfigSchema: z.ZodNullable<z.ZodObject<{
+    presets: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodUnion<[z.ZodEnum<["ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract", ...("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract")[]]>, z.ZodLiteral<"tesseract">, z.ZodObject<{
+        name: z.ZodLiteral<"tesseract">;
+        langs: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEnum<["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"]>, "many">, ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[], ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[]>>>;
+    }, "strict", z.ZodTypeAny, {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    }, {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    }>]>, "many">, ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    })[], ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    })[]>>>;
+    packages: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, string[], string[]>>>;
+}, "strict", z.ZodTypeAny, {
+    presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    })[] | null | undefined;
+    packages?: string[] | null | undefined;
+}, {
+    presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+        name: "tesseract";
+        langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+    })[] | null | undefined;
+    packages?: string[] | null | undefined;
+}>>;
+/**
+ * `build.dependencies`: language packages, the same key for every runtime
+ * (node `name@version`, python a pip requirement such as `name==version`, go
+ * `module@version`). Only the shape is checked here; the platform validates
+ * each entry by the function's runtime and merges the list into its build
+ * workspace's package.json / requirements.txt / go.mod
+ * (docs/FUNCTION_BUILD_DEPENDENCIES.md; FUNCTIONS_INQUIR_YAML_DEPENDENCIES).
+ */
+export declare const buildDependenciesSchema: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+/** The parts of an inquir.yaml document the functions read; apps' `version` and `services` are checked by the platform. */
+export declare const inquirYamlFunctionsSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodUnknown>;
+    services: z.ZodOptional<z.ZodUnknown>;
+    build: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        system: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            presets: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodUnion<[z.ZodEnum<["ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract", ...("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract")[]]>, z.ZodLiteral<"tesseract">, z.ZodObject<{
+                name: z.ZodLiteral<"tesseract">;
+                langs: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEnum<["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"]>, "many">, ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[], ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[]>>>;
+            }, "strict", z.ZodTypeAny, {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            }, {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            }>]>, "many">, ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[], ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[]>>>;
+            packages: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, string[], string[]>>>;
+        }, "strict", z.ZodTypeAny, {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        }, {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        }>>>;
+        dependencies: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    }, "strict", z.ZodTypeAny, {
+        system?: {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        } | null | undefined;
+        dependencies?: string[] | null | undefined;
+    }, {
+        system?: {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        } | null | undefined;
+        dependencies?: string[] | null | undefined;
+    }>>>;
+    functions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+        build: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            system: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                presets: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodUnion<[z.ZodEnum<["ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract", ...("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract")[]]>, z.ZodLiteral<"tesseract">, z.ZodObject<{
+                    name: z.ZodLiteral<"tesseract">;
+                    langs: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEnum<["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"]>, "many">, ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[], ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[]>>>;
+                }, "strict", z.ZodTypeAny, {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                }, {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                }>]>, "many">, ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[], ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[]>>>;
+                packages: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, string[], string[]>>>;
+            }, "strict", z.ZodTypeAny, {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            }, {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            }>>>;
+            dependencies: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        }, "strict", z.ZodTypeAny, {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        }, {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        }>>>;
+    }, "strict", z.ZodTypeAny, {
+        build?: {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        } | null | undefined;
+    }, {
+        build?: {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        } | null | undefined;
+    }>>>>>;
+}, "strict", z.ZodTypeAny, {
+    version?: unknown;
+    services?: unknown;
+    build?: {
+        system?: {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        } | null | undefined;
+        dependencies?: string[] | null | undefined;
+    } | null | undefined;
+    functions?: Record<string, {
+        build?: {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        } | null | undefined;
+    } | null> | null | undefined;
+}, {
+    version?: unknown;
+    services?: unknown;
+    build?: {
+        system?: {
+            presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                name: "tesseract";
+                langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+            })[] | null | undefined;
+            packages?: string[] | null | undefined;
+        } | null | undefined;
+        dependencies?: string[] | null | undefined;
+    } | null | undefined;
+    functions?: Record<string, {
+        build?: {
+            system?: {
+                presets?: ("ffmpeg" | "fonts" | "ghostscript" | "imagemagick" | "libvips" | "poppler" | "tesseract" | {
+                    name: "tesseract";
+                    langs?: ("ara" | "bul" | "ces" | "chi-sim" | "chi-tra" | "dan" | "deu" | "ell" | "eng" | "est" | "fin" | "fra" | "heb" | "hin" | "hrv" | "hun" | "ind" | "ita" | "jpn" | "kat" | "kaz" | "kor" | "lav" | "lit" | "nld" | "nor" | "pol" | "por" | "ron" | "rus" | "slk" | "slv" | "spa" | "srp" | "swe" | "tha" | "tur" | "ukr" | "vie")[] | null | undefined;
+                })[] | null | undefined;
+                packages?: string[] | null | undefined;
+            } | null | undefined;
+            dependencies?: string[] | null | undefined;
+        } | null | undefined;
+    } | null> | null | undefined;
+}>;
+/**
+ * The system block one inquir.yaml document declares for `functionName`:
+ * functions.<name>.build.system first, then build.system; undefined when it
+ * declares neither (null: declared as none). Throws a ZodError on a malformed
+ * document. The platform resolves a deploy the same way, the function's own
+ * inquir.yaml before the project's.
+ */
+export declare function declaredSystemConfig(document: unknown, functionName: string): FunctionSystemConfig | null | undefined;
+/** The keys inquir.yaml may hold at the top level (apps: version, services; functions: build, functions). */
+export declare const INQUIR_YAML_TOP_LEVEL_KEYS: readonly ["version", "services", "build", "functions"];
+/**
+ * JSON Schema (draft-07) of inquir.yaml, for editor completion and
+ * validation (`# yaml-language-server: $schema=…`). The repository keeps it
+ * as schemas/inquir.yaml.json (a test keeps the two equal, and another runs
+ * one fixture set through this schema and the platform validator); apps'
+ * `services` is described loosely here, its validator is the platform's.
+ * Unknown keys are refused everywhere a typo would silently drop packages.
+ */
+export declare const INQUIR_YAML_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://inquir.org/schemas/inquir.yaml.json";
+    readonly title: "inquir.yaml";
+    readonly description: "Inquir Compute configuration: function build settings (system packages) and the application manifest.";
+    readonly type: readonly ["object", "null"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly version: {
+            readonly const: 1;
+            readonly description: "Application manifest version (apps)";
+        };
+        readonly services: {
+            readonly type: "object";
+            readonly description: "Application services (apps): services.web.build, runtime, env";
+        };
+        readonly build: {
+            readonly $ref: "#/definitions/build";
+            readonly description: "Build settings for every function deployed from this project or directory";
+        };
+        readonly functions: {
+            readonly type: readonly ["object", "null"];
+            readonly description: "Per-function settings; a function entry replaces the project default (no merge)";
+            readonly additionalProperties: {
+                readonly type: readonly ["object", "null"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly build: {
+                        readonly $ref: "#/definitions/build";
+                    };
+                };
+            };
+        };
+    };
+    readonly definitions: {
+        readonly build: {
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly system: {
+                    readonly $ref: "#/definitions/system";
+                };
+                readonly dependencies: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 200;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                    };
+                    readonly description: "Language packages, the same list for every runtime: node name@version (npm), python a pip requirement such as name==version, go module@version. Merged into package.json / requirements.txt / go.mod for the build; the same package declared there with another version is an error. Where the platform does not enable it yet, a deploy ignores it with a warning.";
+                };
+            };
+        };
+        readonly system: {
+            readonly description: "OS packages installed into the function image (Debian bookworm; Node.js and Python today, Go coming soon). Removing the block removes them on the next deploy.";
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly presets: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 8;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly anyOf: readonly [{
+                            readonly enum: readonly ["ffmpeg", "fonts", "ghostscript", "imagemagick", "libvips", "poppler", "tesseract"];
+                            readonly description: "A platform preset (Debian bookworm packages plus env)";
+                        }, {
+                            readonly type: "object";
+                            readonly required: readonly ["name"];
+                            readonly additionalProperties: false;
+                            readonly description: "A preset with options (tesseract only)";
+                            readonly properties: {
+                                readonly name: {
+                                    readonly enum: readonly ["tesseract"];
+                                };
+                                readonly langs: {
+                                    readonly type: readonly ["array", "null"];
+                                    readonly maxItems: 8;
+                                    readonly uniqueItems: true;
+                                    readonly items: {
+                                        readonly enum: readonly ["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"];
+                                    };
+                                    readonly description: "Extra OCR languages";
+                                };
+                            };
+                        }];
+                    };
+                };
+                readonly packages: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 10;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^(?!.*\\.\\.)[a-z0-9](?:[a-z0-9+.-]{0,61}[a-z0-9])?(=[A-Za-z0-9.+~:_-]{1,64})?$";
+                        readonly not: {
+                            readonly pattern: "^(systemd.*|init|sudo|sudo-ldap|doas|openssh-server|docker.*|containerd.*|podman.*|runc|crun|linux-image-.*|linux-headers-.*|.*-dkms|apt-transport-.*|apt|dpkg|cron|anacron|rsyslog|udev|dbus)(=.*)?$";
+                        };
+                        readonly description: "Debian package, optionally name=version (daemons, privilege tools, kernels and package tooling are refused)";
+                    };
+                };
+            };
+        };
+    };
+};
+/** GET /functions/:id/system-image (read-only). */
+export interface FunctionSystemImageStatus {
+    mode: 'off' | 'report' | 'on';
+    system: (FunctionSystemConfig & {
+        source?: string;
+    }) | null;
+    source?: string | null;
+    serving: 'base' | 'derived' | 'pending';
+    runtimeKey?: string | null;
+    baseImage?: string | null;
+    distro?: string;
+    aptEpoch?: string;
+    key: string | null;
+    status: 'none' | 'not_built' | 'queued' | 'building' | 'ready' | 'failed' | 'retired';
+    imageRef: string | null;
+    deltaBytes?: number | null;
+    totalBytes?: number | null;
+    shared?: boolean;
+    lock?: string[] | null;
+    error?: string | null;
+    log?: string | null;
+    attempts?: number;
+    finishedAt?: string | null;
+    fallbackImage?: string | null;
+    packages?: string[];
+    env?: Record<string, string>;
+}
+/** GET /functions/system-presets */
+export interface SystemPresetCatalog {
+    mode: 'off' | 'report' | 'on';
+    distro: string;
+    maxPackages: number;
+    presets: Array<{
+        name: string;
+        version: number;
+        title: string;
+        description: string;
+        options?: {
+            langs: string[];
+        };
+        minMemoryMb?: number;
+    }>;
+}
+//# sourceMappingURL=system-packages.d.ts.map

package/dist/system-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-packages.d.ts","sourceRoot":"","sources":["../src/system-packages.ts"],"names":[],"mappings":"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"}