@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/core/conversation-utils.js

@@ -0,0 +1,66 @@
+export function cloneMessages(messages) {
+    return structuredClone(messages);
+}
+function extractAssistantText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return String(content);
+    return content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join('');
+}
+function toInternalMessage(message) {
+    if (message.role === 'user') {
+        return {
+            role: 'user',
+            content: typeof message.content === 'string' ? message.content : message.content,
+        };
+    }
+    if (message.role === 'assistant') {
+        return { role: 'assistant', content: extractAssistantText(message.content) };
+    }
+    const toolMsg = message;
+    return {
+        role: 'tool',
+        callId: toolMsg.callId ?? '',
+        content: typeof toolMsg.content === 'string' ? toolMsg.content : String(toolMsg.content),
+        ...(typeof toolMsg.name === 'string' && toolMsg.name.length > 0 ? { toolName: toolMsg.name } : {}),
+    };
+}
+export function messagesToInternal(messages) {
+    return messages.map(toInternalMessage);
+}
+export function cloneBranchMap(branches) {
+    const result = {};
+    for (const [name, msgs] of branches) {
+        result[name] = cloneMessages(msgs);
+    }
+    return result;
+}
+export function restoreBranchMap(branches) {
+    const restored = new Map();
+    if (!branches)
+        return restored;
+    for (const [name, msgs] of Object.entries(branches)) {
+        restored.set(name, msgs);
+    }
+    return restored;
+}
+export function deriveConversationTitle(content) {
+    const text = content.trim();
+    if (text.length <= 50)
+        return text;
+    let cut = text.lastIndexOf(' ', 50);
+    if (cut <= 0)
+        cut = 50;
+    return text.slice(0, cut);
+}
+export function extractUserDisplayText(content) {
+    if (typeof content === 'string')
+        return content;
+    const textParts = content.filter((part) => part.type === 'text');
+    const imageCount = content.filter((part) => part.type === 'image').length;
+    return textParts.map((part) => part.text).join('') + (imageCount > 0 ? ` [+${imageCount} image(s)]` : '');
+}

package/dist/_internal/platform/core/conversation.d.ts

@@ -0,0 +1,114 @@
+import type { ProviderMessage, ContentPart } from '../providers/interface.js';
+import type { ToolCall, ToolResult } from '@pellux/goodvibes-sdk/platform/types/tools';
+import type { ProviderRegistry } from '../providers/registry.js';
+import type { CompactionContext } from './context-compaction.js';
+import type { SessionMemoryStore } from '@pellux/goodvibes-sdk/platform/core/session-memory';
+import type { SessionLineageTracker } from '@pellux/goodvibes-sdk/platform/core/session-lineage';
+export type TokenUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+};
+type AssistantMessage = {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+    reasoningContent?: string;
+    reasoningSummary?: string;
+    usage?: TokenUsage;
+    model?: string;
+    provider?: string;
+};
+export type ConversationMessageSnapshot = {
+    role: 'user';
+    content: string | ContentPart[];
+    cancelled?: boolean;
+} | AssistantMessage | {
+    role: 'system';
+    content: string;
+} | {
+    role: 'tool';
+    callId: string;
+    content: string;
+    toolName?: string;
+};
+type Message = ConversationMessageSnapshot;
+export type ConversationTitleSource = 'system' | 'user';
+export interface BlockMeta {
+    blockIndex: number;
+    type: 'tool' | 'code' | 'diff' | 'thinking';
+    startLine: number;
+    lineCount: number;
+    rawContent: string;
+    collapseKey: string;
+    filePath?: string;
+    diffOriginal?: string;
+    diffUpdated?: string;
+}
+export declare class ConversationManager {
+    private messages;
+    private _title;
+    private _titleSource;
+    private sessionMemoryStore;
+    private sessionLineageTracker;
+    private branches;
+    private currentBranch;
+    private streamingMessageIndex;
+    constructor(_getWidth?: () => number, _configManager?: unknown);
+    private findToolName;
+    setSessionMemoryStore(store: Pick<SessionMemoryStore, 'list'>): void;
+    getSessionMemoryStore(): Pick<SessionMemoryStore, 'list'> | null;
+    setSessionLineageTracker(tracker: Pick<SessionLineageTracker, 'addCompactionEntry'>): void;
+    getSessionLineageTracker(): Pick<SessionLineageTracker, 'addCompactionEntry'>;
+    getMessagesForLLM(): ProviderMessage[];
+    addUserMessage(content: string | ContentPart[]): void;
+    addAssistantMessage(content: string, opts?: {
+        toolCalls?: ToolCall[];
+        reasoningContent?: string;
+        reasoningSummary?: string;
+        usage?: TokenUsage;
+        model?: string;
+        provider?: string;
+    }): void;
+    addToolResults(results: ToolResult[]): void;
+    addSystemMessage(content: string): void;
+    getLastUserMessage(): string | null;
+    getMessageCount(): number;
+    removeMessagesAfter(count: number): void;
+    markLastUserMessageCancelled(): void;
+    startStreamingBlock(): void;
+    updateStreamingBlock(content: string): void;
+    finalizeStreamingBlock(): void;
+    getMessageSnapshot(): ConversationMessageSnapshot[];
+    getTranscriptEventIndex(): {
+        events: import("./transcript-events/types.js").TranscriptEvent[];
+        groups: import("./transcript-events/grouping.js").TranscriptEventGroup[];
+    };
+    replaceMessagesForLLM(newMessages: ProviderMessage[]): void;
+    compact(registry: ProviderRegistry, modelId: string, trigger?: 'auto' | 'manual', provider?: string, context?: CompactionContext): Promise<void>;
+    get title(): string;
+    set title(value: string);
+    getTitleSource(): ConversationTitleSource;
+    setSystemTitle(value: string): void;
+    resetAll(): void;
+    forkBranch(name?: string, force?: boolean): string;
+    listBranches(): Array<{
+        name: string;
+        messageCount: number;
+        isCurrent: boolean;
+    }>;
+    switchBranch(name: string): boolean;
+    mergeBranch(name: string): boolean;
+    getCurrentBranch(): string;
+    toJSON(): object;
+    fromJSON(data: {
+        messages: Message[];
+        branches?: Record<string, Message[]>;
+        currentBranch?: string;
+        title?: string;
+        titleSource?: ConversationTitleSource;
+    }): void;
+}
+export { parseDiffForApply, applyDiffContent } from './conversation-diff.js';
+//# sourceMappingURL=conversation.d.ts.map

