Skip to content

About

Dynamic agents composed from modular components and an A2A Server for hosting them.

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

Repository files navigation

Composable Agents

Work in Progress

Agents and model clients as Wasm components that run on composable-runtime.

The WIT they implement is in components/agents (composable:agents) and components/models (composable:models).

Examples

Config

AgentService handles [model] and [agent] definitions. Each becomes a component with the definition's name.

[model]

[model.local]
provider = "ollama"
name = "gpt-oss:20b"
Property Required Description
provider yes anthropic, ollama or openai (more to come)
name yes the provider's model name
max-tokens no the default limit on output tokens per call, overridden by the agent's settings or request
temperature no ollama and openai only: the default sampling temperature, overridden by the agent's settings
top-p no ollama and openai only: the default nucleus sampling probability, overridden by the agent's settings
seed no ollama and openai only: the default sampling seed, overridden by the agent's settings
stop-sequences no a list of strings that each end the model's output, as the default, overridden by the agent's settings
effort no how much effort the model uses on a response. For anthropic, one of low, medium, high, xhigh or max. For ollama and openai, sent as reasoning_effort unchanged, with values that depend on the provider and model
include-reasoning no anthropic only: true to include a summary of the model's reasoning in the response (default false)
max-retries no anthropic only: how many times a request may be resent after failure (default 2)

[agent]

[agent.assistant]
model = "local"
description = "Answers questions concisely"
version = "0.1.0"
instructions = "Answer in one or two sentences."
Property Required Description
model yes the name of a [model]
description yes the agent's description, in its metadata
version yes the agent's version, in its metadata
instructions no the model's system instructions
toolset no the name of a component exporting composable:tools/toolset, such as a [toolset]
max-turns no with a toolset: the most model calls allowed per invocation (default 8)
report-tool-calls no with a toolset: true to emit the name of each tool called in a status message (default false)

An agent with a toolset is a tool-calling-agent, and one without a toolset is a chat-agent (see components/agents).

CLI

The agents CLI lists and invokes the agents in one or more definition files.

cargo install --path crates/cli

agents list prints each agent's metadata as JSON, keyed by component name:

agents list config.toml

agents invoke sends a message to an agent as a new task. The message is the argument after the agent's name (or stdin if none is given). The artifact text streams to stdout, and the task's status, finish reason and usage go to stderr. It exits successfully only when the task completes.

agents invoke config.toml -- assistant "Why is the sky blue?"

License

Copyright (c) 2026 Modulewise Inc and the Composable Agents contributors.

Apache License v2.0: see LICENSE for details.

About

Dynamic agents composed from modular components and an A2A Server for hosting them.

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages