@synergenius/flow-weaver-pack-weaver 0.9.59 → 0.9.77

package/flowweaver.manifest.json

@@ -1,7 +1,7 @@
 {
   "manifestVersion": 2,
   "name": "@synergenius/flow-weaver-pack-weaver",
-  "version": "0.9.59",
+  "version": "0.9.62",
   "description": "AI bot for Flow Weaver. Execute tasks, run workflows, evolve autonomously.",
   "engineVersion": ">=0.22.10",
   "categories": [
@@ -14,7 +14,7 @@
       "name": "Weaver Bot",
       "description": "AI-powered autonomous workflow creator",
       "icon": "psychology",
-      "color": "#6366f1",
+      "color": "color-node-blue-icon",
       "workflowExport": "weaverBot",
       "paramName": "taskJson",
       "sourceTemplateId": "weaver-bot"
@@ -24,7 +24,7 @@
       "name": "Weaver Genesis",
       "description": "Self-evolution cycle for a target workflow",
       "icon": "autoAwesome",
-      "color": "#9f5fe3",
+      "color": "color-node-purple-icon",
       "workflowExport": "genesisTask",
       "paramName": "config",
       "sourceTemplateId": "genesis-task"
@@ -962,46 +962,39 @@
   ],
   "mcpEntrypoint": "dist/mcp-tools.js",
   "mcpTools": [
-    {
-      "name": "fw_weaver_run",
-      "description": "Run a workflow file through the bot"
-    },
-    {
-      "name": "fw_weaver_history",
-      "description": "Query run history"
-    },
-    {
-      "name": "fw_weaver_costs",
-      "description": "Get cost summary"
-    },
-    {
-      "name": "fw_weaver_providers",
-      "description": "List available providers"
-    },
-    {
-      "name": "fw_weaver_bot",
-      "description": "Execute a task from natural language"
-    },
-    {
-      "name": "fw_weaver_steer",
-      "description": "Send steering command to running bot"
-    },
-    {
-      "name": "fw_weaver_queue",
-      "description": "Manage bot task queue"
-    },
-    {
-      "name": "fw_weaver_status",
-      "description": "Get bot session status"
-    },
-    {
-      "name": "fw_weaver_genesis",
-      "description": "Run bot self-evolution cycle on a target workflow"
-    },
-    {
-      "name": "fw_weaver_insights",
-      "description": "Get project health, insights, trust level, and cost summary"
-    }
+    { "name": "fw_weaver_run", "description": "Execute a workflow with the AI runner" },
+    { "name": "fw_weaver_history", "description": "Query run history" },
+    { "name": "fw_weaver_costs", "description": "Get AI cost summary" },
+    { "name": "fw_weaver_task_create", "description": "Create a task in the swarm pool" },
+    { "name": "fw_weaver_task_list", "description": "List tasks with optional filters" },
+    { "name": "fw_weaver_task_get", "description": "Get full details for a task" },
+    { "name": "fw_weaver_task_update", "description": "Update a task" },
+    { "name": "fw_weaver_task_cancel", "description": "Cancel a pending or running task" },
+    { "name": "fw_weaver_task_retry", "description": "Retry a failed or cancelled task" },
+    { "name": "fw_weaver_swarm_start", "description": "Start the swarm controller" },
+    { "name": "fw_weaver_swarm_pause", "description": "Pause the swarm" },
+    { "name": "fw_weaver_swarm_stop", "description": "Stop the swarm" },
+    { "name": "fw_weaver_swarm_status", "description": "Get current swarm status" },
+    { "name": "fw_weaver_swarm_config", "description": "View or update swarm configuration" },
+    { "name": "fw_weaver_swarm_events", "description": "Read swarm event log" },
+    { "name": "fw_weaver_providers", "description": "List available AI providers" },
+    { "name": "fw_weaver_steer", "description": "Send steering command to running bot" },
+    { "name": "fw_weaver_status", "description": "Get bot session status" },
+    { "name": "fw_weaver_events", "description": "Read live execution events from a bot task" },
+    { "name": "fw_weaver_approve", "description": "Approve or reject a pending bot plan" },
+    { "name": "fw_weaver_genesis", "description": "Run bot self-evolution cycle on a target workflow" },
+    { "name": "fw_weaver_insights", "description": "Get project health, insights, trust level, and cost summary" },
+    { "name": "fw_weaver_list_bots", "description": "List all registered bots" },
+    { "name": "fw_weaver_register_bot", "description": "Register a new bot workflow" },
+    { "name": "fw_weaver_unregister_bot", "description": "Remove a bot from the registry" },
+    { "name": "fw_weaver_validate_bot", "description": "Validate a registered bot's workflow" },
+    { "name": "fw_weaver_eject_bot", "description": "Eject a bot for customization" },
+    { "name": "fw_weaver_profile_list", "description": "List all bot profiles" },
+    { "name": "fw_weaver_profile_create", "description": "Create a new bot profile" },
+    { "name": "fw_weaver_profile_update", "description": "Update a bot profile" },
+    { "name": "fw_weaver_profile_delete", "description": "Delete a bot profile" },
+    { "name": "fw_weaver_orchestrator_status", "description": "Get orchestrator routing status" },
+    { "name": "fw_weaver_orchestrator_hint", "description": "Provide a routing hint to the orchestrator" }
   ],
   "eventSubscriptions": [
     {
@@ -1078,7 +1071,7 @@
     "config": "dist/ui/bot-config.js",
     "status": "dist/ui/bot-status.js",
     "dashboard": "dist/ui/bot-dashboard.js",
-    "workspace": "dist/ui/bot-workspace.js"
+    "workspace": "dist/ui/swarm-dashboard.js"
   },
   "sidebarPanel": {
     "component": "dist/ui/bot-panel.js",
@@ -1089,7 +1082,7 @@
     "activityBarSection": "start",
     "requiredTier": "pro"
   },
-  "openWorkspaceOnTool": "fw_weaver_bot",
+  "openWorkspaceOnTool": "fw_weaver_task_create",
   "sandboxCapabilities": [
     "fetch:hooks.slack.com",
     "fetch:discord.com",
@@ -1131,7 +1124,7 @@
       "description": "Hands-on AI assistant for Flow Weaver projects. Builds, validates, debugs, and manages workflows. Spawns autonomous bots for long-running tasks."
     },
     "toolResultRenderers": {
-      "fw_weaver_bot": "dist/ui/chat-bot-result.js"
+      "fw_weaver_task_create": "dist/ui/chat-task-result.js"
     },
     "tools": [
       {
@@ -1172,6 +1165,14 @@
               "type": "string",
               "description": "Specific run ID to look up"
             },
+            "taskId": {
+              "type": "string",
+              "description": "Filter by task ID"
+            },
+            "botId": {
+              "type": "string",
+              "description": "Filter by bot ID"
+            },
             "limit": {
               "type": "number",
               "description": "Max number of entries (default 20)"
@@ -1206,122 +1207,363 @@
             "model": {
               "type": "string",
               "description": "Filter by model name"
+            },
+            "taskId": {
+              "type": "string",
+              "description": "Filter by task ID"
+            },
+            "botId": {
+              "type": "string",
+              "description": "Filter by bot ID"
             }
           }
         }
       },
       {
-        "name": "fw_weaver_providers",
-        "description": "List available AI providers for weaver workflow execution.",
+        "name": "fw_weaver_task_create",
+        "description": "Create a new task in the swarm task pool. Supports subtask hierarchies, bot assignment, dependencies, and budget limits.",
         "parameters": {
           "type": "object",
-          "properties": {}
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Short title for the task"
+            },
+            "description": {
+              "type": "string",
+              "description": "Detailed task description with instructions"
+            },
+            "priority": {
+              "type": "number",
+              "description": "Priority (higher = picked first, default 0)"
+            },
+            "parentId": {
+              "type": "string",
+              "description": "Parent task ID for subtask hierarchy"
+            },
+            "dependsOn": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Task IDs that must complete before this task can start"
+            },
+            "budgetTokens": {
+              "type": "number",
+              "description": "Max tokens for this task"
+            },
+            "budgetCost": {
+              "type": "number",
+              "description": "Max cost in USD for this task"
+            },
+            "timeoutMs": {
+              "type": "number",
+              "description": "Timeout in milliseconds"
+            },
+            "maxAttempts": {
+              "type": "number",
+              "description": "Max retry attempts"
+            },
+            "assignedProfile": {
+              "type": "string",
+              "description": "Profile ID to assign this task to"
+            },
+            "complexity": {
+              "type": "string",
+              "enum": ["trivial", "simple", "moderate", "complex"],
+              "description": "Task complexity estimate for routing"
+            },
+            "subtasks": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "type": "string",
+                    "description": "Subtask title"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Subtask description"
+                  },
+                  "dependsOn": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Sibling subtask indices (0-based) this depends on"
+                  },
+                  "priority": {
+                    "type": "number",
+                    "description": "Subtask priority"
+                  },
+                  "assignedProfile": {
+                    "type": "string",
+                    "description": "Profile ID to assign this subtask to"
+                  },
+                  "complexity": {
+                    "type": "string",
+                    "enum": ["trivial", "simple", "moderate", "complex"],
+                    "description": "Subtask complexity estimate"
+                  }
+                },
+                "required": [
+                  "title"
+                ]
+              },
+              "description": "Inline subtask definitions created atomically with the parent"
+            }
+          },
+          "required": [
+            "title"
+          ]
         }
       },
       {
-        "name": "fw_weaver_bot",
-        "description": "Run the autonomous bot to create or modify a Flow Weaver workflow. Provide a natural language task description.",
+        "name": "fw_weaver_task_list",
+        "description": "List tasks in the swarm task pool with optional filters by status, parent, or bot assignment.",
         "parameters": {
           "type": "object",
           "properties": {
-            "task": {
+            "status": {
               "type": "string",
-              "description": "Natural language task description"
+              "description": "Filter by task status (pending, running, completed, failed, cancelled)"
+            },
+            "parentId": {
+              "type": "string",
+              "description": "Filter by parent task ID"
             },
             "botId": {
               "type": "string",
-              "description": "ID of a registered bot to run. If omitted, runs the default Weaver Bot."
+              "description": "Filter by assigned bot ID"
             },
-            "projectDir": {
+            "limit": {
+              "type": "number",
+              "description": "Max number of tasks to return (default 50)"
+            }
+          }
+        }
+      },
+      {
+        "name": "fw_weaver_task_get",
+        "description": "Get full details for a specific task including context, subtasks, and run history.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "id": {
               "type": "string",
-              "description": "Project directory"
+              "description": "Task ID"
             },
-            "mode": {
+            "includeAllRuns": {
+              "type": "boolean",
+              "description": "Include full run history (default false, only latest run)"
+            }
+          },
+          "required": [
+            "id"
+          ]
+        }
+      },
+      {
+        "name": "fw_weaver_task_update",
+        "description": "Update a task's title, description, priority, assignment, notes, or status.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "id": {
               "type": "string",
-              "enum": [
-                "create",
-                "modify",
-                "read",
-                "batch"
-              ],
-              "description": "Task mode"
+              "description": "Task ID to update"
             },
