@agentdeck/shared 0.1.0 → 0.2.3

package/dist/svg-renderers/text-utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CJK-aware text measurement utilities.
+ * Shared across all SVG renderers (Stream Deck plugin, D200H bridge, etc.).
+ */
+/** True for CJK / fullwidth characters (Hangul, Kanji, Kana, CJK symbols). */
+export declare function isWide(code: number): boolean;
+/** Pixel width of a single character at given font size (Arial approximation). */
+export declare function charPx(ch: string, fontSize: number): number;
+/** Estimate pixel width of a string at given font size (Arial). */
+export declare function measureTextWidth(text: string, fontSize: number): number;
+/** Slice string so first part fits within maxPx. */
+export declare function sliceByPx(s: string, maxPx: number, fontSize: number): [string, string];
+/** Word-wrap text by estimated pixel width (works for all scripts). */
+export declare function wrapTextByWidth(text: string, maxWidthPx: number, fontSize: number): string[];
+/**
+ * Strip character sequences that must never reach a text surface: ANSI escape
+ * sequences (PTY-derived goals/activity strings carry them), XML-invalid
+ * control characters, and lone surrogates. Safe for non-SVG surfaces too
+ * (serial/e-ink/plain text) — it only removes garbage, never visible text.
+ */
+export declare function stripUnsafeText(s: string): string;
+/**
+ * The one escape function every SVG renderer must use for interpolated text.
+ * Escaping alone is NOT enough: a single raw control character (common in
+ * PTY-derived session goal/activity strings) makes resvg reject the entire
+ * SVG, which downstream turns into a blank frame on TRMNL/D200H panels.
+ */
+export declare function escSvgText(s: string): string;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/svg-renderers/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../src/svg-renderers/text-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS5C;AAED,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtF;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAsC5F;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5C"}

package/dist/svg-renderers/text-utils.js

