machinaos 0.0.1 → 0.0.7

package/server/skills/android-skill/SKILL.md

@@ -13,12 +13,12 @@ This skill provides context for monitoring and controlling Android devices.
 
 ## How It Works
 
-This skill provides instructions and context. To execute Android actions, connect the **Android Toolkit** node to the Chat Agent's `input-tools` handle, then connect Android service nodes to the toolkit:
+This skill provides instructions and context. To execute Android actions, connect the **Android Toolkit** node to the Zeenie's `input-tools` handle, then connect Android service nodes to the toolkit:
 
 ```
 [Battery Monitor] --+
                     |
-[WiFi Automation] --+--> [Android Toolkit] --> [Chat Agent]
+[WiFi Automation] --+--> [Android Toolkit] --> [Zeenie]
                     |
 [Location]       ---+
 ```
@@ -76,7 +76,7 @@ Before using Android tools, ensure:
 
 ## Setup Requirements
 
-1. Connect this skill to Chat Agent's `input-skill` handle
-2. Add **Android Toolkit** node and connect to Chat Agent's `input-tools` handle
+1. Connect this skill to Zeenie's `input-skill` handle
+2. Add **Android Toolkit** node and connect to Zeenie's `input-tools` handle
 3. Connect desired Android service nodes to the Android Toolkit
 4. Ensure Android device is paired (green status indicator)

package/server/skills/code-skill/SKILL.md

@@ -1,140 +1,174 @@
 ---
 name: code-skill
 description: Execute Python or JavaScript code for calculations, data processing, and automation. Use when user needs to run code, do calculations, or process data.
-allowed-tools: code-python code-javascript
+allowed-tools: python_code javascript_code
 metadata:
   author: machina
-  version: "1.0"
+  version: "3.0"
   category: code
 ---
 
 # Code Execution
 
-This skill enables you to execute Python and JavaScript code for various tasks.
+This skill enables you to execute Python and JavaScript code for various tasks using the `python_code` and `javascript_code` tools.
 
-## Capabilities
+## Tool: python_code
 
-- Run Python code with full standard library
-- Execute JavaScript code
-- Perform complex calculations
-- Process and transform data
-- Generate outputs and visualizations
+Execute Python code for calculations, data processing, and automation.
 
-## Tool Reference
+### Parameters
 
-### code-python
-Execute Python code.
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `code` | string | Yes | Python code to execute. Set `output` variable with result. Use `print()` for console output. |
 
-Parameters:
-- `code` (required): Python code to execute
-- `input_data` (optional): Data to pass to the script (available as `input_data` variable)
+### Available Libraries
+- Standard library: `math`, `json`, `datetime`, `timedelta`, `re`, `random`
+- Collections: `Counter`, `defaultdict`
+- All built-in functions
 
-Returns:
-- output: Script output (print statements)
-- result: Return value if any
-- error: Error message if execution failed
+### Variables Available
+- `input_data` - Data from connected workflow nodes (dict)
+- `output` - Set this variable to return a result
 
-### code-javascript
-Execute JavaScript code.
+### Returns
 
-Parameters:
-- `code` (required): JavaScript code to execute
-- `input_data` (optional): Data to pass to the script
+| Field | Type | Description |
+|-------|------|-------------|
+| `success` | boolean | Whether execution succeeded |
+| `result` | any | Value of `output` variable if set |
+| `output` | string | Captured print() statements |
+| `error` | string | Error message if execution failed |
 
-Returns:
-- output: Console output
-- result: Return value
-- error: Error message if execution failed
+### Example Usage
+```python
+# Calculate with data
+data = input_data.get("numbers", [1, 2, 3])
+total = sum(data)
+average = total / len(data)
+print(f"Total: {total}, Average: {average}")
+output = {"total": total, "average": average}
+```
 
-## Python Guidelines
+---
 
-### Available Libraries
-- Standard library (math, json, datetime, re, etc.)
-- Data processing (collections, itertools)
-- String manipulation
+## Tool: javascript_code
 
