@shepai/cli 1.167.0 → 1.168.0

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

@@ -10,6 +10,11 @@
  * - Infrastructure layer provides concrete implementations
  * - No SDK types leak through this boundary
  */
+/**
+ * Callback invoked when the agent calls AskUserQuestion.
+ * The SDK stream is PAUSED until this resolves — the agent waits for the user's answers.
+ */
+export type OnUserQuestionCallback = (interaction: UserInteractionData) => Promise<Record<string, string>>;
 /** Options for creating/resuming an interactive agent session. */
 export interface InteractiveAgentOptions {
     /** Absolute worktree path (CWD for agent) */
@@ -18,10 +23,32 @@ export interface InteractiveAgentOptions {
     model?: string;
     /** Feature context string to append to system prompt */
     systemPrompt?: string;
+    /**
+     * Called when agent uses AskUserQuestion. Must return user's answers keyed by question text.
+     * The SDK stream pauses until this resolves — the agent cannot continue without answers.
+     */
+    onUserQuestion?: OnUserQuestionCallback;
+}
+/** A single question within an AskUserQuestion tool call. */
+export interface UserQuestionOption {
+    label: string;
+    description: string;
+    preview?: string;
+}
+export interface UserQuestion {
+    question: string;
+    header: string;
+    options: UserQuestionOption[];
+    multiSelect: boolean;
+}
+/** Data for a pending user interaction (AskUserQuestion). */
+export interface UserInteractionData {
+    toolCallId: string;
+    questions: UserQuestion[];
 }
 /** 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';
+    type: 'delta' | 'tool_use' | 'tool_result' | 'status' | 'done' | 'error' | 'init' | 'api_retry' | 'rate_limit' | 'task_started' | 'task_progress' | 'task_done' | 'user_question';
     content?: string;
     label?: string;
     detail?: string;
@@ -33,13 +60,22 @@ export interface InteractiveAgentEvent {
         numTurns?: number;
         durationMs?: number;
     };
+    /** Interaction data (attached to 'user_question' events) */
+    interaction?: UserInteractionData;
+}
+/** Structured tool result message sent back to the agent. */
+export interface ToolResultMessage {
+    toolCallId: string;
+    result: unknown;
 }
 /** 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 a user text message to the agent */
     send(message: string): Promise<void>;
+    /** Send a tool result back to the agent (e.g. AskUserQuestion response) */
+    sendToolResult(toolResult: ToolResultMessage): Promise<void>;
     /** Iterate response events from the agent */
     stream(): AsyncIterable<InteractiveAgentEvent>;
     /** Terminate the session gracefully */

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

