instar 0.28.113 → 0.28.114

package/dist/core/SessionManager.d.ts

@@ -32,6 +32,7 @@ export interface SessionDiagnostics {
 import { InputGuard } from './InputGuard.js';
 import type { InputDetector } from '../monitoring/PromptGate.js';
 import type { Session, SessionManagerConfig, ModelTier } from './types.js';
+import type { IntelligenceFramework } from './intelligenceProviderFactory.js';
 import { StateManager } from './StateManager.js';
 export interface SessionManagerEvents {
     sessionComplete: [session: Session];
@@ -196,13 +197,23 @@ export declare class SessionManager extends EventEmitter {
     spawnSession(options: {
         name: string;
         prompt: string;
-        model?: ModelTier;
+        /** Either a Claude tier name, a generic tier ('fast'|'balanced'|'capable'),
+         *  or a raw model id. Resolution happens inside the framework's headless
+         *  builder via resolveModelForFramework, so generic tiers work uniformly
+         *  across Claude and Codex. */
+        model?: ModelTier | string;
         jobSlug?: string;
         triggeredBy?: string;
         maxDurationMinutes?: number;
         topicId?: number | 'platform';
         worktreeMode?: 'dev' | 'read-only' | 'doc-fix' | 'platform';
         worktreeSlug?: string;
+        /** Per-call framework override; falls back to INSTAR_FRAMEWORK env, then claude-code. */
+        framework?: IntelligenceFramework;
+        /** Phase 6 local-model adapter — when set on a codex-cli launch,
+         *  the spawned session uses `codex exec --oss --local-provider <p>`
+         *  instead of OpenAI. Ignored for non-codex frameworks. */
+        codexLocalProvider?: 'ollama' | 'lmstudio';
         /** Optional Claude Code per-session tool allowlist
          *  (mapped to `--allowedTools <comma-separated>`).
          *  When omitted, the spawn runs with full tools (back-compat).
@@ -244,6 +255,18 @@ export declare class SessionManager extends EventEmitter {
      * Capture the current output of a tmux session.
      */
     captureOutput(tmuxSession: string, lines?: number): string | null;
+    /**
+     * Resolve the IntelligenceFramework a tmux session was spawned under
+     * by reading the INSTAR_FRAMEWORK env we set in its tmux env block.
+     * Cached so repeated injections don't re-shell out. Returns null when
+     * the env isn't present (legacy sessions, non-instar tmux sessions).
+     */
+    private readonly sessionFrameworkCache;
+    /** Invalidate cached framework for a tmux name. Call after killing or
+     *  respawning a session whose name may be reused under a different
+     *  framework — e.g., after a /route switch. */
+    clearSessionFrameworkCache(tmuxSession: string): void;
+    private getSessionFramework;
     /**
      * Send input to a running tmux session.
      */
@@ -307,6 +330,9 @@ export declare class SessionManager extends EventEmitter {
         telegramTopicId?: number;
         slackChannelId?: string;
         resumeSessionId?: string;
+        framework?: IntelligenceFramework;
+        codexLocalProvider?: 'ollama' | 'lmstudio';
+        defaultModel?: string;
     }): Promise<string>;
     /**
      * Wait for Claude to be ready, inject the initial message, and — when the

package/dist/core/SessionManager.d.ts.map

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

package/dist/core/SessionManager.js

@@ -16,6 +16,8 @@ import { fileURLToPath } from 'node:url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 import { DegradationReporter } from '../monitoring/DegradationReporter.js';
 const execFileAsync = promisify(execFile);
+import { buildInteractiveLaunch, buildHeadlessLaunch, resolveInteractiveFramework, } from './frameworkSessionLaunch.js';
+import { frameworkFromEnv } from './intelligenceProviderFactory.js';
 import { buildInjectionTag } from '../types/pipeline.js';
 import { sanitizeSenderName, sanitizeTopicName } from '../utils/sanitize.js';
 /** Absolute maximum session duration (4 hours) — safety net for sessions without explicit timeout */
@@ -640,47 +642,84 @@ rm()  { "${shimRunner}" rm  "$@"; }
                 throw err;
             }
         }
-        // Build Claude CLI arguments — no shell intermediary.
-        // tmux new-session executes the command directly (no bash -c needed)
-        // when given as separate arguments after the session options.
-        // Use -e CLAUDECODE= to unset the CLAUDECODE env var in spawned sessions,
-        // preventing nested Claude Code detection when instar runs inside Claude Code.
+        // Build the CLI argv via the framework-aware headless-launch helper
+        // so Codex agents (and future frameworks) spawn correctly through
+        // this same path. The helper returns argv (binary + flags + prompt)
+        // and env overrides (CLAUDECODE clear, etc.) — caller merges the
+        // env overrides into the tmux -e block alongside the universal
+        // INSTAR_* / DATABASE_URL clears.
         //
+        // Framework resolution: the per-call options.framework wins, falling
+        // back to the agent's configured sessions.framework and then to the
+        // INSTAR_FRAMEWORK env. Defaults to claude-code for back-compat.
+        const headlessFramework = resolveInteractiveFramework({
+            perCall: options.framework,
+            // SessionManagerConfig has no top-level framework field; agent-level
+            // default lives in INSTAR_FRAMEWORK env (set at server boot from
+            // the agent's intelligence config). Per-call wins; env is fallback.
+            configFramework: undefined,
+            envFramework: frameworkFromEnv(),
+        });
+        const headlessBinaryPath = this.config.frameworkBinaryPaths?.[headlessFramework]
+            ?? this.config.claudePath;
+        const headlessSpec = buildHeadlessLaunch(headlessFramework, {
+            binaryPath: headlessBinaryPath,
+            prompt: options.prompt,
+            model: options.model,
+            ...(options.codexLocalProvider ? { codexLocalProvider: options.codexLocalProvider } : {}),
+        });
         // Per-job tool allowlist (INSTAR-JOBS-AS-AGENTMD spec §5): when the
         // caller provides a non-empty `allowedTools` array, scope the spawned
-        // session to that set via `--allowedTools <comma-separated>`. Omitting
-        // the flag preserves the legacy "full tools" behavior — back-compat
-        // for every non-agentmd code path.
-        const claudeArgs = ['--dangerously-skip-permissions'];
-        if (options.allowedTools && options.allowedTools.length > 0) {
-            claudeArgs.push('--allowedTools', options.allowedTools.join(','));
-        }
-        if (options.model) {
-            claudeArgs.push('--model', options.model);
+        // session. Currently Claude-only — `--allowedTools` is a Claude CLI
+        // flag with no Codex equivalent (Codex uses sandbox modes via the
+        // headless builder). For Codex spawns the allowlist is silently
+        // ignored; the spec's enforcement is via Codex sandbox flags upstream.
+        if (headlessFramework === 'claude-code'
+            && options.allowedTools
+            && options.allowedTools.length > 0) {
+            // Insert --allowedTools <list> before the -p prompt positional so
+            // Claude CLI parses it correctly. The helper builds argv with
+            // structure [binary, --dangerously-skip-permissions, (--model X)?, -p, prompt]
+            // — splice right before -p.
+            const dashPIndex = headlessSpec.argv.indexOf('-p');
+            if (dashPIndex > 0) {
+                headlessSpec.argv.splice(dashPIndex, 0, '--allowedTools', options.allowedTools.join(','));
+            }
         }
-        claudeArgs.push('-p', options.prompt);
         // K9: build PATH env with shim prepended (when shim was installed)
         const inheritedPath = process.env.PATH ?? '';
         const shimmedPath = shimDir ? `${shimDir}:${inheritedPath}` : inheritedPath;
+        // Merge the framework-specific env overrides into the tmux -e block.
+        // Anthropic-only env vars (CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY,
+        // ANTHROPIC_BASE_URL) only apply when the framework is claude-code;
+        // for Codex, the env-allowlist enforcement happens inside Codex CLI's
+        // process tree via Spec 12 Rule 1a, not via tmux -e flags (which
+        // would be unscrubbed parent inheritance).
+        const frameworkEnvFlags = [];
+        for (const [k, v] of Object.entries(headlessSpec.envOverrides)) {
+            frameworkEnvFlags.push('-e', `${k}=${v}`);
+        }
+        const anthropicEnvFlags = headlessFramework === 'claude-code'
+            ? [
+                ...((this.config.anthropicApiKey ?? '').startsWith('sk-ant-oat')
+                    ? ['-e', `CLAUDE_CODE_OAUTH_TOKEN=${this.config.anthropicApiKey}`, '-e', 'ANTHROPIC_API_KEY=']
+                    : ['-e', `ANTHROPIC_API_KEY=${this.config.anthropicApiKey ?? ''}`, '-e', 'CLAUDE_CODE_OAUTH_TOKEN=']),
+                '-e', `ANTHROPIC_BASE_URL=${this.config.anthropicBaseUrl ?? ''}`,
+            ]
+            : [];
         try {
             execFileSync(this.config.tmuxPath, [
                 'new-session', '-d',
                 '-s', tmuxSession,
                 '-c', resolvedCwd,
-                '-e', 'CLAUDECODE=', // Prevent nested Claude Code detection
+                ...frameworkEnvFlags,
                 '-e', `INSTAR_SESSION_ID=${sessionId}`, // Expose instar session ID to hook events
                 '-e', `INSTAR_SERVER_URL=http://localhost:${this.config.port}`,
                 '-e', `INSTAR_AUTH_TOKEN=${this.config.authToken}`,
                 ...(workTreeFencingToken ? ['-e', `INSTAR_FENCING_TOKEN=${workTreeFencingToken}`] : []),
                 ...(workTreeFencingToken ? ['-e', `INSTAR_WORKTREE_PATH=${resolvedCwd}`] : []),
                 ...(shimDir ? ['-e', `PATH=${shimmedPath}`, '-e', `BASH_ENV=${path.join(shimDir, '.shellrc')}`] : []),
-                // OAuth tokens (sk-ant-oat01-...) go in CLAUDE_CODE_OAUTH_TOKEN to enable
-                // interactive mode auth via subscription. API keys (sk-ant-api03-...) go in
-                // ANTHROPIC_API_KEY for direct API billing.
-                ...((this.config.anthropicApiKey ?? '').startsWith('sk-ant-oat')
-                    ? ['-e', `CLAUDE_CODE_OAUTH_TOKEN=${this.config.anthropicApiKey}`, '-e', 'ANTHROPIC_API_KEY=']
-                    : ['-e', `ANTHROPIC_API_KEY=${this.config.anthropicApiKey ?? ''}`, '-e', 'CLAUDE_CODE_OAUTH_TOKEN=']),
-                '-e', `ANTHROPIC_BASE_URL=${this.config.anthropicBaseUrl ?? ''}`,
+                ...anthropicEnvFlags,
                 // Isolate database credentials — spawned sessions must never inherit production
                 // database URLs from the parent shell. This prevents accidental schema changes
                 // or data operations against the wrong database. (Learned from Portal incident 2026-02-22)
@@ -689,7 +728,7 @@ rm()  { "${shimRunner}" rm  "$@"; }
                 '-e', 'DATABASE_URL_PROD=',
                 '-e', 'DATABASE_URL_DEV=',
                 '-e', 'DATABASE_URL_TEST=',
-                this.config.claudePath, ...claudeArgs,
+                ...headlessSpec.argv,
             ], { encoding: 'utf-8' });
             // Increase tmux scrollback buffer for dashboard history support
             try {
@@ -894,6 +933,10 @@ rm()  { "${shimRunner}" rm  "$@"; }
     captureOutput(tmuxSession, lines = 100) {
         try {
             // Note: use `=session:` (trailing colon) for pane-level tmux commands
+            // RULE 3: EXEMPT — primitive output capture, not state detection. The
+            // raw bytes returned here are consumed by callers (sentinels, watchdog)
+            // that own the actual state-detection patterns and their canary/registry
+            // coverage. This method is the transport layer.
             return execFileSync(this.config.tmuxPath, ['capture-pane', '-t', `=${tmuxSession}:`, '-p', '-S', `-${lines}`], { encoding: 'utf-8', timeout: 5000 });
         }
         catch {
@@ -901,6 +944,39 @@ rm()  { "${shimRunner}" rm  "$@"; }
             return null;
         }
     }
+    /**
+     * Resolve the IntelligenceFramework a tmux session was spawned under
+     * by reading the INSTAR_FRAMEWORK env we set in its tmux env block.
+     * Cached so repeated injections don't re-shell out. Returns null when
+     * the env isn't present (legacy sessions, non-instar tmux sessions).
+     */
+    sessionFrameworkCache = new Map();
+    /** Invalidate cached framework for a tmux name. Call after killing or
+     *  respawning a session whose name may be reused under a different
+     *  framework — e.g., after a /route switch. */
+    clearSessionFrameworkCache(tmuxSession) {
+        this.sessionFrameworkCache.delete(tmuxSession);
+    }
+    getSessionFramework(tmuxSession) {
+        if (this.sessionFrameworkCache.has(tmuxSession)) {
+            return this.sessionFrameworkCache.get(tmuxSession) ?? null;
+        }
+        let resolved = null;
+        try {
+            const out = execFileSync(this.config.tmuxPath, ['show-environment', '-t', `=${tmuxSession}`, 'INSTAR_FRAMEWORK'], { encoding: 'utf-8', timeout: 2000, stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            const value = out.startsWith('INSTAR_FRAMEWORK=') ? out.slice('INSTAR_FRAMEWORK='.length) : '';
+            if (value === 'claude-code' || value === 'codex-cli') {
+                resolved = value;
+            }
+        }
+        catch {
+            // @silent-fallback-ok — framework lookup is advisory; injection
+            // falls back to the Claude path which is correct for the default
+            // and conservative for unknown frameworks.
+        }
+        this.sessionFrameworkCache.set(tmuxSession, resolved);
+        return resolved;
+    }
     /**
      * Send input to a running tmux session.
      */
@@ -1192,22 +1268,45 @@ rm()  { "${shimRunner}" rm  "$@"; }
         }
         // Generate session ID before tmux spawn so we can pass it as env var
         const interactiveSessionId = this.generateId();
-        // Spawn Claude in tmux — no bash -c shell intermediary.
+        // Resolve which framework this session runs under (per-call override
+        // wins; otherwise default to claude-code). Pick the right binary
+        // path; fall back to the legacy claudePath when the framework-binary
+        // map isn't populated.
+        const framework = options?.framework ?? 'claude-code';
+        const binaryPath = this.config.frameworkBinaryPaths?.[framework]
+            ?? this.config.claudePath;
+        if (!binaryPath) {
+            throw new Error(`No binary path available for framework "${framework}"`);
+        }
+        // Per-call defaultModel override (used by /local-model to set Codex's
+        // local model id) wins over config defaults. Config defaults survive
+        // for cloud-Codex topics that haven't been customized.
+        const defaultModel = options?.defaultModel ?? this.config.frameworkDefaultModels?.[framework];
+        const launchSpec = buildInteractiveLaunch(framework, {
+            binaryPath,
+            ...(options?.resumeSessionId ? { resumeSessionId: options.resumeSessionId } : {}),
+            ...(defaultModel ? { defaultModel } : {}),
+            ...(options?.codexLocalProvider ? { codexLocalProvider: options.codexLocalProvider } : {}),
+        });
+        // Spawn the framework CLI in tmux — no bash -c shell intermediary.
         // Uses tmux -e flags to set/unset env vars directly, matching spawnSession pattern.
-        // This avoids shell injection risks and handles claudePath with spaces.
+        // This avoids shell injection risks and handles binary paths with spaces.
         try {
             const tmuxArgs = [
                 'new-session', '-d',
                 '-s', tmuxSession,
                 '-c', this.config.projectDir,
                 '-x', '200', '-y', '50',
-                '-e', 'CLAUDECODE=', // Prevent nested Claude Code detection
                 '-e', `INSTAR_SESSION_ID=${interactiveSessionId}`, // Expose instar session ID to hook events
                 '-e', `INSTAR_SERVER_URL=http://localhost:${this.config.port}`,
                 '-e', `INSTAR_AUTH_TOKEN=${this.config.authToken}`,
+                '-e', `INSTAR_FRAMEWORK=${framework}`,
+                // Framework-specific env additions/clears (e.g., CLAUDECODE=)
+                ...Object.entries(launchSpec.envOverrides).flatMap(([k, v]) => ['-e', `${k}=${v}`]),
                 // OAuth tokens (sk-ant-oat01-...) go in CLAUDE_CODE_OAUTH_TOKEN to enable
                 // interactive mode auth via subscription. API keys (sk-ant-api03-...) go in
-                // ANTHROPIC_API_KEY for direct API billing.
+                // ANTHROPIC_API_KEY for direct API billing. Codex reads its own
+                // OPENAI_API_KEY but harmless to pass these — Codex ignores them.
                 ...((this.config.anthropicApiKey ?? '').startsWith('sk-ant-oat')
                     ? ['-e', `CLAUDE_CODE_OAUTH_TOKEN=${this.config.anthropicApiKey}`, '-e', 'ANTHROPIC_API_KEY=']
                     : ['-e', `ANTHROPIC_API_KEY=${this.config.anthropicApiKey ?? ''}`, '-e', 'CLAUDE_CODE_OAUTH_TOKEN=']),
@@ -1226,10 +1325,12 @@ rm()  { "${shimRunner}" rm  "$@"; }
             if (options?.slackChannelId) {
                 tmuxArgs.push('-e', `INSTAR_SLACK_CHANNEL=${options.slackChannelId}`);
             }
-            tmuxArgs.push(this.config.claudePath, '--dangerously-skip-permissions');
+            tmuxArgs.push(...launchSpec.argv);
             if (options?.resumeSessionId) {
-                tmuxArgs.push('--resume', options.resumeSessionId);
-                console.log(`[SessionManager] Resuming session: ${options.resumeSessionId}`);
+                console.log(`[SessionManager] Resuming session: ${options.resumeSessionId} (framework: ${framework})`);
+            }
+            else {
+                console.log(`[SessionManager] Spawning interactive session "${tmuxSession}" (framework: ${framework})`);
             }
             execFileSync(this.config.tmuxPath, tmuxArgs, { encoding: 'utf-8' });
             // Increase tmux scrollback buffer for dashboard history support
@@ -1722,6 +1823,18 @@ rm()  { "${shimRunner}" rm  "$@"; }
             this.idlePromptSince.delete(match.id);
         }
         const exactTarget = `=${tmuxSession}:`;
+        // Framework-specific submit semantics. Claude Code's readline buffers
+        // the bracketed paste and accepts a single Enter ~500ms later to
+        // submit. Codex's TUI takes longer to commit a paste into its
+        // input state and silently discards the first Enter that arrives
+        // before the commit is done — observed live: messages stacked up
+        // in the input box because the post-paste Enter landed too early.
+        // For codex we wait longer and send Enter twice (the second one
+        // submits if the first was eaten; if both land, the second is a
+        // harmless no-op against an empty buffer).
+        const framework = this.getSessionFramework(tmuxSession);
+        const postPasteDelaySec = framework === 'codex-cli' ? '1.5' : '0.5';
+        const enterPresses = framework === 'codex-cli' ? 2 : 1;
         const maxAttempts = 2;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             try {
@@ -1739,25 +1852,35 @@ rm()  { "${shimRunner}" rm  "$@"; }
                     execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, '\x1b[201~'], {
                         encoding: 'utf-8', timeout: 5000,
                     });
-                    // Delay to let the terminal fully process the bracketed paste.
-                    // 100ms was too short — Claude Code needs time to parse the paste end
-                    // sequence and buffer the content before Enter can submit it.
-                    // 500ms is conservative but prevents the "[Pasted text #1]" stuck state.
-                    execFileSync('/bin/sleep', ['0.5'], { timeout: 2000 });
-                    // Send Enter to submit
-                    execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, 'Enter'], {
-                        encoding: 'utf-8', timeout: 5000,
-                    });
+                    execFileSync('/bin/sleep', [postPasteDelaySec], { timeout: 4000 });
+                    for (let i = 0; i < enterPresses; i++) {
+                        execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, 'Enter'], {
+                            encoding: 'utf-8', timeout: 5000,
+                        });
+                        if (i < enterPresses - 1) {
+                            try {
+                                execFileSync('/bin/sleep', ['0.3'], { timeout: 2000 });
+                            }
+                            catch { /* ignore */ }
+                        }
+                    }
                 }
                 else {
                     // Single-line: simple send-keys
                     execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, '-l', text], {
                         encoding: 'utf-8', timeout: 10000,
                     });
-                    // Send Enter separately
-                    execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, 'Enter'], {
-                        encoding: 'utf-8', timeout: 5000,
-                    });
+                    for (let i = 0; i < enterPresses; i++) {
+                        execFileSync(this.config.tmuxPath, ['send-keys', '-t', exactTarget, 'Enter'], {
+                            encoding: 'utf-8', timeout: 5000,
+                        });
+                        if (i < enterPresses - 1) {
+                            try {
+                                execFileSync('/bin/sleep', ['0.3'], { timeout: 2000 });
+                            }
+                            catch { /* ignore */ }
+                        }
+                    }
                 }
                 // Verify Enter actually submitted — on fresh Claude Code TUIs (v2.1.105+)
                 // the Enter after bracketed-paste-end is occasionally eaten, leaving the