@shepai/cli 1.151.2 → 1.152.0-pr476.5b101f5

package/dist/packages/core/src/infrastructure/repositories/sqlite-interactive-session.repository.js

@@ -0,0 +1,137 @@
+/**
+ * SQLite Interactive Session Repository Implementation
+ *
+ * Implements IInteractiveSessionRepository using SQLite database.
+ * Uses prepared statements to prevent SQL injection.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { injectable } from 'tsyringe';
+import { toDatabase, fromDatabase, } from '../persistence/sqlite/mappers/interactive-session.mapper.js';
+let SQLiteInteractiveSessionRepository = class SQLiteInteractiveSessionRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async create(session) {
+        const row = toDatabase(session);
+        this.db
+            .prepare(`INSERT INTO interactive_sessions
+          (id, feature_id, status, started_at, stopped_at, last_activity_at, created_at, updated_at)
+         VALUES
+          (@id, @feature_id, @status, @started_at, @stopped_at, @last_activity_at, @created_at, @updated_at)`)
+            .run(row);
+    }
+    async findById(id) {
+        const row = this.db.prepare('SELECT * FROM interactive_sessions WHERE id = ?').get(id);
+        return row ? fromDatabase(row) : null;
+    }
+    async findByFeatureId(featureId) {
+        const row = this.db
+            .prepare('SELECT * FROM interactive_sessions WHERE feature_id = ? ORDER BY created_at DESC LIMIT 1')
+            .get(featureId);
+        return row ? fromDatabase(row) : null;
+    }
+    async findAllActive() {
+        const rows = this.db
+            .prepare(`SELECT * FROM interactive_sessions WHERE status IN ('booting','ready')`)
+            .all();
+        return rows.map(fromDatabase);
+    }
+    async updateStatus(id, status, stoppedAt) {
+        this.db
+            .prepare(`UPDATE interactive_sessions
+         SET status = @status, stopped_at = @stopped_at, updated_at = @updated_at
+         WHERE id = @id`)
+            .run({
+            id,
+            status,
+            stopped_at: stoppedAt ? stoppedAt.getTime() : null,
+            updated_at: Date.now(),
+        });
+    }
+    async updateLastActivity(id, lastActivityAt) {
+        this.db
+            .prepare(`UPDATE interactive_sessions
+         SET last_activity_at = @last_activity_at, updated_at = @updated_at
+         WHERE id = @id`)
+            .run({ id, last_activity_at: lastActivityAt.getTime(), updated_at: Date.now() });
+    }
+    async markAllActiveStopped() {
+        this.db
+            .prepare(`UPDATE interactive_sessions
+         SET status = 'stopped', updated_at = ?
+         WHERE status IN ('booting','ready')`)
+            .run(Date.now());
+    }
+    async countActiveSessions() {
+        const result = this.db
+            .prepare(`SELECT COUNT(*) as count FROM interactive_sessions WHERE status IN ('booting','ready')`)
+            .get();
+        return result.count;
+    }
+    async updateAgentSessionId(id, agentSessionId) {
+        this.db
+            .prepare(`UPDATE interactive_sessions SET agent_session_id = @agent_session_id, updated_at = @updated_at WHERE id = @id`)
+            .run({ id, agent_session_id: agentSessionId, updated_at: Date.now() });
+    }
+    async getAgentSessionId(id) {
+        const row = this.db
+            .prepare('SELECT agent_session_id FROM interactive_sessions WHERE id = ?')
+            .get(id);
+        return row?.agent_session_id ?? null;
+    }
+    async updateTurnStatus(id, turnStatus) {
+        this.db
+            .prepare(`UPDATE interactive_sessions SET turn_status = @turn_status, updated_at = @updated_at WHERE id = @id`)
+            .run({ id, turn_status: turnStatus, updated_at: Date.now() });
+    }
+    async getTurnStatuses(featureIds) {
+        const result = new Map();
+        if (featureIds.length === 0)
+            return result;
+        // Use a single query with placeholders for all feature IDs.
+        // For each feature, get the most recent session's turn_status.
+        const placeholders = featureIds.map(() => '?').join(',');
+        const rows = this.db
+            .prepare(`SELECT feature_id, turn_status FROM interactive_sessions
+         WHERE feature_id IN (${placeholders})
+           AND status IN ('booting','ready')
+         ORDER BY created_at DESC`)
+            .all(...featureIds);
+        // First row per feature wins (most recent due to ORDER BY)
+        for (const row of rows) {
+            if (!result.has(row.feature_id)) {
+                result.set(row.feature_id, row.turn_status);
+            }
+        }
+        return result;
+    }
+    async getAllActiveTurnStatuses() {
+        const result = new Map();
+        const rows = this.db
+            .prepare(`SELECT feature_id, turn_status FROM interactive_sessions
+         WHERE status IN ('booting','ready')
+           AND turn_status != 'idle'
+         ORDER BY created_at DESC`)
+            .all();
+        for (const row of rows) {
+            if (!result.has(row.feature_id)) {
+                result.set(row.feature_id, row.turn_status);
+            }
+        }
+        return result;
+    }
+};
+SQLiteInteractiveSessionRepository = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [Object])
+], SQLiteInteractiveSessionRepository);
+export { SQLiteInteractiveSessionRepository };

package/dist/packages/core/src/infrastructure/repositories/sqlite-settings.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-settings.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-settings.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8EAA8E,CAAC;AACxH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE;;;GAGG;AACH,qBACa,wBAAyB,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEnD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAgBtC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAkFhD"}
+{"version":3,"file":"sqlite-settings.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-settings.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8EAA8E,CAAC;AACxH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE;;;GAGG;AACH,qBACa,wBAAyB,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2EnD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAgBtC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAqFhD"}

package/dist/packages/core/src/infrastructure/repositories/sqlite-settings.repository.js

@@ -67,7 +67,9 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         feature_flag_skills, feature_flag_env_deploy, feature_flag_debug, feature_flag_github_import, feature_flag_adopt_branch, feature_flag_git_rebase_sync,
         feature_flag_react_file_manager,
         workflow_enable_evidence, workflow_commit_evidence,
-        hide_ci_status
+        hide_ci_status,
+        interactive_agent_enabled, interactive_agent_auto_timeout_minutes,
+        interactive_agent_max_concurrent_sessions
       ) VALUES (
         @id, @created_at, @updated_at,
         @model_analyze, @model_requirements, @model_plan, @model_implement, @model_default,
@@ -93,7 +95,9 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         @feature_flag_skills, @feature_flag_env_deploy, @feature_flag_debug, @feature_flag_github_import, @feature_flag_adopt_branch, @feature_flag_git_rebase_sync,
         @feature_flag_react_file_manager,
         @workflow_enable_evidence, @workflow_commit_evidence,
-        @hide_ci_status
+        @hide_ci_status,
+        @interactive_agent_enabled, @interactive_agent_auto_timeout_minutes,
+        @interactive_agent_max_concurrent_sessions
       )
     `);
         // Execute with named parameters (safe from SQL injection)
@@ -190,7 +194,10 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         feature_flag_react_file_manager = @feature_flag_react_file_manager,
         workflow_enable_evidence = @workflow_enable_evidence,
         workflow_commit_evidence = @workflow_commit_evidence,
-        hide_ci_status = @hide_ci_status
+        hide_ci_status = @hide_ci_status,
+        interactive_agent_enabled = @interactive_agent_enabled,
+        interactive_agent_auto_timeout_minutes = @interactive_agent_auto_timeout_minutes,
+        interactive_agent_max_concurrent_sessions = @interactive_agent_max_concurrent_sessions
       WHERE id = @id
     `);
         // Execute with named parameters (safe from SQL injection)

package/dist/packages/core/src/infrastructure/services/agents/common/agent-executor-factory.service.d.ts

@@ -9,6 +9,7 @@
  */
 import type { AgentType, AgentConfig } from '../../../../domain/generated/output.js';
 import type { IAgentExecutor } from '../../../../application/ports/output/agents/agent-executor.interface.js';
