@aiderdesk/aiderdesk 0.73.0 → 0.74.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.
Files changed (75) hide show
  1. package/out/renderer/assets/{AgentSettings-B8NFKgLb.js → AgentSettings-B-793Wr6.js} +4561 -3203
  2. package/out/renderer/assets/{InfoIcon-DhMP8XnB.js → InfoIcon-cuLXzJtV.js} +1 -1
  3. package/out/renderer/assets/{Onboarding-CmlEw4fh.js → Onboarding-xrPWRnXm.js} +4 -4
  4. package/out/renderer/assets/{ProviderHeader-DMNcKpGs.js → ProviderHeader-CMVyqpPa.js} +145 -2
  5. package/out/renderer/assets/{SettingsPage-CmOR4wA1.js → SettingsPage-BBtDhv80.js} +13 -7
  6. package/out/renderer/assets/{UsageDashboard-BGAWd1b2.js → UsageDashboard-CGI4iwCD.js} +3 -3
  7. package/out/renderer/assets/{arc-Jg3VSYdu.js → arc-CFENq1wJ.js} +1 -1
  8. package/out/renderer/assets/{architectureDiagram-3BPJPVTR-BhT1Ad0h.js → architectureDiagram-3BPJPVTR-BRG_9Mao.js} +3 -3
  9. package/out/renderer/assets/{blockDiagram-GPEHLZMM-BZuMX6U_.js → blockDiagram-GPEHLZMM-B3c7WMY4.js} +4 -4
  10. package/out/renderer/assets/{c4Diagram-AAUBKEIU-QL7T5rpZ.js → c4Diagram-AAUBKEIU-BYQrxMcW.js} +2 -2
  11. package/out/renderer/assets/{channel-K2W31OE5.js → channel-DPxL1rpa.js} +1 -1
  12. package/out/renderer/assets/{chunk-2J33WTMH-LumY2cbE.js → chunk-2J33WTMH-C-kk05Nj.js} +1 -1
  13. package/out/renderer/assets/{chunk-4BX2VUAB-GLhRzKG1.js → chunk-4BX2VUAB-BV8PWxnG.js} +1 -1
  14. package/out/renderer/assets/{chunk-55IACEB6-B3B3AcnH.js → chunk-55IACEB6-Cj6KHkUp.js} +1 -1
  15. package/out/renderer/assets/{chunk-727SXJPM-DMyZUEKf.js → chunk-727SXJPM-BaIkuSPr.js} +5 -5
  16. package/out/renderer/assets/{chunk-AQP2D5EJ-CQsD5TCd.js → chunk-AQP2D5EJ-DVZR_bfB.js} +3 -3
  17. package/out/renderer/assets/{chunk-FMBD7UC4-x4SmU5Oe.js → chunk-FMBD7UC4-CNrb2a0a.js} +1 -1
  18. package/out/renderer/assets/{chunk-ND2GUHAM-pT6s9nFT.js → chunk-ND2GUHAM-ClOnPDjy.js} +1 -1
  19. package/out/renderer/assets/{chunk-QZHKN3VN-Cv8umQxL.js → chunk-QZHKN3VN-B2sJx9j2.js} +1 -1
  20. package/out/renderer/assets/{classDiagram-4FO5ZUOK-DmOcXaER.js → classDiagram-4FO5ZUOK-ZzwWMcLO.js} +6 -6
  21. package/out/renderer/assets/{classDiagram-v2-Q7XG4LA2-DmOcXaER.js → classDiagram-v2-Q7XG4LA2-ZzwWMcLO.js} +6 -6
  22. package/out/renderer/assets/{cose-bilkent-S5V4N54A-Bi6ESdxa.js → cose-bilkent-S5V4N54A-DBx-UiMU.js} +1 -1
  23. package/out/renderer/assets/{dagre-BM42HDAG-BK2slT53.js → dagre-BM42HDAG-B_vMvYpz.js} +3 -3
  24. package/out/renderer/assets/{diagram-2AECGRRQ-DkgLH6e2.js → diagram-2AECGRRQ-Do-w2xXO.js} +3 -3
  25. package/out/renderer/assets/{diagram-5GNKFQAL-BwAieVd0.js → diagram-5GNKFQAL-JzG77sgb.js} +4 -4
  26. package/out/renderer/assets/{diagram-KO2AKTUF-D6Km_LB9.js → diagram-KO2AKTUF-CGMx2nPP.js} +3 -3
  27. package/out/renderer/assets/{diagram-LMA3HP47-BhWSHEeO.js → diagram-LMA3HP47-BqXnQeNu.js} +3 -3
  28. package/out/renderer/assets/{diagram-OG6HWLK6-zoN4RvNr.js → diagram-OG6HWLK6-BR4e0lIb.js} +4 -4
  29. package/out/renderer/assets/{erDiagram-TEJ5UH35-DooZS_mc.js → erDiagram-TEJ5UH35-B7QK0XSy.js} +4 -4
  30. package/out/renderer/assets/{flowDiagram-I6XJVG4X-CmZPvaDJ.js → flowDiagram-I6XJVG4X-BOySqejA.js} +6 -6
  31. package/out/renderer/assets/{ganttDiagram-6RSMTGT7-Bx6OJzRM.js → ganttDiagram-6RSMTGT7-BORAleML.js} +3 -3
  32. package/out/renderer/assets/{gitGraphDiagram-PVQCEYII-BPUT8Ht7.js → gitGraphDiagram-PVQCEYII-DTReLiJT.js} +4 -4
  33. package/out/renderer/assets/{graph-CwC0h_b8.js → graph-Bf8U9r0n.js} +1 -1
  34. package/out/renderer/assets/{index-Ds5GQdTm.js → index-5i67azF0.js} +1 -1
  35. package/out/renderer/assets/{index-B3o44aT2.css → index-7NwOg_q_.css} +8 -16
  36. package/out/renderer/assets/{index-CXq4cCbe.js → index-BOQBc3Qj.js} +4 -3
  37. package/out/renderer/assets/{index-DOOlJc12.js → index-BS5vy5uH.js} +1 -1
  38. package/out/renderer/assets/{index-BrZFlbuf.js → index-COyr1I0o.js} +1 -1
  39. package/out/renderer/assets/{index-ChKmR4QP.js → index-CmQY2QKE.js} +1 -1
  40. package/out/renderer/assets/{index-PGLvyST0.js → index-D3R9tjiT.js} +1 -1
  41. package/out/renderer/assets/{index-DqiktxfT.js → index-D6b3rMtW.js} +1 -1
  42. package/out/renderer/assets/{index-BSFaA4XQ.js → index-DUoUqcJ_.js} +1 -1
  43. package/out/renderer/assets/{index-CI0IUNzz.js → index-Dq3ldCAy.js} +1022 -821
  44. package/out/renderer/assets/{index-xI0MsLE8.js → index-Dtxgil7l.js} +1 -1
  45. package/out/renderer/assets/{infoDiagram-5YYISTIA-C77gIx1a.js → infoDiagram-5YYISTIA-Ryv-Emth.js} +2 -2
  46. package/out/renderer/assets/{ishikawaDiagram-YF4QCWOH-DZ8xk7_N.js → ishikawaDiagram-YF4QCWOH-Blzp6JLN.js} +1 -1
  47. package/out/renderer/assets/{journeyDiagram-JHISSGLW-BLPdv_c5.js → journeyDiagram-JHISSGLW--KB4ASET.js} +4 -4
  48. package/out/renderer/assets/{jsx-dev-runtime-1M6DZ35g.js → jsx-dev-runtime-DAzw_Red.js} +1 -1
  49. package/out/renderer/assets/{kanban-definition-UN3LZRKU-CMHVN7c3.js → kanban-definition-UN3LZRKU-BzNpCu_x.js} +2 -2
  50. package/out/renderer/assets/{layout-BJqshyQm.js → layout-BQu4M-KW.js} +2 -2
  51. package/out/renderer/assets/{linear-CbEhS1qE.js → linear-DNZEF2Al.js} +1 -1
  52. package/out/renderer/assets/{mindmap-definition-RKZ34NQL-C8Cz7pQU.js → mindmap-definition-RKZ34NQL-CxQjZIps.js} +3 -3
  53. package/out/renderer/assets/{pieDiagram-4H26LBE5-Bx5tSw6i.js → pieDiagram-4H26LBE5-qJt7eGwM.js} +4 -4
  54. package/out/renderer/assets/{quadrantDiagram-W4KKPZXB-CX6DcDEk.js → quadrantDiagram-W4KKPZXB-mMOhLjN_.js} +2 -2
  55. package/out/renderer/assets/{requirementDiagram-4Y6WPE33-qBp8nKy9.js → requirementDiagram-4Y6WPE33-GLhMtLW7.js} +3 -3
  56. package/out/renderer/assets/{sankeyDiagram-5OEKKPKP-B5zYIsBo.js → sankeyDiagram-5OEKKPKP-Kcd8qR8y.js} +1 -1
  57. package/out/renderer/assets/{sequenceDiagram-3UESZ5HK-C57DtTdH.js → sequenceDiagram-3UESZ5HK-CpmBIgMJ.js} +3 -3
  58. package/out/renderer/assets/{stateDiagram-AJRCARHV-CGRyr6CG.js → stateDiagram-AJRCARHV-D00qZ9cQ.js} +6 -6
  59. package/out/renderer/assets/{stateDiagram-v2-BHNVJYJU-3hvBe5lv.js → stateDiagram-v2-BHNVJYJU-CkEgNJrB.js} +4 -4
  60. package/out/renderer/assets/{time-B3bXse3U.js → time-CQSoUo1N.js} +1 -1
  61. package/out/renderer/assets/{timeline-definition-PNZ67QCA-Dpq0iPd0.js → timeline-definition-PNZ67QCA-CmydTbH6.js} +2 -2
  62. package/out/renderer/assets/{vennDiagram-CIIHVFJN-_jSNuVb5.js → vennDiagram-CIIHVFJN-B4QGhnvI.js} +1 -1
  63. package/out/renderer/assets/{wardley-L42UT6IY-DixmVaQZ.js → wardley-L42UT6IY-B-mpW52K.js} +1 -1
  64. package/out/renderer/assets/{wardleyDiagram-YWT4CUSO-DMK4zc32.js → wardleyDiagram-YWT4CUSO-Cz1pK1MY.js} +3 -3
  65. package/out/renderer/assets/{xychartDiagram-2RQKCTM6-DKPuWmAF.js → xychartDiagram-2RQKCTM6-H-Q9Zv48.js} +2 -2
  66. package/out/renderer/index.html +2 -2
  67. package/out/resources/skills/agent-creator/SKILL.md +223 -0
  68. package/out/resources/skills/agent-creator/assets/examples/sample-profile.json +47 -0
  69. package/out/resources/skills/agent-creator/assets/templates/config.json.template +47 -0
  70. package/out/resources/skills/agent-creator/references/agent-profile-schema.md +294 -0
  71. package/out/resources/skills/agent-creator/references/profile-examples.md +490 -0
  72. package/out/resources/skills/agent-creator/references/subagent-guide.md +317 -0
  73. package/out/resources/skills/agent-creator/references/tool-approval-guide.md +484 -0
  74. package/out/runner.js +10790 -10126
  75. package/package.json +1 -1
@@ -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