@compilr-dev/sdk 0.10.13 → 0.10.14

package/dist/index.d.ts

@@ -57,7 +57,7 @@ export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleSt
 export { createSQLiteRepositories, SQLiteProjectRepository, SQLiteWorkItemRepository, SQLiteDocumentRepository, SQLitePlanRepository, SQLiteCommentRepository, getDatabase, closeDatabase, closeAllDatabases, databaseExists, SCHEMA_VERSION, SCHEMA_SQL, } from './platform/index.js';
 export type { SQLiteRepositories, CreateSQLiteRepositoriesOptions, ProjectDeleteHooks, ProjectRecord, WorkItemRecord, ProjectDocumentRecord, WorkItemCommentRecord, } from './platform/index.js';
 export { createAskUserTool, createAskUserSimpleTool, createProposeAlternativesTool, createInteractiveFlowTool, validateFlow, INTERACTIVE_FLOW_INPUT_SCHEMA, } from './tools/index.js';
-export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, Alternative, ProposeAlternativesInput, ProposeAlternativesResult, ProposeAlternativesHandler, Flow, FlowTone, FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, QuestionInput, Choice, Proposal, NextRef, BranchRoute, BranchCondition, NodeId, IconName, Tint, RenderVariant, AnswerValue, InteractiveFlowInput, InteractiveFlowResult, InteractiveFlowHandler, FlowValidationResult, FlowValidationError, FlowErrorCode, } from './tools/index.js';
+export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, Alternative, ProposeAlternativesInput, ProposeAlternativesResult, ProposeAlternativesHandler, Flow, FlowTone, FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, QuestionInput, Choice, Proposal, NextRef, BranchRoute, BranchCondition, NodeId, IconName, Tint, RenderVariant, AnswerValue, AbortReason, InteractiveFlowInput, InteractiveFlowResult, InteractiveFlowHandler, FlowValidationResult, FlowValidationError, FlowErrorCode, } from './tools/index.js';
 export { EntitlementCache, UNLIMITED, OFFLINE_FALLBACK_LIMITS, DailyCounter, formatLimitMessage, formatTimeUntilReset, formatUpgradeHint, } from './entitlements/index.js';
 export type { TierLimits, EntitlementResponse, LimitCheckResult, IEntitlementStore, EntitlementCacheConfig, } from './entitlements/index.js';
 export { detectProject, suggestProjectType, detectCommon } from './detection/index.js';

package/dist/tools/index.d.ts

@@ -9,4 +9,4 @@ export { createProposeAlternativesTool } from './propose-alternatives-tool.js';
 export { createInteractiveFlowTool, validateFlow, INTERACTIVE_FLOW_INPUT_SCHEMA, } from './interactive-flow-tool.js';
 export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, } from './ask-user-tools.js';
 export type { Alternative, ProposeAlternativesInput, ProposeAlternativesResult, ProposeAlternativesHandler, } from './propose-alternatives-tool.js';
-export type { Flow, FlowTone, Node as FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, QuestionInput, Choice, Proposal, NextRef, BranchRoute, BranchCondition, NodeId, IconName, Tint, RenderVariant, AnswerValue, InteractiveFlowInput, InteractiveFlowResult, InteractiveFlowHandler, FlowValidationResult, FlowValidationError, FlowErrorCode, } from './interactive-flow-tool.js';
+export type { Flow, FlowTone, Node as FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, QuestionInput, Choice, Proposal, NextRef, BranchRoute, BranchCondition, NodeId, IconName, Tint, RenderVariant, AnswerValue, AbortReason, InteractiveFlowInput, InteractiveFlowResult, InteractiveFlowHandler, FlowValidationResult, FlowValidationError, FlowErrorCode, } from './interactive-flow-tool.js';

package/dist/tools/interactive-flow-tool.d.ts

@@ -143,15 +143,39 @@ export interface InteractiveFlowInput {
 }
 /** Value collected from a node (Question only — info/branch/summary don't produce values) */
 export type AnswerValue = string | string[];
+/** Why the flow ended without completion */
+export type AbortReason = 
+/** User pressed Escape */
+'escape'
+/** User clicked the X (close) button */
+ | 'close-button'
+/** User clicked outside the modal */
+ | 'backdrop'
+/** Conversation tab closed or project switched mid-flow */
+ | 'conversation-closed'
+/** Catch-all (renderer not destroyed, but no explicit reason recorded) */
+ | 'unknown';
 export interface InteractiveFlowResult {
     /** False if the user aborted (closed modal, switched conversation, etc.) */
     completed: boolean;
     /** Every node visited, in order — including backtracked nodes */
     path: NodeId[];
-    /** Final answers — answers downstream of a backtrack point are wiped */
+    /**
+     * Final answers (IDs / strings — what you compare in `BranchCondition`).
+     * Wiped downstream of any backtrack point.
+     */
     answers: Record<NodeId, AnswerValue>;
+    /**
+     * Human-readable labels for the answers above — use this when summarizing
+     * the user's choices back to them. For text-mode answers, label == value.
+     * For single/multi/proposal modes, this is the visible label the user saw.
+     */
+    answerLabels: Record<NodeId, AnswerValue>;
     /** Present iff !completed — the node where the user aborted */
     abortedAt?: NodeId;
+    /** Present iff !completed — how the abort happened (helps the agent
+     * differentiate "user closed the modal" from "tab was closed externally") */
+    abortReason?: AbortReason;
     /** Wall-clock time the user spent */
     durationMs: number;
     /** Validator warnings that didn't block execution (e.g., orphan nodes) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.13",
+  "version": "0.10.14",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",