@shepai/cli 1.151.2-pr438.6135e39 → 1.151.2-pr460.ba381d8

package/dist/packages/core/src/application/ports/output/services/interactive-session-service.interface.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Interactive Session Service Interface
+ *
+ * Output port for managing per-feature interactive agent sessions.
+ * Handles session lifecycle (start, stop), message I/O, and real-time
+ * stdout streaming to SSE consumers.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides the concrete implementation (singleton)
+ */
+import type { InteractiveSession, InteractiveMessage } from '../../../../domain/generated/output.js';
+/**
+ * A single streaming chunk forwarded from agent stdout to an SSE consumer.
+ */
+export interface StreamChunk {
+    /** Incremental output text from the agent */
+    delta: string;
+    /** True when the agent has finished this response turn */
+    done: boolean;
+    /** Optional log entry for tool use / thinking events (shown as status indicator) */
+    log?: string;
+    /** Structured activity event for rich rendering in the thread */
+    activity?: StreamActivity;
+}
+/**
+ * A structured activity event emitted during agent execution.
+ * Rendered as a distinct inline entry in the chat thread.
+ */
+export interface StreamActivity {
+    kind: 'tool_use' | 'tool_result' | 'thinking' | 'system';
+    /** Tool name or system event label */
+    label: string;
+    /** Human-readable detail (file path, command, pattern, etc.) */
+    detail?: string;
+}
+/**
+ * Function returned by subscribe() to remove the listener.
+ */
+export type UnsubscribeFn = () => void;
+/**
+ * Chat state returned by getChatState — single response for the frontend.
+ */
+export interface ChatState {
+    /** All persisted messages for the feature, ordered by created_at ASC */
+    messages: InteractiveMessage[];
+    /** Status of the active session (null if no session exists) */
+    sessionStatus: string | null;
+    /** In-progress streaming text from the agent (null when idle) */
+    streamingText: string | null;
+    /** Session info for the toolbar (null if no active session) */
+    sessionInfo: SessionInfo | null;
+}
+/** Live session metadata for the frontend toolbar. */
+export interface SessionInfo {
+    pid: number | null;
+    sessionId: string | null;
+    model: string | null;
+    startedAt: string;
+    idleTimeoutMinutes: number;
+    lastActivityAt: string;
+}
+/**
+ * Service interface for interactive session lifecycle management.
+ *
+ * Implementations are expected to be singletons: they maintain in-memory
+ * state (process handles, timers, subscriber maps) across multiple HTTP
+ * requests for the duration of the server process.
+ *
+ * **Polymorphic `featureId` scope key:** The `featureId` parameter used
+ * throughout this interface is a polymorphic scope key that determines
+ * message and session isolation:
+ * - Feature chat: actual feature UUID (e.g. `"feat-abc123"`)
+ * - Repository chat: repo identifier (e.g. `"repo-<repoId>"`)
+ * - Global chat: literal string `"global"`
+ *
+ * All messages and sessions are scoped by this key regardless of chat type.
+ *
+ * @todo Consider renaming to `scopeId` with a `scopeType` discriminator
+ *       for better type safety and clarity.
+ */
+export interface IInteractiveSessionService {
+    /**
+     * Start a new interactive session for the given feature.
+     * Creates a DB record (status=booting), spawns the agent process with
+     * the feature worktree as CWD, injects the feature context prompt, and
+     * waits for the agent's first response before returning.
+     *
+     * @param featureId - The feature to associate the session with
+     * @param worktreePath - Absolute path to the feature worktree (CWD for the agent)
+     * @returns The newly created session record (status may still be 'booting')
+     * @throws ConcurrentSessionLimitError when the configured cap is reached
+     */
+    startSession(featureId: string, worktreePath: string, model?: string, agentType?: string): Promise<InteractiveSession>;
+    /**
+     * Stop an active session: send SIGTERM to the process, cancel the idle
+     * timer, and mark the DB record as stopped. Idempotent — calling on an
+     * already-stopped session is a no-op.
+     *
+     * @param sessionId - The session to stop
+     */
+    stopSession(sessionId: string): Promise<void>;
+    /**
+     * Send a user message to the agent stdin and persist it to the DB.
+     * Resets the idle timeout clock. Returns the persisted message record.
+     *
+     * @param sessionId - The target session
+     * @param content - Message text (max 32 KB)
+     * @returns The persisted InteractiveMessage
+     * @throws Error if the session is not in 'ready' status
+     */
+    sendMessage(sessionId: string, content: string): Promise<InteractiveMessage>;
+    /**
+     * Return all messages for the feature, ordered by created_at ASC.
+     * History is scoped per feature (not per session) for cross-session continuity.
+     *
+     * @param featureId - The feature whose message history to retrieve
+     * @param limit - Max messages to return (default 200)
+     */
+    getMessages(featureId: string, limit?: number): Promise<InteractiveMessage[]>;
+    /**
+     * Return the most recent session for the given ID, or null if not found.
+     *
+     * @param sessionId - The session ID to look up
+     */
+    getSession(sessionId: string): Promise<InteractiveSession | null>;
+    /**
+     * Delete all messages for a feature (clear chat history).
+     *
+     * @param featureId - The feature whose messages to delete
+     */
+    clearMessages(featureId: string): Promise<void>;
+    /**
+     * Subscribe to real-time stdout chunks for a session.
+     * The callback is invoked with each agent output chunk as it arrives and
+     * once more with done=true when the turn ends.
+     *
+     * @param sessionId - The session to subscribe to
+     * @param onChunk - Callback invoked with each chunk
+     * @returns An unsubscribe function; call it to stop receiving events
+     */
+    subscribe(sessionId: string, onChunk: (chunk: StreamChunk) => void): UnsubscribeFn;
+    /**
+     * Send a user message for a feature. The service handles session lifecycle:
+     * - Persists the user message to DB immediately
+     * - If session is ready: sends to agent
+     * - If session is booting: queues the message
+     * - If no session: boots one and queues the message
+     *
+     * @returns The persisted user message
+     */
+    sendUserMessage(featureId: string, content: string, worktreePath: string): Promise<InteractiveMessage>;
+    /**
+     * Get the complete chat state for a feature in a single call.
+     * Merges DB messages with any in-flight streaming content.
+     */
+    getChatState(featureId: string): Promise<ChatState>;
+    /**
+     * Subscribe to real-time chunks for a feature's active session.
+     * Resolves the active session internally.
+     */
+    subscribeByFeature(featureId: string, onChunk: (chunk: StreamChunk) => void): UnsubscribeFn;
+    /**
+     * Stop the active session for a feature. Kills the agent process.
+     * Idempotent — no-op if no active session exists.
+     */
+    stopByFeature(featureId: string): Promise<void>;
+}
+//# sourceMappingURL=interactive-session-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/interactive-session-service.interface.d.ts.map

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

