@foresthubai/workflow-core 0.4.3 → 0.4.4

package/dist/deploy/spec.js

@@ -0,0 +1,343 @@
+// The spec resolver: (workflow + bindings) -> DeploymentSpec. The shared
+// "packaging library" the migration doc calls for — component-set derivation
+// and device-grant resolution computed once here, frozen into the contract spec,
+// so neither renderer (OSS one-shot CLI, paid ranger) re-derives them.
+//
+// Every produced field is typed against the generated deployment contract, so a
+// contract change stops this compiling — the drift guard for the spec.
+import { serialize } from "../workflow";
+import { deriveRequirements } from "./requirements";
+// Mount path for the engine's memory volume — matches the image's ENGINE_MEMORY_DIR
+// default, so the renderer mounts here without wiring an env var.
+const ENGINE_MEMORY_PATH = "/var/lib/foresthub/memory";
+// Hands out stable, collision-free ref names. Same dedup key -> same ref (the
+// engine builds that resource once); distinct keys preferring the same name get
+// suffixed (-2, -3, ...) so the flat ref namespace stays unambiguous.
+class RefAllocator {
+    byKey = new Map();
+    used = new Set();
+    alloc(key, hint) {
+        const existing = this.byKey.get(key);
+        if (existing)
+            return existing;
+        let ref = hint;
+        for (let n = 2; this.used.has(ref); n++)
+            ref = `${hint}-${n}`;
+        this.used.add(ref);
+        this.byKey.set(key, ref);
+        return ref;
+    }
+}
+// Last path/URL segment, reduced to a safe ref token.
+// "/dev/gpiochip0" -> "gpiochip0", ".../iio:device0" -> "iio:device0".
+function basename(p) {
+    const tail = p.replace(/\/+$/, "").split("/").pop() ?? p;
+    return tail.replace(/[^A-Za-z0-9._:-]/g, "-") || "res";
+}
+// Host of a broker URL, for a readable ref. "mqtt" when unparseable.
+function brokerHost(url) {
+    try {
+        return new URL(url).hostname || "mqtt";
+    }
+    catch {
+        return "mqtt";
+    }
+}
+// Compose/container service name for an on-device model's llama-server sidecar.
+// Single source of truth: the resolver derives the provider URL from it and the
+// renderer emits a service with the same name — they must agree or the URL
+// points at a service that doesn't exist.
+export function sidecarServiceName(modelId) {
+    const slug = modelId
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return `llama-${slug || "model"}`;
+}
+// Why an on-device model filename is unacceptable, or null when fine. A name
+// check only — the file doesn't exist yet at spec time. Shared with the prompts
+// so input collection and the resolver reject the same input.
+export function ggufNameError(name) {
+    const t = (name ?? "").trim();
+    if (!t)
+        return "a model filename is required";
+    if (!t.toLowerCase().endsWith(".gguf"))
+        return "must be a .gguf file (llama-server only loads GGUF)";
+    if (t.includes("/"))
+        return "just the filename, not a path — the file goes in ./models/";
+    return null;
+}
+// A physical address belongs to exactly one channel — the engine doesn't police
+// this and would silently let the last claimer win. Same key = collision;
+// sharing just a chip path is fine (one chip, many lines), except serial where
+// the path IS the device. Exported so input collection (prompts) can reject a
+// duplicate at entry with the same identity the resolver validates against.
+export function hardwareAddressKey(family, chipOrDevice, index) {
+    const dev = chipOrDevice.trim();
+    return family === "serial" ? `serial:${dev}` : `${family}:${dev}:${index}`;
+}
+// The same address phrased for an error message: "/dev/gpiochip0 line 17".
+export function hardwareAddressLabel(family, chipOrDevice, index) {
+    const dev = chipOrDevice.trim();
+    if (family === "serial")
+        return dev;
+    return `${dev} ${family === "gpio" ? "line" : "channel"} ${index}`;
+}
+// One message per channel whose address an earlier channel already claimed.
+// Incomplete bindings are skipped (completeness is checked separately).
+export function hardwareConflicts(channels, bindings) {
+    const conflicts = [];
+    const claimed = new Map(); // address key -> channel id holding it
+    for (const ch of channels) {
+        const b = bindings[ch.id];
+        if (!b?.chipOrDevice || (ch.addressable && b.index === undefined))
+            continue;
+        const key = hardwareAddressKey(ch.family, b.chipOrDevice, b.index);
+        const holder = claimed.get(key);
+        if (holder) {
+            conflicts.push(`hardware "${ch.id}": ${hardwareAddressLabel(ch.family, b.chipOrDevice, b.index)} is already used by "${holder}"`);
+        }
+        else {
+            claimed.set(key, ch.id);
+        }
+    }
+    return conflicts;
+}
+// One message per binding carrying a field its family doesn't have (`baud` is
+// serial-only, `index` is everything-but-serial). Usually a mixed-up channel id
+// in a machine-written binding set — reject loudly instead of ignoring.
+export function familyMismatches(channels, bindings) {
+    const mismatches = [];
+    for (const ch of channels) {
+        const b = bindings[ch.id];
+        if (!b)
+            continue;
+        if (ch.family !== "serial" && b.baud !== undefined) {
+            mismatches.push(`hardware "${ch.id}": "baud" only applies to serial channels (this is a ${ch.family} channel)`);
+        }
+        if (ch.family === "serial" && b.index !== undefined) {
+            mismatches.push(`hardware "${ch.id}": "index" does not apply to serial channels (the device path is the full address)`);
+        }
+    }
+    return mismatches;
+}
+// Exhaustiveness guard over HardwareFamily — a new family breaks compilation
+// here until handled.
+function assertNeverFamily(f) {
+    throw new Error(`unhandled hardware family: ${String(f)}`);
+}
+// Mirror of the engine's deploy-layer validation: every declared resource must
+// carry a binding or the engine fatals at boot. Collects ALL gaps so a caller
+// sees them at once. Throws on any gap — the last guard before a dead spec.
+export function assertDeployable(req, inputs) {
+    const missing = [];
+    for (const ch of req.hardwareChannels) {
+        const b = inputs.hardware[ch.id];
+        if (!b?.chipOrDevice)
+            missing.push(`hardware "${ch.id}": device path`);
+        else if (ch.addressable && b.index === undefined)
+            missing.push(`hardware "${ch.id}": index`);
+    }
+    for (const ch of req.mqttChannels) {
+        if (!inputs.mqtt[ch.id]?.brokerUrl)
+            missing.push(`mqtt "${ch.id}": broker URL`);
+    }
+    for (const m of req.customModels) {
+        const b = inputs.models[m.id];
+        if (b?.location === "device") {
+            const err = ggufNameError(b.modelFile);
+            if (err)
+                missing.push(`model "${m.id}": ${err}`);
+        }
+        else if (!b?.url) {
+            missing.push(`model "${m.id}": endpoint URL`);
+        }
+    }
+    missing.push(...hardwareConflicts(req.hardwareChannels, inputs.hardware));
+    missing.push(...familyMismatches(req.hardwareChannels, inputs.hardware));
+    if (missing.length > 0) {
+        throw new Error(`invalid deploy config:\n  - ${missing.join("\n  - ")}`);
+    }
+}
+// One compose service per name: a duplicate name would collapse two components
+// onto one service and silently drop the loser. Names only — same image under
+// different names is legitimate (e.g. two grafanas).
+function assertNoNameCollisions(components) {
+    const seen = new Set();
+    for (const c of components) {
+        if (seen.has(c.name))
+            throw new Error(`duplicate component name "${c.name}"`);
+        seen.add(c.name);
+    }
+}
+// buildDeploymentSpec resolves a workflow plus its bindings into a complete,
+// contract-defined DeploymentSpec. Throws (via assertDeployable) if any declared
+// resource is unbound. The embedded engine config carries the serialized (and
+// thereby pruned) workflow; device grants and privileged are resolved here.
+// customComponents are operator-authored containers, merged in verbatim.
+export function buildDeploymentSpec(workflow, inputs, meta, customComponents = []) {
+    const req = deriveRequirements(workflow);
+    assertDeployable(req, inputs);
+    const refs = new RefAllocator();
+    const resourceSecrets = {};
+    // DeviceManifest is split per family; accumulate each separately, attach only
+    // the non-empty ones (all slots optional).
+    const gpios = {};
+    const adcs = {};
+    const dacs = {};
+    const pwms = {};
+    const serials = {};
+    const externalResources = {};
+    const mapping = {};
+    // Container-level hardware access, resolved once: cdev nodes (GPIO, UART) map
+    // one-to-one into the engine component's devices; sysfs families (ADC/DAC/PWM)
+    // have no single node, so the engine container runs privileged.
+    const cdev = new Set();
+    let privileged = false;
+    // Hardware: one driver instance per distinct device path (dedup by
+    // family+path); one mapping per channel carrying its per-channel index.
+    for (const ch of req.hardwareChannels) {
+        const b = inputs.hardware[ch.id];
+        if (!b)
+            throw new Error(`unbound hardware channel ${ch.id}`); // unreachable after assertDeployable
+        const dev = b.chipOrDevice;
+        const ref = refs.alloc(`hw:${ch.family}:${dev}`, basename(dev));
+        switch (ch.family) {
+            case "gpio":
+                gpios[ref] = { chip: dev };
+                cdev.add(dev);
+                break;
+            case "serial":
+                serials[ref] = b.baud ? { device: dev, baud: b.baud } : { device: dev };
+                cdev.add(dev);
+                break;
+            case "pwm":
+                pwms[ref] = { chip: dev };
+                privileged = true;
+                break;
+            case "adc":
+                adcs[ref] = { device: dev };
+                privileged = true;
+                break;
+            case "dac":
+                dacs[ref] = { device: dev };
+                privileged = true;
+                break;
+            default:
+                return assertNeverFamily(ch.family);
+        }
+        if (ch.addressable && b.index !== undefined)
+            mapping[ch.id] = { ref, index: b.index };
+        else
+            mapping[ch.id] = { ref };
+    }
+    // MQTT: one connection per distinct config (dedup by full content — same
+    // broker, different creds is a different resource). No index.
+    for (const ch of req.mqttChannels) {
+        const b = inputs.mqtt[ch.id];
+        if (!b)
+            throw new Error(`unbound mqtt channel ${ch.id}`); // unreachable
+        const conn = { type: "mqtt", brokerUrl: b.brokerUrl };
+        if (b.username)
+            conn.username = b.username;
+        // The password is a secret — kept out of conn (and thus the spec). It still
+        // participates in the dedup key, so two channels differing only by password
+        // don't collapse onto one ref (and one shared secret).
+        const ref = refs.alloc(`mqtt:${JSON.stringify(conn)}:${b.password ?? ""}`, `mqtt-${brokerHost(b.brokerUrl)}`);
+        externalResources[ref] = conn;
+        mapping[ch.id] = { ref };
+        if (b.password)
+            resourceSecrets[ref] = { ...resourceSecrets[ref], password: b.password };
+    }
+    // Custom models: one self-hosted provider per model id. A device model points
+    // at the sidecar we run (over the container network, no key) and gets its own
+    // llama-server component; a network model points at the operator's endpoint and
+    // runs no component here. `model` is left off — the endpoint serves under the
+    // workflow id (no upstream-name aliasing yet).
+    const llamaComponents = [];
+    for (const m of req.customModels) {
+        const b = inputs.models[m.id];
+        if (!b)
+            throw new Error(`unbound model ${m.id}`); // unreachable after assertDeployable
+        const ref = refs.alloc(`model:${m.id}`, basename(m.id));
+        mapping[m.id] = { ref };
+        if (b.location === "device") {
+            const port = b.port ?? 8080;
+            const service = sidecarServiceName(m.id);
+            externalResources[ref] = { type: "selfhosted", url: `http://${service}:${port}` };
+            // The whole config is CLI flags, so it rides in `command` (no config blob).
+            // ctx-size is frozen here — retuning it is a re-deploy, not an env edit.
+            llamaComponents.push({
+                name: service,
+                image: meta.llamaServerImage,
+                command: [
+                    "--model",
+                    `/models/${b.modelFile}`,
+                    "--host",
+                    "0.0.0.0",
+                    "--port",
+                    String(port),
+                    "--ctx-size",
+                    String(b.ctxSize ?? 4096),
+                ],
+                volumes: ["./models:/models:ro"],
+            });
+        }
+        else {
+            externalResources[ref] = { type: "selfhosted", url: b.url };
+            // The endpoint bearer is a secret — out of the spec, returned separately.
+            if (b.apiKey)
+                resourceSecrets[ref] = { apiKey: b.apiKey };
+        }
+    }
+    const manifest = {};
+    if (Object.keys(gpios).length)
+        manifest.gpios = gpios;
+    if (Object.keys(adcs).length)
+        manifest.adcs = adcs;
+    if (Object.keys(dacs).length)
+        manifest.dacs = dacs;
+    if (Object.keys(pwms).length)
+        manifest.pwms = pwms;
+    if (Object.keys(serials).length)
+        manifest.serials = serials;
+    // The engine's boot input. workflow is serialized (and thereby pruned) from
+    // the domain. The optional sections attach only when non-empty — an absent
+    // section is correct, not a gap, and matches what the engine skips.
+    const config = { workflow: serialize(workflow) };
+    if (Object.keys(mapping).length)
+        config.mapping = mapping;
+    if (Object.keys(externalResources).length)
+        config.externalResources = externalResources;
+    if (Object.keys(manifest).length)
+        config.manifest = manifest;
+    // The engine component. configPath is omitted (the image reads the convention
+    // path it defaults to); the config blob is mounted there by the renderer. cdev
+    // nodes pass through as devices; sysfs families force privileged; either case
+    // needs root to open the root-owned nodes the nonroot image otherwise can't.
+    const engine = {
+        name: "engine",
+        image: meta.engineImage,
+        pull: "never", // built locally before deploy, in no registry
+        config,
+        volumes: [`engine-memory:${ENGINE_MEMORY_PATH}`],
+    };
+    if (cdev.size > 0)
+        engine.devices = [...cdev];
+    if (privileged)
+        engine.privileged = true;
+    if (cdev.size > 0 || privileged)
+        engine.user = "0:0";
+    const components = [engine, ...llamaComponents, ...customComponents];
+    assertNoNameCollisions(components);
+    const spec = {
+        schemaVersion: 1,
+        id: meta.id,
+        status: meta.status,
+        components,
+    };
+    if (meta.createdAt)
+        spec.createdAt = meta.createdAt;
+    return { spec, resourceSecrets };
+}
+//# sourceMappingURL=spec.js.map

