@shepai/cli 1.175.1-pr537.fc6a92c → 1.176.0

package/dist/packages/core/src/infrastructure/services/interactive/interactive-session.service.d.ts

@@ -1,13 +1,23 @@
 /**
- * Interactive Session Service (Facade)
+ * Interactive Session Service
  *
- * Thin facade that delegates to focused sub-classes:
- * - SubscriberNotifier — real-time subscription management
- * - SessionStateManager — session CRUD, stop, markRead, turn statuses
- * - ChatStateBuilder — chat UI state reconstruction
- * - TurnExecutor — turn execution, message persistence, user interactions
- * - SessionBootSequence — session initialization and agent boot
+ * Singleton service that owns the lifecycle of all interactive agent sessions.
+ * Uses the IAgentExecutorFactory to create interactive executors that manage
+ * persistent sessions via the agent SDK. Multi-turn context is maintained
+ * by the SDK session handle internally.
  *
+ * Dependencies are injected via constructor for testability (no real processes
+ * are spawned in unit tests — the factory is replaced with a test double).
+ */
+import type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState } from '../../../application/ports/output/services/interactive-session-service.interface.js';
+import type { IInteractiveSessionRepository } from '../../../application/ports/output/repositories/interactive-session-repository.interface.js';
+import type { IInteractiveMessageRepository } from '../../../application/ports/output/repositories/interactive-message-repository.interface.js';
+import type { IAgentExecutorFactory } from '../../../application/ports/output/agents/agent-executor-factory.interface.js';
+import type { IFeatureRepository } from '../../../application/ports/output/repositories/feature-repository.interface.js';
+import type { InteractiveSession, InteractiveMessage } from '../../../domain/generated/output.js';
+import { type FeatureContextBuilder } from './feature-context.builder.js';
+/**
+ * Core service managing interactive agent session lifecycles.
  * Must be registered as a singleton in the DI container.
  *
  * **Polymorphic `featureId` scope key:** The `featureId` parameter accepted
@@ -18,28 +28,42 @@
  * - Global chat: literal string `"global"`
  *
  * Sessions and messages are isolated by this key regardless of chat type.
+ *
+ * @todo Consider renaming to `scopeId` + adding a `scopeType` discriminator.
  */
-import type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState } from '../../../application/ports/output/services/interactive-session-service.interface.js';
-import type { IInteractiveSessionRepository } from '../../../application/ports/output/repositories/interactive-session-repository.interface.js';
-import type { IInteractiveMessageRepository } from '../../../application/ports/output/repositories/interactive-message-repository.interface.js';
-import type { IAgentExecutorFactory } from '../../../application/ports/output/agents/agent-executor-factory.interface.js';
-import type { IFeatureRepository } from '../../../application/ports/output/repositories/feature-repository.interface.js';
-import type { InteractiveSession, InteractiveMessage } from '../../../domain/generated/output.js';
-import type { FeatureContextBuilder } from './feature-context.builder.js';
 export declare class InteractiveSessionService implements IInteractiveSessionService {
+    private readonly sessionRepo;
+    private readonly messageRepo;
+    private readonly executorFactory;
+    private readonly featureRepo;
+    private readonly contextBuilder;
     /** Live sessions indexed by sessionId. */
     private sessions;
     /** Cached agentSessionIds from stopped sessions, keyed by featureId. */
     private stoppedAgentSessionIds;
-    private readonly notifier;
-    private readonly stateManager;
-    private readonly chatStateBuilder;
-    private readonly turnExecutor;
-    private readonly bootSequence;
+    /**
+     * Feature-level subscribers that survive session restarts.
+     *
+     * Unlike session-level subscribers (in SessionState.subscribers), these
+     * persist when a session dies and a new one boots. SSE connections
+     * subscribe here so they continue receiving events from new sessions.
+     */
+    private featureSubscribers;
     constructor(sessionRepo: IInteractiveSessionRepository, messageRepo: IInteractiveMessageRepository, executorFactory: IAgentExecutorFactory, featureRepo: IFeatureRepository, contextBuilder: FeatureContextBuilder);
     startSession(featureId: string, worktreePath: string, model?: string, agentType?: string): Promise<InteractiveSession>;
+    /**
+     * Asynchronously complete the boot sequence: build feature context,
+     * create an SDK session via the interactive executor, send the boot
+     * prompt, iterate the stream for the greeting, persist the greeting,
+     * and transition the session to "ready".
+     */
+    private completeBootAsync;
     stopSession(sessionId: string): Promise<void>;
     sendMessage(sessionId: string, content: string): Promise<InteractiveMessage>;
+    /**
+     * Execute a turn via the SDK session handle and persist the assistant response.
+     */
+    private executeAndPersistTurn;
     getMessages(featureId: string, limit?: number): Promise<InteractiveMessage[]>;
     clearMessages(featureId: string): Promise<void>;
     getSession(sessionId: string): Promise<InteractiveSession | null>;
@@ -52,11 +76,38 @@ export declare class InteractiveSessionService implements IInteractiveSessionSer
     getTurnStatuses(featureIds: string[]): Promise<Map<string, string>>;
     getAllActiveTurnStatuses(): Promise<Map<string, string>>;
     respondToInteraction(featureId: string, answers: Record<string, string>): Promise<void>;
+    /**
+     * Build the onUserQuestion callback for a session.
+     * Called by the SDK's canUseTool when the agent invokes AskUserQuestion.
+     * Returns a Promise that doesn't resolve until the user submits their answers.
+     */
+    private buildOnUserQuestionCallback;
+    /** Find the in-memory state for an active session for a feature. */
+    private findActiveStateForFeature;
+    /** Resolve the agent type from an explicit override or settings. */
+    private resolveAgentType;
+    /** Resolve the auth config from settings, with a safe fallback. */
+    private resolveAuthConfig;
+    /**
+     * Persist a tool/system event as its own assistant message in the DB.
+     * Each event gets its own bubble in the chat thread.
+     */
+    private persistToolEvent;
+    /**
+     * Dispatch a StreamChunk to all subscribers for a session.
+     *
+     * Sends to both session-level subscribers (legacy, for sessionId-based
+     * subscribe()) and feature-level subscribers (for SSE connections that
+     * must survive session restarts).
+     */
+    private notify;
     /** Start or restart the idle timeout timer for a session. */
     private resetTimer;
     /** Cancel the idle timer for a session. */
     private clearTimer;
     /** Read the auto-timeout from settings or fall back to default. */
     private getTimeoutMs;
+    /** Read the concurrent session cap from settings or fall back to default. */
+    private getCap;
 }
 //# sourceMappingURL=interactive-session.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/interactive/interactive-session.service.d.ts.map

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