@agentuity/runtime 0.0.35 → 0.0.36

package/dist/_config.d.ts

@@ -58,4 +58,10 @@ export declare function getCLIVersion(): string;
  * @returns string
  */
 export declare function getEnvironment(): string;
+/**
+ * Returns true if the AGENTUITY_SDK_KEY is set
+ *
+ * @returns boolean
+ */
+export declare function isAuthenticated(): boolean;
 //# sourceMappingURL=_config.d.ts.map

package/dist/_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_config.d.ts","sourceRoot":"","sources":["../src/_config.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}
+{"version":3,"file":"_config.d.ts","sourceRoot":"","sources":["../src/_config.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/_server.d.ts

@@ -13,5 +13,5 @@ export declare function getTracer(): Tracer | null;
  * called before the createApp is called for it to be added.
  */
 export declare function addSpanProcessor(processor: SpanProcessor): void;
-export declare const createServer: <E extends Env>(app: Hono<E>, _config?: AppConfig) => Bun.Server<BunWebSocketData>;
+export declare const createServer: <E extends Env>(app: Hono<E>, config?: AppConfig) => Bun.Server<BunWebSocketData>;
 //# sourceMappingURL=_server.d.ts.map

package/dist/_server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_server.d.ts","sourceRoot":"","sources":["../src/_server.ts"],"names":[],"mappings":"AACA,OAAO,EAKN,KAAK,MAAM,EAGX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAInE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAavC,wBAAgB,SAAS,wCAExB;AAED,wBAAgB,MAAM,4DAErB;AAED,wBAAgB,SAAS,kBAExB;AAED,wBAAgB,SAAS,kBAExB;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,QAExD;AA2CD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,SAAS,iCAmJ5E,CAAC"}
+{"version":3,"file":"_server.d.ts","sourceRoot":"","sources":["../src/_server.ts"],"names":[],"mappings":"AACA,OAAO,EAKN,KAAK,MAAM,EAGX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAInE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAcvC,wBAAgB,SAAS,wCAExB;AAED,wBAAgB,MAAM,4DAErB;AAED,wBAAgB,SAAS,kBAExB;AAED,wBAAgB,SAAS,kBAExB;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,QAExD;AA2CD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,SAAS,iCAwJ3E,CAAC"}

package/dist/_services.d.ts

@@ -1,2 +1,4 @@
+import type { AppConfig } from './app';
+export declare function createServices(config?: AppConfig): void;
 export declare function registerServices(o: any): void;
 //# sourceMappingURL=_services.d.ts.map

package/dist/_services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_services.d.ts","sourceRoot":"","sources":["../src/_services.ts"],"names":[],"mappings":"AA8IA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,QAqBtC"}
+{"version":3,"file":"_services.d.ts","sourceRoot":"","sources":["../src/_services.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAsIvC,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,QAkChD;AAGD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,QAqBtC"}

package/dist/_unauthenticated.d.ts

@@ -0,0 +1,26 @@
+import type { KeyValueStorage, ObjectStorage, StreamStorage, VectorStorage, DataResult, KeyValueStorageSetParams, ObjectResult, ObjectStorePutParams, CreatePublicURLParams, Stream, CreateStreamProps, ListStreamsParams, ListStreamsResponse, VectorUpsertParams, VectorUpsertResult, VectorResult, VectorSearchResultWithDocument, VectorSearchParams, VectorSearchResult } from '@agentuity/core';
+export declare class UnauthenticatedKeyValueStorage implements KeyValueStorage {
+    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>;
+}
+export declare class UnauthenticatedObjectStorage implements ObjectStorage {
+    get(_bucket: string, _key: string): Promise<ObjectResult>;
+    put(_bucket: string, _key: string, _data: Uint8Array | ArrayBuffer | ReadableStream, _params?: ObjectStorePutParams): Promise<void>;
+    delete(_bucket: string, _key: string): Promise<boolean>;
+    createPublicURL(_bucket: string, _key: string, _params?: CreatePublicURLParams): Promise<string>;
+}
+export declare class UnauthenticatedStreamStorage implements StreamStorage {
+    create(_name: string, _props?: CreateStreamProps): Promise<Stream>;
+    list(_params?: ListStreamsParams): Promise<ListStreamsResponse>;
+    delete(_id: string): Promise<void>;
+}
+export declare class UnauthenticatedVectorStorage implements VectorStorage {
+    upsert(_name: string, ..._documents: VectorUpsertParams[]): Promise<VectorUpsertResult[]>;
+    get<T extends Record<string, unknown> = Record<string, unknown>>(_name: string, _key: string): Promise<VectorResult<T>>;
+    getMany<T extends Record<string, unknown> = Record<string, unknown>>(_name: string, ..._keys: string[]): Promise<Map<string, VectorSearchResultWithDocument<T>>>;
+    search<T extends Record<string, unknown> = Record<string, unknown>>(_name: string, _params: VectorSearchParams<T>): Promise<VectorSearchResult<T>[]>;
+    delete(_name: string, ..._keys: string[]): Promise<number>;
+    exists(_name: string): Promise<boolean>;
+}
+//# sourceMappingURL=_unauthenticated.d.ts.map

package/dist/_unauthenticated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_unauthenticated.d.ts","sourceRoot":"","sources":["../src/_unauthenticated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,iBAAiB,CAAC;AAYzB,qBAAa,8BAA+B,YAAW,eAAe;IAC/D,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAI3D,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIV,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxD;AAED,qBAAa,4BAA6B,YAAW,aAAa;IAC3D,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzD,GAAG,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,EAChD,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAIV,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,eAAe,CACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC;CAGlB;AAED,qBAAa,4BAA6B,YAAW,aAAa;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlE,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC;AAED,qBAAa,4BAA6B,YAAW,aAAa;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIzF,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAIrB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,KAAK,EAAE,MAAM,EACb,GAAG,KAAK,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAAC,CAAC,CAAC;IAIpD,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAI7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG7C"}

package/dist/app.d.ts

@@ -2,12 +2,22 @@ import { type Env as HonoEnv, Hono } from 'hono';
 import { cors } from 'hono/cors';
 import type { Logger } from './logger';
 import { type Meter, type Tracer } from '@opentelemetry/api';
+import { type KeyValueStorage, type ObjectStorage, type StreamStorage, type VectorStorage } from '@agentuity/core';
 type CorsOptions = Parameters<typeof cors>[0];
 export interface AppConfig {
     /**
      * Override the default cors settings
      */
     cors?: CorsOptions;
+    /**
+     * Override the default services
+     */
+    services?: {
+        keyvalue?: KeyValueStorage;
+        object?: ObjectStorage;
+        stream?: StreamStorage;
+        vector?: VectorStorage;
+    };
 }
 export interface Variables {
     logger: Logger;

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,IAAI,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE7D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9C,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,GAAI,SAAQ,OAAO;IACnC,SAAS,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS;;;;EAK3C"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,IAAI,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,iBAAiB,CAAC;AAEzB,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9C,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,aAAa,CAAC;KACvB,CAAC;CACF;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,GAAI,SAAQ,OAAO;IACnC,SAAS,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS;;;;EAK3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/runtime",
-	"version": "0.0.35",
+	"version": "0.0.36",
 	"type": "module",
 	"main": "./src/index.ts",
 	"types": "./dist/index.d.ts",
@@ -23,8 +23,8 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.31",
-		"@agentuity/server": "0.0.31",
+		"@agentuity/core": "0.0.35",
+		"@agentuity/server": "0.0.35",
 		"@opentelemetry/api": "^1.9.0",
 		"@opentelemetry/api-logs": "^0.207.0",
 		"@opentelemetry/auto-instrumentations-node": "^0.66.0",

package/src/_config.ts

@@ -99,3 +99,12 @@ export function getCLIVersion(): string {
 export function getEnvironment(): string {
 	return process.env.AGENTUITY_ENVIRONMENT || process.env.NODE_ENV || 'development';
 }
+
+/**
+ * Returns true if the AGENTUITY_SDK_KEY is set
+ *
+ * @returns boolean
+ */
+export function isAuthenticated(): boolean {
+	return !!process.env.AGENTUITY_SDK_KEY;
+}

package/src/_server.ts

@@ -24,6 +24,7 @@ import type { Logger } from './logger';
 import { isIdle } from './_idle';
 import * as runtimeConfig from './_config';
 import { inAgentContext, getAgentContext } from './_context';
+import { createServices } from './_services';
 
 let globalServerInstance: Bun.Server<BunWebSocketData> | null = null;
 
@@ -110,11 +111,12 @@ function registerAgentuitySpanProcessor() {
 	addSpanProcessor(new RegisterAgentSpanProcessor());
 }
 
-export const createServer = <E extends Env>(app: Hono<E>, _config?: AppConfig) => {
+export const createServer = <E extends Env>(app: Hono<E>, config?: AppConfig) => {
 	if (globalServerInstance) {
 		return globalServerInstance;
 	}
 
+	createServices(config);
 	registerAgentuitySpanProcessor();
 
 	const server = Bun.serve({
@@ -140,6 +142,10 @@ export const createServer = <E extends Env>(app: Hono<E>, _config?: AppConfig) =
 			otel.logger.error('HTTP Error: %s (%d)', error.cause, error.status);
 			return error.getResponse();
 		}
+		if (error.name === 'UnauthenticatedError') {
+			otel.logger.error('Unauthenticated Error: %s', error.message);
+			return new Response(error.message, { status: 501 });
+		}
 		if (
 			error instanceof ServiceException ||
 			('statusCode' in error && typeof error.statusCode === 'number')
@@ -180,8 +186,8 @@ export const createServer = <E extends Env>(app: Hono<E>, _config?: AppConfig) =
 	app.use(
 		'*',
 		cors({
-			origin: _config?.cors?.origin ?? ((origin) => origin),
-			allowHeaders: _config?.cors?.allowHeaders ?? [
+			origin: config?.cors?.origin ?? ((origin) => origin),
+			allowHeaders: config?.cors?.allowHeaders ?? [
 				'Content-Type',
 				'Authorization',
 				'Accept',
@@ -192,7 +198,7 @@ export const createServer = <E extends Env>(app: Hono<E>, _config?: AppConfig) =
 			exposeHeaders: ['Content-Length'],
 			maxAge: 600,
 			credentials: true,
-			...(_config?.cors ?? {}), // allow the app config to override
+			...(config?.cors ?? {}), // allow the app config to override
 		})
 	);
 

package/src/_services.ts

@@ -4,6 +4,10 @@ import {
 	ObjectStorageService,
 	StreamStorageService,
 	VectorStorageService,
+	type KeyValueStorage,
+	type ObjectStorage,
+	type StreamStorage,
+	type VectorStorage,
 	type ListStreamsResponse,
 	type VectorUpsertResult,
 	type VectorSearchResult,
@@ -11,7 +15,14 @@ import {
 import { createServerFetchAdapter, getServiceUrls } from '@agentuity/server';
 import { injectTraceContextToHeaders } from './otel/http';
 import { getLogger, getTracer } from './_server';
-import { getSDKVersion } from './_config';
+import { getSDKVersion, isAuthenticated } from './_config';
+import type { AppConfig } from './app';
+import {
+	UnauthenticatedKeyValueStorage,
+	UnauthenticatedObjectStorage,
+	UnauthenticatedStreamStorage,
+	UnauthenticatedVectorStorage,
+} from './_unauthenticated';
 
 const userAgent = `Agentuity SDK/${getSDKVersion()}`;
 const bearerKey = `Bearer ${process.env.AGENTUITY_SDK_KEY}`;
@@ -134,10 +145,46 @@ const adapter = createServerFetchAdapter({
 	},
 });
 
-const kv = new KeyValueStorageService(kvBaseUrl, adapter);
-const objectStore = new ObjectStorageService(objectBaseUrl, adapter);
-const stream = new StreamStorageService(streamBaseUrl, adapter);
-const vector = new VectorStorageService(vectorBaseUrl, adapter);
+let kv: KeyValueStorage;
+let objectStore: ObjectStorage;
+let stream: StreamStorage;
+let vector: VectorStorage;
+
+export function createServices(config?: AppConfig) {
+	const authenticated = isAuthenticated();
+
+	if (config?.services?.keyvalue) {
+		kv = config.services.keyvalue;
+	} else if (authenticated) {
+		kv = new KeyValueStorageService(kvBaseUrl, adapter);
+	} else {
+		kv = new UnauthenticatedKeyValueStorage();
+	}
+
+	if (config?.services?.object) {
+		objectStore = config.services.object;
+	} else if (authenticated) {
+		objectStore = new ObjectStorageService(objectBaseUrl, adapter);
+	} else {
+		objectStore = new UnauthenticatedObjectStorage();
+	}
+
+	if (config?.services?.stream) {
+		stream = config.services.stream;
+	} else if (authenticated) {
+		stream = new StreamStorageService(streamBaseUrl, adapter);
+	} else {
+		stream = new UnauthenticatedStreamStorage();
+	}
+
+	if (config?.services?.vector) {
+		vector = config.services.vector;
+	} else if (authenticated) {
+		vector = new VectorStorageService(vectorBaseUrl, adapter);
+	} else {
+		vector = new UnauthenticatedVectorStorage();
+	}
+}
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function registerServices(o: any) {

package/src/_unauthenticated.ts

@@ -0,0 +1,126 @@
+import type {
+	KeyValueStorage,
+	ObjectStorage,
+	StreamStorage,
+	VectorStorage,
+	DataResult,
+	KeyValueStorageSetParams,
+	ObjectResult,
+	ObjectStorePutParams,
+	CreatePublicURLParams,
+	Stream,
+	CreateStreamProps,
+	ListStreamsParams,
+	ListStreamsResponse,
+	VectorUpsertParams,
+	VectorUpsertResult,
+	VectorResult,
+	VectorSearchResultWithDocument,
+	VectorSearchParams,
+	VectorSearchResult,
+} from '@agentuity/core';
+
+const UNAUTHENTICATED_ERROR =
+	'You must authenticate to use Agentuity services. Set the AGENTUITY_SDK_KEY environment variable or provide custom service implementations in your app config.';
+
+class UnauthenticatedError extends Error {
+	constructor() {
+		super(UNAUTHENTICATED_ERROR);
+		this.name = 'UnauthenticatedError';
+	}
+}
+
+export class UnauthenticatedKeyValueStorage implements KeyValueStorage {
+	async get<T>(_name: string, _key: string): Promise<DataResult<T>> {
+		throw new UnauthenticatedError();
+	}
+
+	async set<T = unknown>(
+		_name: string,
+		_key: string,
+		_value: T,
+		_params?: KeyValueStorageSetParams
+	): Promise<void> {
+		throw new UnauthenticatedError();
+	}
+
+	async delete(_name: string, _key: string): Promise<void> {
+		throw new UnauthenticatedError();
+	}
+}
+
+export class UnauthenticatedObjectStorage implements ObjectStorage {
+	async get(_bucket: string, _key: string): Promise<ObjectResult> {
+		throw new UnauthenticatedError();
+	}
+
+	async put(
+		_bucket: string,
+		_key: string,
+		_data: Uint8Array | ArrayBuffer | ReadableStream,
+		_params?: ObjectStorePutParams
+	): Promise<void> {
+		throw new UnauthenticatedError();
+	}
+
+	async delete(_bucket: string, _key: string): Promise<boolean> {
+		throw new UnauthenticatedError();
+	}
+
+	async createPublicURL(
+		_bucket: string,
+		_key: string,
+		_params?: CreatePublicURLParams
+	): Promise<string> {
+		throw new UnauthenticatedError();
+	}
+}
+
+export class UnauthenticatedStreamStorage implements StreamStorage {
+	async create(_name: string, _props?: CreateStreamProps): Promise<Stream> {
+		throw new UnauthenticatedError();
+	}
+
+	async list(_params?: ListStreamsParams): Promise<ListStreamsResponse> {
+		throw new UnauthenticatedError();
+	}
+
+	async delete(_id: string): Promise<void> {
+		throw new UnauthenticatedError();
+	}
+}
+
+export class UnauthenticatedVectorStorage implements VectorStorage {
+	async upsert(_name: string, ..._documents: VectorUpsertParams[]): Promise<VectorUpsertResult[]> {
+		throw new UnauthenticatedError();
+	}
+
+	async get<T extends Record<string, unknown> = Record<string, unknown>>(
+		_name: string,
+		_key: string
+	): Promise<VectorResult<T>> {
+		throw new UnauthenticatedError();
+	}
+
+	async getMany<T extends Record<string, unknown> = Record<string, unknown>>(
+		_name: string,
+		..._keys: string[]
+	): Promise<Map<string, VectorSearchResultWithDocument<T>>> {
+		throw new UnauthenticatedError();
+	}
+
+	async search<T extends Record<string, unknown> = Record<string, unknown>>(
+		_name: string,
+		_params: VectorSearchParams<T>
+	): Promise<VectorSearchResult<T>[]> {
+		throw new UnauthenticatedError();
+	}
+
+	async delete(_name: string, ..._keys: string[]): Promise<number> {
+		throw new UnauthenticatedError();
+	}
+
+	async exists(_name: string): Promise<boolean> {
+		throw new UnauthenticatedError();
+	}
+}

package/src/app.ts

@@ -3,6 +3,12 @@ import { cors } from 'hono/cors';
 import { createServer, getLogger } from './_server';
 import type { Logger } from './logger';
 import { type Meter, type Tracer } from '@opentelemetry/api';
+import {
+	type KeyValueStorage,
+	type ObjectStorage,
+	type StreamStorage,
+	type VectorStorage,
+} from '@agentuity/core';
 
 type CorsOptions = Parameters<typeof cors>[0];
 
@@ -11,6 +17,15 @@ export interface AppConfig {
 	 * Override the default cors settings
 	 */
 	cors?: CorsOptions;
+	/**
+	 * Override the default services
+	 */
+	services?: {
+		keyvalue?: KeyValueStorage;
+		object?: ObjectStorage;
+		stream?: StreamStorage;
+		vector?: VectorStorage;
+	};
 }
 
 export interface Variables {