@agentuity/keyvalue 1.0.54

package/AGENTS.md

@@ -0,0 +1,39 @@
+# Agent Guidelines for @agentuity/keyvalue
+
+## Package Overview
+
+Standalone package for the Agentuity Key-Value storage service. Provides a simple, ergonomic client for storing and retrieving key-value data.
+
+## Commands
+
+- **Build**: `bun run build`
+- **Typecheck**: `bun run typecheck`
+- **Clean**: `rm -rf dist`
+
+## Architecture
+
+- **Runtime**: Node.js and Bun compatible
+- **Exports**: KeyValueClient and all types from @agentuity/core/keyvalue
+- **Dependencies**: @agentuity/core, zod
+
+## Usage
+
+```typescript
+import { KeyValueClient } from '@agentuity/keyvalue';
+
+const client = new KeyValueClient();
+
+// Set a value
+await client.set('my-namespace', 'my-key', { foo: 'bar' });
+
+// Get a value
+const result = await client.get('my-namespace', 'my-key');
+if (result.exists) {
+  console.log(result.data);
+}
+```
+
+## Publishing
+
+1. Run `bun run build`
+2. Must publish **after** @agentuity/core

package/README.md

@@ -0,0 +1,78 @@
+# @agentuity/keyvalue
+
+A standalone package for the Agentuity Key-Value storage service.
+
+## Installation
+
+```bash
+npm install @agentuity/keyvalue
+```
+
+## Quick Start
+
+```typescript
+import { KeyValueClient } from '@agentuity/keyvalue';
+
+const client = new KeyValueClient();
+
+// Set a value with optional TTL
+await client.set('my-namespace', 'user:123', { name: 'John', email: 'john@example.com' }, {
+  ttl: 3600 // expires in 1 hour
+});
+
+// Get a value
+const result = await client.get('my-namespace', 'user:123');
+if (result.exists) {
+  console.log('Found:', result.data);
+  console.log('Content-Type:', result.contentType);
+}
+
+// Delete a value
+await client.delete('my-namespace', 'user:123');
+
+// Get namespace statistics
+const stats = await client.getStats('my-namespace');
+console.log(`${stats.count} keys, ${stats.sum} bytes`);
+
+// Search for keys
+const results = await client.search('my-namespace', 'user');
+```
+
+## Configuration
+
+The client can be configured with options:
+
+```typescript
+const client = new KeyValueClient({
+  apiKey: 'your-api-key',           // or set AGENTUITY_SDK_KEY
+  url: 'https://api.agentuity.com', // or set AGENTUITY_KV_URL
+  logger: customLogger,              // optional custom logger
+});
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AGENTUITY_SDK_KEY` | API key for authentication | Required |
+| `AGENTUITY_REGION` | Region for API endpoints | `usc` |
+| `AGENTUITY_KV_URL` | Override KV API URL | Auto-detected |
+
+## TTL (Time-to-Live)
+
+Keys can have an optional TTL:
+
+```typescript
+// Key expires in 1 hour
+await client.set('ns', 'key', value, { ttl: 3600 });
+
+// Key never expires
+await client.set('ns', 'key', value, { ttl: null });
+
+// Key uses namespace default TTL
+await client.set('ns', 'key', value);
+```
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export { KeyValueStorageService, KeyValueStorage, type KeyValueStats, type KeyValueStatsPaginated, type KeyValueItemWithMetadata, type DataResult, type DataResultFound, type DataResultNotFound, type KeyValueStorageSetParams, type CreateNamespaceParams, type GetAllStatsParams, type KVSortField, KV_MIN_TTL_SECONDS, KV_MAX_TTL_SECONDS, KV_DEFAULT_TTL_SECONDS, DataResultFoundSchema, DataResultNotFoundSchema, DataResultSchema, KeyValueStorageSetParamsSchema, CreateNamespaceParamsSchema, GetAllStatsParamsSchema, KeyValueStatsSchema, KeyValueStatsPaginatedSchema, KeyValueItemWithMetadataSchema, KVSortFieldSchema, } from '@agentuity/core/keyvalue';
+import { KeyValueStorageService, type KeyValueStorageSetParams, type DataResult } from '@agentuity/core/keyvalue';
+import { type Logger } from '@agentuity/server';
+import { z } from 'zod';
+export declare const KeyValueClientOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    logger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
+}, z.core.$strip>;
+export type KeyValueClientOptions = z.infer<typeof KeyValueClientOptionsSchema>;
+export declare class KeyValueClient {
+    #private;
+    constructor(options?: KeyValueClientOptions);
+    get<T>(name: string, key: string): Promise<DataResult<T>>;
+    set<T = unknown>(name: string, key: string, value: T, params?: KeyValueStorageSetParams): Promise<void>;
+    delete(name: string, key: string): Promise<void>;
+    getStats(name: string): Promise<{
+        sum: number;
+        count: number;
+        createdAt?: number | undefined;
+        lastUsedAt?: number | undefined;
+        internal?: boolean | undefined;
+    }>;
+    getAllStats(params?: Parameters<KeyValueStorageService['getAllStats']>[0]): Promise<Record<string, {
+        sum: number;
+        count: number;
+        createdAt?: number | undefined;
+        lastUsedAt?: number | undefined;
+        internal?: boolean | undefined;
+    }> | {
+        namespaces: Record<string, {
+            sum: number;
+            count: number;
+            createdAt?: number | undefined;
+            lastUsedAt?: number | undefined;
+            internal?: boolean | undefined;
+        }>;
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    }>;
+    getNamespaces(): Promise<string[]>;
+    search<T = unknown>(name: string, keyword: string): Promise<Record<string, import("@agentuity/core").KeyValueItemWithMetadata<T>>>;
+    getKeys(name: string): Promise<string[]>;
+    deleteNamespace(name: string): Promise<void>;
+    createNamespace(name: string, params?: Parameters<KeyValueStorageService['createNamespace']>[1]): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,EACtB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC9B,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACN,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgD,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI9F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,qBAAa,cAAc;;gBAGd,OAAO,GAAE,qBAA0B;IAoBzC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAIzD,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,MAAM,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAIV,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,QAAQ,CAAC,IAAI,EAAE,MAAM;;;;;;;IAIrB,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;IAIzE,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIlC,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIjD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,eAAe,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC/D,OAAO,CAAC,IAAI,CAAC;CAGhB"}

package/dist/index.js

@@ -0,0 +1,64 @@
+export { KeyValueStorageService, KV_MIN_TTL_SECONDS, KV_MAX_TTL_SECONDS, KV_DEFAULT_TTL_SECONDS, DataResultFoundSchema, DataResultNotFoundSchema, DataResultSchema, KeyValueStorageSetParamsSchema, CreateNamespaceParamsSchema, GetAllStatsParamsSchema, KeyValueStatsSchema, KeyValueStatsPaginatedSchema, KeyValueItemWithMetadataSchema, KVSortFieldSchema, } from '@agentuity/core/keyvalue';
+import { KeyValueStorageService, } from '@agentuity/core/keyvalue';
+import { createServerFetchAdapter, buildClientHeaders } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+const isLogger = (val) => typeof val === 'object' &&
+    val !== null &&
+    ['info', 'warn', 'error', 'debug', 'trace'].every((m) => typeof val[m] === 'function');
+export const KeyValueClientOptionsSchema = z.object({
+    apiKey: z.string().optional().describe('API key for authentication'),
+    url: z.string().optional().describe('Base URL for the KV API'),
+    orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+    logger: z.custom(isLogger).optional().describe('Custom logger instance'),
+});
+export class KeyValueClient {
+    #service;
+    constructor(options = {}) {
+        const validatedOptions = KeyValueClientOptionsSchema.parse(options);
+        const apiKey = validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+        const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+        const serviceUrls = getServiceUrls(region);
+        const url = validatedOptions.url || getEnv('AGENTUITY_KEYVALUE_URL') || serviceUrls.keyvalue;
+        const logger = validatedOptions.logger ?? createMinimalLogger();
+        const headers = buildClientHeaders({
+            apiKey,
+            orgId: validatedOptions.orgId,
+        });
+        const adapter = createServerFetchAdapter({ headers }, logger);
+        this.#service = new KeyValueStorageService(url, adapter);
+    }
+    async get(name, key) {
+        return this.#service.get(name, key);
+    }
+    async set(name, key, value, params) {
+        return this.#service.set(name, key, value, params);
+    }
+    async delete(name, key) {
+        return this.#service.delete(name, key);
+    }
+    async getStats(name) {
+        return this.#service.getStats(name);
+    }
+    async getAllStats(params) {
+        return this.#service.getAllStats(params);
+    }
+    async getNamespaces() {
+        return this.#service.getNamespaces();
+    }
+    async search(name, keyword) {
+        return this.#service.search(name, keyword);
+    }
+    async getKeys(name) {
+        return this.#service.getKeys(name);
+    }
+    async deleteNamespace(name) {
+        return this.#service.deleteNamespace(name);
+    }
+    async createNamespace(name, params) {
+        return this.#service.createNamespace(name, params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@agentuity/keyvalue",
+	"version": "1.0.54",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "1.0.54",
+		"@agentuity/server": "1.0.54",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^22.0.0",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false
+}

package/src/index.ts

@@ -0,0 +1,125 @@
+export {
+	KeyValueStorageService,
+	KeyValueStorage,
+	type KeyValueStats,
+	type KeyValueStatsPaginated,
+	type KeyValueItemWithMetadata,
+	type DataResult,
+	type DataResultFound,
+	type DataResultNotFound,
+	type KeyValueStorageSetParams,
+	type CreateNamespaceParams,
+	type GetAllStatsParams,
+	type KVSortField,
+	KV_MIN_TTL_SECONDS,
+	KV_MAX_TTL_SECONDS,
+	KV_DEFAULT_TTL_SECONDS,
+	DataResultFoundSchema,
+	DataResultNotFoundSchema,
+	DataResultSchema,
+	KeyValueStorageSetParamsSchema,
+	CreateNamespaceParamsSchema,
+	GetAllStatsParamsSchema,
+	KeyValueStatsSchema,
+	KeyValueStatsPaginatedSchema,
+	KeyValueItemWithMetadataSchema,
+	KVSortFieldSchema,
+} from '@agentuity/core/keyvalue';
+
+import {
+	KeyValueStorageService,
+	type KeyValueStorageSetParams,
+	type DataResult,
+} from '@agentuity/core/keyvalue';
+import { createServerFetchAdapter, buildClientHeaders, type Logger } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+
+const isLogger = (val: unknown): val is Logger =>
+	typeof val === 'object' &&
+	val !== null &&
+	['info', 'warn', 'error', 'debug', 'trace'].every(
+		(m) => typeof (val as Record<string, unknown>)[m] === 'function'
+	);
+
+export const KeyValueClientOptionsSchema = z.object({
+	apiKey: z.string().optional().describe('API key for authentication'),
+	url: z.string().optional().describe('Base URL for the KV API'),
+	orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+	logger: z.custom<Logger>(isLogger).optional().describe('Custom logger instance'),
+});
+export type KeyValueClientOptions = z.infer<typeof KeyValueClientOptionsSchema>;
+
+export class KeyValueClient {
+	readonly #service: KeyValueStorageService;
+
+	constructor(options: KeyValueClientOptions = {}) {
+		const validatedOptions = KeyValueClientOptionsSchema.parse(options);
+		const apiKey =
+			validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+		const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+		const serviceUrls = getServiceUrls(region);
+
+		const url = validatedOptions.url || getEnv('AGENTUITY_KEYVALUE_URL') || serviceUrls.keyvalue;
+
+		const logger = validatedOptions.logger ?? createMinimalLogger();
+
+		const headers = buildClientHeaders({
+			apiKey,
+			orgId: validatedOptions.orgId,
+		});
+
+		const adapter = createServerFetchAdapter({ headers }, logger);
+		this.#service = new KeyValueStorageService(url, adapter);
+	}
+
+	async get<T>(name: string, key: string): Promise<DataResult<T>> {
+		return this.#service.get(name, key);
+	}
+
+	async set<T = unknown>(
+		name: string,
+		key: string,
+		value: T,
+		params?: KeyValueStorageSetParams
+	): Promise<void> {
+		return this.#service.set(name, key, value, params);
+	}
+
+	async delete(name: string, key: string): Promise<void> {
+		return this.#service.delete(name, key);
+	}
+
+	async getStats(name: string) {
+		return this.#service.getStats(name);
+	}
+
+	async getAllStats(params?: Parameters<KeyValueStorageService['getAllStats']>[0]) {
+		return this.#service.getAllStats(params);
+	}
+
+	async getNamespaces(): Promise<string[]> {
+		return this.#service.getNamespaces();
+	}
+
+	async search<T = unknown>(name: string, keyword: string) {
+		return this.#service.search<T>(name, keyword);
+	}
+
+	async getKeys(name: string): Promise<string[]> {
+		return this.#service.getKeys(name);
+	}
+
+	async deleteNamespace(name: string): Promise<void> {
+		return this.#service.deleteNamespace(name);
+	}
+
+	async createNamespace(
+		name: string,
+		params?: Parameters<KeyValueStorageService['createNamespace']>[1]
+	): Promise<void> {
+		return this.#service.createNamespace(name, params);
+	}
+}