@@ -1 +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,uCAAuC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,wEAAwE;IACxE,KAAK,IAAI,IAAI,CAAC;CACf;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"}
+{"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;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,WAAW,EAAE,mBAAmB,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErC,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;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;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,GACX,eAAe,CAAC;IACpB,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;IACF,4DAA4D;IAC5D,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,2EAA2E;IAC3E,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,6CAA6C;IAC7C,MAAM,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC/C,uCAAuC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,wEAAwE;IACxE,KAAK,IAAI,IAAI,CAAC;CACf;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/services/interactive-session-service.interface.d.ts

@@ -10,6 +10,7 @@
  * - Infrastructure layer provides the concrete implementation (singleton)
  */
 import type { InteractiveSession, InteractiveMessage } from '../../../../domain/generated/output.js';
+import type { UserInteractionData } from '../agents/interactive-agent-executor.interface.js';
 /**
  * A single streaming chunk forwarded from agent stdout to an SSE consumer.
  */
@@ -22,6 +23,8 @@ export interface StreamChunk {
     log?: string;
     /** Structured activity event for rich rendering in the thread */
     activity?: StreamActivity;
+    /** Pending user interaction (AskUserQuestion) — agent is waiting for user response */
+    interaction?: UserInteractionData;
 }
 /**
  * A structured activity event emitted during agent execution.
@@ -50,8 +53,10 @@ export interface ChatState {
     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) */
+    /** Turn activity status: 'idle' | 'processing' | 'unread' | 'awaiting_input' (for dot indicators) */
     turnStatus: string;
+    /** Pending user interaction — agent is waiting for user response (null when no interaction pending) */
+    pendingInteraction: UserInteractionData | null;
 }
 /** Live session metadata for the frontend toolbar. */
 export interface SessionInfo {
@@ -189,5 +194,15 @@ export interface IInteractiveSessionService {
      * active session's status ('processing' | 'unread').
      */
     getAllActiveTurnStatuses(): Promise<Map<string, string>>;
+    /**
+     * Respond to a pending user interaction (AskUserQuestion).
+     * Sends the user's answers back to the agent as a tool result,
+     * clears the pending interaction, and resumes the agent's turn.
+     *
+     * @param featureId - The feature scope key
+     * @param answers - Map of question text → selected answer(s)
+     * @param annotations - Optional per-question annotations (notes, preview)
+     */
+    respondToInteraction(featureId: string, answers: Record<string, 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

@@ -1 +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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"}
+{"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/use-cases/interactive/index.d.ts

@@ -11,4 +11,6 @@ export { StopInteractiveSessionUseCase } from './stop-interactive-session.use-ca
 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';
+export { RespondToInteractionUseCase } from './respond-to-interaction.use-case.js';
+export type { RespondToInteractionInput } from './respond-to-interaction.use-case.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC"}

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

@@ -7,3 +7,4 @@ export { StartInteractiveSessionUseCase } from './start-interactive-session.use-
 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';
+export { RespondToInteractionUseCase } from './respond-to-interaction.use-case.js';

package/dist/packages/core/src/application/use-cases/interactive/respond-to-interaction.use-case.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Respond To Interaction Use Case
+ *
+ * Sends the user's response to a pending AskUserQuestion interaction
+ * back to the agent. The agent's turn resumes after receiving the response.
+ */
+import type { IInteractiveSessionService } from '../../ports/output/services/interactive-session-service.interface.js';
+export interface RespondToInteractionInput {
+    featureId: string;
+    answers: Record<string, string>;
+}
+export declare class RespondToInteractionUseCase {
+    private readonly service;
+    constructor(service: IInteractiveSessionService);
+    execute(input: RespondToInteractionInput): Promise<void>;
+}
+//# sourceMappingURL=respond-to-interaction.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/interactive/respond-to-interaction.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond-to-interaction.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/interactive/respond-to-interaction.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAEvH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBACa,2BAA2B;IAGpC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAGhD,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/D"}

package/dist/packages/core/src/application/use-cases/interactive/respond-to-interaction.use-case.js

@@ -0,0 +1,34 @@
+/**
+ * Respond To Interaction Use Case
+ *
+ * Sends the user's response to a pending AskUserQuestion interaction
+ * back to the agent. The agent's turn resumes after receiving the response.
+ */
+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';
+let RespondToInteractionUseCase = class RespondToInteractionUseCase {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async execute(input) {
+        return this.service.respondToInteraction(input.featureId, input.answers);
+    }
+};
+RespondToInteractionUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object])
+], RespondToInteractionUseCase);
+export { RespondToInteractionUseCase };

package/dist/packages/core/src/application/use-cases/repositories/delete-repository.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-repository.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/delete-repository.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,qBACa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAJb,cAAc,EAAE,qBAAqB,EAErC,WAAW,EAAE,kBAAkB,EAE/B,aAAa,EAAE,oBAAoB;IAGhD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAczC"}
+{"version":3,"file":"delete-repository.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/delete-repository.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,qBACa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAJb,cAAc,EAAE,qBAAqB,EAErC,WAAW,EAAE,kBAAkB,EAE/B,aAAa,EAAE,oBAAoB;IAGhD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBzC"}

package/dist/packages/core/src/application/use-cases/repositories/delete-repository.use-case.js

