@agentdeck/shared 0.1.0 → 0.2.3

package/dist/timeline.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Shared timeline types and log parser for OpenClaw mode.
+ * Used by both bridge (BridgeLogStream) and plugin (LogStream).
+ */
+export type TimelineEntryType = 'tool_request' | 'tool_resolved' | 'chat_start' | 'chat_end' | 'chat_response' | 'error' | 'scheduled' | 'user_action' | 'model_call' | 'model_response' | 'memory_recall' | 'tool_exec' | 'eval_result' | 'task_start' | 'task_end' | 'task_milestone';
+import type { TaskBoundarySignal } from './eval-schema.js';
+export type { TaskBoundarySignal } from './eval-schema.js';
+export interface TimelineEntry {
+    ts: number;
+    type: TimelineEntryType;
+    raw: string;
+    detail?: string;
+    approvalId?: string;
+    status?: 'pending' | 'approved' | 'denied';
+    agentType?: string;
+    projectName?: string;
+    sessionId?: string;
+    runId?: string;
+    startedAt?: number;
+    endedAt?: number;
+    repeatCount?: number;
+    automated?: boolean;
+    /** APME task id. Set on task_start/task_end and on every turn entry inside the task scope. */
+    taskId?: string;
+    /** Only on task_end. Why the task closed. */
+    boundarySignal?: TaskBoundarySignal;
+    /**
+     * Per-task evaluation result, attached when the task_judge resolves
+     * (always AFTER the initial task_end emit — clients upsert the existing
+     * row by (type='task_end', taskId) and merge these four fields).
+     *
+     *   - `taskScore`   : 0..1 composite (matches `tasks.composite_score`)
+     *   - `taskOutcome` : terminal outcome string from `bridge/src/apme/outcome.ts`
+     *     (`'committed' | 'abandoned' | 'iterated' | 'ab_winner' | 'ab_loser'
+     *     | 'interrupted' | 'exploratory' | 'pending'`). UIs collapse into
+     *     three visual classes — success / fail / partial / pending — and pick
+     *     the badge color via design-system status tokens.
+     *   - `taskCategory`: task_rollup category ('general' | 'conversation' | …)
+     *   - `taskSummary` : one-line judge summary
+     */
+    taskScore?: number;
+    taskOutcome?: string;
+    taskCategory?: string;
+    taskSummary?: string;
+    /**
+     * How the row's `raw` summary was produced. Lets clients decide whether
+     * the detail pane is worth showing — when `'none'`, detail is just the
+     * unfiltered response that the heuristic couldn't summarize, and showing
+     * it duplicates content rather than adding value.
+     *   - `'llm'`     : LLM-summarized (clean, short, distinct from detail)
+     *   - `'heuristic'`: topic-hint extracted from response or prompt
+     *   - `'none'`    : last-resort fallback (literal "Completed", bare tool name, etc.)
+     *   - `'progress'`: non-terminal assistant status update (work still running)
+     */
+    summaryKind?: 'llm' | 'heuristic' | 'none' | 'progress';
+}
+/**
+ * Prepare a chat-response body for storage as `entry.detail` while keeping
+ * markdown intact. Use this on chat_response / chat_end emit paths so the
+ * client renderer can apply heading / bullet / table / inline span styles —
+ * `cleanDetailText` would have stripped all of that before it ever reached
+ * the dashboard.
+ *
+ * Filters and caps:
+ *   - System JSON blobs (`{"connectionId": ...}` etc.) → empty
+ *   - Error JSON (`{"error": ...}`) → the error string
+ *   - Other JSON object → compact stringified form (200 char cap)
+ *   - Otherwise → original text with 3+ blank lines collapsed to 2, trimmed
+ *
+ * Markdown markers (`**`, `##`, `|`, `` ` ``, `[text](url)`, etc.) are
+ * preserved verbatim so the client `parseTimelineMarkdown` /
+ * `parseInlineSpans` can do their job.
+ */
+export declare function prepareMarkdownDetail(text: string): string;
+/**
+ * Clean detail text — strip markdown artifacts, JSON blobs, and system noise.
+ * Applied to timeline entry `detail` fields before storage on **non-chat**
+ * paths (tool errors, system log lines). Chat response detail should go
+ * through `prepareMarkdownDetail` instead so the dashboard can render the
+ * markdown.
+ */
+export declare function cleanDetailText(text: string): string;
+/**
+ * Strip inline markdown from raw text (lightweight version of cleanDetailText).
+ * Handles: **bold**, # heading, `code`, [text](url).
+ */
+export declare function cleanRawText(text: string): string;
+/**
+ * Remove NOP/NOOP markers from text.
+ * Applied to both raw and detail fields.
+ */
+export declare function cleanNopMarkers(text: string): string;
+export declare function isAssistantProgressUpdate(text?: string): boolean;
+export declare function detailHasRealSignal(detail?: string): boolean;
+export declare function isOpenClawPlaceholderRaw(raw: string): boolean;
+export declare function isTaskNotificationChatStart(entry: TimelineEntry): boolean;
+export declare function isOpenClawLowSignalResponse(entry: TimelineEntry): boolean;
+export declare function isOpenClawCronPrompt(text?: string): boolean;
+export declare function summarizeOpenClawCronPrompt(text?: string): string;
+export declare function shouldDropLowSignalTimelineEntry(entry: TimelineEntry): boolean;
+export declare function normalizeTimelineEntryForStorage(entry: TimelineEntry): TimelineEntry | null;
+/**
+ * Extract the semantic core of a timeline entry for dedup comparison.
+ * For chat_end: strip duration/tool suffix (everything after first ' · ').
+ * For chat_start: use full raw text.
+ */
+export declare function extractSemanticCore(raw: string, type: TimelineEntryType): string;
+/**
+ * Check if an entry is repetitive compared to recent entries.
+ * Returns the index of the matching entry in recentEntries, or -1 if not repetitive.
+ */
+export declare function isRepetitiveEntry(entry: TimelineEntry, recentEntries: readonly TimelineEntry[], windowMs?: number): number;
+/**
+ * Shared dedup pipeline for timeline stores.
+ * Cleans text, checks exact dedup (8s), and repetitive dedup (1h).
+ * Returns: 'skip' (duplicate), 'merge' + index (repetitive), or 'add' (new).
+ *
+ * Window rationale: PTY fallback fires 1.5s after spinner_stop; Stop hook can
+ * arrive several seconds later if Claude Code's transcript_path JSONL flush is
+ * slow. 8s covers worst-case race without merging genuinely separate turns.
+ */
+export type DeduplicateResult = {
+    action: 'skip';
+} | {
+    action: 'merge';
+    index: number;
+    removeChatStartIndex?: number;
+} | {
+    action: 'add';
+    entry: TimelineEntry;
+};
+export declare function deduplicateEntry(entry: TimelineEntry, entries: readonly TimelineEntry[]): DeduplicateResult;
+/** Parse a single JSON log line into a TimelineEntry, or null if unrecognized. */
+export declare function parseLogLine(json: unknown): TimelineEntry | null;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

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