@z3rno/sdk 0.9.0 → 0.23.0

package/dist/index.d.cts

@@ -1,2127 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Zod schemas and inferred TypeScript types for the Z3rno API.
- *
- * Each export is a dual: a Zod schema (used for runtime validation) and an
- * identically-named TypeScript type (used at compile time). Request schemas
- * validate client-side input; response schemas validate server payloads.
- *
- * @module models
- */
-
-/**
- * Memory type enum.
- *
- * Controls how a memory is stored, indexed, and decayed.
- *
- * - `working` — Short-lived scratchpad memory (high decay rate).
- * - `episodic` — Event-based memory tied to a specific interaction.
- * - `semantic` — Long-term factual knowledge.
- * - `procedural` — How-to or process knowledge.
- */
-declare const MemoryType: z.ZodEnum<["working", "episodic", "semantic", "procedural"]>;
-/** Memory type: `"working"` | `"episodic"` | `"semantic"` | `"procedural"`. */
-type MemoryType = z.infer<typeof MemoryType>;
-/**
- * Relationship type enum.
- *
- * Describes how two memories are related in the knowledge graph.
- *
- * - `derived_from` — This memory was created from another.
- * - `contradicts` — This memory conflicts with another.
- * - `supports` — This memory reinforces another.
- * - `supersedes` — This memory replaces another.
- * - `related_to` — General association.
- * - `caused_by` — Causal relationship.
- */
-declare const RelationshipType: z.ZodEnum<["derived_from", "contradicts", "supports", "supersedes", "related_to", "caused_by"]>;
-/** Relationship type between two memories. */
-type RelationshipType = z.infer<typeof RelationshipType>;
-/**
- * Retrieval strategy for `recall({ strategy: ... })` — Phase C.
- *
- * `AUTO` is the default; the server's LLM router picks one of the
- * others when configured. Use an explicit value to bypass routing.
- */
-declare const RetrievalStrategy: z.ZodEnum<["AUTO", "VECTOR", "LEXICAL", "GRAPH", "TRIPLET", "TRACE", "TEMPORAL", "ASK", "CYPHER"]>;
-/** Retrieval strategy enum (canonical UPPERCASE names). */
-type RetrievalStrategy = z.infer<typeof RetrievalStrategy>;
-/**
- * Schema for storing a new memory.
- *
- * @example
- * ```ts
- * const request = StoreMemoryRequest.parse({
- *   agentId: "550e8400-e29b-41d4-a716-446655440000",
- *   content: "User prefers dark mode",
- *   memoryType: "semantic",
- * });
- * ```
- */
-declare const StoreMemoryRequest: z.ZodObject<{
-    /** UUID of the agent that owns this memory. */
-    agentId: z.ZodString;
-    /** The text content to store (1 to 100,000 characters). */
-    content: z.ZodString;
-    /** Category of memory. Defaults to `"episodic"`. */
-    memoryType: z.ZodDefault<z.ZodEnum<["working", "episodic", "semantic", "procedural"]>>;
-    /** Optional UUID of the user associated with this memory. */
-    userId: z.ZodOptional<z.ZodString>;
-    /** Arbitrary key-value metadata attached to the memory. */
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    /** Relationships to other memories in the knowledge graph. */
-    relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** UUID of the target memory. */
-        targetMemoryId: z.ZodString;
-        /** Type of relationship to the target memory. */
-        relationshipType: z.ZodEnum<["derived_from", "contradicts", "supports", "supersedes", "related_to", "caused_by"]>;
-        /** Relationship strength from 0 to 1. Defaults to 1.0. */
-        weight: z.ZodDefault<z.ZodNumber>;
-        /** Arbitrary metadata for the relationship edge. */
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        metadata: Record<string, unknown>;
-        targetMemoryId: string;
-        relationshipType: "derived_from" | "contradicts" | "supports" | "supersedes" | "related_to" | "caused_by";
-        weight: number;
-    }, {
-        targetMemoryId: string;
-        relationshipType: "derived_from" | "contradicts" | "supports" | "supersedes" | "related_to" | "caused_by";
-        metadata?: Record<string, unknown> | undefined;
-        weight?: number | undefined;
-    }>, "many">>;
-    /** Time-to-live in seconds. Memory auto-deletes after this duration. */
-    ttlSeconds: z.ZodOptional<z.ZodNumber>;
-    /** Importance score from 0 to 1. Influences recall ranking. */
-    importance: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    agentId: string;
-    content: string;
-    memoryType: "working" | "episodic" | "semantic" | "procedural";
-    metadata: Record<string, unknown>;
-    relationships: {
-        metadata: Record<string, unknown>;
-        targetMemoryId: string;
-        relationshipType: "derived_from" | "contradicts" | "supports" | "supersedes" | "related_to" | "caused_by";
-        weight: number;
-    }[];
-    userId?: string | undefined;
-    ttlSeconds?: number | undefined;
-    importance?: number | undefined;
-}, {
-    agentId: string;
-    content: string;
-    memoryType?: "working" | "episodic" | "semantic" | "procedural" | undefined;
-    userId?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    relationships?: {
-        targetMemoryId: string;
-        relationshipType: "derived_from" | "contradicts" | "supports" | "supersedes" | "related_to" | "caused_by";
-        metadata?: Record<string, unknown> | undefined;
-        weight?: number | undefined;
-    }[] | undefined;
-    ttlSeconds?: number | undefined;
-    importance?: number | undefined;
-}>;
-/** Parsed type for a store-memory request. */
-type StoreMemoryRequest = z.infer<typeof StoreMemoryRequest>;
-/**
- * Schema for a single memory object returned by the API.
- *
- * Used by {@link Z3rnoClient.store}, {@link Z3rnoClient.getMemory}, and
- * {@link Z3rnoClient.updateMemory}.
- */
-declare const MemoryResponse: z.ZodObject<{
-    /** Unique identifier for this memory. */
-    id: z.ZodString;
-    /** UUID of the owning agent. */
-    agent_id: z.ZodString;
-    /** Text content of the memory. */
-    content: z.ZodString;
-    /** Category of the memory. */
-    memory_type: z.ZodString;
-    /** Server-computed importance score (0-1). */
-    importance_score: z.ZodNumber;
-    /** Number of times this memory has been recalled. */
-    recall_count: z.ZodNumber;
-    /** Name of the embedding model used, if any. */
-    embedding_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** ISO 8601 creation timestamp. */
-    created_at: z.ZodString;
-    /** Arbitrary metadata attached to the memory. */
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    content: string;
-    metadata: Record<string, unknown>;
-    id: string;
-    agent_id: string;
-    memory_type: string;
-    importance_score: number;
-    recall_count: number;
-    created_at: string;
-    embedding_model?: string | null | undefined;
-}, {
-    content: string;
-    id: string;
-    agent_id: string;
-    memory_type: string;
-    importance_score: number;
-    recall_count: number;
-    created_at: string;
-    metadata?: Record<string, unknown> | undefined;
-    embedding_model?: string | null | undefined;
-}>;
-/** Parsed type for a memory response. */
-type MemoryResponse = z.infer<typeof MemoryResponse>;
-/**
- * Schema for a single item in recall results.
- *
- * Each item includes similarity, importance, and relevance scores
- * computed by the server's ranking algorithm.
- */
-declare const RecallResultItem: z.ZodObject<{
-    /** Unique identifier of the recalled memory. */
-    memory_id: z.ZodString;
-    /** Text content of the memory. */
-    content: z.ZodString;
-    /** Optional server-generated summary. */
-    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Category of the memory. */
-    memory_type: z.ZodString;
-    /** Cosine similarity to the query (0-1). */
-    similarity_score: z.ZodNumber;
-    /** Server-computed importance score (0-1). */
-    importance_score: z.ZodNumber;
-    /** Combined relevance score used for ranking (0-1). */
-    relevance_score: z.ZodNumber;
-    /** Number of times this memory has been recalled. */
-    recall_count: z.ZodNumber;
-    /** ISO 8601 creation timestamp. */
-    created_at: z.ZodString;
-    /** Arbitrary metadata attached to the memory. */
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    /**
-     * Phase C per-source signals — e.g. `{ vector: 0.83, lexical: 0.61 }`.
-     * Optional so older servers (v0.7.x) keep parsing.
-     */
-    score_components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-}, "strip", z.ZodTypeAny, {
-    content: string;
-    metadata: Record<string, unknown>;
-    memory_type: string;
-    importance_score: number;
-    recall_count: number;
-    created_at: string;
-    memory_id: string;
-    similarity_score: number;
-    relevance_score: number;
-    score_components: Record<string, number>;
-    summary?: string | null | undefined;
-}, {
-    content: string;
-    memory_type: string;
-    importance_score: number;
-    recall_count: number;
-    created_at: string;
-    memory_id: string;
-    similarity_score: number;
-    relevance_score: number;
-    metadata?: Record<string, unknown> | undefined;
-    summary?: string | null | undefined;
-    score_components?: Record<string, number> | undefined;
-}>;
-/** Parsed type for a single recall result item. */
-type RecallResultItem = z.infer<typeof RecallResultItem>;
-/**
- * Schema for the full recall response.
- *
- * Contains an array of ranked results and the total count of matches.
- */
-declare const RecallResponse: z.ZodObject<{
-    /** Ranked list of matching memories. */
-    results: z.ZodArray<z.ZodObject<{
-        /** Unique identifier of the recalled memory. */
-        memory_id: z.ZodString;
-        /** Text content of the memory. */
-        content: z.ZodString;
-        /** Optional server-generated summary. */
-        summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Category of the memory. */
-        memory_type: z.ZodString;
-        /** Cosine similarity to the query (0-1). */
-        similarity_score: z.ZodNumber;
-        /** Server-computed importance score (0-1). */
-        importance_score: z.ZodNumber;
-        /** Combined relevance score used for ranking (0-1). */
-        relevance_score: z.ZodNumber;
-        /** Number of times this memory has been recalled. */
-        recall_count: z.ZodNumber;
-        /** ISO 8601 creation timestamp. */
-        created_at: z.ZodString;
-        /** Arbitrary metadata attached to the memory. */
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        /**
-         * Phase C per-source signals — e.g. `{ vector: 0.83, lexical: 0.61 }`.
-         * Optional so older servers (v0.7.x) keep parsing.
-         */
-        score_components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        content: string;
-        metadata: Record<string, unknown>;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        memory_id: string;
-        similarity_score: number;
-        relevance_score: number;
-        score_components: Record<string, number>;
-        summary?: string | null | undefined;
-    }, {
-        content: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        memory_id: string;
-        similarity_score: number;
-        relevance_score: number;
-        metadata?: Record<string, unknown> | undefined;
-        summary?: string | null | undefined;
-        score_components?: Record<string, number> | undefined;
-    }>, "many">;
-    /** Total number of matches (may exceed `topK`). */
-    total: z.ZodNumber;
-    /** The query that was searched, if any. */
-    query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Phase C: strategy that actually ran (after AUTO routing + re-rank). */
-    strategy_used: z.ZodDefault<z.ZodString>;
-    /** Phase C: AUTO's candidate list (e.g. `["AUTO->GRAPH"]`). */
-    strategies_considered: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /** Phase C: whether the cross-encoder re-rank ran. */
-    reranked: z.ZodDefault<z.ZodBoolean>;
-    /** Phase C: end-to-end recall latency on the server (ms). */
-    elapsed_ms: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    results: {
-        content: string;
-        metadata: Record<string, unknown>;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        memory_id: string;
-        similarity_score: number;
-        relevance_score: number;
-        score_components: Record<string, number>;
-        summary?: string | null | undefined;
-    }[];
-    total: number;
-    strategy_used: string;
-    strategies_considered: string[];
-    reranked: boolean;
-    elapsed_ms: number;
-    query?: string | null | undefined;
-}, {
-    results: {
-        content: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        memory_id: string;
-        similarity_score: number;
-        relevance_score: number;
-        metadata?: Record<string, unknown> | undefined;
-        summary?: string | null | undefined;
-        score_components?: Record<string, number> | undefined;
-    }[];
-    total: number;
-    query?: string | null | undefined;
-    strategy_used?: string | undefined;
-    strategies_considered?: string[] | undefined;
-    reranked?: boolean | undefined;
-    elapsed_ms?: number | undefined;
-}>;
-/** Parsed type for a recall response. */
-type RecallResponse = z.infer<typeof RecallResponse>;
-/**
- * Schema for the forget (delete) response.
- *
- * Reports how many memories were deleted and whether cascade was applied.
- */
-declare const ForgetResponse: z.ZodObject<{
-    /** Number of memories deleted. */
-    deleted_count: z.ZodNumber;
-    /** Whether a hard delete was performed. */
-    hard_deleted: z.ZodBoolean;
-    /** Number of related memories deleted via cascade. */
-    cascade_count: z.ZodNumber;
-    /** IDs of all deleted memories. */
-    memory_ids: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-    deleted_count: number;
-    hard_deleted: boolean;
-    cascade_count: number;
-    memory_ids: string[];
-}, {
-    deleted_count: number;
-    hard_deleted: boolean;
-    cascade_count: number;
-    memory_ids: string[];
-}>;
-/** Parsed type for a forget response. */
-type ForgetResponse = z.infer<typeof ForgetResponse>;
-/**
- * Schema for a single audit log entry.
- *
- * Audit entries record every operation performed on the agent's memories.
- */
-declare const AuditEntry: z.ZodEffects<z.ZodObject<{
-    /** Auto-incrementing audit entry ID. */
-    id: z.ZodNumber;
-    /** UUID of the agent, if applicable. */
-    agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** UUID of the user, if applicable. */
-    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Operation type (e.g., `"store"`, `"recall"`, `"forget"`). */
-    operation: z.ZodString;
-    /** UUID of the affected memory, if applicable. */
-    memory_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Memory type of the affected memory, if applicable. */
-    memory_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Additional details about the operation. */
-    details: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    /** IP address of the caller, if available. */
-    ip_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** ISO 8601 timestamp of the operation. */
-    created_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: number;
-    created_at: string;
-    operation: string;
-    details: Record<string, unknown>;
-    agent_id?: string | null | undefined;
-    memory_type?: string | null | undefined;
-    memory_id?: string | null | undefined;
-    user_id?: string | null | undefined;
-    ip_address?: string | null | undefined;
-}, {
-    id: number;
-    created_at: string;
-    operation: string;
-    agent_id?: string | null | undefined;
-    memory_type?: string | null | undefined;
-    memory_id?: string | null | undefined;
-    user_id?: string | null | undefined;
-    details?: Record<string, unknown> | undefined;
-    ip_address?: string | null | undefined;
-}>, {
-    /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
-    timestamp: string;
-    id: number;
-    created_at: string;
-    operation: string;
-    details: Record<string, unknown>;
-    agent_id?: string | null | undefined;
-    memory_type?: string | null | undefined;
-    memory_id?: string | null | undefined;
-    user_id?: string | null | undefined;
-    ip_address?: string | null | undefined;
-}, {
-    id: number;
-    created_at: string;
-    operation: string;
-    agent_id?: string | null | undefined;
-    memory_type?: string | null | undefined;
-    memory_id?: string | null | undefined;
-    user_id?: string | null | undefined;
-    details?: Record<string, unknown> | undefined;
-    ip_address?: string | null | undefined;
-}>;
-/** Parsed type for an audit entry. */
-type AuditEntry = z.infer<typeof AuditEntry>;
-/**
- * Schema for a paginated audit log response.
- *
- * Supports cursor-based pagination via `page` and `page_size`.
- */
-declare const AuditPageResponse: z.ZodEffects<z.ZodObject<{
-    /** Audit entries on this page. */
-    entries: z.ZodArray<z.ZodEffects<z.ZodObject<{
-        /** Auto-incrementing audit entry ID. */
-        id: z.ZodNumber;
-        /** UUID of the agent, if applicable. */
-        agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** UUID of the user, if applicable. */
-        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Operation type (e.g., `"store"`, `"recall"`, `"forget"`). */
-        operation: z.ZodString;
-        /** UUID of the affected memory, if applicable. */
-        memory_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Memory type of the affected memory, if applicable. */
-        memory_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Additional details about the operation. */
-        details: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        /** IP address of the caller, if available. */
-        ip_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** ISO 8601 timestamp of the operation. */
-        created_at: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: number;
-        created_at: string;
-        operation: string;
-        details: Record<string, unknown>;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        ip_address?: string | null | undefined;
-    }, {
-        id: number;
-        created_at: string;
-        operation: string;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        details?: Record<string, unknown> | undefined;
-        ip_address?: string | null | undefined;
-    }>, {
-        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
-        timestamp: string;
-        id: number;
-        created_at: string;
-        operation: string;
-        details: Record<string, unknown>;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        ip_address?: string | null | undefined;
-    }, {
-        id: number;
-        created_at: string;
-        operation: string;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        details?: Record<string, unknown> | undefined;
-        ip_address?: string | null | undefined;
-    }>, "many">;
-    /** Total number of matching audit entries. */
-    total: z.ZodNumber;
-    /** Current page number (1-indexed). */
-    page: z.ZodNumber;
-    /** Number of entries per page. */
-    page_size: z.ZodNumber;
-    /** Whether more pages are available. */
-    has_next: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    entries: {
-        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
-        timestamp: string;
-        id: number;
-        created_at: string;
-        operation: string;
-        details: Record<string, unknown>;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        ip_address?: string | null | undefined;
-    }[];
-    total: number;
-    page: number;
-    page_size: number;
-    has_next: boolean;
-}, {
-    entries: {
-        id: number;
-        created_at: string;
-        operation: string;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        details?: Record<string, unknown> | undefined;
-        ip_address?: string | null | undefined;
-    }[];
-    total: number;
-    page: number;
-    page_size: number;
-    has_next: boolean;
-}>, {
-    /** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */
-    total_count: number;
-    entries: {
-        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
-        timestamp: string;
-        id: number;
-        created_at: string;
-        operation: string;
-        details: Record<string, unknown>;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        ip_address?: string | null | undefined;
-    }[];
-    total: number;
-    page: number;
-    page_size: number;
-    has_next: boolean;
-}, {
-    entries: {
-        id: number;
-        created_at: string;
-        operation: string;
-        agent_id?: string | null | undefined;
-        memory_type?: string | null | undefined;
-        memory_id?: string | null | undefined;
-        user_id?: string | null | undefined;
-        details?: Record<string, unknown> | undefined;
-        ip_address?: string | null | undefined;
-    }[];
-    total: number;
-    page: number;
-    page_size: number;
-    has_next: boolean;
-}>;
-/** Parsed type for a paginated audit response. */
-type AuditPageResponse = z.infer<typeof AuditPageResponse>;
-/**
- * Schema for the batch store response.
- *
- * Returned by {@link Z3rnoClient.storeBatch} after storing multiple memories.
- */
-declare const BatchStoreResponse: z.ZodObject<{
-    /** Array of stored memory objects. */
-    results: z.ZodArray<z.ZodObject<{
-        /** Unique identifier for this memory. */
-        id: z.ZodString;
-        /** UUID of the owning agent. */
-        agent_id: z.ZodString;
-        /** Text content of the memory. */
-        content: z.ZodString;
-        /** Category of the memory. */
-        memory_type: z.ZodString;
-        /** Server-computed importance score (0-1). */
-        importance_score: z.ZodNumber;
-        /** Number of times this memory has been recalled. */
-        recall_count: z.ZodNumber;
-        /** Name of the embedding model used, if any. */
-        embedding_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** ISO 8601 creation timestamp. */
-        created_at: z.ZodString;
-        /** Arbitrary metadata attached to the memory. */
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        content: string;
-        metadata: Record<string, unknown>;
-        id: string;
-        agent_id: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        embedding_model?: string | null | undefined;
-    }, {
-        content: string;
-        id: string;
-        agent_id: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        metadata?: Record<string, unknown> | undefined;
-        embedding_model?: string | null | undefined;
-    }>, "many">;
-    /** Number of memories successfully stored. */
-    stored_count: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    results: {
-        content: string;
-        metadata: Record<string, unknown>;
-        id: string;
-        agent_id: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        embedding_model?: string | null | undefined;
-    }[];
-    stored_count: number;
-}, {
-    results: {
-        content: string;
-        id: string;
-        agent_id: string;
-        memory_type: string;
-        importance_score: number;
-        recall_count: number;
-        created_at: string;
-        metadata?: Record<string, unknown> | undefined;
-        embedding_model?: string | null | undefined;
-    }[];
-    stored_count: number;
-}>;
-/** Parsed type for a batch store response. */
-type BatchStoreResponse = z.infer<typeof BatchStoreResponse>;
-/**
- * Schema for a single version of a memory (temporal versioning).
- *
- * Each version represents the state of a memory during a specific time range.
- */
-declare const MemoryVersion: z.ZodObject<{
-    /** Version identifier. */
-    id: z.ZodString;
-    /** Text content at this version. */
-    content: z.ZodString;
-    /** Memory type at this version. */
-    memory_type: z.ZodString;
-    /** Importance score at this version. */
-    importance_score: z.ZodNumber;
-    /** ISO 8601 timestamp when this version became active. */
-    valid_from: z.ZodString;
-    /** ISO 8601 timestamp when this version was superseded, or null if current. */
-    valid_to: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Metadata at this version. */
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    content: string;
-    metadata: Record<string, unknown>;
-    id: string;
-    memory_type: string;
-    importance_score: number;
-    valid_from: string;
-    valid_to?: string | null | undefined;
-}, {
-    content: string;
-    id: string;
-    memory_type: string;
-    importance_score: number;
-    valid_from: string;
-    metadata?: Record<string, unknown> | undefined;
-    valid_to?: string | null | undefined;
-}>;
-/** Parsed type for a memory version. */
-type MemoryVersion = z.infer<typeof MemoryVersion>;
-/**
- * Schema for the memory history response.
- *
- * Contains all temporal versions of a single memory, ordered chronologically.
- */
-declare const MemoryHistoryResponse: z.ZodObject<{
-    /** UUID of the memory. */
-    memory_id: z.ZodString;
-    /** Chronologically ordered list of versions. */
-    versions: z.ZodArray<z.ZodObject<{
-        /** Version identifier. */
-        id: z.ZodString;
-        /** Text content at this version. */
-        content: z.ZodString;
-        /** Memory type at this version. */
-        memory_type: z.ZodString;
-        /** Importance score at this version. */
-        importance_score: z.ZodNumber;
-        /** ISO 8601 timestamp when this version became active. */
-        valid_from: z.ZodString;
-        /** ISO 8601 timestamp when this version was superseded, or null if current. */
-        valid_to: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Metadata at this version. */
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        content: string;
-        metadata: Record<string, unknown>;
-        id: string;
-        memory_type: string;
-        importance_score: number;
-        valid_from: string;
-        valid_to?: string | null | undefined;
-    }, {
-        content: string;
-        id: string;
-        memory_type: string;
-        importance_score: number;
-        valid_from: string;
-        metadata?: Record<string, unknown> | undefined;
-        valid_to?: string | null | undefined;
-    }>, "many">;
-    /** Total number of versions. */
-    total: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    memory_id: string;
-    total: number;
-    versions: {
-        content: string;
-        metadata: Record<string, unknown>;
-        id: string;
-        memory_type: string;
-        importance_score: number;
-        valid_from: string;
-        valid_to?: string | null | undefined;
-    }[];
-}, {
-    memory_id: string;
-    total: number;
-    versions: {
-        content: string;
-        id: string;
-        memory_type: string;
-        importance_score: number;
-        valid_from: string;
-        metadata?: Record<string, unknown> | undefined;
-        valid_to?: string | null | undefined;
-    }[];
-}>;
-/** Parsed type for a memory history response. */
-type MemoryHistoryResponse = z.infer<typeof MemoryHistoryResponse>;
-/**
- * Schema for a session response.
- *
- * Sessions group related memory operations (e.g., a conversation turn).
- */
-declare const SessionResponse: z.ZodObject<{
-    /** Unique session identifier. */
-    session_id: z.ZodString;
-    /** UUID of the agent this session belongs to. */
-    agent_id: z.ZodString;
-    /** Type of session (e.g., `"conversation"`). */
-    session_type: z.ZodString;
-    /** ISO 8601 timestamp when the session started. */
-    started_at: z.ZodString;
-    /** Arbitrary session metadata. */
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    metadata: Record<string, unknown>;
-    agent_id: string;
-    session_id: string;
-    session_type: string;
-    started_at: string;
-}, {
-    agent_id: string;
-    session_id: string;
-    session_type: string;
-    started_at: string;
-    metadata?: Record<string, unknown> | undefined;
-}>;
-/** Parsed type for a session response. */
-type SessionResponse = z.infer<typeof SessionResponse>;
-/**
- * Schema for the end-session response.
- *
- * Returned when a session is closed, including summary statistics.
- */
-declare const EndSessionResponse: z.ZodObject<{
-    /** The session that was ended. */
-    session_id: z.ZodString;
-    /** ISO 8601 timestamp when the session ended. */
-    ended_at: z.ZodString;
-    /** Total duration of the session in seconds. */
-    duration_seconds: z.ZodNumber;
-    /** Number of memories created during the session. */
-    memory_count: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    session_id: string;
-    ended_at: string;
-    duration_seconds: number;
-    memory_count: number;
-}, {
-    session_id: string;
-    ended_at: string;
-    duration_seconds: number;
-    memory_count: number;
-}>;
-/** Parsed type for an end-session response. */
-type EndSessionResponse = z.infer<typeof EndSessionResponse>;
-/** Response to POST /v1/ingest — the enqueue ack. */
-declare const IngestJobResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    kind: z.ZodString;
-    status: z.ZodString;
-    dataset_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    enqueued_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    job_id: string;
-    kind: string;
-    enqueued_at: string;
-    dataset_id?: string | null | undefined;
-}, {
-    status: string;
-    job_id: string;
-    kind: string;
-    enqueued_at: string;
-    dataset_id?: string | null | undefined;
-}>;
-type IngestJobResponse = z.infer<typeof IngestJobResponse>;
-/** Full state from GET /v1/ingest/{job_id}. */
-declare const IngestJobStatusResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    agent_id: z.ZodString;
-    dataset_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    kind: z.ZodString;
-    status: z.ZodString;
-    source_uri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    filename: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    file_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    memory_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    memos_written: z.ZodDefault<z.ZodNumber>;
-    distill_job_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    codegraph_memos_written: z.ZodDefault<z.ZodNumber>;
-    codegraph_edges_written: z.ZodDefault<z.ZodNumber>;
-    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    warnings: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-    started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    completed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    agent_id: string;
-    memory_ids: string[];
-    job_id: string;
-    kind: string;
-    memos_written: number;
-    codegraph_memos_written: number;
-    codegraph_edges_written: number;
-    warnings: Record<string, unknown>[];
-    created_at?: string | null | undefined;
-    started_at?: string | null | undefined;
-    dataset_id?: string | null | undefined;
-    source_uri?: string | null | undefined;
-    content_type?: string | null | undefined;
-    filename?: string | null | undefined;
-    file_size?: number | null | undefined;
-    distill_job_id?: string | null | undefined;
-    error?: string | null | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-}, {
-    status: string;
-    agent_id: string;
-    job_id: string;
-    kind: string;
-    created_at?: string | null | undefined;
-    memory_ids?: string[] | undefined;
-    started_at?: string | null | undefined;
-    dataset_id?: string | null | undefined;
-    source_uri?: string | null | undefined;
-    content_type?: string | null | undefined;
-    filename?: string | null | undefined;
-    file_size?: number | null | undefined;
-    memos_written?: number | undefined;
-    distill_job_id?: string | null | undefined;
-    codegraph_memos_written?: number | undefined;
-    codegraph_edges_written?: number | undefined;
-    error?: string | null | undefined;
-    warnings?: Record<string, unknown>[] | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-}>;
-type IngestJobStatusResponse = z.infer<typeof IngestJobStatusResponse>;
-/** Distill enqueue ack. */
-declare const DistillJobResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    status: z.ZodString;
-    memory_ids: z.ZodArray<z.ZodString, "many">;
-    enqueued_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    memory_ids: string[];
-    job_id: string;
-    enqueued_at: string;
-}, {
-    status: string;
-    memory_ids: string[];
-    job_id: string;
-    enqueued_at: string;
-}>;
-type DistillJobResponse = z.infer<typeof DistillJobResponse>;
-/** Full distill job state. */
-declare const DistillJobStatusResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    agent_id: z.ZodString;
-    status: z.ZodString;
-    model: z.ZodString;
-    memory_ids: z.ZodArray<z.ZodString, "many">;
-    chunk_size: z.ZodNumber;
-    chunk_overlap: z.ZodNumber;
-    max_concurrency: z.ZodNumber;
-    chunks_total: z.ZodNumber;
-    chunks_failed: z.ZodNumber;
-    entities_extracted: z.ZodNumber;
-    relationships_extracted: z.ZodNumber;
-    memos_written: z.ZodNumber;
-    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    completed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    agent_id: string;
-    memory_ids: string[];
-    job_id: string;
-    memos_written: number;
-    model: string;
-    chunk_size: number;
-    chunk_overlap: number;
-    max_concurrency: number;
-    chunks_total: number;
-    chunks_failed: number;
-    entities_extracted: number;
-    relationships_extracted: number;
-    created_at?: string | null | undefined;
-    started_at?: string | null | undefined;
-    error?: string | null | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-}, {
-    status: string;
-    agent_id: string;
-    memory_ids: string[];
-    job_id: string;
-    memos_written: number;
-    model: string;
-    chunk_size: number;
-    chunk_overlap: number;
-    max_concurrency: number;
-    chunks_total: number;
-    chunks_failed: number;
-    entities_extracted: number;
-    relationships_extracted: number;
-    created_at?: string | null | undefined;
-    started_at?: string | null | undefined;
-    error?: string | null | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-}>;
-type DistillJobStatusResponse = z.infer<typeof DistillJobStatusResponse>;
-/** Refine enqueue ack. */
-declare const RefineJobResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    status: z.ZodString;
-    dataset_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    enqueued_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    job_id: string;
-    enqueued_at: string;
-    dataset_id?: string | null | undefined;
-}, {
-    status: string;
-    job_id: string;
-    enqueued_at: string;
-    dataset_id?: string | null | undefined;
-}>;
-type RefineJobResponse = z.infer<typeof RefineJobResponse>;
-/** Full refine job state. */
-declare const RefineJobStatusResponse: z.ZodObject<{
-    job_id: z.ZodString;
-    status: z.ZodString;
-    dataset_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    trigger: z.ZodString;
-    memos_scanned: z.ZodDefault<z.ZodNumber>;
-    memos_deduped: z.ZodDefault<z.ZodNumber>;
-    edges_reweighted: z.ZodDefault<z.ZodNumber>;
-    edges_pruned: z.ZodDefault<z.ZodNumber>;
-    feedback_drained: z.ZodDefault<z.ZodNumber>;
-    job_metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    completed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    status: string;
-    job_id: string;
-    trigger: string;
-    memos_scanned: number;
-    memos_deduped: number;
-    edges_reweighted: number;
-    edges_pruned: number;
-    feedback_drained: number;
-    job_metadata: Record<string, unknown>;
-    created_at?: string | null | undefined;
-    started_at?: string | null | undefined;
-    dataset_id?: string | null | undefined;
-    error?: string | null | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-}, {
-    status: string;
-    job_id: string;
-    trigger: string;
-    created_at?: string | null | undefined;
-    started_at?: string | null | undefined;
-    dataset_id?: string | null | undefined;
-    error?: string | null | undefined;
-    completed_at?: string | null | undefined;
-    updated_at?: string | null | undefined;
-    memos_scanned?: number | undefined;
-    memos_deduped?: number | undefined;
-    edges_reweighted?: number | undefined;
-    edges_pruned?: number | undefined;
-    feedback_drained?: number | undefined;
-    job_metadata?: Record<string, unknown> | undefined;
-}>;
-type RefineJobStatusResponse = z.infer<typeof RefineJobStatusResponse>;
-/** Conversation metadata. */
-declare const ConversationResponse: z.ZodObject<{
-    id: z.ZodString;
-    agent_id: z.ZodString;
-    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    summary_cadence: z.ZodNumber;
-    turn_count: z.ZodNumber;
-    last_summary_turn: z.ZodNumber;
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    created_at: z.ZodString;
-    updated_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    metadata: Record<string, unknown>;
-    id: string;
-    agent_id: string;
-    created_at: string;
-    updated_at: string;
-    summary_cadence: number;
-    turn_count: number;
-    last_summary_turn: number;
-    user_id?: string | null | undefined;
-    title?: string | null | undefined;
-}, {
-    id: string;
-    agent_id: string;
-    created_at: string;
-    updated_at: string;
-    summary_cadence: number;
-    turn_count: number;
-    last_summary_turn: number;
-    metadata?: Record<string, unknown> | undefined;
-    user_id?: string | null | undefined;
-    title?: string | null | undefined;
-}>;
-type ConversationResponse = z.infer<typeof ConversationResponse>;
-/** Result of POST /v1/conversations/{id}/turns. */
-declare const TurnAddResponse: z.ZodObject<{
-    turn_index: z.ZodNumber;
-    needs_summary: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    turn_index: number;
-    needs_summary: boolean;
-}, {
-    turn_index: number;
-    needs_summary: boolean;
-}>;
-type TurnAddResponse = z.infer<typeof TurnAddResponse>;
-/** One turn within a conversation. */
-declare const TurnResponse: z.ZodObject<{
-    memory_id: z.ZodString;
-    turn_index: z.ZodNumber;
-    turn_role: z.ZodString;
-    content: z.ZodString;
-    created_at: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    content: string;
-    created_at: string;
-    memory_id: string;
-    turn_index: number;
-    turn_role: string;
-}, {
-    content: string;
-    created_at: string;
-    memory_id: string;
-    turn_index: number;
-    turn_role: string;
-}>;
-type TurnResponse = z.infer<typeof TurnResponse>;
-/** Paginated turn list. */
-declare const TurnListResponse: z.ZodObject<{
-    turns: z.ZodArray<z.ZodObject<{
-        memory_id: z.ZodString;
-        turn_index: z.ZodNumber;
-        turn_role: z.ZodString;
-        content: z.ZodString;
-        created_at: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        content: string;
-        created_at: string;
-        memory_id: string;
-        turn_index: number;
-        turn_role: string;
-    }, {
-        content: string;
-        created_at: string;
-        memory_id: string;
-        turn_index: number;
-        turn_role: string;
-    }>, "many">;
-    total: z.ZodNumber;
-    conversation_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    total: number;
-    turns: {
-        content: string;
-        created_at: string;
-        memory_id: string;
-        turn_index: number;
-        turn_role: string;
-    }[];
-    conversation_id: string;
-}, {
-    total: number;
-    turns: {
-        content: string;
-        created_at: string;
-        memory_id: string;
-        turn_index: number;
-        turn_role: string;
-    }[];
-    conversation_id: string;
-}>;
-type TurnListResponse = z.infer<typeof TurnListResponse>;
-/** Per-tenant budget caps. Zero means inherit server default. */
-declare const TenantBudgets: z.ZodObject<{
-    daily_tokens: z.ZodNumber;
-    daily_llm_calls: z.ZodNumber;
-    daily_embeddings: z.ZodNumber;
-    monthly_tokens: z.ZodNumber;
-    monthly_llm_calls: z.ZodNumber;
-    monthly_embeddings: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    daily_tokens: number;
-    daily_llm_calls: number;
-    daily_embeddings: number;
-    monthly_tokens: number;
-    monthly_llm_calls: number;
-    monthly_embeddings: number;
-}, {
-    daily_tokens: number;
-    daily_llm_calls: number;
-    daily_embeddings: number;
-    monthly_tokens: number;
-    monthly_llm_calls: number;
-    monthly_embeddings: number;
-}>;
-type TenantBudgets = z.infer<typeof TenantBudgets>;
-/** Server response: stored overrides + resolved effective caps. */
-declare const TenantBudgetsView: z.ZodObject<{
-    overrides: z.ZodObject<{
-        daily_tokens: z.ZodNumber;
-        daily_llm_calls: z.ZodNumber;
-        daily_embeddings: z.ZodNumber;
-        monthly_tokens: z.ZodNumber;
-        monthly_llm_calls: z.ZodNumber;
-        monthly_embeddings: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    }, {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    }>;
-    effective: z.ZodObject<{
-        daily_tokens: z.ZodNumber;
-        daily_llm_calls: z.ZodNumber;
-        daily_embeddings: z.ZodNumber;
-        monthly_tokens: z.ZodNumber;
-        monthly_llm_calls: z.ZodNumber;
-        monthly_embeddings: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    }, {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    overrides: {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    };
-    effective: {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    };
-}, {
-    overrides: {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    };
-    effective: {
-        daily_tokens: number;
-        daily_llm_calls: number;
-        daily_embeddings: number;
-        monthly_tokens: number;
-        monthly_llm_calls: number;
-        monthly_embeddings: number;
-    };
-}>;
-type TenantBudgetsView = z.infer<typeof TenantBudgetsView>;
-
-/**
- * Z3rno TypeScript SDK client.
- *
- * Thin fetch wrapper — no database drivers, no embedding providers.
- * Works in Node.js 18+, Deno, Bun, and modern browsers (any runtime
- * with a global `fetch` and `AbortController`).
- *
- * @module client
- *
- * @example
- * ```ts
- * const client = new Z3rnoClient({ baseUrl: "http://localhost:8000", apiKey: "z3rno_sk_..." });
- * const memory = await client.store({ agentId: "agent-1", content: "User prefers dark mode" });
- * const results = await client.recall({ agentId: "agent-1", query: "user preferences" });
- * await client.forget({ agentId: "agent-1", memoryId: memory.id });
- * ```
- */
-
-/**
- * Configuration options for the {@link Z3rnoClient}.
- *
- * All fields are optional. When omitted, the client reads from environment
- * variables (`Z3RNO_BASE_URL`, `Z3RNO_API_KEY`) or uses sensible defaults.
- */
-interface Z3rnoClientConfig {
-    /**
-     * Base URL of the Z3rno API.
-     *
-     * Falls back to the `Z3RNO_BASE_URL` environment variable, then
-     * to `"https://api.z3rno.dev"`.
-     */
-    baseUrl?: string;
-    /**
-     * API key for authentication.
-     *
-     * Falls back to the `Z3RNO_API_KEY` environment variable, then to
-     * an empty string (unauthenticated).
-     */
-    apiKey?: string;
-    /**
-     * Request timeout in milliseconds.
-     *
-     * @defaultValue 30000 (30 seconds)
-     */
-    timeout?: number;
-    /**
-     * Maximum number of retry attempts for retryable errors (5xx, 429,
-     * network failures, timeouts).
-     *
-     * @defaultValue 3
-     */
-    maxRetries?: number;
-    /**
-     * Custom fetch implementation.
-     *
-     * Defaults to `globalThis.fetch`. Override to use `undici`, `node-fetch`,
-     * or a test double.
-     *
-     * @defaultValue globalThis.fetch
-     */
-    fetch?: typeof globalThis.fetch;
-    /**
-     * Intercept outgoing requests before they are sent.
-     *
-     * Use this to add custom headers, log requests, or collect metrics.
-     * The callback receives the URL and the `RequestInit` and must return
-     * a (possibly modified) `RequestInit`.
-     */
-    onRequest?: (url: string, init: RequestInit) => RequestInit;
-    /**
-     * Intercept responses before they are processed.
-     *
-     * Use this for logging, metrics, or response transformation.
-     * The callback receives the `Response` and must return a `Response`.
-     */
-    onResponse?: (response: Response) => Response;
-}
-/**
- * Client for the Z3rno AI agent memory API.
- *
- * Uses the standard Fetch API under the hood, making it compatible with
- * Node.js 18+, Deno, Bun, and modern browsers. All responses are
- * validated at runtime with Zod schemas.
- *
- * @example
- * ```ts
- * import { Z3rnoClient } from "@z3rno/sdk";
- *
- * const client = new Z3rnoClient({
- *   baseUrl: "http://localhost:8000",
- *   apiKey: "z3rno_sk_test_...",
- * });
- *
- * // Store a memory
- * const mem = await client.store({
- *   agentId: "550e8400-e29b-41d4-a716-446655440000",
- *   content: "User prefers dark mode",
- * });
- *
- * // Recall relevant memories
- * const results = await client.recall({
- *   agentId: "550e8400-e29b-41d4-a716-446655440000",
- *   query: "user preferences",
- * });
- * ```
- */
-declare class Z3rnoClient {
-    private baseUrl;
-    private apiKey;
-    private timeout;
-    private maxRetries;
-    private fetchImpl;
-    private onRequest?;
-    private onResponse?;
-    /**
-     * Creates a new Z3rno client instance.
-     *
-     * @param config - Client configuration options. All fields are optional.
-     *
-     * @example
-     * ```ts
-     * // Explicit configuration
-     * const client = new Z3rnoClient({
-     *   baseUrl: "http://localhost:8000",
-     *   apiKey: "z3rno_sk_test_...",
-     *   timeout: 10000,
-     *   maxRetries: 2,
-     * });
-     *
-     * // Or rely on environment variables (Z3RNO_BASE_URL, Z3RNO_API_KEY)
-     * const client = new Z3rnoClient();
-     * ```
-     */
-    constructor(config?: Z3rnoClientConfig);
-    /**
-     * Stores a new memory for an agent.
-     *
-     * The server generates an embedding for the content and stores it in
-     * the vector database. The memory is immediately available for recall.
-     *
-     * @param request - The memory to store.
-     * @returns The stored memory, including the server-generated ID and scores.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     * @throws {@link ValidationError} If the request body is invalid.
-     * @throws {@link Z3rnoTimeoutError} If the request times out.
-     *
-     * @example
-     * ```ts
-     * const memory = await client.store({
-     *   agentId: "550e8400-e29b-41d4-a716-446655440000",
-     *   content: "User prefers dark mode",
-     *   memoryType: "semantic",
-     *   metadata: { source: "settings-page" },
-     * });
-     * console.log(memory.id); // "mem-abc123"
-     * ```
-     */
-    store(request: StoreMemoryRequest): Promise<MemoryResponse>;
-    /**
-     * Recalls memories by semantic similarity to a query.
-     *
-     * Returns a ranked list of memories sorted by a combined relevance score
-     * that factors in similarity, importance, and recency.
-     *
-     * @param params - Recall parameters including the query and filters.
-     * @param params.agentId - UUID of the agent whose memories to search.
-     * @param params.query - Natural-language query for semantic search.
-     * @param params.memoryType - Filter by memory type.
-     * @param params.filters - Additional metadata filters.
-     * @param params.topK - Maximum results to return (default 10).
-     * @param params.similarityThreshold - Minimum similarity score (default 0).
-     * @returns Ranked recall results with similarity scores.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     * @throws {@link Z3rnoTimeoutError} If the request times out.
-     *
-     * @example
-     * ```ts
-     * const results = await client.recall({
-     *   agentId: "550e8400-e29b-41d4-a716-446655440000",
-     *   query: "user preferences",
-     *   topK: 5,
-     *   similarityThreshold: 0.7,
-     * });
-     * for (const item of results.results) {
-     *   console.log(`${item.content} (score: ${item.relevance_score})`);
-     * }
-     * ```
-     */
-    recall(params: {
-        agentId: string;
-        query?: string;
-        memoryType?: string;
-        /**
-         * v0.21.2 — JSONB metadata containment filter
-         * (`metadata @> :metadata_filter` server-side). Renamed from
-         * `filters`; the old name is still accepted via `filters` below
-         * but emits a deprecation warning.
-         */
-        metadataFilter?: Record<string, unknown>;
-        /** @deprecated Use `metadataFilter` instead. */
-        filters?: Record<string, unknown>;
-        /**
-         * v0.21.1 — scope by end-user id (the `memories.user_id`
-         * column). Multi-user agents use this for per-user recall
-         * isolation. Real WHERE predicate, not just audit context.
-         */
-        userId?: string;
-        topK?: number;
-        similarityThreshold?: number;
-        /**
-         * Phase C: retrieval strategy. One of `AUTO | VECTOR | LEXICAL |
-         * GRAPH | TRIPLET | TRACE | TEMPORAL | ASK | CYPHER`. Default
-         * `"AUTO"` — server's LLM router picks per query.
-         */
-        strategy?: string;
-        /**
-         * Phase C: cross-encoder re-ranking. When `true`, the server
-         * re-ranks the strategy's top results. Requires
-         * `sentence-transformers` on the server side.
-         */
-        rerank?: boolean;
-        /**
-         * Phase G slice 2: scope recall to a single conversation. Older
-         * servers ignore the field.
-         */
-        conversationId?: string;
-    }): Promise<RecallResponse>;
-    /**
-     * Forgets (deletes) one or more memories.
-     *
-     * By default, performs a soft delete (marks as deleted but retains data).
-     * Set `hardDelete: true` for permanent removal. Use `cascade: true` to
-     * also delete related memories in the knowledge graph.
-     *
-     * @param params - Forget parameters.
-     * @param params.agentId - UUID of the agent that owns the memories.
-     * @param params.memoryId - UUID of a single memory to delete.
-     * @param params.memoryIds - UUIDs of multiple memories to delete.
-     * @param params.hardDelete - Permanently delete (default false).
-     * @param params.cascade - Delete related memories too (default false).
-     * @param params.reason - Reason for deletion (stored in audit log).
-     * @returns Summary of the deletion operation.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     * @throws {@link NotFoundError} If the specified memory does not exist.
-     *
-     * @example
-     * ```ts
-     * const result = await client.forget({
-     *   agentId: "550e8400-e29b-41d4-a716-446655440000",
-     *   memoryId: "mem-abc123",
-     *   hardDelete: true,
-     *   reason: "User requested data deletion",
-     * });
-     * console.log(`Deleted ${result.deleted_count} memories`);
-     * ```
-     */
-    forget(params: {
-        agentId: string;
-        memoryId?: string;
-        memoryIds?: string[];
-        hardDelete?: boolean;
-        cascade?: boolean;
-        reason?: string;
-    }): Promise<ForgetResponse>;
-    /**
-     * Retrieves a single memory by its ID.
-     *
-     * @param memoryId - The unique identifier of the memory to retrieve.
-     * @returns The full memory object.
-     * @throws {@link NotFoundError} If no memory exists with the given ID.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const memory = await client.getMemory("mem-abc123");
-     * console.log(memory.content);
-     * console.log(memory.importance_score);
-     * ```
-     */
-    getMemory(memoryId: string): Promise<MemoryResponse>;
-    /**
-     * Stores multiple memories in a single API call.
-     *
-     * More efficient than calling {@link store} in a loop. All memories are
-     * processed atomically on the server.
-     *
-     * @param memories - Array of memories to store.
-     * @returns The stored memories and a count of how many were created.
-     * @throws {@link ValidationError} If any memory in the batch is invalid.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const result = await client.storeBatch([
-     *   { agentId: "agent-1", content: "Fact one" },
-     *   { agentId: "agent-1", content: "Fact two", memoryType: "semantic" },
-     * ]);
-     * console.log(`Stored ${result.stored_count} memories`);
-     * ```
-     */
-    storeBatch(memories: StoreMemoryRequest[]): Promise<BatchStoreResponse>;
-    /**
-     * Retrieves the full version history of a memory.
-     *
-     * Z3rno uses temporal versioning — every update creates a new version
-     * rather than overwriting. This method returns all versions ordered
-     * chronologically.
-     *
-     * @param memoryId - The unique identifier of the memory.
-     * @returns All versions of the memory with validity timestamps.
-     * @throws {@link NotFoundError} If no memory exists with the given ID.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const history = await client.getMemoryHistory("mem-abc123");
-     * for (const version of history.versions) {
-     *   console.log(`${version.valid_from}: ${version.content}`);
-     * }
-     * ```
-     */
-    getMemoryHistory(memoryId: string): Promise<MemoryHistoryResponse>;
-    /**
-     * Updates an existing memory's content, metadata, or importance.
-     *
-     * Creates a new temporal version of the memory. The previous version
-     * remains accessible via {@link getMemoryHistory}.
-     *
-     * @param memoryId - The unique identifier of the memory to update.
-     * @param updates - Fields to update (only provided fields are changed).
-     * @param updates.content - New text content.
-     * @param updates.metadata - New metadata (replaces existing metadata).
-     * @param updates.importance - New importance score (0-1).
-     * @returns The updated memory object.
-     * @throws {@link NotFoundError} If no memory exists with the given ID.
-     * @throws {@link ValidationError} If the update values are invalid.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const updated = await client.updateMemory("mem-abc123", {
-     *   content: "User now prefers light mode",
-     *   importance: 0.9,
-     * });
-     * ```
-     */
-    updateMemory(memoryId: string, updates: {
-        content?: string;
-        metadata?: Record<string, unknown>;
-        importance?: number;
-    }): Promise<MemoryResponse>;
-    /**
-     * Starts a new session for grouping related memory operations.
-     *
-     * Sessions are useful for tracking conversation turns or task boundaries.
-     * Memories created during a session are automatically associated with it.
-     *
-     * @param params - Session parameters.
-     * @param params.agentId - UUID of the agent to start the session for.
-     * @param params.sessionType - Type of session (default `"conversation"`).
-     * @returns The created session with its ID and start time.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const session = await client.startSession({ agentId: "agent-1" });
-     * console.log(`Session started: ${session.session_id}`);
-     * // ... perform operations ...
-     * await client.endSession(session.session_id);
-     * ```
-     */
-    startSession(params: {
-        agentId: string;
-        sessionType?: string;
-    }): Promise<SessionResponse>;
-    /**
-     * Ends an active session.
-     *
-     * Returns summary statistics including the session duration and the
-     * number of memories created during the session.
-     *
-     * @param sessionId - The unique identifier of the session to end.
-     * @returns Session summary with duration and memory count.
-     * @throws {@link NotFoundError} If no active session exists with the given ID.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const summary = await client.endSession("sess-abc123");
-     * console.log(`Session lasted ${summary.duration_seconds}s, ${summary.memory_count} memories`);
-     * ```
-     */
-    endSession(sessionId: string): Promise<EndSessionResponse>;
-    /**
-     * Retrieves a paginated audit log of memory operations.
-     *
-     * The audit log records every store, recall, forget, and update operation
-     * performed by any agent. Useful for compliance, debugging, and analytics.
-     *
-     * @param params - Optional pagination and filter parameters.
-     * @param params.agentId - Filter by agent UUID.
-     * @param params.page - Page number (1-indexed).
-     * @param params.pageSize - Number of entries per page.
-     * @returns A page of audit log entries with pagination metadata.
-     * @throws {@link AuthenticationError} If the API key is invalid.
-     *
-     * @example
-     * ```ts
-     * const page = await client.audit({ agentId: "agent-1", page: 1, pageSize: 20 });
-     * for (const entry of page.entries) {
-     *   console.log(`${entry.created_at}: ${entry.operation} on ${entry.memory_id}`);
-     * }
-     * if (page.has_next) {
-     *   const nextPage = await client.audit({ agentId: "agent-1", page: 2 });
-     * }
-     * ```
-     */
-    audit(params?: {
-        agentId?: string;
-        page?: number;
-        pageSize?: number;
-    }): Promise<AuditPageResponse>;
-    ingestText(params: {
-        agentId: string;
-        text: string;
-        datasetId?: string;
-    }): Promise<IngestJobResponse>;
-    ingestUrl(params: {
-        agentId: string;
-        url: string;
-        datasetId?: string;
-    }): Promise<IngestJobResponse>;
-    getIngestStatus(jobId: string): Promise<IngestJobStatusResponse>;
-    distill(params: {
-        agentId: string;
-        memoryIds: string[];
-        chunkSize?: number;
-        chunkOverlap?: number;
-        maxConcurrency?: number;
-        summaryStyle?: string;
-        includeSummary?: boolean;
-    }): Promise<DistillJobResponse>;
-    getDistillStatus(jobId: string): Promise<DistillJobStatusResponse>;
-    refine(params?: {
-        datasetId?: string;
-    }): Promise<RefineJobResponse>;
-    getRefineStatus(jobId: string): Promise<RefineJobStatusResponse>;
-    /**
-     * Open a new conversation. Returns the conversation row including
-     * the assigned `id`, which subsequent `recall`s and `addTurn`s
-     * reference. The `summaryCadence` controls how often the server
-     * flags the conversation for summarization.
-     */
-    createConversation(params: {
-        agentId: string;
-        userId?: string;
-        title?: string;
-        summaryCadence?: number;
-        metadata?: Record<string, unknown>;
-    }): Promise<ConversationResponse>;
-    getConversation(conversationId: string): Promise<ConversationResponse>;
-    /**
-     * Stamp an existing Memo as the next turn of the conversation.
-     * Returns the assigned `turn_index` plus `needs_summary` — when
-     * `true`, the conversation has crossed its cadence threshold.
-     */
-    addTurn(conversationId: string, params: {
-        memoryId: string;
-        turnRole: string;
-    }): Promise<TurnAddResponse>;
-    /**
-     * v0.19.3 — soft-delete a conversation. Existing turn Memos stay
-     * queryable through standard recall; the conversation itself stops
-     * accepting turns and its endpoints 404. Idempotent.
-     */
-    deleteConversation(conversationId: string): Promise<void>;
-    listTurns(conversationId: string, params?: {
-        afterTurn?: number;
-        limit?: number;
-    }): Promise<TurnListResponse>;
-    /**
-     * Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).
-     *
-     * Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`
-     * surface. Requires `SUPERADMIN_ENABLED=true` on the server and
-     * the client to be configured with the matching superadmin API
-     * key. Methods raise `AuthenticationError` (401) or a generic
-     * `Z3rnoError` (403) otherwise.
-     */
-    get admin(): AdminAPI;
-    /**
-     * Read this org's stored budget overrides + resolved effective caps.
-     * Auth: any admin/write/read member of the calling org.
-     */
-    getMyBudgets(): Promise<TenantBudgetsView>;
-    /**
-     * Replace this org's budget overrides. Zero / missing fields
-     * inherit the server default. Auth: admin/write only.
-     */
-    setMyBudgets(budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
-    private request;
-    private sleep;
-    private handleResponse;
-}
-/**
- * Cross-tenant admin sub-namespace exposed via `client.admin`.
- *
- * Construction captures the parent client's `request` method as a
- * bound closure — no privileged access to the class internals, just
- * a function reference. That's deliberate: the namespace is
- * dependency-injected the same way a stub would be, so test doubles
- * can swap it out without touching the parent client.
- */
-declare class AdminAPI {
-    private readonly request;
-    constructor(request: (method: string, path: string, body?: unknown) => Promise<unknown>);
-    /**
-     * Read another tenant's budget overrides + effective caps.
-     *
-     * Requires `SUPERADMIN_ENABLED=true` server-side and the client to
-     * be configured with the superadmin API key.
-     */
-    getBudgets(orgId: string): Promise<TenantBudgetsView>;
-    /**
-     * Replace another tenant's budget overrides. Zero / missing fields
-     * inherit the server default.
-     */
-    setBudgets(orgId: string, budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
-}
-
-/**
- * Z3rno SDK error hierarchy.
- *
- * All errors thrown by the SDK extend {@link Z3rnoError}, which itself extends
- * the built-in `Error` class. This lets callers catch broadly (`Z3rnoError`)
- * or narrowly (`AuthenticationError`, `RateLimitError`, etc.).
- *
- * @module errors
- */
-/**
- * Base error class for all Z3rno SDK errors.
- *
- * Every error produced by the SDK is an instance of this class, so you can
- * use a single `catch (e) { if (e instanceof Z3rnoError) ... }` guard to
- * handle them all.
- *
- * @example
- * ```ts
- * try {
- *   await client.store({ agentId: "...", content: "..." });
- * } catch (e) {
- *   if (e instanceof Z3rnoError) {
- *     console.error(`Z3rno error (${e.statusCode}): ${e.message}`);
- *   }
- * }
- * ```
- */
-declare class Z3rnoError extends Error {
-    /** HTTP status code returned by the server, if applicable. */
-    statusCode?: number;
-    /**
-     * @param message - Human-readable description of the error.
-     * @param statusCode - HTTP status code associated with the error, if any.
-     */
-    constructor(message: string, statusCode?: number);
-}
-/**
- * Thrown when the API key is missing, invalid, or revoked (HTTP 401).
- *
- * @example
- * ```ts
- * try {
- *   await client.store({ agentId: "...", content: "..." });
- * } catch (e) {
- *   if (e instanceof AuthenticationError) {
- *     console.error("Check your API key");
- *   }
- * }
- * ```
- */
-declare class AuthenticationError extends Z3rnoError {
-    /**
-     * @param message - Description of the authentication failure.
-     */
-    constructor(message: string);
-}
-/**
- * Thrown when the client exceeds the API rate limit (HTTP 429).
- *
- * The {@link retryAfter} property indicates how many seconds to wait
- * before retrying, as reported by the server's `Retry-After` header.
- *
- * @example
- * ```ts
- * try {
- *   await client.recall({ agentId: "...", query: "..." });
- * } catch (e) {
- *   if (e instanceof RateLimitError) {
- *     console.log(`Retry after ${e.retryAfter} seconds`);
- *   }
- * }
- * ```
- */
-declare class RateLimitError extends Z3rnoError {
-    /** Number of seconds to wait before retrying, per the Retry-After header. */
-    retryAfter: number;
-    /**
-     * @param message - Description of the rate-limit error.
-     * @param retryAfter - Seconds to wait before retrying (defaults to 60).
-     */
-    constructor(message: string, retryAfter?: number);
-}
-/**
- * Thrown when the server rejects the request due to invalid input (HTTP 400 or 422).
- *
- * @example
- * ```ts
- * try {
- *   await client.store({ agentId: "not-a-uuid", content: "" });
- * } catch (e) {
- *   if (e instanceof ValidationError) {
- *     console.error(`Validation failed: ${e.message}`);
- *   }
- * }
- * ```
- */
-declare class ValidationError extends Z3rnoError {
-    /**
-     * @param message - Description of the validation failure.
-     * @param statusCode - HTTP status code (400 or 422, defaults to 400).
-     */
-    constructor(message: string, statusCode?: number);
-}
-/**
- * Thrown when the requested resource does not exist (HTTP 404).
- *
- * @example
- * ```ts
- * try {
- *   await client.getMemory("non-existent-id");
- * } catch (e) {
- *   if (e instanceof NotFoundError) {
- *     console.error("Memory not found");
- *   }
- * }
- * ```
- */
-declare class NotFoundError extends Z3rnoError {
-    /**
-     * @param message - Description of what was not found.
-     */
-    constructor(message: string);
-}
-/**
- * Thrown when the Z3rno API returns a server-side error (HTTP 5xx).
- *
- * The SDK automatically retries on 5xx errors with exponential backoff.
- * This error is only thrown after all retries are exhausted.
- *
- * @example
- * ```ts
- * try {
- *   await client.store({ agentId: "...", content: "..." });
- * } catch (e) {
- *   if (e instanceof ServerError) {
- *     console.error(`Server error (${e.statusCode}): ${e.message}`);
- *   }
- * }
- * ```
- */
-declare class ServerError extends Z3rnoError {
-    /**
-     * @param message - Description of the server error.
-     * @param statusCode - HTTP status code (defaults to 500).
-     */
-    constructor(message: string, statusCode?: number);
-}
-/**
- * Thrown when a request exceeds the configured timeout duration.
- *
- * The SDK uses an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}
- * to enforce timeouts. This error is thrown after all retries are exhausted.
- *
- * @example
- * ```ts
- * const client = new Z3rnoClient({ timeout: 5000 }); // 5 seconds
- * try {
- *   await client.recall({ agentId: "...", query: "..." });
- * } catch (e) {
- *   if (e instanceof Z3rnoTimeoutError) {
- *     console.error(`Timed out after ${e.timeout}ms`);
- *   }
- * }
- * ```
- */
-declare class Z3rnoTimeoutError extends Z3rnoError {
-    /** The timeout duration in milliseconds that was exceeded. */
-    timeout: number;
-    /**
-     * @param message - Description of the timeout.
-     * @param timeout - The configured timeout value in milliseconds.
-     */
-    constructor(message: string, timeout: number);
-}
-/**
- * Thrown when the SDK cannot establish a connection to the Z3rno API.
- *
- * This typically indicates a network issue, DNS failure, or the server
- * being unreachable. The SDK retries connection errors with exponential
- * backoff before throwing this error.
- *
- * @example
- * ```ts
- * try {
- *   await client.store({ agentId: "...", content: "..." });
- * } catch (e) {
- *   if (e instanceof Z3rnoConnectionError) {
- *     console.error("Cannot reach Z3rno API — check your network");
- *   }
- * }
- * ```
- */
-declare class Z3rnoConnectionError extends Z3rnoError {
-    /**
-     * @param message - Description of the connection failure.
-     */
-    constructor(message: string);
-}
-
-/**
- * Vercel AI SDK adapter for Z3rno (Phase G slice 3).
- *
- * Vercel AI SDK accepts a plain `CoreMessage[]` history; this adapter
- * loads + persists that history through Z3rno conversations. Drop the
- * `messages` accessor straight into `streamText` / `generateText`,
- * call `appendUserMessage` / `appendAssistantMessage` after each turn,
- * and Z3rno handles ordering + recall.
- *
- * Zero hard dependency on the `ai` package — we duck-type on the
- * minimal `CoreMessage` shape (`{ role, content }`).
- */
-
-type Z3rnoMessageRole = "user" | "assistant" | "system" | "tool";
-/** Subset of Vercel `ai` `CoreMessage` the adapter needs. */
-interface CoreMessage {
-    role: Z3rnoMessageRole;
-    content: string;
-}
-interface Z3rnoVercelMemoryOptions {
-    client: Z3rnoClient;
-    agentId: string;
-    /** When set, recall + persisted turns are scoped to this Z3rno conversation. */
-    conversationId?: string;
-    /** Max history slice to load. Default 50. */
-    topK?: number;
-}
-/**
- * Lightweight history adapter you can hand straight to Vercel AI SDK
- * helpers. `await mem.messages()` returns a CoreMessage[] ready to
- * pass to `streamText({ messages: ... })`. After each turn, call
- * `appendUserMessage` / `appendAssistantMessage` so future recalls
- * see the latest state.
- */
-declare class Z3rnoVercelMemory {
-    private readonly client;
-    private readonly agentId;
-    private readonly conversationId;
-    private readonly topK;
-    constructor(options: Z3rnoVercelMemoryOptions);
-    messages(): Promise<CoreMessage[]>;
-    appendUserMessage(content: string): Promise<void>;
-    appendAssistantMessage(content: string): Promise<void>;
-    appendToolMessage(content: string): Promise<void>;
-    private append;
-    private normaliseRole;
-}
-
-/**
- * Mastra adapter for Z3rno (Phase G slice 3).
- *
- * Mastra exposes a `MastraMemory`-shaped interface — see
- * https://mastra.ai/docs/agents/memory. This adapter implements
- * the same surface (`getMessages` / `addMessage` / `clear`) using
- * Z3rno conversations as the backing store.
- *
- * Zero hard dependency on the `@mastra/core` package — we provide
- * the typed surface and Mastra's runtime accepts any conforming
- * object.
- */
-
-type MastraRole = "user" | "assistant" | "system" | "tool";
-interface MastraMessage {
-    role: MastraRole;
-    content: string;
-    threadId?: string;
-    resourceId?: string;
-}
-interface Z3rnoMastraMemoryOptions {
-    client: Z3rnoClient;
-    agentId: string;
-    /** Mastra's thread is Z3rno's conversation; supply or look up by threadId. */
-    conversationId?: string;
-    topK?: number;
-}
-/**
- * Mastra-compatible memory backed by Z3rno conversations. Plug into
- * a Mastra `Agent`:
- *
- *   const memory = new Z3rnoMastraMemory({ client, agentId, conversationId });
- *   const agent = new Agent({ name: "support", memory });
- */
-declare class Z3rnoMastraMemory {
-    private readonly client;
-    private readonly agentId;
-    private readonly conversationId;
-    private readonly topK;
-    constructor(options: Z3rnoMastraMemoryOptions);
-    /** Mastra contract: return ordered prior messages for the thread. */
-    getMessages(_args?: {
-        limit?: number;
-    }): Promise<MastraMessage[]>;
-    /** Mastra contract: persist one message. */
-    addMessage(message: MastraMessage): Promise<void>;
-    /**
-     * Mastra `clear()` — deliberate no-op. Z3rno keeps the source of
-     * truth and recall is already scoped per conversation; flushing
-     * the thread would risk losing audit-relevant history.
-     */
-    clear(): Promise<void>;
-    private normaliseRole;
-}
-
-export { AdminAPI, AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, type CoreMessage, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, type MastraMessage, type MastraRole, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, StoreMemoryRequest, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };