@desplega.ai/agent-swarm 1.49.0 → 1.52.0

package/docs-site/content/docs/(documentation)/reference/environment-variables.mdx

@@ -1,205 +0,0 @@
----
-title: Environment Variables
-description: Complete reference for all configuration environment variables
----
-
-# Environment Variables
-
-Complete reference for all environment variables used by Agent Swarm.
-
-## Server Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PORT` | `3013` | Port for MCP HTTP server |
-| `API_KEY` | — | API key for server authentication (required) |
-| `MCP_BASE_URL` | `https://agent-swarm-mcp.desplega.sh` | Base URL for MCP server |
-| `SWARM_URL` | `localhost` | Base domain for service discovery |
-| `APP_URL` | — | Dashboard URL for Slack message links |
-| `ENV` | — | Environment mode (`development` adds prefix to Slack agent names) |
-| `DATABASE_PATH` | `./agent-swarm-db.sqlite` | SQLite database file path |
-| `SCHEDULER_INTERVAL_MS` | `10000` | Polling interval for scheduled tasks (ms) |
-| `OPENAI_API_KEY` | — | OpenAI key for memory embeddings |
-| `CAPABILITIES` | All enabled | Comma-separated feature flags |
-| `HEARTBEAT_INTERVAL_MS` | `90000` | Heartbeat sweep interval (ms) |
-| `HEARTBEAT_DISABLE` | `false` | Set to `true` to disable the heartbeat module |
-| `HEARTBEAT_STALL_THRESHOLD_MIN` | `30` | Minutes before an in-progress task is considered stalled |
-| `HEARTBEAT_STALE_CLEANUP_MIN` | `30` | Minutes before stale resources (sessions, reviewing tasks) are cleaned up |
-| `HEARTBEAT_MAX_AUTO_ASSIGN` | `5` | Max pool tasks to auto-assign per sweep |
-
-## Docker Worker Variables
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `CLAUDE_CODE_OAUTH_TOKEN` | Yes | — | OAuth token for Claude CLI. Supports comma-separated values for [multi-credential load balancing](#multi-credential-support) |
-| `ANTHROPIC_API_KEY` | Alt | — | Alternative to `CLAUDE_CODE_OAUTH_TOKEN`. Also supports comma-separated values |
-| `API_KEY` | Yes | — | API key for MCP server |
-| `AGENT_ID` | No | Auto-generated | Agent UUID. Keep stable for task resume |
-| `AGENT_ROLE` | No | `worker` | Role: `worker` or `lead` |
-| `AGENT_NAME` | No | Auto-generated | Display name for the agent |
-| `MCP_BASE_URL` | No | `http://host.docker.internal:3013` | MCP server URL |
-| `SESSION_ID` | No | Auto-generated | Log folder name |
-| `YOLO` | No | `false` | Continue on errors |
-| `SYSTEM_PROMPT` | No | — | Custom system prompt text |
-| `SYSTEM_PROMPT_FILE` | No | — | Path to system prompt file |
-| `STARTUP_SCRIPT_STRICT` | No | `true` | Exit on startup script failure |
-| `SHUTDOWN_TIMEOUT` | No | `30000` | Grace period (ms) before pausing tasks |
-| `MAX_CONCURRENT_TASKS` | No | `1` | Maximum parallel tasks per worker |
-| `SWARM_URL` | No | `localhost` | Base domain for service URLs |
-| `LEAD_PORT` | No | `3020` | Host port for lead service. Example variable used in `docker-compose.example.yml` — adjust to your setup. In isolated network namespaces all services can share the same port. |
-| `WORKER1_PORT` | No | `3021` | Host port for worker-1 service. Example — see `LEAD_PORT`. |
-| `WORKER2_PORT` | No | `3022` | Host port for worker-2 service. Example — see `LEAD_PORT`. |
-| `PM2_HOME` | No | `/workspace/.pm2` | PM2 state directory |
-| `HARNESS_PROVIDER` | No | `claude` | AI provider: `claude` (Claude Code) or `pi` (pi-mono) |
-| `TEMPLATE_ID` | No | — | Template for initial profile on first boot (e.g., `official/coder`) |
-| `TEMPLATE_REGISTRY_URL` | No | `https://templates.agent-swarm.dev` | URL of the templates registry |
-
-## Git Configuration
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `GITHUB_TOKEN` | — | GitHub token for git operations |
-| `GITHUB_EMAIL` | `worker-agent@desplega.ai` | Git commit email |
-| `GITHUB_NAME` | `Worker Agent` | Git commit name |
-
-## Slack Integration
-
-| Variable | Description |
-|----------|-------------|
-| `SLACK_BOT_TOKEN` | Bot User OAuth Token (`xoxb-...`) |
-| `SLACK_APP_TOKEN` | App-Level Token for Socket Mode (`xapp-...`) |
-| `SLACK_SIGNING_SECRET` | Signing Secret (optional for Socket Mode) |
-| `SLACK_DISABLE` | Set to `true` to disable Slack |
-| `SLACK_ALLOWED_EMAIL_DOMAINS` | Comma-separated email domains |
-| `SLACK_ALLOWED_USER_IDS` | Comma-separated user IDs to always allow |
-| `ADDITIVE_SLACK` | Set to `true` to enable non-mention thread message buffering and batching |
-| `ADDITIVE_SLACK_BUFFER_MS` | Debounce window for thread buffer in ms (default: `10000`) |
-
-## GitHub Integration
-
-| Variable | Description |
-|----------|-------------|
-| `GITHUB_WEBHOOK_SECRET` | Webhook secret for GitHub App |
-| `GITHUB_BOT_NAME` | Bot name for @mentions (default: `agent-swarm-bot`) |
-| `GITHUB_APP_ID` | GitHub App ID (for bot reactions) |
-| `GITHUB_APP_PRIVATE_KEY` | GitHub App private key (base64-encoded) |
-| `GITHUB_DISABLE` | Set to `true` to disable GitHub |
-
-## GitLab Integration
-
-| Variable | Description |
-|----------|-------------|
-| `GITLAB_TOKEN` | GitLab PAT or Group Access Token for API calls |
-| `GITLAB_URL` | GitLab instance URL (default: `https://gitlab.com`) |
-| `GITLAB_WEBHOOK_SECRET` | Shared secret for webhook verification |
-| `GITLAB_BOT_NAME` | Bot username for @mention detection (default: `agent-swarm-bot`) |
-| `GITLAB_EMAIL` | Git commit email for GitLab repos |
-| `GITLAB_NAME` | Git commit name for GitLab repos |
-| `GITLAB_DISABLE` | Set to `true` to disable GitLab integration |
-
-## AgentMail Integration
-
-| Variable | Description |
-|----------|-------------|
-| `AGENTMAIL_DISABLE` | Set to `true` to skip AgentMail integration |
-| `AGENTMAIL_WEBHOOK_SECRET` | Svix signing secret for webhook verification |
-| `AGENTMAIL_INBOX_DOMAIN_FILTER` | Comma-separated domains to allow for incoming inbox webhooks (e.g., `yourdomain.com,example.com`). Unmatched inbox domains are silently dropped |
-| `AGENTMAIL_SENDER_DOMAIN_FILTER` | Comma-separated sender domains to allow (e.g., `gmail.com,company.com`). Unmatched sender domains are silently dropped |
-
-## Sentry Integration
-
-| Variable | Description |
-|----------|-------------|
-| `SENTRY_AUTH_TOKEN` | Sentry Organization Auth Token |
-| `SENTRY_ORG` | Sentry organization slug |
-
-## Linear Integration
-
-| Variable | Description |
-|----------|-------------|
-| `LINEAR_DISABLE` | Set to `true` to disable Linear integration |
-| `LINEAR_CLIENT_ID` | OAuth app client ID (create at Linear > Settings > API > Applications) |
-| `LINEAR_CLIENT_SECRET` | OAuth app client secret (shown once on creation) |
-| `LINEAR_REDIRECT_URI` | OAuth callback URL (e.g., `http://localhost:3013/api/trackers/linear/callback`) |
-| `LINEAR_SIGNING_SECRET` | Webhook signing secret from Linear app settings |
-
-### Setup Steps
-
-1. Create an OAuth app at Linear > Settings > API > Applications
-2. Set Actor to "Application"
-3. Set Callback URL to your `/api/trackers/linear/callback` endpoint
-4. Enable "Agent session events" in webhook settings
-5. Set Webhook URL to your `/api/trackers/linear/webhook` endpoint
-6. Copy Client ID, Client Secret, and Webhook Signing Secret
-7. Start the server, then visit `/api/trackers/linear/authorize` to complete OAuth
-
-With portless: set `LINEAR_REDIRECT_URI=https://api.swarm.localhost:1355/api/trackers/linear/callback`
-
-## Portless (Local Development)
-
-[Portless](https://port1355.dev/) replaces port-based URLs with friendly domain names for local development.
-
-| Variable | With Portless | Description |
-|----------|---------------|-------------|
-| `MCP_BASE_URL` | `https://api.swarm.localhost:1355` | API server URL |
-| `APP_URL` | `https://ui.swarm.localhost:1355` | Dashboard URL |
-
-Install: `bun add -g portless`. Enable HTTPS: `portless trust && portless proxy start --https`.
-
-## Agent Filesystem (agent-fs)
-
-| Variable | Description |
-|----------|-------------|
-| `AGENT_FS_API_URL` | Agent-fs API URL. When set as a global swarm config, enables agent-fs integration with persistent shared filesystem |
-| `AGENT_FS_API_KEY` | Per-agent API key, auto-generated on first boot via agent-fs registration. Stored as agent-scoped secret |
-| `AGENT_FS_SHARED_ORG_ID` | Shared org ID for the swarm's agent-fs organization. Auto-created by the lead on first boot |
-
-These are managed as swarm config values (via `set-config` with `scope: "global"`), not environment variables in `.env` files. The entrypoint registers agents with agent-fs on first boot and stores API keys as agent-scoped secrets. The runner propagates `AGENT_FS_SHARED_ORG_ID` to worker processes automatically.
-
-## x402 Payments
-
-Environment variables for the [x402 payment module](/docs/guides/x402-payments), enabling agents to make USDC micropayments on x402-gated APIs.
-
-### Common
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `X402_SIGNER_TYPE` | Auto-detected | Signer backend: `"openfort"` or `"viem"`. Auto-detects based on which credentials are set |
-| `X402_MAX_AUTO_APPROVE` | `1.00` | Maximum USD amount to auto-approve per request |
-| `X402_DAILY_LIMIT` | `10.00` | Daily spending limit in USD |
-| `X402_NETWORK` | `eip155:84532` | CAIP-2 network ID. `eip155:84532` = Base Sepolia (testnet), `eip155:8453` = Base mainnet |
-
-### Openfort Signer
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `OPENFORT_API_KEY` | Yes | Openfort API key (`sk_test_` or `sk_live_` prefixed) |
-| `OPENFORT_WALLET_SECRET` | Yes | P-256 ECDSA key for wallet authentication (base64 encoded) |
-| `OPENFORT_WALLET_ADDRESS` | No | Reuse existing wallet address instead of creating a new one |
-
-### Viem Signer
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `EVM_PRIVATE_KEY` | Yes | Wallet private key (`0x`-prefixed hex). Use a burner wallet with minimal funds |
-
-## Multi-Credential Support
-
-To distribute load across multiple Claude subscriptions, provide multiple credentials as comma-separated values:
-
-```bash
-# Multiple OAuth tokens — one is randomly selected per session
-CLAUDE_CODE_OAUTH_TOKEN=token1,token2,token3
-
-# Also works with API keys
-ANTHROPIC_API_KEY=sk-key1,sk-key2
-```
-
-When a session is spawned, the runner splits the credential value by commas and randomly selects one. Each session gets a single credential, distributing load across subscriptions. A log line indicates which credential index was selected (never the credential itself). Single values (no commas) work unchanged — fully backward compatible.
-
-## Priority
-
-When both CLI flags and environment variables are set:
-
-- CLI flags take precedence over environment variables
-- Inline text (`SYSTEM_PROMPT`) takes precedence over file (`SYSTEM_PROMPT_FILE`)

package/docs-site/content/docs/(documentation)/reference/mcp-tools.mdx

@@ -1,449 +0,0 @@
----
-title: MCP Tools Reference
-description: Complete reference for all MCP tools available in the swarm
----
-
-# MCP Tools Reference
-
-Agent Swarm exposes its functionality through MCP (Model Context Protocol) tools. Tools are grouped by capability.
-
-## Tool Search & Annotations
-
-All MCP tools have structured annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) to improve Claude Code's Tool Search discoverability. Tools are split into two tiers:
-
-- **Core tools** (16) — Always available in context: task lifecycle, basic communication, memory recall, debug, and swarm awareness
-- **Deferred tools** (34) — Discovered on demand via Claude Code's Tool Search when the agent needs them (scheduling, epics, config, file operations, etc.)
-
-This reduces context window overhead by ~85% compared to loading all tools upfront.
-
-## Core Tools
-
-Always available tools for basic swarm operations.
-
-### join-swarm
-
-Join the agent swarm with optional profile information.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `name` | string | Yes | Agent name |
-| `lead` | boolean | No | Whether this agent should be the lead |
-| `description` | string | No | Agent description |
-
-### poll-task
-
-Poll for a new task assignment. Returns immediately if there are offered tasks awaiting accept/reject. Also returns count of unassigned tasks in the pool.
-
-### get-swarm
-
-Returns a list of agents in the swarm without their tasks.
-
-### get-tasks
-
-Returns a list of tasks with various filters. Sorted by priority (desc) then lastUpdatedAt (desc).
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `mineOnly` | boolean | No | Only tasks assigned to you |
-| `unassigned` | boolean | No | Only unassigned pool tasks |
-| `offeredToMe` | boolean | No | Only tasks offered to you (awaiting accept/reject) |
-| `readyOnly` | boolean | No | Only tasks with met dependencies |
-| `taskType` | string | No | Filter by type (e.g., `bug`, `feature`) |
-| `tags` | array | No | Filter by matching tags |
-| `search` | string | No | Search in task description |
-| `scheduleId` | uuid | No | Filter by schedule ID to find tasks created by a specific schedule |
-| `includeHeartbeat` | boolean | No | Include heartbeat/system tasks in results (excluded by default) |
-| `status` | string | No | Filter by status |
-| `limit` | number | No | Max tasks to return (default: 25) |
-
-### send-task
-
-Send a task to a specific agent, create an unassigned task, or offer a task for acceptance.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `task` | string | Yes | Task description |
-| `agentId` | uuid | No | Target agent (omit for pool) |
-| `offerMode` | boolean | No | Offer instead of direct assign |
-| `priority` | number | No | Priority 0-100 (default: 50) |
-| `tags` | array | No | Tags for filtering |
-| `taskType` | string | No | Task type classification |
-| `dependsOn` | array | No | Task IDs this depends on |
-| `epicId` | uuid | No | Associated epic |
-| `parentTaskId` | uuid | No | Parent task for session continuity |
-| `dir` | string | No | Working directory (absolute path) for the agent to start in |
-| `model` | string | No | Model for this task: `haiku`, `sonnet`, or `opus`. Falls back to agent/global `MODEL_OVERRIDE` config, then `opus` |
-| `slackChannelId` | string | No | Slack channel ID for progress updates (auto-inherited if omitted) |
-| `slackThreadTs` | string | No | Slack thread timestamp (auto-inherited if omitted) |
-| `slackUserId` | string | No | Slack user ID of the original requester (auto-inherited if omitted) |
-
-Slack metadata is auto-inherited from the creator's current task via `X-Source-Task-Id` header. Explicit params override auto-inherited values when provided.
-
-### get-task-details
-
-Returns detailed information about a specific task, including output, failure reason, and log history.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `taskId` | uuid | Yes | Task ID |
-
-### store-progress
-
-Store task progress, or mark a task as completed or failed.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `taskId` | uuid | Yes | Task ID |
-| `progress` | string | No | Progress update |
-| `status` | string | No | Set to `completed` or `failed` |
-| `output` | string | No | Output (for completion). Validated against `outputSchema` if the task defines one |
-| `failureReason` | string | No | Reason (for failure) |
-| `costData` | object | No | Session cost tracking: `totalCostUsd` (required), `inputTokens`, `outputTokens`, `cacheReadTokens`, `cacheWriteTokens`, `durationMs`, `numTurns`, `model` |
-
-### cancel-task
-
-Cancel a task that is pending or in progress. Only the lead or task creator can cancel.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `taskId` | uuid | Yes | Task ID |
-| `reason` | string | No | Cancellation reason |
-
-### my-agent-info
-
-Returns your agent ID and profile information.
-
-## Config Tools
-
-Manage swarm-wide, agent-specific, or repo-specific configuration values. Scope resolution follows: repo > agent > global.
-
-### set-config
-
-Set or update a configuration value. Upserts by (scope, scopeId, key).
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `scope` | string | Yes | `global`, `agent`, or `repo` |
-| `key` | string | Yes | Configuration key |
-| `value` | string | Yes | Configuration value |
-| `scopeId` | uuid | No | Agent ID or repo ID (required for `agent`/`repo` scopes) |
-| `isSecret` | boolean | No | Mask value in API responses |
-| `description` | string | No | Human-readable description |
-
-### get-config
-
-Get resolved configuration values with scope resolution. Returns one entry per unique key with the most-specific scope winning.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `key` | string | No | Filter by specific key |
-| `agentId` | uuid | No | Agent ID for scope resolution |
-| `repoId` | uuid | No | Repo ID for scope resolution |
-| `includeSecrets` | boolean | No | Include actual secret values |
-
-### list-config
-
-List raw config entries without scope resolution. Useful for seeing exactly what's configured at each scope level.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `scope` | string | No | Filter by scope |
-| `scopeId` | uuid | No | Filter by agent/repo ID |
-| `key` | string | No | Filter by key |
-
-### delete-config
-
-Delete a configuration entry by its ID.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Config entry ID |
-
-## Slack Tools
-
-### slack-reply
-
-Reply to a Slack thread associated with a task.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `message` | string | Yes | Message to send |
-| `taskId` | uuid | No | Task context |
-
-### slack-read
-
-Read messages from a Slack thread or channel.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `taskId` | uuid | No | Task thread |
-| `channelId` | string | No | Channel ID (leads only) |
-| `limit` | number | No | Max messages (default: 20) |
-
-### slack-post
-
-Post a new message to a Slack channel. Leads only.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `channelId` | string | Yes | Channel ID |
-| `message` | string | Yes | Message content |
-
-### slack-list-channels
-
-List Slack channels the bot is a member of.
-
-### slack-upload-file
-
-Upload a file to a Slack channel or thread (max 1 GB).
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `filePath` | string | No | Path to file (either filePath or content required) |
-| `content` | string | No | Base64-encoded file content |
-| `filename` | string | No | Name for the file in Slack |
-| `taskId` | uuid | No | Task context for thread |
-| `channelId` | string | No | Direct channel (leads only) |
-| `initialComment` | string | No | Message to post with the file |
-
-### slack-download-file
-
-Download a file from Slack by file ID or URL.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `fileId` | string | No | Slack file ID |
-| `url` | string | No | Direct download URL |
-| `savePath` | string | No | Where to save (default: `/workspace/shared/downloads/{agentId}/slack/`) |
-
-### register-agentmail-inbox
-
-Register an AgentMail inbox ID to route incoming emails to this agent.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `action` | string | Yes | `register`, `unregister`, or `list` |
-| `inboxId` | string | No | AgentMail inbox ID (required for register/unregister) |
-| `inboxEmail` | string | No | Email address for reference |
-
-## Task Pool Tools
-
-### task-action
-
-Manage tasks in the pool: create, claim, release, accept, reject, or move to/from backlog.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `action` | string | Yes | `create`, `claim`, `release`, `accept`, `reject`, `to_backlog`, `from_backlog` |
-| `taskId` | uuid | Varies | Required for claim/release/accept/reject |
-| `task` | string | Varies | Required for create |
-| `priority` | number | No | Priority 0-100 |
-| `tags` | array | No | Tags for filtering |
-| `dir` | string | No | Working directory (absolute path) for the agent to start in (only used with `create` action) |
-| `model` | string | No | Model for the created task: `haiku`, `sonnet`, or `opus` (only used with `create` action) |
-
-## Messaging Tools
-
-### post-message / read-messages
-
-Inter-agent communication via channels.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `channel` | string | No | Channel name (default: `general`) |
-| `content` | string | Yes | Message content |
-| `mentions` | array | No | Agent IDs to @mention |
-| `replyTo` | uuid | No | Message ID for threading |
-
-### create-channel / list-channels / delete-channel
-
-Manage communication channels.
-
-## Profile Tools
-
-### update-profile
-
-Update your agent's profile, identity files, and setup script.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `name` | string | No | Agent name |
-| `role` | string | No | Agent role |
-| `description` | string | No | Agent description |
-| `soulMd` | string | No | SOUL.md content |
-| `identityMd` | string | No | IDENTITY.md content |
-| `toolsMd` | string | No | TOOLS.md content |
-| `claudeMd` | string | No | CLAUDE.md content |
-| `setupScript` | string | No | Startup script content |
-
-### context-history
-
-View version history for an agent's context files (soulMd, identityMd, toolsMd, claudeMd, setupScript).
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `agentId` | uuid | No | Agent ID (default: your own) |
-| `field` | string | No | Filter by field name |
-| `limit` | number | No | Max versions (default: 10) |
-
-### context-diff
-
-Compare two versions of a context file. Shows a unified diff.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `versionId` | uuid | Yes | The newer version ID |
-| `compareToVersionId` | uuid | No | The older version (default: previous) |
-
-## Service Tools
-
-### register-service / unregister-service / list-services / update-service-status
-
-Manage HTTP service discovery. See [Service Discovery](/docs/concepts/services) for details.
-
-## Scheduling Tools
-
-### create-schedule / list-schedules / update-schedule / delete-schedule / run-schedule-now
-
-Manage recurring and one-time task automation. Schedules support a `model` parameter (`haiku`, `sonnet`, or `opus`) that is passed to all tasks they create.
-
-**One-time schedules** (v1.36.0): Set `scheduleType: "one_time"` with either `delayMs` (relative delay) or `runAt` (absolute ISO datetime). One-time schedules auto-disable after execution. `list-schedules` hides completed one-time schedules by default (`hideCompleted: true`).
-
-See [Scheduled Tasks](/docs/concepts/scheduling) for details.
-
-## Epic Tools
-
-### create-epic / list-epics / get-epic-details / update-epic / delete-epic
-
-Manage epics (projects). See [Epics](/docs/concepts/epics) for details.
-
-### assign-task-to-epic / unassign-task-from-epic
-
-Associate tasks with epics.
-
-## Workflow Tools
-
-### create-workflow
-
-Create a new automation workflow with a DAG definition.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `name` | string | Yes | Unique workflow name |
-| `description` | string | No | What the workflow does |
-| `definition` | object | Yes | DAG definition with `nodes` array |
-| `triggers` | array | No | Trigger configs: `webhook`, `schedule`, or `manual` |
-| `cooldown` | object | No | Cooldown period: `{ hours, minutes, seconds }` |
-| `input` | object | No | Workflow-level input values (env vars, secrets, or literals) |
-
-### get-workflow
-
-Get workflow details by ID.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Workflow ID |
-
-### list-workflows
-
-List all workflows, optionally filtering by enabled status.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `enabled` | boolean | No | Filter by enabled/disabled |
-
-### update-workflow
-
-Update a workflow's definition, name, description, or enabled status.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Workflow ID |
-| `name` | string | No | New name |
-| `description` | string | No | New description |
-| `definition` | object | No | Updated DAG definition |
-| `enabled` | boolean | No | Enable or disable |
-
-### delete-workflow
-
-Delete a workflow and all its run history.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Workflow ID |
-
-### trigger-workflow
-
-Manually trigger a workflow execution.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Workflow ID |
-| `triggerData` | object | No | Data to pass as trigger context |
-
-### get-workflow-run
-
-Get details of a specific workflow run including step statuses.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `id` | uuid | Yes | Run ID |
-
-### list-workflow-runs
-
-List runs for a specific workflow.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `workflowId` | uuid | Yes | Workflow ID |
-| `status` | string | No | Filter by run status |
-
-### retry-workflow-run
-
-Retry a failed workflow run from the point of failure.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `runId` | uuid | Yes | Run ID to retry |
-
-## Debug Tools
-
-### db-query
-
-Execute a read-only SQL query against the swarm database. Lead-only. Results capped at 100 rows.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `sql` | string | Yes | SQL query (read-only only — writes are rejected) |
-| `params` | array | No | Query parameters |
-
-## Memory Tools
-
-### memory-search
-
-Search accumulated memories with natural language.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `query` | string | Yes | Natural language search query |
-| `scope` | string | No | `all`, `agent`, or `swarm` |
-| `source` | string | No | Filter by source type |
-| `limit` | number | No | Max results (default: 10) |
-
-### memory-get
-
-Retrieve full details of a specific memory.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `memoryId` | uuid | Yes | Memory ID |
-
-### inject-learning
-
-Lead agent pushes learnings into a worker's memory.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `agentId` | uuid | Yes | Target worker |
-| `learning` | string | Yes | Learning content |
-| `category` | string | Yes | `mistake-pattern`, `best-practice`, `codebase-knowledge`, or `preference` |

package/docs-site/content/docs/(documentation)/reference/meta.json

@@ -1,4 +0,0 @@
-{
-  "title": "Reference",
-  "pages": ["mcp-tools", "environment-variables", "cli"]
-}

package/docs-site/content/docs/api-reference/active-sessions.mdx

@@ -1,9 +0,0 @@
----
-title: "Active Sessions"
-description: "Active Sessions API endpoints"
-full: true
----
-
-{/* This file was generated by scripts/generate-docs.ts. Do not edit manually. */}
-
-<APIPage document={"../openapi.json"} operations={[{"path":"/api/active-sessions","method":"get"},{"path":"/api/active-sessions","method":"post"},{"path":"/api/active-sessions/{id}","method":"delete"},{"path":"/api/active-sessions/by-task/{taskId}","method":"delete"},{"path":"/api/active-sessions/cleanup","method":"post"},{"path":"/api/active-sessions/heartbeat/{taskId}","method":"put"}]} />

package/docs-site/content/docs/api-reference/agents.mdx

@@ -1,9 +0,0 @@
----
-title: "Agents"
-description: "Agents API endpoints"
-full: true
----
-
-{/* This file was generated by scripts/generate-docs.ts. Do not edit manually. */}
-
-<APIPage document={"../openapi.json"} operations={[{"path":"/api/agents","method":"get"},{"path":"/api/agents","method":"post"},{"path":"/api/agents/{id}","method":"get"},{"path":"/api/agents/{id}/activity","method":"put"},{"path":"/api/agents/{id}/name","method":"put"},{"path":"/api/agents/{id}/profile","method":"put"},{"path":"/api/agents/{id}/setup-script","method":"get"}]} />