@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-L4GjJDKb.d.mts

@@ -0,0 +1,822 @@
+import { z } from "zod";
+import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
+
+//#region core/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$1 = string | number | boolean | null | JsonValue$1[] | 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$1: z.ZodType<JsonValue$1>;
+/**
+ * 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 and only narrows the public Zod
+ * type. Keeping the underlying schema as `z.record()` is important for
+ * protocol exports: `z.custom()` validates correctly at runtime but cannot be
+ * represented as JSON Schema.
+ */
+declare const JsonObjectContractSchema: z.ZodType<Record<string, unknown>, Record<string, unknown>>;
+/**
+ * Serializable JSON Schema record used for `inputSchema`, `outputSchema`, and
+ * `configSchema` fields on persisted workflow definitions and node primitives.
+ *
+ * A JSON Schema document is itself a JSON object, so this is a
+ * `Record<string, JsonValue>` — identical at runtime to {@link JsonObjectContractSchema}
+ * but carries a semantically narrower name to distinguish "a JSON Schema document"
+ * from "an arbitrary JSON payload".
+ *
+ * The underlying `z.record(z.string(), JsonValueSchema)` validator rejects
+ * functions, `undefined`, and other non-serializable values, keeping persisted
+ * workflow definitions purely JSON-safe.
+ */
+declare const JsonSchemaRecordSchema: z.ZodType<Record<string, JsonValue$1>, Record<string, JsonValue$1>>;
+//#endregion
+//#region core/contracts/src/shared/response-schema.d.ts
+/**
+ * Validates that a provider schema name is safe for use with all supported providers.
+ *
+ * OpenAI requires names that match `[a-zA-Z0-9_-]` and are at most 64 characters.
+ * Adapters must derive a conforming name when none is supplied.
+ */
+declare const ResponseSchemaNameSchema: z.ZodString;
+/**
+ * Descriptor for a JSON Schema document that constrains an agent's structured response.
+ *
+ * Passed through the session bus so adapters can forward native structured-output
+ * constraints to their underlying provider (e.g. OpenAI `response_format`, Anthropic
+ * tool-schema trick). Fields are intentionally narrow to stay JSON-safe and
+ * round-trippable over the wire.
+ */
+declare const ResponseSchemaDescriptorSchema: z.ZodObject<{
+  schema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+  name: z.ZodOptional<z.ZodString>;
+  strict: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * Normalized representation of a single structured-output validation error.
+ *
+ * Mirrors the AJV error shape so validation results from different validators
+ * can be mapped to a common format without pulling AJV into every consumer.
+ */
+declare const StructuredOutputValidationErrorSchema: z.ZodObject<{
+  message: z.ZodString;
+  instancePath: z.ZodString;
+  schemaPath: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Lifecycle status of a structured-output validation pass.
+ *
+ * - `passed`   – The response conforms to the declared schema.
+ * - `failed`   – Validation errors were found; `errors` will be populated.
+ * - `enforced` – A structured-output enforcement handler produced conformant output.
+ */
+declare const StructuredOutputValidationStatusSchema: z.ZodEnum<{
+  failed: "failed";
+  passed: "passed";
+  enforced: "enforced";
+}>;
+/**
+ * Full validation result emitted after a turn completes when a
+ * {@link ResponseSchemaDescriptor} was active.
+ *
+ * When `status` is `failed`, `errors` contains at least one entry describing
+ * what the agent's response violated. The discriminated union enforces that
+ * `errors` is absent for `passed`/`enforced` and required (non-empty) for
+ * `failed`.
+ */
+declare const StructuredOutputValidationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  status: z.ZodLiteral<"passed">;
+}, z.core.$strict>, z.ZodObject<{
+  status: z.ZodLiteral<"enforced">;
+}, z.core.$strict>, z.ZodObject<{
+  status: z.ZodLiteral<"failed">;
+  errors: z.ZodArray<z.ZodObject<{
+    message: z.ZodString;
+    instancePath: z.ZodString;
+    schemaPath: z.ZodString;
+  }, z.core.$strict>>;
+}, z.core.$strict>], "status">;
+/** @see {@link ResponseSchemaNameSchema} */
+type ResponseSchemaName = z.infer<typeof ResponseSchemaNameSchema>;
+/** @see {@link ResponseSchemaDescriptorSchema} */
+type ResponseSchemaDescriptor$1 = z.infer<typeof ResponseSchemaDescriptorSchema>;
+/** @see {@link StructuredOutputValidationSchema} */
+type StructuredOutputValidation$1 = z.infer<typeof StructuredOutputValidationSchema>;
+/** @see {@link StructuredOutputValidationErrorSchema} */
+type StructuredOutputValidationError = z.infer<typeof StructuredOutputValidationErrorSchema>;
+/** @see {@link StructuredOutputValidationStatusSchema} */
+type StructuredOutputValidationStatus = z.infer<typeof StructuredOutputValidationStatusSchema>;
+//#endregion
+//#region core/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$1: 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$1>;
+/**
+ * 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 core/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";
+  cancelled: "cancelled";
+  superseded: "superseded";
+  merged: "merged";
+  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";
+    cancelled: "cancelled";
+    superseded: "superseded";
+    merged: "merged";
+    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$1 = z.infer<typeof MessageBlockSchema>;
+type Message$1 = z.infer<typeof MessageSchema>;
+type MessageInput$1 = z.infer<typeof MessageInputSchema>;
+type SendMessageResult = z.infer<typeof SendMessageResultSchema>;
+type SendMessageResultInnerResult$1 = z.infer<typeof SendMessageResultInnerResultSchema>;
+type MessageOutcome$1 = z.infer<typeof MessageOutcomeSchema>;
+type MessageDeliveryMode$1 = z.infer<typeof MessageDeliveryModeSchema>;
+type SystemPrompt$1 = 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 { JsonValueSchema$1 as $, FieldOption as A, ResponseSchemaDescriptorSchema as B, SystemPromptSchema as C, EntityUIConfig as D, CustomFieldDefinition as E, FieldWidget as F, StructuredOutputValidationErrorSchema as G, ResponseSchemaNameSchema as H, FormFieldProps as I, StructuredOutputValidationStatusSchema as J, StructuredOutputValidationSchema as K, PluginWidgetRegistry as L, FieldOverride as M, FieldOverrideSchema as N, EntityUIConfigSchema$1 as O, FieldType as P, JsonValue$1 as Q, StandardFieldDefinition as R, SystemPrompt$1 as S, BuiltinWidget as T, StructuredOutputValidation$1 as U, ResponseSchemaName as V, StructuredOutputValidationError as W, JsonObjectSchema as X, JsonObjectContractSchema as Y, JsonSchemaRecordSchema as Z, NormalizedMessageInputSchema as _, ErrorCategorySchema as a, SendMessageResultInnerResultSchema as b, MessageBlockSchema as c, MessageInput$1 as d, MessageInputSchema as f, NormalizedMessageInput as g, MessageSchema as h, ErrorCategory as i, FieldOptionSchema as j, FieldDefinition as k, MessageDeliveryMode$1 as l, MessageOutcomeSchema as m, ContentSourceSchema as n, Message$1 as o, MessageOutcome$1 as p, StructuredOutputValidationStatus as q, ERROR_CATEGORIES as r, MessageBlock$1 as s, ContentSource as t, MessageDeliveryModeSchema as u, SendMessageResult as v, BaseFieldDefinition as w, SendMessageResultSchema as x, SendMessageResultInnerResult$1 as y, ResponseSchemaDescriptor$1 as z };