hostctl 0.1.39 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -154,6 +154,7 @@ declare class Host {
154
154
  user: string | undefined;
155
155
  tags: string[];
156
156
  };
157
+ effectiveTags(): Set<string>;
157
158
  hasTag(tag: string): boolean;
158
159
  hasAllTags(tags: Set<string>): boolean;
159
160
  hasAnyTag(tags: Set<string>): boolean;
@@ -238,25 +239,51 @@ declare class CommandResult {
238
239
  get success(): boolean;
239
240
  get failure(): boolean;
240
241
  }
242
+ interface CommandOptions {
243
+ cmd: string;
244
+ args?: string[];
245
+ cwd?: string;
246
+ env?: EnvVarObj;
247
+ result?: CommandResult;
248
+ sudo?: boolean;
249
+ }
241
250
  declare class Command {
242
251
  static parse(commandString: string, env?: EnvVarObj): {
243
252
  cmd: string;
244
253
  args: string[];
245
254
  env?: EnvVarObj;
246
255
  };
256
+ /**
257
+ * Builds a Command object from a command string or array with optional sudo and environment variables.
258
+ * This is the main factory method for creating commands that will be executed.
259
+ */
260
+ static build(command: string | string[], options?: {
261
+ sudo?: boolean;
262
+ env?: EnvVarObj;
263
+ cwd?: string;
264
+ }): Command;
247
265
  cmd: string;
248
266
  args?: string[] | undefined;
249
267
  cwd?: string;
250
268
  env?: Record<string, string>;
251
269
  result?: CommandResult;
252
- constructor(opts: {
253
- cmd: string;
254
- args?: string[];
255
- cwd?: string;
256
- env?: Record<string, string>;
257
- result?: CommandResult;
258
- });
270
+ sudo?: boolean;
271
+ constructor(opts: CommandOptions);
259
272
  isRunning(): boolean;
273
+ /**
274
+ * Returns the command as a string suitable for shell execution.
275
+ * Uses POSIX standard env command for environment variables.
276
+ */
277
+ toString(): string;
278
+ /**
279
+ * Returns the command and args as separate components.
280
+ * If env is set, returns env as the command and env assignments as args.
281
+ * If sudo is set, returns sudo as the command and the rest as args.
282
+ */
283
+ toArray(): {
284
+ cmd: string;
285
+ args: string[];
286
+ };
260
287
  toJSON(): {
261
288
  cmd: string;
262
289
  args: string[] | undefined;
@@ -333,13 +360,47 @@ declare class InteractionHandler {
333
360
  end(): void;
334
361
  }
335
362
 
363
+ /**
364
+ * Generic object type for parameters and return values.
365
+ */
366
+ type ObjectType = {
367
+ [key: string]: any;
368
+ };
369
+ /**
370
+ * Base type for task-specific parameters.
371
+ */
372
+ type TaskParams = ObjectType;
373
+ /**
374
+ * Represents the possible return values of a task's run function.
375
+ */
376
+ type RunFnReturnValue = ObjectType | void | undefined | null | Error;
377
+ /**
378
+ * Defines the signature of a task's main execution function.
379
+ * It receives a TaskContext and returns a Promise of a RunFnReturnValue.
380
+ */
381
+ interface RunFn<TParams extends TaskParams = TaskParams, TReturn extends RunFnReturnValue = RunFnReturnValue> {
382
+ (context: TaskContext<TParams>): Promise<TReturn>;
383
+ }
384
+ /**
385
+ * Represents a task definition, including its run function and metadata.
386
+ * This class is instantiated by the `task` factory function.
387
+ */
388
+ declare class Task<TParams extends TaskParams = TaskParams, TReturn extends RunFnReturnValue = RunFnReturnValue> {
389
+ runFn: RunFn<TParams, TReturn>;
390
+ taskModuleAbsolutePath?: string | undefined;
391
+ description?: string | undefined;
392
+ name?: string | undefined;
393
+ constructor(runFn: RunFn<TParams, TReturn>, taskModuleAbsolutePath?: string | undefined, description?: string | undefined, name?: string | undefined);
394
+ }
395
+
336
396
  type LogLevel = number;
337
397
  interface FileSystemOperations$1 {
338
398
  read: (path: string) => Promise<string>;
339
- write: (path: string, content: string, options?: {
399
+ write: (path: string, content: string | Buffer, options?: {
340
400
  mode?: string | number;
341
401
  user?: string;
342
402
  group?: string;
403
+ flag?: string;
343
404
  }) => Promise<void>;
344
405
  exists: (path: string) => Promise<boolean>;
345
406
  mkdir: (path: string, options?: {
@@ -376,6 +437,7 @@ interface TaskContext<TParams extends TaskParams = TaskParams> {
376
437
  getSecret: (name: string) => Promise<string | undefined>;
377
438
  exit: (exitCode: number, message?: string) => void;
378
439
  inventory: (tags: string[]) => Host[];
440
+ selectedInventory: (tags?: string[]) => Host[];
379
441
  file: FileSystemOperations$1;
380
442
  }
381
443
  type TaskPartialFn<TReturn extends RunFnReturnValue = RunFnReturnValue> = (parentInvocation: IInvocation) => Promise<TReturn>;
@@ -414,6 +476,7 @@ interface IInvocation<TParams extends TaskParams = any> {
414
476
  getSecret(name: string): Promise<string | undefined>;
415
477
  exit(exitCode: number, message?: string): void;
416
478
  inventory(tags: string[]): Host[];
479
+ selectedInventory(tags?: string[]): Host[];
417
480
  setDescription(description: string): void;
418
481
  setFutureResult(resultPromise: Promise<RunFnReturnValue>): void;
419
482
  appendChildInvocation(childInvocation: IInvocation<any>): Promise<void>;
@@ -455,6 +518,7 @@ declare abstract class Invocation<TParams extends TaskParams = any> implements I
455
518
  getResultPromise(): Promise<RunFnReturnValue>;
456
519
  exit(exitCode: number, message?: string): void;
457
520
  inventory(tags: string[]): Host[];
521
+ selectedInventory(tags?: string[]): Host[];
458
522
  appendChildInvocation(childInvocation: IInvocation<any>): Promise<void>;
459
523
  abstract readonly config: AppConfig;
460
524
  abstract log(level: LogLevel, ...message: any[]): void;
@@ -485,48 +549,17 @@ interface IRuntime {
485
549
  getTmpDir(): Path;
486
550
  getTmpFile(prefix?: string, postfix?: string, dir?: Path): Path;
487
551
  inventory(tags: string[]): Host[];
552
+ selectedInventory(tags?: string[]): Host[];
488
553
  invokeRootTask<TParams extends TaskParams, TReturn extends RunFnReturnValue>(taskFnDefinition: TaskFn<TParams, TReturn>, params: TParams, description?: string): Promise<IInvocation<TParams>>;
489
554
  }
490
555
 
491
- /**
492
- * Generic object type for parameters and return values.
493
- */
494
- type ObjectType = {
495
- [key: string]: any;
496
- };
497
- /**
498
- * Base type for task-specific parameters.
499
- */
500
- type TaskParams = ObjectType;
501
- /**
502
- * Represents the possible return values of a task's run function.
503
- */
504
- type RunFnReturnValue = ObjectType | void | undefined | null | Error;
505
- /**
506
- * Defines the signature of a task's main execution function.
507
- * It receives a TaskContext and returns a Promise of a RunFnReturnValue.
508
- */
509
- interface RunFn<TParams extends TaskParams = TaskParams, TReturn extends RunFnReturnValue = RunFnReturnValue> {
510
- (context: TaskContext<TParams>): Promise<TReturn>;
511
- }
512
- /**
513
- * Represents a task definition, including its run function and metadata.
514
- * This class is instantiated by the `task` factory function.
515
- */
516
- declare class Task<TParams extends TaskParams = TaskParams, TReturn extends RunFnReturnValue = RunFnReturnValue> {
517
- runFn: RunFn<TParams, TReturn>;
518
- taskModuleAbsolutePath?: string | undefined;
519
- description?: string | undefined;
520
- name?: string | undefined;
521
- constructor(runFn: RunFn<TParams, TReturn>, taskModuleAbsolutePath?: string | undefined, description?: string | undefined, name?: string | undefined);
522
- }
523
-
524
556
  interface FileSystemOperations {
525
557
  read: (path: string) => Promise<string>;
526
- write: (path: string, content: string, options?: {
558
+ write: (path: string, content: string | Buffer, options?: {
527
559
  mode?: string | number | undefined;
528
560
  user?: string | undefined;
529
561
  group?: string | undefined;
562
+ flag?: string | undefined;
530
563
  }) => Promise<void>;
531
564
  exists: (path: string) => Promise<boolean>;
532
565
  mkdir: (path: string, options?: {
@@ -557,7 +590,6 @@ declare class LocalInvocation<TParams extends TaskParams, TReturn extends RunFnR
557
590
  ssh<TRemoteParams extends TaskParams = {}, TRemoteReturn extends RunFnReturnValue = RunFnReturnValue>(tags: string[], remoteTaskFn: (remoteContext: TaskContext<TRemoteParams>) => Promise<TRemoteReturn>): Promise<Record<string, TRemoteReturn | Error>>;
558
591
  runRemoteTaskOnHost<TRemoteParams extends TaskParams, TRemoteReturn extends RunFnReturnValue>(host: Host, remoteTaskFn: RunFn<TRemoteParams, TRemoteReturn>): Promise<TRemoteReturn | Error>;
559
592
  exit(exitCode: number, message?: string): void;
560
- inventory(tags: string[]): Host[];
561
593
  run<TRunReturn extends RunFnReturnValue>(taskPartialFn: TaskPartialFn<TRunReturn>): Promise<TRunReturn>;
562
594
  invokeChildTask<TTaskParams extends TaskParams, TTaskReturn extends RunFnReturnValue>(childTaskFnDefinition: TaskFn<TTaskParams, TTaskReturn>, params: TTaskParams): Promise<TTaskReturn>;
563
595
  }
@@ -578,34 +610,18 @@ declare class LocalRuntime implements IRuntime {
578
610
  getTmpDir(): Path;
579
611
  getTmpFile(prefix?: string | undefined, postfix?: string | undefined, dir?: Path | undefined): Path;
580
612
  inventory(tags: string[]): Host[];
613
+ selectedInventory(tags?: string[]): Host[];
581
614
  invokeRootTask<TParams extends TaskParams, TReturn extends RunFnReturnValue>(taskFnDefinition: TaskFn<TParams, TReturn>, params: TParams, description?: string): Promise<LocalInvocation<TParams, TReturn>>;
582
615
  }
583
616
 
584
- declare class RemoteRuntime implements IRuntime {
585
- private sftpClientInstance?;
586
- readonly app: App;
587
- readonly host: Host;
588
- readonly interactionHandler: InteractionHandler;
589
- private sshSession;
590
- constructor(app: App, host: Host, _localRuntime: LocalRuntime, interactionHandler?: InteractionHandler);
591
- get tmpDirRootPath(): Path;
592
- getPassword(): Promise<string | undefined>;
593
- getSecret(name: string): Promise<string | undefined>;
594
- getTmpDir(): Path;
595
- getTmpFile(prefix?: string | undefined, postfix?: string | undefined, dir?: Path | undefined): Path;
596
- inventory(tags: string[]): Host[];
597
- connect(): Promise<boolean>;
598
- getSftpClient(): Promise<any>;
599
- executeCommand(command: string | string[], options?: {
600
- cwd?: string;
601
- stdin?: string | Buffer;
602
- pty?: boolean;
603
- env?: Record<string, string>;
604
- interactionHandler?: InteractionHandler;
605
- }): Promise<Command | Error>;
606
- disconnect(): Promise<void>;
607
- invokeRootTask<TParams extends TaskParams, TReturn extends RunFnReturnValue>(taskFnDefinition: TaskFn<TParams, TReturn>, params: TParams): Promise<IInvocation>;
608
- }
617
+ declare const Verbosity: {
618
+ readonly ERROR: 0;
619
+ readonly WARN: 1;
620
+ readonly INFO: 2;
621
+ readonly DEBUG: 3;
622
+ readonly TRACE: 4;
623
+ };
624
+ type VerbosityLevel = (typeof Verbosity)[keyof typeof Verbosity];
609
625
 
610
626
  type AppConfig = Config;
611
627
 
@@ -629,14 +645,42 @@ declare class TaskTree {
629
645
  getWithTimeout(id: string): Promise<TaskTreeNode | undefined>;
630
646
  run(ctx?: any): Promise<any>;
631
647
  }
632
- declare const Verbosity: {
633
- ERROR: number;
634
- WARN: number;
635
- INFO: number;
636
- DEBUG: number;
637
- TRACE: number;
638
- };
648
+ interface LoadAppOptions {
649
+ /** Optional configuration file path or URL */
650
+ config?: string;
651
+ /** Optional verbosity level (0-4, where 0 is error only, 4 is trace) */
652
+ verbosity?: number;
653
+ /** Optional output style (plain, json, api) */
654
+ outputStyle?: 'plain' | 'json' | 'api';
655
+ }
656
+ interface ExecuteResult {
657
+ /** Overall success indicator - true if all hosts succeeded */
658
+ success: boolean;
659
+ /** Results for each host, keyed by hostname */
660
+ hosts: Record<string, {
661
+ /** Host alias if available */
662
+ alias: string;
663
+ /** Whether the command succeeded on this host */
664
+ success: boolean;
665
+ /** Command output */
666
+ stdout: string;
667
+ /** Command error output */
668
+ stderr: string;
669
+ /** Exit code */
670
+ exitCode: number;
671
+ /** Signal if the process was terminated by a signal */
672
+ signal?: string;
673
+ }>;
674
+ /** Total number of hosts that were targeted */
675
+ totalHosts: number;
676
+ /** Number of hosts that succeeded */
677
+ successfulHosts: number;
678
+ /** Number of hosts that failed */
679
+ failedHosts: number;
680
+ }
639
681
  declare class App {
682
+ static loadApiMode(options: LoadAppOptions): Promise<App>;
683
+ static load(options: LoadAppOptions): Promise<App>;
640
684
  configRef?: string;
641
685
  private _config?;
642
686
  selectedTags: Set<string>;
@@ -644,12 +688,14 @@ declare class App {
644
688
  private _tmpDir?;
645
689
  private tmpFileRegistry;
646
690
  taskTree: TaskTree;
647
- verbosity: number;
691
+ verbosity: VerbosityLevel;
648
692
  constructor();
649
693
  appExitCallback(): void;
650
694
  get config(): Config;
651
695
  get tmpDir(): Path;
652
- loadConfig(configString?: string): Promise<void>;
696
+ loadConfig(configRef?: string): Promise<void>;
697
+ isValidUrl(url: string): boolean;
698
+ deriveConfigRef(configRef?: string): string;
653
699
  log(level: LogLevel, ...args: any[]): void;
654
700
  debug(...args: any[]): void;
655
701
  info(...args: any[]): void;
@@ -666,24 +712,41 @@ declare class App {
666
712
  shouldRunRemote(): boolean;
667
713
  logHostCommandResult(host: Host, command: string | string[], cmdOrErr: Command | Error, isErrorResult?: boolean): void;
668
714
  defaultSshUser(): string | undefined;
669
- execute(cmd: string | string[]): Promise<boolean>;
715
+ execute(cmd: string | string[]): Promise<ExecuteResult>;
670
716
  runRemote(host: Host, cmd: string | string[]): Promise<Command | Error>;
717
+ /**
718
+ * Builds the hosts record from host result quads
719
+ */
720
+ private buildHostsRecord;
721
+ /**
722
+ * Counts successful and failed hosts from host result quads
723
+ */
724
+ private countHostResults;
725
+ /**
726
+ * Determines overall success from host result quads
727
+ */
728
+ private determineOverallSuccess;
729
+ /**
730
+ * Constructs the detailed ExecuteResult from host result quads and total host count
731
+ */
732
+ private buildExecuteResult;
671
733
  getSecretsForHost(hostId: string): Map<string | RegExp, string>;
672
734
  taskContextForRunFn<TParams extends TaskParams>(invocation: IInvocation<TParams>, params: TParams, hostForContext?: Host): TaskContext<TParams>;
673
735
  setSelectedTags(selectedTags: string[]): void;
674
- setOutputStyle(outputStyle: 'plain' | 'json'): void;
675
- setVerbosity(level: number): void;
736
+ setOutputStyle(outputStyle: 'plain' | 'json' | 'api'): void;
737
+ setVerbosity(level: number): VerbosityLevel;
738
+ outputApiMode(): boolean;
676
739
  outputJson(): boolean;
677
740
  outputPlain(): boolean;
678
- querySelectedInventory(tags?: string[]): Host[];
741
+ querySelectedInventory(tags?: Set<string>): Host[];
679
742
  selectedInventory(): Host[];
680
743
  queryInventory(tags?: Set<string>): Host[];
681
744
  selectInventory(hosts: Host[], tags?: Set<string>): Host[];
682
745
  printInventoryReport(): void;
683
746
  encryptInventoryFile(): Promise<void>;
684
747
  decryptInventoryFile(): Promise<void>;
685
- runScript(scriptRef: string, params: TaskParams): Promise<void>;
686
- runScriptRemote(scriptRef: string, params: TaskParams): Promise<void>;
748
+ runScript(scriptRef: string, params: TaskParams): Promise<RunFnReturnValue>;
749
+ runScriptRemote(scriptRef: string, params: TaskParams): Promise<RunFnReturnValue>;
687
750
  walkInvocationTreePreorder(invocation: IInvocation<any>, visitFn: (invocation: IInvocation<any>, depth: number) => Promise<void>, visited?: Set<IInvocation<any>>, depth?: number): Promise<void>;
688
751
  reportScriptResult(invocation: LocalInvocation<any, any>, scriptResult: RunFnReturnValue | Error): Promise<void>;
689
752
  loadScriptAsModule(scriptRef: string): Promise<any>;
@@ -692,7 +755,39 @@ declare class App {
692
755
  printRuntimeReport(): Promise<void>;
693
756
  promptPassword(message?: string): Promise<string>;
694
757
  installRuntime(): Promise<void>;
695
- bootstrap(): Promise<void>;
758
+ /**
759
+ * Executes a command on the selected hosts
760
+ *
761
+ * @param options - Configuration options for running the task
762
+ * @returns Promise resolving to the task's result
763
+ */
764
+ apiExecute(options: {
765
+ /** The host tags to scope the run to */
766
+ hostTags?: string[];
767
+ /** The command to execute */
768
+ command: string | string[];
769
+ }): Promise<ExecuteResult>;
770
+ /**
771
+ * Resolves a task from a package reference and runs it
772
+ *
773
+ * This method provides a simple way to resolve and execute tasks using the same
774
+ * logic as the CLI, but as a method on an App instance.
775
+ *
776
+ * @param options - Configuration options for running the task
777
+ * @returns Promise resolving to the task's result
778
+ */
779
+ apiRunTask(options: {
780
+ /** Whether to run the task remotely (if not provided, runs locally) */
781
+ remote?: boolean;
782
+ /** The host tags to scope the run to */
783
+ hostTags?: string[];
784
+ /** The package reference (core task, local path, or remote package) */
785
+ package: string;
786
+ /** Optional task name within the package */
787
+ task?: string;
788
+ /** Parameters to pass to the task */
789
+ params: TaskParams;
790
+ }): Promise<RunFnReturnValue>;
696
791
  }
697
792
 
698
793
  declare class Cli {
@@ -704,7 +799,7 @@ declare class Cli {
704
799
  handleInventoryDecrypt(options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
705
800
  handleInventoryList(options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
706
801
  handleExec(commandParts: string | string[], options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
707
- handleRun(packageRef: string | null, scriptRef: string | undefined, scriptArgs: string[], options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
802
+ handleRun(pkgTaskArgs: string[], options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
708
803
  deriveConfigRef(suppliedConfigRef?: string): string;
709
804
  loadApp(opts: Record<string, any>): Promise<void>;
710
805
  run(): Promise<void>;
@@ -722,6 +817,15 @@ interface WhoamiParams {
722
817
  }
723
818
  interface WhoamiResult {
724
819
  user: string;
820
+ success: boolean;
821
+ error?: string;
822
+ }
823
+
824
+ type EnvParams = {};
825
+ interface EnvResult {
826
+ env: Record<string, string>;
827
+ success: boolean;
828
+ error?: string;
725
829
  }
726
830
 
727
831
  type EchoParams = {
@@ -729,6 +833,8 @@ type EchoParams = {
729
833
  };
730
834
  interface EchoResult {
731
835
  stdout: string;
836
+ success: boolean;
837
+ error?: string;
732
838
  }
733
839
 
734
840
  interface DirExistsParams {
@@ -736,8 +842,10 @@ interface DirExistsParams {
736
842
  }
737
843
  interface DirExistsResult {
738
844
  exists: boolean;
845
+ success: boolean;
846
+ error?: string;
739
847
  }
740
- declare const _default$16: TaskFn<DirExistsParams, DirExistsResult>;
848
+ declare const _default$3x: TaskFn<DirExistsParams, DirExistsResult>;
741
849
 
742
850
  interface DirCopyParams {
743
851
  from: string;
@@ -749,8 +857,9 @@ interface DirCopyParams {
749
857
  }
750
858
  interface DirCopyResult {
751
859
  success: boolean;
860
+ error?: string;
752
861
  }
753
- declare const _default$15: TaskFn<DirCopyParams, DirCopyResult>;
862
+ declare const _default$3w: TaskFn<DirCopyParams, DirCopyResult>;
754
863
 
755
864
  interface DirCreateParams {
756
865
  path: string;
@@ -759,11 +868,12 @@ interface DirCreateParams {
759
868
  }
760
869
  interface DirCreateResult {
761
870
  success: boolean;
871
+ error?: string;
762
872
  }
763
- declare const _default$14: TaskFn<DirCreateParams, DirCreateResult>;
873
+ declare const _default$3v: TaskFn<DirCreateParams, DirCreateResult>;
764
874
 
765
875
  declare namespace dir {
766
- export { _default$15 as copy, _default$14 as create, _default$16 as exists };
876
+ export { _default$3w as copy, _default$3v as create, _default$3x as exists };
767
877
  }
768
878
 
769
879
  interface ChownParams {
@@ -777,7 +887,7 @@ interface ChownResult {
777
887
  success: boolean;
778
888
  error?: string;
779
889
  }
780
- declare const _default$13: TaskFn<ChownParams, ChownResult>;
890
+ declare const _default$3u: TaskFn<ChownParams, ChownResult>;
781
891
 
782
892
  interface ChgrpParams {
783
893
  path: string;
@@ -789,7 +899,7 @@ interface ChgrpResult {
789
899
  success: boolean;
790
900
  error?: string;
791
901
  }
792
- declare const _default$12: TaskFn<ChgrpParams, ChgrpResult>;
902
+ declare const _default$3t: TaskFn<ChgrpParams, ChgrpResult>;
793
903
 
794
904
  interface ChmodParams {
795
905
  path: string;
@@ -801,7 +911,7 @@ interface ChmodResult {
801
911
  success: boolean;
802
912
  error?: string;
803
913
  }
804
- declare const _default$11: TaskFn<ChmodParams, ChmodResult>;
914
+ declare const _default$3s: TaskFn<ChmodParams, ChmodResult>;
805
915
 
806
916
  interface FileCopyParams {
807
917
  from: string;
@@ -814,16 +924,19 @@ interface FileCopyParams {
814
924
  }
815
925
  interface FileCopyResult {
816
926
  success: boolean;
927
+ error?: string;
817
928
  }
818
- declare const _default$10: TaskFn<FileCopyParams, FileCopyResult>;
929
+ declare const _default$3r: TaskFn<FileCopyParams, FileCopyResult>;
819
930
 
820
931
  interface FileExistsParams {
821
932
  path: string;
822
933
  }
823
934
  interface FileExistsResult {
824
935
  exists: boolean;
936
+ success: boolean;
937
+ error?: string;
825
938
  }
826
- declare const _default$$: TaskFn<FileExistsParams, FileExistsResult>;
939
+ declare const _default$3q: TaskFn<FileExistsParams, FileExistsResult>;
827
940
 
828
941
  interface FileTouchParams {
829
942
  file: string;
@@ -832,8 +945,9 @@ interface FileTouchParams {
832
945
  }
833
946
  interface FileTouchResult {
834
947
  success: boolean;
948
+ error?: string;
835
949
  }
836
- declare const _default$_: TaskFn<FileTouchParams, FileTouchResult>;
950
+ declare const _default$3p: TaskFn<FileTouchParams, FileTouchResult>;
837
951
 
838
952
  interface FileDeleteParams {
839
953
  path: string;
@@ -842,8 +956,9 @@ interface FileDeleteParams {
842
956
  }
843
957
  interface FileDeleteResult {
844
958
  success: boolean;
959
+ error?: string;
845
960
  }
846
- declare const _default$Z: TaskFn<FileDeleteParams, FileDeleteResult>;
961
+ declare const _default$3o: TaskFn<FileDeleteParams, FileDeleteResult>;
847
962
 
848
963
  interface FileLinkParams {
849
964
  /** Path the symlink should point TO (target). */
@@ -858,8 +973,9 @@ interface FileLinkParams {
858
973
  interface FileLinkResult {
859
974
  changed: boolean;
860
975
  success: boolean;
976
+ error?: string;
861
977
  }
862
- declare const _default$Y: TaskFn<FileLinkParams, FileLinkResult>;
978
+ declare const _default$3n: TaskFn<FileLinkParams, FileLinkResult>;
863
979
 
864
980
  interface FileEditParams {
865
981
  file: string;
@@ -878,8 +994,9 @@ interface FileEditParams {
878
994
  interface FileEditResult {
879
995
  changed: boolean;
880
996
  success: boolean;
997
+ error?: string;
881
998
  }
882
- declare const _default$X: TaskFn<FileEditParams, FileEditResult>;
999
+ declare const _default$3m: TaskFn<FileEditParams, FileEditResult>;
883
1000
 
884
1001
  interface FileGrepParams {
885
1002
  /** Path to the file to search */
@@ -914,8 +1031,12 @@ interface FileGrepResult {
914
1031
  count: number;
915
1032
  /** Matching lines (included only when return_lines=true) */
916
1033
  lines?: string[];
1034
+ /** Whether the operation was successful */
1035
+ success: boolean;
1036
+ /** Error message if operation failed */
1037
+ error?: string;
917
1038
  }
918
- declare const _default$W: TaskFn<FileGrepParams, FileGrepResult>;
1039
+ declare const _default$3l: TaskFn<FileGrepParams, FileGrepResult>;
919
1040
 
920
1041
  type file_ChgrpParams = ChgrpParams;
921
1042
  type file_ChgrpResult = ChgrpResult;
@@ -938,7 +1059,7 @@ type file_FileLinkResult = FileLinkResult;
938
1059
  type file_FileTouchParams = FileTouchParams;
939
1060
  type file_FileTouchResult = FileTouchResult;
940
1061
  declare namespace file {
941
- export { type file_ChgrpParams as ChgrpParams, type file_ChgrpResult as ChgrpResult, type file_ChmodParams as ChmodParams, type file_ChmodResult as ChmodResult, type file_ChownParams as ChownParams, type file_ChownResult as ChownResult, type file_FileCopyParams as FileCopyParams, type file_FileCopyResult as FileCopyResult, type file_FileDeleteParams as FileDeleteParams, type file_FileDeleteResult as FileDeleteResult, type file_FileEditParams as FileEditParams, type file_FileEditResult as FileEditResult, type file_FileExistsParams as FileExistsParams, type file_FileExistsResult as FileExistsResult, type file_FileGrepParams as FileGrepParams, type file_FileGrepResult as FileGrepResult, type file_FileLinkParams as FileLinkParams, type file_FileLinkResult as FileLinkResult, type file_FileTouchParams as FileTouchParams, type file_FileTouchResult as FileTouchResult, _default$12 as chgrp, _default$11 as chmod, _default$13 as chown, _default$10 as copy, _default$Z as delete, _default$X as edit, _default$$ as exists, _default$W as grep, _default$Y as link, _default$_ as touch };
1062
+ export { type file_ChgrpParams as ChgrpParams, type file_ChgrpResult as ChgrpResult, type file_ChmodParams as ChmodParams, type file_ChmodResult as ChmodResult, type file_ChownParams as ChownParams, type file_ChownResult as ChownResult, type file_FileCopyParams as FileCopyParams, type file_FileCopyResult as FileCopyResult, type file_FileDeleteParams as FileDeleteParams, type file_FileDeleteResult as FileDeleteResult, type file_FileEditParams as FileEditParams, type file_FileEditResult as FileEditResult, type file_FileExistsParams as FileExistsParams, type file_FileExistsResult as FileExistsResult, type file_FileGrepParams as FileGrepParams, type file_FileGrepResult as FileGrepResult, type file_FileLinkParams as FileLinkParams, type file_FileLinkResult as FileLinkResult, type file_FileTouchParams as FileTouchParams, type file_FileTouchResult as FileTouchResult, _default$3t as chgrp, _default$3s as chmod, _default$3u as chown, _default$3r as copy, _default$3o as delete, _default$3m as edit, _default$3q as exists, _default$3l as grep, _default$3n as link, _default$3p as touch };
942
1063
  }
943
1064
 
944
1065
  interface GitCloneParams {
@@ -947,8 +1068,9 @@ interface GitCloneParams {
947
1068
  }
948
1069
  interface GitCloneResult {
949
1070
  success: boolean;
1071
+ error?: string;
950
1072
  }
951
- declare const _default$V: TaskFn<GitCloneParams, GitCloneResult>;
1073
+ declare const _default$3k: TaskFn<GitCloneParams, GitCloneResult>;
952
1074
 
953
1075
  interface GitPullParams {
954
1076
  /** The directory of the git repository on the host. */
@@ -966,7 +1088,7 @@ interface GitPullResult {
966
1088
  /** Error message if the pull operation failed. */
967
1089
  error?: string;
968
1090
  }
969
- declare const _default$U: TaskFn<GitPullParams, GitPullResult>;
1091
+ declare const _default$3j: TaskFn<GitPullParams, GitPullResult>;
970
1092
 
971
1093
  interface GitCheckoutParams {
972
1094
  /** The directory of the git repository on the host. */
@@ -982,7 +1104,7 @@ interface GitCheckoutResult {
982
1104
  /** Error message if the checkout operation failed. */
983
1105
  error?: string;
984
1106
  }
985
- declare const _default$T: TaskFn<GitCheckoutParams, GitCheckoutResult>;
1107
+ declare const _default$3i: TaskFn<GitCheckoutParams, GitCheckoutResult>;
986
1108
 
987
1109
  type git_GitCheckoutParams = GitCheckoutParams;
988
1110
  type git_GitCheckoutResult = GitCheckoutResult;
@@ -991,7 +1113,7 @@ type git_GitCloneResult = GitCloneResult;
991
1113
  type git_GitPullParams = GitPullParams;
992
1114
  type git_GitPullResult = GitPullResult;
993
1115
  declare namespace git {
994
- export { type git_GitCheckoutParams as GitCheckoutParams, type git_GitCheckoutResult as GitCheckoutResult, type git_GitCloneParams as GitCloneParams, type git_GitCloneResult as GitCloneResult, type git_GitPullParams as GitPullParams, type git_GitPullResult as GitPullResult, _default$T as checkout, _default$V as clone, _default$U as pull };
1116
+ export { type git_GitCheckoutParams as GitCheckoutParams, type git_GitCheckoutResult as GitCheckoutResult, type git_GitCloneParams as GitCloneParams, type git_GitCloneResult as GitCloneResult, type git_GitPullParams as GitPullParams, type git_GitPullResult as GitPullResult, _default$3i as checkout, _default$3k as clone, _default$3j as pull };
995
1117
  }
996
1118
 
997
1119
  interface GroupCreateParams {
@@ -1001,8 +1123,9 @@ interface GroupCreateParams {
1001
1123
  }
1002
1124
  interface GroupCreateResult {
1003
1125
  success: boolean;
1126
+ error?: string;
1004
1127
  }
1005
- declare const _default$S: TaskFn<GroupCreateParams, GroupCreateResult>;
1128
+ declare const _default$3h: TaskFn<GroupCreateParams, GroupCreateResult>;
1006
1129
 
1007
1130
  interface GroupDeleteParams {
1008
1131
  group: string;
@@ -1013,7 +1136,7 @@ interface GroupDeleteResult {
1013
1136
  success: boolean;
1014
1137
  error?: string;
1015
1138
  }
1016
- declare const _default$R: TaskFn<GroupDeleteParams, GroupDeleteResult>;
1139
+ declare const _default$3g: TaskFn<GroupDeleteParams, GroupDeleteResult>;
1017
1140
 
1018
1141
  interface GroupExistsParams {
1019
1142
  group: string;
@@ -1021,7 +1144,7 @@ interface GroupExistsParams {
1021
1144
  interface GroupExistsResult {
1022
1145
  exists: boolean;
1023
1146
  }
1024
- declare const _default$Q: TaskFn<GroupExistsParams, GroupExistsResult>;
1147
+ declare const _default$3f: TaskFn<GroupExistsParams, GroupExistsResult>;
1025
1148
 
1026
1149
  interface GroupInfo {
1027
1150
  name: string;
@@ -1031,9 +1154,10 @@ interface GroupListParams {
1031
1154
  }
1032
1155
  interface GroupListResult {
1033
1156
  success: boolean;
1157
+ error?: string;
1034
1158
  groups: GroupInfo[];
1035
1159
  }
1036
- declare const _default$P: TaskFn<GroupListParams, GroupListResult>;
1160
+ declare const _default$3e: TaskFn<GroupListParams, GroupListResult>;
1037
1161
 
1038
1162
  interface GroupModifyParams {
1039
1163
  /** The current name of the group. */
@@ -1050,7 +1174,7 @@ interface GroupModifyResult {
1050
1174
  changed: boolean;
1051
1175
  error?: string;
1052
1176
  }
1053
- declare const _default$O: TaskFn<GroupModifyParams, GroupModifyResult>;
1177
+ declare const _default$3d: TaskFn<GroupModifyParams, GroupModifyResult>;
1054
1178
 
1055
1179
  type group_GroupCreateParams = GroupCreateParams;
1056
1180
  type group_GroupCreateResult = GroupCreateResult;
@@ -1064,7 +1188,7 @@ type group_GroupListResult = GroupListResult;
1064
1188
  type group_GroupModifyParams = GroupModifyParams;
1065
1189
  type group_GroupModifyResult = GroupModifyResult;
1066
1190
  declare namespace group {
1067
- export { type group_GroupCreateParams as GroupCreateParams, type group_GroupCreateResult as GroupCreateResult, type group_GroupDeleteParams as GroupDeleteParams, type group_GroupDeleteResult as GroupDeleteResult, type group_GroupExistsParams as GroupExistsParams, type group_GroupExistsResult as GroupExistsResult, type group_GroupInfo as GroupInfo, type group_GroupListParams as GroupListParams, type group_GroupListResult as GroupListResult, type group_GroupModifyParams as GroupModifyParams, type group_GroupModifyResult as GroupModifyResult, _default$S as create, _default$R as delete, _default$Q as exists, _default$P as list, _default$O as modify };
1191
+ export { type group_GroupCreateParams as GroupCreateParams, type group_GroupCreateResult as GroupCreateResult, type group_GroupDeleteParams as GroupDeleteParams, type group_GroupDeleteResult as GroupDeleteResult, type group_GroupExistsParams as GroupExistsParams, type group_GroupExistsResult as GroupExistsResult, type group_GroupInfo as GroupInfo, type group_GroupListParams as GroupListParams, type group_GroupListResult as GroupListResult, type group_GroupModifyParams as GroupModifyParams, type group_GroupModifyResult as GroupModifyResult, _default$3h as create, _default$3g as delete, _default$3f as exists, _default$3e as list, _default$3d as modify };
1068
1192
  }
1069
1193
 
1070
1194
  interface OSInfo {
@@ -1098,13 +1222,15 @@ interface HostSummary {
1098
1222
 
1099
1223
  interface HostInfoResult {
1100
1224
  host: HostInfo;
1225
+ success: boolean;
1226
+ error?: string;
1101
1227
  }
1102
- declare const _default$N: TaskFn<ObjectType, HostInfoResult>;
1228
+ declare const _default$3c: TaskFn<ObjectType, HostInfoResult>;
1103
1229
 
1104
1230
  interface HostSummaryResult {
1105
1231
  host: HostSummary;
1106
1232
  }
1107
- declare const _default$M: TaskFn<ObjectType, HostSummaryResult>;
1233
+ declare const _default$3b: TaskFn<ObjectType, HostSummaryResult>;
1108
1234
 
1109
1235
  interface OsDetailsResult {
1110
1236
  success: boolean;
@@ -1121,7 +1247,7 @@ interface OsDetailsResult {
1121
1247
  * Determines the operating system family, specific OS, variant, and version.
1122
1248
  * @returns {OsDetailsResult}
1123
1249
  */
1124
- declare const _default$L: TaskFn<ObjectType, OsDetailsResult>;
1250
+ declare const _default$3a: TaskFn<ObjectType, OsDetailsResult>;
1125
1251
 
1126
1252
  interface HostnameParams {
1127
1253
  new_name?: string;
@@ -1129,8 +1255,10 @@ interface HostnameParams {
1129
1255
  interface HostnameResult {
1130
1256
  hostname: string;
1131
1257
  updated: boolean;
1258
+ success: boolean;
1259
+ error?: string;
1132
1260
  }
1133
- declare const _default$K: TaskFn<HostnameParams, HostnameResult>;
1261
+ declare const _default$39: TaskFn<HostnameParams, HostnameResult>;
1134
1262
 
1135
1263
  type host_HostInfo = HostInfo;
1136
1264
  type host_HostInfoResult = HostInfoResult;
@@ -1143,7 +1271,7 @@ type host_LSCPUChild = LSCPUChild;
1143
1271
  type host_OSInfo = OSInfo;
1144
1272
  type host_OsDetailsResult = OsDetailsResult;
1145
1273
  declare namespace host {
1146
- export { type host_HostInfo as HostInfo, type host_HostInfoResult as HostInfoResult, type host_HostSummary as HostSummary, type host_HostSummaryResult as HostSummaryResult, type host_HostnameParams as HostnameParams, type host_HostnameResult as HostnameResult, type host_LSBRelease as LSBRelease, type host_LSCPUChild as LSCPUChild, type host_OSInfo as OSInfo, type host_OsDetailsResult as OsDetailsResult, _default$K as hostname, _default$N as info, _default$L as os, _default$M as summary };
1274
+ export { type host_HostInfo as HostInfo, type host_HostInfoResult as HostInfoResult, type host_HostSummary as HostSummary, type host_HostSummaryResult as HostSummaryResult, type host_HostnameParams as HostnameParams, type host_HostnameResult as HostnameResult, type host_LSBRelease as LSBRelease, type host_LSCPUChild as LSCPUChild, type host_OSInfo as OSInfo, type host_OsDetailsResult as OsDetailsResult, _default$39 as hostname, _default$3c as info, _default$3a as os, _default$3b as summary };
1147
1275
  }
1148
1276
 
1149
1277
  interface AbstractPkgParams {
@@ -1155,6 +1283,11 @@ interface AbstractPkgParams {
1155
1283
  packageManager?: string;
1156
1284
  /** Additional arguments to pass to the package manager */
1157
1285
  extraArgs?: string;
1286
+ /**
1287
+ * Map of interactive prompt patterns to responses. If a prompt matching a pattern appears during installation,
1288
+ * the corresponding response will be sent to stdin. Merged with default patterns for common package manager prompts.
1289
+ */
1290
+ input?: Record<string, string>;
1158
1291
  }
1159
1292
  interface AbstractPkgResult {
1160
1293
  success: boolean;
@@ -1162,6 +1295,9 @@ interface AbstractPkgResult {
1162
1295
  packageManager?: string;
1163
1296
  output?: string;
1164
1297
  packages?: AbstractPkgInfo[];
1298
+ removed?: string[];
1299
+ notInstalled?: string[];
1300
+ failed?: string[];
1165
1301
  }
1166
1302
  interface AbstractPkgInfo {
1167
1303
  name: string;
@@ -1170,12 +1306,48 @@ interface AbstractPkgInfo {
1170
1306
  status?: string;
1171
1307
  [key: string]: any;
1172
1308
  }
1309
+ interface AbstractPkgCleanResult extends AbstractPkgResult {
1310
+ }
1311
+ interface AbstractPkgCleanParams {
1312
+ /** Force use of specific package manager (auto-detect if not specified) */
1313
+ packageManager?: string;
1314
+ /** Whether to run the command with sudo */
1315
+ sudo?: boolean;
1316
+ }
1173
1317
 
1174
1318
  interface AbstractPkgInstallParams extends AbstractPkgParams {
1175
1319
  }
1176
1320
  interface AbstractPkgInstallResult extends AbstractPkgResult {
1177
1321
  }
1178
- declare const _default$J: TaskFn<AbstractPkgInstallParams, AbstractPkgInstallResult>;
1322
+ declare const _default$38: TaskFn<AbstractPkgInstallParams, AbstractPkgInstallResult>;
1323
+
1324
+ interface AbstractPkgUninstallParams extends AbstractPkgParams {
1325
+ }
1326
+ interface AbstractPkgUninstallResult extends AbstractPkgResult {
1327
+ }
1328
+ declare const _default$37: TaskFn<AbstractPkgUninstallParams, AbstractPkgUninstallResult>;
1329
+
1330
+ interface AbstractPkgUpdateParams {
1331
+ /** Run commands with sudo (default true) */
1332
+ sudo?: boolean;
1333
+ /** Force use of specific package manager (auto-detect if not specified) */
1334
+ packageManager?: string;
1335
+ /** Additional arguments to pass to the package manager */
1336
+ extraArgs?: string;
1337
+ }
1338
+ interface AbstractPkgUpdateResult extends AbstractPkgResult {
1339
+ }
1340
+ declare const _default$36: TaskFn<AbstractPkgUpdateParams, AbstractPkgUpdateResult>;
1341
+
1342
+ interface PkgInfoParams {
1343
+ package: string;
1344
+ }
1345
+ interface PkgInfoResult {
1346
+ installed: boolean;
1347
+ success: boolean;
1348
+ error?: string;
1349
+ }
1350
+ declare const _default$35: TaskFn<PkgInfoParams, PkgInfoResult>;
1179
1351
 
1180
1352
  interface BasePkgParams {
1181
1353
  /** Package name or array of package names */
@@ -1211,44 +1383,18 @@ interface PkgIsInstalledParams {
1211
1383
  package: string;
1212
1384
  }
1213
1385
  interface PkgIsInstalledResult {
1214
- installed: boolean;
1215
- }
1216
-
1217
- declare const _default$I: TaskFn<PkgRemoveParams, PkgRemoveResult>;
1218
-
1219
- declare const _default$H: TaskFn<PkgUpdateParams, PkgUpdateResult>;
1220
-
1221
- interface PkgInfoParams {
1222
- package: string;
1223
- }
1224
- interface PkgInfoResult {
1225
- installed: boolean;
1226
1386
  success: boolean;
1387
+ installed: boolean;
1227
1388
  error?: string;
1228
1389
  }
1229
- declare const _default$G: TaskFn<PkgInfoParams, PkgInfoResult>;
1230
1390
 
1231
- declare const _default$F: TaskFn<PkgIsInstalledParams, PkgIsInstalledResult>;
1391
+ declare const _default$34: TaskFn<PkgIsInstalledParams, PkgIsInstalledResult>;
1232
1392
 
1233
- declare const _default$E: TaskFn<PkgInstallParams, PkgInstallResult>;
1393
+ declare const install: TaskFn<PkgInstallParams, PkgInstallResult>;
1234
1394
 
1235
- interface AbstractPkgUninstallParams extends AbstractPkgParams {
1236
- }
1237
- interface AbstractPkgUninstallResult extends AbstractPkgResult {
1238
- }
1239
- declare const _default$D: TaskFn<AbstractPkgUninstallParams, AbstractPkgUninstallResult>;
1395
+ declare const _default$33: TaskFn<PkgRemoveParams, PkgRemoveResult>;
1240
1396
 
1241
- interface AbstractPkgUpdateParams {
1242
- /** Run commands with sudo (default true) */
1243
- sudo?: boolean;
1244
- /** Force use of specific package manager (auto-detect if not specified) */
1245
- packageManager?: string;
1246
- /** Additional arguments to pass to the package manager */
1247
- extraArgs?: string;
1248
- }
1249
- interface AbstractPkgUpdateResult extends AbstractPkgResult {
1250
- }
1251
- declare const _default$C: TaskFn<AbstractPkgUpdateParams, AbstractPkgUpdateResult>;
1397
+ declare const _default$32: TaskFn<PkgUpdateParams, PkgUpdateResult>;
1252
1398
 
1253
1399
  interface AbstractPkgUpgradeParams {
1254
1400
  /** Run commands with sudo (default true) */
@@ -1260,7 +1406,7 @@ interface AbstractPkgUpgradeParams {
1260
1406
  }
1261
1407
  interface AbstractPkgUpgradeResult extends AbstractPkgResult {
1262
1408
  }
1263
- declare const _default$B: TaskFn<AbstractPkgUpgradeParams, AbstractPkgUpgradeResult>;
1409
+ declare const _default$31: TaskFn<AbstractPkgUpgradeParams, AbstractPkgUpgradeResult>;
1264
1410
 
1265
1411
  interface AbstractPkgSearchParams {
1266
1412
  /** Search query */
@@ -1270,7 +1416,7 @@ interface AbstractPkgSearchParams {
1270
1416
  }
1271
1417
  interface AbstractPkgSearchResult extends AbstractPkgResult {
1272
1418
  }
1273
- declare const _default$A: TaskFn<AbstractPkgSearchParams, AbstractPkgSearchResult>;
1419
+ declare const _default$30: TaskFn<AbstractPkgSearchParams, AbstractPkgSearchResult>;
1274
1420
 
1275
1421
  interface AbstractPkgListParams {
1276
1422
  /** Force use of specific package manager (auto-detect if not specified) */
@@ -1278,17 +1424,869 @@ interface AbstractPkgListParams {
1278
1424
  }
1279
1425
  interface AbstractPkgListResult extends AbstractPkgResult {
1280
1426
  }
1281
- declare const _default$z: TaskFn<AbstractPkgListParams, AbstractPkgListResult>;
1427
+ declare const _default$2$: TaskFn<AbstractPkgListParams, AbstractPkgListResult>;
1282
1428
 
1283
- interface AbstractPkgCleanParams {
1284
- /** Force use of specific package manager (auto-detect if not specified) */
1285
- packageManager?: string;
1429
+ declare const _default$2_: TaskFn<AbstractPkgCleanParams, AbstractPkgCleanResult>;
1430
+
1431
+ interface AptBaseParams extends AbstractPkgParams {
1432
+ /** Force use of apt package manager (always true for apt-specific tasks) */
1433
+ packageManager?: 'apt';
1434
+ /** Whether to install recommended packages (default: false) */
1435
+ installRecommends?: boolean;
1436
+ /** Whether to install suggested packages (default: false) */
1437
+ installSuggests?: boolean;
1438
+ /** Whether to hold packages (prevent automatic upgrades) */
1439
+ hold?: boolean;
1440
+ /** Whether to allow downgrades */
1441
+ allowDowngrades?: boolean;
1442
+ /** Whether to allow removal of essential packages */
1443
+ allowRemoveEssential?: boolean;
1444
+ /** Whether to allow changes to held packages */
1445
+ allowChangeHeld?: boolean;
1446
+ }
1447
+ interface AptInstallParams extends AptBaseParams {
1448
+ /** Package name or array of package names */
1449
+ package: string | string[];
1450
+ /** Whether to fix broken dependencies */
1451
+ fixBroken?: boolean;
1452
+ /** Whether to reinstall packages */
1453
+ reinstall?: boolean;
1454
+ }
1455
+ interface AptInstallResult extends AbstractPkgResult {
1456
+ /** List of installed packages with versions */
1457
+ installed?: Array<{
1458
+ name: string;
1459
+ version: string;
1460
+ architecture?: string;
1461
+ }>;
1462
+ /** List of packages that were already installed */
1463
+ alreadyInstalled?: string[];
1464
+ /** List of packages that failed to install */
1465
+ failed?: string[];
1466
+ }
1467
+ interface AptUninstallParams extends AptBaseParams {
1468
+ /** Package name or array of package names */
1469
+ package: string | string[];
1470
+ /** Whether to purge configuration files */
1471
+ purge?: boolean;
1472
+ /** Whether to remove dependencies that are no longer needed */
1473
+ autoremove?: boolean;
1474
+ }
1475
+ interface AptUninstallResult extends AbstractPkgResult {
1476
+ /** List of removed packages */
1477
+ removed?: string[];
1478
+ /** List of packages that were not installed */
1479
+ notInstalled?: string[];
1480
+ /** List of packages that failed to remove */
1481
+ failed?: string[];
1482
+ }
1483
+ interface AptUpdateParams extends AptBaseParams {
1484
+ /** Whether to update package lists */
1485
+ updateLists?: boolean;
1486
+ /** Whether to upgrade packages */
1487
+ upgrade?: boolean;
1488
+ }
1489
+ interface AptUpdateResult extends AbstractPkgResult {
1490
+ /** Number of packages updated */
1491
+ packagesUpdated?: number;
1492
+ /** List of updated packages */
1493
+ updatedPackages?: string[];
1494
+ }
1495
+ interface AptUpgradeParams extends AptBaseParams {
1496
+ /** Whether to perform a full upgrade (dist-upgrade) */
1497
+ fullUpgrade?: boolean;
1498
+ /** Whether to upgrade only security updates */
1499
+ securityOnly?: boolean;
1500
+ }
1501
+ interface AptUpgradeResult extends AbstractPkgResult {
1502
+ /** Number of packages upgraded */
1503
+ packagesUpgraded?: number;
1504
+ /** List of upgraded packages */
1505
+ upgradedPackages?: string[];
1506
+ /** Whether a reboot is recommended */
1507
+ rebootRecommended?: boolean;
1508
+ }
1509
+ interface AptSearchParams extends AptBaseParams {
1510
+ /** Search query */
1511
+ query: string;
1512
+ /** Whether to search in package names only */
1513
+ namesOnly?: boolean;
1514
+ /** Whether to search in package descriptions */
1515
+ descriptions?: boolean;
1516
+ }
1517
+ interface AptSearchResult extends AbstractPkgResult {
1518
+ /** Search results */
1519
+ results?: Array<{
1520
+ name: string;
1521
+ version?: string;
1522
+ description?: string;
1523
+ installed?: boolean;
1524
+ }>;
1525
+ }
1526
+ interface AptListParams extends AptBaseParams {
1527
+ /** Filter by package name pattern */
1528
+ pattern?: string;
1529
+ /** Whether to show only installed packages */
1530
+ installed?: boolean;
1531
+ /** Whether to show only upgradable packages */
1532
+ upgradable?: boolean;
1533
+ }
1534
+ interface AptListResult extends AbstractPkgResult {
1535
+ /** List of packages */
1536
+ packages?: Array<{
1537
+ name: string;
1538
+ version: string;
1539
+ architecture?: string;
1540
+ status?: string;
1541
+ description?: string;
1542
+ }>;
1543
+ }
1544
+ interface AptCleanParams extends AptBaseParams {
1545
+ /** Whether to remove unused packages */
1546
+ autoremove?: boolean;
1547
+ /** Whether to clean package cache */
1548
+ autoclean?: boolean;
1549
+ }
1550
+ interface AptCleanResult extends AbstractPkgResult {
1551
+ /** Number of packages removed */
1552
+ packagesRemoved?: number;
1553
+ /** Amount of disk space freed */
1554
+ spaceFreed?: string;
1555
+ }
1556
+ interface AptIsInstalledParams extends AptBaseParams {
1557
+ /** Package name */
1558
+ package: string;
1286
1559
  }
1287
- interface AbstractPkgCleanResult extends AbstractPkgResult {
1560
+ interface AptIsInstalledResult extends AbstractPkgResult {
1561
+ /** Whether the package is installed */
1562
+ installed: boolean;
1563
+ /** Package version if installed */
1564
+ version?: string;
1565
+ /** Package architecture if installed */
1566
+ architecture?: string;
1567
+ }
1568
+ interface AptInfoParams extends AptBaseParams {
1569
+ /** Package name */
1570
+ package: string;
1571
+ }
1572
+ interface AptInfoResult extends AbstractPkgResult {
1573
+ /** Package information */
1574
+ info?: {
1575
+ name: string;
1576
+ version?: string;
1577
+ architecture?: string;
1578
+ description?: string;
1579
+ depends?: string[];
1580
+ recommends?: string[];
1581
+ suggests?: string[];
1582
+ conflicts?: string[];
1583
+ provides?: string[];
1584
+ replaces?: string[];
1585
+ size?: string;
1586
+ priority?: string;
1587
+ section?: string;
1588
+ maintainer?: string;
1589
+ homepage?: string;
1590
+ };
1591
+ /** Whether the package is installed */
1592
+ installed?: boolean;
1593
+ }
1594
+ interface AptAddKeyParams {
1595
+ url: string;
1596
+ keyring: string;
1597
+ /** Run commands with sudo (default true) */
1598
+ sudo?: boolean;
1599
+ }
1600
+ interface AptAddKeyResult {
1601
+ success: boolean;
1602
+ error?: string;
1603
+ }
1604
+ interface AptAddRepositoryParams {
1605
+ repo: string;
1606
+ name: string;
1607
+ /** Run commands with sudo (default true) */
1608
+ sudo?: boolean;
1609
+ }
1610
+ interface AptAddRepositoryResult {
1611
+ success: boolean;
1612
+ error?: string;
1288
1613
  }
1289
- declare const _default$y: TaskFn<AbstractPkgCleanParams, AbstractPkgCleanResult>;
1290
1614
 
1291
- type pkg_AbstractPkgCleanParams = AbstractPkgCleanParams;
1615
+ declare const _default$2Z: TaskFn<AptInstallParams, AptInstallResult>;
1616
+
1617
+ declare const _default$2Y: TaskFn<AptUninstallParams, AptUninstallResult>;
1618
+
1619
+ declare const _default$2X: TaskFn<AptUpdateParams, AptUpdateResult>;
1620
+
1621
+ declare const _default$2W: TaskFn<AptUpgradeParams, AptUpgradeResult>;
1622
+
1623
+ declare const _default$2V: TaskFn<AptSearchParams, AptSearchResult>;
1624
+
1625
+ declare const _default$2U: TaskFn<AptListParams, AptListResult>;
1626
+
1627
+ declare const _default$2T: TaskFn<AptCleanParams, AptCleanResult>;
1628
+
1629
+ declare const _default$2S: TaskFn<AptIsInstalledParams, AptIsInstalledResult>;
1630
+
1631
+ declare const _default$2R: TaskFn<AptInfoParams, AptInfoResult>;
1632
+
1633
+ declare const _default$2Q: TaskFn<AptAddKeyParams, AptAddKeyResult>;
1634
+
1635
+ declare const _default$2P: TaskFn<AptAddRepositoryParams, AptAddRepositoryResult>;
1636
+
1637
+ type index$3_AptAddKeyParams = AptAddKeyParams;
1638
+ type index$3_AptAddKeyResult = AptAddKeyResult;
1639
+ type index$3_AptAddRepositoryParams = AptAddRepositoryParams;
1640
+ type index$3_AptAddRepositoryResult = AptAddRepositoryResult;
1641
+ type index$3_AptCleanParams = AptCleanParams;
1642
+ type index$3_AptCleanResult = AptCleanResult;
1643
+ type index$3_AptInfoParams = AptInfoParams;
1644
+ type index$3_AptInfoResult = AptInfoResult;
1645
+ type index$3_AptInstallParams = AptInstallParams;
1646
+ type index$3_AptInstallResult = AptInstallResult;
1647
+ type index$3_AptIsInstalledParams = AptIsInstalledParams;
1648
+ type index$3_AptIsInstalledResult = AptIsInstalledResult;
1649
+ type index$3_AptListParams = AptListParams;
1650
+ type index$3_AptListResult = AptListResult;
1651
+ type index$3_AptSearchParams = AptSearchParams;
1652
+ type index$3_AptSearchResult = AptSearchResult;
1653
+ type index$3_AptUninstallParams = AptUninstallParams;
1654
+ type index$3_AptUninstallResult = AptUninstallResult;
1655
+ type index$3_AptUpdateParams = AptUpdateParams;
1656
+ type index$3_AptUpdateResult = AptUpdateResult;
1657
+ type index$3_AptUpgradeParams = AptUpgradeParams;
1658
+ type index$3_AptUpgradeResult = AptUpgradeResult;
1659
+ declare namespace index$3 {
1660
+ export { type index$3_AptAddKeyParams as AptAddKeyParams, type index$3_AptAddKeyResult as AptAddKeyResult, type index$3_AptAddRepositoryParams as AptAddRepositoryParams, type index$3_AptAddRepositoryResult as AptAddRepositoryResult, type index$3_AptCleanParams as AptCleanParams, type index$3_AptCleanResult as AptCleanResult, type index$3_AptInfoParams as AptInfoParams, type index$3_AptInfoResult as AptInfoResult, type index$3_AptInstallParams as AptInstallParams, type index$3_AptInstallResult as AptInstallResult, type index$3_AptIsInstalledParams as AptIsInstalledParams, type index$3_AptIsInstalledResult as AptIsInstalledResult, type index$3_AptListParams as AptListParams, type index$3_AptListResult as AptListResult, type index$3_AptSearchParams as AptSearchParams, type index$3_AptSearchResult as AptSearchResult, type index$3_AptUninstallParams as AptUninstallParams, type index$3_AptUninstallResult as AptUninstallResult, type index$3_AptUpdateParams as AptUpdateParams, type index$3_AptUpdateResult as AptUpdateResult, type index$3_AptUpgradeParams as AptUpgradeParams, type index$3_AptUpgradeResult as AptUpgradeResult, _default$2Q as add_key, _default$2P as add_repository, _default$2T as clean, _default$2R as info, _default$2Z as install, _default$2S as isInstalled, _default$2U as list, _default$2V as search, _default$2Y as uninstall, _default$2X as update, _default$2W as upgrade };
1661
+ }
1662
+
1663
+ interface DnfBaseParams extends AbstractPkgParams {
1664
+ /** Force use of dnf package manager (always true for dnf-specific tasks) */
1665
+ packageManager?: 'dnf';
1666
+ /** Whether to install weak dependencies (default: false) */
1667
+ installWeakDeps?: boolean;
1668
+ /** Whether to install recommended packages (default: false) */
1669
+ installRecommends?: boolean;
1670
+ /** Whether to allow downgrades */
1671
+ allowDowngrades?: boolean;
1672
+ /** Whether to allow erasing of protected packages */
1673
+ allowErasing?: boolean;
1674
+ /** Whether to skip broken packages */
1675
+ skipBroken?: boolean;
1676
+ }
1677
+ interface DnfInstallParams extends DnfBaseParams {
1678
+ /** Package name or array of package names */
1679
+ package: string | string[];
1680
+ /** Whether to install from a specific repository */
1681
+ repo?: string;
1682
+ /** Whether to install the best available version */
1683
+ best?: boolean;
1684
+ }
1685
+ interface DnfInstallResult extends AbstractPkgResult {
1686
+ /** List of installed packages with versions */
1687
+ installed?: Array<{
1688
+ name: string;
1689
+ version: string;
1690
+ architecture?: string;
1691
+ repository?: string;
1692
+ }>;
1693
+ /** List of packages that were already installed */
1694
+ alreadyInstalled?: string[];
1695
+ /** List of packages that failed to install */
1696
+ failed?: string[];
1697
+ }
1698
+ interface DnfUninstallParams extends DnfBaseParams {
1699
+ /** Package name or array of package names */
1700
+ package: string | string[];
1701
+ /** Whether to remove dependencies that are no longer needed */
1702
+ autoremove?: boolean;
1703
+ /** Whether to remove all packages that depend on the specified packages */
1704
+ removeDeps?: boolean;
1705
+ }
1706
+ interface DnfUninstallResult extends AbstractPkgResult {
1707
+ /** List of removed packages */
1708
+ removed?: string[];
1709
+ /** List of packages that were not installed */
1710
+ notInstalled?: string[];
1711
+ /** List of packages that failed to remove */
1712
+ failed?: string[];
1713
+ }
1714
+ interface DnfUpdateParams extends DnfBaseParams {
1715
+ /** Whether to update package metadata */
1716
+ updateMetadata?: boolean;
1717
+ /** Whether to upgrade packages */
1718
+ upgrade?: boolean;
1719
+ }
1720
+ interface DnfUpdateResult extends AbstractPkgResult {
1721
+ /** Number of packages updated */
1722
+ packagesUpdated?: number;
1723
+ /** List of updated packages */
1724
+ updatedPackages?: string[];
1725
+ }
1726
+ interface DnfUpgradeParams extends DnfBaseParams {
1727
+ /** Whether to perform a full system upgrade */
1728
+ fullUpgrade?: boolean;
1729
+ /** Whether to upgrade only security updates */
1730
+ securityOnly?: boolean;
1731
+ }
1732
+ interface DnfUpgradeResult extends AbstractPkgResult {
1733
+ /** Number of packages upgraded */
1734
+ packagesUpgraded?: number;
1735
+ /** List of upgraded packages */
1736
+ upgradedPackages?: string[];
1737
+ /** Whether a reboot is recommended */
1738
+ rebootRecommended?: boolean;
1739
+ }
1740
+ interface DnfSearchParams extends DnfBaseParams {
1741
+ /** Search query */
1742
+ query: string;
1743
+ /** Whether to search in package names only */
1744
+ namesOnly?: boolean;
1745
+ /** Whether to search in package descriptions */
1746
+ descriptions?: boolean;
1747
+ }
1748
+ interface DnfSearchResult extends AbstractPkgResult {
1749
+ /** Search results */
1750
+ results?: Array<{
1751
+ name: string;
1752
+ version?: string;
1753
+ architecture?: string;
1754
+ repository?: string;
1755
+ description?: string;
1756
+ installed?: boolean;
1757
+ }>;
1758
+ }
1759
+ interface DnfListParams extends DnfBaseParams {
1760
+ /** Filter by package name pattern */
1761
+ pattern?: string;
1762
+ /** Whether to show only installed packages */
1763
+ installed?: boolean;
1764
+ /** Whether to show only available packages */
1765
+ available?: boolean;
1766
+ /** Whether to show only upgradable packages */
1767
+ upgradable?: boolean;
1768
+ }
1769
+ interface DnfListResult extends AbstractPkgResult {
1770
+ /** List of packages */
1771
+ packages?: Array<{
1772
+ name: string;
1773
+ version: string;
1774
+ architecture?: string;
1775
+ repository?: string;
1776
+ status?: string;
1777
+ description?: string;
1778
+ }>;
1779
+ }
1780
+ interface DnfCleanParams extends DnfBaseParams {
1781
+ /** Whether to clean all caches */
1782
+ all?: boolean;
1783
+ /** Whether to clean package cache */
1784
+ packages?: boolean;
1785
+ /** Whether to clean metadata cache */
1786
+ metadata?: boolean;
1787
+ }
1788
+ interface DnfCleanResult extends AbstractPkgResult {
1789
+ /** Number of packages removed */
1790
+ packagesRemoved?: number;
1791
+ /** Amount of disk space freed */
1792
+ spaceFreed?: string;
1793
+ }
1794
+ interface DnfIsInstalledParams extends DnfBaseParams {
1795
+ /** Package name */
1796
+ package: string;
1797
+ }
1798
+ interface DnfIsInstalledResult extends AbstractPkgResult {
1799
+ /** Whether the package is installed */
1800
+ installed: boolean;
1801
+ /** Package version if installed */
1802
+ version?: string;
1803
+ /** Package architecture if installed */
1804
+ architecture?: string;
1805
+ /** Package repository if installed */
1806
+ repository?: string;
1807
+ }
1808
+ interface DnfInfoParams extends DnfBaseParams {
1809
+ /** Package name */
1810
+ package: string;
1811
+ }
1812
+ interface DnfInfoResult extends AbstractPkgResult {
1813
+ /** Package information */
1814
+ info?: {
1815
+ name: string;
1816
+ version?: string;
1817
+ architecture?: string;
1818
+ repository?: string;
1819
+ description?: string;
1820
+ depends?: string[];
1821
+ provides?: string[];
1822
+ conflicts?: string[];
1823
+ obsoletes?: string[];
1824
+ size?: string;
1825
+ license?: string;
1826
+ vendor?: string;
1827
+ url?: string;
1828
+ };
1829
+ /** Whether the package is installed */
1830
+ installed?: boolean;
1831
+ }
1832
+
1833
+ declare const _default$2O: TaskFn<DnfInstallParams, DnfInstallResult>;
1834
+
1835
+ declare const _default$2N: TaskFn<DnfUninstallParams, DnfUninstallResult>;
1836
+
1837
+ declare const _default$2M: TaskFn<DnfUpdateParams, DnfUpdateResult>;
1838
+
1839
+ declare const _default$2L: TaskFn<DnfUpgradeParams, DnfUpgradeResult>;
1840
+
1841
+ declare const _default$2K: TaskFn<DnfSearchParams, DnfSearchResult>;
1842
+
1843
+ declare const _default$2J: TaskFn<DnfListParams, DnfListResult>;
1844
+
1845
+ declare const _default$2I: TaskFn<DnfCleanParams, DnfCleanResult>;
1846
+
1847
+ declare const _default$2H: TaskFn<DnfIsInstalledParams, DnfIsInstalledResult>;
1848
+
1849
+ declare const _default$2G: TaskFn<DnfInfoParams, DnfInfoResult>;
1850
+
1851
+ type index$2_DnfCleanParams = DnfCleanParams;
1852
+ type index$2_DnfCleanResult = DnfCleanResult;
1853
+ type index$2_DnfInfoParams = DnfInfoParams;
1854
+ type index$2_DnfInfoResult = DnfInfoResult;
1855
+ type index$2_DnfInstallParams = DnfInstallParams;
1856
+ type index$2_DnfInstallResult = DnfInstallResult;
1857
+ type index$2_DnfIsInstalledParams = DnfIsInstalledParams;
1858
+ type index$2_DnfIsInstalledResult = DnfIsInstalledResult;
1859
+ type index$2_DnfListParams = DnfListParams;
1860
+ type index$2_DnfListResult = DnfListResult;
1861
+ type index$2_DnfSearchParams = DnfSearchParams;
1862
+ type index$2_DnfSearchResult = DnfSearchResult;
1863
+ type index$2_DnfUninstallParams = DnfUninstallParams;
1864
+ type index$2_DnfUninstallResult = DnfUninstallResult;
1865
+ type index$2_DnfUpdateParams = DnfUpdateParams;
1866
+ type index$2_DnfUpdateResult = DnfUpdateResult;
1867
+ type index$2_DnfUpgradeParams = DnfUpgradeParams;
1868
+ type index$2_DnfUpgradeResult = DnfUpgradeResult;
1869
+ declare namespace index$2 {
1870
+ export { type index$2_DnfCleanParams as DnfCleanParams, type index$2_DnfCleanResult as DnfCleanResult, type index$2_DnfInfoParams as DnfInfoParams, type index$2_DnfInfoResult as DnfInfoResult, type index$2_DnfInstallParams as DnfInstallParams, type index$2_DnfInstallResult as DnfInstallResult, type index$2_DnfIsInstalledParams as DnfIsInstalledParams, type index$2_DnfIsInstalledResult as DnfIsInstalledResult, type index$2_DnfListParams as DnfListParams, type index$2_DnfListResult as DnfListResult, type index$2_DnfSearchParams as DnfSearchParams, type index$2_DnfSearchResult as DnfSearchResult, type index$2_DnfUninstallParams as DnfUninstallParams, type index$2_DnfUninstallResult as DnfUninstallResult, type index$2_DnfUpdateParams as DnfUpdateParams, type index$2_DnfUpdateResult as DnfUpdateResult, type index$2_DnfUpgradeParams as DnfUpgradeParams, type index$2_DnfUpgradeResult as DnfUpgradeResult, _default$2I as clean, _default$2G as info, _default$2O as install, _default$2H as isInstalled, _default$2J as list, _default$2K as search, _default$2N as uninstall, _default$2M as update, _default$2L as upgrade };
1871
+ }
1872
+
1873
+ interface YumBaseParams extends AbstractPkgParams {
1874
+ /** Force use of yum package manager (always true for yum-specific tasks) */
1875
+ packageManager?: 'yum';
1876
+ /** Whether to install weak dependencies (default: false) */
1877
+ installWeakDeps?: boolean;
1878
+ /** Whether to allow downgrades */
1879
+ allowDowngrades?: boolean;
1880
+ /** Whether to allow erasing of protected packages */
1881
+ allowErasing?: boolean;
1882
+ }
1883
+ interface YumInstallParams extends YumBaseParams {
1884
+ /** Package name or array of package names */
1885
+ package: string | string[];
1886
+ /** Whether to install from a specific repository */
1887
+ repo?: string;
1888
+ }
1889
+ interface YumInstallResult extends AbstractPkgResult {
1890
+ /** List of installed packages with versions */
1891
+ installed?: Array<{
1892
+ name: string;
1893
+ version: string;
1894
+ architecture?: string;
1895
+ repository?: string;
1896
+ }>;
1897
+ /** List of packages that were already installed */
1898
+ alreadyInstalled?: string[];
1899
+ /** List of packages that failed to install */
1900
+ failed?: string[];
1901
+ }
1902
+ interface YumUninstallParams extends YumBaseParams {
1903
+ /** Package name or array of package names */
1904
+ package: string | string[];
1905
+ /** Whether to remove dependencies that are no longer needed */
1906
+ autoremove?: boolean;
1907
+ }
1908
+ interface YumUninstallResult extends AbstractPkgResult {
1909
+ /** List of removed packages */
1910
+ removed?: string[];
1911
+ /** List of packages that were not installed */
1912
+ notInstalled?: string[];
1913
+ /** List of packages that failed to remove */
1914
+ failed?: string[];
1915
+ }
1916
+ interface YumUpdateParams extends YumBaseParams {
1917
+ /** Whether to update package metadata */
1918
+ updateMetadata?: boolean;
1919
+ /** Whether to upgrade packages */
1920
+ upgrade?: boolean;
1921
+ }
1922
+ interface YumUpdateResult extends AbstractPkgResult {
1923
+ /** Number of packages updated */
1924
+ packagesUpdated?: number;
1925
+ /** List of updated packages */
1926
+ updatedPackages?: string[];
1927
+ }
1928
+ interface YumUpgradeParams extends YumBaseParams {
1929
+ /** Whether to perform a full system upgrade */
1930
+ fullUpgrade?: boolean;
1931
+ /** Whether to upgrade only security updates */
1932
+ securityOnly?: boolean;
1933
+ }
1934
+ interface YumUpgradeResult extends AbstractPkgResult {
1935
+ /** Number of packages upgraded */
1936
+ packagesUpgraded?: number;
1937
+ /** List of upgraded packages */
1938
+ upgradedPackages?: string[];
1939
+ /** Whether a reboot is recommended */
1940
+ rebootRecommended?: boolean;
1941
+ }
1942
+ interface YumSearchParams extends YumBaseParams {
1943
+ /** Search query */
1944
+ query: string;
1945
+ /** Whether to search in package names only */
1946
+ namesOnly?: boolean;
1947
+ /** Whether to search in package descriptions */
1948
+ descriptions?: boolean;
1949
+ }
1950
+ interface YumSearchResult extends AbstractPkgResult {
1951
+ /** Search results */
1952
+ results?: Array<{
1953
+ name: string;
1954
+ version?: string;
1955
+ architecture?: string;
1956
+ repository?: string;
1957
+ description?: string;
1958
+ installed?: boolean;
1959
+ }>;
1960
+ }
1961
+ interface YumListParams extends YumBaseParams {
1962
+ /** Filter by package name pattern */
1963
+ pattern?: string;
1964
+ /** Whether to show only installed packages */
1965
+ installed?: boolean;
1966
+ /** Whether to show only available packages */
1967
+ available?: boolean;
1968
+ /** Whether to show only upgradable packages */
1969
+ upgradable?: boolean;
1970
+ }
1971
+ interface YumListResult extends AbstractPkgResult {
1972
+ /** List of packages */
1973
+ packages?: Array<{
1974
+ name: string;
1975
+ version: string;
1976
+ architecture?: string;
1977
+ repository?: string;
1978
+ status?: string;
1979
+ description?: string;
1980
+ }>;
1981
+ }
1982
+ interface YumCleanParams extends YumBaseParams {
1983
+ /** Whether to clean all caches */
1984
+ all?: boolean;
1985
+ /** Whether to clean package cache */
1986
+ packages?: boolean;
1987
+ /** Whether to clean metadata cache */
1988
+ metadata?: boolean;
1989
+ }
1990
+ interface YumCleanResult extends AbstractPkgResult {
1991
+ /** Number of packages removed */
1992
+ packagesRemoved?: number;
1993
+ /** Amount of disk space freed */
1994
+ spaceFreed?: string;
1995
+ }
1996
+ interface YumIsInstalledParams extends YumBaseParams {
1997
+ /** Package name */
1998
+ package: string;
1999
+ }
2000
+ interface YumIsInstalledResult extends AbstractPkgResult {
2001
+ /** Whether the package is installed */
2002
+ installed: boolean;
2003
+ /** Package version if installed */
2004
+ version?: string;
2005
+ /** Package architecture if installed */
2006
+ architecture?: string;
2007
+ /** Package repository if installed */
2008
+ repository?: string;
2009
+ }
2010
+ interface YumInfoParams extends YumBaseParams {
2011
+ /** Package name */
2012
+ package: string;
2013
+ }
2014
+ interface YumInfoResult extends AbstractPkgResult {
2015
+ /** Package information */
2016
+ info?: {
2017
+ name: string;
2018
+ version?: string;
2019
+ architecture?: string;
2020
+ repository?: string;
2021
+ description?: string;
2022
+ depends?: string[];
2023
+ provides?: string[];
2024
+ conflicts?: string[];
2025
+ obsoletes?: string[];
2026
+ size?: string;
2027
+ license?: string;
2028
+ vendor?: string;
2029
+ url?: string;
2030
+ };
2031
+ /** Whether the package is installed */
2032
+ installed?: boolean;
2033
+ }
2034
+
2035
+ declare const _default$2F: TaskFn<YumInstallParams, YumInstallResult>;
2036
+
2037
+ declare const _default$2E: TaskFn<YumUninstallParams, YumUninstallResult>;
2038
+
2039
+ declare const _default$2D: TaskFn<YumUpdateParams, YumUpdateResult>;
2040
+
2041
+ declare const _default$2C: TaskFn<YumUpgradeParams, YumUpgradeResult>;
2042
+
2043
+ declare const _default$2B: TaskFn<YumSearchParams, YumSearchResult>;
2044
+
2045
+ declare const _default$2A: TaskFn<{}, {
2046
+ success: boolean;
2047
+ packages: {
2048
+ name: string;
2049
+ version: string;
2050
+ arch: string;
2051
+ repository: string;
2052
+ }[];
2053
+ error?: string;
2054
+ }>;
2055
+
2056
+ declare const _default$2z: TaskFn<YumCleanParams, YumCleanResult>;
2057
+
2058
+ declare const _default$2y: TaskFn<YumIsInstalledParams, YumIsInstalledResult>;
2059
+
2060
+ declare const _default$2x: TaskFn<YumInfoParams, YumInfoResult>;
2061
+
2062
+ type index$1_YumCleanParams = YumCleanParams;
2063
+ type index$1_YumCleanResult = YumCleanResult;
2064
+ type index$1_YumInfoParams = YumInfoParams;
2065
+ type index$1_YumInfoResult = YumInfoResult;
2066
+ type index$1_YumInstallParams = YumInstallParams;
2067
+ type index$1_YumInstallResult = YumInstallResult;
2068
+ type index$1_YumIsInstalledParams = YumIsInstalledParams;
2069
+ type index$1_YumIsInstalledResult = YumIsInstalledResult;
2070
+ type index$1_YumListParams = YumListParams;
2071
+ type index$1_YumListResult = YumListResult;
2072
+ type index$1_YumSearchParams = YumSearchParams;
2073
+ type index$1_YumSearchResult = YumSearchResult;
2074
+ type index$1_YumUninstallParams = YumUninstallParams;
2075
+ type index$1_YumUninstallResult = YumUninstallResult;
2076
+ type index$1_YumUpdateParams = YumUpdateParams;
2077
+ type index$1_YumUpdateResult = YumUpdateResult;
2078
+ type index$1_YumUpgradeParams = YumUpgradeParams;
2079
+ type index$1_YumUpgradeResult = YumUpgradeResult;
2080
+ declare namespace index$1 {
2081
+ export { type index$1_YumCleanParams as YumCleanParams, type index$1_YumCleanResult as YumCleanResult, type index$1_YumInfoParams as YumInfoParams, type index$1_YumInfoResult as YumInfoResult, type index$1_YumInstallParams as YumInstallParams, type index$1_YumInstallResult as YumInstallResult, type index$1_YumIsInstalledParams as YumIsInstalledParams, type index$1_YumIsInstalledResult as YumIsInstalledResult, type index$1_YumListParams as YumListParams, type index$1_YumListResult as YumListResult, type index$1_YumSearchParams as YumSearchParams, type index$1_YumSearchResult as YumSearchResult, type index$1_YumUninstallParams as YumUninstallParams, type index$1_YumUninstallResult as YumUninstallResult, type index$1_YumUpdateParams as YumUpdateParams, type index$1_YumUpdateResult as YumUpdateResult, type index$1_YumUpgradeParams as YumUpgradeParams, type index$1_YumUpgradeResult as YumUpgradeResult, _default$2z as clean, _default$2x as info, _default$2F as install, _default$2y as isInstalled, _default$2A as list, _default$2B as search, _default$2E as uninstall, _default$2D as update, _default$2C as upgrade };
2082
+ }
2083
+
2084
+ interface PacmanBaseParams extends AbstractPkgParams {
2085
+ /** Force use of pacman package manager (always true for pacman-specific tasks) */
2086
+ packageManager?: 'pacman';
2087
+ /** Whether to install dependencies */
2088
+ installDeps?: boolean;
2089
+ /** Whether to install as dependencies */
2090
+ asDeps?: boolean;
2091
+ /** Whether to install as explicit packages */
2092
+ asExplicit?: boolean;
2093
+ }
2094
+ interface PacmanInstallParams extends PacmanBaseParams {
2095
+ /** Package name or array of package names */
2096
+ package: string | string[];
2097
+ /** Whether to install from a specific repository */
2098
+ repo?: string;
2099
+ /** Whether to install the best available version */
2100
+ best?: boolean;
2101
+ }
2102
+ interface PacmanInstallResult extends AbstractPkgResult {
2103
+ /** List of installed packages with versions */
2104
+ installed?: Array<{
2105
+ name: string;
2106
+ version: string;
2107
+ architecture?: string;
2108
+ repository?: string;
2109
+ }>;
2110
+ /** List of packages that were already installed */
2111
+ alreadyInstalled?: string[];
2112
+ /** List of packages that failed to install */
2113
+ failed?: string[];
2114
+ }
2115
+ interface PacmanUninstallParams extends PacmanBaseParams {
2116
+ /** Package name or array of package names */
2117
+ package: string | string[];
2118
+ /** Whether to remove dependencies that are no longer needed */
2119
+ cascade?: boolean;
2120
+ /** Whether to remove all packages that depend on the specified packages */
2121
+ recursive?: boolean;
2122
+ }
2123
+ interface PacmanUninstallResult extends AbstractPkgResult {
2124
+ /** List of removed packages */
2125
+ removed?: string[];
2126
+ /** List of packages that were not installed */
2127
+ notInstalled?: string[];
2128
+ /** List of packages that failed to remove */
2129
+ failed?: string[];
2130
+ }
2131
+ interface PacmanUpdateParams extends PacmanBaseParams {
2132
+ /** Whether to update package metadata */
2133
+ updateMetadata?: boolean;
2134
+ /** Whether to upgrade packages */
2135
+ upgrade?: boolean;
2136
+ }
2137
+ interface PacmanUpdateResult extends AbstractPkgResult {
2138
+ /** Number of packages updated */
2139
+ packagesUpdated?: number;
2140
+ /** List of updated packages */
2141
+ updatedPackages?: string[];
2142
+ }
2143
+ interface PacmanUpgradeParams extends PacmanBaseParams {
2144
+ /** Whether to perform a full system upgrade */
2145
+ fullUpgrade?: boolean;
2146
+ /** Whether to upgrade only security updates */
2147
+ securityOnly?: boolean;
2148
+ }
2149
+ interface PacmanUpgradeResult extends AbstractPkgResult {
2150
+ /** Number of packages upgraded */
2151
+ packagesUpgraded?: number;
2152
+ /** List of upgraded packages */
2153
+ upgradedPackages?: string[];
2154
+ /** Whether a reboot is recommended */
2155
+ rebootRecommended?: boolean;
2156
+ }
2157
+ interface PacmanSearchParams extends PacmanBaseParams {
2158
+ /** Search query */
2159
+ query: string;
2160
+ /** Whether to search in package names only */
2161
+ namesOnly?: boolean;
2162
+ /** Whether to search in package descriptions */
2163
+ descriptions?: boolean;
2164
+ }
2165
+ interface PacmanSearchResult extends AbstractPkgResult {
2166
+ /** Search results */
2167
+ results?: Array<{
2168
+ name: string;
2169
+ version?: string;
2170
+ architecture?: string;
2171
+ repository?: string;
2172
+ description?: string;
2173
+ installed?: boolean;
2174
+ }>;
2175
+ }
2176
+ interface PacmanListParams extends PacmanBaseParams {
2177
+ /** Filter by package name pattern */
2178
+ pattern?: string;
2179
+ /** Whether to show only installed packages */
2180
+ installed?: boolean;
2181
+ /** Whether to show only available packages */
2182
+ available?: boolean;
2183
+ /** Whether to show only upgradable packages */
2184
+ upgradable?: boolean;
2185
+ }
2186
+ interface PacmanListResult extends AbstractPkgResult {
2187
+ /** List of packages */
2188
+ packages?: Array<{
2189
+ name: string;
2190
+ version: string;
2191
+ architecture?: string;
2192
+ repository?: string;
2193
+ status?: string;
2194
+ description?: string;
2195
+ }>;
2196
+ }
2197
+ interface PacmanCleanParams extends PacmanBaseParams {
2198
+ /** Whether to clean all caches */
2199
+ all?: boolean;
2200
+ /** Whether to clean package cache */
2201
+ packages?: boolean;
2202
+ /** Whether to clean metadata cache */
2203
+ metadata?: boolean;
2204
+ }
2205
+ interface PacmanCleanResult extends AbstractPkgResult {
2206
+ /** Number of packages removed */
2207
+ packagesRemoved?: number;
2208
+ /** Amount of disk space freed */
2209
+ spaceFreed?: string;
2210
+ }
2211
+ interface PacmanIsInstalledParams extends PacmanBaseParams {
2212
+ /** Package name */
2213
+ package: string;
2214
+ }
2215
+ interface PacmanIsInstalledResult extends AbstractPkgResult {
2216
+ /** Whether the package is installed */
2217
+ installed: boolean;
2218
+ /** Package version if installed */
2219
+ version?: string;
2220
+ /** Package architecture if installed */
2221
+ architecture?: string;
2222
+ /** Package repository if installed */
2223
+ repository?: string;
2224
+ }
2225
+ interface PacmanInfoParams extends PacmanBaseParams {
2226
+ /** Package name */
2227
+ package: string;
2228
+ }
2229
+ interface PacmanInfoResult extends AbstractPkgResult {
2230
+ /** Whether the package is installed */
2231
+ installed: boolean;
2232
+ /** Package information */
2233
+ info?: {
2234
+ name: string;
2235
+ version?: string;
2236
+ architecture?: string;
2237
+ repository?: string;
2238
+ description?: string;
2239
+ depends?: string[];
2240
+ provides?: string[];
2241
+ conflicts?: string[];
2242
+ replaces?: string[];
2243
+ size?: string;
2244
+ license?: string;
2245
+ url?: string;
2246
+ };
2247
+ }
2248
+
2249
+ declare const _default$2w: TaskFn<PacmanInstallParams, PacmanInstallResult>;
2250
+
2251
+ declare const _default$2v: TaskFn<PacmanUninstallParams, PacmanUninstallResult>;
2252
+
2253
+ declare const _default$2u: TaskFn<PacmanUpdateParams, PacmanUpdateResult>;
2254
+
2255
+ declare const _default$2t: TaskFn<PacmanUpgradeParams, PacmanUpgradeResult>;
2256
+
2257
+ declare const _default$2s: TaskFn<PacmanSearchParams, PacmanSearchResult>;
2258
+
2259
+ declare const _default$2r: TaskFn<PacmanListParams, PacmanListResult>;
2260
+
2261
+ declare const _default$2q: TaskFn<PacmanCleanParams, PacmanCleanResult>;
2262
+
2263
+ declare const _default$2p: TaskFn<PacmanIsInstalledParams, PacmanIsInstalledResult>;
2264
+
2265
+ declare const _default$2o: TaskFn<PacmanInfoParams, PacmanInfoResult>;
2266
+
2267
+ type index_PacmanCleanParams = PacmanCleanParams;
2268
+ type index_PacmanCleanResult = PacmanCleanResult;
2269
+ type index_PacmanInfoParams = PacmanInfoParams;
2270
+ type index_PacmanInfoResult = PacmanInfoResult;
2271
+ type index_PacmanInstallParams = PacmanInstallParams;
2272
+ type index_PacmanInstallResult = PacmanInstallResult;
2273
+ type index_PacmanIsInstalledParams = PacmanIsInstalledParams;
2274
+ type index_PacmanIsInstalledResult = PacmanIsInstalledResult;
2275
+ type index_PacmanListParams = PacmanListParams;
2276
+ type index_PacmanListResult = PacmanListResult;
2277
+ type index_PacmanSearchParams = PacmanSearchParams;
2278
+ type index_PacmanSearchResult = PacmanSearchResult;
2279
+ type index_PacmanUninstallParams = PacmanUninstallParams;
2280
+ type index_PacmanUninstallResult = PacmanUninstallResult;
2281
+ type index_PacmanUpdateParams = PacmanUpdateParams;
2282
+ type index_PacmanUpdateResult = PacmanUpdateResult;
2283
+ type index_PacmanUpgradeParams = PacmanUpgradeParams;
2284
+ type index_PacmanUpgradeResult = PacmanUpgradeResult;
2285
+ declare namespace index {
2286
+ export { type index_PacmanCleanParams as PacmanCleanParams, type index_PacmanCleanResult as PacmanCleanResult, type index_PacmanInfoParams as PacmanInfoParams, type index_PacmanInfoResult as PacmanInfoResult, type index_PacmanInstallParams as PacmanInstallParams, type index_PacmanInstallResult as PacmanInstallResult, type index_PacmanIsInstalledParams as PacmanIsInstalledParams, type index_PacmanIsInstalledResult as PacmanIsInstalledResult, type index_PacmanListParams as PacmanListParams, type index_PacmanListResult as PacmanListResult, type index_PacmanSearchParams as PacmanSearchParams, type index_PacmanSearchResult as PacmanSearchResult, type index_PacmanUninstallParams as PacmanUninstallParams, type index_PacmanUninstallResult as PacmanUninstallResult, type index_PacmanUpdateParams as PacmanUpdateParams, type index_PacmanUpdateResult as PacmanUpdateResult, type index_PacmanUpgradeParams as PacmanUpgradeParams, type index_PacmanUpgradeResult as PacmanUpgradeResult, _default$2q as clean, _default$2o as info, _default$2w as install, _default$2p as isInstalled, _default$2r as list, _default$2s as search, _default$2v as uninstall, _default$2u as update, _default$2t as upgrade };
2287
+ }
2288
+
2289
+ type pkg_AbstractPkgCleanParams = AbstractPkgCleanParams;
1292
2290
  type pkg_AbstractPkgCleanResult = AbstractPkgCleanResult;
1293
2291
  type pkg_AbstractPkgInstallParams = AbstractPkgInstallParams;
1294
2292
  type pkg_AbstractPkgInstallResult = AbstractPkgInstallResult;
@@ -1315,7 +2313,7 @@ type pkg_PkgRemoveResult = PkgRemoveResult;
1315
2313
  type pkg_PkgUpdateParams = PkgUpdateParams;
1316
2314
  type pkg_PkgUpdateResult = PkgUpdateResult;
1317
2315
  declare namespace pkg {
1318
- export { type pkg_AbstractPkgCleanParams as AbstractPkgCleanParams, type pkg_AbstractPkgCleanResult as AbstractPkgCleanResult, type pkg_AbstractPkgInstallParams as AbstractPkgInstallParams, type pkg_AbstractPkgInstallResult as AbstractPkgInstallResult, type pkg_AbstractPkgListParams as AbstractPkgListParams, type pkg_AbstractPkgListResult as AbstractPkgListResult, type pkg_AbstractPkgParams as AbstractPkgParams, type pkg_AbstractPkgResult as AbstractPkgResult, type pkg_AbstractPkgSearchParams as AbstractPkgSearchParams, type pkg_AbstractPkgSearchResult as AbstractPkgSearchResult, type pkg_AbstractPkgUninstallParams as AbstractPkgUninstallParams, type pkg_AbstractPkgUninstallResult as AbstractPkgUninstallResult, type pkg_AbstractPkgUpdateParams as AbstractPkgUpdateParams, type pkg_AbstractPkgUpdateResult as AbstractPkgUpdateResult, type pkg_AbstractPkgUpgradeParams as AbstractPkgUpgradeParams, type pkg_AbstractPkgUpgradeResult as AbstractPkgUpgradeResult, type pkg_PkgInfoParams as PkgInfoParams, type pkg_PkgInfoResult as PkgInfoResult, type pkg_PkgInstallParams as PkgInstallParams, type pkg_PkgInstallResult as PkgInstallResult, type pkg_PkgIsInstalledParams as PkgIsInstalledParams, type pkg_PkgIsInstalledResult as PkgIsInstalledResult, type pkg_PkgRemoveParams as PkgRemoveParams, type pkg_PkgRemoveResult as PkgRemoveResult, type pkg_PkgUpdateParams as PkgUpdateParams, type pkg_PkgUpdateResult as PkgUpdateResult, _default$y as abstractClean, _default$A as abstractSearch, _default$D as abstractUninstall, _default$C as abstractUpdate, _default$B as abstractUpgrade, _default$G as info, _default$J as install, _default$E as installOrig, _default$F as isInstalled, _default$z as list, _default$I as remove, _default$H as update };
2316
+ export { type pkg_AbstractPkgCleanParams as AbstractPkgCleanParams, type pkg_AbstractPkgCleanResult as AbstractPkgCleanResult, type pkg_AbstractPkgInstallParams as AbstractPkgInstallParams, type pkg_AbstractPkgInstallResult as AbstractPkgInstallResult, type pkg_AbstractPkgListParams as AbstractPkgListParams, type pkg_AbstractPkgListResult as AbstractPkgListResult, type pkg_AbstractPkgParams as AbstractPkgParams, type pkg_AbstractPkgResult as AbstractPkgResult, type pkg_AbstractPkgSearchParams as AbstractPkgSearchParams, type pkg_AbstractPkgSearchResult as AbstractPkgSearchResult, type pkg_AbstractPkgUninstallParams as AbstractPkgUninstallParams, type pkg_AbstractPkgUninstallResult as AbstractPkgUninstallResult, type pkg_AbstractPkgUpdateParams as AbstractPkgUpdateParams, type pkg_AbstractPkgUpdateResult as AbstractPkgUpdateResult, type pkg_AbstractPkgUpgradeParams as AbstractPkgUpgradeParams, type pkg_AbstractPkgUpgradeResult as AbstractPkgUpgradeResult, type pkg_PkgInfoParams as PkgInfoParams, type pkg_PkgInfoResult as PkgInfoResult, type pkg_PkgInstallParams as PkgInstallParams, type pkg_PkgInstallResult as PkgInstallResult, type pkg_PkgIsInstalledParams as PkgIsInstalledParams, type pkg_PkgIsInstalledResult as PkgIsInstalledResult, type pkg_PkgRemoveParams as PkgRemoveParams, type pkg_PkgRemoveResult as PkgRemoveResult, type pkg_PkgUpdateParams as PkgUpdateParams, type pkg_PkgUpdateResult as PkgUpdateResult, index$3 as apt, _default$2_ as clean, index$2 as dnf, _default$35 as info, _default$38 as install, install as installCp, _default$34 as isInstalled, _default$2$ as list, index as pacman, _default$37 as remove, _default$33 as removeCp, _default$30 as search, _default$36 as update, _default$32 as updateCp, _default$31 as upgrade, index$1 as yum };
1319
2317
  }
1320
2318
 
1321
2319
  interface K3supInstallParams {
@@ -1353,12 +2351,54 @@ interface K3supInstallResult {
1353
2351
  /** The command that would be run if --print-command was used */
1354
2352
  executedCommand?: string;
1355
2353
  }
1356
- declare const _default$x: TaskFn<K3supInstallParams, K3supInstallResult>;
2354
+ declare const _default$2n: TaskFn<K3supInstallParams, K3supInstallResult>;
1357
2355
 
1358
2356
  type k3s_K3supInstallParams = K3supInstallParams;
1359
2357
  type k3s_K3supInstallResult = K3supInstallResult;
1360
2358
  declare namespace k3s {
1361
- export { type k3s_K3supInstallParams as K3supInstallParams, type k3s_K3supInstallResult as K3supInstallResult, _default$x as k3supInstall };
2359
+ export { type k3s_K3supInstallParams as K3supInstallParams, type k3s_K3supInstallResult as K3supInstallResult, _default$2n as k3supInstall };
2360
+ }
2361
+
2362
+ interface DockerInstallParams {
2363
+ users?: string[];
2364
+ install_compose_plugin?: boolean;
2365
+ install_compose_standalone?: boolean;
2366
+ compose_standalone_version?: string;
2367
+ compose_standalone_path?: string;
2368
+ }
2369
+ interface DockerInstallResult {
2370
+ success: boolean;
2371
+ error?: string;
2372
+ }
2373
+ declare const _default$2m: TaskFn<DockerInstallParams, DockerInstallResult>;
2374
+
2375
+ interface AddUsersParams {
2376
+ users: string[];
2377
+ }
2378
+ interface AddUsersResult {
2379
+ success: boolean;
2380
+ error?: string;
2381
+ }
2382
+ declare const _default$2l: TaskFn<AddUsersParams, AddUsersResult>;
2383
+
2384
+ interface InstallComposeParams {
2385
+ version?: string;
2386
+ path?: string;
2387
+ }
2388
+ interface InstallComposeResult {
2389
+ success: boolean;
2390
+ error?: string;
2391
+ }
2392
+ declare const _default$2k: TaskFn<InstallComposeParams, InstallComposeResult>;
2393
+
2394
+ type docker_AddUsersParams = AddUsersParams;
2395
+ type docker_AddUsersResult = AddUsersResult;
2396
+ type docker_DockerInstallParams = DockerInstallParams;
2397
+ type docker_DockerInstallResult = DockerInstallResult;
2398
+ type docker_InstallComposeParams = InstallComposeParams;
2399
+ type docker_InstallComposeResult = InstallComposeResult;
2400
+ declare namespace docker {
2401
+ export { type docker_AddUsersParams as AddUsersParams, type docker_AddUsersResult as AddUsersResult, type docker_DockerInstallParams as DockerInstallParams, type docker_DockerInstallResult as DockerInstallResult, type docker_InstallComposeParams as InstallComposeParams, type docker_InstallComposeResult as InstallComposeResult, _default$2l as addUsers, _default$2m as install, _default$2k as installCompose };
1362
2402
  }
1363
2403
 
1364
2404
  interface CopyIdParams {
@@ -1370,10 +2410,10 @@ interface CopyIdResult {
1370
2410
  success: boolean;
1371
2411
  changed: boolean;
1372
2412
  }
1373
- declare const _default$w: TaskFn<CopyIdParams, CopyIdResult>;
2413
+ declare const _default$2j: TaskFn<CopyIdParams, CopyIdResult>;
1374
2414
 
1375
2415
  declare namespace ssh {
1376
- export { _default$w as copy_id };
2416
+ export { _default$2j as copy_id };
1377
2417
  }
1378
2418
 
1379
2419
  interface SudoersCheckParams {
@@ -1381,8 +2421,9 @@ interface SudoersCheckParams {
1381
2421
  }
1382
2422
  interface SudoersCheckResult {
1383
2423
  success: boolean;
2424
+ error?: string;
1384
2425
  }
1385
- declare const _default$v: TaskFn<SudoersCheckParams, SudoersCheckResult>;
2426
+ declare const _default$2i: TaskFn<SudoersCheckParams, SudoersCheckResult>;
1386
2427
 
1387
2428
  interface GrantNopasswdParams {
1388
2429
  /** The username to grant passwordless sudo privileges. */
@@ -1397,11 +2438,383 @@ interface GrantNopasswdResult {
1397
2438
  changed: boolean;
1398
2439
  /** The path to the created sudoers file. */
1399
2440
  filePath: string;
2441
+ /** Error message if failed. */
2442
+ error?: string;
1400
2443
  }
1401
- declare const _default$u: TaskFn<GrantNopasswdParams, GrantNopasswdResult>;
2444
+ declare const _default$2h: TaskFn<GrantNopasswdParams, GrantNopasswdResult>;
1402
2445
 
1403
2446
  declare namespace sudoers {
1404
- export { _default$v as check, _default$u as grantNopasswd };
2447
+ export { _default$2i as check, _default$2h as grantNopasswd };
2448
+ }
2449
+
2450
+ interface ProcessListParams {
2451
+ user?: string;
2452
+ command?: string;
2453
+ limit?: number;
2454
+ sort?: 'cpu' | 'mem' | 'pid' | 'time';
2455
+ reverse?: boolean;
2456
+ }
2457
+ interface ProcessInfo$2 {
2458
+ pid: number;
2459
+ ppid: number;
2460
+ user: string;
2461
+ command: string;
2462
+ stat: string;
2463
+ start: string;
2464
+ time: string;
2465
+ cpu: number;
2466
+ mem: number;
2467
+ vsz: number;
2468
+ rss: number;
2469
+ tty: string;
2470
+ }
2471
+ interface ProcessListResult {
2472
+ success: boolean;
2473
+ processes?: ProcessInfo$2[];
2474
+ total?: number;
2475
+ error?: string;
2476
+ }
2477
+ declare const _default$2g: TaskFn<ProcessListParams, ProcessListResult>;
2478
+
2479
+ interface ProcessSearchParams {
2480
+ /** Search by process name/command (supports regex) */
2481
+ name?: string;
2482
+ /** Search by user running the process */
2483
+ user?: string;
2484
+ /** Search by process ID */
2485
+ pid?: number;
2486
+ /** Search by parent process ID */
2487
+ ppid?: number;
2488
+ /** Search by command line arguments */
2489
+ args?: string;
2490
+ /** Search by process state */
2491
+ state?: string;
2492
+ /** Use regex matching for name/args (default: false) */
2493
+ regex?: boolean;
2494
+ /** Case insensitive search (default: false) */
2495
+ ignoreCase?: boolean;
2496
+ /** Maximum number of results to return (default: unlimited) */
2497
+ limit?: number;
2498
+ }
2499
+ interface ProcessSearchResult {
2500
+ /** Array of matching processes */
2501
+ processes: ProcessInfo$1[];
2502
+ /** Total number of matches found */
2503
+ total: number;
2504
+ /** Whether the operation was successful */
2505
+ success: boolean;
2506
+ /** Error message if operation failed */
2507
+ error?: string;
2508
+ }
2509
+ interface ProcessInfo$1 {
2510
+ /** Process ID */
2511
+ pid: number;
2512
+ /** Parent Process ID */
2513
+ ppid: number;
2514
+ /** User running the process */
2515
+ user: string;
2516
+ /** CPU usage percentage */
2517
+ cpu: number;
2518
+ /** Memory usage percentage */
2519
+ mem: number;
2520
+ /** Virtual memory size in KB */
2521
+ vsz: number;
2522
+ /** Resident set size in KB */
2523
+ rss: number;
2524
+ /** Terminal associated with the process */
2525
+ tty: string;
2526
+ /** Process state */
2527
+ stat: string;
2528
+ /** Start time */
2529
+ start: string;
2530
+ /** Time the process has been running */
2531
+ time: string;
2532
+ /** Command name */
2533
+ command: string;
2534
+ /** Full command line */
2535
+ fullCommand: string;
2536
+ }
2537
+ declare const _default$2f: TaskFn<ProcessSearchParams, ProcessSearchResult>;
2538
+
2539
+ interface ProcessKillParams {
2540
+ pid?: number | number[];
2541
+ user?: string;
2542
+ command?: string;
2543
+ signal?: string;
2544
+ force?: boolean;
2545
+ sudo?: boolean;
2546
+ }
2547
+ interface ProcessKillResult {
2548
+ success: boolean;
2549
+ killed?: number;
2550
+ total?: number;
2551
+ error?: string;
2552
+ }
2553
+ declare const _default$2e: TaskFn<ProcessKillParams, ProcessKillResult>;
2554
+
2555
+ interface ProcessSignalParams {
2556
+ pid: number;
2557
+ signal?: string;
2558
+ sudo?: boolean;
2559
+ }
2560
+ interface ProcessSignalResult {
2561
+ success: boolean;
2562
+ error?: string;
2563
+ }
2564
+ declare const _default$2d: TaskFn<ProcessSignalParams, ProcessSignalResult>;
2565
+
2566
+ interface ProcessInfoParams {
2567
+ pid: number;
2568
+ }
2569
+ interface ProcessInfo {
2570
+ pid: number;
2571
+ ppid: number;
2572
+ user: string;
2573
+ command: string;
2574
+ stat: string;
2575
+ start: string;
2576
+ time: string;
2577
+ cpu: number;
2578
+ mem: number;
2579
+ vsz: number;
2580
+ rss: number;
2581
+ tty: string;
2582
+ cwd?: string;
2583
+ environ?: Record<string, string>;
2584
+ }
2585
+ interface ProcessInfoResult {
2586
+ success: boolean;
2587
+ process?: ProcessInfo;
2588
+ error?: string;
2589
+ }
2590
+ declare const _default$2c: TaskFn<ProcessInfoParams, ProcessInfoResult>;
2591
+
2592
+ interface ProcessTopParams {
2593
+ /** Number of processes to show (default: 10) */
2594
+ limit?: number;
2595
+ /** Sort by field (default: 'cpu') */
2596
+ sort?: 'cpu' | 'mem' | 'pid' | 'time' | 'command';
2597
+ /** Show processes for specific user (default: all users) */
2598
+ user?: string;
2599
+ /** Refresh interval in seconds (default: 1) */
2600
+ interval?: number;
2601
+ /** Number of iterations (default: 1) */
2602
+ iterations?: number;
2603
+ /** Include system load information (default: true) */
2604
+ includeLoad?: boolean;
2605
+ /** Include memory summary (default: true) */
2606
+ includeMemory?: boolean;
2607
+ }
2608
+ interface ProcessTopResult {
2609
+ /** System load information */
2610
+ load?: LoadInfo;
2611
+ /** Memory summary */
2612
+ memory?: MemorySummary;
2613
+ /** Top processes */
2614
+ processes: TopProcessInfo[];
2615
+ /** Total number of processes shown */
2616
+ total: number;
2617
+ /** Whether the operation was successful */
2618
+ success: boolean;
2619
+ /** Timestamp of the snapshot */
2620
+ timestamp: string;
2621
+ }
2622
+ interface LoadInfo {
2623
+ /** 1-minute load average */
2624
+ load1: number;
2625
+ /** 5-minute load average */
2626
+ load5: number;
2627
+ /** 15-minute load average */
2628
+ load15: number;
2629
+ /** Number of running processes */
2630
+ running: number;
2631
+ /** Total number of processes */
2632
+ total: number;
2633
+ /** Last PID */
2634
+ lastPid: number;
2635
+ }
2636
+ interface MemorySummary {
2637
+ /** Total physical memory in KB */
2638
+ total: number;
2639
+ /** Used memory in KB */
2640
+ used: number;
2641
+ /** Free memory in KB */
2642
+ free: number;
2643
+ /** Shared memory in KB */
2644
+ shared: number;
2645
+ /** Buffer memory in KB */
2646
+ buffers: number;
2647
+ /** Cache memory in KB */
2648
+ cached: number;
2649
+ /** Available memory in KB */
2650
+ available: number;
2651
+ }
2652
+ interface TopProcessInfo {
2653
+ /** Process ID */
2654
+ pid: number;
2655
+ /** User running the process */
2656
+ user: string;
2657
+ /** Priority */
2658
+ priority: number;
2659
+ /** Nice value */
2660
+ nice: number;
2661
+ /** Virtual memory size in KB */
2662
+ vsz: number;
2663
+ /** Resident set size in KB */
2664
+ rss: number;
2665
+ /** Process state */
2666
+ stat: string;
2667
+ /** CPU usage percentage */
2668
+ cpu: number;
2669
+ /** Memory usage percentage */
2670
+ mem: number;
2671
+ /** Time the process has been running */
2672
+ time: string;
2673
+ /** Command name */
2674
+ command: string;
2675
+ }
2676
+ declare const _default$2b: TaskFn<ProcessTopParams, ProcessTopResult>;
2677
+
2678
+ interface ProcessStatsParams {
2679
+ /** Include per-user statistics (default: true) */
2680
+ includeUsers?: boolean;
2681
+ /** Include per-state statistics (default: true) */
2682
+ includeStates?: boolean;
2683
+ /** Include per-command statistics (default: false) */
2684
+ includeCommands?: boolean;
2685
+ /** Limit number of top commands to show (default: 10) */
2686
+ commandLimit?: number;
2687
+ }
2688
+ interface ProcessStatsResult {
2689
+ /** Overall process statistics */
2690
+ overall: OverallStats;
2691
+ /** Per-user statistics */
2692
+ users?: UserStats[];
2693
+ /** Per-state statistics */
2694
+ states?: StateStats[];
2695
+ /** Per-command statistics */
2696
+ commands?: CommandStats[];
2697
+ /** Whether the operation was successful */
2698
+ success: boolean;
2699
+ /** Timestamp of the snapshot */
2700
+ timestamp: string;
2701
+ }
2702
+ interface OverallStats {
2703
+ /** Total number of processes */
2704
+ total: number;
2705
+ /** Number of running processes */
2706
+ running: number;
2707
+ /** Number of sleeping processes */
2708
+ sleeping: number;
2709
+ /** Number of stopped processes */
2710
+ stopped: number;
2711
+ /** Number of zombie processes */
2712
+ zombie: number;
2713
+ /** Number of uninterruptible processes */
2714
+ uninterruptible: number;
2715
+ /** Total CPU usage percentage */
2716
+ totalCpu: number;
2717
+ /** Total memory usage percentage */
2718
+ totalMem: number;
2719
+ /** Average CPU usage per process */
2720
+ avgCpu: number;
2721
+ /** Average memory usage per process */
2722
+ avgMem: number;
2723
+ }
2724
+ interface UserStats {
2725
+ /** Username */
2726
+ user: string;
2727
+ /** Number of processes */
2728
+ count: number;
2729
+ /** Total CPU usage percentage */
2730
+ cpu: number;
2731
+ /** Total memory usage percentage */
2732
+ mem: number;
2733
+ /** Total virtual memory in KB */
2734
+ vsz: number;
2735
+ /** Total resident memory in KB */
2736
+ rss: number;
2737
+ }
2738
+ interface StateStats {
2739
+ /** Process state */
2740
+ state: string;
2741
+ /** Number of processes in this state */
2742
+ count: number;
2743
+ /** Percentage of total processes */
2744
+ percentage: number;
2745
+ }
2746
+ interface CommandStats {
2747
+ /** Command name */
2748
+ command: string;
2749
+ /** Number of processes */
2750
+ count: number;
2751
+ /** Total CPU usage percentage */
2752
+ cpu: number;
2753
+ /** Total memory usage percentage */
2754
+ mem: number;
2755
+ /** Total virtual memory in KB */
2756
+ vsz: number;
2757
+ /** Total resident memory in KB */
2758
+ rss: number;
2759
+ }
2760
+ declare const _default$2a: TaskFn<ProcessStatsParams, ProcessStatsResult>;
2761
+
2762
+ interface ProcessChildrenParams {
2763
+ /** Parent process ID */
2764
+ pid: number;
2765
+ /** Include grandchildren (recursive) */
2766
+ recursive?: boolean;
2767
+ /** Maximum depth for recursive search (default: unlimited) */
2768
+ maxDepth?: number;
2769
+ }
2770
+ interface ProcessChildrenResult {
2771
+ /** Array of child process information */
2772
+ children: ChildProcessInfo[];
2773
+ /** Total number of children found */
2774
+ total: number;
2775
+ /** Whether the operation was successful */
2776
+ success: boolean;
2777
+ /** Error message if operation failed */
2778
+ error?: string;
2779
+ }
2780
+ interface ChildProcessInfo {
2781
+ /** Process ID */
2782
+ pid: number;
2783
+ /** Parent Process ID */
2784
+ ppid: number;
2785
+ /** User running the process */
2786
+ user: string;
2787
+ /** Command name */
2788
+ command: string;
2789
+ /** Process state */
2790
+ stat: string;
2791
+ /** Start time */
2792
+ start: string;
2793
+ /** Time the process has been running */
2794
+ time: string;
2795
+ /** Depth level (0 = direct child, 1 = grandchild, etc.) */
2796
+ depth: number;
2797
+ }
2798
+ declare const _default$29: TaskFn<ProcessChildrenParams, ProcessChildrenResult>;
2799
+
2800
+ type process_ProcessChildrenParams = ProcessChildrenParams;
2801
+ type process_ProcessChildrenResult = ProcessChildrenResult;
2802
+ type process_ProcessInfoParams = ProcessInfoParams;
2803
+ type process_ProcessInfoResult = ProcessInfoResult;
2804
+ type process_ProcessKillParams = ProcessKillParams;
2805
+ type process_ProcessKillResult = ProcessKillResult;
2806
+ type process_ProcessListParams = ProcessListParams;
2807
+ type process_ProcessListResult = ProcessListResult;
2808
+ type process_ProcessSearchParams = ProcessSearchParams;
2809
+ type process_ProcessSearchResult = ProcessSearchResult;
2810
+ type process_ProcessSignalParams = ProcessSignalParams;
2811
+ type process_ProcessSignalResult = ProcessSignalResult;
2812
+ type process_ProcessStatsParams = ProcessStatsParams;
2813
+ type process_ProcessStatsResult = ProcessStatsResult;
2814
+ type process_ProcessTopParams = ProcessTopParams;
2815
+ type process_ProcessTopResult = ProcessTopResult;
2816
+ declare namespace process {
2817
+ export { type process_ProcessChildrenParams as ProcessChildrenParams, type process_ProcessChildrenResult as ProcessChildrenResult, type process_ProcessInfoParams as ProcessInfoParams, type process_ProcessInfoResult as ProcessInfoResult, type process_ProcessKillParams as ProcessKillParams, type process_ProcessKillResult as ProcessKillResult, type process_ProcessListParams as ProcessListParams, type process_ProcessListResult as ProcessListResult, type process_ProcessSearchParams as ProcessSearchParams, type process_ProcessSearchResult as ProcessSearchResult, type process_ProcessSignalParams as ProcessSignalParams, type process_ProcessSignalResult as ProcessSignalResult, type process_ProcessStatsParams as ProcessStatsParams, type process_ProcessStatsResult as ProcessStatsResult, type process_ProcessTopParams as ProcessTopParams, type process_ProcessTopResult as ProcessTopResult, _default$29 as children, _default$2c as info, _default$2e as kill, _default$2g as list, _default$2f as search, _default$2d as signal, _default$2a as stats, _default$2b as top };
1405
2818
  }
1406
2819
 
1407
2820
  interface RebootParams {
@@ -1424,7 +2837,7 @@ interface RebootResult {
1424
2837
  error?: string;
1425
2838
  status: string;
1426
2839
  }
1427
- declare const _default$t: TaskFn<RebootParams, RebootResult>;
2840
+ declare const _default$28: TaskFn<RebootParams, RebootResult>;
1428
2841
 
1429
2842
  interface ShutdownParams {
1430
2843
  /**
@@ -1446,7 +2859,7 @@ interface ShutdownResult {
1446
2859
  error?: string;
1447
2860
  status: string;
1448
2861
  }
1449
- declare const _default$s: TaskFn<ShutdownParams, ShutdownResult>;
2862
+ declare const _default$27: TaskFn<ShutdownParams, ShutdownResult>;
1450
2863
 
1451
2864
  interface RebootNeededParams {
1452
2865
  }
@@ -1455,7 +2868,7 @@ interface RebootNeededResult {
1455
2868
  success: boolean;
1456
2869
  error?: string;
1457
2870
  }
1458
- declare const _default$r: TaskFn<RebootNeededParams, RebootNeededResult>;
2871
+ declare const _default$26: TaskFn<RebootNeededParams, RebootNeededResult>;
1459
2872
 
1460
2873
  interface RebootIfNeededParams {
1461
2874
  delay?: number;
@@ -1466,7 +2879,7 @@ interface RebootIfNeededResult {
1466
2879
  success: boolean;
1467
2880
  error?: string;
1468
2881
  }
1469
- declare const _default$q: TaskFn<RebootIfNeededParams, RebootIfNeededResult>;
2882
+ declare const _default$25: TaskFn<RebootIfNeededParams, RebootIfNeededResult>;
1470
2883
 
1471
2884
  type system_RebootIfNeededParams = RebootIfNeededParams;
1472
2885
  type system_RebootIfNeededResult = RebootIfNeededResult;
@@ -1477,7 +2890,7 @@ type system_RebootResult = RebootResult;
1477
2890
  type system_ShutdownParams = ShutdownParams;
1478
2891
  type system_ShutdownResult = ShutdownResult;
1479
2892
  declare namespace system {
1480
- export { type system_RebootIfNeededParams as RebootIfNeededParams, type system_RebootIfNeededResult as RebootIfNeededResult, type system_RebootNeededParams as RebootNeededParams, type system_RebootNeededResult as RebootNeededResult, type system_RebootParams as RebootParams, type system_RebootResult as RebootResult, type system_ShutdownParams as ShutdownParams, type system_ShutdownResult as ShutdownResult, _default$t as reboot, _default$q as rebootIfNeeded, _default$r as rebootNeeded, _default$s as shutdown };
2893
+ export { type system_RebootIfNeededParams as RebootIfNeededParams, type system_RebootIfNeededResult as RebootIfNeededResult, type system_RebootNeededParams as RebootNeededParams, type system_RebootNeededResult as RebootNeededResult, type system_RebootParams as RebootParams, type system_RebootResult as RebootResult, type system_ShutdownParams as ShutdownParams, type system_ShutdownResult as ShutdownResult, _default$28 as reboot, _default$25 as rebootIfNeeded, _default$26 as rebootNeeded, _default$27 as shutdown };
1481
2894
  }
1482
2895
 
1483
2896
  interface DisableServiceParams {
@@ -1486,8 +2899,9 @@ interface DisableServiceParams {
1486
2899
  }
1487
2900
  interface DisableServiceResult {
1488
2901
  success: boolean;
2902
+ error?: string;
1489
2903
  }
1490
- declare const _default$p: TaskFn<DisableServiceParams, DisableServiceResult>;
2904
+ declare const _default$24: TaskFn<DisableServiceParams, DisableServiceResult>;
1491
2905
 
1492
2906
  interface SystemdEnableParams {
1493
2907
  service: string;
@@ -1495,8 +2909,9 @@ interface SystemdEnableParams {
1495
2909
  }
1496
2910
  interface SystemdEnableResult {
1497
2911
  success: boolean;
2912
+ error?: string;
1498
2913
  }
1499
- declare const _default$o: TaskFn<SystemdEnableParams, SystemdEnableResult>;
2914
+ declare const _default$23: TaskFn<SystemdEnableParams, SystemdEnableResult>;
1500
2915
 
1501
2916
  interface SystemdRestartParams {
1502
2917
  service: string;
@@ -1504,8 +2919,9 @@ interface SystemdRestartParams {
1504
2919
  }
1505
2920
  interface SystemdRestartResult {
1506
2921
  success: boolean;
2922
+ error?: string;
1507
2923
  }
1508
- declare const _default$n: TaskFn<SystemdRestartParams, SystemdRestartResult>;
2924
+ declare const _default$22: TaskFn<SystemdRestartParams, SystemdRestartResult>;
1509
2925
 
1510
2926
  interface SystemdStartParams {
1511
2927
  service: string;
@@ -1513,8 +2929,9 @@ interface SystemdStartParams {
1513
2929
  }
1514
2930
  interface SystemdStartResult {
1515
2931
  success: boolean;
2932
+ error?: string;
1516
2933
  }
1517
- declare const _default$m: TaskFn<SystemdStartParams, SystemdStartResult>;
2934
+ declare const _default$21: TaskFn<SystemdStartParams, SystemdStartResult>;
1518
2935
 
1519
2936
  interface SystemdStopParams {
1520
2937
  service: string;
@@ -1522,8 +2939,9 @@ interface SystemdStopParams {
1522
2939
  }
1523
2940
  interface SystemdStopResult {
1524
2941
  success: boolean;
2942
+ error?: string;
1525
2943
  }
1526
- declare const _default$l: TaskFn<SystemdStopParams, SystemdStopResult>;
2944
+ declare const _default$20: TaskFn<SystemdStopParams, SystemdStopResult>;
1527
2945
 
1528
2946
  interface SystemdReloadParams {
1529
2947
  service: string;
@@ -1531,20 +2949,23 @@ interface SystemdReloadParams {
1531
2949
  }
1532
2950
  interface SystemdReloadResult {
1533
2951
  success: boolean;
2952
+ error?: string;
1534
2953
  }
1535
- declare const _default$k: TaskFn<SystemdReloadParams, SystemdReloadResult>;
2954
+ declare const _default$1$: TaskFn<SystemdReloadParams, SystemdReloadResult>;
1536
2955
 
1537
2956
  interface SystemdStatusParams {
1538
2957
  service: string;
1539
2958
  sudo?: boolean;
1540
2959
  }
1541
2960
  interface SystemdStatusResult {
2961
+ success: boolean;
1542
2962
  active: boolean;
2963
+ error?: string;
1543
2964
  }
1544
- declare const _default$j: TaskFn<SystemdStatusParams, SystemdStatusResult>;
2965
+ declare const _default$1_: TaskFn<SystemdStatusParams, SystemdStatusResult>;
1545
2966
 
1546
2967
  declare namespace systemd {
1547
- export { _default$p as disable, _default$o as enable, _default$k as reload, _default$n as restart, _default$m as start, _default$j as status, _default$l as stop };
2968
+ export { _default$24 as disable, _default$23 as enable, _default$1$ as reload, _default$22 as restart, _default$21 as start, _default$1_ as status, _default$20 as stop };
1548
2969
  }
1549
2970
 
1550
2971
  interface TemplateWriteParams {
@@ -1561,63 +2982,122 @@ interface TemplateWriteResult {
1561
2982
  success: boolean;
1562
2983
  path: string;
1563
2984
  }
1564
- declare const _default$i: TaskFn<TemplateWriteParams, TemplateWriteResult>;
2985
+ declare const _default$1Z: TaskFn<TemplateWriteParams, TemplateWriteResult>;
1565
2986
 
1566
2987
  declare namespace template {
1567
- export { _default$i as write };
2988
+ export { _default$1Z as write };
2989
+ }
2990
+
2991
+ interface UfwAllowParams {
2992
+ port: string | number;
2993
+ proto?: 'tcp' | 'udp';
2994
+ from?: string;
2995
+ }
2996
+ interface UfwAllowResult {
2997
+ success: boolean;
2998
+ error?: string;
1568
2999
  }
3000
+ declare const _default$1Y: TaskFn<UfwAllowParams, UfwAllowResult>;
1569
3001
 
1570
3002
  interface UfwDenyParams {
1571
- from_addr?: string;
1572
- from_port?: number;
1573
- to_addr?: string;
1574
- to_port?: number;
3003
+ port?: string | number;
3004
+ proto?: 'tcp' | 'udp';
3005
+ from?: string;
1575
3006
  }
1576
3007
  interface UfwDenyResult {
1577
3008
  success: boolean;
3009
+ error?: string;
3010
+ }
3011
+ declare const _default$1X: TaskFn<UfwDenyParams, UfwDenyResult>;
3012
+
3013
+ interface UfwDeleteParams {
3014
+ rule_number: number;
3015
+ }
3016
+ interface UfwDeleteResult {
3017
+ success: boolean;
3018
+ error?: string;
1578
3019
  }
1579
- declare const _default$h: TaskFn<UfwDenyParams, UfwDenyResult>;
3020
+ declare const _default$1W: TaskFn<UfwDeleteParams, UfwDeleteResult>;
1580
3021
 
1581
3022
  interface UfwDisableParams {
1582
3023
  }
1583
3024
  interface UfwDisableResult {
1584
3025
  success: boolean;
3026
+ error?: string;
1585
3027
  }
1586
- declare const _default$g: TaskFn<UfwDisableParams, UfwDisableResult>;
3028
+ declare const _default$1V: TaskFn<UfwDisableParams, UfwDisableResult>;
1587
3029
 
1588
3030
  interface UfwEnableParams {
1589
3031
  }
1590
3032
  interface UfwEnableResult {
1591
3033
  success: boolean;
3034
+ error?: string;
1592
3035
  }
1593
- declare const _default$f: TaskFn<UfwEnableParams, UfwEnableResult>;
3036
+ declare const _default$1U: TaskFn<UfwEnableParams, UfwEnableResult>;
1594
3037
 
1595
3038
  interface UfwInstallParams {
1596
3039
  }
1597
3040
  interface UfwInstallResult {
1598
3041
  success: boolean;
3042
+ error?: string;
3043
+ }
3044
+ declare const _default$1T: TaskFn<UfwInstallParams, UfwInstallResult>;
3045
+
3046
+ interface UfwLoggingParams {
3047
+ level: 'on' | 'off' | 'low' | 'medium' | 'high' | 'full';
3048
+ }
3049
+ interface UfwLoggingResult {
3050
+ success: boolean;
3051
+ error?: string;
1599
3052
  }
1600
- declare const _default$e: TaskFn<UfwInstallParams, UfwInstallResult>;
3053
+ declare const _default$1S: TaskFn<UfwLoggingParams, UfwLoggingResult>;
1601
3054
 
1602
3055
  interface UfwReloadParams {
1603
3056
  }
1604
3057
  interface UfwReloadResult {
1605
3058
  success: boolean;
3059
+ error?: string;
3060
+ }
3061
+ declare const _default$1R: TaskFn<UfwReloadParams, UfwReloadResult>;
3062
+
3063
+ interface UfwResetParams {
3064
+ }
3065
+ interface UfwResetResult {
3066
+ success: boolean;
3067
+ error?: string;
3068
+ }
3069
+ declare const _default$1Q: TaskFn<UfwResetParams, UfwResetResult>;
3070
+
3071
+ interface UfwStatusParams {
3072
+ }
3073
+ interface UfwRule {
3074
+ number: number;
3075
+ to: string;
3076
+ action: string;
3077
+ from: string;
3078
+ protocol?: string;
3079
+ port?: string;
3080
+ }
3081
+ interface UfwStatusResult {
3082
+ success: boolean;
3083
+ status?: string;
3084
+ rules?: UfwRule[];
3085
+ error?: string;
1606
3086
  }
1607
- declare const _default$d: TaskFn<UfwReloadParams, UfwReloadResult>;
3087
+ declare const _default$1P: TaskFn<UfwStatusParams, UfwStatusResult>;
1608
3088
 
1609
3089
  declare namespace ufw {
1610
- export { _default$h as deny, _default$g as disable, _default$f as enable, _default$e as install, _default$d as reload };
3090
+ export { _default$1Y as allow, _default$1W as delete, _default$1X as deny, _default$1V as disable, _default$1U as enable, _default$1T as install, _default$1S as logging, _default$1R as reload, _default$1Q as reset, _default$1P as status };
1611
3091
  }
1612
3092
 
1613
3093
  interface AddGroupsParams {
1614
3094
  user: string;
1615
- groups: string[];
3095
+ groups?: string | string[];
1616
3096
  }
1617
3097
  interface AddGroupsResult {
1618
3098
  success: boolean;
1619
3099
  }
1620
- declare const _default$c: TaskFn<AddGroupsParams, AddGroupsResult>;
3100
+ declare const _default$1O: TaskFn<AddGroupsParams, AddGroupsResult>;
1621
3101
 
1622
3102
  interface CreateUserParams {
1623
3103
  user: string;
@@ -1628,8 +3108,9 @@ interface CreateUserParams {
1628
3108
  }
1629
3109
  interface CreateUserResult {
1630
3110
  success: boolean;
3111
+ error?: string;
1631
3112
  }
1632
- declare const _default$b: TaskFn<CreateUserParams, CreateUserResult>;
3113
+ declare const _default$1N: TaskFn<CreateUserParams, CreateUserResult>;
1633
3114
 
1634
3115
  interface UserExistsParams {
1635
3116
  user: string;
@@ -1637,7 +3118,7 @@ interface UserExistsParams {
1637
3118
  interface UserExistsResult {
1638
3119
  exists: boolean;
1639
3120
  }
1640
- declare const _default$a: TaskFn<UserExistsParams, UserExistsResult>;
3121
+ declare const _default$1M: TaskFn<UserExistsParams, UserExistsResult>;
1641
3122
 
1642
3123
  interface GetGidParams {
1643
3124
  user: string;
@@ -1646,7 +3127,7 @@ interface GetGidResult {
1646
3127
  success: boolean;
1647
3128
  gid: string;
1648
3129
  }
1649
- declare const _default$9: TaskFn<GetGidParams, GetGidResult>;
3130
+ declare const _default$1L: TaskFn<GetGidParams, GetGidResult>;
1650
3131
 
1651
3132
  interface GetGroupsParams {
1652
3133
  user: string;
@@ -1655,7 +3136,7 @@ interface GetGroupsResult {
1655
3136
  success: boolean;
1656
3137
  groups: string[];
1657
3138
  }
1658
- declare const _default$8: TaskFn<GetGroupsParams, GetGroupsResult>;
3139
+ declare const _default$1K: TaskFn<GetGroupsParams, GetGroupsResult>;
1659
3140
 
1660
3141
  interface GetUidParams {
1661
3142
  user: string;
@@ -1664,13 +3145,13 @@ interface GetUidResult {
1664
3145
  success: boolean;
1665
3146
  uid: string;
1666
3147
  }
1667
- declare const _default$7: TaskFn<GetUidParams, GetUidResult>;
3148
+ declare const _default$1J: TaskFn<GetUidParams, GetUidResult>;
1668
3149
 
1669
3150
  interface GetUsernameResult {
1670
3151
  success: boolean;
1671
3152
  username: string;
1672
3153
  }
1673
- declare const _default$6: TaskFn<{}, GetUsernameResult>;
3154
+ declare const _default$1I: TaskFn<{}, GetUsernameResult>;
1674
3155
 
1675
3156
  interface UserHomeDirParams {
1676
3157
  user: string;
@@ -1679,16 +3160,16 @@ interface UserHomeDirResult {
1679
3160
  path: string;
1680
3161
  exists: boolean;
1681
3162
  }
1682
- declare const _default$5: TaskFn<UserHomeDirParams, UserHomeDirResult>;
3163
+ declare const _default$1H: TaskFn<UserHomeDirParams, UserHomeDirResult>;
1683
3164
 
1684
3165
  interface SetUserGroupsParams {
1685
3166
  user: string;
1686
- groups: string[];
3167
+ groups?: string | string[];
1687
3168
  }
1688
3169
  interface SetUserGroupsResult {
1689
3170
  success: boolean;
1690
3171
  }
1691
- declare const _default$4: TaskFn<SetUserGroupsParams, SetUserGroupsResult>;
3172
+ declare const _default$1G: TaskFn<SetUserGroupsParams, SetUserGroupsResult>;
1692
3173
 
1693
3174
  interface SetUserShellParams {
1694
3175
  user: string;
@@ -1697,7 +3178,7 @@ interface SetUserShellParams {
1697
3178
  interface SetUserShellResult {
1698
3179
  success: boolean;
1699
3180
  }
1700
- declare const _default$3: TaskFn<SetUserShellParams, SetUserShellResult>;
3181
+ declare const _default$1F: TaskFn<SetUserShellParams, SetUserShellResult>;
1701
3182
 
1702
3183
  interface UserDeleteParams {
1703
3184
  user: string;
@@ -1710,7 +3191,7 @@ interface UserDeleteResult {
1710
3191
  success: boolean;
1711
3192
  error?: string;
1712
3193
  }
1713
- declare const _default$2: TaskFn<UserDeleteParams, UserDeleteResult>;
3194
+ declare const _default$1E: TaskFn<UserDeleteParams, UserDeleteResult>;
1714
3195
 
1715
3196
  interface ModifyUserParams {
1716
3197
  user: string;
@@ -1729,8 +3210,9 @@ interface ModifyUserParams {
1729
3210
  }
1730
3211
  interface ModifyUserResult {
1731
3212
  success: boolean;
3213
+ error?: string;
1732
3214
  }
1733
- declare const _default$1: TaskFn<ModifyUserParams, ModifyUserResult>;
3215
+ declare const _default$1D: TaskFn<ModifyUserParams, ModifyUserResult>;
1734
3216
 
1735
3217
  type user_AddGroupsParams = AddGroupsParams;
1736
3218
  type user_AddGroupsResult = AddGroupsResult;
@@ -1754,26 +3236,2284 @@ type user_UserExistsResult = UserExistsResult;
1754
3236
  type user_UserHomeDirParams = UserHomeDirParams;
1755
3237
  type user_UserHomeDirResult = UserHomeDirResult;
1756
3238
  declare namespace user {
1757
- export { type user_AddGroupsParams as AddGroupsParams, type user_AddGroupsResult as AddGroupsResult, type user_CreateUserParams as CreateUserParams, type user_CreateUserResult as CreateUserResult, type user_GetGidParams as GetGidParams, type user_GetGidResult as GetGidResult, type user_GetGroupsParams as GetGroupsParams, type user_GetGroupsResult as GetGroupsResult, type user_GetUidParams as GetUidParams, type user_GetUidResult as GetUidResult, type user_GetUsernameResult as GetUsernameResult, type user_SetUserGroupsParams as SetUserGroupsParams, type user_SetUserGroupsResult as SetUserGroupsResult, type user_SetUserShellParams as SetUserShellParams, type user_SetUserShellResult as SetUserShellResult, type user_UserDeleteParams as UserDeleteParams, type user_UserDeleteResult as UserDeleteResult, type user_UserExistsParams as UserExistsParams, type user_UserExistsResult as UserExistsResult, type user_UserHomeDirParams as UserHomeDirParams, type user_UserHomeDirResult as UserHomeDirResult, _default$c as addGroups, _default$b as create, _default$2 as delete, _default$a as exists, _default$9 as getGid, _default$8 as getGroups, _default$7 as getUid, _default$6 as getUsername, _default$5 as homeDir, _default$1 as modify, _default$4 as setGroups, _default$3 as setShell };
3239
+ export { type user_AddGroupsParams as AddGroupsParams, type user_AddGroupsResult as AddGroupsResult, type user_CreateUserParams as CreateUserParams, type user_CreateUserResult as CreateUserResult, type user_GetGidParams as GetGidParams, type user_GetGidResult as GetGidResult, type user_GetGroupsParams as GetGroupsParams, type user_GetGroupsResult as GetGroupsResult, type user_GetUidParams as GetUidParams, type user_GetUidResult as GetUidResult, type user_GetUsernameResult as GetUsernameResult, type user_SetUserGroupsParams as SetUserGroupsParams, type user_SetUserGroupsResult as SetUserGroupsResult, type user_SetUserShellParams as SetUserShellParams, type user_SetUserShellResult as SetUserShellResult, type user_UserDeleteParams as UserDeleteParams, type user_UserDeleteResult as UserDeleteResult, type user_UserExistsParams as UserExistsParams, type user_UserExistsResult as UserExistsResult, type user_UserHomeDirParams as UserHomeDirParams, type user_UserHomeDirResult as UserHomeDirResult, _default$1O as addGroups, _default$1N as create, _default$1E as delete, _default$1M as exists, _default$1L as getGid, _default$1K as getGroups, _default$1J as getUid, _default$1I as getUsername, _default$1H as homeDir, _default$1D as modify, _default$1G as setGroups, _default$1F as setShell };
1758
3240
  }
1759
3241
 
1760
- declare const _default: {
1761
- echo: TaskFn<EchoParams, EchoResult>;
1762
- whoami: TaskFn<WhoamiParams, WhoamiResult>;
1763
- dir: typeof dir;
1764
- file: typeof file;
1765
- git: typeof git;
1766
- group: typeof group;
1767
- host: typeof host;
1768
- pkg: typeof pkg;
1769
- k3s: typeof k3s;
1770
- ssh: typeof ssh;
1771
- sudoers: typeof sudoers;
1772
- system: typeof system;
1773
- systemd: typeof systemd;
1774
- template: typeof template;
1775
- ufw: typeof ufw;
1776
- user: typeof user;
3242
+ interface XcpngListAttachedDisksParams {
3243
+ vm_uuid: string;
3244
+ include_readonly?: boolean;
3245
+ }
3246
+ interface XcpngAttachedDisk {
3247
+ vbdUuid: string;
3248
+ device?: string;
3249
+ mode?: string;
3250
+ type?: string;
3251
+ currentlyAttached?: boolean;
3252
+ vdiUuid?: string;
3253
+ vdiNameLabel?: string;
3254
+ vdiType?: string;
3255
+ srUuid?: string;
3256
+ }
3257
+ interface XcpngListAttachedDisksResult {
3258
+ success: boolean;
3259
+ vmUuid?: string;
3260
+ disks?: XcpngAttachedDisk[];
3261
+ error?: string;
3262
+ }
3263
+ declare const _default$1C: TaskFn<XcpngListAttachedDisksParams, XcpngListAttachedDisksResult>;
3264
+
3265
+ /**
3266
+ * Supported input for filter-style arguments. Allows callers to pass:
3267
+ * - an object map (`{ uuid: '...', name: 'foo' }`)
3268
+ * - a single string (`"uuid=..."`)
3269
+ * - an array of strings (`["uuid=...", "name=foo"]`)
3270
+ */
3271
+ type XeFilterInput = Record<string, string | number | boolean | undefined | null> | string | string[] | undefined | null;
3272
+
3273
+ interface XcpngListVbdsParams {
3274
+ filters?: XeFilterInput;
3275
+ }
3276
+ type XcpngVbdRecord = Record<string, string> & {
3277
+ params: Record<string, string>;
1777
3278
  };
3279
+ interface XcpngListVbdsResult {
3280
+ success: boolean;
3281
+ items?: XcpngVbdRecord[];
3282
+ error?: string;
3283
+ }
3284
+ declare const _default$1B: TaskFn<XcpngListVbdsParams, XcpngListVbdsResult>;
3285
+
3286
+ interface XcpngListVifsParams {
3287
+ filters?: XeFilterInput;
3288
+ }
3289
+ type XcpngVifRecord = Record<string, string> & {
3290
+ params: Record<string, string>;
3291
+ };
3292
+ interface XcpngListVifsResult {
3293
+ success: boolean;
3294
+ items?: XcpngVifRecord[];
3295
+ error?: string;
3296
+ }
3297
+ declare const _default$1A: TaskFn<XcpngListVifsParams, XcpngListVifsResult>;
3298
+
3299
+ interface XcpngGetVmInfoParams {
3300
+ vm_uuid?: string;
3301
+ vm_name_label?: string;
3302
+ allow_missing?: boolean;
3303
+ include_vbds?: boolean;
3304
+ include_vifs?: boolean;
3305
+ }
3306
+ interface XcpngVmInfo {
3307
+ uuid: string;
3308
+ nameLabel?: string;
3309
+ powerState?: string;
3310
+ params?: Record<string, string>;
3311
+ memory?: {
3312
+ staticMax?: number;
3313
+ staticMin?: number;
3314
+ dynamicMax?: number;
3315
+ dynamicMin?: number;
3316
+ };
3317
+ vcpus?: {
3318
+ max?: number;
3319
+ atStartup?: number;
3320
+ };
3321
+ hvmBootPolicy?: string;
3322
+ hvmBootParams?: {
3323
+ raw: string | undefined;
3324
+ values: Record<string, string>;
3325
+ };
3326
+ platform?: {
3327
+ raw: string | undefined;
3328
+ values: Record<string, string>;
3329
+ };
3330
+ otherConfig?: string;
3331
+ residentOn?: string;
3332
+ }
3333
+ interface XcpngGetVmInfoResult {
3334
+ success: boolean;
3335
+ vmUuid?: string;
3336
+ vm?: XcpngVmInfo;
3337
+ vbds?: XcpngVbdRecord[];
3338
+ vifs?: XcpngVifRecord[];
3339
+ error?: string;
3340
+ skipped?: boolean;
3341
+ }
3342
+ declare const _default$1z: TaskFn<XcpngGetVmInfoParams, XcpngGetVmInfoResult>;
3343
+
3344
+ /**
3345
+ * Parameters for powering off an XCP-ng VM.
3346
+ * - `vm_uuid`: Target VM identifier.
3347
+ * - `force`: When `true`, invokes `xe vm-shutdown --force` (immediate power-off). Defaults to graceful shutdown.
3348
+ * - `timeout_seconds`: Optional grace period for `vm-shutdown`. When set, `xe` receives `--timeout=<seconds>`.
3349
+ */
3350
+ interface XcpngStopVmParams {
3351
+ vm_uuid: string;
3352
+ force?: boolean;
3353
+ timeout_seconds?: number;
3354
+ }
3355
+ /**
3356
+ * Result containing the executed command details.
3357
+ * - `command`: Final CLI invocation executed through `xe`.
3358
+ * - `error`: Raw stderr output when the stop workflow fails.
3359
+ */
3360
+ interface XcpngStopVmResult {
3361
+ success: boolean;
3362
+ command?: string;
3363
+ error?: string;
3364
+ alreadyHalted?: boolean;
3365
+ initialPowerState?: string;
3366
+ finalPowerState?: string;
3367
+ waitAttempts?: number;
3368
+ }
3369
+ declare const _default$1y: TaskFn<XcpngStopVmParams, XcpngStopVmResult>;
3370
+
3371
+ /**
3372
+ * Parameters for powering on an XCP-ng VM.
3373
+ * - `vm_uuid`: Target VM identifier.
3374
+ * - `start_paused`: When `true`, boots the VM in a paused state (`xe vm-start --paused`).
3375
+ * - `force`: When `true`, skips safety checks (maps to `xe vm-start --force`).
3376
+ */
3377
+ interface XcpngStartVmParams {
3378
+ vm_uuid: string;
3379
+ start_paused?: boolean;
3380
+ force?: boolean;
3381
+ }
3382
+ /**
3383
+ * Result containing the executed command details.
3384
+ * - `command`: Final CLI invocation executed through `xe`.
3385
+ * - `error`: Raw stderr output when the start workflow fails.
3386
+ */
3387
+ interface XcpngStartVmResult {
3388
+ success: boolean;
3389
+ command?: string;
3390
+ error?: string;
3391
+ alreadyRunning?: boolean;
3392
+ initialPowerState?: string;
3393
+ finalPowerState?: string;
3394
+ waitAttempts?: number;
3395
+ }
3396
+ declare const _default$1x: TaskFn<XcpngStartVmParams, XcpngStartVmResult>;
3397
+
3398
+ interface XcpngSnapshotVmParams {
3399
+ vm_uuid?: string;
3400
+ vm_name_label?: string;
3401
+ snapshot_name_label: string;
3402
+ description?: string;
3403
+ quiesce?: boolean;
3404
+ }
3405
+ interface XcpngSnapshotVmResult {
3406
+ success: boolean;
3407
+ vmUuid?: string;
3408
+ snapshotUuid?: string;
3409
+ command?: string;
3410
+ error?: string;
3411
+ }
3412
+ declare const _default$1w: TaskFn<XcpngSnapshotVmParams, XcpngSnapshotVmResult>;
3413
+
3414
+ interface XcpngUnplugVbdParams {
3415
+ vbd_uuid: string;
3416
+ allow_missing?: boolean;
3417
+ }
3418
+ interface XcpngUnplugVbdResult {
3419
+ success: boolean;
3420
+ command?: string;
3421
+ alreadyDetached?: boolean;
3422
+ error?: string;
3423
+ }
3424
+ declare const _default$1v: TaskFn<XcpngUnplugVbdParams, XcpngUnplugVbdResult>;
3425
+
3426
+ interface XcpngResumeVmParams {
3427
+ vm_uuid: string;
3428
+ start_paused?: boolean;
3429
+ host_uuid?: string;
3430
+ }
3431
+ interface XcpngResumeVmResult {
3432
+ success: boolean;
3433
+ command?: string;
3434
+ alreadyRunning?: boolean;
3435
+ initialPowerState?: string;
3436
+ finalPowerState?: string;
3437
+ waitAttempts?: number;
3438
+ error?: string;
3439
+ }
3440
+ declare const _default$1u: TaskFn<XcpngResumeVmParams, XcpngResumeVmResult>;
3441
+
3442
+ interface XcpngSuspendVmParams {
3443
+ vm_uuid: string;
3444
+ allow_running?: boolean;
3445
+ }
3446
+ interface XcpngSuspendVmResult {
3447
+ success: boolean;
3448
+ command?: string;
3449
+ alreadySuspended?: boolean;
3450
+ initialPowerState?: string;
3451
+ finalPowerState?: string;
3452
+ waitAttempts?: number;
3453
+ error?: string;
3454
+ }
3455
+ declare const _default$1t: TaskFn<XcpngSuspendVmParams, XcpngSuspendVmResult>;
3456
+
3457
+ interface XcpngSetVmResourcesParams {
3458
+ vm_uuid?: string;
3459
+ vm_name_label?: string;
3460
+ memory_mib?: number;
3461
+ memory_static_min_mib?: number;
3462
+ memory_static_max_mib?: number;
3463
+ memory_dynamic_min_mib?: number;
3464
+ memory_dynamic_max_mib?: number;
3465
+ vcpus?: number;
3466
+ vcpus_max?: number;
3467
+ vcpus_at_startup?: number;
3468
+ }
3469
+ interface XcpngSetVmResourcesResult {
3470
+ success: boolean;
3471
+ vmUuid?: string;
3472
+ appliedCommands: string[];
3473
+ updatedMemoryBytes?: number;
3474
+ updatedMemoryFields?: Record<string, number>;
3475
+ updatedVcpus?: number;
3476
+ updatedVcpusMax?: number;
3477
+ updatedVcpusAtStartup?: number;
3478
+ error?: string;
3479
+ powerState?: string;
3480
+ waitAttempts?: number;
3481
+ }
3482
+ declare const _default$1s: TaskFn<XcpngSetVmResourcesParams, XcpngSetVmResourcesResult>;
3483
+
3484
+ /**
3485
+ * Parameters for configuring VM boot behaviour.
3486
+ * - `vm_uuid`: Target VM identifier.
3487
+ * - `boot_order`: Boot sequence string recognised by XCP-ng (e.g., `cd`, `n`, `cdn`).
3488
+ * - `firmware`: Optional firmware mode (`bios`, `uefi`). When set, updates `HVM-boot-params`.
3489
+ */
3490
+ interface XcpngSetBootOrderParams {
3491
+ vm_uuid: string;
3492
+ boot_order: string;
3493
+ firmware?: 'bios' | 'uefi';
3494
+ }
3495
+ /**
3496
+ * Result describing the parameter updates issued for the VM.
3497
+ * - `appliedCommands`: Ordered list of CLI commands executed.
3498
+ * - `error`: Raw stderr output when a step fails.
3499
+ */
3500
+ interface XcpngSetBootOrderResult {
3501
+ success: boolean;
3502
+ appliedCommands: string[];
3503
+ error?: string;
3504
+ }
3505
+ declare const _default$1r: TaskFn<XcpngSetBootOrderParams, XcpngSetBootOrderResult>;
3506
+
3507
+ interface XcpngSetSnapshotParamParams {
3508
+ snapshot_uuid: string;
3509
+ key: string;
3510
+ value: string;
3511
+ }
3512
+ interface XcpngSetSnapshotParamResult {
3513
+ success: boolean;
3514
+ snapshotUuid?: string;
3515
+ command?: string;
3516
+ error?: string;
3517
+ }
3518
+ declare const _default$1q: TaskFn<XcpngSetSnapshotParamParams, XcpngSetSnapshotParamResult>;
3519
+
3520
+ interface XcpngRevertSnapshotParams {
3521
+ snapshot_uuid: string;
3522
+ }
3523
+ interface XcpngRevertSnapshotResult {
3524
+ success: boolean;
3525
+ snapshotUuid?: string;
3526
+ vmUuid?: string;
3527
+ command?: string;
3528
+ error?: string;
3529
+ powerState?: string;
3530
+ waitAttempts?: number;
3531
+ }
3532
+ declare const _default$1p: TaskFn<XcpngRevertSnapshotParams, XcpngRevertSnapshotResult>;
3533
+
3534
+ interface XcpngRemoveDiskParams {
3535
+ vbd_uuid?: string;
3536
+ vdi_uuid?: string;
3537
+ vm_uuid?: string;
3538
+ device?: string;
3539
+ allow_missing?: boolean;
3540
+ unplug?: boolean;
3541
+ destroy_vbd?: boolean;
3542
+ destroy_vdi?: boolean;
3543
+ }
3544
+ interface XcpngRemoveDiskResult {
3545
+ success: boolean;
3546
+ vbdUuid?: string;
3547
+ vdiUuid?: string;
3548
+ unplugged?: boolean;
3549
+ destroyedVbd?: boolean;
3550
+ destroyedVdi?: boolean;
3551
+ appliedCommands: string[];
3552
+ error?: string;
3553
+ }
3554
+ declare const _default$1o: TaskFn<XcpngRemoveDiskParams, XcpngRemoveDiskResult>;
3555
+
3556
+ interface XcpngResizeVmMemoryParams {
3557
+ vm_uuid?: string;
3558
+ vm_name_label?: string;
3559
+ memory_mib: number;
3560
+ }
3561
+ interface XcpngResizeVmMemoryResult {
3562
+ success: boolean;
3563
+ vmUuid?: string;
3564
+ appliedCommands: string[];
3565
+ memoryBytes?: number;
3566
+ error?: string;
3567
+ powerState?: string;
3568
+ waitAttempts?: number;
3569
+ }
3570
+ declare const _default$1n: TaskFn<XcpngResizeVmMemoryParams, XcpngResizeVmMemoryResult>;
3571
+
3572
+ interface XcpngResizeVmCpusParams {
3573
+ vm_uuid?: string;
3574
+ vm_name_label?: string;
3575
+ vcpus?: number;
3576
+ vcpus_max?: number;
3577
+ vcpus_at_startup?: number;
3578
+ }
3579
+ interface XcpngResizeVmCpusResult {
3580
+ success: boolean;
3581
+ vmUuid?: string;
3582
+ appliedCommands: string[];
3583
+ vcpus?: number;
3584
+ vcpusMax?: number;
3585
+ vcpusAtStartup?: number;
3586
+ error?: string;
3587
+ powerState?: string;
3588
+ waitAttempts?: number;
3589
+ }
3590
+ declare const _default$1m: TaskFn<XcpngResizeVmCpusParams, XcpngResizeVmCpusResult>;
3591
+
3592
+ interface XcpngResizeVdiParams {
3593
+ vdi_uuid?: string;
3594
+ vdi_name_label?: string;
3595
+ sr_uuid?: string;
3596
+ new_size_bytes?: number;
3597
+ new_size_mb?: number;
3598
+ new_size_gb?: number;
3599
+ new_size_mib?: number;
3600
+ online?: boolean;
3601
+ }
3602
+ interface XcpngResizeVdiResult {
3603
+ success: boolean;
3604
+ vdiUuid?: string;
3605
+ command?: string;
3606
+ newSizeBytes?: number;
3607
+ error?: string;
3608
+ }
3609
+ declare const _default$1l: TaskFn<XcpngResizeVdiParams, XcpngResizeVdiResult>;
3610
+
3611
+ /**
3612
+ * Parameters when querying VMs from an XCP-ng host.
3613
+ * - `filters`: Key/value pairs passed directly to `xe vm-list` for server-side filtering.
3614
+ * Examples include `{ uuid: '...', 'resident-on': 'host-uuid' }`.
3615
+ */
3616
+ interface XcpngListVmsParams {
3617
+ filters?: XeFilterInput;
3618
+ params?: 'all' | string | string[];
3619
+ }
3620
+ /**
3621
+ * Result payload containing VM records.
3622
+ * - `items`: Array of parsed metadata produced by `xe vm-list`.
3623
+ * - `raw`: Original stdout for debugging or custom parsing.
3624
+ * - `error`: Raw stderr output when the list operation fails.
3625
+ */
3626
+ interface XcpngListVmsResult {
3627
+ success: boolean;
3628
+ items?: XcpngVmRecord[];
3629
+ error?: string;
3630
+ }
3631
+ type XcpngVmRecord = Record<string, string> & {
3632
+ params: Record<string, string>;
3633
+ };
3634
+ declare const _default$1k: TaskFn<XcpngListVmsParams, XcpngListVmsResult>;
3635
+
3636
+ interface XcpngImportVdiParams {
3637
+ sr_uuid?: string;
3638
+ sr_name_label?: string;
3639
+ filename: string;
3640
+ vdi_name_label?: string;
3641
+ description?: string;
3642
+ type?: string;
3643
+ virtual_size?: number;
3644
+ force?: boolean;
3645
+ uuid?: string;
3646
+ format?: string;
3647
+ }
3648
+ interface XcpngImportVdiResult {
3649
+ success: boolean;
3650
+ srUuid?: string;
3651
+ vdiUuid?: string;
3652
+ appliedCommands: string[];
3653
+ error?: string;
3654
+ }
3655
+ declare const _default$1j: TaskFn<XcpngImportVdiParams, XcpngImportVdiResult>;
3656
+
3657
+ /**
3658
+ * Parameters for querying VDIs.
3659
+ * - `filters`: Filters passed to `xe vdi-list` (e.g., `{ 'sr-uuid': '...', type: 'user' }`).
3660
+ */
3661
+ interface XcpngListVdisParams {
3662
+ filters?: XeFilterInput;
3663
+ }
3664
+ /**
3665
+ * Result payload for VDI listings.
3666
+ * - `items`: Parsed records for each VDI returned by the host.
3667
+ * - `raw`: Full stdout output for troubleshooting.
3668
+ * - `error`: Raw stderr output when listing fails.
3669
+ */
3670
+ type XcpngVdiRecord = Record<string, string> & {
3671
+ params: Record<string, string>;
3672
+ };
3673
+ interface XcpngListVdisResult {
3674
+ success: boolean;
3675
+ items?: XcpngVdiRecord[];
3676
+ error?: string;
3677
+ }
3678
+ declare const _default$1i: TaskFn<XcpngListVdisParams, XcpngListVdisResult>;
3679
+
3680
+ interface XcpngListPifsParams {
3681
+ filters?: XeFilterInput;
3682
+ }
3683
+ type XcpngPifRecord = Record<string, string> & {
3684
+ params: Record<string, string>;
3685
+ };
3686
+ interface XcpngListPifsResult {
3687
+ success: boolean;
3688
+ items?: XcpngPifRecord[];
3689
+ error?: string;
3690
+ }
3691
+ declare const _default$1h: TaskFn<XcpngListPifsParams, XcpngListPifsResult>;
3692
+
3693
+ interface XcpngListTemplatesParams {
3694
+ filters?: XeFilterInput;
3695
+ }
3696
+ type XcpngTemplateRecord = Record<string, string> & {
3697
+ params: Record<string, string>;
3698
+ };
3699
+ interface XcpngListTemplatesResult {
3700
+ success: boolean;
3701
+ items?: XcpngTemplateRecord[];
3702
+ error?: string;
3703
+ }
3704
+ declare const _default$1g: TaskFn<XcpngListTemplatesParams, XcpngListTemplatesResult>;
3705
+
3706
+ interface XcpngListNetworksParams {
3707
+ filters?: XeFilterInput;
3708
+ }
3709
+ type XcpngNetworkRecord = Record<string, string> & {
3710
+ params: Record<string, string>;
3711
+ };
3712
+ interface XcpngListNetworksResult {
3713
+ success: boolean;
3714
+ items?: XcpngNetworkRecord[];
3715
+ error?: string;
3716
+ }
3717
+ declare const _default$1f: TaskFn<XcpngListNetworksParams, XcpngListNetworksResult>;
3718
+
3719
+ /**
3720
+ * Parameters for querying storage repositories.
3721
+ * - `filters`: Filters passed to `xe sr-list` (e.g., `{ 'name-label': 'Local storage' }`).
3722
+ */
3723
+ interface XcpngListStorageRepositoriesParams {
3724
+ filters?: XeFilterInput;
3725
+ }
3726
+ /**
3727
+ * Result payload for storage repository listings.
3728
+ * - `items`: Parsed SR metadata records.
3729
+ * - `raw`: Full stdout output captured from the host.
3730
+ * - `error`: Raw stderr when the list operation fails.
3731
+ */
3732
+ type XcpngStorageRepositoryRecord = Record<string, string> & {
3733
+ params: Record<string, string>;
3734
+ };
3735
+ interface XcpngListStorageRepositoriesResult {
3736
+ success: boolean;
3737
+ items?: XcpngStorageRepositoryRecord[];
3738
+ error?: string;
3739
+ }
3740
+ declare const _default$1e: TaskFn<XcpngListStorageRepositoriesParams, XcpngListStorageRepositoriesResult>;
3741
+
3742
+ interface XcpngUploadIsoParams {
3743
+ /** Path to the ISO on the local machine running hostctl. */
3744
+ source_path: string;
3745
+ /** Name-label of the ISO SR to ensure exists before uploading. */
3746
+ iso_sr_name: string;
3747
+ /**
3748
+ * Directory on the hypervisor where ISOs should reside. Defaults to `/var/opt/xen/iso-sr`.
3749
+ * Must align with the location configured on the SR.
3750
+ */
3751
+ location?: string;
3752
+ /**
3753
+ * Override the destination file name (defaults to the basename of `source_path`).
3754
+ */
3755
+ filename?: string;
3756
+ /**
3757
+ * When false (default), the upload is skipped if a file already exists at the destination.
3758
+ */
3759
+ overwrite?: boolean;
3760
+ /** Plumbed through to `find-or-create-iso-sr` for directory ownership. */
3761
+ location_owner?: string;
3762
+ /** Plumbed through to `find-or-create-iso-sr` for directory permissions. */
3763
+ location_mode?: string;
3764
+ /** Optional chunk size (in MiB) used when streaming the ISO to the hypervisor. Defaults to 128MiB. */
3765
+ chunk_size_mb?: number;
3766
+ }
3767
+ interface XcpngUploadIsoHostResult {
3768
+ success: boolean;
3769
+ uploaded: boolean;
3770
+ skipped?: boolean;
3771
+ srUuid?: string;
3772
+ createdSr?: boolean;
3773
+ remotePath?: string;
3774
+ error?: string;
3775
+ }
3776
+ interface XcpngUploadIsoResult {
3777
+ success: boolean;
3778
+ uploads: Record<string, XcpngUploadIsoHostResult | Error>;
3779
+ error?: string;
3780
+ }
3781
+ declare const _default$1d: TaskFn<XcpngUploadIsoParams, XcpngUploadIsoResult>;
3782
+
3783
+ interface XcpngProvisionVmParams {
3784
+ vm_name_label: string;
3785
+ vm_description?: string;
3786
+ template_uuid?: string;
3787
+ template_name_label?: string;
3788
+ destination_sr_uuid?: string;
3789
+ destination_sr_name_label?: string;
3790
+ disk_name_label?: string;
3791
+ disk_description?: string;
3792
+ disk_device?: string;
3793
+ disk_size_bytes?: number;
3794
+ disk_size_mb?: number;
3795
+ disk_size_mib?: number;
3796
+ disk_size_gb?: number;
3797
+ disk_size_gib?: number;
3798
+ vcpus?: number;
3799
+ memory_mib?: number;
3800
+ memory_mb?: number;
3801
+ memory_gb?: number;
3802
+ memory_gib?: number;
3803
+ virtualization_mode?: 'pv' | 'pvhvm';
3804
+ device_model?: 'qemu_traditional' | 'qemu-upstream-compat';
3805
+ boot_order?: string;
3806
+ boot_firmware?: 'bios' | 'uefi';
3807
+ boot_efi_file?: string;
3808
+ network_uuid?: string;
3809
+ network_name_label?: string;
3810
+ network_device?: string;
3811
+ network_mac_address?: string;
3812
+ network_mtu?: number;
3813
+ start_vm?: boolean;
3814
+ start_paused?: boolean;
3815
+ start_force?: boolean;
3816
+ cloud_init_user_data?: string;
3817
+ cloud_init_user_data_b64?: string;
3818
+ cloud_init_user_data_path?: string;
3819
+ cloud_init_network_config?: string;
3820
+ cloud_init_network_config_b64?: string;
3821
+ cloud_init_network_config_path?: string;
3822
+ cloud_init_hostname?: string;
3823
+ cloud_init_instance_id?: string;
3824
+ config_drive_enabled?: boolean;
3825
+ config_drive_force?: boolean;
3826
+ config_drive_sr_uuid?: string;
3827
+ config_drive_sr_name_label?: string;
3828
+ config_drive_sr_location?: string;
3829
+ config_drive_sr_location_owner?: string;
3830
+ config_drive_sr_location_mode?: string;
3831
+ config_drive_iso_filename?: string;
3832
+ config_drive_overwrite?: boolean;
3833
+ config_drive_volume_id?: string;
3834
+ config_drive_detach_after_start?: boolean;
3835
+ config_drive_detach_delay_seconds?: number;
3836
+ config_drive_keep_vdi?: boolean;
3837
+ }
3838
+ interface XcpngProvisionVmStep {
3839
+ name: string;
3840
+ success: boolean;
3841
+ details?: Record<string, unknown>;
3842
+ error?: string;
3843
+ }
3844
+ interface XcpngProvisionVmResult {
3845
+ success: boolean;
3846
+ vmUuid?: string;
3847
+ templateUuid?: string;
3848
+ sourceVdiUuid?: string;
3849
+ clonedVdiUuid?: string;
3850
+ destinationSrUuid?: string;
3851
+ rootVbdUuid?: string;
3852
+ vifUuid?: string;
3853
+ configDriveVdiUuid?: string;
3854
+ configDriveIsoPath?: string;
3855
+ configDriveSrUuid?: string;
3856
+ configDriveReused?: boolean;
3857
+ commands: string[];
3858
+ steps: XcpngProvisionVmStep[];
3859
+ error?: string;
3860
+ skipped?: boolean;
3861
+ }
3862
+ declare const _default$1c: TaskFn<XcpngProvisionVmParams, XcpngProvisionVmResult>;
3863
+
3864
+ interface XcpngProvisionVmFromIsoParams {
3865
+ /** Human readable VM name. */
3866
+ vm_name_label: string;
3867
+ /** Optional VM description. */
3868
+ vm_description?: string;
3869
+ /** Template UUID to clone. Takes precedence over `template_name_label`. */
3870
+ template_uuid?: string;
3871
+ /** Template name to resolve when UUID is not provided. */
3872
+ template_name_label?: string;
3873
+ /** Memory allocation in MiB (applied to static/dynamic bounds). */
3874
+ memory_mib?: number;
3875
+ /** Memory allocation in MB (converted to MiB when applied). */
3876
+ memory_mb?: number;
3877
+ /** Number of vCPUs to configure. */
3878
+ vcpus?: number;
3879
+ /** Virtualization mode to apply to the VM (defaults to PVHVM). */
3880
+ virtualization_mode?: 'pv' | 'pvhvm';
3881
+ /** Device model applied after cloning (defaults to qemu-upstream-compat). */
3882
+ device_model?: 'qemu_traditional' | 'qemu-upstream-compat';
3883
+ /** Root disk name. Defaults to `<vm_name_label>-root`. */
3884
+ root_disk_name_label?: string;
3885
+ /** Storage repository UUID to host the root disk. */
3886
+ root_disk_sr_uuid?: string;
3887
+ /** Storage repository name-label used when the UUID is not provided. */
3888
+ root_disk_sr_name_label?: string;
3889
+ /** Size of the root disk (provide exactly one of bytes/MB/GB). */
3890
+ root_disk_size_bytes?: number;
3891
+ root_disk_size_mb?: number;
3892
+ root_disk_size_gb?: number;
3893
+ /** Optional description for the root disk. */
3894
+ root_disk_description?: string;
3895
+ /** Device slot for the root disk (defaults to `0`). */
3896
+ root_disk_device?: string;
3897
+ /** Network UUID to attach. */
3898
+ network_uuid?: string;
3899
+ /** Network name-label used when UUID is not provided. */
3900
+ network_name_label?: string;
3901
+ /** Optional VIF slot (defaults to `0`). */
3902
+ network_device?: string;
3903
+ /** Optional static MAC address. */
3904
+ network_mac_address?: string;
3905
+ /** Optional MTU for the VIF. */
3906
+ network_mtu?: number;
3907
+ /** ISO VDI UUID if already known. */
3908
+ iso_vdi_uuid?: string;
3909
+ /** ISO VDI name-label used for lookup when UUID is not provided. */
3910
+ iso_name_label?: string;
3911
+ /** Storage repository UUID that houses the ISO when resolving by name. */
3912
+ iso_sr_uuid?: string;
3913
+ /** Device slot for the virtual CD drive (defaults to hypervisor selection). */
3914
+ iso_device?: string;
3915
+ /** Whether to eject existing media before inserting the ISO (default true). */
3916
+ iso_eject_before_insert?: boolean;
3917
+ /** Explicit boot order string (defaults to `cd` so the ISO is attempted first). */
3918
+ boot_order?: string;
3919
+ /** Optional firmware mode applied alongside boot order. */
3920
+ boot_firmware?: 'bios' | 'uefi';
3921
+ /** When true, powers on the VM after configuration. */
3922
+ start_vm?: boolean;
3923
+ /** Maps to `xe vm-start --paused`. */
3924
+ start_paused?: boolean;
3925
+ /** Maps to `xe vm-start --force`. */
3926
+ start_force?: boolean;
3927
+ }
3928
+ interface XcpngProvisionVmFromIsoStep {
3929
+ name: string;
3930
+ success: boolean;
3931
+ details?: Record<string, unknown>;
3932
+ error?: string;
3933
+ }
3934
+ interface XcpngProvisionVmFromIsoResult {
3935
+ success: boolean;
3936
+ vmUuid?: string;
3937
+ templateUuid?: string;
3938
+ rootDiskUuid?: string;
3939
+ rootVbdUuid?: string;
3940
+ rootDiskSrUuid?: string;
3941
+ networkVifUuid?: string;
3942
+ isoVdiUuid?: string;
3943
+ commands: string[];
3944
+ steps: XcpngProvisionVmFromIsoStep[];
3945
+ error?: string;
3946
+ }
3947
+ declare const _default$1b: TaskFn<XcpngProvisionVmFromIsoParams, XcpngProvisionVmFromIsoResult>;
3948
+
3949
+ interface XcpngImportIsoParams {
3950
+ /** ISO SR name-label that should surface the ISO. */
3951
+ iso_sr_name: string;
3952
+ /**
3953
+ * ISO file name (or full path) within the SR location. When a path is supplied, the directory
3954
+ * portion is treated as the SR location unless `location` is explicitly provided.
3955
+ */
3956
+ iso_filename: string;
3957
+ /**
3958
+ * Filesystem location on the hypervisor where ISO files live. Defaults to `/var/opt/xen/iso-sr`
3959
+ * or the directory component of `iso_filename` when provided.
3960
+ */
3961
+ location?: string;
3962
+ /** Owner passed to `core.dir.create` when ensuring the location exists. */
3963
+ location_owner?: string;
3964
+ /** Mode passed to `core.dir.create` when ensuring the location exists. */
3965
+ location_mode?: string;
3966
+ /**
3967
+ * When true (default), runs `xe sr-scan` before attempting an import so the SR indexes new files.
3968
+ */
3969
+ rescan?: boolean;
3970
+ /**
3971
+ * When true (default), calls `xe vdi-import` if the VDI is still missing after a rescan. Set to
3972
+ * false to only rescan and report absence.
3973
+ */
3974
+ import_when_missing?: boolean;
3975
+ }
3976
+ interface XcpngImportIsoResult {
3977
+ success: boolean;
3978
+ srUuid?: string;
3979
+ createdSr?: boolean;
3980
+ vdiUuid?: string;
3981
+ vdi?: Record<string, string>;
3982
+ wasImported?: boolean;
3983
+ rescanned?: boolean;
3984
+ commands: string[];
3985
+ error?: string;
3986
+ }
3987
+ declare const _default$1a: TaskFn<XcpngImportIsoParams, XcpngImportIsoResult>;
3988
+
3989
+ interface XcpngFindNetworkParams {
3990
+ name_label?: string;
3991
+ uuid?: string;
3992
+ filters?: XeFilterInput;
3993
+ allow_multiple?: boolean;
3994
+ fail_when_missing?: boolean;
3995
+ }
3996
+ interface XcpngFindNetworkResult {
3997
+ success: boolean;
3998
+ network?: XcpngNetworkRecord;
3999
+ matches?: XcpngNetworkRecord[];
4000
+ multiple?: boolean;
4001
+ error?: string;
4002
+ }
4003
+ declare const _default$19: TaskFn<XcpngFindNetworkParams, XcpngFindNetworkResult>;
4004
+
4005
+ interface XcpngFindStorageRepositoryParams {
4006
+ name_label?: string;
4007
+ uuid?: string;
4008
+ type?: string;
4009
+ content_type?: string;
4010
+ filters?: XcpngListStorageRepositoriesParams['filters'];
4011
+ allow_multiple?: boolean;
4012
+ fail_when_missing?: boolean;
4013
+ }
4014
+ interface XcpngFindStorageRepositoryResult {
4015
+ success: boolean;
4016
+ storageRepository?: XcpngStorageRepositoryRecord;
4017
+ matches?: XcpngStorageRepositoryRecord[];
4018
+ multiple?: boolean;
4019
+ error?: string;
4020
+ }
4021
+ declare const _default$18: TaskFn<XcpngFindStorageRepositoryParams, XcpngFindStorageRepositoryResult>;
4022
+
4023
+ interface XcpngFindOrCreateIsoSrParams {
4024
+ /** Desired `name-label` for the ISO SR. */
4025
+ name_label: string;
4026
+ /** Optional `name-description` to apply when the SR is created. */
4027
+ description?: string;
4028
+ /**
4029
+ * Filesystem path on the hypervisor that contains ISO images.
4030
+ * Defaults to `/var/opt/xen/iso-sr` when not provided.
4031
+ */
4032
+ location?: string;
4033
+ /**
4034
+ * Owner passed to `core.dir.create` when ensuring the location exists.
4035
+ * Defaults to `root` because ISO SR paths typically live under `/var`.
4036
+ */
4037
+ location_owner?: string;
4038
+ /**
4039
+ * Mode passed to `core.dir.create` when ensuring the location exists.
4040
+ */
4041
+ location_mode?: string;
4042
+ /** Optional host UUID to scope SR creation. Rarely required for ISO SRs. */
4043
+ host_uuid?: string;
4044
+ /**
4045
+ * Explicitly control the legacy mode flag on the SR (defaults to true, matching XCP-ng tooling).
4046
+ * Set to false to omit the legacy mode flag.
4047
+ */
4048
+ legacy_mode?: boolean;
4049
+ /**
4050
+ * Additional device-config entries to include when creating the SR.
4051
+ * Keys map to the suffix after `device-config:` (e.g., `{ legacy_mode: 'true' }`).
4052
+ */
4053
+ device_config?: Record<string, string | number | boolean | undefined | null>;
4054
+ /**
4055
+ * Additional other-config entries to include when creating the SR.
4056
+ * Keys map to the suffix after `other-config:` (e.g., `{ auto-scan: 'true' }`).
4057
+ */
4058
+ other_config?: Record<string, string | number | boolean | undefined | null>;
4059
+ }
4060
+ interface XcpngFindOrCreateIsoSrResult {
4061
+ success: boolean;
4062
+ created: boolean;
4063
+ /** UUID for the located or newly created SR. */
4064
+ srUuid?: string;
4065
+ /** Parsed SR metadata returned from `xe sr-list`. */
4066
+ sr?: Record<string, string>;
4067
+ /** Commands executed during creation (empty when SR already exists). */
4068
+ commands: string[];
4069
+ error?: string;
4070
+ }
4071
+ declare const _default$17: TaskFn<XcpngFindOrCreateIsoSrParams, XcpngFindOrCreateIsoSrResult>;
4072
+
4073
+ interface XcpngFindVmParams {
4074
+ name_label?: string;
4075
+ uuid?: string;
4076
+ filters?: XcpngListVmsParams['filters'];
4077
+ allow_multiple?: boolean;
4078
+ fail_when_missing?: boolean;
4079
+ params?: XcpngListVmsParams['params'];
4080
+ }
4081
+ interface XcpngFindVmResult {
4082
+ success: boolean;
4083
+ vm?: XcpngVmRecord;
4084
+ matches?: XcpngVmRecord[];
4085
+ multiple?: boolean;
4086
+ error?: string;
4087
+ }
4088
+ declare const _default$16: TaskFn<XcpngFindVmParams, XcpngFindVmResult>;
4089
+
4090
+ interface XcpngFindVdiParams {
4091
+ name_label?: string;
4092
+ uuid?: string;
4093
+ sr_uuid?: string;
4094
+ filters?: XcpngListVdisParams['filters'];
4095
+ allow_multiple?: boolean;
4096
+ fail_when_missing?: boolean;
4097
+ }
4098
+ interface XcpngFindVdiResult {
4099
+ success: boolean;
4100
+ vdi?: Record<string, string>;
4101
+ matches?: Array<Record<string, string>>;
4102
+ multiple?: boolean;
4103
+ error?: string;
4104
+ }
4105
+ declare const _default$15: TaskFn<XcpngFindVdiParams, XcpngFindVdiResult>;
4106
+
4107
+ interface XcpngFindTemplateParams {
4108
+ name_label?: string;
4109
+ uuid?: string;
4110
+ filters?: XcpngListTemplatesParams['filters'];
4111
+ allow_multiple?: boolean;
4112
+ fail_when_missing?: boolean;
4113
+ }
4114
+ interface XcpngFindTemplateResult {
4115
+ success: boolean;
4116
+ template?: Record<string, string>;
4117
+ matches?: Array<Record<string, string>>;
4118
+ multiple?: boolean;
4119
+ error?: string;
4120
+ }
4121
+ declare const _default$14: TaskFn<XcpngFindTemplateParams, XcpngFindTemplateResult>;
4122
+
4123
+ interface XcpngRebootVmParams {
4124
+ vm_uuid?: string;
4125
+ vm_name_label?: string;
4126
+ force?: boolean;
4127
+ }
4128
+ interface XcpngRebootVmResult {
4129
+ success: boolean;
4130
+ vmUuid?: string;
4131
+ command?: string;
4132
+ error?: string;
4133
+ powerState?: string;
4134
+ waitAttempts?: number;
4135
+ }
4136
+ declare const _default$13: TaskFn<XcpngRebootVmParams, XcpngRebootVmResult>;
4137
+
4138
+ interface XcpngSetPifParamParams {
4139
+ pif_uuid: string;
4140
+ key: string;
4141
+ value: string;
4142
+ }
4143
+ interface XcpngSetPifParamResult {
4144
+ success: boolean;
4145
+ pifUuid?: string;
4146
+ command?: string;
4147
+ error?: string;
4148
+ }
4149
+ declare const _default$12: TaskFn<XcpngSetPifParamParams, XcpngSetPifParamResult>;
4150
+
4151
+ interface XcpngUnplugPifParams {
4152
+ pif_uuid?: string;
4153
+ device?: string;
4154
+ host_uuid?: string;
4155
+ host_name_label?: string;
4156
+ allow_missing?: boolean;
4157
+ }
4158
+ interface XcpngUnplugPifResult {
4159
+ success: boolean;
4160
+ pifUuid?: string;
4161
+ appliedCommands: string[];
4162
+ skipped?: boolean;
4163
+ error?: string;
4164
+ }
4165
+ declare const _default$11: TaskFn<XcpngUnplugPifParams, XcpngUnplugPifResult>;
4166
+
4167
+ interface XcpngPifScanParams {
4168
+ host_uuid?: string;
4169
+ host_name_label?: string;
4170
+ allow_missing?: boolean;
4171
+ }
4172
+ interface XcpngPifScanResult {
4173
+ success: boolean;
4174
+ hostUuid?: string;
4175
+ appliedCommands: string[];
4176
+ skipped?: boolean;
4177
+ error?: string;
4178
+ }
4179
+ declare const _default$10: TaskFn<XcpngPifScanParams, XcpngPifScanResult>;
4180
+
4181
+ interface XcpngPlugPifParams {
4182
+ pif_uuid?: string;
4183
+ device?: string;
4184
+ host_uuid?: string;
4185
+ host_name_label?: string;
4186
+ allow_missing?: boolean;
4187
+ }
4188
+ interface XcpngPlugPifResult {
4189
+ success: boolean;
4190
+ pifUuid?: string;
4191
+ appliedCommands: string[];
4192
+ skipped?: boolean;
4193
+ error?: string;
4194
+ }
4195
+ declare const _default$$: TaskFn<XcpngPlugPifParams, XcpngPlugPifResult>;
4196
+
4197
+ interface XcpngSetSrParamParams {
4198
+ sr_uuid?: string;
4199
+ sr_name_label?: string;
4200
+ key: string;
4201
+ value: string;
4202
+ }
4203
+ interface XcpngSetSrParamResult {
4204
+ success: boolean;
4205
+ srUuid?: string;
4206
+ appliedCommands: string[];
4207
+ error?: string;
4208
+ }
4209
+ declare const _default$_: TaskFn<XcpngSetSrParamParams, XcpngSetSrParamResult>;
4210
+
4211
+ interface XcpngSetNetworkParamParams {
4212
+ network_uuid?: string;
4213
+ network_name_label?: string;
4214
+ key: string;
4215
+ value: string;
4216
+ }
4217
+ interface XcpngSetNetworkParamResult {
4218
+ success: boolean;
4219
+ networkUuid?: string;
4220
+ appliedCommands: string[];
4221
+ error?: string;
4222
+ }
4223
+ declare const _default$Z: TaskFn<XcpngSetNetworkParamParams, XcpngSetNetworkParamResult>;
4224
+
4225
+ interface XcpngSetPoolParamParams {
4226
+ pool_uuid?: string;
4227
+ pool_name_label?: string;
4228
+ key: string;
4229
+ value: string;
4230
+ }
4231
+ interface XcpngSetPoolParamResult {
4232
+ success: boolean;
4233
+ poolUuid?: string;
4234
+ appliedCommands: string[];
4235
+ error?: string;
4236
+ }
4237
+ declare const _default$Y: TaskFn<XcpngSetPoolParamParams, XcpngSetPoolParamResult>;
4238
+
4239
+ interface XcpngListPoolsParams {
4240
+ filters?: XeFilterInput;
4241
+ }
4242
+ interface XcpngListPoolsResult {
4243
+ success: boolean;
4244
+ items?: Array<Record<string, string>>;
4245
+ error?: string;
4246
+ }
4247
+ declare const _default$X: TaskFn<XcpngListPoolsParams, XcpngListPoolsResult>;
4248
+
4249
+ interface XcpngFindPoolParams {
4250
+ uuid?: string;
4251
+ name_label?: string;
4252
+ filters?: XcpngListPoolsParams['filters'];
4253
+ allow_multiple?: boolean;
4254
+ fail_when_missing?: boolean;
4255
+ }
4256
+ interface XcpngFindPoolResult {
4257
+ success: boolean;
4258
+ pool?: Record<string, string>;
4259
+ matches?: Array<Record<string, string>>;
4260
+ multiple?: boolean;
4261
+ error?: string;
4262
+ }
4263
+ declare const _default$W: TaskFn<XcpngFindPoolParams, XcpngFindPoolResult>;
4264
+
4265
+ interface XcpngUnplugPbdParams {
4266
+ pbd_uuid?: string;
4267
+ sr_uuid?: string;
4268
+ host_uuid?: string;
4269
+ allow_missing?: boolean;
4270
+ }
4271
+ interface XcpngUnplugPbdResult {
4272
+ success: boolean;
4273
+ pbdUuid?: string;
4274
+ appliedCommands: string[];
4275
+ skipped?: boolean;
4276
+ error?: string;
4277
+ }
4278
+ declare const _default$V: TaskFn<XcpngUnplugPbdParams, XcpngUnplugPbdResult>;
4279
+
4280
+ interface XcpngPlugPbdParams {
4281
+ pbd_uuid?: string;
4282
+ sr_uuid?: string;
4283
+ host_uuid?: string;
4284
+ allow_missing?: boolean;
4285
+ }
4286
+ interface XcpngPlugPbdResult {
4287
+ success: boolean;
4288
+ pbdUuid?: string;
4289
+ appliedCommands: string[];
4290
+ skipped?: boolean;
4291
+ error?: string;
4292
+ }
4293
+ declare const _default$U: TaskFn<XcpngPlugPbdParams, XcpngPlugPbdResult>;
4294
+
4295
+ interface XcpngDestroyPbdParams {
4296
+ pbd_uuid?: string;
4297
+ host_uuid?: string;
4298
+ host_name_label?: string;
4299
+ sr_uuid?: string;
4300
+ sr_name_label?: string;
4301
+ allow_missing?: boolean;
4302
+ }
4303
+ interface XcpngDestroyPbdResult {
4304
+ success: boolean;
4305
+ pbdUuid?: string;
4306
+ appliedCommands: string[];
4307
+ skipped?: boolean;
4308
+ error?: string;
4309
+ }
4310
+ declare const _default$T: TaskFn<XcpngDestroyPbdParams, XcpngDestroyPbdResult>;
4311
+
4312
+ interface XcpngCreatePbdParams {
4313
+ host_uuid?: string;
4314
+ host_name_label?: string;
4315
+ sr_uuid?: string;
4316
+ sr_name_label?: string;
4317
+ device_config?: Record<string, string | number | boolean>;
4318
+ other_config?: Record<string, string | number | boolean>;
4319
+ allow_existing?: boolean;
4320
+ }
4321
+ interface XcpngCreatePbdResult {
4322
+ success: boolean;
4323
+ pbdUuid?: string;
4324
+ hostUuid?: string;
4325
+ srUuid?: string;
4326
+ appliedCommands: string[];
4327
+ skipped?: boolean;
4328
+ error?: string;
4329
+ }
4330
+ declare const _default$S: TaskFn<XcpngCreatePbdParams, XcpngCreatePbdResult>;
4331
+
4332
+ interface XcpngListPbdsParams {
4333
+ filters?: XeFilterInput;
4334
+ }
4335
+ type XcpngPbdRecord = Record<string, string> & {
4336
+ params: Record<string, string>;
4337
+ };
4338
+ interface XcpngListPbdsResult {
4339
+ success: boolean;
4340
+ items?: XcpngPbdRecord[];
4341
+ error?: string;
4342
+ }
4343
+ declare const _default$R: TaskFn<XcpngListPbdsParams, XcpngListPbdsResult>;
4344
+
4345
+ interface XcpngFindPbdParams {
4346
+ uuid?: string;
4347
+ sr_uuid?: string;
4348
+ host_uuid?: string;
4349
+ filters?: XcpngListPbdsParams['filters'];
4350
+ allow_multiple?: boolean;
4351
+ fail_when_missing?: boolean;
4352
+ }
4353
+ interface XcpngFindPbdResult {
4354
+ success: boolean;
4355
+ pbd?: XcpngPbdRecord;
4356
+ matches?: XcpngPbdRecord[];
4357
+ multiple?: boolean;
4358
+ error?: string;
4359
+ }
4360
+ declare const _default$Q: TaskFn<XcpngFindPbdParams, XcpngFindPbdResult>;
4361
+
4362
+ interface XcpngEvacuateHostParams {
4363
+ host_uuid?: string;
4364
+ host_name_label?: string;
4365
+ allow_missing?: boolean;
4366
+ }
4367
+ interface XcpngEvacuateHostResult {
4368
+ success: boolean;
4369
+ hostUuid?: string;
4370
+ command?: string;
4371
+ skipped?: boolean;
4372
+ error?: string;
4373
+ }
4374
+ declare const _default$P: TaskFn<XcpngEvacuateHostParams, XcpngEvacuateHostResult>;
4375
+
4376
+ interface XcpngShutdownHostParams {
4377
+ host_uuid?: string;
4378
+ host_name_label?: string;
4379
+ force?: boolean;
4380
+ allow_missing?: boolean;
4381
+ }
4382
+ interface XcpngShutdownHostResult {
4383
+ success: boolean;
4384
+ hostUuid?: string;
4385
+ command?: string;
4386
+ skipped?: boolean;
4387
+ error?: string;
4388
+ }
4389
+ declare const _default$O: TaskFn<XcpngShutdownHostParams, XcpngShutdownHostResult>;
4390
+
4391
+ interface XcpngRebootHostParams {
4392
+ host_uuid?: string;
4393
+ host_name_label?: string;
4394
+ force?: boolean;
4395
+ allow_missing?: boolean;
4396
+ }
4397
+ interface XcpngRebootHostResult {
4398
+ success: boolean;
4399
+ hostUuid?: string;
4400
+ command?: string;
4401
+ skipped?: boolean;
4402
+ error?: string;
4403
+ }
4404
+ declare const _default$N: TaskFn<XcpngRebootHostParams, XcpngRebootHostResult>;
4405
+
4406
+ interface XcpngDisableHostParams {
4407
+ host_uuid?: string;
4408
+ host_name_label?: string;
4409
+ allow_missing?: boolean;
4410
+ force?: boolean;
4411
+ evacuate?: boolean;
4412
+ }
4413
+ interface XcpngDisableHostResult {
4414
+ success: boolean;
4415
+ hostUuid?: string;
4416
+ appliedCommands: string[];
4417
+ skipped?: boolean;
4418
+ evacuated?: boolean;
4419
+ error?: string;
4420
+ }
4421
+ declare const _default$M: TaskFn<XcpngDisableHostParams, XcpngDisableHostResult>;
4422
+
4423
+ interface XcpngEnableHostParams {
4424
+ host_uuid?: string;
4425
+ host_name_label?: string;
4426
+ allow_missing?: boolean;
4427
+ force?: boolean;
4428
+ }
4429
+ interface XcpngEnableHostResult {
4430
+ success: boolean;
4431
+ hostUuid?: string;
4432
+ appliedCommands: string[];
4433
+ skipped?: boolean;
4434
+ error?: string;
4435
+ }
4436
+ declare const _default$L: TaskFn<XcpngEnableHostParams, XcpngEnableHostResult>;
4437
+
4438
+ interface XcpngListHostsParams {
4439
+ filters?: XeFilterInput;
4440
+ }
4441
+ interface XcpngListHostsResult {
4442
+ success: boolean;
4443
+ items?: Array<Record<string, string>>;
4444
+ error?: string;
4445
+ }
4446
+ declare const _default$K: TaskFn<XcpngListHostsParams, XcpngListHostsResult>;
4447
+
4448
+ interface XcpngFindHostParams {
4449
+ name_label?: string;
4450
+ uuid?: string;
4451
+ filters?: XcpngListHostsParams['filters'];
4452
+ allow_multiple?: boolean;
4453
+ fail_when_missing?: boolean;
4454
+ }
4455
+ interface XcpngFindHostResult {
4456
+ success: boolean;
4457
+ host?: Record<string, string>;
4458
+ matches?: Array<Record<string, string>>;
4459
+ multiple?: boolean;
4460
+ error?: string;
4461
+ }
4462
+ declare const _default$J: TaskFn<XcpngFindHostParams, XcpngFindHostResult>;
4463
+
4464
+ interface XcpngClearMessagesParams {
4465
+ uuid?: string;
4466
+ uuid_prefix?: string;
4467
+ all?: boolean;
4468
+ filters?: XeFilterInput;
4469
+ }
4470
+ interface XcpngClearMessagesResult {
4471
+ success: boolean;
4472
+ cleared?: Array<string>;
4473
+ commands?: Array<string>;
4474
+ error?: string;
4475
+ }
4476
+ declare const _default$I: TaskFn<XcpngClearMessagesParams, XcpngClearMessagesResult>;
4477
+
4478
+ interface XcpngListMessagesParams {
4479
+ filters?: XeFilterInput;
4480
+ }
4481
+ interface XcpngListMessagesResult {
4482
+ success: boolean;
4483
+ items?: Array<Record<string, string>>;
4484
+ error?: string;
4485
+ }
4486
+ declare const _default$H: TaskFn<XcpngListMessagesParams, XcpngListMessagesResult>;
4487
+
4488
+ interface XcpngListSnapshotsParams {
4489
+ filters?: XeFilterInput;
4490
+ }
4491
+ interface XcpngListSnapshotsResult {
4492
+ success: boolean;
4493
+ items?: Array<Record<string, string>>;
4494
+ error?: string;
4495
+ }
4496
+ declare const _default$G: TaskFn<XcpngListSnapshotsParams, XcpngListSnapshotsResult>;
4497
+
4498
+ interface XcpngForgetSrParams {
4499
+ sr_uuid?: string;
4500
+ sr_name_label?: string;
4501
+ allow_missing?: boolean;
4502
+ }
4503
+ interface XcpngForgetSrResult {
4504
+ success: boolean;
4505
+ srUuid?: string;
4506
+ appliedCommands: string[];
4507
+ skipped?: boolean;
4508
+ error?: string;
4509
+ }
4510
+ declare const _default$F: TaskFn<XcpngForgetSrParams, XcpngForgetSrResult>;
4511
+
4512
+ interface XcpngIntroduceSrParams {
4513
+ sr_uuid: string;
4514
+ name_label?: string;
4515
+ type?: string;
4516
+ content_type?: string;
4517
+ shared?: boolean;
4518
+ }
4519
+ interface XcpngIntroduceSrResult {
4520
+ success: boolean;
4521
+ srUuid?: string;
4522
+ appliedCommands: string[];
4523
+ error?: string;
4524
+ }
4525
+ declare const _default$E: TaskFn<XcpngIntroduceSrParams, XcpngIntroduceSrResult>;
4526
+
4527
+ interface XcpngDestroySrParams {
4528
+ sr_uuid?: string;
4529
+ sr_name_label?: string;
4530
+ allow_missing?: boolean;
4531
+ force?: boolean;
4532
+ }
4533
+ interface XcpngDestroySrResult {
4534
+ success: boolean;
4535
+ srUuid?: string;
4536
+ appliedCommands: string[];
4537
+ skipped?: boolean;
4538
+ error?: string;
4539
+ }
4540
+ declare const _default$D: TaskFn<XcpngDestroySrParams, XcpngDestroySrResult>;
4541
+
4542
+ interface XcpngCreateSrParams {
4543
+ name_label: string;
4544
+ type: string;
4545
+ device_config: Record<string, string>;
4546
+ content_type?: string;
4547
+ description?: string;
4548
+ allow_existing?: boolean;
4549
+ }
4550
+ interface XcpngCreateSrResult {
4551
+ success: boolean;
4552
+ srUuid?: string;
4553
+ appliedCommands: string[];
4554
+ skipped?: boolean;
4555
+ error?: string;
4556
+ }
4557
+ declare const _default$C: TaskFn<XcpngCreateSrParams, XcpngCreateSrResult>;
4558
+
4559
+ interface XcpngDetachVdiParams {
4560
+ vbd_uuid?: string;
4561
+ vm_uuid?: string;
4562
+ vdi_uuid?: string;
4563
+ device?: string;
4564
+ allow_missing?: boolean;
4565
+ destroy_vbd?: boolean;
4566
+ destroy_vdi?: boolean;
4567
+ }
4568
+ interface XcpngDetachVdiResult {
4569
+ success: boolean;
4570
+ vbdUuid?: string;
4571
+ vdiUuid?: string;
4572
+ unplugged?: boolean;
4573
+ destroyedVbd?: boolean;
4574
+ destroyedVdi?: boolean;
4575
+ appliedCommands: string[];
4576
+ error?: string;
4577
+ }
4578
+ declare const _default$B: TaskFn<XcpngDetachVdiParams, XcpngDetachVdiResult>;
4579
+
4580
+ interface XcpngDetachNetworkInterfaceParams {
4581
+ vif_uuid?: string;
4582
+ vm_uuid?: string;
4583
+ device?: string;
4584
+ allow_missing?: boolean;
4585
+ destroy_record?: boolean;
4586
+ }
4587
+ interface XcpngDetachNetworkInterfaceResult {
4588
+ success: boolean;
4589
+ vifUuid?: string;
4590
+ unplugged?: boolean;
4591
+ destroyed?: boolean;
4592
+ appliedCommands: string[];
4593
+ error?: string;
4594
+ }
4595
+ declare const _default$A: TaskFn<XcpngDetachNetworkInterfaceParams, XcpngDetachNetworkInterfaceResult>;
4596
+
4597
+ interface XcpngDetachIsoParams {
4598
+ vm_uuid: string;
4599
+ allow_missing?: boolean;
4600
+ }
4601
+ interface XcpngDetachIsoResult {
4602
+ success: boolean;
4603
+ command?: string;
4604
+ ejected?: boolean;
4605
+ alreadyEmpty?: boolean;
4606
+ error?: string;
4607
+ }
4608
+ declare const _default$z: TaskFn<XcpngDetachIsoParams, XcpngDetachIsoResult>;
4609
+
4610
+ interface XcpngVmImportParams {
4611
+ filename: string;
4612
+ sr_uuid?: string;
4613
+ sr_name_label?: string;
4614
+ new_name_label?: string;
4615
+ preserve_mac_addresses?: boolean;
4616
+ force?: boolean;
4617
+ }
4618
+ interface XcpngVmImportResult {
4619
+ success: boolean;
4620
+ srUuid?: string;
4621
+ importedVmUuid?: string;
4622
+ appliedCommands: string[];
4623
+ error?: string;
4624
+ }
4625
+ declare const _default$y: TaskFn<XcpngVmImportParams, XcpngVmImportResult>;
4626
+
4627
+ interface XcpngVmExportParams {
4628
+ vm_uuid?: string;
4629
+ vm_name_label?: string;
4630
+ vm_filters?: XcpngFindVmParams['filters'];
4631
+ remote_path: string;
4632
+ compress?: boolean;
4633
+ live?: boolean;
4634
+ force?: boolean;
4635
+ allow_missing?: boolean;
4636
+ }
4637
+ interface XcpngVmExportResult {
4638
+ success: boolean;
4639
+ vmUuid?: string;
4640
+ outputPath?: string;
4641
+ appliedCommands: string[];
4642
+ skipped?: boolean;
4643
+ error?: string;
4644
+ }
4645
+ declare const _default$x: TaskFn<XcpngVmExportParams, XcpngVmExportResult>;
4646
+
4647
+ interface XcpngVmMigrateParams {
4648
+ vm_uuid?: string;
4649
+ vm_name_label?: string;
4650
+ vm_filters?: XcpngFindVmParams['filters'];
4651
+ destination_host_uuid?: string;
4652
+ destination_host_name_label?: string;
4653
+ destination_sr_uuid?: string;
4654
+ destination_sr_name_label?: string;
4655
+ live?: boolean;
4656
+ force?: boolean;
4657
+ allow_missing?: boolean;
4658
+ }
4659
+ interface XcpngVmMigrateResult {
4660
+ success: boolean;
4661
+ vmUuid?: string;
4662
+ destinationHostUuid?: string;
4663
+ destinationSrUuid?: string;
4664
+ appliedCommands: string[];
4665
+ skipped?: boolean;
4666
+ error?: string;
4667
+ }
4668
+ declare const _default$w: TaskFn<XcpngVmMigrateParams, XcpngVmMigrateResult>;
4669
+
4670
+ interface XcpngVmCopyParams {
4671
+ vm_uuid?: string;
4672
+ vm_name_label?: string;
4673
+ vm_filters?: XcpngFindVmParams['filters'];
4674
+ destination_sr_uuid?: string;
4675
+ destination_sr_name_label?: string;
4676
+ new_name_label?: string;
4677
+ description?: string;
4678
+ force?: boolean;
4679
+ allow_missing?: boolean;
4680
+ }
4681
+ interface XcpngVmCopyResult {
4682
+ success: boolean;
4683
+ sourceVmUuid?: string;
4684
+ newVmUuid?: string;
4685
+ destinationSrUuid?: string;
4686
+ appliedCommands: string[];
4687
+ skipped?: boolean;
4688
+ error?: string;
4689
+ }
4690
+ declare const _default$v: TaskFn<XcpngVmCopyParams, XcpngVmCopyResult>;
4691
+
4692
+ interface XcpngExportVdiParams {
4693
+ vdi_uuid?: string;
4694
+ vdi_name_label?: string;
4695
+ sr_uuid?: string;
4696
+ filters?: XcpngFindVdiParams['filters'];
4697
+ remote_path: string;
4698
+ export_format?: 'raw' | 'vhd' | 'vhd.gz';
4699
+ allow_missing?: boolean;
4700
+ }
4701
+ interface XcpngExportVdiResult {
4702
+ success: boolean;
4703
+ vdiUuid?: string;
4704
+ outputPath?: string;
4705
+ appliedCommands: string[];
4706
+ skipped?: boolean;
4707
+ error?: string;
4708
+ }
4709
+ declare const _default$u: TaskFn<XcpngExportVdiParams, XcpngExportVdiResult>;
4710
+
4711
+ interface XcpngCopyVdiParams {
4712
+ source_vdi_uuid?: string;
4713
+ source_vdi_name_label?: string;
4714
+ source_sr_uuid?: string;
4715
+ destination_sr_uuid?: string;
4716
+ destination_sr_name_label?: string;
4717
+ new_name_label?: string;
4718
+ description?: string;
4719
+ sharable?: boolean;
4720
+ allow_missing?: boolean;
4721
+ filters?: XcpngFindVdiParams['filters'];
4722
+ }
4723
+ interface XcpngCopyVdiResult {
4724
+ success: boolean;
4725
+ sourceVdiUuid?: string;
4726
+ destinationSrUuid?: string;
4727
+ sourceSrUuid?: string;
4728
+ newVdiUuid?: string;
4729
+ appliedCommands: string[];
4730
+ skipped?: boolean;
4731
+ error?: string;
4732
+ }
4733
+ declare const _default$t: TaskFn<XcpngCopyVdiParams, XcpngCopyVdiResult>;
4734
+
4735
+ interface XcpngDestroyVmParams {
4736
+ vm_uuid?: string;
4737
+ vm_name_label?: string;
4738
+ force?: boolean;
4739
+ destroy_snapshots?: boolean;
4740
+ destroy_vdis?: boolean;
4741
+ allow_missing?: boolean;
4742
+ filters?: Record<string, string | number | boolean | undefined | null>;
4743
+ }
4744
+ interface XcpngDestroyVmResult {
4745
+ success: boolean;
4746
+ vmUuid?: string;
4747
+ command?: string;
4748
+ commands?: string[];
4749
+ destroyedVdiUuids?: string[];
4750
+ skipped?: boolean;
4751
+ error?: string;
4752
+ }
4753
+ declare const _default$s: TaskFn<XcpngDestroyVmParams, XcpngDestroyVmResult>;
4754
+
4755
+ interface XcpngDestroyVdiParams {
4756
+ /** Target VDI UUID. */
4757
+ vdi_uuid?: string;
4758
+ /** Optional VDI name-label used to resolve the UUID when vdi_uuid is not supplied. */
4759
+ vdi_name_label?: string;
4760
+ /** Optional storage repository UUID when resolving by name. */
4761
+ sr_uuid?: string;
4762
+ /** Treat a missing VDI as success when true. */
4763
+ allow_missing?: boolean;
4764
+ }
4765
+ interface XcpngDestroyVdiResult {
4766
+ success: boolean;
4767
+ vdiUuid?: string;
4768
+ command?: string;
4769
+ skipped?: boolean;
4770
+ error?: string;
4771
+ }
4772
+ declare const _default$r: TaskFn<XcpngDestroyVdiParams, XcpngDestroyVdiResult>;
4773
+
4774
+ interface XcpngDestroyNetworkParams {
4775
+ network_uuid?: string;
4776
+ network_name_label?: string;
4777
+ allow_missing?: boolean;
4778
+ }
4779
+ interface XcpngDestroyNetworkResult {
4780
+ success: boolean;
4781
+ networkUuid?: string;
4782
+ appliedCommands: string[];
4783
+ skipped?: boolean;
4784
+ error?: string;
4785
+ }
4786
+ declare const _default$q: TaskFn<XcpngDestroyNetworkParams, XcpngDestroyNetworkResult>;
4787
+
4788
+ interface XcpngDestroyTemplateParams {
4789
+ template_uuid?: string;
4790
+ template_name_label?: string;
4791
+ allow_missing?: boolean;
4792
+ force?: boolean;
4793
+ filters?: Record<string, string | number | boolean | undefined | null>;
4794
+ }
4795
+ interface XcpngDestroyTemplateResult {
4796
+ success: boolean;
4797
+ templateUuid?: string;
4798
+ command?: string;
4799
+ skipped?: boolean;
4800
+ error?: string;
4801
+ }
4802
+ declare const _default$p: TaskFn<XcpngDestroyTemplateParams, XcpngDestroyTemplateResult>;
4803
+
4804
+ interface XcpngDestroyIsoSrParams {
4805
+ /** Target SR UUID. */
4806
+ sr_uuid?: string;
4807
+ /** Optional SR name-label used to resolve the UUID when sr_uuid is not provided. */
4808
+ sr_name_label?: string;
4809
+ /** Filesystem path to remove after destroying the SR (e.g., `/var/opt/xen/iso-hostctl-e2e`). */
4810
+ location?: string;
4811
+ /** Treat missing SRs or paths as success when true. */
4812
+ allow_missing?: boolean;
4813
+ }
4814
+ interface XcpngDestroyIsoSrResult {
4815
+ success: boolean;
4816
+ srUuid?: string;
4817
+ commands: string[];
4818
+ removedLocation?: boolean;
4819
+ skipped?: boolean;
4820
+ error?: string;
4821
+ }
4822
+ declare const _default$o: TaskFn<XcpngDestroyIsoSrParams, XcpngDestroyIsoSrResult>;
4823
+
4824
+ interface XcpngDestroyBondParams {
4825
+ bond_uuid?: string;
4826
+ pif_uuid?: string;
4827
+ allow_missing?: boolean;
4828
+ }
4829
+ interface XcpngDestroyBondResult {
4830
+ success: boolean;
4831
+ bondUuid?: string;
4832
+ appliedCommands: string[];
4833
+ skipped?: boolean;
4834
+ error?: string;
4835
+ }
4836
+ declare const _default$n: TaskFn<XcpngDestroyBondParams, XcpngDestroyBondResult>;
4837
+
4838
+ interface XcpngDestroySnapshotParams {
4839
+ snapshot_uuid: string;
4840
+ }
4841
+ interface XcpngDestroySnapshotResult {
4842
+ success: boolean;
4843
+ snapshotUuid?: string;
4844
+ command?: string;
4845
+ error?: string;
4846
+ }
4847
+ declare const _default$m: TaskFn<XcpngDestroySnapshotParams, XcpngDestroySnapshotResult>;
4848
+
4849
+ interface XcpngConvertTemplateToVmParams {
4850
+ template_uuid?: string;
4851
+ template_name_label?: string;
4852
+ filters?: XcpngFindTemplateParams['filters'];
4853
+ vm_name_label?: string;
4854
+ description?: string;
4855
+ allow_missing?: boolean;
4856
+ }
4857
+ interface XcpngConvertTemplateToVmResult {
4858
+ success: boolean;
4859
+ templateUuid?: string;
4860
+ vmUuid?: string;
4861
+ appliedCommands: string[];
4862
+ skipped?: boolean;
4863
+ alreadyVm?: boolean;
4864
+ error?: string;
4865
+ }
4866
+ declare const _default$l: TaskFn<XcpngConvertTemplateToVmParams, XcpngConvertTemplateToVmResult>;
4867
+
4868
+ /**
4869
+ * Parameters for provisioning a new VM on an XCP-ng host.
4870
+ * - `name_label`: Human-readable VM name (required).
4871
+ * - `template_name`: Optional template name to clone (e.g., "Other install media").
4872
+ * - `template_uuid`: Optional template UUID. Takes precedence over `template_name` when both are provided.
4873
+ * - `description`: Optional long-form description stored on the VM record.
4874
+ * - `affinity_host_uuid`: Optional host UUID to set VCpu affinity.
4875
+ * - `memory_mib`: Optional memory allocation expressed in MiB. All static/dynamic bounds are set to this value.
4876
+ * - `vcpus`: Optional number of virtual CPUs to configure.
4877
+ */
4878
+ interface XcpngCreateVmParams {
4879
+ name_label: string;
4880
+ template_name?: string;
4881
+ template_uuid?: string;
4882
+ description?: string;
4883
+ affinity_host_uuid?: string;
4884
+ memory_mib?: number;
4885
+ vcpus?: number;
4886
+ /**
4887
+ * Desired virtualization mode. Defaults to `pvhvm` so new guests receive hardware virtualization
4888
+ * with PV drivers (modern XCP-ng best practice).
4889
+ */
4890
+ virtualization_mode?: 'pv' | 'pvhvm';
4891
+ /**
4892
+ * Device model to use for the guest (defaults left untouched when omitted).
4893
+ */
4894
+ device_model?: 'qemu_traditional' | 'qemu-upstream-compat';
4895
+ }
4896
+ /**
4897
+ * Result payload describing the newly created VM.
4898
+ * - `vmUuid`: Identifier emitted by `xe vm-create`.
4899
+ * - `appliedCommands`: Ordered list of CLI invocations executed for auditing or retries.
4900
+ * - `error`: Raw error output when any step fails.
4901
+ */
4902
+ interface XcpngCreateVmResult {
4903
+ success: boolean;
4904
+ vmUuid?: string;
4905
+ appliedCommands: string[];
4906
+ error?: string;
4907
+ }
4908
+ declare const _default$k: TaskFn<XcpngCreateVmParams, XcpngCreateVmResult>;
4909
+
4910
+ /**
4911
+ * Parameters required to create a new virtual disk image (VDI) on an XCP-ng storage repository.
4912
+ * - `name_label`: Human-readable name assigned to the disk.
4913
+ * - `sr_uuid`: Identifier of the storage repository that should host the disk.
4914
+ * - `size_bytes`/`size_mb`/`size_gb`: Provisioned size; supply exactly one (bytes, MiB, or GiB).
4915
+ * - `description`: Optional friendly description stored alongside the VDI metadata.
4916
+ * - `type`: Disk type (`user`, `system`, `metadata`, etc.); defaults to `user`.
4917
+ * - `shareable`: Marks the disk as shareable across multiple VMs when set to `true`.
4918
+ */
4919
+ interface XcpngCreateVdiParams {
4920
+ name_label: string;
4921
+ sr_uuid: string;
4922
+ size_bytes?: number;
4923
+ size_mb?: number;
4924
+ size_gb?: number;
4925
+ description?: string;
4926
+ type?: string;
4927
+ shareable?: boolean;
4928
+ }
4929
+ /**
4930
+ * Result payload summarising the newly created disk.
4931
+ * - `vdiUuid`: Identifier emitted by `xe vdi-create`.
4932
+ * - `command`: Resolved CLI invocation for auditability.
4933
+ * - `error`: Raw stderr output when the command fails.
4934
+ */
4935
+ interface XcpngCreateVdiResult {
4936
+ success: boolean;
4937
+ vdiUuid?: string;
4938
+ command?: string;
4939
+ error?: string;
4940
+ }
4941
+ declare const _default$j: TaskFn<XcpngCreateVdiParams, XcpngCreateVdiResult>;
4942
+
4943
+ interface XcpngCreateTemplateFromVdiParams {
4944
+ template_name_label: string;
4945
+ template_description?: string;
4946
+ vm_name_label?: string;
4947
+ vm_description?: string;
4948
+ base_template_uuid?: string;
4949
+ base_template_name_label?: string;
4950
+ virtualization_mode?: 'pv' | 'pvhvm';
4951
+ device_model?: 'qemu_traditional' | 'qemu-upstream-compat' | 'qemu-upstream-uefi';
4952
+ memory_mib?: number;
4953
+ vcpus?: number;
4954
+ firmware?: 'bios' | 'uefi';
4955
+ vdi_uuid?: string;
4956
+ vdi_name_label?: string;
4957
+ vdi_sr_uuid?: string;
4958
+ disk_device?: string;
4959
+ allow_existing_template?: boolean;
4960
+ initial_boot_order?: string;
4961
+ final_boot_order?: string;
4962
+ cloud_init_user_data?: string;
4963
+ cloud_init_user_data_b64?: string;
4964
+ cloud_init_network_config?: string;
4965
+ cloud_init_network_config_b64?: string;
4966
+ cloud_init_hostname?: string;
4967
+ cloud_init_instance_id?: string;
4968
+ }
4969
+ interface XcpngCreateTemplateFromVdiStep {
4970
+ name: string;
4971
+ success: boolean;
4972
+ details?: Record<string, unknown>;
4973
+ error?: string;
4974
+ }
4975
+ interface XcpngCreateTemplateFromVdiResult {
4976
+ success: boolean;
4977
+ templateUuid?: string;
4978
+ vmUuid?: string;
4979
+ vdiUuid?: string;
4980
+ vbdUuid?: string;
4981
+ appliedCommands: string[];
4982
+ steps: XcpngCreateTemplateFromVdiStep[];
4983
+ error?: string;
4984
+ skipped?: boolean;
4985
+ }
4986
+ declare const _default$i: TaskFn<XcpngCreateTemplateFromVdiParams, XcpngCreateTemplateFromVdiResult>;
4987
+
4988
+ interface XcpngCloneTemplateParams {
4989
+ source_template_uuid?: string;
4990
+ source_template_name_label?: string;
4991
+ filters?: XcpngFindTemplateParams['filters'];
4992
+ new_template_name_label: string;
4993
+ description?: string;
4994
+ make_default?: boolean;
4995
+ allow_missing?: boolean;
4996
+ }
4997
+ interface XcpngCloneTemplateResult {
4998
+ success: boolean;
4999
+ sourceTemplateUuid?: string;
5000
+ templateUuid?: string;
5001
+ appliedCommands: string[];
5002
+ skipped?: boolean;
5003
+ alreadyExists?: boolean;
5004
+ error?: string;
5005
+ }
5006
+ declare const _default$h: TaskFn<XcpngCloneTemplateParams, XcpngCloneTemplateResult>;
5007
+
5008
+ interface XcpngCreateBondParams {
5009
+ host_uuid?: string;
5010
+ host_name_label?: string;
5011
+ network_uuid?: string;
5012
+ network_name_label?: string;
5013
+ pif_uuids: string[];
5014
+ mode?: string;
5015
+ mtu?: number;
5016
+ mac?: string;
5017
+ other_config?: Record<string, string | number | boolean>;
5018
+ properties?: Record<string, string | number | boolean>;
5019
+ }
5020
+ interface XcpngCreateBondResult {
5021
+ success: boolean;
5022
+ bondPifUuid?: string;
5023
+ hostUuid?: string;
5024
+ networkUuid?: string;
5025
+ appliedCommands: string[];
5026
+ error?: string;
5027
+ }
5028
+ declare const _default$g: TaskFn<XcpngCreateBondParams, XcpngCreateBondResult>;
5029
+
5030
+ interface XcpngDetachCdMediaParams {
5031
+ vm_uuid: string;
5032
+ allow_missing?: boolean;
5033
+ }
5034
+ interface XcpngDetachCdMediaStep {
5035
+ name: string;
5036
+ success: boolean;
5037
+ details?: Record<string, unknown>;
5038
+ error?: string;
5039
+ }
5040
+ interface XcpngDetachCdMediaResult {
5041
+ success: boolean;
5042
+ vmUuid?: string;
5043
+ removedVbds?: string[];
5044
+ commands: string[];
5045
+ steps: XcpngDetachCdMediaStep[];
5046
+ error?: string;
5047
+ skipped?: boolean;
5048
+ }
5049
+ declare const _default$f: TaskFn<XcpngDetachCdMediaParams, XcpngDetachCdMediaResult>;
5050
+
5051
+ interface XcpngCleanupConfigDriveParams {
5052
+ vm_uuid?: string;
5053
+ vm_name_label?: string;
5054
+ allow_missing?: boolean;
5055
+ keep_vdi?: boolean;
5056
+ require_halted?: boolean;
5057
+ }
5058
+ interface XcpngCleanupConfigDriveStep {
5059
+ name: string;
5060
+ success: boolean;
5061
+ details?: Record<string, unknown>;
5062
+ error?: string;
5063
+ }
5064
+ interface XcpngCleanupConfigDriveResult {
5065
+ success: boolean;
5066
+ vmUuid?: string;
5067
+ configDriveVdis?: string[];
5068
+ commands: string[];
5069
+ steps: XcpngCleanupConfigDriveStep[];
5070
+ error?: string;
5071
+ skipped?: boolean;
5072
+ }
5073
+ declare const _default$e: TaskFn<XcpngCleanupConfigDriveParams, XcpngCleanupConfigDriveResult>;
5074
+
5075
+ interface XcpngCreateConfigDriveParams {
5076
+ iso_sr_uuid?: string;
5077
+ iso_sr_name_label?: string;
5078
+ iso_sr_location?: string;
5079
+ iso_sr_location_owner?: string;
5080
+ iso_sr_location_mode?: string;
5081
+ iso_filename?: string;
5082
+ overwrite?: boolean;
5083
+ volume_id?: string;
5084
+ iso_tool_name?: string;
5085
+ vm_uuid?: string;
5086
+ vm_name_label?: string;
5087
+ instance_id?: string;
5088
+ hostname?: string;
5089
+ user_data?: string;
5090
+ user_data_b64?: string;
5091
+ meta_data?: string;
5092
+ meta_data_b64?: string;
5093
+ network_config?: string;
5094
+ network_config_b64?: string;
5095
+ local_iso_path?: string;
5096
+ }
5097
+ interface XcpngCreateConfigDriveStep {
5098
+ name: string;
5099
+ success: boolean;
5100
+ details?: Record<string, unknown>;
5101
+ error?: string;
5102
+ }
5103
+ interface XcpngCreateConfigDriveResult {
5104
+ success: boolean;
5105
+ srUuid?: string;
5106
+ vdiUuid?: string;
5107
+ isoPath?: string;
5108
+ volumeId?: string;
5109
+ reused?: boolean;
5110
+ commands: string[];
5111
+ steps: XcpngCreateConfigDriveStep[];
5112
+ error?: string;
5113
+ }
5114
+ declare const _default$d: TaskFn<XcpngCreateConfigDriveParams, XcpngCreateConfigDriveResult>;
5115
+
5116
+ interface XcpngCreateNetworkParams {
5117
+ name_label: string;
5118
+ description?: string;
5119
+ bridge?: string;
5120
+ mtu?: number;
5121
+ tags?: string[];
5122
+ allow_existing?: boolean;
5123
+ }
5124
+ interface XcpngCreateNetworkResult {
5125
+ success: boolean;
5126
+ networkUuid?: string;
5127
+ appliedCommands: string[];
5128
+ skipped?: boolean;
5129
+ error?: string;
5130
+ }
5131
+ declare const _default$c: TaskFn<XcpngCreateNetworkParams, XcpngCreateNetworkResult>;
5132
+
5133
+ interface XcpngCreateTemplateParams {
5134
+ source_vm_uuid?: string;
5135
+ source_vm_name_label?: string;
5136
+ template_name_label: string;
5137
+ description?: string;
5138
+ make_default?: boolean;
5139
+ }
5140
+ interface XcpngCreateTemplateResult {
5141
+ success: boolean;
5142
+ sourceVmUuid?: string;
5143
+ templateUuid?: string;
5144
+ appliedCommands: string[];
5145
+ error?: string;
5146
+ powerState?: string;
5147
+ waitAttempts?: number;
5148
+ }
5149
+ declare const _default$b: TaskFn<XcpngCreateTemplateParams, XcpngCreateTemplateResult>;
5150
+
5151
+ /**
5152
+ * Parameters for attaching an existing virtual disk image to a VM.
5153
+ * - `vm_uuid`: Target VM identifier.
5154
+ * - `vdi_uuid`: Disk identifier returned by `xe vdi-create` or `xe vdi-list`.
5155
+ * - `device`: Virtual device slot (e.g., `0`, `1`). Defaults to `0`.
5156
+ * - `mode`: Access mode (`RW` or `RO`). Defaults to `RW`.
5157
+ * - `bootable`: Marks the disk as bootable if `true`.
5158
+ */
5159
+ interface XcpngAttachVdiParams {
5160
+ vm_uuid: string;
5161
+ vdi_uuid: string;
5162
+ device?: string;
5163
+ mode?: 'RW' | 'RO';
5164
+ bootable?: boolean;
5165
+ }
5166
+ /**
5167
+ * Result summarising the new virtual block device (VBD) created for the VM.
5168
+ * - `vbdUuid`: Identifier emitted by `xe vbd-create`.
5169
+ * - `appliedCommands`: Both creation and plug commands for auditing purposes.
5170
+ * - `error`: Raw stderr output when the workflow fails.
5171
+ */
5172
+ interface XcpngAttachVdiResult {
5173
+ success: boolean;
5174
+ vbdUuid?: string;
5175
+ appliedCommands: string[];
5176
+ plugged?: boolean;
5177
+ error?: string;
5178
+ }
5179
+ declare const _default$a: TaskFn<XcpngAttachVdiParams, XcpngAttachVdiResult>;
5180
+
5181
+ /**
5182
+ * Parameters for attaching a virtual network interface (VIF) to a VM.
5183
+ * - `vm_uuid`: Target VM identifier.
5184
+ * - `network_uuid`: Network resource UUID obtained from `xe network-list`.
5185
+ * - `device`: Optional slot number (defaults to `0`).
5186
+ * - `mac_address`: Optional static MAC address. Leave undefined to let XCP-ng assign one.
5187
+ * - `mtu`: Optional MTU value applied to the interface.
5188
+ */
5189
+ interface XcpngAttachNetworkInterfaceParams {
5190
+ vm_uuid: string;
5191
+ network_uuid: string;
5192
+ device?: string;
5193
+ mac_address?: string;
5194
+ mtu?: number;
5195
+ }
5196
+ /**
5197
+ * Result details for the newly created VIF.
5198
+ * - `vifUuid`: Identifier emitted by `xe vif-create`.
5199
+ * - `appliedCommands`: Creation and plug commands executed in order.
5200
+ * - `error`: Raw stderr output when the workflow fails.
5201
+ */
5202
+ interface XcpngAttachNetworkInterfaceResult {
5203
+ success: boolean;
5204
+ vifUuid?: string;
5205
+ appliedCommands: string[];
5206
+ plugged?: boolean;
5207
+ error?: string;
5208
+ }
5209
+ declare const _default$9: TaskFn<XcpngAttachNetworkInterfaceParams, XcpngAttachNetworkInterfaceResult>;
5210
+
5211
+ /**
5212
+ * Parameters for inserting an ISO image into a VM's virtual CD drive.
5213
+ * - `vm_uuid`: Target VM identifier.
5214
+ * - `iso_vdi_uuid`: UUID of the ISO VDI stored in an SR.
5215
+ * - `device`: Optional CD device slot (defaults to hypervisor choice, commonly `3`).
5216
+ * - `eject_before_insert`: Attempts to eject any existing media before inserting the new ISO.
5217
+ */
5218
+ interface XcpngAttachIsoParams {
5219
+ vm_uuid: string;
5220
+ iso_vdi_uuid: string;
5221
+ device?: string;
5222
+ eject_before_insert?: boolean;
5223
+ }
5224
+ /**
5225
+ * Result describing the CD handling workflow.
5226
+ * - `appliedCommands`: Ordered list of `xe` commands executed.
5227
+ * - `error`: Raw stderr output when the insert workflow fails.
5228
+ */
5229
+ interface XcpngAttachIsoResult {
5230
+ success: boolean;
5231
+ appliedCommands: string[];
5232
+ plugged?: boolean;
5233
+ error?: string;
5234
+ }
5235
+ declare const _default$8: TaskFn<XcpngAttachIsoParams, XcpngAttachIsoResult>;
5236
+
5237
+ interface XcpngAddDiskParams {
5238
+ vm_uuid: string;
5239
+ sr_uuid?: string;
5240
+ sr_name_label?: string;
5241
+ /** Provide exactly one of the size fields to set disk capacity. */
5242
+ size_bytes?: number;
5243
+ size_mb?: number;
5244
+ size_gb?: number;
5245
+ size_mib?: number;
5246
+ name_label?: string;
5247
+ description?: string;
5248
+ device?: string;
5249
+ mode?: 'RW' | 'RO';
5250
+ bootable?: boolean;
5251
+ shareable?: boolean;
5252
+ type?: string;
5253
+ cleanup_vdi_on_failure?: boolean;
5254
+ }
5255
+ interface XcpngAddDiskResult {
5256
+ success: boolean;
5257
+ vmUuid?: string;
5258
+ vdiUuid?: string;
5259
+ vbdUuid?: string;
5260
+ appliedCommands: string[];
5261
+ plugged?: boolean;
5262
+ error?: string;
5263
+ }
5264
+ declare const _default$7: TaskFn<XcpngAddDiskParams, XcpngAddDiskResult>;
5265
+
5266
+ declare const _default$6: {
5267
+ addDisk: TaskFn<XcpngAddDiskParams, XcpngAddDiskResult>;
5268
+ attachIso: TaskFn<XcpngAttachIsoParams, XcpngAttachIsoResult>;
5269
+ attachNetworkInterface: TaskFn<XcpngAttachNetworkInterfaceParams, XcpngAttachNetworkInterfaceResult>;
5270
+ attachVdi: TaskFn<XcpngAttachVdiParams, XcpngAttachVdiResult>;
5271
+ createTemplate: TaskFn<XcpngCreateTemplateParams, XcpngCreateTemplateResult>;
5272
+ createNetwork: TaskFn<XcpngCreateNetworkParams, XcpngCreateNetworkResult>;
5273
+ createConfigDrive: TaskFn<XcpngCreateConfigDriveParams, XcpngCreateConfigDriveResult>;
5274
+ cleanupConfigDrive: TaskFn<XcpngCleanupConfigDriveParams, XcpngCleanupConfigDriveResult>;
5275
+ detachCdMedia: TaskFn<XcpngDetachCdMediaParams, XcpngDetachCdMediaResult>;
5276
+ createBond: TaskFn<XcpngCreateBondParams, XcpngCreateBondResult>;
5277
+ cloneTemplate: TaskFn<XcpngCloneTemplateParams, XcpngCloneTemplateResult>;
5278
+ createTemplateFromVdi: TaskFn<XcpngCreateTemplateFromVdiParams, XcpngCreateTemplateFromVdiResult>;
5279
+ createVdi: TaskFn<XcpngCreateVdiParams, XcpngCreateVdiResult>;
5280
+ createVm: TaskFn<XcpngCreateVmParams, XcpngCreateVmResult>;
5281
+ convertTemplateToVm: TaskFn<XcpngConvertTemplateToVmParams, XcpngConvertTemplateToVmResult>;
5282
+ destroySnapshot: TaskFn<XcpngDestroySnapshotParams, XcpngDestroySnapshotResult>;
5283
+ destroyBond: TaskFn<XcpngDestroyBondParams, XcpngDestroyBondResult>;
5284
+ destroyIsoSr: TaskFn<XcpngDestroyIsoSrParams, XcpngDestroyIsoSrResult>;
5285
+ destroyTemplate: TaskFn<XcpngDestroyTemplateParams, XcpngDestroyTemplateResult>;
5286
+ destroyNetwork: TaskFn<XcpngDestroyNetworkParams, XcpngDestroyNetworkResult>;
5287
+ destroyVdi: TaskFn<XcpngDestroyVdiParams, XcpngDestroyVdiResult>;
5288
+ destroyVm: TaskFn<XcpngDestroyVmParams, XcpngDestroyVmResult>;
5289
+ copyVdi: TaskFn<XcpngCopyVdiParams, XcpngCopyVdiResult>;
5290
+ exportVdi: TaskFn<XcpngExportVdiParams, XcpngExportVdiResult>;
5291
+ vmCopy: TaskFn<XcpngVmCopyParams, XcpngVmCopyResult>;
5292
+ vmMigrate: TaskFn<XcpngVmMigrateParams, XcpngVmMigrateResult>;
5293
+ vmExport: TaskFn<XcpngVmExportParams, XcpngVmExportResult>;
5294
+ vmImport: TaskFn<XcpngVmImportParams, XcpngVmImportResult>;
5295
+ detachIso: TaskFn<XcpngDetachIsoParams, XcpngDetachIsoResult>;
5296
+ detachNetworkInterface: TaskFn<XcpngDetachNetworkInterfaceParams, XcpngDetachNetworkInterfaceResult>;
5297
+ detachVdi: TaskFn<XcpngDetachVdiParams, XcpngDetachVdiResult>;
5298
+ createSr: TaskFn<XcpngCreateSrParams, XcpngCreateSrResult>;
5299
+ destroySr: TaskFn<XcpngDestroySrParams, XcpngDestroySrResult>;
5300
+ introduceSr: TaskFn<XcpngIntroduceSrParams, XcpngIntroduceSrResult>;
5301
+ forgetSr: TaskFn<XcpngForgetSrParams, XcpngForgetSrResult>;
5302
+ listSnapshots: TaskFn<XcpngListSnapshotsParams, XcpngListSnapshotsResult>;
5303
+ listMessages: TaskFn<XcpngListMessagesParams, XcpngListMessagesResult>;
5304
+ clearMessages: TaskFn<XcpngClearMessagesParams, XcpngClearMessagesResult>;
5305
+ listHosts: TaskFn<XcpngListHostsParams, XcpngListHostsResult>;
5306
+ findHost: TaskFn<XcpngFindHostParams, XcpngFindHostResult>;
5307
+ enableHost: TaskFn<XcpngEnableHostParams, XcpngEnableHostResult>;
5308
+ disableHost: TaskFn<XcpngDisableHostParams, XcpngDisableHostResult>;
5309
+ rebootHost: TaskFn<XcpngRebootHostParams, XcpngRebootHostResult>;
5310
+ shutdownHost: TaskFn<XcpngShutdownHostParams, XcpngShutdownHostResult>;
5311
+ evacuateHost: TaskFn<XcpngEvacuateHostParams, XcpngEvacuateHostResult>;
5312
+ listPbds: TaskFn<XcpngListPbdsParams, XcpngListPbdsResult>;
5313
+ findPbd: TaskFn<XcpngFindPbdParams, XcpngFindPbdResult>;
5314
+ createPbd: TaskFn<XcpngCreatePbdParams, XcpngCreatePbdResult>;
5315
+ destroyPbd: TaskFn<XcpngDestroyPbdParams, XcpngDestroyPbdResult>;
5316
+ plugPbd: TaskFn<XcpngPlugPbdParams, XcpngPlugPbdResult>;
5317
+ unplugPbd: TaskFn<XcpngUnplugPbdParams, XcpngUnplugPbdResult>;
5318
+ listPools: TaskFn<XcpngListPoolsParams, XcpngListPoolsResult>;
5319
+ findPool: TaskFn<XcpngFindPoolParams, XcpngFindPoolResult>;
5320
+ setPoolParam: TaskFn<XcpngSetPoolParamParams, XcpngSetPoolParamResult>;
5321
+ setNetworkParam: TaskFn<XcpngSetNetworkParamParams, XcpngSetNetworkParamResult>;
5322
+ setSrParam: TaskFn<XcpngSetSrParamParams, XcpngSetSrParamResult>;
5323
+ plugPif: TaskFn<XcpngPlugPifParams, XcpngPlugPifResult>;
5324
+ pifScan: TaskFn<XcpngPifScanParams, XcpngPifScanResult>;
5325
+ unplugPif: TaskFn<XcpngUnplugPifParams, XcpngUnplugPifResult>;
5326
+ setPifParam: TaskFn<XcpngSetPifParamParams, XcpngSetPifParamResult>;
5327
+ rebootVm: TaskFn<XcpngRebootVmParams, XcpngRebootVmResult>;
5328
+ findTemplate: TaskFn<XcpngFindTemplateParams, XcpngFindTemplateResult>;
5329
+ findVdi: TaskFn<XcpngFindVdiParams, XcpngFindVdiResult>;
5330
+ findVm: TaskFn<XcpngFindVmParams, XcpngFindVmResult>;
5331
+ findOrCreateIsoSr: TaskFn<XcpngFindOrCreateIsoSrParams, XcpngFindOrCreateIsoSrResult>;
5332
+ findStorageRepository: TaskFn<XcpngFindStorageRepositoryParams, XcpngFindStorageRepositoryResult>;
5333
+ findNetwork: TaskFn<XcpngFindNetworkParams, XcpngFindNetworkResult>;
5334
+ importIso: TaskFn<XcpngImportIsoParams, XcpngImportIsoResult>;
5335
+ provisionVmFromIso: TaskFn<XcpngProvisionVmFromIsoParams, XcpngProvisionVmFromIsoResult>;
5336
+ provisionVm: TaskFn<XcpngProvisionVmParams, XcpngProvisionVmResult>;
5337
+ uploadIso: TaskFn<XcpngUploadIsoParams, XcpngUploadIsoResult>;
5338
+ listStorageRepositories: TaskFn<XcpngListStorageRepositoriesParams, XcpngListStorageRepositoriesResult>;
5339
+ listNetworks: TaskFn<XcpngListNetworksParams, XcpngListNetworksResult>;
5340
+ listTemplates: TaskFn<XcpngListTemplatesParams, XcpngListTemplatesResult>;
5341
+ listVbds: TaskFn<XcpngListVbdsParams, XcpngListVbdsResult>;
5342
+ listVifs: TaskFn<XcpngListVifsParams, XcpngListVifsResult>;
5343
+ listPifs: TaskFn<XcpngListPifsParams, XcpngListPifsResult>;
5344
+ listVdis: TaskFn<XcpngListVdisParams, XcpngListVdisResult>;
5345
+ importVdi: TaskFn<XcpngImportVdiParams, XcpngImportVdiResult>;
5346
+ listVms: TaskFn<XcpngListVmsParams, XcpngListVmsResult>;
5347
+ resizeVdi: TaskFn<XcpngResizeVdiParams, XcpngResizeVdiResult>;
5348
+ resizeVmCpus: TaskFn<XcpngResizeVmCpusParams, XcpngResizeVmCpusResult>;
5349
+ resizeVmMemory: TaskFn<XcpngResizeVmMemoryParams, XcpngResizeVmMemoryResult>;
5350
+ removeDisk: TaskFn<XcpngRemoveDiskParams, XcpngRemoveDiskResult>;
5351
+ revertSnapshot: TaskFn<XcpngRevertSnapshotParams, XcpngRevertSnapshotResult>;
5352
+ setSnapshotParam: TaskFn<XcpngSetSnapshotParamParams, XcpngSetSnapshotParamResult>;
5353
+ setBootOrder: TaskFn<XcpngSetBootOrderParams, XcpngSetBootOrderResult>;
5354
+ setVmResources: TaskFn<XcpngSetVmResourcesParams, XcpngSetVmResourcesResult>;
5355
+ suspendVm: TaskFn<XcpngSuspendVmParams, XcpngSuspendVmResult>;
5356
+ resumeVm: TaskFn<XcpngResumeVmParams, XcpngResumeVmResult>;
5357
+ unplugVbd: TaskFn<XcpngUnplugVbdParams, XcpngUnplugVbdResult>;
5358
+ snapshotVm: TaskFn<XcpngSnapshotVmParams, XcpngSnapshotVmResult>;
5359
+ startVm: TaskFn<XcpngStartVmParams, XcpngStartVmResult>;
5360
+ stopVm: TaskFn<XcpngStopVmParams, XcpngStopVmResult>;
5361
+ getVmInfo: TaskFn<XcpngGetVmInfoParams, XcpngGetVmInfoResult>;
5362
+ listAttachedDisks: TaskFn<XcpngListAttachedDisksParams, XcpngListAttachedDisksResult>;
5363
+ };
5364
+
5365
+ declare namespace xcpng {
5366
+ export { _default$7 as addDisk, _default$8 as attachIso, _default$9 as attachNetworkInterface, _default$a as attachVdi, _default$e as cleanupConfigDrive, _default$I as clearMessages, _default$h as cloneTemplate, _default$l as convertTemplateToVm, _default$t as copyVdi, _default$g as createBond, _default$d as createConfigDrive, _default$c as createNetwork, _default$S as createPbd, _default$C as createSr, _default$b as createTemplate, _default$i as createTemplateFromVdi, _default$j as createVdi, _default$k as createVm, _default$6 as default, _default$n as destroyBond, _default$o as destroyIsoSr, _default$q as destroyNetwork, _default$T as destroyPbd, _default$m as destroySnapshot, _default$D as destroySr, _default$p as destroyTemplate, _default$r as destroyVdi, _default$s as destroyVm, _default$f as detachCdMedia, _default$z as detachIso, _default$A as detachNetworkInterface, _default$B as detachVdi, _default$M as disableHost, _default$L as enableHost, _default$P as evacuateHost, _default$u as exportVdi, _default$J as findHost, _default$19 as findNetwork, _default$17 as findOrCreateIsoSr, _default$Q as findPbd, _default$W as findPool, _default$18 as findStorageRepository, _default$14 as findTemplate, _default$15 as findVdi, _default$16 as findVm, _default$F as forgetSr, _default$1z as getVmInfo, _default$1a as importIso, _default$1j as importVdi, _default$E as introduceSr, _default$1C as listAttachedDisks, _default$K as listHosts, _default$H as listMessages, _default$1f as listNetworks, _default$R as listPbds, _default$1h as listPifs, _default$X as listPools, _default$G as listSnapshots, _default$1e as listStorageRepositories, _default$1g as listTemplates, _default$1B as listVbds, _default$1i as listVdis, _default$1A as listVifs, _default$1k as listVms, _default$10 as pifScan, _default$U as plugPbd, _default$$ as plugPif, _default$1c as provisionVm, _default$1b as provisionVmFromIso, _default$N as rebootHost, _default$13 as rebootVm, _default$1o as removeDisk, _default$1l as resizeVdi, _default$1m as resizeVmCpus, _default$1n as resizeVmMemory, _default$1u as resumeVm, _default$1p as revertSnapshot, _default$1r as setBootOrder, _default$Z as setNetworkParam, _default$12 as setPifParam, _default$Y as setPoolParam, _default$1q as setSnapshotParam, _default$_ as setSrParam, _default$1s as setVmResources, _default$O as shutdownHost, _default$1w as snapshotVm, _default$1x as startVm, _default$1y as stopVm, _default$1t as suspendVm, _default$V as unplugPbd, _default$11 as unplugPif, _default$1v as unplugVbd, _default$1d as uploadIso, _default$v as vmCopy, _default$x as vmExport, _default$y as vmImport, _default$w as vmMigrate };
5367
+ }
5368
+
5369
+ interface YumAddRepositoryParams {
5370
+ content: string;
5371
+ name: string;
5372
+ /** Run commands with sudo (default true) */
5373
+ sudo?: boolean;
5374
+ }
5375
+ interface YumAddRepositoryResult {
5376
+ success: boolean;
5377
+ error?: string;
5378
+ }
5379
+ declare const _default$5: TaskFn<YumAddRepositoryParams, YumAddRepositoryResult>;
5380
+
5381
+ declare namespace yum {
5382
+ export { _default$5 as add_repository };
5383
+ }
5384
+
5385
+ interface DownloadParams {
5386
+ url: string;
5387
+ dest: string;
5388
+ mode?: string | number;
5389
+ /** Run commands with sudo (default false) */
5390
+ sudo?: boolean;
5391
+ }
5392
+ interface DownloadResult {
5393
+ success: boolean;
5394
+ path?: string;
5395
+ error?: string;
5396
+ }
5397
+ declare const _default$4: TaskFn<DownloadParams, DownloadResult>;
5398
+
5399
+ interface NetworkInterface {
5400
+ name: string;
5401
+ state: string;
5402
+ mac?: string;
5403
+ ipv4?: {
5404
+ address: string;
5405
+ prefix: number;
5406
+ };
5407
+ ipv6?: {
5408
+ address: string;
5409
+ prefix: number;
5410
+ };
5411
+ ipv4_addresses?: Array<{
5412
+ address: string;
5413
+ prefix: number;
5414
+ }>;
5415
+ ipv6_addresses?: Array<{
5416
+ address: string;
5417
+ prefix: number;
5418
+ }>;
5419
+ mtu?: string;
5420
+ type?: string;
5421
+ }
5422
+ interface InterfacesParams {
5423
+ /** Run commands with sudo (default false) */
5424
+ sudo?: boolean;
5425
+ }
5426
+ interface InterfacesResult {
5427
+ success: boolean;
5428
+ interfaces?: NetworkInterface[];
5429
+ error?: string;
5430
+ }
5431
+ declare const _default$3: TaskFn<InterfacesParams, InterfacesResult>;
5432
+
5433
+ declare namespace net {
5434
+ export { _default$4 as download, _default$3 as interfaces };
5435
+ }
5436
+
5437
+ interface NftablesApplyParams {
5438
+ config: string;
5439
+ }
5440
+ interface NftablesApplyResult {
5441
+ success: boolean;
5442
+ error?: string;
5443
+ }
5444
+
5445
+ declare const _default$2: {
5446
+ apply: TaskFn<NftablesApplyParams, NftablesApplyResult>;
5447
+ };
5448
+
5449
+ declare namespace nftables {
5450
+ export { _default$2 as default };
5451
+ }
5452
+
5453
+ interface FirewalldDisableResult {
5454
+ success: boolean;
5455
+ error?: string;
5456
+ }
5457
+
5458
+ declare const _default$1: {
5459
+ disable: TaskFn<ObjectType, FirewalldDisableResult>;
5460
+ };
5461
+
5462
+ declare namespace firewalld {
5463
+ export { _default$1 as default };
5464
+ }
5465
+
5466
+ declare const _default: {
5467
+ echo: TaskFn<EchoParams, EchoResult>;
5468
+ env: TaskFn<EnvParams, EnvResult>;
5469
+ whoami: TaskFn<WhoamiParams, WhoamiResult>;
5470
+ dir: typeof dir;
5471
+ file: typeof file;
5472
+ git: typeof git;
5473
+ group: typeof group;
5474
+ host: typeof host;
5475
+ pkg: typeof pkg;
5476
+ k3s: typeof k3s;
5477
+ docker: typeof docker;
5478
+ ssh: typeof ssh;
5479
+ sudoers: typeof sudoers;
5480
+ process: typeof process;
5481
+ system: typeof system;
5482
+ systemd: typeof systemd;
5483
+ template: typeof template;
5484
+ ufw: typeof ufw;
5485
+ user: typeof user;
5486
+ xcpng: typeof xcpng;
5487
+ apt: typeof index$3;
5488
+ yum: typeof yum;
5489
+ net: typeof net;
5490
+ nftables: typeof nftables;
5491
+ firewalld: typeof firewalld;
5492
+ };
5493
+
5494
+ declare class RemoteRuntime implements IRuntime {
5495
+ private sftpClientInstance?;
5496
+ readonly app: App;
5497
+ readonly host: Host;
5498
+ readonly interactionHandler: InteractionHandler;
5499
+ private sshSession;
5500
+ constructor(app: App, host: Host, interactionHandler?: InteractionHandler);
5501
+ get tmpDirRootPath(): Path;
5502
+ getPassword(): Promise<string | undefined>;
5503
+ getSecret(name: string): Promise<string | undefined>;
5504
+ getTmpDir(): Path;
5505
+ getTmpFile(prefix?: string | undefined, postfix?: string | undefined, dir?: Path | undefined): Path;
5506
+ inventory(tags: string[]): Host[];
5507
+ selectedInventory(tags?: string[]): Host[];
5508
+ connect(): Promise<boolean>;
5509
+ getSftpClient(): Promise<any>;
5510
+ executeCommand(command: Command, options?: {
5511
+ stdin?: string | Buffer;
5512
+ pty?: boolean;
5513
+ interactionHandler?: InteractionHandler;
5514
+ }): Promise<Command | Error>;
5515
+ disconnect(): Promise<void>;
5516
+ invokeRootTask<TParams extends TaskParams, TReturn extends RunFnReturnValue>(taskFnDefinition: TaskFn<TParams, TReturn>, params: TParams): Promise<IInvocation>;
5517
+ }
1778
5518
 
1779
- export { App, CHECKMARK, type ChgrpParams, type ChgrpResult, type ChmodParams, type ChmodResult, type ChownParams, type ChownResult, Cli, CommandResult, type EnvVarObj, type FileSystemOperations$1 as FileSystemOperations, Host, type IInvocation, type IRuntime, type InputMap, Invocation, LocalRuntime, type LogLevel, type ObjectType, type OsDetailsResult, type PkgInfoParams, type PkgInfoResult, type PkgInstallParams, type PkgInstallResult, type PkgIsInstalledParams, type PkgIsInstalledResult, type PkgRemoveParams, type PkgRemoveResult, type PkgUpdateParams, type PkgUpdateResult, type RebootIfNeededParams, type RebootIfNeededResult, type RebootNeededParams, type RebootNeededResult, type RebootParams, type RebootResult, RemoteRuntime, type RunFn, type RunFnReturnValue, SUDO_PROMPT_REGEX, type ShutdownParams, type ShutdownResult, Task, type TaskContext, type TaskFn, type TaskParams, type TaskPartialFn, Verbosity, XMARK, _default as core, task, withSudo };
5519
+ export { type AddUsersParams, type AddUsersResult, App, CHECKMARK, type ChgrpParams, type ChgrpResult, type ChmodParams, type ChmodResult, type ChownParams, type ChownResult, Cli, CommandResult, type DockerInstallParams, type DockerInstallResult, type EnvVarObj, type ExecuteResult, type FileSystemOperations$1 as FileSystemOperations, Host, type IInvocation, type IRuntime, type InputMap, type InstallComposeParams, type InstallComposeResult, Invocation, LocalRuntime, type LogLevel, type ObjectType, type OsDetailsResult, type PkgInfoParams, type PkgInfoResult, type PkgInstallParams, type PkgInstallResult, type PkgIsInstalledParams, type PkgIsInstalledResult, type PkgRemoveParams, type PkgRemoveResult, type PkgUpdateParams, type PkgUpdateResult, type RebootIfNeededParams, type RebootIfNeededResult, type RebootNeededParams, type RebootNeededResult, type RebootParams, type RebootResult, RemoteRuntime, type RunFn, type RunFnReturnValue, SUDO_PROMPT_REGEX, type ShutdownParams, type ShutdownResult, Task, type TaskContext, type TaskFn, type TaskParams, type TaskPartialFn, Verbosity, XMARK, type XcpngAddDiskParams, type XcpngAddDiskResult, type XcpngAttachIsoParams, type XcpngAttachIsoResult, type XcpngAttachNetworkInterfaceParams, type XcpngAttachNetworkInterfaceResult, type XcpngAttachVdiParams, type XcpngAttachVdiResult, type XcpngAttachedDisk, type XcpngCleanupConfigDriveParams, type XcpngCleanupConfigDriveResult, type XcpngCleanupConfigDriveStep, type XcpngClearMessagesParams, type XcpngClearMessagesResult, type XcpngCloneTemplateParams, type XcpngCloneTemplateResult, type XcpngConvertTemplateToVmParams, type XcpngConvertTemplateToVmResult, type XcpngCopyVdiParams, type XcpngCopyVdiResult, type XcpngCreateBondParams, type XcpngCreateBondResult, type XcpngCreateConfigDriveParams, type XcpngCreateConfigDriveResult, type XcpngCreateConfigDriveStep, type XcpngCreatePbdParams, type XcpngCreatePbdResult, type XcpngCreateSrParams, type XcpngCreateSrResult, type XcpngCreateTemplateFromVdiParams, type XcpngCreateTemplateFromVdiResult, type XcpngCreateTemplateFromVdiStep, type XcpngCreateTemplateParams, type XcpngCreateTemplateResult, type XcpngCreateVdiParams, type XcpngCreateVdiResult, type XcpngCreateVmParams, type XcpngCreateVmResult, type XcpngDestroyBondParams, type XcpngDestroyBondResult, type XcpngDestroyIsoSrParams, type XcpngDestroyIsoSrResult, type XcpngDestroyPbdParams, type XcpngDestroyPbdResult, type XcpngDestroySnapshotParams, type XcpngDestroySnapshotResult, type XcpngDestroySrParams, type XcpngDestroySrResult, type XcpngDestroyTemplateParams, type XcpngDestroyTemplateResult, type XcpngDestroyVdiParams, type XcpngDestroyVdiResult, type XcpngDestroyVmParams, type XcpngDestroyVmResult, type XcpngDetachCdMediaParams, type XcpngDetachCdMediaResult, type XcpngDetachCdMediaStep, type XcpngDetachIsoParams, type XcpngDetachIsoResult, type XcpngDetachNetworkInterfaceParams, type XcpngDetachNetworkInterfaceResult, type XcpngDetachVdiParams, type XcpngDetachVdiResult, type XcpngDisableHostParams, type XcpngDisableHostResult, type XcpngEnableHostParams, type XcpngEnableHostResult, type XcpngExportVdiParams, type XcpngExportVdiResult, type XcpngFindHostParams, type XcpngFindHostResult, type XcpngFindNetworkParams, type XcpngFindNetworkResult, type XcpngFindOrCreateIsoSrParams, type XcpngFindOrCreateIsoSrResult, type XcpngFindPbdParams, type XcpngFindPbdResult, type XcpngFindPoolParams, type XcpngFindPoolResult, type XcpngFindStorageRepositoryParams, type XcpngFindStorageRepositoryResult, type XcpngFindTemplateParams, type XcpngFindTemplateResult, type XcpngFindVdiParams, type XcpngFindVdiResult, type XcpngFindVmParams, type XcpngFindVmResult, type XcpngForgetSrParams, type XcpngForgetSrResult, type XcpngGetVmInfoParams, type XcpngGetVmInfoResult, type XcpngImportIsoParams, type XcpngImportIsoResult, type XcpngImportVdiParams, type XcpngImportVdiResult, type XcpngIntroduceSrParams, type XcpngIntroduceSrResult, type XcpngListAttachedDisksParams, type XcpngListAttachedDisksResult, type XcpngListHostsParams, type XcpngListHostsResult, type XcpngListMessagesParams, type XcpngListMessagesResult, type XcpngListNetworksParams, type XcpngListNetworksResult, type XcpngListPbdsParams, type XcpngListPbdsResult, type XcpngListPoolsParams, type XcpngListPoolsResult, type XcpngListSnapshotsParams, type XcpngListSnapshotsResult, type XcpngListStorageRepositoriesParams, type XcpngListStorageRepositoriesResult, type XcpngListTemplatesParams, type XcpngListTemplatesResult, type XcpngListVbdsParams, type XcpngListVbdsResult, type XcpngListVdisParams, type XcpngListVdisResult, type XcpngListVmsParams, type XcpngListVmsResult, type XcpngPifScanParams, type XcpngPifScanResult, type XcpngPlugPbdParams, type XcpngPlugPbdResult, type XcpngPlugPifParams, type XcpngPlugPifResult, type XcpngProvisionVmFromIsoParams, type XcpngProvisionVmFromIsoResult, type XcpngProvisionVmFromIsoStep, type XcpngProvisionVmParams, type XcpngProvisionVmResult, type XcpngProvisionVmStep, type XcpngRebootVmParams, type XcpngRebootVmResult, type XcpngRemoveDiskParams, type XcpngRemoveDiskResult, type XcpngResizeVdiParams, type XcpngResizeVdiResult, type XcpngResizeVmCpusParams, type XcpngResizeVmCpusResult, type XcpngResizeVmMemoryParams, type XcpngResizeVmMemoryResult, type XcpngResumeVmParams, type XcpngResumeVmResult, type XcpngRevertSnapshotParams, type XcpngRevertSnapshotResult, type XcpngSetBootOrderParams, type XcpngSetBootOrderResult, type XcpngSetNetworkParamParams, type XcpngSetNetworkParamResult, type XcpngSetPifParamParams, type XcpngSetPifParamResult, type XcpngSetPoolParamParams, type XcpngSetPoolParamResult, type XcpngSetSnapshotParamParams, type XcpngSetSnapshotParamResult, type XcpngSetSrParamParams, type XcpngSetSrParamResult, type XcpngSetVmResourcesParams, type XcpngSetVmResourcesResult, type XcpngSnapshotVmParams, type XcpngSnapshotVmResult, type XcpngStartVmParams, type XcpngStartVmResult, type XcpngStopVmParams, type XcpngStopVmResult, type XcpngSuspendVmParams, type XcpngSuspendVmResult, type XcpngUnplugPbdParams, type XcpngUnplugPbdResult, type XcpngUnplugPifParams, type XcpngUnplugPifResult, type XcpngUnplugVbdParams, type XcpngUnplugVbdResult, type XcpngUploadIsoHostResult, type XcpngUploadIsoParams, type XcpngUploadIsoResult, type XcpngVmCopyParams, type XcpngVmCopyResult, type XcpngVmExportParams, type XcpngVmExportResult, type XcpngVmImportParams, type XcpngVmImportResult, type XcpngVmInfo, type XcpngVmMigrateParams, type XcpngVmMigrateResult, _default as core, task, withSudo };