@agentuity/runtime 2.0.11 → 3.0.0-alpha.1

package/src/services/local/_db.ts

@@ -1,353 +0,0 @@
-import { Database } from 'bun:sqlite';
-import { mkdirSync, existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-let dbInstance: Database | null = null;
-
-export function getLocalDB(): Database {
-	if (dbInstance) {
-		return dbInstance;
-	}
-
-	const configDir = join(homedir(), '.config', 'agentuity');
-
-	if (!existsSync(configDir)) {
-		mkdirSync(configDir, { recursive: true });
-	}
-
-	const dbPath = join(configDir, 'local.db');
-	dbInstance = new Database(dbPath);
-
-	initializeTables(dbInstance);
-	cleanupOrphanedProjects(dbInstance);
-
-	return dbInstance;
-}
-
-function initializeTables(db: Database): void {
-	// KeyValue Storage table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS kv_storage (
-			project_path TEXT NOT NULL,
-			name TEXT NOT NULL,
-			key TEXT NOT NULL,
-			value BLOB NOT NULL,
-			content_type TEXT NOT NULL DEFAULT 'application/octet-stream',
-			expires_at INTEGER,
-			created_at INTEGER NOT NULL,
-			updated_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, name, key)
-		)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_kv_expires 
-		ON kv_storage(expires_at) 
-		WHERE expires_at IS NOT NULL
-	`);
-
-	// Stream Storage table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS stream_storage (
-			project_path TEXT NOT NULL,
-			id TEXT PRIMARY KEY,
-			name TEXT NOT NULL,
-			metadata TEXT,
-			content_type TEXT NOT NULL DEFAULT 'application/octet-stream',
-			data BLOB,
-			size_bytes INTEGER NOT NULL DEFAULT 0,
-			created_at INTEGER NOT NULL
-		)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_stream_name 
-		ON stream_storage(project_path, name)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_stream_metadata 
-		ON stream_storage(metadata)
-	`);
-
-	// Vector Storage table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS vector_storage (
-			project_path TEXT NOT NULL,
-			name TEXT NOT NULL,
-			id TEXT PRIMARY KEY,
-			key TEXT NOT NULL,
-			embedding TEXT NOT NULL,
-			document TEXT,
-			metadata TEXT,
-			created_at INTEGER NOT NULL,
-			updated_at INTEGER NOT NULL,
-			UNIQUE (project_path, name, key)
-		)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_vector_lookup 
-		ON vector_storage(project_path, name, key)
-	`);
-
-	db.run(`
-		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,
-			deleted INTEGER NOT NULL DEFAULT 0,
-			created_at INTEGER NOT NULL,
-			updated_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, id)
-		)
-	`);
-
-	// Migration: add deleted column for existing databases
-	try {
-		db.run('ALTER TABLE task_storage ADD COLUMN deleted INTEGER NOT NULL DEFAULT 0');
-	} catch {
-		// Column already exists
-	}
-
-	// 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)
-	`);
-
-	// Task Comment table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS task_comment_storage (
-			project_path TEXT NOT NULL,
-			id TEXT NOT NULL,
-			task_id TEXT NOT NULL,
-			user_id TEXT NOT NULL,
-			body TEXT NOT NULL,
-			created_at INTEGER NOT NULL,
-			updated_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, id)
-		)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_task_comment_lookup
-		ON task_comment_storage(project_path, task_id)
-	`);
-
-	// Task Tag table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS task_tag_storage (
-			project_path TEXT NOT NULL,
-			id TEXT NOT NULL,
-			name TEXT NOT NULL,
-			color TEXT,
-			created_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, id)
-		)
-	`);
-
-	// Task-Tag association table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS task_tag_association_storage (
-			project_path TEXT NOT NULL,
-			task_id TEXT NOT NULL,
-			tag_id TEXT NOT NULL,
-			PRIMARY KEY (project_path, task_id, tag_id)
-		)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_task_tag_assoc_task
-		ON task_tag_association_storage(project_path, task_id)
-	`);
-
-	db.run(`
-		CREATE INDEX IF NOT EXISTS idx_task_tag_assoc_tag
-		ON task_tag_association_storage(project_path, tag_id)
-	`);
-
-	// Task User table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS task_user_storage (
-			project_path TEXT NOT NULL,
-			id TEXT NOT NULL,
-			name TEXT NOT NULL,
-			type TEXT NOT NULL DEFAULT 'human',
-			created_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, id)
-		)
-	`);
-
-	// Task Project table
-	db.run(`
-		CREATE TABLE IF NOT EXISTS task_project_storage (
-			project_path TEXT NOT NULL,
-			id TEXT NOT NULL,
-			name TEXT NOT NULL,
-			created_at INTEGER NOT NULL,
-			PRIMARY KEY (project_path, id)
-		)
-	`);
-}
-
-function cleanupOrphanedProjects(db: Database): void {
-	// Get the current project path to exclude from cleanup
-	const currentProjectPath = process.cwd();
-
-	// Query all tables for unique project paths
-	const kvPaths = db.query('SELECT DISTINCT project_path FROM kv_storage').all() as Array<{
-		project_path: string;
-	}>;
-	const streamPaths = db.query('SELECT DISTINCT project_path FROM stream_storage').all() as Array<{
-		project_path: string;
-	}>;
-	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;
-	}>;
-	const taskCommentPaths = db
-		.query('SELECT DISTINCT project_path FROM task_comment_storage')
-		.all() as Array<{
-		project_path: string;
-	}>;
-	const taskTagPaths = db
-		.query('SELECT DISTINCT project_path FROM task_tag_storage')
-		.all() as Array<{
-		project_path: string;
-	}>;
-	const taskTagAssocPaths = db
-		.query('SELECT DISTINCT project_path FROM task_tag_association_storage')
-		.all() as Array<{
-		project_path: string;
-	}>;
-	const taskUserPaths = db
-		.query('SELECT DISTINCT project_path FROM task_user_storage')
-		.all() as Array<{
-		project_path: string;
-	}>;
-	const taskProjectPaths = db
-		.query('SELECT DISTINCT project_path FROM task_project_storage')
-		.all() as Array<{
-		project_path: string;
-	}>;
-
-	// Combine and deduplicate all project paths
-	const allPaths = new Set<string>();
-	[
-		...kvPaths,
-		...streamPaths,
-		...vectorPaths,
-		...taskPaths,
-		...taskChangelogPaths,
-		...taskCommentPaths,
-		...taskTagPaths,
-		...taskTagAssocPaths,
-		...taskUserPaths,
-		...taskProjectPaths,
-	].forEach((row) => {
-		allPaths.add(row.project_path);
-	});
-
-	// Check which paths no longer exist and are not the current project
-	const pathsToDelete: string[] = [];
-	for (const path of allPaths) {
-		if (path !== currentProjectPath && !existsSync(path)) {
-			pathsToDelete.push(path);
-		}
-	}
-
-	// Delete data for removed projects
-	if (pathsToDelete.length > 0) {
-		const placeholders = pathsToDelete.map(() => '?').join(', ');
-
-		// Delete from all tables
-		const deleteKv = db.prepare(`DELETE FROM kv_storage WHERE project_path IN (${placeholders})`);
-		const deleteStream = db.prepare(
-			`DELETE FROM stream_storage WHERE project_path IN (${placeholders})`
-		);
-		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})`
-		);
-		const deleteTaskComments = db.prepare(
-			`DELETE FROM task_comment_storage WHERE project_path IN (${placeholders})`
-		);
-		const deleteTaskTags = db.prepare(
-			`DELETE FROM task_tag_storage WHERE project_path IN (${placeholders})`
-		);
-		const deleteTaskTagAssoc = db.prepare(
-			`DELETE FROM task_tag_association_storage WHERE project_path IN (${placeholders})`
-		);
-		const deleteTaskUsers = db.prepare(
-			`DELETE FROM task_user_storage WHERE project_path IN (${placeholders})`
-		);
-		const deleteTaskProjects = db.prepare(
-			`DELETE FROM task_project_storage WHERE project_path IN (${placeholders})`
-		);
-
-		deleteKv.run(...pathsToDelete);
-		deleteStream.run(...pathsToDelete);
-		deleteVector.run(...pathsToDelete);
-		deleteTasks.run(...pathsToDelete);
-		deleteTaskChangelog.run(...pathsToDelete);
-		deleteTaskComments.run(...pathsToDelete);
-		deleteTaskTags.run(...pathsToDelete);
-		deleteTaskTagAssoc.run(...pathsToDelete);
-		deleteTaskUsers.run(...pathsToDelete);
-		deleteTaskProjects.run(...pathsToDelete);
-
-		console.log(`[LocalDB] Cleaned up data for ${pathsToDelete.length} orphaned project(s)`);
-	}
-}
-
-export function closeLocalDB(): void {
-	if (dbInstance) {
-		dbInstance.close();
-		dbInstance = null;
-	}
-}

package/src/services/local/_router.ts

@@ -1,40 +0,0 @@
-import type { Database } from 'bun:sqlite';
-import { createRouter } from '../../router';
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function createLocalStorageRouter(db: Database, projectPath: string): any {
-	const router = createRouter();
-
-	// so we can detect if we're running in local mode easily
-	router.get('/_agentuity/local/health', (c) => c.text('OK'));
-
-	// Serve streams: GET /_agentuity/local/stream/:id
-	router.get('/_agentuity/local/stream/:id', async (c) => {
-		const id = c.req.param('id');
-
-		const query = db.query(`
-			SELECT data, content_type 
-			FROM stream_storage 
-			WHERE project_path = ? AND id = ?
-		`);
-
-		const row = query.get(projectPath, id) as {
-			data: Buffer | null;
-			content_type: string;
-		} | null;
-
-		if (!row) {
-			return c.notFound();
-		}
-
-		if (!row.data) {
-			return c.json({ error: 'Stream not finalized' }, 400);
-		}
-
-		return c.body(new Uint8Array(row.data), 200, {
-			'Content-Type': row.content_type,
-		});
-	});
-
-	return router;
-}

package/src/services/local/_util.ts

@@ -1,55 +0,0 @@
-import { StructuredError } from '@agentuity/core';
-import { resolve } from 'node:path';
-
-/**
- * Normalize a project path to an absolute path for consistent DB keys
- */
-export function normalizeProjectPath(cwd: string = process.cwd()): string {
-	return resolve(cwd);
-}
-
-/**
- * Simple character-based embedding for local vector search
- * Not production-quality, but good enough for local dev/testing
- */
-export function simpleEmbedding(text: string, dimensions = 128): number[] {
-	const vec = new Array(dimensions).fill(0);
-	const normalized = text.toLowerCase();
-
-	for (let i = 0; i < normalized.length; i++) {
-		const charCode = normalized.charCodeAt(i);
-		vec[i % dimensions] += Math.sin(charCode * (i + 1));
-		vec[(i * 2) % dimensions] += Math.cos(charCode);
-	}
-
-	// Normalize vector
-	const magnitude = Math.sqrt(vec.reduce((sum, v) => sum + v * v, 0));
-	return magnitude > 0 ? vec.map((v) => v / magnitude) : vec;
-}
-
-const InvalidVectorError = StructuredError(
-	'InvalidVectorError',
-	'Vectors must have the same dimension'
-);
-
-/**
- * Calculate cosine similarity between two vectors
- */
-export function cosineSimilarity(a: number[], b: number[]): number {
-	if (a.length !== b.length) {
-		throw new InvalidVectorError();
-	}
-
-	const dot = a.reduce((sum, ai, i) => sum + ai * (b[i] ?? 0), 0);
-	const normA = Math.sqrt(a.reduce((sum, ai) => sum + ai * ai, 0));
-	const normB = Math.sqrt(b.reduce((sum, bi) => sum + bi * bi, 0));
-
-	return normA > 0 && normB > 0 ? dot / (normA * normB) : 0;
-}
-
-/**
- * Get current timestamp in milliseconds
- */
-export function now(): number {
-	return Date.now();
-}

package/src/services/local/email.ts

@@ -1,91 +0,0 @@
-import {
-	StructuredError,
-	type EmailService,
-	type EmailAddress,
-	type EmailDestination,
-	type EmailConnectionConfig,
-	type EmailInbound,
-	type EmailOutbound,
-	type EmailSendParams,
-	type EmailActivityParams,
-	type EmailActivityResult,
-} 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 getConnectionConfig(_id: string): Promise<EmailConnectionConfig | 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 deleteInbound(_id: string): Promise<void> {
-		throw new LocalEmailNotAvailableError();
-	}
-
-	async listOutbound(_addressId?: string): Promise<EmailOutbound[]> {
-		throw new LocalEmailNotAvailableError();
-	}
-
-	async getOutbound(_id: string): Promise<EmailOutbound | null> {
-		throw new LocalEmailNotAvailableError();
-	}
-
-	async deleteOutbound(_id: string): Promise<void> {
-		throw new LocalEmailNotAvailableError();
-	}
-
-	async getActivity(_params?: EmailActivityParams): Promise<EmailActivityResult> {
-		throw new LocalEmailNotAvailableError();
-	}
-}

package/src/services/local/index.ts

@@ -1,9 +0,0 @@
-export { getLocalDB, closeLocalDB } from './_db';
-export { normalizeProjectPath, simpleEmbedding, cosineSimilarity } from './_util';
-export { createLocalStorageRouter } from './_router';
-export { LocalKeyValueStorage } from './keyvalue';
-export { LocalStreamStorage } from './stream';
-export { LocalVectorStorage } from './vector';
-export { LocalQueueStorage } from './queue';
-export { LocalEmailStorage } from './email';
-export { LocalTaskStorage } from './task';