@ugm/desiagent 0.1.37 → 0.2.1

package/README.md

@@ -1,278 +1,420 @@
 # desiAgent
 
-A library-first async agent system for building autonomous workflows with TypeScript.
+A library-first async agent system for building autonomous workflows with TypeScript. Give it a goal in plain English and it decomposes it into a DAG of tasks, executes them with built-in tools, and streams results back — all in a few lines of code.
 
 ## 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
+- **Goal → DAG → Execution** — Describe what you want; desiAgent plans a directed acyclic graph (DAG) of sub-tasks and executes them autonomously.
+- **Multiple LLM Providers** — OpenAI, OpenRouter, and Ollama (local) out of the box.
+- **Built-in Tools** — Web scraping, file I/O, bash commands, email (SMTP/IMAP), PDF parsing, and more.
+- **Event Streaming** — `for await` over execution events to track progress in real-time.
+- **Clarification Flow** — If the goal is ambiguous the agent asks for clarification before proceeding.
+- **In-Memory or Persistent Storage** — Use `:memory:` for quick experiments or a SQLite file for production.
+- **Cron Scheduling** — Schedule DAGs to run on a cron expression with timezone support.
+- **Artifacts** — Tools can write output files (reports, code, images) that are automatically stored and retrievable.
+- **Cost Tracking** — Token usage and USD cost are recorded per execution step.
+- **Skills** — Drop a `SKILL.md` file into your workspace or global config and the agent discovers it automatically. Skills can be injected as context into LLM prompts or executed as sub-tasks in a DAG.
+- **Experiments API** — Compare models and temperatures on the same goal in one call.
 
 ## Installation
 
 ### Prerequisites
 
