@codespring-app/use-agent 0.1.0

package/dist/react.d.ts

@@ -0,0 +1,212 @@
+import * as react from 'react';
+import { CSSProperties, ReactNode, PropsWithChildren } from 'react';
+import { a as AgentClient, f as AgentSession, S as SessionSnapshot, d as AgentEvent, k as SubmitOptions, l as SubmitTurnResponse, B as BrowserAgentClientOptions } from './client-Bz3eVQXx.js';
+export { m as createBrowserClient } from './client-Bz3eVQXx.js';
+
+interface AgentTheme {
+    canvas: string;
+    ink: string;
+    inkSecondary: string;
+    inkTertiary: string;
+    well: string;
+    hairline: string;
+    statusGood: string;
+    statusBad: string;
+    statusWarn: string;
+    accent: string;
+    fontFamily: string;
+    monoFamily: string;
+    contentMaxWidth: number | string;
+    containerRadius: number | string;
+    wellRadius: number | string;
+}
+/** Stable CSS custom-property names supported by every default component. */
+declare const agentThemeVariables: Readonly<{
+    canvas: "--codespring-agent-canvas";
+    ink: "--codespring-agent-ink";
+    inkSecondary: "--codespring-agent-ink-secondary";
+    inkTertiary: "--codespring-agent-ink-tertiary";
+    well: "--codespring-agent-well";
+    hairline: "--codespring-agent-hairline";
+    statusGood: "--codespring-agent-status-good";
+    statusBad: "--codespring-agent-status-bad";
+    statusWarn: "--codespring-agent-status-warn";
+    accent: "--codespring-agent-accent";
+    fontFamily: "--codespring-agent-font-family";
+    monoFamily: "--codespring-agent-mono-family";
+    contentMaxWidth: "--codespring-agent-content-max-width";
+    containerRadius: "--codespring-agent-container-radius";
+    wellRadius: "--codespring-agent-well-radius";
+}>;
+interface AgentCopy {
+    title: string;
+    empty: string;
+    loading: string;
+    thinking: string;
+    placeholder: string;
+    send: string;
+    sending: string;
+    failed: string;
+    cancelled: string;
+    userLabel: string;
+    assistantLabel: string;
+    toolRunning: string;
+    toolCompleted: string;
+    toolFailed: string;
+    toolApprovalRequired: string;
+}
+declare const paperLightTheme: Readonly<AgentTheme>;
+declare const paperDarkTheme: Readonly<AgentTheme>;
+declare const defaultAgentCopy: Readonly<AgentCopy>;
+interface AgentAppearance {
+    readonly theme: Readonly<AgentTheme>;
+    readonly copy: Readonly<AgentCopy>;
+}
+interface CreateAgentAppearanceOptions {
+    mode?: "light" | "dark";
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+declare function createAgentAppearance({ mode, theme, copy, }?: CreateAgentAppearanceOptions): AgentAppearance;
+declare const paperAppearance: AgentAppearance;
+declare const paperDarkAppearance: AgentAppearance;
+interface AgentContextValue {
+    client: AgentClient;
+    theme: AgentTheme;
+    copy: AgentCopy;
+    stores: Map<string, SessionStore>;
+}
+interface AgentProviderProps extends PropsWithChildren {
+    client: AgentClient;
+    appearance?: AgentAppearance;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+declare function AgentProvider({ client, appearance, theme, copy, children, }: AgentProviderProps): react.FunctionComponentElement<react.ProviderProps<AgentContextValue | null>>;
+declare function useAgentClient(): AgentClient;
+interface CreateAgentClientOptions {
+    endpoint: string;
+    clientTokenEndpoint: string;
+    fetch?: BrowserAgentClientOptions["fetch"];
+    credentials?: RequestCredentials;
+    clientTokenTtlMs?: number;
+    refreshSkewMs?: number;
+}
+/** Creates one stable browser client with an in-memory, deduplicated client-token cache. */
+declare function createAgentClient({ endpoint, clientTokenEndpoint, fetch: fetchImplementation, credentials, clientTokenTtlMs, refreshSkewMs, }: CreateAgentClientOptions): AgentClient;
+declare function useAgentTheme(): AgentTheme;
+declare function useAgentCopy(): AgentCopy;
+type AgentMessageStatus = "completed" | "streaming" | "failed" | "cancelled";
+interface AgentChatMessage {
+    id: string;
+    turnId: string;
+    role: "user" | "assistant";
+    content: string;
+    status: AgentMessageStatus;
+    createdAt: string;
+    eventId: number;
+}
+type AgentToolCallStatus = "proposed" | "running" | "completed" | "failed" | "approval_required";
+/** Pure reducer for consumers that want CodeSpring's durable event semantics with custom UI. */
+declare function reduceAgentMessages(events: readonly AgentEvent[]): AgentChatMessage[];
+/** Pure reducer for durable server, MCP, and client tool activity. */
+declare function reduceAgentToolCalls(events: readonly AgentEvent[]): AgentToolCall[];
+interface SessionState {
+    status: "idle" | "loading" | "ready" | "error";
+    snapshot: SessionSnapshot | null;
+    events: AgentEvent[];
+    messages: AgentChatMessage[];
+    toolCalls: AgentToolCall[];
+    error: Error | null;
+}
+declare class SessionStore {
+    readonly session: AgentSession;
+    private state;
+    private readonly listeners;
+    private controller;
+    private refreshTimer;
+    constructor(session: AgentSession);
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => SessionState;
+    getServerSnapshot: () => SessionState;
+    private setState;
+    private scheduleRefresh;
+    refresh(): Promise<void>;
+    dispose(): void;
+}
+interface AgentSessionResult extends SessionState {
+    session: AgentSession;
+    refresh: () => Promise<void>;
+    submit: (content: string, options?: SubmitOptions) => Promise<SubmitTurnResponse>;
+    cancel: (turnId: string) => Promise<void>;
+}
+declare function useAgentSession(sessionId: string): AgentSessionResult;
+declare function useAgentMessages(sessionId: string): AgentChatMessage[];
+declare function useAgentToolCalls(sessionId: string): AgentToolCall[];
+interface StyledProps {
+    className?: string;
+    style?: CSSProperties;
+}
+interface AgentMessageProps extends StyledProps {
+    message: AgentChatMessage;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+declare function AgentMessage({ message, className, style, theme, copy }: AgentMessageProps): react.JSX.Element;
+interface AgentToolCallProps extends StyledProps {
+    toolCall: AgentToolCall;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+interface AgentToolCall {
+    id: string;
+    turnId: string;
+    name: string;
+    label: string;
+    summary?: string;
+    status: AgentToolCallStatus;
+    input?: unknown;
+    output?: unknown;
+    createdAt: string;
+    eventId: number;
+}
+declare function AgentToolCall({ toolCall, className, style, theme, copy }: AgentToolCallProps): react.JSX.Element;
+interface AgentMessageListProps extends StyledProps {
+    messages: readonly AgentChatMessage[];
+    toolCalls?: readonly AgentToolCall[];
+    isWorking?: boolean;
+    renderMessage?: (message: AgentChatMessage) => ReactNode;
+    renderToolCall?: (toolCall: AgentToolCall) => ReactNode;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+declare function AgentMessageList({ messages, toolCalls, isWorking, renderMessage, renderToolCall, className, style, theme, copy, }: AgentMessageListProps): react.JSX.Element;
+interface AgentComposerProps extends StyledProps {
+    value: string;
+    onChange: (value: string) => void;
+    onSubmit: () => void | Promise<void>;
+    disabled?: boolean;
+    error?: string | null;
+    leadingActions?: ReactNode;
+    trailingActions?: ReactNode;
+    onCancel?: () => void | Promise<void>;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+}
+declare function AgentComposer({ value, onChange, onSubmit, disabled, error, leadingActions, trailingActions, onCancel, className, style, theme, copy, }: AgentComposerProps): react.JSX.Element;
+interface AgentChatProps extends StyledProps {
+    sessionId: string;
+    header?: ReactNode;
+    composerLeadingActions?: ReactNode;
+    composerTrailingActions?: ReactNode;
+    /** @deprecated Prefer the header slot; the default chat has no header. */
+    title?: string;
+    theme?: Partial<AgentTheme>;
+    copy?: Partial<AgentCopy>;
+    renderMessage?: (message: AgentChatMessage) => ReactNode;
+    renderToolCall?: (toolCall: AgentToolCall) => ReactNode;
+    onError?: (error: Error) => void;
+}
+declare function AgentChat({ sessionId, header, composerLeadingActions, composerTrailingActions, title, className, style, theme, copy, renderMessage, renderToolCall, onError, }: AgentChatProps): react.JSX.Element;
+
+export { type AgentAppearance, AgentChat, type AgentChatMessage, type AgentChatProps, AgentComposer, type AgentComposerProps, type AgentCopy, AgentMessage, AgentMessageList, type AgentMessageListProps, type AgentMessageProps, type AgentMessageStatus, AgentProvider, type AgentProviderProps, type AgentSessionResult, type AgentTheme, AgentToolCall, type AgentToolCallProps, type AgentToolCallStatus, BrowserAgentClientOptions, type CreateAgentAppearanceOptions, type CreateAgentClientOptions, SessionSnapshot, agentThemeVariables, createAgentAppearance, createAgentClient, defaultAgentCopy, paperAppearance, paperDarkAppearance, paperDarkTheme, paperLightTheme, reduceAgentMessages, reduceAgentToolCalls, useAgentClient, useAgentCopy, useAgentMessages, useAgentSession, useAgentTheme, useAgentToolCalls };