agents/

directory
v1.18.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 5, 2026 License: MIT

Directories

Path Synopsis
Package a2aremote makes wick an A2A client: an agent of another system, reached over the A2A protocol, joins a Team roster as an agent of kind "a2a-remote".
Package a2aremote makes wick an A2A client: an agent of another system, reached over the A2A protocol, joins a Team roster as an agent of kind "a2a-remote".
a2aremotetest
Package a2aremotetest is a fake remote A2A agent for tests: a real a2asrv JSON-RPC handler behind httptest, with a scripted executor and a record of what it received.
Package a2aremotetest is a fake remote A2A agent for tests: a real a2asrv JSON-RPC handler behind httptest, with a scripted executor and a record of what it received.
Package a2aserver exposes Team agents as Agent-to-Agent (A2A) servers.
Package a2aserver exposes Team agents as Agent-to-Agent (A2A) servers.
Package actioncard parses the ```actioncard fences agents write and renders them for chat surfaces without the web UI's card component: Block Kit for Slack (see channels/slack), a numbered list for plain text channels.
Package actioncard parses the ```actioncard fences agents write and renders them for chat surfaces without the web UI's card component: Block Kit for Slack (see channels/slack), a numbered list for plain text channels.
Package agentctl provides a unix-socket control channel between the wick MCP stdio process and the wick HTTP daemon.
Package agentctl provides a unix-socket control channel between the wick MCP stdio process and the wick HTTP daemon.
Package aigen runs one-shot "generate this for me" LLM calls — a system prompt from a brief, a connector definition from a pasted snippet — as queued jobs instead of synchronous request handlers.
Package aigen runs one-shot "generate this for me" LLM calls — a system prompt from a brief, a connector definition from a pasted snippet — as queued jobs instead of synchronous request handlers.
Package airouter manages one or more embedded "AI router" backends — local OpenAI-compatible proxy dashboards (9router, OmniRoute, …) that ship as npm packages and serve a web dashboard on a loopback port.
Package airouter manages one or more embedded "AI router" backends — local OpenAI-compatible proxy dashboards (9router, OmniRoute, …) that ship as npm packages and serve a web dashboard on a loopback port.
omniroute
Package omniroute registers the OmniRoute backend with airouter.
Package omniroute registers the OmniRoute backend with airouter.
router9
Package router9 registers the 9router backend with airouter.
Package router9 registers the 9router backend with airouter.
Package askuser holds the daemon-side coordinator for the ask_user MCP tool.
Package askuser holds the daemon-side coordinator for the ask_user MCP tool.
Package capability declares per-provider hook-support metadata and a self-registering registry for it.
Package capability declares per-provider hook-support metadata and a self-registering registry for it.
Package channels provides message channel implementations for the Agents subsystem.
Package channels provides message channel implementations for the Agents subsystem.
rest
Package rest implements an OpenAI Chat Completions compatible HTTP channel for the agents pool.
Package rest implements an OpenAI Chat Completions compatible HTTP channel for the agents pool.
setup
Package setup composes channel implementations into a registry.
Package setup composes channel implementations into a registry.
slack
Package slack — markdown.go: outbound reply shaping for markdown text.
Package slack — markdown.go: outbound reply shaping for markdown text.
slack/workflow
Slack picker resolvers — feed workflow_picker_resolve so AI authors editing a trigger match (channel_id whitelist, user whitelist) can get real IDs instead of guessing C123/U456.
Slack picker resolvers — feed workflow_picker_resolve so AI authors editing a trigger match (channel_id whitelist, user whitelist) can get real IDs instead of guessing C123/U456.
telegram
Package telegram implements the Telegram transport for the agents channel registry.
Package telegram implements the Telegram transport for the agents channel registry.
Package clitoken issues the short-lived bearer a SHELL uses to talk back into the session that minted it.
Package clitoken issues the short-lived bearer a SHELL uses to talk back into the session that minted it.
Package config holds the runtime-editable Agents config (General / Slack / Storage structs reflected into the configs DB table) plus the on-disk Layout — the single source of truth for path math under the platform default data directory (~/.<app>/agents).
Package config holds the runtime-editable Agents config (General / Slack / Storage structs reflected into the configs DB table) plus the on-disk Layout — the single source of truth for path math under the platform default data directory (~/.<app>/agents).
Package delegation implements synchronous sub-agent delegation: a leader agent calls the wick_delegate MCP tool, wick spawns an isolated child session for the requested profile, waits for it to finish, and hands the final text back as a tool result.
Package delegation implements synchronous sub-agent delegation: a leader agent calls the wick_delegate MCP tool, wick spawns an isolated child session for the requested profile, waits for it to finish, and hands the final text back as a tool result.
Package event holds the CLI-agnostic event abstraction.
Package event holds the CLI-agnostic event abstraction.
Package gate is the command whitelist enforcement layer.
Package gate is the command whitelist enforcement layer.
Package notes stores markdown notes attached to a ticket or to a single session, one JSON file per note.
Package notes stores markdown notes attached to a ticket or to a single session, one JSON file per note.
Package pool manages the global agent subprocess slot count + FIFO queue.
Package pool manages the global agent subprocess slot count + FIFO queue.
Package preset manages reusable agent templates stored at `<BaseDir>/presets/<name>/agent.md`.
Package preset manages reusable agent templates stored at `<BaseDir>/presets/<name>/agent.md`.
Package project manages on-disk project entries at `<BaseDir>/projects/<id>/` (managed) or any user-supplied absolute path (custom).
Package project manages on-disk project entries at `<BaseDir>/projects/<id>/` (managed) or any user-supplied absolute path (custom).
Package promptguard keeps the version history of the prompts every agent spawn carries — the operator prompts (`system_prompt_security`, `system_prompt`, `system_prompt_team`) and each user's Team instructions — and the approval step an MCP change to an operator prompt has to pass.
Package promptguard keeps the version history of the prompts every agent spawn carries — the operator prompts (`system_prompt_security`, `system_prompt`, `system_prompt_team`) and each user's Team instructions — and the approval step an MCP change to an operator prompt has to pass.
Package runtime owns the per-AI-CLI runtime layer for agents:
Package runtime owns the per-AI-CLI runtime layer for agents:
claude
Package claude is the Claude-CLI specific Spawner implementation.
Package claude is the Claude-CLI specific Spawner implementation.
cliserver
Package cliserver keeps long-lived CLI server processes (opencode serve, omp --mode rpc) for the providers that hand turns to one instead of spawning a process per turn.
Package cliserver keeps long-lived CLI server processes (opencode serve, omp --mode rpc) for the providers that hand turns to one instead of spawning a process per turn.
codex
Package codex will hold the Codex-CLI specific Spawner implementation.
Package codex will hold the Codex-CLI specific Spawner implementation.
gemini
Package gemini will hold the Gemini-CLI specific Spawner implementation.
Package gemini will hold the Gemini-CLI specific Spawner implementation.
logintty
Package logintty runs a provider CLI's interactive login flow inside a wick-owned PTY so the Providers page can offer "Reconnect": the user gets a live terminal in the browser, wick tees the output to parse the OAuth login link, enforces a TTL countdown on the session, and reads the resulting credential files to report which account is connected.
Package logintty runs a provider CLI's interactive login flow inside a wick-owned PTY so the Providers page can offer "Reconnect": the user gets a live terminal in the browser, wick tees the output to parse the OAuth login link, enforces a TTL countdown on the session, and reads the resulting credential files to report which account is connected.
managedbin
Package managedbin installs, updates and rolls back provider CLI binaries that wick manages itself, under
Package managedbin installs, updates and rolls back provider CLI binaries that wick manages itself, under
memscope
Package memscope places each agent spawn in its own systemd transient scope inside a sibling slice, so the kernel's memory ceiling applies to that agent's whole process tree — grandchildren included — and a kill reaches only that agent.
Package memscope places each agent spawn in its own systemd transient scope inside a sibling slice, so the kernel's memory ceiling applies to that agent's whole process tree — grandchildren included — and a kill reaches only that agent.
memscope/wrapper
Package wrapper installs and removes the shim that places each agent spawn in its own cgroup, for hosts where wick's built-in guard is not the thing doing it.
Package wrapper installs and removes the shim that places each agent spawn in its own cgroup, for hosts where wick's built-in guard is not the thing doing it.
modelfilter
Package modelfilter is the one model-filter grammar wick uses everywhere a model list is narrowed by a typed query: the wick provider's live model sets (wick.MatchFilter) and the omp/opencode "live from CLI" model lists.
Package modelfilter is the one model-filter grammar wick uses everywhere a model list is narrowed by a typed query: the wick provider's live model sets (wick.MatchFilter) and the omp/opencode "live from CLI" model lists.
omp
Package omp implements provider.Spawner for oh-my-pi (`omp`).
Package omp implements provider.Spawner for oh-my-pi (`omp`).
oomscore
Package oomscore biases the kernel OOM killer's victim selection.
Package oomscore biases the kernel OOM killer's victim selection.
opencode
Package opencode implements provider.Spawner for sst's opencode.
Package opencode implements provider.Spawner for sst's opencode.
procgroup
Package procgroup starts agent subprocesses as the root of their own process group, so teardown can reach the descendants they spawn (MCP servers, shells, tool subprocesses) instead of orphaning them.
Package procgroup starts agent subprocesses as the root of their own process group, so teardown can reach the descendants they spawn (MCP servers, shells, tool subprocesses) instead of orphaning them.
savedresets
Package savedresets is the provider-agnostic base for saved rate-limit resets: one-time credits some accounts hold that refill their usage windows on demand (Codex's banked resets, Claude Code's /limit-reset).
Package savedresets is the provider-agnostic base for saved rate-limit resets: one-time credits some accounts hold that refill their usage windows on demand (Codex's banked resets, Claude Code's /limit-reset).
sessionoverride
Package sessionoverride is the provider-agnostic registry + runtime store for per-session setting overrides — the values the composer's `/`-menu popover edits WITHOUT sending a chat message (e.g.
Package sessionoverride is the provider-agnostic registry + runtime store for per-session setting overrides — the values the composer's `/`-menu popover edits WITHOUT sending a chat message (e.g.
wick
Package wick implements the built-in in-process provider — wick's own agent runtime, no external CLI required.
Package wick implements the built-in in-process provider — wick's own agent runtime, no external CLI required.
Package providersync syncs provider credential files to/from the DB.
Package providersync syncs provider credential files to/from the DB.
Package registry holds the in-memory cache of on-disk Agents state (Registry) plus a mutator wrapper (Manager) and the boot entrypoint (Bootstrap).
Package registry holds the in-memory cache of on-disk Agents state (Registry) plus a mutator wrapper (Manager) and the boot entrypoint (Bootstrap).
Package remote runs agents whose brain lives outside wick.
Package remote runs agents whose brain lives outside wick.
pluginremote
Package pluginremote is the remote.Source of a service plugin that declares remote_source: Send / Receive / Done go to the plugin's internal /_wick/remote/* paths over its unix socket, and events arrive as SSE in the v1 event schema, so nothing is converted.
Package pluginremote is the remote.Source of a service plugin that declares remote_source: Send / Receive / Done go to the plugin's internal /_wick/remote/* paths over its unix socket, and events arrive as SSE in the v1 event schema, so nothing is converted.
slackremote
Package slackremote is the Slack adapter of remote.Source: an agent that lives in Slack (a third-party AI bot, an internal bot, a person) wrapped as a Team agent.
Package slackremote is the Slack adapter of remote.Source: an agent that lives in Slack (a third-party AI bot, an internal bot, a person) wrapped as a Team agent.
Package resourceguard is wick's fast watchdog for every agent it spawns — sessions, sub-agents, Team agents, workflow agent nodes, and whatever they start, including `systemd-run --user` units outside agents.slice.
Package resourceguard is wick's fast watchdog for every agent it spawns — sessions, sub-agents, Team agents, workflow agent nodes, and whatever they start, including `systemd-run --user` units outside agents.slice.
Package schedule stores and delivers future message injections into agent sessions (see internal/planning/in-progress/scheduled-messages.md).
Package schedule stores and delivers future message injections into agent sessions (see internal/planning/in-progress/scheduled-messages.md).
Package scm provides git source-control operations over a session's working directory.
Package scm provides git source-control operations over a session's working directory.
Package session manages on-disk session entries at `<BaseDir>/sessions/<id>/`.
Package session manages on-disk session entries at `<BaseDir>/sessions/<id>/`.
Package sessionlink ties sessions that handle the same matter together, so each knows the others exist, what they are doing right now, and can read their latest turns — instead of a person forwarding between them.
Package sessionlink ties sessions that handle the same matter together, so each knows the others exist, what they are doing right now, and can read their latest turns — instead of a person forwarding between them.
Package sessionworkspace stores a per-session "workspace": a set of ephemeral connector instances cloned from a base module (httprest, custom API defs, …).
Package sessionworkspace stores a per-session "workspace": a set of ephemeral connector instances cloned from a base module (httprest, custom API defs, …).
Package skillsync mirrors skill files across all agent skill directories (~/.claude/skills, ~/.codex/skills, ~/.gemini/skills, ~/.agents/skills) without symlinks.
Package skillsync mirrors skill files across all agent skill directories (~/.claude/skills, ~/.codex/skills, ~/.gemini/skills, ~/.agents/skills) without symlinks.
Package state holds the per-agent runtime state machine.
Package state holds the per-agent runtime state machine.
Package storage holds the filesystem primitives used by every other agents subpackage: atomic JSON write, JSONL append/read/tail/truncate, directory scan, and identifier validation.
Package storage holds the filesystem primitives used by every other agents subpackage: atomic JSON write, JSONL append/read/tail/truncate, directory scan, and identifier validation.
Package store is the agents pipeline sink: it consumes AgentEvent values produced by a Parser and writes them to the on-disk session folder (conversation.jsonl, raw.jsonl, agents.json cli_session_id).
Package store is the agents pipeline sink: it consumes AgentEvent values produced by a Parser and writes them to the on-disk session folder (conversation.jsonl, raw.jsonl, agents.json cli_session_id).
Package team is the Agents app's data layer: the agents a user owns, the connector access each one is handed, and the resolver the MCP layer asks "which agent is this session, and what may it reach?".
Package team is the Agents app's data layer: the agents a user owns, the connector access each one is handed, and the resolver the MCP layer asks "which agent is this session, and what may it reach?".
Package teamlink lets one Team agent talk to another over A2A.
Package teamlink lets one Team agent talk to another over A2A.
Package terminal runs a web terminal (gotty) for one CLI provider instance of any type registered with Register (omp, opencode, claude, codex, gemini each in their own provider_<type>.go): an admin picks a command from a fixed allowlist, wick starts gotty on 127.0.0.1 with a random port, a random credential and --once, and the browser reaches it only through wick's own reverse proxy (Session.ServeHTTP) — behind the wick login and the provider admin guard.
Package terminal runs a web terminal (gotty) for one CLI provider instance of any type registered with Register (omp, opencode, claude, codex, gemini each in their own provider_<type>.go): an admin picks a command from a fixed allowlist, wick starts gotty on 127.0.0.1 with a random port, a random credential and --once, and the browser reaches it only through wick's own reverse proxy (Session.ServeHTTP) — behind the wick login and the provider admin guard.
Package ticket stores tickets as first-class entities under a project (`projects/<id>/tickets/<ticketID>/ticket.json`), each holding zero or more sessions.
Package ticket stores tickets as first-class entities under a project (`projects/<id>/tickets/<ticketID>/ticket.json`), each holding zero or more sessions.
Package ticketprompt builds the short prompt block that tells an agent which ticket its session is on and how many notes are waiting.
Package ticketprompt builds the short prompt block that tells an agent which ticket its session is on and how many notes are waiting.
Package todoprompt puts a session's unfinished todo list in front of the agent at spawn time.
Package todoprompt puts a session's unfinished todo list in front of the agent at spawn time.
Package transport defines the boundary between Agents and message sources (Slack, UI, future API).
Package transport defines the boundary between Agents and message sources (Slack, UI, future API).
api
Package api will hold the HTTP API transport — external integrations that POST messages directly into a session, bypassing UI / Slack.
Package api will hold the HTTP API transport — external integrations that POST messages directly into a session, bypassing UI / Slack.
slack
Package slack will hold the Slack transport: socket-mode (default) or HTTP Event API listener, reaction lifecycle, chunked replies, access control, and meta-command routing.
Package slack will hold the Slack transport: socket-mode (default) or HTTP Event API listener, reaction lifecycle, chunked replies, access control, and meta-command routing.
ui
Package ui will hold the UI transport: an HTTP handler glue layer that turns POST /tools/agents/sessions/{id}/send into an IncomingMessage and pumps it through the pool.
Package ui will hold the UI transport: an HTTP handler glue layer that turns POST /tools/agents/sessions/{id}/send into an IncomingMessage and pumps it through the pool.
Package trash keeps deleted projects recoverable for a while.
Package trash keeps deleted projects recoverable for a while.
Package usagereport builds the token ledger read model: what each provider burned, which projects and people it was burned for, and where a given provider is actually used.
Package usagereport builds the token ledger read model: what each provider burned, which projects and people it was burned for, and where a given provider is actually used.
Package workflow is the domain for AI-orchestrated multi-step automations stored at `<BaseDir>/workflows/<id>/`.
Package workflow is the domain for AI-orchestrated multi-step automations stored at `<BaseDir>/workflows/<id>/`.
canvas
Package canvas mutates a Workflow's graph atomically.
Package canvas mutates a Workflow's graph atomically.
channel
Package channel is a thin adapter over internal/agents/channels.
Package channel is a thin adapter over internal/agents/channels.
connector
Package connector is the workflow-facing index of connector modules.
Package connector is the workflow-facing index of connector modules.
cost
Package cost aggregates per-node + per-workflow LLM usage.
Package cost aggregates per-node + per-workflow LLM usage.
datatable
Package datatable is the workflow-facing shared-table store.
Package datatable is the workflow-facing shared-table store.
engine
Package engine — multi-subscriber event broker.
Package engine — multi-subscriber event broker.
env
Package env validates and resolves the workflow's env schema + values.
Package env validates and resolves the workflow's env schema + values.
guard
Package guard reviews a workflow body for safety violations before publish.
Package guard reviews a workflow body for safety violations before publish.
integration
Package integration is the workflow-side surface for per-event + per-action node descriptors.
Package integration is the workflow-side surface for per-event + per-action node descriptors.
mcp
Package mcp — Data Tables MCP surface.
Package mcp — Data Tables MCP surface.
nodes
Package nodes contains the concrete Executor impls for every Node type.
Package nodes contains the concrete Executor impls for every Node type.
parse
Package parse decodes and validates workflow JSON bodies.
Package parse decodes and validates workflow JSON bodies.
provider
Package provider is the abstraction the workflow engine talks to for classify + agent nodes.
Package provider is the abstraction the workflow engine talks to for classify + agent nodes.
repository
Package repository is the DB-backed storage for workflows + their version history.
Package repository is the DB-backed storage for workflows + their version history.
scaffold
Package scaffold provides workflow starter templates used by `workflow_create` MCP op + UI "New workflow" form.
Package scaffold provides workflow starter templates used by `workflow_create` MCP op + UI "New workflow" form.
service
Package service is the CRUD facade over `<BaseDir>/workflows/`.
Package service is the CRUD facade over `<BaseDir>/workflows/`.
setup
Package setup wires every workflow subpkg together.
Package setup wires every workflow subpkg together.
state
Package state persists per-run state.json + events.jsonl under `<BaseDir>/workflows/<id>/runs/<run-id>/`.
Package state persists per-run state.json + events.jsonl under `<BaseDir>/workflows/<id>/runs/<run-id>/`.
template
Package template renders Go text/template strings against a workflow.RenderCtx.
Package template renders Go text/template strings against a workflow.RenderCtx.
trigger
Package trigger is the dispatch + queue + dedup layer between trigger sources (cron, channel adapter, webhook, manual, error) and the engine.
Package trigger is the dispatch + queue + dedup layer between trigger sources (cron, channel adapter, webhook, manual, error) and the engine.
wftest
Package wftest runs workflow test cases loaded from `__tests__/` fixtures.
Package wftest runs workflow test cases loaded from `__tests__/` fixtures.
Package workspace manages on-disk workspace entries at `<BaseDir>/workspaces/<name>/` (managed) or any user-supplied absolute path (custom).
Package workspace manages on-disk workspace entries at `<BaseDir>/workspaces/<name>/` (managed) or any user-supplied absolute path (custom).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL