@pecot/tools-mcp 0.0.0-stage → 1.0.1

package/cli/dist/mcp/tools/_shared.js

@@ -0,0 +1,290 @@
+// 全ツール共通の入出力スキーマと、許可リストのエントリを 1 本の実行手順へ通す処理。
+//
+// 系統別のツール定義（`mcp/tools/{sts,lambda,logs,sqs,athena,s3}.ts`）が宣言するのは、使うエントリと入力スキーマだけ。
+// 検証 → 実行前拒否 → 引数組み立て → awscli 起動 → 失敗種別判定 → 秘匿化 → 切り詰め、という手順はここに 1 本だけ置く。
+// 手順をツール側へ複製すると、秘匿化や上限の適用を忘れるおそれがある。
+/* eslint-disable @typescript-eslint/prefer-readonly-parameter-types -- call.signal は mutable なメンバを持つ。
+   readonly 化すると、SDK 側の型と適合しなくなる。 */
+import { z } from 'zod';
+import { PROFILE_PATTERN, REGION_PATTERN, } from '../../domain/allowlist.js';
+import { buildArguments, validateInput } from '../../domain/arguments.js';
+import { classifyFailure } from '../../domain/failure.js';
+import { redactSecrets } from '../../domain/redact.js';
+import { ensureAwscli, OUTPUT_LIMIT_BYTES, runAwscli } from '../../infra/awscli.js';
+import { limitOutput, toCallToolResult } from '../result.js';
+/**
+1 回の awscli 呼び出しに与える既定の制限時間。
+*/
+export const TOOL_TIMEOUT_MS = 120_000;
+// 終了コードの規約は、許可リストの呼び出しと SSO の呼び出しで同じ値を使う。
+// 応答を読む側が 1 つの表で解釈できるようにするため。SSO 側（tools/sso.ts）から参照するので export する。
+/**
+awscli を起動せずに拒否したときの終了コード（UsageError 相当）。
+*/
+export const PRE_EXECUTION_EXIT_CODE = 2;
+/**
+時間切れの終了コード（coreutils timeout の慣習）。
+*/
+export const TIMEOUT_EXIT_CODE = 124;
+/**
+コマンドが見つからないときの終了コード（シェルの慣習）。
+*/
+export const COMMAND_NOT_FOUND_EXIT_CODE = 127;
+/**
+終了コードを持たない失敗（シグナル終了等）の既定値。
+*/
+export const UNKNOWN_FAILURE_EXIT_CODE = 1;
+/**
+`profile` だけの入力。
+
+SSO の 2 件は region を取らない（contracts/mcp-tools.md §SSO 認証）。
+そのため共通入力から profile だけを切り出し、両方が同じ書式・同じ説明文を公開できるようにする。
+*/
+export const PROFILE_INPUT_SHAPE = {
+    profile: z.string().regex(PROFILE_PATTERN).optional()
+        .describe('AWS プロファイル名。未指定なら awscli の既定解決に従う'),
+};
+/**
+全ツール共通の任意入力。
+
+書式の定義は domain/allowlist.ts の PROFILE_PATTERN / REGION_PATTERN にある。
+ここはその定数をそのまま inputSchema へ載せる（契約書の共通規約を tools/list で見せるため）。
+値を書き写さないので、定義は 1 箇所のまま。書式違反はハンドラ到達前に入力検証エラーとなる。awscli は起動しない。
+*/
+export const COMMON_INPUT_SHAPE = {
+    ...PROFILE_INPUT_SHAPE,
+    region: z.string().regex(REGION_PATTERN).optional()
+        .describe('AWS リージョン（ap-northeast-1 等）。未指定なら awscli の既定解決に従う'),
+};
+/**
+クライアント側ページング（`--max-items` / `--starting-token`）を持つツールの入力。
+*/
+export const MAX_ITEMS_PAGINATION_SHAPE = {
+    max_items: z.number().int().min(1).optional().describe('1 回の応答に含める最大件数'),
+    starting_token: z.string().optional().describe('前回応答の nextToken。続きを取得する'),
+};
+/**
+API 固有ページング（`logs get-log-events`）を持つツールの入力。
+*/
+export const LIMIT_NEXT_TOKEN_PAGINATION_SHAPE = {
+    limit: z.number().int().min(1).max(10_000).optional().describe('取得するイベント数の上限（1〜10000）'),
+    next_token: z.string().optional().describe('前回応答の nextForwardToken / nextBackwardToken'),
+    start_from_head: z.boolean().default(false).describe('true なら古いイベントから返す'),
+};
+/**
+ExecutionResult と同形の outputSchema。全ツールで共有する。
+*/
+export const TOOL_OUTPUT_SCHEMA = z.object({
+    ok: z.boolean().describe('awscli の実行が成功したか'),
+    exitCode: z.number().describe('終了コード (0 = success、実行前拒否 2、時間切れ 124、未導入 127)'),
+    category: z.string().optional().describe('失敗種別（成功時は省略）'),
+    data: z.record(z.string(), z.unknown()).describe('awscli の JSON 出力、または行配列'),
+    artifacts: z.array(z.string()).describe('書き出したローカルファイルの絶対パス'),
+    message: z.string().describe('呼び出し元エージェント向けの 1 行サマリ'),
+    stderr: z.string().optional().describe('秘匿化済みの awscli stderr（失敗時のみ）'),
+});
+/**
+失敗種別ごとの再試行方法。message の後半に載せる。
+*/
+const FAILURE_HINTS = {
+    'not-allowed': '許可されていない操作です。公開しているツールの範囲で実行してください',
+    'invalid-input': '入力を修正して再実行してください',
+    'awscli-missing': 'awscli v2 (2.22 以上) を導入して PATH を通してください',
+    'auth-missing': '認証設定がありません。aws_sso_login を実行するか profile を指定してください',
+    'auth-expired': '認証の有効期限が切れています。aws_sso_login で再認証してください',
+    'permission-denied': '権限が不足しています。profile / role を確認してください',
+    'resource-not-found': '対象が見つかりません。名前・リージョンを確認してください',
+    'timeout': '時間切れです。取得範囲を狭めて再実行してください',
+    'other': 'awscli が失敗しました。stderr を確認してください',
+};
+/**
+出力が上限を超えたときの案内。
+*/
+const TRUNCATION_MESSAGE = `出力が上限 ${String(OUTPUT_LIMIT_BYTES)} バイトを超えたため先頭のみ返しました。`
+    + 'max_items を減らすか starting_token で分割して再取得してください';
+/**
+stderr が上限で切り詰められたときに message へ足す注記。
+*/
+const STDERR_TRUNCATION_NOTE = '（stderr は上限を超えたため先頭のみ載せています）';
+function isRecord(value) {
+    return value instanceof Object && !Array.isArray(value);
+}
+function commonOptions(arguments_) {
+    const profile = arguments_['profile'];
+    const region = arguments_['region'];
+    return {
+        ...((typeof profile === 'string') && { profile }),
+        ...((typeof region === 'string') && { region }),
+    };
+}
+function parseJsonOutput(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        // JSON として読めない出力（空・警告のみ等）は行配列へ落とす。
+        return undefined;
+    }
+}
+function toLines(text) {
+    const body = text.endsWith('\n') ? text.slice(0, -1) : text;
+    return body === '' ? [] : body.split('\n');
+}
+/**
+失敗種別と awscli の終了コードから応答の exitCode を決める。
+
+exitCode を持たない失敗（シグナル終了・awscli を起動していない SSO の状態遷移）は
+省略するか null で渡し、1 以上へ畳む。ok: false と exitCode 0 が同居しないようにする。
+*/
+export function resolveExitCode(category, exitCode) {
+    if (category === 'timeout')
+        return TIMEOUT_EXIT_CODE;
+    if (category === 'awscli-missing')
+        return COMMAND_NOT_FOUND_EXIT_CODE;
+    return exitCode ?? UNKNOWN_FAILURE_EXIT_CODE;
+}
+function failureMessage(toolName, category) {
+    // eslint-disable-next-line security/detect-object-injection -- category は FailureCategory の列挙値
+    return `${toolName} が失敗しました (${category})。${FAILURE_HINTS[category]}`;
+}
+/**
+成功時の data。JSON 出力はそのまま、非 JSON 出力は行配列にする。
+*/
+function successData(entry, stdout) {
+    const parsed = entry.jsonOutput ? parseJsonOutput(stdout) : undefined;
+    if (parsed === undefined)
+        return { lines: toLines(stdout) };
+    const nextToken = parsed['NextToken'];
+    return typeof nextToken === 'string' && entry.pagination === 'max-items' ? { ...parsed, nextToken } : parsed;
+}
+/**
+許可リストのエントリ 1 件を実行し、ExecutionResult を返す。
+
+検証で弾いた場合は awscli を起動しない（exitCode 2）。awscli の失敗は種別判定にかけ、
+応答へ載せる stdout / stderr は必ず秘匿化と上限を通す。
+*/
+export async function executeAllowlisted(entry, arguments_, call, options = {}) {
+    const invalid = validateInput(entry, arguments_);
+    if (invalid !== undefined) {
+        return {
+            ok: false,
+            exitCode: PRE_EXECUTION_EXIT_CODE,
+            category: invalid.category,
+            data: {},
+            artifacts: [],
+            message: invalid.message,
+        };
+    }
+    const rejected = options.reject?.(arguments_);
+    if (rejected !== undefined) {
+        return {
+            ok: false,
+            exitCode: PRE_EXECUTION_EXIT_CODE,
+            category: rejected.category,
+            data: {},
+            artifacts: [],
+            message: rejected.message,
+        };
+    }
+    const probe = await ensureAwscli();
+    if (!probe.ok) {
+        return {
+            ok: false,
+            exitCode: COMMAND_NOT_FOUND_EXIT_CODE,
+            category: probe.category,
+            data: {},
+            artifacts: [],
+            message: probe.message,
+        };
+    }
+    const result = await runAwscli(buildArguments(entry, arguments_, commonOptions(arguments_)), {
+        timeoutMs: options.timeoutMs ?? TOOL_TIMEOUT_MS,
+        signal: call.signal,
+    });
+    if (result.timedOut || result.exitCode !== 0) {
+        const category = classifyFailure({
+            exitCode: result.exitCode,
+            stderr: result.stderr,
+            timedOut: result.timedOut,
+            ...(result.spawnErrorCode !== undefined && { spawnErrorCode: result.spawnErrorCode }),
+        });
+        // 巨大な stderr は先頭だけを載せる。通知せず欠けると読み手が全文だと誤認するため、
+        // 切り詰めたことを message に残す。
+        const limitedStderr = limitOutput(redactSecrets(result.stderr));
+        return {
+            ok: false,
+            exitCode: resolveExitCode(category, result.exitCode),
+            category,
+            data: {},
+            artifacts: [],
+            message: failureMessage(entry.toolName, category)
+                + (limitedStderr.truncated ? STDERR_TRUNCATION_NOTE : ''),
+            stderr: limitedStderr.text,
+        };
+    }
+    // artifacts は切り詰めの有無に依らず載せる。書き出しは awscli 側で完了しており、
+    // 応答の切り詰めは「出力が長い」ことしか意味しないため。
+    const artifacts = options.artifactsOf?.(arguments_) ?? [];
+    const limited = limitOutput(redactSecrets(result.stdout));
+    if (limited.truncated) {
+        return {
+            ok: true,
+            exitCode: 0,
+            data: { output: limited.text, truncated: true },
+            artifacts,
+            message: TRUNCATION_MESSAGE,
+        };
+    }
+    return {
+        ok: true,
+        exitCode: 0,
+        data: successData(entry, limited.text),
+        artifacts,
+        message: `${entry.toolName} が成功しました`,
+    };
+}
+/**
+annotations を許可リストの kind から導く。
+
+契約表の「読取専用」列は read だけが true で、fetch（ローカルへ書き出す）と
+execute（Athena のクエリ起動）は false。destructiveHint は fetch だけ true にする:
+`overwrite: true` の呼び出しはローカルの既存ファイルを上書きして戻せない。
+openWorldHint は AWS API へ到達するので全件 true。
+
+契約書の共通規約も destructiveHint を fetch 2 件だけ true と定めており、ここはそれと一致する。
+*/
+function annotationsOf(entry) {
+    return {
+        readOnlyHint: entry.kind === 'read',
+        destructiveHint: entry.kind === 'fetch',
+        openWorldHint: true,
+    };
+}
+/**
+許可リストのエントリ 1 件を MCP ツール定義にする。
+
+入力の検証は 2 段になる。
+inputSchema（型・列挙・書式）は SDK がハンドラ到達前に見て、入力検証エラーを返す。
+許可リスト側の規則（先頭 '-'・排他・shorthand の構成要素）は、executeAllowlisted が見て isError の応答にする。ハンドラで再度 zod parse はしない
+（SDK が既に未知キーの除去と default の適用を済ませている）。
+*/
+export function allowlistedTool(spec, options = {}) {
+    const executeOptions = {
+        ...(options.timeoutMs !== undefined && { timeoutMs: options.timeoutMs }),
+        ...(spec.reject !== undefined && { reject: spec.reject }),
+        ...(spec.artifactsOf !== undefined && { artifactsOf: spec.artifactsOf }),
+    };
+    return {
+        name: spec.entry.toolName,
+        config: {
+            title: spec.title,
+            description: spec.description,
+            inputSchema: spec.inputSchema,
+            outputSchema: TOOL_OUTPUT_SCHEMA,
+            annotations: annotationsOf(spec.entry),
+        },
+        handler: async (arguments_, call) => toCallToolResult(await executeAllowlisted(spec.entry, arguments_, call, executeOptions)),
+    };
+}
+//# sourceMappingURL=_shared.js.map

