@ax-llm/ax 19.0.9 → 19.0.11

package/package.json

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

package/skills/ax-agent.md

@@ -1,7 +1,7 @@
 ---
 name: ax-agent
 description: This skill helps with building AxAgent-based agents using @ax-llm/ax. Use when the user asks about agent(), AxAgent, child agents, tool functions, RLM mode, stopping agents, composing multi-agent hierarchies, shared fields, shared agents, or global shared fields/agents.
-version: "19.0.9"
+version: "19.0.11"
 ---
 
 # AxAgent Guide (@ax-llm/ax)
@@ -348,17 +348,20 @@ When composing agent hierarchies, you often need to pass data or utility agents
 
 ### `fields.shared` — Pass fields to direct children (one level)
 
-Fields listed in `fields.shared` are automatically injected into direct child agents at runtime. They bypass the parent's LLM entirely.
+Fields listed in `fields.shared` are automatically injected into direct child agents at runtime. By default, they bypass the parent's LLM.
 
 ```typescript
 const parentAgent = agent('query:string, userId:string, knowledgeBase:string -> answer:string', {
   agents: { local: [childAgent] },
   contextFields: ['knowledgeBase'],
-  fields: { shared: ['userId'] },  // userId is injected into child agents automatically
+  fields: {
+    shared: ['userId'],  // userId is injected into child agents automatically
+    local: ['userId'],   // and remains available in the parent Actor/Responder too
+  },
 });
 ```
 
-- `userId` is removed from the parent's Actor/Responder prompts
+- Without `fields.local`, `userId` is removed from the parent's Actor/Responder prompts
 - Children can opt out via `fields: { excluded: ['userId'] }`
 
 ### `fields.globallyShared` — Pass fields to ALL descendants (recursive)
@@ -372,6 +375,8 @@ const parent = agent('query:string, sessionId:string -> answer:string', {
 });
 ```
 
+Use `fields.local: ['sessionId']` when a globally shared field should also remain visible in the current parent agent.
+
 ### `agents.shared` — Add agents to direct children (one level)
 
 Utility agents listed in `agents.shared` are added to every direct child agent's available agents list.
@@ -970,6 +975,7 @@ Extends `AxProgramForwardOptions` (without `functions`) with:
   };
 
   fields?: {
+    local?: string[];              // Keep shared/global fields visible in this agent
     shared?: string[];             // Fields passed to direct child agents (one level)
     globallyShared?: string[];     // Fields passed to ALL descendants recursively
     excluded?: string[];           // Fields this agent should NOT receive from parents

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.9"
+version: "19.0.11"
 ---
 
 # Ax Library (@ax-llm/ax) Usage Guide