@love-moon/tui-driver 0.2.11 → 0.2.13

package/dist/driver/profiles/claudeCode.profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"claudeCode.profile.js","sourceRoot":"","sources":["../../../src/driver/profiles/claudeCode.profile.ts"],"names":[],"mappings":";;;AAAA,oDAA6D;AAEhD,QAAA,iBAAiB,GAAe,IAAA,6BAAa,EAAC;IACzD,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,EAAE;IACR,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;KACtB;IAED,OAAO,EAAE;QACP,KAAK,EAAE;YACL,QAAQ,EAAqB,iCAAiC;YAC9D,gBAAgB,EAAa,yCAAyC;SACvE;QACD,KAAK,EAAE;YACL,uBAAuB;YACvB,qBAAqB;YACrB,2BAA2B;SAC5B;QACD,IAAI,EAAE;YACJ,GAAG,EAA0B,+BAA+B;YAC5D,WAAW;YACX,UAAU;SACX;QACD,KAAK,EAAE;YACL,yBAAyB;YACzB,UAAU,EAAmB,aAAa;YAC1C,sBAAsB,EAAO,OAAO;YACpC,qBAAqB;YACrB,wBAAwB;YACxB,0BAA0B,EAAG,qBAAqB;YAClD,uBAAuB;YACvB,iBAAiB;YACjB,gBAAgB;SACjB;QACD,KAAK,EAAE;YACL,qBAAqB;YACrB,iBAAiB;YACjB,2BAA2B;YAC3B,uBAAuB;YACvB,qBAAqB;YACrB,sBAAsB;YACtB,mBAAmB;YACnB,iBAAiB;YACjB,oBAAoB,EAAS,oBAAoB;SAClD;QACD,UAAU,EAAE;YACV,yBAAyB;YACzB,yBAAyB;YACzB,wBAAwB;YACxB,mBAAmB;YACnB,uBAAuB;YACvB,wBAAwB;YACxB,uBAAuB;YACvB,qBAAqB;SACtB;KACF;IAED,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,QAAQ,CAAC;QACnB,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB;IAED,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,mBAAmB,EAAE;YACnB,4CAA4C;SAC7C;QACD,gBAAgB,EAAE;YAChB,QAAQ;SACT;QACD,aAAa,EAAE;YACb,SAAS,EAAoB,mBAAmB;YAChD,SAAS,EAAoB,8BAA8B;YAC3D,eAAe,EAAc,eAAe;YAC5C,eAAe;YACf,oBAAoB,EAAS,YAAY;YACzC,QAAQ,EAAqB,mBAAmB;YAChD,OAAO,EAAsB,UAAU;YACvC,OAAO,EAAsB,aAAa;YAC1C,OAAO,EAAsB,mCAAmC;SACjE;QACD,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,CAAC;KACjB;IAED,OAAO,EAAE;QACP,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,UAAU,EAAE,CAAC,oBAAoB,CAAC;QAClC,UAAU,EAAE,CAAC,4CAA4C,CAAC;QAC1D,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,MAAM,EAAE;YACN,wCAAwC;YACxC,mBAAmB,EAAG,qEAAqE;SAC5F;QACD,UAAU,EAAE;YACV,2BAA2B,EAAG,mDAAmD;SAClF;KACF;IAED,iBAAiB,EAAE,IAAI;IAEvB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI;KACX;CACF,CAAC,CAAC;AAEH,kBAAe,yBAAiB,CAAC"}
+{"version":3,"file":"claudeCode.profile.js","sourceRoot":"","sources":["../../../src/driver/profiles/claudeCode.profile.ts"],"names":[],"mappings":";;;AAAA,oDAA6D;AAC7D,uEAAgE;AAEnD,QAAA,iBAAiB,GAAe,IAAA,6BAAa,EAAC;IACzD,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,EAAE;IACR,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;KACtB;IACD,QAAQ,EAAE,mCAAc;IAExB,OAAO,EAAE;QACP,KAAK,EAAE;YACL,QAAQ,EAAqB,iCAAiC;YAC9D,gBAAgB,EAAa,yCAAyC;SACvE;QACD,KAAK,EAAE;YACL,uBAAuB;YACvB,qBAAqB;YACrB,2BAA2B;SAC5B;QACD,IAAI,EAAE;YACJ,GAAG,EAA0B,+BAA+B;YAC5D,WAAW;YACX,UAAU;YACV,gFAAgF;SACjF;QACD,KAAK,EAAE;YACL,yBAAyB;YACzB,UAAU,EAAmB,aAAa;YAC1C,sBAAsB,EAAO,OAAO;YACpC,qBAAqB;YACrB,wBAAwB;YACxB,0BAA0B,EAAG,qBAAqB;YAClD,uBAAuB;YACvB,iBAAiB;YACjB,gBAAgB;SACjB;QACD,KAAK,EAAE;YACL,qBAAqB;YACrB,iBAAiB;YACjB,2BAA2B;YAC3B,uBAAuB;YACvB,qBAAqB;YACrB,sBAAsB;YACtB,mBAAmB;YACnB,iBAAiB;YACjB,oBAAoB,EAAS,oBAAoB;SAClD;QACD,UAAU,EAAE;YACV,yBAAyB;YACzB,yBAAyB;YACzB,wBAAwB;YACxB,mBAAmB;YACnB,uBAAuB;YACvB,wBAAwB;YACxB,uBAAuB;YACvB,qBAAqB;SACtB;KACF;IAED,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,QAAQ,CAAC;QACnB,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB;IAED,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,mBAAmB,EAAE;YACnB,oDAAoD;SACrD;QACD,gBAAgB,EAAE;YAChB,QAAQ;SACT;QACD,aAAa,EAAE;YACb,SAAS,EAAoB,mBAAmB;YAChD,SAAS,EAAoB,8BAA8B;YAC3D,eAAe,EAAc,eAAe;YAC5C,eAAe;YACf,oBAAoB,EAAS,YAAY;YACzC,QAAQ,EAAqB,mBAAmB;YAChD,OAAO,EAAsB,UAAU;YACvC,OAAO,EAAsB,aAAa;YAC1C,OAAO,EAAsB,mCAAmC;SACjE;QACD,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,CAAC;KACjB;IAED,OAAO,EAAE;QACP,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,UAAU,EAAE,CAAC,oBAAoB,CAAC;QAClC,UAAU,EAAE,CAAC,oDAAoD,CAAC;QAClE,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,MAAM,EAAE;YACN,uCAAuC;YACvC,mBAAmB,EAAG,qEAAqE;YAC3F,gFAAgF;SACjF;QACD,UAAU,EAAE;YACV,2BAA2B,EAAG,mDAAmD;SAClF;KACF;IAED,iBAAiB,EAAE,IAAI;IAEvB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI;KACX;CACF,CAAC,CAAC;AAEH,kBAAe,yBAAiB,CAAC"}

