machinaos 0.0.21 → 0.0.23

package/server/skills/social_agent/twitter-user-skill/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: twitter-user-skill
+description: Look up Twitter/X user profiles, get authenticated user info, and retrieve followers/following lists.
+allowed-tools: twitter_user
+metadata:
+  author: machina
+  version: "1.0"
+  category: social
+  icon: "👤"
+  color: "#000000"
+---
+
+# Twitter User Tool
+
+Look up user profiles and social connections on Twitter/X.
+
+## How It Works
+
+This skill provides instructions for the **Twitter User** tool node. Connect the **Twitter User** node to an AI Agent's `input-tools` handle to enable user lookups.
+
+## twitter_user Tool
+
+Retrieve user information and social connections.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| operation | string | Yes | Operation type: `me`, `by_username`, `by_id`, `followers`, `following` |
+| username | string | If by_username | Twitter username (without @) |
+| user_id | string | If by_id/followers/following | Twitter user ID |
+| max_results | integer | No | For followers/following (default: 100, max: 1000) |
+
+### Operations
+
+| Operation | Required Fields | Description |
+|-----------|-----------------|-------------|
+| `me` | none | Get authenticated user's profile |
+| `by_username` | username | Look up user by username |
+| `by_id` | user_id | Look up user by ID |
+| `followers` | user_id (optional) | Get user's followers (defaults to authenticated user) |
+| `following` | user_id (optional) | Get accounts user follows (defaults to authenticated user) |
+
+### Examples
+
+**Get my profile:**
+```json
+{
+  "operation": "me"
+}
+```
+
+**Look up user by username:**
+```json
+{
+  "operation": "by_username",
+  "username": "elonmusk"
+}
+```
+
+**Look up user by ID:**
+```json
+{
+  "operation": "by_id",
+  "user_id": "44196397"
+}
+```
+
+**Get my followers:**
+```json
+{
+  "operation": "followers",
+  "max_results": 100
+}
+```
+
+**Get accounts I follow:**
+```json
+{
+  "operation": "following",
+  "max_results": 50
+}
+```
+
+**Get another user's followers:**
+```json
+{
+  "operation": "followers",
+  "user_id": "44196397",
+  "max_results": 200
+}
+```
+
+### Response Format - Single User
+
+```json
+{
+  "success": true,
+  "result": {
+    "user": {
+      "id": "44196397",
+      "username": "elonmusk",
+      "name": "Elon Musk",
+      "profile_image_url": "https://pbs.twimg.com/...",
+      "verified": true
+    }
+  },
+  "execution_time": 0.35
+}
+```
+
+### Response Format - User List
+
+```json
+{
+  "success": true,
+  "result": {
+    "followers": {
+      "users": [
+        {
+          "id": "123456789",
+          "username": "user1",
+          "name": "User One",
+          "profile_image_url": "https://...",
+          "verified": false
+        }
+      ],
+      "count": 100
+    }
+  },
+  "execution_time": 1.2
+}
+```
+
+### Error Response
+
+```json
+{
+  "success": false,
+  "error": "Username is required",
+  "execution_time": 0.01
+}
+```
+
+## Guidelines
+
+1. **Usernames**: Provide without the @ symbol (e.g., `elonmusk` not `@elonmusk`)
+2. **User IDs**: Use the numeric ID string
+3. **Rate limits**: Follower/following endpoints have lower rate limits
+4. **Max results**: Limited to 1000 per request for followers/following
+5. **Pagination**: For large accounts, results are paginated (first page returned)
+
+## Common Use Cases
+
+- Get your own profile information
+- Look up profiles of users you interact with
+- Check if users are verified
+- Analyze follower/following relationships
+- Build lists of relevant accounts
+
+## Setup Requirements
+
+1. Connect the **Twitter User** node to an AI Agent's `input-tools` handle
+2. Ensure Twitter is connected (authenticated via OAuth in Credentials Modal)
+3. Your X Developer account must have appropriate API access level

package/workflows/Zeenie_full.json

