Method execute

src/tools/docker/docker-tools.ts:66–89

(a: z.infer<typeof InspectArgs>)

  description = 'Inspect a container or image. With no path, returns a condensed summary (state, health, mounts, networks, env count, image). With a Go-template path, returns just that field. Read-only.';
  isReadOnly = true; isDestructive = false; argsSchema = InspectArgs;
  async execute(a: z.infer<typeof InspectArgs>): Promise<ToolResult> {
    if (a.path) return docker(['inspect', '--format', a.path, a.target], 20_000);
    const r = await runProcess('docker', ['inspect', a.target], { timeoutMs: 20_000 });
    if (r.notFound) return { content: notInstalledMessage('docker', DOCKER_HINT), isError: true };
    if (!r.ok) return { content: (r.stderr || r.stdout).trim() || 'inspect failed', isError: true };
    // Condense the (huge) inspect JSON to the fields a developer actually reads.
    try {
      const arr = JSON.parse(r.stdout);
      const o = Array.isArray(arr) ? arr[0] : arr;
      const summary: Record<string, unknown> = {
        name: o?.Name, image: o?.Config?.Image ?? o?.RepoTags,
        state: o?.State?.Status, health: o?.State?.Health?.Status,
        startedAt: o?.State?.StartedAt, restartCount: o?.RestartCount,
        ports: o?.NetworkSettings?.Ports ? Object.keys(o.NetworkSettings.Ports) : undefined,
        mounts: Array.isArray(o?.Mounts) ? o.Mounts.map((m: any) => `${m.Source}:${m.Destination}`) : undefined,
        networks: o?.NetworkSettings?.Networks ? Object.keys(o.NetworkSettings.Networks) : undefined,
        envCount: Array.isArray(o?.Config?.Env) ? o.Config.Env.length : undefined,
        cmd: o?.Config?.Cmd,
      };
      return { content: JSON.stringify(summary, null, 2) };
    } catch {
      return { content: r.stdout.slice(0, 4000) };
    }
  }
}

// ---- docker_exec ----