@procedures/docker 0.2.3 → 0.4.0

package/src/procedures/docker/run.ts

@@ -5,7 +5,7 @@
  */
 
 import type { ProcedureContext } from "@procedures/client";
-import { dockerArg, runDocker, words } from "./shared.js";
+import { commandWords, dockerArg, runDocker } from "./shared.js";
 import type { DockerRunInput, DockerCommandOutput } from "../../types.js";
 
 /**
@@ -56,10 +56,8 @@ export async function dockerRun(
     // Add image
     args.push(dockerArg("image", input.image));
 
-    // Add command if specified
-    if (input.command) {
-      args.push(...words(input.command));
-    }
+    // Add the command: args as they are, or command split at whitespace
+    args.push(...commandWords(input));
     return runDocker(args, input, ctx);
   }
 }

package/src/procedures/docker/shared.ts

@@ -26,6 +26,34 @@ export function words(command: string): string[] {
   return command.trim().split(/\s+/).filter((word) => word.length > 0);
 }
 
+/**
+ * The command of docker.run or docker.exec: `args` as they are, or `command` split at whitespace.
+ * R32 found that `command` cannot carry an argument with a space, so R41 added `args`. The two
+ * together are an error. Docker reads no option after the image or the container, so an
+ * argument that starts with "-" goes to the command.
+ */
+export function commandWords(input: { command?: string | undefined; args?: string[] | undefined }): string[] {
+  if (input.command !== undefined && input.args !== undefined) {
+    throw new Error("Give command or args, not both");
+  }
+  return input.args ?? (input.command !== undefined ? words(input.command) : []);
+}
+
+/** The start of a compose command: `compose`, the compose file, and the subcommand. */
+export function composeArgs(file: string | undefined, subcommand: string): string[] {
+  return ["compose", ...(file ? ["-f", file] : []), subcommand];
+}
+
+/** The services of a compose command, after its options. */
+export function serviceArgs(services: string[] | undefined): string[] {
+  return (services ?? []).map((service) => dockerArg("service", service));
+}
+
+/** `--label key=value` for each label. */
+export function labelArgs(labels: Record<string, string> | undefined): string[] {
+  return Object.entries(labels ?? {}).flatMap(([key, value]) => ["--label", `${key}=${value}`]);
+}
+
 /** This function runs `docker <args>` and gives its result. It does not throw. */
 export async function runDocker(
   args: string[],

package/src/procedures/docker/tag.ts

@@ -0,0 +1,17 @@
+/**
+ * docker.tag procedure
+ *
+ * Give an image another name (roadmap R41). An image that had the target name loses it.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { dockerArg, runDocker } from "./shared.js";
+import type { DockerTagInput, DockerTagOutput } from "../../types.js";
+
+/**
+ * Give an image another name
+ */
+export async function dockerTag(input: DockerTagInput, ctx: ProcedureContext): Promise<DockerTagOutput> {
+  const args = ["tag", dockerArg("source", input.source), dockerArg("target", input.target)];
+  return runDocker(args, input, ctx);
+}

package/src/procedures/docker/volume/create.ts

@@ -0,0 +1,21 @@
+/**
+ * docker.volume.create procedure
+ *
+ * Create a volume (roadmap R41). Docker keeps a volume that exists: a second call with the same
+ * name changes nothing. The output is the name of the volume.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { dockerArg, labelArgs, runDocker } from "../shared.js";
+import type { DockerVolumeCreateInput, DockerVolumeCreateOutput } from "../../../types.js";
+
+/**
+ * Create a volume
+ */
+export async function dockerVolumeCreate(input: DockerVolumeCreateInput, ctx: ProcedureContext): Promise<DockerVolumeCreateOutput> {
+  const args = ["volume", "create"];
+  if (input.driver) args.push("--driver", input.driver);
+  args.push(...labelArgs(input.labels));
+  if (input.name) args.push(dockerArg("volume", input.name));
+  return runDocker(args, input, ctx);
+}

package/src/procedures/docker/volume/list.ts

@@ -0,0 +1,19 @@
+/**
+ * docker.volume.list procedure
+ *
+ * List volumes (roadmap R41).
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { runDocker } from "../shared.js";
+import type { DockerVolumeListInput, DockerVolumeListOutput } from "../../../types.js";
+
+/**
+ * List volumes
+ */
+export async function dockerVolumeList(input: DockerVolumeListInput, ctx: ProcedureContext): Promise<DockerVolumeListOutput> {
+  const args = ["volume", "ls"];
+  if (input.filter) args.push("--filter", input.filter);
+  if (input.format) args.push("--format", input.format);
+  return runDocker(args, input, ctx);
+}

package/src/procedures/docker/volume/remove.ts

@@ -0,0 +1,20 @@
+/**
+ * docker.volume.remove procedure
+ *
+ * Remove volumes (roadmap R41). The data of a removed volume is lost. Docker refuses a volume
+ * that a container uses.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { dockerArg, runDocker } from "../shared.js";
+import type { DockerVolumeRemoveInput, DockerVolumeRemoveOutput } from "../../../types.js";
+
+/**
+ * Remove volumes
+ */
+export async function dockerVolumeRemove(input: DockerVolumeRemoveInput, ctx: ProcedureContext): Promise<DockerVolumeRemoveOutput> {
+  const args = ["volume", "rm"];
+  if (input.force) args.push("--force");
+  args.push(...input.volumes.map((volume) => dockerArg("volume", volume)));
+  return runDocker(args, input, ctx);
+}

package/src/types.ts

@@ -77,6 +77,7 @@ export const DockerRunInputSchema: z.ZodObject<{
   detach: z.ZodOptional<z.ZodBoolean>;
   rm: z.ZodOptional<z.ZodBoolean>;
   command: z.ZodOptional<z.ZodString>;
+  args: z.ZodOptional<z.ZodArray<z.ZodString>>;
   cwd: z.ZodOptional<z.ZodString>;
   timeout: z.ZodOptional<z.ZodNumber>;
 }> = z.object({
@@ -94,8 +95,10 @@ export const DockerRunInputSchema: z.ZodObject<{
   detach: z.boolean().optional().describe("Run in detached mode"),
   /** Automatically remove container when it exits */
   rm: z.boolean().optional().describe("Automatically remove container when it exits"),
-  /** Command to run in container */
-  command: z.string().optional().describe("Command to run in container"),
+  /** Command to run in container: split at whitespace, so it cannot hold quoted text */
+  command: z.string().optional().describe("Command to run in container, split at whitespace. For an argument with spaces, use args"),
+  /** The command as a list: each item is one argument. It replaces `command` (roadmap R41). */
+  args: z.array(z.string()).optional().describe("The command as a list of arguments, each one as it is (not with command)"),
   /** Working directory */
   cwd: z.string().optional().describe("Working directory"),
   /** Timeout in milliseconds */
@@ -163,7 +166,8 @@ export type DockerPullInput = z.infer<typeof DockerPullInputSchema>;
 
 export const DockerExecInputSchema: z.ZodObject<{
   container: z.ZodString;
-  command: z.ZodString;
+  command: z.ZodOptional<z.ZodString>;
+  args: z.ZodOptional<z.ZodArray<z.ZodString>>;
   interactive: z.ZodOptional<z.ZodBoolean>;
   tty: z.ZodOptional<z.ZodBoolean>;
   workdir: z.ZodOptional<z.ZodString>;
@@ -173,8 +177,10 @@ export const DockerExecInputSchema: z.ZodObject<{
 }> = z.object({
   /** Container name or ID */
   container: z.string().describe("Container name or ID"),
-  /** Command to execute */
-  command: z.string().describe("Command to execute"),
+  /** Command to execute: split at whitespace, so it cannot hold quoted text */
+  command: z.string().optional().describe("Command to execute, split at whitespace. For an argument with spaces, use args"),
+  /** The command as a list: each item is one argument. Give `command` or `args` (roadmap R41). */
+  args: z.array(z.string()).optional().describe("The command as a list of arguments, each one as it is (not with command)"),
   /** Run interactively */
   interactive: z.boolean().optional().describe("Run interactively"),
   /** Allocate a TTY */
@@ -349,3 +355,352 @@ export const DockerComposeDownInputSchema: z.ZodObject<{
 });
 
 export type DockerComposeDownInput = z.infer<typeof DockerComposeDownInputSchema>;
+
+// =============================================================================
+// Roadmap R41: the fields that several procedures share
+// =============================================================================
+
+const COMPOSE_FILE = z.string().optional().describe("Compose file path");
+const SERVICES = z.array(z.string()).optional().describe("The services (default: all)");
+const CWD = z.string().optional().describe("Working directory");
+const TIMEOUT = z.number().optional().describe("Timeout in milliseconds");
+const FILTER = z.string().optional().describe("A filter of docker, for example label=app or dangling=true");
+const FORMAT = z.string().optional().describe("A Go template or json for the output (--format)");
+const LABELS = z.record(z.string(), z.string()).optional().describe("Labels");
+
+// =============================================================================
+// docker.compose.ps Types - The containers of a compose project (roadmap R41)
+// =============================================================================
+
+export const DockerComposePsInputSchema: z.ZodObject<{
+  file: z.ZodOptional<z.ZodString>;
+  services: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  all: z.ZodOptional<z.ZodBoolean>;
+  format: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  file: COMPOSE_FILE,
+  services: SERVICES,
+  all: z.boolean().optional().describe("Also the stopped containers"),
+  format: FORMAT,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerComposePsInput = z.infer<typeof DockerComposePsInputSchema>;
+
+// =============================================================================
+// docker.compose.logs Types - The logs of the services (roadmap R41)
+// =============================================================================
+
+export const DockerComposeLogsInputSchema: z.ZodObject<{
+  file: z.ZodOptional<z.ZodString>;
+  services: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tail: z.ZodOptional<z.ZodNumber>;
+  since: z.ZodOptional<z.ZodString>;
+  timestamps: z.ZodOptional<z.ZodBoolean>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  file: COMPOSE_FILE,
+  services: SERVICES,
+  tail: z.number().int().min(0).optional().describe("The number of lines from the end of each log"),
+  since: z.string().optional().describe("Only the logs after this time, for example 10m or 2026-10-16T10:00:00"),
+  timestamps: z.boolean().optional().describe("Show timestamps"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerComposeLogsInput = z.infer<typeof DockerComposeLogsInputSchema>;
+
+// =============================================================================
+// docker.compose.build Types - The images of the services (roadmap R41)
+// =============================================================================
+
+export const DockerComposeBuildInputSchema: z.ZodObject<{
+  file: z.ZodOptional<z.ZodString>;
+  services: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  noCache: z.ZodOptional<z.ZodBoolean>;
+  pull: z.ZodOptional<z.ZodBoolean>;
+  buildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  file: COMPOSE_FILE,
+  services: SERVICES,
+  noCache: z.boolean().optional().describe("Do not use cache when building"),
+  pull: z.boolean().optional().describe("Pull newer versions of the base images"),
+  buildArgs: z.record(z.string(), z.string()).optional().describe("Build arguments"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerComposeBuildInput = z.infer<typeof DockerComposeBuildInputSchema>;
+
+// =============================================================================
+// docker.compose.restart Types - Restart the services (roadmap R41)
+// =============================================================================
+
+export const DockerComposeRestartInputSchema: z.ZodObject<{
+  file: z.ZodOptional<z.ZodString>;
+  services: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  time: z.ZodOptional<z.ZodNumber>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  file: COMPOSE_FILE,
+  services: SERVICES,
+  time: z.number().int().min(0).optional().describe("Seconds to wait for the stop before killing"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerComposeRestartInput = z.infer<typeof DockerComposeRestartInputSchema>;
+
+// =============================================================================
+// docker.images Types - List images (roadmap R41)
+// =============================================================================
+
+export const DockerImagesInputSchema: z.ZodObject<{
+  repository: z.ZodOptional<z.ZodString>;
+  all: z.ZodOptional<z.ZodBoolean>;
+  filter: z.ZodOptional<z.ZodString>;
+  format: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  repository: z.string().optional().describe("Only the images of this repository, for example nginx or nginx:1.27"),
+  all: z.boolean().optional().describe("Also the intermediate images"),
+  filter: FILTER,
+  format: FORMAT,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerImagesInput = z.infer<typeof DockerImagesInputSchema>;
+
+// =============================================================================
+// docker.inspect Types - The details of objects as JSON (roadmap R41)
+// =============================================================================
+
+export const DockerInspectInputSchema: z.ZodObject<{
+  targets: z.ZodArray<z.ZodString>;
+  type: z.ZodOptional<z.ZodEnum<{ container: "container"; image: "image"; volume: "volume"; network: "network" }>>;
+  format: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  targets: z.array(z.string()).min(1).describe("The names or the IDs of the objects"),
+  type: z.enum(["container", "image", "volume", "network"]).optional().describe("The type of the objects (default: any type)"),
+  format: z.string().optional().describe("A Go template for the output. Without it, the output is JSON, and data has it"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerInspectInput = z.infer<typeof DockerInspectInputSchema>;
+
+/** The result of docker.inspect: `data` is the parsed JSON of docker, without `format`. */
+export interface DockerInspectOutput extends DockerCommandOutput {
+  data?: unknown;
+}
+
+// =============================================================================
+// docker.volume.* Types - Volumes (roadmap R41)
+// =============================================================================
+
+export const DockerVolumeListInputSchema: z.ZodObject<{
+  filter: z.ZodOptional<z.ZodString>;
+  format: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  filter: FILTER,
+  format: FORMAT,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerVolumeListInput = z.infer<typeof DockerVolumeListInputSchema>;
+
+export const DockerVolumeCreateInputSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  driver: z.ZodOptional<z.ZodString>;
+  labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  name: z.string().optional().describe("The volume name (default: a random name)"),
+  driver: z.string().optional().describe("The volume driver (default: local)"),
+  labels: LABELS,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerVolumeCreateInput = z.infer<typeof DockerVolumeCreateInputSchema>;
+
+export const DockerVolumeRemoveInputSchema: z.ZodObject<{
+  volumes: z.ZodArray<z.ZodString>;
+  force: z.ZodOptional<z.ZodBoolean>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  volumes: z.array(z.string()).min(1).describe("The volume names. Their data is lost"),
+  force: z.boolean().optional().describe("Force removal"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerVolumeRemoveInput = z.infer<typeof DockerVolumeRemoveInputSchema>;
+
+// =============================================================================
+// docker.network.* Types - Networks (roadmap R41)
+// =============================================================================
+
+export const DockerNetworkListInputSchema: z.ZodObject<{
+  filter: z.ZodOptional<z.ZodString>;
+  format: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  filter: FILTER,
+  format: FORMAT,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerNetworkListInput = z.infer<typeof DockerNetworkListInputSchema>;
+
+export const DockerNetworkCreateInputSchema: z.ZodObject<{
+  name: z.ZodString;
+  driver: z.ZodOptional<z.ZodString>;
+  internal: z.ZodOptional<z.ZodBoolean>;
+  labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  name: z.string().describe("The network name"),
+  driver: z.string().optional().describe("The network driver (default: bridge)"),
+  internal: z.boolean().optional().describe("No access to networks outside the host"),
+  labels: LABELS,
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerNetworkCreateInput = z.infer<typeof DockerNetworkCreateInputSchema>;
+
+export const DockerNetworkRemoveInputSchema: z.ZodObject<{
+  networks: z.ZodArray<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  networks: z.array(z.string()).min(1).describe("The network names or IDs"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerNetworkRemoveInput = z.infer<typeof DockerNetworkRemoveInputSchema>;
+
+// =============================================================================
+// docker.tag and docker.push Types (roadmap R41)
+// =============================================================================
+
+export const DockerTagInputSchema: z.ZodObject<{
+  source: z.ZodString;
+  target: z.ZodString;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  source: z.string().describe("The image, for example app:latest or an image ID"),
+  target: z.string().describe("The new name, for example registry.example.com/app:1.0. An image with this name loses it"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerTagInput = z.infer<typeof DockerTagInputSchema>;
+
+export const DockerPushInputSchema: z.ZodObject<{
+  image: z.ZodString;
+  allTags: z.ZodOptional<z.ZodBoolean>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  image: z.string().describe("The image, for example registry.example.com/app:1.0"),
+  allTags: z.boolean().optional().describe("Push all the tags of the repository"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerPushInput = z.infer<typeof DockerPushInputSchema>;
+
+// =============================================================================
+// docker.prune Types - Remove unused objects (roadmap R41)
+// =============================================================================
+
+export const DockerPruneInputSchema: z.ZodObject<{
+  kind: z.ZodOptional<
+    z.ZodEnum<{ system: "system"; container: "container"; image: "image"; volume: "volume"; network: "network"; builder: "builder" }>
+  >;
+  all: z.ZodOptional<z.ZodBoolean>;
+  volumes: z.ZodOptional<z.ZodBoolean>;
+  filter: z.ZodOptional<z.ZodString>;
+  confirm: z.ZodLiteral<true>;
+  cwd: z.ZodOptional<z.ZodString>;
+  timeout: z.ZodOptional<z.ZodNumber>;
+}> = z.object({
+  kind: z
+    .enum(["system", "container", "image", "volume", "network", "builder"])
+    .optional()
+    .describe("What to remove. system: the stopped containers, the unused networks, the dangling images and the build cache (default: system)"),
+  all: z.boolean().optional().describe("Also the unused images that have a name (image, system, builder), or the named volumes (volume)"),
+  volumes: z.boolean().optional().describe("With the kind system: also the unused volumes. Their data is lost"),
+  filter: FILTER,
+  confirm: z.literal(true).describe("Must be true: the removed objects and their data are lost"),
+  cwd: CWD,
+  timeout: TIMEOUT,
+});
+
+export type DockerPruneInput = z.infer<typeof DockerPruneInputSchema>;
+
+// =============================================================================
+// The outputs of the procedures of roadmap R41
+// =============================================================================
+
+export type DockerComposePsOutput = DockerCommandOutput;
+export type DockerComposeLogsOutput = DockerCommandOutput;
+export type DockerComposeBuildOutput = DockerCommandOutput;
+export type DockerComposeRestartOutput = DockerCommandOutput;
+export type DockerImagesOutput = DockerCommandOutput;
+export type DockerVolumeListOutput = DockerCommandOutput;
+export type DockerVolumeCreateOutput = DockerCommandOutput;
+export type DockerVolumeRemoveOutput = DockerCommandOutput;
+export type DockerNetworkListOutput = DockerCommandOutput;
+export type DockerNetworkCreateOutput = DockerCommandOutput;
+export type DockerNetworkRemoveOutput = DockerCommandOutput;
+export type DockerTagOutput = DockerCommandOutput;
+export type DockerPushOutput = DockerCommandOutput;
+export type DockerPruneOutput = DockerCommandOutput;
+
+export const DockerComposePsOutputSchema: z.ZodType<DockerComposePsOutput> = DockerCommandOutputSchema;
+export const DockerComposeLogsOutputSchema: z.ZodType<DockerComposeLogsOutput> = DockerCommandOutputSchema;
+export const DockerComposeBuildOutputSchema: z.ZodType<DockerComposeBuildOutput> = DockerCommandOutputSchema;
+export const DockerComposeRestartOutputSchema: z.ZodType<DockerComposeRestartOutput> = DockerCommandOutputSchema;
+export const DockerImagesOutputSchema: z.ZodType<DockerImagesOutput> = DockerCommandOutputSchema;
+export const DockerVolumeListOutputSchema: z.ZodType<DockerVolumeListOutput> = DockerCommandOutputSchema;
+export const DockerVolumeCreateOutputSchema: z.ZodType<DockerVolumeCreateOutput> = DockerCommandOutputSchema;
+export const DockerVolumeRemoveOutputSchema: z.ZodType<DockerVolumeRemoveOutput> = DockerCommandOutputSchema;
+export const DockerNetworkListOutputSchema: z.ZodType<DockerNetworkListOutput> = DockerCommandOutputSchema;
+export const DockerNetworkCreateOutputSchema: z.ZodType<DockerNetworkCreateOutput> = DockerCommandOutputSchema;
+export const DockerNetworkRemoveOutputSchema: z.ZodType<DockerNetworkRemoveOutput> = DockerCommandOutputSchema;
+export const DockerTagOutputSchema: z.ZodType<DockerTagOutput> = DockerCommandOutputSchema;
+export const DockerPushOutputSchema: z.ZodType<DockerPushOutput> = DockerCommandOutputSchema;
+export const DockerPruneOutputSchema: z.ZodType<DockerPruneOutput> = DockerCommandOutputSchema;
+
+export const DockerInspectOutputSchema: z.ZodType<DockerInspectOutput> = z.looseObject({
+  exitCode: z.number().describe("The exit code of docker (0 is success)"),
+  stdout: z.string().describe("The standard output of docker"),
+  stderr: z.string().describe("The standard error of docker, or the error message when docker did not start"),
+  success: z.boolean().describe("True when the exit code is 0"),
+  duration: z.number().describe("The time of the command, in milliseconds"),
+  data: z.unknown().optional().describe("The parsed JSON of docker: one object for each target"),
+});