@guuey/chat 0.4.0

package/dist/types.d.ts

@@ -0,0 +1,283 @@
+/**
+ * The headless view-model's public types (wave-3a design §7, guuey#135).
+ *
+ * Everything here is DATA — no clocks, no DOM, no React. `planTranscript`
+ * (see `plan.ts`) is a pure function of these inputs; the renderers (React in
+ * 3b, RN in 3c) are thin walks of its output.
+ *
+ * Category vocabulary is ADOPTED from AgJSON (`@silverprotocol/core` owns
+ * it — the spec's "adopt, never invent" invariant): the matrix rows R0–R15
+ * map onto the fold's real block types plus `invokeTurn`'s turn-level
+ * events. A category this UI needs but AgJSON cannot express is an upstream
+ * silverprotocol change, never a guuey-side extension.
+ */
+import type { AgReduceResult, AgSource, JsonValue } from "@silverprotocol/core";
+import type { AgentInvokeStatus, HistoryCard } from "@guuey/agent-client";
+import type { ViewHostPhase, ViewMount, ViewMountChannel } from "@guuey/mcp-apps-host";
+/**
+ * One settled entry of the flat conversation transcript — structurally
+ * compatible with the hook's `AgentMessage`, plus the optional
+ * `clientMessageId` the R0 send-lifecycle join needs (the 3b live assembler
+ * threads it through; history entries and older callers simply omit it).
+ */
+export interface TranscriptMessage {
+    role: "user" | "assistant";
+    text: string;
+    /** Present on live-sent user turns — the `sendStates` join key (R0). */
+    clientMessageId?: string;
+}
+/**
+ * A pending/resolved consent or link ask (R10) — the turn-level
+ * `profile-consent` / `profile-link` events lifted into renderable state.
+ * The assembler (3b) accumulates these from `invokeTurn` events; `id` is
+ * assembler-chosen and stable for the ask's lifetime.
+ */
+export interface PromptItemInput {
+    id: string;
+    kind: "consent" | "link";
+    appId: string;
+    requested: "read" | "read-write";
+    state: "pending" | "answered" | "declined" | "dismissed";
+}
+/** Everything the plan derives from. All fields are data — no clocks, no DOM. */
+export interface TranscriptInputs {
+    /** The Reducer's fold (silver mode); null on bypass-frame streams. */
+    result: AgReduceResult | null;
+    /**
+     * The in-flight turn's cumulative text fold (ALWAYS present; the sole
+     * assistant text source in bypass mode). Ignored once `status` is back to
+     * `ready` — the settled transcript owns finished turns — EXCEPT when
+     * `aborted` is set, where it carries the kept partial (R1
+     * aborted-partial).
+     */
+    assistantText: string;
+    status: AgentInvokeStatus;
+    /** Renderer-supplied elapsed ms in the current status; drives R12 escalation. */
+    statusElapsedMs: number;
+    activeTool: string | null;
+    error: {
+        message: string;
+        code: string | null;
+    } | null;
+    /** Pending/answered consent + link asks (R10). */
+    prompts: PromptItemInput[];
+    /**
+     * The settled conversation, both roles, in order. Assistant entries are
+     * the flat-text projection; when `result` is present the FOLD owns
+     * assistant content and these entries' assistant text is not re-rendered
+     * (one unified plan owns both — spec §9 Change-1).
+     */
+    messages: TranscriptMessage[];
+    historyCards?: HistoryCard[];
+    /** R13 rehydration state; absent means loaded. */
+    historyState?: "loading" | "gone" | "loaded";
+    /** R0: optimistic-send lifecycle, keyed by clientMessageId; absent = settled. */
+    sendStates?: Readonly<Record<string, "sending" | "failed">>;
+    /** mountKey → live phase (R6 states). Keys match `ViewMountItem.key`. */
+    viewPhases?: Readonly<Record<string, ViewHostPhase>>;
+    /** The last turn ended by user abort (R1 aborted-partial + "Stopped."). */
+    aborted?: boolean;
+    /**
+     * The last turn was ADOPTED from history after a mid-stream stall
+     * (guuey#192's watchdog). Calm renders it identically to a streamed turn;
+     * debug appends the recovered marker (spec §3, F10). The hook sets this
+     * in the 3b live assembler.
+     */
+    adopted?: boolean;
+}
+/** Stable per-item identity — survives streaming updates (spec §7). */
+export type ItemKey = string;
+/** User-toggled collapse state — OWNED by the renderer, passed in (purity). */
+export type TranscriptOverrides = Readonly<Record<ItemKey, {
+    expanded?: boolean;
+}>>;
+interface BaseItem {
+    key: ItemKey;
+    /** Resolved collapse state: policy default, then `overrides[key]` wins. */
+    expanded: boolean;
+}
+/** R0 — the caller's own turn. */
+export interface UserMessageItem extends BaseItem {
+    kind: "user";
+    text: string;
+    state: "sending" | "sent" | "failed";
+    /** The failed-state affordance (policy-gated); never silently disappears. */
+    retry: boolean;
+}
+/** R1 — assistant text. */
+export interface TextItem extends BaseItem {
+    kind: "text";
+    text: string;
+    markdown: boolean;
+    streaming: boolean;
+    /** Aborted-partial: kept, marked with `strings.stopped`. */
+    stopped: boolean;
+}
+/** R2 — reasoning. */
+export interface ReasoningItem extends BaseItem {
+    kind: "reasoning";
+    label: string;
+    text: string;
+    streaming: boolean;
+}
+/** R5 — a data result, embedded inside its R3 row's expansion. */
+export interface DataResultItem extends BaseItem {
+    kind: "data-result";
+    /**
+     * A bounded pretty-printed preview — NEVER the full payload (the plan
+     * stays cheap; fixture 6). Null for binary/unrenderable content.
+     */
+    preview: string | null;
+    byteCount: number;
+    state: "small" | "giant" | "binary" | "empty";
+    showBytes: boolean;
+}
+/** R3 — one tool call lifecycle line. */
+export interface ToolItem extends BaseItem {
+    kind: "tool";
+    toolCallId: string;
+    /** The wire name. */
+    name: string;
+    /** The humanized display title (policy's humanizer). */
+    title: string;
+    state: "running" | "done" | "failed" | "orphaned";
+    /** Bounded args preview (policy-gated); null when args are hidden. */
+    argsPreview: string | null;
+    /** The result inside this row's expansion (R5); null while running. */
+    result: DataResultItem | null;
+    /**
+     * True when this call's result renders as its own transcript row (an R6
+     * view) and calm folds this line into that row's chrome as attribution
+     * instead of a standalone line (R4's display-bearing rule).
+     */
+    attribution: boolean;
+}
+/** R4 — a collapsed run of adjacent settled SILENT tools. */
+export interface ToolGroupItem extends BaseItem {
+    kind: "tool-group";
+    label: string;
+    tools: ToolItem[];
+    failureCount: number;
+    /** Non-empty when failureCount > 0 ("1 failed" — badge without unrolling). */
+    failureBadge: string | null;
+}
+/** R6 — a renderable result mounting through the wave-2 host. */
+export interface ViewMountItem extends BaseItem {
+    kind: "view";
+    /** The mount material; null when the locator is dead (R13 expired path). */
+    mount: ViewMount | null;
+    channel: ViewMountChannel | null;
+    /** Live host phase, or the R13 dead-locator state. */
+    phase: ViewHostPhase | "expired";
+    /** The channel-aware state label the renderer shows for non-connected phases. */
+    label: string | null;
+    /** Calm chrome: "via {tool}" when this mount broke an R4 group. */
+    attribution: string | null;
+    /** The producing call's humanized title (live mounts); null for history cards. */
+    toolTitle: string | null;
+    /**
+     * The persisted `ui://` locator a mounted card's runtime actions bind to
+     * (guuey#158) — the block's `uiData.resourceUri` for live mounts, the
+     * card's own persisted identity for history snapshots; never a ggui
+     * shell's synthetic payload uri. `null` → the host's relay answers its
+     * in-band "not available" stub.
+     */
+    actionScope: string | null;
+}
+/** R7 — media blocks. */
+export interface MediaItem extends BaseItem {
+    kind: "media";
+    media: "image" | "audio" | "file" | "document";
+    source: AgSource;
+    name: string | null;
+    presentation: "inline" | "chip";
+}
+/** R8 — code blocks. */
+export interface CodeItem extends BaseItem {
+    kind: "code";
+    language: string;
+    code: string;
+    wrap: boolean;
+}
+/** R9 — a citation run collapsed to a chip row. */
+export interface CitationsItem extends BaseItem {
+    kind: "citations";
+    label: string;
+    sources: {
+        title: string | null;
+        url: string | null;
+    }[];
+    style: "chips" | "list";
+}
+/** R10 — a consent/link prompt card. */
+export interface PromptItem extends BaseItem {
+    kind: "prompt";
+    /** The `PromptItemInput.id` this row records — the host's resolution key. */
+    promptId: string;
+    promptKind: "consent" | "link";
+    appId: string;
+    requested: "read" | "read-write";
+    state: "pending" | "answered" | "declined" | "dismissed";
+    /** Raw ask payload, populated only under the debug policy. */
+    raw: JsonValue | null;
+}
+/** R11 — a coded, human-worded error notice. */
+export interface ErrorItem extends BaseItem {
+    kind: "error";
+    /**
+     * The source message (wire body or client-side error copy), regardless of
+     * policy — `copy` is the calm family sentence; overrides that keep a
+     * surface's own voice (the widget renders pod messages verbatim) need the
+     * original without opting into debug's `verbatim` formatting.
+     */
+    message: string;
+    family: "auth" | "quota" | "transient" | "invalid";
+    code: string | null;
+    copy: string;
+    /** The wire message verbatim, populated only under the debug policy. */
+    verbatim: string | null;
+}
+/** R13 — history rehydration boundary states. */
+export interface HistoryBoundaryItem extends BaseItem {
+    kind: "history-boundary";
+    state: "loading" | "gone";
+    label: string;
+}
+/** R14 — the compaction divider. */
+export interface CompactionItem extends BaseItem {
+    kind: "compaction";
+    label: string;
+}
+/** R15 — the trust invariant: labeled, collapsed, never blank, never raw. */
+export interface UnknownItem extends BaseItem {
+    kind: "unknown";
+    label: string;
+    typeName: string;
+    byteSize: number;
+    /** Pretty-printed payload, populated only under the debug policy. */
+    raw: JsonValue | null;
+}
+export type DisplayItem = UserMessageItem | TextItem | ReasoningItem | ToolItem | ToolGroupItem | DataResultItem | ViewMountItem | MediaItem | CodeItem | CitationsItem | PromptItem | ErrorItem | HistoryBoundaryItem | CompactionItem | UnknownItem;
+/** R12/§4 — the derived status line with its resolved copy. */
+export interface StatusLineItem {
+    kind: "status";
+    key: "status";
+    state: "connecting" | "starting" | "long-start" | "thinking" | "using-tool" | "aborted";
+    copy: string;
+    /** Literal state + elapsed, populated only under the debug policy. */
+    detail: string | null;
+}
+export interface TranscriptPlan {
+    /** Ordered, stable keys (spec §7's determinism contract). */
+    items: DisplayItem[];
+    /** Null when there is nothing to show (`ready`, `responding`). */
+    status: StatusLineItem | null;
+    /**
+     * The #192 recovered-turn marker: the resolved marker string under the
+     * debug policy when `inputs.adopted` is set, else null — calm plans stay
+     * byte-identical to a streamed turn's (fixture 17).
+     */
+    recovery: string | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@guuey/chat",
+  "version": "0.4.0",
+  "description": "The default end-user transcript UI for guuey agents — the headless view-model (planTranscript), calm/debug presets, the GuueyChatTheme token schema, the ChatStrings i18n seam, and (at ./react) the component kit that renders it: per-category components, <Transcript>, the live + history input assemblers, and stick-to-bottom/windowed/accessible transcript behavior.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "styles.css",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "react-native": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "react-native": "./src/react.tsx",
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./styles.css": "./styles.css"
+  },
+  "dependencies": {
+    "@silverprotocol/core": "0.4.1",
+    "@silverprotocol/richtext": "0.4.1",
+    "zod": "^4.3.6",
+    "@guuey/agent-client": "0.4.0",
+    "@guuey/mcp-apps-host": "0.4.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.0.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "guuey",
+    "chat",
+    "transcript",
+    "agent",
+    "generative-ui",
+    "view-model",
+    "agjson",
+    "react"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/withguuey/guuey-sdks.git",
+    "directory": "packages/chat"
+  },
+  "bugs": {
+    "url": "https://github.com/withguuey/guuey-sdks/issues"
+  },
+  "homepage": "https://guuey.com",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/corpus/README.md