package/dist/packages/core/src/application/ports/output/services/interactive-session-service.interface.js

@@ -0,0 +1,12 @@
+/**
+ * Interactive Session Service Interface
+ *
+ * Output port for managing per-feature interactive agent sessions.
+ * Handles session lifecycle (start, stop), message I/O, and real-time
+ * stdout streaming to SSE consumers.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides the concrete implementation (singleton)
+ */
+export {};

package/dist/packages/core/src/application/use-cases/interactive/get-interactive-chat-state.use-case.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get Interactive Chat State Use Case
+ *
+ * Returns the complete chat state for a feature: messages, session status,
+ * in-flight streaming text, and session metadata. Single call for the frontend.
+ */
+import type { IInteractiveSessionService, ChatState } from '../../ports/output/services/interactive-session-service.interface.js';
+/**
+ * Input for getting interactive chat state.
+ */
+export interface GetInteractiveChatStateInput {
+    featureId: string;
+}
+/**
+ * Use case for retrieving the complete chat state for a feature.
+ *
+ * Algorithm:
+ * 1. Delegate to service.getChatState
+ * 2. Return merged state (messages + session status + streaming text)
+ */
+export declare class GetInteractiveChatStateUseCase {
+    private readonly service;
+    constructor(service: IInteractiveSessionService);
+    execute(input: GetInteractiveChatStateInput): Promise<ChatState>;
+}
+//# sourceMappingURL=get-interactive-chat-state.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/get-interactive-chat-state.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-interactive-chat-state.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/get-interactive-chat-state.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAC1B,SAAS,EACV,MAAM,sEAAsE,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBACa,8BAA8B;IAGvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAGhD,OAAO,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,SAAS,CAAC;CAGvE"}