-- [Bun](https://bun.sh) 1.3.5 or higher
+- [Bun](https://bun.sh) ≥ 1.3.5
 
 ### Install
 
 ```bash
-bun add desiagent
+bun add @ugm/desiagent
 ```
 
-Or with npm/pnpm:
+Or with npm / pnpm:
 
 ```bash
-npm install desiagent
+npm install @ugm/desiagent
 # or
-pnpm add desiagent
+pnpm add @ugm/desiagent
 ```
 
-## Environment Variables
+### Environment Variables
 
-Create a `.env` file in your project root with the appropriate API keys for your chosen provider:
-
-### OpenAI
+Create a `.env` file with your provider's API key:
 
 ```bash
-OPENAI_API_KEY=sk-...
-```
+# OpenRouter (recommended — access to many models via one key)
+OPENROUTER_API_KEY=sk-or-...
 
-### OpenRouter
+# OpenAI
+OPENAI_API_KEY=sk-...
 
-```bash
-OPENROUTER_API_KEY=sk-or-...
+# Ollama (local, no key needed)
+OLLAMA_BASE_URL=http://localhost:11434   # optional, this is the default
 ```
 
-### Ollama (Local)
+## Examples
 
-```bash
-OLLAMA_BASE_URL=http://localhost:11434  # Optional, this is the default
-```
+> All examples below use OpenRouter and an in-memory database (`:memory:`) so you can run them without any local SQLite file.
 
-## Quick Start
+### 1. Goal → Execute in One Call
 
-### Basic Example (OpenAI)
+The fastest way to go from idea to result. `createAndExecuteFromGoal` plans the DAG **and** executes it in a single call.
 
 ```typescript
-import { setupDesiAgent } from 'desiagent';
+import { setupDesiAgent } from '@ugm/desiagent';
 
 const client = await setupDesiAgent({
-  llmProvider: 'openai',
-  openaiApiKey: process.env.OPENAI_API_KEY,
-  modelName: 'gpt-4o',
+  llmProvider: 'openrouter',
+  openrouterApiKey: process.env.OPENROUTER_API_KEY,
+  modelName: 'google/gemini-2.5-flash-lite-preview-09-2025',
+  databasePath: ':memory:',
+  skipGenerationStats: true,
 });
 
-// Create and execute a DAG
-const execution = await client.dags.createAndExecute('Summarize the latest tech news');
-console.log(`Execution: ${execution.id}, Status: ${execution.status}`);
+const result = await client.dags.createAndExecuteFromGoal({
+  goalText: 'Research the top 5 trends in AI agents for 2025 and write a concise briefing document to ai-trends.md',
+  agentName: 'DecomposerV9',
+  temperature: 0.7,
+});
+
+if (result.status === 'clarification_required') {
+  console.log('Agent needs more info:', result.clarificationQuery);
+} else {
+  console.log('Execution started:', result.executionId);
+
+  // Stream events until completion
+  for await (const event of client.executions.streamEvents(result.executionId)) {
+    console.log(event.type, event.data);
+  }
+
+  // Retrieve final result
+  const details = await client.executions.getWithSubSteps(result.executionId);
+  console.log('Final result:\n', details.finalResult);
+}
 
 await client.shutdown();
 ```
 
-### Using OpenRouter
+### 2. Plan First, Execute Later
+
+Separate planning from execution so you can inspect or modify the DAG before running it.
 
 ```typescript
-import { setupDesiAgent } from 'desiagent';
+import { setupDesiAgent } from '@ugm/desiagent';
 
 const client = await setupDesiAgent({
   llmProvider: 'openrouter',
   openrouterApiKey: process.env.OPENROUTER_API_KEY,
-  modelName: 'google/gemini-2.5-flash-lite-preview-06-2025',
+  modelName: 'google/gemini-2.5-flash-lite-preview-09-2025',
+  databasePath: ':memory:',
+  skipGenerationStats: true,
 });
 
-const execution = await client.dags.createAndExecute('Research best practices for API design');
+// Step 1 — Plan
+const plan = await client.dags.createFromGoal({
+  goalText: 'Create a tutorial on processing driftwood into handicrafts — cover cleaning, tools, finishes — and write it to driftwood.md',
+  agentName: 'DecomposerV9',
+  temperature: 0.7,
+});
+
+if (plan.status !== 'success') {
+  console.log('Planning issue:', plan.status);
+  await client.shutdown();
+  process.exit(1);
+}
+
+console.log('DAG created:', plan.dagId);
+
+// Step 2 — Execute
+const execution = await client.dags.execute(plan.dagId);
+console.log('Execution ID:', execution.id);
+
+for await (const event of client.executions.streamEvents(execution.id)) {
+  console.log(event.type, event.data);
+}
+
+const details = await client.executions.getWithSubSteps(execution.id);
+console.log('Final result:\n', details.finalResult);
+
 await client.shutdown();
 ```
 
-### Using Ollama (Local LLM)
+### 3. List Agents and Tools
+
+Explore what's available in the system.
 
 ```typescript
-import { setupDesiAgent } from 'desiagent';
+import { setupDesiAgent } from '@ugm/desiagent';
 
 const client = await setupDesiAgent({
-  llmProvider: 'ollama',
-  ollamaBaseUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
-  modelName: 'llama3.2',
+  llmProvider: 'openrouter',
+  openrouterApiKey: process.env.OPENROUTER_API_KEY,
+  modelName: 'openai/gpt-4o',
+  databasePath: ':memory:',
+  skipGenerationStats: true,
+  logLevel: 'warn',
 });
 
-const execution = await client.dags.createAndExecute('Explain quantum computing in simple terms');
+// List seeded agents
+const agents = await client.agents.list();
+for (const a of agents) {
+  console.log(`${a.name} (${a.provider}/${a.model}) — ${a.description}`);
+}
+
+// List available tools
+const tools = await client.tools.list();
+for (const t of tools) {
+  console.log(t.function.name);
+}
+
 await client.shutdown();
 ```
 
-## Configuration Options
+### 4. Handle Clarifications
 
-```typescript
-interface DesiAgentConfig {
-  // LLM Provider (required)
-  llmProvider: 'openai' | 'openrouter' | 'ollama';
-  modelName: string;
+When the agent decides the goal is ambiguous, it returns a clarification query instead of creating a DAG.
 
-  // 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
+```typescript
+import { setupDesiAgent } from '@ugm/desiagent';
 
-  // Database (optional)
-  databasePath?: string;      // Default: ~/.desiAgent/data/agent.db
+const client = await setupDesiAgent({
+  llmProvider: 'openrouter',
+  openrouterApiKey: process.env.OPENROUTER_API_KEY,
+  modelName: 'google/gemini-2.5-flash-lite-preview-09-2025',
+  databasePath: ':memory:',
+  skipGenerationStats: true,
+});
 
-  // Agent definitions (optional)
-  agentDefinitionsPath?: string;  // Default: ~/.desiAgent/agents
+const plan = await client.dags.createFromGoal({
+  goalText: 'Build the app',
+  agentName: 'DecomposerV9',
+});
 
-  // Logging (optional)
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';  // Default: 'info'
+if (plan.status === 'clarification_required') {
+  console.log('Agent asks:', plan.clarificationQuery);
 
-  // Callbacks (optional)
-  onExecutionStart?: (executionId: string) => void;
-  onExecutionEnd?: (executionId: string, result: any) => void;
+  // Provide the answer and retry
+  const resumed = await client.dags.resumeFromClarification(
+    plan.dagId,
+    'A Pomodoro timer web app using HTML, CSS, and vanilla JS',
+  );
+  console.log('Resumed status:', resumed.status);
 }
+
+await client.shutdown();
 ```
 
-## API Reference
+### 5. Custom Inference (No DAG)
 
-### Agents
+Use a named agent directly for a single LLM call — useful for summarisation, translation, or any one-shot task.
 
 ```typescript
-// Create a new agent
-const agent = await client.agents.create(name, version, prompt, params?);
+import { setupDesiAgent } from '@ugm/desiagent';
 
-// List all agents
-const agents = await client.agents.list(filter?);
+const client = await setupDesiAgent({
+  llmProvider: 'openrouter',
+  openrouterApiKey: process.env.OPENROUTER_API_KEY,
+  modelName: 'openai/gpt-4o',
+  databasePath: ':memory:',
+  skipGenerationStats: true,
+});
+
+// Resolve an agent by name and call it directly
+const agent = await client.agents.resolve('Summarizer');
+// ... or use the lower-level inference API in scripts/infer.ts
+
+await client.shutdown();
+```
+
+### Running the Bundled Examples
 
-// Get a specific agent
-const agent = await client.agents.get(id);
+The [`examples/`](./examples/) directory contains runnable scripts:
 
-// Update an agent
-await client.agents.update(id, updates);
+```bash
+# Execute a goal from a file
+bun run examples/execute-goal.ts -f examples/goals/pomodoro-timer.txt
+
+# In-memory database smoke test
+bun run examples/init_6_memory_db.ts
 
-// Activate/Delete an agent
-await client.agents.activate(id);
-await client.agents.delete(id);
+# List all agents
+bun run examples/list-agents.ts
 
-// Resolve agent by name
-const agent = await client.agents.resolve(name);
+# List all tools
+bun run examples/list-tools.ts --names
 ```
 
-### DAGs (Directed Acyclic Graphs)
+## Skills
 
-```typescript
-// Create a DAG from an objective
-const dag = await client.dags.create(objective, params?);
+Skills are reusable instruction files (`SKILL.md`) that extend what the agent can do. Each skill is a Markdown file with YAML frontmatter describing its name, description, and type. When a goal is submitted, desiAgent automatically discovers skills, detects which ones are relevant, and either injects their content into the LLM prompt or executes them as sub-tasks inside a DAG.
 
-// Create and immediately execute
-const execution = await client.dags.createAndExecute(objective, params?);
+### Skill Types
 
-// Execute an existing DAG
-const execution = await client.dags.execute(dagId, params?);
+| Type | Behaviour |
+|---|---|
+| `context` | The skill's Markdown body is loaded and injected as instructions into an LLM inference call during DAG execution. |
+| `executable` | A sibling `handler.ts` file is imported and its default export is called with the task parameters. |
 
-// List DAGs
-const dags = await client.dags.list(filter?);
-const scheduled = await client.dags.listScheduled();
+### SKILL.md Format
 
-// Get/Update/Delete
-const dag = await client.dags.get(id);
-await client.dags.update(id, updates);
-await client.dags.delete(id);
+```markdown
+---
+name: my-skill
+description: A short sentence describing what this skill does (min 10 chars).
+type: context        # or "executable"
+model: openai/gpt-4o # optional — override model for this skill
+provider: openrouter  # optional — override provider
+---
 
-// Resume a paused execution
-await client.dags.resume(executionId);
+Your skill instructions in Markdown go here.
+The agent receives this content when the skill is used.
 ```
 
-### Executions
+> The `name` field **must** match the enclosing directory name (e.g., `my-skill/SKILL.md` must have `name: my-skill`).
 
-```typescript
-// List executions
-const executions = await client.executions.list(filter?);
+### Discovery
 
-// Get execution details
-const execution = await client.executions.get(id);
-const subSteps = await client.executions.getSubSteps(id);
+On startup, `SkillRegistry.discover()` scans the following locations **in order**. The first skill registered for a given name wins — later duplicates are silently skipped.
 
-// Delete an execution
-await client.executions.delete(id);
+| Priority | Location | Scope |
+|---|---|---|
+| 1 | `<workspace>/.agents/skills/<name>/SKILL.md` | Local (workspace) |
+| 2 | `<workspace>/skills/<name>/SKILL.md` | Local (workspace) |
+| 3 | `<workspace>/SKILL.md` | Local (workspace root) |
+| 4 | `~/.config/agents/skills/<name>/SKILL.md` | Global |
+| 5 | `~/.desiAgent/skills/<name>/SKILL.md` | Global |
 
-// Stream execution events (AsyncIterable)
-for await (const event of client.executions.streamEvents(id)) {
-  console.log(event.type, event.data);
+**Local wins over global.** If a workspace defines a skill named `summarizer` in `.agents/skills/summarizer/SKILL.md` and a global skill with the same name exists in `~/.desiAgent/skills/summarizer/SKILL.md`, the workspace version is used.
+
+### How Skills Are Selected
+
+When you submit a goal, a `MinimalSkillDetector` checks for:
+
+1. **Explicit triggers** — phrases like `use skill <name>` or `use <name> skill` in the goal text.
+2. **Keyword matching** — if no explicit trigger is found, skill descriptions are matched against keywords in the goal.
+
+Matched skills are listed in the agent's system prompt so the LLM can plan DAG tasks with `action_type: 'skill'`.
+
+### Using Skills Programmatically
+
+```typescript
+import { SkillRegistry } from '@ugm/desiagent';
+
+const registry = new SkillRegistry(process.cwd());
+await registry.discover();
+
+// List all discovered skills
+for (const skill of registry.getAll()) {
+  console.log(`${skill.name} (${skill.type}) — ${skill.description}`);
 }
+
+// Load a skill's content
+const content = await registry.loadContent('my-skill');
+console.log(content);
 ```
 
-## CLI
+## Configuration Reference
 
-The `desi` CLI ships with the standalone `desiCLI` package. Command groups support default subcommands for convenience:
+```typescript
+interface DesiAgentConfig {
+  llmProvider: 'openai' | 'openrouter' | 'ollama';
+  modelName: string;
 
-```bash
-# Artifacts
-desi artifacts              # Same as: desi artifacts list
-desi artifacts report.json  # Same as: desi artifacts get report.json
+  // Provider keys
+  openaiApiKey?: string;
+  openrouterApiKey?: string;
+  ollamaBaseUrl?: string;       // default: http://localhost:11434
+
+  // Storage
+  databasePath?: string;        // default: ~/.desiAgent/data/agent.db
+                                 // use ':memory:' for ephemeral experiments
+  artifactsDir?: string;        // default: sibling of database file
 
-# Agents
-desi agents                 # Same as: desi agents list
+  // Agent definitions
+  agentDefinitionsPath?: string; // default: ~/.desiAgent/agents
 
-# Results
-desi results exec_123       # Same as: desi results view exec_123
+  // Logging
+  logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'silent';
+
+  // Lifecycle hooks
+  onExecutionStart?: (executionId: string) => void;
+  onExecutionEnd?: (executionId: string, result: Record<string, any>) => void;
+
+  // Workspace root for skill discovery
+  workspaceRoot?: string;         // default: process.cwd()
+
+  // Feature flags
+  autoStartScheduler?: boolean;  // default: true
+  enableToolValidation?: boolean; // default: true
+  skipGenerationStats?: boolean; // default: false
+}
 ```
 
-## Examples
+## Contributing
 
-### News Bulletin Generator
+We welcome contributions of all kinds — bug fixes, new tools, documentation improvements, and feature ideas.
 
-See [`examples/news-bulletin.ts`](./examples/news-bulletin.ts) for a complete example that creates a news bulletin with multiple categories.
+### Getting Started
 
-```bash
-# Run with Ollama
-bun run examples/news-bulletin.ts
+1. **Fork & clone** the repository.
 
-# Run with OpenRouter
-OPENROUTER_API_KEY=your-key bun run examples/news-bulletin-openrouter.ts
-```
+   ```bash
+   git clone https://github.com/<your-username>/desiAgent.git
+   cd desiAgent
+   ```
 
-## Manual Abort Tests
+2. **Install dependencies** (requires Bun ≥ 1.3.5).
 
-Use these scripts to manually verify that abort signals cancel in-flight LLM calls.
+   ```bash
+   bun install
+   ```
 
-```bash
-# OpenRouter abort test
-OPENROUTER_API_KEY=sk-or-... ABORT_AFTER_MS=2000 bun run test:abort:openrouter
+3. **Create a branch** for your change.
 
-# Ollama abort test
-OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL=mistral ABORT_AFTER_MS=2000 bun run test:abort:ollama
-```
+   ```bash
+   git checkout -b feat/my-awesome-feature
+   ```
 
-## Development
+4. **Make your changes**, then verify:
 
-### Setup
+   ```bash
+   bun run type-check   # TypeScript must compile cleanly
+   bun test             # All tests must pass
+   ```
 
-```bash
-# Install dependencies
-pnpm install
+### Code Guidelines
+
+- **TypeScript only** — no plain JS files.
+- **Follow existing patterns** — look at neighbouring files before writing new code. Match naming conventions, imports, and error handling style.
+- **Keep PRs focused** — one logical change per pull request. Small, reviewable diffs are merged faster.
+- **Write tests** — if you add a feature or fix a bug, add or update a test in the corresponding `*.test.ts` file. Run `bun test` to verify.
+- **No secrets** — never commit API keys, tokens, or credentials. Use environment variables and `.env` files (already in `.gitignore`).
 
-# Run in development mode
-bun run dev
+### Commit Messages
+
+Follow the [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```
+feat: add PDF attachment support to inference
+fix: handle empty goal text in DAG creation
+docs: update README examples
+chore: bump drizzle-orm to 0.46
 ```
 
-### Commands
+### Pull Request Process
 
-```bash
-# Build
-pnpm build
+1. Ensure your branch is up to date with `main`.
+2. Open a PR against `main` with a clear title and description of **what** and **why**.
+3. Link any related issues (e.g., `Closes #42`).
+4. A maintainer will review your PR. Address feedback promptly — we aim to merge within a few days.
 
-# Type check
-pnpm type-check
+### Reporting Issues
 
-# Run tests
-pnpm test
-pnpm test:watch
-pnpm test:coverage
+- Use [GitHub Issues](https://github.com/ugmurthy/desiAgent/issues) to report bugs or request features.
+- Include steps to reproduce, expected vs. actual behaviour, and your environment (OS, Bun version, provider used).
 
-# Database commands
-pnpm db:generate
-pnpm db:push
-pnpm db:studio
-```
+### Code of Conduct
+
+Be respectful and constructive. We follow the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.
 
 ## License
 

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

@@ -1 +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"}
+{"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;IAkFjE;;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

@@ -133,11 +133,25 @@ export class AgentsService {
         if (updates.systemPrompt !== undefined) {
             updateData.promptTemplate = updates.systemPrompt;
         }
-        if (updates.constraints?.maxTokens !== undefined) {
-            updateData.model = updates.constraints.maxTokens;
+        if (updates.provider !== undefined) {
+            updateData.provider = updates.provider;
         }
-        if (updates.metadata !== undefined) {
-            updateData.metadata = updates.metadata;
+        if (updates.model !== undefined) {
+            updateData.model = updates.model;
+        }
+        // Build metadata: if metadata is explicitly provided, it replaces existing;
+        // description and constraints are merged on top of existing metadata
+        if (updates.metadata !== undefined || updates.description !== undefined || updates.constraints !== undefined) {
+            const currentMetadata = existing.metadata || {};
+            const baseMetadata = updates.metadata !== undefined ? updates.metadata : currentMetadata;
+            updateData.metadata = {
+                ...baseMetadata,
+                ...(updates.constraints !== undefined ? { constraints: updates.constraints } : {}),
+                ...(updates.description !== undefined ? { description: updates.description } : {}),
+            };
+        }
+        if (updates.isActive !== undefined) {
+            updateData.active = updates.isActive;
         }
         await this.db.update(agents).set(updateData).where(eq(agents.id, id));
         // Invalidate cache for this agent