@prompty/core 0.1.4 → 2.0.0-alpha.1

package/dist/index.d.cts

@@ -0,0 +1,2327 @@
+/**
+ * Core message types for the Prompty pipeline.
+ *
+ * These types are protocol-agnostic — they represent the abstract
+ * message format that executors translate to provider-specific
+ * wire formats (e.g., OpenAI JSON).
+ *
+ * @module
+ */
+/** Base shape shared by all content parts. */
+interface ContentPartBase {
+    kind: string;
+}
+/** Plain text content. */
+interface TextPart extends ContentPartBase {
+    kind: "text";
+    value: string;
+}
+/** Image reference (URL or base64 data URI). */
+interface ImagePart extends ContentPartBase {
+    kind: "image";
+    source: string;
+    detail?: string;
+    mediaType?: string;
+}
+/** File reference. */
+interface FilePart extends ContentPartBase {
+    kind: "file";
+    source: string;
+    mediaType?: string;
+}
+/** Audio reference (URL or base64 data URI). */
+interface AudioPart extends ContentPartBase {
+    kind: "audio";
+    source: string;
+    mediaType?: string;
+}
+/** Discriminated union of all content part types. */
+type ContentPart = TextPart | ImagePart | FilePart | AudioPart;
+/** Valid message roles. */
+type Role = "system" | "user" | "assistant" | "developer" | "tool";
+/**
+ * An abstract message in the Prompty pipeline.
+ *
+ * Executors convert this to provider-specific wire format.
+ * Parsers produce this from rendered template text.
+ */
+declare class Message {
+    role: Role;
+    parts: ContentPart[];
+    metadata: Record<string, unknown>;
+    constructor(role: Role, parts?: ContentPart[], metadata?: Record<string, unknown>);
+    /** Concatenate all TextPart values into a single string. */
+    get text(): string;
+    /**
+     * Return content in a format suitable for wire serialization:
+     * - If all parts are text, return a single string.
+     * - If multimodal, return an array of content objects.
+     */
+    toTextContent(): string | Record<string, unknown>[];
+}
+/**
+ * Positional marker for conversation history insertion.
+ *
+ * During `prepare()`, nonce strings in rendered text are replaced
+ * with ThreadMarker objects. Then `expandThreadMarkers()` replaces
+ * them with actual conversation messages from the inputs.
+ */
+declare class ThreadMarker {
+    readonly name: string;
+    constructor(name: string);
+}
+/** Represents a tool call extracted from an LLM response. */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+/**
+ * Input kinds that receive special handling in the pipeline
+ * (nonce-based substitution rather than direct template interpolation).
+ */
+declare const RICH_KINDS: Set<string>;
+/** Standard message roles. */
+declare const ROLES: Set<Role>;
+/**
+ * Tracing-aware wrapper for asynchronous LLM streaming responses.
+ *
+ * Accumulates all chunks as they are yielded. When the async iterator
+ * is exhausted, the accumulated items are flushed to the tracer.
+ *
+ * Matches the Python PromptyStream / AsyncPromptyStream pattern.
+ */
+declare class PromptyStream implements AsyncIterable<unknown> {
+    readonly name: string;
+    private readonly inner;
+    readonly items: unknown[];
+    constructor(name: string, inner: AsyncIterable<unknown>);
+    [Symbol.asyncIterator](): AsyncIterableIterator<unknown>;
+}
+/** Create a TextPart. */
+declare function text(value: string): TextPart;
+/** Create a Message with a single text part. */
+declare function textMessage(role: Role, value: string, metadata?: Record<string, unknown>): Message;
+/** Convert a plain dict `{role, content, ...}` to a Message. */
+declare function dictToMessage(d: Record<string, unknown>): Message;
+/** Convert a content dict to a ContentPart. */
+declare function dictContentToPart(d: Record<string, unknown>): ContentPart;
+
+/**
+ * Context for customizing the loading process of agent definitions.
+ *
+ * Provides hooks for pre-processing input data before parsing and
+ * post-processing output data after instantiation.
+ */
+declare class LoadContext {
+    /**
+     * Optional callback to transform input data before parsing.
+     */
+    preProcess?: (data: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Optional callback to transform the result after instantiation.
+     */
+    postProcess?: (result: unknown) => unknown;
+    constructor(init?: Partial<LoadContext>);
+    /**
+     * Apply pre-processing to input data if a preProcess callback is set.
+     * @param data - The raw input dictionary to process.
+     * @returns The processed dictionary, or the original if no callback is set.
+     */
+    processInput(data: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Apply post-processing to the result if a postProcess callback is set.
+     * @param result - The instantiated object to process.
+     * @returns The processed result, or the original if no callback is set.
+     */
+    processOutput<T>(result: T): T;
+}
+/**
+ * Context for customizing the serialization process of agent definitions.
+ *
+ * Provides hooks for pre-processing the object before serialization and
+ * post-processing the dictionary after serialization.
+ */
+declare class SaveContext {
+    /**
+     * Optional callback to transform the object before serialization.
+     */
+    preSave?: (obj: unknown) => unknown;
+    /**
+     * Optional callback to transform the dictionary after serialization.
+     */
+    postSave?: (data: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Output format for collections: "object" (name as key) or "array" (list of dicts).
+     * Defaults to "object".
+     */
+    collectionFormat: "object" | "array";
+    /**
+     * Use shorthand scalar representation when possible.
+     * Defaults to true.
+     */
+    useShorthand: boolean;
+    constructor(init?: Partial<SaveContext>);
+    /**
+     * Apply pre-processing to the object if a preSave callback is set.
+     * @param obj - The object to process before serialization.
+     * @returns The processed object, or the original if no callback is set.
+     */
+    processObject<T>(obj: T): T;
+    /**
+     * Apply post-processing to the dictionary if a postSave callback is set.
+     * @param data - The serialized dictionary to process.
+     * @returns The processed dictionary, or the original if no callback is set.
+     */
+    processDict(data: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Convert a dictionary to a YAML string.
+     * @param data - The dictionary to convert.
+     * @returns The YAML string representation.
+     */
+    toYaml(data: Record<string, unknown>): string;
+    /**
+     * Convert a dictionary to a JSON string.
+     * @param data - The dictionary to convert.
+     * @param indent - Number of spaces for indentation.
+     * @returns The JSON string representation.
+     */
+    toJson(data: Record<string, unknown>, indent?: number): string;
+}
+
+/**
+ * Connection configuration for AI agents.
+ * `provider`, `kind`, and `endpoint` are required properties here,
+ * but this section can accept additional via options.
+ *
+ */
+declare abstract class Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The Authentication kind for the AI service (e.g., 'key' for API key, 'oauth' for OAuth tokens)
+     */
+    kind: string;
+    /**
+     * The authority level for the connection, indicating under whose authority the connection is made (e.g., 'user', 'agent', 'system')
+     */
+    authenticationMode: string;
+    /**
+     * The usage description for the connection, providing context on how this connection will be used
+     */
+    usageDescription?: string | undefined;
+    /**
+     * Initializes a new instance of Connection.
+     */
+    constructor(init?: Partial<Connection>);
+    /**
+     * Load a Connection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Connection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Connection;
+    /**
+     * Load polymorphic Connection based on discriminator.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Connection instance.
+     */
+    private static loadKind;
+    /**
+     * Save the Connection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Connection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Connection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Connection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Connection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Connection;
+    /**
+     * Load a Connection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Connection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Connection;
+}
+/**
+ * Connection configuration for AI services using named connections.
+ *
+ */
+declare class ReferenceConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The Authentication kind for the AI service (e.g., 'key' for API key, 'oauth' for OAuth tokens)
+     */
+    kind: string;
+    /**
+     * The name of the connection
+     */
+    name: string;
+    /**
+     * The target resource or service that this connection refers to
+     */
+    target?: string | undefined;
+    /**
+     * Initializes a new instance of ReferenceConnection.
+     */
+    constructor(init?: Partial<ReferenceConnection>);
+    /**
+     * Load a ReferenceConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ReferenceConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): ReferenceConnection;
+    /**
+     * Save the ReferenceConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the ReferenceConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the ReferenceConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a ReferenceConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ReferenceConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): ReferenceConnection;
+    /**
+     * Load a ReferenceConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ReferenceConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): ReferenceConnection;
+}
+/**
+ * Connection configuration for AI services using named connections.
+ *
+ */
+declare class RemoteConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The Authentication kind for the AI service (e.g., 'key' for API key, 'oauth' for OAuth tokens)
+     */
+    kind: string;
+    /**
+     * The name of the connection
+     */
+    name: string;
+    /**
+     * The endpoint URL for the AI service
+     */
+    endpoint: string;
+    /**
+     * Initializes a new instance of RemoteConnection.
+     */
+    constructor(init?: Partial<RemoteConnection>);
+    /**
+     * Load a RemoteConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded RemoteConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): RemoteConnection;
+    /**
+     * Save the RemoteConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the RemoteConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the RemoteConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a RemoteConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded RemoteConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): RemoteConnection;
+    /**
+     * Load a RemoteConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded RemoteConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): RemoteConnection;
+}
+/**
+ * Connection configuration for AI services using API keys.
+ *
+ */
+declare class ApiKeyConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The Authentication kind for the AI service (e.g., 'key' for API key, 'oauth' for OAuth tokens)
+     */
+    kind: string;
+    /**
+     * The endpoint URL for the AI service
+     */
+    endpoint: string;
+    /**
+     * The API key for authenticating with the AI service
+     */
+    apiKey: string;
+    /**
+     * Initializes a new instance of ApiKeyConnection.
+     */
+    constructor(init?: Partial<ApiKeyConnection>);
+    /**
+     * Load a ApiKeyConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ApiKeyConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): ApiKeyConnection;
+    /**
+     * Save the ApiKeyConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the ApiKeyConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the ApiKeyConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a ApiKeyConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ApiKeyConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): ApiKeyConnection;
+    /**
+     * Load a ApiKeyConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ApiKeyConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): ApiKeyConnection;
+}
+/**
+ *
+ *
+ */
+declare class AnonymousConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The Authentication kind for the AI service (e.g., 'key' for API key, 'oauth' for OAuth tokens)
+     */
+    kind: string;
+    /**
+     * The endpoint for authenticating with the AI service
+     */
+    endpoint: string;
+    /**
+     * Initializes a new instance of AnonymousConnection.
+     */
+    constructor(init?: Partial<AnonymousConnection>);
+    /**
+     * Load a AnonymousConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded AnonymousConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): AnonymousConnection;
+    /**
+     * Save the AnonymousConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the AnonymousConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the AnonymousConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a AnonymousConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded AnonymousConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): AnonymousConnection;
+    /**
+     * Load a AnonymousConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded AnonymousConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): AnonymousConnection;
+}
+/**
+ * Connection configuration for Microsoft Foundry projects.
+ * Provides project-scoped access to models, tools, and services
+ * via Entra ID (DefaultAzureCredential) authentication.
+ *
+ */
+declare class FoundryConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The connection kind for Foundry project access
+     */
+    kind: string;
+    /**
+     * The Foundry project endpoint URL
+     */
+    endpoint: string;
+    /**
+     * The named connection within the Foundry project
+     */
+    name?: string | undefined;
+    /**
+     * The connection type within the Foundry project (e.g., 'model', 'index', 'storage')
+     */
+    connectionType?: string | undefined;
+    /**
+     * Initializes a new instance of FoundryConnection.
+     */
+    constructor(init?: Partial<FoundryConnection>);
+    /**
+     * Load a FoundryConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FoundryConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): FoundryConnection;
+    /**
+     * Save the FoundryConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the FoundryConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the FoundryConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a FoundryConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FoundryConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): FoundryConnection;
+    /**
+     * Load a FoundryConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FoundryConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): FoundryConnection;
+}
+/**
+ * Connection configuration using OAuth 2.0 client credentials.
+ * Useful for tools and services that require OAuth authentication,
+ * such as MCP servers, OpenAPI endpoints, or other REST APIs.
+ *
+ */
+declare class OAuthConnection extends Connection {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The connection kind for OAuth authentication
+     */
+    kind: string;
+    /**
+     * The endpoint URL for the service
+     */
+    endpoint: string;
+    /**
+     * The OAuth client ID
+     */
+    clientId: string;
+    /**
+     * The OAuth client secret
+     */
+    clientSecret: string;
+    /**
+     * The OAuth token endpoint URL
+     */
+    tokenUrl: string;
+    /**
+     * OAuth scopes to request
+     */
+    scopes?: string[];
+    /**
+     * Initializes a new instance of OAuthConnection.
+     */
+    constructor(init?: Partial<OAuthConnection>);
+    /**
+     * Load a OAuthConnection instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OAuthConnection instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): OAuthConnection;
+    /**
+     * Save the OAuthConnection instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the OAuthConnection instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the OAuthConnection instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a OAuthConnection instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OAuthConnection instance.
+     */
+    static fromJson(json: string, context?: LoadContext): OAuthConnection;
+    /**
+     * Load a OAuthConnection instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OAuthConnection instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): OAuthConnection;
+}
+
+/**
+ * Options for configuring the behavior of the AI model.
+ *
+ */
+declare class ModelOptions {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The frequency penalty to apply to the model's output
+     */
+    frequencyPenalty?: number | undefined;
+    /**
+     * The maximum number of tokens to generate in the output
+     */
+    maxOutputTokens?: number | undefined;
+    /**
+     * The presence penalty to apply to the model's output
+     */
+    presencePenalty?: number | undefined;
+    /**
+     * A random seed for deterministic output
+     */
+    seed?: number | undefined;
+    /**
+     * The temperature to use for sampling
+     */
+    temperature?: number | undefined;
+    /**
+     * The top-K sampling value
+     */
+    topK?: number | undefined;
+    /**
+     * The top-P sampling value
+     */
+    topP?: number | undefined;
+    /**
+     * Stop sequences to end generation
+     */
+    stopSequences?: string[];
+    /**
+     * Whether to allow multiple tool calls in a single response
+     */
+    allowMultipleToolCalls?: boolean | undefined;
+    /**
+     * Additional custom properties for model options
+     */
+    additionalProperties?: Record<string, unknown> | undefined;
+    /**
+     * Initializes a new instance of ModelOptions.
+     */
+    constructor(init?: Partial<ModelOptions>);
+    /**
+     * Load a ModelOptions instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ModelOptions instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): ModelOptions;
+    /**
+     * Save the ModelOptions instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the ModelOptions instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the ModelOptions instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a ModelOptions instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ModelOptions instance.
+     */
+    static fromJson(json: string, context?: LoadContext): ModelOptions;
+    /**
+     * Load a ModelOptions instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ModelOptions instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): ModelOptions;
+}
+
+/**
+ * Model for defining the structure and behavior of AI agents.
+ * This model includes properties for specifying the model's provider, connection details, and various options.
+ * It allows for flexible configuration of AI models to suit different use cases and requirements.
+ *
+ */
+declare class Model {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The unique identifier of the model - can be used as the single property shorthand
+     */
+    id: string;
+    /**
+     * The provider of the model (e.g., 'openai', 'azure', 'anthropic')
+     */
+    provider?: string | undefined;
+    /**
+     * The type of API to use for the model (e.g., 'chat', 'response', etc.)
+     */
+    apiType?: string | undefined;
+    /**
+     * The connection configuration for the model
+     */
+    connection?: Connection | undefined;
+    /**
+     * Additional options for the model
+     */
+    options?: ModelOptions | undefined;
+    /**
+     * Initializes a new instance of Model.
+     */
+    constructor(init?: Partial<Model>);
+    /**
+     * Load a Model instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Model instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Model;
+    /**
+     * Save the Model instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Model instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Model instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Model instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Model instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Model;
+    /**
+     * Load a Model instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Model instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Model;
+}
+
+/**
+ * Represents a single property.
+ *
+ * - This model defines the structure of properties that can be used in prompts,
+ * including their type, description, whether they are required, and other attributes.
+ * - It allows for the definition of dynamic inputs that can be filled with data
+ * and processed to generate prompts for AI models.
+ *
+ */
+declare class Property {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Name of the property
+     */
+    name: string;
+    /**
+     * The data type of the input property
+     */
+    kind: string;
+    /**
+     * A short description of the input property
+     */
+    description?: string | undefined;
+    /**
+     * Whether the property is required
+     */
+    required?: boolean | undefined;
+    /**
+     * The default value of the property - this represents the default value if none is provided
+     */
+    default?: unknown | undefined;
+    /**
+     * Example value used for either initialization or tooling
+     */
+    example?: unknown | undefined;
+    /**
+     * Allowed enumeration values for the property
+     */
+    enumValues?: unknown[];
+    /**
+     * Initializes a new instance of Property.
+     */
+    constructor(init?: Partial<Property>);
+    /**
+     * Load a Property instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Property instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Property;
+    /**
+     * Load polymorphic Property based on discriminator.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Property instance.
+     */
+    private static loadKind;
+    /**
+     * Save the Property instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Property instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Property instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Property instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Property instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Property;
+    /**
+     * Load a Property instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Property instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Property;
+}
+/**
+ * Represents an array property.
+ * This extends the base Property model to represent an array of items.
+ *
+ */
+declare class ArrayProperty extends Property {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     *
+     */
+    kind: string;
+    /**
+     * The type of items contained in the array
+     */
+    items: Property;
+    /**
+     * Initializes a new instance of ArrayProperty.
+     */
+    constructor(init?: Partial<ArrayProperty>);
+    /**
+     * Load a ArrayProperty instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ArrayProperty instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): ArrayProperty;
+    /**
+     * Save the ArrayProperty instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the ArrayProperty instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the ArrayProperty instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a ArrayProperty instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ArrayProperty instance.
+     */
+    static fromJson(json: string, context?: LoadContext): ArrayProperty;
+    /**
+     * Load a ArrayProperty instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ArrayProperty instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): ArrayProperty;
+}
+/**
+ * Represents an object property.
+ * This extends the base Property model to represent a structured object.
+ *
+ */
+declare class ObjectProperty extends Property {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     *
+     */
+    kind: string;
+    /**
+     * The properties contained in the object
+     */
+    properties: Property[];
+    /**
+     * Initializes a new instance of ObjectProperty.
+     */
+    constructor(init?: Partial<ObjectProperty>);
+    /**
+     * Load a ObjectProperty instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ObjectProperty instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): ObjectProperty;
+    /**
+     * Load a collection of Property from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Property.
+     */
+    static loadProperties(data: unknown, context?: LoadContext): Property[];
+    /**
+     * Save the ObjectProperty instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Save a collection of Property to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveProperties(items: Property[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Convert the ObjectProperty instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the ObjectProperty instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a ObjectProperty instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ObjectProperty instance.
+     */
+    static fromJson(json: string, context?: LoadContext): ObjectProperty;
+    /**
+     * Load a ObjectProperty instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded ObjectProperty instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): ObjectProperty;
+}
+
+/**
+ * Template format definition
+ *
+ */
+declare class Format {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Template rendering engine used for slot filling prompts (e.g., mustache, jinja2)
+     */
+    kind: string;
+    /**
+     * Whether the template can emit structural text for parsing output
+     */
+    strict?: boolean | undefined;
+    /**
+     * Options for the template engine
+     */
+    options?: Record<string, unknown> | undefined;
+    /**
+     * Initializes a new instance of Format.
+     */
+    constructor(init?: Partial<Format>);
+    /**
+     * Load a Format instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Format instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Format;
+    /**
+     * Save the Format instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Format instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Format instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Format instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Format instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Format;
+    /**
+     * Load a Format instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Format instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Format;
+}
+
+/**
+ * Template parser definition
+ *
+ */
+declare class Parser$1 {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Parser used to process the rendered template into API-compatible format
+     */
+    kind: string;
+    /**
+     * Options for the parser
+     */
+    options?: Record<string, unknown> | undefined;
+    /**
+     * Initializes a new instance of Parser.
+     */
+    constructor(init?: Partial<Parser$1>);
+    /**
+     * Load a Parser instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Parser instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Parser$1;
+    /**
+     * Save the Parser instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Parser instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Parser instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Parser instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Parser instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Parser$1;
+    /**
+     * Load a Parser instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Parser instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Parser$1;
+}
+
+/**
+ * Template model for defining prompt templates.
+ *
+ * This model specifies the rendering engine used for slot filling prompts,
+ * the parser used to process the rendered template into API-compatible format,
+ * and additional options for the template engine.
+ *
+ * It allows for the creation of reusable templates that can be filled with dynamic data
+ * and processed to generate prompts for AI models.
+ *
+ */
+declare class Template {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Template rendering engine used for slot filling prompts (e.g., mustache, jinja2)
+     */
+    format: Format;
+    /**
+     * Parser used to process the rendered template into API-compatible format
+     */
+    parser: Parser$1;
+    /**
+     * Initializes a new instance of Template.
+     */
+    constructor(init?: Partial<Template>);
+    /**
+     * Load a Template instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Template instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Template;
+    /**
+     * Save the Template instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Template instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Template instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Template instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Template instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Template;
+    /**
+     * Load a Template instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Template instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Template;
+}
+
+/**
+ * Represents a binding between an input property and a tool parameter.
+ *
+ */
+declare class Binding {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Name of the binding
+     */
+    name: string;
+    /**
+     * The input property that will be bound to the tool parameter argument
+     */
+    input: string;
+    /**
+     * Initializes a new instance of Binding.
+     */
+    constructor(init?: Partial<Binding>);
+    /**
+     * Load a Binding instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Binding instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Binding;
+    /**
+     * Save the Binding instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the Binding instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Binding instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Binding instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Binding instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Binding;
+    /**
+     * Load a Binding instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Binding instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Binding;
+}
+
+/**
+ * The approval mode for MCP server tools.
+ * When kind is "specify", use alwaysRequireApprovalTools and neverRequireApprovalTools
+ * to control per-tool approval. For "always" and "never", those fields are ignored.
+ *
+ */
+declare class McpApprovalMode {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The approval mode: 'always', 'never', or 'specify'
+     */
+    kind: string;
+    /**
+     * List of tools that always require approval (only used when kind is 'specify')
+     */
+    alwaysRequireApprovalTools?: string[];
+    /**
+     * List of tools that never require approval (only used when kind is 'specify')
+     */
+    neverRequireApprovalTools?: string[];
+    /**
+     * Initializes a new instance of McpApprovalMode.
+     */
+    constructor(init?: Partial<McpApprovalMode>);
+    /**
+     * Load a McpApprovalMode instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpApprovalMode instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): McpApprovalMode;
+    /**
+     * Save the McpApprovalMode instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the McpApprovalMode instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the McpApprovalMode instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a McpApprovalMode instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpApprovalMode instance.
+     */
+    static fromJson(json: string, context?: LoadContext): McpApprovalMode;
+    /**
+     * Load a McpApprovalMode instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpApprovalMode instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): McpApprovalMode;
+}
+
+/**
+ * Represents a tool that can be used in prompts.
+ *
+ */
+declare abstract class Tool {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Name of the tool. If a function tool, this is the function name, otherwise it is the type
+     */
+    name: string;
+    /**
+     * The kind identifier for the tool
+     */
+    kind: string;
+    /**
+     * A short description of the tool for metadata purposes
+     */
+    description?: string | undefined;
+    /**
+     * Tool argument bindings to input properties
+     */
+    bindings?: Binding[];
+    /**
+     * Initializes a new instance of Tool.
+     */
+    constructor(init?: Partial<Tool>);
+    /**
+     * Load a Tool instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Tool instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Tool;
+    /**
+     * Load a collection of Binding from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Binding.
+     */
+    static loadBindings(data: unknown, context?: LoadContext): Binding[];
+    /**
+     * Load polymorphic Tool based on discriminator.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Tool instance.
+     */
+    private static loadKind;
+    /**
+     * Save the Tool instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Save a collection of Binding to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveBindings(items: Binding[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Convert the Tool instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Tool instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Tool instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Tool instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Tool;
+    /**
+     * Load a Tool instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Tool instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Tool;
+}
+/**
+ * Represents a local function tool.
+ *
+ */
+declare class FunctionTool extends Tool {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The kind identifier for function tools
+     */
+    kind: string;
+    /**
+     * Parameters accepted by the function tool
+     */
+    parameters: Property[];
+    /**
+     * Indicates whether the function tool enforces strict validation on its parameters
+     */
+    strict?: boolean | undefined;
+    /**
+     * Initializes a new instance of FunctionTool.
+     */
+    constructor(init?: Partial<FunctionTool>);
+    /**
+     * Load a FunctionTool instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FunctionTool instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): FunctionTool;
+    /**
+     * Load a collection of Property from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Property.
+     */
+    static loadParameters(data: unknown, context?: LoadContext): Property[];
+    /**
+     * Save the FunctionTool instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Save a collection of Property to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveParameters(items: Property[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Convert the FunctionTool instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the FunctionTool instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a FunctionTool instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FunctionTool instance.
+     */
+    static fromJson(json: string, context?: LoadContext): FunctionTool;
+    /**
+     * Load a FunctionTool instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded FunctionTool instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): FunctionTool;
+}
+/**
+ * Represents a generic server tool that runs on a server
+ * This tool kind is designed for operations that require server-side execution
+ * It may include features such as authentication, data storage, and long-running processes
+ * This tool kind is ideal for tasks that involve complex computations or access to secure resources
+ * Server tools can be used to offload heavy processing from client applications
+ *
+ */
+declare class CustomTool extends Tool {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The kind identifier for server tools. This is a wildcard and can represent any server tool type not explicitly defined.
+     */
+    kind: string;
+    /**
+     * Connection configuration for the server tool
+     */
+    connection: Connection;
+    /**
+     * Configuration options for the server tool
+     */
+    options: Record<string, unknown>;
+    /**
+     * Initializes a new instance of CustomTool.
+     */
+    constructor(init?: Partial<CustomTool>);
+    /**
+     * Load a CustomTool instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded CustomTool instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): CustomTool;
+    /**
+     * Save the CustomTool instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the CustomTool instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the CustomTool instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a CustomTool instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded CustomTool instance.
+     */
+    static fromJson(json: string, context?: LoadContext): CustomTool;
+    /**
+     * Load a CustomTool instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded CustomTool instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): CustomTool;
+}
+/**
+ * The MCP Server tool.
+ *
+ */
+declare class McpTool extends Tool {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The kind identifier for MCP tools
+     */
+    kind: string;
+    /**
+     * The connection configuration for the MCP tool
+     */
+    connection: Connection;
+    /**
+     * The server name of the MCP tool
+     */
+    serverName: string;
+    /**
+     * The description of the MCP tool
+     */
+    serverDescription?: string | undefined;
+    /**
+     * The approval mode for the MCP tool
+     */
+    approvalMode: McpApprovalMode;
+    /**
+     * List of allowed operations or resources for the MCP tool
+     */
+    allowedTools?: string[];
+    /**
+     * Initializes a new instance of McpTool.
+     */
+    constructor(init?: Partial<McpTool>);
+    /**
+     * Load a McpTool instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpTool instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): McpTool;
+    /**
+     * Save the McpTool instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the McpTool instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the McpTool instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a McpTool instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpTool instance.
+     */
+    static fromJson(json: string, context?: LoadContext): McpTool;
+    /**
+     * Load a McpTool instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded McpTool instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): McpTool;
+}
+/**
+ *
+ *
+ */
+declare class OpenApiTool extends Tool {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * The kind identifier for OpenAPI tools
+     */
+    kind: string;
+    /**
+     * The connection configuration for the OpenAPI tool
+     */
+    connection: Connection;
+    /**
+     * The full OpenAPI specification
+     */
+    specification: string;
+    /**
+     * Initializes a new instance of OpenApiTool.
+     */
+    constructor(init?: Partial<OpenApiTool>);
+    /**
+     * Load a OpenApiTool instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OpenApiTool instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): OpenApiTool;
+    /**
+     * Save the OpenApiTool instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Convert the OpenApiTool instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the OpenApiTool instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a OpenApiTool instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OpenApiTool instance.
+     */
+    static fromJson(json: string, context?: LoadContext): OpenApiTool;
+    /**
+     * Load a OpenApiTool instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded OpenApiTool instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): OpenApiTool;
+}
+
+/**
+ * A Prompty is a markdown file format for LLM prompts. The frontmatter defines
+ * structured metadata including model configuration, input/output schemas, tools,
+ * and template settings. The markdown body becomes the instructions.
+ *
+ * This is the single root type for the Prompty schema — there is no abstract base
+ * class or kind discriminator. A .prompty file always produces a Prompty instance.
+ *
+ */
+declare class Prompty {
+    /**
+     * The shorthand property name for this type, if any.
+     */
+    static readonly shorthandProperty: string | undefined;
+    /**
+     * Human-readable name of the prompt
+     */
+    name: string;
+    /**
+     * Display name for UI purposes
+     */
+    displayName?: string | undefined;
+    /**
+     * Description of the prompt's purpose
+     */
+    description?: string | undefined;
+    /**
+     * Additional metadata including authors, tags, and other arbitrary properties
+     */
+    metadata?: Record<string, unknown> | undefined;
+    /**
+     * Input parameters that participate in template rendering
+     */
+    inputs?: Property[];
+    /**
+     * Expected output format and structure
+     */
+    outputs?: Property[];
+    /**
+     * AI model configuration
+     */
+    model: Model;
+    /**
+     * Tools available for extended functionality
+     */
+    tools?: Tool[];
+    /**
+     * Template configuration for prompt rendering
+     */
+    template?: Template | undefined;
+    /**
+     * Clear directions on what the prompt should do. In .prompty files, this comes from the markdown body.
+     */
+    instructions?: string | undefined;
+    /**
+     * Initializes a new instance of Prompty.
+     */
+    constructor(init?: Partial<Prompty>);
+    /**
+     * Load a Prompty instance from a dictionary.
+     * @param data - The dictionary containing the data.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Prompty instance.
+     */
+    static load(data: Record<string, unknown>, context?: LoadContext): Prompty;
+    /**
+     * Load a collection of Property from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Property.
+     */
+    static loadInputs(data: unknown, context?: LoadContext): Property[];
+    /**
+     * Load a collection of Property from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Property.
+     */
+    static loadOutputs(data: unknown, context?: LoadContext): Property[];
+    /**
+     * Load a collection of Tool from a dictionary or array.
+     * @param data - The data to load from.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded array of Tool.
+     */
+    static loadTools(data: unknown, context?: LoadContext): Tool[];
+    /**
+     * Save the Prompty instance to a dictionary.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The dictionary representation of this instance.
+     */
+    save(context?: SaveContext): Record<string, unknown>;
+    /**
+     * Save a collection of Property to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveInputs(items: Property[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Save a collection of Property to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveOutputs(items: Property[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Save a collection of Tool to object or array format.
+     * @param items - The items to save.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The saved collection in object or array format.
+     */
+    static saveTools(items: Tool[], context?: SaveContext): Record<string, unknown> | Record<string, unknown>[];
+    /**
+     * Convert the Prompty instance to a YAML string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The YAML string representation of this instance.
+     */
+    toYaml(context?: SaveContext): string;
+    /**
+     * Convert the Prompty instance to a JSON string.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @param indent - Number of spaces for indentation. Defaults to 2.
+     * @returns The JSON string representation of this instance.
+     */
+    toJson(context?: SaveContext, indent?: number): string;
+    /**
+     * Load a Prompty instance from a JSON string.
+     * @param json - The JSON string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Prompty instance.
+     */
+    static fromJson(json: string, context?: LoadContext): Prompty;
+    /**
+     * Load a Prompty instance from a YAML string.
+     * @param yaml - The YAML string to parse.
+     * @param context - Optional context with pre/post processing callbacks.
+     * @returns The loaded Prompty instance.
+     */
+    static fromYaml(yaml: string, context?: LoadContext): Prompty;
+}
+
+/**
+ * Plugin interfaces for the Prompty pipeline.
+ *
+ * Each pipeline step is defined as an interface. Implementations are
+ * registered via the registry and discovered at runtime by key
+ * (e.g., "nunjucks" for renderers, "openai" for executors).
+ *
+ * @module
+ */
+
+/**
+ * Renders a template string with the given inputs.
+ *
+ * Discovered by: `agent.template.format.kind` (e.g., "nunjucks", "mustache").
+ */
+interface Renderer {
+    render(agent: Prompty, template: string, inputs: Record<string, unknown>): Promise<string>;
+}
+/**
+ * Parses a rendered string into an array of abstract Messages.
+ *
+ * Discovered by: `agent.template.parser.kind` (e.g., "prompty").
+ *
+ * Optionally implements `preRender()` for nonce injection (strict mode).
+ */
+interface Parser {
+    parse(agent: Prompty, rendered: string, context?: Record<string, unknown>): Promise<Message[]>;
+    /**
+     * Optional hook called before rendering to sanitize the template
+     * and produce context used during parsing.
+     *
+     * Returns `[sanitizedTemplate, context]`.
+     */
+    preRender?(template: string): [string, Record<string, unknown>];
+}
+/**
+ * Sends messages to an LLM provider and returns the raw response.
+ *
+ * Discovered by: `agent.model.provider` (e.g., "openai", "azure").
+ */
+interface Executor {
+    execute(agent: Prompty, messages: Message[]): Promise<unknown>;
+}
+/**
+ * Extracts clean results from raw LLM responses.
+ *
+ * Discovered by: `agent.model.provider` (e.g., "openai", "azure").
+ */
+interface Processor {
+    process(agent: Prompty, response: unknown): Promise<unknown>;
+}
+
+/**
+ * Plugin registry for Prompty pipeline components.
+ *
+ * TypeScript doesn't have Python's entry-point system, so we use
+ * explicit registration. Built-in implementations are registered
+ * when the package is imported (see src/index.ts).
+ *
+ * Third-party plugins call `registerRenderer()`, etc. at module load.
+ *
+ * @module
+ */
+
+declare function registerRenderer(key: string, impl: Renderer): void;
+declare function registerParser(key: string, impl: Parser): void;
+declare function registerExecutor(key: string, impl: Executor): void;
+declare function registerProcessor(key: string, impl: Processor): void;
+declare class InvokerError extends Error {
+    readonly group: string;
+    readonly key: string;
+    constructor(group: string, key: string);
+}
+declare function getRenderer(key: string): Renderer;
+declare function getParser(key: string): Parser;
+declare function getExecutor(key: string): Executor;
+declare function getProcessor(key: string): Processor;
+/** Clear all registered implementations. Useful in tests. */
+declare function clearCache(): void;
+
+/**
+ * Connection registry for pre-configured SDK clients.
+ *
+ * Executors look up registered connections when
+ * `model.connection.kind === "reference"`.
+ *
+ * @module
+ */
+/**
+ * Register a pre-configured SDK client by name.
+ *
+ * @example
+ * ```ts
+ * import OpenAI from "openai";
+ * registerConnection("my-openai", new OpenAI({ apiKey: "sk-..." }));
+ * ```
+ */
+declare function registerConnection(name: string, client: unknown): void;
+/**
+ * Look up a registered connection.
+ * @throws {Error} if the name is not registered.
+ */
+declare function getConnection(name: string): unknown;
+/** Remove all registered connections. Useful in tests. */
+declare function clearConnections(): void;
+
+/**
+ * Prompty loader — loads .prompty files into typed Prompty objects.
+ *
+ * Splits frontmatter (YAML) from the markdown body, resolves
+ * `${protocol:value}` references (env vars, file includes),
+ * and delegates to `Prompty.load()`.
+ *
+ * @module
+ */
+
+/**
+ * Load a `.prompty` file and return a typed `Prompty`.
+ *
+ * @param path - File system path to a `.prompty` file.
+ * @returns Fully typed Prompty definition.
+ */
+declare function load(path: string): Prompty;
+
+/**
+ * Four-step execution pipeline.
+ *
+ * ```
+ * execute(prompt, inputs)              → top-level orchestrator
+ *   ├── prepare(agent, inputs)         → template → wire format
+ *   │     ├── render(agent, inputs)    → template + inputs → rendered string
+ *   │     └── parse(agent, rendered)   → rendered string → Message[]
+ *   └── run(agent, messages)           → LLM call → clean result
+ *         ├── Executor.execute(...)    → messages → raw LLM response
+ *         └── process(agent, response) → raw response → clean result
+ * ```
+ *
+ * Each leaf step is independently traced. Users can bring their own
+ * Renderer, Parser, Executor, Processor via the registry.
+ *
+ * @module
+ */
+
+/**
+ * Validate and fill defaults for agent inputs.
+ */
+declare function validateInputs(agent: Prompty, inputs: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Render the template with inputs.
+ *
+ * Discovered by: `agent.template.format.kind` (default: "nunjucks").
+ */
+declare function render(agent: Prompty, inputs: Record<string, unknown>): Promise<string>;
+/**
+ * Parse a rendered string into abstract messages.
+ *
+ * Discovered by: `agent.template.parser.kind` (default: "prompty").
+ */
+declare function parse(agent: Prompty, rendered: string, context?: Record<string, unknown>): Promise<Message[]>;
+/**
+ * Process a raw LLM response into a clean result.
+ *
+ * Discovered by: `agent.model.provider` (default: "openai").
+ */
+declare function process(agent: Prompty, response: unknown): Promise<unknown>;
+/**
+ * Render template + parse into messages + expand thread markers.
+ */
+declare function prepare(agent: Prompty, inputs?: Record<string, unknown>): Promise<Message[]>;
+/**
+ * Execute messages against the LLM and process the response.
+ */
+declare function run(agent: Prompty, messages: Message[], options?: {
+    raw?: boolean;
+}): Promise<unknown>;
+/**
+ * Full pipeline: load → prepare → run.
+ */
+declare function execute(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+    raw?: boolean;
+}): Promise<unknown>;
+/**
+ * Run a prompt with automatic tool-call execution loop.
+ */
+declare function executeAgent(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+    tools?: Record<string, (...args: unknown[]) => unknown>;
+    maxIterations?: number;
+    raw?: boolean;
+}): Promise<unknown>;
+declare const runAgent: typeof executeAgent;
+
+/**
+ * Nunjucks renderer — Jinja2-compatible template rendering for TypeScript.
+ *
+ * Nunjucks is the standard Jinja2-compatible engine for Node.js.
+ * This renderer replaces thread-kind inputs with nonce markers
+ * before rendering.
+ *
+ * @module
+ */
+
+declare class NunjucksRenderer implements Renderer {
+    render(agent: Prompty, template: string, inputs: Record<string, unknown>): Promise<string>;
+}
+
+/**
+ * Mustache renderer — logic-less template rendering.
+ *
+ * @module
+ */
+
+declare class MustacheRenderer implements Renderer {
+    render(agent: Prompty, template: string, inputs: Record<string, unknown>): Promise<string>;
+}
+
+/**
+ * Prompty chat parser — splits rendered text into abstract messages.
+ *
+ * Recognizes role markers (`system:`, `user:`, `assistant:`, `developer:`)
+ * and inline markdown images. Supports nonce-based sanitization when
+ * `Format.strict` is enabled.
+ *
+ * @module
+ */
+
+declare class PromptyChatParser implements Parser {
+    preRender(template: string): [string, Record<string, unknown>];
+    parse(agent: Prompty, rendered: string, context?: Record<string, unknown>): Promise<Message[]>;
+    private resolveBasePath;
+    private parseMessages;
+    private buildMessage;
+    private parseAttrs;
+    private parseContent;
+    private resolveImage;
+}
+
+/**
+ * Tracing framework — multi-backend registry with function wrappers.
+ *
+ * Matches the Python tracing architecture:
+ * - `Tracer` registry holds named backends
+ * - `trace()` wraps async functions with span tracking
+ * - `traceSpan()` creates manual spans
+ * - Each backend receives `(key, value)` events
+ *
+ * @module
+ */
+/** A tracer backend receives (key, value) events for a span. */
+type TracerBackend = (key: string, value: unknown) => void;
+/** Factory: given a span signature, return a backend (or null to skip). */
+type TracerFactory = (signature: string) => TracerBackend | null;
+declare const Tracer: {
+    /**
+     * Register a tracer backend.
+     *
+     * @param name - Unique name for this backend.
+     * @param factory - Called for each new span; return a callback or null.
+     */
+    add(name: string, factory: TracerFactory): void;
+    /** Remove a tracer backend by name. */
+    remove(name: string): void;
+    /** Remove all backends. */
+    clear(): void;
+    /**
+     * Start a new trace span. Returns a callback for emitting events
+     * and a `end()` function to close the span.
+     */
+    start(signature: string): SpanEmitter;
+};
+interface SpanEmitter {
+    (key: string, value: unknown): void;
+    end: () => void;
+}
+/**
+ * Wrap an async function with tracing.
+ *
+ * Creates a span with the function name, traces inputs and output,
+ * and measures duration.
+ *
+ * @param fn - The async function to wrap.
+ * @param name - Optional span name (defaults to `fn.name`).
+ * @returns Wrapped function with same signature.
+ */
+declare function trace<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, name?: string): T;
+/**
+ * Execute a callback within a traced span.
+ *
+ * @param name - Span name.
+ * @param fn - Callback receiving a `(key, value)` emitter.
+ * @returns The callback's return value.
+ */
+declare function traceSpan<T>(name: string, fn: (emit: (key: string, value: unknown) => void) => Promise<T>): Promise<T>;
+/**
+ * Method decorator that wraps a class method with tracing.
+ *
+ * ```typescript
+ * class MyService {
+ *   @traceMethod()
+ *   async chat(question: string): Promise<string> { ... }
+ * }
+ * ```
+ *
+ * @param attributes - Optional key-value pairs to emit at the start of each span.
+ */
+declare function traceMethod(attributes?: Record<string, unknown>): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** Redact sensitive values from trace output. */
+declare function sanitizeValue(key: string, value: unknown): unknown;
+/**
+ * Convert an arbitrary object to a JSON-serializable form.
+ * Handles Date, Error, Map, Set, etc.
+ */
+declare function toSerializable(obj: unknown): unknown;
+
+/**
+ * Console tracer backend — prints trace events to stderr.
+ *
+ * @module
+ */
+
+/**
+ * A tracer factory that prints all span events to stderr.
+ *
+ * @example
+ * ```ts
+ * import { Tracer } from "prompty";
+ * import { consoleTracer } from "prompty/tracing";
+ * Tracer.add("console", consoleTracer);
+ * ```
+ */
+declare const consoleTracer: TracerFactory;
+
+/**
+ * File-writing tracer backend — writes hierarchical `.tracy` JSON files.
+ *
+ * Mirrors the Python `PromptyTracer`: captures timing, usage metrics,
+ * and nested call frames, then writes a `.tracy` file on root span completion.
+ *
+ * @module
+ */
+
+/**
+ * JSON file trace backend that writes `.tracy` files to disk.
+ *
+ * Each completed root span is written as a `.tracy` file in the configured
+ * output directory, using the format: `{spanName}.{YYYYMMDD.HHMMSS}.tracy`
+ *
+ * @example
+ * ```ts
+ * import { Tracer } from "@prompty/core";
+ * import { PromptyTracer } from "@prompty/core";
+ *
+ * const pt = new PromptyTracer({ outputDir: "./.runs" });
+ * Tracer.add("prompty", pt.factory);
+ * ```
+ */
+declare class PromptyTracer {
+    private outputDir;
+    private version;
+    private stack;
+    /** The path of the last written `.tracy` file, if any. */
+    lastTracePath: string | undefined;
+    constructor(options?: {
+        outputDir?: string;
+        version?: string;
+    });
+    /**
+     * The tracer factory — pass this to `Tracer.add()`.
+     *
+     * Arrow function so `this` is bound correctly.
+     */
+    factory: TracerFactory;
+    private endSpan;
+    private hoistUsage;
+    private writeTrace;
+    private serializeFrame;
+    /** Format a Date to match the Python PromptyTracer format: `YYYY-MM-DDTHH:MM:SS.ffffff` */
+    private formatDateTime;
+    private sanitizeName;
+}
+
+export { Prompty as AgentDefinition, AnonymousConnection, ApiKeyConnection, ArrayProperty, type AudioPart, Binding, Connection, type ContentPart, CustomTool, type Executor, type FilePart, Format, FoundryConnection, FunctionTool, type ImagePart, InvokerError, LoadContext, McpApprovalMode, McpTool, Message, Model, ModelOptions, MustacheRenderer, NunjucksRenderer, OAuthConnection, ObjectProperty, OpenApiTool, type Parser, type Processor, Prompty as PromptAgent, Prompty, PromptyChatParser, PromptyStream, PromptyTracer, Property, RICH_KINDS, ROLES, ReferenceConnection, RemoteConnection, type Renderer, type Role, SaveContext, Parser$1 as SchemaParser, type SpanEmitter, Template, type TextPart, ThreadMarker, Tool, type ToolCall, Tracer, type TracerBackend, type TracerFactory, clearCache, clearConnections, consoleTracer, dictContentToPart, dictToMessage, execute, executeAgent, getConnection, getExecutor, getParser, getProcessor, getRenderer, load, parse, prepare, process, registerConnection, registerExecutor, registerParser, registerProcessor, registerRenderer, render, run, runAgent, sanitizeValue, text, textMessage, toSerializable, trace, traceMethod, traceSpan, validateInputs };