@agentuity/runtime 1.0.22 → 1.0.23

package/src/app.ts

@@ -12,6 +12,9 @@ import type {
 	VectorStorage,
 	SandboxService,
 	QueueService,
+	EmailService,
+	ScheduleService,
+	TaskStorage,
 	SessionStartEvent,
 } from '@agentuity/core';
 
@@ -182,6 +185,10 @@ export interface AppConfig<TAppState = Record<string, never>> {
 		 * the VectorStorage to override instead of the default
 		 */
 		vector?: VectorStorage;
+		/**
+		 * the TaskStorage to override instead of the default
+		 */
+		task?: TaskStorage;
 		/**
 		 * the ThreadProvider to override instead of the default
 		 */
@@ -198,6 +205,10 @@ export interface AppConfig<TAppState = Record<string, never>> {
 		 * the EvalRunEventProvider to override instead of the default
 		 */
 		evalRunEvent?: EvalRunEventProvider;
+		/**
+		 * the EmailService to override instead of the default
+		 */
+		email?: EmailService;
 	};
 	/**
 	 * Optional setup function called before server starts
@@ -229,6 +240,9 @@ export interface Variables<TAppState = Record<string, never>> {
 	vector: VectorStorage;
 	sandbox: SandboxService;
 	queue: QueueService;
+	email: EmailService;
+	schedule: ScheduleService;
+	task: TaskStorage;
 	app: TAppState;
 	// Web analytics context (set by createWebSessionMiddleware, thread-only tracking)
 	_webThreadId?: string;

package/src/middleware.ts

@@ -61,6 +61,9 @@ export const AGENT_CONTEXT_PROPERTIES = [
 	'vector',
 	'sandbox',
 	'queue',
+	'email',
+	'schedule',
+	'task',
 	'state',
 	'thread',
 	'session',
@@ -118,6 +121,9 @@ export function createBaseMiddleware(config: MiddlewareConfig) {
 		c.set('vector', services.vector);
 		c.set('sandbox', services.sandbox);
 		c.set('queue', services.queue);
+		c.set('email', services.email);
+		c.set('schedule', services.schedule);
+		c.set('task', services.task);
 
 		installContextPropertyHelpers(c);
 
@@ -509,9 +515,7 @@ export function createOtelMiddleware() {
 
 						// Check if this is a WebSocket response that needs deferred finalization
 						// eslint-disable-next-line @typescript-eslint/no-explicit-any
-						const wsDone = (c as any).get(WS_DONE_PROMISE_KEY) as
-							| Promise<void>
-							| undefined;
+						const wsDone = (c as any).get(WS_DONE_PROMISE_KEY) as Promise<void> | undefined;
 
 						// Check if Hono caught an error (c.error is set by Hono's error handler)
 						// or if the response status indicates an error

package/src/services/local/_db.ts

@@ -96,6 +96,49 @@ function initializeTables(db: Database): void {
 		CREATE INDEX IF NOT EXISTS idx_vector_name 
 		ON vector_storage(project_path, name)
 	`);
+
+	// Task Storage table
+	db.run(`
+		CREATE TABLE IF NOT EXISTS task_storage (
+			project_path TEXT NOT NULL,
+			id TEXT NOT NULL,
+			title TEXT NOT NULL,
+			description TEXT,
+			metadata TEXT,
+			priority TEXT NOT NULL DEFAULT 'none',
+			parent_id TEXT,
+			type TEXT NOT NULL,
+			status TEXT NOT NULL DEFAULT 'open',
+			open_date TEXT,
+			in_progress_date TEXT,
+			closed_date TEXT,
+			created_id TEXT NOT NULL,
+			assigned_id TEXT,
+			closed_id TEXT,
+			created_at INTEGER NOT NULL,
+			updated_at INTEGER NOT NULL,
+			PRIMARY KEY (project_path, id)
+		)
+	`);
+
+	// Task Changelog table
+	db.run(`
+		CREATE TABLE IF NOT EXISTS task_changelog_storage (
+			project_path TEXT NOT NULL,
+			id TEXT NOT NULL,
+			task_id TEXT NOT NULL,
+			field TEXT NOT NULL,
+			old_value TEXT,
+			new_value TEXT,
+			created_at INTEGER NOT NULL,
+			PRIMARY KEY (project_path, id)
+		)
+	`);
+
+	db.run(`
+		CREATE INDEX IF NOT EXISTS idx_task_changelog_lookup
+		ON task_changelog_storage(project_path, task_id)
+	`);
 }
 
 function cleanupOrphanedProjects(db: Database): void {
@@ -112,12 +155,22 @@ function cleanupOrphanedProjects(db: Database): void {
 	const vectorPaths = db.query('SELECT DISTINCT project_path FROM vector_storage').all() as Array<{
 		project_path: string;
 	}>;
+	const taskPaths = db.query('SELECT DISTINCT project_path FROM task_storage').all() as Array<{
+		project_path: string;
+	}>;
+	const taskChangelogPaths = db
+		.query('SELECT DISTINCT project_path FROM task_changelog_storage')
+		.all() as Array<{
+		project_path: string;
+	}>;
 
 	// Combine and deduplicate all project paths
 	const allPaths = new Set<string>();
-	[...kvPaths, ...streamPaths, ...vectorPaths].forEach((row) => {
-		allPaths.add(row.project_path);
-	});
+	[...kvPaths, ...streamPaths, ...vectorPaths, ...taskPaths, ...taskChangelogPaths].forEach(
+		(row) => {
+			allPaths.add(row.project_path);
+		}
+	);
 
 	// Check which paths no longer exist and are not the current project
 	const pathsToDelete: string[] = [];
@@ -139,10 +192,18 @@ function cleanupOrphanedProjects(db: Database): void {
 		const deleteVector = db.prepare(
 			`DELETE FROM vector_storage WHERE project_path IN (${placeholders})`
 		);
+		const deleteTasks = db.prepare(
+			`DELETE FROM task_storage WHERE project_path IN (${placeholders})`
+		);
+		const deleteTaskChangelog = db.prepare(
+			`DELETE FROM task_changelog_storage WHERE project_path IN (${placeholders})`
+		);
 
 		deleteKv.run(...pathsToDelete);
 		deleteStream.run(...pathsToDelete);
 		deleteVector.run(...pathsToDelete);
+		deleteTasks.run(...pathsToDelete);
+		deleteTaskChangelog.run(...pathsToDelete);
 
 		console.log(`[LocalDB] Cleaned up data for ${pathsToDelete.length} orphaned project(s)`);
 	}

package/src/services/local/email.ts

@@ -0,0 +1,75 @@
+import {
+	StructuredError,
+	type EmailService,
+	type EmailAddress,
+	type EmailDestination,
+	type EmailInbound,
+	type EmailOutbound,
+	type EmailSendParams,
+} from '@agentuity/core';
+
+const ERROR_MESSAGE =
+	'Email service is not available in local development mode. Deploy to Agentuity Cloud to use email.';
+
+const LocalEmailNotAvailableError = StructuredError(
+	'LocalEmailNotAvailableError',
+	ERROR_MESSAGE
+);
+
+/**
+ * Local development stub for the email service.
+ * All methods throw a descriptive error directing users to deploy to Agentuity Cloud.
+ */
+export class LocalEmailStorage implements EmailService {
+	async createAddress(_localPart: string): Promise<EmailAddress> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async listAddresses(): Promise<EmailAddress[]> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async getAddress(_id: string): Promise<EmailAddress | null> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async deleteAddress(_id: string): Promise<void> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async createDestination(
+		_addressId: string,
+		_type: string,
+		_config: Record<string, unknown>
+	): Promise<EmailDestination> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async listDestinations(_addressId: string): Promise<EmailDestination[]> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async deleteDestination(_addressId: string, _destinationId: string): Promise<void> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async send(_params: EmailSendParams): Promise<EmailOutbound> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async listInbound(_addressId?: string): Promise<EmailInbound[]> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async getInbound(_id: string): Promise<EmailInbound | null> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async listOutbound(_addressId?: string): Promise<EmailOutbound[]> {
+		throw new LocalEmailNotAvailableError();
+	}
+
+	async getOutbound(_id: string): Promise<EmailOutbound | null> {
+		throw new LocalEmailNotAvailableError();
+	}
+}

package/src/services/local/index.ts

@@ -5,3 +5,5 @@ export { LocalKeyValueStorage } from './keyvalue';
 export { LocalStreamStorage } from './stream';
 export { LocalVectorStorage } from './vector';
 export { LocalQueueStorage } from './queue';
+export { LocalEmailStorage } from './email';
+export { LocalTaskStorage } from './task';