@iqai/adk 0.0.15 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @iqai/adk
 
+## 0.1.1
+
+### Patch Changes
+
+- 8b45e2b: Adds agent builder to create agents with minimal boiler plate
+
+## 0.1.0
+
+### Minor Changes
+
+- 481e0da: Rewrites common interfaces to match more close to adk-python
+
+### Patch Changes
+
+- 1741097: Fixes openai models not getting system message
+- 75309a1: postgres-session-service: new fromConnectionString() factory method. fix minor duplication bug
+- 33b1887: added planners
+
 ## 0.0.15
 
 ### Patch Changes

package/README.md

@@ -68,7 +68,7 @@ dotenv.config();
 // Instantiate the agent
 const myAgent = new Agent({
   name: "simple_query_assistant",
-  model: "gemini-2.5-flash-preview-05-20", // Or "gpt-4-turbo", "claude-3-opus"
+  model: "gemini-2.5-flash", // Or "gpt-4-turbo", "claude-3-opus"
   description: "A basic assistant to answer questions.",
   instructions: "You are a helpful AI. Respond clearly and concisely."
 });
@@ -92,6 +92,68 @@ async function runQuery() {
 runQuery();
 ```
 
+## 🎯 AgentBuilder - Simplified Agent Creation
+
+The `AgentBuilder` provides a fluent interface for creating agents with minimal boilerplate. It's perfect for rapid prototyping and reduces the complexity of agent setup.
+
+```typescript
+import { AgentBuilder } from '@iqai/adk';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+// Simple agent creation and execution in one fluent chain
+async function quickQuery() {
+  const response = await AgentBuilder
+    .create("query_assistant")
+    .withModel("gemini-2.5-flash")
+    .withInstruction("You are a helpful AI. Respond clearly and concisely.")
+    .withQuickSession("my-app", "user-123")
+    .ask("What is the capital of France?");
+
+  console.log(response);
+}
+
+// For more complex scenarios, build the agent and get full control
+async function advancedSetup() {
+  const { agent, runner, session } = await AgentBuilder
+    .create("research_assistant")
+    .withModel("gpt-4-turbo")
+    .withDescription("An advanced research assistant")
+    .withInstruction("You are a research assistant with access to various tools")
+    .withTools(new GoogleSearchTool(), new FileOperationsTool())
+    .withQuickSession("research-app", "researcher-456")
+    .build();
+
+  // Now you have full access to agent, runner, and session for advanced usage
+  console.log(`Created agent: ${agent.name}`);
+}
+
+// Specialized agent types for orchestration
+async function createWorkflowAgent() {
+  // Sequential execution of multiple agents
+  const workflow = await AgentBuilder
+    .create("data_pipeline")
+    .asSequential([dataCollector, dataProcessor, dataAnalyzer])
+    .withQuickSession("pipeline-app", "admin")
+    .build();
+
+  // Parallel execution for concurrent tasks
+  const parallelAnalysis = await AgentBuilder
+    .create("multi_analysis")
+    .asParallel([sentimentAnalyzer, topicExtractor, summaryGenerator])
+    .build();
+}
+```
+
+**Benefits of AgentBuilder:**
+- **Reduced Boilerplate**: ~80% less setup code compared to manual configuration
+- **Fluent Interface**: Readable, chainable method calls
+- **Automatic Management**: Handles session and runner creation automatically
+- **Quick Execution**: Built-in `ask()` method for immediate responses
+- **Flexible**: Supports all agent types (LLM, Sequential, Parallel, Loop, LangGraph)
+- **Backward Compatible**: Works alongside existing ADK patterns
+
 ## 🛠️ Using Tools with an Agent
 
 Extend your agent's capabilities by defining and integrating custom tools.