package/dist/_internal/platform/core/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/core/conversation.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/core/conversation.js

@@ -0,0 +1,246 @@
+import { buildTranscriptEventIndex } from './transcript-events/index.js';
+import { compactConversation } from './conversation-compaction.js';
+import { cloneBranchMap, cloneMessages, deriveConversationTitle, messagesToInternal, restoreBranchMap, } from './conversation-utils.js';
+import { applyDiffContent, parseDiffForApply } from './conversation-diff.js';
+export class ConversationManager {
+    messages = [];
+    _title = '';
+    _titleSource = 'system';
+    sessionMemoryStore = null;
+    sessionLineageTracker = {
+        addCompactionEntry: () => { },
+    };
+    branches = new Map();
+    currentBranch = 'main';
+    streamingMessageIndex = -1;
+    constructor(_getWidth = () => 80, _configManager) { }
+    findToolName(callId) {
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            const message = this.messages[i];
+            if (message.role !== 'assistant' || !message.toolCalls?.length)
+                continue;
+            const match = message.toolCalls.find((call) => call.id === callId);
+            if (match?.name)
+                return match.name;
+        }
+        return undefined;
+    }
+    setSessionMemoryStore(store) {
+        this.sessionMemoryStore = store;
+    }
+    getSessionMemoryStore() {
+        return this.sessionMemoryStore;
+    }
+    setSessionLineageTracker(tracker) {
+        this.sessionLineageTracker = tracker;
+    }
+    getSessionLineageTracker() {
+        return this.sessionLineageTracker;
+    }
+    getMessagesForLLM() {
+        const result = [];
+        for (const message of this.messages) {
+            if (message.role === 'system')
+                continue;
+            if (message.role === 'user') {
+                result.push({ role: 'user', content: message.content });
+                continue;
+            }
+            if (message.role === 'assistant') {
+                result.push({
+                    role: 'assistant',
+                    content: message.content,
+                    ...(message.toolCalls ? { toolCalls: message.toolCalls } : {}),
+                });
+                continue;
+            }
+            result.push({
+                role: 'tool',
+                callId: message.callId,
+                content: message.content,
+                ...(message.toolName ? { name: message.toolName } : {}),
+            });
+        }
+        return result;
+    }
+    addUserMessage(content) {
+        if (this._title === '' && typeof content === 'string' && content.trim().length > 0) {
+            this.setSystemTitle(deriveConversationTitle(content));
+        }
+        this.messages.push({ role: 'user', content });
+    }
+    addAssistantMessage(content, opts) {
+        this.messages.push({
+            role: 'assistant',
+            content,
+            toolCalls: opts?.toolCalls,
+            reasoningContent: opts?.reasoningContent,
+            reasoningSummary: opts?.reasoningSummary,
+            usage: opts?.usage,
+            model: opts?.model,
+            provider: opts?.provider,
+        });
+    }
+    addToolResults(results) {
+        for (const result of results) {
+            const content = result.success
+                ? (result.output ?? 'Tool completed successfully.')
+                : `Error: ${result.error ?? 'Unknown error'}`;
+            const toolName = this.findToolName(result.callId);
+            this.messages.push({
+                role: 'tool',
+                callId: result.callId,
+                content,
+                ...(toolName ? { toolName } : {}),
+            });
+        }
+    }
+    addSystemMessage(content) {
+        this.messages.push({ role: 'system', content });
+    }
+    getLastUserMessage() {
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            if (this.messages[i].role === 'user') {
+                const content = this.messages[i].content;
+                return typeof content === 'string' ? content : null;
+            }
+        }
+        return null;
+    }
+    getMessageCount() {
+        return this.messages.length;
+    }
+    removeMessagesAfter(count) {
+        if (count < this.messages.length) {
+            this.messages.length = count;
+        }
+    }
+    markLastUserMessageCancelled() {
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            if (this.messages[i].role === 'user') {
+                this.messages[i].cancelled = true;
+                return;
+            }
+        }
+    }
+    startStreamingBlock() {
+        this.messages.push({ role: 'assistant', content: '' });
+        this.streamingMessageIndex = this.messages.length - 1;
+    }
+    updateStreamingBlock(content) {
+        if (this.streamingMessageIndex < 0)
+            return;
+        const message = this.messages[this.streamingMessageIndex];
+        if (message?.role === 'assistant') {
+            message.content = content;
+        }
+    }
+    finalizeStreamingBlock() {
+        if (this.streamingMessageIndex >= 0 && this.messages[this.streamingMessageIndex]?.role === 'assistant') {
+            this.messages.splice(this.streamingMessageIndex, 1);
+        }
+        this.streamingMessageIndex = -1;
+    }
+    getMessageSnapshot() {
+        return cloneMessages(this.messages);
+    }
+    getTranscriptEventIndex() {
+        return buildTranscriptEventIndex(this.getMessageSnapshot());
+    }
+    replaceMessagesForLLM(newMessages) {
+        const systemMessages = this.messages.filter((message) => message.role === 'system');
+        this.messages = [...systemMessages, ...messagesToInternal(newMessages)];
+        this.streamingMessageIndex = -1;
+    }
+    async compact(registry, modelId, trigger = 'manual', provider, context) {
+        return compactConversation(this, registry, modelId, trigger, provider, context);
+    }
+    get title() {
+        return this._title;
+    }
+    set title(value) {
+        this._title = String(value ?? '');
+        this._titleSource = this._title.trim().length > 0 ? 'user' : 'system';
+    }
+    getTitleSource() {
+        return this._titleSource;
+    }
+    setSystemTitle(value) {
+        if (this._titleSource === 'user')
+            return;
+        this._title = String(value ?? '');
+        this._titleSource = 'system';
+    }
+    resetAll() {
+        this.messages = [];
+        this._title = '';
+        this._titleSource = 'system';
+        this.branches.clear();
+        this.currentBranch = 'main';
+        this.streamingMessageIndex = -1;
+    }
+    forkBranch(name, force = false) {
+        const branchName = name?.trim() || `branch-${Date.now()}`;
+        if (!force && this.branches.has(branchName)) {
+            return branchName;
+        }
+        this.branches.set(branchName, cloneMessages(this.messages));
+        return branchName;
+    }
+    listBranches() {
+        const result = [];
+        const currentInMap = this.branches.has(this.currentBranch);
+        if (!currentInMap) {
+            result.push({ name: this.currentBranch, messageCount: this.messages.length, isCurrent: true });
+        }
+        for (const [name, messages] of this.branches) {
+            result.push({ name, messageCount: messages.length, isCurrent: name === this.currentBranch });
+        }
+        return result;
+    }
+    switchBranch(name) {
+        const stored = this.branches.get(name);
+        if (!stored)
+            return false;
+        this.branches.set(this.currentBranch, cloneMessages(this.messages));
+        this.messages = cloneMessages(stored);
+        this.currentBranch = name;
+        this.streamingMessageIndex = -1;
+        return true;
+    }
+    mergeBranch(name) {
+        const stored = this.branches.get(name);
+        if (!stored)
+            return false;
+        const commonLength = Math.min(this.messages.length, stored.length);
+        const toAppend = stored.slice(commonLength);
+        if (toAppend.length === 0)
+            return true;
+        this.messages.push(...cloneMessages(toAppend));
+        return true;
+    }
+    getCurrentBranch() {
+        return this.currentBranch;
+    }
+    toJSON() {
+        return {
+            messages: cloneMessages(this.messages),
+            timestamp: Date.now(),
+            title: this._title,
+            titleSource: this._titleSource,
+            branches: cloneBranchMap(this.branches),
+            currentBranch: this.currentBranch,
+        };
+    }
+    fromJSON(data) {
+        this.messages = data.messages ?? [];
+        this._title = typeof data.title === 'string' ? data.title : '';
+        this._titleSource = data.titleSource === 'user' || data.titleSource === 'system'
+            ? data.titleSource
+            : (this._title ? 'user' : 'system');
+        this.branches = restoreBranchMap(data.branches);
+        this.currentBranch = data.currentBranch ?? 'main';
+        this.streamingMessageIndex = -1;
+    }
+}
+export { parseDiffForApply, applyDiffContent } from './conversation-diff.js';