@@ -0,0 +1,459 @@
+{
+  "id": "workflow-1770568399727-b5zkjpuda",
+  "name": "Zeenie",
+  "nodes": [
+    {
+      "id": "chatAgent-1770207244010",
+      "type": "chatAgent",
+      "position": {
+        "x": 260,
+        "y": 180
+      },
+      "data": {
+        "label": "Zeenie"
+      },
+      "width": 260,
+      "height": 160,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 260,
+        "y": 180
+      },
+      "dragging": false
+    },
+    {
+      "id": "chatTrigger-1770207686160",
+      "type": "chatTrigger",
+      "position": {
+        "x": -400,
+        "y": 260
+      },
+      "data": {
+        "label": "Chat Trigger"
+      },
+      "width": 67,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": -400,
+        "y": 260
+      },
+      "dragging": false
+    },
+    {
+      "id": "console-1770207687094",
+      "type": "console",
+      "position": {
+        "x": 780,
+        "y": 300
+      },
+      "data": {
+        "label": "Console"
+      },
+      "width": 60,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 780,
+        "y": 300
+      },
+      "dragging": true
+    },
+    {
+      "id": "whatsappSend-1770207695172",
+      "type": "whatsappSend",
+      "position": {
+        "x": 760,
+        "y": 140
+      },
+      "data": {
+        "label": "WhatsApp Send"
+      },
+      "width": 87,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 760,
+        "y": 140
+      },
+      "dragging": false
+    },
+    {
+      "id": "whatsappReceive-1770207696316",
+      "type": "whatsappReceive",
+      "position": {
+        "x": -420,
+        "y": 140
+      },
+      "data": {
+        "label": "WhatsApp Receive"
+      },
+      "width": 101,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": -420,
+        "y": 140
+      },
+      "dragging": true
+    },
+    {
+      "id": "whatsappDb-1770207697703",
+      "type": "whatsappDb",
+      "position": {
+        "x": 1460,
+        "y": 540
+      },
+      "data": {
+        "label": "WhatsApp DB"
+      },
+      "width": 76,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 1460,
+        "y": 540
+      },
+      "dragging": true
+    },
+    {
+      "id": "webSearchTool-1770207714722",
+      "type": "webSearchTool",
+      "position": {
+        "x": 640,
+        "y": 540
+      },
+      "data": {
+        "label": "Web Search Tool"
+      },
+      "width": 91,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 640,
+        "y": 540
+      },
+      "dragging": false
+    },
+    {
+      "id": "httpRequest-1770207725414",
+      "type": "httpRequest",
+      "position": {
+        "x": 760,
+        "y": 540
+      },
+      "data": {
+        "label": "HTTP Request"
+      },
+      "width": 76,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 760,
+        "y": 540
+      },
+      "dragging": false
+    },
+    {
+      "id": "gmaps_locations-1770207738763",
+      "type": "gmaps_locations",
+      "position": {
+        "x": 1180,
+        "y": 540
+      },
+      "data": {
+        "label": "GMaps Locations"
+      },
+      "width": 93,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 1180,
+        "y": 540
+      },
+      "dragging": false
+    },
+    {
+      "id": "gmaps_nearby_places-1770207740402",
+      "type": "gmaps_nearby_places",
+      "position": {
+        "x": 1300,
+        "y": 540
+      },
+      "data": {
+        "label": "GMaps Nearby Places"
+      },
+      "width": 118,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 1300,
+        "y": 540
+      },
+      "dragging": true
+    },
+    {
+      "id": "pythonExecutor-1770207749221",
+      "type": "pythonExecutor",
+      "position": {
+        "x": 1000,
+        "y": 540
+      },
+      "data": {
+        "label": "Python Executor"
+      },
+      "width": 89,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 1000,
+        "y": 540
+      },
+      "dragging": true
+    },
+    {
+      "id": "javascriptExecutor-1770207751142",
+      "type": "javascriptExecutor",
+      "position": {
+        "x": 860,
+        "y": 540
+      },
+      "data": {
+        "label": "JavaScript Executor"
+      },
+      "width": 105,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 860,
+        "y": 540
+      },
+      "dragging": false
+    },
+    {
+      "id": "masterSkill-1770207855144",
+      "type": "masterSkill",
+      "position": {
+        "x": 200,
+        "y": 540
+      },
+      "data": {
+        "label": "Master Skill"
+      },
+      "width": 63,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 200,
+        "y": 540
+      },
+      "dragging": false
+    },
+    {
+      "id": "simpleMemory-1770207943830",
+      "type": "simpleMemory",
+      "position": {
+        "x": 60,
+        "y": 540
+      },
+      "data": {
+        "label": "Simple Memory"
+      },
+      "width": 87,
+      "height": 82,
+      "selected": false,
+      "positionAbsolute": {
+        "x": 60,
+        "y": 540
+      },
+      "dragging": true
+    }
+  ],
+  "edges": [
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "chatTrigger-1770207686160",
+      "sourceHandle": "output-main",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-main",
+      "id": "reactflow__edge-chatTrigger-1770207686160output-main-chatAgent-1770207244010input-main",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "whatsappReceive-1770207696316",
+      "sourceHandle": "output-main",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-main",
+      "id": "reactflow__edge-whatsappReceive-1770207696316output-main-chatAgent-1770207244010input-main",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "masterSkill-1770207855144",
+      "sourceHandle": "output-main",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-skill",
+      "id": "reactflow__edge-masterSkill-1770207855144output-main-chatAgent-1770207244010input-skill",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "simpleMemory-1770207943830",
+      "sourceHandle": "output-memory",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-memory",
+      "id": "reactflow__edge-simpleMemory-1770207943830output-memory-chatAgent-1770207244010input-memory",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "httpRequest-1770207725414",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-httpRequest-1770207725414output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "javascriptExecutor-1770207751142",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-javascriptExecutor-1770207751142output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "webSearchTool-1770207714722",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-webSearchTool-1770207714722output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "pythonExecutor-1770207749221",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-pythonExecutor-1770207749221output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "gmaps_locations-1770207738763",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-gmaps_locations-1770207738763output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "gmaps_nearby_places-1770207740402",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-gmaps_nearby_places-1770207740402output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "whatsappDb-1770207697703",
+      "sourceHandle": "output-tool",
+      "target": "chatAgent-1770207244010",
+      "targetHandle": "input-tools",
+      "id": "reactflow__edge-whatsappDb-1770207697703output-tool-chatAgent-1770207244010input-tools",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "chatAgent-1770207244010",
+      "sourceHandle": "output-main",
+      "target": "console-1770207687094",
+      "targetHandle": "input-main",
+      "id": "reactflow__edge-chatAgent-1770207244010output-main-console-1770207687094input-main",
+      "selected": false
+    },
+    {
+      "type": "smoothstep",
+      "animated": true,
+      "style": {
+        "stroke": "#8be9fd",
+        "strokeWidth": 3
+      },
+      "source": "chatAgent-1770207244010",
+      "sourceHandle": "output-main",
+      "target": "whatsappSend-1770207695172",
+      "targetHandle": "input-main",
+      "id": "reactflow__edge-chatAgent-1770207244010output-main-whatsappSend-1770207695172input-main",
+      "selected": false
+    }
+  ],
+  "createdAt": "2026-02-08T16:33:19.727Z",
+  "lastModified": "2026-02-08T16:35:36.239Z",
+  "version": "0.0.10"
+}