@z3rno/sdk 0.0.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 The AI Project Co.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,75 @@
+# @z3rno/sdk (TypeScript)
+
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![CI](https://github.com/the-ai-project-co/z3rno-sdk-typescript/actions/workflows/ci.yml/badge.svg)](https://github.com/the-ai-project-co/z3rno-sdk-typescript/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@z3rno/sdk)](https://www.npmjs.com/package/@z3rno/sdk)
+
+TypeScript SDK for Z3rno -- native fetch client with Zod validation.
+
+## Installation
+
+```bash
+npm install @z3rno/sdk
+```
+
+## Quickstart
+
+```typescript
+import { Z3rnoClient } from "@z3rno/sdk";
+
+const client = new Z3rnoClient({ baseUrl: "https://api.z3rno.dev", apiKey: "z3rno_sk_..." });
+const memory = await client.store({ agentId: "agent-1", content: "User prefers dark mode", memoryType: "semantic" });
+const results = await client.recall({ agentId: "agent-1", query: "What does the user prefer?", topK: 5 });
+await client.forget({ agentId: "agent-1", memoryId: memory.id });
+```
+
+## CJS + ESM Support
+
+The SDK ships as a dual build via tsup. Both CommonJS and ES module entry points are provided:
+
+```jsonc
+// package.json exports
+{
+  "import": "./dist/index.js",   // ESM
+  "require": "./dist/index.cjs"  // CJS
+}
+```
+
+Works in Node.js 18+, Bun, Deno, and browsers.
+
+## Methods
+
+| Method | Description |
+|--------|-------------|
+| `store(request)` | Store a new memory with optional type, metadata, relationships, TTL, and importance |
+| `recall(params)` | Recall memories by semantic similarity query |
+| `forget(params)` | Soft-delete a memory by ID |
+| `audit(params?)` | Query the audit trail with optional filters and pagination |
+
+## Features
+
+- **Zero runtime dependencies** -- only `zod` for request/response validation. No `axios`, no database drivers.
+- **Native fetch** -- works in every modern JavaScript runtime without polyfills.
+- **Runtime-validated responses** -- every API response is parsed through a Zod schema, giving both compile-time and runtime type safety.
+- **Typed errors** -- `Z3rnoAuthenticationError`, `Z3rnoRateLimitError` (with `retryAfter`), `Z3rnoValidationError`.
+- **Tree-shakeable** -- ESM build with clean exports for optimal bundling.
+
+## API Documentation
+
+Full API reference: [docs.z3rno.dev/sdk/typescript](https://docs.z3rno.dev/sdk/typescript)
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm run format:check
+npm test
+npm run build
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow.
+
+## License
+
+Apache 2.0 -- see [LICENSE](LICENSE).

package/dist/index.cjs

@@ -0,0 +1,292 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/errors.ts
+var Z3rnoError = class extends Error {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.name = "Z3rnoError";
+    this.statusCode = statusCode;
+  }
+};
+var AuthenticationError = class extends Z3rnoError {
+  constructor(message) {
+    super(message, 401);
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends Z3rnoError {
+  retryAfter;
+  constructor(message, retryAfter = 60) {
+    super(message, 429);
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var ValidationError = class extends Z3rnoError {
+  constructor(message, statusCode = 400) {
+    super(message, statusCode);
+    this.name = "ValidationError";
+  }
+};
+var NotFoundError = class extends Z3rnoError {
+  constructor(message) {
+    super(message, 404);
+    this.name = "NotFoundError";
+  }
+};
+var ServerError = class extends Z3rnoError {
+  constructor(message, statusCode = 500) {
+    super(message, statusCode);
+    this.name = "ServerError";
+  }
+};
+var MemoryType = zod.z.enum([
+  "working",
+  "episodic",
+  "semantic",
+  "procedural"
+]);
+var RelationshipType = zod.z.enum([
+  "derived_from",
+  "contradicts",
+  "supports",
+  "supersedes",
+  "related_to",
+  "caused_by"
+]);
+zod.z.object({
+  agentId: zod.z.string().uuid(),
+  content: zod.z.string().min(1).max(1e5),
+  memoryType: MemoryType.default("episodic"),
+  userId: zod.z.string().uuid().optional(),
+  metadata: zod.z.record(zod.z.unknown()).default({}),
+  relationships: zod.z.array(
+    zod.z.object({
+      targetMemoryId: zod.z.string().uuid(),
+      relationshipType: RelationshipType,
+      weight: zod.z.number().min(0).max(1).default(1),
+      metadata: zod.z.record(zod.z.unknown()).default({})
+    })
+  ).default([]),
+  ttlSeconds: zod.z.number().int().positive().optional(),
+  importance: zod.z.number().min(0).max(1).optional()
+});
+zod.z.object({
+  agentId: zod.z.string().uuid(),
+  query: zod.z.string().optional(),
+  memoryType: zod.z.string().optional(),
+  filters: zod.z.record(zod.z.unknown()).optional(),
+  topK: zod.z.number().int().min(1).max(100).default(10),
+  similarityThreshold: zod.z.number().min(0).max(1).default(0),
+  asOf: zod.z.string().datetime().optional(),
+  includeDeleted: zod.z.boolean().default(false)
+});
+zod.z.object({
+  agentId: zod.z.string().uuid(),
+  memoryId: zod.z.string().uuid().optional(),
+  memoryIds: zod.z.array(zod.z.string().uuid()).optional(),
+  hardDelete: zod.z.boolean().default(false),
+  cascade: zod.z.boolean().default(false),
+  reason: zod.z.string().optional()
+});
+var MemoryResponse = zod.z.object({
+  id: zod.z.string(),
+  agent_id: zod.z.string(),
+  content: zod.z.string(),
+  memory_type: zod.z.string(),
+  importance_score: zod.z.number(),
+  recall_count: zod.z.number(),
+  embedding_model: zod.z.string().nullable().optional(),
+  created_at: zod.z.string(),
+  metadata: zod.z.record(zod.z.unknown()).default({})
+});
+var RecallResultItem = zod.z.object({
+  memory_id: zod.z.string(),
+  content: zod.z.string(),
+  summary: zod.z.string().nullable().optional(),
+  memory_type: zod.z.string(),
+  similarity_score: zod.z.number(),
+  importance_score: zod.z.number(),
+  relevance_score: zod.z.number(),
+  recall_count: zod.z.number(),
+  created_at: zod.z.string(),
+  metadata: zod.z.record(zod.z.unknown()).default({})
+});
+var RecallResponse = zod.z.object({
+  results: zod.z.array(RecallResultItem),
+  total: zod.z.number(),
+  query: zod.z.string().nullable().optional()
+});
+var ForgetResponse = zod.z.object({
+  deleted_count: zod.z.number(),
+  hard_deleted: zod.z.boolean(),
+  cascade_count: zod.z.number(),
+  memory_ids: zod.z.array(zod.z.string())
+});
+var AuditEntry = zod.z.object({
+  id: zod.z.number(),
+  agent_id: zod.z.string().nullable().optional(),
+  user_id: zod.z.string().nullable().optional(),
+  operation: zod.z.string(),
+  memory_id: zod.z.string().nullable().optional(),
+  memory_type: zod.z.string().nullable().optional(),
+  details: zod.z.record(zod.z.unknown()).default({}),
+  ip_address: zod.z.string().nullable().optional(),
+  created_at: zod.z.string()
+});
+var AuditPageResponse = zod.z.object({
+  entries: zod.z.array(AuditEntry),
+  total: zod.z.number(),
+  page: zod.z.number(),
+  page_size: zod.z.number(),
+  has_next: zod.z.boolean()
+});
+
+// src/client.ts
+var Z3rnoClient = class {
+  baseUrl;
+  apiKey;
+  timeout;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  // --- Store ---
+  async store(request) {
+    const body = {
+      agent_id: request.agentId,
+      content: request.content,
+      memory_type: request.memoryType,
+      user_id: request.userId,
+      metadata: request.metadata,
+      relationships: request.relationships?.map((r) => ({
+        target_memory_id: r.targetMemoryId,
+        relationship_type: r.relationshipType,
+        weight: r.weight,
+        metadata: r.metadata
+      })),
+      ttl_seconds: request.ttlSeconds,
+      importance: request.importance
+    };
+    const resp = await this.request("POST", "/v1/memories", body);
+    return MemoryResponse.parse(resp);
+  }
+  // --- Recall ---
+  async recall(params) {
+    const body = {
+      agent_id: params.agentId,
+      query: params.query,
+      memory_type: params.memoryType,
+      filters: params.filters,
+      top_k: params.topK ?? 10,
+      similarity_threshold: params.similarityThreshold ?? 0
+    };
+    const resp = await this.request("POST", "/v1/memories/recall", body);
+    return RecallResponse.parse(resp);
+  }
+  // --- Forget ---
+  async forget(params) {
+    const body = {
+      agent_id: params.agentId,
+      memory_id: params.memoryId,
+      memory_ids: params.memoryIds,
+      hard_delete: params.hardDelete ?? false,
+      cascade: params.cascade ?? false,
+      reason: params.reason
+    };
+    const resp = await this.request("POST", "/v1/memories/forget", body);
+    return ForgetResponse.parse(resp);
+  }
+  // --- Audit ---
+  async audit(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.agentId) searchParams.set("agent_id", params.agentId);
+    if (params?.page) searchParams.set("page", String(params.page));
+    if (params?.pageSize)
+      searchParams.set("page_size", String(params.pageSize));
+    const query = searchParams.toString();
+    const path = query ? `/v1/audit?${query}` : "/v1/audit";
+    const resp = await this.request("GET", path);
+    return AuditPageResponse.parse(resp);
+  }
+  // --- HTTP layer ---
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "User-Agent": "@z3rno/sdk/0.0.1"
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      return this.handleResponse(response);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Z3rnoError) throw error;
+      throw new Z3rnoError(`Request failed: ${String(error)}`);
+    }
+  }
+  async handleResponse(resp) {
+    if (resp.ok) {
+      return resp.json();
+    }
+    let detail = resp.statusText;
+    try {
+      const body = await resp.json();
+      detail = String(body.detail ?? body.error ?? resp.statusText);
+    } catch {
+    }
+    switch (resp.status) {
+      case 401:
+        throw new AuthenticationError(`Authentication failed: ${detail}`);
+      case 404:
+        throw new NotFoundError(`Not found: ${detail}`);
+      case 429: {
+        const retryAfter = parseInt(
+          resp.headers.get("Retry-After") ?? "60",
+          10
+        );
+        throw new RateLimitError(`Rate limit exceeded: ${detail}`, retryAfter);
+      }
+      case 400:
+      case 422:
+        throw new ValidationError(detail, resp.status);
+      default:
+        if (resp.status >= 500) {
+          throw new ServerError(`Server error: ${detail}`, resp.status);
+        }
+        throw new Z3rnoError(
+          `Unexpected error (${resp.status}): ${detail}`,
+          resp.status
+        );
+    }
+  }
+};
+
+exports.AuditEntry = AuditEntry;
+exports.AuditPageResponse = AuditPageResponse;
+exports.AuthenticationError = AuthenticationError;
+exports.ForgetResponse = ForgetResponse;
+exports.MemoryResponse = MemoryResponse;
+exports.MemoryType = MemoryType;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitError = RateLimitError;
+exports.RecallResponse = RecallResponse;
+exports.RecallResultItem = RecallResultItem;
+exports.RelationshipType = RelationshipType;
+exports.ServerError = ServerError;
+exports.ValidationError = ValidationError;
+exports.Z3rnoClient = Z3rnoClient;
+exports.Z3rnoError = Z3rnoError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/models.ts","../src/client.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Z3rno SDK error hierarchy.\n */\n\nexport class Z3rnoError extends Error {\n  statusCode?: number;\n\n  constructor(message: string, statusCode?: number) {\n    super(message);\n    this.name = \"Z3rnoError\";\n    this.statusCode = statusCode;\n  }\n}\n\nexport class AuthenticationError extends Z3rnoError {\n  constructor(message: string) {\n    super(message, 401);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class RateLimitError extends Z3rnoError {\n  retryAfter: number;\n\n  constructor(message: string, retryAfter: number = 60) {\n    super(message, 429);\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class ValidationError extends Z3rnoError {\n  constructor(message: string, statusCode: number = 400) {\n    super(message, statusCode);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class NotFoundError extends Z3rnoError {\n  constructor(message: string) {\n    super(message, 404);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class ServerError extends Z3rnoError {\n  constructor(message: string, statusCode: number = 500) {\n    super(message, statusCode);\n    this.name = \"ServerError\";\n  }\n}\n","/**\n * Zod schemas and inferred TypeScript types for the Z3rno API.\n */\n\nimport { z } from \"zod\";\n\n// --- Enums ---\n\nexport const MemoryType = z.enum([\n  \"working\",\n  \"episodic\",\n  \"semantic\",\n  \"procedural\",\n]);\nexport type MemoryType = z.infer<typeof MemoryType>;\n\nexport const RelationshipType = z.enum([\n  \"derived_from\",\n  \"contradicts\",\n  \"supports\",\n  \"supersedes\",\n  \"related_to\",\n  \"caused_by\",\n]);\nexport type RelationshipType = z.infer<typeof RelationshipType>;\n\n// --- Request schemas ---\n\nexport const StoreMemoryRequest = z.object({\n  agentId: z.string().uuid(),\n  content: z.string().min(1).max(100000),\n  memoryType: MemoryType.default(\"episodic\"),\n  userId: z.string().uuid().optional(),\n  metadata: z.record(z.unknown()).default({}),\n  relationships: z\n    .array(\n      z.object({\n        targetMemoryId: z.string().uuid(),\n        relationshipType: RelationshipType,\n        weight: z.number().min(0).max(1).default(1.0),\n        metadata: z.record(z.unknown()).default({}),\n      }),\n    )\n    .default([]),\n  ttlSeconds: z.number().int().positive().optional(),\n  importance: z.number().min(0).max(1).optional(),\n});\nexport type StoreMemoryRequest = z.infer<typeof StoreMemoryRequest>;\n\nexport const RecallRequest = z.object({\n  agentId: z.string().uuid(),\n  query: z.string().optional(),\n  memoryType: z.string().optional(),\n  filters: z.record(z.unknown()).optional(),\n  topK: z.number().int().min(1).max(100).default(10),\n  similarityThreshold: z.number().min(0).max(1).default(0),\n  asOf: z.string().datetime().optional(),\n  includeDeleted: z.boolean().default(false),\n});\nexport type RecallRequest = z.infer<typeof RecallRequest>;\n\nexport const ForgetRequest = z.object({\n  agentId: z.string().uuid(),\n  memoryId: z.string().uuid().optional(),\n  memoryIds: z.array(z.string().uuid()).optional(),\n  hardDelete: z.boolean().default(false),\n  cascade: z.boolean().default(false),\n  reason: z.string().optional(),\n});\nexport type ForgetRequest = z.infer<typeof ForgetRequest>;\n\n// --- Response schemas ---\n\nexport const MemoryResponse = z.object({\n  id: z.string(),\n  agent_id: z.string(),\n  content: z.string(),\n  memory_type: z.string(),\n  importance_score: z.number(),\n  recall_count: z.number(),\n  embedding_model: z.string().nullable().optional(),\n  created_at: z.string(),\n  metadata: z.record(z.unknown()).default({}),\n});\nexport type MemoryResponse = z.infer<typeof MemoryResponse>;\n\nexport const RecallResultItem = z.object({\n  memory_id: z.string(),\n  content: z.string(),\n  summary: z.string().nullable().optional(),\n  memory_type: z.string(),\n  similarity_score: z.number(),\n  importance_score: z.number(),\n  relevance_score: z.number(),\n  recall_count: z.number(),\n  created_at: z.string(),\n  metadata: z.record(z.unknown()).default({}),\n});\nexport type RecallResultItem = z.infer<typeof RecallResultItem>;\n\nexport const RecallResponse = z.object({\n  results: z.array(RecallResultItem),\n  total: z.number(),\n  query: z.string().nullable().optional(),\n});\nexport type RecallResponse = z.infer<typeof RecallResponse>;\n\nexport const ForgetResponse = z.object({\n  deleted_count: z.number(),\n  hard_deleted: z.boolean(),\n  cascade_count: z.number(),\n  memory_ids: z.array(z.string()),\n});\nexport type ForgetResponse = z.infer<typeof ForgetResponse>;\n\nexport const AuditEntry = z.object({\n  id: z.number(),\n  agent_id: z.string().nullable().optional(),\n  user_id: z.string().nullable().optional(),\n  operation: z.string(),\n  memory_id: z.string().nullable().optional(),\n  memory_type: z.string().nullable().optional(),\n  details: z.record(z.unknown()).default({}),\n  ip_address: z.string().nullable().optional(),\n  created_at: z.string(),\n});\nexport type AuditEntry = z.infer<typeof AuditEntry>;\n\nexport const AuditPageResponse = z.object({\n  entries: z.array(AuditEntry),\n  total: z.number(),\n  page: z.number(),\n  page_size: z.number(),\n  has_next: z.boolean(),\n});\nexport type AuditPageResponse = z.infer<typeof AuditPageResponse>;\n","/**\n * Z3rno TypeScript SDK client.\n *\n * Thin fetch wrapper — no database drivers, no embedding providers.\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  Z3rnoError,\n} from \"./errors.js\";\nimport type {\n  AuditPageResponse,\n  ForgetResponse,\n  MemoryResponse,\n  RecallResponse,\n  StoreMemoryRequest,\n} from \"./models.js\";\nimport {\n  AuditPageResponse as AuditPageSchema,\n  ForgetResponse as ForgetSchema,\n  MemoryResponse as MemorySchema,\n  RecallResponse as RecallSchema,\n} from \"./models.js\";\n\nexport interface Z3rnoClientConfig {\n  baseUrl: string;\n  apiKey: string;\n  timeout?: number;\n  maxRetries?: number;\n}\n\nexport class Z3rnoClient {\n  private baseUrl: string;\n  private apiKey: string;\n  private timeout: number;\n\n  constructor(config: Z3rnoClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout ?? 30000;\n  }\n\n  // --- Store ---\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  async recall(params: {\n    agentId: string;\n    query?: string;\n    memoryType?: string;\n    filters?: Record<string, unknown>;\n    topK?: number;\n    similarityThreshold?: number;\n  }): Promise<RecallResponse> {\n    const body = {\n      agent_id: params.agentId,\n      query: params.query,\n      memory_type: params.memoryType,\n      filters: params.filters,\n      top_k: params.topK ?? 10,\n      similarity_threshold: params.similarityThreshold ?? 0,\n    };\n\n    const resp = await this.request(\"POST\", \"/v1/memories/recall\", body);\n    return RecallSchema.parse(resp);\n  }\n\n  // --- Forget ---\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  // --- Audit ---\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  // --- HTTP layer ---\n\n  private async request(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<unknown> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\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      clearTimeout(timeoutId);\n      return this.handleResponse(response);\n    } catch (error) {\n      clearTimeout(timeoutId);\n      if (error instanceof Z3rnoError) throw error;\n      throw new Z3rnoError(`Request failed: ${String(error)}`);\n    }\n  }\n\n  private async handleResponse(resp: Response): Promise<unknown> {\n    if (resp.ok) {\n      return resp.json();\n    }\n\n    let detail = resp.statusText;\n    try {\n      const body = (await resp.json()) as Record<string, unknown>;\n      detail = String(body.detail ?? body.error ?? resp.statusText);\n    } catch {\n      // Not JSON\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"]}