clawless 0.1.2

package/scripts/gemini-scheduler-examples.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+
+# Example: How Gemini CLI can interact with the Scheduler API
+# This demonstrates the curl commands that Gemini would execute when asked to create schedules
+
+BASE_URL="http://127.0.0.1:8788"
+TOKEN="" # Set this if CALLBACK_AUTH_TOKEN is configured
+
+# Helper function to add auth header if token is set
+auth_header() {
+  if [ -n "$TOKEN" ]; then
+    echo "-H x-callback-token:$TOKEN"
+  fi
+}
+
+echo "=== Gemini CLI Scheduler Integration Examples ==="
+echo ""
+
+# Example 1: User asks "Remind me to take a break in 30 minutes"
+echo "Example 1: One-time reminder in 30 minutes"
+echo "User: 'Remind me to take a break in 30 minutes'"
+echo ""
+RUN_AT=$(date -u -d "+30 minutes" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+30M +"%Y-%m-%dT%H:%M:%SZ")
+echo "Gemini executes:"
+cat <<EOF
+curl -X POST ${BASE_URL}/api/schedule \\
+  -H "Content-Type: application/json" \\
+  $(auth_header) \\
+  -d '{
+    "message": "Remind: Take a break! It has been 30 minutes.",
+    "description": "Break reminder",
+    "oneTime": true,
+    "runAt": "${RUN_AT}"
+  }'
+EOF
+echo ""
+echo "---"
+echo ""
+
+# Example 2: User asks "Check my calendar every morning at 9am"
+echo "Example 2: Daily calendar check at 9am"
+echo "User: 'Check my calendar every morning at 9am and send me a summary'"
+echo ""
+echo "Gemini executes:"
+cat <<EOF
+curl -X POST ${BASE_URL}/api/schedule \\
+  -H "Content-Type: application/json" \\
+  $(auth_header) \\
+  -d '{
+    "message": "Check my calendar for today and provide a summary of all events",
+    "description": "Daily calendar summary at 9am",
+    "cronExpression": "0 9 * * *"
+  }'
+EOF
+echo ""
+echo "---"
+echo ""
+
+# Example 3: User asks "Every Friday at 5pm, remind me to review my weekly goals"
+echo "Example 3: Weekly reminder on Fridays at 5pm"
+echo "User: 'Every Friday at 5pm, remind me to review my weekly goals'"
+echo ""
+echo "Gemini executes:"
+cat <<EOF
+curl -X POST ${BASE_URL}/api/schedule \\
+  -H "Content-Type: application/json" \\
+  $(auth_header) \\
+  -d '{
+    "message": "Weekly reminder: Review your goals for this week. What did you accomplish? What needs more work?",
+    "description": "Weekly goals review - Friday 5pm",
+    "cronExpression": "0 17 * * 5"
+  }'
+EOF
+echo ""
+echo "---"
+echo ""
+
+# Example 4: User asks "What schedules do I have?"
+echo "Example 4: List all schedules"
+echo "User: 'What schedules do I have?'"
+echo ""
+echo "Gemini executes:"
+cat <<EOF
+curl ${BASE_URL}/api/schedule \\
+  $(auth_header)
+EOF
+echo ""
+echo "Then Gemini formats the response in a human-readable way."
+echo ""
+echo "---"
+echo ""
+
+# Example 5: User asks "Cancel my daily calendar check"
+echo "Example 5: Cancel a specific schedule"
+echo "User: 'Cancel my daily calendar check'"
+echo ""
+echo "Gemini first lists schedules, finds the one matching 'daily calendar', then:"
+cat <<EOF
+curl -X DELETE ${BASE_URL}/api/schedule/SCHEDULE_ID \\
+  $(auth_header)
+EOF
+echo ""
+echo "---"
+echo ""
+
+# Example 6: More complex recurring schedules
+echo "Example 6: Complex recurring schedules"
+echo ""
+
+echo "Every 5 minutes:"
+echo "  cronExpression: '*/5 * * * *'"
+echo ""
+
+echo "Every weekday at 8am:"
+echo "  cronExpression: '0 8 * * 1-5'"
+echo ""
+
+echo "First day of every month at midnight:"
+echo "  cronExpression: '0 0 1 * *'"
+echo ""
+
+echo "Every hour during work hours (9am-5pm) on weekdays:"
+echo "  cronExpression: '0 9-17 * * 1-5'"
+echo ""
+
+echo "---"
+echo ""
+
+echo "=== Cron Expression Guide ==="
+echo ""
+echo "Format: minute hour day month weekday"
+echo ""
+echo "Field      Values"
+echo "-------    ----------------"
+echo "minute     0-59"
+echo "hour       0-23"
+echo "day        1-31"
+echo "month      1-12"
+echo "weekday    0-7 (0 or 7 is Sunday)"
+echo ""
+echo "Special characters:"
+echo "  *   any value"
+echo "  ,   value list separator (e.g., 1,3,5)"
+echo "  -   range of values (e.g., 1-5)"
+echo "  /   step values (e.g., */15 for every 15 minutes)"
+echo ""
+
+echo "=== Integration Notes ==="
+echo ""
+echo "1. Gemini CLI has access to the scheduler API endpoints through system prompts"
+echo "2. When users ask to schedule something, Gemini:"
+echo "   - Parses the natural language request"
+echo "   - Determines if it's one-time (runAt) or recurring (cronExpression)"
+echo "   - Converts time expressions to appropriate format"
+echo "   - Calls the API with proper JSON payload"
+echo "   - Confirms schedule creation to the user"
+echo ""
+echo "3. When scheduled jobs run:"
+echo "   - The message is executed through a new Gemini CLI session"
+echo "   - Gemini can use all its tools (calendar, file access, web search, etc.)"
+echo "   - The response is automatically sent to Telegram"
+echo ""

