@start9labs/start-sdk 0.3.6-beta.1 → 0.3.6-beta.11

package/package/lib/StartSdk.d.ts

@@ -1,7 +1,6 @@
-/// <reference types="node" />
 import { Value } from "../../base/lib/actions/input/builder/value";
-import { InputSpec, ExtractInputSpecType, LazyBuild } from "../../base/lib/actions/input/builder/inputSpec";
-import { DefaultString, ListValueSpecText, Pattern, RandomString, UniqueBy, ValueSpecDatetime, ValueSpecText } from "../../base/lib/actions/input/inputSpecTypes";
+import { InputSpec, LazyBuild } from "../../base/lib/actions/input/builder/inputSpec";
+import { DefaultString, ListValueSpecText, Pattern, RandomString, ValueSpecDatetime, ValueSpecText } from "../../base/lib/actions/input/inputSpecTypes";
 import { Variants } from "../../base/lib/actions/input/builder/variants";
 import { Action, Actions } from "../../base/lib/actions/setupActions";
 import { SyncOptions, ServiceInterfaceId, PackageId, HealthReceipt, ServiceInterfaceType, Effects } from "../../base/lib/types";
@@ -23,6 +22,7 @@ import { nullIfEmpty } from "./util";
 import { CommandOptions, MountOptions, SubContainer } from "./util/SubContainer";
 import { Mounts } from "./mainFn/Mounts";
 import * as T from "../../base/lib/types";
+import { ExposedStorePaths } from "./store/setupExposeStore";
 import { PathBuilder } from "../../base/lib/util/PathBuilder";
 import { CheckDependencies } from "../../base/lib/dependencies/dependencies";
 import { GetSslCertificate } from "./util";
