@echothink-ui/agent 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @echothink-ui/agent
+
+Agent package for EchoThink app-domain websites.
+
+This package is part of the EchoThink-UI app-domain library. It is designed for normal website app domains rendered inside EchoThink Studio's Chromium shell, not for implementing the studio browser chrome itself.

package/dist/components/AgentApprovalGate.d.ts

@@ -0,0 +1,10 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentApprovalAction, AgentCitation } from "../types";
+export interface AgentApprovalGateProps extends Omit<SurfaceComponentProps, "children"> {
+    action: AgentApprovalAction;
+    evidence?: AgentCitation[];
+    onApprove?: (reason?: string) => void;
+    onReject?: (reason?: string) => void;
+    state?: "idle" | "pending" | "approved" | "rejected";
+}
+export declare function AgentApprovalGate({ action, evidence, onApprove, onReject, state, title, className, ...props }: AgentApprovalGateProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentContextViewer.d.ts

@@ -0,0 +1,7 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentContextSource } from "../types";
+export interface AgentContextViewerProps extends Omit<SurfaceComponentProps, "children" | "onSelect"> {
+    sources: AgentContextSource[];
+    onSelect?: (source: AgentContextSource) => void;
+}
+export declare function AgentContextViewer({ sources, onSelect, title, className, ...props }: AgentContextViewerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentGeneratedArtifactPanel.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentGeneratedArtifact } from "../types";
+export interface AgentGeneratedArtifactPanelProps extends Omit<SurfaceComponentProps, "children" | "onSelect"> {
+    artifacts: AgentGeneratedArtifact[];
+    onSelect?: (artifact: AgentGeneratedArtifact) => void;
+    selectedId?: string;
+}
+export declare function AgentGeneratedArtifactPanel({ artifacts, onSelect, selectedId, density, title, className, ...props }: AgentGeneratedArtifactPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentHandoffPanel.d.ts

@@ -0,0 +1,22 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentHandoffTarget } from "../types";
+export interface AgentHandoffPanelProps extends Omit<SurfaceComponentProps, "children" | "onChange" | "onSubmit"> {
+    itemRef?: string;
+    agentRef?: string;
+    assigneeOptions?: AgentHandoffTarget[];
+    selectedAssigneeId?: string;
+    reason?: string;
+    reasonSchema?: {
+        label?: string;
+        placeholder?: string;
+        required?: boolean;
+    };
+    disabled?: boolean;
+    onAssigneeChange?: (id: string) => void;
+    onReasonChange?: (reason: string) => void;
+    onSubmit?: (handoff: {
+        assigneeId?: string;
+        reason: string;
+    }) => void;
+}
+export declare function AgentHandoffPanel({ itemRef, agentRef, assigneeOptions, selectedAssigneeId, reason, reasonSchema, disabled, onAssigneeChange, onReasonChange, onSubmit, title, className, ...props }: AgentHandoffPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentInterruptionPanel.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+export interface AgentInterruptionPanelProps extends Omit<SurfaceComponentProps, "children" | "onChange" | "onSubmit"> {
+    prompt: string;
+    onChange: (prompt: string) => void;
+    onSubmit?: (prompt: string) => void;
+    disabled?: boolean;
+    promptLabel?: React.ReactNode;
+    helperText?: React.ReactNode;
+    placeholder?: string;
+    submitLabel?: React.ReactNode;
+}
+export declare function AgentInterruptionPanel({ prompt, onChange, onSubmit, disabled, title, subtitle, metadata, promptLabel, helperText, placeholder, submitLabel, className, ...props }: AgentInterruptionPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentMemoryPanel.d.ts

@@ -0,0 +1,9 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentMemoryEntry } from "../types";
+export interface AgentMemoryPanelProps extends Omit<SurfaceComponentProps, "children"> {
+    entries: AgentMemoryEntry[];
+    onPin?: (id: string) => void;
+    onEdit?: (id: string) => void;
+    onDelete?: (id: string) => void;
+}
+export declare function AgentMemoryPanel({ entries, onPin, onEdit, onDelete, title, subtitle, className, ...props }: AgentMemoryPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentMessageList.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+import type { AgentMessage } from "../types";
+export interface AgentMessageListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    messages: AgentMessage[];
+    streaming?: boolean;
+    autoScroll?: boolean;
+}
+export declare function AgentMessageList({ messages, streaming, autoScroll, className, style, ...props }: AgentMessageListProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentPlanDiff.d.ts

@@ -0,0 +1,7 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentPlanStep } from "../types";
+export interface AgentPlanDiffProps extends Omit<SurfaceComponentProps, "children"> {
+    before: AgentPlanStep[];
+    after: AgentPlanStep[];
+}
+export declare function AgentPlanDiff({ before, after, title, subtitle, className, ...props }: AgentPlanDiffProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentPlanPreview.d.ts

@@ -0,0 +1,6 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentPlan } from "../types";
+export interface AgentPlanPreviewProps extends Omit<SurfaceComponentProps, "children"> {
+    plan: AgentPlan;
+}
+export declare function AgentPlanPreview({ plan, title, className, ...props }: AgentPlanPreviewProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentPromptBox.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import type { AgentScopeAttachment } from "../types";
+export interface AgentPromptBoxProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, "children" | "onChange" | "onSubmit"> {
+    value: string;
+    onChange: (value: string) => void;
+    onSubmit?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    scopeLabel?: React.ReactNode;
+    attachments?: AgentScopeAttachment[];
+    onAttach?: () => void;
+    onAttachmentRemove?: (id: string) => void;
+    onSlash?: () => void;
+}
+export declare function AgentPromptBox({ value, onChange, onSubmit, placeholder, disabled, scopeLabel, attachments, onAttach, onAttachmentRemove, onSlash, className, style, ...props }: AgentPromptBoxProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentRunControls.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+export interface AgentRunControlsProps extends Omit<React.HTMLAttributes<HTMLElement>, "children" | "onChange"> {
+    state: "running" | "paused" | "stopped" | "failed" | "completed";
+    onPause?: () => void;
+    onResume?: () => void;
+    onStop?: () => void;
+    onRetry?: () => void;
+    onInterrupt?: (reason: string) => void;
+}
+export declare function AgentRunControls({ state, onPause, onResume, onStop, onRetry, onInterrupt, className, style, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, ...props }: AgentRunControlsProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentSafetyPanel.d.ts

@@ -0,0 +1,6 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentSafetyCheck } from "../types";
+export interface AgentSafetyPanelProps extends Omit<SurfaceComponentProps, "children"> {
+    checks: AgentSafetyCheck[];
+}
+export declare function AgentSafetyPanel({ checks, title, subtitle, className, ...props }: AgentSafetyPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentStateBadge.d.ts

@@ -0,0 +1,6 @@
+import * as React from "react";
+import type { AgentRunState } from "../types";
+export interface AgentStateBadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    state?: AgentRunState;
+}
+export declare function AgentStateBadge({ state, className, ...props }: AgentStateBadgeProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentThinkingChain.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentStep } from "../types";
+export interface AgentThinkingChainProps extends Omit<SurfaceComponentProps, "children"> {
+    steps: AgentStep[];
+    streaming?: boolean;
+    redactionPolicy?: string;
+}
+export declare function AgentThinkingChain({ steps, streaming, redactionPolicy, title, className, ...props }: AgentThinkingChainProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentThinkingPanel.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+export interface AgentThinkingPanelProps extends Omit<SurfaceComponentProps, "children"> {
+    currentStep?: string;
+    summary?: string;
+    progress?: number;
+    lastUpdatedAt?: string;
+}
+export declare function AgentThinkingPanel({ currentStep, summary, progress, lastUpdatedAt, title, subtitle, metadata, className, ...props }: AgentThinkingPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentToolCallLog.d.ts

@@ -0,0 +1,7 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentToolCall } from "../types";
+export interface AgentToolCallLogProps extends Omit<SurfaceComponentProps, "children" | "onSelect"> {
+    calls: AgentToolCall[];
+    onSelect?: (call: AgentToolCall) => void;
+}
+export declare function AgentToolCallLog({ calls, onSelect, title, subtitle, className, ...props }: AgentToolCallLogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AgentTraceViewer.d.ts

@@ -0,0 +1,6 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentTraceSpan } from "../types";
+export interface AgentTraceViewerProps extends Omit<SurfaceComponentProps, "children"> {
+    spans: AgentTraceSpan[];
+}
+export declare function AgentTraceViewer({ spans, title, className, ...props }: AgentTraceViewerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/AppDomainAgentPanel.d.ts

@@ -0,0 +1,17 @@
+import * as React from "react";
+import type { AgentMessage, AgentRunState, ChatAgentRailAttachment } from "../types";
+export interface AppDomainAgentPanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "children" | "onSubmit"> {
+    appDomainRef: string;
+    agentRef?: string;
+    projectRef?: string;
+    messages?: AgentMessage[];
+    state?: AgentRunState;
+    prompt?: string;
+    onPromptChange?: (value: string) => void;
+    onSubmit?: (prompt: string, attachments?: ChatAgentRailAttachment[]) => void;
+    attachments?: ChatAgentRailAttachment[];
+    onAttachmentRemove?: (id: string) => void;
+    runControls?: React.ReactNode;
+    children?: React.ReactNode;
+}
+export declare function AppDomainAgentPanel({ appDomainRef, agentRef, projectRef, messages, state, prompt, onPromptChange, onSubmit, attachments, onAttachmentRemove, runControls, children, ...props }: AppDomainAgentPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ChatAgentRail.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import type { AgentMessage, AgentRunState, ChatAgentRailAttachment } from "../types";
+export interface ChatAgentRailProps extends Omit<React.HTMLAttributes<HTMLElement>, "children" | "onSubmit"> {
+    agentRef?: string;
+    projectRef?: string;
+    messages: AgentMessage[];
+    state?: AgentRunState;
+    prompt: string;
+    onPromptChange: (value: string) => void;
+    onSubmit?: (prompt: string, attachments?: ChatAgentRailAttachment[]) => void;
+    attachments?: ChatAgentRailAttachment[];
+    onAttachmentRemove?: (id: string) => void;
+    onAttach?: () => void;
+    onSlash?: () => void;
+    autoScroll?: boolean;
+    runControls?: React.ReactNode;
+    header?: React.ReactNode;
+    scopeLabel?: React.ReactNode;
+    width?: number | string;
+}
+export interface LeftAgentRailProps extends ChatAgentRailProps {
+}
+export declare function ChatAgentRail(props: ChatAgentRailProps): import("react/jsx-runtime").JSX.Element;
+export declare function LeftAgentRail(props: LeftAgentRailProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ScopeAttachmentPanel.d.ts

@@ -0,0 +1,7 @@
+import type { SurfaceComponentProps } from "@echothink-ui/core";
+import type { AgentScopeAttachment } from "../types";
+export interface ScopeAttachmentPanelProps extends Omit<SurfaceComponentProps, "children" | "items" | "metadata"> {
+    attachments: AgentScopeAttachment[];
+    onRemove?: (id: string) => void;
+}
+export declare function ScopeAttachmentPanel({ attachments, onRemove, title, subtitle, severity, className, ...props }: ScopeAttachmentPanelProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/utils.d.ts

@@ -0,0 +1,20 @@
+import type * as React from "react";
+import type { EthOperationalStatus, EthSeverity } from "@echothink-ui/core";
+import type { AgentDiffItem, AgentPlanStep, AgentRunState, AgentSafetyCheck } from "../types";
+export declare const EMPTY_MARK = "\u2014";
+export declare function formatDateTime(value: string): string;
+export declare function formatTime(value: string): string;
+export declare function formatDuration(durationMs?: number): string;
+export declare function jsonPreview(value: unknown, redacted?: boolean, maxLength?: number): string;
+export declare function prettyJson(value: unknown, redacted?: boolean): string;
+export declare function stateLabel(state: AgentRunState): "Idle" | "Listening" | "Thinking" | "Calling tools" | "Waiting for user" | "Interrupted" | "Failed" | "Completed";
+export declare function stateSeverity(state: AgentRunState): EthSeverity;
+export declare function stateStatus(state: AgentRunState): EthOperationalStatus;
+export declare function isActiveAgentState(state: AgentRunState): state is "listening" | "thinking" | "tool-calling";
+export declare function statusSeverity(status: EthOperationalStatus): EthSeverity;
+export declare function riskSeverity(riskLevel?: "low" | "medium" | "high" | "critical"): "warning" | "info" | "danger";
+export declare function safetyStatus(check: AgentSafetyCheck): EthOperationalStatus;
+export declare function safetySeverity(check: AgentSafetyCheck): EthSeverity;
+export declare function mergeStyle(base: React.CSSProperties, incoming?: React.CSSProperties): React.CSSProperties;
+export declare function diffPlanSteps(before: AgentPlanStep[], after: AgentPlanStep[]): AgentDiffItem[];
+export declare const visuallyHiddenStyle: React.CSSProperties;