myuru 0.3.1 → 2.0.0-alpha.2

package/README.md

@@ -3,98 +3,226 @@
 [![npm version](https://img.shields.io/npm/v/myuru.svg)](https://www.npmjs.com/package/myuru)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Multi-provider AI agent orchestrator. Coordinate Claude, GPT, and Gemini agents to build software in parallel.
+TypeScript-first multi-agent orchestration framework. Coordinate AI agents across any provider with built-in tracing, intelligent routing, and production-grade reliability.
 
-## Features
+## Why MyUru?
 
-- **Multi-Provider**: Claude, OpenAI, Gemini
-- **Council Mode**: Agents deliberate in a chatroom, then execute tasks together
-- **Session Persistence**: Agents maintain context across invocations
-- **Terminal Dashboard**: Real-time ANSI UI showing agent status
-- **Concurrent Execution**: Run agents in parallel or sequentially
+- **Provider-agnostic** -- works with Claude, GPT, Gemini, Mistral, and 40+ providers via the Vercel AI SDK
+- **TypeScript-native** -- full type safety, no Python bridge, runs anywhere Node runs
+- **Built-in observability** -- every run produces token counts, cost estimates, and step-by-step traces
+- **Intelligent routing** -- automatically selects the right model for each task based on complexity
+- **Pipeline orchestration** -- chain agents sequentially, in parallel, or in mixed patterns with human approval gates
+- **Checkpoint/resume** -- long-running pipelines survive crashes and can be resumed from disk
 
 ## Installation
 
 ```bash
-npm install -g myuru
+npm install myuru
 ```
 
-## Quick Start
-
-Initialize a project:
+Install at least one provider SDK:
 
 ```bash
-myuru init
+npm install @ai-sdk/anthropic  # or @ai-sdk/openai, @ai-sdk/google
 ```
 
-Run agents on a task:
+## Quick Start
 
-```bash
-myuru run --task "Build a login page with JWT auth"
-```
+### Single Agent
 
-Output:
+```ts
+import { Agent } from 'myuru';
+import { anthropic } from '@ai-sdk/anthropic';
+
+const agent = new Agent({
+  name: 'researcher',
+  model: anthropic('claude-sonnet-4-5'),
+  instructions: 'You are a research assistant. Be concise and accurate.',
+});
+
+const result = await agent.run('What are the top TypeScript frameworks in 2026?');
+console.log(result.text);
+console.log(`Cost: $${result.usage.estimatedCostUsd.toFixed(4)}`);
 ```
-[Agent Architect] Designing authentication system...
-[Agent Frontend] Building React login form...
-[Agent Security] Implementing JWT validation...
 
-Tasks completed: 3/3 | Status: SUCCESS
+### Agent with Tools
+
+```ts
+import { Agent, defineTool, z } from 'myuru';
+import { openai } from '@ai-sdk/openai';
+
+const searchTool = defineTool({
+  name: 'web_search',
+  description: 'Search the web for information',
+  parameters: z.object({
+    query: z.string().describe('The search query'),
+  }),
+  execute: async ({ query }) => {
+    // Your search implementation
+    return `Results for: ${query}`;
+  },
+});
+
+const agent = Agent.create({
+  name: 'search-agent',
+  model: openai('gpt-4o'),
+  instructions: 'Use the search tool to find accurate information.',
+  tools: [searchTool],
+  maxSteps: 5,
+  budgetPerRun: 0.50, // USD limit per run
+});
+
+const result = await agent.run('Find the latest Node.js LTS version');
 ```
 
-Start a council discussion:
+### Streaming
 
-```bash
-myuru council \
-  --topic "Design auth system" \
-  --agents "Architect,Security,Frontend"
+```ts
+const stream = agent.stream('Write a haiku about TypeScript');
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk);
+}
+// The return value contains the full AgentResult
 ```
 
-Check task progress:
+### Pipeline (Multi-Agent)
 
-```bash
-myuru status
+```ts
+import { Agent, Pipeline, parallel } from 'myuru';
+import { anthropic } from '@ai-sdk/anthropic';
+
+const model = anthropic('claude-sonnet-4-5');
+
+const pipeline = new Pipeline({
+  name: 'research-and-write',
+  agents: {
+    researcher: { name: 'researcher', model, instructions: 'Find key facts.' },
+    writer: { name: 'writer', model, instructions: 'Write clear, engaging content.' },
+    editor: { name: 'editor', model, instructions: 'Fix grammar and improve clarity.' },
+  },
+  steps: [
+    { agent: 'researcher', input: (ctx) => `Research: ${ctx.task}` },
+    { agent: 'writer', input: (ctx) => `Write an article using these facts:\n${ctx.results.researcher}` },
+    { agent: 'editor', input: (ctx) => `Edit this article:\n${ctx.results.writer}` },
+  ],
+  trace: true,
+});
+
+const result = await pipeline.run('The state of TypeScript in 2026');
+console.log(result.finalOutput);
 ```
 
