@minimalcorp/tsunagi 0.1.30 → 0.1.32

package/dist/cli.js

@@ -184,10 +184,25 @@ verifyArtifact(NEXT_STANDALONE_ENTRY, 'Next.js standalone artifact');
 // Fastify が単一の公開ポート。Next.js は内部ポートで動かし Fastify からプロキシする。
 const PORT = process.env.PORT ?? '2791';
 const NEXT_PORT = '2792';
+// Fastify サーバー自身の待受ポートは TSUNAGI_SERVER_PORT で伝える（generic な PORT は上書きしない）。
+// PORT を直接上書きすると、ユーザーが Terminal で明示的に PORT=xxxx と指定していた場合でも
+// tsunagi 内部ターミナル側でその値と tsunagi 自身の値を区別できなくなるため。
+//
+// NODE_ENV は Fastify/Next 等が直接参照するため PORT と同じ専用キー方式が使えず、サーバー
+// プロセス自身には強制的に 'production' を渡す必要がある。上書きする前に外側 Terminal 由来の
+// 元の値（未設定なら undefined）を TSUNAGI_OUTER_NODE_ENV に退避し、tsunagi 内部ターミナル側
+// （apps/server/src/pty-manager.ts）で復元できるようにする。
+const outerNodeEnv = process.env.NODE_ENV;
 const fastifyChild = spawn(process.execPath, [FASTIFY_ENTRY_JS], {
     stdio: ['inherit', 'pipe', 'pipe'],
     cwd: PACKAGE_ROOT,
-    env: { ...process.env, NODE_ENV: 'production', PORT, TSUNAGI_NEXT_PORT: NEXT_PORT },
+    env: {
+        ...process.env,
+        NODE_ENV: 'production',
+        ...(outerNodeEnv !== undefined ? { TSUNAGI_OUTER_NODE_ENV: outerNodeEnv } : {}),
+        TSUNAGI_SERVER_PORT: PORT,
+        TSUNAGI_NEXT_PORT: NEXT_PORT,
+    },
 });
 const nextChild = spawn(process.execPath, [NEXT_STANDALONE_ENTRY], {
     stdio: ['inherit', 'pipe', 'pipe'],

package/dist/server/index.js

@@ -22,7 +22,10 @@ import { llmRoutes } from './routes/llm.js';
 import { stopLlmServerOnExit } from './lib/llm-process.js';
 import { createBasicAuth } from './basic-auth.js';
 // Fastify は単一の公開エンドポイント。Next.js は内部ポートで動かしプロキシする。
-const PORT = Number(process.env.PORT) || 2791;
+// PORT ではなく TSUNAGI_SERVER_PORT を見る（apps/cli が注入する専用キー）。generic な PORT を
+// 使うと、ユーザーが Terminal で明示的に設定した PORT と衝突し、内部ターミナルへの伝播を
+// 区別できなくなるため（pty-manager.ts 参照）。
+const PORT = Number(process.env.TSUNAGI_SERVER_PORT) || 2791;
 const NEXT_PORT = Number(process.env.TSUNAGI_NEXT_PORT) || 2792;
 const extraOrigins = (process.env.TSUNAGI_EXTRA_CORS_ORIGINS ?? '')
     .split(',')

package/dist/server/lib/llm-process.js

@@ -4,6 +4,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { killProcessOnPort } from './process-port.js';
+import { findPython, isVenvUpToDate, PYTHON_NOT_FOUND_MESSAGE, writeVenvMarker, } from './python-venv.js';
 const MODEL = 'mlx-community/Qwen3-30B-A3B-Instruct-2507-4bit';
 const LLM_SERVER_URL = process.env.TSUNAGI_LLM_SERVER_URL || 'http://127.0.0.1:8766';
 // run.shが待受けるポート固定値(host.docker.internal経由URLと違い、停止処理は
@@ -40,9 +41,6 @@ export function findLlmServerDir() {
 function venvPython() {
     return path.join(VENV_DIR, 'bin', 'python3');
 }
-function isVenvReady() {
-    return fs.existsSync(venvPython());
-}
 function isModelReady() {
     const snapshotsDir = path.join(MODEL_CACHE_DIR, 'snapshots');
     if (!fs.existsSync(snapshotsDir))
@@ -135,11 +133,17 @@ async function trackModelDownload(child) {
 }
 async function runSetupAndStart(dir) {
     const hfEnv = { ...process.env, HF_HOME: HF_CACHE_DIR, HF_HUB_DISABLE_XET: '1' };
-    if (!isVenvReady()) {
+    const requirementsFile = path.join(dir, 'requirements.txt');
+    if (!isVenvUpToDate(VENV_DIR, requirementsFile)) {
         currentStep = 'installing_deps';
+        const pythonBin = findPython();
+        if (!pythonBin)
+            throw new Error(PYTHON_NOT_FOUND_MESSAGE);
         fs.mkdirSync(TSUNAGI_LLM_DIR, { recursive: true });
-        await runStep('python3', ['-m', 'venv', VENV_DIR], dir);
+        fs.rmSync(VENV_DIR, { recursive: true, force: true });
+        await runStep(pythonBin, ['-m', 'venv', VENV_DIR], dir);
         await runStep(venvPython(), ['-m', 'pip', 'install', '-r', 'requirements.txt'], dir);
+        writeVenvMarker(VENV_DIR, requirementsFile);
     }
     if (!isModelReady()) {
         currentStep = 'downloading_model';

package/dist/server/lib/python-venv.d.ts

@@ -0,0 +1,4 @@
+export declare function findPython(): string | null;
+export declare const PYTHON_NOT_FOUND_MESSAGE = "Python 3.10\u4EE5\u4E0A\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002'brew install python@3.12' \u7B49\u3067\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
+export declare function isVenvUpToDate(venvDir: string, requirementsFile: string): boolean;
+export declare function writeVenvMarker(venvDir: string, requirementsFile: string): void;

package/dist/server/lib/python-venv.js

@@ -0,0 +1,66 @@
+import { execFileSync } from 'node:child_process';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// mlx/mlx-lm/mlx-whisper の固定バージョンが requires-python >=3.10 のため、venv作成に
+// 使う python3 自体も 3.10 以上でなければ pip install がそもそも失敗する。`python3` という
+// 名前が PATH 上のどのバージョンを指すかは環境依存(古い macOS 付属 Python 等)なため、
+// 候補を新しい順に探して最初に見つかった 3.10 以上を使う。
+const MIN_PYTHON_VERSION = '3.10';
+const PYTHON_CANDIDATES = [
+    'python3.14',
+    'python3.13',
+    'python3.12',
+    'python3.11',
+    'python3.10',
+    'python3',
+];
+function pythonVersion(bin) {
+    try {
+        return execFileSync(bin, ['-c', 'import sys; print("%d.%d" % sys.version_info[:2])'], {
+            encoding: 'utf8',
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function versionAtLeast(version, min) {
+    const [vMajor, vMinor] = version.split('.').map(Number);
+    const [mMajor, mMinor] = min.split('.').map(Number);
+    return vMajor !== mMajor ? vMajor > mMajor : vMinor >= mMinor;
+}
+export function findPython() {
+    for (const cand of PYTHON_CANDIDATES) {
+        const version = pythonVersion(cand);
+        if (version && versionAtLeast(version, MIN_PYTHON_VERSION))
+            return cand;
+    }
+    return null;
+}
+export const PYTHON_NOT_FOUND_MESSAGE = `Python ${MIN_PYTHON_VERSION}以上が見つかりません。'brew install python@3.12' 等でインストールしてください。`;
+function venvMarkerPath(venvDir) {
+    return path.join(venvDir, '.requirements.sha256');
+}
+function requirementsHash(requirementsFile) {
+    return crypto.createHash('sha256').update(fs.readFileSync(requirementsFile)).digest('hex');
+}
+// venvが「存在するだけ」でなく、実際に使えるかを検証する。
+// - venv作成に使われた python が 3.10 未満だと mlx 系のインストールに失敗するバージョンのまま放置される
+// - requirements.txt のバージョン指定を後から変更しても、既存venvには反映されない
+// のいずれかが起きていないかを、venv自身のpythonバージョンと記録済みハッシュから判定する。
+export function isVenvUpToDate(venvDir, requirementsFile) {
+    const venvPython = path.join(venvDir, 'bin', 'python3');
+    if (!fs.existsSync(venvPython))
+        return false;
+    const version = pythonVersion(venvPython);
+    if (!version || !versionAtLeast(version, MIN_PYTHON_VERSION))
+        return false;
+    const marker = venvMarkerPath(venvDir);
+    if (!fs.existsSync(marker))
+        return false;
+    return fs.readFileSync(marker, 'utf8').trim() === requirementsHash(requirementsFile);
+}
+export function writeVenvMarker(venvDir, requirementsFile) {
+    fs.writeFileSync(venvMarkerPath(venvDir), requirementsHash(requirementsFile));
+}

package/dist/server/lib/whisper-process.js

@@ -4,6 +4,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { killProcessOnPort } from './process-port.js';
+import { findPython, isVenvUpToDate, PYTHON_NOT_FOUND_MESSAGE, writeVenvMarker, } from './python-venv.js';
 const WHISPER_SERVER_URL = process.env.TSUNAGI_WHISPER_SERVER_URL || 'http://127.0.0.1:8765';
 // run.shが待受けるポート固定値(host.docker.internal経由URLと違い、停止処理は
 // 必ずこのNodeプロセスと同じホスト上のポートを対象にする必要があるため分けて持つ)。
@@ -34,9 +35,6 @@ export function findWhisperServerDir() {
 function venvPython() {
     return path.join(VENV_DIR, 'bin', 'python3');
 }
-function isVenvReady() {
-    return fs.existsSync(venvPython());
-}
 function isModelReady() {
     const snapshotsDir = path.join(MODEL_CACHE_DIR, 'snapshots');
     if (!fs.existsSync(snapshotsDir))
@@ -129,11 +127,17 @@ async function trackModelDownload(child) {
 }
 async function runSetupAndStart(dir) {
     const hfEnv = { ...process.env, HF_HOME: HF_CACHE_DIR, HF_HUB_DISABLE_XET: '1' };
-    if (!isVenvReady()) {
+    const requirementsFile = path.join(dir, 'requirements.txt');
+    if (!isVenvUpToDate(VENV_DIR, requirementsFile)) {
         currentStep = 'installing_deps';
+        const pythonBin = findPython();
+        if (!pythonBin)
+            throw new Error(PYTHON_NOT_FOUND_MESSAGE);
         fs.mkdirSync(TSUNAGI_WHISPER_DIR, { recursive: true });
-        await runStep('python3', ['-m', 'venv', VENV_DIR], dir);
+        fs.rmSync(VENV_DIR, { recursive: true, force: true });
+        await runStep(pythonBin, ['-m', 'venv', VENV_DIR], dir);
         await runStep(venvPython(), ['-m', 'pip', 'install', '-r', 'requirements.txt'], dir);
+        writeVenvMarker(VENV_DIR, requirementsFile);
     }
     if (!isModelReady()) {
         currentStep = 'downloading_model';

package/dist/server/pty-manager.js

@@ -2,6 +2,26 @@ import * as pty from 'node-pty';
 import * as os from 'os';
 const SCROLLBACK_MAX_BYTES = 256 * 1024; // 256KB
 const SESSION_GC_INTERVAL_MS = 30 * 60 * 1000; // 30分
+/**
+ * apps/cli が Fastify サーバー起動時に自分で注入する環境変数
+ * （TSUNAGI_SERVER_PORT, NODE_ENV, TSUNAGI_NEXT_PORT, TSUNAGI_OUTER_NODE_ENV）。
+ * サーバープロセス自身の制御用に後から足された値のため、内部ターミナルには継承しない。
+ * 外側 Terminal 由来の環境変数はこのリストと無関係に、これまで通り全て継承する
+ * （PORT はここでは扱わない。apps/cli は generic な PORT を上書きせず、専用キー
+ * TSUNAGI_SERVER_PORT で自身の待受ポートを伝えるため、ユーザーが Terminal で明示した
+ * PORT はそのまま内部ターミナルまで届く）。
+ *
+ * NODE_ENV は Fastify/Next 等が直接参照するため、PORT と違って専用キーへ逃がせず、
+ * サーバープロセス自身には強制的に 'production' が入る。apps/cli はサーバー起動前の
+ * 元の値（外側 Terminal 由来、未設定なら undefined）を TSUNAGI_OUTER_NODE_ENV に退避して
+ * 渡してくるので、ここで NODE_ENV を一旦除外した後、退避値があれば NODE_ENV として復元する。
+ */
+const TSUNAGI_INJECTED_ENV_KEYS = [
+    'TSUNAGI_SERVER_PORT',
+    'NODE_ENV',
+    'TSUNAGI_NEXT_PORT',
+    'TSUNAGI_OUTER_NODE_ENV',
+];
 class PtyManager {
     sessions = new Map();
     /** sessionId → 最後に input を送信した socket.id */
@@ -22,13 +42,25 @@ class PtyManager {
             throw new Error(`Session already exists: ${sessionId}`);
         }
         const shell = process.env.SHELL || (os.platform() === 'win32' ? 'cmd.exe' : 'bash');
+        // tsunagi 自身が注入した環境変数は内部ターミナルに継承しない（TSUNAGI_INJECTED_ENV_KEYS 参照）。
+        // /settings 等で明示的に同名キーを設定した場合は env（dbEnv 経由）が後勝ちで上書きするため、
+        // カスケードの優先順位・挙動は変わらない。
+        const baseEnv = { ...process.env };
+        for (const key of TSUNAGI_INJECTED_ENV_KEYS) {
+            delete baseEnv[key];
+        }
+        // 外側 Terminal に元々 NODE_ENV があった場合は復元する。なければ未設定のままにする
+        // （tsunagi が強制した 'production' を内部ターミナルに漏らさないため）。
+        if (process.env.TSUNAGI_OUTER_NODE_ENV !== undefined) {
+            baseEnv.NODE_ENV = process.env.TSUNAGI_OUTER_NODE_ENV;
+        }
         const ptyProcess = pty.spawn(shell, [], {
             name: 'xterm-256color',
             cols: 80,
             rows: 24,
             cwd,
             env: {
-                ...process.env,
+                ...baseEnv,
                 ...env,
                 TERM: 'xterm-256color',
                 COLORTERM: 'truecolor',

package/dist/server/routes/terminal.js

@@ -7,9 +7,9 @@ import { getEnv } from '../lib/repositories/environment.js';
 import { ensureClaudeOnboardingCompleted } from '../lib/claude-config-guard.js';
 // サーバーはプロジェクトルートから起動されるため process.cwd() でルートを取得
 const TSUNAGI_EDITOR_PATH = path.resolve(process.cwd(), 'scripts/monaco-editor.sh');
-// Fastify(API) の公開ポート。index.ts と同じ既定値。monaco-editor.sh など PTY 内の
-// プロセスが API を叩く際の同一ホスト向けベース URL に使う。
-const SERVER_PORT = Number(process.env.PORT) || 2791;
+// Fastify(API) の公開ポート。index.ts と同じ既定値・同じ環境変数(TSUNAGI_SERVER_PORT)を見る。
+// monaco-editor.sh など PTY 内のプロセスが API を叩く際の同一ホスト向けベース URL に使う。
+const SERVER_PORT = Number(process.env.TSUNAGI_SERVER_PORT) || 2791;
 /**
  * 再接続時の画面復元用 scrollback から「端末への問い合わせ（クエリ）」シーケンスを除去する。
  *