+import type { IInteractiveAgentExecutor } from '../../../../application/ports/output/agents/interactive-agent-executor.interface.js';
 import type { IAgentExecutorFactory, AgentCliInfo } from '../../../../application/ports/output/agents/agent-executor-factory.interface.js';
 import type { SpawnFunction } from './types.js';
 /**
@@ -48,5 +49,22 @@ export declare class AgentExecutorFactory implements IAgentExecutorFactory {
      * @returns Array of model identifier strings, or empty array for unknown/dev agents
      */
     getSupportedModels(agentType: AgentType): string[];
+    /**
+     * Create an interactive executor for multi-turn agent sessions.
+     * Currently only Claude Code supports interactive sessions via the SDK.
+     *
+     * @param agentType - The type of agent to create an interactive executor for
+     * @param _authConfig - Agent authentication and configuration
+     * @returns A configured interactive agent executor
+     * @throws Error if the agent type does not support interactive sessions
+     */
+    createInteractiveExecutor(agentType: AgentType, _authConfig: AgentConfig): IInteractiveAgentExecutor;
+    /**
+     * Check whether the given agent type supports interactive sessions.
+     *
+     * @param agentType - The agent type to query
+     * @returns true if createInteractiveExecutor can be called for this type
+     */
+    supportsInteractive(agentType: AgentType): boolean;
 }
 //# sourceMappingURL=agent-executor-factory.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/common/agent-executor-factory.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yEAAyE,CAAC;AAC9G,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,iFAAiF,CAAC;AAKzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAMpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D;;OAEG;gBAC0B,KAAK,EAAE,aAAa;IAEjD;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IA6B9E;;;;OAIG;IACH,kBAAkB,IAAI,SAAS,EAAE;IASjC,UAAU,IAAI,YAAY,EAAE;IAQ5B;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE;CAYnD"}
