@flamingo-stack/openframe-frontend-core 0.0.537-snapshot.20260814101439 → 0.0.537

package/dist/components/chat/ai-assistant-info.d.ts

@@ -1,31 +0,0 @@
-import { type HTMLAttributes, type ReactNode } from "react";
-export interface AiAssistantInfoProps extends HTMLAttributes<HTMLDivElement> {
-    /** Rendered inside the standard 48px framed box (typically a 24px icon). */
-    icon?: ReactNode;
-    /** Replaces the framed icon box entirely (e.g. a round 48px avatar for the
-     *  `direct-chat` variant). Wins over `icon` when both are set. */
-    leading?: ReactNode;
-    title: string;
-    /** Secondary line under the title. Omitted → the row is title-only. */
-    body?: ReactNode;
-    /** Timestamp of the message row this block came in on. */
-    timestamp?: Date;
-}
-/**
- * Figma `ai-assistant-info` — the shared in-thread status card: a framed
- * icon (or avatar), a title with a right-aligned time, and a secondary line.
- * One presentational shell for every lifecycle receipt in a chat thread
- * (handoff, technician joined, ticket resolved/reopened, …); the per-event
- * components (`TicketEscalatedMessage`, `TicketEventMessage`) own the copy
- * and icon choice and delegate the chrome here.
- *
- * The body WRAPS, deliberately diverging from the mock's single-line
- * ellipsis: the mock's 72px comes from its placeholder copy fitting one
- * line, while real wire text is a full sentence, and clipping the only
- * explanation of a lifecycle change is not recoverable on touch. The title
- * still truncates — it holds one line so the timestamp is never pushed out
- * of the row at narrow widths.
- */
-declare const AiAssistantInfo: import("react").ForwardRefExoticComponent<AiAssistantInfoProps & import("react").RefAttributes<HTMLDivElement>>;
-export { AiAssistantInfo };
-//# sourceMappingURL=ai-assistant-info.d.ts.map

package/dist/components/chat/ai-assistant-info.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-assistant-info.d.ts","sourceRoot":"","sources":["../../../src/components/chat/ai-assistant-info.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIvE,MAAM,WAAW,oBAAqB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;sEACkE;IAClE,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,eAAe,iHAgCpB,CAAA;AAID,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/components/chat/ticket-event-message.d.ts

@@ -1,24 +0,0 @@
-import { type HTMLAttributes } from "react";
-import { type TicketEventSegment } from "./types/message.types";
-export interface TicketEventMessageProps extends HTMLAttributes<HTMLDivElement> {
-    data: TicketEventSegment['data'];
-    /** Timestamp of the message row this block came in on. */
-    timestamp?: Date;
-}
-/**
- * Ticket lifecycle receipt — resolved / reopened / an unknown future kind.
- * Figma `ai-assistant-info` (type=resolved-fae | resolved-tech |
- * reopened-fae | reopened-tech | reopened-reason).
- *
- * Copy is composed client-side from the event's fields (unlike
- * `ticket_escalated`, whose body the backend authors):
- *   RESOLVED → "Resolved by {actorName}." under a green check;
- *   REOPENED → the reason when the wire carries one, otherwise who picks the
- *     conversation up next, inferred from `actorType` (an AI actor keeps
- *     assisting; anything else means a technician will reply);
- *   unknown kind → a neutral info line: humanized kind as the title, the
- *     reason or actor as the body. Never dropped — the vocabulary is open.
- */
-declare const TicketEventMessage: import("react").ForwardRefExoticComponent<TicketEventMessageProps & import("react").RefAttributes<HTMLDivElement>>;
-export { TicketEventMessage };
-//# sourceMappingURL=ticket-event-message.d.ts.map

package/dist/components/chat/ticket-event-message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ticket-event-message.d.ts","sourceRoot":"","sources":["../../../src/components/chat/ticket-event-message.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA;AAGvD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAoBlF,MAAM,WAAW,uBAAwB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC7E,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAChC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,kBAAkB,oHA6BvB,CAAA;AAID,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/src/components/chat/__tests__/ticket-event.test.ts

