@compilr-dev/sdk 0.10.10 → 0.10.11

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.
@@ -53,11 +53,17 @@ export const CAPABILITY_PACKS = {
53
53
  interaction: {
54
54
  id: 'interaction',
55
55
  label: 'User Interaction',
56
- tools: ['ask_user', 'ask_user_simple', 'propose_alternatives', 'suggest'],
56
+ tools: [
57
+ 'ask_user',
58
+ 'ask_user_simple',
59
+ 'propose_alternatives',
60
+ 'suggest',
61
+ 'build_interactive_flow',
62
+ ],
57
63
  readOnly: true,
58
64
  promptModules: [],
59
65
  estimatedPromptTokens: 0,
60
- estimatedToolTokens: 900,
66
+ estimatedToolTokens: 1100,
61
67
  },
62
68
  coordinator: {
63
69
  id: 'coordinator',
@@ -148,13 +148,14 @@ For complex features:
148
148
 
149
149
  - **ask_user_simple**: For single-choice questions (preferred for most interactions)
150
150
  - **ask_user**: For multi-question batches (when gathering related info)
151
+ - **build_interactive_flow**: For decisions with 2+ branching considerations the user benefits from exploring visually (navigable tree with Back/forward; agent receives the full reasoning path back)
151
152
  - **backlog_read**: Use id param to get specific item, use search/filters otherwise
152
153
  - **backlog_write**: Update items after refinement decisions
153
154
  - **todo_write**: Track your progress through refinement
154
155
 
155
156
  ## RULES
156
157
 
157
- 1. ALWAYS use ask_user_simple or ask_user for decisions - NEVER ask questions in plain text
158
+ 1. ALWAYS use ask_user_simple, ask_user, or build_interactive_flow for decisions - NEVER ask questions in plain text
158
159
  2. Keep backlog reads efficient - use filters and limits
159
160
  3. One refinement focus at a time
160
161
  4. Update backlog with backlog_write after each decision
@@ -140,7 +140,7 @@ IMPORTANT: Tool names are lowercase with underscores.
140
140
  - **File operations**: read_file, write_file, edit, glob, grep
141
141
  - **Shell**: bash (use run_in_background=true for long-running), bash_output, kill_shell
142
142
  - **Task management**: todo_write, todo_read
143
- - **User interaction**: ask_user, ask_user_simple, propose_alternatives (present 2-3 options for comparison)
143
+ - **User interaction**: ask_user_simple (single question, small models), ask_user (1-5 questions), propose_alternatives (2-3 options with pros/cons), build_interactive_flow (navigable decision tree — use when a choice has 2+ branching considerations the user benefits from exploring visually with Back/forward)
144
144
  - **Sub-agents**: task (types: explore, code-review, plan, debug, test-runner, refactor, security-audit, general)`,
145
145
  };
146
146
  /**
@@ -46,12 +46,18 @@ export const SKILL_REQUIREMENTS = {
46
46
  // Planning skills
47
47
  planning: {
48
48
  required: ['read_file', 'glob'],
49
- optional: ['ask_user', 'ask_user_simple', 'todo_write'],
49
+ optional: ['ask_user', 'ask_user_simple', 'build_interactive_flow', 'todo_write'],
50
50
  reason: 'Needs to understand codebase to plan effectively',
51
51
  },
52
52
  design: {
53
53
  required: ['ask_user', 'workitem_add'],
54
- optional: ['propose_alternatives', 'detect_project', 'document_save', 'edit'],
54
+ optional: [
55
+ 'propose_alternatives',
56
+ 'build_interactive_flow',
57
+ 'detect_project',
58
+ 'document_save',
59
+ 'edit',
60
+ ],
55
61
  reason: 'Needs to gather requirements and create backlog',
56
62
  },
57
63
  refine: {
@@ -72,7 +78,13 @@ export const SKILL_REQUIREMENTS = {
72
78
  // Documentation skills
73
79
  architecture: {
74
80
  required: ['read_file', 'write_file', 'edit'],
75
- optional: ['backlog_read', 'ask_user', 'propose_alternatives', 'glob'],
81
+ optional: [
82
+ 'backlog_read',
83
+ 'ask_user',
84
+ 'propose_alternatives',
85
+ 'build_interactive_flow',
86
+ 'glob',
87
+ ],
76
88
  reason: 'Creates architecture documents',
77
89
  },
78
90
  prd: {
@@ -22,6 +22,7 @@ const TOOL_NAMES = {
22
22
  ASK_USER: 'ask_user',
23
23
  ASK_USER_SIMPLE: 'ask_user_simple',
24
24
  PROPOSE_ALTERNATIVES: 'propose_alternatives',
25
+ BUILD_INTERACTIVE_FLOW: 'build_interactive_flow',
25
26
  // Delegation
26
27
  DELEGATE: 'delegate',
27
28
  DELEGATE_BACKGROUND: 'delegate_background',
@@ -115,7 +115,7 @@ You are the **Project Manager (PM)** in this multi-agent development team. You s
115
115
 
116
116
  **Direct tools** (call by name):
117
117
  - \`todo_write\`, \`todo_read\` - Task tracking
118
- - \`ask_user\`, \`suggest\` - User interaction
118
+ - \`ask_user_simple\`, \`ask_user\`, \`propose_alternatives\`, \`build_interactive_flow\`, \`suggest\` - User interaction
119
119
  - \`handoff\` - Hand off to another specialist
120
120
 
121
121
  **Specialized tools** (call via \`use_tool\`):
@@ -601,7 +601,7 @@ You are the **Business Analyst** in this multi-agent development team. You trans
601
601
 
602
602
  **Direct tools** (call by name):
603
603
  - \`todo_write\`, \`todo_read\` - Task tracking
604
- - \`ask_user\`, \`suggest\` - User interaction
604
+ - \`ask_user_simple\`, \`ask_user\`, \`propose_alternatives\`, \`build_interactive_flow\`, \`suggest\` - User interaction
605
605
  - \`handoff\` - Hand off to another specialist
606
606
 
607
607
  **Specialized tools** (call via \`use_tool\`):
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@compilr-dev/sdk",
3
- "version": "0.10.10",
3
+ "version": "0.10.11",
4
4
  "description": "Universal agent runtime for building AI-powered applications",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",