local_ydb_container_logs

Instructions

Implementation Reference

• packages/core/src/operations/checks.ts:95-115 (handler)

  The core handler function `containerLogs` that executes the tool logic. It runs `docker logs` for the targeted container (static or dynamic) with a configurable line count, returning stdout/stderr.

  export async function containerLogs(
    ctx: ToolkitContext,
    options: { target: "static" | "dynamic"; lines?: number }
  ) {
    const container = options.target === "dynamic" ? ctx.profile.dynamicContainer : ctx.profile.staticContainer;
    const lines = options.lines ?? 200;
    const result = await ctx.client.run({
      command: "docker",
      args: ["logs", "--tail", String(lines), container],
      allowFailure: true,
      description: `Read ${options.target} container logs`
    });
    return {
      summary: result.ok ? `Read ${options.target} container logs.` : `Failed to read ${options.target} container logs.`,
      ok: result.ok,
      container,
      command: result.command,
      stdout: result.stdout,
      stderr: result.stderr
    };
  }

• packages/mcp-server/src/tools/input-schemas.ts:41-61 (schema)

  The `logsSchema` function defines the JSON Schema input schema for the tool: required 'target' (static/dynamic) and optional 'lines' (integer, min 1).

  export function logsSchema(): Tool["inputSchema"] {
    return {
      type: "object",
      required: ["target"],
      properties: {
        profile: profileProperty(),
        configPath: configPathProperty(),
        target: {
          type: "string",
          enum: ["static", "dynamic"],
          description: "Container role to read logs from: static node or primary dynamic tenant node.",
        },
        lines: {
          type: "integer",
          minimum: 1,
          description: "Number of recent log lines to read. Defaults to 200.",
        },
      },
      additionalProperties: false,
    };
  }

• packages/mcp-server/src/tools/args.ts:8-11 (schema)

  The `LogsArgs` Zod schema (extends ProfileArgs) that validates parsed arguments: target enum and optional positive integer lines.

  export const LogsArgs = ProfileArgs.extend({
    target: z.enum(["static", "dynamic"]),
    lines: z.number().int().positive().optional(),
  });

• packages/mcp-server/src/tools/registry.ts:177-187 (registration)

  Registration of the 'local_ydb_container_logs' tool in the registry, mapping name, description, inputSchema (from logsSchema()), and handler (withContext wrapping containerLogs).

  defineTool({
    group: "checks",
    name: "local_ydb_container_logs",
    description:
      "Read recent Docker logs from the configured static or primary dynamic local-ydb container. Use when bootstrap, restart, or readiness checks fail; target selects the container role and lines controls the tail length.",
    inputSchema: logsSchema(),
    annotations: readOnlyAnnotations(),
    handler: withContext(LogsArgs, (context, parsed) =>
      containerLogs(context, parsed),
    ),
  }),

• packages/core/src/operations/checks.ts:107-114 (helper)

  The return object shape from containerLogs, including summary, ok flag, container name, command, stdout, and stderr.

  return {
    summary: result.ok ? `Read ${options.target} container logs.` : `Failed to read ${options.target} container logs.`,
    ok: result.ok,
    container,
    command: result.command,
    stdout: result.stdout,
    stderr: result.stderr
  };