promptkaizen-agent 0.1.0 → 0.3.0

package/dist/console-safe.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Windows のレガシーコンソール (conhost / Windows PowerShell のラスタ・Consolas フォント) は
+ * 絵文字 (✅ ❌ ⚠️ 🔴 …) をグリフを持たず □ (tofu) として表示してしまう。
+ * セットアップは PowerShell を右クリック→管理者として実行する前提なので、ここで CLI 出力の
+ * 絵文字を ASCII 記号へ変換し、文字化けを防ぐ。
+ *
+ * Windows Terminal (WT_SESSION) や VS Code 統合ターミナルなど絵文字を描画できる環境では
+ * そのまま絵文字を残す。PROMPTKAIZEN_ASCII=1/0 で強制切り替えも可能。
+ *
+ * 注意: console 出力 (表示) のみを変換する。クラウド送信やファイル書き込みのデータには触れない。
+ */
+/** ASCII フォールバックを使うべきか。Windows のレガシーコンソールのみ true。 */
+export declare function shouldUseAsciiFallback(): boolean;
+/** 文字列内の絵文字を ASCII 記号へ置換する。 */
+export declare function toAsciiSafe(s: string): string;
+/**
+ * 必要な環境でのみ console.log / console.error / console.warn をラップし、
+ * 文字列引数を ASCII セーフに変換する。CLI エントリポイントの先頭で一度だけ呼ぶ。
+ */
+export declare function installConsoleSafe(): void;
+//# sourceMappingURL=console-safe.d.ts.map

package/dist/console-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-safe.d.ts","sourceRoot":"","sources":["../src/console-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,qDAAqD;AACrD,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}

package/dist/console-safe.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Windows のレガシーコンソール (conhost / Windows PowerShell のラスタ・Consolas フォント) は
+ * 絵文字 (✅ ❌ ⚠️ 🔴 …) をグリフを持たず □ (tofu) として表示してしまう。
+ * セットアップは PowerShell を右クリック→管理者として実行する前提なので、ここで CLI 出力の
+ * 絵文字を ASCII 記号へ変換し、文字化けを防ぐ。
+ *
+ * Windows Terminal (WT_SESSION) や VS Code 統合ターミナルなど絵文字を描画できる環境では
+ * そのまま絵文字を残す。PROMPTKAIZEN_ASCII=1/0 で強制切り替えも可能。
+ *
+ * 注意: console 出力 (表示) のみを変換する。クラウド送信やファイル書き込みのデータには触れない。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldUseAsciiFallback = shouldUseAsciiFallback;
+exports.toAsciiSafe = toAsciiSafe;
+exports.installConsoleSafe = installConsoleSafe;
+/** 絵文字 → ASCII 記号。status / report / enable など全コマンドの表示に効く。 */
+const ASCII_MAP = [
+    [/✅/g, '[OK]'],
+    [/✓/g, '[OK]'],
+    [/❌/g, '[NG]'],
+    [/✗/g, '[NG]'],
+    [/⚠️/g, '[!]'],
+    [/⚠/g, '[!]'],
+    // 信号機絵文字は「重要度」と「スコア健全性」の両義で使われるため、どちらでも自然に
+    // 読める記号にする (🔴=要対応, 🟡=注意, 🟢=良好)
+    [/🔴/g, '[!!]'],
+    [/🟡/g, '[!]'],
+    [/🟢/g, '[OK]'],
+    [/️/g, ''], // 単独で残った異体字セレクタを除去
+];
+/** ASCII フォールバックを使うべきか。Windows のレガシーコンソールのみ true。 */
+function shouldUseAsciiFallback() {
+    const force = process.env.PROMPTKAIZEN_ASCII;
+    if (force === '1')
+        return true;
+    if (force === '0')
+        return false;
+    if (process.platform !== 'win32')
+        return false;
+    // 絵文字を描画できる新しめのターミナルは除外
+    if (process.env.WT_SESSION)
+        return false; // Windows Terminal
+    if (process.env.TERM_PROGRAM === 'vscode')
+        return false; // VS Code 統合ターミナル
+    return true; // 旧来の conhost / Windows PowerShell
+}
+/** 文字列内の絵文字を ASCII 記号へ置換する。 */
+function toAsciiSafe(s) {
+    let out = s;
+    for (const [re, rep] of ASCII_MAP)
+        out = out.replace(re, rep);
+    return out;
+}
+/**
+ * 必要な環境でのみ console.log / console.error / console.warn をラップし、
+ * 文字列引数を ASCII セーフに変換する。CLI エントリポイントの先頭で一度だけ呼ぶ。
+ */
+function installConsoleSafe() {
+    if (!shouldUseAsciiFallback())
+        return;
+    const wrap = (orig) => {
+        return (...args) => {
+            orig(...args.map((a) => (typeof a === 'string' ? toAsciiSafe(a) : a)));
+        };
+    };
+    console.log = wrap(console.log.bind(console));
+    console.error = wrap(console.error.bind(console));
+    console.warn = wrap(console.warn.bind(console));
+}
+//# sourceMappingURL=console-safe.js.map

