@hydraharness/harness-client-ui-conversation 0.1.1-rc.6

package/lib/types/client/chat/register-node-renderers.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '@hydraharness/cordis';
+import type { SessionId, UserMessageNode } from '@hydraharness/harness-client-runtime/client';
+import type { PromptEditOptions } from '../contract/prompt-edit.ts';
+/**
+ * Register this package's business renderers behind the keyed Chat Node seat.
+ * @param ctx - owning UI Conversation context.
+ * @param editMessage - replaces a turn with a new prompt revision and response.
+ * @param retryRevision - retries the current failed attempt, keeping its user revision identity.
+ */
+export declare function registerChatNodeRenderers(ctx: Context, editMessage: (sessionId: SessionId, node: UserMessageNode, text: string, options: PromptEditOptions) => Promise<void>, retryRevision: (sessionId: SessionId, idempotencyKey: string) => Promise<void>): void;
+//# sourceMappingURL=register-node-renderers.d.ts.map

package/lib/types/client/chat/tool-node-reader.d.ts

@@ -0,0 +1,16 @@
+import type { ConversationSnapshot, ToolCallBlock } from '@hydraharness/harness-client-runtime/client';
+/**
+ * Read one root Tool lifecycle through the internal Chat Node index.
+ * @param snapshot - current Conversation snapshot.
+ * @param rootCallId - root call identity and Tool Context identity.
+ * @returns root lifecycle when it is materialized in the current window.
+ */
+export declare function rootToolCall(snapshot: ConversationSnapshot, rootCallId: string): ToolCallBlock | undefined;
+/**
+ * Find any root or nested Tool lifecycle through the internal Node store.
+ * @param snapshot - current Conversation snapshot.
+ * @param callId - root or nested call identity.
+ * @returns current Tool lifecycle when materialized in the loaded window.
+ */
+export declare function findToolCall(snapshot: ConversationSnapshot, callId: string): ToolCallBlock | undefined;
+//# sourceMappingURL=tool-node-reader.d.ts.map

package/lib/types/client/chat/turn-assistant.d.ts

@@ -0,0 +1,8 @@
+import type { AssistantBlock } from '@hydraharness/harness-client-runtime/client';
+/**
+ * Collect visible prose from one Assistant lifecycle.
+ * @param blocks - Assistant content blocks.
+ * @returns concatenated text blocks.
+ */
+export declare function assistantText(blocks: readonly AssistantBlock[]): string;
+//# sourceMappingURL=turn-assistant.d.ts.map

package/lib/types/client/chat/turn-metrics.d.ts

@@ -0,0 +1,38 @@
+import type { AssistantMessageNode, ConversationNode } from '@hydraharness/harness-client-runtime/client';
+/** Latency and decode-throughput readings for one turn's footer. */
+export interface TurnMetrics {
+    /** First-step TTFT in ms; absent when that step carries no recorded timing. */
+    ttftMs?: number;
+    /** Decode throughput over steps carrying both timing and provider usage. */
+    tokensPerSecond?: number;
+}
+/** One assistant step's derivable latency facts; null marks an unrecorded part. */
+export interface StepReading {
+    /** step/start → first token delta, in ms. */
+    ttftMs: number | null;
+    /** First token delta → final message, in ms. */
+    decodeMs: number | null;
+    /** Provider-reported completion tokens. */
+    outputTokens: number | null;
+}
+type AssistantNode = AssistantMessageNode;
+/**
+ * Read one assistant node's TTFT, decode wall time, and output tokens.
+ * @param node - A settled assistant node.
+ * @returns Per-part readings with `null` for unrecorded values.
+ */
+export declare function assistantStepReading(node: AssistantNode): StepReading;
+/**
+ * Fold assistant nodes into per-turn footer metrics.
+ *
+ * TTFT is the turn's lowest-step request-dispatch-to-first-token reading, so
+ * it is only meaningful when the turn's start is inside
+ * the loaded window (the caller gates on `turnTimings`, which shares that
+ * window). Throughput divides summed output tokens by summed decode wall time,
+ * counting only steps that carry both.
+ * @param nodes - Snapshot nodes of the loaded window.
+ * @returns Turn number → available metrics; turns with none are absent.
+ */
+export declare function deriveTurnMetrics(nodes: readonly ConversationNode[]): Map<number, TurnMetrics>;
+export {};
+//# sourceMappingURL=turn-metrics.d.ts.map

