Built-ins

Built-ins Overview

The full built-in plugin map in Downcity, including public SDK plugins and platform-managed infrastructure plugins

Built-ins Overview

The current built-in plugin capabilities in code include:

  • skill
  • web
  • sound
  • workboard
  • chat
  • contact
  • schedule
  • task
  • memory
  • shell

Package imports

Each SDK-facing built-in has an isolated package subpath:

PluginImport path
chat@downcity/plugins/chat
contact@downcity/plugins/contact
image@downcity/plugins/image
memory@downcity/plugins/memory
skill@downcity/plugins/skill
sound@downcity/plugins/sound
task@downcity/plugins/task
web@downcity/plugins/web
workboard@downcity/plugins/workboard

There is no default built-in collection factory. Import and instantiate the exact plugins required by each Agent.

Two groups matter

Public SDK-facing built-ins

These are the ones most developers are likely to read first:

  • skill
  • web
  • sound
  • workboard
  • chat

sound requires the FED model catalog plus ASR and TTS functions through its constructor. Built-in plugins are assembled explicitly from their individual package subpaths.

These are the clearest examples for:

  • action plugins
  • hook or resolve plugins
  • system text plugins
  • runtime HTTP plugins
  • lifecycle plugins that normal SDK users may still understand directly

Platform-managed or infrastructure built-ins

These are also built-ins in code, but they are more platform-oriented:

  • contact
  • schedule
  • task
  • memory
  • shell

These plugins are usually read to understand how the platform is assembled, not because every SDK user should manually attach them to a local Agent.

How to read this section

  • If you want user-facing capability plugins, start with skill, web, sound, and chat
  • If you want platform rule layers, read the built-in authorization capability in chat
  • If you want control-plane or status surfaces, read workboard
  • If you want infrastructure patterns, read schedule, task, memory, and shell

Responsibility map

PluginMain roleShape
skillskill discovery, installation guidance, and content loadingaction + system
webweb methodology injection and dependency preparationaction + setup + system
soundFED speech-model discovery, ASR, TTS, and inbound auto-transcriptionaction + pipeline + system
workboardwork snapshots and status surfacesavailability + runtime HTTP
chatchannel runtime, queue worker, chat authorization, and role resolutionlifecycle + actions + hooks + resolves + system
contactpeer-to-peer agent linking and sharingaction + system + remote protocol
scheduleplugin action scheduling infrastructurelifecycle-only infrastructure
tasktask scheduler and cron executionlifecycle + actions + system
memoryprovider-neutral long-term memory and recalllifecycle + actions + system
shellshell session runtimelifecycle + actions

Important distinction

Do not read “built-in” as “all of these are equally public.”

Some built-ins are best understood as:

  • public capability plugins
  • platform integration plugins
  • infrastructure plugins

That distinction is one of the reasons the plugin concept docs stay in Agent SDK Docs, while concrete plugin guides live here.