package/dist/deploy/spec.js.map

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

package/dist/node/OutputNode.js

@@ -45,9 +45,9 @@ export const SerialWriteNodeDefinition = {
         {
             id: "portReference",
             label: "Port",
-            description: "Serial port to write to",
+            description: "Serial port or log channel to write to",
             type: "channelSelect",
-            channelType: ["UART"],
+            channelType: ["UART", "LOG"],
         },
         {
             id: "value",

package/dist/node/OutputNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"OutputNode.js","sourceRoot":"","sources":["../../src/node/OutputNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAuBpD,mBAAmB;AAEnB,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,YAAY,CAAC,MAAM;IAC7B,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACnB,WAAW,EAAE,qBAAqB;IAClC,UAAU,EAAE;QACV;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,IAAkC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACrH;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACtC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;aACrC;SACF;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,gCAAgC;YAC7C,IAAI,EAAE,YAAY;YAClB,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,IAAkC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YACzG,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;SAC9D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,YAAY,CAAC,MAAM;IAC7B,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACtB,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE;QACV;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,CAAC,MAAM,CAAC;SACtB;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,mCAAmC;YAChD,IAAI,EAAE,YAAY;YAClB,cAAc,EAAE,QAAQ;YACxB,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChE;KACF;CACF,CAAC"}
+{"version":3,"file":"OutputNode.js","sourceRoot":"","sources":["../../src/node/OutputNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAuBpD,mBAAmB;AAEnB,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,YAAY,CAAC,MAAM;IAC7B,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACnB,WAAW,EAAE,qBAAqB;IAClC,UAAU,EAAE;QACV;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,IAAkC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACrH;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACtC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;aACrC;SACF;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,gCAAgC;YAC7C,IAAI,EAAE,YAAY;YAClB,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,IAAkC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YACzG,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;SAC9D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,YAAY,CAAC,MAAM;IAC7B,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACtB,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE;QACV;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,wCAAwC;YACrD,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;SAC7B;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,mCAAmC;YAChD,IAAI,EAAE,YAAY;YAClB,cAAc,EAAE,QAAQ;YACxB,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChE;KACF;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foresthubai/workflow-core",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Headless workflow types + serialization + pure validator. No React, no browser.",
   "license": "Apache-2.0",
   "repository": {
@@ -89,7 +89,7 @@
     "access": "public"
   },
   "scripts": {
-    "generate": "openapi-typescript ../../contract/workflow.yaml -o src/api/workflow.ts",
+    "generate": "openapi-typescript ../../contract/workflow.yaml -o src/api/workflow.ts && openapi-typescript ../../contract/deployment.yaml -o src/api/deployment.ts && openapi-typescript ../../contract/engine.yaml -o src/api/engine.ts",
     "build": "tsc -b",
     "prepublishOnly": "npm run build",
     "test": "vitest run"

package/src/api/deployment.ts

@@ -0,0 +1,67 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export type paths = Record<string, never>;
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @description The resolved set of components to run on one device for one deployment, plus its identity and lifecycle status. Every decision (which components run, their images, device access, config file content) is computed once by the packaging step and frozen here, so a renderer renders it without re-deriving anything. The spec is the self-contained, restartable source of truth: spec + cached images + device-local env files are all a device needs to (re)start offline. */
+        DeploymentSpec: {
+            /** @description Spec format version. Bumped when the spec shape changes incompatibly. */
+            schemaVersion: number;
+            /** @description Stable identifier for this deployment, used as the rollback/history key. */
+            id: string;
+            /**
+             * Format: date-time
+             * @description When the packaging step produced this spec. Stamped by the producer; drives deployment history ordering.
+             */
+            createdAt?: string;
+            /**
+             * @description Whether this spec is the one a device should currently be running. The active spec is the reconcile/render target; inactive specs are history or rollback candidates.
+             * @enum {string}
+             */
+            status: "active" | "inactive";
+            /** @description The components to run for this deployment, each a fully resolved container. The list is unordered: components do not declare dependencies on one another. Coupling between components (e.g. the engine reaching an on-device model) is expressed as a URL the consumer connects to at runtime with retry, never as a start-ordering edge, so the model works identically whether the dependency runs on this device or another one. The packaging step expands any one-to-many component (e.g. one llama-server image per on-device model) into separate concrete entries here. */
+            components: components["schemas"]["DeployComponent"][];
+        };
+        /** @description One resolved container to run as part of a deployment. Generic by design: it carries only runtime-neutral container knobs the renderer passes through, never a component-typed config schema. A component's own config shape lives in that component's contract (e.g. the engine's EngineConfig in engine.yaml), referenced directly by whoever produces and consumes that config; this spec only transports the rendered config content as opaque file bytes. Adding a component, OSS or paid, means producing one of these, not editing this contract. */
+        DeployComponent: {
+            /** @description Unique component name within the deployment. Doubles as the container/service name the renderer emits, the basename of any device-local env file the operator supplies ("<name>.env"), and the address other components reach this one by over the container network. */
+            name: string;
+            /** @description OCI image reference, frozen at packaging time. OSS: a local convention tag built before deploy, e.g. "foresthub/engine:local". Paid: a registry-qualified, digest-pinned ref the ranger resolves and freezes, e.g. "ghcr.io/foresthubai/engine:1.2.0@sha256:abc123...". Which registry and how the daemon authenticates to it are device-side config, not part of this string. */
+            image: string;
+            /**
+             * @description Image pull policy, emitted as the renderer's pull_policy. Omit to default to "missing" (pull only if absent locally — correct for any registry image). Use "never" for an image built locally and present in no registry (the OSS engine); "always" re-pulls on every start.
+             * @enum {string}
+             */
+            pull?: "always" | "missing" | "never";
+            /** @description Overrides the image's default command/entrypoint arguments, in exec form — one token per element, e.g. ["--model", "/models/x.gguf", "--ctx-size", "4096"]. Runtime-neutral: every runtime can override a container's command. Lets a CLI-flag-configured image (llama-server and many third-party servers) run unwrapped — the packaging step puts the flags here instead of baking a JSON-to-flags translation into a wrapper image. Omit to use the image's own default command. */
+            command?: string[];
+            /** @description Structured config for the component, frozen at packaging time. The renderer serializes it to JSON, writes it to a device-local file, bind-mounts that file read-only at configPath, and hashes it into a recreate trigger (compose does not track bind-mount content). How the component interprets the file — read it as JSON, convert it to CLI args, expand it into several native config files — is the image's entrypoint, not this spec; a non-JSON image is wrapped with a thin entrypoint that converts. Omit for a component configured only by its image defaults and its device-local env. Never contains secrets; those arrive as environment variables from the device-local env file. */
+            config?: {
+                [key: string]: unknown;
+            };
+            /** @description Absolute in-container path to mount the config file at. Omit to use the convention default "/etc/foresthub/config.json", which first-party components read by default. Set it to drop in a JSON-configured third-party image that reads its config elsewhere, e.g. "/app/config.json". Ignored when config is absent. */
+            configPath?: string;
+            /** @description Persistent or host volume mounts in compose short form, e.g. "engine-memory:/var/lib/foresthub/memory" or "./models:/models:ro". Empty when the component is stateless and mounts nothing beyond its config files. */
+            volumes?: string[];
+            /** @description Resolved host device nodes to pass into the container, e.g. "/dev/gpiochip0", "/dev/ttyUSB0". One entry per distinct cdev node the component binds, computed once from the workflow's hardware against the device manifest. Empty when the component uses no cdev hardware; ADC/DAC/PWM have no single node and go through privileged instead. */
+            devices?: string[];
+            /** @description Host port publishings in compose short form, e.g. "1883:1883". Empty when the component is reached only over the internal container network (the common case: components address each other by name, no host exposure needed). */
+            ports?: string[];
+            /** @description Run the container privileged. Required for hardware with no single device node to grant (ADC/DAC/PWM use sysfs paths like /sys/class/pwm, /sys/bus/iio). False when the component uses only cdev hardware (use devices) or none. */
+            privileged?: boolean;
+            /** @description Container user as "UID[:GID]", e.g. "0:0" for root. The renderer passes it through verbatim. Needed when a nonroot image must reach root-owned resources: the engine image runs nonroot but has to open the root-owned device nodes / sysfs files granted via devices/privileged, so its component sets "0:0". Omit to use the image's own default user. */
+            user?: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;