Refined docs for workflowagents, memory & model packages. (google#223)

* Add workflowagents comments

* Add model comments

* Add memory package comments

* Update agent/workflowagents/loopagent/agent.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update agent/workflowagents/sequentialagent/agent.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update agent/workflowagents/parallelagent/agent.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update agent/workflowagents/sequentialagent/agent.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update memory/service.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: dpasiukevich

agent/workflowagents/loopagent/agent.go

@@ -12,6 +12,8 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package loopagent provides an agent that repeatedly runs its sub-agents for a
+// specified number of iterations or until termination condition is met.
 package loopagent
 
 import (
@@ -23,6 +25,7 @@ import (
 	"google.golang.org/adk/session"
 )
 
+// Config defines the configuration for a LoopAgent.
 type Config struct {
 	// Basic agent setup.
 	AgentConfig agent.Config

agent/workflowagents/parallelagent/agent.go

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package parallelagent provides an agent that runs its sub-agents in parallel.
 package parallelagent
 
 import (
@@ -25,6 +26,7 @@ import (
 	"google.golang.org/adk/session"
 )
 
+// Config defines the configuration for a ParallelAgent.
 type Config struct {
 	// Basic agent setup.
 	AgentConfig agent.Config

agent/workflowagents/sequentialagent/agent.go

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package sequentialagent provides an agent that runs its sub-agents in a sequence.
 package sequentialagent
 
 import (
@@ -48,6 +49,7 @@ func New(cfg Config) (agent.Agent, error) {
 	return sequentialAgent, nil
 }
 
+// Config defines the configuration for a SequentialAgent.
 type Config struct {
 	// Basic agent setup.
 	AgentConfig agent.Config

memory/service.go

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package memory defines the entities to interact with agent memory (long-term knowledge).
 package memory
 
 import (
@@ -24,8 +25,8 @@ import (
 
 // Service is a definition of the memory service.
 //
-// The service provides functionalities to ingest sessions into memory so that
-// the memory can be used for user queries.
+// The service ingests sessions into memory so that it can be used for
+// user queries across user-scoped sessions.
 type Service interface {
 	// AddSession adds a session to the memory service.
 	//

model/gemini/gemini.go

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package gemini implements the model.LLM interface for Gemini models.
 package gemini
 
 import (
@@ -36,8 +37,7 @@ type geminiModel struct {
 	versionHeaderValue string
 }
 
-// NewModel creates and initializes a new model instance that satisfies the
-// model.LLM interface, backed by the Gemini API.
+// NewModel returns [model.LLM], backed by the Gemini API.
 //
 // It uses the provided context and configuration to initialize the underlying
 // genai.Client. The modelName specifies which Gemini model to target

model/llm.go

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// Package model defines the interfaces and data structures for interacting with LLMs.
 package model
 
 import (