@echothink-ui/agent 0.1.0

package/src/types.ts

@@ -0,0 +1,158 @@
+import type * as React from "react";
+import type {
+  EthOperationalStatus,
+  EthSeverity,
+  SurfaceComponentProps
+} from "@echothink-ui/core";
+
+export type AgentRunState =
+  | "idle"
+  | "listening"
+  | "thinking"
+  | "tool-calling"
+  | "waiting-for-user"
+  | "interrupted"
+  | "failed"
+  | "completed";
+
+export interface AgentCitation {
+  id: string;
+  label: string;
+  description?: React.ReactNode;
+  meta?: React.ReactNode;
+  href?: string;
+}
+
+export interface AgentMessage {
+  id: string;
+  role: "user" | "agent" | "system" | "tool";
+  content: React.ReactNode;
+  status?: EthOperationalStatus;
+  createdAt: string;
+  citations?: AgentCitation[];
+  streaming?: boolean;
+}
+
+export interface ChatAgentRailAttachment {
+  id: string;
+  label: string;
+  kind: "file" | "resource" | "scope";
+}
+
+export interface AgentScopeAttachment {
+  id: string;
+  label: string;
+  kind: "project" | "resource" | "document" | "task" | "app-domain" | "scope";
+  status?: EthOperationalStatus;
+}
+
+export interface AgentStep {
+  id: string;
+  title: string;
+  status: EthOperationalStatus;
+  observation?: string;
+  action?: string;
+  blocker?: string;
+  durationMs?: number;
+  redacted?: boolean;
+  children?: AgentStep[];
+}
+
+export interface AgentTraceSpan {
+  id: string;
+  name: string;
+  startedAt: string;
+  durationMs: number;
+  status: EthOperationalStatus;
+  parentId?: string;
+  attributes?: Record<string, unknown>;
+}
+
+export interface AgentToolCall {
+  id: string;
+  toolName: string;
+  args?: unknown;
+  result?: unknown;
+  status: EthOperationalStatus;
+  startedAt: string;
+  durationMs?: number;
+  redacted?: boolean;
+  error?: string;
+}
+
+export interface AgentApprovalAction {
+  id: string;
+  label: string;
+  description: string;
+  riskLevel?: "low" | "medium" | "high" | "critical";
+}
+
+export interface AgentPlanStep {
+  id: string;
+  description: string;
+  durationEstimate?: string;
+  risks?: string[];
+}
+
+export interface AgentPlan {
+  id: string;
+  title: string;
+  steps: AgentPlanStep[];
+  assumptions?: string[];
+  risks?: string[];
+}
+
+export interface AgentMemoryEntry {
+  id: string;
+  kind: "user" | "project" | "feedback" | "reference";
+  key: string;
+  value: React.ReactNode;
+  lastUpdatedAt?: string;
+  pinned?: boolean;
+}
+
+export interface AgentContextSource {
+  id: string;
+  label: string;
+  type: "document" | "message" | "query" | "tool-result";
+  href?: string;
+  excerpt?: string;
+  relevance?: number;
+}
+
+export interface AgentSafetyCheck {
+  id: string;
+  label: string;
+  status: "pass" | "warn" | "fail";
+  details?: string;
+}
+
+export interface AgentHandoffTarget {
+  id: string;
+  label: string;
+  type: "human" | "team" | "agent";
+  description?: string;
+  status?: EthOperationalStatus;
+}
+
+export interface AgentGeneratedArtifact {
+  id: string;
+  label: string;
+  kind: "file" | "doc" | "chart" | "image" | "code";
+  size?: string;
+  createdAt: string;
+  previewUrl?: string;
+  href?: string;
+  mimeType?: string;
+  content?: string;
+}
+
+export interface AgentDiffItem {
+  id: string;
+  before?: AgentPlanStep;
+  after?: AgentPlanStep;
+  status: "added" | "removed" | "modified" | "unchanged";
+  severity: EthSeverity;
+}
+
+export type AgentComponentSurfaceProps = SurfaceComponentProps;