@@ -1,194 +0,0 @@
-/**
- * TICKET_EVENT — the ticket lifecycle receipt (resolved / reopened / open
- * vocabulary), across both the live NATS path and history replay.
- *
- * The behaviours worth pinning:
- *   - the chunk arrives STANDALONE (no MESSAGE_START at all — resolution can
- *     fire from a PSA-side action with no turn open), so it must mint/append
- *     to the trailing bubble like `ticket-escalated` does;
- *   - dedupe identity is the stream sequence, with payload-equality as the
- *     fallback for the hydrate-then-catch-up overlap where the hydrated twin
- *     is seq-less (the persisted row's seq lives on the message, not in
- *     `messageData`);
- *   - `kind` is OPEN: an unknown kind decodes and renders, only a missing
- *     kind is malformed.
- */
-
-import { describe, expect, it } from 'vitest'
-import { decodeNatsChunk } from '../../../chat-protocol/nats-decoder'
-import { createChatStreamReducer } from '../stream/chat-stream-reducer'
-import { MessageSegmentAccumulator } from '../utils/message-segment-accumulator'
-import { processHistoricalMessages } from '../utils/process-historical-messages'
-import type { HistoricalMessage, MessageSegment, TicketEventSegment } from '../types'
-
-const resolvedChunk = (streamSeq: number, over: Record<string, unknown> = {}) => ({
-  type: 'TICKET_EVENT',
-  kind: 'RESOLVED',
-  actorId: 'fae',
-  actorName: 'Fae',
-  actorType: 'AI',
-  streamSeq,
-  ...over,
-})
-
-const events = (segments: MessageSegment[] | string | undefined): TicketEventSegment[] =>
-  Array.isArray(segments)
-    ? (segments.filter((s) => s.type === 'ticket_event') as TicketEventSegment[])
-    : []
-
-describe('decodeNatsChunk — TICKET_EVENT', () => {
-  it('decodes the resolution receipt with its actor fields', () => {
-    expect(decodeNatsChunk(resolvedChunk(7))).toEqual({
-      type: 'ticket-event',
-      kind: 'RESOLVED',
-      actorId: 'fae',
-      actorName: 'Fae',
-      actorType: 'AI',
-      reason: undefined,
-      seq: 7,
-    })
-  })
-
-  it('falls back to the payload `sequenceId` when the transport did not stamp `streamSeq`', () => {
-    const event = decodeNatsChunk({ type: 'TICKET_EVENT', kind: 'REOPENED', sequenceId: 42 })
-    expect(event).toMatchObject({ type: 'ticket-event', seq: 42 })
-  })
-
-  it('prefers the transport-stamped `streamSeq` over the payload copy', () => {
-    expect(decodeNatsChunk(resolvedChunk(500, { sequenceId: 499 }))).toMatchObject({ seq: 500 })
-  })
-
-  it('keeps unknown kinds — the vocabulary is open', () => {
-    expect(decodeNatsChunk({ type: 'TICKET_EVENT', kind: 'ON_HOLD', streamSeq: 1 })).toMatchObject({
-      type: 'ticket-event',
-      kind: 'ON_HOLD',
-    })
-  })
-
-  it('drops only a chunk with no kind at all', () => {
-    expect(decodeNatsChunk({ type: 'TICKET_EVENT', streamSeq: 1 })).toBeNull()
-    expect(decodeNatsChunk({ type: 'TICKET_EVENT', kind: '  ', streamSeq: 1 })).toBeNull()
-  })
-})
-
-describe('chat stream reducer — ticket event', () => {
-  const trailingSegments = (reducer: ReturnType<typeof createChatStreamReducer>): MessageSegment[] => {
-    const { messages } = reducer.state
-    return messages[messages.length - 1]?.segments ?? []
-  }
-
-  const feed = (reducer: ReturnType<typeof createChatStreamReducer>, chunks: unknown[]) => {
-    for (const chunk of chunks) {
-      const event = decodeNatsChunk(chunk)
-      if (event) reducer.apply(event)
-    }
-  }
-
-  it('renders a receipt arriving with no turn open at all', () => {
-    const reducer = createChatStreamReducer({ transport: 'nats' })
-    feed(reducer, [resolvedChunk(1)])
-    expect(events(trailingSegments(reducer))).toHaveLength(1)
-  })
-
-  it('appends to the trailing bubble without wiping the reply the user is reading', () => {
-    const reducer = createChatStreamReducer({ transport: 'nats' })
-    feed(reducer, [
-      { type: 'MESSAGE_START', streamSeq: 1 },
-      { type: 'TEXT', text: 'Excellent! Feel free to reach out.', streamSeq: 2 },
-      { type: 'MESSAGE_END', streamSeq: 3 },
-      resolvedChunk(4),
-    ])
-    const segments = trailingSegments(reducer)
-    expect(segments.find((s: MessageSegment) => s.type === 'text')).toMatchObject({
-      text: 'Excellent! Feel free to reach out.',
-    })
-    expect(events(segments)).toHaveLength(1)
-  })
-
-  it('is idempotent across a redelivered chunk (JetStream catch-up)', () => {
-    const reducer = createChatStreamReducer({ transport: 'nats' })
-    feed(reducer, [resolvedChunk(2), { type: 'MESSAGE_END', streamSeq: 3 }])
-    // A replay re-decodes the same chunk; the seq gate drops it, but the
-    // upsert must hold even if the gate ever moves.
-    const event = decodeNatsChunk(resolvedChunk(2))
-    if (event) reducer.apply(event)
-    expect(events(trailingSegments(reducer))).toHaveLength(1)
-  })
-
-  it('keeps distinct lifecycle events distinct (resolve → reopen → resolve)', () => {
-    const reducer = createChatStreamReducer({ transport: 'nats' })
-    feed(reducer, [
-      resolvedChunk(1),
-      { type: 'TICKET_EVENT', kind: 'REOPENED', reason: 'Still broken', streamSeq: 2 },
-      resolvedChunk(3, { actorName: 'Roman Smith', actorType: 'TECHNICIAN', actorId: 'u-1' }),
-    ])
-    expect(events(trailingSegments(reducer))).toHaveLength(3)
-  })
-})
-
-describe('accumulator — hydrate/catch-up overlap', () => {
-  it('matches a seq-less hydrated twin by payload equality instead of stacking', () => {
-    const accumulator = new MessageSegmentAccumulator()
-    // Hydrated from history: the persisted row's seq lives on the message,
-    // so the restored segment carries none.
-    accumulator.addTicketEvent({ kind: 'RESOLVED', actorId: 'fae', actorName: 'Fae', actorType: 'AI' })
-    // The same event redelivered live, now with its stream sequence.
-    const segments = accumulator.addTicketEvent(
-      { kind: 'RESOLVED', actorId: 'fae', actorName: 'Fae', actorType: 'AI' },
-      412,
-    )
-    const rendered = events(segments)
-    expect(rendered).toHaveLength(1)
-    expect(rendered[0].streamSeq).toBe(412)
-  })
-
-  it('does NOT collapse two different events of the same kind', () => {
-    const accumulator = new MessageSegmentAccumulator()
-    accumulator.addTicketEvent({ kind: 'RESOLVED', actorName: 'Fae', actorType: 'AI' }, 1)
-    const segments = accumulator.addTicketEvent(
-      { kind: 'RESOLVED', actorName: 'Roman Smith', actorType: 'TECHNICIAN' },
-      9,
-    )
-    expect(events(segments)).toHaveLength(2)
-  })
-})
-
-describe('processHistoricalMessages — ticket event', () => {
-  const historyRow = (id: string, data: Record<string, unknown>): HistoricalMessage => ({
-    id,
-    createdAt: '2026-08-06T12:00:00Z',
-    owner: { type: 'ASSISTANT' },
-    messageData: [data as never],
-  })
-
-  it('replays the persisted row through the same mapper as the live path', () => {
-    const { messages } = processHistoricalMessages([
-      historyRow('m1', {
-        type: 'TICKET_EVENT',
-        kind: 'REOPENED',
-        actorId: 'user-42',
-        actorName: 'John Smith',
-        actorType: 'CLIENT',
-        reason: 'The printer stopped working again',
-      }),
-    ])
-    expect(messages).toHaveLength(1)
-    expect(events(messages[0].content)[0]).toMatchObject({
-      data: { kind: 'REOPENED', reason: 'The printer stopped working again' },
-    })
-  })
-
-  it('keeps an unknown persisted kind renderable', () => {
-    const { messages } = processHistoricalMessages([
-      historyRow('m1', { type: 'TICKET_EVENT', kind: 'ON_HOLD' }),
-    ])
-    expect(events(messages[0]?.content ?? [])).toHaveLength(1)
-  })
-
-  it('skips a malformed row with no kind', () => {
-    const { messages } = processHistoricalMessages([
-      historyRow('m1', { type: 'TICKET_EVENT', actorName: 'Fae' }),
-    ])
-    expect(messages.flatMap((m) => events(m.content))).toHaveLength(0)
-  })
-})