+{"version":3,"file":"agent-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yEAAyE,CAAC;AAC9G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qFAAqF,CAAC;AACrI,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,iFAAiF,CAAC;AAMzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAMpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D;;OAEG;gBAC0B,KAAK,EAAE,aAAa;IAEjD;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IA6B9E;;;;OAIG;IACH,kBAAkB,IAAI,SAAS,EAAE;IASjC,UAAU,IAAI,YAAY,EAAE;IAQ5B;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE;IAalD;;;;;;;;OAQG;IACH,yBAAyB,CACvB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,GACvB,yBAAyB;IAW5B;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;CAGnD"}

package/dist/packages/core/src/infrastructure/services/agents/common/agent-executor-factory.service.js

@@ -8,6 +8,7 @@
  * to enable testability without mocking node:child_process directly.
  */
 import { ClaudeCodeExecutorService } from './executors/claude-code-executor.service.js';
+import { ClaudeCodeInteractiveExecutor } from './executors/claude-code-interactive-executor.service.js';
 import { CursorExecutorService } from './executors/cursor-executor.service.js';
 import { DevAgentExecutorService } from './executors/dev-executor.service.js';
 import { GeminiCliExecutorService } from './executors/gemini-cli-executor.service.js';
@@ -98,6 +99,32 @@ export class AgentExecutorFactory {
                 return [];
         }
     }
