@qduc/term2 0.22.0 → 0.22.1

package/dist/utils/conversation/static-commit-policy.d.ts

@@ -0,0 +1,38 @@
+import type { BotMessage, CommandMessage, ReasoningMessage, SubagentActivityMessage } from '../../types/message.js';
+/**
+ * Single source of truth for which message rows can enter Ink's <Static>
+ * region. Both the renderer (MessageList's history/active split and the
+ * static-commit-blocker warning) and the conversation orchestrator's
+ * end-of-turn settlement consume this module, so a new Message variant or
+ * status is classified once — an unclassified addition is a type error here,
+ * not a silently stranded row that blocks static commit for the rest of the
+ * session.
+ *
+ * The subject is a structural subset of the Message union so tests and the
+ * renderer's looser MessageLike rows can be classified without carrying every
+ * display field.
+ */
+export type StaticCommitSubject = Pick<BotMessage, 'sender' | 'status'> | Pick<CommandMessage, 'sender' | 'status'> | Pick<ReasoningMessage, 'sender' | 'status'> | Pick<SubagentActivityMessage, 'sender' | 'status'> | {
+    sender: 'user';
+} | {
+    sender: 'system';
+} | {
+    sender: 'command-group';
+};
+/** Why a row cannot be committed into <Static>. `null` means committable. */
+export type StaticCommitBlockerReason = 'bot_streaming' | 'reasoning_streaming' | 'command_pending' | 'command_running' | 'subagent_activity';
+export declare function classifyStaticCommitBlocker(message: StaticCommitSubject): StaticCommitBlockerReason | null;
+export declare const isBlockingStaticCommit: (message: StaticCommitSubject) => boolean;
+/**
+ * What a closing turn may do with a row that still blocks static commit.
+ *
+ * This is deliberately not the same question as "does it block": command rows
+ * are settled by aborting them, turn-owned streaming rows by finalizing them,
+ * and background subagent rows must be left alone — a running background
+ * subagent legitimately outlives the turn, and freezing it into <Static>
+ * irreversibly misrenders live work. Every blocking classification must name
+ * its rule; that table is pinned by static-commit-policy.test.ts.
+ */
+export type TurnEndSettlement = 'finalize' | 'abort' | 'leave';
+export declare function turnEndSettlement(reason: StaticCommitBlockerReason): TurnEndSettlement;
+//# sourceMappingURL=static-commit-policy.d.ts.map

package/dist/utils/conversation/static-commit-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-commit-policy.d.ts","sourceRoot":"","sources":["../../../source/utils/conversation/static-commit-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEpH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAC3B,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC,GACrC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC,GACzC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC3C,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAClD;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAGpB;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEhC,6EAA6E;AAC7E,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,CAAC;AAUxB,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,yBAAyB,GAAG,IAAI,CAgD1G;AAED,eAAO,MAAM,sBAAsB,YAAa,mBAAmB,KAAG,OACvB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,iBAAiB,CAiBtF"}

package/dist/utils/conversation/static-commit-policy.js

@@ -0,0 +1,76 @@
+// Exhaustiveness below uses `value satisfies never` in default branches: if
+// the union grows, the default-branch value is no longer `never` and this
+// fails to compile until the new member is classified. Unlike a throwing
+// assertNever it is also runtime-safe — the renderer feeds rows whose loose
+// MessageLike types could in principle carry an unrecognized string, and an
+// unrecognized row must degrade to "committable" (the pre-policy behavior),
+// never crash the render loop.
+export function classifyStaticCommitBlocker(message) {
+    switch (message.sender) {
+        case 'bot':
+            return message.status === 'streaming' ? 'bot_streaming' : null;
+        case 'reasoning':
+            // No status yet means the live row exists but has not been finalized —
+            // it still blocks.
+            return message.status === 'finalized' ? null : 'reasoning_streaming';
+        case 'command': {
+            const status = message.status;
+            switch (status) {
+                case 'pending':
+                    return 'command_pending';
+                case 'running':
+                    return 'command_running';
+                case 'completed':
+                case 'failed':
+                case 'aborted':
+                    return null;
+                default:
+                    status;
+                    return null;
+            }
+        }
+        case 'subagent': {
+            const status = message.status;
+            switch (status) {
+                case 'running':
+                    return 'subagent_activity';
+                case 'completed':
+                case 'failed':
+                case 'cancelled':
+                case 'interrupted':
+                case 'backgrounded':
+                    return null;
+                default:
+                    status;
+                    return null;
+            }
+        }
+        case 'user':
+        case 'system':
+        case 'command-group':
+            return null;
+        default:
+            message;
+            return null;
+    }
+}
+export const isBlockingStaticCommit = (message) => classifyStaticCommitBlocker(message) !== null;
+export function turnEndSettlement(reason) {
+    switch (reason) {
+        case 'bot_streaming':
+        case 'reasoning_streaming':
+            return 'finalize';
+        case 'command_pending':
+        case 'command_running':
+            return 'abort';
+        case 'subagent_activity':
+            return 'leave';
+        default:
+            reason;
+            // Unreachable for the known union. If it somehow runs, leaving the row
+            // alone can only keep the tail rendering dynamically — it can never
+            // freeze live work into <Static> irreversibly.
+            return 'leave';
+    }
+}
+//# sourceMappingURL=static-commit-policy.js.map

package/dist/utils/conversation/static-commit-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-commit-policy.js","sourceRoot":"","sources":["../../../source/utils/conversation/static-commit-policy.ts"],"names":[],"mappings":"AAkCA,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,+BAA+B;AAE/B,MAAM,UAAU,2BAA2B,CAAC,OAA4B;IACtE,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,KAAK,WAAW;YACd,uEAAuE;YACvE,mBAAmB;YACnB,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACvE,KAAK,SAAS,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,SAAS;oBACZ,OAAO,iBAAiB,CAAC;gBAC3B,KAAK,SAAS;oBACZ,OAAO,iBAAiB,CAAC;gBAC3B,KAAK,WAAW,CAAC;gBACjB,KAAK,QAAQ,CAAC;gBACd,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC;gBACd;oBACE,MAAsB,CAAC;oBACvB,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,SAAS;oBACZ,OAAO,mBAAmB,CAAC;gBAC7B,KAAK,WAAW,CAAC;gBACjB,KAAK,QAAQ,CAAC;gBACd,KAAK,WAAW,CAAC;gBACjB,KAAK,aAAa,CAAC;gBACnB,KAAK,cAAc;oBACjB,OAAO,IAAI,CAAC;gBACd;oBACE,MAAsB,CAAC;oBACvB,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC;QACd;YACE,OAAuB,CAAC;YACxB,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAA4B,EAAW,EAAE,CAC9E,2BAA2B,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AAchD,MAAM,UAAU,iBAAiB,CAAC,MAAiC;IACjE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe,CAAC;QACrB,KAAK,qBAAqB;YACxB,OAAO,UAAU,CAAC;QACpB,KAAK,iBAAiB,CAAC;QACvB,KAAK,iBAAiB;YACpB,OAAO,OAAO,CAAC;QACjB,KAAK,mBAAmB;YACtB,OAAO,OAAO,CAAC;QACjB;YACE,MAAsB,CAAC;YACvB,uEAAuE;YACvE,oEAAoE;YACpE,+CAA+C;YAC/C,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qduc/term2",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "A terminal-based AI assistant that can help you get things done on your computer",
   "license": "MIT",
   "author": "qduc",