@ax-llm/ax 19.0.39 → 19.0.40

package/README.md

@@ -0,0 +1,235 @@
+# Ax: Build Reliable AI Apps in TypeScript
+
+**Stop wrestling with prompts. Start shipping AI features.**
+
+Ax brings DSPy's revolutionary approach to TypeScript – just describe what you
+want, and let the framework handle the rest. Production-ready, type-safe, and
+works with all major LLMs.
+
+[![NPM Package](https://img.shields.io/npm/v/@ax-llm/ax?style=for-the-badge&color=green)](https://www.npmjs.com/package/@ax-llm/ax)
+[![Twitter](https://img.shields.io/twitter/follow/dosco?style=for-the-badge&color=red)](https://twitter.com/dosco)
+[![Discord Chat](https://img.shields.io/discord/1078454354849304667?style=for-the-badge&color=green)](https://discord.gg/DSHg3dU7dW)
+
+## Transform Your AI Development in 30 Seconds
+
+```typescript
+import { ai, ax } from "@ax-llm/ax";
+
+// 1. Pick any LLM
+const llm = ai({ name: "openai", apiKey: process.env.OPENAI_APIKEY! });
+
+// 2. Say what you want
+const classifier = ax(
+  'review:string -> sentiment:class "positive, negative, neutral"',
+);
+
+// 3. Get type-safe results
+const result = await classifier.forward(llm, {
+  review: "This product is amazing!",
+});
+console.log(result.sentiment); // "positive" ✨
+```
+
+**That's it.** No prompt engineering. No trial and error. It works with GPT-4,
+Claude, Gemini, or any LLM.
+
+## Why Thousands of Developers Choose Ax
+
+### 🎯 **Define Once, Run Anywhere**
+
+Write your logic once. Switch between OpenAI, Anthropic, Google, or 15+
+providers with one line. No rewrites needed.
+
+### ⚡ **Ship 10x Faster**
+
+Stop tweaking prompts. Define inputs → outputs. The framework generates optimal
+prompts automatically.
+
+### 🛡️ **Production-Ready from Day One**
+
+Built-in streaming, validation, error handling, observability. Used by startups
+in production handling millions of requests.
+
+### 🚀 **Gets Smarter Over Time**
+
+Train your programs with examples. Watch accuracy improve automatically. No ML
+expertise needed.
+
+## Real Apps, Real Simple
+
+### Extract Structured Data from Customer Emails
+
+```typescript
+const extractor = ax(`
+  customerEmail:string, currentDate:datetime -> 
+  priority:class "high, normal, low",
+  sentiment:class "positive, negative, neutral",
+  ticketNumber?:number,
+  nextSteps:string[],
+  estimatedResponseTime:string
+`);
+
+const result = await extractor.forward(ai, {
+  customerEmail: "Order #12345 hasn't arrived. Need this resolved immediately!",
+  currentDate: new Date(),
+});
+// Automatically extracts all fields with proper types and validation
+```
+
+### Build Agents That Use Tools (ReAct Pattern)
+
+```typescript
+const assistant = ax(
+  "question:string -> answer:string",
+  {
+    functions: [
+      { name: "getCurrentWeather", func: weatherAPI },
+      { name: "searchNews", func: newsAPI },
+    ],
+  },
+);
+
+const result = await assistant.forward(ai, {
+  question: "What's the weather in Tokyo and any news about it?",
+});
+// AI automatically calls both functions and combines results
+```
+
+### Multi-Modal Analysis with Images
+
+```typescript
+const analyzer = ax(`
+  image:image, question:string ->
+  description:string,
+  mainColors:string[],
+  category:class "electronics, clothing, food, other",
+  estimatedPrice:string
+`);
+// Process images and text together seamlessly
+```
+
+## Quick Start
+
+### Install
+
+```bash
+npm install @ax-llm/ax
+```
+
+### Your First AI Feature (2 minutes)
+
+```typescript
+import { ai, ax } from "@ax-llm/ax";
+
+const llm = ai({ name: "openai", apiKey: process.env.OPENAI_APIKEY! });
+
+const translator = ax(`
+  text:string, 
+  language:string -> 
+  translation:string
+`);
+
+const result = await translator.forward(llm, {
+  text: "Hello world",
+  language: "Spanish",
+});
+console.log(result.translation); // "Hola mundo"
+```
+
+## Powerful Features, Zero Complexity
+
+- ✅ **15+ LLM Providers** - OpenAI, Anthropic, Google, Mistral, Ollama, and
+  more
+- ✅ **Type-Safe Everything** - Full TypeScript support with auto-completion
+- ✅ **Streaming First** - Real-time responses with validation
+- ✅ **Multi-Modal** - Images, audio, text in the same signature
+- ✅ **Smart Optimization** - Automatic prompt tuning with MiPRO
+- ✅ **Production Observability** - OpenTelemetry tracing built-in
+- ✅ **Advanced Workflows** - Compose complex pipelines with AxFlow
+- ✅ **Enterprise RAG** - Multi-hop retrieval with quality loops
+- ✅ **Agent Framework** - Agents that can use tools and call other agents
+- ✅ **Zero Dependencies** - Lightweight, fast, reliable
+
+## Learn More
+
+### 🚀 Quick Wins
+
+- [**Getting Started Guide**](https://github.com/ax-llm/ax/blob/main/docs/QUICKSTART.md) -
+  Set up in 5 minutes
+- [**Examples Guide**](https://github.com/ax-llm/ax/blob/main/docs/EXAMPLES.md) -
+  Comprehensive examples with explanations
+- [**DSPy Concepts**](https://github.com/ax-llm/ax/blob/main/docs/DSPY.md) -
+  Understand the revolutionary approach
+
+### 📚 Deep Dives
+
+- [**AxFlow Workflows**](https://github.com/ax-llm/ax/blob/main/docs/AXFLOW.md) -
+  Build complex AI systems
+- [**Optimization Guide**](https://github.com/ax-llm/ax/blob/main/docs/OPTIMIZE.md) -
+  Make your programs smarter
+- [**Advanced RAG**](https://github.com/ax-llm/ax/blob/main/docs/AXRAG.md) -
+  Production search & retrieval
+- [**API Reference**](https://github.com/ax-llm/ax/blob/main/docs/API.md) -
+  Complete documentation
+
+## Examples
+
+Run any example:
+
+```bash
+OPENAI_APIKEY=your-key npm run tsx ./src/examples/[example-name].ts
+```
+
+### Core Examples
+
+- [extract.ts](src/examples/extract.ts) - Extract structured data from text
+- [react.ts](src/examples/react.ts) - ReAct pattern with function calling
+- [agent.ts](src/examples/agent.ts) - Multi-agent collaboration
+- [streaming1.ts](src/examples/streaming1.ts) - Real-time streaming responses
+- [multi-modal.ts](src/examples/multi-modal.ts) - Image + text processing
+
+### Production Patterns
+
+- [customer-support.ts](src/examples/customer-support.ts) - Complete support
+  system
+- [food-search.ts](src/examples/food-search.ts) - Restaurant recommendations
+  with tools
+- [simple-optimizer-test.ts](src/examples/simple-optimizer-test.ts) - Automatic
+  optimization
+- [mipro-python-optimizer.ts](src/examples/mipro-python-optimizer.ts) - Advanced
+  MIPRO optimization
+- [ax-flow-enhanced-demo.ts](src/examples/ax-flow-enhanced-demo.ts) - Complex
+  workflows
+
+[📚 **View Full Examples Guide** →](docs/EXAMPLES.md)\
+[View All 70+ Examples →](src/examples/)
+
+## Join the Community
+
+- 🐦 [Follow on Twitter](https://twitter.com/dosco) - Latest updates
+- 💬 [Discord Community](https://discord.gg/DSHg3dU7dW) - Get help, share ideas
+- ⭐ [Star on GitHub](https://github.com/ax-llm/ax) - Support the project
+- 📖 [Ask DeepWiki](https://deepwiki.com/ax-llm/ax) - AI-powered docs
+
+## Production Ready
+
+- ✅ **Battle-tested** - Used by startups in production
+- ✅ **No breaking changes** - Stable minor versions
+- ✅ **Comprehensive tests** - Large test coverage
+- ✅ **OpenTelemetry** - Built-in observability
+- ✅ **TypeScript first** - Type-safe by design
+
+## License
+
+Apache 2 - Use it anywhere, build anything.
+
+---
+
+**Ready to build the future?** Stop fighting with prompts. Start shipping with
+signatures.
+
+```bash
+npm install @ax-llm/ax
+```
+
+_Built with ❤️ by developers, for developers._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ax-llm/ax",
-  "version": "19.0.39",
+  "version": "19.0.40",
   "type": "module",
   "description": "The best library to work with LLMs",
   "repository": {

package/skills/ax-agent-optimize.md

@@ -1,7 +1,7 @@
 ---
 name: ax-agent-optimize
 description: This skill helps an LLM generate correct AxAgent tuning and evaluation code using @ax-llm/ax. Use when the user asks about agent.optimize(...), judgeOptions, eval datasets, optimization targets, saved optimizedProgram artifacts, or recursive optimization guidance.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxAgent Optimize Codegen Rules (@ax-llm/ax)

package/skills/ax-agent.md

@@ -1,7 +1,7 @@
 ---
 name: ax-agent
 description: This skill helps an LLM generate correct AxAgent code using @ax-llm/ax. Use when the user asks about agent(), child agents, namespaced functions, discovery mode, shared fields, llmQuery(...), RLM code execution, recursionOptions, or agent runtime behavior. For tuning and eval with agent.optimize(...), use ax-agent-optimize.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxAgent Codegen Rules (@ax-llm/ax)

package/skills/ax-ai.md

@@ -1,7 +1,7 @@
 ---
 name: ax-ai
 description: This skill helps an LLM generate correct AI provider setup and configuration code using @ax-llm/ax. Use when the user asks about ai(), providers, models, presets, embeddings, extended thinking, context caching, or mentions OpenAI/Anthropic/Google/Azure/Groq/DeepSeek/Mistral/Cohere/Together/Ollama/HuggingFace/Reka/OpenRouter with @ax-llm/ax.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AI Provider Codegen Rules (@ax-llm/ax)

package/skills/ax-flow.md

@@ -1,7 +1,7 @@
 ---
 name: ax-flow
 description: This skill helps an LLM generate correct AxFlow workflow code using @ax-llm/ax. Use when the user asks about flow(), AxFlow, workflow orchestration, parallel execution, DAG workflows, conditional routing, map/reduce patterns, or multi-node AI pipelines.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxFlow Codegen Rules (@ax-llm/ax)

package/skills/ax-gen.md

@@ -1,7 +1,7 @@
 ---
 name: ax-gen
 description: This skill helps an LLM generate correct AxGen code using @ax-llm/ax. Use when the user asks about ax(), AxGen, generators, forward(), streamingForward(), assertions, field processors, step hooks, self-tuning, or structured outputs.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxGen Codegen Rules (@ax-llm/ax)

package/skills/ax-gepa.md

@@ -1,7 +1,7 @@
 ---
 name: ax-gepa
 description: This skill helps an LLM generate correct AxGEPA optimization code using @ax-llm/ax. Use when the user asks about AxGEPA, GEPA, Pareto optimization, multi-objective prompt tuning, reflective prompt evolution, validationExamples, maxMetricCalls, or optimizing a generator, flow, or agent tree.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxGEPA Codegen Rules (@ax-llm/ax)

package/skills/ax-learn.md

@@ -1,7 +1,7 @@
 ---
 name: ax-learn
 description: This skill helps an LLM generate correct AxLearn code using @ax-llm/ax. Use when the user asks about self-improving agents, trace-backed learning, feedback-aware updates, or AxLearn modes.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # AxLearn Codegen Rules (@ax-llm/ax)

package/skills/ax-llm.md

@@ -1,7 +1,7 @@
 ---
 name: ax
 description: This skill helps with using the @ax-llm/ax TypeScript library for building LLM applications. Use when the user asks about ax(), ai(), f(), s(), agent(), flow(), AxGen, AxAgent, AxFlow, signatures, streaming, or mentions @ax-llm/ax.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # Ax Library (@ax-llm/ax) Quick Reference

package/skills/ax-signature.md

@@ -1,7 +1,7 @@
 ---
 name: ax-signature
 description: This skill helps an LLM generate correct DSPy signature code using @ax-llm/ax. Use when the user asks about signatures, s(), f(), field types, string syntax, fluent builder API, validation constraints, or type-safe inputs/outputs.
-version: "19.0.39"
+version: "19.0.40"
 ---
 
 # Ax Signature Reference