+    /**
+     * Create an interactive executor for multi-turn agent sessions.
+     * Currently only Claude Code supports interactive sessions via the SDK.
+     *
+     * @param agentType - The type of agent to create an interactive executor for
+     * @param _authConfig - Agent authentication and configuration
+     * @returns A configured interactive agent executor
+     * @throws Error if the agent type does not support interactive sessions
+     */
+    createInteractiveExecutor(agentType, _authConfig) {
+        const key = agentType;
+        if (key === 'claude-code') {
+            return new ClaudeCodeInteractiveExecutor();
+        }
+        throw new Error(`Agent type '${agentType}' does not support interactive sessions. ` +
+            `Only 'claude-code' supports interactive mode.`);
+    }
+    /**
+     * Check whether the given agent type supports interactive sessions.
+     *
+     * @param agentType - The agent type to query
+     * @returns true if createInteractiveExecutor can be called for this type
+     */
+    supportsInteractive(agentType) {
+        return agentType === 'claude-code';
+    }
 }
 // Static model lists per executor — update here when new models are released
 const CLAUDE_CODE_MODELS = ['claude-opus-4-6', 'claude-sonnet-4-6', 'claude-haiku-4-5'];

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-interactive-executor.service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Claude Code Interactive Executor Service
+ *
+ * Infrastructure implementation of IInteractiveAgentExecutor using the
+ * @anthropic-ai/claude-agent-sdk V2 session API. This is the ONLY file
+ * that imports from the SDK.
+ *
+ * Design decisions:
+ * - The CLAUDECODE env var is stripped to prevent nested-session detection
+ *   errors when shep itself is running inside a Claude Code session.
+ * - SDK message types are mapped to our own InteractiveAgentEvent to
+ *   keep the application layer decoupled from SDK specifics.
+ */
+import type { IInteractiveAgentExecutor, InteractiveAgentOptions, InteractiveAgentSessionHandle } from '../../../../../application/ports/output/agents/interactive-agent-executor.interface.js';
+export declare class ClaudeCodeInteractiveExecutor implements IInteractiveAgentExecutor {
+    createSession(options: InteractiveAgentOptions): Promise<InteractiveAgentSessionHandle>;
+    resumeSession(sessionId: string, options: InteractiveAgentOptions): Promise<InteractiveAgentSessionHandle>;
+    /**
+     * SDKSessionOptions (V2) does not support a `cwd` parameter.
+     * Temporarily change process.cwd() for session creation, then restore.
+     * This is safe because Node.js is single-threaded and SDK session creation
+     * is synchronous (returns immediately, spawns process in background).
+     */
+    private withCwd;
+    private buildSdkOptions;
+    private wrapSession;
+    private mapStream;
+    /**
+     * Map a single SDK message to zero or more InteractiveAgentEvents.
+     *
+     * SDK message types we handle:
+     * - stream_event (SDKPartialAssistantMessage): streaming content deltas
+     * - assistant (SDKAssistantMessage): complete assistant turn with tool_use blocks
+     * - result (SDKResultMessage): success or error result
+     * - system (SDKStatusMessage / SDKSystemMessage): status updates
+     * - tool_use_summary: tool execution summaries
+     * - tool_progress: tool execution progress
+     *
+     * Other message types are silently ignored (user replays, auth, etc.)
+     */
+    private mapSdkMessage;
+}
+//# sourceMappingURL=claude-code-interactive-executor.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-interactive-executor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-interactive-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/claude-code-interactive-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAE9B,MAAM,wFAAwF,CAAC;AAKhG,qBAAa,6BAA8B,YAAW,yBAAyB;IACvE,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAOvF,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,6BAA6B,CAAC;IAOzC;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,WAAW;YAiBJ,SAAS;IASxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;CA0MtB"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-interactive-executor.service.js

