refactor: rename AgentContext.EntranceType to InvocationType, fix golang ci lint

Author: N3kox

adk/agent_middleware.go

@@ -95,16 +95,16 @@ type AgentContext struct {
 	AgentRunOptions []AgentRunOption
 
 	// internal properties, read only
-	agentName string
-	entrance  InvocationType
+	agentName      string
+	invocationType InvocationType
 }
 
 func (a *AgentContext) AgentName() string {
 	return a.agentName
 }
 
-func (a *AgentContext) EntranceType() InvocationType {
-	return a.entrance
+func (a *AgentContext) InvocationType() InvocationType {
+	return a.invocationType
 }
 
 func isAgentMiddlewareEnabled(a Agent) bool {

adk/agent_middleware_test.go

@@ -582,12 +582,12 @@ func TestRunnerWithMWCallbacks(t *testing.T) {
 		}
 		mw2 := AgentMiddleware{
 			BeforeAgent: func(ctx context.Context, ac *AgentContext) (nextContext context.Context, err error) {
-				if ac.EntranceType() == InvocationTypeRun {
+				if ac.InvocationType() == InvocationTypeRun {
 					assert.Equal(t, "Hi", ac.AgentInput.Messages[0].Content)
-				} else if ac.EntranceType() == InvocationTypeResume {
+				} else if ac.InvocationType() == InvocationTypeResume {
 					assert.NotNil(t, ac.ResumeInfo)
 				} else {
-					assert.Fail(t, "invalid entrance")
+					assert.Fail(t, "invalid invocationType")
 				}
 				return ctx, nil
 			},

adk/chatmodel.go

@@ -81,6 +81,7 @@ func WithAgentToolRunOptions(opts map[string] /*tool name*/ []AgentRunOption) Ag
 	})
 }
 
+// WithGraphCallbacks sets callback handlers for internal graph / chain execution.
 func WithGraphCallbacks(callbacks ...callbacks.Handler) AgentRunOption {
 	return WrapImplSpecificOptFn(func(t *chatModelAgentRunOptions) {
 		t.graphCallbacks = callbacks
@@ -872,7 +873,7 @@ func (a *ChatModelAgent) Run(ctx context.Context, input *AgentInput, opts ...Age
 		AgentInput:      input,
 		AgentRunOptions: opts,
 		agentName:       a.name,
-		entrance:        InvocationTypeRun,
+		invocationType:  InvocationTypeRun,
 	}
 
 	mwHelper, run := a.buildRunFunc(ctx)
@@ -910,7 +911,7 @@ func (a *ChatModelAgent) Resume(ctx context.Context, info *ResumeInfo, opts ...A
 		ResumeInfo:      info,
 		AgentRunOptions: opts,
 		agentName:       a.name,
-		entrance:        InvocationTypeResume,
+		invocationType:  InvocationTypeResume,
 	}
 
 	mwHelper, run := a.buildRunFunc(ctx)

adk/flow.go

@@ -306,7 +306,7 @@ func (a *flowAgent) Run(ctx context.Context, input *AgentInput, opts ...AgentRun
 			AgentInput:      input,
 			AgentRunOptions: opts,
 			agentName:       agentName,
-			entrance:        InvocationTypeRun,
+			invocationType:  InvocationTypeRun,
 		}
 	)
 
@@ -357,7 +357,7 @@ func (a *flowAgent) Resume(ctx context.Context, info *ResumeInfo, opts ...AgentR
 			ResumeInfo:      info,
 			AgentRunOptions: opts,
 			agentName:       agentName,
-			entrance:        InvocationTypeRun,
+			invocationType:  InvocationTypeRun,
 		}
 	)
 

adk/multi_agent.go

@@ -28,7 +28,7 @@ type MultiAgentConfig struct {
 	Middlewares []AgentMiddleware // optional
 }
 
-// The NewMultiAgent method enables wrapping any individual Agent into a Multi-Agent structure.
+// NewMultiAgent enables wrapping any individual Agent into a Multi-Agent structure.
 // It assigns a new Name and Description to the wrapped Agent and adds middleware-based runtime capabilities around it.
 // This method is essentially a simple wrapper for Agents, designed to address the following specific use cases:
 //  1. Customizing Agent Metadata: Modify the public-facing Name and Description of any existing Agent, while adding middleware to its execution flow.
@@ -74,7 +74,7 @@ func (ma *multiAgent) Run(ctx context.Context, input *AgentInput, options ...Age
 		AgentInput:      input,
 		AgentRunOptions: options,
 		agentName:       ma.name,
-		entrance:        InvocationTypeRun,
+		invocationType:  InvocationTypeRun,
 	}
 
 	mwHelper := newAgentMWHelper(append(globalAgentMiddlewares, ma.middlewares...)...)
@@ -94,7 +94,7 @@ func (ma *multiAgent) Resume(ctx context.Context, info *ResumeInfo, opts ...Agen
 		ResumeInfo:      info,
 		AgentRunOptions: opts,
 		agentName:       ma.name,
-		entrance:        InvocationTypeResume,
+		invocationType:  InvocationTypeResume,
 	}
 
 	mwHelper := newAgentMWHelper(append(globalAgentMiddlewares, ma.middlewares...)...)

adk/multi_agent_test.go

@@ -54,7 +54,7 @@ func TestMultiAgent(t *testing.T) {
 		Name: "test",
 		BeforeAgent: func(ctx context.Context, ac *AgentContext) (nextContext context.Context, err error) {
 			assert.Equal(t, "mock_name", ac.AgentName())
-			assert.Equal(t, InvocationTypeRun, ac.EntranceType())
+			assert.Equal(t, InvocationTypeRun, ac.InvocationType())
 			assert.Equal(t, "hello", ac.AgentInput.Messages[0].Content)
 
 			ac.AgentInput.Messages[0].Content = "bye"

adk/workflow.go

@@ -66,7 +66,7 @@ func (a *workflowAgent) Run(ctx context.Context, input *AgentInput, opts ...Agen
 			AgentInput:      input,
 			AgentRunOptions: opts,
 			agentName:       a.name,
-			entrance:        InvocationTypeRun,
+			invocationType:  InvocationTypeRun,
 		}
 	)
 
@@ -136,7 +136,7 @@ func (a *workflowAgent) Resume(ctx context.Context, info *ResumeInfo, opts ...Ag
 			ResumeInfo:      info,
 			AgentRunOptions: opts,
 			agentName:       a.name,
-			entrance:        InvocationTypeRun,
+			invocationType:  InvocationTypeRun,
 		}
 	)