-            "targets": {
-              "type": "array",
-              "description": "Target files for modify/read"
+            "title": {
+              "type": "string",
+              "description": "New title"
             },
-            "template": {
+            "description": {
               "type": "string",
-              "description": "Template to use for scaffolding"
+              "description": "New description"
             },
-            "dryRun": {
-              "type": "boolean",
-              "description": "Preview without executing"
+            "priority": {
+              "type": "number",
+              "description": "New priority"
             },
-            "autoApprove": {
-              "type": "boolean",
-              "description": "Skip approval gate"
+            "notes": {
+              "type": "string",
+              "description": "Append a note to the task"
+            },
+            "status": {
+              "type": "string",
+              "description": "Force a status change (pending, cancelled)"
             }
           },
           "required": [
-            "task"
+            "id"
           ]
         }
       },
       {
-        "name": "fw_weaver_steer",
-        "description": "Send a steering command to a running bot (pause, resume, cancel, redirect, queue).",
+        "name": "fw_weaver_task_cancel",
+        "description": "Cancel a pending or running task. Running tasks are aborted gracefully.",
         "parameters": {
           "type": "object",
           "properties": {
-            "command": {
+            "id": {
               "type": "string",
-              "enum": [
-                "pause",
-                "resume",
-                "cancel",
-                "redirect",
-                "queue"
-              ],
-              "description": "Steering command"
-            },
-            "payload": {
+              "description": "Task ID to cancel"
+            }
+          },
+          "required": [
+            "id"
+          ]
+        }
+      },
+      {
+        "name": "fw_weaver_task_retry",
+        "description": "Retry a failed or cancelled task. Resets status to pending and increments attempt count.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "id": {
               "type": "string",
-              "description": "Payload for redirect/queue commands"
+              "description": "Task ID to retry"
             }
           },
           "required": [
-            "command"
+            "id"
           ]
         }
       },
       {
-        "name": "fw_weaver_queue",
-        "description": "Manage the bot task queue (add, list, clear, remove tasks).",
+        "name": "fw_weaver_swarm_start",
+        "description": "Start the swarm controller. Bots begin claiming and executing tasks from the pool.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "maxConcurrent": {
+              "type": "number",
+              "description": "Max concurrent bot slots (default from config)"
+            },
+            "sessionBudgetTokens": {
+              "type": "number",
+              "description": "Token budget for this session"
+            },
+            "sessionBudgetCost": {
+              "type": "number",
+              "description": "Cost budget in USD for this session"
+            }
+          }
+        }
+      },
+      {
+        "name": "fw_weaver_swarm_pause",
+        "description": "Pause the swarm. Running tasks finish but no new tasks are claimed.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_swarm_stop",
+        "description": "Stop the swarm. All running tasks are cancelled and bot slots are released.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_swarm_status",
+        "description": "Get current swarm status: state, active bots, task counts, budget consumption.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_swarm_config",
+        "description": "View or update swarm configuration: concurrency, budgets, retry policy.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "maxConcurrent": {
+              "type": "number",
+              "description": "Max concurrent bot slots"
+            },
+            "workspaceBudgetTokens": {
+              "type": "number",
+              "description": "Workspace-level token budget"
+            },
+            "workspaceBudgetCost": {
+              "type": "number",
+              "description": "Workspace-level cost budget in USD"
+            },
+            "sessionBudgetTokens": {
+              "type": "number",
+              "description": "Session-level token budget"
+            },
+            "sessionBudgetCost": {
+              "type": "number",
+              "description": "Session-level cost budget in USD"
+            },
+            "autoRetry": {
+              "type": "boolean",
+              "description": "Auto-retry failed tasks"
+            },
+            "maxAttemptsDefault": {
+              "type": "number",
+              "description": "Default max attempts for tasks"
+            }
+          }
+        }
+      },
+      {
+        "name": "fw_weaver_swarm_events",
+        "description": "Read swarm event log for live dashboard updates. Returns events from the given offset.",
         "parameters": {
           "type": "object",
           "properties": {
-            "action": {
+            "offset": {
+              "type": "number",
+              "description": "Event offset to read from (default 0)"
+            }
+          }
+        }
+      },
+      {
+        "name": "fw_weaver_providers",
+        "description": "List available AI providers for weaver workflow execution.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_steer",
+        "description": "Send a steering command to a running bot (pause, resume, cancel, redirect, queue).",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "botId": {
               "type": "string",
-              "enum": [
-                "add",
-                "list",
-                "clear",
-                "remove"
-              ],
-              "description": "Queue action"
+              "description": "ID of the bot to steer"
             },
-            "task": {
+            "command": {
               "type": "string",
-              "description": "Task instruction (for add)"
+              "enum": [
+                "pause",
+                "resume",
+                "cancel",
+                "redirect",
+                "queue"
+              ],
+              "description": "Steering command"
             },
-            "id": {
+            "payload": {
               "type": "string",
-              "description": "Task ID (for remove)"
+              "description": "Payload for redirect/queue commands"
             }
           },
           "required": [
-            "action"
+            "botId",
+            "command"
           ]
         }
       },
@@ -1341,7 +1583,7 @@
           "properties": {
             "runId": {
               "type": "string",
-              "description": "Run ID returned by fw_weaver_bot"
+              "description": "Run ID from task execution"
             },
             "offset": {
               "type": "number",
@@ -1373,31 +1615,6 @@
           ]
         }
       },
-      {
-        "name": "fw_weaver_session",
-        "description": "Start, stop, or check status of an autonomous bot session",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "action": {
-              "type": "string",
-              "enum": [
-                "start",
-                "stop",
-                "status"
-              ],
-              "description": "Session action"
-            },
-            "maxTasks": {
-              "type": "number",
-              "description": "Max tasks to process (default: all)"
-            }
-          },
-          "required": [
-            "action"
-          ]
-        }
-      },
       {
         "name": "fw_weaver_genesis",
         "description": "Run a single Genesis self-evolution cycle on a target workflow.",
@@ -1541,6 +1758,197 @@
             "filePath"
           ]
         }
+      },
+      {
+        "name": "fw_weaver_profile_list",
+        "description": "List all bot profiles with capabilities, instances, and routing stats.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_profile_create",
+        "description": "Create a new bot profile with capabilities and scaling config.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Profile display name"
+            },
+            "botId": {
+              "type": "string",
+              "description": "Bot registration ID to use"
+            },
+            "capabilities": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": { "type": "string", "description": "Capability name (e.g. 'react-ui', 'api-testing')" },
+                  "description": { "type": "string", "description": "What this capability means" }
+                },
+                "required": ["name", "description"]
+              },
+              "description": "Free-form capabilities with descriptions for AI-powered routing"
+            },
+            "costStrategy": {
+              "type": "string",
+              "enum": ["frugal", "balanced", "performance"],
+              "description": "Cost approach: frugal (cheapest models), balanced, performance (best models)"
+            },
+            "maxCostPerRun": {
+              "type": "number",
+              "description": "Hard cost cap per run (USD)"
+            },
+            "maxCostPerTask": {
+              "type": "number",
+              "description": "Hard cost cap per task across retries (USD)"
+            },
+            "requireApproval": {
+              "type": "boolean",
+              "description": "Require human approval before execution"
+            },
+            "instructions": {
+              "type": "string",
+              "description": "Free-form instructions for the bot (e.g. 'prefer fast models, always run tests')"
+            },
+            "maxInstances": {
+              "type": "number",
+              "description": "Max concurrent instances"
+            },
+            "description": {
+              "type": "string",
+              "description": "Profile description"
+            },
+            "icon": {
+              "type": "string",
+              "description": "Material icon name"
+            },
+            "color": {
+              "type": "string",
+              "description": "Color token or hex color"
+            }
+          },
+          "required": [
+            "name",
+            "botId"
+          ]
+        }
+      },
+      {
+        "name": "fw_weaver_profile_update",
+        "description": "Update a bot profile's configuration.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Profile ID"
+            },
+            "name": {
+              "type": "string",
+              "description": "New display name"
+            },
+            "capabilities": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": { "type": "string", "description": "Capability name (e.g. 'react-ui', 'api-testing')" },
+                  "description": { "type": "string", "description": "What this capability means" }
+                },
+                "required": ["name", "description"]
+              },
+              "description": "Free-form capabilities with descriptions for AI-powered routing"
+            },
+            "costStrategy": {
+              "type": "string",
+              "enum": ["frugal", "balanced", "performance"],
+              "description": "Cost approach: frugal (cheapest models), balanced, performance (best models)"
+            },
+            "maxCostPerRun": {
+              "type": "number",
+              "description": "Hard cost cap per run (USD)"
+            },
+            "maxCostPerTask": {
+              "type": "number",
+              "description": "Hard cost cap per task across retries (USD)"
+            },
+            "requireApproval": {
+              "type": "boolean",
+              "description": "Require human approval before execution"
+            },
+            "instructions": {
+              "type": "string",
+              "description": "Free-form instructions for the bot (e.g. 'prefer fast models, always run tests')"
+            },
+            "maxInstances": {
+              "type": "number",
+              "description": "Max concurrent instances"
+            },
+            "minInstances": {
+              "type": "number",
+              "description": "Min instances (0 = scale to zero)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Profile description"
+            },
+            "icon": {
+              "type": "string",
+              "description": "Material icon name"
+            },
+            "color": {
+              "type": "string",
+              "description": "Color token or hex color"
+            }
+          },
+          "required": [
+            "id"
+          ]
+        }
+      },
+      {
+        "name": "fw_weaver_profile_delete",
+        "description": "Delete a bot profile.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Profile ID to delete"
+            }
+          },
+          "required": [
+            "id"
+          ]
+        }
+      },
+      {
+        "name": "fw_weaver_orchestrator_status",
+        "description": "Get orchestrator routing status — recent decisions, stats, active instances.",
+        "parameters": {
+          "type": "object",
+          "properties": {}
+        }
+      },
+      {
+        "name": "fw_weaver_orchestrator_hint",
+        "description": "Provide a routing hint to influence orchestrator decisions.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "hint": {
+              "type": "string",
+              "description": "Routing hint text (e.g. 'assign deploy tasks to deploy-bot')"
+            }
+          },
+          "required": [
+            "hint"
+          ]
+        }
       }
     ],
     "docTopics": [
@@ -1553,7 +1961,13 @@
           "task",
           "run bot",
           "spawn bot",
-          "weaver bot"
+          "weaver bot",
+          "profile",
+          "orchestrator",
+          "routing",
+          "capabilities",
+          "instances",
+          "swarm"
         ],
         "contentFile": "dist/docs/weaver-bot-usage.md"
       },