@makaio/framework 1.0.0-dev-1779046984397

package/dist/index-BJOfdtbw.d.mts

@@ -0,0 +1,729 @@
+import { z } from "zod";
+
+//#region packages/contracts/src/shared/json-value.d.ts
+/**
+ * JSON-safe value type shared by storage and runtime context contracts.
+ *
+ * Restricting persisted values to JSON keeps the storage contracts aligned
+ * with the actual serialization boundary instead of accepting runtime-only
+ * values such as functions, Maps, or `undefined`.
+ *
+ * The object branch intentionally stays broad (`object`) instead of requiring
+ * an index signature. The runtime Zod schema remains the source of truth for
+ * JSON validation, while the broader TypeScript type keeps regular DTOs and
+ * typed fixtures assignable without forcing every interface in the codebase to
+ * declare `[key: string]: ...`.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | object;
+/**
+ * Recursive JSON-safe value schema.
+ *
+ * Uses `z.lazy()` so arrays and objects can reference the same schema without
+ * widening the contract to arbitrary `unknown`.
+ */
+declare const JsonValueSchema: z.ZodType<JsonValue>;
+/**
+ * JSON object helper for map-like persisted configuration records.
+ *
+ * The runtime validation stays strict, while the public TypeScript surface
+ * remains `Record<string, unknown>` so opaque config bags do not force callers
+ * to thread `JsonValue` through every intermediate type.
+ */
+declare const JsonObjectSchema: z.ZodType<Record<string, unknown>>;
+/**
+ * Contract-friendly JSON object schema for opaque config bags.
+ *
+ * Uses the strict runtime validator above but preserves the public inferred
+ * type as `Record<string, unknown>` for storage/API boundaries.
+ */
+declare const JsonObjectContractSchema: z.ZodCustom<Record<string, unknown>, Record<string, unknown>>;
+//#endregion
+//#region packages/contracts/src/shared/ui-config.d.ts
+/**
+ * Builtin widget types provided by the UI components package
+ * - tags: Comma-separated input that converts to array
+ * - textarea-array: Multi-line textarea that converts to array
+ * - password: Password input field
+ * - slider: Numeric slider input
+ * - capability-picker: Grouped three-state capability selector with raw tool overrides
+ * - prompt-editor: Multi-line textarea with `{{prompt:name}}` template reference highlighting
+ */
+type BuiltinWidget = 'tags' | 'textarea-array' | 'password' | 'slider' | 'capability-picker' | 'prompt-editor';
+/**
+ * Plugin widget registry - augment to add custom widgets.
+ * @example Augmenting from a plugin
+ * ```typescript
+ * // extensions/loop/src/types.ts
+ * declare module '@makaio/framework/contracts' {
+ *   interface PluginWidgetRegistry {
+ *     'success-criteria': true;
+ *   }
+ * }
+ * ```
+ */
+interface PluginWidgetRegistry {}
+/**
+ * All available widget types (builtin + plugin-registered)
+ */
+type FieldWidget = BuiltinWidget | keyof PluginWidgetRegistry;
+/**
+ * Option for select-type fields.
+ *
+ * Each option represents a selectable choice in dropdown/select fields.
+ */
+declare const FieldOptionSchema: z.ZodObject<{
+  value: z.ZodString;
+  label: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Option for select-type fields.
+ *
+ * Each option represents a selectable choice in dropdown/select fields.
+ */
+type FieldOption = z.infer<typeof FieldOptionSchema>;
+/**
+ * Zod schema for field override (runtime validation - accepts any string for widget)
+ */
+declare const FieldOverrideSchema: z.ZodObject<{
+  widget: z.ZodOptional<z.ZodString>;
+  delimiter: z.ZodOptional<z.ZodString>;
+  placeholder: z.ZodOptional<z.ZodString>;
+  helpText: z.ZodOptional<z.ZodString>;
+  min: z.ZodOptional<z.ZodNumber>;
+  max: z.ZodOptional<z.ZodNumber>;
+  step: z.ZodOptional<z.ZodNumber>;
+  options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Field override type - inferred from schema
+ * Note: widget is string at runtime, use FieldWidget type for type-safe code
+ */
+type FieldOverride = z.infer<typeof FieldOverrideSchema>;
+/**
+ * UI configuration for entity forms
+ * Defines how the entity should be displayed and edited in the UI
+ */
+declare const EntityUIConfigSchema: z.ZodObject<{
+  editMode: z.ZodDefault<z.ZodEnum<{
+    inline: "inline";
+    slidePanel: "slidePanel";
+    fullPage: "fullPage";
+  }>>;
+  hiddenFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  readOnlyInEditMode: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  fieldOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    widget: z.ZodOptional<z.ZodString>;
+    delimiter: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    helpText: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      value: z.ZodString;
+      label: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>>;
+  sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Entity UI configuration type - inferred from schema
+ * Note: widget values are string at runtime, use FieldWidget type for type-safe widget handling
+ */
+type EntityUIConfig = z.infer<typeof EntityUIConfigSchema>;
+/**
+ * Field type options for form inputs.
+ *
+ * These types correspond to standard HTML input types and provide
+ * type-safe rendering of different form field variants. Slider-style numeric
+ * controls continue to use `type: 'number'` with `widget: 'slider'`.
+ *
+ * Use `'custom'` when field rendering is fully delegated to the widget
+ * specified in `widget` — SchemaForm will route the field to the registered
+ * widget and ignore the type for rendering purposes.
+ */
+type FieldType = 'text' | 'password' | 'number' | 'boolean' | 'select' | 'array' | 'custom';
+/**
+ * Shared properties for all form field definitions.
+ *
+ * This interface provides the seam for extensible form generation.
+ * Fields can be generated from JSON Schema, hardcoded registries,
+ * or any other source that can produce this structure.
+ */
+interface BaseFieldDefinition {
+  /** Unique key for the field (used as form field name). */
+  key: string;
+  /** Display label for the field. */
+  label: string;
+  /** Delimiter for array-type fields (default varies by widget). */
+  delimiter?: string;
+  /** Minimum numeric value (for numeric fields, including the slider widget). */
+  min?: number;
+  /** Maximum numeric value (for numeric fields, including the slider widget). */
+  max?: number;
+  /** Step increment for numeric fields, including the slider widget. */
+  step?: number;
+  /** Placeholder text for text-based inputs. */
+  placeholder?: string;
+  /** Help text/description shown below the input, including mapped override help text. */
+  description?: string;
+  /** Whether the field is required. */
+  required?: boolean;
+  /** Options for select-type fields. */
+  options?: FieldOption[];
+  /** Default value for the field. */
+  defaultValue?: unknown;
+  /** Whether the field is disabled. */
+  disabled?: boolean;
+}
+/** Field definition for builtin field types. */
+interface StandardFieldDefinition extends BaseFieldDefinition {
+  /** Type of input to render. */
+  type: Exclude<FieldType, 'custom'>;
+  /** Custom widget for specialized rendering (e.g., tags for arrays). */
+  widget?: FieldWidget;
+}
+/** Field definition for widgets that render through the custom field path. */
+interface CustomFieldDefinition extends BaseFieldDefinition {
+  /** Custom fields always render through an explicit widget. */
+  type: 'custom';
+  /** Builtin or plugin-registered widget used to render the custom field. */
+  widget: FieldWidget;
+}
+/**
+ * Definition for a form field.
+ *
+ * Builtin field types may omit `widget` and fall back to their type renderer.
+ * Custom field types must provide a registered widget so render-time lookup
+ * never falls back to the literal `'custom'` type.
+ */
+type FieldDefinition = StandardFieldDefinition | CustomFieldDefinition;
+/**
+ * Props for form field components.
+ *
+ * Defines the contract between the form rendering infrastructure and
+ * individual field components. Both framework extensions and host UI
+ * implement components that accept this interface.
+ * @param field - Field definition describing what to render
+ * @param value - Current value of the field
+ * @param onChange - Callback when the field value changes
+ * @param className - Optional additional CSS class
+ * @param idPrefix - Optional id prefix (defaults to 'field')
+ * @param error - Error state message (when present, field shows error styling)
+ */
+interface FormFieldProps {
+  /** Field definition describing what to render. */
+  field: FieldDefinition;
+  /** Current value of the field. */
+  value: unknown;
+  /** Callback when the field value changes. */
+  onChange: (value: unknown) => void;
+  /** Optional additional CSS class. */
+  className?: string;
+  /** Optional id prefix (defaults to 'field'). */
+  idPrefix?: string;
+  /** Error message (when present, field shows error styling). */
+  error?: string;
+}
+//#endregion
+//#region packages/contracts/src/shared/index.d.ts
+/**
+ * Content source for binary data or external resources.
+ * Supports either base64-encoded data or URL-based content.
+ *
+ * Invariant: the `base64` branch requires a known MIME type. Staging utilities
+ * always populate `mimeType` before a source reaches the message bus, so callers
+ * that construct a `base64` source must always provide it.
+ * The `url` branch leaves `mimeType` optional because remote URLs may not have
+ * a known content type upfront.
+ */
+declare const ContentSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"base64">;
+  data: z.ZodString;
+  mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"url">;
+  url: z.ZodString;
+  mimeType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+/**
+ * Message block representing different types of content.
+ * Supports text, images, documents, file attachments, reasoning, tool calls, and tool outputs.
+ */
+declare const MessageBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"text">;
+  content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"image">;
+  source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"base64">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"document">;
+  source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"base64">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"attachment">;
+  fileName: z.ZodString;
+  filePath: z.ZodString;
+  source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"base64">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "type">;
+  displayName: z.ZodOptional<z.ZodString>;
+  attachmentType: z.ZodEnum<{
+    file: "file";
+    directory: "directory";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"reasoning">;
+  content: z.ZodString;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"tool_call">;
+  toolCallId: z.ZodString;
+  name: z.ZodString;
+  args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"tool_output">;
+  toolCallId: z.ZodString;
+  output: z.ZodString;
+  isError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "type">;
+/**
+ * Structured message with role and content blocks.
+ * Blocks can be a single block or an array of blocks.
+ */
+declare const MessageSchema: z.ZodObject<{
+  role: z.ZodOptional<z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+  }>>;
+  blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+      file: "file";
+      directory: "directory";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+      file: "file";
+      directory: "directory";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>], "type">>]>;
+}, z.core.$strip>;
+/**
+ * Message input type.
+ * Accepts either a simple string or a structured Message object.
+ */
+declare const MessageInputSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  role: z.ZodOptional<z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+  }>>;
+  blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+      file: "file";
+      directory: "directory";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+      file: "file";
+      directory: "directory";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>], "type">>]>;
+}, z.core.$strip>]>;
+declare const SendMessageResultInnerResultSchema: z.ZodObject<{
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Possible outcomes for a user message lifecycle.
+ */
+declare const MessageOutcomeSchema: z.ZodEnum<{
+  error: "error";
+  completed: "completed";
+  superseded: "superseded";
+  merged: "merged";
+  cancelled: "cancelled";
+  rejected: "rejected";
+}>;
+declare const SendMessageResultSchema: z.ZodObject<{
+  messageId: z.ZodString;
+  result: z.ZodOptional<z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  error: z.ZodOptional<z.ZodString>;
+  outcome: z.ZodEnum<{
+    error: "error";
+    completed: "completed";
+    superseded: "superseded";
+    merged: "merged";
+    cancelled: "cancelled";
+    rejected: "rejected";
+  }>;
+}, z.core.$strip>;
+declare const MessageDeliveryModeSchema: z.ZodEnum<{
+  replace: "replace";
+  enqueue: "enqueue";
+  immediate: "immediate";
+}>;
+/**
+ * System prompt configuration for agent sessions.
+ *
+ * Supports two modes:
+ * - `string`: Replace/set the entire system prompt
+ * - `{ mode: 'append', content: string }`: Append to adapter's default system prompt
+ *
+ * The append mode is useful for adding context-specific instructions (e.g., messageHistory
+ * interpretation) without overriding the adapter's base configuration.
+ * @example
+ * ```typescript
+ * // Replace entirely
+ * systemPrompt: 'You are a helpful assistant.'
+ *
+ * // Append to existing
+ * systemPrompt: {
+ *   mode: 'append',
+ *   content: 'You are naturally continuing a conversation with user.',
+ * }
+ * ```
+ */
+declare const SystemPromptSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  mode: z.ZodLiteral<"append">;
+  content: z.ZodString;
+}, z.core.$strip>]>;
+/**
+ * Schema for normalized message input.
+ * Used for user messages with full structure including role and content blocks.
+ */
+declare const NormalizedMessageInputSchema: z.ZodObject<{
+  role: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+  }>;
+  blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"base64">;
+      data: z.ZodString;
+      mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"url">;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+      file: "file";
+      directory: "directory";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>], "type">>;
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type NormalizedMessageInput = z.infer<typeof NormalizedMessageInputSchema>;
+/**
+ * Inferred TypeScript types from schemas.
+ */
+type ContentSource = z.infer<typeof ContentSourceSchema>;
+type MessageBlock = z.infer<typeof MessageBlockSchema>;
+type Message = z.infer<typeof MessageSchema>;
+type MessageInput = z.infer<typeof MessageInputSchema>;
+type SendMessageResult = z.infer<typeof SendMessageResultSchema>;
+type SendMessageResultInnerResult = z.infer<typeof SendMessageResultInnerResultSchema>;
+type MessageOutcome = z.infer<typeof MessageOutcomeSchema>;
+type MessageDeliveryMode = z.infer<typeof MessageDeliveryModeSchema>;
+type SystemPrompt = z.infer<typeof SystemPromptSchema>;
+/**
+ * Runtime error categories for adapter failures.
+ * Used to classify errors during agent execution for fallback/retry logic.
+ *
+ * Note: The 'all' category exists in VirtualModelErrorCategorySchema but is excluded here
+ * as it's only used for fallback configuration, not runtime error classification.
+ */
+declare const ERROR_CATEGORIES: readonly ["rate_limit", "auth", "model_unavailable", "quota_exceeded"];
+declare const ErrorCategorySchema: z.ZodEnum<{
+  rate_limit: "rate_limit";
+  auth: "auth";
+  model_unavailable: "model_unavailable";
+  quota_exceeded: "quota_exceeded";
+}>;
+type ErrorCategory = z.infer<typeof ErrorCategorySchema>;
+//#endregion
+export { FieldOption as A, JsonObjectSchema as B, SystemPromptSchema as C, EntityUIConfig as D, CustomFieldDefinition as E, FieldWidget as F, JsonValueSchema as H, FormFieldProps as I, PluginWidgetRegistry as L, FieldOverride as M, FieldOverrideSchema as N, EntityUIConfigSchema as O, FieldType as P, StandardFieldDefinition as R, SystemPrompt as S, BuiltinWidget as T, JsonValue as V, NormalizedMessageInputSchema as _, ErrorCategorySchema as a, SendMessageResultInnerResultSchema as b, MessageBlockSchema as c, MessageInput as d, MessageInputSchema as f, NormalizedMessageInput as g, MessageSchema as h, ErrorCategory as i, FieldOptionSchema as j, FieldDefinition as k, MessageDeliveryMode as l, MessageOutcomeSchema as m, ContentSourceSchema as n, Message as o, MessageOutcome as p, ERROR_CATEGORIES as r, MessageBlock as s, ContentSource as t, MessageDeliveryModeSchema as u, SendMessageResult as v, BaseFieldDefinition as w, SendMessageResultSchema as x, SendMessageResultInnerResult as y, JsonObjectContractSchema as z };