package/dist/packages/core/src/application/use-cases/interactive/get-interactive-chat-state.use-case.js

@@ -0,0 +1,41 @@
+/**
+ * Get Interactive Chat State Use Case
+ *
+ * Returns the complete chat state for a feature: messages, session status,
+ * in-flight streaming text, and session metadata. Single call for the frontend.
+ */
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/**
+ * Use case for retrieving the complete chat state for a feature.
+ *
+ * Algorithm:
+ * 1. Delegate to service.getChatState
+ * 2. Return merged state (messages + session status + streaming text)
+ */
+let GetInteractiveChatStateUseCase = class GetInteractiveChatStateUseCase {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async execute(input) {
+        return this.service.getChatState(input.featureId);
+    }
+};
+GetInteractiveChatStateUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object])
+], GetInteractiveChatStateUseCase);
+export { GetInteractiveChatStateUseCase };

package/dist/packages/core/src/application/use-cases/interactive/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Interactive Session Use Cases Module
+ *
+ * Exports use cases for interactive agent session operations.
+ */
+export { StartInteractiveSessionUseCase } from './start-interactive-session.use-case.js';
+export type { StartInteractiveSessionInput } from './start-interactive-session.use-case.js';
+export { SendInteractiveMessageUseCase } from './send-interactive-message.use-case.js';
+export type { SendInteractiveMessageInput } from './send-interactive-message.use-case.js';
+export { StopInteractiveSessionUseCase } from './stop-interactive-session.use-case.js';
+export type { StopInteractiveSessionInput } from './stop-interactive-session.use-case.js';
+export { GetInteractiveChatStateUseCase } from './get-interactive-chat-state.use-case.js';
+export type { GetInteractiveChatStateInput } from './get-interactive-chat-state.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,YAAY,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,YAAY,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,YAAY,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/packages/core/src/application/use-cases/interactive/index.js

@@ -0,0 +1,9 @@
+/**
+ * Interactive Session Use Cases Module
+ *
+ * Exports use cases for interactive agent session operations.
+ */
+export { StartInteractiveSessionUseCase } from './start-interactive-session.use-case.js';
+export { SendInteractiveMessageUseCase } from './send-interactive-message.use-case.js';
+export { StopInteractiveSessionUseCase } from './stop-interactive-session.use-case.js';
+export { GetInteractiveChatStateUseCase } from './get-interactive-chat-state.use-case.js';

package/dist/packages/core/src/application/use-cases/interactive/send-interactive-message.use-case.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Send Interactive Message Use Case
+ *
+ * Sends a user message to the interactive session for a feature.
+ * The service handles session lifecycle: starts a session if needed,
+ * queues the message if the session is booting, or delivers immediately
+ * if the session is ready.
+ */
+import type { IInteractiveSessionService } from '../../ports/output/services/interactive-session-service.interface.js';
+import type { InteractiveMessage } from '../../../domain/generated/output.js';
+/**
+ * Input for sending a message to an interactive session.
+ */
+export interface SendInteractiveMessageInput {
+    featureId: string;
+    content: string;
+    worktreePath: string;
+}
+/**
+ * Use case for sending a user message to an interactive agent session.
+ *
+ * Algorithm:
+ * 1. Delegate to service.sendUserMessage with featureId, content, worktreePath
+ * 2. Return the persisted user message
+ */
+export declare class SendInteractiveMessageUseCase {
+    private readonly service;
+    constructor(service: IInteractiveSessionService);
+    execute(input: SendInteractiveMessageInput): Promise<InteractiveMessage>;
+}
+//# sourceMappingURL=send-interactive-message.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/send-interactive-message.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-interactive-message.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/send-interactive-message.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AACvH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBACa,6BAA6B;IAGtC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAGhD,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG/E"}