-### Input Data Access
-```python
-# Access input data from previous nodes
-data = input_data  # Available as global variable
-print(f"Received: {data}")
-```
+Execute JavaScript code for calculations, data processing, and JSON manipulation.
 
-### Output
-```python
-# Print for output display
-print("Hello, World!")
+### Parameters
 
-# Return value for downstream nodes
-result = {"status": "success", "value": 42}
-```
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `code` | string | Yes | JavaScript code to execute. Set `output` variable with result. Use `console.log()` for output. |
 
-## JavaScript Guidelines
+### Variables Available
+- `input_data` - Data from connected workflow nodes (object)
+- `output` - Set this variable to return a result
 
-### Input Data Access
-```javascript
-// Access input data from previous nodes
-const data = input_data;
-console.log(`Received: ${JSON.stringify(data)}`);
-```
+### Returns
 
-### Output
-```javascript
-// Console for output display
-console.log("Hello, World!");
+| Field | Type | Description |
+|-------|------|-------------|
+| `success` | boolean | Whether execution succeeded |
+| `result` | any | Value of `output` variable if set |
+| `output` | string | Captured console.log() statements |
+| `error` | string | Error message if execution failed |
 
-// Return value for downstream nodes
-return { status: "success", value: 42 };
+### Example Usage
+```javascript
+// Process JSON data
+const data = input_data.numbers || [1, 2, 3];
+const total = data.reduce((a, b) => a + b, 0);
+const average = total / data.length;
+console.log(`Total: ${total}, Average: ${average}`);
+output = { total, average };
 ```
 
+---
+
 ## Examples
 
+### Calculate a tip (Python)
 **User**: "Calculate 15% tip on $85.50"
-**Action**: Use code-python with:
-```python
-bill = 85.50
-tip_percent = 15
-tip = bill * (tip_percent / 100)
-total = bill + tip
-print(f"Tip: ${tip:.2f}")
-print(f"Total: ${total:.2f}")
-```
 
-**User**: "Convert this JSON to CSV"
-**Action**: Use code-python with:
-```python
-import json
-import csv
-import io
-
-data = input_data  # JSON from previous node
-output = io.StringIO()
-writer = csv.DictWriter(output, fieldnames=data[0].keys())
-writer.writeheader()
-writer.writerows(data)
-print(output.getvalue())
+**Tool Call** (python_code):
+```json
+{
+  "code": "bill = 85.50\ntip_percent = 15\ntip = bill * (tip_percent / 100)\ntotal = bill + tip\nprint(f\"Tip: ${tip:.2f}\")\nprint(f\"Total: ${total:.2f}\")\noutput = {\"tip\": tip, \"total\": total}"
+}
 ```
 
+### Generate random numbers (Python)
 **User**: "Generate 5 random numbers between 1 and 100"