-## Commands
+### Intelligent Model Routing
 
-| Command | Description |
-|---------|-------------|
-| `myuru init` | Initialize project with config |
-| `myuru run --task "..."` | Run agents on a task |
-| `myuru council --topic "..." --agents "..." --model sonnet` | Start council deliberation |
-| `myuru status` | View task progress |
+```ts
+import { ModelRouter } from 'myuru';
+import { anthropic } from '@ai-sdk/anthropic';
+
+const router = new ModelRouter({
+  strategy: 'cost-optimized', // or 'quality-first', 'balanced'
+  models: {
+    complex: anthropic('claude-opus-4-6'),
+    standard: anthropic('claude-sonnet-4-5'),
+    simple: anthropic('claude-haiku-4-5'),
+  },
+  budget: { maxPerDay: 10.00 },
+});
+
+// Automatically picks the right model based on input complexity
+const model = router.select('Analyze the architectural trade-offs of...');
+```
 
-## Configuration
+### Human Approval Gates
+
+```ts
+const pipeline = new Pipeline({
+  name: 'deploy-pipeline',
+  agents: { /* ... */ },
+  steps: [
+    { agent: 'planner', input: (ctx) => ctx.task },
+    { agent: 'deployer', input: (ctx) => ctx.results.planner, needsApproval: true },
+  ],
+  onApproval: async (step, ctx) => {
+    // Your approval logic -- prompt user, check policy, etc.
+    return confirm(`Approve ${step.agent}?`);
+  },
+});
+```
 
-Set environment variables:
+## CLI
 
 ```bash
-export OPENAI_API_KEY="sk-..."
-export ANTHROPIC_API_KEY="sk-ant-..."
-export GEMINI_API_KEY="..."
+# Initialize a project
+npx myuru init
+
+# Run a task
+npx myuru run --task "Summarize this codebase" --provider anthropic --trace
 ```
 
