@agentuity/hono 3.0.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @agentuity/hono - Agentuity middleware for Hono
+ *
+ * Provides the `agentuity()` middleware that initializes telemetry and service clients,
+ * injecting them into Hono's context variables.
+ *
+ * @example Basic usage (auto-configured from env vars):
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { agentuity } from '@agentuity/hono';
+ *
+ * const app = new Hono();
+ * app.use('*', agentuity());
+ *
+ * app.get('/data', async (c) => {
+ *   const { kv, logger } = c.var;
+ *   const data = await kv.get('namespace', 'key');
+ *   return c.json(data);
+ * });
+ * ```
+ */
+import { type TelemetryConfig, type TelemetryResponse, type Logger } from '@agentuity/telemetry';
+import { KeyValueClient, type KeyValueClientOptions } from '@agentuity/keyvalue';
+import { VectorClient, type VectorClientOptions } from '@agentuity/vector';
+import { StreamClient, type StreamClientOptions } from '@agentuity/stream';
+import { QueueClient, type QueueClientOptions } from '@agentuity/queue';
+import { EmailClient, type EmailClientOptions } from '@agentuity/email';
+import { TaskClient, type TaskClientOptions } from '@agentuity/task';
+import { ScheduleClient, type ScheduleClientOptions } from '@agentuity/schedule';
+import { SandboxClient, type SandboxClientOptions } from '@agentuity/sandbox';
+export interface ServicesConfig {
+    /** Logger instance */
+    logger?: Logger;
+    /** Service client options */
+    clients?: {
+        kv?: KeyValueClientOptions;
+        vector?: VectorClientOptions;
+        stream?: StreamClientOptions;
+        queue?: QueueClientOptions;
+        email?: EmailClientOptions;
+        task?: TaskClientOptions;
+        schedule?: ScheduleClientOptions;
+        sandbox?: SandboxClientOptions;
+    };
+}
+export interface Services {
+    kv: KeyValueClient;
+    stream: StreamClient;
+    vector: VectorClient;
+    sandbox: SandboxClient;
+    queue: QueueClient;
+    email: EmailClient;
+    schedule: ScheduleClient;
+    task: TaskClient;
+}
+export interface AgentuityOptions {
+    /** Telemetry configuration overrides */
+    telemetry?: Partial<TelemetryConfig>;
+    /** Services configuration */
+    services?: ServicesConfig;
+}
+/**
+ * Get initialized services. Throws if not initialized.
+ */
+export declare function getServices(): Services;
+/**
+ * Reset global state (for testing).
+ */
+export declare function resetServices(): void;
+/**
+ * Create the Agentuity middleware for Hono.
+ *
+ * Initializes telemetry and services at middleware composition time,
+ * making them available via Hono's context variables.
+ *
+ * Telemetry auto-configures from AGENTUITY_* environment variables.
+ * Services auto-configure from AGENTUITY_SDK_KEY.
+ */
+export declare function agentuity(options?: AgentuityOptions): import("hono/types").MiddlewareHandler<any, string, {}, Response>;
+/**
+ * Get the telemetry instance. Available after agentuity() is composed.
+ */
+export declare function getTelemetry(): TelemetryResponse | null;
+/**
+ * Reset global state (for testing).
+ */
+export declare function reset(): void;
+export type { TelemetryConfig, TelemetryResponse, Logger } from '@agentuity/telemetry';
+//# 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;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC9B,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE;QACT,EAAE,CAAC,EAAE,qBAAqB,CAAC;QAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;QAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;QAC3B,IAAI,CAAC,EAAE,iBAAiB,CAAC;QACzB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;QACjC,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAC/B,CAAC;CACF;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC1B;AA0BD;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,qEAgCnD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAGD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,119 @@
+/**
+ * @agentuity/hono - Agentuity middleware for Hono
+ *
+ * Provides the `agentuity()` middleware that initializes telemetry and service clients,
+ * injecting them into Hono's context variables.
+ *
+ * @example Basic usage (auto-configured from env vars):
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { agentuity } from '@agentuity/hono';
+ *
+ * const app = new Hono();
+ * app.use('*', agentuity());
+ *
+ * app.get('/data', async (c) => {
+ *   const { kv, logger } = c.var;
+ *   const data = await kv.get('namespace', 'key');
+ *   return c.json(data);
+ * });
+ * ```
+ */
+import { createMiddleware } from 'hono/factory';
+import { register, } from '@agentuity/telemetry';
+import { KeyValueClient } from '@agentuity/keyvalue';
+import { VectorClient } from '@agentuity/vector';
+import { StreamClient } from '@agentuity/stream';
+import { QueueClient } from '@agentuity/queue';
+import { EmailClient } from '@agentuity/email';
+import { TaskClient } from '@agentuity/task';
+import { ScheduleClient } from '@agentuity/schedule';
+import { SandboxClient } from '@agentuity/sandbox';
+// Global state (initialized once at composition time)
+let telemetryInstance = null;
+let globalServices = null;
+/**
+ * Initialize service clients.
+ */
+function initServices(config) {
+    if (globalServices)
+        return globalServices;
+    globalServices = {
+        kv: new KeyValueClient({ logger: config?.logger, ...config?.clients?.kv }),
+        stream: new StreamClient({ logger: config?.logger, ...config?.clients?.stream }),
+        vector: new VectorClient({ logger: config?.logger, ...config?.clients?.vector }),
+        queue: new QueueClient({ logger: config?.logger, ...config?.clients?.queue }),
+        email: new EmailClient({ logger: config?.logger, ...config?.clients?.email }),
+        task: new TaskClient({ logger: config?.logger, ...config?.clients?.task }),
+        schedule: new ScheduleClient({ logger: config?.logger, ...config?.clients?.schedule }),
+        sandbox: new SandboxClient({ logger: config?.logger, ...config?.clients?.sandbox }),
+    };
+    return globalServices;
+}
+/**
+ * Get initialized services. Throws if not initialized.
+ */
+export function getServices() {
+    if (!globalServices) {
+        throw new Error('Services not initialized. Call agentuity() first.');
+    }
+    return globalServices;
+}
+/**
+ * Reset global state (for testing).
+ */
+export function resetServices() {
+    globalServices = null;
+}
+/**
+ * Create the Agentuity middleware for Hono.
+ *
+ * Initializes telemetry and services at middleware composition time,
+ * making them available via Hono's context variables.
+ *
+ * Telemetry auto-configures from AGENTUITY_* environment variables.
+ * Services auto-configure from AGENTUITY_SDK_KEY.
+ */
+export function agentuity(options) {
+    // Initialize telemetry (auto-configures from env vars)
+    if (!telemetryInstance) {
+        telemetryInstance = register(options?.telemetry);
+    }
+    // Initialize services
+    initServices({
+        logger: telemetryInstance.logger,
+        ...options?.services,
+    });
+    // Return the middleware handler
+    return createMiddleware(async (c, next) => {
+        // Inject telemetry into context
+        c.set('tracer', telemetryInstance.tracer);
+        c.set('logger', telemetryInstance.logger);
+        c.set('meter', telemetryInstance.meter);
+        // Inject services into context
+        const services = getServices();
+        c.set('kv', services.kv);
+        c.set('stream', services.stream);
+        c.set('vector', services.vector);
+        c.set('queue', services.queue);
+        c.set('email', services.email);
+        c.set('schedule', services.schedule);
+        c.set('task', services.task);
+        c.set('sandbox', services.sandbox);
+        await next();
+    });
+}
+/**
+ * Get the telemetry instance. Available after agentuity() is composed.
+ */
+export function getTelemetry() {
+    return telemetryInstance;
+}
+/**
+ * Reset global state (for testing).
+ */
+export function reset() {
+    telemetryInstance = null;
+    resetServices();
+}
+//# 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,55 @@
+{
+	"name": "@agentuity/hono",
+	"version": "3.0.0-alpha.0",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": [
+		"src",
+		"dist"
+	],
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/telemetry": "3.0.0-alpha.0",
+		"@agentuity/keyvalue": "3.0.0-alpha.0",
+		"@agentuity/vector": "3.0.0-alpha.0",
+		"@agentuity/stream": "3.0.0-alpha.0",
+		"@agentuity/queue": "3.0.0-alpha.0",
+		"@agentuity/email": "3.0.0-alpha.0",
+		"@agentuity/task": "3.0.0-alpha.0",
+		"@agentuity/schedule": "3.0.0-alpha.0",
+		"@agentuity/sandbox": "3.0.0-alpha.0",
+		"@opentelemetry/api": "^1.9.0",
+		"hono": "^4.7.13"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"peerDependencies": {
+		"hono": "^4.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false,
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/agentuity/sdk.git",
+		"directory": "packages/hono"
+	}
+}

