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

package/apis/json-schema/InteractiveAgentConfig.yaml

@@ -0,0 +1,25 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InteractiveAgentConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: true
+    description: "Whether the interactive agent Chat tab is enabled (default: true)"
+  autoTimeoutMinutes:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    default: 15
+    description: "Idle timeout in minutes before auto-stopping the agent (default: 15, range: 1-120)"
+  maxConcurrentSessions:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    default: 3
+    description: "Maximum number of concurrent active interactive sessions (default: 3)"
+required:
+  - enabled
+  - autoTimeoutMinutes
+  - maxConcurrentSessions
+description: Interactive agent chat tab configuration

package/apis/json-schema/InteractiveMessage.yaml

@@ -0,0 +1,23 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InteractiveMessage.yaml
+type: object
+properties:
+  featureId:
+    type: string
+    description: "Polymorphic scope key: feature UUID, 'repo-<id>', or 'global'. Future: rename to scopeId + scopeType."
+  sessionId:
+    type: string
+    description: Session ID during which this message was sent (optional)
+  role:
+    $ref: InteractiveMessageRole.yaml
+    description: "Author role: user or assistant"
+  content:
+    type: string
+    description: Full message content (finalised after streaming for assistant messages)
+required:
+  - featureId
+  - role
+  - content
+allOf:
+  - $ref: BaseEntity.yaml
+description: A single chat message in a per-feature interactive agent session

package/apis/json-schema/InteractiveMessageRole.yaml

@@ -0,0 +1,7 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InteractiveMessageRole.yaml
+type: string
+enum:
+  - user
+  - assistant
+description: Author role for an interactive chat message

package/apis/json-schema/InteractiveSession.yaml

@@ -0,0 +1,30 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InteractiveSession.yaml
+type: object
+properties:
+  featureId:
+    $ref: UUID.yaml
+    description: "Polymorphic scope key: feature UUID, 'repo-<id>', or 'global'. Future: rename to scopeId + scopeType."
+  status:
+    $ref: InteractiveSessionStatus.yaml
+    description: Current lifecycle status of the interactive session
+  startedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the agent process was spawned
+  stoppedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the session ended (null if still active)
+  lastActivityAt:
+    type: string
+    format: date-time
+    description: Timestamp of last user message or agent stdout activity
+required:
+  - featureId
+  - status
+  - startedAt
+  - lastActivityAt
+allOf:
+  - $ref: BaseEntity.yaml
+description: Per-feature interactive agent session record

package/apis/json-schema/InteractiveSessionStatus.yaml

@@ -0,0 +1,9 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InteractiveSessionStatus.yaml
+type: string
+enum:
+  - booting
+  - ready
+  - stopped
+  - error
+description: Lifecycle status of an interactive agent session

package/apis/json-schema/Settings.yaml

@@ -30,6 +30,9 @@ properties:
     type: boolean
     default: false
     description: "Whether first-run onboarding has been completed (default: false)"
+  interactiveAgent:
+    $ref: InteractiveAgentConfig.yaml
+    description: Interactive agent chat configuration (optional, defaults applied at runtime)
 required:
   - models
   - user

package/dist/packages/core/src/application/ports/output/agents/agent-executor-factory.interface.d.ts

@@ -18,6 +18,7 @@
  */
 import type { AgentType, AgentConfig } from '../../../../domain/generated/output.js';
 import type { IAgentExecutor } from './agent-executor.interface.js';
+import type { IInteractiveAgentExecutor } from './interactive-agent-executor.interface.js';
 /**
  * CLI binary info for an agent executor, used for version detection.
  */
@@ -67,5 +68,21 @@ export interface 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.
+     *
+     * @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.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/agents/agent-executor-factory.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor-factory.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-executor-factory.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,GAAG,cAAc,CAAC;IAE9E;;;;OAIG;IACH,kBAAkB,IAAI,SAAS,EAAE,CAAC;IAElC;;;;;OAKG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAAC;CACpD"}
+{"version":3,"file":"agent-executor-factory.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-executor-factory.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,GAAG,cAAc,CAAC;IAE9E;;;;OAIG;IACH,kBAAkB,IAAI,SAAS,EAAE,CAAC;IAElC;;;;;OAKG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAAC;IAEnD;;;;;;;OAOG;IACH,yBAAyB,CACvB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,WAAW,GACtB,yBAAyB,CAAC;IAE7B;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;CACpD"}

package/dist/packages/core/src/application/ports/output/agents/index.d.ts

@@ -15,4 +15,5 @@ export type { IFeatureAgentProcessService } from './feature-agent-process.interf
 export type { IStructuredAgentCaller, StructuredCallOptions, } from './structured-agent-caller.interface.js';
 export { StructuredCallError } from './structured-call-error.js';
 export type { IAgentSessionRepository, ListSessionsOptions, GetSessionOptions, } from './agent-session-repository.interface.js';
+export type { IInteractiveAgentExecutor, InteractiveAgentOptions, InteractiveAgentEvent, InteractiveAgentSessionHandle, } from './interactive-agent-executor.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACjG,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACjG,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,2CAA2C,CAAC"}

