@guuey/chat 0.4.0

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,2BAA2B,EAC3B,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/react.js

@@ -0,0 +1,20 @@
+/**
+ * React entry point (`@guuey/chat/react`) — the component kit over the
+ * root subpath's headless view-model (wave 3b, guuey#135).
+ *
+ * The root subpath stays React-free forever; everything React-coupled —
+ * the per-category components, `<Transcript>`, the renderer-state owner
+ * (`useTranscript`), and the live input assembler (`useTranscriptInputs`)
+ * — lives behind this arm, with `react` as an optional peer (the
+ * mcp-apps-host precedent).
+ *
+ * Composition ladder (spec §1 "configurable"): use `<Transcript>` with the
+ * default kit as-is → override per-category components → tune policy knobs
+ * → drop to `planTranscript` + `attachViewHost` and render it all yourself.
+ */
+export { Transcript, } from "./react/transcript.js";
+export { defaultTranscriptComponents, renderItem, DefaultUserMessage, DefaultText, DefaultReasoning, DefaultTool, DefaultToolGroup, DefaultDataResult, DefaultView, DefaultMedia, DefaultCode, DefaultCitations, DefaultPrompt, DefaultError, DefaultHistoryBoundary, DefaultCompaction, DefaultUnknown, DefaultStatus, } from "./react/components.js";
+export { useTranscript, useTranscriptInputs, } from "./react/use-transcript.js";
+export { GuueyChat } from "./react/guuey-chat.js";
+export { Markdown } from "./react/markdown.js";
+export { themeCssVars } from "./react/theme-css.js";

package/dist/strings.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The ONE place every user-facing string lives — the i18n seam (spec §4.2).
+ *
+ * Builders override any string (or all of them, for a locale) through
+ * `TranscriptPolicy.strings` without forking components; nothing else in the
+ * package carries literal copy. Parameterized strings are functions so word
+ * order stays translatable ("Ran 4 tools" vs "4 Werkzeuge ausgeführt").
+ *
+ * The en defaults below are the founder-review copy from the wave-3a design
+ * (§4.2 + per-row labels; guuey#135 — F7 keeps them wordsmith-able until 3b
+ * freezes the voice).
+ */
+export interface ChatStrings {
+    /** R12 escalation ladder (spec §4.2). */
+    connecting: string;
+    starting: string;
+    longStart: string;
+    thinking: string;
+    usingTool: (toolTitle: string) => string;
+    /** R1 aborted-partial marker + §4.2 aborted line. */
+    stopped: string;
+    /** R11 family copy — each is a PREFIX slot for the builder's own wording. */
+    errorAuth: string;
+    errorQuota: string;
+    errorTransient: string;
+    errorInvalid: string;
+    /** R3/R4. */
+    toolGroup: (count: number) => string;
+    toolGroupFailures: (count: number) => string;
+    toolDidntFinish: string;
+    /** R4 calm attribution chrome on a display-bearing call ("via {tool}"). */
+    viaTool: (toolTitle: string) => string;
+    /** R2. */
+    reasoningLabel: string;
+    /** R9. */
+    citations: (count: number) => string;
+    /** R15 — the trust invariant's label. */
+    unknownLabel: string;
+    /** R14. */
+    compaction: string;
+    /** R0. */
+    userCouldntSend: string;
+    userRetry: string;
+    /** R6 states. */
+    viewNegotiating: string;
+    viewBootFailure: string;
+    viewInlineFallback: string;
+    viewExpired: string;
+    viewSandboxUnavailable: string;
+    /** #192 debug-preset marker (calm never shows it — spec §3, F10). */
+    recoveredFromHistory: string;
+    /** R5 empty result. */
+    noOutput: string;
+    /** R5/R15 byte-count note. */
+    bytes: (byteCount: number) => string;
+    /** R13 states. */
+    historyLoading: string;
+    threadGone: string;
+    /** Renderer chrome (spec §3.2 — the 3b kit's own affordances). */
+    jumpToLatest: string;
+    showEarlier: (count: number) => string;
+    copy: string;
+    copied: string;
+    /** The 3c composer (`<GuueyChat>`). */
+    composerPlaceholder: string;
+    composerUnavailable: string;
+    composerLabel: string;
+    send: string;
+    stop: string;
+}
+/** Humanize a wire tool name: `render_weather-card` → `render weather card`. */
+export declare function humanizeToolName(wireName: string): string;
+export declare const defaultChatStrings: ChatStrings;
+//# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAEhB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,aAAa;IACb,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAEvC,UAAU;IACV,cAAc,EAAE,MAAM,CAAC;IAEvB,UAAU;IACV,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAErC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU;IACV,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;IAE/B,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,CAAC;IAE7B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAErC,kBAAkB;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,eAAO,MAAM,kBAAkB,EAAE,WAsDhC,CAAC"}