package/dist/driver/profiles/copilot.profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.profile.d.ts","sourceRoot":"","sources":["../../../src/driver/profiles/copilot.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAE7D,eAAO,MAAM,cAAc,EAAE,UA6G3B,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"copilot.profile.d.ts","sourceRoot":"","sources":["../../../src/driver/profiles/copilot.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAG7D,eAAO,MAAM,cAAc,EAAE,UAgH3B,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/driver/profiles/copilot.profile.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.copilotProfile = void 0;
 const TuiProfile_js_1 = require("../TuiProfile.js");
+const copilot_behavior_js_1 = require("../behavior/copilot.behavior.js");
 exports.copilotProfile = (0, TuiProfile_js_1.createProfile)({
     name: "copilot",
     command: "copilot",
@@ -16,10 +17,13 @@ exports.copilotProfile = (0, TuiProfile_js_1.createProfile)({
         LANG: "en_US.UTF-8",
         LC_ALL: "en_US.UTF-8",
     },
+    behavior: copilot_behavior_js_1.copilotBehavior,
     anchors: {
         ready: [
             /^(?![\s\S]*Thinking \(Esc to cancel)(?=[\s\S]*(?:^|\n)❯\s+)(?=[\s\S]*Remaining reqs\.:)[\s\S]*$/,
             /^(?![\s\S]*Thinking \(Esc to cancel)(?=[\s\S]*(?:^|\n)Start of Prompt Indicator\b)(?=[\s\S]*Remaining reqs\.:)[\s\S]*$/i,
+            /^(?![\s\S]*Thinking \(Esc to cancel)(?=[\s\S]*(?:^|\n)❯\s+)[\s\S]*$/,
+            /^(?![\s\S]*Thinking \(Esc to cancel)(?=[\s\S]*(?:^|\n)Start of Prompt Indicator\b)[\s\S]*$/i,
         ],
         trust: [
             /Remember screen reader mode/i,

package/dist/driver/profiles/copilot.profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.profile.js","sourceRoot":"","sources":["../../../src/driver/profiles/copilot.profile.ts"],"names":[],"mappings":";;;AAAA,oDAA6D;AAEhD,QAAA,cAAc,GAAe,IAAA,6BAAa,EAAC;IACtD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE;QACJ,YAAY;QACZ,cAAc;QACd,KAAK;QACL,kBAAkB;KACnB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;KACtB;IAED,OAAO,EAAE;QACP,KAAK,EAAE;YACL,iGAAiG;YACjG,yHAAyH;SAC1H;QACD,KAAK,EAAE;YACL,8BAA8B;YAC9B,6CAA6C;SAC9C;QACD,IAAI,EAAE;YACJ,wDAAwD;YACxD,gDAAgD;SACjD;QACD,KAAK,EAAE;YACL,UAAU;YACV,sBAAsB;YACtB,iBAAiB;YACjB,gBAAgB;SACjB;QACD,KAAK,EAAE;YACL,iBAAiB;YACjB,2BAA2B;YAC3B,qBAAqB;YACrB,4BAA4B;YAC5B,oBAAoB;YACpB,qBAAqB;SACtB;QACD,UAAU,EAAE;YACV,wBAAwB;YACxB,wBAAwB;YACxB,kBAAkB;YAClB,aAAa;YACb,uBAAuB;YACvB,qBAAqB;SACtB;KACF;IAED,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EAAE,CAAC,OAAO,CAAC;KACxB;IAED,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,mBAAmB,EAAE;YACnB,WAAW;YACX,oBAAoB;SACrB;QACD,gBAAgB,EAAE;YAChB,QAAQ;YACR,+BAA+B;SAChC;QACD,aAAa,EAAE;YACb,SAAS;YACT,YAAY;YACZ,sBAAsB;YACtB,kBAAkB;YAClB,yDAAyD;YACzD,iDAAiD;YACjD,kBAAkB;YAClB,kCAAkC;YAClC,6BAA6B;YAC7B,iCAAiC;YACjC,kCAAkC;SACnC;QACD,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,CAAC;KACjB;IAED,OAAO,EAAE;QACP,MAAM,EAAE,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACnD,UAAU,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;QAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACtD,MAAM,EAAE;YACN,wDAAwD;YACxD,gDAAgD;SACjD;KACF;IAED,iBAAiB,EAAE,IAAI;IAEvB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI;KACX;CACF,CAAC,CAAC;AAEH,kBAAe,sBAAc,CAAC"}
+{"version":3,"file":"copilot.profile.js","sourceRoot":"","sources":["../../../src/driver/profiles/copilot.profile.ts"],"names":[],"mappings":";;;AAAA,oDAA6D;AAC7D,yEAAkE;AAErD,QAAA,cAAc,GAAe,IAAA,6BAAa,EAAC;IACtD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE;QACJ,YAAY;QACZ,cAAc;QACd,KAAK;QACL,kBAAkB;KACnB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;KACtB;IACD,QAAQ,EAAE,qCAAe;IAEzB,OAAO,EAAE;QACP,KAAK,EAAE;YACL,iGAAiG;YACjG,yHAAyH;YACzH,qEAAqE;YACrE,6FAA6F;SAC9F;QACD,KAAK,EAAE;YACL,8BAA8B;YAC9B,6CAA6C;SAC9C;QACD,IAAI,EAAE;YACJ,wDAAwD;YACxD,gDAAgD;SACjD;QACD,KAAK,EAAE;YACL,UAAU;YACV,sBAAsB;YACtB,iBAAiB;YACjB,gBAAgB;SACjB;QACD,KAAK,EAAE;YACL,iBAAiB;YACjB,2BAA2B;YAC3B,qBAAqB;YACrB,4BAA4B;YAC5B,oBAAoB;YACpB,qBAAqB;SACtB;QACD,UAAU,EAAE;YACV,wBAAwB;YACxB,wBAAwB;YACxB,kBAAkB;YAClB,aAAa;YACb,uBAAuB;YACvB,qBAAqB;SACtB;KACF;IAED,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EAAE,CAAC,OAAO,CAAC;KACxB;IAED,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,mBAAmB,EAAE;YACnB,WAAW;YACX,oBAAoB;SACrB;QACD,gBAAgB,EAAE;YAChB,QAAQ;YACR,+BAA+B;SAChC;QACD,aAAa,EAAE;YACb,SAAS;YACT,YAAY;YACZ,sBAAsB;YACtB,kBAAkB;YAClB,yDAAyD;YACzD,iDAAiD;YACjD,kBAAkB;YAClB,kCAAkC;YAClC,6BAA6B;YAC7B,iCAAiC;YACjC,kCAAkC;SACnC;QACD,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,CAAC;KACjB;IAED,OAAO,EAAE;QACP,MAAM,EAAE,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACnD,UAAU,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;QAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACtD,MAAM,EAAE;YACN,wDAAwD;YACxD,gDAAgD;SACjD;KACF;IAED,iBAAiB,EAAE,IAAI;IAEvB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI;KACX;CACF,CAAC,CAAC;AAEH,kBAAe,sBAAc,CAAC"}

package/dist/extract/OutputExtractor.d.ts

@@ -11,6 +11,22 @@ export declare class OutputExtractor {
     extract(before: ScreenSnapshot, after: ScreenSnapshot): ExtractionResult;
     private extractFromViewport;
     private extractFromScrollback;
+    /**
+     * Extract the latest reply block by TUI markers:
+     * reply starts from includeLinePatterns (e.g. "• ...")
+     * and ends at the latest stopLinePatterns match (e.g. "› ...").
+     * Content after the latest prompt line is ignored.
+     * Returns:
+     * - null: rule not applicable (missing markers/config)
+     * - "": prompt found but no valid new reply block before it
+     * - string: bounded raw reply block
+     */
+    private extractLatestReplyBlockFromSnapshot;
+    private findFirstChangedLineIndex;
+    private findLastMatchingLineIndexInRange;
+    private rangeHasChangedContentBeforeStop;
     private cleanText;
+    private findLastMatchingLineIndex;
+    private matchesAny;
 }
 //# sourceMappingURL=OutputExtractor.d.ts.map

package/dist/extract/OutputExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutputExtractor.d.ts","sourceRoot":"","sources":["../../src/extract/OutputExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa;IAE7C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAkBxE,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,SAAS;CA2ClB"}
+{"version":3,"file":"OutputExtractor.d.ts","sourceRoot":"","sources":["../../src/extract/OutputExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa;IAE7C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAmBxE,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAK7B;;;;;;;;;OASG;IACH,OAAO,CAAC,mCAAmC;IAqD3C,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,gCAAgC;IAgBxC,OAAO,CAAC,gCAAgC;IAwBxC,OAAO,CAAC,SAAS;IAoDjB,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,UAAU;CASnB"}

package/dist/extract/OutputExtractor.js

@@ -15,11 +15,12 @@ class OutputExtractor {
         else {
             rawText = this.extractFromScrollback(before, after);
         }
-        const text = this.cleanText(rawText);
+        const boundedRawText = this.extractLatestReplyBlockFromSnapshot(before, after) ?? rawText;
+        const text = this.cleanText(boundedRawText);
         return {
             text,
-            rawText,
-            linesAdded: text.split("\n").length,
+            rawText: boundedRawText,
+            linesAdded: text ? text.split("\n").length : 0,
         };
     }
     extractFromViewport(before, after) {
@@ -32,21 +33,111 @@ class OutputExtractor {
         const { added } = (0, Diff_js_1.computeLineDiff)(before.scrollbackText, after.scrollbackText);
         return added.join("\n");
     }
+    /**
+     * Extract the latest reply block by TUI markers:
+     * reply starts from includeLinePatterns (e.g. "• ...")
+     * and ends at the latest stopLinePatterns match (e.g. "› ...").
+     * Content after the latest prompt line is ignored.
+     * Returns:
+     * - null: rule not applicable (missing markers/config)
+     * - "": prompt found but no valid new reply block before it
+     * - string: bounded raw reply block
+     */
+    extractLatestReplyBlockFromSnapshot(before, after) {
+        const includeLinePatterns = this.extraction.includeLinePatterns ?? [];
+        const stopLinePatterns = this.extraction.stopLinePatterns ?? [];
+        if (this.extraction.mode !== "diff-scrollback") {
+            return null;
+        }
+        if (includeLinePatterns.length === 0 || stopLinePatterns.length === 0) {
+            return null;
+        }
+        const beforeLines = before.scrollbackText.split("\n");
+        const lines = after.scrollbackText.split("\n");
+        const stopIndex = this.findLastMatchingLineIndex(lines, stopLinePatterns);
+        if (stopIndex < 0) {
+            return null;
+        }
+        if (stopIndex === 0) {
+            return "";
+        }
+        const firstChangedIndex = this.findFirstChangedLineIndex(beforeLines, lines);
+        if (firstChangedIndex < 0) {
+            return "";
+        }
+        // Prefer reply markers that appeared in this turn's changed range.
+        const startIndex = this.findLastMatchingLineIndexInRange(lines, firstChangedIndex, stopIndex, includeLinePatterns);
+        if (startIndex < 0) {
+            return "";
+        }
+        if (!this.rangeHasChangedContentBeforeStop({
+            lines,
+            startIndex,
+            stopIndex,
+            firstChangedIndex,
+            stopLinePatterns,
+        })) {
+            return "";
+        }
+        const block = lines.slice(startIndex, stopIndex + 1);
+        return block.join("\n");
+    }
+    findFirstChangedLineIndex(beforeLines, afterLines) {
+        const minLength = Math.min(beforeLines.length, afterLines.length);
+        let prefixLength = 0;
+        while (prefixLength < minLength && beforeLines[prefixLength] === afterLines[prefixLength]) {
+            prefixLength += 1;
+        }
+        return prefixLength < afterLines.length ? prefixLength : -1;
+    }
+    findLastMatchingLineIndexInRange(lines, startIndex, endExclusive, patterns) {
+        const safeStart = Math.max(0, startIndex);
+        const safeEnd = Math.min(lines.length, Math.max(safeStart, endExclusive));
+        for (let index = safeEnd - 1; index >= safeStart; index -= 1) {
+            if (this.matchesAny(lines[index], patterns)) {
+                return index;
+            }
+        }
+        return -1;
+    }
+    rangeHasChangedContentBeforeStop(options) {
+        const { lines, startIndex, stopIndex, firstChangedIndex, stopLinePatterns } = options;
+        const from = Math.max(startIndex, firstChangedIndex);
+        const to = Math.min(stopIndex, lines.length);
+        for (let index = from; index < to; index += 1) {
+            const line = lines[index];
+            if (!line || line.trim().length === 0) {
+                continue;
+            }
+            if (this.matchesAny(line, stopLinePatterns)) {
+                continue;
+            }
+            return true;
+        }
+        return false;
+    }
     cleanText(text) {
         let result = text;
         const includeLinePatterns = this.extraction.includeLinePatterns;
         const stopLinePatterns = this.extraction.stopLinePatterns ?? [];
+        if (stopLinePatterns.length > 0) {
+            const boundedLines = result.split("\n");
+            const lastStopIndex = this.findLastMatchingLineIndex(boundedLines, stopLinePatterns);
+            if (lastStopIndex >= 0) {
+                result = boundedLines.slice(0, lastStopIndex + 1).join("\n");
+            }
+        }
         if (includeLinePatterns && includeLinePatterns.length > 0) {
             const lines = result.split("\n");
             const kept = [];
             let including = false;
             for (const line of lines) {
-                if (includeLinePatterns.some(pattern => pattern.test(line))) {
+                if (this.matchesAny(line, includeLinePatterns)) {
                     including = true;
                     kept.push(line);
                     continue;
                 }
-                if (including && stopLinePatterns.some(pattern => pattern.test(line))) {
+                if (including && this.matchesAny(line, stopLinePatterns)) {
                     including = false;
                     continue;
                 }
@@ -66,6 +157,23 @@ class OutputExtractor {
         result = result.replace(/\n{3,}/g, "\n\n");
         return result.trim();
     }
+    findLastMatchingLineIndex(lines, patterns) {
+        for (let index = lines.length - 1; index >= 0; index -= 1) {
+            if (this.matchesAny(lines[index], patterns)) {
+                return index;
+            }
+        }
+        return -1;
+    }
+    matchesAny(line, patterns) {
+        for (const pattern of patterns) {
+            pattern.lastIndex = 0;
+            if (pattern.test(line)) {
+                return true;
+            }
+        }
+        return false;
+    }
 }
 exports.OutputExtractor = OutputExtractor;
 //# sourceMappingURL=OutputExtractor.js.map

package/dist/extract/OutputExtractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"OutputExtractor.js","sourceRoot":"","sources":["../../src/extract/OutputExtractor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OutputExtractor.js","sourceRoot":"","sources":["../../src/extract/OutputExtractor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export { HeadlessScreen, HeadlessScreenOptions } from "./term/index.js";
 export { ScreenSnapshot, ScreenSnapshotData } from "./term/index.js";
 export { ExpectEngine, UntilOptions, IdleOptions, ExpectResult } from "./expect/index.js";
 export { Matchers, MatcherFn } from "./expect/index.js";
-export { TuiDriver, TuiDriverOptions, AskResult, TuiProfile, TuiProfileName, TuiAnchors, TuiKeys, TuiExtraction, createProfile, StateMachine, TuiState, StateTransition, claudeCodeProfile, codexProfile, copilotProfile, TuiSignals, TuiScreenSignals, HealthStatus, HealthReason, } from "./driver/index.js";
+export { TuiDriver, TuiDriverOptions, AskResult, TuiProfile, TuiProfileName, TuiAnchors, TuiKeys, TuiExtraction, createProfile, StateMachine, TuiState, StateTransition, claudeCodeProfile, codexProfile, copilotProfile, TuiSignals, TuiScreenSignals, HealthStatus, HealthReason, defaultTuiDriverBehavior, claudeBehavior, copilotBehavior, } from "./driver/index.js";
+export type { TuiSessionInfo, TuiSessionUsageSummary, TuiDriverBehavior, SignalHelpers, SignalScopeContext, ResolveStatusLineContext, StreamStartFallbackContext, StreamEndReplyFallbackContext, StreamEndCompleteMatcherContext, StreamEndStatusClearMatcherContext, } from "./driver/index.js";
 export { OutputExtractor, ExtractionResult, computeLineDiff, computeCharDiff, getAddedText, getRemovedText, DiffResult, } from "./extract/index.js";
 import { TuiDriver, TuiDriverOptions } from "./driver/index.js";
 import { TuiProfileName } from "./driver/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,cAAc,EACd,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAE/D,wBAAgB,YAAY,CAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GACnD,SAAS,CAqBX"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,cAAc,EACd,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,EAC7B,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAE/D,wBAAgB,YAAY,CAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GACnD,SAAS,CAqBX"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRemovedText = exports.getAddedText = exports.computeCharDiff = exports.computeLineDiff = exports.OutputExtractor = exports.copilotProfile = exports.codexProfile = exports.claudeCodeProfile = exports.StateMachine = exports.createProfile = exports.TuiDriver = exports.Matchers = exports.ExpectEngine = exports.ScreenSnapshot = exports.HeadlessScreen = exports.PtySession = void 0;
+exports.getRemovedText = exports.getAddedText = exports.computeCharDiff = exports.computeLineDiff = exports.OutputExtractor = exports.copilotBehavior = exports.claudeBehavior = exports.defaultTuiDriverBehavior = exports.copilotProfile = exports.codexProfile = exports.claudeCodeProfile = exports.StateMachine = exports.createProfile = exports.TuiDriver = exports.Matchers = exports.ExpectEngine = exports.ScreenSnapshot = exports.HeadlessScreen = exports.PtySession = void 0;
 exports.createDriver = createDriver;
 // PTY Session
 var index_js_1 = require("./pty/index.js");
@@ -23,6 +23,9 @@ Object.defineProperty(exports, "StateMachine", { enumerable: true, get: function
 Object.defineProperty(exports, "claudeCodeProfile", { enumerable: true, get: function () { return index_js_6.claudeCodeProfile; } });
 Object.defineProperty(exports, "codexProfile", { enumerable: true, get: function () { return index_js_6.codexProfile; } });
 Object.defineProperty(exports, "copilotProfile", { enumerable: true, get: function () { return index_js_6.copilotProfile; } });
+Object.defineProperty(exports, "defaultTuiDriverBehavior", { enumerable: true, get: function () { return index_js_6.defaultTuiDriverBehavior; } });
+Object.defineProperty(exports, "claudeBehavior", { enumerable: true, get: function () { return index_js_6.claudeBehavior; } });
+Object.defineProperty(exports, "copilotBehavior", { enumerable: true, get: function () { return index_js_6.copilotBehavior; } });
 // Extract
 var index_js_7 = require("./extract/index.js");
 Object.defineProperty(exports, "OutputExtractor", { enumerable: true, get: function () { return index_js_7.OutputExtractor; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAkDA,oCAwBC;AA1ED,cAAc;AACd,2CAA+D;AAAtD,sGAAA,UAAU,OAAA;AAEnB,oBAAoB;AACpB,4CAAwE;AAA/D,0GAAA,cAAc,OAAA;AACvB,4CAAqE;AAA5D,0GAAA,cAAc,OAAA;AAEvB,gBAAgB;AAChB,8CAA0F;AAAjF,wGAAA,YAAY,OAAA;AACrB,8CAAwD;AAA/C,oGAAA,QAAQ,OAAA;AAEjB,SAAS;AACT,8CAoB2B;AAnBzB,qGAAA,SAAS,OAAA;AAQT,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AAGZ,6GAAA,iBAAiB,OAAA;AACjB,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AAOhB,UAAU;AACV,+CAQ4B;AAP1B,2GAAA,eAAe,OAAA;AAEf,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AAIhB,+BAA+B;AAC/B,gDAAgE;AAChE,gDAAoF;AAGpF,SAAgB,YAAY,CAC1B,WAA2B,EAC3B,OAAoD;IAEpD,MAAM,UAAU,GAAuC;QACrD,aAAa,EAAE,4BAAiB;QAChC,KAAK,EAAE,uBAAY;QACnB,OAAO,EAAE,yBAAc;KACxB,CAAC;IACF,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,OAAO,GAAe;QAC1B,GAAG,WAAW;QACd,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAA6B;YACxC,GAAG,WAAW,CAAC,GAAG;SACnB;KACF,CAAC;IAEF,OAAO,IAAI,oBAAS,CAAC;QACnB,OAAO;QACP,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAiEA,oCAwBC;AAzFD,cAAc;AACd,2CAA+D;AAAtD,sGAAA,UAAU,OAAA;AAEnB,oBAAoB;AACpB,4CAAwE;AAA/D,0GAAA,cAAc,OAAA;AACvB,4CAAqE;AAA5D,0GAAA,cAAc,OAAA;AAEvB,gBAAgB;AAChB,8CAA0F;AAAjF,wGAAA,YAAY,OAAA;AACrB,8CAAwD;AAA/C,oGAAA,QAAQ,OAAA;AAEjB,SAAS;AACT,8CAuB2B;AAtBzB,qGAAA,SAAS,OAAA;AAQT,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AAGZ,6GAAA,iBAAiB,OAAA;AACjB,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AAKd,oHAAA,wBAAwB,OAAA;AACxB,0GAAA,cAAc,OAAA;AACd,2GAAA,eAAe,OAAA;AAejB,UAAU;AACV,+CAQ4B;AAP1B,2GAAA,eAAe,OAAA;AAEf,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AAIhB,+BAA+B;AAC/B,gDAAgE;AAChE,gDAAoF;AAGpF,SAAgB,YAAY,CAC1B,WAA2B,EAC3B,OAAoD;IAEpD,MAAM,UAAU,GAAuC;QACrD,aAAa,EAAE,4BAAiB;QAChC,KAAK,EAAE,uBAAY;QACnB,OAAO,EAAE,yBAAc;KACxB,CAAC;IACF,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,OAAO,GAAe;QAC1B,GAAG,WAAW;QACd,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAA6B;YACxC,GAAG,WAAW,CAAC,GAAG;SACnB;KACF,CAAC;IAEF,OAAO,IAAI,oBAAS,CAAC;QACnB,OAAO;QACP,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/pty/PtySession.d.ts

@@ -24,6 +24,7 @@ export declare class PtySession extends EventEmitter {
     get isRunning(): boolean;
     get pid(): number | undefined;
     spawn(): void;
+    setCommandArgs(command: string, args?: string[]): void;
     write(data: string): void;
     writeResponse(data: string): void;
     writeChunked(data: string, chunkSize?: number, delayMs?: number): Promise<void>;

package/dist/pty/PtySession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PtySession.d.ts","sourceRoot":"","sources":["../../src/pty/PtySession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AA4DD,qBAAa,UAAW,SAAQ,YAAY;IAOxC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IARjB,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;gBAGjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,iBAAsB;IAOzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,KAAK,IAAI,IAAI;IAmCb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,SAAM,EACf,OAAO,SAAK,GACX,OAAO,CAAC,IAAI,CAAC;IAUhB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASxC,IAAI,CAAC,MAAM,GAAE,MAAkB,GAAG,IAAI;IAQtC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAyB1B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,OAAO,CAAC,KAAK;IAIb,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI/C,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAGhE"}
+{"version":3,"file":"PtySession.d.ts","sourceRoot":"","sources":["../../src/pty/PtySession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AA4DD,qBAAa,UAAW,SAAQ,YAAY;IAOxC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IARjB,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;gBAGjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,iBAAsB;IAOzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,KAAK,IAAI,IAAI;IAqCb,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI;IAQ1D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,SAAM,EACf,OAAO,SAAK,GACX,OAAO,CAAC,IAAI,CAAC;IAUhB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASxC,IAAI,CAAC,MAAM,GAAE,MAAkB,GAAG,IAAI;IAQtC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAyB1B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,OAAO,CAAC,KAAK;IAIb,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI/C,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAGhE"}

package/dist/pty/PtySession.js

@@ -146,9 +146,18 @@ class PtySession extends events_1.EventEmitter {
         });
         this.ptyProcess.onExit(({ exitCode, signal }) => {
             this._isRunning = false;
+            // Clear spawn state on natural exit so follow-up restarts can spawn safely.
+            this.ptyProcess = null;
             this.emit("exit", exitCode, signal);
         });
     }
+    setCommandArgs(command, args = []) {
+        if (this.ptyProcess) {
+            throw new Error("Cannot update PTY command while session is running");
+        }
+        this.command = command;
+        this.args = Array.isArray(args) ? [...args] : [];
+    }
     write(data) {
         if (!this.ptyProcess) {
             throw new Error("PTY session not spawned");

package/dist/pty/PtySession.js.map

@@ -1 +1 @@
-{"version":3,"file":"PtySession.js","sourceRoot":"","sources":["../../src/pty/PtySession.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PtySession.js","sourceRoot":"","sources":["../../src/pty/PtySession.ts"],"names":[],"mappings":"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"}

package/docs/how-to-add-a-new-backend.md

@@ -0,0 +1,212 @@
+# How To Add a New Backend in `@love-moon/tui-driver`
+
+## 1. 先看当前真实架构
+
+现在的 `tui-driver` 是“两套并行判定链路”：
+
+- `PTY + snapshot` 链路（老链路，通用兜底）
+  - `src/pty/PtySession.ts`
+  - `src/term/*`
+  - `src/expect/*`
+  - `src/extract/OutputExtractor.ts`
+- `session file` 链路（codex/claude/copilot 主链路）
+  - `src/driver/TuiDriver.ts` 中的：
+    - session 发现：`ensureSessionInfo` / `detect*SessionInfo`
+    - 流开始判定：`waitForSessionFileGrowth`
+    - 流结束判定：`waitForSessionFileIdle`
+    - 答案提取：`extractAnswerFromSessionFile`
+
+`ask()` 的关键流程已经是：
+
+1. `ensureReady()`
+2. `ensureSessionInfo()`（能拿到就走 session-file）
+3. `submit`
+4. `captureSessionFileCheckpoint`（记录 submit 前文件 offset）
+5. `WAIT_STREAM_START`
+   - session-file: `waitForSessionFileGrowth`
+   - fallback: `waitStreamStart(snapshot)`
+6. `WAIT_STREAM_END`
+   - session-file: `waitForSessionFileIdle`
+   - fallback: `waitStreamEnd(snapshot)`
+7. `CAPTURE + extract`
+   - session-file: `extractAnswerFromSessionFile`
+   - fallback: `extractAnswer(before/after snapshot)`
+
+## 2. 当前三种 backend 的 session 接入方式
+
+### Codex
+
+- session id / file 来源：`~/.codex/state_5.sqlite`
+- 查询逻辑：
+  - 优先按 `cwd` 匹配 `threads`
+  - 否则退化到最近一条 openai cli thread
+- session file：数据库里的 `rollout_path`
+- 完成标记（completion marker）：
+  - `event_msg.payload.type === "task_complete"`
+- 答案提取优先级：
+  1. `task_complete.payload.last_agent_message`
+  2. 普通 assistant message
+- restart resume 参数：
+  - `codex resume <sessionId>`
+
+### Claude Code
+
+- session 来源目录：`~/.claude/projects/<encoded-cwd>/`
+- 优先读取 `sessions-index.json`（按 mtime/modified 排序）
+- fallback：目录下最新 `.jsonl`
+- completion marker：当前不强制
+- restart resume 参数：
+  - `claude --resume <sessionId>`
+
+### Copilot
+
+- session 来源目录：`~/.copilot/session-state/<session-dir>/`
+- 读取：
+  - `workspace.yaml`（取 `cwd` / `id`）
+  - `events.jsonl`（作为 session file）
+- completion marker（强制）：
+  - `type === "assistant.turn_end"`
+- restart resume 参数：
+  - `copilot --resume=<sessionId>`
+
+## 3. 新 backend 需要实现什么
+
+### 3.1 Profile 和导出
+
+至少完成：
+
+1. 在 `src/driver/TuiProfile.ts` 扩展 `TuiProfileName`
+2. 新建 `src/driver/profiles/<new>.profile.ts`
+3. 需要动态逻辑时新增 `behavior/<new>.behavior.ts`
+4. 更新导出：
+   - `src/driver/profiles/index.ts`
+   - `src/driver/behavior/index.ts`（若新增 behavior）
+   - `src/driver/index.ts`
+   - `src/index.ts` 里的 `createDriver` profileMap
+
+### 3.2 Session file 支持（推荐做成主链路）
+
+若新 backend 有稳定 session 持久化，建议接入 session-file 模式。需要在 `TuiDriver` 增补：
+
+1. `supportsSessionFileTracking()` 把新 backend 纳入
+2. `detectSessionInfoByBackend()` 增加分支
+3. 新增 `detect<NewBackend>SessionInfo()`
+   - 返回 `TuiSessionInfo { backend, sessionId, sessionFilePath }`
+4. 若需要强完成标记，更新 `requiresSessionCompletionMarker()`
+5. 新增对应 marker 识别函数（类似 codex/copilot）
+6. 在 `extractAssistantReplyFromJsonLines()` 增加新 backend 的 assistant 文本解析
+7. 在 `buildResumeArgsForBackend()` + `stripResumeArgs()` 中补 resume 规则
+
+## 4. 流判定与完成判定（新逻辑）
+
+### 4.1 轮询间隔
+
+- `DEFAULT_SESSION_POLL_INTERVAL_MS = 2000`
+- 即 session 文件轮询间隔为 2 秒
+
+### 4.2 Stream Start
+
+- `waitForSessionFileGrowth` 判断 `size/mtime` 是否变化
+- 超时抛错：`Stream start timeout: session file did not grow`
+
+### 4.3 Stream End
+
+`waitForSessionFileIdle` 的判定条件：
+
+1. 必须先 `observedProgress=true`（文件至少增长过一次）
+2. 连续两次检查不变（`unchangedChecks >= 2`）
+3. 若 backend 要求 completion marker（当前 codex/copilot），还必须已经观测到 marker
+
+对应超时错误：
+
+- `Stream end timeout: session file did not grow`
+- `Stream end timeout: session completion marker not observed`
+- `Stream end timeout: session file did not become stable`
+
+## 5. session 事件与上层对接
+
+`TuiDriver` 在发现 session（或变化）时会 emit：
+
+- `session` 事件，payload 为 `TuiSessionInfo`
+
+同时 `ask()` 返回值里也会附带：
+
+- `sessionId`
+- `sessionFilePath`
+
+上层（例如 web/daemon/cli）应在拿到 sessionId 后尽早广播会话开始消息（例如 `backend session started: <sessionId>`），resume 与否都要发，避免 UI 丢 session 关联。
+
+## 6. 重启时 resume 机制（必须理解）
+
+`restart()` 不再盲重启，而是：
+
+1. 先找可用 session（`sessionInfo` 或 `lastSessionInfo`，必要时重新探测）
+2. 基于 backend 生成 resume args
+3. 先剥离旧 resume 参数，再拼最新 `sessionId`
+4. `pty.kill()`
+5. `pty.setCommandArgs(command, newArgs)`
+6. 再 `boot()`
+
+### 为什么要“先去旧 resume，再拼新 resume”
+
+避免参数冲突，例如：
+
+- 错误：`... --resume old --resume new`
+- 正确：`... --resume new`
+
+`stripResumeArgs()` 当前会清理：
+
+- `--resume <id>`
+- `--resume=<id>`
+- codex 风格 `resume <id>`
+
+## 7. 建议测试清单
+
+新增 backend 至少覆盖：
+
+1. session 发现测试（能拿到 `sessionId + file`）
+2. session completion marker 测试（若启用）
+3. session answer 提取测试（jsonl -> 最终文本）
+4. restart resume args 测试（去旧参数 + 拼新参数）
+5. profile/signal 测试（ready/busy/replyStart/replyStop）
+
+可参考：
+
+- `test/session-file-extraction.test.ts`
+- `test/codex-profile.test.ts`
+- `test/claude-profile.test.ts`
+- `test/copilot-profile.test.ts`
+
+运行：
+
+```bash
+cd modules/tui-driver
+pnpm test
+pnpm build
+```
+
+## 8. FAQ
+
+### Q1: 为什么任务明明还在跑，却被判 finished？
+
+常见原因：
+
+- 只用了“文件稳定”判定，没有 completion marker 兜底
+- 或 session 文件解析没命中新 backend 的完成事件
+
+处理：
+
+- 给该 backend 开启 completion marker 要求
+- 实现 marker 检测函数并加入 `requiresSessionCompletionMarker()`
+
+### Q2: `Stream end timeout: session file did not become stable` 是什么含义？
+
+含义是：文件确实增长过，但在超时窗口内始终无法连续两次稳定（每次间隔 2 秒）。
+
+### Q3: 什么时候还会走 snapshot diff？
+
+当 `ensureSessionInfo()` 失败（没有 sessionId / session file）时，自动回退到旧的 snapshot 流程，不会阻塞整个 turn。
+
+### Q4: `PtySession.setCommandArgs()` 什么时候用？
+
+仅在 PTY 已停止时使用（运行中调用会抛错），主要用于 `restart()` 前替换为最新 resume 参数。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@love-moon/tui-driver",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "TUI Driver for interactive CLI tools like Claude Code and Codex",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",