@agentuity/runtime 0.0.69 → 0.0.70

package/src/app.ts

@@ -8,7 +8,6 @@ import { createServer, getLogger } from './_server';
 import type { Meter, Tracer } from '@opentelemetry/api';
 import type {
 	KeyValueStorage,
-	ObjectStorage,
 	SessionEventProvider,
 	EvalRunEventProvider,
 	StreamStorage,
@@ -16,7 +15,7 @@ import type {
 	SessionStartEvent,
 } from '@agentuity/core';
 import type { Email } from './io/email';
-import type { Agent, AgentContext, AgentRegistry } from './agent';
+import type { Agent, AgentContext } from './agent';
 import type { ThreadProvider, SessionProvider, Session, Thread } from './session';
 import type WaitUntilHandler from './_waituntil';
 
@@ -44,10 +43,6 @@ export interface AppConfig<TAppState = Record<string, never>> {
 		 * the KeyValueStorage to override instead of the default
 		 */
 		keyvalue?: KeyValueStorage;
-		/**
-		 * the ObjectStorage to override instead of the default
-		 */
-		object?: ObjectStorage;
 		/**
 		 * the StreamStorage to override instead of the default
 		 */
@@ -97,9 +92,7 @@ export interface Variables<TAppState = Record<string, never>> {
 	sessionId: string;
 	thread: Thread;
 	session: Session;
-	agent: AgentRegistry;
 	kv: KeyValueStorage;
-	objectstore: ObjectStorage;
 	stream: StreamStorage;
 	vector: VectorStorage;
 	app: TAppState;
@@ -119,17 +112,11 @@ export interface Env<TAppState = Record<string, never>> extends HonoEnv {
 }
 
 type AppEventMap<TAppState = Record<string, never>> = {
-	'agent.started': [
-		Agent<any, any, any, any, TAppState>,
-		AgentContext<any, any, any, any, TAppState>,
-	];
-	'agent.completed': [
-		Agent<any, any, any, any, TAppState>,
-		AgentContext<any, any, any, any, TAppState>,
-	];
+	'agent.started': [Agent<any, any, any, any, TAppState>, AgentContext<any, any, TAppState>];
+	'agent.completed': [Agent<any, any, any, any, TAppState>, AgentContext<any, any, TAppState>];
 	'agent.errored': [
 		Agent<any, any, any, any, TAppState>,
-		AgentContext<any, any, any, any, TAppState>,
+		AgentContext<any, any, TAppState>,
 		Error,
 	];
 	'session.started': [Session];
@@ -356,7 +343,7 @@ export function getApp(): App<any> | null {
  * });
  *
  * // Access state in agents
- * const agent = createAgent({
+ * const agent = createAgent('user-query', {
  *   handler: async (ctx, input) => {
  *     const db = ctx.app.db; // Strongly typed!
  *     return db.query('SELECT * FROM users');

package/src/eval.ts

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import type { StandardSchemaV1 } from '@agentuity/core';
+import type { StandardSchemaV1, InferInput, InferOutput } from '@agentuity/core';
 import type { AgentContext } from './agent';
 
 // Eval SDK types
@@ -75,14 +75,14 @@ export type ExternalEvalMetadata = {
 
 export type EvalMetadata = InternalEvalMetadata & ExternalEvalMetadata;
 
-type InferSchemaInput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferInput<T> : any;
-type InferSchemaOutput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<T> : any;
+type InferSchemaInput<T> = T extends StandardSchemaV1 ? InferInput<T> : any;
+type InferSchemaOutput<T> = T extends StandardSchemaV1 ? InferOutput<T> : any;
 
-export type EvalFunction<TInput = any, TOutput = any> = TInput extends undefined
-	? TOutput extends undefined
+export type EvalFunction<TInput = any, TOutput = any> = [TInput] extends [undefined]
+	? [TOutput] extends [undefined]
 		? (ctx: EvalContext) => Promise<EvalRunResult>
 		: (ctx: EvalContext, output: TOutput) => Promise<EvalRunResult>
-	: TOutput extends undefined
+	: [TOutput] extends [undefined]
 		? (ctx: EvalContext, input: TInput) => Promise<EvalRunResult>
 		: (ctx: EvalContext, input: TInput, output: TOutput) => Promise<EvalRunResult>;
 

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './router';
 export * from './eval';
 export * from './session';
 export * from './workbench';
+export * from './validator';
 export type { Logger } from './logger';
 export { getRouter, getAppState } from './_server';
 export { Email, parseEmail } from './io/email';
@@ -36,7 +37,7 @@ export type { RouteSchema, GetRouteSchema } from './_validation';
  * });
  *
  * // In your agent:
- * const agent = createAgent({
+ * const agent = createAgent('user-query', {
  *   handler: async (ctx, input) => {
  *     // ctx.app is strongly typed with { db, redis }!
  *     const user = await ctx.app.db.query('SELECT * FROM users');

package/src/otel/config.ts

@@ -1,5 +1,6 @@
 import type { LogLevel } from '@agentuity/core';
 import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { getServiceUrls } from '@agentuity/server';
 import * as runtimeConfig from '../_config';
 import type { OtelConfig, OtelResponse } from './otel';
 import { registerOtel } from './otel';
@@ -22,8 +23,10 @@ interface OtelRegisterConfig {
 }
 
 export function register(registerConfig: OtelRegisterConfig): OtelResponse {
-	const url = process.env.AGENTUITY_OTLP_URL ?? 'https://otel.agentuity.cloud';
-	const bearerToken = process.env.AGENTUITY_OTLP_BEARER_TOKEN;
+	const region = process.env.AGENTUITY_REGION ?? 'usc';
+	const serviceUrls = getServiceUrls(region);
+	const url = serviceUrls.otel;
+	const bearerToken = process.env.AGENTUITY_OTLP_BEARER_TOKEN ?? process.env.AGENTUITY_SDK_KEY;
 	const config: OtelConfig = {
 		spanProcessors: registerConfig.processors,
 		name: runtimeConfig.getAppName(),

package/src/otel/console.ts

@@ -1,26 +1,14 @@
 import { SeverityNumber } from '@opentelemetry/api-logs';
 import { type ExportResult, ExportResultCode } from '@opentelemetry/core';
 import type { LogRecordExporter, ReadableLogRecord } from '@opentelemetry/sdk-logs';
-import { type ColorScheme, createLogger } from '@agentuity/server';
-import type { Logger, LogLevel } from '@agentuity/core';
+import type { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { __originalConsole } from './logger';
 
 /**
  * Console implementation of the LogRecordExporter interface
+ * Uses __originalConsole to avoid infinite loop when console is patched
  */
 export class ConsoleLogRecordExporter implements LogRecordExporter {
-	private readonly logger: Logger;
-
-	/**
-	 * Creates a new console log record exporter
-	 */
-	constructor(logLevel: LogLevel) {
-		this.logger = createLogger(
-			logLevel,
-			false,
-			(process.env.COLOR_SCHEME as ColorScheme) ?? 'dark'
-		);
-	}
-
 	/**
 	 * Exports log records to the console
 	 *
@@ -29,21 +17,23 @@ export class ConsoleLogRecordExporter implements LogRecordExporter {
 	 */
 	export(logs: ReadableLogRecord[], resultCallback: (result: ExportResult) => void): void {
 		for (const log of logs) {
+			const severity = log.severityNumber ? SeverityNumber[log.severityNumber] : 'INFO';
+			const msg = `[${severity}] ${log.body}`;
 			switch (log.severityNumber) {
 				case SeverityNumber.DEBUG:
-					this.logger.debug(log.body);
+					__originalConsole.debug(msg);
 					break;
 				case SeverityNumber.INFO:
-					this.logger.info(log.body);
+					__originalConsole.info(msg);
 					break;
 				case SeverityNumber.WARN:
-					this.logger.warn(log.body);
+					__originalConsole.warn(msg);
 					break;
 				case SeverityNumber.ERROR:
-					this.logger.error(log.body);
+					__originalConsole.error(msg);
 					break;
 				default:
-					this.logger.info(log.body);
+					__originalConsole.log(msg);
 					break;
 			}
 		}
@@ -59,3 +49,27 @@ export class ConsoleLogRecordExporter implements LogRecordExporter {
 		return Promise.resolve();
 	}
 }
+
+/**
+ * Console implementation of the SpanExporter interface
+ * Uses __originalConsole to avoid infinite loop when console is patched
+ */
+export class DebugSpanExporter implements SpanExporter {
+	export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {
+		for (const span of spans) {
+			__originalConsole.log('[SPAN]', {
+				name: span.name,
+				traceId: span.spanContext().traceId,
+				spanId: span.spanContext().spanId,
+				duration: span.duration,
+				status: span.status,
+				attributes: span.attributes,
+			});
+		}
+		resultCallback({ code: ExportResultCode.SUCCESS });
+	}
+
+	shutdown(): Promise<void> {
+		return Promise.resolve();
+	}
+}

package/src/otel/logger.ts

@@ -3,7 +3,6 @@ import { safeStringify, type LogLevel } from '@agentuity/core';
 import * as LogsAPI from '@opentelemetry/api-logs';
 import type { Logger } from '../logger';
 import ConsoleLogger from '../logger/console';
-import { getAgentContext } from '../_context';
 
 /**
  * Reference to the original console object before patching
@@ -41,23 +40,6 @@ export class OtelLogger implements Logger {
 	}
 
 	private getAttributes(): Record<string, unknown> | undefined {
-		try {
-			const actx = getAgentContext();
-			const current = actx.current?.metadata;
-			if (current) {
-				const result: Record<string, unknown> = {
-					...(this.context ?? {}),
-				};
-				for (const [key, value] of Object.entries(current)) {
-					if (value !== null && value !== undefined) {
-						result[`@agentuity/${key}`] = value as unknown;
-					}
-				}
-				return result;
-			}
-		} catch {
-			/* fall through */
-		}
 		return this.context;
 	}
 

package/src/otel/otel.ts

@@ -1,5 +1,5 @@
 import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
-import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';
 import opentelemetry, { type Meter, metrics, propagation, type Tracer } from '@opentelemetry/api';
 import * as LogsAPI from '@opentelemetry/api-logs';
 import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
@@ -26,7 +26,7 @@ import { NodeSDK } from '@opentelemetry/sdk-node';
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
 import { initialize } from '@traceloop/node-server-sdk';
 import type { Logger } from '../logger';
-import { ConsoleLogRecordExporter } from './console';
+import { ConsoleLogRecordExporter, DebugSpanExporter } from './console';
 import { instrumentFetch } from './fetch';
 import { createLogger, patchConsole } from './logger';
 import { getSDKVersion, isAuthenticated } from '../_config';
@@ -88,19 +88,22 @@ export const createAgentuityLoggerProvider = ({
 	url,
 	headers,
 	resource,
-	logLevel,
 	jsonlBasePath,
+	useConsoleExporters,
 }: {
 	url?: string;
 	headers?: Record<string, string>;
 	resource: Resource;
 	logLevel: LogLevel;
 	jsonlBasePath?: string;
+	useConsoleExporters: boolean;
 }) => {
 	let processor: LogRecordProcessor;
 	let exporter: OTLPLogExporter | JSONLLogExporter | undefined;
 
-	if (jsonlBasePath) {
+	if (useConsoleExporters) {
+		processor = new SimpleLogRecordProcessor(new ConsoleLogRecordExporter());
+	} else if (jsonlBasePath) {
 		exporter = new JSONLLogExporter(jsonlBasePath);
 		processor = new BatchLogRecordProcessor(exporter);
 	} else if (url) {
@@ -114,7 +117,7 @@ export const createAgentuityLoggerProvider = ({
 		exporter = otlpExporter;
 		processor = new BatchLogRecordProcessor(otlpExporter);
 	} else {
-		processor = new SimpleLogRecordProcessor(new ConsoleLogRecordExporter(logLevel));
+		processor = new SimpleLogRecordProcessor(new ConsoleLogRecordExporter());
 	}
 	const provider = new LoggerProvider({
 		resource,
@@ -184,6 +187,9 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 		headers.Authorization = `Bearer ${bearerToken}`;
 	}
 
+	// use console debug exporters for local debugging
+	const useConsoleExporters = process.env.AGENTUITY_DEBUG_OTEL_CONSOLE === 'true';
+
 	const resource = createResource(config);
 	const loggerProvider = createAgentuityLoggerProvider({
 		url,
@@ -191,6 +197,7 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 		resource,
 		logLevel,
 		jsonlBasePath,
+		useConsoleExporters,
 	});
 	const attrs = {
 		'@agentuity/orgId': orgId ?? 'unknown',
@@ -205,6 +212,7 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 	// must do this after we have created the logger
 	patchConsole(!!url, attrs, logLevel);
 
+	// Build trace exporter (OTLP or JSONL)
 	const traceExporter = jsonlBasePath
 		? new JSONLTraceExporter(jsonlBasePath)
 		: url
@@ -216,6 +224,7 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 				})
 			: undefined;
 
+	// Build metric exporter (OTLP or JSONL)
 	const metricExporter = jsonlBasePath
 		? new JSONLMetricExporter(jsonlBasePath)
 		: url
@@ -227,28 +236,36 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 				})
 			: undefined;
 
-	// Create span processor for the trace exporter
-	const traceSpanProcessor = traceExporter ? new BatchSpanProcessor(traceExporter) : undefined;
+	// Create span processors
+	const spanProcessors: SpanProcessor[] = [];
+
+	// Add OTLP/JSONL span processor if we have an exporter
+	if (traceExporter) {
+		spanProcessors.push(new BatchSpanProcessor(traceExporter));
+	}
+
+	// Add debug span processor if console debugging is enabled
+	if (useConsoleExporters) {
+		spanProcessors.push(new SimpleSpanProcessor(new DebugSpanExporter()));
+	}
 
 	// Create a separate metric reader for the NodeSDK
-	const sdkMetricReader =
-		url && metricExporter
-			? new PeriodicExportingMetricReader({
-					exporter: metricExporter,
-					exportTimeoutMillis: devmode ? devmodeExportInterval : productionExportInterval,
-					exportIntervalMillis: devmode ? devmodeExportInterval : productionExportInterval,
-				})
-			: undefined;
+	const sdkMetricReader = metricExporter
+		? new PeriodicExportingMetricReader({
+				exporter: metricExporter,
+				exportTimeoutMillis: devmode ? devmodeExportInterval : productionExportInterval,
+				exportIntervalMillis: devmode ? devmodeExportInterval : productionExportInterval,
+			})
+		: undefined;
 
 	// Create a separate metric reader for the MeterProvider
-	const hostMetricReader =
-		url && metricExporter
-			? new PeriodicExportingMetricReader({
-					exporter: metricExporter,
-					exportTimeoutMillis: devmode ? devmodeExportInterval : productionExportInterval,
-					exportIntervalMillis: devmode ? devmodeExportInterval : productionExportInterval,
-				})
-			: undefined;
+	const hostMetricReader = metricExporter
+		? new PeriodicExportingMetricReader({
+				exporter: metricExporter,
+				exportTimeoutMillis: devmode ? devmodeExportInterval : productionExportInterval,
+				exportIntervalMillis: devmode ? devmodeExportInterval : productionExportInterval,
+			})
+		: undefined;
 
 	const meterProvider = hostMetricReader
 		? new MeterProvider({
@@ -266,7 +283,7 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 	let running = false;
 	let instrumentationSDK: NodeSDK | undefined;
 
-	if (url) {
+	if (url || useConsoleExporters) {
 		const propagator = new CompositePropagator({
 			propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],
 		});
@@ -274,11 +291,8 @@ export function registerOtel(config: OtelConfig): OtelResponse {
 
 		instrumentFetch();
 
-		// Combine custom span processors with the trace exporter processor
-		const allSpanProcessors = [
-			...(traceSpanProcessor ? [traceSpanProcessor] : []),
-			...(config.spanProcessors || []),
-		];
+		// Combine custom span processors with our span processors
+		const allSpanProcessors = [...spanProcessors, ...(config.spanProcessors || [])];
 
 		instrumentationSDK = new NodeSDK({
 			logRecordProcessor: loggerProvider.processor,

package/src/services/local/_db.ts

@@ -47,25 +47,6 @@ function initializeTables(db: Database): void {
 		WHERE expires_at IS NOT NULL
 	`);
 
-	// Object Storage table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS object_storage (
-			project_path TEXT NOT NULL,
-			bucket TEXT NOT NULL,
-			key TEXT NOT NULL,
-			data BLOB NOT NULL,
-			content_type TEXT NOT NULL DEFAULT 'application/octet-stream',
-			content_encoding TEXT,
-			cache_control TEXT,
-			content_disposition TEXT,
-			content_language TEXT,
-			metadata TEXT,
-			created_at INTEGER NOT NULL,
-			updated_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, bucket, key)
-		)
-	`);
-
 	// Stream Storage table
 	db.run(`
 		CREATE TABLE IF NOT EXISTS stream_storage (
@@ -125,9 +106,6 @@ function cleanupOrphanedProjects(db: Database): void {
 	const kvPaths = db.query('SELECT DISTINCT project_path FROM kv_storage').all() as Array<{
 		project_path: string;
 	}>;
-	const objectPaths = db.query('SELECT DISTINCT project_path FROM object_storage').all() as Array<{
-		project_path: string;
-	}>;
 	const streamPaths = db.query('SELECT DISTINCT project_path FROM stream_storage').all() as Array<{
 		project_path: string;
 	}>;
@@ -137,7 +115,7 @@ function cleanupOrphanedProjects(db: Database): void {
 
 	// Combine and deduplicate all project paths
 	const allPaths = new Set<string>();
-	[...kvPaths, ...objectPaths, ...streamPaths, ...vectorPaths].forEach((row) => {
+	[...kvPaths, ...streamPaths, ...vectorPaths].forEach((row) => {
 		allPaths.add(row.project_path);
 	});
 
@@ -155,9 +133,6 @@ function cleanupOrphanedProjects(db: Database): void {
 
 		// Delete from all tables
 		const deleteKv = db.prepare(`DELETE FROM kv_storage WHERE project_path IN (${placeholders})`);
-		const deleteObject = db.prepare(
-			`DELETE FROM object_storage WHERE project_path IN (${placeholders})`
-		);
 		const deleteStream = db.prepare(
 			`DELETE FROM stream_storage WHERE project_path IN (${placeholders})`
 		);
@@ -166,7 +141,6 @@ function cleanupOrphanedProjects(db: Database): void {
 		);
 
 		deleteKv.run(...pathsToDelete);
-		deleteObject.run(...pathsToDelete);
 		deleteStream.run(...pathsToDelete);
 		deleteVector.run(...pathsToDelete);
 

package/src/services/local/_router.ts

@@ -8,52 +8,6 @@ export function createLocalStorageRouter(db: Database, projectPath: string): any
 	// so we can detect if we're running in local mode easily
 	router.get('/_agentuity/local/health', (c) => c.text('OK'));
 
-	// Serve objects: GET /_agentuity/local/object/:bucket/:key
-	router.get('/_agentuity/local/object/:bucket/:key', async (c) => {
-		const bucket = c.req.param('bucket');
-		const key = c.req.param('key');
-
-		const query = db.query(`
-			SELECT data, content_type, content_encoding, cache_control, 
-						 content_disposition, content_language 
-			FROM object_storage 
-			WHERE project_path = ? AND bucket = ? AND key = ?
-		`);
-
-		const row = query.get(projectPath, bucket, key) as {
-			data: Buffer;
-			content_type: string;
-			content_encoding: string | null;
-			cache_control: string | null;
-			content_disposition: string | null;
-			content_language: string | null;
-		} | null;
-
-		if (!row) {
-			return c.notFound();
-		}
-
-		// Set headers
-		const headers: Record<string, string> = {
-			'Content-Type': row.content_type,
-		};
-
-		if (row.content_encoding) {
-			headers['Content-Encoding'] = row.content_encoding;
-		}
-		if (row.cache_control) {
-			headers['Cache-Control'] = row.cache_control;
-		}
-		if (row.content_disposition) {
-			headers['Content-Disposition'] = row.content_disposition;
-		}
-		if (row.content_language) {
-			headers['Content-Language'] = row.content_language;
-		}
-
-		return c.body(new Uint8Array(row.data), 200, headers);
-	});
-
 	// Serve streams: GET /_agentuity/local/stream/:id
 	router.get('/_agentuity/local/stream/:id', async (c) => {
 		const id = c.req.param('id');

package/src/services/local/index.ts

@@ -2,6 +2,5 @@ export { getLocalDB, closeLocalDB } from './_db';
 export { normalizeProjectPath, simpleEmbedding, cosineSimilarity } from './_util';
 export { createLocalStorageRouter } from './_router';
 export { LocalKeyValueStorage } from './keyvalue';
-export { LocalObjectStorage } from './objectstore';
 export { LocalStreamStorage } from './stream';
 export { LocalVectorStorage } from './vector';

package/src/session.ts

@@ -30,7 +30,7 @@ type SessionEventCallback<T extends Session> = (
  * @example
  * ```typescript
  * // Access thread in agent handler
- * const agent = createAgent({
+ * const agent = createAgent('conversation', {
  *   handler: async (ctx, input) => {
  *     // Get thread ID
  *     ctx.logger.info('Thread: %s', ctx.thread.id);
@@ -135,7 +135,7 @@ export interface Thread {
  *
  * @example
  * ```typescript
- * const agent = createAgent({
+ * const agent = createAgent('request-handler', {
  *   handler: async (ctx, input) => {
  *     // Get session ID (unique per request)
  *     ctx.logger.info('Session: %s', ctx.session.id);