@illuminis/comprism 0.1.3 → 0.1.5

package/out/agent/render.d.ts

@@ -26,6 +26,11 @@ export declare const red: (t: string) => string;
 export declare const green: (t: string) => string;
 export declare const yellow: (t: string) => string;
 export declare const gray: (t: string) => string;
+/** The brand's violet, for model names and the receipt's label. */
+export declare const violet: (t: string) => string;
+/** `claude-haiku-4-5` as a person says it, `Claude Haiku 4.5`. Other vendors'
+ *  ids are shown as they arrive: a wrong guess at a name is worse than the id. */
+export declare function modelName(id: string): string;
 /** Money, at the precision a person can act on.
  *
  *  Four decimal places below a cent, because a coding step often costs less
@@ -36,6 +41,8 @@ export declare function duration(ms: number | null | undefined): string;
 /** One action, as it happens. A word as well as a color, so this still reads
  *  when piped to a file. */
 export declare function action(name: string, target: string, ok: boolean, ms?: number): string;
+/** A connected tool as people write it, `server.tool` (manual 9.10). */
+export declare function actionName(name: string): string;
 /** The share of a step's context the provider served from its cache, or null
  *  when it reported no counts. Anthropic counts cached tokens OUTSIDE the input
  *  figure, so the whole context is the three counts added together. */
@@ -44,7 +51,7 @@ export declare function reusePct(tokensIn: number | null | undefined, cacheRead:
  *  provider had already seen. The last figure is the one study 005 found
  *  missing from our receipt: without it nobody could tell a warm step from a
  *  cold one, and every step was cold. */
-export declare function step(index: number, model: string, usd: number | null, ms: number | null, reused?: number | null): string;
+export declare function step(index: number, model: string, usd: number | null, ms: number | null, reused?: number | null, reason?: string): string;
 /** The task list, reprinted whenever it changes.
  *
  *  Reprinted rather than redrawn in place: what the agent intended at each point
@@ -54,14 +61,40 @@ export declare function todos(items: Array<{
     content: string;
     status: string;
 }>): string;
+/** A question from the agent, or the plan question (manual 4.2, 4.3). The
+ *  wording is the service's; this only lays it out. */
+export declare function question(q: string, options: string[]): string;
 /** A change, before it is made.
  *
  *  Full text for a small edit and a summary for a large one. Pasting four
  *  hundred lines into a terminal is not review, it is a wall somebody presses
  *  through, and an approval people press through protects nobody. */
-export declare function diff(name: string, input: Record<string, unknown>): string;
+export declare function diff(name: string, input: Record<string, unknown>, withHead?: boolean): string;
+/** What was stopped when a session ended, one line each (manual 5.13). */
+export declare function stoppedLines(stopped: string[]): string;
+/** The first line of a finished job, as the service wrote it (manual 5.15).
+ *  Colored by its first word only; the words are the service's. */
+export declare function ending(line: string, detail: string | null | undefined): string;
 /** How the job ended, in the words a person reads. */
 export declare function outcome(o: string, detail: string | null | undefined): string;
+/**
+ * A link a person can click, where the terminal supports one.
+ *
+ * Modern terminals understand an escape that carries an address behind a piece
+ * of text; older ones print it as ordinary characters, so the address is shown
+ * in words there instead. Never a bare escape with no fallback: a receipt whose
+ * proof is unreachable is not proof.
+ */
+export declare function link(text: string, url: string): string;
+/**
+ * A file the agent made, as a link that opens it, with where it lives beneath.
+ *
+ * The name alone is not enough: somebody who asked from their home folder for a
+ * diagram cannot tell which folder "saved diagram.png" means. So the full path
+ * is written out underneath in gray, where it can be copied into Finder or a
+ * terminal, and the name above it opens the file on a click.
+ */
+export declare function savedFile(name: string, fullPath: string, bytes: string): string;
 /** One model's share of a job, as our server reported it. */
 export interface ModelShare {
     model: string | null;
@@ -69,6 +102,18 @@ export interface ModelShare {
     usd: number | null;
     unpriced?: number;
 }
+/** The receipt card, exactly as the server words it for every client. */
+export interface ReceiptCard {
+    model: string | null;
+    title: string | null;
+    vs: string | null;
+    amount: string | null;
+    saved: boolean;
+    /** The label of the link to the whole record. */
+    details?: string | null;
+    badge: string | null;
+    warning: string | null;
+}
 /**
  * The receipt under a finished job.
  *
@@ -85,13 +130,16 @@ export interface ModelShare {
  * it, quieten it, and turn the address in it into something clickable. That is
  * formatting, which belongs to the client, and it is the only part that does.
  */
-export declare function receipt(text: string, models?: ModelShare[], testsPassed?: boolean): string;
+export declare function receipt(text: string, models?: ModelShare[], testsPassed?: boolean, card?: ReceiptCard | null): string;
 /**
- * Plain text, from a model that writes markdown.
+ * An answer, laid out for reading in a terminal (manual 6.17).
  *
- * A terminal has no bold and no bullet glyphs, so `**like this**` arrives on
- * screen as literal asterisks and a heading looks like a typing mistake. The
- * emphasis is real, so it is kept as terminal bold rather than thrown away;
- * everything that only exists to be rendered by a browser is removed.
+ * The approved design (docs/product/design/cli-answer, option B): the whole
+ * answer on one left margin behind a violet rail, so where the question ends
+ * and the answer begins is never in doubt; words wrapped at a reading width
+ * and never split by the window edge; a blank line between every block;
+ * headings in the brand violet; code in its own color; wrapped list items
+ * continuing under their own text. Piped to a file or another program, the
+ * same answer comes out without the rail or the color, as a log wants it.
  */
 export declare function plain(text: string): string;