package/dist/console-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-safe.js","sourceRoot":"","sources":["../src/console-safe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAmBH,wDASC;AAGD,kCAIC;AAMD,gDAUC;AAjDD,6DAA6D;AAC7D,MAAM,SAAS,GAA4B;IACzC,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,IAAI,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,kCAAkC;IAClC,CAAC,KAAK,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,KAAK,EAAE,MAAM,CAAC;IACf,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,mBAAmB;CAChC,CAAA;AAED,qDAAqD;AACrD,SAAgB,sBAAsB;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC5C,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC9B,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,KAAK,CAAA;IAC/B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAA;IAC9C,wBAAwB;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA,CAAC,mBAAmB;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA,CAAC,kBAAkB;IAC1E,OAAO,IAAI,CAAA,CAAC,mCAAmC;AACjD,CAAC;AAED,+BAA+B;AAC/B,SAAgB,WAAW,CAAC,CAAS;IACnC,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,SAAS;QAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC7D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,IAAI,CAAC,sBAAsB,EAAE;QAAE,OAAM;IACrC,MAAM,IAAI,GAAG,CAAC,IAAkC,EAAE,EAAE;QAClD,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;YAClC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACxE,CAAC,CAAA;IACH,CAAC,CAAA;IACD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AACjD,CAAC"}

package/dist/detection-secret.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HMAC 鍵を解決する。優先順:
+ * 1. agent 設定 `detection.hmacSecret`
+ * 2. 既存の鍵ファイル (~/.promptkaizen/detection-secret)
+ * 3. 初回起動時に生成して同ファイルへ保存 (mode 600)
+ */
+export declare function loadOrCreateDetectionSecret(configSecret?: string, secretPath?: string): Promise<string>;
+//# sourceMappingURL=detection-secret.d.ts.map