package/dist/packages/core/src/application/use-cases/interactive/send-interactive-message.use-case.js

@@ -0,0 +1,43 @@
+/**
+ * Send Interactive Message Use Case
+ *
+ * Sends a user message to the interactive session for a feature.
+ * The service handles session lifecycle: starts a session if needed,
+ * queues the message if the session is booting, or delivers immediately
+ * if the session is ready.
+ */
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/**
+ * Use case for sending a user message to an interactive agent session.
+ *
+ * Algorithm:
+ * 1. Delegate to service.sendUserMessage with featureId, content, worktreePath
+ * 2. Return the persisted user message
+ */
+let SendInteractiveMessageUseCase = class SendInteractiveMessageUseCase {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async execute(input) {
+        return this.service.sendUserMessage(input.featureId, input.content, input.worktreePath);
+    }
+};
+SendInteractiveMessageUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object])
+], SendInteractiveMessageUseCase);
+export { SendInteractiveMessageUseCase };

package/dist/packages/core/src/application/use-cases/interactive/start-interactive-session.use-case.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Start Interactive Session Use Case
+ *
+ * Starts a new interactive agent session for a feature.
+ * Delegates to the interactive session service for session lifecycle management.
+ */
+import type { IInteractiveSessionService } from '../../ports/output/services/interactive-session-service.interface.js';
+import type { InteractiveSession } from '../../../domain/generated/output.js';
+/**
+ * Input for starting an interactive session.
+ */
+export interface StartInteractiveSessionInput {
+    featureId: string;
+    worktreePath: string;
+    /** Agent type for forward compatibility — will be used in Phase 3 when the service is refactored. */
+    agentType?: string;
+    /** Model override, e.g. 'claude-sonnet-4-6' */
+    model?: string;
+}
+/**
+ * Use case for starting a new interactive agent session.
+ *
+ * Algorithm:
+ * 1. Delegate to the service with featureId and worktreePath
+ * 2. Return the created session record
+ *
+ * @throws ConcurrentSessionLimitError when the configured session cap is reached
+ */
+export declare class StartInteractiveSessionUseCase {
+    private readonly service;
+    constructor(service: IInteractiveSessionService);
+    execute(input: StartInteractiveSessionInput): Promise<InteractiveSession>;
+}
+//# sourceMappingURL=start-interactive-session.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/start-interactive-session.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-interactive-session.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/start-interactive-session.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AACvH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBACa,8BAA8B;IAGvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAGhD,OAAO,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAQhF"}

package/dist/packages/core/src/application/use-cases/interactive/start-interactive-session.use-case.js

@@ -0,0 +1,43 @@
+/**
+ * Start Interactive Session Use Case
+ *
+ * Starts a new interactive agent session for a feature.
+ * Delegates to the interactive session service for session lifecycle management.
+ */
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/**
+ * Use case for starting a new interactive agent session.
+ *
+ * Algorithm:
+ * 1. Delegate to the service with featureId and worktreePath
+ * 2. Return the created session record
+ *
+ * @throws ConcurrentSessionLimitError when the configured session cap is reached
+ */
+let StartInteractiveSessionUseCase = class StartInteractiveSessionUseCase {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async execute(input) {
+        return this.service.startSession(input.featureId, input.worktreePath, input.model, input.agentType);
+    }
+};
+StartInteractiveSessionUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object])
+], StartInteractiveSessionUseCase);
+export { StartInteractiveSessionUseCase };

