@pecot/tools-mcp 0.0.0-stage → 1.0.1

package/cli/dist/domain/allowlist.js

@@ -0,0 +1,657 @@
+// 許可リストの型と実体。公開する awscli コマンドは全てここで静的に宣言し、
+// ツール実装（mcp/tools/*）はこの宣言からしか引数を組み立てない。
+//
+// エントリの並びは contracts/mcp-tools.md の表の順で、そのまま tools/list の並びになる。
+// 系統ごとの配列に分けてから ALLOWLIST へ連結する（1 系統を足すときに触る範囲が閉じる）。
+/**
+`profile` の書式。data-model.md の `^[A-Za-z0-9_.-]+$` と同値（`\w` = `[A-Za-z0-9_]`）。
+
+inputSchema へ載せる mcp 層も同じ定数を読む。書式の定義をここ 1 箇所に保つため。
+*/
+export const PROFILE_PATTERN = /^[\w.-]+$/;
+/**
+`region` の書式（`ap-northeast-1` 等）。
+
+先頭は 2〜4 文字。European Sovereign Cloud の `eusc-de-east-1` が 4 文字始まりで、
+2 文字固定だと入力検証エラーで弾かれる。
+契約書の共通規約も `^[a-z]{2,4}(-[a-z]+)+-\d$` で、本パターンと一致している。
+契約書は specs/012-awscli-mcp-server/contracts/mcp-tools.md を指す。
+*/
+// eslint-disable-next-line security/detect-unsafe-regex -- 繰り返し部の先頭 '-' は内側の文字クラスに無く backtracking しない
+export const REGION_PATTERN = /^[a-z]{2,4}(?:-[a-z]+)+-\d$/;
+/**
+ISO 8601 の日時（`2026-09-01T00:00Z` / `2026-09-01T00:00:00.000+09:00`）。
+
+CloudWatch と RDS の timestamp 引数はこの書式で渡す。CloudWatch Logs 系の epoch ミリ秒
+（integer）とは型が異なるので、契約と description にも「ISO 8601」と明記している。
+`Z` とオフセット付きの双方を awscli 2.36.40 が正しく変換することを動作確認済み。
+*/
+// eslint-disable-next-line security/detect-unsafe-regex -- 任意の繰り返しは `(?:\.\d+)?` の 1 段だけ。直前が固定文字 '.' で、直後は Z かオフセットの固定長。入れ子が無く backtracking しない
+export const TIMESTAMP_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2})$/;
+/**
+全エントリ共通の任意入力 `profile`。
+*/
+export const PROFILE_INPUT = {
+    name: 'profile',
+    kind: 'string',
+    required: false,
+    awsFlag: '--profile',
+    pattern: PROFILE_PATTERN,
+};
+/**
+全エントリ共通の任意入力 `region`。
+*/
+export const REGION_INPUT = {
+    name: 'region',
+    kind: 'string',
+    required: false,
+    awsFlag: '--region',
+    pattern: REGION_PATTERN,
+};
+/**
+ページング列が `max-items` のエントリが共通で持つ入力（契約の共通規約）。
+*/
+const MAX_ITEMS_INPUTS = [
+    { name: 'max_items', kind: 'integer', required: false, awsFlag: '--max-items', min: 1 },
+    { name: 'starting_token', kind: 'string', required: false, awsFlag: '--starting-token' },
+];
+export const STS_GET_CALLER_IDENTITY = {
+    toolName: 'aws_sts_get_caller_identity',
+    service: 'sts',
+    subcommand: 'get-caller-identity',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [],
+};
+const STS_ENTRIES = [STS_GET_CALLER_IDENTITY];
+export const LAMBDA_LIST_FUNCTIONS = {
+    toolName: 'aws_lambda_list_functions',
+    service: 'lambda',
+    subcommand: 'list-functions',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [...MAX_ITEMS_INPUTS],
+};
+export const LAMBDA_GET_FUNCTION_CONFIGURATION = {
+    toolName: 'aws_lambda_get_function_configuration',
+    service: 'lambda',
+    subcommand: 'get-function-configuration',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'function_name', kind: 'string', required: true, awsFlag: '--function-name' },
+        { name: 'qualifier', kind: 'string', required: false, awsFlag: '--qualifier' },
+    ],
+};
+/**
+`lambda list-event-source-mappings`。
+
+関数とイベントソース（SQS キュー等）の対応を引くために使う。`--event-source-arn` と
+`--function-name` は、片方だけでも両方でも指定できる。
+*/
+export const LAMBDA_LIST_EVENT_SOURCE_MAPPINGS = {
+    toolName: 'aws_lambda_list_event_source_mappings',
+    service: 'lambda',
+    subcommand: 'list-event-source-mappings',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        {
+            name: 'event_source_arn',
+            kind: 'string',
+            required: false,
+            awsFlag: '--event-source-arn',
+            pattern: /^arn:/,
+        },
+        { name: 'function_name', kind: 'string', required: false, awsFlag: '--function-name' },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+const LAMBDA_ENTRIES = [
+    LAMBDA_LIST_FUNCTIONS,
+    LAMBDA_GET_FUNCTION_CONFIGURATION,
+    LAMBDA_LIST_EVENT_SOURCE_MAPPINGS,
+];
+export const LOGS_DESCRIBE_LOG_GROUPS = {
+    toolName: 'aws_logs_describe_log_groups',
+    service: 'logs',
+    subcommand: 'describe-log-groups',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'log_group_name_prefix', kind: 'string', required: false, awsFlag: '--log-group-name-prefix' },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+export const LOGS_DESCRIBE_LOG_STREAMS = {
+    toolName: 'aws_logs_describe_log_streams',
+    service: 'logs',
+    subcommand: 'describe-log-streams',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'log_group_name', kind: 'string', required: true, awsFlag: '--log-group-name' },
+        { name: 'log_stream_name_prefix', kind: 'string', required: false, awsFlag: '--log-stream-name-prefix' },
+        {
+            name: 'order_by',
+            kind: 'enum',
+            required: false,
+            awsFlag: '--order-by',
+            values: ['LogStreamName', 'LastEventTime'],
+        },
+        { name: 'descending', kind: 'boolean', required: false, awsFlag: '--descending', default: false },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+export const LOGS_GET_LOG_EVENTS = {
+    toolName: 'aws_logs_get_log_events',
+    service: 'logs',
+    subcommand: 'get-log-events',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'limit-next-token',
+    inputs: [
+        { name: 'log_group_name', kind: 'string', required: true, awsFlag: '--log-group-name' },
+        { name: 'log_stream_name', kind: 'string', required: true, awsFlag: '--log-stream-name' },
+        { name: 'start_time', kind: 'integer', required: false, awsFlag: '--start-time' },
+        { name: 'end_time', kind: 'integer', required: false, awsFlag: '--end-time' },
+        { name: 'limit', kind: 'integer', required: false, awsFlag: '--limit', min: 1, max: 10_000 },
+        { name: 'next_token', kind: 'string', required: false, awsFlag: '--next-token' },
+        { name: 'start_from_head', kind: 'boolean', required: false, awsFlag: '--start-from-head', default: false },
+    ],
+};
+export const LOGS_FILTER_LOG_EVENTS = {
+    toolName: 'aws_logs_filter_log_events',
+    service: 'logs',
+    subcommand: 'filter-log-events',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'log_group_name', kind: 'string', required: true, awsFlag: '--log-group-name' },
+        { name: 'log_stream_names', kind: 'string-list', required: false, awsFlag: '--log-stream-names' },
+        { name: 'log_stream_name_prefix', kind: 'string', required: false, awsFlag: '--log-stream-name-prefix' },
+        { name: 'filter_pattern', kind: 'string', required: false, awsFlag: '--filter-pattern' },
+        { name: 'start_time', kind: 'integer', required: false, awsFlag: '--start-time' },
+        { name: 'end_time', kind: 'integer', required: false, awsFlag: '--end-time' },
+        ...MAX_ITEMS_INPUTS,
+    ],
+    exclusive: [['log_stream_names', 'log_stream_name_prefix']],
+};
+const LOGS_ENTRIES = [
+    LOGS_DESCRIBE_LOG_GROUPS,
+    LOGS_DESCRIBE_LOG_STREAMS,
+    LOGS_GET_LOG_EVENTS,
+    LOGS_FILTER_LOG_EVENTS,
+];
+/**
+CloudWatch の標準単位（`--unit` の候補。awscli 2.36.40）。
+
+許可リストの `values` と mcp 層の `z.enum`、契約テストが同じ配列を読む。3 箇所に写すと
+綴りがずれるので定義をここ 1 箇所に置く。`z.enum` は非空タプルを要求するため型注釈を付ける。
+*/
+export const CLOUDWATCH_UNIT_VALUES = [
+    'Seconds', 'Microseconds', 'Milliseconds',
+    'Bytes', 'Kilobytes', 'Megabytes', 'Gigabytes', 'Terabytes',
+    'Bits', 'Kilobits', 'Megabits', 'Gigabits', 'Terabits',
+    'Percent', 'Count',
+    'Bytes/Second', 'Kilobytes/Second', 'Megabytes/Second', 'Gigabytes/Second',
+    'Terabytes/Second',
+    'Bits/Second', 'Kilobits/Second', 'Megabits/Second', 'Gigabits/Second',
+    'Terabits/Second',
+    'Count/Second', 'None',
+];
+/**
+`cloudwatch get-metric-statistics`。
+
+`--statistics` を必須にすることで `--extended-statistics`（パーセンタイル）を公開しない形に
+閉じている。API は双方の同時指定を拒否するため、片方だけを公開すれば足りる。
+*/
+export const CLOUDWATCH_GET_METRIC_STATISTICS = {
+    toolName: 'aws_cloudwatch_get_metric_statistics',
+    service: 'cloudwatch',
+    subcommand: 'get-metric-statistics',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'namespace', kind: 'string', required: true, awsFlag: '--namespace' },
+        { name: 'metric_name', kind: 'string', required: true, awsFlag: '--metric-name' },
+        {
+            name: 'dimensions',
+            kind: 'shorthand-list',
+            required: false,
+            awsFlag: '--dimensions',
+            elements: [{ key: 'Name', field: 'name' }, { key: 'Value', field: 'value' }],
+        },
+        {
+            name: 'start_time',
+            kind: 'string',
+            required: true,
+            awsFlag: '--start-time',
+            pattern: TIMESTAMP_PATTERN,
+        },
+        {
+            name: 'end_time',
+            kind: 'string',
+            required: true,
+            awsFlag: '--end-time',
+            pattern: TIMESTAMP_PATTERN,
+        },
+        { name: 'period', kind: 'integer', required: true, awsFlag: '--period', min: 1 },
+        {
+            name: 'statistics',
+            kind: 'string-list',
+            required: true,
+            awsFlag: '--statistics',
+            values: ['SampleCount', 'Average', 'Sum', 'Minimum', 'Maximum'],
+        },
+        {
+            name: 'unit',
+            kind: 'enum',
+            required: false,
+            awsFlag: '--unit',
+            values: CLOUDWATCH_UNIT_VALUES,
+        },
+    ],
+};
+const CLOUDWATCH_ENTRIES = [CLOUDWATCH_GET_METRIC_STATISTICS];
+export const SQS_LIST_QUEUES = {
+    toolName: 'aws_sqs_list_queues',
+    service: 'sqs',
+    subcommand: 'list-queues',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'queue_name_prefix', kind: 'string', required: false, awsFlag: '--queue-name-prefix' },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+export const SQS_GET_QUEUE_ATTRIBUTES = {
+    toolName: 'aws_sqs_get_queue_attributes',
+    service: 'sqs',
+    subcommand: 'get-queue-attributes',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'queue_url', kind: 'string', required: true, awsFlag: '--queue-url', pattern: /^https:\/\// },
+        {
+            name: 'attribute_names',
+            kind: 'string-list',
+            required: false,
+            awsFlag: '--attribute-names',
+            default: ['All'],
+        },
+    ],
+};
+const SQS_ENTRIES = [SQS_LIST_QUEUES, SQS_GET_QUEUE_ATTRIBUTES];
+/**
+`athena start-query-execution`。
+
+`database` / `catalog` / `output_location` は検証だけに使う。
+awscli へは shorthand の `--query-execution-context` / `--result-configuration` として渡す。利用者に shorthand の
+文字列そのものを書かせると契約外のキー（`ExpectedBucketOwner` 等）を混ぜられるため、
+組み立てはここの宣言に閉じる。
+*/
+export const ATHENA_START_QUERY_EXECUTION = {
+    toolName: 'aws_athena_start_query_execution',
+    service: 'athena',
+    subcommand: 'start-query-execution',
+    kind: 'execute',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'query_string', kind: 'string', required: true, awsFlag: '--query-string' },
+        { name: 'work_group', kind: 'string', required: false, awsFlag: '--work-group' },
+        { name: 'database', kind: 'string', required: false },
+        { name: 'catalog', kind: 'string', required: false },
+        { name: 'output_location', kind: 'string', required: false, pattern: /^s3:\/\// },
+        {
+            name: 'query_execution_context',
+            kind: 'shorthand',
+            required: false,
+            awsFlag: '--query-execution-context',
+            parts: [{ key: 'Database', from: 'database' }, { key: 'Catalog', from: 'catalog' }],
+        },
+        {
+            name: 'result_configuration',
+            kind: 'shorthand',
+            required: false,
+            awsFlag: '--result-configuration',
+            parts: [{ key: 'OutputLocation', from: 'output_location' }],
+        },
+    ],
+};
+export const ATHENA_GET_QUERY_EXECUTION = {
+    toolName: 'aws_athena_get_query_execution',
+    service: 'athena',
+    subcommand: 'get-query-execution',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'query_execution_id', kind: 'string', required: true, awsFlag: '--query-execution-id' },
+    ],
+};
+export const ATHENA_GET_QUERY_RESULTS = {
+    toolName: 'aws_athena_get_query_results',
+    service: 'athena',
+    subcommand: 'get-query-results',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'query_execution_id', kind: 'string', required: true, awsFlag: '--query-execution-id' },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+const ATHENA_ENTRIES = [
+    ATHENA_START_QUERY_EXECUTION,
+    ATHENA_GET_QUERY_EXECUTION,
+    ATHENA_GET_QUERY_RESULTS,
+];
+/**
+`s3 ls`。高レベルコマンドで JSON 出力を持たないため jsonOutput は false。
+*/
+export const S3_LS = {
+    toolName: 'aws_s3_ls',
+    service: 's3',
+    subcommand: 'ls',
+    kind: 'read',
+    jsonOutput: false,
+    pagination: 'none',
+    inputs: [
+        { name: 's3_uri', kind: 's3-list-uri', required: false, positional: 0 },
+    ],
+};
+/**
+`s3 cp <s3_uri> <local_path>`。
+
+入力は「取得元は S3、書き出し先はローカル」の 2 項目に固定されている。
+そのため、アップロード方向は検証で弾くまでもなく表現できない（research R7）。
+*/
+export const S3_CP = {
+    toolName: 'aws_s3_cp',
+    service: 's3',
+    subcommand: 'cp',
+    kind: 'fetch',
+    jsonOutput: false,
+    pagination: 'none',
+    inputs: [
+        { name: 's3_uri', kind: 's3-uri', required: true, positional: 0 },
+        { name: 'local_path', kind: 'abs-path', required: true, positional: 1 },
+        { name: 'overwrite', kind: 'boolean', required: false, default: false },
+    ],
+};
+export const S3API_GET_OBJECT = {
+    toolName: 'aws_s3api_get_object',
+    service: 's3api',
+    subcommand: 'get-object',
+    kind: 'fetch',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'bucket', kind: 'string', required: true, awsFlag: '--bucket' },
+        { name: 'key', kind: 'string', required: true, awsFlag: '--key' },
+        { name: 'outfile', kind: 'abs-path', required: true, positional: 0 },
+        { name: 'version_id', kind: 'string', required: false, awsFlag: '--version-id' },
+        { name: 'range', kind: 'string', required: false, awsFlag: '--range', pattern: /^bytes=/ },
+        { name: 'overwrite', kind: 'boolean', required: false, default: false },
+    ],
+};
+const S3_ENTRIES = [S3_LS, S3_CP, S3API_GET_OBJECT];
+/**
+イベントを引ける発生元の種別（`--source-type` の候補。awscli 2.36.40）。
+
+許可リストの `values` と mcp 層の `z.enum`、契約テストが同じ配列を読む（`CLOUDWATCH_UNIT_VALUES`
+と同型）。
+*/
+export const RDS_SOURCE_TYPE_VALUES = [
+    'db-instance', 'db-parameter-group', 'db-security-group', 'db-snapshot',
+    'db-cluster', 'db-cluster-snapshot', 'custom-engine-version', 'db-proxy',
+    'blue-green-deployment', 'db-shard-group', 'zero-etl',
+];
+/**
+`rds describe-events`。
+
+DB の停止・フェイルオーバー等のイベント履歴を引く。`--filters` は公開しない
+（API が受ける属性は版で動くので、契約に固定できる範囲へ絞る）。
+
+`duration`（現在から遡る分数）は `start_time` / `end_time` と意味が重なるので排他にする。
+*/
+export const RDS_DESCRIBE_EVENTS = {
+    toolName: 'aws_rds_describe_events',
+    service: 'rds',
+    subcommand: 'describe-events',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'source_identifier', kind: 'string', required: false, awsFlag: '--source-identifier' },
+        {
+            name: 'source_type',
+            kind: 'enum',
+            required: false,
+            awsFlag: '--source-type',
+            values: RDS_SOURCE_TYPE_VALUES,
+        },
+        {
+            name: 'start_time',
+            kind: 'string',
+            required: false,
+            awsFlag: '--start-time',
+            pattern: TIMESTAMP_PATTERN,
+        },
+        {
+            name: 'end_time',
+            kind: 'string',
+            required: false,
+            awsFlag: '--end-time',
+            pattern: TIMESTAMP_PATTERN,
+        },
+        { name: 'duration', kind: 'integer', required: false, awsFlag: '--duration', min: 1 },
+        {
+            name: 'event_categories',
+            kind: 'string-list',
+            required: false,
+            awsFlag: '--event-categories',
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+    exclusive: [['start_time', 'duration'], ['end_time', 'duration']],
+};
+export const RDS_DESCRIBE_DB_CLUSTERS = {
+    toolName: 'aws_rds_describe_db_clusters',
+    service: 'rds',
+    subcommand: 'describe-db-clusters',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        {
+            name: 'db_cluster_identifier',
+            kind: 'string',
+            required: false,
+            awsFlag: '--db-cluster-identifier',
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+export const RDS_DESCRIBE_DB_INSTANCES = {
+    toolName: 'aws_rds_describe_db_instances',
+    service: 'rds',
+    subcommand: 'describe-db-instances',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        {
+            name: 'db_instance_identifier',
+            kind: 'string',
+            required: false,
+            awsFlag: '--db-instance-identifier',
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+const RDS_ENTRIES = [
+    RDS_DESCRIBE_EVENTS,
+    RDS_DESCRIBE_DB_CLUSTERS,
+    RDS_DESCRIBE_DB_INSTANCES,
+];
+export const SCHEDULER_LIST_SCHEDULES = {
+    toolName: 'aws_scheduler_list_schedules',
+    service: 'scheduler',
+    subcommand: 'list-schedules',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'group_name', kind: 'string', required: false, awsFlag: '--group-name' },
+        { name: 'name_prefix', kind: 'string', required: false, awsFlag: '--name-prefix' },
+        {
+            name: 'state',
+            kind: 'enum',
+            required: false,
+            awsFlag: '--state',
+            values: ['ENABLED', 'DISABLED'],
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+export const SCHEDULER_GET_SCHEDULE = {
+    toolName: 'aws_scheduler_get_schedule',
+    service: 'scheduler',
+    subcommand: 'get-schedule',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'none',
+    inputs: [
+        { name: 'name', kind: 'string', required: true, awsFlag: '--name' },
+        { name: 'group_name', kind: 'string', required: false, awsFlag: '--group-name' },
+    ],
+};
+const SCHEDULER_ENTRIES = [
+    SCHEDULER_LIST_SCHEDULES,
+    SCHEDULER_GET_SCHEDULE,
+];
+/**
+`ecr describe-images`。
+
+`tag_status` は awsFlag を持たない。shorthand の `--filter tagStatus=<値>` へ合成する
+（Athena の `query_execution_context` と同型）。`--filter` の `imageStatus` は公開しない
+ため、未指定時は API 既定の ACTIVE のイメージだけが返る。
+
+`image_ids` と `starting_token` は排他。ECR の API が `imageIds` 指定時に `nextToken` を
+受け付けない（botocore のサービスモデル）ため、構文としては通っても実行できない。
+*/
+export const ECR_DESCRIBE_IMAGES = {
+    toolName: 'aws_ecr_describe_images',
+    service: 'ecr',
+    subcommand: 'describe-images',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        { name: 'repository_name', kind: 'string', required: true, awsFlag: '--repository-name' },
+        {
+            name: 'registry_id',
+            kind: 'string',
+            required: false,
+            awsFlag: '--registry-id',
+            pattern: /^\d{12}$/,
+        },
+        {
+            name: 'image_ids',
+            kind: 'shorthand-list',
+            required: false,
+            awsFlag: '--image-ids',
+            elements: [
+                { key: 'imageTag', field: 'image_tag' },
+                { key: 'imageDigest', field: 'image_digest' },
+            ],
+        },
+        {
+            name: 'tag_status',
+            kind: 'enum',
+            required: false,
+            values: ['TAGGED', 'UNTAGGED', 'ANY'],
+        },
+        {
+            name: 'filter',
+            kind: 'shorthand',
+            required: false,
+            awsFlag: '--filter',
+            parts: [{ key: 'tagStatus', from: 'tag_status' }],
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+    exclusive: [['image_ids', 'starting_token']],
+};
+const ECR_ENTRIES = [ECR_DESCRIBE_IMAGES];
+/**
+`ec2 describe-instances`。
+
+応答が大きくなりやすいので、description で max_items か filters による絞り込みを促している。
+`--dry-run` と `--include-managed-resources` は公開しない。
+*/
+export const EC2_DESCRIBE_INSTANCES = {
+    toolName: 'aws_ec2_describe_instances',
+    service: 'ec2',
+    subcommand: 'describe-instances',
+    kind: 'read',
+    jsonOutput: true,
+    pagination: 'max-items',
+    inputs: [
+        {
+            name: 'instance_ids',
+            kind: 'string-list',
+            required: false,
+            awsFlag: '--instance-ids',
+            pattern: /^i-[0-9a-f]+$/,
+        },
+        {
+            name: 'filters',
+            kind: 'shorthand-list',
+            required: false,
+            awsFlag: '--filters',
+            elements: [
+                { key: 'Name', field: 'name' },
+                { key: 'Values', field: 'values', list: true },
+            ],
+        },
+        ...MAX_ITEMS_INPUTS,
+    ],
+};
+const EC2_ENTRIES = [EC2_DESCRIBE_INSTANCES];
+/**
+公開するエントリの一覧。並びは契約表の順で、tools/list の並びもこれに従う。
+*/
+export const ALLOWLIST = [
+    ...STS_ENTRIES,
+    ...LAMBDA_ENTRIES,
+    ...LOGS_ENTRIES,
+    ...CLOUDWATCH_ENTRIES,
+    ...SQS_ENTRIES,
+    ...ATHENA_ENTRIES,
+    ...S3_ENTRIES,
+    ...RDS_ENTRIES,
+    ...SCHEDULER_ENTRIES,
+    ...ECR_ENTRIES,
+    ...EC2_ENTRIES,
+];
+/**
+ツール名からエントリを引く。見つからなければ undefined（呼び出し側が not-allowed にする）。
+*/
+export function findAllowlistEntry(toolName, entries = ALLOWLIST) {
+    return entries.find(entry => entry.toolName === toolName);
+}
+//# sourceMappingURL=allowlist.js.map

package/cli/dist/domain/arguments.d.ts

@@ -0,0 +1,37 @@
+import { type AllowlistEntry } from './allowlist.js';
+/**
+検証で弾いたときの戻り値。awscli は起動しない。
+*/
+export interface InvalidInput {
+    readonly category: 'invalid-input';
+    readonly message: string;
+}
+/**
+全エントリ共通の任意入力。指定時のみ awscli へ付与する。
+*/
+export interface CommonOptions {
+    readonly profile?: string;
+    readonly region?: string;
+}
+/**
+入力を検証する。問題があれば invalid-input を、無ければ undefined を返す。
+
+profile / region も同じ処理で検証する（別扱いにすると書式検証が抜ける）。
+*/
+export declare function validateInput(entry: Readonly<AllowlistEntry>, input: Readonly<Record<string, unknown>>): InvalidInput | undefined;
+/**
+awscli へ渡す引数配列を組み立てる。
+
+並びは `<service> <subcommand> <位置引数…> <フラグ…> --output json --no-cli-pager
+--profile <p> --region <r>`。位置引数を先・フラグを後に置くと、string-list（nargs が貪欲）と
+位置引数が同居しても awscli v2 の argparse が取り違えない（動作確認済み）。
+
+`--no-cli-pager` は jsonOutput の有無に依らず常に付ける（非 tty では無害で、分岐を持たない方が単純）。
+
+`--profile` / `--region` は末尾で 1 度だけ付ける。エントリ側が inputs に同名を宣言していても
+フラグ列挙では飛ばす。
+
+値が '-' で始まる string は `--flag=value` の 1 トークンにする（flagTokens）。
+*/
+export declare function buildArguments(entry: Readonly<AllowlistEntry>, input: Readonly<Record<string, unknown>>, common?: Readonly<CommonOptions>): string[];
+//# sourceMappingURL=arguments.d.ts.map