@flamingo-stack/openframe-frontend-core 0.0.490-1506.3944.1 → 0.0.490

package/src/components/ui/ticket-info-section.tsx

@@ -12,7 +12,7 @@ import { TicketDetailSection } from "./ticket-detail-section"
 import { type TicketAttachment, TicketAttachmentsList } from "./ticket-attachments-list"
 import type { TicketNote } from "./ticket-note-card"
 import { TicketNotesSection } from "./ticket-notes-section"
-import { SimpleMarkdownRenderer } from "./markdown/simple-markdown-renderer"
+import { SimpleMarkdownRenderer } from "./simple-markdown-renderer"
 
 export type { TicketAssigneeOption }
 

package/src/stories/ChatMessageEnhanced.stories.tsx

@@ -183,7 +183,50 @@ export const PendingApprovalSegment: Story = {
 	},
 };
 
-/** Every remaining segment type in one message — thinking, tool execution, context compaction, error. */
+/**
+ * `[card://]` markers inside a `guide` segment resolve exactly as they do in a
+ * text segment — the host's `renderEntityCard` node is hoisted out of the
+ * markdown as a sibling block, and an unknown id degrades to the bare id.
+ * Regression guard: the guide body used to skip the marker plan entirely.
+ */
+export const GuideWithEntityCards: Story = {
+	args: {
+		role: "assistant",
+		name: "Mingo",
+		assistantType: "mingo",
+		timestamp: at247(),
+		chatRefs: {
+			"onboarding_guide:first-check": {
+				type: "onboarding_guide",
+				id: "first-check",
+				title: "Create Your First Monitoring Check",
+				url: "/help-center/onboarding-guides/first-check",
+			},
+			"onboarding_guide:add-devices": {
+				type: "onboarding_guide",
+				id: "add-devices",
+				title: "Add Devices to a Policy",
+				url: "/help-center/onboarding-guides/add-devices",
+			},
+		},
+		renderEntityCard: (ref) =>
+			ref.type === "onboarding_guide" ? (
+				<div className="flex items-center gap-[var(--spacing-system-s)] rounded-md border border-ods-border bg-ods-card p-[var(--spacing-system-s)]">
+					<span className="flex-1 text-h4 text-ods-text-primary">{ref.title}</span>
+					<span className="text-h5 text-ods-text-secondary">Guide</span>
+				</div>
+			) : null,
+		content: [
+			{
+				type: "guide",
+				text: "Here's how to create a monitoring policy (check) in OpenFrame:\n\n[card://onboarding_guide:first-check]\n\nStep-by-step:\n\n1. Go to Monitoring → Policies → Add Policy\n2. Write your osquery SQL query\n3. Save the policy",
+			},
+			{ type: "text", text: "A plain text segment renders its own marker identically:\n\n[card://onboarding_guide:add-devices]" },
+		] satisfies MessageSegment[],
+	},
+};
+
+/** Every remaining segment type in one message — thinking, guide, tool execution, context compaction, error. */
 export const AllSegmentTypes: Story = {
 	args: {
 		role: "assistant",
@@ -195,6 +238,10 @@ export const AllSegmentTypes: Story = {
 				text: "The user wants Slack installed. Homebrew is present on the endpoint, so `brew install --cask slack` is the cleanest path.",
 			},
 			{ type: "text", text: "Installing Slack now." },
+			{
+				type: "guide",
+				text: "Here's how to create a monitoring policy (check) in OpenFrame:\n\nStep-by-step:\n\n1. Go to Monitoring → Policies → Add Policy\n2. Give it a Name (something descriptive)\n3. Write your osquery SQL query — the query should return rows for devices that fail the check\n4. Set the interval — how often each device runs the check\n5. Save the policy",
+			},
 			{
 				type: "tool_execution",
 				data: {

package/src/utils/index.ts

@@ -334,7 +334,6 @@ export * from './humanity-signals'
 export * from './doc-path-utils'
 export * from './doc-tree-nav'
 export * from './tree-builder'
-export * from './markdown-heading-id'
 export * from './markdown-section-extractor'
 export * from './markdown-to-plain'
 export * from './embed-url-converters'

package/src/utils/markdown-section-extractor.ts

@@ -4,12 +4,6 @@
  */
 
 import { stripInlineMarkdown } from './markdown-to-plain'
-import {
-  createHeadingIdDeduper,
-  scanHeadings,
-  slugifyHeadingBase,
-  stripHeadingEmojis,
-} from './markdown-heading-id'
 
 export interface MarkdownSection {
   id: string
@@ -44,47 +38,68 @@ export function extractSections(
 ): MarkdownSection[] {
   const opts = { ...DEFAULT_OPTIONS, ...options }
   const sections: MarkdownSection[] = []
-  const dedupe = createHeadingIdDeduper()
-
-  // ONE scanner, shared with the renderer's heading-id map
-  // (utils/markdown-heading-id.ts). This file used to carry its own
-  // line loop — `line.startsWith('```')` for fences (blind to `~~~`, to
-  // longer backtick runs and to the CommonMark 0..3-space indent) and a
-  // bare `line === '---'` YAML toggle (which a mid-document thematic break
-  // or setext underline tripped, swallowing every heading after it). Both
-  // produced sections the renderer emitted no id for.
-  const scanned = scanHeadings(markdown, {
-    skipFrontmatter: opts.skipCodeAndYamlBlocks,
-    skipFences: opts.skipCodeAndYamlBlocks,
-  })
-
-  for (const heading of scanned) {
-    if (heading.level > opts.maxLevel) continue
-
-    let title = heading.text
+  const lines = markdown.split('\n')
+  const idCounts: Record<string, number> = {}
+
+  let inCodeBlock = false
+  let inYamlBlock = false
+
+  for (const line of lines) {
+    if (opts.skipCodeAndYamlBlocks) {
+      if (line.startsWith('```')) {
+        inCodeBlock = !inCodeBlock
+        continue
+      }
+      if (line === '---') {
+        inYamlBlock = !inYamlBlock
+        continue
+      }
+      if (inCodeBlock || inYamlBlock) continue
+    }
+
+    const pattern = new RegExp(`^(#{1,${opts.maxLevel}})\\s+(.+)`)
+    const match = line.match(pattern)
+    if (!match) continue
+
+    const level = match[1].length
+    if (level > opts.maxLevel) continue
+
+    let title = match[2].trim()
+
     if (opts.stripFormattingMarkers) {
       title = stripInlineMarkdown(title).trim()
     }
 
-    // Slug chain SSOT — shared with the renderers' heading-id generator
-    // (see utils/markdown-heading-id.ts). Extractor and renderers MUST
-    // agree or deep-link anchors silently diverge.
-    const baseId = slugifyHeadingBase(
-      opts.removeEmojis ? stripHeadingEmojis(title) : title,
-    )
-
-    // Symbol-only heading fallback: the 1-based ordinal among the headings
-    // this extractor EMITS (levels ≤ maxLevel). The renderer's heading-id
-    // generator mirrors this exact counter for levels ≤ 2
-    // (components/ui/markdown/heading-ids.ts) — the two must agree or
-    // deep-link anchors diverge for symbol-only headings.
+    let baseId = title
+
+    if (opts.removeEmojis) {
+      baseId = baseId
+        .replace(
+          /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]/gu,
+          '',
+        )
+        .trim()
+    }
+
+    baseId = baseId
+      .toLowerCase()
+      .replace(/[^\w\s-]/g, '')
+      .replace(/\s+/g, '-')
+      .replace(/^-+|-+$/g, '')
+
     const cleanId = baseId || `section-${sections.length + 1}`
 
-    sections.push({
-      id: opts.handleDuplicateIds ? dedupe(cleanId) : cleanId,
-      title,
-      level: heading.level,
-    })
+    let id = cleanId
+    if (opts.handleDuplicateIds) {
+      if (idCounts[cleanId]) {
+        idCounts[cleanId]++
+        id = `${cleanId}-${idCounts[cleanId]}`
+      } else {
+        idCounts[cleanId] = 1
+      }
+    }
+
+    sections.push({ id, title, level })
   }
 
   return sections

package/dist/chat-protocol/decode.d.ts

@@ -1,58 +0,0 @@
-/**
- * SSE wire-protocol decoder — a timer-free synchronous state machine,
- * mechanically extracted from `useSseChatAdapter`'s inline
- * `createDocStreamFn` parser. Byte-for-byte behavior parity with the
- * legacy parser is the contract (the golden fixtures in
- * `src/components/chat/hooks/__tests__/sse-stream-golden.test.ts` pin it
- * through the full hook path), including its quirks:
- *
- *   - A leading `\0`-terminated block that fails JSON.parse flips the
- *     stream into text mode and the WHOLE buffer (including the `\0`)
- *     is emitted as answer text (legacy no-frame stream fallback). This
- *     transition is marked `turn-start { implicit: true }`.
- *   - In text mode only `\x1F` is scanned — literal `\0` / `\x1E` bytes
- *     pass through into the answer; the FIRST literal `\x1F` flips into
- *     trailer mode and everything after is captured as the trailer
- *     (golden fixture (d) characterizes this mis-framing; the fix lives
- *     in `encode.ts`'s sentinel stripping, NOT here).
- *   - The `\x1E` sentinel and the `\x1F` trailer can arrive in ONE TCP
- *     chunk (fixed-answer responses) — the post-sentinel slice is
- *     re-scanned for the trailer sentinel.
- *   - Multi-byte UTF-8 across chunk boundaries survives via a single
- *     streaming TextDecoder (`{ stream: true }` on every push; no final
- *     flush — a trailing partial code point is dropped, as legacy did).
- *   - `end()` parses the accumulated trailer (malformed → silently
- *     ignored) and drops any un-terminated leading buffer, as legacy did.
- *     It is IDEMPOTENT (a deliberate deviation from legacy): repeat calls
- *     emit nothing, so an adapter that ends in both its completion path
- *     and its `finally` cannot double-count the usage frame.
- *
- * State flow: leading → (sentinel | parse-failure) → text → (\x1F) →
- * trailer-accumulate → end().
- *
- * Server-safe: no React, no timers, TextDecoder only.
- */
-import type { ChatStreamEvent } from './events';
-export interface SseFrameDecoder {
-    /** Feed raw response bytes; returns the events they produced. */
-    push(bytes: Uint8Array): ChatStreamEvent[];
-    /**
-     * Signal end-of-stream; parses the trailing usage frame if present.
-     * IDEMPOTENT — every call after the first returns `[]`. Adapters
-     * routinely call this from BOTH their completion path and a `finally`,
-     * and a re-emitted `usage`/`stage:'end'` event would double-count token
-     * usage (displayed cost doubles).
-     */
-    end(): ChatStreamEvent[];
-}
-/**
- * Escape `<` so markdown renderers that pass HTML through (rehypeRaw)
- * don't treat XML-like tokens in Claude's thinking output as elements.
- * `<` → `&lt;` preserves the visible character without breaking
- * blockquote `>` markers. Per-character, so it distributes over
- * concatenation: escape(a + b) === escape(a) + escape(b) — callers may
- * apply it per-delta or on the accumulated string interchangeably.
- */
-export declare function escapeThinkingTags(text: string): string;
-export declare function createSseFrameDecoder(): SseFrameDecoder;
-//# sourceMappingURL=decode.d.ts.map

package/dist/chat-protocol/decode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,CAAA;IAC1C;;;;;;OAMG;IACH,GAAG,IAAI,eAAe,EAAE,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAqGD,wBAAgB,qBAAqB,IAAI,eAAe,CAmHvD"}

package/dist/chat-protocol/encode.d.ts

@@ -1,44 +0,0 @@
-/**
- * SSE wire-protocol encoders — the emit side of the framing contract in
- * `./frames.ts`. Server-safe (TextEncoder only). The hub's stream route
- * consumes these so emitter and decoder can never drift.
- */
-import { type SseLeadingFrame, type SseTrailingUsageFrame } from './frames';
-/**
- * Remove the SSE framing sentinel bytes (`\0`, `\x1E`, `\x1F`) from model
- * text. Exported as a STANDALONE helper — not just folded into
- * `encodeTextDelta` — because producers must strip at the point where they
- * first take custody of the text, BEFORE any local accumulation.
- *
- * Concretely: the hub's `claude-util.ts` accumulates `state.answerText` for
- * persistence + telemetry. If stripping only happened at encode time, the
- * persisted/telemetered answer would diverge, character for character, from
- * the bytes the user actually received whenever the model echoes a control
- * byte. Both sides call this, so there is exactly ONE definition of "which
- * bytes are framing" in the whole system — do not re-declare the regex.
- *
- * Idempotent and per-character, so it distributes over concatenation:
- * `strip(a + b) === strip(a) + strip(b)` — safe to apply per-delta or on the
- * accumulated string interchangeably.
- */
-export declare function stripSentinelBytes(text: string): string;
-/** Encode one leading frame: JSON + `\0` terminator. */
-export declare function encodeLeadingFrame(frame: SseLeadingFrame): Uint8Array;
-/** Encode the single `\x1E` end-of-leading-frames sentinel. */
-export declare function encodeEndOfLeading(): Uint8Array;
-/**
- * Encode a raw answer-text delta. STRIPS the framing sentinel bytes via
- * `stripSentinelBytes` so model-echoed control bytes can no longer
- * mis-frame the stream (a literal `\x1F` in the answer used to flip the
- * client into trailer mode and swallow the rest of the answer PLUS the real
- * usage trailer — characterized by golden fixture (d)). Forward-looking
- * encoder fix only; the decoder's behavior is unchanged.
- *
- * Producers that ALSO accumulate the text locally (persistence, telemetry)
- * must call `stripSentinelBytes` on their own copy — see its docblock.
- */
-export declare function encodeTextDelta(text: string): Uint8Array;
-/** Encode the trailing usage frame: `\x1F` + JSON, no terminator
- *  (runs to stream end). */
-export declare function encodeTrailingUsageFrame(frame: SseTrailingUsageFrame): Uint8Array;
-//# sourceMappingURL=encode.d.ts.map

package/dist/chat-protocol/encode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/encode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAA;AAQjB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAErE;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAExD;AAED;4BAC4B;AAC5B,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAEjF"}

package/dist/chat-protocol/env-flag.d.ts

@@ -1,35 +0,0 @@
-/**
- * `envFlagEnabled` — THE cross-repo predicate for reading a boolean env flag.
- *
- * WHY IT LIVES HERE: the same flag is read on BOTH sides of the guide-chat
- * seam and each side had grown its own reading of it. The hub parsed the
- * value (`'0'` / `'false'` / `'off'` mean OFF); the producing app used bare
- * `Boolean(process.env.X)`, under which every non-empty string — including
- * `'0'` and `'false'` — is TRUE.
- *
- * That divergence failed OPEN on the one flag that gates a security boundary.
- * `TRUSTED_INGRESS_SETS_REAL_IP` is an operator's assertion that a reverse
- * proxy OVERWRITES the client-IP headers; without it those headers are
- * attacker-writable and must not be read. An operator writing `=0` to mean
- * "off" got the hub honoring that while the producer read `x-real-ip` /
- * `x-forwarded-for` anyway and forwarded the value as `x-chat-ip`, which the
- * hub then trusts verbatim under the service token. A rate-limit-bucket
- * spoof, reachable through a plausible operator typo.
- *
- * Both repos already depend on this package and `./chat-protocol` is its
- * server-safe subpath (no React, no browser APIs), so this is the one place
- * both sides can share — same reasoning that moved `normalizeIpForBucketKey`
- * here. Keep it as ONE definition: a second copy is what caused the drift.
- *
- * Contract:
- *   - unset, empty, or whitespace-only  → `false`;
- *   - `'0'`, `'false'`, `'off'`         → `false` (case- and
- *     surrounding-whitespace-insensitive);
- *   - any other non-empty value         → `true`.
- *
- * `process.env` is read PER CALL, never module-hoisted, so tests, preview and
- * prod all observe the live value rather than whatever was present at
- * module-eval time.
- */
-export declare function envFlagEnabled(name: string): boolean;
-//# sourceMappingURL=env-flag.d.ts.map

package/dist/chat-protocol/env-flag.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env-flag.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/env-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/dist/chat-protocol/events.d.ts

@@ -1,196 +0,0 @@
-/**
- * Normalized chat stream events — the transport-agnostic event union BOTH
- * decoders (SSE byte framing in `./decode.ts`, NATS chunks in
- * `./nats-decoder.ts`) emit. Phase 3 of the chat unification makes the
- * reducer consume these directly; today the SSE adapter maps them back to
- * legacy `MessageSegment` yields.
- *
- * Server-safe: no React, no browser APIs.
- */
-import type { ApprovalRequestField, DecisionResolvedFrame, UsageTelemetry } from './frames';
-/** Optional envelope on every event. `seq` carries the transport's
- *  stream sequence (JetStream `streamSeq` on NATS; unused on SSE). */
-interface ChatStreamEventBase {
-    seq?: number;
-}
-/** Stream entered answer-text mode (SSE: the `\x1E` sentinel or the
- *  JSON-parse-failure fallback; NATS: MESSAGE_START).
- *  `implicit` is true ONLY for the SSE fallback path where a
- *  non-JSON leading buffer flips straight into text mode — consumers
- *  that flush coalesced thinking on turn-start must SKIP the flush for
- *  implicit starts (legacy adapter parity: the fallback path never
- *  flushed pending thinking before the text). */
-export interface TurnStartEvent extends ChatStreamEventBase {
-    type: 'turn-start';
-    implicit?: boolean;
-}
-export interface TurnEndEvent extends ChatStreamEventBase {
-    type: 'turn-end';
-}
-/** Answer text delta. `leading: true` marks SSE `text-leading` frames
- *  (model preamble prose emitted BEFORE the tool approval card). */
-export interface TextDeltaEvent extends ChatStreamEventBase {
-    type: 'text-delta';
-    text: string;
-    leading?: boolean;
-}
-/** Thinking delta — APPEND-ONLY contract: each event carries the next
- *  verbatim slice; consumers accumulate. Decoders never diff. */
-export interface ThinkingDeltaEvent extends ChatStreamEventBase {
-    type: 'thinking-delta';
-    text: string;
-}
-export interface StatusEvent extends ChatStreamEventBase {
-    type: 'status';
-    phase: 'thinking';
-}
-/** NATS tool execution progress (EXECUTING_TOOL / EXECUTED_TOOL). */
-export interface ToolExecutionEvent extends ChatStreamEventBase {
-    type: 'tool-execution';
-    data: {
-        type: 'EXECUTING_TOOL' | 'EXECUTED_TOOL';
-        integratedToolType: string;
-        toolFunction: string;
-        toolTitle?: string;
-        parameters?: Record<string, unknown>;
-        result?: string;
-        success?: boolean;
-        toolExecutionRequestId?: string;
-    };
-}
-/** Single tool call inside a batch approval request (NATS). */
-export interface ApprovalToolCall {
-    toolExecutionRequestId: string;
-    toolName: string;
-    toolTitle?: string;
-    toolExplanation?: string;
-    toolType?: string;
-    requiresApproval: boolean;
-    approvalType?: string | null;
-    toolCallArguments?: Record<string, unknown> | null;
-}
-/** A tool call awaits user approval. SSE fills `command`/`fields`
- *  (card-ready payload); NATS fills `command`/`explanation` or
- *  `toolCalls` (batch form). */
-export interface ApprovalRequestEvent extends ChatStreamEventBase {
-    type: 'approval-request';
-    requestId: string;
-    /** SSE: the write tool's name. NATS: approval tier (USER/ADMIN/…). */
-    approvalType?: string;
-    command?: string;
-    explanation?: string;
-    fields?: ApprovalRequestField[];
-    toolCalls?: ApprovalToolCall[];
-    status?: 'pending';
-}
-/** An approval request was resolved (SSE `decision_resolved` frame /
- *  NATS APPROVAL_RESULT chunk). */
-export interface ApprovalResolvedEvent extends ChatStreamEventBase {
-    type: 'approval-resolved';
-    requestId?: string;
-    status: 'approved' | 'rejected';
-    ok?: boolean;
-    toolName?: string;
-    approvalType?: string;
-    resolvedByName?: string | null;
-    receiptText?: string;
-    /** Inline post-approve card: the ref payload + its documentType +
-     *  the `[card://…]` marker (SSE only). */
-    cardRef?: unknown;
-    cardType?: string;
-    marker?: string;
-    result?: DecisionResolvedFrame['result'];
-    willAutoContinue?: boolean;
-}
-/** Per-turn metadata. Raw wire values pass through UNVALIDATED — the
- *  consumer replicates the legacy truthiness/typeof gates (so a
- *  malformed frame degrades identically to the pre-SSOT parser). */
-export interface ChatMetadataEvent extends ChatStreamEventBase {
-    type: 'metadata';
-    provider?: string | null;
-    modelLabel?: string | null;
-    /** Raw model id (SSE `meta.model`; NATS `modelName`). */
-    modelName?: string | null;
-    contextWindowMaxTokens?: number | null;
-    sources?: unknown;
-    refs?: unknown;
-    scrollAnchor?: unknown;
-    /** Server-minted conversation id (`ChatMetadataFrame.conversationId`),
-     *  passed through raw like every other catch-all field — the consumer
-     *  applies the `typeof === 'string' && truthy` gate. */
-    conversationId?: string | null;
-    routing?: {
-        routedComplexity: string;
-        routedModel?: string;
-        routedThinkingBudget: number | null;
-    };
-}
-/** SSE usage frames — raw wire keys (snake_case) preserved. */
-export interface UsageEvent extends ChatStreamEventBase {
-    type: 'usage';
-    stage: 'start' | 'end';
-    input_tokens?: number;
-    output_tokens?: number;
-    cache_read_input_tokens?: number;
-    cache_creation_input_tokens?: number;
-    hit_rate_pct?: number;
-    telemetry?: UsageTelemetry;
-    /** Left OPAQUE on purpose: the consumer (`chat-stream-reducer`'s
-     *  `applySseUsage`) re-validates every nested field with the legacy
-     *  truthiness/typeof gates, so a malformed frame degrades identically
-     *  to the pre-SSOT parser. Typing it would imply guarantees the wire
-     *  does not make. */
-    breakdown?: unknown;
-    debug?: unknown;
-}
-/** NATS TOKEN_USAGE chunk (camelCase backend shape). */
-export interface TokenUsageEvent extends ChatStreamEventBase {
-    type: 'token-usage';
-    inputTokensSize: number;
-    outputTokensSize: number;
-    totalTokensSize: number;
-    contextSize: number;
-}
-export interface CompactionEvent extends ChatStreamEventBase {
-    type: 'compaction';
-    phase: 'start' | 'end';
-    summary?: string;
-}
-export interface ErrorEvent extends ChatStreamEventBase {
-    type: 'error';
-    title: string;
-    details?: string;
-}
-/** Non-assistant message on the stream (NATS): the user's own message
- *  echo (`message-request`), an operator direct message, or a system
- *  line. */
-/**
- * Dialog participant owner type. The two members below are the ones clients
- * BRANCH ON (admin-vs-not decides echo dedup and author styling); the union
- * stays open (`string & {}`) because the wire may carry other roles that the
- * client treats as "not admin". Always compare against `CHAT_OWNER_ADMIN`,
- * never a bare `'ADMIN'` literal — a typo in a literal silently disables
- * dedup instead of failing to compile.
- */
-export type ChatOwnerType = 'ADMIN' | 'CLIENT' | (string & {});
-/** Canonical ADMIN owner-type token (see `ChatOwnerType`). */
-export declare const CHAT_OWNER_ADMIN = "ADMIN";
-export interface ParticipantEvent extends ChatStreamEventBase {
-    type: 'participant';
-    kind: 'message-request' | 'direct-message' | 'system';
-    text: string;
-    ownerType?: ChatOwnerType;
-    displayName?: string;
-    userId?: string;
-    contextItems?: Array<{
-        type: string;
-        id: string;
-        label: string;
-    }>;
-}
-export interface DialogClosedEvent extends ChatStreamEventBase {
-    type: 'dialog-closed';
-}
-export type ChatStreamEvent = TurnStartEvent | TurnEndEvent | TextDeltaEvent | ThinkingDeltaEvent | StatusEvent | ToolExecutionEvent | ApprovalRequestEvent | ApprovalResolvedEvent | ChatMetadataEvent | UsageEvent | TokenUsageEvent | CompactionEvent | ErrorEvent | ParticipantEvent | DialogClosedEvent;
-export {};
-//# sourceMappingURL=events.d.ts.map

package/dist/chat-protocol/events.d.ts.map

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