package/src/components/chat/ai-assistant-info.tsx

@@ -1,71 +0,0 @@
-"use client"
-
-import { forwardRef, type HTMLAttributes, type ReactNode } from "react"
-import { cn } from "../../utils/cn"
-import { formatTime } from "../../utils/format-date"
-
-export interface AiAssistantInfoProps extends HTMLAttributes<HTMLDivElement> {
-  /** Rendered inside the standard 48px framed box (typically a 24px icon). */
-  icon?: ReactNode
-  /** Replaces the framed icon box entirely (e.g. a round 48px avatar for the
-   *  `direct-chat` variant). Wins over `icon` when both are set. */
-  leading?: ReactNode
-  title: string
-  /** Secondary line under the title. Omitted → the row is title-only. */
-  body?: ReactNode
-  /** Timestamp of the message row this block came in on. */
-  timestamp?: Date
-}
-
-/**
- * Figma `ai-assistant-info` — the shared in-thread status card: a framed
- * icon (or avatar), a title with a right-aligned time, and a secondary line.
- * One presentational shell for every lifecycle receipt in a chat thread
- * (handoff, technician joined, ticket resolved/reopened, …); the per-event
- * components (`TicketEscalatedMessage`, `TicketEventMessage`) own the copy
- * and icon choice and delegate the chrome here.
- *
- * The body WRAPS, deliberately diverging from the mock's single-line
- * ellipsis: the mock's 72px comes from its placeholder copy fitting one
- * line, while real wire text is a full sentence, and clipping the only
- * explanation of a lifecycle change is not recoverable on touch. The title
- * still truncates — it holds one line so the timestamp is never pushed out
- * of the row at narrow widths.
- */
-const AiAssistantInfo = forwardRef<HTMLDivElement, AiAssistantInfoProps>(
-  ({ className, icon, leading, title, body, timestamp, ...props }, ref) => {
-    return (
-      <div
-        ref={ref}
-        className={cn(
-          "mb-[var(--spacing-system-xsf)] flex items-start gap-[var(--spacing-system-s)] rounded-md border border-ods-border bg-ods-card p-[var(--spacing-system-s)]",
-          className,
-        )}
-        {...props}
-      >
-        {leading ?? (
-          <div className="flex size-12 shrink-0 items-center justify-center rounded-md border border-ods-border bg-ods-bg">
-            {icon}
-          </div>
-        )}
-        <div className="flex min-w-0 flex-1 flex-col">
-          <div className="flex w-full items-start">
-            <p className="text-h4 min-w-0 flex-1 truncate text-ods-text-primary" title={title}>
-              {title}
-            </p>
-            {timestamp && (
-              <span className="text-h6 shrink-0 text-right text-ods-text-secondary">{formatTime(timestamp)}</span>
-            )}
-          </div>
-          {body != null && body !== "" && (
-            <p className="text-h4 w-full break-words text-ods-text-secondary">{body}</p>
-          )}
-        </div>
-      </div>
-    )
-  },
-)
-
-AiAssistantInfo.displayName = "AiAssistantInfo"
-
-export { AiAssistantInfo }