@@ -0,0 +1,122 @@
+/**
+ * CJK-aware text measurement utilities.
+ * Shared across all SVG renderers (Stream Deck plugin, D200H bridge, etc.).
+ */
+const COMBINING_RE = /\p{M}/u;
+/** True for CJK / fullwidth characters (Hangul, Kanji, Kana, CJK symbols). */
+export function isWide(code) {
+    return ((code >= 0x1100 && code <= 0x11FF) || // Hangul Jamo
+        (code >= 0x2E80 && code <= 0x9FFF) || // CJK radicals, symbols, ideographs
+        (code >= 0xAC00 && code <= 0xD7AF) || // Hangul Syllables
+        (code >= 0xF900 && code <= 0xFAFF) || // CJK Compatibility Ideographs
+        (code >= 0xFF00 && code <= 0xFF60) || // Fullwidth forms
+        (code >= 0xFFE0 && code <= 0xFFE6) // Fullwidth signs
+    );
+}
+/** Pixel width of a single character at given font size (Arial approximation). */
+export function charPx(ch, fontSize) {
+    if (COMBINING_RE.test(ch))
+        return 0; // combining marks: zero width
+    if (isWide(ch.charCodeAt(0)))
+        return fontSize; // CJK: ~1em
+    return fontSize * 0.55; // Latin, etc.: ~0.55em
+}
+/** Estimate pixel width of a string at given font size (Arial). */
+export function measureTextWidth(text, fontSize) {
+    let px = 0;
+    for (const ch of text)
+        px += charPx(ch, fontSize);
+    return px;
+}
+/** Slice string so first part fits within maxPx. */
+export function sliceByPx(s, maxPx, fontSize) {
+    let px = 0;
+    let i = 0;
+    for (const ch of s) {
+        const cw = charPx(ch, fontSize);
+        if (cw > 0 && px + cw > maxPx)
+            break;
+        px += cw;
+        i += ch.length;
+    }
+    return [s.slice(0, i), s.slice(i)];
+}
+/** Word-wrap text by estimated pixel width (works for all scripts). */
+export function wrapTextByWidth(text, maxWidthPx, fontSize) {
+    const words = text.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = '';
+    let currentPx = 0;
+    const spacePx = fontSize * 0.28;
+    for (const word of words) {
+        const wordPx = measureTextWidth(word, fontSize);
+        if (current && currentPx + spacePx + wordPx > maxWidthPx) {
+            lines.push(current);
+            current = '';
+            currentPx = 0;
+        }
+        if (wordPx > maxWidthPx) {
+            if (current) {
+                lines.push(current);
+                current = '';
+                currentPx = 0;
+            }
+            let rem = word;
+            while (measureTextWidth(rem, fontSize) > maxWidthPx) {
+                const [chunk, rest] = sliceByPx(rem, maxWidthPx, fontSize);
+                lines.push(chunk);
+                rem = rest;
+            }
+            current = rem;
+            currentPx = measureTextWidth(rem, fontSize);
+        }
+        else {
+            if (current) {
+                current += ' ' + word;
+                currentPx += spacePx + wordPx;
+            }
+            else {
+                current = word;
+                currentPx = wordPx;
+            }
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines;
+}
+// --- SVG text sanitization ---
+/** ANSI escape sequences (CSI like `\x1b[31m`, OSC, and 2-char `\x1bX` forms). */
+const ANSI_RE = /\x1b(?:\[[0-9;:?<=>]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|[@-_])/g;
+/**
+ * Characters XML 1.0 forbids even when escaped: C0 controls (minus \t \n \r),
+ * DEL, and the noncharacters U+FFFE/U+FFFF. resvg hard-fails the whole SVG
+ * parse on any of these, so they must be stripped, not entity-escaped.
+ */
+const XML_INVALID_RE = /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f\ufffe\uffff]/g;
+/** Lone UTF-16 surrogate halves (e.g. an emoji cut by a byte-length slice). */
+const LONE_SURROGATE_RE = /[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]/g;
+/**
+ * Strip character sequences that must never reach a text surface: ANSI escape
+ * sequences (PTY-derived goals/activity strings carry them), XML-invalid
+ * control characters, and lone surrogates. Safe for non-SVG surfaces too
+ * (serial/e-ink/plain text) — it only removes garbage, never visible text.
+ */
+export function stripUnsafeText(s) {
+    return String(s).replace(ANSI_RE, '').replace(XML_INVALID_RE, '').replace(LONE_SURROGATE_RE, '');
+}
+/**
+ * The one escape function every SVG renderer must use for interpolated text.
+ * Escaping alone is NOT enough: a single raw control character (common in
+ * PTY-derived session goal/activity strings) makes resvg reject the entire
+ * SVG, which downstream turns into a blank frame on TRMNL/D200H panels.
+ */
+export function escSvgText(s) {
+    return stripUnsafeText(s)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/svg-renderers/text-utils.js.map

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

package/dist/telemetry-envelope.d.ts

@@ -0,0 +1,108 @@
+/**
+ * AgentDeck telemetry envelope — internal OTel-shape struct for APME ingestion.
+ *
+ * Goal: every agent's lifecycle events (Claude hooks, Claude PTY parser, OpenClaw/
+ * OpenCode timeline, Codex OTLP, Codex PTY) emit the same `TelemetrySpan` struct.
+ * The APME collector consumes only this struct via `ingestSpan(...)`. New agents
+ * plug in by writing one adapter; collector plumbing stays untouched.
+ *
+ * **Not an external wire format.** This struct is bridge-internal. Codex CLI's
+ * real OTLP/HTTP traffic is handled separately by the Swift daemon
+ * (`apple/AgentDeck/Daemon/Modules/CodexOtelRoutes.swift`).
+ *
+ * Naming: where a sensible OpenTelemetry GenAI semantic convention exists
+ * (`gen_ai.request.model`, `gen_ai.tool.name`, etc.) we mirror it. Where it
+ * doesn't (response_kind, vibe, judge axes), we keep our `agentdeck.*` namespace.
+ * GenAI semconv is currently in "Development" status — we reference but do not
+ * pin to it. See docs/otel-standardization-study.md.
+ */
+import type { AgentType } from './adapter.js';
+/** Discriminator for what a span describes. Each kind has a contract about
+ *  which attributes are required (see `TelemetryAttributes`). */
+export type TelemetrySpanKind = 
+/** A user prompt was received → open a new turn. Carries `agentdeck.prompt_text`. */
+'turn_start'
+/** Assistant response captured → set on the active turn. Carries `agentdeck.response_text`. */
+ | 'turn_response'
+/** Explicit turn close (rare — most sources auto-close on next `turn_start`). */
+ | 'turn_end'
+/** A tool was invoked. Carries `gen_ai.tool.name`. */
+ | 'tool_call'
+/** A tool finished. May carry `gen_ai.tool.name` if available. */
+ | 'tool_result'
+/** The agent declared task boundary. Carries `agentdeck.boundary_signal`. */
+ | 'task_boundary'
+/** Model id resolved or usage snapshot updated. Carries either
+ *  `gen_ai.request.model` or `agentdeck.usage.*`. */
+ | 'session_meta'
+/** Generic step — record verbatim into `steps` table without lifecycle
+ *  side effects. Carries `agentdeck.raw_event` + `agentdeck.raw_payload`. */
+ | 'raw_step';
+/** OTel-shape attributes. Keys mirror GenAI semconv where available;
+ *  AgentDeck-specific data lives under `agentdeck.*`. All keys are optional —
+ *  consumers should defensively check for the ones their kind requires. */
+export interface TelemetryAttributes {
+    /** Model id, e.g. "claude-opus-4-7". */
+    'gen_ai.request.model'?: string;
+    /** Tool name for tool_call / tool_result. */
+    'gen_ai.tool.name'?: string;
+    /** Provider/system, e.g. "anthropic", "openai". */
+    'gen_ai.system'?: string;
+    'agentdeck.agent_type'?: AgentType;
+    'agentdeck.cwd'?: string;
+    /** User prompt text for turn_start. */
+    'agentdeck.prompt_text'?: string;
+    /** Assistant response text for turn_response. */
+    'agentdeck.response_text'?: string;
+    /** Task boundary discriminator. */
+    'agentdeck.boundary_signal'?: 'todo_complete' | 'clear' | 'session_end' | 'manual' | 'idle_gap';
+    /** Original event name for raw_step. */
+    'agentdeck.raw_event'?: string;
+    /** Original event payload for raw_step (JSON-serializable). */
+    'agentdeck.raw_payload'?: Record<string, unknown>;
+    /** Tool name as reported by the source (Claude hooks use `tool_name`). */
+    'agentdeck.tool_name'?: string;
+    'agentdeck.usage.input_tokens'?: number;
+    'agentdeck.usage.output_tokens'?: number;
+    'agentdeck.usage.cost_usd'?: number;
+    /** Open extension. Adapters may attach extra string-keyed scalars. */
+    [k: string]: string | number | boolean | Record<string, unknown> | undefined;
+}
+/** A single ingestion event. `traceId` ≈ run id (one trace per session/run);
+ *  `spanId` is a unique id per emitted event; `parentSpanId` optionally points
+ *  to the active turn. The collector currently uses the `kind`/attributes
+ *  directly; the trace/span ids are present for future OTLP export. */
+export interface TelemetrySpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    /** Human-readable span name, e.g. "agentdeck.turn", "agentdeck.tool.call". */
+    name: string;
+    kind: TelemetrySpanKind;
+    /** Wall-clock millis when the event happened. Adapters use Date.now() if
+     *  the source doesn't provide a timestamp. */
+    ts: number;
+    attributes: TelemetryAttributes;
+}
+/** Source kind passed to adapters. Mostly informational — used by the collector
+ *  for debug logs and by tests for fixture filtering. */
+export type TelemetrySource = 'claude-hook' | 'claude-pty' | 'timeline' | 'codex-pty' | 'codex-otlp';
+/** Opaque context passed to adapters. Holds the session-stable identifiers an
+ *  adapter would otherwise have to thread through every call. */
+export interface AdapterContext {
+    sessionId: string;
+    agentType: AgentType;
+    /** trace id for this session/run. Adapters should reuse this for every span
+     *  they emit during the session — the collector dispatches by sessionId so
+     *  trace_id is mostly informational, but keeping it stable lets future OTLP
+     *  exports tie spans together. */
+    traceId: string;
+    cwd?: string;
+    /** Optional: current active turn id, populated by the collector after
+     *  `turn_start` is processed. Adapters can read but should not write. */
+    activeTurnId?: string;
+}
+/** Canonical span name for a kind. Used by adapters so all spans for the same
+ *  kind share a name — makes log filtering and OTLP queries predictable. */
+export declare function spanNameForKind(kind: TelemetrySpanKind): string;
+//# sourceMappingURL=telemetry-envelope.d.ts.map

package/dist/telemetry-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-envelope.d.ts","sourceRoot":"","sources":["../src/telemetry-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;iEACiE;AACjE,MAAM,MAAM,iBAAiB;AAC3B,qFAAqF;AACnF,YAAY;AACd,+FAA+F;GAC7F,eAAe;AACjB,iFAAiF;GAC/E,UAAU;AACZ,sDAAsD;GACpD,WAAW;AACb,kEAAkE;GAChE,aAAa;AACf,6EAA6E;GAC3E,eAAe;AACjB;qDACqD;GACnD,cAAc;AAChB;6EAC6E;GAC3E,UAAU,CAAC;AAEf;;2EAE2E;AAC3E,MAAM,WAAW,mBAAmB;IAElC,wCAAwC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,sBAAsB,CAAC,EAAE,SAAS,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mCAAmC;IACnC,2BAA2B,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;IAChG,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,sEAAsE;IACtE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;uEAGuE;AACvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB;kDAC8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAID;yDACyD;AACzD,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,WAAW,GACX,YAAY,CAAC;AAEjB;iEACiE;AACjE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB;;;sCAGkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;6EACyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAW/D"}

package/dist/telemetry-envelope.js

@@ -0,0 +1,34 @@
+/**
+ * AgentDeck telemetry envelope — internal OTel-shape struct for APME ingestion.
+ *
+ * Goal: every agent's lifecycle events (Claude hooks, Claude PTY parser, OpenClaw/
+ * OpenCode timeline, Codex OTLP, Codex PTY) emit the same `TelemetrySpan` struct.
+ * The APME collector consumes only this struct via `ingestSpan(...)`. New agents
+ * plug in by writing one adapter; collector plumbing stays untouched.
+ *
+ * **Not an external wire format.** This struct is bridge-internal. Codex CLI's
+ * real OTLP/HTTP traffic is handled separately by the Swift daemon
+ * (`apple/AgentDeck/Daemon/Modules/CodexOtelRoutes.swift`).
+ *
+ * Naming: where a sensible OpenTelemetry GenAI semantic convention exists
+ * (`gen_ai.request.model`, `gen_ai.tool.name`, etc.) we mirror it. Where it
+ * doesn't (response_kind, vibe, judge axes), we keep our `agentdeck.*` namespace.
+ * GenAI semconv is currently in "Development" status — we reference but do not
+ * pin to it. See docs/otel-standardization-study.md.
+ */
+// ─── Naming helpers ──────────────────────────────────────────────────────────
+/** Canonical span name for a kind. Used by adapters so all spans for the same
+ *  kind share a name — makes log filtering and OTLP queries predictable. */
+export function spanNameForKind(kind) {
+    switch (kind) {
+        case 'turn_start': return 'agentdeck.turn.start';
+        case 'turn_response': return 'agentdeck.turn.response';
+        case 'turn_end': return 'agentdeck.turn.end';
+        case 'tool_call': return 'agentdeck.tool.call';
+        case 'tool_result': return 'agentdeck.tool.result';
+        case 'task_boundary': return 'agentdeck.task.boundary';
+        case 'session_meta': return 'agentdeck.session.meta';
+        case 'raw_step': return 'agentdeck.step.raw';
+    }
+}
+//# sourceMappingURL=telemetry-envelope.js.map

package/dist/telemetry-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-envelope.js","sourceRoot":"","sources":["../src/telemetry-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA2GH,gFAAgF;AAEhF;4EAC4E;AAC5E,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC,CAAI,OAAO,sBAAsB,CAAC;QACpD,KAAK,eAAe,CAAC,CAAC,OAAO,yBAAyB,CAAC;QACvD,KAAK,UAAU,CAAC,CAAM,OAAO,oBAAoB,CAAC;QAClD,KAAK,WAAW,CAAC,CAAK,OAAO,qBAAqB,CAAC;QACnD,KAAK,aAAa,CAAC,CAAG,OAAO,uBAAuB,CAAC;QACrD,KAAK,eAAe,CAAC,CAAC,OAAO,yBAAyB,CAAC;QACvD,KAAK,cAAc,CAAC,CAAE,OAAO,wBAAwB,CAAC;QACtD,KAAK,UAAU,CAAC,CAAM,OAAO,oBAAoB,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/timeline-icons.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared icon-key system for timeline entries.
+ *
+ * Each platform maps the abstract key to its native form:
+ *   - Apple: SF Symbols (`checkmark.circle.fill`, etc.)
+ *   - Android tablet: Material Icons (`Icons.Filled.CheckCircle`)
+ *   - Android e-ink: ASCII bracket markers (`[OK]`, `[T ]`) — high black coverage,
+ *     no thin glyph strokes that ghost on partial refresh.
+ *
+ * This is the single source of truth. If you add a new key, add the platform
+ * mapping in the same commit (apple TimelineStripView.swift,
+ * android TimelineStrip.kt + EinkTimelinePanel.kt).
+ */
+import type { TimelineEntry, TimelineEntryType } from './timeline.js';
+export type TimelineIconKey = 'success' | 'error' | 'running' | 'awaiting' | 'tool' | 'model' | 'user' | 'task' | 'scheduled' | 'memory';
+/**
+ * Map a timeline entry to its semantic icon key.
+ * Looks at both the entry type and (for tool_request) the approval status.
+ */
+export declare function timelineIconKey(entry: Pick<TimelineEntry, 'type' | 'status'>): TimelineIconKey;
+/** All known icon keys, in stable order (used for tests/registries). */
+export declare const TIMELINE_ICON_KEYS: readonly TimelineIconKey[];
+/**
+ * True when `entry` is a `task_start` whose matching `task_end` (same `taskId`)
+ * has not yet appeared among `siblings`. Lets clients render in-flight task
+ * hierarchy markers with the rotating "running" treatment instead of the
+ * static `task` icon. Mirrored in Apple `isInFlightTask` and Android
+ * `isInFlightTask`.
+ */
+export declare function isInFlightTask(entry: Pick<TimelineEntry, 'type' | 'taskId'>, siblings: ReadonlyArray<Pick<TimelineEntry, 'type' | 'taskId'>>): boolean;
+/**
+ * Age cap for the rotating "running" treatment on turn rows. Turn-completion
+ * signals are best-effort (Stop hook, transcript tail, PTY marker) and can be
+ * lost across daemon handoffs — a chat_start older than this stops spinning
+ * even without an explicit completion so dead turns don't animate forever.
+ * Matches Apple's `chatStartMaxAgeSec` (TimelineStripView.swift). Task
+ * hierarchy markers are handled by the daemon-side orphan reaper plus Apple's
+ * own in-flight cap.
+ */
+export declare const ROTATING_ENTRY_MAX_AGE_MS: number;
+type RotatingSibling = Pick<TimelineEntry, 'type' | 'taskId'> & Partial<Pick<TimelineEntry, 'sessionId' | 'ts'>>;
+/**
+ * True when a turn row should rotate its leading icon. Combines the static
+ * `running` icon-key (chat_start, unknown types) with the in-flight
+ * task-hierarchy signal so an open `task_start` also spins until its
+ * `task_end` arrives. `siblings` should be the entries the row sees in its
+ * group/list — passing `[]` falls back to icon-key only.
+ *
+ * A chat_start only spins while its turn is plausibly still open:
+ *   - no later same-session completion (chat_response / chat_end / model_response),
+ *   - no later same-session chat_start (a new prompt supersedes the turn even
+ *     when its completion signal was lost — Stop hooks are best-effort),
+ *   - younger than ROTATING_ENTRY_MAX_AGE_MS.
+ * Mirrored in Apple TimelineStripView.swift and Android TimelineIcons.kt —
+ * update all three in the same commit.
+ */
+export declare function isRotatingEntry(entry: Pick<TimelineEntry, 'type' | 'status' | 'taskId'> & Partial<Pick<TimelineEntry, 'sessionId' | 'ts'>>, siblings: ReadonlyArray<RotatingSibling>, nowMs?: number): boolean;
+/**
+ * E-ink ASCII glyphs — bracket-padded so total width is constant (4 chars)
+ * for column alignment on monospace bitmap fonts.
+ */
+export declare const EINK_ICON_GLYPHS: Record<TimelineIconKey, string>;
+/**
+ * Whether a timeline entry type carries a content body worth showing in the
+ * detail pane. task_start/task_end/task_milestone are hierarchy markers —
+ * their `raw` is the summary, no extra detail expected.
+ */
+export declare function entryHasDetailBody(type: TimelineEntryType): boolean;
+export {};
+//# sourceMappingURL=timeline-icons.d.ts.map

package/dist/timeline-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-icons.d.ts","sourceRoot":"","sources":["../src/timeline-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,QAAQ,CAAC;AAEb;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,eAAe,CAoC9F;AAED,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAI/C,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,EAC7C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,GAC9D,OAAO,CAOT;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,KAAK,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;AASnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,EAClD,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAiBT;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAW5D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEnE"}

package/dist/timeline-icons.js

@@ -0,0 +1,161 @@
+/**
+ * Shared icon-key system for timeline entries.
+ *
+ * Each platform maps the abstract key to its native form:
+ *   - Apple: SF Symbols (`checkmark.circle.fill`, etc.)
+ *   - Android tablet: Material Icons (`Icons.Filled.CheckCircle`)
+ *   - Android e-ink: ASCII bracket markers (`[OK]`, `[T ]`) — high black coverage,
+ *     no thin glyph strokes that ghost on partial refresh.
+ *
+ * This is the single source of truth. If you add a new key, add the platform
+ * mapping in the same commit (apple TimelineStripView.swift,
+ * android TimelineStrip.kt + EinkTimelinePanel.kt).
+ */
+/**
+ * Map a timeline entry to its semantic icon key.
+ * Looks at both the entry type and (for tool_request) the approval status.
+ */
+export function timelineIconKey(entry) {
+    switch (entry.type) {
+        case 'task_start':
+        case 'task_end':
+            return 'task';
+        case 'task_milestone':
+            return 'success';
+        case 'chat_start':
+            return 'running';
+        case 'chat_end':
+        case 'chat_response':
+        case 'model_response':
+            return 'success';
+        case 'model_call':
+            return 'model';
+        case 'tool_request':
+            if (entry.status === 'approved')
+                return 'success';
+            if (entry.status === 'denied')
+                return 'error';
+            return 'awaiting';
+        case 'tool_resolved':
+            return 'success';
+        case 'tool_exec':
+            return 'tool';
+        case 'error':
+            return 'error';
+        case 'user_action':
+            return 'user';
+        case 'scheduled':
+            return 'scheduled';
+        case 'memory_recall':
+            return 'memory';
+        case 'eval_result':
+            return entry.status === 'denied' ? 'error' : 'success';
+        default:
+            return 'running';
+    }
+}
+/** All known icon keys, in stable order (used for tests/registries). */
+export const TIMELINE_ICON_KEYS = [
+    'success', 'error', 'running', 'awaiting',
+    'tool', 'model', 'user', 'task',
+    'scheduled', 'memory',
+];
+/**
+ * True when `entry` is a `task_start` whose matching `task_end` (same `taskId`)
+ * has not yet appeared among `siblings`. Lets clients render in-flight task
+ * hierarchy markers with the rotating "running" treatment instead of the
+ * static `task` icon. Mirrored in Apple `isInFlightTask` and Android
+ * `isInFlightTask`.
+ */
+export function isInFlightTask(entry, siblings) {
+    if (entry.type !== 'task_start')
+        return false;
+    if (!entry.taskId)
+        return false;
+    for (const s of siblings) {
+        if (s.type === 'task_end' && s.taskId === entry.taskId)
+            return false;
+    }
+    return true;
+}
+/**
+ * Age cap for the rotating "running" treatment on turn rows. Turn-completion
+ * signals are best-effort (Stop hook, transcript tail, PTY marker) and can be
+ * lost across daemon handoffs — a chat_start older than this stops spinning
+ * even without an explicit completion so dead turns don't animate forever.
+ * Matches Apple's `chatStartMaxAgeSec` (TimelineStripView.swift). Task
+ * hierarchy markers are handled by the daemon-side orphan reaper plus Apple's
+ * own in-flight cap.
+ */
+export const ROTATING_ENTRY_MAX_AGE_MS = 10 * 60 * 1000;
+/** Same-session test mirroring the turn-merge rule: both ids equal, or both
+ *  absent (legacy single-session emitters). */
+function sameRotatingSession(a, b) {
+    if (!a && !b)
+        return true;
+    return !!a && !!b && a === b;
+}
+/**
+ * True when a turn row should rotate its leading icon. Combines the static
+ * `running` icon-key (chat_start, unknown types) with the in-flight
+ * task-hierarchy signal so an open `task_start` also spins until its
+ * `task_end` arrives. `siblings` should be the entries the row sees in its
+ * group/list — passing `[]` falls back to icon-key only.
+ *
+ * A chat_start only spins while its turn is plausibly still open:
+ *   - no later same-session completion (chat_response / chat_end / model_response),
+ *   - no later same-session chat_start (a new prompt supersedes the turn even
+ *     when its completion signal was lost — Stop hooks are best-effort),
+ *   - younger than ROTATING_ENTRY_MAX_AGE_MS.
+ * Mirrored in Apple TimelineStripView.swift and Android TimelineIcons.kt —
+ * update all three in the same commit.
+ */
+export function isRotatingEntry(entry, siblings, nowMs) {
+    if (timelineIconKey(entry) === 'running') {
+        if (entry.type !== 'chat_start')
+            return true;
+        const ts = entry.ts;
+        if (ts != null) {
+            const now = nowMs ?? Date.now();
+            if (now - ts > ROTATING_ENTRY_MAX_AGE_MS)
+                return false;
+            for (const s of siblings) {
+                if (s.ts == null || s.ts < ts)
+                    continue;
+                if (!sameRotatingSession(entry.sessionId, s.sessionId))
+                    continue;
+                if (s.type === 'chat_response' || s.type === 'chat_end' || s.type === 'model_response')
+                    return false;
+                if (s.type === 'chat_start' && s.ts > ts)
+                    return false;
+            }
+        }
+        return true;
+    }
+    return isInFlightTask(entry, siblings);
+}
+/**
+ * E-ink ASCII glyphs — bracket-padded so total width is constant (4 chars)
+ * for column alignment on monospace bitmap fonts.
+ */
+export const EINK_ICON_GLYPHS = {
+    success: '[OK]',
+    error: '[!!]',
+    running: '[..]',
+    awaiting: '[??]',
+    tool: '[T ]',
+    model: '[M ]',
+    user: '[U ]',
+    task: '[==]',
+    scheduled: '[S ]',
+    memory: '[~ ]',
+};
+/**
+ * Whether a timeline entry type carries a content body worth showing in the
+ * detail pane. task_start/task_end/task_milestone are hierarchy markers —
+ * their `raw` is the summary, no extra detail expected.
+ */
+export function entryHasDetailBody(type) {
+    return type !== 'task_start' && type !== 'task_end' && type !== 'task_milestone';
+}
+//# sourceMappingURL=timeline-icons.js.map

package/dist/timeline-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-icons.js","sourceRoot":"","sources":["../src/timeline-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAA6C;IAC3E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,KAAK,gBAAgB;YACnB,OAAO,SAAS,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU,CAAC;QAChB,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB;YACnB,OAAO,SAAS,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,OAAO,CAAC;QACjB,KAAK,cAAc;YACjB,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YAClD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC;YAC9C,OAAO,UAAU,CAAC;QACpB,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,MAAM,CAAC;QAChB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC5D,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU;IACzC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAC/B,WAAW,EAAE,QAAQ;CACb,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA6C,EAC7C,QAA+D;IAE/D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAKxD;+CAC+C;AAC/C,SAAS,mBAAmB,CAAC,CAAU,EAAE,CAAU;IACjD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,KACkD,EAClD,QAAwC,EACxC,KAAc;IAEd,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QAC7C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,GAAG,GAAG,EAAE,GAAG,yBAAyB;gBAAE,OAAO,KAAK,CAAC;YACvD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE;oBAAE,SAAS;gBACxC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;oBAAE,SAAS;gBACjE,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;oBAAE,OAAO,KAAK,CAAC;gBACrG,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE;oBAAE,OAAO,KAAK,CAAC;YACzD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoC;IAC/D,OAAO,EAAI,MAAM;IACjB,KAAK,EAAM,MAAM;IACjB,OAAO,EAAI,MAAM;IACjB,QAAQ,EAAG,MAAM;IACjB,IAAI,EAAO,MAAM;IACjB,KAAK,EAAM,MAAM;IACjB,IAAI,EAAO,MAAM;IACjB,IAAI,EAAO,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,MAAM,EAAK,MAAM;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,gBAAgB,CAAC;AACnF,CAAC"}

package/dist/timeline-label.d.ts

@@ -0,0 +1,38 @@
+import type { TimelineEntry } from './timeline.js';
+/** Canonical agent → display-name map. The ONLY place this mapping lives on
+ *  the TS side; language mirrors copy it verbatim. Never abbreviate
+ *  "OpenClaw" (see memory `brand-direction.md`). */
+export declare function agentDisplayLabel(agentType: string | undefined | null): string;
+/** Compact agent → display-name for very tight surfaces (LED matrix, ticker
+ *  when width is scarce). Keeps the brand distinct without the CLI/App suffix. */
+export declare function agentShortLabel(agentType: string | undefined | null): string;
+export interface TimelineRowAttribution {
+    /** Resolved agent display name, or undefined when no agent is attributed. */
+    agent?: string;
+    /** Project / worktree name. */
+    project?: string;
+    /** Task label — the APME task summary when present, else the task row's
+     *  own label; undefined for rows outside a task. */
+    task?: string;
+    /** The already-summarized row body (`entry.raw`). */
+    text: string;
+}
+/** Decompose a TimelineEntry into its attributed pieces. Every surface builds
+ *  its displayed row from this, so agent/project/task/text stay consistent. */
+export declare function timelineRowAttribution(entry: TimelineEntry): TimelineRowAttribution;
+export interface FormatTimelineRowOptions {
+    /** Which attribution parts to prepend before the text, in order. Defaults
+     *  to agent + project (the common glance form). */
+    parts?: Array<'agent' | 'project' | 'task'>;
+    /** Include the row body text after the attribution. Default true. */
+    includeText?: boolean;
+    /** Use the compact agent name (ticker/matrix). Default false. */
+    short?: boolean;
+    /** Separator between attribution parts. Default " · ". */
+    separator?: string;
+}
+/** Canonical joined label. Replaces the divergent "[project] Agent" vs
+ *  "project · tag" conventions with one separator (" · ") and an explicit,
+ *  caller-chosen part order. Example: "Claude · AgentDeck · Fix eink ticker". */
+export declare function formatTimelineRowLabel(entry: TimelineEntry, opts?: FormatTimelineRowOptions): string;
+//# sourceMappingURL=timeline-label.d.ts.map

package/dist/timeline-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-label.d.ts","sourceRoot":"","sources":["../src/timeline-label.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;oDAEoD;AACpD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkB9E;AAED;kFACkF;AAClF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAM5E;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;wDACoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAeD;+EAC+E;AAC/E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,sBAAsB,CAWnF;AAED,MAAM,WAAW,wBAAwB;IACvC;uDACmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IAC5C,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iFAEiF;AACjF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,wBAA6B,GAClC,MAAM,CAYR"}