@z3rno/sdk 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +55 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +121 -4
- package/dist/index.d.ts +121 -4
- package/dist/index.js +55 -3
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -278,7 +278,11 @@ var AuditEntry = zod.z.object({
|
|
|
278
278
|
ip_address: zod.z.string().nullable().optional(),
|
|
279
279
|
/** ISO 8601 timestamp of the operation. */
|
|
280
280
|
created_at: zod.z.string()
|
|
281
|
-
})
|
|
281
|
+
}).transform((data) => ({
|
|
282
|
+
...data,
|
|
283
|
+
/** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
|
|
284
|
+
timestamp: data.created_at
|
|
285
|
+
}));
|
|
282
286
|
var AuditPageResponse = zod.z.object({
|
|
283
287
|
/** Audit entries on this page. */
|
|
284
288
|
entries: zod.z.array(AuditEntry),
|
|
@@ -290,7 +294,11 @@ var AuditPageResponse = zod.z.object({
|
|
|
290
294
|
page_size: zod.z.number(),
|
|
291
295
|
/** Whether more pages are available. */
|
|
292
296
|
has_next: zod.z.boolean()
|
|
293
|
-
})
|
|
297
|
+
}).transform((data) => ({
|
|
298
|
+
...data,
|
|
299
|
+
/** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */
|
|
300
|
+
total_count: data.total
|
|
301
|
+
}));
|
|
294
302
|
var BatchStoreResponse = zod.z.object({
|
|
295
303
|
/** Array of stored memory objects. */
|
|
296
304
|
results: zod.z.array(MemoryResponse),
|
|
@@ -968,6 +976,18 @@ var Z3rnoClient = class {
|
|
|
968
976
|
return TurnListResponse.parse(resp);
|
|
969
977
|
}
|
|
970
978
|
// --- Tenant budgets (v0.20.3) ---
|
|
979
|
+
/**
|
|
980
|
+
* Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).
|
|
981
|
+
*
|
|
982
|
+
* Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`
|
|
983
|
+
* surface. Requires `SUPERADMIN_ENABLED=true` on the server and
|
|
984
|
+
* the client to be configured with the matching superadmin API
|
|
985
|
+
* key. Methods raise `AuthenticationError` (401) or a generic
|
|
986
|
+
* `Z3rnoError` (403) otherwise.
|
|
987
|
+
*/
|
|
988
|
+
get admin() {
|
|
989
|
+
return new AdminAPI(this.request.bind(this));
|
|
990
|
+
}
|
|
971
991
|
/**
|
|
972
992
|
* Read this org's stored budget overrides + resolved effective caps.
|
|
973
993
|
* Auth: any admin/write/read member of the calling org.
|
|
@@ -1111,6 +1131,38 @@ var Z3rnoClient = class {
|
|
|
1111
1131
|
}
|
|
1112
1132
|
}
|
|
1113
1133
|
};
|
|
1134
|
+
var AdminAPI = class {
|
|
1135
|
+
constructor(request) {
|
|
1136
|
+
this.request = request;
|
|
1137
|
+
}
|
|
1138
|
+
request;
|
|
1139
|
+
/**
|
|
1140
|
+
* Read another tenant's budget overrides + effective caps.
|
|
1141
|
+
*
|
|
1142
|
+
* Requires `SUPERADMIN_ENABLED=true` server-side and the client to
|
|
1143
|
+
* be configured with the superadmin API key.
|
|
1144
|
+
*/
|
|
1145
|
+
async getBudgets(orgId) {
|
|
1146
|
+
const resp = await this.request("GET", `/v1/tenants/${orgId}/budgets`);
|
|
1147
|
+
return TenantBudgetsView.parse(resp);
|
|
1148
|
+
}
|
|
1149
|
+
/**
|
|
1150
|
+
* Replace another tenant's budget overrides. Zero / missing fields
|
|
1151
|
+
* inherit the server default.
|
|
1152
|
+
*/
|
|
1153
|
+
async setBudgets(orgId, budgets) {
|
|
1154
|
+
const body = {
|
|
1155
|
+
daily_tokens: budgets.daily_tokens ?? 0,
|
|
1156
|
+
daily_llm_calls: budgets.daily_llm_calls ?? 0,
|
|
1157
|
+
daily_embeddings: budgets.daily_embeddings ?? 0,
|
|
1158
|
+
monthly_tokens: budgets.monthly_tokens ?? 0,
|
|
1159
|
+
monthly_llm_calls: budgets.monthly_llm_calls ?? 0,
|
|
1160
|
+
monthly_embeddings: budgets.monthly_embeddings ?? 0
|
|
1161
|
+
};
|
|
1162
|
+
const resp = await this.request("PUT", `/v1/tenants/${orgId}/budgets`, body);
|
|
1163
|
+
return TenantBudgetsView.parse(resp);
|
|
1164
|
+
}
|
|
1165
|
+
};
|
|
1114
1166
|
|
|
1115
1167
|
// src/integrations/vercel-ai.ts
|
|
1116
1168
|
var Z3rnoVercelMemory = class {
|
|
@@ -1261,6 +1313,7 @@ var Z3rnoMastraMemory = class {
|
|
|
1261
1313
|
}
|
|
1262
1314
|
};
|
|
1263
1315
|
|
|
1316
|
+
exports.AdminAPI = AdminAPI;
|
|
1264
1317
|
exports.AuditEntry = AuditEntry;
|
|
1265
1318
|
exports.AuditPageResponse = AuditPageResponse;
|
|
1266
1319
|
exports.AuthenticationError = AuthenticationError;
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/errors.ts","../src/models.ts","../src/client.ts","../src/integrations/vercel-ai.ts","../src/integrations/mastra.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Z3rno SDK error hierarchy.\n *\n * All errors thrown by the SDK extend {@link Z3rnoError}, which itself extends\n * the built-in `Error` class. This lets callers catch broadly (`Z3rnoError`)\n * or narrowly (`AuthenticationError`, `RateLimitError`, etc.).\n *\n * @module errors\n */\n\n/**\n * Base error class for all Z3rno SDK errors.\n *\n * Every error produced by the SDK is an instance of this class, so you can\n * use a single `catch (e) { if (e instanceof Z3rnoError) ... }` guard to\n * handle them all.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoError) {\n * console.error(`Z3rno error (${e.statusCode}): ${e.message}`);\n * }\n * }\n * ```\n */\nexport class Z3rnoError extends Error {\n /** HTTP status code returned by the server, if applicable. */\n statusCode?: number;\n\n /**\n * @param message - Human-readable description of the error.\n * @param statusCode - HTTP status code associated with the error, if any.\n */\n constructor(message: string, statusCode?: number) {\n super(message);\n this.name = \"Z3rnoError\";\n this.statusCode = statusCode;\n }\n}\n\n/**\n * Thrown when the API key is missing, invalid, or revoked (HTTP 401).\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof AuthenticationError) {\n * console.error(\"Check your API key\");\n * }\n * }\n * ```\n */\nexport class AuthenticationError extends Z3rnoError {\n /**\n * @param message - Description of the authentication failure.\n */\n constructor(message: string) {\n super(message, 401);\n this.name = \"AuthenticationError\";\n }\n}\n\n/**\n * Thrown when the client exceeds the API rate limit (HTTP 429).\n *\n * The {@link retryAfter} property indicates how many seconds to wait\n * before retrying, as reported by the server's `Retry-After` header.\n *\n * @example\n * ```ts\n * try {\n * await client.recall({ agentId: \"...\", query: \"...\" });\n * } catch (e) {\n * if (e instanceof RateLimitError) {\n * console.log(`Retry after ${e.retryAfter} seconds`);\n * }\n * }\n * ```\n */\nexport class RateLimitError extends Z3rnoError {\n /** Number of seconds to wait before retrying, per the Retry-After header. */\n retryAfter: number;\n\n /**\n * @param message - Description of the rate-limit error.\n * @param retryAfter - Seconds to wait before retrying (defaults to 60).\n */\n constructor(message: string, retryAfter: number = 60) {\n super(message, 429);\n this.name = \"RateLimitError\";\n this.retryAfter = retryAfter;\n }\n}\n\n/**\n * Thrown when the server rejects the request due to invalid input (HTTP 400 or 422).\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"not-a-uuid\", content: \"\" });\n * } catch (e) {\n * if (e instanceof ValidationError) {\n * console.error(`Validation failed: ${e.message}`);\n * }\n * }\n * ```\n */\nexport class ValidationError extends Z3rnoError {\n /**\n * @param message - Description of the validation failure.\n * @param statusCode - HTTP status code (400 or 422, defaults to 400).\n */\n constructor(message: string, statusCode: number = 400) {\n super(message, statusCode);\n this.name = \"ValidationError\";\n }\n}\n\n/**\n * Thrown when the requested resource does not exist (HTTP 404).\n *\n * @example\n * ```ts\n * try {\n * await client.getMemory(\"non-existent-id\");\n * } catch (e) {\n * if (e instanceof NotFoundError) {\n * console.error(\"Memory not found\");\n * }\n * }\n * ```\n */\nexport class NotFoundError extends Z3rnoError {\n /**\n * @param message - Description of what was not found.\n */\n constructor(message: string) {\n super(message, 404);\n this.name = \"NotFoundError\";\n }\n}\n\n/**\n * Thrown when the Z3rno API returns a server-side error (HTTP 5xx).\n *\n * The SDK automatically retries on 5xx errors with exponential backoff.\n * This error is only thrown after all retries are exhausted.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof ServerError) {\n * console.error(`Server error (${e.statusCode}): ${e.message}`);\n * }\n * }\n * ```\n */\nexport class ServerError extends Z3rnoError {\n /**\n * @param message - Description of the server error.\n * @param statusCode - HTTP status code (defaults to 500).\n */\n constructor(message: string, statusCode: number = 500) {\n super(message, statusCode);\n this.name = \"ServerError\";\n }\n}\n\n/**\n * Thrown when a request exceeds the configured timeout duration.\n *\n * The SDK uses an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}\n * to enforce timeouts. This error is thrown after all retries are exhausted.\n *\n * @example\n * ```ts\n * const client = new Z3rnoClient({ timeout: 5000 }); // 5 seconds\n * try {\n * await client.recall({ agentId: \"...\", query: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoTimeoutError) {\n * console.error(`Timed out after ${e.timeout}ms`);\n * }\n * }\n * ```\n */\nexport class Z3rnoTimeoutError extends Z3rnoError {\n /** The timeout duration in milliseconds that was exceeded. */\n timeout: number;\n\n /**\n * @param message - Description of the timeout.\n * @param timeout - The configured timeout value in milliseconds.\n */\n constructor(message: string, timeout: number) {\n super(message, undefined);\n this.name = \"Z3rnoTimeoutError\";\n this.timeout = timeout;\n }\n}\n\n/**\n * Thrown when the SDK cannot establish a connection to the Z3rno API.\n *\n * This typically indicates a network issue, DNS failure, or the server\n * being unreachable. The SDK retries connection errors with exponential\n * backoff before throwing this error.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoConnectionError) {\n * console.error(\"Cannot reach Z3rno API — check your network\");\n * }\n * }\n * ```\n */\nexport class Z3rnoConnectionError extends Z3rnoError {\n /**\n * @param message - Description of the connection failure.\n */\n constructor(message: string) {\n super(message, undefined);\n this.name = \"Z3rnoConnectionError\";\n }\n}\n","/**\n * Zod schemas and inferred TypeScript types for the Z3rno API.\n *\n * Each export is a dual: a Zod schema (used for runtime validation) and an\n * identically-named TypeScript type (used at compile time). Request schemas\n * validate client-side input; response schemas validate server payloads.\n *\n * @module models\n */\n\nimport { z } from \"zod\";\n\n// --- Enums ---\n\n/**\n * Memory type enum.\n *\n * Controls how a memory is stored, indexed, and decayed.\n *\n * - `working` — Short-lived scratchpad memory (high decay rate).\n * - `episodic` — Event-based memory tied to a specific interaction.\n * - `semantic` — Long-term factual knowledge.\n * - `procedural` — How-to or process knowledge.\n */\nexport const MemoryType = z.enum([\n \"working\",\n \"episodic\",\n \"semantic\",\n \"procedural\",\n]);\n\n/** Memory type: `\"working\"` | `\"episodic\"` | `\"semantic\"` | `\"procedural\"`. */\nexport type MemoryType = z.infer<typeof MemoryType>;\n\n/**\n * Relationship type enum.\n *\n * Describes how two memories are related in the knowledge graph.\n *\n * - `derived_from` — This memory was created from another.\n * - `contradicts` — This memory conflicts with another.\n * - `supports` — This memory reinforces another.\n * - `supersedes` — This memory replaces another.\n * - `related_to` — General association.\n * - `caused_by` — Causal relationship.\n */\nexport const RelationshipType = z.enum([\n \"derived_from\",\n \"contradicts\",\n \"supports\",\n \"supersedes\",\n \"related_to\",\n \"caused_by\",\n]);\n\n/** Relationship type between two memories. */\nexport type RelationshipType = z.infer<typeof RelationshipType>;\n\n/**\n * Retrieval strategy for `recall({ strategy: ... })` — Phase C.\n *\n * `AUTO` is the default; the server's LLM router picks one of the\n * others when configured. Use an explicit value to bypass routing.\n */\nexport const RetrievalStrategy = z.enum([\n \"AUTO\",\n \"VECTOR\",\n \"LEXICAL\",\n \"GRAPH\",\n \"TRIPLET\",\n \"TRACE\",\n \"TEMPORAL\",\n \"ASK\",\n \"CYPHER\",\n]);\n\n/** Retrieval strategy enum (canonical UPPERCASE names). */\nexport type RetrievalStrategy = z.infer<typeof RetrievalStrategy>;\n\n// --- Request schemas ---\n\n/**\n * Schema for storing a new memory.\n *\n * @example\n * ```ts\n * const request = StoreMemoryRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * memoryType: \"semantic\",\n * });\n * ```\n */\nexport const StoreMemoryRequest = z.object({\n /** UUID of the agent that owns this memory. */\n agentId: z.string().uuid(),\n /** The text content to store (1 to 100,000 characters). */\n content: z.string().min(1).max(100000),\n /** Category of memory. Defaults to `\"episodic\"`. */\n memoryType: MemoryType.default(\"episodic\"),\n /** Optional UUID of the user associated with this memory. */\n userId: z.string().uuid().optional(),\n /** Arbitrary key-value metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n /** Relationships to other memories in the knowledge graph. */\n relationships: z\n .array(\n z.object({\n /** UUID of the target memory. */\n targetMemoryId: z.string().uuid(),\n /** Type of relationship to the target memory. */\n relationshipType: RelationshipType,\n /** Relationship strength from 0 to 1. Defaults to 1.0. */\n weight: z.number().min(0).max(1).default(1.0),\n /** Arbitrary metadata for the relationship edge. */\n metadata: z.record(z.unknown()).default({}),\n }),\n )\n .default([]),\n /** Time-to-live in seconds. Memory auto-deletes after this duration. */\n ttlSeconds: z.number().int().positive().optional(),\n /** Importance score from 0 to 1. Influences recall ranking. */\n importance: z.number().min(0).max(1).optional(),\n});\n\n/** Parsed type for a store-memory request. */\nexport type StoreMemoryRequest = z.infer<typeof StoreMemoryRequest>;\n\n/**\n * Schema for recalling memories by semantic similarity.\n *\n * @example\n * ```ts\n * const request = RecallRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * topK: 5,\n * });\n * ```\n */\nexport const RecallRequest = z.object({\n /** UUID of the agent whose memories to search. */\n agentId: z.string().uuid(),\n /** Natural-language query for semantic similarity search. */\n query: z.string().optional(),\n /** Filter results to a specific memory type. */\n memoryType: z.string().optional(),\n /** Additional metadata filters. */\n filters: z.record(z.unknown()).optional(),\n /** Maximum number of results to return (1-100, default 10). */\n topK: z.number().int().min(1).max(100).default(10),\n /** Minimum similarity score threshold (0-1, default 0). */\n similarityThreshold: z.number().min(0).max(1).default(0),\n /** ISO 8601 timestamp for temporal queries (point-in-time recall). */\n asOf: z.string().datetime().optional(),\n /** Whether to include soft-deleted memories. */\n includeDeleted: z.boolean().default(false),\n /**\n * Phase C retrieval strategy. `AUTO` (default) lets the server's\n * LLM router pick the best fit. See {@link RetrievalStrategy}.\n */\n strategy: RetrievalStrategy.default(\"AUTO\"),\n /**\n * Phase C cross-encoder re-ranking. When `true`, the server\n * re-ranks the top results via a cross-encoder. Requires the\n * `sentence-transformers` extra on the server.\n */\n rerank: z.boolean().default(false),\n});\n\n/** Parsed type for a recall request. */\nexport type RecallRequest = z.infer<typeof RecallRequest>;\n\n/**\n * Schema for forgetting (deleting) memories.\n *\n * @example\n * ```ts\n * const request = ForgetRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * memoryId: \"mem-123\",\n * hardDelete: true,\n * });\n * ```\n */\nexport const ForgetRequest = z.object({\n /** UUID of the agent that owns the memories. */\n agentId: z.string().uuid(),\n /** UUID of a single memory to delete. */\n memoryId: z.string().uuid().optional(),\n /** UUIDs of multiple memories to delete in one call. */\n memoryIds: z.array(z.string().uuid()).optional(),\n /** If true, permanently deletes (vs. soft-delete). Defaults to false. */\n hardDelete: z.boolean().default(false),\n /** If true, also deletes related memories. Defaults to false. */\n cascade: z.boolean().default(false),\n /** Optional reason for the deletion (stored in audit log). */\n reason: z.string().optional(),\n});\n\n/** Parsed type for a forget request. */\nexport type ForgetRequest = z.infer<typeof ForgetRequest>;\n\n// --- Response schemas ---\n\n/**\n * Schema for a single memory object returned by the API.\n *\n * Used by {@link Z3rnoClient.store}, {@link Z3rnoClient.getMemory}, and\n * {@link Z3rnoClient.updateMemory}.\n */\nexport const MemoryResponse = z.object({\n /** Unique identifier for this memory. */\n id: z.string(),\n /** UUID of the owning agent. */\n agent_id: z.string(),\n /** Text content of the memory. */\n content: z.string(),\n /** Category of the memory. */\n memory_type: z.string(),\n /** Server-computed importance score (0-1). */\n importance_score: z.number(),\n /** Number of times this memory has been recalled. */\n recall_count: z.number(),\n /** Name of the embedding model used, if any. */\n embedding_model: z.string().nullable().optional(),\n /** ISO 8601 creation timestamp. */\n created_at: z.string(),\n /** Arbitrary metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a memory response. */\nexport type MemoryResponse = z.infer<typeof MemoryResponse>;\n\n/**\n * Schema for a single item in recall results.\n *\n * Each item includes similarity, importance, and relevance scores\n * computed by the server's ranking algorithm.\n */\nexport const RecallResultItem = z.object({\n /** Unique identifier of the recalled memory. */\n memory_id: z.string(),\n /** Text content of the memory. */\n content: z.string(),\n /** Optional server-generated summary. */\n summary: z.string().nullable().optional(),\n /** Category of the memory. */\n memory_type: z.string(),\n /** Cosine similarity to the query (0-1). */\n similarity_score: z.number(),\n /** Server-computed importance score (0-1). */\n importance_score: z.number(),\n /** Combined relevance score used for ranking (0-1). */\n relevance_score: z.number(),\n /** Number of times this memory has been recalled. */\n recall_count: z.number(),\n /** ISO 8601 creation timestamp. */\n created_at: z.string(),\n /** Arbitrary metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n /**\n * Phase C per-source signals — e.g. `{ vector: 0.83, lexical: 0.61 }`.\n * Optional so older servers (v0.7.x) keep parsing.\n */\n score_components: z.record(z.number()).default({}),\n});\n\n/** Parsed type for a single recall result item. */\nexport type RecallResultItem = z.infer<typeof RecallResultItem>;\n\n/**\n * Schema for the full recall response.\n *\n * Contains an array of ranked results and the total count of matches.\n */\nexport const RecallResponse = z.object({\n /** Ranked list of matching memories. */\n results: z.array(RecallResultItem),\n /** Total number of matches (may exceed `topK`). */\n total: z.number(),\n /** The query that was searched, if any. */\n query: z.string().nullable().optional(),\n /** Phase C: strategy that actually ran (after AUTO routing + re-rank). */\n strategy_used: z.string().default(\"VECTOR\"),\n /** Phase C: AUTO's candidate list (e.g. `[\"AUTO->GRAPH\"]`). */\n strategies_considered: z.array(z.string()).default([]),\n /** Phase C: whether the cross-encoder re-rank ran. */\n reranked: z.boolean().default(false),\n /** Phase C: end-to-end recall latency on the server (ms). */\n elapsed_ms: z.number().default(0),\n});\n\n/** Parsed type for a recall response. */\nexport type RecallResponse = z.infer<typeof RecallResponse>;\n\n/**\n * Schema for the forget (delete) response.\n *\n * Reports how many memories were deleted and whether cascade was applied.\n */\nexport const ForgetResponse = z.object({\n /** Number of memories deleted. */\n deleted_count: z.number(),\n /** Whether a hard delete was performed. */\n hard_deleted: z.boolean(),\n /** Number of related memories deleted via cascade. */\n cascade_count: z.number(),\n /** IDs of all deleted memories. */\n memory_ids: z.array(z.string()),\n});\n\n/** Parsed type for a forget response. */\nexport type ForgetResponse = z.infer<typeof ForgetResponse>;\n\n/**\n * Schema for a single audit log entry.\n *\n * Audit entries record every operation performed on the agent's memories.\n */\nexport const AuditEntry = z.object({\n /** Auto-incrementing audit entry ID. */\n id: z.number(),\n /** UUID of the agent, if applicable. */\n agent_id: z.string().nullable().optional(),\n /** UUID of the user, if applicable. */\n user_id: z.string().nullable().optional(),\n /** Operation type (e.g., `\"store\"`, `\"recall\"`, `\"forget\"`). */\n operation: z.string(),\n /** UUID of the affected memory, if applicable. */\n memory_id: z.string().nullable().optional(),\n /** Memory type of the affected memory, if applicable. */\n memory_type: z.string().nullable().optional(),\n /** Additional details about the operation. */\n details: z.record(z.unknown()).default({}),\n /** IP address of the caller, if available. */\n ip_address: z.string().nullable().optional(),\n /** ISO 8601 timestamp of the operation. */\n created_at: z.string(),\n});\n\n/** Parsed type for an audit entry. */\nexport type AuditEntry = z.infer<typeof AuditEntry>;\n\n/**\n * Schema for a paginated audit log response.\n *\n * Supports cursor-based pagination via `page` and `page_size`.\n */\nexport const AuditPageResponse = z.object({\n /** Audit entries on this page. */\n entries: z.array(AuditEntry),\n /** Total number of matching audit entries. */\n total: z.number(),\n /** Current page number (1-indexed). */\n page: z.number(),\n /** Number of entries per page. */\n page_size: z.number(),\n /** Whether more pages are available. */\n has_next: z.boolean(),\n});\n\n/** Parsed type for a paginated audit response. */\nexport type AuditPageResponse = z.infer<typeof AuditPageResponse>;\n\n// --- Batch Store ---\n\n/**\n * Schema for the batch store response.\n *\n * Returned by {@link Z3rnoClient.storeBatch} after storing multiple memories.\n */\nexport const BatchStoreResponse = z.object({\n /** Array of stored memory objects. */\n results: z.array(MemoryResponse),\n /** Number of memories successfully stored. */\n stored_count: z.number(),\n});\n\n/** Parsed type for a batch store response. */\nexport type BatchStoreResponse = z.infer<typeof BatchStoreResponse>;\n\n// --- Memory History ---\n\n/**\n * Schema for a single version of a memory (temporal versioning).\n *\n * Each version represents the state of a memory during a specific time range.\n */\nexport const MemoryVersion = z.object({\n /** Version identifier. */\n id: z.string(),\n /** Text content at this version. */\n content: z.string(),\n /** Memory type at this version. */\n memory_type: z.string(),\n /** Importance score at this version. */\n importance_score: z.number(),\n /** ISO 8601 timestamp when this version became active. */\n valid_from: z.string(),\n /** ISO 8601 timestamp when this version was superseded, or null if current. */\n valid_to: z.string().nullable().optional(),\n /** Metadata at this version. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a memory version. */\nexport type MemoryVersion = z.infer<typeof MemoryVersion>;\n\n/**\n * Schema for the memory history response.\n *\n * Contains all temporal versions of a single memory, ordered chronologically.\n */\nexport const MemoryHistoryResponse = z.object({\n /** UUID of the memory. */\n memory_id: z.string(),\n /** Chronologically ordered list of versions. */\n versions: z.array(MemoryVersion),\n /** Total number of versions. */\n total: z.number(),\n});\n\n/** Parsed type for a memory history response. */\nexport type MemoryHistoryResponse = z.infer<typeof MemoryHistoryResponse>;\n\n// --- Sessions ---\n\n/**\n * Schema for a session response.\n *\n * Sessions group related memory operations (e.g., a conversation turn).\n */\nexport const SessionResponse = z.object({\n /** Unique session identifier. */\n session_id: z.string(),\n /** UUID of the agent this session belongs to. */\n agent_id: z.string(),\n /** Type of session (e.g., `\"conversation\"`). */\n session_type: z.string(),\n /** ISO 8601 timestamp when the session started. */\n started_at: z.string(),\n /** Arbitrary session metadata. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a session response. */\nexport type SessionResponse = z.infer<typeof SessionResponse>;\n\n/**\n * Schema for the end-session response.\n *\n * Returned when a session is closed, including summary statistics.\n */\nexport const EndSessionResponse = z.object({\n /** The session that was ended. */\n session_id: z.string(),\n /** ISO 8601 timestamp when the session ended. */\n ended_at: z.string(),\n /** Total duration of the session in seconds. */\n duration_seconds: z.number(),\n /** Number of memories created during the session. */\n memory_count: z.number(),\n});\n\n/** Parsed type for an end-session response. */\nexport type EndSessionResponse = z.infer<typeof EndSessionResponse>;\n\n// ---------------------------------------------------------------------------\n// Forge verbs — ingest / distill / refine (Phase A / B / D)\n// ---------------------------------------------------------------------------\n\n/** Response to POST /v1/ingest — the enqueue ack. */\nexport const IngestJobResponse = z.object({\n job_id: z.string(),\n kind: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n enqueued_at: z.string(),\n});\n\nexport type IngestJobResponse = z.infer<typeof IngestJobResponse>;\n\n/** Full state from GET /v1/ingest/{job_id}. */\nexport const IngestJobStatusResponse = z.object({\n job_id: z.string(),\n agent_id: z.string(),\n dataset_id: z.string().nullable().optional(),\n kind: z.string(),\n status: z.string(),\n source_uri: z.string().nullable().optional(),\n content_type: z.string().nullable().optional(),\n filename: z.string().nullable().optional(),\n file_size: z.number().nullable().optional(),\n memory_ids: z.array(z.string()).default([]),\n memos_written: z.number().default(0),\n distill_job_id: z.string().nullable().optional(),\n codegraph_memos_written: z.number().default(0),\n codegraph_edges_written: z.number().default(0),\n error: z.string().nullable().optional(),\n warnings: z.array(z.record(z.unknown())).default([]),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type IngestJobStatusResponse = z.infer<typeof IngestJobStatusResponse>;\n\n/** Distill enqueue ack. */\nexport const DistillJobResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n memory_ids: z.array(z.string()),\n enqueued_at: z.string(),\n});\n\nexport type DistillJobResponse = z.infer<typeof DistillJobResponse>;\n\n/** Full distill job state. */\nexport const DistillJobStatusResponse = z.object({\n job_id: z.string(),\n agent_id: z.string(),\n status: z.string(),\n model: z.string(),\n memory_ids: z.array(z.string()),\n chunk_size: z.number(),\n chunk_overlap: z.number(),\n max_concurrency: z.number(),\n chunks_total: z.number(),\n chunks_failed: z.number(),\n entities_extracted: z.number(),\n relationships_extracted: z.number(),\n memos_written: z.number(),\n error: z.string().nullable().optional(),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type DistillJobStatusResponse = z.infer<typeof DistillJobStatusResponse>;\n\n/** Refine enqueue ack. */\nexport const RefineJobResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n enqueued_at: z.string(),\n});\n\nexport type RefineJobResponse = z.infer<typeof RefineJobResponse>;\n\n/** Full refine job state. */\nexport const RefineJobStatusResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n trigger: z.string(),\n memos_scanned: z.number().default(0),\n memos_deduped: z.number().default(0),\n edges_reweighted: z.number().default(0),\n edges_pruned: z.number().default(0),\n feedback_drained: z.number().default(0),\n job_metadata: z.record(z.unknown()).default({}),\n error: z.string().nullable().optional(),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type RefineJobStatusResponse = z.infer<typeof RefineJobStatusResponse>;\n\n\n// ---------------------------------------------------------------------------\n// Conversations — Phase G slice 2\n// ---------------------------------------------------------------------------\n\n/** Conversation metadata. */\nexport const ConversationResponse = z.object({\n id: z.string(),\n agent_id: z.string(),\n user_id: z.string().nullable().optional(),\n title: z.string().nullable().optional(),\n summary_cadence: z.number(),\n turn_count: z.number(),\n last_summary_turn: z.number(),\n metadata: z.record(z.unknown()).default({}),\n created_at: z.string(),\n updated_at: z.string(),\n});\n\nexport type ConversationResponse = z.infer<typeof ConversationResponse>;\n\n/** Result of POST /v1/conversations/{id}/turns. */\nexport const TurnAddResponse = z.object({\n turn_index: z.number(),\n needs_summary: z.boolean(),\n});\n\nexport type TurnAddResponse = z.infer<typeof TurnAddResponse>;\n\n/** One turn within a conversation. */\nexport const TurnResponse = z.object({\n memory_id: z.string(),\n turn_index: z.number(),\n turn_role: z.string(),\n content: z.string(),\n created_at: z.string(),\n});\n\nexport type TurnResponse = z.infer<typeof TurnResponse>;\n\n/** Paginated turn list. */\nexport const TurnListResponse = z.object({\n turns: z.array(TurnResponse),\n total: z.number(),\n conversation_id: z.string(),\n});\n\nexport type TurnListResponse = z.infer<typeof TurnListResponse>;\n\n\n// ---------------------------------------------------------------------------\n// Tenant budgets — v0.20.3\n// ---------------------------------------------------------------------------\n\n/** Per-tenant budget caps. Zero means inherit server default. */\nexport const TenantBudgets = z.object({\n daily_tokens: z.number(),\n daily_llm_calls: z.number(),\n daily_embeddings: z.number(),\n monthly_tokens: z.number(),\n monthly_llm_calls: z.number(),\n monthly_embeddings: z.number(),\n});\n\nexport type TenantBudgets = z.infer<typeof TenantBudgets>;\n\n/** Server response: stored overrides + resolved effective caps. */\nexport const TenantBudgetsView = z.object({\n overrides: TenantBudgets,\n effective: TenantBudgets,\n});\n\nexport type TenantBudgetsView = z.infer<typeof TenantBudgetsView>;\n","/**\n * Z3rno TypeScript SDK client.\n *\n * Thin fetch wrapper — no database drivers, no embedding providers.\n * Works in Node.js 18+, Deno, Bun, and modern browsers (any runtime\n * with a global `fetch` and `AbortController`).\n *\n * @module client\n *\n * @example\n * ```ts\n * const client = new Z3rnoClient({ baseUrl: \"http://localhost:8000\", apiKey: \"z3rno_sk_...\" });\n * const memory = await client.store({ agentId: \"agent-1\", content: \"User prefers dark mode\" });\n * const results = await client.recall({ agentId: \"agent-1\", query: \"user preferences\" });\n * await client.forget({ agentId: \"agent-1\", memoryId: memory.id });\n * ```\n */\n\nimport {\n AuthenticationError,\n NotFoundError,\n RateLimitError,\n ServerError,\n ValidationError,\n Z3rnoConnectionError,\n Z3rnoError,\n Z3rnoTimeoutError,\n} from \"./errors.js\";\nimport type {\n AuditPageResponse,\n BatchStoreResponse,\n ConversationResponse,\n DistillJobResponse,\n DistillJobStatusResponse,\n EndSessionResponse,\n ForgetResponse,\n IngestJobResponse,\n IngestJobStatusResponse,\n MemoryHistoryResponse,\n MemoryResponse,\n RecallResponse,\n RefineJobResponse,\n RefineJobStatusResponse,\n SessionResponse,\n StoreMemoryRequest,\n TenantBudgets,\n TenantBudgetsView,\n TurnAddResponse,\n TurnListResponse,\n} from \"./models.js\";\nimport {\n AuditPageResponse as AuditPageSchema,\n BatchStoreResponse as BatchStoreSchema,\n ConversationResponse as ConversationSchema,\n DistillJobResponse as DistillJobSchema,\n DistillJobStatusResponse as DistillJobStatusSchema,\n EndSessionResponse as EndSessionSchema,\n ForgetResponse as ForgetSchema,\n IngestJobResponse as IngestJobSchema,\n IngestJobStatusResponse as IngestJobStatusSchema,\n MemoryHistoryResponse as MemoryHistorySchema,\n MemoryResponse as MemorySchema,\n RecallResponse as RecallSchema,\n RefineJobResponse as RefineJobSchema,\n RefineJobStatusResponse as RefineJobStatusSchema,\n SessionResponse as SessionSchema,\n TenantBudgetsView as TenantBudgetsViewSchema,\n TurnAddResponse as TurnAddSchema,\n TurnListResponse as TurnListSchema,\n} from \"./models.js\";\n\n/**\n * Configuration options for the {@link Z3rnoClient}.\n *\n * All fields are optional. When omitted, the client reads from environment\n * variables (`Z3RNO_BASE_URL`, `Z3RNO_API_KEY`) or uses sensible defaults.\n */\nexport interface Z3rnoClientConfig {\n /**\n * Base URL of the Z3rno API.\n *\n * Falls back to the `Z3RNO_BASE_URL` environment variable, then\n * to `\"https://api.z3rno.dev\"`.\n */\n baseUrl?: string;\n\n /**\n * API key for authentication.\n *\n * Falls back to the `Z3RNO_API_KEY` environment variable, then to\n * an empty string (unauthenticated).\n */\n apiKey?: string;\n\n /**\n * Request timeout in milliseconds.\n *\n * @defaultValue 30000 (30 seconds)\n */\n timeout?: number;\n\n /**\n * Maximum number of retry attempts for retryable errors (5xx, 429,\n * network failures, timeouts).\n *\n * @defaultValue 3\n */\n maxRetries?: number;\n\n /**\n * Custom fetch implementation.\n *\n * Defaults to `globalThis.fetch`. Override to use `undici`, `node-fetch`,\n * or a test double.\n *\n * @defaultValue globalThis.fetch\n */\n fetch?: typeof globalThis.fetch;\n\n /**\n * Intercept outgoing requests before they are sent.\n *\n * Use this to add custom headers, log requests, or collect metrics.\n * The callback receives the URL and the `RequestInit` and must return\n * a (possibly modified) `RequestInit`.\n */\n onRequest?: (url: string, init: RequestInit) => RequestInit;\n\n /**\n * Intercept responses before they are processed.\n *\n * Use this for logging, metrics, or response transformation.\n * The callback receives the `Response` and must return a `Response`.\n */\n onResponse?: (response: Response) => Response;\n}\n\n/**\n * Client for the Z3rno AI agent memory API.\n *\n * Uses the standard Fetch API under the hood, making it compatible with\n * Node.js 18+, Deno, Bun, and modern browsers. All responses are\n * validated at runtime with Zod schemas.\n *\n * @example\n * ```ts\n * import { Z3rnoClient } from \"@z3rno/sdk\";\n *\n * const client = new Z3rnoClient({\n * baseUrl: \"http://localhost:8000\",\n * apiKey: \"z3rno_sk_test_...\",\n * });\n *\n * // Store a memory\n * const mem = await client.store({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * });\n *\n * // Recall relevant memories\n * const results = await client.recall({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * });\n * ```\n */\nexport class Z3rnoClient {\n private baseUrl: string;\n private apiKey: string;\n private timeout: number;\n private maxRetries: number;\n private fetchImpl: typeof globalThis.fetch;\n private onRequest?: (url: string, init: RequestInit) => RequestInit;\n private onResponse?: (response: Response) => Response;\n\n /**\n * Creates a new Z3rno client instance.\n *\n * @param config - Client configuration options. All fields are optional.\n *\n * @example\n * ```ts\n * // Explicit configuration\n * const client = new Z3rnoClient({\n * baseUrl: \"http://localhost:8000\",\n * apiKey: \"z3rno_sk_test_...\",\n * timeout: 10000,\n * maxRetries: 2,\n * });\n *\n * // Or rely on environment variables (Z3RNO_BASE_URL, Z3RNO_API_KEY)\n * const client = new Z3rnoClient();\n * ```\n */\n constructor(config: Z3rnoClientConfig = {}) {\n // Resolve baseUrl: explicit > env var > default\n let resolvedUrl = config.baseUrl ?? \"\";\n if (!resolvedUrl && typeof process !== \"undefined\" && process.env) {\n resolvedUrl = process.env.Z3RNO_BASE_URL ?? \"\";\n }\n if (!resolvedUrl) {\n resolvedUrl = \"https://api.z3rno.dev\";\n }\n this.baseUrl = resolvedUrl.replace(/\\/$/, \"\");\n\n // Resolve apiKey: explicit > env var > empty\n let resolvedKey = config.apiKey ?? \"\";\n if (!resolvedKey && typeof process !== \"undefined\" && process.env) {\n resolvedKey = process.env.Z3RNO_API_KEY ?? \"\";\n }\n this.apiKey = resolvedKey;\n\n this.timeout = config.timeout ?? 30000;\n this.maxRetries = config.maxRetries ?? 3;\n this.fetchImpl = config.fetch ?? globalThis.fetch;\n this.onRequest = config.onRequest;\n this.onResponse = config.onResponse;\n }\n\n // --- Store ---\n\n /**\n * Stores a new memory for an agent.\n *\n * The server generates an embedding for the content and stores it in\n * the vector database. The memory is immediately available for recall.\n *\n * @param request - The memory to store.\n * @returns The stored memory, including the server-generated ID and scores.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link ValidationError} If the request body is invalid.\n * @throws {@link Z3rnoTimeoutError} If the request times out.\n *\n * @example\n * ```ts\n * const memory = await client.store({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * memoryType: \"semantic\",\n * metadata: { source: \"settings-page\" },\n * });\n * console.log(memory.id); // \"mem-abc123\"\n * ```\n */\n async store(request: StoreMemoryRequest): Promise<MemoryResponse> {\n const body = {\n agent_id: request.agentId,\n content: request.content,\n memory_type: request.memoryType,\n user_id: request.userId,\n metadata: request.metadata,\n relationships: request.relationships?.map((r) => ({\n target_memory_id: r.targetMemoryId,\n relationship_type: r.relationshipType,\n weight: r.weight,\n metadata: r.metadata,\n })),\n ttl_seconds: request.ttlSeconds,\n importance: request.importance,\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories\", body);\n return MemorySchema.parse(resp);\n }\n\n // --- Recall ---\n\n /**\n * Recalls memories by semantic similarity to a query.\n *\n * Returns a ranked list of memories sorted by a combined relevance score\n * that factors in similarity, importance, and recency.\n *\n * @param params - Recall parameters including the query and filters.\n * @param params.agentId - UUID of the agent whose memories to search.\n * @param params.query - Natural-language query for semantic search.\n * @param params.memoryType - Filter by memory type.\n * @param params.filters - Additional metadata filters.\n * @param params.topK - Maximum results to return (default 10).\n * @param params.similarityThreshold - Minimum similarity score (default 0).\n * @returns Ranked recall results with similarity scores.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link Z3rnoTimeoutError} If the request times out.\n *\n * @example\n * ```ts\n * const results = await client.recall({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * topK: 5,\n * similarityThreshold: 0.7,\n * });\n * for (const item of results.results) {\n * console.log(`${item.content} (score: ${item.relevance_score})`);\n * }\n * ```\n */\n async recall(params: {\n agentId: string;\n query?: string;\n memoryType?: string;\n /**\n * v0.21.2 — JSONB metadata containment filter\n * (`metadata @> :metadata_filter` server-side). Renamed from\n * `filters`; the old name is still accepted via `filters` below\n * but emits a deprecation warning.\n */\n metadataFilter?: Record<string, unknown>;\n /** @deprecated Use `metadataFilter` instead. */\n filters?: Record<string, unknown>;\n /**\n * v0.21.1 — scope by end-user id (the `memories.user_id`\n * column). Multi-user agents use this for per-user recall\n * isolation. Real WHERE predicate, not just audit context.\n */\n userId?: string;\n topK?: number;\n similarityThreshold?: number;\n /**\n * Phase C: retrieval strategy. One of `AUTO | VECTOR | LEXICAL |\n * GRAPH | TRIPLET | TRACE | TEMPORAL | ASK | CYPHER`. Default\n * `\"AUTO\"` — server's LLM router picks per query.\n */\n strategy?: string;\n /**\n * Phase C: cross-encoder re-ranking. When `true`, the server\n * re-ranks the strategy's top results. Requires\n * `sentence-transformers` on the server side.\n */\n rerank?: boolean;\n /**\n * Phase G slice 2: scope recall to a single conversation. Older\n * servers ignore the field.\n */\n conversationId?: string;\n }): Promise<RecallResponse> {\n // v0.21.2 — honour the deprecated `filters` alias.\n let metadataFilter = params.metadataFilter;\n if (params.filters !== undefined && metadataFilter === undefined) {\n if (typeof console !== \"undefined\" && console.warn) {\n console.warn(\n \"Z3rnoClient.recall({filters}) is deprecated; use {metadataFilter} instead.\",\n );\n }\n metadataFilter = params.filters;\n }\n\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n query: params.query,\n memory_type: params.memoryType,\n metadata_filter: metadataFilter,\n top_k: params.topK ?? 10,\n similarity_threshold: params.similarityThreshold ?? 0,\n // Always send strategy + rerank. Older servers silently ignore\n // unknown body fields.\n strategy: params.strategy ?? \"AUTO\",\n rerank: params.rerank ?? false,\n };\n if (params.userId) {\n body.user_id = params.userId;\n }\n if (params.conversationId) {\n body.conversation_id = params.conversationId;\n }\n\n const resp = await this.request(\"POST\", \"/v1/memories/recall\", body);\n return RecallSchema.parse(resp);\n }\n\n // --- Forget ---\n\n /**\n * Forgets (deletes) one or more memories.\n *\n * By default, performs a soft delete (marks as deleted but retains data).\n * Set `hardDelete: true` for permanent removal. Use `cascade: true` to\n * also delete related memories in the knowledge graph.\n *\n * @param params - Forget parameters.\n * @param params.agentId - UUID of the agent that owns the memories.\n * @param params.memoryId - UUID of a single memory to delete.\n * @param params.memoryIds - UUIDs of multiple memories to delete.\n * @param params.hardDelete - Permanently delete (default false).\n * @param params.cascade - Delete related memories too (default false).\n * @param params.reason - Reason for deletion (stored in audit log).\n * @returns Summary of the deletion operation.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link NotFoundError} If the specified memory does not exist.\n *\n * @example\n * ```ts\n * const result = await client.forget({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * memoryId: \"mem-abc123\",\n * hardDelete: true,\n * reason: \"User requested data deletion\",\n * });\n * console.log(`Deleted ${result.deleted_count} memories`);\n * ```\n */\n async forget(params: {\n agentId: string;\n memoryId?: string;\n memoryIds?: string[];\n hardDelete?: boolean;\n cascade?: boolean;\n reason?: string;\n }): Promise<ForgetResponse> {\n const body = {\n agent_id: params.agentId,\n memory_id: params.memoryId,\n memory_ids: params.memoryIds,\n hard_delete: params.hardDelete ?? false,\n cascade: params.cascade ?? false,\n reason: params.reason,\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories/forget\", body);\n return ForgetSchema.parse(resp);\n }\n\n // --- Get Memory ---\n\n /**\n * Retrieves a single memory by its ID.\n *\n * @param memoryId - The unique identifier of the memory to retrieve.\n * @returns The full memory object.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const memory = await client.getMemory(\"mem-abc123\");\n * console.log(memory.content);\n * console.log(memory.importance_score);\n * ```\n */\n async getMemory(memoryId: string): Promise<MemoryResponse> {\n const resp = await this.request(\"GET\", `/v1/memories/${memoryId}`);\n return MemorySchema.parse(resp);\n }\n\n // --- Store Batch ---\n\n /**\n * Stores multiple memories in a single API call.\n *\n * More efficient than calling {@link store} in a loop. All memories are\n * processed atomically on the server.\n *\n * @param memories - Array of memories to store.\n * @returns The stored memories and a count of how many were created.\n * @throws {@link ValidationError} If any memory in the batch is invalid.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const result = await client.storeBatch([\n * { agentId: \"agent-1\", content: \"Fact one\" },\n * { agentId: \"agent-1\", content: \"Fact two\", memoryType: \"semantic\" },\n * ]);\n * console.log(`Stored ${result.stored_count} memories`);\n * ```\n */\n async storeBatch(\n memories: StoreMemoryRequest[],\n ): Promise<BatchStoreResponse> {\n const body = {\n memories: memories.map((m) => ({\n agent_id: m.agentId,\n content: m.content,\n memory_type: m.memoryType,\n metadata: m.metadata,\n importance: m.importance,\n })),\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories/batch\", body);\n return BatchStoreSchema.parse(resp);\n }\n\n // --- Memory History ---\n\n /**\n * Retrieves the full version history of a memory.\n *\n * Z3rno uses temporal versioning — every update creates a new version\n * rather than overwriting. This method returns all versions ordered\n * chronologically.\n *\n * @param memoryId - The unique identifier of the memory.\n * @returns All versions of the memory with validity timestamps.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const history = await client.getMemoryHistory(\"mem-abc123\");\n * for (const version of history.versions) {\n * console.log(`${version.valid_from}: ${version.content}`);\n * }\n * ```\n */\n async getMemoryHistory(memoryId: string): Promise<MemoryHistoryResponse> {\n const resp = await this.request(\"GET\", `/v1/memories/${memoryId}/history`);\n return MemoryHistorySchema.parse(resp);\n }\n\n // --- Update Memory ---\n\n /**\n * Updates an existing memory's content, metadata, or importance.\n *\n * Creates a new temporal version of the memory. The previous version\n * remains accessible via {@link getMemoryHistory}.\n *\n * @param memoryId - The unique identifier of the memory to update.\n * @param updates - Fields to update (only provided fields are changed).\n * @param updates.content - New text content.\n * @param updates.metadata - New metadata (replaces existing metadata).\n * @param updates.importance - New importance score (0-1).\n * @returns The updated memory object.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link ValidationError} If the update values are invalid.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const updated = await client.updateMemory(\"mem-abc123\", {\n * content: \"User now prefers light mode\",\n * importance: 0.9,\n * });\n * ```\n */\n async updateMemory(\n memoryId: string,\n updates: {\n content?: string;\n metadata?: Record<string, unknown>;\n importance?: number;\n },\n ): Promise<MemoryResponse> {\n const body: Record<string, unknown> = {};\n if (updates.content !== undefined) body.content = updates.content;\n if (updates.metadata !== undefined) body.metadata = updates.metadata;\n if (updates.importance !== undefined) body.importance = updates.importance;\n\n const resp = await this.request(\"PATCH\", `/v1/memories/${memoryId}`, body);\n return MemorySchema.parse(resp);\n }\n\n // --- Sessions ---\n\n /**\n * Starts a new session for grouping related memory operations.\n *\n * Sessions are useful for tracking conversation turns or task boundaries.\n * Memories created during a session are automatically associated with it.\n *\n * @param params - Session parameters.\n * @param params.agentId - UUID of the agent to start the session for.\n * @param params.sessionType - Type of session (default `\"conversation\"`).\n * @returns The created session with its ID and start time.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const session = await client.startSession({ agentId: \"agent-1\" });\n * console.log(`Session started: ${session.session_id}`);\n * // ... perform operations ...\n * await client.endSession(session.session_id);\n * ```\n */\n async startSession(params: {\n agentId: string;\n sessionType?: string;\n }): Promise<SessionResponse> {\n const body = {\n agent_id: params.agentId,\n session_type: params.sessionType ?? \"conversation\",\n };\n\n const resp = await this.request(\"POST\", \"/v1/sessions\", body);\n return SessionSchema.parse(resp);\n }\n\n /**\n * Ends an active session.\n *\n * Returns summary statistics including the session duration and the\n * number of memories created during the session.\n *\n * @param sessionId - The unique identifier of the session to end.\n * @returns Session summary with duration and memory count.\n * @throws {@link NotFoundError} If no active session exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const summary = await client.endSession(\"sess-abc123\");\n * console.log(`Session lasted ${summary.duration_seconds}s, ${summary.memory_count} memories`);\n * ```\n */\n async endSession(sessionId: string): Promise<EndSessionResponse> {\n const resp = await this.request(\"POST\", `/v1/sessions/${sessionId}/end`);\n return EndSessionSchema.parse(resp);\n }\n\n // --- Audit ---\n\n /**\n * Retrieves a paginated audit log of memory operations.\n *\n * The audit log records every store, recall, forget, and update operation\n * performed by any agent. Useful for compliance, debugging, and analytics.\n *\n * @param params - Optional pagination and filter parameters.\n * @param params.agentId - Filter by agent UUID.\n * @param params.page - Page number (1-indexed).\n * @param params.pageSize - Number of entries per page.\n * @returns A page of audit log entries with pagination metadata.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const page = await client.audit({ agentId: \"agent-1\", page: 1, pageSize: 20 });\n * for (const entry of page.entries) {\n * console.log(`${entry.created_at}: ${entry.operation} on ${entry.memory_id}`);\n * }\n * if (page.has_next) {\n * const nextPage = await client.audit({ agentId: \"agent-1\", page: 2 });\n * }\n * ```\n */\n async audit(params?: {\n agentId?: string;\n page?: number;\n pageSize?: number;\n }): Promise<AuditPageResponse> {\n const searchParams = new URLSearchParams();\n if (params?.agentId) searchParams.set(\"agent_id\", params.agentId);\n if (params?.page) searchParams.set(\"page\", String(params.page));\n if (params?.pageSize)\n searchParams.set(\"page_size\", String(params.pageSize));\n\n const query = searchParams.toString();\n const path = query ? `/v1/audit?${query}` : \"/v1/audit\";\n const resp = await this.request(\"GET\", path);\n return AuditPageSchema.parse(resp);\n }\n\n // --- Forge: ingest / distill / refine -------------------------------\n //\n // Wrap the server's POST /v1/ingest, /v1/distill, /v1/refine plus the\n // matching GET status endpoints. The server gates each verb behind an\n // operator flag (INGEST_ENABLED / DISTILL_ENABLED / REFINE_ENABLED);\n // when off, these methods throw NotFoundError.\n\n async ingestText(params: {\n agentId: string;\n text: string;\n datasetId?: string;\n }): Promise<IngestJobResponse> {\n const body: Record<string, unknown> = {\n kind: \"text\",\n agent_id: params.agentId,\n text: params.text,\n };\n if (params.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/ingest\", body);\n return IngestJobSchema.parse(resp);\n }\n\n async ingestUrl(params: {\n agentId: string;\n url: string;\n datasetId?: string;\n }): Promise<IngestJobResponse> {\n const body: Record<string, unknown> = {\n kind: \"url\",\n agent_id: params.agentId,\n url: params.url,\n };\n if (params.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/ingest\", body);\n return IngestJobSchema.parse(resp);\n }\n\n async getIngestStatus(jobId: string): Promise<IngestJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/ingest/${jobId}`);\n return IngestJobStatusSchema.parse(resp);\n }\n\n async distill(params: {\n agentId: string;\n memoryIds: string[];\n chunkSize?: number;\n chunkOverlap?: number;\n maxConcurrency?: number;\n summaryStyle?: string;\n includeSummary?: boolean;\n }): Promise<DistillJobResponse> {\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n memory_ids: params.memoryIds,\n include_summary: params.includeSummary ?? true,\n };\n if (params.chunkSize !== undefined) body.chunk_size = params.chunkSize;\n if (params.chunkOverlap !== undefined)\n body.chunk_overlap = params.chunkOverlap;\n if (params.maxConcurrency !== undefined)\n body.max_concurrency = params.maxConcurrency;\n if (params.summaryStyle !== undefined)\n body.summary_style = params.summaryStyle;\n const resp = await this.request(\"POST\", \"/v1/distill\", body);\n return DistillJobSchema.parse(resp);\n }\n\n async getDistillStatus(jobId: string): Promise<DistillJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/distill/${jobId}`);\n return DistillJobStatusSchema.parse(resp);\n }\n\n async refine(params?: { datasetId?: string }): Promise<RefineJobResponse> {\n const body: Record<string, unknown> = {};\n if (params?.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/refine\", body);\n return RefineJobSchema.parse(resp);\n }\n\n async getRefineStatus(jobId: string): Promise<RefineJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/refine/${jobId}`);\n return RefineJobStatusSchema.parse(resp);\n }\n\n // --- Conversations (Phase G slice 2) ---\n\n /**\n * Open a new conversation. Returns the conversation row including\n * the assigned `id`, which subsequent `recall`s and `addTurn`s\n * reference. The `summaryCadence` controls how often the server\n * flags the conversation for summarization.\n */\n async createConversation(params: {\n agentId: string;\n userId?: string;\n title?: string;\n summaryCadence?: number;\n metadata?: Record<string, unknown>;\n }): Promise<ConversationResponse> {\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n summary_cadence: params.summaryCadence ?? 10,\n };\n if (params.userId) body.user_id = params.userId;\n if (params.title) body.title = params.title;\n if (params.metadata) body.metadata = params.metadata;\n const resp = await this.request(\"POST\", \"/v1/conversations\", body);\n return ConversationSchema.parse(resp);\n }\n\n async getConversation(conversationId: string): Promise<ConversationResponse> {\n const resp = await this.request(\"GET\", `/v1/conversations/${conversationId}`);\n return ConversationSchema.parse(resp);\n }\n\n /**\n * Stamp an existing Memo as the next turn of the conversation.\n * Returns the assigned `turn_index` plus `needs_summary` — when\n * `true`, the conversation has crossed its cadence threshold.\n */\n async addTurn(\n conversationId: string,\n params: { memoryId: string; turnRole: string },\n ): Promise<TurnAddResponse> {\n const resp = await this.request(\n \"POST\",\n `/v1/conversations/${conversationId}/turns`,\n { memory_id: params.memoryId, turn_role: params.turnRole },\n );\n return TurnAddSchema.parse(resp);\n }\n\n /**\n * v0.19.3 — soft-delete a conversation. Existing turn Memos stay\n * queryable through standard recall; the conversation itself stops\n * accepting turns and its endpoints 404. Idempotent.\n */\n async deleteConversation(conversationId: string): Promise<void> {\n await this.request(\"DELETE\", `/v1/conversations/${conversationId}`);\n }\n\n async listTurns(\n conversationId: string,\n params?: { afterTurn?: number; limit?: number },\n ): Promise<TurnListResponse> {\n const query = new URLSearchParams();\n if (params?.afterTurn !== undefined)\n query.set(\"after_turn\", String(params.afterTurn));\n query.set(\"limit\", String(params?.limit ?? 50));\n const path = `/v1/conversations/${conversationId}/turns?${query.toString()}`;\n const resp = await this.request(\"GET\", path);\n return TurnListSchema.parse(resp);\n }\n\n // --- Tenant budgets (v0.20.3) ---\n\n /**\n * Read this org's stored budget overrides + resolved effective caps.\n * Auth: any admin/write/read member of the calling org.\n */\n async getMyBudgets(): Promise<TenantBudgetsView> {\n const resp = await this.request(\"GET\", \"/v1/tenants/me/budgets\");\n return TenantBudgetsViewSchema.parse(resp);\n }\n\n /**\n * Replace this org's budget overrides. Zero / missing fields\n * inherit the server default. Auth: admin/write only.\n */\n async setMyBudgets(\n budgets: Partial<TenantBudgets>,\n ): Promise<TenantBudgetsView> {\n const body: TenantBudgets = {\n daily_tokens: budgets.daily_tokens ?? 0,\n daily_llm_calls: budgets.daily_llm_calls ?? 0,\n daily_embeddings: budgets.daily_embeddings ?? 0,\n monthly_tokens: budgets.monthly_tokens ?? 0,\n monthly_llm_calls: budgets.monthly_llm_calls ?? 0,\n monthly_embeddings: budgets.monthly_embeddings ?? 0,\n };\n const resp = await this.request(\"PUT\", \"/v1/tenants/me/budgets\", body);\n return TenantBudgetsViewSchema.parse(resp);\n }\n\n // --- HTTP layer ---\n\n private async request(\n method: string,\n path: string,\n body?: unknown,\n ): Promise<unknown> {\n let lastError: Error | undefined;\n\n for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n try {\n const url = `${this.baseUrl}${path}`;\n let init: RequestInit = {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n \"User-Agent\": \"@z3rno/sdk/0.0.1\",\n },\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n };\n\n if (this.onRequest) {\n init = this.onRequest(url, init);\n }\n\n let response = await this.fetchImpl(url, init);\n\n if (this.onResponse) {\n response = this.onResponse(response);\n }\n\n clearTimeout(timeoutId);\n\n // On 429, honor Retry-After header and retry\n if (response.status === 429 && attempt < this.maxRetries) {\n const retryAfter = parseInt(\n response.headers.get(\"Retry-After\") ?? \"1\",\n 10,\n );\n await this.sleep(retryAfter * 1000);\n continue;\n }\n\n // On 5xx, retry with exponential backoff\n if (response.status >= 500 && attempt < this.maxRetries) {\n const delay = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s\n await this.sleep(delay);\n continue;\n }\n\n return this.handleResponse(response);\n } catch (error) {\n clearTimeout(timeoutId);\n\n // Do not retry Z3rnoError subclasses (4xx client errors)\n if (error instanceof Z3rnoError) throw error;\n\n // Classify the error before deciding whether to retry\n if (error instanceof DOMException && error.name === \"AbortError\") {\n lastError = new Z3rnoTimeoutError(\n `Request timed out after ${this.timeout}ms`,\n this.timeout,\n );\n } else if (error instanceof TypeError) {\n lastError = new Z3rnoConnectionError(\n `Connection failed: ${error.message}`,\n );\n } else {\n lastError = error instanceof Error ? error : new Error(String(error));\n }\n\n if (attempt < this.maxRetries) {\n const delay = Math.pow(2, attempt) * 1000;\n await this.sleep(delay);\n continue;\n }\n }\n }\n\n // After all retries exhausted, throw the last classified error\n if (lastError instanceof Z3rnoError) {\n throw lastError;\n }\n throw new Z3rnoError(\n `Request failed after ${this.maxRetries + 1} attempts: ${String(lastError)}`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n\n private async handleResponse(resp: Response): Promise<unknown> {\n if (resp.ok) {\n // 204 No Content: DELETE-style endpoints (deleteConversation,\n // key revoke) return an empty body. Calling resp.json() on it\n // rejects with SyntaxError (\"Unexpected end of JSON input\"),\n // which the retry loop above wraps and burns through every\n // retry attempt before timing out. Short-circuit instead.\n if (resp.status === 204) {\n return undefined;\n }\n return resp.json();\n }\n\n let detail = resp.statusText;\n try {\n const text = await resp.text();\n try {\n const body = JSON.parse(text) as Record<string, unknown>;\n detail = String(body.detail ?? body.error ?? resp.statusText);\n } catch {\n // Response is not JSON (e.g., nginx HTML 502). Include the\n // beginning of the body so users can diagnose proxy/gateway issues.\n if (text.length > 0) {\n const preview = text.length > 200 ? text.slice(0, 200) + \"...\" : text;\n detail = `${resp.statusText} — ${preview}`;\n }\n }\n } catch {\n // Could not read body at all\n }\n\n switch (resp.status) {\n case 401:\n throw new AuthenticationError(`Authentication failed: ${detail}`);\n case 404:\n throw new NotFoundError(`Not found: ${detail}`);\n case 429: {\n const retryAfter = parseInt(\n resp.headers.get(\"Retry-After\") ?? \"60\",\n 10,\n );\n throw new RateLimitError(`Rate limit exceeded: ${detail}`, retryAfter);\n }\n case 400:\n case 422:\n throw new ValidationError(detail, resp.status);\n default:\n if (resp.status >= 500) {\n throw new ServerError(`Server error: ${detail}`, resp.status);\n }\n throw new Z3rnoError(\n `Unexpected error (${resp.status}): ${detail}`,\n resp.status,\n );\n }\n }\n}\n","/**\n * Vercel AI SDK adapter for Z3rno (Phase G slice 3).\n *\n * Vercel AI SDK accepts a plain `CoreMessage[]` history; this adapter\n * loads + persists that history through Z3rno conversations. Drop the\n * `messages` accessor straight into `streamText` / `generateText`,\n * call `appendUserMessage` / `appendAssistantMessage` after each turn,\n * and Z3rno handles ordering + recall.\n *\n * Zero hard dependency on the `ai` package — we duck-type on the\n * minimal `CoreMessage` shape (`{ role, content }`).\n */\n\nimport type { Z3rnoClient } from \"../client.js\";\n\nexport type Z3rnoMessageRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\n/** Subset of Vercel `ai` `CoreMessage` the adapter needs. */\nexport interface CoreMessage {\n role: Z3rnoMessageRole;\n content: string;\n}\n\nexport interface Z3rnoVercelMemoryOptions {\n client: Z3rnoClient;\n agentId: string;\n /** When set, recall + persisted turns are scoped to this Z3rno conversation. */\n conversationId?: string;\n /** Max history slice to load. Default 50. */\n topK?: number;\n}\n\n/**\n * Lightweight history adapter you can hand straight to Vercel AI SDK\n * helpers. `await mem.messages()` returns a CoreMessage[] ready to\n * pass to `streamText({ messages: ... })`. After each turn, call\n * `appendUserMessage` / `appendAssistantMessage` so future recalls\n * see the latest state.\n */\nexport class Z3rnoVercelMemory {\n private readonly client: Z3rnoClient;\n private readonly agentId: string;\n private readonly conversationId: string | undefined;\n private readonly topK: number;\n\n constructor(options: Z3rnoVercelMemoryOptions) {\n this.client = options.client;\n this.agentId = options.agentId;\n this.conversationId = options.conversationId;\n this.topK = options.topK ?? 50;\n }\n\n async messages(): Promise<CoreMessage[]> {\n if (this.conversationId) {\n // Conversation-scoped: pull turns in order.\n const page = await this.client.listTurns(this.conversationId, {\n limit: this.topK,\n });\n return page.turns.map((t) => ({\n role: this.normaliseRole(t.turn_role),\n content: t.content,\n }));\n }\n // No conversation — fall back to recall-based history (newest first).\n const resp = await this.client.recall({\n agentId: this.agentId,\n topK: this.topK,\n memoryType: \"episodic\",\n });\n const reversed = [...resp.results].reverse();\n return reversed.map((r) => ({\n role: this.normaliseRole(\n ((r.metadata as Record<string, unknown> | undefined) ?? {})[\n \"role\"\n ] as string | undefined,\n ),\n content: r.content,\n }));\n }\n\n async appendUserMessage(content: string): Promise<void> {\n await this.append(content, \"user\");\n }\n\n async appendAssistantMessage(content: string): Promise<void> {\n await this.append(content, \"assistant\");\n }\n\n async appendToolMessage(content: string): Promise<void> {\n await this.append(content, \"tool\");\n }\n\n private async append(content: string, role: Z3rnoMessageRole): Promise<void> {\n const memory = await this.client.store({\n agentId: this.agentId,\n content,\n memoryType: \"episodic\",\n metadata: { role },\n relationships: [],\n });\n if (this.conversationId) {\n await this.client.addTurn(this.conversationId, {\n memoryId: memory.id,\n turnRole: role,\n });\n }\n }\n\n private normaliseRole(raw: string | undefined): Z3rnoMessageRole {\n switch (raw) {\n case \"assistant\":\n case \"ai\":\n return \"assistant\";\n case \"system\":\n return \"system\";\n case \"tool\":\n return \"tool\";\n default:\n return \"user\";\n }\n }\n}\n","/**\n * Mastra adapter for Z3rno (Phase G slice 3).\n *\n * Mastra exposes a `MastraMemory`-shaped interface — see\n * https://mastra.ai/docs/agents/memory. This adapter implements\n * the same surface (`getMessages` / `addMessage` / `clear`) using\n * Z3rno conversations as the backing store.\n *\n * Zero hard dependency on the `@mastra/core` package — we provide\n * the typed surface and Mastra's runtime accepts any conforming\n * object.\n */\n\nimport type { Z3rnoClient } from \"../client.js\";\n\nexport type MastraRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\nexport interface MastraMessage {\n role: MastraRole;\n content: string;\n threadId?: string;\n resourceId?: string;\n}\n\nexport interface Z3rnoMastraMemoryOptions {\n client: Z3rnoClient;\n agentId: string;\n /** Mastra's thread is Z3rno's conversation; supply or look up by threadId. */\n conversationId?: string;\n topK?: number;\n}\n\n/**\n * Mastra-compatible memory backed by Z3rno conversations. Plug into\n * a Mastra `Agent`:\n *\n * const memory = new Z3rnoMastraMemory({ client, agentId, conversationId });\n * const agent = new Agent({ name: \"support\", memory });\n */\nexport class Z3rnoMastraMemory {\n private readonly client: Z3rnoClient;\n private readonly agentId: string;\n private readonly conversationId: string | undefined;\n private readonly topK: number;\n\n constructor(options: Z3rnoMastraMemoryOptions) {\n this.client = options.client;\n this.agentId = options.agentId;\n this.conversationId = options.conversationId;\n this.topK = options.topK ?? 50;\n }\n\n /** Mastra contract: return ordered prior messages for the thread. */\n async getMessages(_args?: { limit?: number }): Promise<MastraMessage[]> {\n const limit = _args?.limit ?? this.topK;\n if (this.conversationId) {\n const page = await this.client.listTurns(this.conversationId, { limit });\n return page.turns.map((t) => ({\n role: this.normaliseRole(t.turn_role),\n content: t.content,\n threadId: this.conversationId,\n }));\n }\n const resp = await this.client.recall({\n agentId: this.agentId,\n topK: limit,\n memoryType: \"episodic\",\n });\n const reversed = [...resp.results].reverse();\n return reversed.map((r) => ({\n role: this.normaliseRole(\n ((r.metadata as Record<string, unknown> | undefined) ?? {})[\n \"role\"\n ] as string | undefined,\n ),\n content: r.content,\n }));\n }\n\n /** Mastra contract: persist one message. */\n async addMessage(message: MastraMessage): Promise<void> {\n const memory = await this.client.store({\n agentId: this.agentId,\n content: message.content,\n memoryType: \"episodic\",\n metadata: { role: message.role },\n relationships: [],\n });\n if (this.conversationId) {\n await this.client.addTurn(this.conversationId, {\n memoryId: memory.id,\n turnRole: message.role,\n });\n }\n }\n\n /**\n * Mastra `clear()` — deliberate no-op. Z3rno keeps the source of\n * truth and recall is already scoped per conversation; flushing\n * the thread would risk losing audit-relevant history.\n */\n async clear(): Promise<void> {\n return;\n }\n\n private normaliseRole(raw: string | undefined): MastraRole {\n switch (raw) {\n case \"assistant\":\n case \"ai\":\n return \"assistant\";\n case \"system\":\n return \"system\";\n case \"tool\":\n return \"tool\";\n default:\n return \"user\";\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/models.ts","../src/client.ts","../src/integrations/vercel-ai.ts","../src/integrations/mastra.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Z3rno SDK error hierarchy.\n *\n * All errors thrown by the SDK extend {@link Z3rnoError}, which itself extends\n * the built-in `Error` class. This lets callers catch broadly (`Z3rnoError`)\n * or narrowly (`AuthenticationError`, `RateLimitError`, etc.).\n *\n * @module errors\n */\n\n/**\n * Base error class for all Z3rno SDK errors.\n *\n * Every error produced by the SDK is an instance of this class, so you can\n * use a single `catch (e) { if (e instanceof Z3rnoError) ... }` guard to\n * handle them all.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoError) {\n * console.error(`Z3rno error (${e.statusCode}): ${e.message}`);\n * }\n * }\n * ```\n */\nexport class Z3rnoError extends Error {\n /** HTTP status code returned by the server, if applicable. */\n statusCode?: number;\n\n /**\n * @param message - Human-readable description of the error.\n * @param statusCode - HTTP status code associated with the error, if any.\n */\n constructor(message: string, statusCode?: number) {\n super(message);\n this.name = \"Z3rnoError\";\n this.statusCode = statusCode;\n }\n}\n\n/**\n * Thrown when the API key is missing, invalid, or revoked (HTTP 401).\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof AuthenticationError) {\n * console.error(\"Check your API key\");\n * }\n * }\n * ```\n */\nexport class AuthenticationError extends Z3rnoError {\n /**\n * @param message - Description of the authentication failure.\n */\n constructor(message: string) {\n super(message, 401);\n this.name = \"AuthenticationError\";\n }\n}\n\n/**\n * Thrown when the client exceeds the API rate limit (HTTP 429).\n *\n * The {@link retryAfter} property indicates how many seconds to wait\n * before retrying, as reported by the server's `Retry-After` header.\n *\n * @example\n * ```ts\n * try {\n * await client.recall({ agentId: \"...\", query: \"...\" });\n * } catch (e) {\n * if (e instanceof RateLimitError) {\n * console.log(`Retry after ${e.retryAfter} seconds`);\n * }\n * }\n * ```\n */\nexport class RateLimitError extends Z3rnoError {\n /** Number of seconds to wait before retrying, per the Retry-After header. */\n retryAfter: number;\n\n /**\n * @param message - Description of the rate-limit error.\n * @param retryAfter - Seconds to wait before retrying (defaults to 60).\n */\n constructor(message: string, retryAfter: number = 60) {\n super(message, 429);\n this.name = \"RateLimitError\";\n this.retryAfter = retryAfter;\n }\n}\n\n/**\n * Thrown when the server rejects the request due to invalid input (HTTP 400 or 422).\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"not-a-uuid\", content: \"\" });\n * } catch (e) {\n * if (e instanceof ValidationError) {\n * console.error(`Validation failed: ${e.message}`);\n * }\n * }\n * ```\n */\nexport class ValidationError extends Z3rnoError {\n /**\n * @param message - Description of the validation failure.\n * @param statusCode - HTTP status code (400 or 422, defaults to 400).\n */\n constructor(message: string, statusCode: number = 400) {\n super(message, statusCode);\n this.name = \"ValidationError\";\n }\n}\n\n/**\n * Thrown when the requested resource does not exist (HTTP 404).\n *\n * @example\n * ```ts\n * try {\n * await client.getMemory(\"non-existent-id\");\n * } catch (e) {\n * if (e instanceof NotFoundError) {\n * console.error(\"Memory not found\");\n * }\n * }\n * ```\n */\nexport class NotFoundError extends Z3rnoError {\n /**\n * @param message - Description of what was not found.\n */\n constructor(message: string) {\n super(message, 404);\n this.name = \"NotFoundError\";\n }\n}\n\n/**\n * Thrown when the Z3rno API returns a server-side error (HTTP 5xx).\n *\n * The SDK automatically retries on 5xx errors with exponential backoff.\n * This error is only thrown after all retries are exhausted.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof ServerError) {\n * console.error(`Server error (${e.statusCode}): ${e.message}`);\n * }\n * }\n * ```\n */\nexport class ServerError extends Z3rnoError {\n /**\n * @param message - Description of the server error.\n * @param statusCode - HTTP status code (defaults to 500).\n */\n constructor(message: string, statusCode: number = 500) {\n super(message, statusCode);\n this.name = \"ServerError\";\n }\n}\n\n/**\n * Thrown when a request exceeds the configured timeout duration.\n *\n * The SDK uses an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}\n * to enforce timeouts. This error is thrown after all retries are exhausted.\n *\n * @example\n * ```ts\n * const client = new Z3rnoClient({ timeout: 5000 }); // 5 seconds\n * try {\n * await client.recall({ agentId: \"...\", query: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoTimeoutError) {\n * console.error(`Timed out after ${e.timeout}ms`);\n * }\n * }\n * ```\n */\nexport class Z3rnoTimeoutError extends Z3rnoError {\n /** The timeout duration in milliseconds that was exceeded. */\n timeout: number;\n\n /**\n * @param message - Description of the timeout.\n * @param timeout - The configured timeout value in milliseconds.\n */\n constructor(message: string, timeout: number) {\n super(message, undefined);\n this.name = \"Z3rnoTimeoutError\";\n this.timeout = timeout;\n }\n}\n\n/**\n * Thrown when the SDK cannot establish a connection to the Z3rno API.\n *\n * This typically indicates a network issue, DNS failure, or the server\n * being unreachable. The SDK retries connection errors with exponential\n * backoff before throwing this error.\n *\n * @example\n * ```ts\n * try {\n * await client.store({ agentId: \"...\", content: \"...\" });\n * } catch (e) {\n * if (e instanceof Z3rnoConnectionError) {\n * console.error(\"Cannot reach Z3rno API — check your network\");\n * }\n * }\n * ```\n */\nexport class Z3rnoConnectionError extends Z3rnoError {\n /**\n * @param message - Description of the connection failure.\n */\n constructor(message: string) {\n super(message, undefined);\n this.name = \"Z3rnoConnectionError\";\n }\n}\n","/**\n * Zod schemas and inferred TypeScript types for the Z3rno API.\n *\n * Each export is a dual: a Zod schema (used for runtime validation) and an\n * identically-named TypeScript type (used at compile time). Request schemas\n * validate client-side input; response schemas validate server payloads.\n *\n * @module models\n */\n\nimport { z } from \"zod\";\n\n// --- Enums ---\n\n/**\n * Memory type enum.\n *\n * Controls how a memory is stored, indexed, and decayed.\n *\n * - `working` — Short-lived scratchpad memory (high decay rate).\n * - `episodic` — Event-based memory tied to a specific interaction.\n * - `semantic` — Long-term factual knowledge.\n * - `procedural` — How-to or process knowledge.\n */\nexport const MemoryType = z.enum([\n \"working\",\n \"episodic\",\n \"semantic\",\n \"procedural\",\n]);\n\n/** Memory type: `\"working\"` | `\"episodic\"` | `\"semantic\"` | `\"procedural\"`. */\nexport type MemoryType = z.infer<typeof MemoryType>;\n\n/**\n * Relationship type enum.\n *\n * Describes how two memories are related in the knowledge graph.\n *\n * - `derived_from` — This memory was created from another.\n * - `contradicts` — This memory conflicts with another.\n * - `supports` — This memory reinforces another.\n * - `supersedes` — This memory replaces another.\n * - `related_to` — General association.\n * - `caused_by` — Causal relationship.\n */\nexport const RelationshipType = z.enum([\n \"derived_from\",\n \"contradicts\",\n \"supports\",\n \"supersedes\",\n \"related_to\",\n \"caused_by\",\n]);\n\n/** Relationship type between two memories. */\nexport type RelationshipType = z.infer<typeof RelationshipType>;\n\n/**\n * Retrieval strategy for `recall({ strategy: ... })` — Phase C.\n *\n * `AUTO` is the default; the server's LLM router picks one of the\n * others when configured. Use an explicit value to bypass routing.\n */\nexport const RetrievalStrategy = z.enum([\n \"AUTO\",\n \"VECTOR\",\n \"LEXICAL\",\n \"GRAPH\",\n \"TRIPLET\",\n \"TRACE\",\n \"TEMPORAL\",\n \"ASK\",\n \"CYPHER\",\n]);\n\n/** Retrieval strategy enum (canonical UPPERCASE names). */\nexport type RetrievalStrategy = z.infer<typeof RetrievalStrategy>;\n\n// --- Request schemas ---\n\n/**\n * Schema for storing a new memory.\n *\n * @example\n * ```ts\n * const request = StoreMemoryRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * memoryType: \"semantic\",\n * });\n * ```\n */\nexport const StoreMemoryRequest = z.object({\n /** UUID of the agent that owns this memory. */\n agentId: z.string().uuid(),\n /** The text content to store (1 to 100,000 characters). */\n content: z.string().min(1).max(100000),\n /** Category of memory. Defaults to `\"episodic\"`. */\n memoryType: MemoryType.default(\"episodic\"),\n /** Optional UUID of the user associated with this memory. */\n userId: z.string().uuid().optional(),\n /** Arbitrary key-value metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n /** Relationships to other memories in the knowledge graph. */\n relationships: z\n .array(\n z.object({\n /** UUID of the target memory. */\n targetMemoryId: z.string().uuid(),\n /** Type of relationship to the target memory. */\n relationshipType: RelationshipType,\n /** Relationship strength from 0 to 1. Defaults to 1.0. */\n weight: z.number().min(0).max(1).default(1.0),\n /** Arbitrary metadata for the relationship edge. */\n metadata: z.record(z.unknown()).default({}),\n }),\n )\n .default([]),\n /** Time-to-live in seconds. Memory auto-deletes after this duration. */\n ttlSeconds: z.number().int().positive().optional(),\n /** Importance score from 0 to 1. Influences recall ranking. */\n importance: z.number().min(0).max(1).optional(),\n});\n\n/** Parsed type for a store-memory request. */\nexport type StoreMemoryRequest = z.infer<typeof StoreMemoryRequest>;\n\n/**\n * Schema for recalling memories by semantic similarity.\n *\n * @example\n * ```ts\n * const request = RecallRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * topK: 5,\n * });\n * ```\n */\nexport const RecallRequest = z.object({\n /** UUID of the agent whose memories to search. */\n agentId: z.string().uuid(),\n /** Natural-language query for semantic similarity search. */\n query: z.string().optional(),\n /** Filter results to a specific memory type. */\n memoryType: z.string().optional(),\n /** Additional metadata filters. */\n filters: z.record(z.unknown()).optional(),\n /** Maximum number of results to return (1-100, default 10). */\n topK: z.number().int().min(1).max(100).default(10),\n /** Minimum similarity score threshold (0-1, default 0). */\n similarityThreshold: z.number().min(0).max(1).default(0),\n /** ISO 8601 timestamp for temporal queries (point-in-time recall). */\n asOf: z.string().datetime().optional(),\n /** Whether to include soft-deleted memories. */\n includeDeleted: z.boolean().default(false),\n /**\n * Phase C retrieval strategy. `AUTO` (default) lets the server's\n * LLM router pick the best fit. See {@link RetrievalStrategy}.\n */\n strategy: RetrievalStrategy.default(\"AUTO\"),\n /**\n * Phase C cross-encoder re-ranking. When `true`, the server\n * re-ranks the top results via a cross-encoder. Requires the\n * `sentence-transformers` extra on the server.\n */\n rerank: z.boolean().default(false),\n});\n\n/** Parsed type for a recall request. */\nexport type RecallRequest = z.infer<typeof RecallRequest>;\n\n/**\n * Schema for forgetting (deleting) memories.\n *\n * @example\n * ```ts\n * const request = ForgetRequest.parse({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * memoryId: \"mem-123\",\n * hardDelete: true,\n * });\n * ```\n */\nexport const ForgetRequest = z.object({\n /** UUID of the agent that owns the memories. */\n agentId: z.string().uuid(),\n /** UUID of a single memory to delete. */\n memoryId: z.string().uuid().optional(),\n /** UUIDs of multiple memories to delete in one call. */\n memoryIds: z.array(z.string().uuid()).optional(),\n /** If true, permanently deletes (vs. soft-delete). Defaults to false. */\n hardDelete: z.boolean().default(false),\n /** If true, also deletes related memories. Defaults to false. */\n cascade: z.boolean().default(false),\n /** Optional reason for the deletion (stored in audit log). */\n reason: z.string().optional(),\n});\n\n/** Parsed type for a forget request. */\nexport type ForgetRequest = z.infer<typeof ForgetRequest>;\n\n// --- Response schemas ---\n\n/**\n * Schema for a single memory object returned by the API.\n *\n * Used by {@link Z3rnoClient.store}, {@link Z3rnoClient.getMemory}, and\n * {@link Z3rnoClient.updateMemory}.\n */\nexport const MemoryResponse = z.object({\n /** Unique identifier for this memory. */\n id: z.string(),\n /** UUID of the owning agent. */\n agent_id: z.string(),\n /** Text content of the memory. */\n content: z.string(),\n /** Category of the memory. */\n memory_type: z.string(),\n /** Server-computed importance score (0-1). */\n importance_score: z.number(),\n /** Number of times this memory has been recalled. */\n recall_count: z.number(),\n /** Name of the embedding model used, if any. */\n embedding_model: z.string().nullable().optional(),\n /** ISO 8601 creation timestamp. */\n created_at: z.string(),\n /** Arbitrary metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a memory response. */\nexport type MemoryResponse = z.infer<typeof MemoryResponse>;\n\n/**\n * Schema for a single item in recall results.\n *\n * Each item includes similarity, importance, and relevance scores\n * computed by the server's ranking algorithm.\n */\nexport const RecallResultItem = z.object({\n /** Unique identifier of the recalled memory. */\n memory_id: z.string(),\n /** Text content of the memory. */\n content: z.string(),\n /** Optional server-generated summary. */\n summary: z.string().nullable().optional(),\n /** Category of the memory. */\n memory_type: z.string(),\n /** Cosine similarity to the query (0-1). */\n similarity_score: z.number(),\n /** Server-computed importance score (0-1). */\n importance_score: z.number(),\n /** Combined relevance score used for ranking (0-1). */\n relevance_score: z.number(),\n /** Number of times this memory has been recalled. */\n recall_count: z.number(),\n /** ISO 8601 creation timestamp. */\n created_at: z.string(),\n /** Arbitrary metadata attached to the memory. */\n metadata: z.record(z.unknown()).default({}),\n /**\n * Phase C per-source signals — e.g. `{ vector: 0.83, lexical: 0.61 }`.\n * Optional so older servers (v0.7.x) keep parsing.\n */\n score_components: z.record(z.number()).default({}),\n});\n\n/** Parsed type for a single recall result item. */\nexport type RecallResultItem = z.infer<typeof RecallResultItem>;\n\n/**\n * Schema for the full recall response.\n *\n * Contains an array of ranked results and the total count of matches.\n */\nexport const RecallResponse = z.object({\n /** Ranked list of matching memories. */\n results: z.array(RecallResultItem),\n /** Total number of matches (may exceed `topK`). */\n total: z.number(),\n /** The query that was searched, if any. */\n query: z.string().nullable().optional(),\n /** Phase C: strategy that actually ran (after AUTO routing + re-rank). */\n strategy_used: z.string().default(\"VECTOR\"),\n /** Phase C: AUTO's candidate list (e.g. `[\"AUTO->GRAPH\"]`). */\n strategies_considered: z.array(z.string()).default([]),\n /** Phase C: whether the cross-encoder re-rank ran. */\n reranked: z.boolean().default(false),\n /** Phase C: end-to-end recall latency on the server (ms). */\n elapsed_ms: z.number().default(0),\n});\n\n/** Parsed type for a recall response. */\nexport type RecallResponse = z.infer<typeof RecallResponse>;\n\n/**\n * Schema for the forget (delete) response.\n *\n * Reports how many memories were deleted and whether cascade was applied.\n */\nexport const ForgetResponse = z.object({\n /** Number of memories deleted. */\n deleted_count: z.number(),\n /** Whether a hard delete was performed. */\n hard_deleted: z.boolean(),\n /** Number of related memories deleted via cascade. */\n cascade_count: z.number(),\n /** IDs of all deleted memories. */\n memory_ids: z.array(z.string()),\n});\n\n/** Parsed type for a forget response. */\nexport type ForgetResponse = z.infer<typeof ForgetResponse>;\n\n/**\n * Schema for a single audit log entry.\n *\n * Audit entries record every operation performed on the agent's memories.\n */\nexport const AuditEntry = z\n .object({\n /** Auto-incrementing audit entry ID. */\n id: z.number(),\n /** UUID of the agent, if applicable. */\n agent_id: z.string().nullable().optional(),\n /** UUID of the user, if applicable. */\n user_id: z.string().nullable().optional(),\n /** Operation type (e.g., `\"store\"`, `\"recall\"`, `\"forget\"`). */\n operation: z.string(),\n /** UUID of the affected memory, if applicable. */\n memory_id: z.string().nullable().optional(),\n /** Memory type of the affected memory, if applicable. */\n memory_type: z.string().nullable().optional(),\n /** Additional details about the operation. */\n details: z.record(z.unknown()).default({}),\n /** IP address of the caller, if available. */\n ip_address: z.string().nullable().optional(),\n /** ISO 8601 timestamp of the operation. */\n created_at: z.string(),\n })\n .transform((data) => ({\n ...data,\n /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */\n timestamp: data.created_at,\n }));\n\n/** Parsed type for an audit entry. */\nexport type AuditEntry = z.infer<typeof AuditEntry>;\n\n/**\n * Schema for a paginated audit log response.\n *\n * Supports cursor-based pagination via `page` and `page_size`.\n */\nexport const AuditPageResponse = z\n .object({\n /** Audit entries on this page. */\n entries: z.array(AuditEntry),\n /** Total number of matching audit entries. */\n total: z.number(),\n /** Current page number (1-indexed). */\n page: z.number(),\n /** Number of entries per page. */\n page_size: z.number(),\n /** Whether more pages are available. */\n has_next: z.boolean(),\n })\n .transform((data) => ({\n ...data,\n /** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */\n total_count: data.total,\n }));\n\n/** Parsed type for a paginated audit response. */\nexport type AuditPageResponse = z.infer<typeof AuditPageResponse>;\n\n// --- Batch Store ---\n\n/**\n * Schema for the batch store response.\n *\n * Returned by {@link Z3rnoClient.storeBatch} after storing multiple memories.\n */\nexport const BatchStoreResponse = z.object({\n /** Array of stored memory objects. */\n results: z.array(MemoryResponse),\n /** Number of memories successfully stored. */\n stored_count: z.number(),\n});\n\n/** Parsed type for a batch store response. */\nexport type BatchStoreResponse = z.infer<typeof BatchStoreResponse>;\n\n// --- Memory History ---\n\n/**\n * Schema for a single version of a memory (temporal versioning).\n *\n * Each version represents the state of a memory during a specific time range.\n */\nexport const MemoryVersion = z.object({\n /** Version identifier. */\n id: z.string(),\n /** Text content at this version. */\n content: z.string(),\n /** Memory type at this version. */\n memory_type: z.string(),\n /** Importance score at this version. */\n importance_score: z.number(),\n /** ISO 8601 timestamp when this version became active. */\n valid_from: z.string(),\n /** ISO 8601 timestamp when this version was superseded, or null if current. */\n valid_to: z.string().nullable().optional(),\n /** Metadata at this version. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a memory version. */\nexport type MemoryVersion = z.infer<typeof MemoryVersion>;\n\n/**\n * Schema for the memory history response.\n *\n * Contains all temporal versions of a single memory, ordered chronologically.\n */\nexport const MemoryHistoryResponse = z.object({\n /** UUID of the memory. */\n memory_id: z.string(),\n /** Chronologically ordered list of versions. */\n versions: z.array(MemoryVersion),\n /** Total number of versions. */\n total: z.number(),\n});\n\n/** Parsed type for a memory history response. */\nexport type MemoryHistoryResponse = z.infer<typeof MemoryHistoryResponse>;\n\n// --- Sessions ---\n\n/**\n * Schema for a session response.\n *\n * Sessions group related memory operations (e.g., a conversation turn).\n */\nexport const SessionResponse = z.object({\n /** Unique session identifier. */\n session_id: z.string(),\n /** UUID of the agent this session belongs to. */\n agent_id: z.string(),\n /** Type of session (e.g., `\"conversation\"`). */\n session_type: z.string(),\n /** ISO 8601 timestamp when the session started. */\n started_at: z.string(),\n /** Arbitrary session metadata. */\n metadata: z.record(z.unknown()).default({}),\n});\n\n/** Parsed type for a session response. */\nexport type SessionResponse = z.infer<typeof SessionResponse>;\n\n/**\n * Schema for the end-session response.\n *\n * Returned when a session is closed, including summary statistics.\n */\nexport const EndSessionResponse = z.object({\n /** The session that was ended. */\n session_id: z.string(),\n /** ISO 8601 timestamp when the session ended. */\n ended_at: z.string(),\n /** Total duration of the session in seconds. */\n duration_seconds: z.number(),\n /** Number of memories created during the session. */\n memory_count: z.number(),\n});\n\n/** Parsed type for an end-session response. */\nexport type EndSessionResponse = z.infer<typeof EndSessionResponse>;\n\n// ---------------------------------------------------------------------------\n// Forge verbs — ingest / distill / refine (Phase A / B / D)\n// ---------------------------------------------------------------------------\n\n/** Response to POST /v1/ingest — the enqueue ack. */\nexport const IngestJobResponse = z.object({\n job_id: z.string(),\n kind: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n enqueued_at: z.string(),\n});\n\nexport type IngestJobResponse = z.infer<typeof IngestJobResponse>;\n\n/** Full state from GET /v1/ingest/{job_id}. */\nexport const IngestJobStatusResponse = z.object({\n job_id: z.string(),\n agent_id: z.string(),\n dataset_id: z.string().nullable().optional(),\n kind: z.string(),\n status: z.string(),\n source_uri: z.string().nullable().optional(),\n content_type: z.string().nullable().optional(),\n filename: z.string().nullable().optional(),\n file_size: z.number().nullable().optional(),\n memory_ids: z.array(z.string()).default([]),\n memos_written: z.number().default(0),\n distill_job_id: z.string().nullable().optional(),\n codegraph_memos_written: z.number().default(0),\n codegraph_edges_written: z.number().default(0),\n error: z.string().nullable().optional(),\n warnings: z.array(z.record(z.unknown())).default([]),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type IngestJobStatusResponse = z.infer<typeof IngestJobStatusResponse>;\n\n/** Distill enqueue ack. */\nexport const DistillJobResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n memory_ids: z.array(z.string()),\n enqueued_at: z.string(),\n});\n\nexport type DistillJobResponse = z.infer<typeof DistillJobResponse>;\n\n/** Full distill job state. */\nexport const DistillJobStatusResponse = z.object({\n job_id: z.string(),\n agent_id: z.string(),\n status: z.string(),\n model: z.string(),\n memory_ids: z.array(z.string()),\n chunk_size: z.number(),\n chunk_overlap: z.number(),\n max_concurrency: z.number(),\n chunks_total: z.number(),\n chunks_failed: z.number(),\n entities_extracted: z.number(),\n relationships_extracted: z.number(),\n memos_written: z.number(),\n error: z.string().nullable().optional(),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type DistillJobStatusResponse = z.infer<typeof DistillJobStatusResponse>;\n\n/** Refine enqueue ack. */\nexport const RefineJobResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n enqueued_at: z.string(),\n});\n\nexport type RefineJobResponse = z.infer<typeof RefineJobResponse>;\n\n/** Full refine job state. */\nexport const RefineJobStatusResponse = z.object({\n job_id: z.string(),\n status: z.string(),\n dataset_id: z.string().nullable().optional(),\n trigger: z.string(),\n memos_scanned: z.number().default(0),\n memos_deduped: z.number().default(0),\n edges_reweighted: z.number().default(0),\n edges_pruned: z.number().default(0),\n feedback_drained: z.number().default(0),\n job_metadata: z.record(z.unknown()).default({}),\n error: z.string().nullable().optional(),\n started_at: z.string().nullable().optional(),\n completed_at: z.string().nullable().optional(),\n created_at: z.string().nullable().optional(),\n updated_at: z.string().nullable().optional(),\n});\n\nexport type RefineJobStatusResponse = z.infer<typeof RefineJobStatusResponse>;\n\n\n// ---------------------------------------------------------------------------\n// Conversations — Phase G slice 2\n// ---------------------------------------------------------------------------\n\n/** Conversation metadata. */\nexport const ConversationResponse = z.object({\n id: z.string(),\n agent_id: z.string(),\n user_id: z.string().nullable().optional(),\n title: z.string().nullable().optional(),\n summary_cadence: z.number(),\n turn_count: z.number(),\n last_summary_turn: z.number(),\n metadata: z.record(z.unknown()).default({}),\n created_at: z.string(),\n updated_at: z.string(),\n});\n\nexport type ConversationResponse = z.infer<typeof ConversationResponse>;\n\n/** Result of POST /v1/conversations/{id}/turns. */\nexport const TurnAddResponse = z.object({\n turn_index: z.number(),\n needs_summary: z.boolean(),\n});\n\nexport type TurnAddResponse = z.infer<typeof TurnAddResponse>;\n\n/** One turn within a conversation. */\nexport const TurnResponse = z.object({\n memory_id: z.string(),\n turn_index: z.number(),\n turn_role: z.string(),\n content: z.string(),\n created_at: z.string(),\n});\n\nexport type TurnResponse = z.infer<typeof TurnResponse>;\n\n/** Paginated turn list. */\nexport const TurnListResponse = z.object({\n turns: z.array(TurnResponse),\n total: z.number(),\n conversation_id: z.string(),\n});\n\nexport type TurnListResponse = z.infer<typeof TurnListResponse>;\n\n\n// ---------------------------------------------------------------------------\n// Tenant budgets — v0.20.3\n// ---------------------------------------------------------------------------\n\n/** Per-tenant budget caps. Zero means inherit server default. */\nexport const TenantBudgets = z.object({\n daily_tokens: z.number(),\n daily_llm_calls: z.number(),\n daily_embeddings: z.number(),\n monthly_tokens: z.number(),\n monthly_llm_calls: z.number(),\n monthly_embeddings: z.number(),\n});\n\nexport type TenantBudgets = z.infer<typeof TenantBudgets>;\n\n/** Server response: stored overrides + resolved effective caps. */\nexport const TenantBudgetsView = z.object({\n overrides: TenantBudgets,\n effective: TenantBudgets,\n});\n\nexport type TenantBudgetsView = z.infer<typeof TenantBudgetsView>;\n","/**\n * Z3rno TypeScript SDK client.\n *\n * Thin fetch wrapper — no database drivers, no embedding providers.\n * Works in Node.js 18+, Deno, Bun, and modern browsers (any runtime\n * with a global `fetch` and `AbortController`).\n *\n * @module client\n *\n * @example\n * ```ts\n * const client = new Z3rnoClient({ baseUrl: \"http://localhost:8000\", apiKey: \"z3rno_sk_...\" });\n * const memory = await client.store({ agentId: \"agent-1\", content: \"User prefers dark mode\" });\n * const results = await client.recall({ agentId: \"agent-1\", query: \"user preferences\" });\n * await client.forget({ agentId: \"agent-1\", memoryId: memory.id });\n * ```\n */\n\nimport {\n AuthenticationError,\n NotFoundError,\n RateLimitError,\n ServerError,\n ValidationError,\n Z3rnoConnectionError,\n Z3rnoError,\n Z3rnoTimeoutError,\n} from \"./errors.js\";\nimport type {\n AuditPageResponse,\n BatchStoreResponse,\n ConversationResponse,\n DistillJobResponse,\n DistillJobStatusResponse,\n EndSessionResponse,\n ForgetResponse,\n IngestJobResponse,\n IngestJobStatusResponse,\n MemoryHistoryResponse,\n MemoryResponse,\n RecallResponse,\n RefineJobResponse,\n RefineJobStatusResponse,\n SessionResponse,\n StoreMemoryRequest,\n TenantBudgets,\n TenantBudgetsView,\n TurnAddResponse,\n TurnListResponse,\n} from \"./models.js\";\nimport {\n AuditPageResponse as AuditPageSchema,\n BatchStoreResponse as BatchStoreSchema,\n ConversationResponse as ConversationSchema,\n DistillJobResponse as DistillJobSchema,\n DistillJobStatusResponse as DistillJobStatusSchema,\n EndSessionResponse as EndSessionSchema,\n ForgetResponse as ForgetSchema,\n IngestJobResponse as IngestJobSchema,\n IngestJobStatusResponse as IngestJobStatusSchema,\n MemoryHistoryResponse as MemoryHistorySchema,\n MemoryResponse as MemorySchema,\n RecallResponse as RecallSchema,\n RefineJobResponse as RefineJobSchema,\n RefineJobStatusResponse as RefineJobStatusSchema,\n SessionResponse as SessionSchema,\n TenantBudgetsView as TenantBudgetsViewSchema,\n TurnAddResponse as TurnAddSchema,\n TurnListResponse as TurnListSchema,\n} from \"./models.js\";\n\n/**\n * Configuration options for the {@link Z3rnoClient}.\n *\n * All fields are optional. When omitted, the client reads from environment\n * variables (`Z3RNO_BASE_URL`, `Z3RNO_API_KEY`) or uses sensible defaults.\n */\nexport interface Z3rnoClientConfig {\n /**\n * Base URL of the Z3rno API.\n *\n * Falls back to the `Z3RNO_BASE_URL` environment variable, then\n * to `\"https://api.z3rno.dev\"`.\n */\n baseUrl?: string;\n\n /**\n * API key for authentication.\n *\n * Falls back to the `Z3RNO_API_KEY` environment variable, then to\n * an empty string (unauthenticated).\n */\n apiKey?: string;\n\n /**\n * Request timeout in milliseconds.\n *\n * @defaultValue 30000 (30 seconds)\n */\n timeout?: number;\n\n /**\n * Maximum number of retry attempts for retryable errors (5xx, 429,\n * network failures, timeouts).\n *\n * @defaultValue 3\n */\n maxRetries?: number;\n\n /**\n * Custom fetch implementation.\n *\n * Defaults to `globalThis.fetch`. Override to use `undici`, `node-fetch`,\n * or a test double.\n *\n * @defaultValue globalThis.fetch\n */\n fetch?: typeof globalThis.fetch;\n\n /**\n * Intercept outgoing requests before they are sent.\n *\n * Use this to add custom headers, log requests, or collect metrics.\n * The callback receives the URL and the `RequestInit` and must return\n * a (possibly modified) `RequestInit`.\n */\n onRequest?: (url: string, init: RequestInit) => RequestInit;\n\n /**\n * Intercept responses before they are processed.\n *\n * Use this for logging, metrics, or response transformation.\n * The callback receives the `Response` and must return a `Response`.\n */\n onResponse?: (response: Response) => Response;\n}\n\n/**\n * Client for the Z3rno AI agent memory API.\n *\n * Uses the standard Fetch API under the hood, making it compatible with\n * Node.js 18+, Deno, Bun, and modern browsers. All responses are\n * validated at runtime with Zod schemas.\n *\n * @example\n * ```ts\n * import { Z3rnoClient } from \"@z3rno/sdk\";\n *\n * const client = new Z3rnoClient({\n * baseUrl: \"http://localhost:8000\",\n * apiKey: \"z3rno_sk_test_...\",\n * });\n *\n * // Store a memory\n * const mem = await client.store({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * });\n *\n * // Recall relevant memories\n * const results = await client.recall({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * });\n * ```\n */\nexport class Z3rnoClient {\n private baseUrl: string;\n private apiKey: string;\n private timeout: number;\n private maxRetries: number;\n private fetchImpl: typeof globalThis.fetch;\n private onRequest?: (url: string, init: RequestInit) => RequestInit;\n private onResponse?: (response: Response) => Response;\n\n /**\n * Creates a new Z3rno client instance.\n *\n * @param config - Client configuration options. All fields are optional.\n *\n * @example\n * ```ts\n * // Explicit configuration\n * const client = new Z3rnoClient({\n * baseUrl: \"http://localhost:8000\",\n * apiKey: \"z3rno_sk_test_...\",\n * timeout: 10000,\n * maxRetries: 2,\n * });\n *\n * // Or rely on environment variables (Z3RNO_BASE_URL, Z3RNO_API_KEY)\n * const client = new Z3rnoClient();\n * ```\n */\n constructor(config: Z3rnoClientConfig = {}) {\n // Resolve baseUrl: explicit > env var > default\n let resolvedUrl = config.baseUrl ?? \"\";\n if (!resolvedUrl && typeof process !== \"undefined\" && process.env) {\n resolvedUrl = process.env.Z3RNO_BASE_URL ?? \"\";\n }\n if (!resolvedUrl) {\n resolvedUrl = \"https://api.z3rno.dev\";\n }\n this.baseUrl = resolvedUrl.replace(/\\/$/, \"\");\n\n // Resolve apiKey: explicit > env var > empty\n let resolvedKey = config.apiKey ?? \"\";\n if (!resolvedKey && typeof process !== \"undefined\" && process.env) {\n resolvedKey = process.env.Z3RNO_API_KEY ?? \"\";\n }\n this.apiKey = resolvedKey;\n\n this.timeout = config.timeout ?? 30000;\n this.maxRetries = config.maxRetries ?? 3;\n this.fetchImpl = config.fetch ?? globalThis.fetch;\n this.onRequest = config.onRequest;\n this.onResponse = config.onResponse;\n }\n\n // --- Store ---\n\n /**\n * Stores a new memory for an agent.\n *\n * The server generates an embedding for the content and stores it in\n * the vector database. The memory is immediately available for recall.\n *\n * @param request - The memory to store.\n * @returns The stored memory, including the server-generated ID and scores.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link ValidationError} If the request body is invalid.\n * @throws {@link Z3rnoTimeoutError} If the request times out.\n *\n * @example\n * ```ts\n * const memory = await client.store({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * content: \"User prefers dark mode\",\n * memoryType: \"semantic\",\n * metadata: { source: \"settings-page\" },\n * });\n * console.log(memory.id); // \"mem-abc123\"\n * ```\n */\n async store(request: StoreMemoryRequest): Promise<MemoryResponse> {\n const body = {\n agent_id: request.agentId,\n content: request.content,\n memory_type: request.memoryType,\n user_id: request.userId,\n metadata: request.metadata,\n relationships: request.relationships?.map((r) => ({\n target_memory_id: r.targetMemoryId,\n relationship_type: r.relationshipType,\n weight: r.weight,\n metadata: r.metadata,\n })),\n ttl_seconds: request.ttlSeconds,\n importance: request.importance,\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories\", body);\n return MemorySchema.parse(resp);\n }\n\n // --- Recall ---\n\n /**\n * Recalls memories by semantic similarity to a query.\n *\n * Returns a ranked list of memories sorted by a combined relevance score\n * that factors in similarity, importance, and recency.\n *\n * @param params - Recall parameters including the query and filters.\n * @param params.agentId - UUID of the agent whose memories to search.\n * @param params.query - Natural-language query for semantic search.\n * @param params.memoryType - Filter by memory type.\n * @param params.filters - Additional metadata filters.\n * @param params.topK - Maximum results to return (default 10).\n * @param params.similarityThreshold - Minimum similarity score (default 0).\n * @returns Ranked recall results with similarity scores.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link Z3rnoTimeoutError} If the request times out.\n *\n * @example\n * ```ts\n * const results = await client.recall({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * query: \"user preferences\",\n * topK: 5,\n * similarityThreshold: 0.7,\n * });\n * for (const item of results.results) {\n * console.log(`${item.content} (score: ${item.relevance_score})`);\n * }\n * ```\n */\n async recall(params: {\n agentId: string;\n query?: string;\n memoryType?: string;\n /**\n * v0.21.2 — JSONB metadata containment filter\n * (`metadata @> :metadata_filter` server-side). Renamed from\n * `filters`; the old name is still accepted via `filters` below\n * but emits a deprecation warning.\n */\n metadataFilter?: Record<string, unknown>;\n /** @deprecated Use `metadataFilter` instead. */\n filters?: Record<string, unknown>;\n /**\n * v0.21.1 — scope by end-user id (the `memories.user_id`\n * column). Multi-user agents use this for per-user recall\n * isolation. Real WHERE predicate, not just audit context.\n */\n userId?: string;\n topK?: number;\n similarityThreshold?: number;\n /**\n * Phase C: retrieval strategy. One of `AUTO | VECTOR | LEXICAL |\n * GRAPH | TRIPLET | TRACE | TEMPORAL | ASK | CYPHER`. Default\n * `\"AUTO\"` — server's LLM router picks per query.\n */\n strategy?: string;\n /**\n * Phase C: cross-encoder re-ranking. When `true`, the server\n * re-ranks the strategy's top results. Requires\n * `sentence-transformers` on the server side.\n */\n rerank?: boolean;\n /**\n * Phase G slice 2: scope recall to a single conversation. Older\n * servers ignore the field.\n */\n conversationId?: string;\n }): Promise<RecallResponse> {\n // v0.21.2 — honour the deprecated `filters` alias.\n let metadataFilter = params.metadataFilter;\n if (params.filters !== undefined && metadataFilter === undefined) {\n if (typeof console !== \"undefined\" && console.warn) {\n console.warn(\n \"Z3rnoClient.recall({filters}) is deprecated; use {metadataFilter} instead.\",\n );\n }\n metadataFilter = params.filters;\n }\n\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n query: params.query,\n memory_type: params.memoryType,\n metadata_filter: metadataFilter,\n top_k: params.topK ?? 10,\n similarity_threshold: params.similarityThreshold ?? 0,\n // Always send strategy + rerank. Older servers silently ignore\n // unknown body fields.\n strategy: params.strategy ?? \"AUTO\",\n rerank: params.rerank ?? false,\n };\n if (params.userId) {\n body.user_id = params.userId;\n }\n if (params.conversationId) {\n body.conversation_id = params.conversationId;\n }\n\n const resp = await this.request(\"POST\", \"/v1/memories/recall\", body);\n return RecallSchema.parse(resp);\n }\n\n // --- Forget ---\n\n /**\n * Forgets (deletes) one or more memories.\n *\n * By default, performs a soft delete (marks as deleted but retains data).\n * Set `hardDelete: true` for permanent removal. Use `cascade: true` to\n * also delete related memories in the knowledge graph.\n *\n * @param params - Forget parameters.\n * @param params.agentId - UUID of the agent that owns the memories.\n * @param params.memoryId - UUID of a single memory to delete.\n * @param params.memoryIds - UUIDs of multiple memories to delete.\n * @param params.hardDelete - Permanently delete (default false).\n * @param params.cascade - Delete related memories too (default false).\n * @param params.reason - Reason for deletion (stored in audit log).\n * @returns Summary of the deletion operation.\n * @throws {@link AuthenticationError} If the API key is invalid.\n * @throws {@link NotFoundError} If the specified memory does not exist.\n *\n * @example\n * ```ts\n * const result = await client.forget({\n * agentId: \"550e8400-e29b-41d4-a716-446655440000\",\n * memoryId: \"mem-abc123\",\n * hardDelete: true,\n * reason: \"User requested data deletion\",\n * });\n * console.log(`Deleted ${result.deleted_count} memories`);\n * ```\n */\n async forget(params: {\n agentId: string;\n memoryId?: string;\n memoryIds?: string[];\n hardDelete?: boolean;\n cascade?: boolean;\n reason?: string;\n }): Promise<ForgetResponse> {\n const body = {\n agent_id: params.agentId,\n memory_id: params.memoryId,\n memory_ids: params.memoryIds,\n hard_delete: params.hardDelete ?? false,\n cascade: params.cascade ?? false,\n reason: params.reason,\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories/forget\", body);\n return ForgetSchema.parse(resp);\n }\n\n // --- Get Memory ---\n\n /**\n * Retrieves a single memory by its ID.\n *\n * @param memoryId - The unique identifier of the memory to retrieve.\n * @returns The full memory object.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const memory = await client.getMemory(\"mem-abc123\");\n * console.log(memory.content);\n * console.log(memory.importance_score);\n * ```\n */\n async getMemory(memoryId: string): Promise<MemoryResponse> {\n const resp = await this.request(\"GET\", `/v1/memories/${memoryId}`);\n return MemorySchema.parse(resp);\n }\n\n // --- Store Batch ---\n\n /**\n * Stores multiple memories in a single API call.\n *\n * More efficient than calling {@link store} in a loop. All memories are\n * processed atomically on the server.\n *\n * @param memories - Array of memories to store.\n * @returns The stored memories and a count of how many were created.\n * @throws {@link ValidationError} If any memory in the batch is invalid.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const result = await client.storeBatch([\n * { agentId: \"agent-1\", content: \"Fact one\" },\n * { agentId: \"agent-1\", content: \"Fact two\", memoryType: \"semantic\" },\n * ]);\n * console.log(`Stored ${result.stored_count} memories`);\n * ```\n */\n async storeBatch(\n memories: StoreMemoryRequest[],\n ): Promise<BatchStoreResponse> {\n const body = {\n memories: memories.map((m) => ({\n agent_id: m.agentId,\n content: m.content,\n memory_type: m.memoryType,\n metadata: m.metadata,\n importance: m.importance,\n })),\n };\n\n const resp = await this.request(\"POST\", \"/v1/memories/batch\", body);\n return BatchStoreSchema.parse(resp);\n }\n\n // --- Memory History ---\n\n /**\n * Retrieves the full version history of a memory.\n *\n * Z3rno uses temporal versioning — every update creates a new version\n * rather than overwriting. This method returns all versions ordered\n * chronologically.\n *\n * @param memoryId - The unique identifier of the memory.\n * @returns All versions of the memory with validity timestamps.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const history = await client.getMemoryHistory(\"mem-abc123\");\n * for (const version of history.versions) {\n * console.log(`${version.valid_from}: ${version.content}`);\n * }\n * ```\n */\n async getMemoryHistory(memoryId: string): Promise<MemoryHistoryResponse> {\n const resp = await this.request(\"GET\", `/v1/memories/${memoryId}/history`);\n return MemoryHistorySchema.parse(resp);\n }\n\n // --- Update Memory ---\n\n /**\n * Updates an existing memory's content, metadata, or importance.\n *\n * Creates a new temporal version of the memory. The previous version\n * remains accessible via {@link getMemoryHistory}.\n *\n * @param memoryId - The unique identifier of the memory to update.\n * @param updates - Fields to update (only provided fields are changed).\n * @param updates.content - New text content.\n * @param updates.metadata - New metadata (replaces existing metadata).\n * @param updates.importance - New importance score (0-1).\n * @returns The updated memory object.\n * @throws {@link NotFoundError} If no memory exists with the given ID.\n * @throws {@link ValidationError} If the update values are invalid.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const updated = await client.updateMemory(\"mem-abc123\", {\n * content: \"User now prefers light mode\",\n * importance: 0.9,\n * });\n * ```\n */\n async updateMemory(\n memoryId: string,\n updates: {\n content?: string;\n metadata?: Record<string, unknown>;\n importance?: number;\n },\n ): Promise<MemoryResponse> {\n const body: Record<string, unknown> = {};\n if (updates.content !== undefined) body.content = updates.content;\n if (updates.metadata !== undefined) body.metadata = updates.metadata;\n if (updates.importance !== undefined) body.importance = updates.importance;\n\n const resp = await this.request(\"PATCH\", `/v1/memories/${memoryId}`, body);\n return MemorySchema.parse(resp);\n }\n\n // --- Sessions ---\n\n /**\n * Starts a new session for grouping related memory operations.\n *\n * Sessions are useful for tracking conversation turns or task boundaries.\n * Memories created during a session are automatically associated with it.\n *\n * @param params - Session parameters.\n * @param params.agentId - UUID of the agent to start the session for.\n * @param params.sessionType - Type of session (default `\"conversation\"`).\n * @returns The created session with its ID and start time.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const session = await client.startSession({ agentId: \"agent-1\" });\n * console.log(`Session started: ${session.session_id}`);\n * // ... perform operations ...\n * await client.endSession(session.session_id);\n * ```\n */\n async startSession(params: {\n agentId: string;\n sessionType?: string;\n }): Promise<SessionResponse> {\n const body = {\n agent_id: params.agentId,\n session_type: params.sessionType ?? \"conversation\",\n };\n\n const resp = await this.request(\"POST\", \"/v1/sessions\", body);\n return SessionSchema.parse(resp);\n }\n\n /**\n * Ends an active session.\n *\n * Returns summary statistics including the session duration and the\n * number of memories created during the session.\n *\n * @param sessionId - The unique identifier of the session to end.\n * @returns Session summary with duration and memory count.\n * @throws {@link NotFoundError} If no active session exists with the given ID.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const summary = await client.endSession(\"sess-abc123\");\n * console.log(`Session lasted ${summary.duration_seconds}s, ${summary.memory_count} memories`);\n * ```\n */\n async endSession(sessionId: string): Promise<EndSessionResponse> {\n const resp = await this.request(\"POST\", `/v1/sessions/${sessionId}/end`);\n return EndSessionSchema.parse(resp);\n }\n\n // --- Audit ---\n\n /**\n * Retrieves a paginated audit log of memory operations.\n *\n * The audit log records every store, recall, forget, and update operation\n * performed by any agent. Useful for compliance, debugging, and analytics.\n *\n * @param params - Optional pagination and filter parameters.\n * @param params.agentId - Filter by agent UUID.\n * @param params.page - Page number (1-indexed).\n * @param params.pageSize - Number of entries per page.\n * @returns A page of audit log entries with pagination metadata.\n * @throws {@link AuthenticationError} If the API key is invalid.\n *\n * @example\n * ```ts\n * const page = await client.audit({ agentId: \"agent-1\", page: 1, pageSize: 20 });\n * for (const entry of page.entries) {\n * console.log(`${entry.created_at}: ${entry.operation} on ${entry.memory_id}`);\n * }\n * if (page.has_next) {\n * const nextPage = await client.audit({ agentId: \"agent-1\", page: 2 });\n * }\n * ```\n */\n async audit(params?: {\n agentId?: string;\n page?: number;\n pageSize?: number;\n }): Promise<AuditPageResponse> {\n const searchParams = new URLSearchParams();\n if (params?.agentId) searchParams.set(\"agent_id\", params.agentId);\n if (params?.page) searchParams.set(\"page\", String(params.page));\n if (params?.pageSize)\n searchParams.set(\"page_size\", String(params.pageSize));\n\n const query = searchParams.toString();\n const path = query ? `/v1/audit?${query}` : \"/v1/audit\";\n const resp = await this.request(\"GET\", path);\n return AuditPageSchema.parse(resp);\n }\n\n // --- Forge: ingest / distill / refine -------------------------------\n //\n // Wrap the server's POST /v1/ingest, /v1/distill, /v1/refine plus the\n // matching GET status endpoints. The server gates each verb behind an\n // operator flag (INGEST_ENABLED / DISTILL_ENABLED / REFINE_ENABLED);\n // when off, these methods throw NotFoundError.\n\n async ingestText(params: {\n agentId: string;\n text: string;\n datasetId?: string;\n }): Promise<IngestJobResponse> {\n const body: Record<string, unknown> = {\n kind: \"text\",\n agent_id: params.agentId,\n text: params.text,\n };\n if (params.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/ingest\", body);\n return IngestJobSchema.parse(resp);\n }\n\n async ingestUrl(params: {\n agentId: string;\n url: string;\n datasetId?: string;\n }): Promise<IngestJobResponse> {\n const body: Record<string, unknown> = {\n kind: \"url\",\n agent_id: params.agentId,\n url: params.url,\n };\n if (params.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/ingest\", body);\n return IngestJobSchema.parse(resp);\n }\n\n async getIngestStatus(jobId: string): Promise<IngestJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/ingest/${jobId}`);\n return IngestJobStatusSchema.parse(resp);\n }\n\n async distill(params: {\n agentId: string;\n memoryIds: string[];\n chunkSize?: number;\n chunkOverlap?: number;\n maxConcurrency?: number;\n summaryStyle?: string;\n includeSummary?: boolean;\n }): Promise<DistillJobResponse> {\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n memory_ids: params.memoryIds,\n include_summary: params.includeSummary ?? true,\n };\n if (params.chunkSize !== undefined) body.chunk_size = params.chunkSize;\n if (params.chunkOverlap !== undefined)\n body.chunk_overlap = params.chunkOverlap;\n if (params.maxConcurrency !== undefined)\n body.max_concurrency = params.maxConcurrency;\n if (params.summaryStyle !== undefined)\n body.summary_style = params.summaryStyle;\n const resp = await this.request(\"POST\", \"/v1/distill\", body);\n return DistillJobSchema.parse(resp);\n }\n\n async getDistillStatus(jobId: string): Promise<DistillJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/distill/${jobId}`);\n return DistillJobStatusSchema.parse(resp);\n }\n\n async refine(params?: { datasetId?: string }): Promise<RefineJobResponse> {\n const body: Record<string, unknown> = {};\n if (params?.datasetId) body.dataset_id = params.datasetId;\n const resp = await this.request(\"POST\", \"/v1/refine\", body);\n return RefineJobSchema.parse(resp);\n }\n\n async getRefineStatus(jobId: string): Promise<RefineJobStatusResponse> {\n const resp = await this.request(\"GET\", `/v1/refine/${jobId}`);\n return RefineJobStatusSchema.parse(resp);\n }\n\n // --- Conversations (Phase G slice 2) ---\n\n /**\n * Open a new conversation. Returns the conversation row including\n * the assigned `id`, which subsequent `recall`s and `addTurn`s\n * reference. The `summaryCadence` controls how often the server\n * flags the conversation for summarization.\n */\n async createConversation(params: {\n agentId: string;\n userId?: string;\n title?: string;\n summaryCadence?: number;\n metadata?: Record<string, unknown>;\n }): Promise<ConversationResponse> {\n const body: Record<string, unknown> = {\n agent_id: params.agentId,\n summary_cadence: params.summaryCadence ?? 10,\n };\n if (params.userId) body.user_id = params.userId;\n if (params.title) body.title = params.title;\n if (params.metadata) body.metadata = params.metadata;\n const resp = await this.request(\"POST\", \"/v1/conversations\", body);\n return ConversationSchema.parse(resp);\n }\n\n async getConversation(conversationId: string): Promise<ConversationResponse> {\n const resp = await this.request(\"GET\", `/v1/conversations/${conversationId}`);\n return ConversationSchema.parse(resp);\n }\n\n /**\n * Stamp an existing Memo as the next turn of the conversation.\n * Returns the assigned `turn_index` plus `needs_summary` — when\n * `true`, the conversation has crossed its cadence threshold.\n */\n async addTurn(\n conversationId: string,\n params: { memoryId: string; turnRole: string },\n ): Promise<TurnAddResponse> {\n const resp = await this.request(\n \"POST\",\n `/v1/conversations/${conversationId}/turns`,\n { memory_id: params.memoryId, turn_role: params.turnRole },\n );\n return TurnAddSchema.parse(resp);\n }\n\n /**\n * v0.19.3 — soft-delete a conversation. Existing turn Memos stay\n * queryable through standard recall; the conversation itself stops\n * accepting turns and its endpoints 404. Idempotent.\n */\n async deleteConversation(conversationId: string): Promise<void> {\n await this.request(\"DELETE\", `/v1/conversations/${conversationId}`);\n }\n\n async listTurns(\n conversationId: string,\n params?: { afterTurn?: number; limit?: number },\n ): Promise<TurnListResponse> {\n const query = new URLSearchParams();\n if (params?.afterTurn !== undefined)\n query.set(\"after_turn\", String(params.afterTurn));\n query.set(\"limit\", String(params?.limit ?? 50));\n const path = `/v1/conversations/${conversationId}/turns?${query.toString()}`;\n const resp = await this.request(\"GET\", path);\n return TurnListSchema.parse(resp);\n }\n\n // --- Tenant budgets (v0.20.3) ---\n\n /**\n * Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).\n *\n * Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`\n * surface. Requires `SUPERADMIN_ENABLED=true` on the server and\n * the client to be configured with the matching superadmin API\n * key. Methods raise `AuthenticationError` (401) or a generic\n * `Z3rnoError` (403) otherwise.\n */\n get admin(): AdminAPI {\n return new AdminAPI(this.request.bind(this));\n }\n\n /**\n * Read this org's stored budget overrides + resolved effective caps.\n * Auth: any admin/write/read member of the calling org.\n */\n async getMyBudgets(): Promise<TenantBudgetsView> {\n const resp = await this.request(\"GET\", \"/v1/tenants/me/budgets\");\n return TenantBudgetsViewSchema.parse(resp);\n }\n\n /**\n * Replace this org's budget overrides. Zero / missing fields\n * inherit the server default. Auth: admin/write only.\n */\n async setMyBudgets(\n budgets: Partial<TenantBudgets>,\n ): Promise<TenantBudgetsView> {\n const body: TenantBudgets = {\n daily_tokens: budgets.daily_tokens ?? 0,\n daily_llm_calls: budgets.daily_llm_calls ?? 0,\n daily_embeddings: budgets.daily_embeddings ?? 0,\n monthly_tokens: budgets.monthly_tokens ?? 0,\n monthly_llm_calls: budgets.monthly_llm_calls ?? 0,\n monthly_embeddings: budgets.monthly_embeddings ?? 0,\n };\n const resp = await this.request(\"PUT\", \"/v1/tenants/me/budgets\", body);\n return TenantBudgetsViewSchema.parse(resp);\n }\n\n // --- HTTP layer ---\n\n private async request(\n method: string,\n path: string,\n body?: unknown,\n ): Promise<unknown> {\n let lastError: Error | undefined;\n\n for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n try {\n const url = `${this.baseUrl}${path}`;\n let init: RequestInit = {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n \"User-Agent\": \"@z3rno/sdk/0.0.1\",\n },\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n };\n\n if (this.onRequest) {\n init = this.onRequest(url, init);\n }\n\n let response = await this.fetchImpl(url, init);\n\n if (this.onResponse) {\n response = this.onResponse(response);\n }\n\n clearTimeout(timeoutId);\n\n // On 429, honor Retry-After header and retry\n if (response.status === 429 && attempt < this.maxRetries) {\n const retryAfter = parseInt(\n response.headers.get(\"Retry-After\") ?? \"1\",\n 10,\n );\n await this.sleep(retryAfter * 1000);\n continue;\n }\n\n // On 5xx, retry with exponential backoff\n if (response.status >= 500 && attempt < this.maxRetries) {\n const delay = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s\n await this.sleep(delay);\n continue;\n }\n\n return this.handleResponse(response);\n } catch (error) {\n clearTimeout(timeoutId);\n\n // Do not retry Z3rnoError subclasses (4xx client errors)\n if (error instanceof Z3rnoError) throw error;\n\n // Classify the error before deciding whether to retry\n if (error instanceof DOMException && error.name === \"AbortError\") {\n lastError = new Z3rnoTimeoutError(\n `Request timed out after ${this.timeout}ms`,\n this.timeout,\n );\n } else if (error instanceof TypeError) {\n lastError = new Z3rnoConnectionError(\n `Connection failed: ${error.message}`,\n );\n } else {\n lastError = error instanceof Error ? error : new Error(String(error));\n }\n\n if (attempt < this.maxRetries) {\n const delay = Math.pow(2, attempt) * 1000;\n await this.sleep(delay);\n continue;\n }\n }\n }\n\n // After all retries exhausted, throw the last classified error\n if (lastError instanceof Z3rnoError) {\n throw lastError;\n }\n throw new Z3rnoError(\n `Request failed after ${this.maxRetries + 1} attempts: ${String(lastError)}`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n\n private async handleResponse(resp: Response): Promise<unknown> {\n if (resp.ok) {\n // 204 No Content: DELETE-style endpoints (deleteConversation,\n // key revoke) return an empty body. Calling resp.json() on it\n // rejects with SyntaxError (\"Unexpected end of JSON input\"),\n // which the retry loop above wraps and burns through every\n // retry attempt before timing out. Short-circuit instead.\n if (resp.status === 204) {\n return undefined;\n }\n return resp.json();\n }\n\n let detail = resp.statusText;\n try {\n const text = await resp.text();\n try {\n const body = JSON.parse(text) as Record<string, unknown>;\n detail = String(body.detail ?? body.error ?? resp.statusText);\n } catch {\n // Response is not JSON (e.g., nginx HTML 502). Include the\n // beginning of the body so users can diagnose proxy/gateway issues.\n if (text.length > 0) {\n const preview = text.length > 200 ? text.slice(0, 200) + \"...\" : text;\n detail = `${resp.statusText} — ${preview}`;\n }\n }\n } catch {\n // Could not read body at all\n }\n\n switch (resp.status) {\n case 401:\n throw new AuthenticationError(`Authentication failed: ${detail}`);\n case 404:\n throw new NotFoundError(`Not found: ${detail}`);\n case 429: {\n const retryAfter = parseInt(\n resp.headers.get(\"Retry-After\") ?? \"60\",\n 10,\n );\n throw new RateLimitError(`Rate limit exceeded: ${detail}`, retryAfter);\n }\n case 400:\n case 422:\n throw new ValidationError(detail, resp.status);\n default:\n if (resp.status >= 500) {\n throw new ServerError(`Server error: ${detail}`, resp.status);\n }\n throw new Z3rnoError(\n `Unexpected error (${resp.status}): ${detail}`,\n resp.status,\n );\n }\n }\n}\n\n/**\n * Cross-tenant admin sub-namespace exposed via `client.admin`.\n *\n * Construction captures the parent client's `request` method as a\n * bound closure — no privileged access to the class internals, just\n * a function reference. That's deliberate: the namespace is\n * dependency-injected the same way a stub would be, so test doubles\n * can swap it out without touching the parent client.\n */\nexport class AdminAPI {\n constructor(\n private readonly request: (\n method: string,\n path: string,\n body?: unknown,\n ) => Promise<unknown>,\n ) {}\n\n /**\n * Read another tenant's budget overrides + effective caps.\n *\n * Requires `SUPERADMIN_ENABLED=true` server-side and the client to\n * be configured with the superadmin API key.\n */\n async getBudgets(orgId: string): Promise<TenantBudgetsView> {\n const resp = await this.request(\"GET\", `/v1/tenants/${orgId}/budgets`);\n return TenantBudgetsViewSchema.parse(resp);\n }\n\n /**\n * Replace another tenant's budget overrides. Zero / missing fields\n * inherit the server default.\n */\n async setBudgets(\n orgId: string,\n budgets: Partial<TenantBudgets>,\n ): Promise<TenantBudgetsView> {\n const body: TenantBudgets = {\n daily_tokens: budgets.daily_tokens ?? 0,\n daily_llm_calls: budgets.daily_llm_calls ?? 0,\n daily_embeddings: budgets.daily_embeddings ?? 0,\n monthly_tokens: budgets.monthly_tokens ?? 0,\n monthly_llm_calls: budgets.monthly_llm_calls ?? 0,\n monthly_embeddings: budgets.monthly_embeddings ?? 0,\n };\n const resp = await this.request(\"PUT\", `/v1/tenants/${orgId}/budgets`, body);\n return TenantBudgetsViewSchema.parse(resp);\n }\n}\n","/**\n * Vercel AI SDK adapter for Z3rno (Phase G slice 3).\n *\n * Vercel AI SDK accepts a plain `CoreMessage[]` history; this adapter\n * loads + persists that history through Z3rno conversations. Drop the\n * `messages` accessor straight into `streamText` / `generateText`,\n * call `appendUserMessage` / `appendAssistantMessage` after each turn,\n * and Z3rno handles ordering + recall.\n *\n * Zero hard dependency on the `ai` package — we duck-type on the\n * minimal `CoreMessage` shape (`{ role, content }`).\n */\n\nimport type { Z3rnoClient } from \"../client.js\";\n\nexport type Z3rnoMessageRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\n/** Subset of Vercel `ai` `CoreMessage` the adapter needs. */\nexport interface CoreMessage {\n role: Z3rnoMessageRole;\n content: string;\n}\n\nexport interface Z3rnoVercelMemoryOptions {\n client: Z3rnoClient;\n agentId: string;\n /** When set, recall + persisted turns are scoped to this Z3rno conversation. */\n conversationId?: string;\n /** Max history slice to load. Default 50. */\n topK?: number;\n}\n\n/**\n * Lightweight history adapter you can hand straight to Vercel AI SDK\n * helpers. `await mem.messages()` returns a CoreMessage[] ready to\n * pass to `streamText({ messages: ... })`. After each turn, call\n * `appendUserMessage` / `appendAssistantMessage` so future recalls\n * see the latest state.\n */\nexport class Z3rnoVercelMemory {\n private readonly client: Z3rnoClient;\n private readonly agentId: string;\n private readonly conversationId: string | undefined;\n private readonly topK: number;\n\n constructor(options: Z3rnoVercelMemoryOptions) {\n this.client = options.client;\n this.agentId = options.agentId;\n this.conversationId = options.conversationId;\n this.topK = options.topK ?? 50;\n }\n\n async messages(): Promise<CoreMessage[]> {\n if (this.conversationId) {\n // Conversation-scoped: pull turns in order.\n const page = await this.client.listTurns(this.conversationId, {\n limit: this.topK,\n });\n return page.turns.map((t) => ({\n role: this.normaliseRole(t.turn_role),\n content: t.content,\n }));\n }\n // No conversation — fall back to recall-based history (newest first).\n const resp = await this.client.recall({\n agentId: this.agentId,\n topK: this.topK,\n memoryType: \"episodic\",\n });\n const reversed = [...resp.results].reverse();\n return reversed.map((r) => ({\n role: this.normaliseRole(\n ((r.metadata as Record<string, unknown> | undefined) ?? {})[\n \"role\"\n ] as string | undefined,\n ),\n content: r.content,\n }));\n }\n\n async appendUserMessage(content: string): Promise<void> {\n await this.append(content, \"user\");\n }\n\n async appendAssistantMessage(content: string): Promise<void> {\n await this.append(content, \"assistant\");\n }\n\n async appendToolMessage(content: string): Promise<void> {\n await this.append(content, \"tool\");\n }\n\n private async append(content: string, role: Z3rnoMessageRole): Promise<void> {\n const memory = await this.client.store({\n agentId: this.agentId,\n content,\n memoryType: \"episodic\",\n metadata: { role },\n relationships: [],\n });\n if (this.conversationId) {\n await this.client.addTurn(this.conversationId, {\n memoryId: memory.id,\n turnRole: role,\n });\n }\n }\n\n private normaliseRole(raw: string | undefined): Z3rnoMessageRole {\n switch (raw) {\n case \"assistant\":\n case \"ai\":\n return \"assistant\";\n case \"system\":\n return \"system\";\n case \"tool\":\n return \"tool\";\n default:\n return \"user\";\n }\n }\n}\n","/**\n * Mastra adapter for Z3rno (Phase G slice 3).\n *\n * Mastra exposes a `MastraMemory`-shaped interface — see\n * https://mastra.ai/docs/agents/memory. This adapter implements\n * the same surface (`getMessages` / `addMessage` / `clear`) using\n * Z3rno conversations as the backing store.\n *\n * Zero hard dependency on the `@mastra/core` package — we provide\n * the typed surface and Mastra's runtime accepts any conforming\n * object.\n */\n\nimport type { Z3rnoClient } from \"../client.js\";\n\nexport type MastraRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\nexport interface MastraMessage {\n role: MastraRole;\n content: string;\n threadId?: string;\n resourceId?: string;\n}\n\nexport interface Z3rnoMastraMemoryOptions {\n client: Z3rnoClient;\n agentId: string;\n /** Mastra's thread is Z3rno's conversation; supply or look up by threadId. */\n conversationId?: string;\n topK?: number;\n}\n\n/**\n * Mastra-compatible memory backed by Z3rno conversations. Plug into\n * a Mastra `Agent`:\n *\n * const memory = new Z3rnoMastraMemory({ client, agentId, conversationId });\n * const agent = new Agent({ name: \"support\", memory });\n */\nexport class Z3rnoMastraMemory {\n private readonly client: Z3rnoClient;\n private readonly agentId: string;\n private readonly conversationId: string | undefined;\n private readonly topK: number;\n\n constructor(options: Z3rnoMastraMemoryOptions) {\n this.client = options.client;\n this.agentId = options.agentId;\n this.conversationId = options.conversationId;\n this.topK = options.topK ?? 50;\n }\n\n /** Mastra contract: return ordered prior messages for the thread. */\n async getMessages(_args?: { limit?: number }): Promise<MastraMessage[]> {\n const limit = _args?.limit ?? this.topK;\n if (this.conversationId) {\n const page = await this.client.listTurns(this.conversationId, { limit });\n return page.turns.map((t) => ({\n role: this.normaliseRole(t.turn_role),\n content: t.content,\n threadId: this.conversationId,\n }));\n }\n const resp = await this.client.recall({\n agentId: this.agentId,\n topK: limit,\n memoryType: \"episodic\",\n });\n const reversed = [...resp.results].reverse();\n return reversed.map((r) => ({\n role: this.normaliseRole(\n ((r.metadata as Record<string, unknown> | undefined) ?? {})[\n \"role\"\n ] as string | undefined,\n ),\n content: r.content,\n }));\n }\n\n /** Mastra contract: persist one message. */\n async addMessage(message: MastraMessage): Promise<void> {\n const memory = await this.client.store({\n agentId: this.agentId,\n content: message.content,\n memoryType: \"episodic\",\n metadata: { role: message.role },\n relationships: [],\n });\n if (this.conversationId) {\n await this.client.addTurn(this.conversationId, {\n memoryId: memory.id,\n turnRole: message.role,\n });\n }\n }\n\n /**\n * Mastra `clear()` — deliberate no-op. Z3rno keeps the source of\n * truth and recall is already scoped per conversation; flushing\n * the thread would risk losing audit-relevant history.\n */\n async clear(): Promise<void> {\n return;\n }\n\n private normaliseRole(raw: string | undefined): MastraRole {\n switch (raw) {\n case \"assistant\":\n case \"ai\":\n return \"assistant\";\n case \"system\":\n return \"system\";\n case \"tool\":\n return \"tool\";\n default:\n return \"user\";\n }\n }\n}\n"]}
|