@illuma-ai/agents 1.1.15 → 1.1.17

package/src/scripts/multi-agent-sequence.ts

@@ -82,13 +82,13 @@ async function testSequentialMultiAgent() {
     {
       from: 'agent_a',
       to: 'agent_b',
-      edgeType: 'direct', // This creates direct edges without tools
+      edgeType: 'sequence', // This creates direct edges without tools
       description: 'Automatic transition from A to B',
     },
     {
       from: 'agent_b',
       to: 'agent_c',
-      edgeType: 'direct', // This creates direct edges without tools
+      edgeType: 'sequence', // This creates direct edges without tools
       description: 'Automatic transition from B to C',
     },
   ];

package/src/scripts/multi-agent-supervisor.js

@@ -228,31 +228,31 @@ async function testSupervisorMultiAgent() {
                 from: 'supervisor',
                 to: 'data_analyst',
                 description: 'Transfer to data analyst for statistical analysis and metrics',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
             {
                 from: 'supervisor',
                 to: 'security_expert',
                 description: 'Transfer to security expert for cybersecurity assessment',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
             {
                 from: 'supervisor',
                 to: 'product_designer',
                 description: 'Transfer to product designer for UX/UI design',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
             {
                 from: 'supervisor',
                 to: 'devops_engineer',
                 description: 'Transfer to DevOps engineer for infrastructure and deployment',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
             {
                 from: 'supervisor',
                 to: 'legal_advisor',
                 description: 'Transfer to legal advisor for compliance and licensing',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/multi-agent-supervisor.ts

@@ -255,32 +255,32 @@ async function testSupervisorMultiAgent() {
         to: 'data_analyst',
         description:
           'Transfer to data analyst for statistical analysis and metrics',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
       {
         from: 'supervisor',
         to: 'security_expert',
         description: 'Transfer to security expert for cybersecurity assessment',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
       {
         from: 'supervisor',
         to: 'product_designer',
         description: 'Transfer to product designer for UX/UI design',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
       {
         from: 'supervisor',
         to: 'devops_engineer',
         description:
           'Transfer to DevOps engineer for infrastructure and deployment',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
       {
         from: 'supervisor',
         to: 'legal_advisor',
         description: 'Transfer to legal advisor for compliance and licensing',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/scripts/poc-multi-agent-comprehensive.ts

@@ -690,7 +690,7 @@ Start with "SUMMARY:" and end with "RECOMMENDATION:"`
     {
       from: 'researcher',
       to: 'analyst',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here are the research findings. Analyze them and provide insights:\n\n${buffer}`;
@@ -700,7 +700,7 @@ Start with "SUMMARY:" and end with "RECOMMENDATION:"`
     {
       from: 'analyst',
       to: 'summarizer',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here are the combined research and analysis. Synthesize into a final summary:\n\n${buffer}`;
@@ -813,7 +813,7 @@ Start with "REVIEW:" and keep it to 3-4 lines.`
     {
       from: 'data_collector',
       to: 'translator',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here is the collected data. Translate the key findings to Spanish:\n\n${buffer}`;
@@ -823,7 +823,7 @@ Start with "REVIEW:" and keep it to 3-4 lines.`
     {
       from: 'translator',
       to: 'reviewer',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here is the collected and translated data. Review it for quality:\n\n${buffer}`;
@@ -934,7 +934,7 @@ Format as a brief executive memo (4-5 sentences). Start with "EXECUTIVE SUMMARY:
     {
       from: 'intel_gatherer',
       to: 'market_analyst',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here is the gathered intelligence. Analyze the market sentiment and cross-reference with our database:\n\n${buffer}`;
@@ -944,7 +944,7 @@ Format as a brief executive memo (4-5 sentences). Start with "EXECUTIVE SUMMARY:
     {
       from: 'market_analyst',
       to: 'presenter',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here is the intelligence and market analysis. Create a polished executive summary:\n\n${buffer}`;
@@ -1070,7 +1070,7 @@ Start with "SENTIMENT ANALYSIS:"`,
     {
       from: 'planner',
       to: 'researcher',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt: (messages: BaseMessage[], startIndex: number) => {
         const buffer = getBufferString(messages.slice(startIndex));
         return `Here is the content plan. Gather the required data:\n\n${buffer}`;

package/src/scripts/sequential-full-metadata-test.js

@@ -37,7 +37,7 @@ async function testSequentialMetadata() {
     ];
     // Sequential edge: A -> B (using edgeType not type)
     const edges = [
-        { from: 'agent_a', to: 'agent_b', edgeType: 'direct' },
+        { from: 'agent_a', to: 'agent_b', edgeType: 'sequence' },
     ];
     const captureMetadata = (eventName, metadata) => {
         if (metadata) {

package/src/scripts/sequential-full-metadata-test.ts

@@ -49,7 +49,7 @@ async function testSequentialMetadata() {
 
   // Sequential edge: A -> B (using edgeType not type)
   const edges: t.GraphEdge[] = [
-    { from: 'agent_a', to: 'agent_b', edgeType: 'direct' },
+    { from: 'agent_a', to: 'agent_b', edgeType: 'sequence' },
   ];
 
   const captureMetadata = (

package/src/scripts/test-custom-prompt-key.js

@@ -70,7 +70,7 @@ async function testCustomPromptKey() {
                 {
                     from: 'supervisor',
                     to: 'researcher',
-                    edgeType: 'handoff',
+                    edgeType: 'transfer',
                     // Custom parameter name: "query"
                     prompt: 'The research question or topic to investigate',
                     promptKey: 'query',
@@ -78,7 +78,7 @@ async function testCustomPromptKey() {
                 {
                     from: 'supervisor',
                     to: 'designer',
-                    edgeType: 'handoff',
+                    edgeType: 'transfer',
                     // Custom parameter name: "requirements"
                     prompt: 'The design requirements and constraints',
                     promptKey: 'requirements',
@@ -86,7 +86,7 @@ async function testCustomPromptKey() {
                 {
                     from: 'supervisor',
                     to: 'coder',
-                    edgeType: 'handoff',
+                    edgeType: 'transfer',
                     // Custom parameter name: "specification"
                     prompt: 'The technical specification for the code to implement',
                     promptKey: 'specification',

package/src/scripts/test-custom-prompt-key.ts

@@ -75,7 +75,7 @@ async function testCustomPromptKey() {
         {
           from: 'supervisor',
           to: 'researcher',
-          edgeType: 'handoff',
+          edgeType: 'transfer',
           // Custom parameter name: "query"
           prompt: 'The research question or topic to investigate',
           promptKey: 'query',
@@ -83,7 +83,7 @@ async function testCustomPromptKey() {
         {
           from: 'supervisor',
           to: 'designer',
-          edgeType: 'handoff',
+          edgeType: 'transfer',
           // Custom parameter name: "requirements"
           prompt: 'The design requirements and constraints',
           promptKey: 'requirements',
@@ -91,7 +91,7 @@ async function testCustomPromptKey() {
         {
           from: 'supervisor',
           to: 'coder',
-          edgeType: 'handoff',
+          edgeType: 'transfer',
           // Custom parameter name: "specification"
           prompt: 'The technical specification for the code to implement',
           promptKey: 'specification',

package/src/scripts/test-handoff-input.js

@@ -104,7 +104,7 @@ async function testHandoffInput() {
                 {
                     from: 'supervisor',
                     to: ['analyst', 'writer'],
-                    edgeType: 'handoff',
+                    edgeType: 'transfer',
                     // This prompt field now serves as the description for the input parameter
                     prompt: 'Specific instructions for the specialist to follow. Be detailed about what analysis to perform, what data to focus on, or what content to create.',
                 },

package/src/scripts/test-handoff-input.ts

@@ -123,7 +123,7 @@ async function testHandoffInput() {
         {
           from: 'supervisor',
           to: ['analyst', 'writer'],
-          edgeType: 'handoff',
+          edgeType: 'transfer',
           // This prompt field now serves as the description for the input parameter
           prompt:
             'Specific instructions for the specialist to follow. Be detailed about what analysis to perform, what data to focus on, or what content to create.',

package/src/scripts/test-handoff-preamble.js

@@ -112,7 +112,7 @@ IMPORTANT: You are the specialist - provide a complete, helpful response to the
             from: 'coordinator',
             to: 'specialist',
             description: 'Transfer to technical specialist for analysis',
-            edgeType: 'handoff',
+            edgeType: 'transfer',
             prompt: 'Specific instructions for the specialist about what to analyze',
             promptKey: 'instructions',
         },

package/src/scripts/test-handoff-preamble.ts

@@ -136,7 +136,7 @@ IMPORTANT: You are the specialist - provide a complete, helpful response to the
       from: 'coordinator',
       to: 'specialist',
       description: 'Transfer to technical specialist for analysis',
-      edgeType: 'handoff',
+      edgeType: 'transfer',
       prompt: 'Specific instructions for the specialist about what to analyze',
       promptKey: 'instructions',
     },

package/src/scripts/test-handoff-steering.js

@@ -98,7 +98,7 @@ When you receive a task, execute it thoroughly. Always identify yourself as the
             {
                 from: 'coordinator',
                 to: 'specialist',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
                 description: 'Transfer to specialist for detailed work',
                 prompt: 'Provide specific instructions for the specialist about what to analyze or create',
                 promptKey: 'instructions',
@@ -184,7 +184,7 @@ You must follow the exact format requested.`,
             {
                 from: 'manager',
                 to: 'writer',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
                 description: 'Transfer to writer for report creation',
                 prompt: 'Provide specific formatting and content instructions for the writer',
                 promptKey: 'instructions',
@@ -264,7 +264,7 @@ If asked about non-Italian food, politely redirect to Italian alternatives.`,
             {
                 from: 'router',
                 to: 'chef',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
                 description: 'Transfer to chef',
                 prompt: 'Instructions for the chef about how to respond',
                 promptKey: 'instructions',

package/src/scripts/test-handoff-steering.ts

@@ -121,7 +121,7 @@ When you receive a task, execute it thoroughly. Always identify yourself as the
       {
         from: 'coordinator',
         to: 'specialist',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
         description: 'Transfer to specialist for detailed work',
         prompt:
           'Provide specific instructions for the specialist about what to analyze or create',
@@ -226,7 +226,7 @@ You must follow the exact format requested.`,
       {
         from: 'manager',
         to: 'writer',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
         description: 'Transfer to writer for report creation',
         prompt:
           'Provide specific formatting and content instructions for the writer',
@@ -322,7 +322,7 @@ If asked about non-Italian food, politely redirect to Italian alternatives.`,
       {
         from: 'router',
         to: 'chef',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
         description: 'Transfer to chef',
         prompt: 'Instructions for the chef about how to respond',
         promptKey: 'instructions',

package/src/scripts/test-multi-agent-list-handoff.js

@@ -139,7 +139,7 @@ async function testSupervisorListHandoff() {
                     'legal_advisor',
                 ],
                 description: 'Transfer to appropriate specialist based on task requirements',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/test-multi-agent-list-handoff.ts

@@ -170,7 +170,7 @@ async function testSupervisorListHandoff() {
         ],
         description:
           'Transfer to appropriate specialist based on task requirements',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/scripts/test-parallel-agent-labeling.js

@@ -75,13 +75,13 @@ async function testParallelWithAgentLabeling() {
             from: 'researcher',
             to: ['analyst1', 'analyst2', 'analyst3'],
             description: 'Distribute research to specialist analysts',
-            edgeType: 'direct',
+            edgeType: 'sequence',
         },
         {
             from: ['analyst1', 'analyst2', 'analyst3'],
             to: 'summarizer',
             description: 'Aggregate analysis results',
-            edgeType: 'direct',
+            edgeType: 'sequence',
             prompt: 'Based on the analyses below, provide an integrated summary:\n\n{results}',
         },
     ];

package/src/scripts/test-parallel-agent-labeling.ts

@@ -83,13 +83,13 @@ async function testParallelWithAgentLabeling() {
       from: 'researcher',
       to: ['analyst1', 'analyst2', 'analyst3'],
       description: 'Distribute research to specialist analysts',
-      edgeType: 'direct',
+      edgeType: 'sequence',
     },
     {
       from: ['analyst1', 'analyst2', 'analyst3'],
       to: 'summarizer',
       description: 'Aggregate analysis results',
-      edgeType: 'direct',
+      edgeType: 'sequence',
       prompt:
         'Based on the analyses below, provide an integrated summary:\n\n{results}',
     },

package/src/scripts/test-parallel-handoffs.js

@@ -73,14 +73,14 @@ When delegating, provide clear instructions to each agent about what they should
         {
             from: 'coordinator',
             to: 'researcher',
-            edgeType: 'handoff',
+            edgeType: 'transfer',
             description: 'Transfer to researcher for research and fact-finding tasks',
             prompt: 'Research task instructions',
         },
         {
             from: 'coordinator',
             to: 'writer',
-            edgeType: 'handoff',
+            edgeType: 'transfer',
             description: 'Transfer to writer for content creation and writing tasks',
             prompt: 'Writing task instructions',
         },

package/src/scripts/test-parallel-handoffs.ts

@@ -82,14 +82,14 @@ When delegating, provide clear instructions to each agent about what they should
     {
       from: 'coordinator',
       to: 'researcher',
-      edgeType: 'handoff',
+      edgeType: 'transfer',
       description: 'Transfer to researcher for research and fact-finding tasks',
       prompt: 'Research task instructions',
     },
     {
       from: 'coordinator',
       to: 'writer',
-      edgeType: 'handoff',
+      edgeType: 'transfer',
       description: 'Transfer to writer for content creation and writing tasks',
       prompt: 'Writing task instructions',
     },

package/src/scripts/test-thinking-handoff-bedrock.js

@@ -67,7 +67,7 @@ async function testBedrockThinkingHandoff() {
                 from: 'supervisor',
                 to: ['code_reviewer'],
                 description: 'Transfer to code review specialist',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/test-thinking-handoff-bedrock.ts

@@ -78,7 +78,7 @@ async function testBedrockThinkingHandoff() {
         from: 'supervisor',
         to: ['code_reviewer'],
         description: 'Transfer to code review specialist',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/scripts/test-thinking-handoff.js

@@ -67,7 +67,7 @@ async function testThinkingHandoff() {
                 from: 'supervisor',
                 to: ['code_reviewer'],
                 description: 'Transfer to code review specialist',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/test-thinking-handoff.ts

@@ -80,7 +80,7 @@ async function testThinkingHandoff() {
         from: 'supervisor',
         to: ['code_reviewer'],
         description: 'Transfer to code review specialist',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/scripts/test-thinking-to-thinking-handoff-bedrock.js

@@ -82,7 +82,7 @@ async function testThinkingToThinkingHandoffBedrock() {
                 from: 'supervisor',
                 to: ['code_reviewer'],
                 description: 'Transfer to code review specialist',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/test-thinking-to-thinking-handoff-bedrock.ts

@@ -97,7 +97,7 @@ async function testThinkingToThinkingHandoffBedrock() {
         from: 'supervisor',
         to: ['code_reviewer'],
         description: 'Transfer to code review specialist',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/scripts/test-tool-before-handoff-role-order.js

@@ -129,7 +129,7 @@ Do NOT write a long response. Just call the tool and hand off.`,
             from: 'router',
             to: 'data_analyst',
             description: 'Transfer to data analyst after checking sessions',
-            edgeType: 'handoff',
+            edgeType: 'transfer',
             prompt: 'Provide specific instructions for the data analyst about what to analyze',
             promptKey: 'instructions',
         },

package/src/scripts/test-tool-before-handoff-role-order.ts

@@ -156,7 +156,7 @@ Do NOT write a long response. Just call the tool and hand off.`,
       from: 'router',
       to: 'data_analyst',
       description: 'Transfer to data analyst after checking sessions',
-      edgeType: 'handoff',
+      edgeType: 'transfer',
       prompt:
         'Provide specific instructions for the data analyst about what to analyze',
       promptKey: 'instructions',

package/src/scripts/test-tools-before-handoff.js

@@ -110,7 +110,7 @@ async function testToolsBeforeHandoff() {
                 from: 'research_coordinator',
                 to: 'report_writer',
                 description: 'Transfer to report writer after completing research',
-                edgeType: 'handoff',
+                edgeType: 'transfer',
             },
         ];
         return {

package/src/scripts/test-tools-before-handoff.ts

@@ -133,7 +133,7 @@ async function testToolsBeforeHandoff() {
         from: 'research_coordinator',
         to: 'report_writer',
         description: 'Transfer to report writer after completing research',
-        edgeType: 'handoff',
+        edgeType: 'transfer',
       },
     ];
 

package/src/specs/agent-handoffs-bedrock.integration.test.ts

@@ -118,13 +118,13 @@ describeIf('Agent Handoff E2E with Bedrock', () => {
         {
           from: 'supervisor_abc123',
           to: 'agent_W47hBnn2RoVZEOy5595GC',
-          edgeType: EdgeType.HANDOFF,
+          edgeType: EdgeType.TRANSFER,
           // No description - should auto-generate from agent name + description
         },
         {
           from: 'supervisor_abc123',
           to: 'agent_X92kLmn4TpQR8vw3221HD',
-          edgeType: EdgeType.HANDOFF,
+          edgeType: EdgeType.TRANSFER,
           // No description
         },
       ];
@@ -203,8 +203,8 @@ describeIf('Agent Handoff E2E with Bedrock', () => {
       ];
 
       const edges: t.GraphEdge[] = [
-        { from: 'router', to: 'sales_agent', edgeType: EdgeType.HANDOFF },
-        { from: 'router', to: 'support_agent', edgeType: EdgeType.HANDOFF },
+        { from: 'router', to: 'sales_agent', edgeType: EdgeType.TRANSFER },
+        { from: 'router', to: 'support_agent', edgeType: EdgeType.TRANSFER },
       ];
 
       const { contentParts: _contentParts, aggregateContent } =
@@ -321,8 +321,8 @@ describeIf('Agent Handoff E2E with Bedrock', () => {
       ];
 
       const edges: t.GraphEdge[] = [
-        { from: 'router', to: 'sales_agent', edgeType: EdgeType.HANDOFF },
-        { from: 'router', to: 'support_agent', edgeType: EdgeType.HANDOFF },
+        { from: 'router', to: 'sales_agent', edgeType: EdgeType.TRANSFER },
+        { from: 'router', to: 'support_agent', edgeType: EdgeType.TRANSFER },
       ];
 
       const { contentParts: _contentParts, aggregateContent } =