@couplet/agent-ui 1.0.0

package/dist/types-rklAgjcr.d.ts

@@ -0,0 +1,219 @@
+type AgentMessageRole = 'user' | 'assistant' | 'system';
+type AgentStatus = 'idle' | 'streaming' | 'retrying' | 'error';
+type ChainNodeType = 'thinking' | 'tool_call' | 'tool_result' | 'user_reply' | 'final' | 'task_plan' | 'task_update' | 'goal';
+interface AgentClarify {
+    readonly question: string;
+    readonly options?: readonly string[];
+}
+interface AgentPendingClarify {
+    readonly question: string;
+    readonly options: readonly string[];
+    readonly chainReplyTo: string;
+}
+interface AgentToolCallFunction {
+    readonly name: string;
+    readonly arguments: string;
+}
+interface AgentToolCall {
+    readonly index: number;
+    readonly id: string;
+    readonly type: string;
+    readonly function: AgentToolCallFunction;
+}
+interface ChainNode {
+    readonly id: string;
+    readonly type: ChainNodeType;
+    readonly title?: string;
+    readonly content?: string;
+    readonly tool_name?: string;
+    readonly tool_input?: Record<string, unknown>;
+    readonly tool_output?: Record<string, unknown>;
+    readonly parent_id?: string;
+    readonly created_at?: string;
+}
+interface AgentMessage {
+    readonly id: string;
+    readonly role: AgentMessageRole;
+    readonly content: string;
+    readonly reasoning?: string;
+    readonly toolCalls?: readonly AgentToolCall[];
+    readonly type?: 'message' | 'clarify' | 'plan' | 'access' | 'error' | 'chain';
+    readonly clarify?: AgentClarify;
+    readonly chain?: readonly ChainNode[];
+    readonly createdAt: number;
+    readonly error?: boolean;
+    readonly chainReplyTo?: string;
+}
+interface AgentSession {
+    readonly id: string;
+    readonly title: string;
+    readonly project: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly messages: readonly AgentMessage[];
+}
+interface ContextUsageCategory {
+    readonly id: string;
+    readonly label: string;
+    readonly tokens: number;
+}
+interface ContextUsage {
+    readonly budget_tokens: number;
+    readonly used_tokens: number;
+    readonly used_percent: number;
+    readonly categories: readonly ContextUsageCategory[];
+    readonly source?: 'estimated' | 'provider';
+    readonly estimated_tokens?: number;
+    readonly prompt_tokens?: number;
+}
+interface AgentStreamRequest {
+    readonly session_id: string;
+    readonly message: {
+        readonly role: 'user';
+        readonly content: string;
+    };
+    readonly stream: true;
+    readonly chain_reply_to?: string;
+}
+interface StreamEventBase {
+    readonly kind: string;
+}
+interface MessageChunkEvent extends StreamEventBase {
+    readonly kind: 'MessageChunk';
+    readonly text: string;
+}
+interface MessageStopEvent extends StreamEventBase {
+    readonly kind: 'MessageStop';
+    readonly final: boolean;
+}
+interface ThinkingChunkEvent extends StreamEventBase {
+    readonly kind: 'ThinkingChunk';
+    readonly content: string;
+    readonly node_id?: string | null;
+}
+interface ToolCallFinishedEvent extends StreamEventBase {
+    readonly kind: 'ToolCallFinished';
+    readonly tool_name: string;
+    readonly duration: number;
+    readonly ok: boolean;
+    readonly index: number;
+}
+interface ToolCallEvent extends StreamEventBase {
+    readonly kind: 'ToolCallEvent';
+    readonly node_id: string;
+    readonly tool_name: string;
+    readonly tool_input?: Record<string, unknown> | null;
+    readonly title?: string | null;
+}
+interface ToolResultEvent extends StreamEventBase {
+    readonly kind: 'ToolResultEvent';
+    readonly node_id: string;
+    readonly tool_name: string;
+    readonly tool_output?: Record<string, unknown> | null;
+    readonly title?: string | null;
+}
+interface UserReplyEvent extends StreamEventBase {
+    readonly kind: 'UserReplyEvent';
+    readonly node_id: string;
+    readonly content: string;
+    readonly parent_id?: string | null;
+}
+interface ClarifyEvent extends StreamEventBase {
+    readonly kind: 'ClarifyEvent';
+    readonly node_id: string;
+    readonly question: string;
+    readonly options: readonly string[];
+}
+interface FinalEvent extends StreamEventBase {
+    readonly kind: 'FinalEvent';
+    readonly node_id: string;
+    readonly content: string;
+}
+interface RetryingEvent extends StreamEventBase {
+    readonly kind: 'Retrying';
+    readonly attempt: number;
+    readonly max_retries: number;
+    readonly delay: number;
+    readonly reason: string;
+}
+interface ContextCompressedEvent extends StreamEventBase {
+    readonly kind: 'ContextCompressed';
+}
+interface LongToolHintEvent extends StreamEventBase {
+    readonly kind: 'LongToolHint';
+    readonly tool_name: string;
+    readonly duration: number;
+}
+interface FatalErrorEvent extends StreamEventBase {
+    readonly kind: 'FatalError';
+    readonly message: string;
+}
+interface ContextUsageEvent extends StreamEventBase {
+    readonly kind: 'ContextUsageEvent';
+    readonly budget_tokens: number;
+    readonly used_tokens: number;
+    readonly used_percent: number;
+    readonly categories: readonly {
+        readonly id: string;
+        readonly label: string;
+        readonly tokens: number;
+    }[];
+    readonly source?: 'estimated' | 'provider';
+    readonly estimated_tokens?: number;
+    readonly prompt_tokens?: number;
+}
+interface OpenPageEvent extends StreamEventBase {
+    readonly kind: 'OpenPageEvent';
+    readonly url: string;
+    readonly title?: string | null;
+}
+interface OpenExternalLinkEvent extends StreamEventBase {
+    readonly kind: 'OpenExternalLinkEvent';
+    readonly url: string;
+    readonly title?: string | null;
+}
+type AgentNavigationEvent = OpenPageEvent | OpenExternalLinkEvent;
+type StreamEvent = MessageChunkEvent | MessageStopEvent | ThinkingChunkEvent | ToolCallFinishedEvent | ToolCallEvent | ToolResultEvent | UserReplyEvent | ClarifyEvent | FinalEvent | RetryingEvent | ContextCompressedEvent | LongToolHintEvent | FatalErrorEvent | ContextUsageEvent | OpenPageEvent | OpenExternalLinkEvent;
+
+interface AgentTransport {
+    request<T>(url: string, init?: RequestInit): Promise<T>;
+    requestStream(url: string, init?: RequestInit): Promise<Response>;
+}
+interface AgentEndpoints {
+    readonly createSession: string;
+    readonly sessions: string;
+    readonly completions: string;
+}
+interface ChatSessionListItem {
+    readonly id: string;
+    readonly title?: string | null;
+    readonly is_active?: boolean;
+    readonly created_at?: string | null;
+    readonly updated_at?: string | null;
+    readonly message_count?: number;
+}
+interface AgentClient {
+    readonly endpoints: AgentEndpoints;
+    createSession(): Promise<string>;
+    listSessions(): Promise<readonly ChatSessionListItem[]>;
+    loadLatestSession(): Promise<{
+        sessionId: string;
+        messages: AgentMessage[];
+    }>;
+    getSessionDetail(sessionId: string): Promise<AgentSession>;
+    fetchContextUsage(sessionId: string): Promise<ContextUsage>;
+    sendMessageStream(options: {
+        readonly request: AgentStreamRequest;
+        readonly signal?: AbortSignal;
+        readonly onEvent: (event: StreamEvent) => void;
+    }): Promise<void>;
+}
+interface ChatSessionListResponse {
+    readonly sessions: ChatSessionListItem[];
+}
+interface CreateAgentClientOptions {
+    readonly transport: AgentTransport;
+    readonly endpoints?: Partial<AgentEndpoints>;
+}
+
+export type { AgentSession as A, ToolCallFinishedEvent as B, ContextUsage as C, ToolResultEvent as D, FatalErrorEvent as F, LongToolHintEvent as L, MessageChunkEvent as M, OpenExternalLinkEvent as O, RetryingEvent as R, StreamEvent as S, ThinkingChunkEvent as T, UserReplyEvent as U, AgentStatus as a, AgentClient as b, AgentNavigationEvent as c, AgentPendingClarify as d, AgentClarify as e, AgentEndpoints as f, AgentMessage as g, AgentMessageRole as h, AgentStreamRequest as i, AgentToolCall as j, AgentToolCallFunction as k, AgentTransport as l, ChainNode as m, ChainNodeType as n, ChatSessionListItem as o, ChatSessionListResponse as p, ClarifyEvent as q, ContextCompressedEvent as r, ContextUsageCategory as s, ContextUsageEvent as t, CreateAgentClientOptions as u, FinalEvent as v, MessageStopEvent as w, OpenPageEvent as x, StreamEventBase as y, ToolCallEvent as z };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@couplet/agent-ui",
+  "version": "1.0.0",
+  "description": "TurboMesh Agent conversation UI and session runtime",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    }
+  },
+  "dependencies": {
+    "clsx": "catalog:",
+    "lucide-react": "catalog:",
+    "react-markdown": "catalog:",
+    "tailwind-merge": "catalog:"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "swr": "catalog:",
+    "tsup": "^8.5.0",
+    "typescript": "catalog:",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "swr": "^2.0.0"
+  }
+}