@ugm/desiagent 0.1.21

package/README.md

@@ -0,0 +1,251 @@
+# desiAgent
+
+A library-first async agent system for building autonomous workflows with TypeScript.
+
+## Features
+
+- **Multiple LLM Providers**: OpenAI, OpenRouter, and Ollama support
+- **Autonomous Execution**: Let agents execute objectives autonomously
+- **DAG Workflows**: Decompose complex objectives into directed acyclic graphs
+- **Built-in Tools**: Web scraping, file operations, bash commands, and more
+- **Event Streaming**: Track execution progress in real-time
+- **SQLite Storage**: Persistent storage using bun:sqlite
+
+## Installation
+
+### Prerequisites
+
+- [Bun](https://bun.sh) 1.3.5 or higher
+
+### Install
+
+```bash
+bun add desiagent
+```
+
+Or with npm/pnpm:
+
+```bash
+npm install desiagent
+# or
+pnpm add desiagent
+```
+
+## Environment Variables
+
+Create a `.env` file in your project root with the appropriate API keys for your chosen provider:
+
+### OpenAI
+
+```bash
+OPENAI_API_KEY=sk-...
+```
+
+### OpenRouter
+
+```bash
+OPENROUTER_API_KEY=sk-or-...
+```
+
+### Ollama (Local)
+
+```bash
+OLLAMA_BASE_URL=http://localhost:11434  # Optional, this is the default
+```
+
+## Quick Start
+
+### Basic Example (OpenAI)
+
+```typescript
+import { setupDesiAgent } from 'desiagent';
+
+const client = await setupDesiAgent({
+  llmProvider: 'openai',
+  openaiApiKey: process.env.OPENAI_API_KEY,
+  modelName: 'gpt-4o',
+});
+
+// Create and execute a DAG
+const execution = await client.dags.createAndExecute('Summarize the latest tech news');
+console.log(`Execution: ${execution.id}, Status: ${execution.status}`);
+
+await client.shutdown();
+```
+
+### Using OpenRouter
+
+```typescript
+import { setupDesiAgent } from 'desiagent';
+
+const client = await setupDesiAgent({
+  llmProvider: 'openrouter',
+  openrouterApiKey: process.env.OPENROUTER_API_KEY,
+  modelName: 'google/gemini-2.5-flash-lite-preview-06-2025',
+});
+
+const execution = await client.dags.createAndExecute('Research best practices for API design');
+await client.shutdown();
+```
+
+### Using Ollama (Local LLM)
+
+```typescript
+import { setupDesiAgent } from 'desiagent';
+
+const client = await setupDesiAgent({
+  llmProvider: 'ollama',
+  ollamaBaseUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+  modelName: 'llama3.2',
+});
+
+const execution = await client.dags.createAndExecute('Explain quantum computing in simple terms');
+await client.shutdown();
+```
+
+## Configuration Options
+
+```typescript
+interface DesiAgentConfig {
+  // LLM Provider (required)
+  llmProvider: 'openai' | 'openrouter' | 'ollama';
+  modelName: string;
+
+  // Provider-specific API keys
+  openaiApiKey?: string;      // Required for 'openai' provider
+  openrouterApiKey?: string;  // Required for 'openrouter' provider
+  ollamaBaseUrl?: string;     // Optional for 'ollama', defaults to http://localhost:11434
+
+  // Database (optional)
+  databasePath?: string;      // Default: ~/.desiAgent/data/agent.db
+
+  // Agent definitions (optional)
+  agentDefinitionsPath?: string;  // Default: ~/.desiAgent/agents
+
+  // Logging (optional)
+  logLevel?: 'debug' | 'info' | 'warn' | 'error';  // Default: 'info'
+
+  // Callbacks (optional)
+  onExecutionStart?: (executionId: string) => void;
+  onExecutionEnd?: (executionId: string, result: any) => void;
+}
+```
+
+## API Reference
+
+### Agents
+
+```typescript
+// Create a new agent
+const agent = await client.agents.create(name, version, prompt, params?);
+
+// List all agents
+const agents = await client.agents.list(filter?);
+
+// Get a specific agent
+const agent = await client.agents.get(id);
+
+// Update an agent
+await client.agents.update(id, updates);
+
+// Activate/Delete an agent
+await client.agents.activate(id);
+await client.agents.delete(id);
+
+// Resolve agent by name
+const agent = await client.agents.resolve(name);
+```
+
+### DAGs (Directed Acyclic Graphs)
+
+```typescript
+// Create a DAG from an objective
+const dag = await client.dags.create(objective, params?);
+
+// Create and immediately execute
+const execution = await client.dags.createAndExecute(objective, params?);
+
+// Execute an existing DAG
+const execution = await client.dags.execute(dagId, params?);
+
+// List DAGs
+const dags = await client.dags.list(filter?);
+const scheduled = await client.dags.listScheduled();
+
+// Get/Update/Delete
+const dag = await client.dags.get(id);
+await client.dags.update(id, updates);
+await client.dags.delete(id);
+
+// Resume a paused execution
+await client.dags.resume(executionId);
+```
+
+### Executions
+
+```typescript
+// List executions
+const executions = await client.executions.list(filter?);
+
+// Get execution details
+const execution = await client.executions.get(id);
+const subSteps = await client.executions.getSubSteps(id);
+
+// Delete an execution
+await client.executions.delete(id);
+
+// Stream execution events (AsyncIterable)
+for await (const event of client.executions.streamEvents(id)) {
+  console.log(event.type, event.data);
+}
+```
+
+## Examples
+
+### News Bulletin Generator
+
+See [`examples/news-bulletin.ts`](./examples/news-bulletin.ts) for a complete example that creates a news bulletin with multiple categories.
+
+```bash
+# Run with Ollama
+bun run examples/news-bulletin.ts
+
+# Run with OpenRouter
+OPENROUTER_API_KEY=your-key bun run examples/news-bulletin-openrouter.ts
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run in development mode
+bun run dev
+```
+
+### Commands
+
+```bash
+# Build
+pnpm build
+
+# Type check
+pnpm type-check
+
+# Run tests
+pnpm test
+pnpm test:watch
+pnpm test:coverage
+
+# Database commands
+pnpm db:generate
+pnpm db:push
+pnpm db:studio
+```
+
+## License
+
+MIT

package/dist/__tests__/test-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Test Utilities
+ *
+ * Helper functions for setting up test environments
+ */
+import type { DrizzleDB } from '../db/client.js';
+/**
+ * Create an in-memory test database
+ */
+export declare function createTestDatabase(): DrizzleDB;
+/**
+ * Clean up test database
+ */
+export declare function cleanupTestDatabase(): void;
+/**
+ * Create mock logger for tests
+ */
+export declare function createMockLogger(): {
+    debug: () => void;
+    info: () => void;
+    warn: () => void;
+    error: () => void;
+};
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,CAI9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB;;;;;EAO/B"}

package/dist/__tests__/test-utils.js

@@ -0,0 +1,32 @@
+/**
+ * Test Utilities
+ *
+ * Helper functions for setting up test environments
+ */
+import { getDatabase, closeDatabase } from '../db/client.js';
+/**
+ * Create an in-memory test database
+ */
+export function createTestDatabase() {
+    // Use a unique in-memory database for each test
+    const dbPath = `:memory:`;
+    return getDatabase(dbPath);
+}
+/**
+ * Clean up test database
+ */
+export function cleanupTestDatabase() {
+    closeDatabase();
+}
+/**
+ * Create mock logger for tests
+ */
+export function createMockLogger() {
+    return {
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/__tests__/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,gDAAgD;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC;IAC1B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,aAAa,EAAE,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;KAChB,CAAC;AACJ,CAAC"}

package/dist/core/execution/agents.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agents Service
+ *
+ * Manages agent creation, configuration, activation, and resolution.
+ */
+import type { DrizzleDB } from '../../db/client.js';
+import type { Agent } from '../../types/index.js';
+/**
+ * Create an agent ID with 'agent_' prefix
+ */
+export declare function generateAgentId(): string;
+/**
+ * AgentsService handles all agent-related operations
+ */
+export declare class AgentsService {
+    private db;
+    private logger;
+    private static agentCache;
+    private static readonly CACHE_TTL_MS;
+    private static readonly MAX_CACHE_SIZE;
+    constructor(db: DrizzleDB);
+    /**
+     * Clear the agent cache (call after updates/activations)
+     */
+    static clearCache(agentName?: string): void;
+    /**
+     * Create a new agent
+     */
+    create(name: string, version: string, systemPrompt: string, params?: Record<string, any>): Promise<Agent>;
+    /**
+     * Get an agent by ID
+     */
+    get(id: string): Promise<Agent>;
+    /**
+     * List all agents with optional filtering
+     */
+    list(filter?: Record<string, any>): Promise<Agent[]>;
+    /**
+     * Update an agent
+     */
+    update(id: string, updates: Partial<Agent>): Promise<Agent>;
+    /**
+     * Activate an agent (only one active per name)
+     */
+    activate(id: string): Promise<Agent>;
+    /**
+     * Resolve an agent by name (gets active agent with that name)
+     * Uses caching for performance
+     */
+    resolve(name: string): Promise<Agent | null>;
+    /**
+     * Delete an agent (cannot delete active agents)
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Map database record to Agent type
+     */
+    private mapAgent;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/core/execution/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/core/execution/agents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAIlD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAUD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAU;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;gBAEhC,EAAE,EAAE,SAAS;IAIzB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,KAAK,CAAC;IA2CjB;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAYrC;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmB1D;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAoEjE;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAiC1C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA+BlD;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvC;;OAEG;IACH,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/core/execution/agents.js

@@ -0,0 +1,249 @@
+/**
+ * Agents Service
+ *
+ * Manages agent creation, configuration, activation, and resolution.
+ */
+import { eq, and } from 'drizzle-orm';
+import { nanoid } from 'nanoid';
+import { agents } from '../../db/schema.js';
+import { NotFoundError, ValidationError } from '../../errors/index.js';
+import { getLogger } from '../../util/logger.js';
+/**
+ * Create an agent ID with 'agent_' prefix
+ */
+export function generateAgentId() {
+    return `agent_${nanoid(21)}`;
+}
+/**
+ * AgentsService handles all agent-related operations
+ */
+export class AgentsService {
+    db;
+    logger = getLogger();
+    // LRU-style cache for resolved agents (by name)
+    static agentCache = new Map();
+    static CACHE_TTL_MS = 60_000; // 1 minute TTL
+    static MAX_CACHE_SIZE = 50;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Clear the agent cache (call after updates/activations)
+     */
+    static clearCache(agentName) {
+        if (agentName) {
+            AgentsService.agentCache.delete(agentName);
+        }
+        else {
+            AgentsService.agentCache.clear();
+        }
+    }
+    /**
+     * Create a new agent
+     */
+    async create(name, version, systemPrompt, params) {
+        this.logger.debug(`Creating agent: ${name}@${version}`);
+        // Check for duplicate name+version
+        const existing = await this.db.query.agents.findFirst({
+            where: and(eq(agents.name, name), eq(agents.version, version)),
+        });
+        if (existing) {
+            throw new ValidationError(`Agent with name "${name}" and version "${version}" already exists`, 'name_version', { name, version });
+        }
+        const agentId = generateAgentId();
+        const now = new Date();
+        await this.db.insert(agents).values({
+            id: agentId,
+            name,
+            version,
+            promptTemplate: systemPrompt,
+            provider: params?.provider,
+            model: params?.model,
+            active: false,
+            metadata: params?.metadata || {},
+            createdAt: now,
+            updatedAt: now,
+        });
+        const agent = await this.db.query.agents.findFirst({
+            where: eq(agents.id, agentId),
+        });
+        if (!agent) {
+            throw new Error('Failed to create agent');
+        }
+        return this.mapAgent(agent);
+    }
+    /**
+     * Get an agent by ID
+     */
+    async get(id) {
+        const agent = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!agent) {
+            throw new NotFoundError('Agent', id);
+        }
+        return this.mapAgent(agent);
+    }
+    /**
+     * List all agents with optional filtering
+     */
+    async list(filter) {
+        const conditions = [];
+        if (filter?.name) {
+            conditions.push(eq(agents.name, filter.name));
+        }
+        if (filter?.active !== undefined) {
+            conditions.push(eq(agents.active, filter.active));
+        }
+        const allAgents = await this.db.query.agents.findMany({
+            where: conditions.length > 0 ? and(...conditions) : undefined,
+            orderBy: (agents, { desc }) => [desc(agents.createdAt)],
+        });
+        return allAgents.map((a) => this.mapAgent(a));
+    }
+    /**
+     * Update an agent
+     */
+    async update(id, updates) {
+        const existing = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!existing) {
+            throw new NotFoundError('Agent', id);
+        }
+        // Check for duplicate name+version if updating those fields
+        if ((updates.name || updates.version) &&
+            (updates.name !== existing.name || updates.version !== existing.version)) {
+            const duplicate = await this.db.query.agents.findFirst({
+                where: and(eq(agents.name, updates.name || existing.name), eq(agents.version, updates.version || existing.version)),
+            });
+            if (duplicate && duplicate.id !== id) {
+                throw new ValidationError(`Agent with name and version already exists`, 'name_version');
+            }
+        }
+        const updateData = {
+            updatedAt: new Date(),
+        };
+        if (updates.name !== undefined) {
+            updateData.name = updates.name;
+        }
+        if (updates.version !== undefined) {
+            updateData.version = updates.version;
+        }
+        if (updates.systemPrompt !== undefined) {
+            updateData.promptTemplate = updates.systemPrompt;
+        }
+        if (updates.constraints?.maxTokens !== undefined) {
+            updateData.model = updates.constraints.maxTokens;
+        }
+        if (updates.metadata !== undefined) {
+            updateData.metadata = updates.metadata;
+        }
+        await this.db.update(agents).set(updateData).where(eq(agents.id, id));
+        // Invalidate cache for this agent
+        AgentsService.clearCache(existing.name);
+        if (updates.name && updates.name !== existing.name) {
+            AgentsService.clearCache(updates.name);
+        }
+        const updated = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!updated) {
+            throw new Error('Failed to update agent');
+        }
+        return this.mapAgent(updated);
+    }
+    /**
+     * Activate an agent (only one active per name)
+     */
+    async activate(id) {
+        const agent = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!agent) {
+            throw new NotFoundError('Agent', id);
+        }
+        // Deactivate all other agents with the same name
+        await this.db.update(agents)
+            .set({ active: false, updatedAt: new Date() })
+            .where(eq(agents.name, agent.name));
+        // Activate this agent
+        await this.db.update(agents)
+            .set({ active: true, updatedAt: new Date() })
+            .where(eq(agents.id, id));
+        // Invalidate cache for this agent name
+        AgentsService.clearCache(agent.name);
+        const updated = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!updated) {
+            throw new Error('Failed to activate agent');
+        }
+        return this.mapAgent(updated);
+    }
+    /**
+     * Resolve an agent by name (gets active agent with that name)
+     * Uses caching for performance
+     */
+    async resolve(name) {
+        // Check cache first
+        const cached = AgentsService.agentCache.get(name);
+        const now = Date.now();
+        if (cached && (now - cached.timestamp) < AgentsService.CACHE_TTL_MS) {
+            this.logger.debug(`Agent cache hit: ${name}`);
+            return cached.agent;
+        }
+        // Cache miss or expired - fetch from DB
+        const agent = await this.db.query.agents.findFirst({
+            where: and(eq(agents.name, name), eq(agents.active, true)),
+        });
+        if (agent) {
+            const mappedAgent = this.mapAgent(agent);
+            // Evict oldest if cache is full
+            if (AgentsService.agentCache.size >= AgentsService.MAX_CACHE_SIZE) {
+                const firstKey = AgentsService.agentCache.keys().next().value;
+                if (firstKey)
+                    AgentsService.agentCache.delete(firstKey);
+            }
+            AgentsService.agentCache.set(name, { agent: mappedAgent, timestamp: now });
+            return mappedAgent;
+        }
+        return null;
+    }
+    /**
+     * Delete an agent (cannot delete active agents)
+     */
+    async delete(id) {
+        const agent = await this.db.query.agents.findFirst({
+            where: eq(agents.id, id),
+        });
+        if (!agent) {
+            throw new NotFoundError('Agent', id);
+        }
+        if (agent.active) {
+            throw new ValidationError('Cannot delete active agent. Activate another version first.', 'active', agent.active);
+        }
+        await this.db.delete(agents).where(eq(agents.id, id));
+        this.logger.debug(`Deleted agent: ${id}`);
+    }
+    /**
+     * Map database record to Agent type
+     */
+    mapAgent(record) {
+        return {
+            id: record.id,
+            name: record.name,
+            version: record.version,
+            description: record.metadata?.description,
+            systemPrompt: record.promptTemplate,
+            provider: (record.provider || 'openai'),
+            model: record.model || 'gpt-4o',
+            isActive: record.active,
+            constraints: record.metadata?.constraints,
+            metadata: record.metadata,
+            createdAt: record.createdAt,
+            updatedAt: record.updatedAt,
+        };
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/core/execution/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/core/execution/agents.ts"],"names":[],"mappings":"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"}

package/dist/core/execution/artifacts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Artifacts Service
+ *
+ * Manages artifact files generated during execution.
+ * Artifacts are output files created by agents and stored for later retrieval.
+ */
+/**
+ * ArtifactsService handles artifact listing and retrieval
+ */
+export declare class ArtifactsService {
+    private artifactsDir;
+    private logger;
+    constructor(artifactsDir?: string);
+    /**
+     * List all artifacts
+     */
+    list(): Promise<string[]>;
+    /**
+     * Get an artifact by filename
+     */
+    get(filename: string): Promise<Buffer>;
+    /**
+     * Internal: Save an artifact
+     */
+    _save(filename: string, content: Buffer | string): Promise<void>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/core/execution/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/core/execution/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAe;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAIjC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmB/B;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB5C;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BvE"}