package/dist/packages/core/src/application/use-cases/interactive/stop-interactive-session.use-case.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stop Interactive Session Use Case
+ *
+ * Stops the active interactive agent session for a feature.
+ * Kills the agent process and marks the session as stopped.
+ * Idempotent — no-op if no active session exists.
+ */
+import type { IInteractiveSessionService } from '../../ports/output/services/interactive-session-service.interface.js';
+/**
+ * Input for stopping an interactive session.
+ */
+export interface StopInteractiveSessionInput {
+    featureId: string;
+}
+/**
+ * Use case for stopping the active interactive session for a feature.
+ *
+ * Algorithm:
+ * 1. Delegate to service.stopByFeature
+ * 2. The service handles process cleanup and DB status update
+ */
+export declare class StopInteractiveSessionUseCase {
+    private readonly service;
+    constructor(service: IInteractiveSessionService);
+    execute(input: StopInteractiveSessionInput): Promise<void>;
+}
+//# sourceMappingURL=stop-interactive-session.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/stop-interactive-session.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-interactive-session.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/stop-interactive-session.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAEvH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBACa,6BAA6B;IAGtC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAGhD,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}

package/dist/packages/core/src/application/use-cases/interactive/stop-interactive-session.use-case.js

@@ -0,0 +1,42 @@
+/**
+ * Stop Interactive Session Use Case
+ *
+ * Stops the active interactive agent session for a feature.
+ * Kills the agent process and marks the session as stopped.
+ * Idempotent — no-op if no active session exists.
+ */
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/**
+ * Use case for stopping the active interactive session for a feature.
+ *
+ * Algorithm:
+ * 1. Delegate to service.stopByFeature
+ * 2. The service handles process cleanup and DB status update
+ */
+let StopInteractiveSessionUseCase = class StopInteractiveSessionUseCase {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async execute(input) {
+        return this.service.stopByFeature(input.featureId);
+    }
+};
+StopInteractiveSessionUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object])
+], StopInteractiveSessionUseCase);
+export { StopInteractiveSessionUseCase };

package/dist/packages/core/src/domain/errors/concurrent-session-limit.error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Concurrent Session Limit Error
+ *
+ * Thrown by InteractiveSessionService.startSession() when the number of
+ * active sessions (status 'booting' or 'ready') has reached the configured
+ * maximum. The API route translates this to HTTP 429.
+ */
+export declare class ConcurrentSessionLimitError extends Error {
+    readonly activeSessions: number;
+    readonly cap: number;
+    constructor(activeSessions: number, cap: number);
+}
+//# sourceMappingURL=concurrent-session-limit.error.d.ts.map

package/dist/packages/core/src/domain/errors/concurrent-session-limit.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrent-session-limit.error.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/domain/errors/concurrent-session-limit.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;aAElC,cAAc,EAAE,MAAM;aACtB,GAAG,EAAE,MAAM;gBADX,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM;CAS9B"}

package/dist/packages/core/src/domain/errors/concurrent-session-limit.error.js

@@ -0,0 +1,19 @@
+/**
+ * Concurrent Session Limit Error
+ *
+ * Thrown by InteractiveSessionService.startSession() when the number of
+ * active sessions (status 'booting' or 'ready') has reached the configured
+ * maximum. The API route translates this to HTTP 429.
+ */
+export class ConcurrentSessionLimitError extends Error {
+    activeSessions;
+    cap;
+    constructor(activeSessions, cap) {
+        super(`Cannot start a new session: ${activeSessions} of ${cap} allowed concurrent sessions are active. Stop an existing session first.`);
+        this.activeSessions = activeSessions;
+        this.cap = cap;
+        this.name = 'ConcurrentSessionLimitError';
+        // Maintain proper prototype chain in TypeScript/ES5 targets
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}