package/dist/packages/core/src/application/ports/output/agents/interactive-agent-executor.interface.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Interactive Agent Executor Interface
+ *
+ * Output port for creating and managing interactive agent sessions.
+ * Provides clean domain types (InteractiveAgentEvent, InteractiveAgentSessionHandle)
+ * that decouple the application layer from any SDK specifics.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface and its domain types
+ * - Infrastructure layer provides concrete implementations
+ * - No SDK types leak through this boundary
+ */
+/** Options for creating/resuming an interactive agent session. */
+export interface InteractiveAgentOptions {
+    /** Absolute worktree path (CWD for agent) */
+    cwd: string;
+    /** Model override (e.g. 'claude-sonnet-4-6') */
+    model?: string;
+    /** Feature context string to append to system prompt */
+    systemPrompt?: string;
+}
+/** Event emitted by an interactive agent session stream. */
+export interface InteractiveAgentEvent {
+    type: 'delta' | 'tool_use' | 'tool_result' | 'status' | 'done' | 'error' | 'init' | 'api_retry' | 'rate_limit' | 'task_started' | 'task_progress' | 'task_done';
+    content?: string;
+    label?: string;
+    detail?: string;
+    /** Usage/cost metadata (attached to 'done' events) */
+    usage?: {
+        costUsd?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        numTurns?: number;
+        durationMs?: number;
+    };
+}
+/** Handle to a live interactive agent session. */
+export interface InteractiveAgentSessionHandle {
+    /** The agent's session ID (used for resumption) */
+    readonly sessionId: string;
+    /** Send a user message to the agent */
+    send(message: string): Promise<void>;
+    /** Iterate response events from the agent */
+    stream(): AsyncIterable<InteractiveAgentEvent>;
+    /** Terminate the session */
+    close(): Promise<void>;
+}
+/** Executor interface for interactive agent sessions. */
+export interface IInteractiveAgentExecutor {
+    createSession(options: InteractiveAgentOptions): Promise<InteractiveAgentSessionHandle>;
+    resumeSession(sessionId: string, options: InteractiveAgentOptions): Promise<InteractiveAgentSessionHandle>;
+}
+//# sourceMappingURL=interactive-agent-executor.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/agents/interactive-agent-executor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-agent-executor.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/interactive-agent-executor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kEAAkE;AAClE,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EACA,OAAO,GACP,UAAU,GACV,aAAa,GACb,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,GACX,YAAY,GACZ,cAAc,GACd,eAAe,GACf,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,6CAA6C;IAC7C,MAAM,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC/C,4BAA4B;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACxF,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C"}

package/dist/packages/core/src/application/ports/output/agents/interactive-agent-executor.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Interactive Agent Executor Interface
+ *
+ * Output port for creating and managing interactive agent sessions.
+ * Provides clean domain types (InteractiveAgentEvent, InteractiveAgentSessionHandle)
+ * that decouple the application layer from any SDK specifics.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface and its domain types
+ * - Infrastructure layer provides concrete implementations
+ * - No SDK types leak through this boundary
+ */
+export {};

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts

@@ -6,4 +6,6 @@
 export type { IFeatureRepository, FeatureListFilters } from './feature-repository.interface.js';
 export type { ISettingsRepository } from './settings.repository.interface.js';
 export type { IRepositoryRepository } from './repository-repository.interface.js';
+export type { IInteractiveSessionRepository } from './interactive-session-repository.interface.js';
+export type { IInteractiveMessageRepository } from './interactive-message-repository.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/packages/core/src/application/ports/output/repositories/interactive-message-repository.interface.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Interactive Message Repository Interface
+ *
+ * Output port for InteractiveMessage persistence operations.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides the SQLite implementation
+ */
+import type { InteractiveMessage } from '../../../../domain/generated/output.js';
+/**
+ * Repository interface for InteractiveMessage entity persistence.
+ */
+export interface IInteractiveMessageRepository {
+    /**
+     * Persist a new message record.
+     */
+    create(message: InteractiveMessage): Promise<void>;
+    /**
+     * Find all messages for a feature, ordered by created_at ASC.
+     * Messages are scoped by featureId (not sessionId) for cross-session continuity.
+     *
+     * @param featureId - Polymorphic scope key: may be a spec ID, repo ID, or any
+     *   future entity that owns an interactive chat. Not a FK to a single table.
+     * @param limit - Maximum number of messages to return (default 200)
+     */
+    findByFeatureId(featureId: string, limit?: number): Promise<InteractiveMessage[]>;
+    /**
+     * Find all messages for a specific session, ordered by created_at ASC.
+     */
+    findBySessionId(sessionId: string): Promise<InteractiveMessage[]>;
+    /**
+     * Delete all messages for a feature. Used for "clear chat" functionality.
+     */
+    deleteByFeatureId(featureId: string): Promise<void>;
+}
+//# sourceMappingURL=interactive-message-repository.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/interactive-message-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-message-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/interactive-message-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAElF;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAElE;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/dist/packages/core/src/application/ports/output/repositories/interactive-message-repository.interface.js

