@pecot/tools-mcp 1.0.2 → 1.1.0

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

@@ -3,27 +3,27 @@ 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';
 /**
-取得する属性名。既定は全属性。
+Attribute names to get. Defaults to all attributes。
 */
-const ATTRIBUTE_NAMES_INPUT = z.array(z.string()).default(['All']).describe('取得する属性名。既定は全属性');
+const ATTRIBUTE_NAMES_INPUT = z.array(z.string()).default(['All']).describe('Attribute names to get. Defaults to all attributes');
 export function sqsTools(options = {}) {
     return [
         allowlistedTool({
             entry: SQS_LIST_QUEUES,
-            title: 'キューの一覧',
-            description: 'SQS のキュー URL を一覧する。queue_name_prefix でキュー名の前方一致に絞れる',
+            title: 'List queues',
+            description: 'Lists SQS queue URLs. Narrow by name prefix with queue_name_prefix',
             inputSchema: z.object({
-                queue_name_prefix: z.string().optional().describe('キュー名の前方一致'),
+                queue_name_prefix: z.string().optional().describe('Queue name prefix'),
                 ...MAX_ITEMS_PAGINATION_SHAPE,
                 ...COMMON_INPUT_SHAPE,
             }),
         }, options),
         allowlistedTool({
             entry: SQS_GET_QUEUE_ATTRIBUTES,
-            title: 'キュー属性の取得',
-            description: 'キュー 1 本の属性（滞留件数・可視性タイムアウト・デッドレターキュー設定等）を返す',
+            title: 'Get queue attributes',
+            description: 'Returns the attributes of one queue (backlog counts, visibility timeout, dead-letter queue settings, etc.)',
             inputSchema: z.object({
-                queue_url: z.string().describe('キューの URL（https:// で始まる）'),
+                queue_url: z.string().describe('Queue URL (starts with https://)'),
                 attribute_names: ATTRIBUTE_NAMES_INPUT,
                 ...COMMON_INPUT_SHAPE,
             }),

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

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

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

@@ -1,45 +1,30 @@
-// 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 へ通す。
-// そのため、入れると実行のたびに本物のデバイス認証が発行される。
+// SSO 認証の 2 段構成（contracts/mcp-tools.md §SSO 認証 / research R5）。開始と完了確認を別ツールに分け、子の保持は login-registry.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 自身の失敗に使うと、案内が循環する。
+SSO 専用の失敗種別ごとの再試行方法。共通表は「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 を確認してください',
+    'not-allowed': 'Operation not allowed. Use only the exposed tools',
+    'invalid-input': 'Fix the profile and run again',
+    'awscli-missing': 'Install awscli v2 (2.22 or later) and add it to PATH',
+    'auth-missing': 'The profile has no SSO configuration. Run aws configure sso in a terminal',
+    'auth-expired': 'Could not read the token cache. Check the SSO settings of the profile',
+    'permission-denied': 'Check that the SSO permission set includes the target account',
+    'resource-not-found': 'Check sso_start_url / sso_region of the profile',
+    'timeout': 'Authentication did not complete within the time limit. Call aws_sso_login again',
+    'other': 'awscli failed. Check stderr',
 };
 /**
 出力が上限で切り詰められたときに message へ足す注記。
 */
-const OUTPUT_TRUNCATION_NOTE = '（出力は上限を超えたため先頭のみ載せています）';
+const OUTPUT_TRUNCATION_NOTE = '(Output exceeded the limit, so only the beginning is included)';
 /**
-annotations（判断の根拠は契約書の共通規約）。
-
-`aws_sso_login` は AWS 側に新しいトークンを発行させるので readOnlyHint は false。
-`aws_sso_login_status` はレジストリを読むだけなので true。壊す対象を持たないため
-destructiveHint は 2 件とも false。openWorldHint は共通規約に合わせて 2 件とも true にする
-（status は awscli を起動しないが、返す内容は外界での承認の進み具合に依存する）。
+annotations。status は awscli を起動しないが、返す内容は外界の承認の進み具合に依存するので openWorldHint は 2 件とも true。
 */
 const LOGIN_ANNOTATIONS = { readOnlyHint: false, destructiveHint: false, openWorldHint: true };
 const STATUS_ANNOTATIONS = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
@@ -58,19 +43,14 @@ function promptData(session) {
     };
 }
 /**
-pending 応答の案内文。
-
-`promptData` は未確定の項目をキーごと data から落とす。
-autofill URL（verificationUrlComplete）が未確定のときに、それを第一候補として案内すると、
-応答に無い項目を案内することになる。
-autofill 行は URL・コードより後の chunk で届くことがあり、揃うまでの間はこの分岐に入る。
+pending 応答の案内文。autofill URL は後の chunk で届くことがあり、未確定の間は応答に無い項目を案内しない。
 */
 function pendingMessage(session) {
     return (session.verificationUrlComplete === undefined
-        ? 'デバイス認証を開始しました。verificationUrl をブラウザで開き、userCode を入力してください。'
-        : 'デバイス認証を開始しました。verificationUrlComplete をブラウザで開けば'
-            + 'コード入力は要りません（verificationUrl を開いた場合は userCode を入力します）。')
-        + '承認後に aws_sso_login_status で完了を確認してください';
+        ? 'Device authorization started. Open verificationUrl in a browser and enter userCode. '
+        : 'Device authorization started. Open verificationUrlComplete in a browser; '
+            + 'no code entry is needed (if you open verificationUrl, enter userCode). ')
+        + 'After approval, check completion with aws_sso_login_status.';
 }
 function hintOf(category) {
     // eslint-disable-next-line security/detect-object-injection -- category は FailureCategory の列挙値
@@ -83,9 +63,7 @@ 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 にする。
+    // awscli の終了コードをそのまま返す（SSO 設定なしなら 253）。ok: false と同居できないので、0 以下とシグナル終了は 1 にする。
     const resolved = resolveExitCode(category, session.exitCode);
     return {
         ok: false,
@@ -96,7 +74,7 @@ function failureResult(session, data) {
         category,
         data: { ...data },
         artifacts: [],
-        message: `SSO 認証が失敗しました (${category})。${hintOf(category)}`
+        message: `SSO authentication failed (${category}). ${hintOf(category)}`
             + (limited.truncated ? OUTPUT_TRUNCATION_NOTE : ''),
         stderr: limited.text,
     };
@@ -111,7 +89,7 @@ function timedOutResult(data) {
         category: 'timeout',
         data: { ...data },
         artifacts: [],
-        message: `SSO 認証が時間切れになりました。${hintOf('timeout')}`,
+        message: `SSO authentication timed out. ${hintOf('timeout')}`,
     };
 }
 async function startLogin(arguments_, registry) {
@@ -146,7 +124,7 @@ async function startLogin(arguments_, registry) {
                 exitCode: 0,
                 data: { ...promptData(session), ...base },
                 artifacts: [],
-                message: 'デバイス認証を始める前から認証済みでした',
+                message: 'Already authenticated before device authorization started',
             };
         }
         case 'timed-out': {
@@ -166,7 +144,7 @@ function loginStatus(arguments_, registry) {
             category: 'invalid-input',
             data: {},
             artifacts: [],
-            message: '開始済みの SSO ログインがありません。aws_sso_login を先に呼んでください',
+            message: 'No SSO login in progress. Call aws_sso_login first',
         };
     }
     const base = { state: session.state };
@@ -177,7 +155,7 @@ function loginStatus(arguments_, registry) {
                 exitCode: 0,
                 data: { ...promptData(session), ...base },
                 artifacts: [],
-                message: 'まだ承認されていません。案内した URL での承認後に再度呼び出してください',
+                message: 'Not approved yet. Approve at the given URL, then call again',
             };
         }
         case 'completed': {
@@ -187,7 +165,7 @@ function loginStatus(arguments_, registry) {
                 exitCode: 0,
                 data: { ...promptData(session), ...base, output: limited.text },
                 artifacts: [],
-                message: 'SSO 認証が完了しました'
+                message: 'SSO authentication completed'
                     + (limited.truncated ? OUTPUT_TRUNCATION_NOTE : ''),
             };
         }
@@ -200,11 +178,7 @@ function loginStatus(arguments_, registry) {
     }
 }
 /**
-SSO の 2 件を組み立てる。
-
-ハンドラは ToolCallContext（signal）を使わない。tools/call のキャンセルで子を落とすと、
-「開始だけして後で確認する」という 2 段構成の趣旨に反する。
-クライアントの接続断は serve.ts の stdin end の処理が子を片付けるため、孤児は残らない。
+SSO の 2 件を組み立てる。signal を使わないのは、キャンセルで子を落とすと 2 段構成の趣旨に反するため（接続断は serve.ts が片付ける）。
 */
 export function ssoTools(options = {}) {
     // 既定の解決はここで済ませる。ハンドラ内で遅延解決すると、テストが注入したレジストリと
@@ -214,9 +188,9 @@ export function ssoTools(options = {}) {
         {
             name: 'aws_sso_login',
             config: {
-                title: 'SSO ログインの開始',
-                description: 'AWS SSO のデバイス認証を開始し、認証 URL とコードを即時に返す。完了は待たないため、'
-                    + '利用者の承認後に aws_sso_login_status で確認する',
+                title: 'Start SSO login',
+                description: 'Starts AWS SSO device authorization and returns the verification URL and code immediately. It does not wait for completion, so '
+                    + 'check with aws_sso_login_status after the user approves',
                 inputSchema: z.object({ ...PROFILE_INPUT_SHAPE }),
                 outputSchema: TOOL_OUTPUT_SCHEMA,
                 annotations: LOGIN_ANNOTATIONS,
@@ -226,9 +200,9 @@ export function ssoTools(options = {}) {
         {
             name: 'aws_sso_login_status',
             config: {
-                title: 'SSO ログインの完了確認',
-                description: 'aws_sso_login で開始した認証の状態（pending / completed / failed / timed-out）を返す。'
-                    + 'awscli は起動しない',
+                title: 'Check SSO login status',
+                description: 'Returns the state (pending / completed / failed / timed-out) of the authorization started by aws_sso_login. '
+                    + 'Does not run awscli',
                 inputSchema: z.object({ ...PROFILE_INPUT_SHAPE }),
                 outputSchema: TOOL_OUTPUT_SCHEMA,
                 annotations: STATUS_ANNOTATIONS,

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

@@ -6,8 +6,8 @@ export function stsTools(options = {}) {
     return [
         allowlistedTool({
             entry: STS_GET_CALLER_IDENTITY,
-            title: '呼び出し元 ID の確認',
-            description: '現在の認証情報が示すアカウント ID・ユーザ ID・ARN を返す。認証が通っているかの確認に使う',
+            title: 'Get caller identity',
+            description: 'Returns the account ID, user ID, and ARN of the current credentials. Use it to check that authentication works',
             inputSchema: z.object({ ...COMMON_INPUT_SHAPE }),
         }, options),
     ];

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

@@ -12,9 +12,14 @@ export declare const MINIMUM_NODE_VERSIONS: Readonly<Record<number, string>>;
 */
 export declare function suggestedNodeVersion(): string;
 /**
-起動してよい版なら undefined、止めるべき版なら利用者向けの案内文を返す。
+起動してよい版なら undefined、止めるべき版なら字下げ無しの複数行の案内文を返す。
+CLI は診断行の共通の関数に渡し、続きの行の字下げはそちらが付ける。
 表に無い major は、表の最大 major より新しければ修正後のリリースとみなして許可し、
 それ以外（24 未満・サポート終了の 25 系）は止める。
 */
+export declare function nodeRuntimeGuidance(version: string): string | undefined;
+/**
+launcher と hook がそのまま書く形。続きの行の先頭に空白 2 つを付けた案内文を返す。
+*/
 export declare function checkNodeRuntime(version: string): string | undefined;
 //# sourceMappingURL=node-runtime.d.ts.map

package/cli/dist/node-runtime.js

@@ -6,7 +6,8 @@
 // enum・namespace・パラメータプロパティを使わず、他モジュールを import しない。
 // ランチャーと hook が node から直接読み込んで checkNodeRuntime を呼ぶため。
 //
-// 判定は cli.ts の main() で行う。静的 import の評価後に動くため、import の段階で落ちる
+// 判定は cli.ts の main() で行う。CLI は nodeRuntimeGuidance の結果を診断行の共通の関数に渡す
+// （続きの行の字下げは共通の関数が付ける）。静的 import の評価後に動くため、import の段階で落ちる
 // 古い major（23 以前）では案内を出せないことがある。判定だけのエントリモジュールには分けない。
 /**
 系列（major）ごとの最低版。2026-10-21 の Node.js セキュリティリリース
@@ -44,8 +45,8 @@ function isAtLeast(actual, minimum) {
 }
 function requiredVersionsText() {
     return Object.entries(MINIMUM_NODE_VERSIONS)
-        .map(([major, minimum]) => `${major} 系は ${minimum} 以上`)
-        .join('、');
+        .map(([major, minimum]) => `${major}.x: ${minimum} or later`)
+        .join(', ');
 }
 /**
 案内に載せる更新先の版。表の最小 major の最低版。
@@ -57,17 +58,18 @@ export function suggestedNodeVersion() {
 }
 function guidance(version) {
     return [
-        `Node.js ${version} は既知の脆弱性の修正を含まないため起動しません。`,
-        `  必要な版: ${requiredVersionsText()}`,
-        `  Node.js を更新して再実行してください（nvm の例: nvm install ${suggestedNodeVersion()}）。`,
+        `Node.js ${version} does not include fixes for known vulnerabilities; not starting`,
+        `required: ${requiredVersionsText()}`,
+        `(fix: update Node.js and run again; with nvm: nvm install ${suggestedNodeVersion()})`,
     ].join('\n');
 }
 /**
-起動してよい版なら undefined、止めるべき版なら利用者向けの案内文を返す。
+起動してよい版なら undefined、止めるべき版なら字下げ無しの複数行の案内文を返す。
+CLI は診断行の共通の関数に渡し、続きの行の字下げはそちらが付ける。
 表に無い major は、表の最大 major より新しければ修正後のリリースとみなして許可し、
 それ以外（24 未満・サポート終了の 25 系）は止める。
 */
-export function checkNodeRuntime(version) {
+export function nodeRuntimeGuidance(version) {
     const actual = parseVersion(version);
     if (actual === undefined)
         return guidance(version);
@@ -81,4 +83,10 @@ export function checkNodeRuntime(version) {
         return guidance(version);
     return isAtLeast(actual, minimumVersion.tuple) ? undefined : guidance(version);
 }
+/**
+launcher と hook がそのまま書く形。続きの行の先頭に空白 2 つを付けた案内文を返す。
+*/
+export function checkNodeRuntime(version) {
+    return nodeRuntimeGuidance(version)?.split('\n').join('\n  ');
+}
 //# sourceMappingURL=node-runtime.js.map

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pecot/tools-mcp",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@pecot/tools-mcp",
-      "version": "1.0.2",
+      "version": "1.1.0",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/server": "^2.4.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pecot/tools-mcp",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "pecot-tools MCP server (standalone distribution)",
   "license": "MIT",