@@ -0,0 +1,288 @@
+/**
+ * Claude Code Interactive Executor Service
+ *
+ * Infrastructure implementation of IInteractiveAgentExecutor using the
+ * @anthropic-ai/claude-agent-sdk V2 session API. This is the ONLY file
+ * that imports from the SDK.
+ *
+ * Design decisions:
+ * - The CLAUDECODE env var is stripped to prevent nested-session detection
+ *   errors when shep itself is running inside a Claude Code session.
+ * - SDK message types are mapped to our own InteractiveAgentEvent to
+ *   keep the application layer decoupled from SDK specifics.
+ */
+import { unstable_v2_createSession, unstable_v2_resumeSession, } from '@anthropic-ai/claude-agent-sdk';
+/** Default model used when options.model is not specified. */
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+export class ClaudeCodeInteractiveExecutor {
+    async createSession(options) {
+        const sdkSession = this.withCwd(options.cwd, () => unstable_v2_createSession(this.buildSdkOptions(options)));
+        return this.wrapSession(sdkSession);
+    }
+    async resumeSession(sessionId, options) {
+        const sdkSession = this.withCwd(options.cwd, () => unstable_v2_resumeSession(sessionId, this.buildSdkOptions(options)));
+        return this.wrapSession(sdkSession);
+    }
+    /**
+     * SDKSessionOptions (V2) does not support a `cwd` parameter.
+     * Temporarily change process.cwd() for session creation, then restore.
+     * This is safe because Node.js is single-threaded and SDK session creation
+     * is synchronous (returns immediately, spawns process in background).
+     */
+    withCwd(cwd, fn) {
+        const originalCwd = process.cwd();
+        try {
+            process.chdir(cwd);
+            return fn();
+        }
+        finally {
+            process.chdir(originalCwd);
+        }
+    }
+    buildSdkOptions(options) {
+        // Strip CLAUDECODE env var to prevent nested-session detection errors.
+        const { CLAUDECODE: _, ...cleanEnv } = process.env;
+        return {
+            model: options.model ?? DEFAULT_MODEL,
+            permissionMode: 'bypassPermissions',
+            env: cleanEnv,
+            // Forward system prompt using preset+append pattern
+            ...(options.systemPrompt && {
+                systemPrompt: {
+                    type: 'preset',
+                    preset: 'claude_code',
+                    append: options.systemPrompt,
+                },
+            }),
+        };
+    }
+    wrapSession(sdkSession) {
+        return {
+            get sessionId() {
+                // SDK session ID is not available until after the first message exchange.
+                // Return empty string before that — callers should read it after streaming.
+                try {
+                    return sdkSession.sessionId;
+                }
+                catch {
+                    return '';
+                }
+            },
+            send: (message) => sdkSession.send(message),
+            stream: () => this.mapStream(sdkSession),
+            close: async () => sdkSession.close(),
+        };
+    }
+    async *mapStream(sdkSession) {
+        for await (const msg of sdkSession.stream()) {
+            const events = this.mapSdkMessage(msg);
+            for (const event of events) {
+                yield event;
+            }
+        }
+    }
+    /**
+     * Map a single SDK message to zero or more InteractiveAgentEvents.
+     *
+     * SDK message types we handle:
+     * - stream_event (SDKPartialAssistantMessage): streaming content deltas
+     * - assistant (SDKAssistantMessage): complete assistant turn with tool_use blocks
+     * - result (SDKResultMessage): success or error result
+     * - system (SDKStatusMessage / SDKSystemMessage): status updates
+     * - tool_use_summary: tool execution summaries
+     * - tool_progress: tool execution progress
+     *
+     * Other message types are silently ignored (user replays, auth, etc.)
+     */
+    mapSdkMessage(msg) {
+        const events = [];
+        switch (msg.type) {
+            case 'stream_event': {
+                // SDKPartialAssistantMessage — streaming content delta
+                const evt = msg.event;
+                if (evt.type === 'content_block_delta' &&
+                    'delta' in evt &&
+                    evt.delta.type === 'text_delta' &&
+                    'text' in evt.delta) {
+                    events.push({
+                        type: 'delta',
+                        content: evt.delta.text,
+                    });
+                }
+                break;
+            }
+            case 'assistant': {
+                // SDKAssistantMessage — complete assistant turn with text + tool_use blocks.
+                // Text blocks contain the agent's reasoning between tool calls (e.g.,
+                // "Let me read that file..." or "I see, now I'll..."). These MUST be
+                // emitted as deltas — stream_event deltas may not be available in V2.
+                if ('message' in msg && msg.message?.content) {
+                    for (const block of msg.message.content) {
+                        if (block.type === 'text' && block.text) {
+                            events.push({
+                                type: 'delta',
+                                content: block.text,
+                            });
+                        }
+                        else if (block.type === 'tool_use') {
+                            events.push({
+                                type: 'tool_use',
+                                label: block.name,
+                                detail: JSON.stringify(block.input ?? {}),
+                            });
+                        }
+                    }
+                }
+                // If the assistant message contains an error, emit it
+                if ('error' in msg && msg.error) {
+                    events.push({
+                        type: 'error',
+                        content: String(msg.error),
+                    });
+                }
+                break;
+            }
+            case 'result': {
+                // SDKResultMessage — success or error
+                if (msg.subtype === 'success') {
+                    events.push({
+                        type: 'done',
+                        content: msg.result,
+                        usage: {
+                            costUsd: msg.total_cost_usd,
+                            inputTokens: msg.usage?.input_tokens,
+                            outputTokens: msg.usage?.output_tokens,
+                            numTurns: msg.num_turns,
+                            durationMs: msg.duration_ms,
+                        },
+                    });
+                }
+                else {
+                    // SDKResultError
+                    const errorMsg = 'errors' in msg && Array.isArray(msg.errors) ? msg.errors.join('; ') : msg.subtype;
+                    events.push({
+                        type: 'error',
+                        content: errorMsg,
+                    });
+                }
+                break;
+            }
+            case 'system': {
+                if (!('subtype' in msg))
+                    break;
+                switch (msg.subtype) {
+                    case 'init':
+                        // Session initialized — model, tools, version
+                        if ('model' in msg) {
+                            const tools = 'tools' in msg && Array.isArray(msg.tools) ? msg.tools : [];
+                            const version = 'claude_code_version' in msg ? String(msg.claude_code_version) : '';
+                            events.push({
+                                type: 'init',
+                                label: String(msg.model),
+                                detail: `${tools.length} tools`,
+                                content: version ? `v${version}` : undefined,
+                            });
+                        }
+                        break;
+                    case 'status':
+                        if ('status' in msg) {
+                            events.push({
+                                type: 'status',
+                                content: String(msg.status ?? 'ready'),
+                            });
+                        }
+                        break;
+                    case 'api_retry':
+                        // API retry — let user know agent is retrying
+                        if ('attempt' in msg) {
+                            const attempt = msg.attempt;
+                            const maxRetries = 'max_retries' in msg ? msg.max_retries : '?';
+                            const delayMs = 'retry_delay_ms' in msg ? msg.retry_delay_ms : 0;
+                            const delaySec = Math.round(delayMs / 1000);
+                            events.push({
+                                type: 'api_retry',
+                                content: `Retrying API call (attempt ${attempt}/${maxRetries})${delaySec > 0 ? `, waiting ${delaySec}s` : ''}`,
+                            });
+                        }
+                        break;
+                    case 'task_started':
+                        if ('description' in msg && 'task_id' in msg) {
+                            events.push({
+                                type: 'task_started',
+                                label: String(msg.task_id),
+                                content: String(msg.description),
+                            });
+                        }
+                        break;
+                    case 'task_progress':
+                        if ('description' in msg && 'task_id' in msg) {
+                            events.push({
+                                type: 'task_progress',
+                                label: String(msg.task_id),
+                                content: String(msg.description),
+                            });
+                        }
+                        break;
+                    case 'task_notification':
+                        if ('summary' in msg && 'task_id' in msg) {
+                            const status = 'status' in msg ? String(msg.status) : 'done';
+                            events.push({
+                                type: 'task_done',
+                                label: String(msg.task_id),
+                                content: String(msg.summary),
+                                detail: status,
+                            });
+                        }
+                        break;
+                }
+                break;
+            }
+            case 'rate_limit_event': {
+                if ('rate_limit_info' in msg) {
+                    const info = msg.rate_limit_info;
+                    const status = info.status;
+                    if (status === 'rejected') {
+                        const resetsAt = info.resetsAt ? new Date(info.resetsAt).toLocaleTimeString() : 'soon';
+                        events.push({
+                            type: 'rate_limit',
+                            content: `Rate limited — resets at ${resetsAt}`,
+                        });
+                    }
+                    else if (status === 'allowed_warning') {
+                        const pct = info.utilization ? `${Math.round(info.utilization * 100)}%` : '';
+                        events.push({
+                            type: 'rate_limit',
+                            content: `Rate limit warning${pct ? ` (${pct} used)` : ''}`,
+                        });
+                    }
+                }
+                break;
+            }
+            case 'tool_use_summary': {
+                if ('summary' in msg) {
+                    events.push({
+                        type: 'tool_result',
+                        content: msg.summary,
+                    });
+                }
+                break;
+            }
+            case 'tool_progress': {
+                if ('tool_name' in msg) {
+                    events.push({
+                        type: 'status',
+                        label: msg.tool_name,
+                        content: `Running ${msg.tool_name}...`,
+                    });
+                }
+                break;
+            }
+            default:
+                // Ignore: user, user_replay, auth_status, compact_boundary,
+                // local_command_output, hook_*, files_persisted,
+                // elicitation_complete, prompt_suggestion
+                break;
+        }
+        return events;
+    }
+}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.d.ts