-**Action**: Use code-python with:
-```python
-import random
-numbers = [random.randint(1, 100) for _ in range(5)]
-print(f"Random numbers: {numbers}")
+
+**Tool Call** (python_code):
+```json
+{
+  "code": "import random\nnumbers = [random.randint(1, 100) for _ in range(5)]\nprint(f\"Random numbers: {numbers}\")\noutput = numbers"
+}
+```
+
+### Process JSON data (JavaScript)
+**User**: "Sum all the values in this object"
+
+**Tool Call** (javascript_code):
+```json
+{
+  "code": "const values = Object.values(input_data);\nconst sum = values.reduce((a, b) => a + b, 0);\nconsole.log(`Sum: ${sum}`);\noutput = sum;"
+}
 ```
 
+### Date calculations (Python)
+**User**: "What date is 30 days from now?"
+
+**Tool Call** (python_code):
+```json
+{
+  "code": "from datetime import datetime, timedelta\ntoday = datetime.now()\nfuture = today + timedelta(days=30)\nresult = future.strftime('%Y-%m-%d')\nprint(f\"30 days from now: {result}\")\noutput = result"
+}
+```
+
+### Array manipulation (JavaScript)
+**User**: "Filter this array to only even numbers"
+
+**Tool Call** (javascript_code):
+```json
+{
+  "code": "const numbers = input_data.numbers || [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];\nconst evens = numbers.filter(n => n % 2 === 0);\nconsole.log(`Even numbers: ${evens}`);\noutput = evens;"
+}
+```
+
+---
+
+## When to Use Each Tool
+
+| Use Case | Recommended Tool |
+|----------|------------------|
+| Math calculations | `python_code` |
+| Date/time operations | `python_code` |
+| Data analysis | `python_code` |
+| Random number generation | `python_code` |
+| JSON manipulation | `javascript_code` |
+| Array operations | Either |
+| String processing | Either |
+
+---
+
 ## Security Guidelines
 
 1. **No file system access** outside designated directories
 2. **No network requests** from code (use http-skill instead)
 3. **No system commands** or shell access
-4. **Limited execution time** (timeout after 30 seconds)
+4. **Limited execution time** (timeout configurable, default 30 seconds)
 5. **No sensitive data** in code outputs
 
 ## Best Practices
 
 1. Keep code simple and focused on one task
 2. Use descriptive variable names
-3. Add comments for complex logic
-4. Validate input data before processing
+3. Always set the `output` variable with your result
+4. Use `print()` / `console.log()` for debugging
 5. Handle potential errors gracefully
+6. Prefer Python for math, dates, and data processing
+7. Prefer JavaScript for JSON manipulation

package/server/skills/maps-skill/SKILL.md

@@ -13,7 +13,7 @@ This skill provides context for location-based capabilities using Google Maps se
 
 ## How It Works
 
-This skill provides instructions and context. To execute location actions, connect the appropriate **tool nodes** to the Chat Agent's `input-tools` handle:
+This skill provides instructions and context. To execute location actions, connect the appropriate **tool nodes** to the Zeenie's `input-tools` handle:
 
 - **Add Locations** node - Geocode addresses to coordinates or reverse geocode
 - **Show Nearby Places** node - Search for nearby places
@@ -165,6 +165,6 @@ When presenting location results:
 
 ## Setup Requirements
 
-1. Connect this skill to Chat Agent's `input-skill` handle
-2. Connect location tool nodes to Chat Agent's `input-tools` handle
+1. Connect this skill to Zeenie's `input-skill` handle
+2. Connect location tool nodes to Zeenie's `input-tools` handle
 3. Ensure Google Maps API key is configured in credentials

package/server/skills/memory-skill/SKILL.md

@@ -140,7 +140,7 @@ User prefers formal language.
 
 ## Integration with SimpleMemory Node
 
-When connected to a Chat Agent:
+When connected to a Zeenie:
 1. Conversation is automatically logged to markdown
 2. Window size limits short-term memory
 3. Overflow archives to vector DB (if long-term enabled)

package/server/skills/web-search-skill/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: web-search-skill
+description: Search the web for current information, news, facts, and real-time data that may not be in your training data.
+allowed-tools: web_search
+metadata:
+  author: machina
+  version: "1.0"
+  category: search
+---
+
+# Web Search Skill
+
+This skill enables you to search the web for current, up-to-date information.
+
+## How It Works
+
+This skill provides instructions and context. To execute web searches, connect the **Web Search Tool** node to the Zeenie's `input-tools` handle.
+
+## web_search Tool
+
+Search the web and get relevant results.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| query | string | Yes | The search query to look up on the web |
+
+### Examples
+
+**Basic search:**
+```json
+{
+  "query": "latest news about artificial intelligence"
+}
+```
+
+**Factual search:**
+```json
+{
+  "query": "population of Tokyo 2024"
+}
+```
+
+**Current events:**
+```json
+{
+  "query": "weather forecast New York today"
+}
+```
+
+**Technical search:**
+```json
+{
+  "query": "how to use Python asyncio gather"
+}
+```
+
+### Response Format
+
+```json
+{
+  "query": "artificial intelligence news",
+  "results": [
+    {
+      "title": "AI Breakthrough in Medical Research",
+      "snippet": "Researchers have developed a new AI model that can predict...",
+      "url": "https://example.com/ai-medical-research"
+    },
+    {
+      "title": "OpenAI Announces New Model",
+      "snippet": "The company revealed its latest advancement in...",
+      "url": "https://example.com/openai-announcement"
+    }
+  ],
+  "provider": "duckduckgo"
+}
+```
+
+## When to Use Web Search
+
+Use web search when the user asks about:
+
+1. **Current events and news** - Recent happenings, breaking news, current affairs
+2. **Real-time data** - Stock prices, weather, sports scores, exchange rates
+3. **Recent information** - Events, releases, or changes after your knowledge cutoff
+4. **Specific facts** - Population, statistics, dates that may have changed
+5. **Technical documentation** - Latest API docs, library versions, tutorials
+6. **Local information** - Business hours, addresses, phone numbers
+7. **Product information** - Prices, availability, reviews
+
+## When NOT to Use Web Search
+
+Avoid searching when:
+
+1. **General knowledge** - Well-established facts that won't change
+2. **Simple calculations** - Use the calculator tool instead
+3. **Creative tasks** - Writing, brainstorming, analysis
+4. **Personal advice** - Relationship, life decisions
+5. **Subjective opinions** - Preferences, recommendations without factual basis
+
+## Search Query Best Practices
+
+### Do:
+- Use specific, focused queries
+- Include relevant keywords
+- Add context like dates, locations, or names
+- Break complex questions into simpler searches
+
+### Don't:
+- Use overly long queries (keep under 10 words when possible)
+- Include unnecessary words like "please" or "can you tell me"
+- Ask questions as full sentences (use keywords instead)
+
+### Examples of Good vs Bad Queries
+
+| Bad Query | Good Query |
+|-----------|------------|
+| "Can you please tell me what the weather is like in London today?" | "London weather today" |
+| "I want to know about the latest iPhone model and its features" | "iPhone 15 Pro specifications" |
+| "What is happening in the stock market right now?" | "stock market news today" |
+
+## Handling Results
+
+1. **Summarize** the key findings from search results
+2. **Cite sources** when providing specific information
+3. **Indicate uncertainty** if results are conflicting or unclear
+4. **Suggest follow-up searches** if the initial results are insufficient
+5. **Combine multiple searches** for comprehensive answers
+
+## Provider Information
+
+The Web Search Tool supports multiple providers:
+
+| Provider | API Key Required | Notes |
+|----------|-----------------|-------|
+| DuckDuckGo | No | Free, privacy-focused, good general results |
+| Serper API | Yes | Google-powered, high quality, requires API key |
+| Google Custom Search | Yes | Direct Google results, requires setup |
+
+The default provider (DuckDuckGo) works without any API key.
+
+## Limitations
+
+- Results depend on the search provider's index
+- Some recent events may not be indexed immediately
+- Paywalled content may show limited snippets
+- Results are in English by default
+
+## Setup Requirements
+
+1. Connect this skill to Zeenie's `input-skill` handle
+2. Connect the Web Search Tool node to Zeenie's `input-tools` handle
+3. (Optional) Configure API key in the tool node for Serper or Google

package/server/skills/whatsapp-skill/SKILL.md

@@ -13,7 +13,7 @@ This skill provides context for WhatsApp messaging capabilities.
 
 ## How It Works
 
-This skill provides instructions and context. To execute WhatsApp actions, connect the appropriate **tool nodes** to the Chat Agent's `input-tools` handle:
+This skill provides instructions and context. To execute WhatsApp actions, connect the appropriate **tool nodes** to the Zeenie's `input-tools` handle:
 
 - **WhatsApp Send** node - Send messages to contacts or groups
 - **WhatsApp DB** node - Query contacts, groups, and chat history
@@ -278,6 +278,6 @@ Check WhatsApp registration status.
 
 ## Setup Requirements
 
-1. Connect this skill to Chat Agent's `input-skill` handle
-2. Connect WhatsApp tool nodes to Chat Agent's `input-tools` handle
+1. Connect this skill to Zeenie's `input-skill` handle
+2. Connect WhatsApp tool nodes to Zeenie's `input-tools` handle
 3. Ensure WhatsApp is connected (green status indicator)