@@ -42,44 +42,45 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
     build(isReady: AnyNeverCond<[Manifest, Store], "Build not ready", true>): {
         action: {
             run: <Input extends Record<string, unknown>>(options: {
-                effects: Effects;
-                actionId: string;
-                input?: actions.RunActionInput<Input> | undefined;
+                effects: T.Effects;
+                actionId: T.ActionId;
+                input?: actions.RunActionInput<Input>;
             }) => Promise<T.ActionResult | null>;
-            request: <T extends Action<string, any, any>>(effects: Effects, packageId: string, action: T, severity: T.ActionSeverity, options?: actions.ActionRequestOptions<T> | undefined) => Promise<null>;
-            requestOwn: <T_1 extends Action<string, Store, any>>(effects: Effects, action: T_1, severity: T.ActionSeverity, options?: actions.ActionRequestOptions<T_1> | undefined) => Promise<null>;
+            request: <T extends Action<T.ActionId, any, any>>(effects: T.Effects, packageId: T.PackageId, action: T, severity: T.ActionSeverity, options?: actions.ActionRequestOptions<T>) => Promise<null>;
+            requestOwn: <T extends Action<T.ActionId, Store, any>>(effects: T.Effects, action: T, severity: T.ActionSeverity, options?: actions.ActionRequestOptions<T>) => Promise<null>;
             clearRequest: (effects: T.Effects, ...replayIds: string[]) => Promise<null>;
         };
-        checkDependencies: <DependencyId extends keyof Manifest["dependencies"] & string = keyof Manifest["dependencies"] & string>(effects: Effects, packageIds?: DependencyId[] | undefined) => Promise<CheckDependencies<DependencyId>>;
+        checkDependencies: <DependencyId extends keyof Manifest["dependencies"] & PackageId = keyof Manifest["dependencies"] & PackageId>(effects: Effects, packageIds?: DependencyId[]) => Promise<CheckDependencies<DependencyId>>;
         serviceInterface: {
             getOwn: <E extends Effects>(effects: E, id: ServiceInterfaceId) => import("./util").GetServiceInterface;
-            get: <E_1 extends Effects>(effects: E_1, opts: {
+            get: <E extends Effects>(effects: E, opts: {
                 id: ServiceInterfaceId;
                 packageId: PackageId;
             }) => import("./util").GetServiceInterface;
-            getAllOwn: <E_2 extends Effects>(effects: E_2) => import("../../base/lib/util/getServiceInterfaces").GetServiceInterfaces;
-            getAll: <E_3 extends Effects>(effects: E_3, opts: {
+            getAllOwn: <E extends Effects>(effects: E) => import("../../base/lib/util/getServiceInterfaces").GetServiceInterfaces;
+            getAll: <E extends Effects>(effects: E, opts: {
                 packageId: PackageId;
             }) => import("../../base/lib/util/getServiceInterfaces").GetServiceInterfaces;
         };
         store: {
-            get: <E_4 extends Effects, StoreValue = unknown>(effects: E_4, packageId: string, path: PathBuilder<Store, StoreValue>) => import("./store/getStore").GetStore<Store, StoreValue>;
-            getOwn: <E_5 extends Effects, StoreValue_1 = unknown>(effects: E_5, path: PathBuilder<Store, StoreValue_1>) => import("./store/getStore").GetStore<Store, StoreValue_1>;
-            setOwn: <E_6 extends Effects, Path extends import("../../base/lib/util/PathBuilder").PathBuilderStored<Store, unknown>>(effects: E_6, path: Path, value: Path extends PathBuilder<Store, infer Value_1> ? Value_1 : never) => Promise<null>;
+            get: <E extends Effects, StoreValue = unknown>(effects: E, packageId: string, path: PathBuilder<Store, StoreValue>) => import("./store/getStore").GetStore<Store, StoreValue>;
+            getOwn: <E extends Effects, StoreValue = unknown>(effects: E, path: PathBuilder<Store, StoreValue>) => import("./store/getStore").GetStore<Store, StoreValue>;
+            setOwn: <E extends Effects, Path extends PathBuilder<Store, unknown>>(effects: E, path: Path, value: Path extends PathBuilder<Store, infer Value> ? Value : never) => Promise<null>;
         };
-        host: {
-            multi: (effects: Effects, id: string) => MultiHost;
+        MultiHost: {
+            of: (effects: Effects, id: string) => MultiHost;
         };
         nullIfEmpty: typeof nullIfEmpty;
+        useEntrypoint: (overrideCmd?: string[]) => T.UseEntrypoint;
         runCommand: <A extends string>(effects: Effects, image: {
-            id: keyof Manifest["images"] & T.ImageId;
+            imageId: keyof Manifest["images"] & T.ImageId;
             sharedRun?: boolean;
         }, command: T.CommandType, options: CommandOptions & {
             mounts?: {
                 path: string;
                 options: MountOptions;
-            }[] | undefined;
-        }, name: string) => Promise<{
+            }[];
+        }, name?: string) => Promise<{
             stdout: string | Buffer;
             stderr: string | Buffer;
         }>;
@@ -145,7 +146,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
               )
              * ```
             */
-            withInput: <Id extends string, InputSpecType extends Record<string, any> | InputSpec<any, never> | InputSpec<any, any>, Type extends ExtractInputSpecType<InputSpecType> = ExtractInputSpecType<InputSpecType>>(id: Id, metadata: MaybeFn<Omit<T.ActionMetadata, "hasInput">>, inputSpec: InputSpecType, getInput: GetInput<Type>, run: Run<Type>) => Action<Id, unknown, InputSpecType>;
+            withInput: <Id extends T.ActionId, InputSpecType extends Record<string, any> | InputSpec<any, any> | InputSpec<any, never>>(id: Id, metadata: MaybeFn<Omit<T.ActionMetadata, "hasInput">>, inputSpec: InputSpecType, getInput: GetInput<InputSpecType>, run: Run<InputSpecType>) => Action<Id, unknown, InputSpecType>;
             /**
              * @description Use this function to create an action that does not accept form input
              * @param id - a unique ID for this action
@@ -190,7 +191,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
               )
              * ```
             */
-            withoutInput: <Id_1 extends string>(id: Id_1, metadata: MaybeFn<Omit<T.ActionMetadata, "hasInput">>, run: Run<{}>) => Action<Id_1, unknown, {}>;
+            withoutInput: <Id extends T.ActionId>(id: Id, metadata: MaybeFn<Omit<T.ActionMetadata, "hasInput">>, run: Run<{}>) => Action<Id, unknown, {}>;
         };
         inputSpecConstants: {
             smtpInputSpec: Value<import("../../base/lib/actions/input/builder/variants").UnionRes<never, {
@@ -229,7 +230,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             id: 'ui',
             description: 'The primary web app for this service.',
             type: 'ui',
-            hasPrimary: false,
             masked: false,
             schemeOverride: null,
             username: null,
@@ -245,8 +245,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             id: string;
             /** The human readable description. */
             description: string;
-            /** No effect until StartOS v0.4.0. If true, forces the user to select one URL (i.e. .onion, .local, or IP address) as the primary URL. This is needed by some services to function properly. */
-            hasPrimary: boolean;
             /** Affects how the interface appears to the user. One of: 'ui', 'api', 'p2p'. If 'ui', the user will see a "Launch UI" button */
             type: ServiceInterfaceType;
             /** (optional) prepends the provided username to all URLs. */
@@ -266,8 +264,8 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             /** TODO Aiden how would someone include a password in the URL? Whether or not to mask the URLs on the screen, for example, when they contain a password */
             masked: boolean;
         }) => ServiceInterfaceBuilder;
-        getSystemSmtp: <E_7 extends Effects>(effects: E_7) => GetSystemSmtp;
-        getSslCerificate: <E_8 extends Effects>(effects: E_8, hostnames: string[], algorithm?: T.Algorithm) => GetSslCertificate;
+        getSystemSmtp: <E extends Effects>(effects: E) => GetSystemSmtp;
+        getSslCerificate: <E extends Effects>(effects: E, hostnames: string[], algorithm?: T.Algorithm) => GetSslCertificate;
         HealthCheck: {
             of(effects: T.Effects, o: Omit<HealthCheckParams, "effects">): HealthReceipt;
         };
@@ -372,13 +370,13 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
          * ```
          */
         setupDependencies: (fn: (options: {
-            effects: Effects;
+            effects: T.Effects;
         }) => Promise<T.CurrentDependenciesResult<Manifest>>) => (options: {
-            effects: Effects;
+            effects: T.Effects;
         }) => Promise<null>;
         setupInit: (versions: VersionGraph<string>, install: Install<Manifest, Store>, uninstall: import("./inits/setupUninstall").Uninstall<Manifest, Store>, setServiceInterfaces: UpdateServiceInterfaces<any>, setDependencies: (options: {
-            effects: Effects;
-        }) => Promise<void | null | undefined>, actions: Actions<Store, any>, exposedStore: T.ExposedStorePaths) => {
+            effects: T.Effects;
+        }) => Promise<null | void | undefined>, actions: Actions<Store, any>, exposedStore: ExposedStorePaths) => {
             packageInit: T.ExpectedExports.packageInit;
             packageUninit: T.ExpectedExports.packageUninit;
             containerInit: T.ExpectedExports.containerInit;
@@ -418,7 +416,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             inputSpecSpec,
             async ({ effects, input }) => {
               // ** UI multi-host **
-              const uiMulti = sdk.host.multi(effects, 'ui-multi')
+              const uiMulti = sdk.MultiHost.of(effects, 'ui-multi')
               const uiMultiOrigin = await uiMulti.bindPort(80, {
                 protocol: 'http',
               })
@@ -428,7 +426,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
                 id: 'primary-ui',
                 description: 'The primary web app for this service.',
                 type: 'ui',
-                hasPrimary: false,
                 masked: false,
                 schemeOverride: null,
                 username: null,
@@ -441,7 +438,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
                 id: 'admin-ui',
                 description: 'The admin web app for this service.',
                 type: 'ui',
-                hasPrimary: false,
                 masked: false,
                 schemeOverride: null,
                 username: null,
@@ -452,7 +448,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
               const uiReceipt = await uiMultiOrigin.export([primaryUi, adminUi])
          
               // ** API multi-host **
-              const apiMulti = sdk.host.multi(effects, 'api-multi')
+              const apiMulti = sdk.MultiHost.of(effects, 'api-multi')
               const apiMultiOrigin = await apiMulti.bindPort(5959, {
                 protocol: 'http',
               })
@@ -462,7 +458,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
                 id: 'api',
                 description: 'The advanced API for this service.',
                 type: 'api',
-                hasPrimary: false,
                 masked: false,
                 schemeOverride: null,
                 username: null,
@@ -532,11 +527,24 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
               })
              * ```
              */
-            of: <Spec extends Record<string, Value<any, never> | Value<any, Store>>>(spec: Spec) => InputSpec<{ [K in keyof Spec]: Spec[K] extends Value<infer T_2, never> | Value<infer T_2, Store> ? T_2 : never; }, Store>;
+            of: <Spec extends Record<string, Value<any, Store> | Value<any, never>>>(spec: Spec) => InputSpec<{ [K in keyof Spec]: Spec[K] extends Value<infer T, never> | Value<infer T, Store> ? T : never; }, Store>;
         };
         Daemons: {
             of(effects: Effects, started: (onTerm: () => PromiseLike<void>) => PromiseLike<null>, healthReceipts: HealthReceipt[]): Daemons<Manifest, never>;
         };
+        SubContainer: {
+            of(effects: Effects, image: {
+                imageId: T.ImageId & keyof Manifest["images"];
+                sharedRun?: boolean;
+            }, name: string): Promise<SubContainer>;
+            with<T>(effects: T.Effects, image: {
+                imageId: T.ImageId & keyof Manifest["images"];
+                sharedRun?: boolean;
+            }, mounts: {
+                options: MountOptions;
+                path: string;
+            }[], name: string, fn: (subContainer: SubContainer) => Promise<T>): Promise<T>;
+        };
         List: {
             /**
              * @description Create a list of text inputs.
@@ -549,78 +557,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
              * @param a - attributes of the list itself.
              * @param aSpec - attributes describing each member of the list.
              */
-            obj: <Type_1 extends Record<string, any>>(a: {
-                name: string;
-                description?: string | null;
-                /** Presents a warning before adding/removing/editing a list item. */
-                warning?: string | null;
-                default?: [];
-                minLength?: number | null;
-                maxLength?: number | null;
-            }, aSpec: {
-                spec: InputSpec<Type_1, Store>;
-                /**
-                 * @description The ID of a required field on the inner object whose value will be used to display items in the list.
-                 * @example
-                 * In this example, we use the value of the `label` field to display members of the list.
-                 *
-                 * ```
-                  spec: InputSpec.of({
-                    label: Value.text({
-                      name: 'Label',
-                      required: false,
-                      default: null,
-                    })
-                  })
-                  displayAs: 'label',
-                  uniqueBy: null,
-                 * ```
-                 *
-                 */
-                displayAs?: string | null | undefined;
-                /**
-                 * @description The ID(s) of required fields on the inner object whose value(s) will be used to enforce uniqueness in the list.
-                 * @example
-                 * In this example, we use the `label` field to enforce uniqueness, meaning the label field must be unique from other entries.
-                 *
-                 * ```
-                  spec: InputSpec.of({
-                    label: Value.text({
-                      name: 'Label',
-                      required: true,
-                      default: null,
-                    })
-                    pubkey: Value.text({
-                      name: 'Pubkey',
-                      required: true,
-                      default: null,
-                    })
-                  })
-                  displayAs: 'label',
-                  uniqueBy: 'label',
-                 * ```
-                 * @example
-                 * In this example, we use the `label` field AND the `pubkey` field to enforce uniqueness, meaning both these fields must be unique from other entries.
-                 *
-                 * ```
-                  spec: InputSpec.of({
-                    label: Value.text({
-                      name: 'Label',
-                      required: true,
-                      default: null,
-                    })
-                    pubkey: Value.text({
-                      name: 'Pubkey',
-                      required: true,
-                      default: null,
-                    })
-                  })
-                  displayAs: 'label',
-                  uniqueBy: { all: ['label', 'pubkey'] },
-                 * ```
-                 */
-                uniqueBy?: UniqueBy | undefined;
-            }) => List<Type_1[], Store>;
+            obj: <Type extends Record<string, any>>(a: Parameters<typeof List.obj<Type, Store>>[0], aSpec: Parameters<typeof List.obj<Type, Store>>[1]) => List<Type[], Store>;
             /**
              * @description Create a list of dynamic text inputs.
              * @param a - attributes of the list itself.
@@ -640,7 +577,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
                     placeholder?: string | null;
                     minLength?: number | null;
                     maxLength?: number | null;
-                    patterns: Pattern[];
+                    patterns?: Pattern[];
                     inputmode?: ListValueSpecText["inputmode"];
                 };
             }>) => List<string[], Store>;
@@ -935,7 +872,6 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             dynamicToggle: (a: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
                 default: boolean;
                 disabled?: false | string;
@@ -943,53 +879,21 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             dynamicText: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
-                /**
-                 * @description optionally provide a default value.
-                 * @type { string | RandomString | null }
-                 * @example default: null
-                 * @example default: 'World'
-                 * @example default: { charset: 'abcdefg', len: 16 }
-                 */
                 default: DefaultString | null;
                 required: boolean;
-                /**
-                 * @description Mask (aka camouflage) text input with dots: ● ● ●
-                 * @default false
-                 */
                 masked?: boolean;
                 placeholder?: string | null;
                 minLength?: number | null;
                 maxLength?: number | null;
-                /**
-                 * @description A list of regular expressions to which the text must conform to pass validation. A human readable description is provided in case the validation fails.
-                 * @default []
-                 * @example
-                 * ```
-                  [
-                    {
-                      regex: "[a-z]",
-                      description: "May only contain lower case letters from the English alphabet."
-                    }
-                  ]
-                 * ```
-                 */
                 patterns?: Pattern[];
-                /**
-                 * @description Informs the browser how to behave and which keyboard to display on mobile
-                 * @default "text"
-                 */
                 inputmode?: ValueSpecText["inputmode"];
-                /**
-                 * @description Displays a button that will generate a random string according to the provided charset and len attributes.
-                 */
+                disabled?: string | false;
                 generate?: null | RandomString;
             }>) => Value<string | null, Store>;
             dynamicTextarea: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
                 default: string | null;
                 required: boolean;
