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).
AgentService handles [model] and [agent] definitions. Each becomes a
component with the definition's name.
[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.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).
The agents CLI lists and invokes the agents in one or more definition files.
cargo install --path crates/cliagents list prints each agent's metadata as JSON, keyed by component name:
agents list config.tomlagents 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?"Copyright (c) 2026 Modulewise Inc and the Composable Agents contributors.
Apache License v2.0: see LICENSE for details.