package/src/components/chat/ticket-event-message.tsx

@@ -1,79 +0,0 @@
-"use client"
-
-import { forwardRef, type HTMLAttributes } from "react"
-import { CheckCircleIcon, InfoCircleIcon } from "../icons-v2-generated"
-import { AiAssistantInfo } from "./ai-assistant-info"
-import { TICKET_EVENT_KIND, type TicketEventSegment } from "./types/message.types"
-
-/** Actor types the backend uses for the AI agent. Open set on the wire —
- *  compared case-insensitively; anything else is treated as a human. */
-const AI_ACTOR_TYPES = new Set(["AI", "AGENT", "ASSISTANT", "BOT"])
-
-function isAiActor(actorType?: string): boolean {
-  return !!actorType && AI_ACTOR_TYPES.has(actorType.toUpperCase())
-}
-
-/** `TICKET_ON_HOLD` → `Ticket On Hold` — neutral title for kinds this build
- *  does not know, which must still render (the vocabulary is open). */
-function humanizeKind(kind: string): string {
-  return kind
-    .split(/[_\s-]+/)
-    .filter(Boolean)
-    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-    .join(" ")
-}
-
-export interface TicketEventMessageProps extends HTMLAttributes<HTMLDivElement> {
-  data: TicketEventSegment['data']
-  /** Timestamp of the message row this block came in on. */
-  timestamp?: Date
-}
-
-/**
- * Ticket lifecycle receipt — resolved / reopened / an unknown future kind.
- * Figma `ai-assistant-info` (type=resolved-fae | resolved-tech |
- * reopened-fae | reopened-tech | reopened-reason).
- *
- * Copy is composed client-side from the event's fields (unlike
- * `ticket_escalated`, whose body the backend authors):
- *   RESOLVED → "Resolved by {actorName}." under a green check;
- *   REOPENED → the reason when the wire carries one, otherwise who picks the
- *     conversation up next, inferred from `actorType` (an AI actor keeps
- *     assisting; anything else means a technician will reply);
- *   unknown kind → a neutral info line: humanized kind as the title, the
- *     reason or actor as the body. Never dropped — the vocabulary is open.
- */
-const TicketEventMessage = forwardRef<HTMLDivElement, TicketEventMessageProps>(
-  ({ data, timestamp, ...props }, ref) => {
-    const { kind, actorName, actorType, reason } = data
-    const resolved = kind === TICKET_EVENT_KIND.RESOLVED
-    const reopened = kind === TICKET_EVENT_KIND.REOPENED
-
-    const title = resolved ? "Ticket Resolved" : reopened ? "Ticket Reopened" : humanizeKind(kind)
-
-    let body: string | undefined
-    if (resolved) {
-      body = actorName ? `Resolved by ${actorName}.` : "The ticket has been resolved."
-    } else if (reopened) {
-      body = reason
-        ? `Reason: ${reason}`
-        : isAiActor(actorType)
-          ? `${actorName || "Fae"} will continue assisting in this conversation.`
-          : "A technician will reply when available."
-    } else {
-      body = reason || (actorName ? `By ${actorName}.` : undefined)
-    }
-
-    const icon = resolved ? (
-      <CheckCircleIcon className="size-6 text-ods-attention-green-success" />
-    ) : (
-      <InfoCircleIcon className="size-6 text-ods-flamingo-pink" />
-    )
-
-    return <AiAssistantInfo ref={ref} icon={icon} title={title} body={body} timestamp={timestamp} {...props} />
-  },
-)
-
-TicketEventMessage.displayName = "TicketEventMessage"
-
-export { TicketEventMessage }

package/src/stories/TicketEventMessage.stories.tsx

@@ -1,100 +0,0 @@
-import type { Meta, StoryObj } from "@storybook/nextjs-vite";
-import type React from "react";
-
-import { TicketEventMessage } from "../components/chat/ticket-event-message";
-
-/**
- * `ticket_event` message segment — the ticket lifecycle receipt (Figma:
- * `ai-assistant-info`, types resolved-fae / resolved-tech / reopened-fae /
- * reopened-tech / reopened-reason).
- *
- * Decoded from the standalone `TICKET_EVENT` chunk (live) or the persisted
- * `TicketEventData` row (history). `kind` is an OPEN vocabulary: unknown
- * kinds render as a neutral info line rather than being dropped, so the
- * backend can add lifecycle kinds without a client release.
- */
-
-/** Fixed so the timestamp doesn't churn between snapshots. */
-const TIMESTAMP = new Date("2026-08-07T14:47:00");
-
-const plainDecorator = (Story: React.ComponentType) => (
-	<div style={{ maxWidth: 600, background: "var(--color-bg)" }} className="p-4">
-		<Story />
-	</div>
-);
-
-const meta = {
-	title: "Chat/Client/TicketEventMessage",
-	component: TicketEventMessage,
-	tags: ["autodocs"],
-	parameters: {
-		docs: {
-			description: {
-				component:
-					"Renders a `TICKET_EVENT` block: a green check for RESOLVED, a pink info tile for REOPENED and for any kind this build doesn't know, with copy composed from the event's actor and reason fields.",
-			},
-		},
-	},
-	decorators: [plainDecorator],
-} satisfies Meta<typeof TicketEventMessage>;
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-/** Fae (the AI agent) resolved the ticket — Figma type=resolved-fae. */
-export const ResolvedByFae: Story = {
-	args: {
-		data: { kind: "RESOLVED", actorId: "fae", actorName: "Fae", actorType: "AI" },
-		timestamp: TIMESTAMP,
-	},
-};
-
-/** A human technician resolved the ticket — Figma type=resolved-tech. */
-export const ResolvedByTechnician: Story = {
-	args: {
-		data: { kind: "RESOLVED", actorId: "u-42", actorName: "Roman Smith", actorType: "TECHNICIAN" },
-		timestamp: TIMESTAMP,
-	},
-};
-
-/** Reopened with the user's stated reason — Figma type=reopened-reason. */
-export const ReopenedWithReason: Story = {
-	args: {
-		data: {
-			kind: "REOPENED",
-			actorId: "u-7",
-			actorName: "John Smith",
-			actorType: "CLIENT",
-			reason: "The printer stopped working again",
-		},
-		timestamp: TIMESTAMP,
-	},
-};
-
-/** Reopened, no reason, AI keeps assisting — Figma type=reopened-fae. */
-export const ReopenedFaeContinues: Story = {
-	args: {
-		data: { kind: "REOPENED", actorId: "fae", actorName: "Fae", actorType: "AI" },
-		timestamp: TIMESTAMP,
-	},
-};
-
-/** Reopened, no reason, routed to a human — Figma type=reopened-tech. */
-export const ReopenedTechnicianReplies: Story = {
-	args: {
-		data: { kind: "REOPENED", actorId: "u-42", actorName: "Roman Smith", actorType: "TECHNICIAN" },
-		timestamp: TIMESTAMP,
-	},
-};
-
-/**
- * A kind the client has never seen. The open vocabulary means the backend can
- * add lifecycle kinds without a client release — this story is the regression
- * guard: neutral info line, humanized title, never dropped.
- */
-export const UnknownKind: Story = {
-	args: {
-		data: { kind: "ON_HOLD", actorName: "Roman Smith", reason: "Waiting for replacement hardware" },
-		timestamp: TIMESTAMP,
-	},
-};