@@ -1001,30 +905,13 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             dynamicNumber: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
-                /**
-                 * @description optionally provide a default value.
-                 * @type { number | null }
-                 * @example default: null
-                 * @example default: 7
-                 */
                 default: number | null;
                 required: boolean;
                 min?: number | null;
                 max?: number | null;
-                /**
-                 * @description How much does the number increase/decrease when using the arrows provided by the browser.
-                 * @default 1
-                 */
                 step?: number | null;
-                /**
-                 * @description Requires the number to be an integer.
-                 */
                 integer: boolean;
-                /**
-                 * @description Optionally display units to the right of the input box.
-                 */
                 units?: string | null;
                 placeholder?: string | null;
                 disabled?: false | string;
@@ -1032,14 +919,7 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             dynamicColor: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
-                /**
-                 * @description optionally provide a default value.
-                 * @type { string | null }
-                 * @example default: null
-                 * @example default: 'ffffff'
-                 */
                 default: string | null;
                 required: boolean;
                 disabled?: false | string;
@@ -1047,141 +927,52 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             dynamicDatetime: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
-                /**
-                 * @description optionally provide a default value.
-                 * @type { string | null }
-                 * @example default: null
-                 * @example default: '1985-12-16 18:00:00.000'
-                 */
-                default: string;
+                default: string | null;
                 required: boolean;