-Create `myuru.config.mjs`:
-
-```js
-export default {
-  provider: "claude",
-  model: "sonnet",
-  agents: 2,
-  concurrent: false,
-  roles: {
-    Builder: "You are a software engineer. Write clean, working code.",
-    Reviewer: "You review code for bugs, security issues, and quality.",
-  },
+## API Reference
+
+### `Agent`
+
+| Method | Description |
+|--------|-------------|
+| `new Agent(config)` | Create an agent with name, model, instructions, tools |
+| `Agent.create(config)` | Create from NamedTool array (convenience) |
+| `agent.run(input, options?)` | Run and return full result |
+| `agent.stream(input, options?)` | Stream text chunks as they arrive |
+
+### `Pipeline`
+
+| Method | Description |
+|--------|-------------|
+| `new Pipeline(config)` | Create a multi-agent pipeline |
+| `pipeline.run(task)` | Execute the pipeline |
+| `sequential(steps)` | Group steps to run in order |
+| `parallel(steps)` | Group steps to run concurrently |
+
+### `ModelRouter`
+
+| Method | Description |
+|--------|-------------|
+| `new ModelRouter(config)` | Create with strategy and model tiers |
+| `router.select(input)` | Get the best model for this input |
+| `router.recordSpend(usd)` | Track spending for budget enforcement |
+
+### `defineTool`
+
+| Method | Description |
+|--------|-------------|
+| `defineTool(config)` | Create a type-safe tool with Zod schema |
+
+### Result Types
+
+```ts
+type AgentResult = {
+  text: string;           // Final text output
+  steps: StepResult[];    // Step-by-step execution log
+  usage: UsageSummary;    // Token counts + cost estimate
+  trace?: TraceRecord;    // Full trace (if enabled)
+};
+
+type UsageSummary = {
+  totalInputTokens: number;
+  totalOutputTokens: number;
+  totalTokens: number;
+  estimatedCostUsd: number;
+  stepCount: number;
 };
 ```
 
 ## Requirements
 
-- Node.js >= 18
-- Claude CLI (for Claude provider)
-- API keys for your chosen providers
+- Node.js >= 20
+- At least one AI provider SDK (`@ai-sdk/anthropic`, `@ai-sdk/openai`, `@ai-sdk/google`)
+
+## Related Tools
+
+- **[RulesForge](https://github.com/Wittlesus/rulesforge)** -- Auto-generate AI coding rules for any codebase
+- **[DepScope](https://github.com/Wittlesus/depscope)** -- Check npm dependency health scores
+- **[ScopeGuard](https://github.com/Wittlesus/scopeguard)** -- Prevent AI scope creep with session tracking
 
 ## License
 
@@ -102,4 +230,4 @@ MIT - See LICENSE file
 
 ---
 
-Built by Wittlesus | [GitHub](https://github.com/Wittlesus/myuru)
+Built by [@WSDevGuy](https://x.com/WSDevGuy) | [GitHub](https://github.com/Wittlesus/myuru)

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,4 @@
+export declare function initCommand(opts: {
+    dir: string;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CtE"}

package/dist/cli/commands/init.js

@@ -0,0 +1,87 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export async function initCommand(opts) {
+    const dir = path.resolve(opts.dir);
+    console.log(`\nMyUru v2 — Initializing project in ${dir}\n`);
+    // Create config file
+    const configPath = path.join(dir, 'myuru.config.ts');
+    if (!fs.existsSync(configPath)) {
+        fs.writeFileSync(configPath, CONFIG_TEMPLATE);
+        console.log('  Created myuru.config.ts');
+    }
+    else {
+        console.log('  myuru.config.ts already exists, skipping');
+    }
+    // Create agents directory
+    const agentsDir = path.join(dir, 'agents');
+    if (!fs.existsSync(agentsDir)) {
+        fs.mkdirSync(agentsDir, { recursive: true });
+        fs.writeFileSync(path.join(agentsDir, 'researcher.ts'), AGENT_TEMPLATE);
+        console.log('  Created agents/researcher.ts');
+    }
+    // Create .myuru directory for state
+    const stateDir = path.join(dir, '.myuru');
+    fs.mkdirSync(stateDir, { recursive: true });
+    console.log('  Created .myuru/ (state directory)');
+    // Add to .gitignore if it exists
+    const gitignorePath = path.join(dir, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('.myuru')) {
+            fs.appendFileSync(gitignorePath, '\n# MyUru state\n.myuru/\n');
+            console.log('  Added .myuru/ to .gitignore');
+        }
+    }
+    console.log('\nDone! Next steps:');
+    console.log('  1. Set your API key: export ANTHROPIC_API_KEY=sk-ant-...');
+    console.log('  2. Edit myuru.config.ts to configure your agents');
+    console.log('  3. Run: myuru run --task "Your task here"\n');
+}
+const CONFIG_TEMPLATE = `import { type AgentConfig } from 'myuru';
+
+// MyUru Configuration
+// Docs: https://github.com/Wittlesus/myuru
+
+export default {
+  // Default provider and model
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5',
+
+  // Agent definitions
+  agents: {
+    default: {
+      name: 'default',
+      instructions: 'You are a helpful AI assistant. Complete tasks efficiently.',
+      maxSteps: 10,
+    },
+  },
+
+  // Pipeline definitions (optional)
+  pipelines: {},
+
+  // Tracing
+  trace: false,
+
+  // Budget limits (optional)
+  budget: {
+    maxPerRun: 5.00,
+  },
+};
+`;
+const AGENT_TEMPLATE = `import { Agent, defineTool, z } from 'myuru';
+
+// Example agent definition
+// Import your provider:
+// import { anthropic } from '@ai-sdk/anthropic';
+
+// const researcher = new Agent({
+//   name: 'researcher',
+//   model: anthropic('claude-sonnet-4-5'),
+//   instructions: 'You are a research assistant. Find accurate information.',
+//   tools: {},
+//   maxSteps: 10,
+// });
+//
+// export default researcher;
+`;
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,wCAAwC,GAAG,IAAI,CAAC,CAAC;IAE7D,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,0BAA0B;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EACrC,cAAc,CACf,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAED,oCAAoC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAEnD,iCAAiC;IACjC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BvB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;CAetB,CAAC"}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,13 @@
+type RunOpts = {
+    task: string;
+    config: string;
+    model?: string;
+    provider: string;
+    maxSteps: string;
+    budget?: string;
+    trace?: boolean;
+    dryRun?: boolean;
+};
+export declare function runCommand(opts: RunOpts): Promise<void>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAGA,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD7D"}

package/dist/cli/commands/run.js

@@ -0,0 +1,69 @@
+import { Agent } from '../../core/agent.js';
+export async function runCommand(opts) {
+    const maxSteps = parseInt(opts.maxSteps, 10) || 10;
+    const budget = opts.budget ? parseFloat(opts.budget) : undefined;
+    console.log(`\nMyUru v2 | ${opts.provider}/${opts.model ?? 'default'}`);
+    console.log(`Task: ${opts.task.substring(0, 80)}`);
+    console.log(`Max steps: ${maxSteps}${budget ? ` | Budget: $${budget}` : ''}`);
+    console.log('─'.repeat(50));
+    if (opts.dryRun) {
+        console.log('\nDry run — would execute the above. Exiting.\n');
+        return;
+    }
+    // Resolve model
+    const model = await resolveModel(opts.provider, opts.model);
+    const agent = new Agent({
+        name: 'cli-agent',
+        model,
+        instructions: 'You are a helpful AI assistant. Complete the task efficiently.',
+        maxSteps,
+        budgetPerRun: budget,
+    });
+    const startTime = Date.now();
+    try {
+        const result = await agent.run(opts.task, {
+            trace: opts.trace,
+            onStep: (step) => {
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                if (step.toolCalls?.length) {
+                    for (const tc of step.toolCalls) {
+                        console.log(`  [${elapsed}s] Tool: ${tc.name}`);
+                    }
+                }
+                else if (step.text) {
+                    const preview = step.text.substring(0, 100).replace(/\n/g, ' ');
+                    console.log(`  [${elapsed}s] Text: ${preview}...`);
+                }
+            },
+        });
+        const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.log('\n' + '─'.repeat(50));
+        console.log(result.text);
+        console.log('─'.repeat(50));
+        console.log(`Steps: ${result.usage.stepCount} | Tokens: ${result.usage.totalTokens} | Cost: $${result.usage.estimatedCostUsd.toFixed(4)} | Time: ${elapsed}s`);
+        console.log('');
+    }
+    catch (error) {
+        console.error(`\nError: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    }
+}
+async function resolveModel(provider, modelName) {
+    switch (provider) {
+        case 'anthropic': {
+            const { anthropic } = await import('@ai-sdk/anthropic');
+            return anthropic(modelName ?? 'claude-sonnet-4-5');
+        }
+        case 'openai': {
+            const { openai } = await import('@ai-sdk/openai');
+            return openai(modelName ?? 'gpt-4o');
+        }
+        case 'google': {
+            const { google } = await import('@ai-sdk/google');
+            return google(modelName ?? 'gemini-2.0-flash');
+        }
+        default:
+            throw new Error(`Unknown provider: ${provider}. Use: anthropic, openai, google`);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAc5C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAa;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,WAAW;QACjB,KAAK;QACL,YAAY,EAAE,gEAAgE;QAC9E,QAAQ;QACR,YAAY,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;YACxC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACf,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC7D,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;oBAC3B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;wBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAChE,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,YAAY,OAAO,KAAK,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,SAAS,cAAc,MAAM,CAAC,KAAK,CAAC,WAAW,aAAa,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC;QAC/J,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAkB;IAC9D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxD,OAAO,SAAS,CAAC,SAAS,IAAI,mBAAmB,CAAqB,CAAC;QACzE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,SAAS,IAAI,QAAQ,CAAqB,CAAC;QAC3D,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAqB,CAAC;QACrE,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,kCAAkC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { runCommand } from './commands/run.js';
+const program = new Command();
+program
+    .name('myuru')
+    .description('TypeScript-first multi-agent orchestration framework')
+    .version('2.0.0-alpha.1');
+program
+    .command('init')
+    .description('Initialize a new MyUru project')
+    .option('-d, --dir <path>', 'Target directory', '.')
+    .action(initCommand);
+program
+    .command('run')
+    .description('Run an agent or pipeline')
+    .requiredOption('-t, --task <task>', 'Task description')
+    .option('-c, --config <path>', 'Config file path', 'myuru.config.ts')
+    .option('-m, --model <model>', 'Model to use (e.g. claude-sonnet-4-5)')
+    .option('-p, --provider <provider>', 'Provider (anthropic, openai, google)', 'anthropic')
+    .option('--max-steps <n>', 'Maximum agent steps', '10')
+    .option('--budget <usd>', 'Max budget in USD')
+    .option('--trace', 'Enable tracing output')
+    .option('--dry-run', 'Show what would run without executing')
+    .action(runCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,sDAAsD,CAAC;KACnE,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5B,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,GAAG,CAAC;KACnD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,0BAA0B,CAAC;KACvC,cAAc,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;KACvD,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;KACpE,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;KACtE,MAAM,CAAC,2BAA2B,EAAE,sCAAsC,EAAE,WAAW,CAAC;KACxF,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,CAAC;KACtD,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;KAC7C,MAAM,CAAC,SAAS,EAAE,uBAAuB,CAAC;KAC1C,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC;KAC5D,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/agent.d.ts

@@ -0,0 +1,53 @@
+import type { Model, AgentConfig, RunOptions, AgentResult } from '../types/index.js';
+import type { NamedTool } from './tool.js';
+/**
+ * Agent — the core primitive of MyUru.
+ *
+ * Wraps an LLM with instructions, tools, and built-in tracing.
+ * Uses the Vercel AI SDK under the hood for provider-agnostic model access.
+ *
+ * ```ts
+ * import { Agent } from 'myuru';
+ * import { anthropic } from '@ai-sdk/anthropic';
+ *
+ * const agent = new Agent({
+ *   name: 'researcher',
+ *   model: anthropic('claude-sonnet-4-5'),
+ *   instructions: 'You are a research assistant.',
+ *   tools: { search: searchTool },
+ * });
+ *
+ * const result = await agent.run('Find info about TypeScript frameworks');
+ * console.log(result.text);
+ * console.log(result.usage.estimatedCostUsd);
+ * ```
+ */
+export declare class Agent {
+    readonly name: string;
+    readonly model: Model;
+    readonly instructions: string;
+    readonly tools: Record<string, unknown>;
+    readonly maxSteps: number;
+    readonly budgetPerRun?: number;
+    readonly onBeforeToolCall?: (toolName: string, args: unknown) => boolean | Promise<boolean>;
+    constructor(config: AgentConfig);
+    /**
+     * Create an Agent from NamedTool array (convenience).
+     */
+    static create(config: Omit<AgentConfig, 'tools'> & {
+        tools?: NamedTool[];
+    }): Agent;
+    /**
+     * Run the agent on an input. Returns the full result with tracing.
+     */
+    run(input: string, options?: RunOptions): Promise<AgentResult>;
+    /**
+     * Stream the agent's response. Yields text chunks as they arrive.
+     */
+    stream(input: string, options?: RunOptions): AsyncGenerator<string, AgentResult>;
+    private buildSystemPrompt;
+    private extractModelId;
+    private mapStep;
+    private summarizeUsage;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,UAAU,EAEV,WAAW,EAIZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;gBAEhF,MAAM,EAAE,WAAW;IAmB/B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,KAAK;IAKlF;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA+DpE;;OAEG;IACI,MAAM,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,UAAU,GACnB,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC;IAsDtC,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,cAAc;CAiBvB"}