package/cli/dist/mcp/tools/athena.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function athenaTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=athena.d.ts.map

package/cli/dist/mcp/tools/athena.js

@@ -0,0 +1,82 @@
+// Athena 系のツール定義。
+//
+// start-query-execution だけは許可リストの静的宣言でクエリ内容を縛れないため、
+// 実行前拒否（reject）で参照専用クエリ以外を落とす。
+import { z } from 'zod';
+import { ATHENA_GET_QUERY_EXECUTION, ATHENA_GET_QUERY_RESULTS, ATHENA_START_QUERY_EXECUTION, } from '../../domain/allowlist.js';
+import { classifyAthenaQuery } from '../../domain/athena-query.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+参照専用でないクエリを not-allowed で落とす。
+
+query_string が文字列でない場合は undefined を返し、必須入力の検証（invalid-input）へ委ねる。
+ここで別種別を返すと「必須入力の欠落」が「許可されていない操作」に化ける。
+*/
+function rejectNonReadOnlyQuery(arguments_) {
+    const query = arguments_['query_string'];
+    if (typeof query !== 'string')
+        return undefined;
+    const classified = classifyAthenaQuery(query);
+    return classified.allowed
+        ? undefined
+        : { category: 'not-allowed', message: classified.message };
+}
+/**
+catalog の単独指定を invalid-input で落とす。
+
+契約書は catalog を「database と併用」と定めている。
+組み立て自体は `--query-execution-context Catalog=…` を作れてしまう。
+ただし Database を欠いた QueryExecutionContext を実 Athena API が受けるかは未確認なので、契約の範囲へ寄せる。
+*/
+function rejectCatalogWithoutDatabase(arguments_) {
+    if ((typeof arguments_['catalog'] !== 'string') || (typeof arguments_['database'] === 'string'))
+        return undefined;
+    return {
+        category: 'invalid-input',
+        message: 'catalog は database と併せて指定してください',
+    };
+}
+/**
+start-query-execution の実行前拒否。クエリ内容 → catalog の順に見る。
+*/
+function rejectStartQueryExecution(arguments_) {
+    return rejectNonReadOnlyQuery(arguments_) ?? rejectCatalogWithoutDatabase(arguments_);
+}
+export function athenaTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: ATHENA_START_QUERY_EXECUTION,
+            title: 'クエリの実行開始',
+            description: '参照クエリ（SELECT / WITH / SHOW / DESCRIBE / EXPLAIN）の実行を開始し query_execution_id を返す。変更系と複数文は実行前に拒否する。結果は aws_athena_get_query_execution で完了を待ってから aws_athena_get_query_results で取る',
+            inputSchema: z.object({
+                query_string: z.string().describe('実行する参照クエリ。1 文だけを指定し、先頭は SELECT / WITH / SHOW / DESCRIBE / EXPLAIN のいずれかにする（括弧で囲まない）'),
+                work_group: z.string().optional().describe('ワークグループ名'),
+                database: z.string().optional().describe('既定のデータベース名'),
+                catalog: z.string().optional().describe('データカタログ名。database と併せて指定する（単独指定はしない）'),
+                output_location: z.string().optional().describe('結果の出力先（s3:// で始まる）'),
+                ...COMMON_INPUT_SHAPE,
+            }),
+            reject: rejectStartQueryExecution,
+        }, options),
+        allowlistedTool({
+            entry: ATHENA_GET_QUERY_EXECUTION,
+            title: 'クエリ実行状態の取得',
+            description: 'クエリ実行の状態（QUEUED / RUNNING / SUCCEEDED / FAILED / CANCELLED）と統計を返す',
+            inputSchema: z.object({
+                query_execution_id: z.string().describe('aws_athena_start_query_execution が返した ID'),
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: ATHENA_GET_QUERY_RESULTS,
+            title: 'クエリ結果の取得',
+            description: '完了したクエリの結果行を返す。件数が多い場合は max_items と starting_token で分割する',
+            inputSchema: z.object({
+                query_execution_id: z.string().describe('aws_athena_start_query_execution が返した ID'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=athena.js.map

package/cli/dist/mcp/tools/cloudwatch.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function cloudwatchTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=cloudwatch.d.ts.map

package/cli/dist/mcp/tools/cloudwatch.js

@@ -0,0 +1,46 @@
+// CloudWatch（メトリクス）系のツール定義。
+//
+// ログ系は logs.ts が持つ。こちらはメトリクスの統計取得だけを公開する。
+import { z } from 'zod';
+import { CLOUDWATCH_GET_METRIC_STATISTICS, CLOUDWATCH_UNIT_VALUES } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE } from './_shared.js';
+/**
+ディメンション 1 件。`z.object` は宣言外のキーを通知せず削るため strictObject を使う。
+JSON Schema では `items.additionalProperties: false` になり、SDK が入力検証エラーで拒否する。
+*/
+const DIMENSION_ELEMENT = z.strictObject({
+    name: z.string().describe('ディメンション名（QueueName・FunctionName 等）'),
+    value: z.string().describe('ディメンション値'),
+});
+/**
+取得できる統計値。パーセンタイル（ExtendedStatistics）は公開しない。
+*/
+const STATISTIC_ENUM = z.enum(['SampleCount', 'Average', 'Sum', 'Minimum', 'Maximum']);
+/**
+CloudWatch の標準単位。許可リストと同じ配列を読む（綴りの定義は allowlist.ts）。
+*/
+const UNIT_ENUM = z.enum(CLOUDWATCH_UNIT_VALUES);
+export function cloudwatchTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: CLOUDWATCH_GET_METRIC_STATISTICS,
+            title: 'メトリクス統計の取得',
+            description: 'メトリクス 1 本の統計値を期間指定で取得する。dimensions はメトリクス作成時と同じ組み合わせを全て指定しないと空の結果になる',
+            inputSchema: z.object({
+                namespace: z.string().describe('メトリクスの名前空間（AWS/SQS・AWS/Lambda 等）'),
+                metric_name: z.string().describe('メトリクス名（NumberOfMessagesSent 等）'),
+                dimensions: z.array(DIMENSION_ELEMENT).max(30).optional()
+                    .describe('絞り込むディメンション。メトリクスが持つ組み合わせを過不足なく指定する'),
+                start_time: z.string().describe('取得開始時刻。ISO 8601 形式で、タイムゾーン（Z か +09:00 形式）必須（2026-09-01T00:00:00Z / 2026-09-01T09:00:00+09:00）'),
+                end_time: z.string().describe('取得終了時刻。ISO 8601 形式で、タイムゾーン（Z か +09:00 形式）必須（start_time と同じ書式）'),
+                period: z.number().int().min(1).describe('集計間隔（秒）。60 の倍数で指定する'),
+                statistics: z.array(STATISTIC_ENUM).min(1).max(5)
+                    .describe('取得する統計値。1〜5 件を指定する'),
+                unit: UNIT_ENUM.optional()
+                    .describe('絞り込む単位。データの単位と一致しないと結果が空になる'),
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=cloudwatch.js.map

package/cli/dist/mcp/tools/ec2.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function ec2Tools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=ec2.d.ts.map

package/cli/dist/mcp/tools/ec2.js

@@ -0,0 +1,31 @@
+// EC2 系のツール定義。
+import { z } from 'zod';
+import { EC2_DESCRIBE_INSTANCES } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+絞り込み条件 1 件。`values` のいずれかに一致すれば対象になる。
+
+`z.object` は宣言外のキーを通知せず削るため strictObject を使う。
+JSON Schema では `items.additionalProperties: false` になり、SDK が入力検証エラーで拒否する。
+*/
+const FILTER_ELEMENT = z.strictObject({
+    name: z.string().describe('フィルタ名（instance-state-name・tag:Name 等）'),
+    values: z.array(z.string()).min(1).describe('いずれかに一致すれば対象になる値'),
+});
+const INSTANCE_IDS_INPUT = z.array(z.string()).min(1).optional().describe('取得するインスタンス ID（i-… の形式）');
+export function ec2Tools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: EC2_DESCRIBE_INSTANCES,
+            title: 'EC2 インスタンスの一覧',
+            description: 'インスタンスの状態・タイプ・タグ・ネットワーク構成を返す。出力が大きいので max_items か filters で絞る',
+            inputSchema: z.object({
+                instance_ids: INSTANCE_IDS_INPUT,
+                filters: z.array(FILTER_ELEMENT).optional().describe('絞り込み条件。複数指定すると全てに一致するものが返る'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=ec2.js.map

package/cli/dist/mcp/tools/ecr.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function ecrTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=ecr.d.ts.map

package/cli/dist/mcp/tools/ecr.js

@@ -0,0 +1,37 @@
+// ECR 系のツール定義。
+//
+// tag_status は awscli の `--filter tagStatus=<値>` へ合成する（許可リスト側の shorthand）。
+// 利用者に shorthand の文字列そのものを書かせないのは Athena と同じ理由。
+import { z } from 'zod';
+import { ECR_DESCRIBE_IMAGES } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+取得するイメージの指定 1 件。タグとダイジェストのどちらか一方だけでも指定できる。
+
+`z.object` は宣言外のキーを通知せず削るため strictObject を使う。
+JSON Schema では `items.additionalProperties: false` になり、SDK が入力検証エラーで拒否する。
+*/
+const IMAGE_ID_ELEMENT = z.strictObject({
+    image_tag: z.string().optional().describe('イメージタグ'),
+    image_digest: z.string().optional().describe('イメージダイジェスト（sha256:… の形式）'),
+});
+export function ecrTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: ECR_DESCRIBE_IMAGES,
+            title: 'コンテナイメージの一覧',
+            description: 'リポジトリ内のイメージのタグ・ダイジェスト・push 時刻を返す。デプロイ時刻の確認に使う。未指定時は ACTIVE のイメージのみが返る',
+            inputSchema: z.object({
+                repository_name: z.string().describe('リポジトリ名'),
+                registry_id: z.string().optional().describe('レジストリの AWS アカウント ID（12 桁）。未指定なら既定のレジストリ'),
+                image_ids: z.array(IMAGE_ID_ELEMENT).max(100).optional()
+                    .describe('取得するイメージの指定。要素ごとに image_tag と image_digest の少なくとも一方が必要。starting_token とは併用できない'),
+                tag_status: z.enum(['TAGGED', 'UNTAGGED', 'ANY']).optional()
+                    .describe('タグの有無で絞り込む。未指定なら絞り込まない'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=ecr.js.map

package/cli/dist/mcp/tools/index.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from '../server.js';
+import type { ToolOptions } from './_shared.js';
+/**
+tools/list に公開するツール。並びはそのまま tools/list の並びになる。
+*/
+export declare function allTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/mcp/tools/index.js

@@ -0,0 +1,37 @@
+// 公開するツールの集約。serve.ts が createMcpServer() へ渡す。
+//
+// 並びは contracts/mcp-tools.md の表の順で、そのまま tools/list の並びになる。SSO の 2 件は
+// 契約書で許可リストの表より前に置かれているため先頭に来る（許可リストには入らない）。
+// 系統別の関数へ分けているのは、1 系統を足すときに触るファイルを閉じるため。
+import { athenaTools } from './athena.js';
+import { cloudwatchTools } from './cloudwatch.js';
+import { ec2Tools } from './ec2.js';
+import { ecrTools } from './ecr.js';
+import { lambdaTools } from './lambda.js';
+import { logsTools } from './logs.js';
+import { rdsTools } from './rds.js';
+import { s3Tools } from './s3.js';
+import { schedulerTools } from './scheduler.js';
+import { sqsTools } from './sqs.js';
+import { ssoTools } from './sso.js';
+import { stsTools } from './sts.js';
+/**
+tools/list に公開するツール。並びはそのまま tools/list の並びになる。
+*/
+export function allTools(options = {}) {
+    return [
+        ...ssoTools(options),
+        ...stsTools(options),
+        ...lambdaTools(options),
+        ...logsTools(options),
+        ...cloudwatchTools(options),
+        ...sqsTools(options),
+        ...athenaTools(options),
+        ...s3Tools(options),
+        ...rdsTools(options),
+        ...schedulerTools(options),
+        ...ecrTools(options),
+        ...ec2Tools(options),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/mcp/tools/lambda.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function lambdaTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=lambda.d.ts.map

package/cli/dist/mcp/tools/lambda.js

@@ -0,0 +1,36 @@
+// Lambda 系のツール定義。
+import { z } from 'zod';
+import { LAMBDA_GET_FUNCTION_CONFIGURATION, LAMBDA_LIST_EVENT_SOURCE_MAPPINGS, LAMBDA_LIST_FUNCTIONS, } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+export function lambdaTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: LAMBDA_LIST_FUNCTIONS,
+            title: 'Lambda 関数の一覧',
+            description: 'リージョン内の Lambda 関数を一覧する。件数が多い場合は max_items と starting_token で分割する',
+            inputSchema: z.object({ ...MAX_ITEMS_PAGINATION_SHAPE, ...COMMON_INPUT_SHAPE }),
+        }, options),
+        allowlistedTool({
+            entry: LAMBDA_GET_FUNCTION_CONFIGURATION,
+            title: 'Lambda 関数の構成取得',
+            description: '関数 1 件の構成（ランタイム・ハンドラ・環境変数・タイムアウト等）を返す',
+            inputSchema: z.object({
+                function_name: z.string().describe('関数名・部分 ARN・完全 ARN のいずれか'),
+                qualifier: z.string().optional().describe('バージョン番号またはエイリアス名。未指定なら $LATEST'),
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: LAMBDA_LIST_EVENT_SOURCE_MAPPINGS,
+            title: 'イベントソースマッピングの一覧',
+            description: '関数とイベントソース（SQS キュー・DynamoDB ストリーム等）の対応を一覧する。event_source_arn と function_name のどちらでも絞れる',
+            inputSchema: z.object({
+                event_source_arn: z.string().optional().describe('イベントソースの ARN（arn: で始まる）'),
+                function_name: z.string().optional().describe('関数名・部分 ARN・完全 ARN のいずれか'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=lambda.js.map

package/cli/dist/mcp/tools/logs.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+export declare function logsTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=logs.d.ts.map