deepclause-sdk 0.0.63 → 0.0.65

package/README.md

@@ -719,6 +719,37 @@ agent_main(Topic) :-
     answer(Final).
 ```
 
+### Shared Predicates Across DML Files
+
+When a skill grows beyond one file, move reusable predicates into helper files and load them at the top of the main DML. This is useful for shared search helpers, validation predicates, common formatting logic, or domain-specific utilities that multiple skills reuse.
+
+```prolog
+% .deepclause/tools/repo-review/helpers/search_helpers.dml
+normalize_query(Query, Normalized) :-
+    format(string(Normalized), "site:github.com ~w", [Query]).
+
+search_and_summarize(Query, Summary) :-
+    normalize_query(Query, Normalized),
+    exec(web_search(query: Normalized), Results),
+    task("Summarize these results: {Results}", Summary).
+```
+
+```prolog
+% .deepclause/tools/repo-review.dml
+:- use_module(library(lists)).
+:- use_module(library(clpfd)).
+:- consult('.deepclause/tools/repo-review/helpers/search_helpers.dml').
+
+agent_main(Topic) :-
+    search_and_summarize(Topic, Summary),
+    answer(Summary).
+```
+
+- Use `:- use_module(library(...)).` for standard SWI-Prolog libraries such as `lists`, `clpfd`, `clpq`, and `clpr`.
+- Use `:- consult('workspace-relative/path.dml').` for local shared DML helpers inside the workspace.
+- Local `:- use_module('.deepclause/tools/repo-review/helpers/search_helpers.dml').` also works as a convenience alias, but today it has consult-style loading semantics rather than full SWI module export filtering.
+- When a helper belongs to one skill, keep it in a dedicated subfolder such as `.deepclause/tools/<skill-slug>/helpers/` so the skill and its shared predicates stay together.
+
 ## Using as a Library
 
 Embed DeepClause in your own applications:

package/dist/cli/tui.d.ts

@@ -54,6 +54,7 @@ export declare class ActivityBuffer {
     finish(): void;
     clear(): void;
     snapshot(): string[];
+    snapshotTail(limit: number): string[];
     private handleStream;
     private flushStream;
     private trim;
@@ -73,6 +74,14 @@ export declare function parseCommandArgs(rawArgs: string): string[];
 export declare function parseCommandBarInput(line: string): ParsedTuiInput;
 export declare function parseSlashInput(line: string): ParsedTuiInput;
 export declare function canSubmitParsedInputWhileBusy(parsed: ParsedTuiInput): boolean;
+export declare function reconcileEphemeralMessages(persistedMessages: Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>, ephemeralMessages: DisplayMessage[]): DisplayMessage[];
+export declare function sessionMessagesContainCompletedTaskPreview(persistedMessages: Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>, previewEntries: DisplayMessage[]): boolean;
 export declare function computeFramePatch(previousLines: string[] | null, nextLines: string[], previousSize: {
     columns: number;
     rows: number;
@@ -100,6 +109,10 @@ export declare function nextWrappedIndex(currentIndex: number, delta: -1 | 1, le
 export declare function selectMenuItemByTypeahead(items: ReadonlyArray<{
     label: string;
 }>, query: string, currentIndex?: number): number;
+export declare function collectTailWrappedLines(body: string[], innerWidth: number, limit: number): {
+    lines: string[];
+    truncated: boolean;
+};
 export declare function filterPickerItems<T extends {
     label: string;
     description: string;

package/dist/cli/tui.d.ts.map

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

package/dist/cli/tui.js

@@ -212,6 +212,19 @@ export class ActivityBuffer {
             ? [...activeLines, '', ...body]
             : activeLines;
     }
+    snapshotTail(limit) {
+        const boundedLimit = Math.max(1, limit);
+        const body = this.activeStreamLine
+            ? [...this.lines.slice(-boundedLimit), this.activeStreamLine]
+            : this.lines.slice(-boundedLimit);
+        const activeLines = this.buildActiveToolLines();
+        if (activeLines.length === 0) {
+            return body;
+        }
+        return body.length > 0
+            ? [...activeLines, '', ...body]
+            : activeLines;
+    }
     handleStream(logEvent) {
         const streamKey = logEvent.scope === 'child' ? `child:${logEvent.childSlug ?? '?'}` : 'main';
         if (this.activeStreamKey !== streamKey) {
@@ -860,9 +873,12 @@ class FullscreenTui {
                 },
             });
             activity.finish();
+            this.completeCurrentPreview({
+                finalText: result.answer,
+                error: result.error,
+            });
             await this.refreshSessions({ createIfMissing: true, selectedSessionId: result.sessionId });
             await this.refreshCommands();
-            this.finishExecutionPreview({ persist: false });
             this.statusLine = result.error ? 'Task failed.' : 'Task finished.';
         }
         catch (error) {
@@ -2108,6 +2124,21 @@ class FullscreenTui {
         }
         this.currentPreview = null;
     }
+    completeCurrentPreview(options) {
+        if (!this.currentPreview || this.currentPreview.kind === 'shell') {
+            return;
+        }
+        this.currentPreview.activeChildTag = undefined;
+        const assistant = this.ensurePreviewAssistantMessage();
+        if (typeof options.finalText === 'string' && options.finalText.trim()) {
+            assistant.content = options.finalText;
+        }
+        if (typeof options.error === 'string' && options.error.trim()) {
+            assistant.content = options.error;
+            assistant.error = true;
+        }
+        assistant.pending = false;
+    }
     cancelCurrentExecution(message) {
         if (!this.busy || !this.currentAbortController) {
             this.statusLine = 'No execution is currently running.';
@@ -2264,6 +2295,22 @@ class FullscreenTui {
             return;
         }
         this.sessionDetail = await getConductorSessionDetail(this.workspaceRoot, this.selectedSessionId);
+        if (this.currentPreview
+            && this.currentPreview.kind === 'task'
+            && this.currentPreview.sessionId === this.selectedSessionId
+            && sessionMessagesContainCompletedTaskPreview(this.sessionDetail.messages, this.currentPreview.entries)) {
+            this.currentPreview = null;
+        }
+        const existingEphemeral = this.ephemeralMessagesBySessionId.get(this.selectedSessionId);
+        if (!existingEphemeral || existingEphemeral.length === 0) {
+            return;
+        }
+        const reconciled = reconcileEphemeralMessages(this.sessionDetail.messages, existingEphemeral);
+        if (reconciled.length === 0) {
+            this.ephemeralMessagesBySessionId.delete(this.selectedSessionId);
+            return;
+        }
+        this.ephemeralMessagesBySessionId.set(this.selectedSessionId, reconciled);
     }
     activityFor(key) {
         const existing = this.activityBySessionId.get(key);
@@ -2430,7 +2477,7 @@ class FullscreenTui {
         }
         return lines;
     }
-    buildMessagesPaneBody() {
+    buildMessageEntries() {
         const entries = [];
         if (this.sessionDetail) {
             for (const message of this.sessionDetail.messages) {
@@ -2442,6 +2489,10 @@ class FullscreenTui {
         if (this.currentPreview && this.currentPreview.sessionId === this.selectedSessionId) {
             entries.push(...this.currentPreview.entries);
         }
+        return entries;
+    }
+    buildMessagesPaneBody(options = {}) {
+        const entries = this.buildMessageEntries();
         if (entries.length === 0) {
             return [
                 '[System] No messages yet.',
@@ -2449,8 +2500,11 @@ class FullscreenTui {
                 '  The center pane shows user and assistant messages.',
             ];
         }
+        const visibleEntries = typeof options.recentEntryLimit === 'number' && options.recentEntryLimit > 0
+            ? entries.slice(-options.recentEntryLimit)
+            : entries;
         const lines = [];
-        for (const entry of entries) {
+        for (const entry of visibleEntries) {
             const header = this.formatMessageHeader(entry);
             lines.push(header);
             const bodyLines = entry.content
@@ -2466,8 +2520,10 @@ class FullscreenTui {
         }
         return lines;
     }
-    buildProcessPaneBody() {
-        const activity = this.currentProcessActivity().snapshot();
+    buildProcessPaneBody(options = {}) {
+        const activity = typeof options.tailLineLimit === 'number' && options.tailLineLimit > 0
+            ? this.currentProcessActivity().snapshotTail(options.tailLineLimit)
+            : this.currentProcessActivity().snapshot();
         if (activity.length > 0) {
             return activity;
         }
@@ -2531,7 +2587,7 @@ class FullscreenTui {
         return body;
     }
     buildPaneView(kind, title, width, height) {
-        const metrics = this.getPaneMetrics(kind, width, height);
+        const metrics = this.getRenderPaneMetrics(kind, width, height);
         const paneTitle = this.buildPaneTitle(title, kind, metrics);
         return buildPane(paneTitle, metrics.lines.slice(metrics.start, metrics.start + metrics.viewportLines), width, height, kind, this.focusedPane === kind);
     }
@@ -2681,6 +2737,23 @@ class FullscreenTui {
             ? `${title}${this.focusedPane === kind ? ' [focus]' : ''} [follow]`
             : `${title}${this.focusedPane === kind ? ' [focus]' : ''} [-${this.paneScroll[kind]}]`;
     }
+    getRenderPaneMetrics(kind, width = paneDimensionsForKind(kind, output.columns ?? 120, output.rows ?? 40).width, height = paneDimensionsForKind(kind, output.columns ?? 120, output.rows ?? 40).height) {
+        if ((kind === 'process' || kind === 'messages') && this.paneScroll[kind] === 0) {
+            const innerWidth = Math.max(1, width - 2);
+            const viewportLines = Math.max(0, height - 2);
+            const rawBody = kind === 'messages'
+                ? this.buildMessagesPaneBody({ recentEntryLimit: Math.max(8, viewportLines * 2) })
+                : this.buildProcessPaneBody({ tailLineLimit: Math.max(16, viewportLines * 4) });
+            const tail = collectTailWrappedLines(rawBody, innerWidth, viewportLines);
+            return {
+                lines: tail.lines,
+                start: 0,
+                maxStart: tail.truncated ? 1 : 0,
+                viewportLines,
+            };
+        }
+        return this.getPaneMetrics(kind, width, height);
+    }
     getPaneMetrics(kind, width = paneDimensionsForKind(kind, output.columns ?? 120, output.rows ?? 40).width, height = paneDimensionsForKind(kind, output.columns ?? 120, output.rows ?? 40).height) {
         const innerWidth = Math.max(1, width - 2);
         const rawBody = this.getPaneBody(kind);
@@ -3157,6 +3230,49 @@ export function parseSlashInput(line) {
 export function canSubmitParsedInputWhileBusy(parsed) {
     return parsed.kind === 'builtin' && (parsed.name === 'cancel' || parsed.name === 'exit' || parsed.name === 'quit');
 }
+export function reconcileEphemeralMessages(persistedMessages, ephemeralMessages) {
+    if (ephemeralMessages.length === 0) {
+        return [];
+    }
+    const persistedCounts = new Map();
+    for (const message of persistedMessages) {
+        const key = `${message.role}\u0000${message.content}`;
+        persistedCounts.set(key, (persistedCounts.get(key) ?? 0) + 1);
+    }
+    const remaining = [];
+    for (const message of ephemeralMessages) {
+        if (message.pending || message.role === 'system') {
+            remaining.push(message);
+            continue;
+        }
+        const key = `${message.role}\u0000${message.content}`;
+        const count = persistedCounts.get(key) ?? 0;
+        if (count > 0) {
+            persistedCounts.set(key, count - 1);
+            continue;
+        }
+        remaining.push(message);
+    }
+    return remaining;
+}
+export function sessionMessagesContainCompletedTaskPreview(persistedMessages, previewEntries) {
+    const previewUser = [...previewEntries].reverse().find((entry) => entry.role === 'user' && entry.content);
+    const previewAssistant = [...previewEntries].reverse().find((entry) => entry.role === 'assistant' && !entry.pending && entry.content);
+    if (!previewUser || !previewAssistant) {
+        return false;
+    }
+    for (let index = persistedMessages.length - 1; index >= 1; index -= 1) {
+        const assistant = persistedMessages[index];
+        const user = persistedMessages[index - 1];
+        if (user?.role === 'user'
+            && assistant?.role === 'assistant'
+            && user.content === previewUser.content
+            && assistant.content === previewAssistant.content) {
+            return true;
+        }
+    }
+    return false;
+}
 export function computeFramePatch(previousLines, nextLines, previousSize, nextSize) {
     if (!previousLines
         || !previousSize
@@ -3855,6 +3971,29 @@ function wrapBodyLines(body, innerWidth) {
     }
     return lines;
 }
+export function collectTailWrappedLines(body, innerWidth, limit) {
+    if (limit <= 0) {
+        return { lines: [], truncated: body.length > 0 };
+    }
+    const collected = [];
+    let truncated = false;
+    for (let index = body.length - 1; index >= 0; index -= 1) {
+        const wrapped = wrapPlainText(body[index], innerWidth);
+        const remaining = limit - collected.length;
+        if (remaining <= 0) {
+            truncated = true;
+            break;
+        }
+        if (wrapped.length <= remaining) {
+            collected.unshift(...wrapped);
+            continue;
+        }
+        collected.unshift(...wrapped.slice(wrapped.length - remaining));
+        truncated = true;
+        break;
+    }
+    return { lines: collected, truncated };
+}
 async function listWorkspaceTextFiles(workspaceRoot) {
     const results = [];
     const visit = async (relativeDir) => {