package/lib/types/client/chat/use-calendar-day.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Local calendar-day epoch that advances at each local midnight.
+ * @returns Midnight ms for the current local day; updates after the boundary.
+ */
+export declare function useCalendarDay(): number;
+//# sourceMappingURL=use-calendar-day.d.ts.map

package/lib/types/client/chat/use-throttled-visual-update.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return a stable scheduler that coalesces visual updates over a frame interval.
+ * @param update - DOM alignment to run after the throttle interval.
+ * @param intervalFrames - frames to wait before applying the latest alignment.
+ * @returns a stable function that schedules the latest update.
+ */
+export declare function useThrottledVisualUpdate(update: () => void, intervalFrames?: number): () => void;
+//# sourceMappingURL=use-throttled-visual-update.d.ts.map

package/lib/types/client/chat/useVersionNavigation.d.ts

@@ -0,0 +1,12 @@
+import type { SessionId, SessionVersionId } from '@hydraharness/harness-session/types';
+/**
+ * Serialize navigation from one version pager and preserve failures for its live region.
+ * @param open - Host-backed transcript selection.
+ * @returns Navigation callback, pending state, and the latest failure.
+ */
+export declare function useVersionNavigation(open: (id: SessionId | SessionVersionId) => void | Promise<void>): {
+    pending: boolean;
+    error: string | null;
+    navigate(id: SessionId | SessionVersionId): Promise<void>;
+};
+//# sourceMappingURL=useVersionNavigation.d.ts.map

package/lib/types/client/chat/web-citations.d.ts

@@ -0,0 +1,11 @@
+/** Citation evidence is derived from successful, preceding fetch results in the loaded transcript. */
+import type { ConversationNode } from '@hydraharness/harness-client-runtime/client';
+import type { MarkdownCitations } from '@hydraharness/harness-client-ui-primitives';
+/**
+ * Index source versions without a separate evidence database, including Code Mode subcalls.
+ * @param nodes - loaded session transcript; missing historical sources remain unresolved.
+ * @param beforeSeq - assistant message position, excluding sources retrieved later.
+ * @returns resolver accepting only exact nonempty quotes from successful recorded fetches.
+ */
+export declare function webCitations(nodes: readonly ConversationNode[], beforeSeq: number): MarkdownCitations;
+//# sourceMappingURL=web-citations.d.ts.map

package/lib/types/client/contract/chat-nodes.d.ts

