@swarmify/agents-cli 1.12.0 → 1.13.1

package/dist/lib/session/render.d.ts

@@ -1,22 +1,103 @@
+/**
+ * Session rendering: summary, markdown conversation, and JSON output.
+ *
+ * Provides the display layer for `agents sessions <id>`. The summary renderer
+ * produces a chalk-formatted activity overview (modified files, commands,
+ * errors, final message). The markdown renderer emits a full conversation
+ * transcript. Filtering by role and turn slicing is handled here as well.
+ */
 import type { SessionEvent } from './types.js';
 /**
- * Render session as a conversation transcript.
- * Shows user messages, assistant text, and tool calls as one-liners.
+ * Return absPath relative to cwd; fall back to ~/… then absolute.
+ */
+export declare function relativeToCwd(absPath: string, cwd?: string): string;
+/**
+ * Wrap label in an OSC 8 hyperlink when the terminal supports it.
+ * Degrades to plain label otherwise.
+ */
+export declare function linkPath(absPath: string, label: string): string;
+/**
+ * Unwrap wrapper prefixes to find the actual executable.
+ */
+export declare function unwrapCommand(cmd: string): string;
+/**
+ * Normalize a command so trivial flag/pipe variations collapse to the same key.
+ */
+export declare function normalizeForDedup(cmd: string): string;
+/**
+ * Return the bucket key for a command (used for grouping within a category).
+ */
+export declare function bucketKey(cmd: string): string;
+interface CmdRun {
+    normalized: string;
+    raw: string;
+    firstTs: number;
+    lastTs: number;
+    count: number;
+}
+/**
+ * Collapse consecutive same-normalized commands within a 60-second window
+ * when they appear 3+ times. Fewer than 3 stay as separate entries.
+ */
+export declare function collapseRetries(commands: Array<{
+    cmd: string;
+    ts: number;
+}>): CmdRun[];
+/** Aggregated statistics computed from a session's parsed events. */
+export interface SessionStats {
+    models: string[];
+    userTurns: number;
+    assistantTurns: number;
+    toolCount: number;
+    errorCount: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    firstTs: number;
+    lastTs: number;
+}
+/** Compute aggregate statistics (turns, tools, tokens, duration) from session events. */
+export declare function computeSummaryStats(events: SessionEvent[]): SessionStats;
+/**
+ * Return the stats line for a session summary header.
+ * e.g. "221 turns · 198 tools (10 errors) · 67.5M cached / 361K out · 12 min"
+ */
+export declare function renderSummaryHeader(stats: SessionStats): string;
+/**
+ * Render session as an activity summary.
+ * Returns a chalk-formatted string (not markdown) for direct terminal output.
+ */
+export declare function renderSummary(events: SessionEvent[], cwd?: string): string;
+/** Allowed values for --include/--exclude role filters. */
+export declare const VALID_ROLE_VALUES: readonly ["user", "assistant", "thinking", "tools"];
+/** A single role filter value derived from VALID_ROLE_VALUES. */
+export type RoleFilter = typeof VALID_ROLE_VALUES[number];
+/** Options for filtering session events by role and turn range. */
+export interface FilterOptions {
+    include?: RoleFilter[];
+    exclude?: RoleFilter[];
+    first?: number;
+    last?: number;
+}
+/**
+ * Parse a comma-separated role list (e.g. "user,assistant") into typed values.
+ * Throws with a clear message listing valid values on any unknown entry.
  */
-export declare function renderTranscript(events: SessionEvent[]): string;
+export declare function parseRoleList(raw: string, flag: string): RoleFilter[];
 /**
- * Render session as a markdown activity summary.
- * Groups files by directory, shows commands in a code block,
- * and gives the final message room to breathe.
+ * Apply include/exclude/first/last. Turn slicing runs first so role filters
+ * operate on the sliced window (natural semantics: "last 3 turns, user only").
  */
-export declare function renderSummary(events: SessionEvent[]): string;
+export declare function filterEvents(events: SessionEvent[], opts: FilterOptions): SessionEvent[];
 /**
- * Render session as a markdown trace (for GitHub gist uploads).
- * Structure: Agent Reasoning section + Full Conversation section.
+ * Build the conversation as a single markdown string: user / assistant
+ * messages, inline thinking blocks, tool calls, and errors. Emitted in event
+ * order so reasoning sits where it actually occurred relative to the assistant
+ * reply.
  */
-export declare function renderTrace(events: SessionEvent[]): string;
+export declare function renderConversationMarkdown(events: SessionEvent[]): string;
 /**
  * Render session as JSON (normalized events).
  */
 export declare function renderJson(events: SessionEvent[]): string;
+export {};
 //# sourceMappingURL=render.d.ts.map

package/dist/lib/session/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/session/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CA8B/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CA0G5D;AAwED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAyC1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/session/render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAUnE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAW/D;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD;AAwBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7C;AAaD,UAAU,MAAM;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAwBtF;AAID,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CA0CxE;AA6BD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyB/D;AAgLD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CA6O1E;AAID,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,qDAAsD,CAAC;AACrF,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1D,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAWrE;AA0ED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,CAMxF;AAID;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAiCzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAEzD"}