package/dist/detection-secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection-secret.d.ts","sourceRoot":"","sources":["../src/detection-secret.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/detection-secret.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadOrCreateDetectionSecret = loadOrCreateDetectionSecret;
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// pii/pii_jp の matchHash (HMAC-SHA256) に使うローカルシークレット (Issue #42)。
+// マイナンバー等の低エントロピー値を無塩ハッシュで送ると総当たりで復元できてしまう
+// ため、鍵付きハッシュにする。鍵はローカルにのみ保持し、クラウドへは送らない。
+const DEFAULT_SECRET_PATH = path_1.default.join(os_1.default.homedir(), '.promptkaizen', 'detection-secret');
+/**
+ * HMAC 鍵を解決する。優先順:
+ * 1. agent 設定 `detection.hmacSecret`
+ * 2. 既存の鍵ファイル (~/.promptkaizen/detection-secret)
+ * 3. 初回起動時に生成して同ファイルへ保存 (mode 600)
+ */
+async function loadOrCreateDetectionSecret(configSecret, secretPath = DEFAULT_SECRET_PATH) {
+    if (configSecret)
+        return configSecret;
+    try {
+        const existing = (await promises_1.default.readFile(secretPath, 'utf8')).trim();
+        if (existing.length >= 32)
+            return existing;
+    }
+    catch {
+        // ファイルなし (初回起動) → 下で生成する
+    }
+    const secret = (0, crypto_1.randomBytes)(32).toString('hex');
+    await promises_1.default.mkdir(path_1.default.dirname(secretPath), { recursive: true });
+    await promises_1.default.writeFile(secretPath, secret + '\n', { mode: 0o600 });
+    // Windows は mode 600 が無視されるため、ACL で本人のみに制限する (Issue #61 方針)。
+    // 継承 ACE を外し (inheritance:r)、現在ユーザーへのフルコントロールだけ付与する。
+    // 失敗しても鍵自体は機能する (相関がローカルに限定されるだけ) ので best-effort。
+    if (process.platform === 'win32') {
+        try {
+            (0, child_process_1.execFileSync)('icacls', [secretPath, '/inheritance:r', '/grant:r', `${os_1.default.userInfo().username}:F`], { stdio: 'ignore' });
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return secret;
+}
+//# sourceMappingURL=detection-secret.js.map

package/dist/detection-secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection-secret.js","sourceRoot":"","sources":["../src/detection-secret.ts"],"names":[],"mappings":";;;;;AAkBA,kEA6BC;AA/CD,iDAA4C;AAC5C,mCAAoC;AACpC,2DAA4B;AAC5B,4CAAmB;AACnB,gDAAuB;AAEvB,kEAAkE;AAClE,2CAA2C;AAC3C,yCAAyC;AAEzC,MAAM,mBAAmB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAA;AAExF;;;;;GAKG;AACI,KAAK,UAAU,2BAA2B,CAC/C,YAAqB,EACrB,aAAqB,mBAAmB;IAExC,IAAI,YAAY;QAAE,OAAO,YAAY,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/D,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO,QAAQ,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9C,MAAM,kBAAE,CAAC,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7D,MAAM,kBAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,6DAA6D;IAC7D,qDAAqD;IACrD,kDAAkD;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,IAAA,4BAAY,EACV,QAAQ,EACR,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,YAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,IAAI,CAAC,EACzE,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/env-detect.d.ts

@@ -0,0 +1,44 @@
+export type DetectedTool = 'claude_code' | 'codex';
+export interface ToolDetection {
+    tool: DetectedTool;
+    label: string;
+    /** 検出に採用したディレクトリ (存在する候補のうちセッション数最大)。未検出なら null。 */
+    basePath: string | null;
+    present: boolean;
+    /** Claude: project ディレクトリ数。Codex は概念がないため 0。 */
+    projects: number;
+    /** *.jsonl セッションファイル数。 */
+    sessions: number;
+    /** watchPaths 用の glob (~ 圧縮済み)。未検出なら null。 */
+    watchGlob: string | null;
+}
+export interface EnvironmentDetection {
+    platform: NodeJS.Platform;
+    isWSL: boolean;
+    home: string;
+    tools: ToolDetection[];
+    /** 検出されたツールのみ。 */
+    detected: ToolDetection[];
+    anyDetected: boolean;
+    /** 検出ツールの watch glob 一覧 (config.watchPaths に使える)。 */
+    watchPaths: string[];
+}
+export interface DetectOptions {
+    homeDir?: string;
+    platform?: NodeJS.Platform;
+    isWSL?: boolean;
+    /** WSL 時に探索する Windows ユーザーディレクトリ (/mnt/c/Users/<u>)。テスト注入可。 */
+    windowsUserDirs?: string[];
+    /** ディレクトリ walk の深さ上限 (暴走防止)。 */
+    maxDepth?: number;
+}
+/** WSL 上で動いているか (/proc/version に microsoft/WSL を含むか)。 */
+export declare function detectWSL(platform?: NodeJS.Platform): boolean;
+/**
+ * 環境を検出する。各ツールについて候補ベース (ホーム + WSL の Windows ユーザー) を評価し、
+ * 「存在する候補のうちセッション数が最大のもの」を採用する。
+ */
+export declare function detectEnvironment(opts?: DetectOptions): Promise<EnvironmentDetection>;
+/** 検出結果を人間向けの要約行に整形する (例: `Claude Code : 12 projects / 348 sessions`)。 */
+export declare function formatDetectionSummary(env: EnvironmentDetection): string[];
+//# sourceMappingURL=env-detect.d.ts.map

package/dist/env-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-detect.d.ts","sourceRoot":"","sources":["../src/env-detect.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,OAAO,CAAA;AAElD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAA;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,kBAAkB;IAClB,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAOD,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,OAAO,CAO/E;AAqED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyC/F;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAe1E"}

package/dist/env-detect.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectWSL = detectWSL;
+exports.detectEnvironment = detectEnvironment;
+exports.formatDetectionSummary = formatDetectionSummary;
+const promises_1 = __importDefault(require("fs/promises"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const TOOL_META = {
+    claude_code: { label: 'Claude Code', rel: ['.claude', 'projects'] },
+    codex: { label: 'Codex', rel: ['.codex', 'sessions'] },
+};
+/** WSL 上で動いているか (/proc/version に microsoft/WSL を含むか)。 */
+function detectWSL(platform = process.platform) {
+    if (platform !== 'linux')
+        return false;
+    try {
+        return /microsoft|wsl/i.test(fs_1.default.readFileSync('/proc/version', 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+/** /mnt/c/Users 配下の実ユーザーディレクトリ (WSL から Windows 側履歴を拾う)。 */
+function listWindowsUserDirs() {
+    const root = '/mnt/c/Users';
+    const skip = new Set(['Public', 'Default', 'Default User', 'All Users', 'desktop.ini']);
+    try {
+        return fs_1.default
+            .readdirSync(root, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && !skip.has(e.name))
+            .map((e) => path_1.default.join(root, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/** base を ~ 圧縮した watch glob を返す。home 配下なら `~/...`、それ以外は絶対パス。 */
+function toWatchGlob(base, home) {
+    const norm = base.replace(/\\/g, '/');
+    const h = home.replace(/\\/g, '/').replace(/\/+$/, '');
+    const rel = norm === h ? '' : norm.startsWith(h + '/') ? norm.slice(h.length + 1) : null;
+    const head = rel === null ? norm : rel === '' ? '~' : `~/${rel}`;
+    return `${head}/**/*.jsonl`;
+}
+/** base ディレクトリの project 数 (直下のディレクトリ) と *.jsonl セッション数を数える。 */
+async function countDir(base, maxDepth) {
+    let exists = false;
+    let projects = 0;
+    let sessions = 0;
+    let top;
+    try {
+        top = await promises_1.default.readdir(base, { withFileTypes: true });
+        exists = true;
+    }
+    catch {
+        return { exists: false, projects: 0, sessions: 0 };
+    }
+    // 直下のディレクトリ数 = projects (Claude の project 単位)。
+    projects = top.filter((e) => e.isDirectory() && !e.isSymbolicLink()).length;
+    // *.jsonl を再帰カウント (symlink は辿らない / 深さ上限)。
+    const walk = async (dir, entries, depth) => {
+        for (const e of entries) {
+            if (e.isSymbolicLink())
+                continue;
+            const full = path_1.default.join(dir, e.name);
+            if (e.isFile()) {
+                if (e.name.toLowerCase().endsWith('.jsonl'))
+                    sessions++;
+            }
+            else if (e.isDirectory() && depth < maxDepth) {
+                let sub;
+                try {
+                    sub = await promises_1.default.readdir(full, { withFileTypes: true });
+                }
+                catch {
+                    continue;
+                }
+                await walk(full, sub, depth + 1);
+            }
+        }
+    };
+    await walk(base, top, 0);
+    return { exists, projects, sessions };
+}
+/**
+ * 環境を検出する。各ツールについて候補ベース (ホーム + WSL の Windows ユーザー) を評価し、
+ * 「存在する候補のうちセッション数が最大のもの」を採用する。
+ */
+async function detectEnvironment(opts = {}) {
+    const home = opts.homeDir ?? os_1.default.homedir();
+    const platform = opts.platform ?? process.platform;
+    const isWSL = opts.isWSL ?? detectWSL(platform);
+    const maxDepth = opts.maxDepth ?? 24;
+    const windowsUserDirs = opts.windowsUserDirs ?? (isWSL ? listWindowsUserDirs() : []);
+    const tools = [];
+    for (const tool of Object.keys(TOOL_META)) {
+        const { label, rel } = TOOL_META[tool];
+        const candidates = [path_1.default.join(home, ...rel), ...windowsUserDirs.map((d) => path_1.default.join(d, ...rel))];
+        let chosen = null;
+        for (const base of candidates) {
+            const counts = await countDir(base, maxDepth);
+            if (!counts.exists)
+                continue;
+            // 存在する候補のうちセッション数が最大のものを採用 (同数なら先勝ち = ホーム優先)。
+            if (!chosen || counts.sessions > chosen.counts.sessions)
+                chosen = { base, counts };
+        }
+        tools.push({
+            tool,
+            label,
+            basePath: chosen?.base ?? null,
+            present: chosen !== null,
+            projects: tool === 'codex' ? 0 : (chosen?.counts.projects ?? 0),
+            sessions: chosen?.counts.sessions ?? 0,
+            watchGlob: chosen ? toWatchGlob(chosen.base, home) : null,
+        });
+    }
+    const detected = tools.filter((t) => t.present);
+    return {
+        platform,
+        isWSL,
+        home,
+        tools,
+        detected,
+        anyDetected: detected.length > 0,
+        watchPaths: detected.map((t) => t.watchGlob).filter(Boolean),
+    };
+}
+/** 検出結果を人間向けの要約行に整形する (例: `Claude Code : 12 projects / 348 sessions`)。 */
+function formatDetectionSummary(env) {
+    const lines = [];
+    for (const t of env.tools) {
+        if (!t.present) {
+            lines.push(`  ${t.label.padEnd(12)}: 未検出`);
+            continue;
+        }
+        const count = t.tool === 'codex'
+            ? `${t.sessions.toLocaleString()} sessions`
+            : `${t.projects.toLocaleString()} projects / ${t.sessions.toLocaleString()} sessions`;
+        lines.push(`  ${t.label.padEnd(12)}: ${count}   (${t.basePath})`);
+    }
+    if (env.isWSL)
+        lines.push('  (WSL を検出: Linux ホーム + /mnt/c/Users を探索)');
+    return lines;
+}
+//# sourceMappingURL=env-detect.js.map

package/dist/env-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-detect.js","sourceRoot":"","sources":["../src/env-detect.ts"],"names":[],"mappings":"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"}

package/dist/exec/executor.d.ts

@@ -0,0 +1,42 @@
+export declare const SUPPORTED_LANGUAGES: readonly ["bash", "node", "python"];
+export type ExecLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+export declare function isExecLanguage(v: unknown): v is ExecLanguage;
+/**
+ * 子プロセスへ伝播する環境変数のホワイトリスト。
+ * 秘匿値 (ANTHROPIC_API_KEY / AWS_* / *_TOKEN 等) はリストに無い時点で遮断される
+ * (ブラックリストではなくホワイトリスト = 新種のキーも漏れない)。
+ * HOME は実ホームを隠すため一時ディレクトリに差し替える。
+ */
+export declare const ENV_WHITELIST: readonly ["PATH", "LANG", "LC_ALL", "LC_CTYPE", "TZ", "TERM", "TMPDIR"];
+export interface ExecRequest {
+    language: ExecLanguage;
+    code: string;
+    /** 実行の作業ディレクトリ (プロジェクトルート)。 */
+    projectRoot: string;
+    /** タイムアウト ms (既定 30_000)。 */
+    timeoutMs?: number;
+    /** stdout / stderr の取り込み上限 (メモリ保護のハードキャップ)。 */
+    maxCaptureBytes?: number;
+}
+export interface ExecResult {
+    /** 取り込んだ stdout (maxCaptureBytes でハードキャップ済み・マスク前)。 */
+    stdout: string;
+    /** stderr の先頭 (診断用に小さく保持)。 */
+    stderrHead: string;
+    exitCode: number | null;
+    /** タイムアウトで SIGKILL したか。 */
+    timedOut: boolean;
+    /** stdout が maxCaptureBytes を超えて切り捨てられたか。 */
+    captureTruncated: boolean;
+    durationMs: number;
+}
+/** ホワイトリストで子プロセス環境を構築。HOME は一時ディレクトリに差し替え。 */
+export declare function buildSandboxEnv(parentEnv: NodeJS.ProcessEnv, sandboxHome: string): NodeJS.ProcessEnv;
+/**
+ * code を一時ファイル経由で実行する。例外は投げず ExecResult に正規化する
+ * (インタープリタ不在等は exitCode null + stderrHead にメッセージ)。
+ */
+export declare function executeCode(req: ExecRequest): Promise<ExecResult>;
+/** 実行ログ・参照IDに使う一意 ID。 */
+export declare function generateExecId(): string;
+//# sourceMappingURL=executor.d.ts.map

package/dist/exec/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/exec/executor.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,mBAAmB,qCAAsC,CAAA;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yEAA0E,CAAA;AAEpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAcD,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAOpG;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwEvE;AAED,yBAAyB;AACzB,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/exec/executor.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_WHITELIST = exports.SUPPORTED_LANGUAGES = void 0;
+exports.isExecLanguage = isExecLanguage;
+exports.buildSandboxEnv = buildSandboxEnv;
+exports.executeCode = executeCode;
+exports.generateExecId = generateExecId;
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// =============================================
+// pk_execute 実行エンジン (Issue #94 / Epic #91 R2)
+// =============================================
+//
+// 生データをコンテキストに入れず、エージェントが書いたコードをローカルで実行して
+// 結果 (stdout) だけを返す。安全制約:
+//   - タイムアウト (既定 30s、SIGKILL)
+//   - 作業ディレクトリ = プロジェクトルート (cwd 固定)
+//   - 環境変数はホワイトリストのみ伝播 (API キー類を子プロセスへ渡さない)
+//   - stdout は上限でトリム (超過分は呼び出し側が R1 退避へ回す)
+// ポリシー判定 (policy.ts) は呼び出し側 (mcp/server.ts) が実行前に行う。
+exports.SUPPORTED_LANGUAGES = ['bash', 'node', 'python'];
+function isExecLanguage(v) {
+    return typeof v === 'string' && exports.SUPPORTED_LANGUAGES.includes(v);
+}
+/**
+ * 子プロセスへ伝播する環境変数のホワイトリスト。
+ * 秘匿値 (ANTHROPIC_API_KEY / AWS_* / *_TOKEN 等) はリストに無い時点で遮断される
+ * (ブラックリストではなくホワイトリスト = 新種のキーも漏れない)。
+ * HOME は実ホームを隠すため一時ディレクトリに差し替える。
+ */
+exports.ENV_WHITELIST = ['PATH', 'LANG', 'LC_ALL', 'LC_CTYPE', 'TZ', 'TERM', 'TMPDIR'];
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_CAPTURE_BYTES = 5 * 1024 * 1024; // 5MB (メモリ保護)
+const STDERR_HEAD_BYTES = 4 * 1024;
+const INTERPRETER = {
+    bash: { cmd: 'bash', args: (f) => [f] },
+    node: { cmd: 'node', args: (f) => [f] },
+    python: { cmd: 'python3', args: (f) => [f] },
+};
+const FILE_EXT = { bash: '.sh', node: '.cjs', python: '.py' };
+/** ホワイトリストで子プロセス環境を構築。HOME は一時ディレクトリに差し替え。 */
+function buildSandboxEnv(parentEnv, sandboxHome) {
+    const env = {};
+    for (const key of exports.ENV_WHITELIST) {
+        if (parentEnv[key] !== undefined)
+            env[key] = parentEnv[key];
+    }
+    env.HOME = sandboxHome;
+    return env;
+}
+/**
+ * code を一時ファイル経由で実行する。例外は投げず ExecResult に正規化する
+ * (インタープリタ不在等は exitCode null + stderrHead にメッセージ)。
+ */
+async function executeCode(req) {
+    const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const maxCapture = req.maxCaptureBytes ?? DEFAULT_MAX_CAPTURE_BYTES;
+    const started = Date.now();
+    // 一時ファイル + サンドボックス HOME (実行ごとに隔離、終了後に削除)
+    const workDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'pk-exec-'));
+    const codeFile = path_1.default.join(workDir, `code${FILE_EXT[req.language]}`);
+    const sandboxHome = path_1.default.join(workDir, 'home');
+    fs_1.default.mkdirSync(sandboxHome);
+    fs_1.default.writeFileSync(codeFile, req.code, { mode: 0o600 });
+    const { cmd, args } = INTERPRETER[req.language];
+    try {
+        return await new Promise((resolve) => {
+            const child = (0, child_process_1.spawn)(cmd, args(codeFile), {
+                cwd: req.projectRoot,
+                env: buildSandboxEnv(process.env, sandboxHome),
+                timeout: timeoutMs,
+                killSignal: 'SIGKILL',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            const out = [];
+            let outBytes = 0;
+            let captureTruncated = false;
+            const err = [];
+            let errBytes = 0;
+            child.stdout.on('data', (chunk) => {
+                if (outBytes >= maxCapture) {
+                    captureTruncated = true;
+                    return;
+                }
+                const room = maxCapture - outBytes;
+                const take = chunk.length > room ? chunk.subarray(0, room) : chunk;
+                if (take.length < chunk.length)
+                    captureTruncated = true;
+                out.push(take);
+                outBytes += take.length;
+            });
+            child.stderr.on('data', (chunk) => {
+                if (errBytes >= STDERR_HEAD_BYTES)
+                    return;
+                const take = chunk.subarray(0, STDERR_HEAD_BYTES - errBytes);
+                err.push(take);
+                errBytes += take.length;
+            });
+            child.on('error', (e) => {
+                resolve({
+                    stdout: '',
+                    stderrHead: `実行に失敗しました: ${e.message}`,
+                    exitCode: null,
+                    timedOut: false,
+                    captureTruncated: false,
+                    durationMs: Date.now() - started,
+                });
+            });
+            child.on('close', (code, signal) => {
+                resolve({
+                    stdout: Buffer.concat(out).toString('utf8'),
+                    stderrHead: Buffer.concat(err).toString('utf8'),
+                    exitCode: code,
+                    timedOut: signal === 'SIGKILL' && Date.now() - started >= timeoutMs - 50,
+                    captureTruncated,
+                    durationMs: Date.now() - started,
+                });
+            });
+        });
+    }
+    finally {
+        fs_1.default.rmSync(workDir, { recursive: true, force: true });
+    }
+}
+/** 実行ログ・参照IDに使う一意 ID。 */
+function generateExecId() {
+    return `pk-exec-${(0, crypto_1.randomBytes)(6).toString('hex')}`;
+}
+//# sourceMappingURL=executor.js.map

package/dist/exec/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/exec/executor.ts"],"names":[],"mappings":";;;;;;AAqBA,wCAEC;AA+CD,0CAOC;AAMD,kCAwEC;AAGD,wCAEC;AAhKD,iDAAqC;AACrC,mCAAoC;AACpC,4CAAmB;AACnB,4CAAmB;AACnB,gDAAuB;AAEvB,gDAAgD;AAChD,8CAA8C;AAC9C,gDAAgD;AAChD,EAAE;AACF,0CAA0C;AAC1C,0BAA0B;AAC1B,8BAA8B;AAC9B,oCAAoC;AACpC,4CAA4C;AAC5C,2CAA2C;AAC3C,qDAAqD;AAExC,QAAA,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAA;AAGtE,SAAgB,cAAc,CAAC,CAAU;IACvC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,2BAAyC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACxF,CAAC;AAED;;;;;GAKG;AACU,QAAA,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAA;AA0BpG,MAAM,kBAAkB,GAAG,MAAM,CAAA;AACjC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA,CAAC,cAAc;AAChE,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAAA;AAElC,MAAM,WAAW,GAA4E;IAC3F,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;IACvC,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;IACvC,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;CAC7C,CAAA;AAED,MAAM,QAAQ,GAAiC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAE3F,8CAA8C;AAC9C,SAAgB,eAAe,CAAC,SAA4B,EAAE,WAAmB;IAC/E,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,KAAK,MAAM,GAAG,IAAI,qBAAa,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7D,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,WAAW,CAAA;IACtB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,WAAW,CAAC,GAAgB;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,kBAAkB,CAAA;IACrD,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,IAAI,yBAAyB,CAAA;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAE1B,yCAAyC;IACzC,MAAM,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpE,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC9C,YAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACzB,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAErD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAE/C,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;YAC/C,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACvC,GAAG,EAAE,GAAG,CAAC,WAAW;gBACpB,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;gBAC9C,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,SAAS;gBACrB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAA;YAEF,MAAM,GAAG,GAAa,EAAE,CAAA;YACxB,IAAI,QAAQ,GAAG,CAAC,CAAA;YAChB,IAAI,gBAAgB,GAAG,KAAK,CAAA;YAC5B,MAAM,GAAG,GAAa,EAAE,CAAA;YACxB,IAAI,QAAQ,GAAG,CAAC,CAAA;YAEhB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;oBAC3B,gBAAgB,GAAG,IAAI,CAAA;oBACvB,OAAM;gBACR,CAAC;gBACD,MAAM,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAA;gBAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;gBAClE,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;oBAAE,gBAAgB,GAAG,IAAI,CAAA;gBACvD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACd,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAA;YACzB,CAAC,CAAC,CAAA;YACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,IAAI,QAAQ,IAAI,iBAAiB;oBAAE,OAAM;gBACzC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,iBAAiB,GAAG,QAAQ,CAAC,CAAA;gBAC5D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACd,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAA;YACzB,CAAC,CAAC,CAAA;YAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACtB,OAAO,CAAC;oBACN,MAAM,EAAE,EAAE;oBACV,UAAU,EAAE,cAAc,CAAC,CAAC,OAAO,EAAE;oBACrC,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,KAAK;oBACf,gBAAgB,EAAE,KAAK;oBACvB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;YACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjC,OAAO,CAAC;oBACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAC/C,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,SAAS,GAAG,EAAE;oBACxE,gBAAgB;oBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,YAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,SAAgB,cAAc;IAC5B,OAAO,WAAW,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAA;AACpD,CAAC"}

package/dist/exec/pk-execute.d.ts

@@ -0,0 +1,30 @@
+import type { StoredToolOutputRef } from '../store/local-store';
+import type { ParsedEntry } from '../types';
+import { type ExecutionPolicy } from './policy';
+import { executeCode } from './executor';
+export interface PkExecuteDeps {
+    /** マスキング前置パイプライン (#68 の不変条件)。 */
+    maskText: (text: string) => string;
+    /** R1 退避ストアへの保存 (#93)。 */
+    storeRef: (ref: StoredToolOutputRef) => void;
+    /** 実行ログ entry の記録 + 送信 (best-effort、呼び出し側で実装)。 */
+    recordEntry: (entry: ParsedEntry) => Promise<void>;
+    /** 組織実行ポリシー (cloud 配信、オフライン時 null)。 */
+    getPolicy: () => ExecutionPolicy | null;
+    projectRoot: string;
+    timeoutMs: number;
+    maxReturnBytes: number;
+    /** テスト注入用。 */
+    now?: () => string;
+    execImpl?: typeof executeCode;
+}
+export interface PkExecuteResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** pk_execute 本体。例外を投げず PkExecuteResult に正規化する。 */
+export declare function runPkExecute(deps: PkExecuteDeps, args: Record<string, unknown>): Promise<PkExecuteResult>;
+//# sourceMappingURL=pk-execute.d.ts.map

package/dist/exec/pk-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-execute.d.ts","sourceRoot":"","sources":["../../src/exec/pk-execute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,WAAW,EAAmD,MAAM,YAAY,CAAA;AAYzF,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAC5C,kDAAkD;IAClD,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,uCAAuC;IACvC,SAAS,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAmDD,mDAAmD;AACnD,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC,CAwI1B"}