@svadmin/core 0.47.0 → 0.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/core",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "author": "zuohuadong",
   "repository": {
     "type": "git",

package/src/chatProvider.svelte.ts

@@ -1,49 +1,83 @@
-// Chat & Agent provider — headless interface for AI integration
-//
-// Two abstraction levels:
-//   1. ChatProvider  — simple message-in / text-out  (backward compatible)
-//   2. AgentProvider — tool calling, approval gates, generative UI events
-//
-// Inspired by Vercel AI SDK 6 agent abstractions.
-
-/** Describes an actionable button rendered in assistant messages (tool-call UX). */
-export interface ChatAction {
-  label: string;
-  /** Optional variant for styling (e.g. 'destructive' renders red) */
-  variant?: 'default' | 'destructive' | 'outline';
-  /** Arbitrary payload forwarded to the onAction handler */
-  payload?: Record<string, unknown>;
+// Headless AI contracts. Rendering lives in @svadmin/ai-elements.
+
+export type ToolState =
+  | 'input-streaming'
+  | 'input-available'
+  | 'approval-requested'
+  | 'approval-responded'
+  | 'output-available'
+  | 'output-denied'
+  | 'output-error';
+
+export type MessageStatus = 'submitted' | 'streaming' | 'complete' | 'aborted' | 'error';
+
+export interface ChatAttachment {
+  id: string;
+  name: string;
+  mediaType?: string;
+  url?: string;
+  size?: number;
+  /** 原始浏览器文件，供上传适配器直接读取；持久化恢复时不会保留。 */
+  file?: File;
+}
+
+export interface ChatSource {
+  id?: string;
+  title: string;
+  url?: string;
+  quote?: string;
+  description?: string;
 }
 
+export type ChatMessagePart =
+  | { id?: string; type: 'text'; text: string }
+  | { id?: string; type: 'reasoning'; text: string; streaming?: boolean }
+  | { id?: string; type: 'tool-call'; tool: string; input: unknown; state: ToolState; callId?: string }
+  | { id?: string; type: 'tool-result'; tool: string; output: unknown; error?: string; callId?: string }
+  | { id?: string; type: 'source'; source: ChatSource }
+  | { id?: string; type: 'image'; src: string; alt?: string; width?: number; height?: number }
+  | { id?: string; type: 'file'; file: ChatAttachment }
+  | {
+      id?: string;
+      type: 'approval';
+      approvalId: string;
+      tool: string;
+      input: Record<string, unknown>;
+      description: string;
+      approved?: boolean;
+    }
+  | { id?: string; type: 'component'; name: string; props: Record<string, unknown> };
+
 export interface ChatMessage {
   id: string;
   role: 'user' | 'assistant' | 'system';
-  content: string;
-  timestamp: number;
-  /** Tool-call action buttons rendered below the message bubble */
-  actions?: ChatAction[];
+  parts: ChatMessagePart[];
+  status?: MessageStatus;
+  createdAt: number;
+  attachments?: ChatAttachment[];
 }
 
-/** Admin context automatically injected into chat system messages. */
+/** Admin context passed separately from untrusted conversation messages. */
 export interface ChatContext {
   currentResource?: string;
-  selectedRecordId?: string;
-  currentView?: 'list' | 'edit' | 'create' | 'show';
+  selectedRecordId?: string | number;
+  currentView?: 'list' | 'edit' | 'create' | 'show' | string;
   pathname?: string;
+  metadata?: Record<string, unknown>;
 }
 
 /**
  * ChatProvider interface for integrating AI chat into admin panels.
  * Implement `sendMessage` to connect to any AI backend (OpenAI, self-hosted, etc.)
  *
- * Return a `string` for non-streaming responses, or an `AsyncGenerator<string>`
- * for streaming (SSE / chunked) responses.
+ * Return text or structured parts for non-streaming responses. For streaming
+ * transports, yield text chunks and/or structured parts from an async generator.
  */
 export interface ChatProvider {
   sendMessage(
     messages: ChatMessage[],
-    options?: { signal?: AbortSignal },
-  ): Promise<string> | AsyncGenerator<string, void, unknown>;
+    options?: { signal?: AbortSignal; context?: ChatContext },
+  ): Promise<ChatMessagePart[] | string> | AsyncGenerator<ChatMessagePart | string, void, unknown>;
 }
 
 // ─── Agent Provider (extends ChatProvider concept) ─────────────
@@ -113,12 +147,16 @@ export interface ToolResult {
 export type AgentEvent =
   /** Streaming text chunk */
   | { type: 'text'; content: string }
+  /** Streaming reasoning chunk */
+  | { type: 'reasoning'; content: string; streaming?: boolean }
   /** Agent wants to call a tool (informational — execution is handled internally) */
-  | { type: 'tool_call'; tool: string; args: Record<string, unknown> }
+  | { type: 'tool_call'; tool: string; args: Record<string, unknown>; callId?: string }
   /** Agent wants to call a tool that requires user approval before execution */
   | { type: 'approval_request'; id: string; tool: string; args: Record<string, unknown>; description: string }
   /** Tool execution completed */
-  | { type: 'tool_result'; tool: string; result: ToolResult }
+  | { type: 'tool_result'; tool: string; result: ToolResult; callId?: string }
+  /** Source attribution emitted by a retrieval step */
+  | { type: 'source'; source: ChatSource }
   /** Agent wants to render a named component (Generative UI) */
   | { type: 'component'; name: string; props: Record<string, unknown> }
   /** Stream finished */
@@ -131,6 +169,14 @@ export interface AgentOptions {
   context?: ChatContext;
 }
 
+/**
+ * Cancellation signal supplied while an approval decision is being submitted.
+ * Providers must stop before committing tool execution when this signal aborts.
+ */
+export interface ApprovalResponseOptions {
+  signal: AbortSignal;
+}
+
 /**
  * AgentProvider — advanced AI integration with tool calling and approval gates.
  *
@@ -159,7 +205,11 @@ export interface AgentProvider {
     messages: ChatMessage[],
     options?: AgentOptions,
   ): AsyncGenerator<AgentEvent, void, unknown>;
-  approveToolCall?(id: string, approved: boolean): void;
+  approveToolCall?(
+    id: string,
+    approved: boolean,
+    options: ApprovalResponseOptions,
+  ): void | Promise<void>;
 }
 
 // ─── Chat Provider singleton ───────────────────────────────────

package/src/helpers-pure.ts

@@ -165,34 +165,7 @@ export function parseCSV(text: string): string[][] {
   return rows;
 }
 
-// ─── Universal Schema Validator Helper ──────────────────────────
-
-/**
- * Universal schema interface compatible with TypeBox, Standard Schema (v1), Valibot, Zod,
- * Yup, Joi, etc.
- */
-export interface SchemaValidatorLike {
-  Check?: (value: unknown) => boolean;
-  Errors?: (value: unknown) => Iterable<{ path?: string; message: string; schema?: unknown }>;
-  safeParse?: (data: unknown) => {
-    success: boolean;
-    data?: unknown;
-    error?: {
-      issues?: Array<{ path?: Array<string | number>; message: string }>;
-      errors?: Array<{ path?: Array<string | number>; message: string }>;
-    };
-  };
-  parse?: (data: unknown) => unknown;
-  validate?: (data: unknown) => {
-    error?: {
-      details?: Array<{ path?: Array<string | number>; message: string }>;
-      message?: string;
-    };
-  };
-  '~standard'?: {
-    validate: (data: unknown) => unknown | Promise<unknown>;
-  };
-}
+// ─── TypeBox Validator Helper ───────────────────────────────────
 
 /**
  * TypeBox validator interface matching TypeCompiler.Compile or Value.Errors
@@ -202,134 +175,6 @@ export type TypeBoxValidatorLike = {
   Errors: (value: unknown) => Iterable<{ path?: string; message: string }>;
 };
 
-/**
- * Creates a synchronous form validator function from any TypeBox, Standard Schema v1,
- * Valibot, Zod, Yup, or Joi object.
- *
- * @example
- * ```ts
- * import { Type } from '@sinclair/typebox';
- * import { TypeCompiler } from '@sinclair/typebox/compiler';
- * import { createSchemaValidator, useForm } from '@svadmin/core';
- *
- * const userSchema = Type.Object({
- *   name: Type.String({ minLength: 2 }),
- *   email: Type.String({ format: 'email' }),
- * });
- *
- * const form = useForm({
- *   resource: 'users',
- *   validate: createSchemaValidator(TypeCompiler.Compile(userSchema)),
- * });
- * ```
- */
-export function createSchemaValidator(
-  schema: SchemaValidatorLike | unknown
-): (values: Record<string, unknown>) => Record<string, string> | null {
-  if (!schema || typeof schema !== 'object') {
-    return () => null;
-  }
-
-  const s = schema as SchemaValidatorLike;
-
-  return (values: Record<string, unknown>) => {
-    const errors: Record<string, string> = {};
-
-    // 0. TypeBox TypeCompiler compiled validator (.Check & .Errors)
-    if (typeof s.Check === 'function' && typeof s.Errors === 'function') {
-      if (s.Check(values)) return null;
-      for (const err of s.Errors(values)) {
-        const rawPath = err.path || '';
-        const cleanPath = rawPath.replace(/^\//, '').replace(/\//g, '.');
-        const key = cleanPath || '_root';
-        if (!errors[key]) errors[key] = err.message;
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    // 0b. TypeBox Value.Errors iterator provider
-    if (typeof s.Errors === 'function') {
-      for (const err of s.Errors(values)) {
-        const rawPath = err.path || '';
-        const cleanPath = rawPath.replace(/^\//, '').replace(/\//g, '.');
-        const key = cleanPath || '_root';
-        if (!errors[key]) errors[key] = err.message;
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    // 1. Standard Schema v1 (~standard)
-    if (s['~standard'] && typeof s['~standard'].validate === 'function') {
-      const res = s['~standard'].validate(values);
-      if (res && typeof res === 'object' && 'issues' in res && Array.isArray((res as { issues?: Array<{ path?: Array<unknown>; message: string }> }).issues)) {
-        for (const issue of (res as { issues: Array<{ path?: Array<unknown>; message: string }> }).issues) {
-          const rawPath = issue.path?.[0];
-          const key = typeof rawPath === 'object' && rawPath !== null && 'key' in rawPath
-            ? String((rawPath as { key: unknown }).key)
-            : rawPath != null
-              ? String(rawPath)
-              : '_root';
-          if (!errors[key]) errors[key] = issue.message;
-        }
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    // 2. Zod / Valibot safeParse
-    if (typeof s.safeParse === 'function') {
-      const res = s.safeParse(values);
-      if (!res.success && res.error) {
-        const issues = res.error.issues ?? res.error.errors ?? [];
-        for (const issue of issues) {
-          const key = issue.path?.[0] != null ? String(issue.path[0]) : '_root';
-          if (!errors[key]) errors[key] = issue.message;
-        }
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    // 3. Joi / generic .validate()
-    if (typeof s.validate === 'function') {
-      const res = s.validate(values);
-      if (res && typeof res === 'object' && res.error) {
-        const details = res.error.details;
-        if (Array.isArray(details) && details.length > 0) {
-          for (const d of details) {
-            const key = d.path?.[0] != null ? String(d.path[0]) : '_root';
-            if (!errors[key]) errors[key] = d.message;
-          }
-        } else if (res.error.message) {
-          errors._root = res.error.message;
-        }
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    // 4. Synchronous .parse() that throws (e.g. standard Zod parse or Yup validateSync)
-    if (typeof s.parse === 'function') {
-      try {
-        s.parse(values);
-      } catch (err: unknown) {
-        if (err && typeof err === 'object') {
-          const issues = (err as { issues?: Array<{ path?: Array<string | number>; message: string }>; errors?: Array<{ path?: Array<string | number>; message: string }> }).issues ??
-            (err as { errors?: Array<{ path?: Array<string | number>; message: string }> }).errors;
-          if (Array.isArray(issues)) {
-            for (const issue of issues) {
-              const key = issue.path?.[0] != null ? String(issue.path[0]) : '_root';
-              if (!errors[key]) errors[key] = issue.message;
-            }
-          } else if ('message' in err && typeof (err as { message: unknown }).message === 'string') {
-            errors._root = (err as { message: string }).message;
-          }
-        }
-      }
-      return Object.keys(errors).length > 0 ? errors : null;
-    }
-
-    return null;
-  };
-}
-
 /**
  * Creates a synchronous form validator function specifically optimized for TypeBox
  * compiled validators (from TypeCompiler.Compile) or TypeBox value checks.
@@ -354,7 +199,18 @@ export function createSchemaValidator(
  * ```
  */
 export function createTypeBoxValidator(
-  compiledOrSchema: TypeBoxValidatorLike | SchemaValidatorLike | unknown
+  validator: TypeBoxValidatorLike
 ): (values: Record<string, unknown>) => Record<string, string> | null {
-  return createSchemaValidator(compiledOrSchema);
+  return (values) => {
+    if (validator.Check?.(values)) return null;
+
+    const errors: Record<string, string> = {};
+    for (const error of validator.Errors(values)) {
+      const path = (error.path ?? '').replace(/^\//, '').replace(/\//g, '.');
+      const key = path || '_root';
+      if (!errors[key]) errors[key] = error.message;
+    }
+
+    return Object.keys(errors).length > 0 ? errors : null;
+  };
 }

package/src/helpers.ts

@@ -8,10 +8,9 @@ export {
   getDefaultFilter, getDefaultSortOrder,
   unionFilters, unionSorters,
   file2Base64, parseCSV,
-  createSchemaValidator,
   createTypeBoxValidator,
 } from './helpers-pure';
-export type { SchemaValidatorLike, TypeBoxValidatorLike } from './helpers-pure';
+export type { TypeBoxValidatorLike } from './helpers-pure';
 
 
 // ─── Document Title Helper ────────────────────────────────────
@@ -61,7 +60,7 @@ export function generateDefaultDocumentTitle(options?: {
  * - `type === 'number'` fields (must be a valid number)
  * - Custom per-field `field.validate()` callback
  *
- * This eliminates the need for hand-written Zod schemas in most CRUD scenarios.
+ * This eliminates the need for hand-written schemas in most CRUD scenarios.
  *
  * @example
  * ```ts

package/src/index.ts

@@ -117,7 +117,11 @@ export type {
 } from './enterprise';
 export { assertEnterpriseRequestContext, createEnterpriseRequestContext } from './enterprise';
 export { setChatProvider, getChatProvider, setChatContext, getChatContext, setAgentProvider, getAgentProvider, registerApproval, resolveApproval, hasPendingApprovals, resetChatProvider, projectAdminToolSchema } from './chatProvider.svelte';
-export type { ChatProvider, ChatMessage, ChatContext, ChatAction, AgentProvider, AgentEvent, AgentOptions, AdminTool, AdminToolParameter, ToolResult } from './chatProvider.svelte';
+export type {
+  ChatProvider, ChatMessage, ChatMessagePart, ChatContext, ChatAttachment, ChatSource,
+  MessageStatus, ToolState, AgentProvider, AgentEvent, AgentOptions, ApprovalResponseOptions,
+  AdminTool, AdminToolParameter, ToolResult,
+} from './chatProvider.svelte';
 export { getTheme, setTheme, toggleTheme, getResolvedTheme, getColorTheme, setColorTheme, getColorThemes, configureTheme, getThemeConfig, clearCssOverrides, builtinPresets, registerColorPreset, getColorPresets, registerThemeOwner, updateThemeOwner, unregisterThemeOwner, resetTheme } from './theme.svelte';
 export type { ThemeMode, ColorTheme, ThemeStrategy, ThemeConfig, ColorPreset, ThemeOwnerOptions, ThemeOwnerToken } from './theme.svelte';
 export { setUnsavedChanges, getUnsavedChanges, initUnsavedChangesNotifier, resetUnsavedChanges } from './unsaved-changes.svelte';
@@ -203,10 +207,9 @@ export {
   unionFilters, unionSorters,
   file2Base64, generateDefaultDocumentTitle,
   deriveValidator,
-  createSchemaValidator,
   createTypeBoxValidator,
 } from './helpers';
-export type { SchemaValidatorLike, TypeBoxValidatorLike } from './helpers';
+export type { TypeBoxValidatorLike } from './helpers';
 export { TableState } from './table-state.svelte';
 export type { TableStateOptions } from './table-state.svelte';
 export type { UseInfiniteListOptions } from './hooks.svelte';