@xenosystem/agent-conversation 0.1.156 → 0.1.158

package/dist/stores/terminalConversationMessages.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A conversation started in a terminal, as the app shows it.
+ *
+ * Turns come from two places. The host's log has every turn run anywhere (decision 0001), and the app's copy has what the
+ * person did here, which the log does not know about: a message edited or a restore undoes a turn in this copy and nowhere
+ * else. So the copy is never overruled. A turn missing from it is added only if it is NEW, meaning past the point in the
+ * log the app last read. A turn the app already saw and no longer has was removed on purpose, and stays out.
+ *
+ * Where the app has its own copy of a turn it keeps that copy, which carries what a transcript does not (attachments, a
+ * rating). A turn only the copy has is kept too. Text and tool cards are then filled from the event log by the usual
+ * projection, keyed on the assistant message id, which is the request id.
+ */
+import type { AgentConversationTranscriptItem } from '@xenosystem/agent-interface-contract';
+import type { ChatMessage } from './agentChatStore.js';
+export interface TerminalTurnsContext {
+    /** How far through the host's log the app has read: `transcriptSeenSequence` on the conversation. */
+    seenSequence?: number | undefined;
+    /** Reply ids held only by an inactive branch: turns the person edited away. Covers a read position saved too late. */
+    supersededIds?: ReadonlySet<string> | undefined;
+}
+export declare function terminalConversationMessages(saved: ChatMessage[], items: AgentConversationTranscriptItem[], context?: TerminalTurnsContext): ChatMessage[];
+/** What the list shows for a conversation the app has no title for: the first thing the person typed, or its folder. */
+export declare function terminalConversationTitle(items: AgentConversationTranscriptItem[], folder: string | undefined): string;
+//# sourceMappingURL=terminalConversationMessages.d.ts.map

package/dist/stores/terminalConversationMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalConversationMessages.d.ts","sourceRoot":"","sources":["../../src/stores/terminalConversationMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AA4BtD,MAAM,WAAW,oBAAoB;IACnC,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,sHAAsH;IACtH,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;CAChD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,WAAW,EAAE,CA4C9J;AAED,wHAAwH;AACxH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKtH"}

package/dist/stores/terminalConversationMessages.js

@@ -0,0 +1,83 @@
+const time = (value, fallback) => {
+    const parsed = value ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(parsed) ? parsed : fallback;
+};
+/** The app's messages, grouped into turns: an assistant message and the user messages that led to it. */
+function savedTurns(messages) {
+    const turns = new Map();
+    const others = [];
+    let pending = [];
+    for (const message of messages) {
+        if (message.role === 'user') {
+            pending.push(message);
+            continue;
+        }
+        if (message.isCommandResult) {
+            others.push([...pending, message]);
+        }
+        else {
+            turns.set(message.id, [...pending, message]);
+        }
+        pending = [];
+    }
+    if (pending.length)
+        others.push(pending);
+    return { turns, others };
+}
+export function terminalConversationMessages(saved, items, context = {}) {
+    const { turns, others } = savedTurns(saved);
+    const users = new Map(items.filter((item) => item.kind === 'user').map((item) => [item.requestId, item]));
+    const inLog = new Set(items.flatMap((item) => (item.kind === 'assistant' ? [item.requestId] : [])));
+    const seen = context.seenSequence ?? 0;
+    const groups = [...others, ...[...turns].filter(([id]) => !inLog.has(id)).map(([, group]) => group)];
+    let clock = 0;
+    for (const item of items) {
+        if (item.kind === 'user')
+            continue;
+        if (item.kind === 'compaction') {
+            clock = time(item.timestamp, clock);
+            // Saved with the copy once it has been shown, so it is already among the others.
+            if (saved.some((message) => message.id === item.itemId))
+                continue;
+            groups.push([{ id: item.itemId, role: 'assistant', content: `Earlier turns were summarised.\n\n${item.summary}`, timestamp: clock, isCommandResult: true, hideToolbar: true }]);
+            continue;
+        }
+        const kept = turns.get(item.requestId);
+        if (kept) {
+            groups.push(kept);
+            continue;
+        }
+        const user = users.get(item.requestId);
+        // A turn with no recorded input predates decision 0001, so any read position is past it.
+        if (context.supersededIds?.has(item.requestId) || (user?.sequence ?? 0) <= seen && seen > 0)
+            continue;
+        clock = time(user?.timestamp ?? item.completedAt, clock);
+        groups.push([
+            ...(user ? [{ id: user.itemId, role: 'user', content: user.text, timestamp: clock }] : []),
+            {
+                id: item.requestId,
+                role: 'assistant',
+                content: item.text,
+                timestamp: clock,
+                ...(item.model ? { model: item.model } : {}),
+                ...(item.error ? { error: item.error } : {}),
+                ...(item.completedAt ? { endedAt: time(item.completedAt, clock) } : {}),
+            },
+        ]);
+    }
+    // Stable: turns at one instant keep the transcript's order, and a turn is never split.
+    const first = (group) => group[0]?.timestamp ?? 0;
+    return groups
+        .map((group, index) => ({ group, index }))
+        .sort((a, b) => first(a.group) - first(b.group) || a.index - b.index)
+        .flatMap(({ group }) => group);
+}
+/** What the list shows for a conversation the app has no title for: the first thing the person typed, or its folder. */
+export function terminalConversationTitle(items, folder) {
+    const first = items.find((item) => item.kind === 'user')?.text.replace(/\s+/g, ' ').trim();
+    if (first)
+        return first.length > 60 ? `${first.slice(0, 59)}…` : first;
+    const name = folder?.split(/[\\/]/).filter(Boolean).pop();
+    return name || 'Terminal conversation';
+}
+//# sourceMappingURL=terminalConversationMessages.js.map

package/dist/stores/terminalConversationMessages.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenosystem/agent-conversation",
-  "version": "0.1.156",
+  "version": "0.1.158",
   "license": "UNLICENSED",
   "description": "The XENO Agent conversation surface: the transcript, the composer, and the logic behind them.",
   "type": "module",
@@ -42,10 +42,10 @@
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
     "zustand": "^5.0.2",
-    "@xenosystem/agent-interface-client": "0.1.156",
-    "@xenosystem/agent-interface-contract": "0.1.156",
-    "@xenosystem/agent-interface-core": "0.1.156",
-    "@xenosystem/agent-interface-hub-adapter": "0.1.156"
+    "@xenosystem/agent-interface-client": "0.1.158",
+    "@xenosystem/agent-interface-hub-adapter": "0.1.158",
+    "@xenosystem/agent-interface-contract": "0.1.158",
+    "@xenosystem/agent-interface-core": "0.1.158"
   },
   "peerDependencies": {
     "react": "^19.0.0",