@bluelamp/secret-exec 0.3.0 → 0.4.0

package/README.md

@@ -3,10 +3,11 @@
 > 🔒 **これは値を返さない口です。**
 > 取れるのは「金庫にその名前が**在るか無いか**」と「値を**使えるか**（子プロセスが値を環境変数で受けて走れたか＝子の終了コード）」だけです。
 > 値を標準出力・標準エラー・戻り値・ファイル・コマンドの引数に出す口は、このパッケージには**ありません**。今後も作りません。
-> 値を見たい用途（表示・コピー・ファイルへの書き出し）には使えません。それは設計上の意図です。
+> 値を見たい用途（表示・ファイルへの書き出し）には使えません。それは設計上の意図です。
+> 例外は 1 つだけ: `copy` は、**持ち主の画面に出る確認の窓で「コピー」を押したときだけ**値をクリップボードへ入れます（下の「クリップボードへ入れる」）。値は出力には出ません。
 
 金庫（password-manager）に置いた値を、**子プロセスの環境変数にだけ**入れてコマンドを実行します（`exec`）。終了コードは子のものをそのまま返します。
-値を会話に出さずに金庫へ**入れる**口（`put`）も同梱しています（下の「値を金庫へ入れる」）。
+値を会話に出さずに金庫へ**入れる**口（`put`）と、持ち主の確認を挟んでクリップボードへ入れる口（`copy`）も同梱しています。
 
 ## 使い方
 
@@ -77,3 +78,16 @@ bluelamp-secret put my-db --file ./db-url.txt --url https://db.example.com
 - `resolveHandoffBins(overrideEnvNames)` … node と bluelamp-secret の実体の絶対パス（launchd の貧しい PATH に依らない）。見つからなければ null
 
 ⛔ 値を返す口は無い（テスト P10 が export の一覧を縛る）。外側の `env -u CLAUDE_CODE_OAUTH_TOKEN`（親の継承を切る）は呼び手が付ける。
+
+## クリップボードへ入れる（copy）
+
+```bash
+bluelamp-secret copy "<金庫の名前>"
+```
+
+- 持ち主の画面に OS の確認の窓（「<名前> のパスワードをクリップボードにコピーしますか？」コピー／やめる）を出し、**「コピー」を押したときだけ**値をクリップボードへ入れます。45 秒たってクリップボードがまだその値なら空にします（別の物をコピーし直していれば触りません）。
+- 決めるのは毎回、画面の前の持ち主です。エージェント（Claude Code など）から撃っても、窓を押さなければ入りません。窓が 120 秒押されなければ「やめる」と同じです。
+- 名前が完全に一致しなければ、名前か利用者名に（大文字小文字を問わず）含む候補を窓に並べて選んでもらいます（最大 20 件）。名前は値の列を持たない一覧で当てるので、「やめる」を押したときは金庫の値を引きません。
+- Mac: 窓は `osascript`、クリップボードは `pbcopy`。Windows: PowerShell のフォームと `System.Windows.Forms.Clipboard`（クリップボードの履歴とクラウド同期には載せない印を付けます）。WSL から撃っても Windows 側の画面とクリップボードに出ます。
+- 窓を出せない機体では**黙ってコピーせず断ります**: ssh 越し（`SSH_CONNECTION` 等）・CI・画面にログインしていない利用者の Mac・WSL でない Linux。
+- 出力は「コピーしました」「やめました」と理由だけです。終了コード: 0 コピーした／1 失敗／2 引数の形／3 やめた／4 窓を出せない。

package/bin/bluelamp-secret.mjs

@@ -3,6 +3,7 @@
  * bluelamp-secret — 金庫の値を子プロセスの環境変数にだけ入れてコマンドを走らせる（箱 n=2018 設計④′）。
  *   bluelamp-secret exec <ENV名>=<金庫の名前> [...] -- <コマンド> [引数…]
  *   <値を出すコマンド> | bluelamp-secret put <金庫の名前> [--note 文] [--username 名] [--url URL] [--file パス] [--force]（箱 n=2498）
+ *   bluelamp-secret copy "<金庫の名前>"（箱 n=3738・持ち主の画面の確認の窓で「コピー」を押したときだけクリップボードへ）
  * 🔒 値を返さない口: 値は stdout・stderr・戻り値・ファイルに出ない（README の冒頭・src/index.ts の頭注）。
  * 判定と組み立ては dist/index.js（unit テスト済み）。ここは実物の網・トークン・子プロセス・シグナルを繋ぐだけ。
  */
@@ -10,7 +11,8 @@ import { spawn } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 import { constants as osConstants } from 'node:os';
 import { tryReadCliToken } from '@bluelamp/cli-token';
-import { runSecretExec, runSecretPut } from '../dist/index.js';
+import { runSecretCopy, runSecretExec, runSecretPut } from '../dist/index.js';
+import { clipboardBackend, consoleIsMine, isWsl, scheduleClear } from '../dist/clipboard.js';
 
 // 端末の Ctrl-C は同じプロセスグループの子にも届く＝親は受け流して子の終了を待つ。
 // SIGTERM / SIGHUP は親だけに来うるので子へ回す。
@@ -33,7 +35,21 @@ const run =
         readFile: (p) => readFile(p, 'utf8'),
         stderr: (text) => process.stderr.write(text),
       })
