@pecot/tools-mcp 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,74 @@
+// CloudWatch Logs 系のツール定義。
+import { z } from 'zod';
+import { LOGS_DESCRIBE_LOG_GROUPS, LOGS_DESCRIBE_LOG_STREAMS, LOGS_FILTER_LOG_EVENTS, LOGS_GET_LOG_EVENTS, } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, LIMIT_NEXT_TOKEN_PAGINATION_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+並び順の指定。既定は昇順（false）。
+*/
+const DESCENDING_INPUT = z.boolean().default(false).describe('true なら降順に並べる');
+/**
+検索対象のログストリーム名の一覧。
+*/
+const LOG_STREAM_NAMES_INPUT = z.array(z.string()).optional()
+    .describe('検索対象のログストリーム名。log_stream_name_prefix とは併用できない');
+/**
+期間の絞り込み。epoch ミリ秒で、両ツールとも同じ意味を持つ。
+*/
+const TIME_RANGE_SHAPE = {
+    start_time: z.number().int().optional().describe('取得開始時刻（UNIX epoch ミリ秒）'),
+    end_time: z.number().int().optional().describe('取得終了時刻（UNIX epoch ミリ秒）'),
+};
+export function logsTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: LOGS_DESCRIBE_LOG_GROUPS,
+            title: 'ロググループの一覧',
+            description: 'CloudWatch Logs のロググループを一覧する。log_group_name_prefix で前方一致に絞れる',
+            inputSchema: z.object({
+                log_group_name_prefix: z.string().optional().describe('ロググループ名の前方一致'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: LOGS_DESCRIBE_LOG_STREAMS,
+            title: 'ログストリームの一覧',
+            description: 'ロググループ内のログストリームを一覧する。最新のストリームを探すには order_by に LastEventTime を指定して descending を true にする',
+            inputSchema: z.object({
+                log_group_name: z.string().describe('対象のロググループ名'),
+                log_stream_name_prefix: z.string().optional().describe('ログストリーム名の前方一致'),
+                order_by: z.enum(['LogStreamName', 'LastEventTime']).optional().describe('並び替えの基準'),
+                descending: DESCENDING_INPUT,
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: LOGS_GET_LOG_EVENTS,
+            title: 'ログイベントの取得',
+            description: 'ログストリーム 1 本のイベントを取得する。続きは応答の nextForwardToken を next_token に渡す',
+            inputSchema: z.object({
+                log_group_name: z.string().describe('対象のロググループ名'),
+                log_stream_name: z.string().describe('対象のログストリーム名'),
+                ...TIME_RANGE_SHAPE,
+                ...LIMIT_NEXT_TOKEN_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: LOGS_FILTER_LOG_EVENTS,
+            title: 'ログイベントの検索',
+            description: 'ロググループ横断でログイベントを検索する。log_stream_names と log_stream_name_prefix は同時に指定できない',
+            inputSchema: z.object({
+                log_group_name: z.string().describe('対象のロググループ名'),
+                log_stream_names: LOG_STREAM_NAMES_INPUT,
+                log_stream_name_prefix: z.string().optional().describe('検索対象のログストリーム名の前方一致。log_stream_names とは併用できない'),
+                filter_pattern: z.string().optional().describe('CloudWatch Logs のフィルタパターン'),
+                ...TIME_RANGE_SHAPE,
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=logs.js.map

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

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

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

@@ -0,0 +1,60 @@
+// RDS 系のツール定義。
+//
+// 3 件とも `--filters` は公開しない。API が受ける属性はバージョンで変わるため、契約に固定できる
+// 引数だけに絞っている。
+import { z } from 'zod';
+import { RDS_DESCRIBE_DB_CLUSTERS, RDS_DESCRIBE_DB_INSTANCES, RDS_DESCRIBE_EVENTS, RDS_SOURCE_TYPE_VALUES, } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+イベントを引ける発生元の種別。許可リストと同じ配列を読む（綴りの定義元は allowlist.ts）。
+*/
+const SOURCE_TYPE_ENUM = z.enum(RDS_SOURCE_TYPE_VALUES);
+/**
+絞り込むイベントカテゴリ。
+*/
+const EVENT_CATEGORIES_INPUT = z.array(z.string()).min(1).optional()
+    .describe('絞り込むイベントカテゴリ（availability・failover 等）');
+export function rdsTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: RDS_DESCRIBE_EVENTS,
+            title: 'RDS イベントの取得',
+            description: 'DB インスタンス・クラスタのイベント履歴（停止・起動・フェイルオーバー等）を返す。指定しない場合は直近 1 時間ぶんで、保持期間は 14 日',
+            inputSchema: z.object({
+                source_identifier: z.string().optional()
+                    .describe('イベントの発生元の識別子。指定するときは source_type も併せて指定する'),
+                source_type: SOURCE_TYPE_ENUM.optional().describe('イベントの発生元の種別'),
+                start_time: z.string().optional()
+                    .describe('取得開始時刻。ISO 8601 形式で、タイムゾーン（Z か +09:00 形式）必須（2026-09-01T00:00:00Z / 2026-09-01T09:00:00+09:00）'),
+                end_time: z.string().optional()
+                    .describe('取得終了時刻。ISO 8601 形式で、タイムゾーン（Z か +09:00 形式）必須（start_time と同じ書式）'),
+                duration: z.number().int().min(1).optional()
+                    .describe('現在から遡る分数。start_time / end_time とは併用できない'),
+                event_categories: EVENT_CATEGORIES_INPUT,
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: RDS_DESCRIBE_DB_CLUSTERS,
+            title: 'DB クラスタの一覧',
+            description: 'Aurora / Multi-AZ DB クラスタの構成と状態を返す。db_cluster_identifier で 1 本に絞れる',
+            inputSchema: z.object({
+                db_cluster_identifier: z.string().optional().describe('クラスタ識別子または ARN。未指定なら全件'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: RDS_DESCRIBE_DB_INSTANCES,
+            title: 'DB インスタンスの一覧',
+            description: 'DB インスタンスの構成と状態（DBInstanceStatus・エンドポイント等）を返す。db_instance_identifier で 1 台に絞れる',
+            inputSchema: z.object({
+                db_instance_identifier: z.string().optional().describe('インスタンス識別子または ARN。未指定なら全件'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=rds.js.map

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

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

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

@@ -0,0 +1,96 @@
+// S3 系のツール定義。
+//
+// 取得方向（S3 → ローカル）は入力の型で固定されており、逆方向は表現できない（research R7）。
+// 残る上書き規則だけを実行前拒否（reject）で見て、書き出し先を artifacts に載せる。
+import { z } from 'zod';
+import { S3API_GET_OBJECT, S3_CP, S3_LS } from '../../domain/allowlist.js';
+import { doesFileExist, isDirectory } from '../../infra/local-file.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, } from './_shared.js';
+function targetOf(arguments_, name) {
+    // eslint-disable-next-line security/detect-object-injection -- name は本ファイルの TargetName リテラル 2 値のみ
+    const value = arguments_[name];
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+書き出し先を実行前に見る（research R7 の Edge Case）。
+
+ディレクトリは overwrite に依らず拒否する。
+`aws s3 cp s3://b/k /dir` は `/dir/k` を書く。
+「上書きするなら overwrite に true を」の案内どおりに再実行しても、artifacts に載る書き出し先（`/dir`）と実体がずれたまま成功してしまう。
+
+既存ファイルは overwrite が無ければ拒否する。書き出し先が未指定・非文字列のときは undefined を
+返し、必須入力の検証へ委ねる。
+*/
+function rejectExistingTarget(name) {
+    return (arguments_) => {
+        const target = targetOf(arguments_, name);
+        if (target === undefined)
+            return;
+        if (isDirectory(target)) {
+            return {
+                category: 'invalid-input',
+                message: `${name} にディレクトリは指定できません。書き出すファイルの絶対パスを指定してください: ${target}`,
+            };
+        }
+        if ((arguments_['overwrite'] === true) || !doesFileExist(target))
+            return;
+        return {
+            category: 'invalid-input',
+            message: `${name} は既に存在します。上書きするなら overwrite に true を指定してください: ${target}`,
+        };
+    };
+}
+/**
+成功時に artifacts へ載せる書き出し先。
+*/
+function artifactsOfTarget(name) {
+    return (arguments_) => {
+        const target = targetOf(arguments_, name);
+        return target === undefined ? [] : [target];
+    };
+}
+const OVERWRITE_INPUT = z.boolean().default(false)
+    .describe('true なら書き出し先が既にあっても上書きする');
+export function s3Tools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: S3_LS,
+            title: 'S3 の一覧',
+            description: 'バケットまたは prefix の直下を一覧する。s3_uri を省略するとバケット一覧を返す。JSON 出力を持たないコマンドのため data.lines に行単位で返る',
+            inputSchema: z.object({
+                s3_uri: z.string().optional().describe('一覧する対象（s3://bucket または s3://bucket/prefix/）。省略時はバケット一覧'),
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: S3_CP,
+            title: 'S3 オブジェクトの取得',
+            description: 'S3 のオブジェクト 1 件をローカルの絶対パスへ取得する。アップロード方向と再帰コピーは公開していない',
+            inputSchema: z.object({
+                s3_uri: z.string().describe('取得元（s3://bucket/key の形式）'),
+                local_path: z.string().describe('書き出し先のローカル絶対パス'),
+                overwrite: OVERWRITE_INPUT,
+                ...COMMON_INPUT_SHAPE,
+            }),
+            reject: rejectExistingTarget('local_path'),
+            artifactsOf: artifactsOfTarget('local_path'),
+        }, options),
+        allowlistedTool({
+            entry: S3API_GET_OBJECT,
+            title: 'S3 オブジェクトの取得（メタデータ付き）',
+            description: 'バケットとキーを指定してオブジェクトを取得し、メタデータを JSON で返す。version_id でバージョン指定、range で部分取得ができる',
+            inputSchema: z.object({
+                bucket: z.string().describe('バケット名'),
+                key: z.string().describe('オブジェクトキー'),
+                outfile: z.string().describe('書き出し先のローカル絶対パス'),
+                version_id: z.string().optional().describe('取得するバージョン ID'),
+                range: z.string().optional().describe('取得するバイト範囲（bytes=0-1023 の形式）'),
+                overwrite: OVERWRITE_INPUT,
+                ...COMMON_INPUT_SHAPE,
+            }),
+            reject: rejectExistingTarget('outfile'),
+            artifactsOf: artifactsOfTarget('outfile'),
+        }, options),
+    ];
+}
+//# sourceMappingURL=s3.js.map

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

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

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

@@ -0,0 +1,44 @@
+// EventBridge Scheduler 系のツール定義。
+import { z } from 'zod';
+import { SCHEDULER_GET_SCHEDULE, SCHEDULER_LIST_SCHEDULES } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+一覧の絞り込みに使うスケジュールグループ名。
+
+`list-schedules` の `--group-name` は未指定なら全グループが対象で、`get-schedule` の
+既定（default グループ）とは意味が違うので定数を分ける。
+*/
+const LIST_GROUP_NAME_INPUT = z.string().optional()
+    .describe('絞り込むスケジュールグループ名。未指定なら全グループを一覧する');
+/**
+単体取得の対象になるスケジュールグループ名。
+*/
+const GET_GROUP_NAME_INPUT = z.string().optional()
+    .describe('スケジュールグループ名。未指定なら default グループを見る');
+export function schedulerTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: SCHEDULER_LIST_SCHEDULES,
+            title: 'スケジュールの一覧',
+            description: 'EventBridge Scheduler のスケジュールを一覧する。詳細（実行式・ターゲット）は aws_scheduler_get_schedule で取る',
+            inputSchema: z.object({
+                group_name: LIST_GROUP_NAME_INPUT,
+                name_prefix: z.string().optional().describe('スケジュール名の前方一致'),
+                state: z.enum(['ENABLED', 'DISABLED']).optional().describe('絞り込む状態'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: SCHEDULER_GET_SCHEDULE,
+            title: 'スケジュールの詳細取得',
+            description: 'スケジュール 1 件の実行式（ScheduleExpression）・タイムゾーン・ターゲット・状態を返す',
+            inputSchema: z.object({
+                name: z.string().describe('スケジュール名'),
+                group_name: GET_GROUP_NAME_INPUT,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=scheduler.js.map

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

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

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

@@ -0,0 +1,33 @@
+// SQS 系のツール定義。
+import { z } from 'zod';
+import { SQS_GET_QUEUE_ATTRIBUTES, SQS_LIST_QUEUES } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE, MAX_ITEMS_PAGINATION_SHAPE, } from './_shared.js';
+/**
+取得する属性名。既定は全属性。
+*/
+const ATTRIBUTE_NAMES_INPUT = z.array(z.string()).default(['All']).describe('取得する属性名。既定は全属性');
+export function sqsTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: SQS_LIST_QUEUES,
+            title: 'キューの一覧',
+            description: 'SQS のキュー URL を一覧する。queue_name_prefix でキュー名の前方一致に絞れる',
+            inputSchema: z.object({
+                queue_name_prefix: z.string().optional().describe('キュー名の前方一致'),
+                ...MAX_ITEMS_PAGINATION_SHAPE,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+        allowlistedTool({
+            entry: SQS_GET_QUEUE_ATTRIBUTES,
+            title: 'キュー属性の取得',
+            description: 'キュー 1 本の属性（滞留件数・可視性タイムアウト・デッドレターキュー設定等）を返す',
+            inputSchema: z.object({
+                queue_url: z.string().describe('キューの URL（https:// で始まる）'),
+                attribute_names: ATTRIBUTE_NAMES_INPUT,
+                ...COMMON_INPUT_SHAPE,
+            }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=sqs.js.map

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

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../server.js';
+import { type ToolOptions } from './_shared.js';
+/**
+SSO の 2 件を組み立てる。
+
+ハンドラは ToolCallContext（signal）を使わない。tools/call のキャンセルで子を落とすと、
+「開始だけして後で確認する」という 2 段構成の趣旨に反する。
+クライアントの接続断は serve.ts の stdin end の処理が子を片付けるため、孤児は残らない。
+*/
+export declare function ssoTools(options?: Readonly<ToolOptions>): readonly ToolDefinition[];
+//# sourceMappingURL=sso.d.ts.map

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

@@ -0,0 +1,240 @@
+// SSO 認証の 2 段構成（contracts/mcp-tools.md §SSO 認証 / research R5 / FR-007）。
+//
+// `aws sso login` は認証が終わるまで戻らないため、開始（URL とコードを即時に返す）と
+// 完了確認を別のツールに分ける。子プロセスの保持と状態遷移は infra/sso/login-registry.ts が持ち、
+// ここは応答の組み立て（ヒント・上限・annotations）だけを持つ。
+//
+// この 2 件は許可リスト（domain/allowlist.ts）に入れない。許可リストは「awscli を 1 回起動して
+// 出力を返す」形のコマンド表で、tests/integration/real-awscli.test.ts が全件を実 awscli へ通す。
+// そのため、入れると実行のたびに本物のデバイス認証が発行される。
+import { z } from 'zod';
+import { ensureAwscli } from '../../infra/awscli.js';
+import { loginRegistry as sharedLoginRegistry, } from '../../infra/sso/login-registry.js';
+import { limitOutput, toCallToolResult } from '../result.js';
+import { PRE_EXECUTION_EXIT_CODE, PROFILE_INPUT_SHAPE, resolveExitCode, TIMEOUT_EXIT_CODE, TOOL_OUTPUT_SCHEMA, UNKNOWN_FAILURE_EXIT_CODE, } from './_shared.js';
+/**
+SSO 専用の失敗種別ごとの再試行方法。
+
+共通表（_shared.ts の FAILURE_HINTS）は auth-missing / auth-expired で、
+「aws_sso_login を実行してください」と案内する。SSO 自身の失敗に使うと、案内が循環する。
+*/
+const SSO_FAILURE_HINTS = {
+    'not-allowed': '許可されていない操作です。公開しているツールの範囲で実行してください',
+    'invalid-input': 'profile を修正して再実行してください',
+    'awscli-missing': 'awscli v2 (2.22 以上) を導入して PATH を通してください',
+    'auth-missing': 'profile に SSO の設定がありません。端末で aws configure sso を実行してください',
+    'auth-expired': 'トークンのキャッシュを読めませんでした。profile の SSO 設定を確認してください',
+    'permission-denied': 'SSO の許可セットに対象アカウントが含まれているか確認してください',
+    'resource-not-found': 'profile の sso_start_url / sso_region を確認してください',
+    'timeout': '制限時間内に認証が完了しませんでした。aws_sso_login を再度呼び出してください',
+    'other': 'awscli が失敗しました。stderr を確認してください',
+};
+/**
+出力が上限で切り詰められたときに message へ足す注記。
+*/
+const OUTPUT_TRUNCATION_NOTE = '（出力は上限を超えたため先頭のみ載せています）';
+/**
+annotations（判断の根拠は契約書の共通規約）。
+
+`aws_sso_login` は AWS 側に新しいトークンを発行させるので readOnlyHint は false。
+`aws_sso_login_status` はレジストリを読むだけなので true。壊す対象を持たないため
+destructiveHint は 2 件とも false。openWorldHint は共通規約に合わせて 2 件とも true にする
+（status は awscli を起動しないが、返す内容は外界での承認の進み具合に依存する）。
+*/
+const LOGIN_ANNOTATIONS = { readOnlyHint: false, destructiveHint: false, openWorldHint: true };
+const STATUS_ANNOTATIONS = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
+function profileOf(arguments_) {
+    const profile = arguments_['profile'];
+    return typeof profile === 'string' ? profile : undefined;
+}
+/**
+応答 data に載せる URL / コード。確定前と、デバイスフローに入らなかった場合は載らない。
+*/
+function promptData(session) {
+    return {
+        ...(session.verificationUrl !== undefined && { verificationUrl: session.verificationUrl }),
+        ...(session.verificationUrlComplete !== undefined && { verificationUrlComplete: session.verificationUrlComplete }),
+        ...(session.userCode !== undefined && { userCode: session.userCode }),
+    };
+}
+/**
+pending 応答の案内文。
+
+`promptData` は未確定の項目をキーごと data から落とす。
+autofill URL（verificationUrlComplete）が未確定のときに、それを第一候補として案内すると、
+応答に無い項目を案内することになる。
+autofill 行は URL・コードより後の chunk で届くことがあり、揃うまでの間はこの分岐に入る。
+*/
+function pendingMessage(session) {
+    return (session.verificationUrlComplete === undefined
+        ? 'デバイス認証を開始しました。verificationUrl をブラウザで開き、userCode を入力してください。'
+        : 'デバイス認証を開始しました。verificationUrlComplete をブラウザで開けば'
+            + 'コード入力は要りません（verificationUrl を開いた場合は userCode を入力します）。')
+        + '承認後に aws_sso_login_status で完了を確認してください';
+}
+function hintOf(category) {
+    // eslint-disable-next-line security/detect-object-injection -- category は FailureCategory の列挙値
+    return SSO_FAILURE_HINTS[category];
+}
+/**
+失敗セッションを ExecutionResult にする。exitCode は必ず 1 以上になる。
+*/
+function failureResult(session, data) {
+    /* c8 ignore next -- レジストリは failed に必ず category を付ける。既定値は型を閉じるための防御網 */
+    const category = session.category ?? 'other';
+    const limited = limitOutput(session.output);
+    // awscli の終了コードをそのまま返す（許可リストのツールと同じ規約。SSO 設定なしなら 253）。
+    // シグナル終了・未終了は resolveExitCode が 1 へ畳む。0 以下は ok: false と同居させられないので、
+    // ここでも 1 にする。
+    const resolved = resolveExitCode(category, session.exitCode);
+    return {
+        ok: false,
+        // resolveExitCode は 'timeout' なら 124、'awscli-missing' なら 127、それ以外は session.exitCode（未設定なら 1）を返す。
+        // 0 以下にならず、false 分岐は型を閉じるための防御。
+        /* c8 ignore next */
+        exitCode: resolved > 0 ? resolved : UNKNOWN_FAILURE_EXIT_CODE,
+        category,
+        data: { ...data },
+        artifacts: [],
+        message: `SSO 認証が失敗しました (${category})。${hintOf(category)}`
+            + (limited.truncated ? OUTPUT_TRUNCATION_NOTE : ''),
+        stderr: limited.text,
+    };
+}
+/**
+時間切れセッションを ExecutionResult にする。
+*/
+function timedOutResult(data) {
+    return {
+        ok: false,
+        exitCode: TIMEOUT_EXIT_CODE,
+        category: 'timeout',
+        data: { ...data },
+        artifacts: [],
+        message: `SSO 認証が時間切れになりました。${hintOf('timeout')}`,
+    };
+}
+async function startLogin(arguments_, registry) {
+    // バージョンの判定を先に行う。`--use-device-code` は awscli 2.22 以降にしか無い。
+    // 古い awscli では「不正な引数」として失敗し、そのままだと invalid-input になって対処法が伝わらない。
+    const probe = await ensureAwscli();
+    if (!probe.ok) {
+        return {
+            ok: false,
+            exitCode: resolveExitCode(probe.category),
+            category: probe.category,
+            data: {},
+            artifacts: [],
+            message: probe.message,
+        };
+    }
+    const session = await registry.start(profileOf(arguments_));
+    const base = { state: session.state, profile: session.profile };
+    switch (session.state) {
+        case 'pending': {
+            return {
+                ok: true,
+                exitCode: 0,
+                data: { ...promptData(session), ...base },
+                artifacts: [],
+                message: pendingMessage(session),
+            };
+        }
+        case 'completed': {
+            return {
+                ok: true,
+                exitCode: 0,
+                data: { ...promptData(session), ...base },
+                artifacts: [],
+                message: 'デバイス認証を始める前から認証済みでした',
+            };
+        }
+        case 'timed-out': {
+            return timedOutResult(base);
+        }
+        case 'failed': {
+            return failureResult(session, base);
+        }
+    }
+}
+function loginStatus(arguments_, registry) {
+    const session = registry.get(profileOf(arguments_));
+    if (session === undefined) {
+        return {
+            ok: false,
+            exitCode: PRE_EXECUTION_EXIT_CODE,
+            category: 'invalid-input',
+            data: {},
+            artifacts: [],
+            message: '開始済みの SSO ログインがありません。aws_sso_login を先に呼んでください',
+        };
+    }
+    const base = { state: session.state };
+    switch (session.state) {
+        case 'pending': {
+            return {
+                ok: true,
+                exitCode: 0,
+                data: { ...promptData(session), ...base },
+                artifacts: [],
+                message: 'まだ承認されていません。案内した URL での承認後に再度呼び出してください',
+            };
+        }
+        case 'completed': {
+            const limited = limitOutput(session.output);
+            return {
+                ok: true,
+                exitCode: 0,
+                data: { ...promptData(session), ...base, output: limited.text },
+                artifacts: [],
+                message: 'SSO 認証が完了しました'
+                    + (limited.truncated ? OUTPUT_TRUNCATION_NOTE : ''),
+            };
+        }
+        case 'timed-out': {
+            return timedOutResult(base);
+        }
+        case 'failed': {
+            return failureResult(session, base);
+        }
+    }
+}
+/**
+SSO の 2 件を組み立てる。
+
+ハンドラは ToolCallContext（signal）を使わない。tools/call のキャンセルで子を落とすと、
+「開始だけして後で確認する」という 2 段構成の趣旨に反する。
+クライアントの接続断は serve.ts の stdin end の処理が子を片付けるため、孤児は残らない。
+*/
+export function ssoTools(options = {}) {
+    // 既定の解決はここで済ませる。ハンドラ内で遅延解決すると、テストが注入したレジストリと
+    // 共有インスタンスのどちらを見るかが呼び出し時まで決まらない。
+    const registry = options.loginRegistry ?? sharedLoginRegistry();
+    return [
+        {
+            name: 'aws_sso_login',
+            config: {
+                title: 'SSO ログインの開始',
+                description: 'AWS SSO のデバイス認証を開始し、認証 URL とコードを即時に返す。完了は待たないため、'
+                    + '利用者の承認後に aws_sso_login_status で確認する',
+                inputSchema: z.object({ ...PROFILE_INPUT_SHAPE }),
+                outputSchema: TOOL_OUTPUT_SCHEMA,
+                annotations: LOGIN_ANNOTATIONS,
+            },
+            handler: async (arguments_) => toCallToolResult(await startLogin(arguments_, registry)),
+        },
+        {
+            name: 'aws_sso_login_status',
+            config: {
+                title: 'SSO ログインの完了確認',
+                description: 'aws_sso_login で開始した認証の状態（pending / completed / failed / timed-out）を返す。'
+                    + 'awscli は起動しない',
+                inputSchema: z.object({ ...PROFILE_INPUT_SHAPE }),
+                outputSchema: TOOL_OUTPUT_SCHEMA,
+                annotations: STATUS_ANNOTATIONS,
+            },
+            handler: (arguments_) => Promise.resolve(toCallToolResult(loginStatus(arguments_, registry))),
+        },
+    ];
+}
+//# sourceMappingURL=sso.js.map

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

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

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

@@ -0,0 +1,15 @@
+// STS 系のツール定義。
+import { z } from 'zod';
+import { STS_GET_CALLER_IDENTITY } from '../../domain/allowlist.js';
+import { allowlistedTool, COMMON_INPUT_SHAPE } from './_shared.js';
+export function stsTools(options = {}) {
+    return [
+        allowlistedTool({
+            entry: STS_GET_CALLER_IDENTITY,
+            title: '呼び出し元 ID の確認',
+            description: '現在の認証情報が示すアカウント ID・ユーザ ID・ARN を返す。認証が通っているかの確認に使う',
+            inputSchema: z.object({ ...COMMON_INPUT_SHAPE }),
+        }, options),
+    ];
+}
+//# sourceMappingURL=sts.js.map

package/cli/dist/node-runtime.d.ts

@@ -0,0 +1,20 @@
+/**
+系列（major）ごとの最低版。2026-10-21 の Node.js セキュリティリリース
+（Brotli 展開の RCE CVE-2026-111497 ほか）の修正版。25 系はサポート終了で修正版が無い。
+次のセキュリティリリースで上げるときは、現行の版を次のコマンドで列挙する。
+`grep -rn '24.22.1' plugins .githooks`（node_modules・アイコン SVG のヒットは除く）。
+ヒットした箇所を同じ変更で更新する。
+表・engines・フックの期待値・両プラグインの複製の一致は node-runtime.test.ts が検証する。
+*/
+export declare const MINIMUM_NODE_VERSIONS: Readonly<Record<number, string>>;
+/**
+案内に載せる更新先の版。表の最小 major の最低版。
+*/
+export declare function suggestedNodeVersion(): string;
+/**
+起動してよい版なら undefined、止めるべき版なら利用者向けの案内文を返す。
+表に無い major は、表の最大 major より新しければ修正後のリリースとみなして許可し、
+それ以外（24 未満・サポート終了の 25 系）は止める。
+*/
+export declare function checkNodeRuntime(version: string): string | undefined;
+//# sourceMappingURL=node-runtime.d.ts.map