@@ -33,8 +33,12 @@ let DeleteRepositoryUseCase = class DeleteRepositoryUseCase {
         if (!repository) {
             throw new Error(`Repository not found: "${id}"`);
         }
-        // Delete all child features (cancels agent runs, removes worktrees)
-        const features = await this.featureRepo.list({ repositoryPath: repository.path });
+        // Delete all child features (cancels agent runs, removes worktrees).
+        // Include archived features so they don't survive as orphans.
+        const features = await this.featureRepo.list({
+            repositoryPath: repository.path,
+            includeArchived: true,
+        });
         for (const feature of features) {
             await this.deleteFeature.execute(feature.id);
         }

package/dist/packages/core/src/infrastructure/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAoJrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CAubrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAqJrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA2brE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/packages/core/src/infrastructure/di/container.js

@@ -99,6 +99,7 @@ import { StartInteractiveSessionUseCase } from '../../application/use-cases/inte
 import { SendInteractiveMessageUseCase } from '../../application/use-cases/interactive/send-interactive-message.use-case.js';
 import { StopInteractiveSessionUseCase } from '../../application/use-cases/interactive/stop-interactive-session.use-case.js';
 import { GetInteractiveChatStateUseCase } from '../../application/use-cases/interactive/get-interactive-chat-state.use-case.js';
+import { RespondToInteractionUseCase } from '../../application/use-cases/interactive/respond-to-interaction.use-case.js';
 // Session listing
 import { ClaudeCodeSessionRepository } from '../services/agents/sessions/claude-code-session.repository.js';
 import { CodexCliSessionRepository } from '../services/agents/sessions/codex-cli-session.repository.js';
@@ -489,6 +490,7 @@ export async function initializeContainer() {
     container.registerSingleton(SendInteractiveMessageUseCase);
     container.registerSingleton(StopInteractiveSessionUseCase);
     container.registerSingleton(GetInteractiveChatStateUseCase);
+    container.registerSingleton(RespondToInteractionUseCase);
     // String-token aliases for web routes (Turbopack can't resolve .js→.ts
     // imports inside @shepai/core, so routes use string tokens instead of class refs)
     container.register('StartInteractiveSessionUseCase', {
@@ -503,6 +505,9 @@ export async function initializeContainer() {
     container.register('GetInteractiveChatStateUseCase', {
         useFactory: (c) => c.resolve(GetInteractiveChatStateUseCase),
     });
+    container.register('RespondToInteractionUseCase', {
+        useFactory: (c) => c.resolve(RespondToInteractionUseCase),
+    });
     // Startup cleanup: mark any zombie sessions (booting/ready from a prior server run) as stopped
     await interactiveSessionRepo.markAllActiveStopped();
     _initialized = true;

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

@@ -32,6 +32,9 @@
  *   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.
+ * - AskUserQuestion is intercepted via the SDK's `canUseTool` callback,
+ *   which pauses the stream until the user responds. The callback delegates
+ *   to the `onUserQuestion` option provided by the session service.
  */
 import type { IInteractiveAgentExecutor, InteractiveAgentOptions, InteractiveAgentSessionHandle } from '../../../../../application/ports/output/agents/interactive-agent-executor.interface.js';
 export declare class ClaudeCodeInteractiveExecutor implements IInteractiveAgentExecutor {

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAE9B,MAAM,wFAAwF,CAAC;AAgBhG,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;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,WAAW;IAoBnB;;;;;;OAMG;YACY,SAAS;IA6BxB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,aAAa;CAuPtB"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAOH,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAI9B,MAAM,wFAAwF,CAAC;AAgBhG,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;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,WAAW;IAqCnB;;;;;;OAMG;YACY,SAAS;IA6BxB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,aAAa;CA4PtB"}

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

@@ -32,6 +32,9 @@
  *   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.
+ * - AskUserQuestion is intercepted via the SDK's `canUseTool` callback,
+ *   which pauses the stream until the user responds. The callback delegates
+ *   to the `onUserQuestion` option provided by the session service.
  */
 import { unstable_v2_createSession, unstable_v2_resumeSession, } from '@anthropic-ai/claude-agent-sdk';
 /** Default model used when options.model is not specified. */
@@ -83,9 +86,37 @@ export class ClaudeCodeInteractiveExecutor {
     buildSdkOptions(options) {
         // Strip CLAUDECODE env var to prevent nested-session detection errors.
         const { CLAUDECODE: _, ...cleanEnv } = process.env;
+        // Build the canUseTool callback that intercepts AskUserQuestion.
+        // When the agent calls AskUserQuestion, this callback:
+        // 1. Delegates to onUserQuestion (which notifies the UI and waits for user response)
+        // 2. Returns { behavior: 'allow', updatedInput } with the user's answers injected
+        // 3. The SDK passes the updated input to AskUserQuestion, which sees pre-filled answers
+        //
+        // For ALL other tools: auto-allow (same effect as bypassPermissions).
+        const canUseTool = options.onUserQuestion
+            ? async (toolName, input, opts) => {
+                if (toolName === 'AskUserQuestion') {
+                    const questions = input.questions ?? [];
+                    const answers = await options.onUserQuestion({
+                        toolCallId: opts.toolUseID,
+                        questions,
+                    });
+                    // Inject answers into the tool input so the SDK treats it as already answered
+                    return {
+                        behavior: 'allow',
+                        updatedInput: { ...input, answers },
+                    };
+                }
+                // Auto-allow all other tools
+                return { behavior: 'allow' };
+            }
+            : undefined;
         return {
             model: options.model ?? DEFAULT_MODEL,
-            permissionMode: 'bypassPermissions',
+            // When onUserQuestion is provided, use canUseTool to intercept AskUserQuestion
+            // while auto-allowing everything else (replaces bypassPermissions).
+            // When not provided, use bypassPermissions for backward compatibility.
+            ...(canUseTool ? { canUseTool } : { permissionMode: 'bypassPermissions' }),
             env: cleanEnv,
             // Forward system prompt using preset+append pattern
             ...(options.systemPrompt && {
@@ -106,6 +137,22 @@ export class ClaudeCodeInteractiveExecutor {
                 return resolvedSessionId;
             },
             send: (message) => sdkSession.send(message),
+            sendToolResult: (toolResult) => sdkSession.send({
+                type: 'user',
+                session_id: sdkSession.sessionId,
+                parent_tool_use_id: toolResult.toolCallId,
+                tool_use_result: toolResult.result,
+                message: {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'tool_result',
+                            tool_use_id: toolResult.toolCallId,
+                            content: JSON.stringify(toolResult.result),
+                        },
+                    ],
+                },
+            }),
             stream: () => this.mapStream(sdkSession, (id) => (resolvedSessionId = id)),
             close: async () => sdkSession.close(),
             abort: () => {
@@ -189,11 +236,17 @@ export class ClaudeCodeInteractiveExecutor {
                             }
                         }
                         else if (block.type === 'tool_use') {
-                            events.push({
-                                type: 'tool_use',
-                                label: block.name,
-                                detail: JSON.stringify(block.input ?? {}),
-                            });
+                            // AskUserQuestion is handled by canUseTool callback — don't emit as tool_use
+                            if (block.name === 'AskUserQuestion') {
+                                // Silently skip — the canUseTool callback already handled this
+                            }
+                            else {
+                                events.push({
+                                    type: 'tool_use',
+                                    label: block.name,
+                                    detail: JSON.stringify(block.input ?? {}),
+                                });
+                            }
                         }
                     }
                 }

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

@@ -75,6 +75,13 @@ export declare class InteractiveSessionService implements IInteractiveSessionSer
     markRead(featureId: string): Promise<void>;
     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. */

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":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,EACV,MAAM,qFAAqF,CAAC;AAC7F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4FAA4F,CAAC;AAChJ,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4FAA4F,CAAC;AAChJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8EAA8E,CAAC;AAE1H,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gFAAgF,CAAC;AACzH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AASlG,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA0C1E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAA0B,YAAW,0BAA0B;IAexE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAlBjC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAmC;IACnD,wEAAwE;IACxE,OAAO,CAAC,sBAAsB,CAA6B;IAC3D;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAAwD;gBAG/D,WAAW,EAAE,6BAA6B,EAC1C,WAAW,EAAE,6BAA6B,EAC1C,eAAe,EAAE,qBAAqB,EACtC,WAAW,EAAE,kBAAkB,EAC/B,cAAc,EAAE,qBAAqB;IAOlD,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC;IAgE9B;;;;;OAKG;YACW,iBAAiB;IAgRzB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C7C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuClF;;OAEG;YACW,qBAAqB;IAyP7B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI7E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAIvE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,aAAa;IAc5E,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC;IA2ExB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmFzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,aAAa;IAkBrF,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAInE,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI9D,oEAAoE;IACpE,OAAO,CAAC,yBAAyB;IAWjC,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;IAUxB,mEAAmE;IACnE,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;YACW,gBAAgB;IA0B9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAYd,6DAA6D;IAC7D,OAAO,CAAC,UAAU;IAQlB,2CAA2C;IAC3C,OAAO,CAAC,UAAU;IAOlB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAOpB,6EAA6E;IAC7E,OAAO,CAAC,MAAM;CAKf"}
+{"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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"}

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

@@ -80,6 +80,8 @@ export class InteractiveSessionService {
             updatedAt: now,
         };
         await this.sessionRepo.create(session);
+        // Mark as processing immediately so the FAB shows the spinner during boot
+        void this.sessionRepo.updateTurnStatus(session.id, 'processing');
         // Carry over agentSessionId from previous session so resumption works
         let previousAgentSessionId;
         for (const [, s] of this.sessions) {
@@ -113,6 +115,8 @@ export class InteractiveSessionService {
             subscribers: new Set(),
             turnInProgress: false,
             turnQueue: [],
+            pendingInteraction: null,
+            pendingInteractionResolver: null,
         };
         this.sessions.set(session.id, state);
         // Fire-and-forget the async boot sequence. The API returns the session
@@ -189,6 +193,9 @@ export class InteractiveSessionService {
             // Create the interactive executor and session
             const executor = this.executorFactory.createInteractiveExecutor(resolvedAgentType, authConfig);
             let handle;
+            // Build the onUserQuestion callback that pauses the SDK stream
+            // and waits for user input via the UI.
+            const onUserQuestion = this.buildOnUserQuestionCallback(state);
             const previousAgentSessionId = state.agentSessionId;
             if (previousAgentSessionId) {
                 // Resume existing SDK session
@@ -196,6 +203,7 @@ export class InteractiveSessionService {
                     cwd: worktreePath,
                     model: state.model,
                     systemPrompt: context,
+                    onUserQuestion,
                 });
             }
             else {
@@ -204,6 +212,7 @@ export class InteractiveSessionService {
                     cwd: worktreePath,
                     model: state.model,
                     systemPrompt: context,
+                    onUserQuestion,
                 });
             }
             state.handle = handle;
@@ -585,6 +594,12 @@ export class InteractiveSessionService {
                                 });
                             }
                             break;
+                        case 'user_question':
+                            // AskUserQuestion is now handled by the canUseTool callback
+                            // (buildOnUserQuestionCallback) which pauses the SDK stream.
+                            // This event should not appear in the stream anymore, but if it
+                            // does (e.g. from a different code path), ignore it here.
+                            break;
                     }
                 }
             }