@@ -0,0 +1,68 @@
+import type { AssistantBlock, AssistantMessageNode, ChatConversationViewNode, CommandNode, CompactionSummaryNode, ModelRetryNode, RunningToolCall, ToolCallBlock } from '@hydraharness/harness-client-runtime/client';
+/** Merge-extensible payload registry keyed by final Chat renderer kind. */
+export interface ChatNodeDataMap {
+}
+/** Renderer kinds contributed by the currently installed Chat business modules. */
+export type ChatNodeKind = Extract<keyof ChatNodeDataMap, string>;
+/** Final Chat Node narrowed to one registered renderer kind and payload. */
+export type ChatNode<Kind extends ChatNodeKind = ChatNodeKind> = {
+    [RegisteredKind in Kind]: ChatConversationViewNode & {
+        readonly kind: RegisteredKind;
+        readonly data: ChatNodeDataMap[RegisteredKind];
+    };
+}[Kind];
+/** Final Assistant row payload shared by streaming and settled states. */
+export interface AssistantChatData {
+    readonly status: 'running' | 'settled' | 'interrupted';
+    readonly turn: number;
+    readonly step: number;
+    readonly blocks: readonly AssistantBlock[];
+    readonly time: number;
+    readonly usage?: unknown;
+    readonly finalNode?: AssistantMessageNode;
+}
+/** Settled or interrupted Assistant payload with its durable presentation node. */
+export type FinalAssistantChatData = AssistantChatData & {
+    readonly finalNode: AssistantMessageNode;
+};
+/** Root Tool row payload; the root lifecycle owns all recursive subcalls. */
+export interface ToolChatData {
+    readonly root: ToolCallBlock;
+}
+/** One manual command and its correlated compaction transaction. */
+export interface ManualCompactionChatData {
+    readonly command: CommandNode;
+    readonly compaction: CompactionSummaryNode | null;
+}
+/** One durable retry chain rendered as a single row. */
+export interface RetryChatData {
+    readonly attempts: readonly ModelRetryNode[];
+    readonly current: ModelRetryNode;
+}
+/** Turn-local footer row that owns actions and optional feature contributions. */
+export interface TurnTailChatData {
+    readonly turn: number;
+    readonly seq: number;
+    readonly time: number;
+    /** Last finalized content-bearing Assistant in this Turn. */
+    readonly closing: FinalAssistantChatData | null;
+    /** Whether non-rendered later evidence makes the closing seq non-tail. */
+    readonly branchUnavailable: boolean;
+    readonly ttftMs?: number;
+    readonly tokensPerSecond?: number;
+}
+/**
+ * Test whether a Tool root has settled.
+ * @param block - Tool root lifecycle value.
+ * @returns whether the root carries its final result.
+ */
+export declare function isSettledTool(block: ToolCallBlock): block is Extract<ToolCallBlock, {
+    kind: 'tool-result';
+}>;
+/**
+ * Test whether a Tool root is still running.
+ * @param block - Tool root lifecycle value.
+ * @returns whether the root lacks a final result.
+ */
+export declare function isRunningTool(block: ToolCallBlock): block is RunningToolCall;
+//# sourceMappingURL=chat-nodes.d.ts.map

package/lib/types/client/contract/composer-submission.d.ts

@@ -0,0 +1,8 @@
+/** Composer submission vocabulary shared by the input and settings domains. */
+import type { BusyEnterBehavior } from '../../submission-settings.ts';
+export type { BusyEnterBehavior } from '../../submission-settings.ts';
+/** Delivery mode requested for one ordinary composer message. */
+export type InputSubmitMode = BusyEnterBehavior;
+/** Keyboard gesture whose delivery mode the submission policy resolves. */
+export type ComposerSubmitGesture = 'enter' | 'accelerated';
+//# sourceMappingURL=composer-submission.d.ts.map

package/lib/types/client/contract/prompt-edit.d.ts

@@ -0,0 +1,6 @@
+/** Browser-owned text edit admission; attachments remain unchanged. */
+/** Exact draft sent by the inline editor; the key survives retry while its contents stay unchanged. */
+export interface PromptEditOptions {
+    idempotencyKey: string;
+}
+//# sourceMappingURL=prompt-edit.d.ts.map

package/lib/types/client/contract/queue.d.ts

@@ -0,0 +1,9 @@
+/** Queue contracts derived from the runtime session face and snapshot. */
+import type { ConversationSnapshot, SessionFace } from '@hydraharness/harness-client-runtime/client';
+/** One address accepted by the runtime session's queue mutation verb. */
+export type QueueItemId = Parameters<SessionFace['updateQueue']>[0];
+/** One mutation accepted by the runtime session's queue mutation verb. */
+export type QueueAction = Parameters<SessionFace['updateQueue']>[1];
+/** One row projected by the runtime session's authoritative queue snapshot. */
+export type QueueRow = ConversationSnapshot['queue'][number];
+//# sourceMappingURL=queue.d.ts.map