package/dist/strings.js

@@ -0,0 +1,45 @@
+/** Humanize a wire tool name: `render_weather-card` → `render weather card`. */
+export function humanizeToolName(wireName) {
+    return wireName.replace(/[_-]+/g, " ").trim();
+}
+export const defaultChatStrings = {
+    connecting: "Connecting…",
+    starting: "Starting your agent…",
+    longStart: "Starting your agent… first load can take a minute",
+    thinking: "Thinking…",
+    usingTool: (toolTitle) => `Using ${toolTitle}…`,
+    stopped: "Stopped.",
+    errorAuth: "Sign in to continue.",
+    errorQuota: "This agent is over its usage limit.",
+    errorTransient: "Something went wrong on our side — try again.",
+    errorInvalid: "The app sent a request the agent couldn't read.",
+    toolGroup: (count) => `Ran ${count} tools`,
+    toolGroupFailures: (count) => (count === 1 ? "1 failed" : `${count} failed`),
+    toolDidntFinish: "didn't finish",
+    viaTool: (toolTitle) => `via ${toolTitle}`,
+    reasoningLabel: "Thought for a moment",
+    citations: (count) => (count === 1 ? "1 source" : `${count} sources`),
+    unknownLabel: "Unrecognized content",
+    compaction: "Earlier conversation summarized",
+    userCouldntSend: "Couldn't send",
+    userRetry: "Retry",
+    viewNegotiating: "Loading view…",
+    viewBootFailure: "This view couldn't start",
+    viewInlineFallback: "Showing plain content",
+    viewExpired: "This view expired",
+    viewSandboxUnavailable: "Interactive view unavailable",
+    recoveredFromHistory: "recovered from history",
+    noOutput: "no output",
+    bytes: (byteCount) => byteCount >= 1024 ? `${Math.round(byteCount / 1024)} KB` : `${byteCount} B`,
+    historyLoading: "Loading conversation…",
+    threadGone: "This conversation is no longer available.",
+    jumpToLatest: "Jump to latest",
+    showEarlier: (count) => `Show ${count} earlier`,
+    copy: "Copy",
+    copied: "Copied",
+    composerPlaceholder: "Message the agent…",
+    composerUnavailable: "Chat is unavailable.",
+    composerLabel: "Message",
+    send: "Send",
+    stop: "Stop",
+};