@@ -819,7 +834,9 @@ export class InteractiveSessionService {
                 turnStatus = statuses.get(featureId) ?? 'idle';
             }
         }
-        return { messages, sessionStatus, streamingText, sessionInfo, turnStatus };
+        // Include pending interaction if one exists
+        const pendingInteraction = state?.pendingInteraction ?? null;
+        return { messages, sessionStatus, streamingText, sessionInfo, turnStatus, pendingInteraction };
     }
     subscribeByFeature(featureId, onChunk) {
         // Subscribe at the feature level so the callback survives session restarts.
@@ -863,6 +880,89 @@ export class InteractiveSessionService {
     async getAllActiveTurnStatuses() {
         return this.sessionRepo.getAllActiveTurnStatuses();
     }
+    async respondToInteraction(featureId, answers) {
+        const state = this.findActiveStateForFeature(featureId);
+        if (!state?.pendingInteraction || !state.pendingInteractionResolver) {
+            throw new Error(`No pending interaction for feature ${featureId}`);
+        }
+        // Persist the user's answers as a structured user message.
+        // The {{interaction}} prefix lets the frontend detect and render it
+        // as a compact green bubble instead of a regular text message.
+        const interactionPayload = {
+            questions: state.pendingInteraction.questions.map((q) => ({
+                header: q.header,
+                question: q.question,
+            })),
+            answers,
+        };
+        const now = new Date();
+        const userMsg = {
+            id: crypto.randomUUID(),
+            featureId: state.featureId,
+            sessionId: state.sessionId,
+            role: InteractiveMessageRole.user,
+            content: `{{interaction}}${JSON.stringify(interactionPayload)}`,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.messageRepo.create(userMsg);
+        // Resolve the Promise that the canUseTool callback is awaiting.
+        // This unblocks the SDK stream — the agent resumes with the user's answers.
+        state.pendingInteractionResolver(answers);
+        // Clear pending interaction state
+        state.pendingInteraction = null;
+        state.pendingInteractionResolver = null;
+        // Update turn status back to processing
+        void this.sessionRepo.updateTurnStatus(state.sessionId, 'processing');
+        // Clear the "Waiting for your response..." log
+        state.subscribers.forEach((sub) => sub({ delta: '', done: false }));
+    }
+    /**
+     * 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.
+     */
+    buildOnUserQuestionCallback(state) {
+        return async (interaction) => {
+            // Flush any accumulated assistant text as a separate message BEFORE
+            // the interaction. This ensures the agent's question text appears
+            // above the green answer bubble in the conversation history.
+            if (state.currentAssistantBuffer.trim()) {
+                const now = new Date();
+                const msg = {
+                    id: crypto.randomUUID(),
+                    featureId: state.featureId,
+                    sessionId: state.sessionId,
+                    role: InteractiveMessageRole.assistant,
+                    content: state.currentAssistantBuffer,
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                await this.messageRepo.create(msg);
+                state.currentAssistantBuffer = '';
+                state.toolEventsLog = [];
+                // Notify subscribers so the frontend picks up the new message
+                state.subscribers.forEach((sub) => sub({ delta: '', done: true }));
+                // Small delay so the refetch completes before the interaction appears
+                await new Promise((r) => setTimeout(r, 100));
+            }
+            // Store the interaction data for the frontend
+            state.pendingInteraction = interaction;
+            // Update turn status so the dot indicator shows amber
+            void this.sessionRepo.updateTurnStatus(state.sessionId, 'awaiting_input');
+            // Notify subscribers so SSE pushes the interaction to the frontend
+            state.subscribers.forEach((sub) => sub({
+                delta: '',
+                done: false,
+                log: 'Waiting for your response...',
+                interaction,
+            }));
+            // Create a Promise that will be resolved when the user calls respondToInteraction
+            return new Promise((resolve) => {
+                state.pendingInteractionResolver = resolve;
+            });
+        };
+    }
     /** Find the in-memory state for an active session for a feature. */
     findActiveStateForFeature(featureId) {
         for (const state of this.sessions.values()) {

package/dist/src/presentation/web/app/api/interactive/chat/[featureId]/respond/route.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Respond to a pending agent interaction (AskUserQuestion).
+ *
+ * POST - Submit user's answers to the pending interaction.
+ *        The agent resumes processing after receiving the response.
+ *
+ * `featureId` is a polymorphic scope key: a feature UUID, "repo-<id>", or "global".
+ */
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+export declare const dynamic = "force-dynamic";
+interface RouteParams {
+    params: Promise<{
+        featureId: string;
+    }>;
+}
+export declare function POST(request: NextRequest, { params }: RouteParams): Promise<NextResponse>;
+export {};
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/interactive/chat/[featureId]/respond/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../../../src/presentation/web/app/api/interactive/chat/[featureId]/respond/route.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC,UAAU,WAAW;IACnB,MAAM,EAAE,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxC;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB/F"}