@@ -0,0 +1,40 @@
+# The fixture corpus
+
+This directory is the executable definition of "comfortably readable" — the
+acceptance bar for `@guuey/chat`'s default UI (wave-3a design §8, guuey#135).
+Every fixture is a recorded `InvokeTurnEvent[]` sequence driven through the
+real `@silverprotocol/core` `Reducer` (`drive.ts`), planned by
+`planTranscript`, and pinned by both named assertions and a full plan
+snapshot.
+
+## The standing rule
+
+**A new weird transcript found in production becomes a fixture BEFORE its
+fix lands. The corpus only grows.** Fixtures are never deleted and never
+weakened to make a change pass — a change that breaks a fixture is arguing
+with the product definition, and that argument happens in review, not in the
+fixture file.
+
+Fixture 17 (`stalled-then-adopted`) is this rule's first production entry:
+the guuey#192 widget stall, recorded the day it was diagnosed.
+
+Family 18 (`production-capture-ggui-render`, `capture.ts` +
+`capture.test.ts`) is the rule's structural upgrade, from 3b's dogfood
+finding 1: the hand-driven corpus was green while the PRODUCTION fold
+shape (tool results in `role: "tool"` messages) rendered blank cards. At
+least one family is therefore derived from a real redacted production
+capture, replayed through the REAL `invokeTurn` with adversarial
+chunking — hand-driven sequences can no longer be the corpus's only
+witness.
+
+## Layers
+
+- `drive.ts` — test-only assembler: events → `TranscriptInputs`, applying
+  the hook's documented accumulation rules. The 3b live/history assemblers
+  are its production twins.
+- `fixtures.ts` — the 17 named fixtures, spec §8 order.
+- `capture.ts` / `captures/` — family 18: production-capture replay
+  through the real `invokeTurn` (provenance in the module header).
+- `corpus.test.ts` — the runner: per-fixture assertions + snapshots, plain
+  Node (mirror-CI-safe). The browser render of the SAME corpus is 3b's
+  Storybook/screenshot leg.