@z3rno/sdk 0.0.1
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/LICENSE +201 -0
- package/README.md +75 -0
- package/dist/index.cjs +292 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +396 -0
- package/dist/index.d.ts +396 -0
- package/dist/index.js +276 -0
- package/dist/index.js.map +1 -0
- package/package.json +47 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/models.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","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"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@z3rno/sdk",
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"description": "TypeScript SDK for Z3rno — AI agent memory database",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.cjs",
|
|
7
|
+
"module": "./dist/index.js",
|
|
8
|
+
"types": "./dist/index.d.ts",
|
|
9
|
+
"exports": {
|
|
10
|
+
".": {
|
|
11
|
+
"types": "./dist/index.d.ts",
|
|
12
|
+
"import": "./dist/index.js",
|
|
13
|
+
"require": "./dist/index.cjs"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"files": ["dist"],
|
|
17
|
+
"scripts": {
|
|
18
|
+
"build": "tsup",
|
|
19
|
+
"test": "vitest run",
|
|
20
|
+
"test:watch": "vitest",
|
|
21
|
+
"lint": "tsc --noEmit",
|
|
22
|
+
"format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
|
|
23
|
+
"format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts'",
|
|
24
|
+
"typecheck": "tsc --noEmit"
|
|
25
|
+
},
|
|
26
|
+
"author": "The AI Project Co. <engineering@z3rno.dev>",
|
|
27
|
+
"homepage": "https://z3rno.dev",
|
|
28
|
+
"engines": {
|
|
29
|
+
"node": ">=18.0.0"
|
|
30
|
+
},
|
|
31
|
+
"dependencies": {
|
|
32
|
+
"zod": "^3.23.0"
|
|
33
|
+
},
|
|
34
|
+
"devDependencies": {
|
|
35
|
+
"@types/node": "^22.0.0",
|
|
36
|
+
"prettier": "^3.8.0",
|
|
37
|
+
"tsup": "^8.5.0",
|
|
38
|
+
"typescript": "^5.7.0",
|
|
39
|
+
"vitest": "^3.2.0"
|
|
40
|
+
},
|
|
41
|
+
"keywords": ["ai-agents", "memory", "vector-database", "rag", "agent-memory", "pgvector"],
|
|
42
|
+
"license": "Apache-2.0",
|
|
43
|
+
"repository": {
|
|
44
|
+
"type": "git",
|
|
45
|
+
"url": "https://github.com/the-ai-project-co/z3rno-sdk-typescript"
|
|
46
|
+
}
|
|
47
|
+
}
|