@nomad-e/bluma-cli 0.1.39 → 0.1.41

package/dist/config/native_tools.json

@@ -70,6 +70,122 @@
         }
       }
     },
+    {
+      "type": "function",
+      "function": {
+        "name": "file_write",
+        "description": "Writes full file contents directly into the workspace. Use this when creating a new file or replacing an entire file body is cleaner than edit_tool. In sandbox mode this is ideal for generated outputs, configs, and artifact staging.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "filepath": {
+              "type": "string",
+              "description": "Absolute or relative path to the file inside the current workspace."
+            },
+            "content": {
+              "type": "string",
+              "description": "Full file content to write."
+            },
+            "overwrite": {
+              "type": "boolean",
+              "description": "Whether an existing file may be overwritten. Defaults to true.",
+              "default": true
+            },
+            "create_directories": {
+              "type": "boolean",
+              "description": "Create missing parent directories before writing. Defaults to true.",
+              "default": true
+            }
+          },
+          "required": [
+            "filepath",
+            "content"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "spawn_agent",
+        "description": "Spawns a background worker agent for a bounded subtask. Use this when work can run in parallel or should be delegated. The returned session_id can be used with wait_agent or list_agents.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "task": {
+              "type": "string",
+              "description": "Concrete task for the worker agent to execute."
+            },
+            "title": {
+              "type": "string",
+              "description": "Optional short title for the worker session."
+            },
+            "agent_type": {
+              "type": "string",
+              "description": "Optional worker role label such as worker, verifier, or planner.",
+              "default": "worker"
+            },
+            "context": {
+              "type": "object",
+              "description": "Optional structured context to pass to the worker."
+            }
+          },
+          "required": [
+            "task"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "wait_agent",
+        "description": "Waits for a worker agent session to finish and returns its latest result event. Use this after spawn_agent when the next step depends on the worker output.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "session_id": {
+              "type": "string",
+              "description": "Worker session id returned by spawn_agent."
+            },
+            "timeout_ms": {
+              "type": "integer",
+              "description": "Maximum time to wait before returning without completion.",
+              "default": 30000
+            },
+            "poll_interval_ms": {
+              "type": "integer",
+              "description": "Polling interval for checking worker completion.",
+              "default": 1000
+            }
+          },
+          "required": [
+            "session_id"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "list_agents",
+        "description": "Lists known agent and worker sessions. Use this to inspect active or completed delegated work.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "parent_session_id": {
+              "type": "string",
+              "description": "Optional parent session id to filter child workers."
+            },
+            "status": {
+              "type": "string",
+              "description": "Optional status filter such as running, completed, error, or cancelled."
+            }
+          },
+          "required": []
+        }
+      }
+    },
     {
       "type": "function",
       "function": {
@@ -507,6 +623,29 @@
         }
       }
     },
+    {
+      "type": "function",
+      "function": {
+        "name": "web_fetch",
+        "description": "Fetch the contents of a remote URL and return cleaned text for analysis. Use this when you already know the exact page to inspect and want the content itself, not just search results.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "url": {
+              "type": "string",
+              "description": "HTTP or HTTPS URL to fetch."
+            },
+            "max_chars": {
+              "type": "integer",
+              "description": "Optional response truncation limit in characters. Defaults to 12000."
+            }
+          },
+          "required": [
+            "url"
+          ]
+        }
+      }
+    },
     {
       "type": "function",
       "function": {
@@ -607,4 +746,4 @@
       }
     }
   ]
-}
+}

package/dist/config/skills/xlsx/SKILL.md

@@ -5,10 +5,12 @@ description: >
   Triggers: open, read, edit, create, fix, or convert .xlsx, .xlsm, .csv,
   or .tsv files — including adding columns, computing formulas, formatting,
   charting, cleaning messy data, restructuring tabular data, or building
-  financial models. Also trigger when the user references a spreadsheet by
-  name or path and wants something done to it. The deliverable must be a
-  spreadsheet file. Do NOT trigger when the primary deliverable is a Word
-  document, HTML report, or standalone script.
+  financial models. Prefer normal Excel formulas in cells (visible in the
+  formula bar, human-auditable), not hidden logic or pasted numeric results.
+  Also trigger when the user references a spreadsheet by name or path and
+  wants something done to it. The deliverable must be a spreadsheet file.
+  Do NOT trigger when the primary deliverable is a Word document, HTML
+  report, or standalone script.
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -20,6 +22,28 @@ license: Proprietary. LICENSE.txt has complete terms
 > formula so the spreadsheet stays dynamic. Never compute in Python and
 > paste the result into a cell.
 
+### Human-readable formulas — everything visible in Excel
+
+The workbook must behave like one a **human analyst** would open and audit:
+
+- **Visible in the formula bar:** Any cell that depends on other cells MUST
+  store a real Excel formula (string starting with `=`). When the user
+  selects the cell, they see the formula — not a magic number that was
+  computed offline.
+- **No “black box” outputs:** Do not replace formulas with static values
+  except for true inputs (assumptions, imported facts). Intermediate and
+  final calculated columns = formulas referencing cells/sheets.
+- **Readable structure:** Prefer clear, conventional functions (`SUM`,
+  `AVERAGE`, `IF`, `SUMIF`, `XLOOKUP`/`VLOOKUP`, etc.) and broken-out
+  helper columns over one impenetrable mega-formula, when that makes the
+  model easier to follow — same as a careful human would build.
+- **Auditable trail:** Another person should trace “this total → those
+  lines → those inputs” using only Excel (Show Formulas / following
+  references), without reading Python.
+- **openpyxl:** Assign formulas as strings, e.g. `ws['D2'] = '=B2*C2'`, so
+  they remain formulas in the saved file. Never save a workbook opened with
+  `data_only=True` if you need formulas preserved (see Reading section).
+
 ## Output Quality Standards
 
 ### Professional Appearance
@@ -135,6 +159,16 @@ ws['B10'] = '=SUM(B2:B9)'
 This applies to ALL calculations: totals, averages, percentages,
 growth rates, ratios, conditional aggregations.
 
+### Visibility checklist (model must self-verify)
+
+- Opening the file in Excel/LibreOffice: calculated cells show **formulas**
+  in the formula bar, not only final numbers with no `=`.
+- Totals, subtotals, ratios, and lookups reference **cell addresses** or
+  structured ranges — not constants copied from a script.
+- If the user asked for “Excel they can trust,” err on the side of **more
+  rows/columns with simpler formulas** rather than fewer cells with opaque
+  nested functions.
+
 ### Common Formula Patterns
 
 | Operation | Formula |