@norskvideo/ctl-commands 0.1.3 → 0.1.5

package/commands.d.ts

@@ -59,6 +59,24 @@ export interface ProductAddOpts {
     licenseFile?: string;
     marketplaceProvider?: string;
 }
+export interface ProductPullOpts {
+    /** Also fetch the product's CUDA sideload bundles. Opt-in: a host having a GPU
+     *  is not consent to use it, so ctl never infers this. */
+    sideload?: boolean;
+    /** Report what would be pulled — including the media image ref
+     *  `sideload fetch --image` takes — without downloading anything. */
+    dryRun?: boolean;
+}
+export interface SideloadFetchOpts {
+    /** Registered product whose default template names the media image. */
+    product?: string;
+    /** Media image ref; needs nothing pulled, so a builder can seed for another host. */
+    image?: string;
+    /** Exactly which bundles to fetch, overriding the selector's default. */
+    bundle?: ("gpu-video" | "gpu-inference")[];
+    /** Fetch locally into this directory instead of through the daemon. */
+    cacheDir?: string;
+}
 export interface TemplateImportOpts {
     name: string;
 }
@@ -70,6 +88,10 @@ export interface InstanceLaunchTemplateOpts {
     hostPorts?: string[];
     hardware?: HardwareProfile;
     sidecars?: string[];
+    /** Operator environment overrides — compose files setting `environment` /
+     *  `env_file` on services that already exist. Separate from `sidecars`,
+     *  which adds services that run. */
+    overrides?: string[];
     cpuPinning?: number[];
     cpuCount?: number;
     containerUser?: string;
@@ -130,6 +152,9 @@ export type Command = {
     kind: "shm.list";
 } | {
     kind: "sideload.status";
+} | {
+    kind: "sideload.fetch";
+    opts: SideloadFetchOpts;
 } | {
     kind: "template.list";
 } | {
@@ -165,6 +190,7 @@ export type Command = {
 } | {
     kind: "product.pull";
     name: string;
+    opts: ProductPullOpts;
 } | {
     kind: "mcp";
 } | {
@@ -309,9 +335,10 @@ export declare const commands: {
             readonly kind: "product.reload";
             readonly name: string;
         }>;
-        readonly pull: LeafCmd<(name: string) => {
+        readonly pull: LeafCmd<(name: string, opts?: ProductPullOpts) => {
             readonly kind: "product.pull";
             readonly name: string;
+            readonly opts: ProductPullOpts;
         }>;
     };
     readonly shm: {
@@ -323,6 +350,10 @@ export declare const commands: {
         readonly status: LeafCmd<() => {
             readonly kind: "sideload.status";
         }>;
+        readonly fetch: LeafCmd<(opts?: SideloadFetchOpts) => {
+            readonly kind: "sideload.fetch";
+            readonly opts: SideloadFetchOpts;
+        }>;
     };
     readonly template: {
         readonly list: LeafCmd<() => {

package/commands.js

@@ -50,13 +50,14 @@ export const commands = {
         exists: leaf("exists <name>", (name) => ({ kind: "product.exists", name })),
         remove: leaf("remove <name>", (name) => ({ kind: "product.remove", name })),
         reload: leaf("reload <name>", (name) => ({ kind: "product.reload", name })),
-        pull: leaf("pull <name>", (name) => ({ kind: "product.pull", name })),
+        pull: leaf("pull <name>", (name, opts = {}) => ({ kind: "product.pull", name, opts })),
     },
     shm: {
         list: leaf("list", () => ({ kind: "shm.list" })),
     },
     sideload: {
         status: leaf("status", () => ({ kind: "sideload.status" })),
+        fetch: leaf("fetch", (opts = {}) => ({ kind: "sideload.fetch", opts })),
     },
     template: {
         list: leaf("list", () => ({ kind: "template.list" })),

package/format.js

@@ -77,11 +77,13 @@ export function toArgv(cmd) {
         case "product.reload":
             return ["product", "reload", cmd.name];
         case "product.pull":
-            return ["product", "pull", cmd.name];
+            return ["product", "pull", cmd.name, ...formatOpts(cmd.opts)];
         case "shm.list":
             return ["shm", "list"];
         case "sideload.status":
             return ["sideload", "status"];
+        case "sideload.fetch":
+            return ["sideload", "fetch", ...formatOpts(cmd.opts)];
         case "template.list":
             return ["template", "list"];
         case "template.show":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-commands",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "exports": {
     ".": {