package/dist/theme.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Theme = platform data (wave-3a design §6, founder-ratified).
+ *
+ * ONE serializable token schema, four consumers: this package's default
+ * theme, the per-app theme configured on platform.guuey.com (console editor
+ * + app-record field + runtime delivery — a platform-lane slice sharing this
+ * schema), the widget (defaults to the app's configured theme), and portal
+ * (defaults to the GUUEY theme, per-app override).
+ *
+ * EVOLUTION RULE (spec §6): this schema becomes PERSISTED platform data —
+ * changes are additive-only, parsing is LENIENT (unknown keys pass through,
+ * never rejected), and every new token ships with a default-theme fallback.
+ * A stored theme from any earlier schema version must always parse:
+ * `resolveTheme` merges per-token over the default, so a half-configured (or
+ * old-schema) app theme can never produce an unreadable surface.
+ *
+ * The React kit (3b) projects these as `--guuey-chat-*` CSS custom
+ * properties; RN (3c) maps the same object to style values — the schema is
+ * the cross-platform contract, CSS is one projection.
+ */
+import { z } from "zod";
+/**
+ * One mode's palette — grounded in the widget's shipped `--guuey-*`
+ * custom-property precedent (`apps/widget/src/app/globals.css`).
+ */
+export declare const GuueyChatPalette: z.ZodObject<{
+    accent: z.ZodString;
+    onAccent: z.ZodString;
+    ink: z.ZodString;
+    inkMuted: z.ZodString;
+    surface: z.ZodString;
+    canvas: z.ZodString;
+    canvasMuted: z.ZodString;
+    error: z.ZodString;
+}, z.core.$loose>;
+export type GuueyChatPalette = z.infer<typeof GuueyChatPalette>;
+export declare const GuueyChatTheme: z.ZodObject<{
+    name: z.ZodString;
+    colors: z.ZodObject<{
+        light: z.ZodObject<{
+            accent: z.ZodString;
+            onAccent: z.ZodString;
+            ink: z.ZodString;
+            inkMuted: z.ZodString;
+            surface: z.ZodString;
+            canvas: z.ZodString;
+            canvasMuted: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>;
+        dark: z.ZodObject<{
+            accent: z.ZodString;
+            onAccent: z.ZodString;
+            ink: z.ZodString;
+            inkMuted: z.ZodString;
+            surface: z.ZodString;
+            canvas: z.ZodString;
+            canvasMuted: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    typography: z.ZodObject<{
+        fontFamily: z.ZodOptional<z.ZodString>;
+        monoFontFamily: z.ZodOptional<z.ZodString>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>;
+    shape: z.ZodObject<{
+        radius: z.ZodEnum<{
+            none: "none";
+            soft: "soft";
+            round: "round";
+        }>;
+        density: z.ZodEnum<{
+            compact: "compact";
+            comfortable: "comfortable";
+        }>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export type GuueyChatTheme = z.infer<typeof GuueyChatTheme>;
+/**
+ * The brand-neutral-but-polished package default — the theme a builder gets
+ * before configuring anything, and the per-token fallback floor every other
+ * theme resolves against.
+ */
+export declare const DEFAULT_CHAT_THEME: GuueyChatTheme;
+/**
+ * The guuey visual identity — portal's default, and the look an app
+ * "unleashes" its own theme against. Values are the widget's shipped
+ * slime/ink/fog tokens verbatim; the saturated accents deliberately do not
+ * change between modes (they read the same on any canvas — the widget's own
+ * documented posture).
+ */
+export declare const GUUEY_CHAT_THEME: GuueyChatTheme;
+/**
+ * Resolve a stored (possibly partial, possibly old-schema, possibly not even
+ * object-shaped) theme against a base — per-token fallback, lenient parse.
+ * NEVER throws: unparseable input resolves to the base theme untouched.
+ */
+export declare function resolveTheme(candidate: unknown, base?: GuueyChatTheme): GuueyChatTheme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;iBAWnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cA0BhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA0B9B,CAAC;AA0CF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,IAAI,GAAE,cAAmC,GACxC,cAAc,CAgBhB"}

package/dist/theme.js

@@ -0,0 +1,182 @@
+/**
+ * Theme = platform data (wave-3a design §6, founder-ratified).
+ *
+ * ONE serializable token schema, four consumers: this package's default
+ * theme, the per-app theme configured on platform.guuey.com (console editor
+ * + app-record field + runtime delivery — a platform-lane slice sharing this
+ * schema), the widget (defaults to the app's configured theme), and portal
+ * (defaults to the GUUEY theme, per-app override).
+ *
+ * EVOLUTION RULE (spec §6): this schema becomes PERSISTED platform data —
+ * changes are additive-only, parsing is LENIENT (unknown keys pass through,
+ * never rejected), and every new token ships with a default-theme fallback.
+ * A stored theme from any earlier schema version must always parse:
+ * `resolveTheme` merges per-token over the default, so a half-configured (or
+ * old-schema) app theme can never produce an unreadable surface.
+ *
+ * The React kit (3b) projects these as `--guuey-chat-*` CSS custom
+ * properties; RN (3c) maps the same object to style values — the schema is
+ * the cross-platform contract, CSS is one projection.
+ */
+import { z } from "zod";
+/**
+ * One mode's palette — grounded in the widget's shipped `--guuey-*`
+ * custom-property precedent (`apps/widget/src/app/globals.css`).
+ */
+export const GuueyChatPalette = z
+    .object({
+    accent: z.string(),
+    onAccent: z.string(),
+    ink: z.string(),
+    inkMuted: z.string(),
+    surface: z.string(),
+    canvas: z.string(),
+    canvasMuted: z.string(),
+    error: z.string(),
+})
+    .loose();
+export const GuueyChatTheme = z
+    .object({
+    name: z.string(),
+    /** BOTH palettes always present — mode is the consumer's runtime choice. */
+    colors: z.object({ light: GuueyChatPalette, dark: GuueyChatPalette }).loose(),
+    typography: z
+        .object({
+        fontFamily: z.string().optional(),
+        monoFontFamily: z.string().optional(),
+        scale: z.number().optional(),
+    })
+        .loose(),
+    shape: z
+        .object({
+        radius: z.enum(["none", "soft", "round"]),
+        density: z.enum(["compact", "comfortable"]),
+    })
+        .loose(),
+})
+    .loose();
+/**
+ * The brand-neutral-but-polished package default — the theme a builder gets
+ * before configuring anything, and the per-token fallback floor every other
+ * theme resolves against.
+ */
+export const DEFAULT_CHAT_THEME = {
+    name: "default",
+    colors: {
+        light: {
+            accent: "#2f6bff",
+            onAccent: "#ffffff",
+            ink: "#111318",
+            inkMuted: "#5b6270",
+            surface: "#ffffff",
+            canvas: "#f7f7f5",
+            canvasMuted: "#eceded",
+            error: "#d64545",
+        },
+        dark: {
+            accent: "#5c8dff",
+            onAccent: "#0b0d12",
+            ink: "#e8e9ee",
+            inkMuted: "#9aa0ac",
+            surface: "#1b1e26",
+            canvas: "#0f1116",
+            canvasMuted: "#1b1e26",
+            error: "#ff6b6b",
+        },
+    },
+    typography: {},
+    shape: { radius: "soft", density: "comfortable" },
+};
+/**
+ * The guuey visual identity — portal's default, and the look an app
+ * "unleashes" its own theme against. Values are the widget's shipped
+ * slime/ink/fog tokens verbatim; the saturated accents deliberately do not
+ * change between modes (they read the same on any canvas — the widget's own
+ * documented posture).
+ */
+export const GUUEY_CHAT_THEME = {
+    name: "guuey",
+    colors: {
+        light: {
+            accent: "#b8ff3a",
+            onAccent: "#0e1014",
+            ink: "#0e1014",
+            inkMuted: "#1a1d24",
+            surface: "#ffffff",
+            canvas: "#f6f5ee",
+            canvasMuted: "#ecebe0",
+            error: "#ff5b5b",
+        },
+        dark: {
+            accent: "#b8ff3a",
+            onAccent: "#0e1014",
+            ink: "#e7e8ec",
+            inkMuted: "#9aa0ac",
+            surface: "#1a1d24",
+            canvas: "#0e1014",
+            canvasMuted: "#1a1d24",
+            error: "#ff5b5b",
+        },
+    },
+    typography: {},
+    shape: { radius: "soft", density: "comfortable" },
+};
+/** The candidate shape `resolveTheme` accepts: anything partial, unknown, or stale. */
+const PartialPalette = GuueyChatPalette.partial();
+const PartialTheme = z
+    .object({
+    name: z.string().optional(),
+    colors: z
+        .object({ light: PartialPalette.optional(), dark: PartialPalette.optional() })
+        .loose()
+        .optional(),
+    typography: GuueyChatTheme.shape.typography.optional(),
+    shape: GuueyChatTheme.shape.shape.partial().loose().optional(),
+})
+    .loose();
+/** The known token set — the per-token fallback iterates THIS, so unknown
+ * (future-schema) keys are preserved by the parse but never projected. */
+const PALETTE_TOKENS = [
+    "accent",
+    "onAccent",
+    "ink",
+    "inkMuted",
+    "surface",
+    "canvas",
+    "canvasMuted",
+    "error",
+];
+function mergePalette(base, over) {
+    if (!over)
+        return { ...base };
+    const merged = { ...base };
+    for (const token of PALETTE_TOKENS) {
+        const value = over[token];
+        if (typeof value === "string")
+            merged[token] = value;
+    }
+    return merged;
+}
+/**
+ * Resolve a stored (possibly partial, possibly old-schema, possibly not even
+ * object-shaped) theme against a base — per-token fallback, lenient parse.
+ * NEVER throws: unparseable input resolves to the base theme untouched.
+ */
+export function resolveTheme(candidate, base = DEFAULT_CHAT_THEME) {
+    const parsed = PartialTheme.safeParse(candidate);
+    if (!parsed.success)
+        return { ...base, colors: { light: { ...base.colors.light }, dark: { ...base.colors.dark } } };
+    const p = parsed.data;
+    return {
+        name: p.name ?? base.name,
+        colors: {
+            light: mergePalette(base.colors.light, p.colors?.light),
+            dark: mergePalette(base.colors.dark, p.colors?.dark),
+        },
+        typography: { ...base.typography, ...(p.typography ?? {}) },
+        shape: {
+            radius: p.shape?.radius ?? base.shape.radius,
+            density: p.shape?.density ?? base.shape.density,
+        },
+    };
+}