-                /**
-                 * @description Informs the browser how to behave and which date/time component to display.
-                 * @default "datetime-local"
-                 */
                 inputmode?: ValueSpecDatetime["inputmode"];
                 min?: string | null;
                 max?: string | null;
                 disabled?: false | string;
             }>) => Value<string | null, Store>;
-            dynamicSelect: <Variants_1 extends Record<string, string>>(getA: LazyBuild<Store, {
+            dynamicSelect: (getA: LazyBuild<Store, {
                 name: string;
-                description?: string | null | undefined;
-                /** Presents a warning prompt before permitting the value to change. */
-                warning?: string | null | undefined;
-                /**
-                 * @description provide a default value from the list of values.
-                 * @type { default: string }
-                 * @example default: 'radio1'
-                 */
-                default: keyof Variants_1 & string;
-                required: boolean;
-                /**
-                 * @description A mapping of unique radio options to their human readable display format.
-                 * @example
-                 * ```
-                  {
-                    radio1: "Radio 1"
-                    radio2: "Radio 2"
-                    radio3: "Radio 3"
-                  }
-                 * ```
-                 */
-                values: Variants_1;
-                /**
-                 * @options
-                 *   - false - The field can be modified.
-                 *   - string - The field cannot be modified. The provided text explains why.
-                 *   - string[] - The field can be modified, but the values contained in the array cannot be selected.
-                 * @default false
-                 */
-                disabled?: string | false | string[] | undefined;
+                description?: string | null;
+                warning?: string | null;
+                default: string;
+                values: Record<string, string>;
+                disabled?: false | string | string[];
             }>) => Value<string, Store>;
             dynamicMultiselect: (getA: LazyBuild<Store, {
                 name: string;
                 description?: string | null;
-                /** Presents a warning prompt before permitting the value to change. */
                 warning?: string | null;
-                /**
-                 * @description A simple list of which options should be checked by default.
-                 */
                 default: string[];
-                /**
-                 * @description A mapping of checkbox options to their human readable display format.
-                 * @example
-                 * ```
-                  {
-                    option1: "Option 1"
-                    option2: "Option 2"
-                    option3: "Option 3"
-                  }
-                 * ```
-                 */
                 values: Record<string, string>;
                 minLength?: number | null;
                 maxLength?: number | null;
-                /**
-                 * @options
-                 *   - false - The field can be modified.
-                 *   - string - The field cannot be modified. The provided text explains why.
-                 *   - string[] - The field can be modified, but the values contained in the array cannot be selected.
-                 * @default false
-                 */
                 disabled?: false | string | string[];
             }>) => Value<string[], Store>;
-            filteredUnion: <VariantValues extends {
-                [x: string]: {
-                    name: string;
-                    spec: InputSpec<any, Store> | InputSpec<any, never>;
-                };
-            }>(getDisabledFn: LazyBuild<Store, string[]>, a: {
+            filteredUnion: <VariantValues extends { [K in string]: {
                 name: string;
-                description?: string | null | undefined;
-                warning?: string | null | undefined;
-                default: keyof VariantValues & string;
-            }, aVariants: Variants<VariantValues, Store> | Variants<VariantValues, never>) => Value<import("../../base/lib/actions/input/builder/variants").UnionRes<Store, VariantValues, keyof VariantValues & string> | import("../../base/lib/actions/input/builder/variants").UnionRes<never, VariantValues, keyof VariantValues & string>, Store>;
-            dynamicUnion: <VariantValues_1 extends {
-                [x: string]: {
-                    name: string;
-                    spec: InputSpec<any, Store> | InputSpec<any, never>;
-                };
-            }>(getA: LazyBuild<Store, {
+                spec: InputSpec<any, Store> | InputSpec<any, never>;
+            }; }>(getDisabledFn: Parameters<typeof Value.filteredUnion<VariantValues, Store>>[0], a: Parameters<typeof Value.filteredUnion<VariantValues, Store>>[1], aVariants: Parameters<typeof Value.filteredUnion<VariantValues, Store>>[2]) => Value<import("../../base/lib/actions/input/builder/variants").UnionRes<Store, VariantValues, keyof VariantValues & string> | import("../../base/lib/actions/input/builder/variants").UnionRes<never, VariantValues, keyof VariantValues & string>, Store>;
+            dynamicUnion: <VariantValues extends { [K in string]: {
                 name: string;
-                description?: string | null | undefined;
-                /** Presents a warning prompt before permitting the value to change. */
-                warning?: string | null | undefined;
-                /**
-                 * @description provide a default value from the list of variants.
-                 * @type { string }
-                 * @example default: 'variant1'
-                 */
-                default: keyof VariantValues_1 & string;
-                required: boolean;
-                /**
-                 * @options
-                 *   - false - The field can be modified.
-                 *   - string - The field cannot be modified. The provided text explains why.
-                 *   - string[] - The field can be modified, but the values contained in the array cannot be selected.
-                 * @default false
-                 */
-                disabled: false | string | string[];
-            }>, aVariants: Variants<VariantValues_1, Store> | Variants<VariantValues_1, never>) => Value<import("../../base/lib/actions/input/builder/variants").UnionRes<Store, VariantValues_1, keyof VariantValues_1 & string> | import("../../base/lib/actions/input/builder/variants").UnionRes<never, VariantValues_1, keyof VariantValues_1 & string>, Store>;
+                spec: InputSpec<any, Store> | InputSpec<any, never>;
+            }; }>(getA: Parameters<typeof Value.dynamicUnion<VariantValues, Store>>[0], aVariants: Parameters<typeof Value.dynamicUnion<VariantValues, Store>>[1]) => Value<import("../../base/lib/actions/input/builder/variants").UnionRes<Store, VariantValues, keyof VariantValues & string> | import("../../base/lib/actions/input/builder/variants").UnionRes<never, VariantValues, keyof VariantValues & string>, Store>;
         };
         Variants: {
-            of: <VariantValues_2 extends {
-                [x: string]: {
-                    name: string;
-                    spec: InputSpec<any, Store>;
-                };
-            }>(a: VariantValues_2) => Variants<VariantValues_2, Store>;
+            of: <VariantValues extends { [K in string]: {
+                name: string;
+                spec: InputSpec<any, Store>;
+            }; }>(a: VariantValues) => Variants<VariantValues, Store>;
         };
         restart: (effects: Effects) => Promise<null>;
         shutdown: (effects: Effects) => Promise<null>;
         getStatus: (effects: Effects, options: {
-            packageId?: string | undefined;
-            callback?: (() => void) | undefined;
+            packageId?: PackageId;
+            callback?: () => void;
         }) => Promise<T.MainStatus>;
         setDependencies: (effects: Effects, options: {
             dependencies: T.Dependencies;
@@ -1201,20 +992,21 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
             paths: string[];
         }) => Promise<null>;
         getServicePortForward: (effects: Effects, options: {
-            packageId?: string | undefined;
-            hostId: string;
+            packageId?: PackageId;
+            hostId: T.HostId;
             internalPort: number;
         }) => Promise<T.NetInfo>;
         clearBindings: (effects: Effects, options: {
             except: {
-                id: string;
+                id: T.HostId;
                 internalPort: number;
             }[];
         }) => Promise<null>;
         getContainerIp: (effects: Effects) => Promise<string>;
+        getOsIp: (effects: Effects) => Promise<string>;
         getSslKey: (effects: Effects, options: {
             hostnames: string[];
-            algorithm?: "ecdsa" | "ed25519" | undefined;
+            algorithm?: "ecdsa" | "ed25519";
         }) => Promise<string>;
         setDataVersion: (effects: Effects, options: {
             version: string;
@@ -1224,14 +1016,14 @@ export declare class StartSdk<Manifest extends T.SDKManifest, Store> {
     };
 }
 export declare function runCommand<Manifest extends T.SDKManifest>(effects: Effects, image: {
-    id: keyof Manifest["images"] & T.ImageId;
+    imageId: keyof Manifest["images"] & T.ImageId;
     sharedRun?: boolean;
-}, command: string | [string, ...string[]], options: CommandOptions & {
+}, command: T.CommandType, options: CommandOptions & {
     mounts?: {
         path: string;
         options: MountOptions;
     }[];
-}, name: string): Promise<{
+}, name?: string): Promise<{
     stdout: string | Buffer;
     stderr: string | Buffer;
 }>;