@agentuity/cli 1.0.1 → 1.0.3

package/src/cache/agent-intro.ts

@@ -0,0 +1,62 @@
+import { Database } from 'bun:sqlite';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { getDefaultConfigDir } from '../config';
+
+let db: Database | null = null;
+
+/**
+ * Get or create the database connection synchronously.
+ * Reuses the existing resource.db file for consistency.
+ */
+function getDatabase(): Database {
+	if (db) return db;
+
+	const configDir = getDefaultConfigDir();
+	mkdirSync(configDir, { recursive: true });
+
+	db = new Database(join(configDir, 'resource.db'));
+	db.run(`
+		CREATE TABLE IF NOT EXISTS agent_intro_seen (
+			agent_id TEXT PRIMARY KEY,
+			first_seen_at INTEGER NOT NULL
+		)
+	`);
+	return db;
+}
+
+/**
+ * Check if an agent has already seen the intro message.
+ * This is a synchronous operation for use in formatHelp.
+ * Returns true on error to avoid blocking CLI (assumes seen).
+ */
+export function hasAgentSeenIntro(agentId: string): boolean {
+	try {
+		const row = getDatabase()
+			.query<
+				{ agent_id: string },
+				[string]
+			>('SELECT agent_id FROM agent_intro_seen WHERE agent_id = ?')
+			.get(agentId);
+		return row !== null;
+	} catch {
+		// Assume seen on error to avoid blocking CLI
+		return true;
+	}
+}
+
+/**
+ * Mark an agent as having seen the intro message.
+ * This is a synchronous operation for use in formatHelp.
+ * Silently fails on error (non-critical feature).
+ */
+export function markAgentIntroSeen(agentId: string): void {
+	try {
+		getDatabase().run(
+			'INSERT OR IGNORE INTO agent_intro_seen (agent_id, first_seen_at) VALUES (?, ?)',
+			[agentId, Date.now()]
+		);
+	} catch {
+		// Non-critical - intro tracking failure shouldn't block CLI
+	}
+}

package/src/cache/index.ts

@@ -11,3 +11,5 @@ export {
 } from './resource-region';
 
 export { getCachedProject, setCachedProject, clearProjectCache } from './project-cache';
+
+export { hasAgentSeenIntro, markAgentIntroSeen } from './agent-intro';

package/src/cache/resource-region.ts

@@ -26,6 +26,7 @@ async function getDatabase(): Promise<Database> {
 			id TEXT NOT NULL,
 			region TEXT NOT NULL,
 			org_id TEXT,
+			project_id TEXT,
 			last_updated INTEGER NOT NULL,
 			PRIMARY KEY (resource_type, profile, id)
 		)
@@ -36,6 +37,13 @@ async function getDatabase(): Promise<Database> {
 		ON resource_region_cache(last_updated)
 	`);
 
+	// Migration: Add project_id column if it doesn't exist (for existing databases)
+	try {
+		db.run('ALTER TABLE resource_region_cache ADD COLUMN project_id TEXT');
+	} catch {
+		// Column already exists, ignore the error
+	}
+
 	return db;
 }
 
@@ -44,7 +52,17 @@ function pruneOldEntries(database: Database): void {
 	database.run('DELETE FROM resource_region_cache WHERE last_updated < ?', [cutoff]);
 }
 
-export type ResourceType = 'sandbox' | 'bucket' | 'db' | 'project' | 'deployment';
+export type ResourceType =
+	| 'sandbox'
+	| 'bucket'
+	| 'db'
+	| 'project'
+	| 'deployment'
+	| 'machine'
+	| 'queue'
+	| 'vector'
+	| 'kv'
+	| 'stream';
 
 /**
  * Resource info returned from cache lookup
@@ -52,6 +70,7 @@ export type ResourceType = 'sandbox' | 'bucket' | 'db' | 'project' | 'deployment
 export interface ResourceInfo {
 	region: string;
 	orgId?: string;
+	projectId?: string;
 }
 
 /**
@@ -68,9 +87,9 @@ export async function getResourceInfo(
 
 	const row = database
 		.query<
-			{ region: string; org_id: string | null; last_updated: number },
+			{ region: string; org_id: string | null; project_id: string | null; last_updated: number },
 			[string, string, string]
-		>('SELECT region, org_id, last_updated FROM resource_region_cache WHERE resource_type = ? AND profile = ? AND id = ?')
+		>('SELECT region, org_id, project_id, last_updated FROM resource_region_cache WHERE resource_type = ? AND profile = ? AND id = ?')
 		.get(type, profile, id);
 
 	if (!row) {
@@ -90,6 +109,7 @@ export async function getResourceInfo(
 	return {
 		region: row.region,
 		orgId: row.org_id ?? undefined,
+		projectId: row.project_id ?? undefined,
 	};
 }
 
@@ -116,7 +136,8 @@ export async function setResourceInfo(
 	profile: string,
 	id: string,
 	region: string,
-	orgId?: string
+	orgId?: string,
+	projectId?: string
 ): Promise<void> {
 	const database = await getDatabase();
 
@@ -124,9 +145,9 @@ export async function setResourceInfo(
 
 	database.run(
 		`INSERT OR REPLACE INTO resource_region_cache 
-		 (resource_type, profile, id, region, org_id, last_updated)
-		 VALUES (?, ?, ?, ?, ?, ?)`,
-		[type, profile, id, region, orgId ?? null, Date.now()]
+		 (resource_type, profile, id, region, org_id, project_id, last_updated)
+		 VALUES (?, ?, ?, ?, ?, ?, ?)`,
+		[type, profile, id, region, orgId ?? null, projectId ?? null, Date.now()]
 	);
 }
 

package/src/catalyst.ts

@@ -0,0 +1,16 @@
+import { getServiceUrls } from '@agentuity/server';
+
+/**
+ * Get the catalyst URL for a specific region.
+ * The catalyst can resolve any prefixed ID (sbx_, proj_, org_, etc.)
+ * without requiring org context.
+ */
+export function getCatalystUrl(region: string): string {
+	// Allow override via environment variable for testing/development
+	if (process.env.AGENTUITY_CATALYST_URL) {
+		return process.env.AGENTUITY_CATALYST_URL;
+	}
+
+	// Regional catalyst endpoint (with existing transport/local handling)
+	return getServiceUrls(region).catalyst;
+}