package/scripts/test-scheduler.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+
+# Test script for scheduler API
+# This script tests the scheduler API endpoints
+
+BASE_URL="http://127.0.0.1:8788"
+
+echo "=== Scheduler API Test ==="
+echo ""
+
+# Test 1: Health check
+echo "1. Testing health check..."
+curl -s "${BASE_URL}/healthz" | jq .
+echo ""
+
+# Test 2: Create a recurring schedule (every minute)
+echo "2. Creating a recurring schedule (every minute)..."
+RECURRING_RESPONSE=$(curl -s -X POST "${BASE_URL}/api/schedule" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "message": "What time is it now?",
+    "description": "Test recurring schedule - every minute",
+    "cronExpression": "* * * * *"
+  }')
+echo "$RECURRING_RESPONSE" | jq .
+SCHEDULE_ID=$(echo "$RECURRING_RESPONSE" | jq -r '.schedule.id')
+echo "Created schedule ID: $SCHEDULE_ID"
+echo ""
+
+# Test 3: Create a one-time schedule (30 seconds from now)
+echo "3. Creating a one-time schedule (30 seconds from now)..."
+if ! RUN_AT=$(date -u -d "+30 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null); then
+  # Fallback for macOS/BSD date
+  RUN_AT=$(date -u -v+30S +"%Y-%m-%dT%H:%M:%SZ")
+fi
+ONE_TIME_RESPONSE=$(curl -s -X POST "${BASE_URL}/api/schedule" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"message\": \"This is a one-time scheduled message\",
+    \"description\": \"Test one-time schedule\",
+    \"oneTime\": true,
+    \"runAt\": \"${RUN_AT}\"
+  }")
+echo "$ONE_TIME_RESPONSE" | jq .
+ONE_TIME_ID=$(echo "$ONE_TIME_RESPONSE" | jq -r '.schedule.id')
+echo "Created one-time schedule ID: $ONE_TIME_ID"
+echo ""
+
+# Test 4: List all schedules
+echo "4. Listing all schedules..."
+curl -s "${BASE_URL}/api/schedule" | jq .
+echo ""
+
+# Test 5: Get a specific schedule
+echo "5. Getting schedule by ID..."
+curl -s "${BASE_URL}/api/schedule/${SCHEDULE_ID}" | jq .
+echo ""
+
+# Test 6: Wait for 65 seconds to see recurring job execute
+echo "6. Waiting 65 seconds to observe recurring job execution..."
+echo "   (Check the bridge logs to see the job execute)"
+sleep 65
+echo ""
+
+# Test 7: Delete the recurring schedule
+echo "7. Deleting recurring schedule..."
+curl -s -X DELETE "${BASE_URL}/api/schedule/${SCHEDULE_ID}" | jq .
+echo ""
+
+# Test 8: List schedules again (should only have one-time if it hasn't run yet)
+echo "8. Listing schedules after deletion..."
+curl -s "${BASE_URL}/api/schedule" | jq .
+echo ""
+
+echo "=== Test Complete ==="
+echo ""
+echo "Note: Make sure the bridge is running before executing this script."
+echo "To run the bridge: npm run dev"

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "index.ts",
+    "bin/**/*.ts",
+    "messaging/**/*.ts"
+  ],
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}

package/utils/error.ts

@@ -0,0 +1,12 @@
+export function getErrorMessage(error: unknown, fallback = 'Unknown error'): string {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === 'string') {
+    return error;
+  }
+  if (error === null || error === undefined) {
+    return fallback;
+  }
+  return String(error);
+}