@aiderdesk/aiderdesk 0.73.0 → 0.75.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/out/{open-telemetry-baOvr6sK.js → open-telemetry-B7yROZIC.js} +3 -0
- package/out/renderer/assets/{AgentSettings-B8NFKgLb.js → AgentSettings-DX34HLFv.js} +4561 -3203
- package/out/renderer/assets/{InfoIcon-DhMP8XnB.js → InfoIcon-DzyZQ7Ye.js} +1 -1
- package/out/renderer/assets/{Onboarding-CmlEw4fh.js → Onboarding-FwXfKZ8B.js} +4 -4
- package/out/renderer/assets/{ProviderHeader-DMNcKpGs.js → ProviderHeader-Cii9aAmV.js} +418 -197
- package/out/renderer/assets/{SettingsPage-CmOR4wA1.js → SettingsPage-XanGltUZ.js} +13 -7
- package/out/renderer/assets/{UsageDashboard-BGAWd1b2.js → UsageDashboard-eHbvZTZC.js} +3795 -2366
- package/out/renderer/assets/{arc-Jg3VSYdu.js → arc-CVfdiTl1.js} +1 -1
- package/out/renderer/assets/{architectureDiagram-3BPJPVTR-BhT1Ad0h.js → architectureDiagram-3BPJPVTR-DsLLo_Ek.js} +3 -3
- package/out/renderer/assets/{blockDiagram-GPEHLZMM-BZuMX6U_.js → blockDiagram-GPEHLZMM-eWy47S0_.js} +4 -4
- package/out/renderer/assets/{c4Diagram-AAUBKEIU-QL7T5rpZ.js → c4Diagram-AAUBKEIU-BH9b_e6y.js} +2 -2
- package/out/renderer/assets/{channel-K2W31OE5.js → channel-D1z_mPGJ.js} +1 -1
- package/out/renderer/assets/{chunk-2J33WTMH-LumY2cbE.js → chunk-2J33WTMH-DK0Yw_7f.js} +1 -1
- package/out/renderer/assets/{chunk-4BX2VUAB-GLhRzKG1.js → chunk-4BX2VUAB-DIGR8Y5b.js} +1 -1
- package/out/renderer/assets/{chunk-55IACEB6-B3B3AcnH.js → chunk-55IACEB6-DoCkLI5e.js} +1 -1
- package/out/renderer/assets/{chunk-727SXJPM-DMyZUEKf.js → chunk-727SXJPM-C2gQLzLi.js} +5 -5
- package/out/renderer/assets/{chunk-AQP2D5EJ-CQsD5TCd.js → chunk-AQP2D5EJ-D83_SlRR.js} +3 -3
- package/out/renderer/assets/{chunk-FMBD7UC4-x4SmU5Oe.js → chunk-FMBD7UC4-CyiPoUsC.js} +1 -1
- package/out/renderer/assets/{chunk-ND2GUHAM-pT6s9nFT.js → chunk-ND2GUHAM-DfGsUYDD.js} +1 -1
- package/out/renderer/assets/{chunk-QZHKN3VN-Cv8umQxL.js → chunk-QZHKN3VN-BhnTFlht.js} +1 -1
- package/out/renderer/assets/{classDiagram-4FO5ZUOK-DmOcXaER.js → classDiagram-4FO5ZUOK-Dy7E8tVe.js} +6 -6
- package/out/renderer/assets/{classDiagram-v2-Q7XG4LA2-DmOcXaER.js → classDiagram-v2-Q7XG4LA2-Dy7E8tVe.js} +6 -6
- package/out/renderer/assets/{cose-bilkent-S5V4N54A-Bi6ESdxa.js → cose-bilkent-S5V4N54A-Dsl61WN3.js} +1 -1
- package/out/renderer/assets/{dagre-BM42HDAG-BK2slT53.js → dagre-BM42HDAG-D-u18G94.js} +3 -3
- package/out/renderer/assets/{diagram-2AECGRRQ-DkgLH6e2.js → diagram-2AECGRRQ-BumP49Qp.js} +3 -3
- package/out/renderer/assets/{diagram-5GNKFQAL-BwAieVd0.js → diagram-5GNKFQAL-VpUN87Sw.js} +4 -4
- package/out/renderer/assets/{diagram-KO2AKTUF-D6Km_LB9.js → diagram-KO2AKTUF-CXCWwzRa.js} +3 -3
- package/out/renderer/assets/{diagram-LMA3HP47-BhWSHEeO.js → diagram-LMA3HP47-vlOcStwn.js} +3 -3
- package/out/renderer/assets/{diagram-OG6HWLK6-zoN4RvNr.js → diagram-OG6HWLK6-DS1BscxN.js} +4 -4
- package/out/renderer/assets/{erDiagram-TEJ5UH35-DooZS_mc.js → erDiagram-TEJ5UH35-DPi6-CLL.js} +4 -4
- package/out/renderer/assets/{flowDiagram-I6XJVG4X-CmZPvaDJ.js → flowDiagram-I6XJVG4X-BYlX12Cd.js} +6 -6
- package/out/renderer/assets/{ganttDiagram-6RSMTGT7-Bx6OJzRM.js → ganttDiagram-6RSMTGT7-BJQl-A9d.js} +3 -3
- package/out/renderer/assets/{gitGraphDiagram-PVQCEYII-BPUT8Ht7.js → gitGraphDiagram-PVQCEYII-CUFXx3IZ.js} +4 -4
- package/out/renderer/assets/{graph-CwC0h_b8.js → graph-CbFubTTc.js} +1 -1
- package/out/renderer/assets/{index-DOOlJc12.js → index-9GNr8q1O.js} +1 -1
- package/out/renderer/assets/{index-BSFaA4XQ.js → index-B6R_BNfE.js} +1 -1
- package/out/renderer/assets/{index-PGLvyST0.js → index-B9iW9QmT.js} +1 -1
- package/out/renderer/assets/{index-DqiktxfT.js → index-BkdacTnN.js} +1 -1
- package/out/renderer/assets/{index-ChKmR4QP.js → index-C7885gEz.js} +1 -1
- package/out/renderer/assets/{index-CXq4cCbe.js → index-Cg7tn967.js} +576 -251
- package/out/renderer/assets/{index-B3o44aT2.css → index-DCILJy4w.css} +50 -16
- package/out/renderer/assets/{index-CI0IUNzz.js → index-DNlMJMPg.js} +4194 -3241
- package/out/renderer/assets/{index-BrZFlbuf.js → index-DYKLRIHT.js} +1 -1
- package/out/renderer/assets/{index-Ds5GQdTm.js → index-DeoI6jti.js} +1 -1
- package/out/renderer/assets/{index-xI0MsLE8.js → index-fD843lMX.js} +1 -1
- package/out/renderer/assets/{infoDiagram-5YYISTIA-C77gIx1a.js → infoDiagram-5YYISTIA-IWJLFUYz.js} +2 -2
- package/out/renderer/assets/{ishikawaDiagram-YF4QCWOH-DZ8xk7_N.js → ishikawaDiagram-YF4QCWOH-BuNfm7cB.js} +1 -1
- package/out/renderer/assets/{journeyDiagram-JHISSGLW-BLPdv_c5.js → journeyDiagram-JHISSGLW-CfceKUHO.js} +4 -4
- package/out/renderer/assets/{jsx-dev-runtime-1M6DZ35g.js → jsx-dev-runtime-DT3FTts0.js} +1 -1
- package/out/renderer/assets/{kanban-definition-UN3LZRKU-CMHVN7c3.js → kanban-definition-UN3LZRKU-Bb6YnEgS.js} +2 -2
- package/out/renderer/assets/{layout-BJqshyQm.js → layout-BkrDn6V9.js} +2 -2
- package/out/renderer/assets/{linear-CbEhS1qE.js → linear-jxO_dc8P.js} +1 -1
- package/out/renderer/assets/{mindmap-definition-RKZ34NQL-C8Cz7pQU.js → mindmap-definition-RKZ34NQL-BPRx7p9A.js} +3 -3
- package/out/renderer/assets/{pieDiagram-4H26LBE5-Bx5tSw6i.js → pieDiagram-4H26LBE5-CPR4AuPM.js} +4 -4
- package/out/renderer/assets/{quadrantDiagram-W4KKPZXB-CX6DcDEk.js → quadrantDiagram-W4KKPZXB-BKzlAr7m.js} +2 -2
- package/out/renderer/assets/{requirementDiagram-4Y6WPE33-qBp8nKy9.js → requirementDiagram-4Y6WPE33-CUan3EZI.js} +3 -3
- package/out/renderer/assets/{sankeyDiagram-5OEKKPKP-B5zYIsBo.js → sankeyDiagram-5OEKKPKP-y8X8qnX2.js} +1 -1
- package/out/renderer/assets/{sequenceDiagram-3UESZ5HK-C57DtTdH.js → sequenceDiagram-3UESZ5HK-B4xv8iDW.js} +3 -3
- package/out/renderer/assets/{stateDiagram-AJRCARHV-CGRyr6CG.js → stateDiagram-AJRCARHV-DTPE2Z4L.js} +6 -6
- package/out/renderer/assets/{stateDiagram-v2-BHNVJYJU-3hvBe5lv.js → stateDiagram-v2-BHNVJYJU-BmZ9o6q3.js} +4 -4
- package/out/renderer/assets/{time-B3bXse3U.js → time-D391Z6zp.js} +1 -1
- package/out/renderer/assets/{timeline-definition-PNZ67QCA-Dpq0iPd0.js → timeline-definition-PNZ67QCA-DVLUB2HD.js} +2 -2
- package/out/renderer/assets/{vennDiagram-CIIHVFJN-_jSNuVb5.js → vennDiagram-CIIHVFJN-BGGBlVN1.js} +1 -1
- package/out/renderer/assets/{wardley-L42UT6IY-DixmVaQZ.js → wardley-L42UT6IY-ZVVSjQUD.js} +1 -1
- package/out/renderer/assets/{wardleyDiagram-YWT4CUSO-DMK4zc32.js → wardleyDiagram-YWT4CUSO-CRAH-LRw.js} +3 -3
- package/out/renderer/assets/{xychartDiagram-2RQKCTM6-DKPuWmAF.js → xychartDiagram-2RQKCTM6-DQqvm7M3.js} +2 -2
- package/out/renderer/index.html +2 -2
- package/out/resources/linux/probe +0 -0
- package/out/resources/linux-x64/probe +0 -0
- package/out/resources/skills/agent-creator/SKILL.md +223 -0
- package/out/resources/skills/agent-creator/assets/examples/sample-profile.json +47 -0
- package/out/resources/skills/agent-creator/assets/templates/config.json.template +47 -0
- package/out/resources/skills/agent-creator/references/agent-profile-schema.md +294 -0
- package/out/resources/skills/agent-creator/references/profile-examples.md +490 -0
- package/out/resources/skills/agent-creator/references/subagent-guide.md +317 -0
- package/out/resources/skills/agent-creator/references/tool-approval-guide.md +484 -0
- package/out/resources/skills/extension-creator/SKILL.md +71 -7
- package/out/resources/skills/extension-creator/references/event-types.md +543 -40
- package/out/resources/skills/extension-creator/references/examples-gallery.md +23 -14
- package/out/resources/skills/extension-creator/references/extension-interface.md +1111 -171
- package/out/resources/skills/extension-creator/references/ui-components.md +34 -6
- package/out/runner.js +11164 -10392
- package/package.json +21 -19
- package/patches/@requesty+ai-sdk+3.5.0.patch +84 -0
- package/patches/ai+7.0.28.patch +33 -0
- package/patches/ai+5.0.195.patch +0 -33
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
# Subagent Configuration Guide
|
|
2
|
+
|
|
3
|
+
Complete guide to configuring subagents and subagent filtering for agent profiles in AiderDesk.
|
|
4
|
+
|
|
5
|
+
## SubagentConfig Properties
|
|
6
|
+
|
|
7
|
+
| Property | Type | Description | Default |
|
|
8
|
+
|-----------|------|-------------|----------|
|
|
9
|
+
| `enabled` | boolean | Can this profile be used as a subagent? | `false` |
|
|
10
|
+
| `contextMemory` | ContextMemoryMode | How much previous context to share | `"off"` |
|
|
11
|
+
| `systemPrompt` | string | Specialized system prompt for subagent role | Empty |
|
|
12
|
+
| `invocationMode` | InvocationMode | When to invoke this subagent | `"on-demand"` |
|
|
13
|
+
| `color` | string | Visual identifier (hex color) | `"#3368a8"` |
|
|
14
|
+
| `description` | string | Description for automatic invocation | Empty |
|
|
15
|
+
|
|
16
|
+
## System Prompts: Two Distinct Fields
|
|
17
|
+
|
|
18
|
+
AiderDesk has two separate system prompt fields that serve different roles:
|
|
19
|
+
|
|
20
|
+
### Top-Level `systemPrompt` (AgentProfile)
|
|
21
|
+
|
|
22
|
+
- Used when the profile runs as the **main agent**
|
|
23
|
+
- Replaces the default template-generated system prompt entirely
|
|
24
|
+
- Rules files and `customInstructions` are still appended after it
|
|
25
|
+
- If empty, the default built-in system prompt is used (includes OS info, project context, tool permissions, autonomy mode)
|
|
26
|
+
- Falls back as subagent system prompt when `subagent.systemPrompt` is empty
|
|
27
|
+
|
|
28
|
+
### `subagent.systemPrompt` (SubagentConfig)
|
|
29
|
+
|
|
30
|
+
- Used when the profile runs as a **subagent**
|
|
31
|
+
- Passed directly to the subagent's LLM
|
|
32
|
+
- If empty, falls back to the top-level `systemPrompt`
|
|
33
|
+
|
|
34
|
+
### When to Use Which
|
|
35
|
+
|
|
36
|
+
| Scenario | Top-level `systemPrompt` | `subagent.systemPrompt` |
|
|
37
|
+
|----------|-------------------------|------------------------|
|
|
38
|
+
| Agent works only as main agent | Set with custom behavior | Leave empty |
|
|
39
|
+
| Agent works only as subagent | Leave empty (default used) | Set with subagent-specific behavior |
|
|
40
|
+
| Agent works in both roles | Set with main-agent behavior | Set with subagent-specific behavior (can differ) |
|
|
41
|
+
| Agent doesn't need custom prompts | Leave empty | Leave empty |
|
|
42
|
+
|
|
43
|
+
**Example:** An agent that acts as a code reviewer both as main agent and subagent:
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"systemPrompt": "You are a code review expert. Analyze changes systematically. Provide constructive feedback.",
|
|
47
|
+
"subagent": {
|
|
48
|
+
"enabled": true,
|
|
49
|
+
"systemPrompt": "You are a specialized code review subagent. Focus on the specific code changes provided. Be concise and actionable.",
|
|
50
|
+
"contextMemory": "full-context",
|
|
51
|
+
"invocationMode": "automatic",
|
|
52
|
+
"color": "#ef4444",
|
|
53
|
+
"description": "Expert code review specialist focused on quality and security"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Context Memory Modes
|
|
59
|
+
|
|
60
|
+
Controls how much of previous conversation context is remembered by the subagent across multiple invocations.
|
|
61
|
+
|
|
62
|
+
### Off (`"off"`)
|
|
63
|
+
|
|
64
|
+
**Behavior:** Subagent starts fresh with no previous conversation history. Each invocation is completely independent.
|
|
65
|
+
|
|
66
|
+
**When to Use:**
|
|
67
|
+
- Tasks are independent and self-contained
|
|
68
|
+
- Token cost is a priority
|
|
69
|
+
- Previous context isn't relevant to new tasks
|
|
70
|
+
- Default for most profiles
|
|
71
|
+
|
|
72
|
+
**Pros:**
|
|
73
|
+
- Lower token cost
|
|
74
|
+
- Cleaner context
|
|
75
|
+
- No confusion from previous conversations
|
|
76
|
+
- Predictable behavior
|
|
77
|
+
|
|
78
|
+
**Cons:**
|
|
79
|
+
- No continuity across multiple invocations
|
|
80
|
+
- Cannot reference previous decisions or work
|
|
81
|
+
|
|
82
|
+
**Examples:** Power Tools profile, Aider profile, general purpose agents, single-task agents
|
|
83
|
+
|
|
84
|
+
### Last Message (`"last-message"`)
|
|
85
|
+
|
|
86
|
+
**Behavior:** Subagent receives only the final message from previous runs. Intermediate steps and reasoning are filtered out.
|
|
87
|
+
|
|
88
|
+
**When to Use:**
|
|
89
|
+
- Need the result of previous work but not the full journey
|
|
90
|
+
- Want cost savings but still need continuity
|
|
91
|
+
- Building upon latest state is sufficient
|
|
92
|
+
|
|
93
|
+
**Pros:**
|
|
94
|
+
- Token-efficient
|
|
95
|
+
- Provides continuity via latest result
|
|
96
|
+
- Avoids context bloat
|
|
97
|
+
|
|
98
|
+
**Cons:**
|
|
99
|
+
- Loses intermediate steps and reasoning
|
|
100
|
+
- Cannot reference earlier decisions
|
|
101
|
+
- Limited context for complex dependencies
|
|
102
|
+
|
|
103
|
+
**Examples:** Documentation generators, status update agents, progressive builders
|
|
104
|
+
|
|
105
|
+
### Full Context (`"full-context"`)
|
|
106
|
+
|
|
107
|
+
**Behavior:** Subagent receives entire conversation history from previous runs. All messages, tool calls, and results are preserved.
|
|
108
|
+
|
|
109
|
+
**When to Use:**
|
|
110
|
+
- Complex, iterative tasks requiring deep continuity
|
|
111
|
+
- Building upon previous decisions and reasoning
|
|
112
|
+
- Analysis that needs complete history
|
|
113
|
+
- Specialized, expert agents
|
|
114
|
+
|
|
115
|
+
**Pros:**
|
|
116
|
+
- Complete context awareness
|
|
117
|
+
- Maintains reasoning and decisions
|
|
118
|
+
- Can reference any point in conversation history
|
|
119
|
+
|
|
120
|
+
**Cons:**
|
|
121
|
+
- Higher token cost
|
|
122
|
+
- Potential for context bloat
|
|
123
|
+
- May include irrelevant information
|
|
124
|
+
|
|
125
|
+
**Examples:** Code reviewers, security auditors, debugging agents, long-running analysis
|
|
126
|
+
|
|
127
|
+
## Invocation Modes
|
|
128
|
+
|
|
129
|
+
### On-Demand (`"on-demand"`)
|
|
130
|
+
|
|
131
|
+
- Only invoked when explicitly requested by user or main agent
|
|
132
|
+
- Manual control over when to use
|
|
133
|
+
- Default for most profiles
|
|
134
|
+
|
|
135
|
+
**When to Use:** General purpose profiles, profiles with broad capabilities, user wants manual control
|
|
136
|
+
|
|
137
|
+
### Automatic (`"automatic"`)
|
|
138
|
+
|
|
139
|
+
- Automatically invoked when relevant to current task
|
|
140
|
+
- Based on `description` matching task context
|
|
141
|
+
- Requires clear, specific `description`
|
|
142
|
+
|
|
143
|
+
**When to Use:** Specialized profiles with clear purpose, domain experts
|
|
144
|
+
|
|
145
|
+
**Tips for Automatic Invocation:**
|
|
146
|
+
- Write clear, specific descriptions
|
|
147
|
+
- Include domain keywords (e.g., "security", "code review", "documentation")
|
|
148
|
+
- Avoid overly broad descriptions that trigger too frequently
|
|
149
|
+
- Focus on the agent's unique value proposition
|
|
150
|
+
|
|
151
|
+
**Example Description (Good):**
|
|
152
|
+
```
|
|
153
|
+
"Expert code review specialist focused on quality, security, and adherence to coding standards"
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
**Example Description (Bad - too vague):**
|
|
157
|
+
```
|
|
158
|
+
"Helps with code"
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Subagent Filtering
|
|
162
|
+
|
|
163
|
+
`enabledSubagentIds` on a **parent** agent profile controls which subagent profiles it can use.
|
|
164
|
+
|
|
165
|
+
### How It Works
|
|
166
|
+
|
|
167
|
+
When a main agent has `useSubagents: true`, it can delegate tasks to subagents. The `enabledSubagentIds` field controls which subagents are available:
|
|
168
|
+
|
|
169
|
+
- **Omitted/undefined** — All enabled subagents are available (default)
|
|
170
|
+
- **Array of profile IDs** — Only subagents whose `id` matches are available
|
|
171
|
+
|
|
172
|
+
### Subagent Eligibility
|
|
173
|
+
|
|
174
|
+
A subagent profile must pass `isSubagentEnabled(agentProfile, mainAgentProfile?)` check:
|
|
175
|
+
1. `subagent.enabled` must be `true`
|
|
176
|
+
2. Must not be the same profile as the main agent
|
|
177
|
+
3. If parent has `enabledSubagentIds` defined, subagent's `id` must be in the array
|
|
178
|
+
|
|
179
|
+
### Filtering Scenarios
|
|
180
|
+
|
|
181
|
+
**Allow all subagents** (default):
|
|
182
|
+
```json
|
|
183
|
+
{
|
|
184
|
+
"useSubagents": true
|
|
185
|
+
// enabledSubagentIds omitted
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
**Allow only specific subagents:**
|
|
190
|
+
```json
|
|
191
|
+
{
|
|
192
|
+
"useSubagents": true,
|
|
193
|
+
"enabledSubagentIds": ["code-reviewer", "security-auditor", "doc-generator"]
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
**Parent allows all, override for a restricted child agent:**
|
|
198
|
+
```json
|
|
199
|
+
{
|
|
200
|
+
"useSubagents": true,
|
|
201
|
+
"enabledSubagentIds": ["code-reviewer"]
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Practical Use Cases
|
|
206
|
+
|
|
207
|
+
- **Security-focused agent**: Only allow security auditor and code reviewer subagents
|
|
208
|
+
- **Documentation agent**: Only allow documentation generator subagent
|
|
209
|
+
- **Orchestrator agent**: Allow all subagents (omit `enabledSubagentIds`)
|
|
210
|
+
- **Sandboxed/isolated agent**: Allow no subagents (set `useSubagents: false`)
|
|
211
|
+
|
|
212
|
+
## Color Selection
|
|
213
|
+
|
|
214
|
+
Colors help visually distinguish subagents in the UI.
|
|
215
|
+
|
|
216
|
+
**Common Color Patterns:**
|
|
217
|
+
- **Blue** (`#3b82f6` / `#3368a8`): General purpose, power tools
|
|
218
|
+
- **Red** (`#ef4444` / `#dc2626`): Security, critical tasks
|
|
219
|
+
- **Green** (`#10b981`): Success, Aider, positive actions
|
|
220
|
+
- **Purple** (`#8b5cf6`): Documentation, creative tasks
|
|
221
|
+
- **Yellow/Orange** (`#f59e0b`): Warnings, analysis
|
|
222
|
+
- **Gray** (`#6b7280`): Neutral, default
|
|
223
|
+
|
|
224
|
+
## Default Configuration
|
|
225
|
+
|
|
226
|
+
**Every agent that should be delegable should have subagent enabled:**
|
|
227
|
+
|
|
228
|
+
```json
|
|
229
|
+
{
|
|
230
|
+
"subagent": {
|
|
231
|
+
"enabled": true,
|
|
232
|
+
"contextMemory": "off",
|
|
233
|
+
"systemPrompt": "",
|
|
234
|
+
"invocationMode": "on-demand",
|
|
235
|
+
"color": "#3368a8",
|
|
236
|
+
"description": ""
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
**Adjust Based on Agent Type:**
|
|
242
|
+
- **Analysis experts**: `contextMemory: "full-context"`, `invocationMode: "automatic"`
|
|
243
|
+
- **Progressive builders**: `contextMemory: "last-message"`, `invocationMode: "automatic"`
|
|
244
|
+
- **General purpose**: `contextMemory: "off"`, `invocationMode: "on-demand"`
|
|
245
|
+
- **Single-task agents**: `contextMemory: "off"`, `invocationMode: "on-demand"`
|
|
246
|
+
|
|
247
|
+
## Configuration Checklist
|
|
248
|
+
|
|
249
|
+
Before finalizing subagent configuration:
|
|
250
|
+
|
|
251
|
+
- [ ] `enabled` reflects whether this profile should be delegable
|
|
252
|
+
- [ ] `contextMemory` is appropriate for agent type
|
|
253
|
+
- [ ] `systemPrompt` is set if subagent-specific behavior is needed (optional — falls back to top-level `systemPrompt`)
|
|
254
|
+
- [ ] `invocationMode` matches agent's intended use
|
|
255
|
+
- [ ] If `invocationMode` is "automatic", `description` is non-empty and specific
|
|
256
|
+
- [ ] `color` is visually distinct and appropriate
|
|
257
|
+
- [ ] Parent profiles with `useSubagents: true` have `enabledSubagentIds` set if filtering is needed
|
|
258
|
+
- [ ] All referenced subagent IDs in `enabledSubagentIds` correspond to existing profiles
|
|
259
|
+
|
|
260
|
+
## Common Subagent Patterns
|
|
261
|
+
|
|
262
|
+
### Analysis Agent (Automatic Subagent)
|
|
263
|
+
```json
|
|
264
|
+
{
|
|
265
|
+
"subagent": {
|
|
266
|
+
"enabled": true,
|
|
267
|
+
"contextMemory": "full-context",
|
|
268
|
+
"systemPrompt": "You are an expert analyst specializing in code quality and security analysis.",
|
|
269
|
+
"invocationMode": "automatic",
|
|
270
|
+
"color": "#ef4444",
|
|
271
|
+
"description": "Expert analyst for detailed code and security analysis"
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
### Documentation Agent (On-Demand Subagent)
|
|
277
|
+
```json
|
|
278
|
+
{
|
|
279
|
+
"subagent": {
|
|
280
|
+
"enabled": true,
|
|
281
|
+
"contextMemory": "last-message",
|
|
282
|
+
"systemPrompt": "You are a technical documentation specialist. Create clear, comprehensive documentation.",
|
|
283
|
+
"invocationMode": "on-demand",
|
|
284
|
+
"color": "#8b5cf6",
|
|
285
|
+
"description": ""
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
### Orchestrator Agent (Uses Filtered Subagents)
|
|
291
|
+
```json
|
|
292
|
+
{
|
|
293
|
+
"useSubagents": true,
|
|
294
|
+
"enabledSubagentIds": ["code-reviewer", "security-auditor", "doc-generator"],
|
|
295
|
+
"toolApprovals": {
|
|
296
|
+
"subagents---run_task": "always"
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
### General Purpose Agent (Uses All Subagents)
|
|
302
|
+
```json
|
|
303
|
+
{
|
|
304
|
+
"useSubagents": true,
|
|
305
|
+
"toolApprovals": {
|
|
306
|
+
"subagents---run_task": "always"
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
## Integration Notes
|
|
312
|
+
|
|
313
|
+
- Nested subagents are disabled by default (a subagent cannot use its own subagents)
|
|
314
|
+
- Todo tools are disabled for subagents (`useTodoTools: false` in subagent runtime config)
|
|
315
|
+
- Context messages are collected from both `contextMessages` and `currentMessages`
|
|
316
|
+
- When context is passed, an enhanced prompt is added: "Make sure to reuse previous conversation if possible."
|
|
317
|
+
- Subagent runs with its own abort controller; parent abort cascades to subagent
|