package/dist/_internal/platform/core/event-replay.d.ts

@@ -0,0 +1,83 @@
+import type { RuntimeEventBus } from '../runtime/events/index.js';
+export type ReplayTrackedEventName = 'AGENT_COMPLETED' | 'AGENT_FAILED' | 'WORKFLOW_STATE_CHANGED' | 'WORKFLOW_CHAIN_PASSED' | 'WORKFLOW_CHAIN_FAILED';
+export interface QueuedEvent {
+    id: string;
+    eventName: ReplayTrackedEventName;
+    payload: unknown;
+    timestamp: number;
+    acknowledged: boolean;
+    turnCount: number;
+    replayCount: number;
+}
+/** Events that are significant enough to track for replay. */
+export declare const TRACKED_EVENTS: readonly ["AGENT_COMPLETED", "AGENT_FAILED", "WORKFLOW_STATE_CHANGED", "WORKFLOW_CHAIN_PASSED", "WORKFLOW_CHAIN_FAILED"];
+/**
+ * EventReplayQueue — holds events and replays unacknowledged ones.
+ *
+ * Grace period: events are held for 1 full LLM turn after they fire.
+ * After the grace period, if unacknowledged, they are replayed as
+ * system messages in the conversation.
+ *
+ * Replay strategy:
+ * - After 1 turn grace: replay once as system message
+ * - After 2nd replay: replay with emphasis
+ * - After 3rd replay: mark as dropped, log warning
+ * - Max 3 replays per event
+ */
+export declare class EventReplayQueue {
+    private queue;
+    private currentTurn;
+    private droppedCount;
+    private readonly maxReplays;
+    private readonly graceTurns;
+    constructor(maxReplays?: number, graceTurns?: number);
+    /**
+     * Enqueue an event for tracking.
+     * Called when significant events fire (agent complete, WRFC state change, etc.)
+     * Returns the assigned event ID.
+     */
+    enqueue(eventName: ReplayTrackedEventName, payload: unknown): string;
+    /**
+     * Mark an event as acknowledged by ID.
+     * Called when the model demonstrates awareness of the event.
+     */
+    acknowledge(eventId: string): void;
+    /**
+     * Acknowledge all events matching a predicate.
+     * E.g., acknowledge all events for a specific agent ID.
+     * Returns the number of events acknowledged.
+     */
+    acknowledgeWhere(predicate: (event: QueuedEvent) => boolean): number;
+    /**
+     * Signal that an LLM turn has completed.
+     * Increments the turn counter and returns events that need replaying.
+     * Events that exceed maxReplays are dropped (logged and removed from queue).
+     */
+    onTurnComplete(): QueuedEvent[];
+    /**
+     * Format replay events as system messages ready to inject into the conversation.
+     */
+    formatReplays(events: QueuedEvent[]): string[];
+    /**
+     * Get queue stats for telemetry and debugging.
+     */
+    getStats(): {
+        queued: number;
+        acknowledged: number;
+        pending: number;
+        replayed: number;
+        dropped: number;
+    };
+    /**
+     * Clear all events (e.g., on session reset).
+     */
+    clear(): void;
+    /** Format a human-readable message for a single event. */
+    private _formatEventMessage;
+    /**
+     * Wire up listeners for replay-significant events on the typed runtime bus.
+     * Returns an unsubscribe function that removes all listeners.
+     */
+    static attachToRuntimeBus(bus: RuntimeEventBus, queue: EventReplayQueue): () => void;
+}
+//# sourceMappingURL=event-replay.d.ts.map

package/dist/_internal/platform/core/event-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-replay.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/core/event-replay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,4BAA4B,CAAC;AAG7F,MAAM,MAAM,sBAAsB,GAC9B,iBAAiB,GACjB,cAAc,GACd,wBAAwB,GACxB,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,eAAO,MAAM,cAAc,0HAMjB,CAAC;AAMX;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAU;IAMxB;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAcpE;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlC;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM;IAWpE;;;;OAIG;IACH,cAAc,IAAI,WAAW,EAAE;IAkC/B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE;IAc9C;;OAEG;IACH,QAAQ,IAAI;QACV,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB;IAcD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,0DAA0D;IAC1D,OAAO,CAAC,mBAAmB;IAsC3B;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,IAAI;CA+CrF"}