@hachej/boring-agent 0.1.0

package/dist/front/index.d.ts

@@ -0,0 +1,394 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, ComponentType, HTMLAttributes, ComponentProps, FormEvent, ElementType } from 'react';
+import * as ai from 'ai';
+import { UIMessage, FileUIPart, ChatStatus } from 'ai';
+import * as _ai_sdk_react from '@ai-sdk/react';
+import { S as SendMessageInput, d as SessionSummary } from '../harness-CMiJ4kok.js';
+import { Button, Collapsible, CollapsibleContent, CollapsibleTrigger, InputGroupButton, TooltipContent, InputGroupAddon, InputGroupTextarea } from '@hachej/boring-ui-kit';
+import { Streamdown } from 'streamdown';
+import { StickToBottom } from 'use-stick-to-bottom';
+import { ClassValue } from 'clsx';
+
+type SlashCommandHandler = (args: string, ctx: SlashCommandContext) => string | void;
+interface SlashCommand {
+    name: string;
+    description: string;
+    /** 'skill' commands are forwarded to the PI agent as `skill: <name>\n\n<args>` instead of running locally. */
+    kind?: 'local' | 'skill';
+    handler: SlashCommandHandler;
+}
+interface SlashCommandContext {
+    sessionId: string;
+    clearMessages: () => void;
+    resetSession: () => void;
+    setModel: (model: string) => boolean;
+    listCommands: () => SlashCommand[];
+}
+interface CommandRegistry {
+    register(cmd: SlashCommand): void;
+    get(name: string): SlashCommand | undefined;
+    list(): SlashCommand[];
+}
+declare function createCommandRegistry(initial?: SlashCommand[]): CommandRegistry;
+
+interface DiffViewProps {
+    oldString: string;
+    newString: string;
+    path: string;
+    replaceAll?: boolean;
+}
+declare function DiffView({ oldString, newString, path, replaceAll }: DiffViewProps): react_jsx_runtime.JSX.Element;
+
+type ToolState = 'input-streaming' | 'input-available' | 'approval-requested' | 'approval-responded' | 'output-available' | 'output-error' | 'output-denied';
+
+interface ToolPart {
+    type: string;
+    toolName: string;
+    toolCallId: string;
+    state: ToolState;
+    input?: unknown;
+    output?: unknown;
+    errorText?: string;
+}
+type ToolRenderer = (part: ToolPart) => ReactNode;
+type ToolRendererOverrides = Partial<Record<string, ToolRenderer>>;
+declare const defaultToolRenderers: Record<string, ToolRenderer>;
+declare function mergeToolRenderers(overrides?: ToolRendererOverrides): Record<string, ToolRenderer>;
+declare function resolveToolRenderer(toolName: string, overrides?: ToolRendererOverrides): ToolRenderer;
+
+type OpenArtifactHandler = (path: string) => void;
+interface ArtifactOpenProviderProps {
+    onOpenArtifact?: OpenArtifactHandler;
+    children: ReactNode;
+}
+declare function ArtifactOpenProvider({ onOpenArtifact, children }: ArtifactOpenProviderProps): react_jsx_runtime.JSX.Element;
+declare function useOpenArtifact(): OpenArtifactHandler | null;
+
+/**
+ * Suggested action shown in a chat empty state. Customizable per child app
+ * via `ChatPanel.suggestions` / `ChatCenteredShell.chatSuggestions`.
+ *
+ * Click behavior: if `onSelect` is provided it wins; otherwise `prompt`
+ * (or `label` as a fallback) is sent as the next user message.
+ */
+interface ChatSuggestion {
+    /** Title shown on the suggestion card. */
+    label: string;
+    /** Smaller hint/subtitle line below the label. */
+    hint?: string;
+    /**
+     * Lucide-compatible icon component (any component that accepts className
+     * + strokeWidth). Pass `BookOpen`, `Code2`, etc. directly from lucide-react.
+     */
+    icon?: ComponentType<{
+        className?: string;
+        strokeWidth?: number;
+    }>;
+    /**
+     * Text inserted as the user's next message when the card is clicked. If
+     * omitted, falls back to `label`.
+     */
+    prompt?: string;
+    /**
+     * Override the click handler entirely. When set, `prompt` is ignored —
+     * the host decides what happens (e.g., open a wizard, prefill the
+     * composer, route somewhere).
+     */
+    onSelect?: () => void;
+}
+/**
+ * Sensible defaults that mirror the suggestions the chat-centered shell
+ * showed before the agent was wired into the workspace. Child apps that
+ * pass nothing inherit these; passing an empty array hides the grid.
+ */
+declare const defaultChatSuggestions: ChatSuggestion[];
+interface ChatEmptyStateProps {
+    /** Small uppercase eyebrow above the headline. */
+    eyebrow?: string;
+    /** Large headline. Editorial tone. */
+    title?: string;
+    /** Single-paragraph description below the headline. */
+    description?: string;
+    /**
+     * Suggestion cards. Pass `[]` to hide the grid entirely (headline still
+     * renders). Defaults to `defaultChatSuggestions`.
+     */
+    suggestions?: ChatSuggestion[];
+    /**
+     * Fired when a suggestion card is clicked. The default ChatPanel wiring
+     * resolves this to `sendMessage` with the suggestion's prompt.
+     */
+    onSelect?: (suggestion: ChatSuggestion) => void;
+    /** Optional content rendered below the suggestion grid. */
+    footer?: ReactNode;
+    className?: string;
+}
+declare function ChatEmptyState({ eyebrow, title, description, suggestions, onSelect, footer, className, }: ChatEmptyStateProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Selected model, stored as { provider, id } so the composer can speak
+ * pi-coding-agent's real registered IDs (claude-sonnet-4-6, gpt-5.2-codex,
+ * …) rather than a 3-alias shorthand. Legacy single-string values
+ * (sonnet/haiku/opus) are still honoured for back-compat.
+ */
+interface ModelSelection {
+    provider: string;
+    id: string;
+}
+interface ChatPanelProps {
+    sessionId: string;
+    toolRenderers?: ToolRendererOverrides;
+    extraCommands?: SlashCommand[];
+    onSessionReset?: () => void | Promise<void>;
+    /**
+     * Render flush, without the outer canvas tint or the inner mx/my rounded
+     * card chrome. Use when embedding ChatPanel inside a parent that already
+     * provides its own card surface (e.g. workspace's ChatCenteredShell).
+     * Defaults to `true` (standalone chrome on).
+     */
+    chrome?: boolean;
+    /**
+     * Cards shown when the conversation is empty. Click → sendMessage with the
+     * suggestion's `prompt` (or `label` as fallback). Pass `[]` to hide the
+     * grid; omit to inherit `defaultChatSuggestions`. Customizable per child
+     * app — e.g. a data-app might offer "Build a chart from a CSV" instead.
+     */
+    suggestions?: ChatSuggestion[];
+    /** Eyebrow above the empty-state headline. */
+    emptyEyebrow?: string;
+    /** Empty-state headline. */
+    emptyTitle?: string;
+    /** Empty-state description below the headline. */
+    emptyDescription?: string;
+    /**
+     * Render the extended-thinking selector in the composer footer (off / low
+     * / medium / high). When enabled, the selected level is persisted in
+     * localStorage and sent through to the agent on every turn. Default off
+     * — opt-in because not every host wants users tweaking model knobs, and
+     * thinking budget consumes more tokens.
+     */
+    thinkingControl?: boolean;
+    /**
+     * Model selected before any local user choice exists. Usually supplied by
+     * the host's /api/v1/agent/models payload, so deployment env can choose
+     * the default without rebuilding consumers.
+     */
+    defaultModel?: ModelSelection;
+    /**
+     * Tap into the SSE data stream. Called for every `onData` part the
+     * agent emits — host apps use this to bridge agent-driven file
+     * changes into their own UI plumbing (see
+     * `useAgentFileChangeBridge` in `@hachej/boring-workspace` for the
+     * canonical wire-up).
+     */
+    onData?: (part: unknown) => void;
+    /** Headers sent with chat and chat-history requests. */
+    requestHeaders?: Record<string, string>;
+    /**
+     * Called with a file path when the user clicks the path label inside
+     * a read / write / edit tool card. Hosts (e.g. @hachej/boring-workspace)
+     * supply this to open the file in the surrounding workbench. Without
+     * it the path renders as plain text. Mounted via context so any
+     * future renderer can consume it without a prop drill.
+     */
+    onOpenArtifact?: OpenArtifactHandler;
+    /**
+     * Enable the admin debug drawer — system prompt, raw messages JSON, and
+     * live onData stream events. Intended for development and ops; keep off
+     * in production consumer UIs.
+     */
+    debug?: boolean;
+    className?: string;
+}
+declare function ChatPanel(props: ChatPanelProps): react_jsx_runtime.JSX.Element;
+
+interface DebugDrawerProps {
+    sessionId: string;
+    messages: UIMessage[];
+    requestHeaders?: Record<string, string>;
+    width: number;
+    onWidthChange: (w: number) => void;
+}
+declare function DebugDrawer({ sessionId, messages, requestHeaders, width, onWidthChange }: DebugDrawerProps): react_jsx_runtime.JSX.Element;
+
+interface AgentCommandContribution {
+    id: string;
+    title: string;
+    run: () => void;
+    keywords?: string[];
+    shortcut?: string;
+    when?: () => boolean;
+    pluginId?: string;
+}
+interface AgentCommandOptions {
+    focusComposer?: () => void;
+    newChat?: () => void;
+    stopGeneration?: () => void;
+    canStopGeneration?: () => boolean;
+}
+declare function getAgentCommands(options?: AgentCommandOptions): AgentCommandContribution[];
+
+type UseAgentChatOptions = Pick<SendMessageInput, 'sessionId' | 'model' | 'thinkingLevel'> & {
+    onData?: (part: unknown) => void;
+    requestHeaders?: Record<string, string>;
+};
+declare function useAgentChat(opts: UseAgentChatOptions): _ai_sdk_react.UseChatHelpers<UIMessage<unknown, ai.UIDataTypes, ai.UITools>>;
+
+interface UseSessionsOptions {
+    requestHeaders?: Record<string, string>;
+    storageKey?: string;
+}
+interface UseSessionsResult {
+    sessions: SessionSummary[];
+    activeSession: SessionSummary | undefined;
+    activeSessionId: string | undefined;
+    loading: boolean;
+    error: Error | undefined;
+    create: (init?: {
+        title?: string;
+    }) => Promise<SessionSummary>;
+    switch: (id: string) => void;
+    delete: (id: string) => Promise<void>;
+}
+declare function useSessions(opts?: UseSessionsOptions): UseSessionsResult;
+
+interface ParsedCommand {
+    name: string;
+    args: string;
+}
+declare function parseSlashCommand(text: string): ParsedCommand | null;
+
+declare const builtinCommands: SlashCommand[];
+
+declare function mergeShadcnToolRenderers(overrides?: ToolRendererOverrides): Record<string, ToolRenderer>;
+
+type GroupedToolEntry = {
+    part: UIMessage['parts'][number];
+    key: string;
+};
+interface ToolCallGroupProps {
+    tools: GroupedToolEntry[];
+    mergedToolRenderers: ToolRendererOverrides;
+}
+declare const ToolCallGroup: react.MemoExoticComponent<({ tools, mergedToolRenderers }: ToolCallGroupProps) => react_jsx_runtime.JSX.Element>;
+
+type MessageProps = HTMLAttributes<HTMLDivElement> & {
+    from: UIMessage["role"];
+};
+declare const Message: ({ className, from, ...props }: MessageProps) => react_jsx_runtime.JSX.Element;
+type MessageContentProps = HTMLAttributes<HTMLDivElement>;
+declare const MessageContent: ({ children, className, ...props }: MessageContentProps) => react_jsx_runtime.JSX.Element;
+type MessageActionsProps = ComponentProps<"div">;
+declare const MessageActions: ({ className, children, ...props }: MessageActionsProps) => react_jsx_runtime.JSX.Element;
+type MessageActionProps = ComponentProps<typeof Button> & {
+    tooltip?: string;
+    label?: string;
+};
+declare const MessageAction: ({ tooltip, children, label, variant, size, ...props }: MessageActionProps) => react_jsx_runtime.JSX.Element;
+type MessageResponseProps = ComponentProps<typeof Streamdown>;
+declare const MessageResponse: react.MemoExoticComponent<({ className, shikiTheme, components, ...props }: MessageResponseProps) => react_jsx_runtime.JSX.Element>;
+type MessageToolbarProps = ComponentProps<"div">;
+declare const MessageToolbar: ({ className, children, ...props }: MessageToolbarProps) => react_jsx_runtime.JSX.Element;
+
+type ConversationProps = ComponentProps<typeof StickToBottom>;
+declare const Conversation: ({ className, ...props }: ConversationProps) => react_jsx_runtime.JSX.Element;
+type ConversationContentProps = ComponentProps<typeof StickToBottom.Content>;
+declare const ConversationContent: ({ className, ...props }: ConversationContentProps) => react_jsx_runtime.JSX.Element;
+type ConversationEmptyStateProps = ComponentProps<"div"> & {
+    title?: string;
+    description?: string;
+    icon?: React.ReactNode;
+};
+declare const ConversationEmptyState: ({ className, title, description, icon, children, ...props }: ConversationEmptyStateProps) => react_jsx_runtime.JSX.Element;
+type ConversationScrollButtonProps = ComponentProps<typeof Button>;
+declare const ConversationScrollButton: ({ className, ...props }: ConversationScrollButtonProps) => false | react_jsx_runtime.JSX.Element;
+
+type ReasoningProps = ComponentProps<typeof Collapsible> & {
+    isStreaming?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    duration?: number;
+};
+declare const Reasoning: react.MemoExoticComponent<({ className, isStreaming, open, defaultOpen, onOpenChange, duration: durationProp, children, ...props }: ReasoningProps) => react_jsx_runtime.JSX.Element>;
+type ReasoningTriggerProps = ComponentProps<typeof CollapsibleTrigger> & {
+    getThinkingMessage?: (isStreaming: boolean, duration?: number) => ReactNode;
+};
+declare const ReasoningTrigger: react.MemoExoticComponent<({ className, children, getThinkingMessage, ...props }: ReasoningTriggerProps) => react_jsx_runtime.JSX.Element>;
+type ReasoningContentProps = ComponentProps<typeof CollapsibleContent> & {
+    children: string;
+};
+declare const ReasoningContent: react.MemoExoticComponent<({ className, children, ...props }: ReasoningContentProps) => react_jsx_runtime.JSX.Element>;
+
+type CodeBlockProps = HTMLAttributes<HTMLDivElement> & {
+    code: string;
+    language: string;
+    showLineNumbers?: boolean;
+};
+declare const CodeBlockContainer: ({ className, language, style, ...props }: HTMLAttributes<HTMLDivElement> & {
+    language: string;
+}) => react_jsx_runtime.JSX.Element;
+declare const CodeBlockHeader: ({ children, className, ...props }: HTMLAttributes<HTMLDivElement>) => react_jsx_runtime.JSX.Element;
+declare const CodeBlockContent: ({ code, language, showLineNumbers, }: {
+    code: string;
+    language: string;
+    showLineNumbers?: boolean;
+}) => react_jsx_runtime.JSX.Element;
+declare const CodeBlock: ({ code, language, showLineNumbers, className, children, ...props }: CodeBlockProps) => react_jsx_runtime.JSX.Element;
+type CodeBlockCopyButtonProps = ComponentProps<typeof Button> & {
+    onCopy?: () => void;
+    onError?: (error: Error) => void;
+    timeout?: number;
+};
+declare const CodeBlockCopyButton: ({ onCopy, onError, timeout, children, className, ...props }: CodeBlockCopyButtonProps) => react_jsx_runtime.JSX.Element;
+
+interface PromptInputMessage {
+    text: string;
+    files: FileUIPart[];
+}
+type PromptInputProps = Omit<HTMLAttributes<HTMLFormElement>, "onSubmit" | "onError"> & {
+    accept?: string;
+    multiple?: boolean;
+    globalDrop?: boolean;
+    syncHiddenInput?: boolean;
+    maxFiles?: number;
+    maxFileSize?: number;
+    onError?: (err: {
+        code: "max_files" | "max_file_size" | "accept";
+        message: string;
+    }) => void;
+    onSubmit: (message: PromptInputMessage, event: FormEvent<HTMLFormElement>) => void | Promise<void>;
+};
+declare const PromptInput: ({ className, accept, multiple, globalDrop, syncHiddenInput, maxFiles, maxFileSize, onError, onSubmit, children, ...props }: PromptInputProps) => react_jsx_runtime.JSX.Element;
+type PromptInputTextareaProps = ComponentProps<typeof InputGroupTextarea>;
+declare const PromptInputTextarea: ({ onChange, onKeyDown, className, placeholder, ...props }: PromptInputTextareaProps) => react_jsx_runtime.JSX.Element;
+type PromptInputFooterProps = Omit<ComponentProps<typeof InputGroupAddon>, "align">;
+declare const PromptInputFooter: ({ className, ...props }: PromptInputFooterProps) => react_jsx_runtime.JSX.Element;
+type PromptInputButtonTooltip = string | {
+    content: ReactNode;
+    shortcut?: string;
+    side?: ComponentProps<typeof TooltipContent>["side"];
+};
+type PromptInputButtonProps = ComponentProps<typeof InputGroupButton> & {
+    tooltip?: PromptInputButtonTooltip;
+};
+declare const PromptInputButton: ({ variant, className, size, tooltip, ...props }: PromptInputButtonProps) => react_jsx_runtime.JSX.Element;
+type PromptInputSubmitProps = ComponentProps<typeof InputGroupButton> & {
+    status?: ChatStatus;
+    onStop?: () => void;
+};
+declare const PromptInputSubmit: ({ className, variant, size, status, onStop, onClick, children, ...props }: PromptInputSubmitProps) => react_jsx_runtime.JSX.Element;
+
+interface TextShimmerProps {
+    children: string;
+    as?: ElementType;
+    className?: string;
+    duration?: number;
+    spread?: number;
+}
+declare const Shimmer: react.MemoExoticComponent<({ children, as: Component, className, duration, spread, }: TextShimmerProps) => react_jsx_runtime.JSX.Element>;
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { type AgentCommandContribution, type AgentCommandOptions, ArtifactOpenProvider, ChatEmptyState, type ChatEmptyStateProps, ChatPanel, type ChatPanelProps, type ChatSuggestion, CodeBlock, CodeBlockContainer, CodeBlockContent, CodeBlockCopyButton, CodeBlockHeader, type CommandRegistry, Conversation, ConversationContent, ConversationEmptyState, ConversationScrollButton, DebugDrawer, DiffView, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, MessageToolbar, type OpenArtifactHandler, type ParsedCommand, PromptInput, PromptInputButton, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, Reasoning, ReasoningContent, ReasoningTrigger, Shimmer, type SlashCommand, type SlashCommandContext, ToolCallGroup, type ToolPart, type ToolRenderer, type ToolRendererOverrides, type UseAgentChatOptions, type UseSessionsOptions, type UseSessionsResult, builtinCommands, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, getAgentCommands, mergeShadcnToolRenderers, mergeToolRenderers, parseSlashCommand, resolveToolRenderer, useAgentChat, useOpenArtifact, useSessions };