@@ -6,6 +6,7 @@
  */
 import type { AgentType, AgentConfig } from '../../../../../domain/generated/output.js';
 import type { IAgentExecutor } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
+import type { IInteractiveAgentExecutor } from '../../../../../application/ports/output/agents/interactive-agent-executor.interface.js';
 import type { IAgentExecutorFactory, AgentCliInfo } from '../../../../../application/ports/output/agents/agent-executor-factory.interface.js';
 export declare class MockAgentExecutorFactory implements IAgentExecutorFactory {
     private readonly executor;
@@ -13,5 +14,7 @@ export declare class MockAgentExecutorFactory implements IAgentExecutorFactory {
     getSupportedAgents(): AgentType[];
     getCliInfo(): AgentCliInfo[];
     getSupportedModels(_agentType: AgentType): string[];
+    createInteractiveExecutor(_agentType: AgentType, _authConfig: AgentConfig): IInteractiveAgentExecutor;
+    supportsInteractive(_agentType: AgentType): boolean;
 }
 //# sourceMappingURL=mock-executor-factory.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AACjH,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,oFAAoF,CAAC;AAG5F,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IAI/E,kBAAkB,IAAI,SAAS,EAAE;IAIjC,UAAU,IAAI,YAAY,EAAE;IAI5B,kBAAkB,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,EAAE;CAGpD"}
+{"version":3,"file":"mock-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AACjH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wFAAwF,CAAC;AACxI,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,oFAAoF,CAAC;AAG5F,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IAI/E,kBAAkB,IAAI,SAAS,EAAE;IAIjC,UAAU,IAAI,YAAY,EAAE;IAI5B,kBAAkB,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,EAAE;IAInD,yBAAyB,CACvB,UAAU,EAAE,SAAS,EACrB,WAAW,EAAE,WAAW,GACvB,yBAAyB;IAI5B,mBAAmB,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO;CAGpD"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.js

@@ -19,4 +19,10 @@ export class MockAgentExecutorFactory {
     getSupportedModels(_agentType) {
         return [];
     }
+    createInteractiveExecutor(_agentType, _authConfig) {
+        throw new Error('Interactive sessions are not supported in mock executor');
+    }
+    supportsInteractive(_agentType) {
+        return false;
+    }
 }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-graph.d.ts

@@ -89,7 +89,7 @@ export declare function createFeatureAgentGraph(depsOrExecutor: FeatureAgentGrap
     ciFixAttempts?: number | undefined;
     ciFixHistory?: import("../../../../domain/index.js").CiFixRecord[] | undefined;
     ciFixStatus?: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted" | undefined;
-}, "implement" | "__start__" | "analyze" | "requirements" | "research" | "plan" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
+}, "plan" | "implement" | "__start__" | "analyze" | "requirements" | "research" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
     featureId: {
         (): import("@langchain/langgraph").LastValue<string>;
         (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;