@@ -0,0 +1,10 @@
+/**
+ * Interactive Message Repository Interface
+ *
+ * Output port for InteractiveMessage persistence operations.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides the SQLite implementation
+ */
+export {};

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

@@ -0,0 +1,78 @@
+/**
+ * Interactive Session Repository Interface
+ *
+ * Output port for InteractiveSession persistence operations.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides the SQLite implementation
+ */
+import type { InteractiveSession, InteractiveSessionStatus } from '../../../../domain/generated/output.js';
+/**
+ * Repository interface for InteractiveSession entity persistence.
+ */
+export interface IInteractiveSessionRepository {
+    /**
+     * Create a new interactive session record.
+     */
+    create(session: InteractiveSession): Promise<void>;
+    /**
+     * Find a session by its unique ID.
+     */
+    findById(id: string): Promise<InteractiveSession | null>;
+    /**
+     * Find the most recent session for a given feature.
+     *
+     * @param featureId - Polymorphic scope key: may be a spec ID, repo ID, or any
+     *   future entity that owns an interactive chat. Not a FK to a single table.
+     */
+    findByFeatureId(featureId: string): Promise<InteractiveSession | null>;
+    /**
+     * Find all sessions with status 'booting' or 'ready'.
+     * Used for concurrent session cap enforcement and zombie cleanup.
+     */
+    findAllActive(): Promise<InteractiveSession[]>;
+    /**
+     * Update session status and optionally set stoppedAt.
+     */
+    updateStatus(id: string, status: InteractiveSessionStatus, stoppedAt?: Date): Promise<void>;
+    /**
+     * Update the lastActivityAt timestamp for a session.
+     */
+    updateLastActivity(id: string, lastActivityAt: Date): Promise<void>;
+    /**
+     * Mark all sessions with status 'booting' or 'ready' as 'stopped'.
+     * Called on server startup to clean up zombie sessions from prior restart.
+     */
+    markAllActiveStopped(): Promise<void>;
+    /**
+     * Count sessions with status 'booting' or 'ready'.
+     * Used to enforce the concurrent session cap.
+     */
+    countActiveSessions(): Promise<number>;
+    /**
+     * Persist the agent SDK session ID for resumption across service restarts.
+     * Agent-agnostic: works with Claude, Cursor, Codex, or any future agent.
+     */
+    updateAgentSessionId(id: string, agentSessionId: string): Promise<void>;
+    /**
+     * Retrieve the agent SDK session ID for a given session.
+     */
+    getAgentSessionId(id: string): Promise<string | null>;
+    /**
+     * Update the turn status for a session.
+     * Values: 'idle' | 'processing' | 'unread'
+     */
+    updateTurnStatus(id: string, turnStatus: string): Promise<void>;
+    /**
+     * Get turn statuses for multiple feature IDs in a single query.
+     * Returns a map of featureId → turnStatus for features that have an active session.
+     */
+    getTurnStatuses(featureIds: string[]): Promise<Map<string, string>>;
+    /**
+     * Get ALL non-idle turn statuses across all active sessions.
+     * Returns a map of featureId → turnStatus (only 'processing' | 'unread' entries).
+     */
+    getAllActiveTurnStatuses(): Promise<Map<string, string>>;
+}
+//# sourceMappingURL=interactive-session-repository.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-session-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/interactive-session-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAEvE;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAE/C;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpE;;;OAGG;IACH,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D"}

package/dist/packages/core/src/application/ports/output/repositories/interactive-session-repository.interface.js

@@ -0,0 +1,10 @@
+/**
+ * Interactive Session Repository Interface
+ *
+ * Output port for InteractiveSession persistence operations.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides the SQLite implementation
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -19,4 +19,5 @@ export type { IDaemonService, DaemonState } from './daemon-service.interface.js'
 export type { IDeploymentService, DeploymentStatus } from './deployment-service.interface.js';
 export type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl, } from './github-repository-service.interface.js';
 export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
+export type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState, } from './interactive-session-service.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC"}

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

@@ -0,0 +1,187 @@
+/**
+ * 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;
+    /** Turn activity status: 'idle' | 'processing' | 'unread' (for dot indicators) */
+    turnStatus: string;
+}
+/** 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>;
+    /**
+     * Mark a feature's chat as read — clears the 'unread' turn status to 'idle'.
+     * Called when the user opens/views the chat tab.
+     */
+    markRead(featureId: string): Promise<void>;
+    /**
+     * Get turn statuses for multiple features in a single call.
+     * Returns a map of featureId → 'idle' | 'processing' | 'unread'.
+     * Used by UI to show dot indicators on all chat buttons.
+     */
+    getTurnStatuses(featureIds: string[]): Promise<Map<string, string>>;
+    /**
+     * Get ALL non-idle turn statuses. No IDs needed — returns every
+     * active session's status ('processing' | 'unread').
+     */
+    getAllActiveTurnStatuses(): Promise<Map<string, string>>;
+}
+//# 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 {};