-    : runExec();
+    : argv[0] === 'copy'
+      ? runSecretCopy(argv, {
+          env: process.env,
+          host: {
+            platform: process.platform,
+            isWsl: process.platform === 'linux' && isWsl(process.env),
+            consoleIsMine: process.platform === 'darwin' && consoleIsMine(),
+          },
+          loadToken: () => tryReadCliToken(),
+          fetch: (url, init) => globalThis.fetch(url, init),
+          backend: (kind) => clipboardBackend(kind),
+          scheduleClear: (kind, value, seconds) => scheduleClear(kind, value, seconds),
+          stderr: (text) => process.stderr.write(text),
+        })
+      : runExec();
 
 function runExec() {
   return runSecretExec(argv, {

package/dist/clear-clipboard.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clear-clipboard.js

@@ -0,0 +1,22 @@
+/**
+ * `bluelamp-secret copy` が切り離して起こす子（箱 n=3738）: 標準入力で値を受け、秒数を待って、クリップボードがまだ
+ * その値なら空にする（持ち主が別の物をコピーしていたら触らない）。⛔ 何も出力しない。
+ *   node clear-clipboard.js <mac|windows|wsl> <秒>
+ */
+import { clipboardBackend } from './clipboard.js';
+const KINDS = ['mac', 'windows', 'wsl'];
+async function main() {
+    const kind = process.argv[2];
+    const seconds = Number(process.argv[3]);
+    if (!KINDS.includes(kind) || !Number.isFinite(seconds) || seconds < 0)
+        return;
+    const chunks = [];
+    for await (const c of process.stdin)
+        chunks.push(c);
+    const value = Buffer.concat(chunks).toString('utf8');
+    if (value === '')
+        return;
+    await new Promise((r) => setTimeout(r, seconds * 1000));
+    await clipboardBackend(kind).clearIfSame(value);
+}
+main().then(() => process.exit(0), () => process.exit(1));

package/dist/clipboard.d.ts

@@ -0,0 +1,20 @@
+import { type DialogAnswer, type DialogKind } from './copy.js';
+export interface ClipboardBackend {
+    /** 窓を出して答えを待つ（choices が null なら確認だけ） */
+    dialog(prompt: string, choices: readonly string[] | null): Promise<DialogAnswer>;
+    /** 値をクリップボードへ置く。置けたら true */
+    write(value: string): Promise<boolean>;
+    /** クリップボードがまだ値と同じなら空にする */
+    clearIfSame(value: string): Promise<'cleared' | 'changed' | 'failed'>;
+}
+/** 窓の種類に合う口を返す。WSL は Windows 側の powershell.exe を撃つ（窓とクリップボードは Windows の画面に出る） */
+export declare function clipboardBackend(kind: DialogKind): ClipboardBackend;
+/** WSL の中か（/proc/version に microsoft） */
+export declare function isWsl(env: Readonly<Record<string, string | undefined>>): boolean;
+/** Mac の画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false（＝窓を出さない） */
+export declare function consoleIsMine(): boolean;
+/**
+ * 後で消す子を切り離して起こす（親はすぐ終わる・子は秒数の後にまだ同じ値なら空にする）。値は子の標準入力で渡す。
+ * 🔑 detached＝別のプロセス群。撃った席のシェルが終わっても子は残って消しに行く。
+ */
+export declare function scheduleClear(kind: DialogKind, value: string, seconds: number): Promise<boolean>;

package/dist/clipboard.js

@@ -0,0 +1,133 @@
+/**
+ * `bluelamp-secret copy` の OS の口（箱 n=3738）— 確認の窓・クリップボード・後で消す子。判定は copy.ts（純粋関数）。
+ *
+ * 🔑 値の通り道は「index.ts → クリップボードの子（pbcopy／powershell）の標準入力」と「→ 後で消す子の標準入力」の 2 本だけ。
+ *    ⛔ 値を argv・env・ファイル・子の出力に載せない（子の stderr は捨て、stdout は窓の答え・ok/cleared の語だけを読む）。
+ * 🔑 パッケージの外へは出ない（package.json の exports に無い）。
+ */
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { MAC_CHOOSE_SCRIPT, MAC_CONFIRM_SCRIPT, WINDOWS_CLEAR_SCRIPT, WINDOWS_SET_SCRIPT, parseDialogAnswer, powerShellArgs, windowsDialogScript, } from './copy.js';
+/** pbcopy／pbpaste が文字化けしないように UTF-8 を名指す（親の LANG が空の機体がある） */
+const MAC_ENV = { ...process.env, LANG: 'en_US.UTF-8', LC_ALL: 'en_US.UTF-8' };
+const WSL_POWERSHELL = '/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe';
+/**
+ * 子を起こして stdout を読む。
+ * 🔑 窓を出す子は hide=false。Windows の windowsHide は STARTUPINFO に SW_HIDE を入れ、WinForms の最初の
+ *    ShowDialog がそれを受けて窓が見えないまま開く（🔬 2026-10-25 CI の Windows で実測: 窓は 120 秒開いたが上位の窓に出なかった）。
+ */
+function runChild(command, args, input, env, hide = true) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(command, [...args], { stdio: [input === null ? 'ignore' : 'pipe', 'pipe', 'ignore'], env, windowsHide: hide });
+        }
+        catch {
+            resolve({ code: 127, stdout: '' });
+            return;
+        }
+        const chunks = [];
+        child.stdout?.on('data', (c) => chunks.push(c));
+        child.on('error', () => resolve({ code: 127, stdout: '' }));
+        child.on('close', (code) => resolve({ code: code ?? 1, stdout: Buffer.concat(chunks).toString('utf8') }));
+        if (input !== null) {
+            child.stdin?.on('error', () => { });
+            child.stdin?.end(input, 'utf8');
+        }
+    });
+}
+function macBackend() {
+    return {
+        async dialog(prompt, choices) {
+            const args = choices === null ? ['-e', MAC_CONFIRM_SCRIPT, prompt] : ['-e', MAC_CHOOSE_SCRIPT, prompt, ...choices];
+            const r = await runChild('osascript', args, null);
+            return r.code === 0 ? parseDialogAnswer(r.stdout) : { kind: 'nogui' };
+        },
+        async write(value) {
+            return (await runChild('pbcopy', [], value, MAC_ENV)).code === 0;
+        },
+        async clearIfSame(value) {
+            const now = await runChild('pbpaste', [], null, MAC_ENV);
+            if (now.code !== 0)
+                return 'failed';
+            if (now.stdout !== value)
+                return 'changed';
+            return (await runChild('pbcopy', [], '', MAC_ENV)).code === 0 ? 'cleared' : 'failed';
+        },
+    };
+}
+function windowsBackend(powershell) {
+    return {
+        async dialog(prompt, choices) {
+            const r = await runChild(powershell, powerShellArgs(windowsDialogScript(prompt, choices)), null, undefined, false);
+            return r.code === 0 ? parseDialogAnswer(r.stdout) : { kind: 'nogui' };
+        },
+        async write(value) {
+            const r = await runChild(powershell, powerShellArgs(WINDOWS_SET_SCRIPT), value);
+            return r.code === 0 && r.stdout.trim() === 'ok';
+        },
+        async clearIfSame(value) {
+            const r = await runChild(powershell, powerShellArgs(WINDOWS_CLEAR_SCRIPT), value);
+            const s = r.stdout.trim();
+            if (r.code !== 0)
+                return 'failed';
+            return s === 'cleared' || s === 'changed' ? s : 'failed';
+        },
+    };
+}
+/** 窓の種類に合う口を返す。WSL は Windows 側の powershell.exe を撃つ（窓とクリップボードは Windows の画面に出る） */
+export function clipboardBackend(kind) {
+    if (kind === 'mac')
+        return macBackend();
+    if (kind === 'windows')
+        return windowsBackend('powershell.exe');
+    return windowsBackend(fs.existsSync(WSL_POWERSHELL) ? WSL_POWERSHELL : 'powershell.exe');
+}
+/** WSL の中か（/proc/version に microsoft） */
+export function isWsl(env) {
+    if (env.WSL_DISTRO_NAME)
+        return true;
+    try {
+        return /microsoft/i.test(fs.readFileSync('/proc/version', 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+/** Mac の画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false（＝窓を出さない） */
+export function consoleIsMine() {
+    try {
+        return typeof process.getuid === 'function' && fs.statSync('/dev/console').uid === process.getuid();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 後で消す子を切り離して起こす（親はすぐ終わる・子は秒数の後にまだ同じ値なら空にする）。値は子の標準入力で渡す。
+ * 🔑 detached＝別のプロセス群。撃った席のシェルが終わっても子は残って消しに行く。
+ */
+export function scheduleClear(kind, value, seconds) {
+    const script = fileURLToPath(new URL('./clear-clipboard.js', import.meta.url));
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(process.execPath, [script, kind, String(seconds)], {
+                detached: true,
+                stdio: ['pipe', 'ignore', 'ignore'],
+                windowsHide: true,
+            });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        child.on('error', () => resolve(false));
+        child.stdin?.on('error', () => resolve(false));
+        child.stdin?.end(value, 'utf8', () => {
+            child.unref();
+            resolve(true);
+        });
+    });
+}

package/dist/copy.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `bluelamp-secret copy` の判定と組み立て（箱 n=3738）— 純粋関数だけ。網・子プロセスは clipboard.ts と index.ts の deps。
+ *
+ * 🔑 決めるのは毎回、持ち主の画面に出る OS の確認の窓の「コピー」。席（Claude Code）が撃っても、窓を押さなければ入らない。
+ *    ⇒ 窓を出せない機体（ssh 越し・CI・GUI の無い Linux・他人の画面）では黙ってコピーせず断る。
+ * ⛔ ここに値は来ない（窓に出すのは金庫の名前だけ・値は index.ts の中でクリップボードの子の標準入力へ渡すだけ）。
+ */
+/** クリップボードに置いておく秒数（過ぎてまだその値なら空にする） */
+export declare const CLEAR_AFTER_SECONDS = 45;
+/** 名前の当てで窓に並べる最大の件数（多すぎる時は絞ってもらう） */
+export declare const MAX_CHOICES = 20;
+/** 確認の窓を開けておく秒数（押されなければ「やめる」と同じ） */
+export declare const DIALOG_TIMEOUT_SECONDS = 120;
+export type CopyParseResult = {
+    ok: true;
+    name: string;
+} | {
+    ok: false;
+    help: boolean;
+    error: string;
+};
+/** `copy <金庫の名前>` を解析する（`process.argv.slice(2)` を受ける）。⛔ 失敗の文言に引数の中身を引用しない */
+export declare function parseCopyArgs(argv: readonly string[]): CopyParseResult;
+/** 一覧の 1 件（値の列は無い） */
+export interface VaultListEntry {
+    service: string;
+    username?: string | null;
+}
+/** 一覧の応答から名前と利用者名だけを取り出す。形が違えば null（⛔ note など他の列は使わない） */
+export declare function readVaultList(body: unknown): VaultListEntry[] | null;
+export type NameMatch = {
+    kind: 'exact';
+    name: string;
+} | {
+    kind: 'candidates';
+    names: string[];
+    total: number;
+} | {
+    kind: 'none';
+};
+/**
+ * 名前を当てる。完全一致が在ればそれ。無ければ名前か利用者名に（大文字小文字を問わず）含む物を候補にする。
+ * 例: 「ishii」→「Google 役割アカウント（窓口の箱・ishii.s）」。同じ名前（自分の分と共有されてきた分）は 1 つに畳む。
+ */
+export declare function matchVaultName(entries: readonly VaultListEntry[], query: string): NameMatch;
+export type DialogKind = 'mac' | 'windows' | 'wsl';
+export interface HostInfo {
+    platform: string;
+    env: Readonly<Record<string, string | undefined>>;
+    /** Linux のとき WSL の中か */
+    isWsl: boolean;
+    /** Mac のとき、画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false */
+    consoleIsMine: boolean;
+}
+export type DialogSupport = {
+    ok: true;
+    kind: DialogKind;
+} | {
+    ok: false;
+    reason: string;
+};
+/** 確認の窓を持ち主の画面に出せるか（⛔ 出せない時は黙ってコピーしない） */
+export declare function detectDialogSupport(host: HostInfo): DialogSupport;
+/** 確認の窓に出す文 */
+export declare function confirmPrompt(name: string): string;
+/** 候補を選ぶ窓に出す文 */
+export declare function choosePrompt(query: string, shown: number, total: number): string;
+/** 確認の窓（argv: 文）。stdout に copy／cancel／nogui:<番号> */
+export declare const MAC_CONFIRM_SCRIPT: string;
+/** 候補を選ぶ窓（argv: 文, 候補…）。stdout に pick:<番号（0 から）>／cancel／nogui:<番号> */
+export declare const MAC_CHOOSE_SCRIPT: string;
+/** `-EncodedCommand` に渡す形（UTF-16LE の base64） */
+export declare function encodePowerShell(script: string): string;
+/** powershell.exe に渡す引数（スクリプトは encoded で渡す＝値はここに来ない） */
+export declare function powerShellArgs(script: string): string[];
+/**
+ * 窓（確認か候補選び）を出す PowerShell。stdout に copy／pick:<番号>／cancel／nogui。
+ * 🔑 session 0（サービス）や非対話では窓が誰にも見えない＝nogui。MessageBox はボタンの名前を変えられないので小さなフォームで出す。
+ */
+export declare function windowsDialogScript(prompt: string, choices: readonly string[] | null): string;
+/** 標準入力の値をクリップボードへ置く PowerShell（クリップボードの履歴・クラウド同期には載せない印を付ける） */
+export declare const WINDOWS_SET_SCRIPT: string;
+/** 標準入力の値とクリップボードが同じなら空にする PowerShell。stdout に cleared／changed */
+export declare const WINDOWS_CLEAR_SCRIPT: string;
+export type DialogAnswer = {
+    kind: 'copy';
+} | {
+    kind: 'pick';
+    index: number;
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'nogui';
+};
+/** 窓の子の stdout を答えにする（知らない形は nogui＝コピーしない側へ倒す） */
+export declare function parseDialogAnswer(stdout: string): DialogAnswer;

package/dist/copy.js

@@ -0,0 +1,207 @@
+/**
+ * `bluelamp-secret copy` の判定と組み立て（箱 n=3738）— 純粋関数だけ。網・子プロセスは clipboard.ts と index.ts の deps。
+ *
+ * 🔑 決めるのは毎回、持ち主の画面に出る OS の確認の窓の「コピー」。席（Claude Code）が撃っても、窓を押さなければ入らない。
+ *    ⇒ 窓を出せない機体（ssh 越し・CI・GUI の無い Linux・他人の画面）では黙ってコピーせず断る。
+ * ⛔ ここに値は来ない（窓に出すのは金庫の名前だけ・値は index.ts の中でクリップボードの子の標準入力へ渡すだけ）。
+ */
+/** クリップボードに置いておく秒数（過ぎてまだその値なら空にする） */
+export const CLEAR_AFTER_SECONDS = 45;
+/** 名前の当てで窓に並べる最大の件数（多すぎる時は絞ってもらう） */
+export const MAX_CHOICES = 20;
+/** 確認の窓を開けておく秒数（押されなければ「やめる」と同じ） */
+export const DIALOG_TIMEOUT_SECONDS = 120;
+/** `copy <金庫の名前>` を解析する（`process.argv.slice(2)` を受ける）。⛔ 失敗の文言に引数の中身を引用しない */
+export function parseCopyArgs(argv) {
+    if (argv[0] !== 'copy')
+        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put と copy だけ）' };
+    const rest = argv.slice(1);
+    if (rest.length === 0 || rest.includes('-h') || rest.includes('--help'))
+        return { ok: false, help: true, error: '' };
+    if (rest.some((a) => a.startsWith('-')))
+        return { ok: false, help: false, error: 'copy はオプションを受けません' };
+    if (rest.length !== 1)
+        return { ok: false, help: false, error: '金庫の名前は 1 つだけ書いてください（空白を含むなら "" で囲みます）' };
+    const name = rest[0];
+    if (name === '' || name === '.' || name === '..')
+        return { ok: false, help: false, error: '金庫の名前が使えない形です' };
+    return { ok: true, name };
+}
+/** 一覧の応答から名前と利用者名だけを取り出す。形が違えば null（⛔ note など他の列は使わない） */
+export function readVaultList(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    const b = body;
+    if (b.success !== true || !Array.isArray(b.data))
+        return null;
+    const out = [];
+    for (const e of b.data) {
+        if (!e || typeof e !== 'object')
+            continue;
+        const { service, username } = e;
+        if (typeof service !== 'string')
+            continue;
+        out.push({ service, username: typeof username === 'string' ? username : null });
+    }
+    return out;
+}
+/**
+ * 名前を当てる。完全一致が在ればそれ。無ければ名前か利用者名に（大文字小文字を問わず）含む物を候補にする。
+ * 例: 「ishii」→「Google 役割アカウント（窓口の箱・ishii.s）」。同じ名前（自分の分と共有されてきた分）は 1 つに畳む。
+ */
+export function matchVaultName(entries, query) {
+    if (entries.some((e) => e.service === query))
+        return { kind: 'exact', name: query };
+    const q = query.toLowerCase();
+    const names = [];
+    for (const e of entries) {
+        const hit = e.service.toLowerCase().includes(q) || (e.username ?? '').toLowerCase().includes(q);
+        if (hit && !names.includes(e.service))
+            names.push(e.service);
+    }
+    if (names.length === 0)
+        return { kind: 'none' };
+    return { kind: 'candidates', names: names.slice(0, MAX_CHOICES), total: names.length };
+}
+/** 確認の窓を持ち主の画面に出せるか（⛔ 出せない時は黙ってコピーしない） */
+export function detectDialogSupport(host) {
+    // 🔑 ssh 越しは窓が向こうの機体の画面に出る（撃った人の画面ではない）。CI は見ている人がいない。
+    if (host.env.SSH_CONNECTION || host.env.SSH_CLIENT || host.env.SSH_TTY) {
+        return { ok: false, reason: 'ssh 越しです' };
+    }
+    if (host.env.CI)
+        return { ok: false, reason: 'CI の中です' };
+    if (host.platform === 'darwin') {
+        return host.consoleIsMine ? { ok: true, kind: 'mac' } : { ok: false, reason: 'この利用者は画面にログインしていません' };
+    }
+    if (host.platform === 'win32')
+        return { ok: true, kind: 'windows' };
+    if (host.platform === 'linux' && host.isWsl)
+        return { ok: true, kind: 'wsl' };
+    return { ok: false, reason: 'この OS では確認の窓に対応していません' };
+}
+/** 確認の窓に出す文 */
+export function confirmPrompt(name) {
+    return `「${name}」のパスワードをクリップボードにコピーしますか？\n${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます。`;
+}
+/** 候補を選ぶ窓に出す文 */
+export function choosePrompt(query, shown, total) {
+    const more = total > shown ? `（${total} 件のうち ${shown} 件を出しています。名前を長く書くと絞れます）` : '';
+    return `「${query}」に当たる名前がいくつかあります。コピーするパスワードを選んでください。${more}\n${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます。`;
+}
+// ── Mac（osascript）。名前・文は argv で渡す（スクリプトに埋め込まない＝引用の崩れが無い） ──────────
+/** 確認の窓（argv: 文）。stdout に copy／cancel／nogui:<番号> */
+export const MAC_CONFIRM_SCRIPT = [
+    'on run argv',
+    'try',
+    'tell me to activate',
+    `set r to display dialog (item 1 of argv) with title "BlueLamp 金庫" buttons {"やめる", "コピー"} default button "コピー" cancel button "やめる" with icon caution giving up after ${DIALOG_TIMEOUT_SECONDS}`,
+    'on error number n',
+    'if n is -128 then return "cancel"',
+    'return "nogui:" & n',
+    'end try',
+    'if gave up of r then return "cancel"',
+    'return "copy"',
+    'end run',
+].join('\n');
+/** 候補を選ぶ窓（argv: 文, 候補…）。stdout に pick:<番号（0 から）>／cancel／nogui:<番号> */
+export const MAC_CHOOSE_SCRIPT = [
+    'on run argv',
+    'set p to item 1 of argv',
+    'set c to rest of argv',
+    'try',
+    'tell me to activate',
+    'set r to choose from list c with title "BlueLamp 金庫" with prompt p default items {item 1 of c} OK button name "コピー" cancel button name "やめる"',
+    'on error number n',
+    'return "nogui:" & n',
+    'end try',
+    'if r is false then return "cancel"',
+    'set picked to item 1 of r',
+    'repeat with i from 1 to count of c',
+    'if item i of c is picked then return "pick:" & (i - 1)',
+    'end repeat',
+    'return "cancel"',
+    'end run',
+].join('\n');
+// ── Windows（PowerShell）。文と候補は base64 の JSON で埋める・値は標準入力でだけ渡す ──────────
+/** `-EncodedCommand` に渡す形（UTF-16LE の base64） */
+export function encodePowerShell(script) {
+    return Buffer.from(script, 'utf16le').toString('base64');
+}
+/** powershell.exe に渡す引数（スクリプトは encoded で渡す＝値はここに来ない） */
+export function powerShellArgs(script) {
+    return ['-NoProfile', '-NonInteractive', '-Sta', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', encodePowerShell(script)];
+}
+/**
+ * 窓（確認か候補選び）を出す PowerShell。stdout に copy／pick:<番号>／cancel／nogui。
+ * 🔑 session 0（サービス）や非対話では窓が誰にも見えない＝nogui。MessageBox はボタンの名前を変えられないので小さなフォームで出す。
+ */
+export function windowsDialogScript(prompt, choices) {
+    const data = Buffer.from(JSON.stringify({ prompt, choices: choices ?? [] }), 'utf8').toString('base64');
+    return [
+        "$ErrorActionPreference = 'Stop'",
+        'try {',
+        "  if ((Get-Process -Id $PID).SessionId -eq 0 -or -not [Environment]::UserInteractive) { 'nogui'; exit 0 }",
+        '  Add-Type -AssemblyName System.Windows.Forms',
+        '  Add-Type -AssemblyName System.Drawing',
+        `  $d = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${data}')) | ConvertFrom-Json`,
+        '  $f = New-Object Windows.Forms.Form',
+        "  $f.Text = 'BlueLamp 金庫'; $f.TopMost = $true; $f.StartPosition = 'CenterScreen'",
+        "  $f.FormBorderStyle = 'FixedDialog'; $f.MinimizeBox = $false; $f.MaximizeBox = $false",
+        "  $f.AutoSize = $true; $f.AutoSizeMode = 'GrowAndShrink'; $f.Padding = New-Object Windows.Forms.Padding 12",
+        "  $p = New-Object Windows.Forms.FlowLayoutPanel; $p.FlowDirection = 'TopDown'; $p.AutoSize = $true; $p.AutoSizeMode = 'GrowAndShrink'",
+        '  $l = New-Object Windows.Forms.Label; $l.Text = $d.prompt; $l.AutoSize = $true; $l.MaximumSize = New-Object Drawing.Size 480, 0',
+        '  $p.Controls.Add($l)',
+        '  $lb = $null',
+        '  if (@($d.choices).Count -gt 0) {',
+        '    $lb = New-Object Windows.Forms.ListBox; $lb.Width = 460; $lb.Height = [Math]::Min(@($d.choices).Count, 12) * 20 + 8',
+        '    foreach ($c in $d.choices) { [void]$lb.Items.Add([string]$c) }',
+        '    $lb.SelectedIndex = 0; $p.Controls.Add($lb)',
+        '  }',
+        "  $bp = New-Object Windows.Forms.FlowLayoutPanel; $bp.FlowDirection = 'RightToLeft'; $bp.AutoSize = $true; $bp.Width = 460",
+        "  $ok = New-Object Windows.Forms.Button; $ok.Text = 'コピー'; $ok.Name = 'copy'; $ok.DialogResult = 'OK'; $ok.AutoSize = $true",
+        "  $ng = New-Object Windows.Forms.Button; $ng.Text = 'やめる'; $ng.Name = 'cancel'; $ng.DialogResult = 'Cancel'; $ng.AutoSize = $true",
+        '  $bp.Controls.Add($ng); $bp.Controls.Add($ok); $p.Controls.Add($bp)',
+        '  $f.AcceptButton = $ok; $f.CancelButton = $ng; $f.Controls.Add($p)',
+        `  $t = New-Object Windows.Forms.Timer; $t.Interval = ${DIALOG_TIMEOUT_SECONDS * 1000}`,
+        "  $t.Add_Tick({ $t.Stop(); $f.DialogResult = 'Cancel' }); $t.Start()",
+        '  $f.Add_Shown({ $f.Activate() })',
+        '  $r = $f.ShowDialog()',
+        "  if ($r -eq 'OK') { if ($lb) { 'pick:' + $lb.SelectedIndex } else { 'copy' } } else { 'cancel' }",
+        "} catch { 'nogui' }",
+    ].join('\n');
+}
+/** 標準入力の値をクリップボードへ置く PowerShell（クリップボードの履歴・クラウド同期には載せない印を付ける） */
+export const WINDOWS_SET_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    '[Console]::InputEncoding = New-Object Text.UTF8Encoding $false',
+    '$v = [Console]::In.ReadToEnd()',
+    'Add-Type -AssemblyName System.Windows.Forms',
+    '$o = New-Object Windows.Forms.DataObject',
+    '$o.SetData([Windows.Forms.DataFormats]::UnicodeText, $v)',
+    "foreach ($k in 'ExcludeClipboardContentFromMonitorProcessing', 'CanIncludeInClipboardHistory', 'CanUploadToCloudClipboard') {",
+    '  $o.SetData($k, (New-Object IO.MemoryStream (, [byte[]](0, 0, 0, 0))))',
+    '}',
+    '[Windows.Forms.Clipboard]::SetDataObject($o, $true)',
+    "'ok'",
+].join('\n');
+/** 標準入力の値とクリップボードが同じなら空にする PowerShell。stdout に cleared／changed */
+export const WINDOWS_CLEAR_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    '[Console]::InputEncoding = New-Object Text.UTF8Encoding $false',
+    '$v = [Console]::In.ReadToEnd()',
+    'Add-Type -AssemblyName System.Windows.Forms',
+    "if ([Windows.Forms.Clipboard]::GetText() -ceq $v) { [Windows.Forms.Clipboard]::Clear(); 'cleared' } else { 'changed' }",
+].join('\n');
+/** 窓の子の stdout を答えにする（知らない形は nogui＝コピーしない側へ倒す） */
+export function parseDialogAnswer(stdout) {
+    const s = stdout.trim();
+    if (s === 'copy')
+        return { kind: 'copy' };
+    if (s === 'cancel')
+        return { kind: 'cancel' };
+    const m = /^pick:(\d+)$/.exec(s);
+    if (m)
+        return { kind: 'pick', index: Number(m[1]) };
+    return { kind: 'nogui' };
+}

package/dist/handoff.d.ts

@@ -0,0 +1,51 @@
+/** 子の env に金庫の値を入れる仮の名（exec 前に unset する）。 */
+export declare const CRED_ENV_NAME = "MO_ACCOUNT_CRED";
+/**
+ * 金庫の値から accessToken を取り出して stdout に出す（`node -e` に渡す本文）。
+ * 🔐 本文に値は無い（値は env から読む）。stdout はコマンド置換（pipe）で受けるのでディスクに落ちない。
+ */
+export declare const EXTRACT_TOKEN_JS: string;
+/** 取り出せるかだけを終了コードで返す本文（0＝取り出せる・97＝形が違う／空）。⛔ 何も出力しない */
+export declare const PROBE_TOKEN_JS: string;
+/**
+ * 値を受けて exec する sh の本文（`$1`=node・`$2`=取り出す本文・`$3`=元の command）。
+ * 値は `$(…)` で変数に受けるだけ＝argv に出ない。仮の名は exec 前に unset。
+ */
+export declare const HANDOFF_SH: string;
+/** 金庫の名前に許す文字（シェルの 1 語にそのまま載るので狭く取る） */
+export declare const VAULT_NAME_RE: RegExp;
+/** POSIX sh の 1 語にクォートする（純関数） */
+export declare function shellQuote(s: string): string;
+export interface HandoffBins {
+    /** node の絶対パス（launchd の貧しい PATH に依らない） */
+    node: string;
+    /** bluelamp-secret の実体（.mjs）の絶対パス。shebang の `env node` に依らないよう node で直接起こす */
+    secretExec: string;
+}
+/**
+ * `command` を「金庫 `vaultName` の鍵を `CLAUDE_CODE_OAUTH_TOKEN` に入れてから exec する」sh の 1 行に包む（純関数）。
+ * 外側の `env -u CLAUDE_CODE_OAUTH_TOKEN`（親の継承を切る多重防御）は呼び手が付ける。
+ */
+export declare function buildCredentialHandoff(command: string, vaultName: string, bins: HandoffBins): string;
+/** 取り出せるかだけを確かめる argv（純関数・シェルを通さず spawn する）。 */
+export declare function buildCredentialProbeArgv(vaultName: string, bins: HandoffBins): string[];
+/** 金庫の鍵を取り出せるか（I/O）。⛔ stdout／stderr は捨てる（値は出ないが、bluelamp-secret の案内も呼び手に返さない） */
+export declare function probeCredential(vaultName: string, bins: HandoffBins, timeoutMs?: number): {
+    ok: boolean;
+    exitCode: number | null;
+};
+export declare const SECRET_EXEC_NAME = "bluelamp-secret";
+/**
+ * bluelamp-secret を探す先（純関数・箱 n=2730）。順は
+ * 呼び手の上書き（env の値・先頭から）→ /opt/homebrew/bin → /usr/local/bin → PATH の各段 → node と同じ bin（npm の既定 prefix）。
+ * Mac の 2 か所を PATH より前に置く＝launchd の貧しい PATH でも、Mac で選ばれる実体は変わらない。
+ */
+export declare function secretExecCandidates(env: NodeJS.ProcessEnv, execPath: string, overrideEnvNames?: readonly string[]): string[];
+export interface HandoffBinsDeps {
+    env: NodeJS.ProcessEnv;
+    execPath: string;
+    realpath: (p: string) => string;
+    npmGlobal: () => string | null;
+}
+/** node / bluelamp-secret の絶対パスを決める。見つからなければ null（呼び手が自分の言葉でエラーにする）。 */
+export declare function resolveHandoffBins(overrideEnvNames?: readonly string[], deps?: Partial<HandoffBinsDeps>): HandoffBins | null;

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）と
+ *   `bluelamp-secret copy`（箱 n=3738・末尾の copy の節）
+ *
+ * 🔒 これは「値を返さない口」である（実装より先に書いた線・README の冒頭と同じ）。
+ *   取れるのは「金庫にその名前が在るか無いか」と「値を使えるか（子プロセスが env で受けて走れたか＝終了コード）」だけ。
+ *   ⛔ 値を標準出力・標準エラー・戻り値・ファイル・argv・ログ・エラーの文言に出す口を作らない。
+ *   ⛔ 値を返す関数を export しない（呼び手に値を渡す API を足したくなったら、それはこのパッケージの仕事ではない）。
+ */
+/**
+ * 🕳 塞いでいる穴: MCP の `get_secret` は値を返り値にしていたため、値が会話の転写に残った。
+ *   その口を閉じると、値を Bash で使っていた手順（21 日で 235 回）が壊れる。⇒ 値を「見せずに使う」口をここに置く。
+ *
+ * 🔑 値の通り道は「金庫の HTTP 応答 → 子の env」の 1 本だけ。
+ *   ⛔ HTTP の本文・fetch の例外をそのまま出さない（本文は値を、例外は要求を引用しうる）。
+ *      失敗は「どの ENV 名・どの金庫の名前が・なぜ」だけを返す。
+ * 🔑 パッケージの外へ出す API は無い（package.json の exports は package.json だけ）。
+ *   下の export は同じパッケージの bin と unit テストのためのもの。値を返す関数は export しない（`extractSecretValue` は非公開）。`runSecretExec` の戻り値は終了コードだけ。
+ * 🔑 使用の記録: `GET /vault/:service` は backend 側で監査 `get`（誰が・どの秘密を）を 1 行書く。
+ *
+ * 判定と組み立ては純粋関数（unit で直接撃つ）、網と子プロセスは `runSecretExec` の deps に寄せる。
+ */
+import type { ClipboardBackend } from './clipboard.js';
+import { type DialogKind, type HostInfo } from './copy.js';
+/** ENV 名として受ける形。⛔ これ以外（小文字・記号・先頭数字）は受けない */
+export declare const ENV_NAME_PATTERN: RegExp;
+/** 既定のポータル API（bluelamp CLI の portal-api-client・TokenManager と同じ値） */
+export declare const DEFAULT_PORTAL_API_BASE_URL = "https://api.motohi.jp/api/bluelamp";
+export declare const USAGE: string;
+export interface SecretBinding {
+    env: string;
+    name: string;
+}
+export type ParseResult = {
+    ok: true;
+    bindings: SecretBinding[];
+    command: string;
+    args: string[];
+} | {
+    ok: false;
+    help: boolean;
+    error: string;
+};
+/** 引数を解析する（`process.argv.slice(2)` を受ける）。値はここに来ない＝金庫の名前だけ */
+export declare function parseExecArgs(argv: readonly string[]): ParseResult;
+/** 基底 URL（BLUELAMP_PORTAL_API_BASE_URL > PORTAL_URL > 既定。portal-api-client.cjs と同じ順） */
+export declare function resolvePortalApiBaseUrl(env: Readonly<Record<string, string | undefined>>): string;
+/**
+ * 金庫の 1 件を引く URL。
+ * 🔑 vault の sub-app は内部で `/api/vault/...` に経路を切るが、bluelamp module ごと `/api/bluelamp` に
+ *    載っているので外から見える経路は `<base>/vault/...`（base は /api/bluelamp まで含む）。
+ *    🔬 実測（無認証）: `/api/bluelamp/api/vault/x` → 404／`/api/bluelamp/vault/x` → 401。
+ *    mcp-list/bluelamp/playwright/src/fillSecret.ts の VAULT_FILL_PATH と同じ結論。
+ */
+export declare function buildVaultUrl(baseUrl: string, name: string): string;
+/** 子の env を合成する（親を書き換えない） */
+export declare function composeChildEnv(parentEnv: Readonly<Record<string, string | undefined>>, values: Readonly<Record<string, string>>): Record<string, string>;
+/** HTTP の状態を理由の文言にする（⛔ 本文は使わない） */
+export declare function describeVaultStatus(status: number): string;
+/** 子の終わり方を終了コードにする（シグナルは 128+番号＝シェルと同じ） */
+export declare function exitCodeOf(code: number | null, signal: string | null, signalNumbers: Readonly<Record<string, number>>): number;
+interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}
+type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<FetchResponseLike>;
+interface ChildLike {
+    on(event: 'exit', cb: (code: number | null, signal: string | null) => void): unknown;
+    on(event: 'error', cb: (err: {
+        code?: string;
+    }) => void): unknown;
+    kill(signal?: string): unknown;
+}
+export interface SecretExecDeps {
+    env: Readonly<Record<string, string | undefined>>;
+    loadToken: () => string | null;
+    fetch: FetchLike;
+    spawn: (command: string, args: string[], options: {
+        stdio: 'inherit';
+        shell: false;
+        env: Record<string, string>;
+    }) => ChildLike;
+    stderr: (text: string) => void;
+    signalNumbers: Readonly<Record<string, number>>;
+    /** 親が受けたシグナルを子へ回す口（無ければ回さない）。戻り値は解除関数 */
+    onParentSignal?: (forward: (signal: string) => void) => () => void;
+}
+/** 実行する。戻り値は終了コード */
+export declare function runSecretExec(argv: readonly string[], deps: SecretExecDeps): Promise<number>;
+/**
+ * 🔒 exec と対になる「値を会話に出さない書き込みの口」。
+ *   値の通り道は「標準入力（か --file のファイル）→ 金庫への POST 本文」の 1 本だけ。
+ *   ⛔ 値を引数で受けない（argv はプロセス一覧と転写に残る）。⛔ 値・HTTP の本文を出力に出さない。
+ * 🔑 金庫の POST は同じ名前を黙って上書きする（🔬 2026-10-05 本番で実測）。⇒ --force が無ければ
+ *    先に一覧（値を含まない）で「自分の金庫に同じ名前が在るか」を見て止める。共有されてきた同名は
+ *    自分の金庫には無いので止めない（書けば自分の側に別の 1 件ができ、exec は自分の側を先に引く）。
+ * 🔑 保存の後に読み戻して一致を確かめる（読み戻しは exec と同じ GET＝監査に get が 1 行残る）。
+ */
+export interface PutOptions {
+    name: string;
+    note?: string;
+    username?: string;
+    /** --url から導いた origin（scheme+host+port）。金庫の列は bound_origins */
+    origin?: string;
+    file?: string;
+    force: boolean;
+}
+export type PutParseResult = {
+    ok: true;
+    options: PutOptions;
+} | {
+    ok: false;
+    help: boolean;
+    error: string;
+};
+/** --url を origin に畳む（http/https だけ受ける）。畳めなければ null */
+export declare function deriveOrigin(raw: string): string | null;
+/**
+ * put の引数を解析する（`process.argv.slice(2)` を受ける）。
+ * ⛔ 失敗の文言に、知らない引数や余分な位置引数の中身を引用しない（値を引数に書き間違えた場合に値が出るため）。
+ */
+export declare function parsePutArgs(argv: readonly string[]): PutParseResult;
+export interface SecretPutDeps {
+    env: Readonly<Record<string, string | undefined>>;
+    loadToken: () => string | null;
+    fetch: FetchLike;
+    /** 標準入力が端末か */
+    stdinIsTTY: () => boolean;
+    /** 標準入力を最後まで読む（⛔ 失敗時の例外の文言は出さない） */
+    readStdin: () => Promise<string>;
+    readFile: (path: string) => Promise<string>;
+    stderr: (text: string) => void;
+}
+/** put を実行する。戻り値は終了コード（0 保存して一致／1 失敗／2 引数・入力の形／3 既に在る） */
+export declare function runSecretPut(argv: readonly string[], deps: SecretPutDeps): Promise<number>;
+/**
+ * 🔒 決めるのは毎回、持ち主の画面の窓。値の通り道は「金庫の GET → クリップボードの子の標準入力（と後で消す子の標準入力）」だけ。
+ *   ⛔ 値を出力に出さない（出すのは「コピーしました」「やめました」と理由だけ）。⛔ 窓を出せない機体では黙ってコピーしない。
+ * 🔑 名前は一覧（値の列を持たない）で先に当てる＝窓で「やめる」を押されたら金庫の値は引かない（監査の get も残らない）。
+ * 終了コード: 0 コピーした／1 失敗／2 引数の形／3 やめた／4 窓を出せない
+ */
+export interface SecretCopyDeps {
+    env: Readonly<Record<string, string | undefined>>;
+    host: Omit<HostInfo, 'env'>;
+    loadToken: () => string | null;
+    fetch: FetchLike;
+    backend: (kind: DialogKind) => Pick<ClipboardBackend, 'dialog' | 'write'>;
+    scheduleClear: (kind: DialogKind, value: string, seconds: number) => Promise<boolean>;
+    stderr: (text: string) => void;
+}
+export declare function runSecretCopy(argv: readonly string[], deps: SecretCopyDeps): Promise<number>;
+export {};

package/dist/index.js

@@ -1,5 +1,6 @@
 /**
- * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）
+ * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）と
+ *   `bluelamp-secret copy`（箱 n=3738・末尾の copy の節）
  *
  * 🔒 これは「値を返さない口」である（実装より先に書いた線・README の冒頭と同じ）。
  *   取れるのは「金庫にその名前が在るか無いか」と「値を使えるか（子プロセスが env で受けて走れたか＝終了コード）」だけ。
@@ -19,6 +20,7 @@
  *
  * 判定と組み立ては純粋関数（unit で直接撃つ）、網と子プロセスは `runSecretExec` の deps に寄せる。
  */
+import { CLEAR_AFTER_SECONDS, choosePrompt, confirmPrompt, detectDialogSupport, matchVaultName, parseCopyArgs, readVaultList, } from './copy.js';
 /** ENV 名として受ける形。⛔ これ以外（小文字・記号・先頭数字）は受けない */
 export const ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
 /** 既定のポータル API（bluelamp CLI の portal-api-client・TokenManager と同じ値） */
@@ -28,7 +30,10 @@ export const USAGE = '使い方: bluelamp-secret exec <ENV名>=<金庫の名前>
     '  値は画面・引数・ログに出ません。シェルの展開が要るときは -- sh -c \'psql "$PGURL" -c "select 1"\' のように渡します。\n' +
     '使い方: <値を出すコマンド> | bluelamp-secret put <金庫の名前> [--note 文] [--username 名] [--url URL] [--file パス] [--force]\n' +
     '  値を標準入力（または --file のファイル）から読んで金庫へ入れ、読み戻して一致を確かめます。末尾の改行 1 つは落とします。\n' +
-    '  既に在る名前は --force が無ければ止まります。標準入力が端末なら受けません（打ち込んだ値が画面に残るため）。\n';
+    '  既に在る名前は --force が無ければ止まります。標準入力が端末なら受けません（打ち込んだ値が画面に残るため）。\n' +
+    '使い方: bluelamp-secret copy "<金庫の名前>"\n' +
+    '  持ち主の画面に確認の窓を出し、「コピー」を押したときだけ値をクリップボードへ入れます（45 秒で消えます）。\n' +
+    '  名前が完全に一致しなければ、当たる候補を窓に並べて選んでもらいます。窓を出せない機体（ssh 越し・CI など）では断ります。\n';
 /** `.`／`..` は URL の区間として解決され、金庫の外の経路を指してしまう（%2E も URL 側で同じに扱われる） */
 function isUsableVaultName(name) {
     return name !== '' && name !== '.' && name !== '..';
@@ -39,7 +44,7 @@ export function parseExecArgs(argv) {
         return { ok: false, help: true, error: '' };
     }
     if (argv[0] !== 'exec') {
-        return { ok: false, help: false, error: `不明な操作です（受けるのは exec と put だけ）` };
+        return { ok: false, help: false, error: `不明な操作です（受けるのは exec と put と copy だけ）` };
     }
     const sep = argv.indexOf('--');
     if (sep === -1) {
@@ -250,7 +255,7 @@ const PUT_VALUE_OPTIONS = ['--note', '--username', '--url', '--file'];
  */
 export function parsePutArgs(argv) {
     if (argv[0] !== 'put')
-        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put だけ）' };
+        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put と copy だけ）' };
     const rest = argv.slice(1);
     if (rest.length === 0 || rest.includes('-h') || rest.includes('--help'))
         return { ok: false, help: true, error: '' };
@@ -422,3 +427,88 @@ export async function runSecretPut(argv, deps) {
     deps.stderr(`${PREFIX}${name}: 保存しました（${value.length} 文字・読み戻して一致）\n`);
     return 0;
 }
+export async function runSecretCopy(argv, deps) {
+    const parsed = parseCopyArgs(argv);
+    if (!parsed.ok) {
+        if (parsed.help) {
+            deps.stderr(USAGE);
+            return argv.length <= 1 ? 2 : 0;
+        }
+        deps.stderr(`${PREFIX}${parsed.error}\n${USAGE}`);
+        return 2;
+    }
+    const query = parsed.name;
+    const support = detectDialogSupport({ ...deps.host, env: deps.env });
+    if (!support.ok) {
+        deps.stderr(`${PREFIX}確認の窓を出せないのでコピーしません（${support.reason}）\n`);
+        return 4;
+    }
+    const token = deps.loadToken();
+    if (!token) {
+        deps.stderr(`${PREFIX}未ログインです（bluelamp1 などでログインしてから撃ってください）\n`);
+        return 1;
+    }
+    const baseUrl = resolvePortalApiBaseUrl(deps.env);
+    let entries = null;
+    try {
+        const res = await deps.fetch(`${baseUrl}/vault/list`, { method: 'GET', headers: cliHeaders(token) });
+        if (!res.ok) {
+            deps.stderr(`${PREFIX}金庫の一覧を引けませんでした（${describeVaultStatus(res.status)}）\n`);
+            return 1;
+        }
+        entries = readVaultList(await res.json());
+    }
+    catch {
+        entries = null;
+    }
+    if (entries === null) {
+        deps.stderr(`${PREFIX}金庫の一覧を読めませんでした\n`);
+        return 1;
+    }
+    const match = matchVaultName(entries, query);
+    if (match.kind === 'none') {
+        deps.stderr(`${PREFIX}${query}: 金庫に当たる名前がありません\n`);
+        return 1;
+    }
+    const backend = deps.backend(support.kind);
+    let name;
+    if (match.kind === 'exact') {
+        const answer = await backend.dialog(confirmPrompt(match.name), null);
+        if (answer.kind === 'nogui')
+            return refuseNoGui(deps);
+        if (answer.kind !== 'copy')
+            return cancelled(deps);
+        name = match.name;
+    }
+    else {
+        const answer = await backend.dialog(choosePrompt(query, match.names.length, match.total), match.names);
+        if (answer.kind === 'nogui')
+            return refuseNoGui(deps);
+        if (answer.kind !== 'pick' || match.names[answer.index] === undefined)
+            return cancelled(deps);
+        name = match.names[answer.index];
+    }
+    const got = await fetchSecretValue(deps.fetch, baseUrl, token, name);
+    if (!got.ok) {
+        deps.stderr(`${PREFIX}${name}: ${got.reason}（コピーしていません）\n`);
+        return 1;
+    }
+    if (!(await backend.write(got.value))) {
+        deps.stderr(`${PREFIX}${name}: クリップボードに入れられませんでした\n`);
+        return 1;
+    }
+    if (!(await deps.scheduleClear(support.kind, got.value, CLEAR_AFTER_SECONDS))) {
+        deps.stderr(`${PREFIX}${name}: コピーしました。ただし ${CLEAR_AFTER_SECONDS} 秒後に消す仕掛けを起こせませんでした（使い終わったら別の物をコピーして上書きしてください）\n`);
+        return 0;
+    }
+    deps.stderr(`${PREFIX}${name}: コピーしました（${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます）\n`);
+    return 0;
+}
+function refuseNoGui(deps) {
+    deps.stderr(`${PREFIX}確認の窓を出せないのでコピーしません（画面に窓を出せませんでした）\n`);
+    return 4;
+}
+function cancelled(deps) {
+    deps.stderr(`${PREFIX}やめました（クリップボードは変えていません）\n`);
+    return 3;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bluelamp/secret-exec",
-  "version": "0.3.0",
-  "description": "金庫の値を子プロセスの環境変数にだけ入れてコマンドを実行し（exec）、標準入力から金庫へ入れる（put）。値を画面・引数・ログに出さない口",
+  "version": "0.4.0",
+  "description": "金庫の値を子プロセスの環境変数にだけ入れてコマンドを実行し（exec）、標準入力から金庫へ入れる（put）・持ち主の確認の窓でクリップボードへ入れる（copy）。値を画面・引数・ログに出さない口",
   "keywords": [
     "bluelamp",
     "cli",
@@ -12,7 +12,10 @@
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
-    "./handoff": "./dist/handoff.js"
+    "./handoff": {
+      "types": "./dist/handoff.d.ts",
+      "default": "./dist/handoff.js"
+    }
   },
   "bin": {
     "bluelamp-secret": "./bin/bluelamp-secret.mjs"