package/src/index.ts

@@ -0,0 +1,173 @@
+/**
+ * @agentuity/hono - Agentuity middleware for Hono
+ *
+ * Provides the `agentuity()` middleware that initializes telemetry and service clients,
+ * injecting them into Hono's context variables.
+ *
+ * @example Basic usage (auto-configured from env vars):
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { agentuity } from '@agentuity/hono';
+ *
+ * const app = new Hono();
+ * app.use('*', agentuity());
+ *
+ * app.get('/data', async (c) => {
+ *   const { kv, logger } = c.var;
+ *   const data = await kv.get('namespace', 'key');
+ *   return c.json(data);
+ * });
+ * ```
+ */
+
+import { createMiddleware } from 'hono/factory';
+import {
+	register,
+	type TelemetryConfig,
+	type TelemetryResponse,
+	type Logger,
+} from '@agentuity/telemetry';
+import { KeyValueClient, type KeyValueClientOptions } from '@agentuity/keyvalue';
+import { VectorClient, type VectorClientOptions } from '@agentuity/vector';
+import { StreamClient, type StreamClientOptions } from '@agentuity/stream';
+import { QueueClient, type QueueClientOptions } from '@agentuity/queue';
+import { EmailClient, type EmailClientOptions } from '@agentuity/email';
+import { TaskClient, type TaskClientOptions } from '@agentuity/task';
+import { ScheduleClient, type ScheduleClientOptions } from '@agentuity/schedule';
+import { SandboxClient, type SandboxClientOptions } from '@agentuity/sandbox';
+
+export interface ServicesConfig {
+	/** Logger instance */
+	logger?: Logger;
+	/** Service client options */
+	clients?: {
+		kv?: KeyValueClientOptions;
+		vector?: VectorClientOptions;
+		stream?: StreamClientOptions;
+		queue?: QueueClientOptions;
+		email?: EmailClientOptions;
+		task?: TaskClientOptions;
+		schedule?: ScheduleClientOptions;
+		sandbox?: SandboxClientOptions;
+	};
+}
+
+export interface Services {
+	kv: KeyValueClient;
+	stream: StreamClient;
+	vector: VectorClient;
+	sandbox: SandboxClient;
+	queue: QueueClient;
+	email: EmailClient;
+	schedule: ScheduleClient;
+	task: TaskClient;
+}
+
+export interface AgentuityOptions {
+	/** Telemetry configuration overrides */
+	telemetry?: Partial<TelemetryConfig>;
+	/** Services configuration */
+	services?: ServicesConfig;
+}
+
+// Global state (initialized once at composition time)
+let telemetryInstance: TelemetryResponse | null = null;
+let globalServices: Services | null = null;
+
+/**
+ * Initialize service clients.
+ */
+function initServices(config?: ServicesConfig): Services {
+	if (globalServices) return globalServices;
+
+	globalServices = {
+		kv: new KeyValueClient({ logger: config?.logger, ...config?.clients?.kv }),
+		stream: new StreamClient({ logger: config?.logger, ...config?.clients?.stream }),
+		vector: new VectorClient({ logger: config?.logger, ...config?.clients?.vector }),
+		queue: new QueueClient({ logger: config?.logger, ...config?.clients?.queue }),
+		email: new EmailClient({ logger: config?.logger, ...config?.clients?.email }),
+		task: new TaskClient({ logger: config?.logger, ...config?.clients?.task }),
+		schedule: new ScheduleClient({ logger: config?.logger, ...config?.clients?.schedule }),
+		sandbox: new SandboxClient({ logger: config?.logger, ...config?.clients?.sandbox }),
+	};
+
+	return globalServices;
+}
+
+/**
+ * Get initialized services. Throws if not initialized.
+ */
+export function getServices(): Services {
+	if (!globalServices) {
+		throw new Error('Services not initialized. Call agentuity() first.');
+	}
+	return globalServices;
+}
+
+/**
+ * Reset global state (for testing).
+ */
+export function resetServices(): void {
+	globalServices = null;
+}
+
+/**
+ * Create the Agentuity middleware for Hono.
+ *
+ * Initializes telemetry and services at middleware composition time,
+ * making them available via Hono's context variables.
+ *
+ * Telemetry auto-configures from AGENTUITY_* environment variables.
+ * Services auto-configure from AGENTUITY_SDK_KEY.
+ */
+export function agentuity(options?: AgentuityOptions) {
+	// Initialize telemetry (auto-configures from env vars)
+	if (!telemetryInstance) {
+		telemetryInstance = register(options?.telemetry);
+	}
+
+	// Initialize services
+	initServices({
+		logger: telemetryInstance.logger,
+		...options?.services,
+	});
+
+	// Return the middleware handler
+	return createMiddleware(async (c, next) => {
+		// Inject telemetry into context
+		c.set('tracer', telemetryInstance!.tracer as any);
+		c.set('logger', telemetryInstance!.logger as any);
+		c.set('meter', telemetryInstance!.meter as any);
+
+		// Inject services into context
+		const services = getServices();
+		c.set('kv', services.kv as any);
+		c.set('stream', services.stream as any);
+		c.set('vector', services.vector as any);
+		c.set('queue', services.queue as any);
+		c.set('email', services.email as any);
+		c.set('schedule', services.schedule as any);
+		c.set('task', services.task as any);
+		c.set('sandbox', services.sandbox as any);
+
+		await next();
+	});
+}
+
+/**
+ * Get the telemetry instance. Available after agentuity() is composed.
+ */
+export function getTelemetry(): TelemetryResponse | null {
+	return telemetryInstance;
+}
+
+/**
+ * Reset global state (for testing).
+ */
+export function reset(): void {
+	telemetryInstance = null;
+	resetServices();
+}
+
+// Re-export types
+export type { TelemetryConfig, TelemetryResponse, Logger } from '@agentuity/telemetry';