@rozek/nanoclaw 1.2.17

package/.claude/skills/x-integration/scripts/post.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env npx tsx
+/**
+ * X Integration - Post Tweet
+ * Usage: echo '{"content":"Hello world"}' | npx tsx post.ts
+ */
+
+import { getBrowserContext, runScript, validateContent, config, ScriptResult } from '../lib/browser.js';
+
+interface PostInput {
+  content: string;
+}
+
+async function postTweet(input: PostInput): Promise<ScriptResult> {
+  const { content } = input;
+
+  const validationError = validateContent(content, 'Tweet');
+  if (validationError) return validationError;
+
+  let context = null;
+  try {
+    context = await getBrowserContext();
+    const page = context.pages()[0] || await context.newPage();
+
+    await page.goto('https://x.com/home', { timeout: config.timeouts.navigation, waitUntil: 'domcontentloaded' });
+    await page.waitForTimeout(config.timeouts.pageLoad);
+
+    // Check if logged in
+    const isLoggedIn = await page.locator('[data-testid="SideNav_AccountSwitcher_Button"]').isVisible().catch(() => false);
+    if (!isLoggedIn) {
+      const onLoginPage = await page.locator('input[autocomplete="username"]').isVisible().catch(() => false);
+      if (onLoginPage) {
+        return { success: false, message: 'X login expired. Run /x-integration to re-authenticate.' };
+      }
+    }
+
+    // Find and fill tweet input
+    const tweetInput = page.locator('[data-testid="tweetTextarea_0"]');
+    await tweetInput.waitFor({ timeout: config.timeouts.elementWait * 2 });
+    await tweetInput.click();
+    await page.waitForTimeout(config.timeouts.afterClick / 2);
+    await tweetInput.fill(content);
+    await page.waitForTimeout(config.timeouts.afterFill);
+
+    // Click post button
+    const postButton = page.locator('[data-testid="tweetButtonInline"]');
+    await postButton.waitFor({ timeout: config.timeouts.elementWait });
+
+    const isDisabled = await postButton.getAttribute('aria-disabled');
+    if (isDisabled === 'true') {
+      return { success: false, message: 'Post button disabled. Content may be empty or exceed character limit.' };
+    }
+
+    await postButton.click();
+    await page.waitForTimeout(config.timeouts.afterSubmit);
+
+    return {
+      success: true,
+      message: `Tweet posted: ${content.slice(0, 50)}${content.length > 50 ? '...' : ''}`
+    };
+
+  } finally {
+    if (context) await context.close();
+  }
+}
+
+runScript<PostInput>(postTweet);

package/.claude/skills/x-integration/scripts/quote.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env npx tsx
+/**
+ * X Integration - Quote Tweet
+ * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","comment":"My thoughts"}' | npx tsx quote.ts
+ */
+
+import { getBrowserContext, navigateToTweet, runScript, validateContent, config, ScriptResult } from '../lib/browser.js';
+
+interface QuoteInput {
+  tweetUrl: string;
+  comment: string;
+}
+
+async function quoteTweet(input: QuoteInput): Promise<ScriptResult> {
+  const { tweetUrl, comment } = input;
+
+  if (!tweetUrl) {
+    return { success: false, message: 'Please provide a tweet URL' };
+  }
+
+  const validationError = validateContent(comment, 'Comment');
+  if (validationError) return validationError;
+
+  let context = null;
+  try {
+    context = await getBrowserContext();
+    const { page, success, error } = await navigateToTweet(context, tweetUrl);
+
+    if (!success) {
+      return { success: false, message: error || 'Navigation failed' };
+    }
+
+    // Click retweet button to open menu
+    const tweet = page.locator('article[data-testid="tweet"]').first();
+    const retweetButton = tweet.locator('[data-testid="retweet"]');
+    await retweetButton.waitFor({ timeout: config.timeouts.elementWait });
+    await retweetButton.click();
+    await page.waitForTimeout(config.timeouts.afterClick);
+
+    // Click quote option
+    const quoteOption = page.getByRole('menuitem').filter({ hasText: /Quote/i });
+    await quoteOption.waitFor({ timeout: config.timeouts.elementWait });
+    await quoteOption.click();
+    await page.waitForTimeout(config.timeouts.afterClick * 1.5);
+
+    // Find dialog with aria-modal="true"
+    const dialog = page.locator('[role="dialog"][aria-modal="true"]');
+    await dialog.waitFor({ timeout: config.timeouts.elementWait });
+
+    // Fill comment
+    const quoteInput = dialog.locator('[data-testid="tweetTextarea_0"]');
+    await quoteInput.waitFor({ timeout: config.timeouts.elementWait });
+    await quoteInput.click();
+    await page.waitForTimeout(config.timeouts.afterClick / 2);
+    await quoteInput.fill(comment);
+    await page.waitForTimeout(config.timeouts.afterFill);
+
+    // Click submit button
+    const submitButton = dialog.locator('[data-testid="tweetButton"]');
+    await submitButton.waitFor({ timeout: config.timeouts.elementWait });
+
+    const isDisabled = await submitButton.getAttribute('aria-disabled');
+    if (isDisabled === 'true') {
+      return { success: false, message: 'Submit button disabled. Content may be empty or exceed character limit.' };
+    }
+
+    await submitButton.click();
+    await page.waitForTimeout(config.timeouts.afterSubmit);
+
+    return {
+      success: true,
+      message: `Quote tweet posted: ${comment.slice(0, 50)}${comment.length > 50 ? '...' : ''}`
+    };
+
+  } finally {
+    if (context) await context.close();
+  }
+}
+
+runScript<QuoteInput>(quoteTweet);

package/.claude/skills/x-integration/scripts/reply.ts

@@ -0,0 +1,74 @@
+#!/usr/bin/env npx tsx
+/**
+ * X Integration - Reply to Tweet
+ * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","content":"Great post!"}' | npx tsx reply.ts
+ */
+
+import { getBrowserContext, navigateToTweet, runScript, validateContent, config, ScriptResult } from '../lib/browser.js';
+
+interface ReplyInput {
+  tweetUrl: string;
+  content: string;
+}
+
+async function replyToTweet(input: ReplyInput): Promise<ScriptResult> {
+  const { tweetUrl, content } = input;
+
+  if (!tweetUrl) {
+    return { success: false, message: 'Please provide a tweet URL' };
+  }
+
+  const validationError = validateContent(content, 'Reply');
+  if (validationError) return validationError;
+
+  let context = null;
+  try {
+    context = await getBrowserContext();
+    const { page, success, error } = await navigateToTweet(context, tweetUrl);
+
+    if (!success) {
+      return { success: false, message: error || 'Navigation failed' };
+    }
+
+    // Click reply button
+    const tweet = page.locator('article[data-testid="tweet"]').first();
+    const replyButton = tweet.locator('[data-testid="reply"]');
+    await replyButton.waitFor({ timeout: config.timeouts.elementWait });
+    await replyButton.click();
+    await page.waitForTimeout(config.timeouts.afterClick * 1.5);
+
+    // Find dialog with aria-modal="true" to avoid matching other dialogs
+    const dialog = page.locator('[role="dialog"][aria-modal="true"]');
+    await dialog.waitFor({ timeout: config.timeouts.elementWait });
+
+    // Fill reply content
+    const replyInput = dialog.locator('[data-testid="tweetTextarea_0"]');
+    await replyInput.waitFor({ timeout: config.timeouts.elementWait });
+    await replyInput.click();
+    await page.waitForTimeout(config.timeouts.afterClick / 2);
+    await replyInput.fill(content);
+    await page.waitForTimeout(config.timeouts.afterFill);
+
+    // Click submit button
+    const submitButton = dialog.locator('[data-testid="tweetButton"]');
+    await submitButton.waitFor({ timeout: config.timeouts.elementWait });
+
+    const isDisabled = await submitButton.getAttribute('aria-disabled');
+    if (isDisabled === 'true') {
+      return { success: false, message: 'Submit button disabled. Content may be empty or exceed character limit.' };
+    }
+
+    await submitButton.click();
+    await page.waitForTimeout(config.timeouts.afterSubmit);
+
+    return {
+      success: true,
+      message: `Reply posted: ${content.slice(0, 50)}${content.length > 50 ? '...' : ''}`
+    };
+
+  } finally {
+    if (context) await context.close();
+  }
+}
+
+runScript<ReplyInput>(replyToTweet);

package/.claude/skills/x-integration/scripts/retweet.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env npx tsx
+/**
+ * X Integration - Retweet
+ * Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx retweet.ts
+ */
+
+import { getBrowserContext, navigateToTweet, runScript, config, ScriptResult } from '../lib/browser.js';
+
+interface RetweetInput {
+  tweetUrl: string;
+}
+
+async function retweet(input: RetweetInput): Promise<ScriptResult> {
+  const { tweetUrl } = input;
+
+  if (!tweetUrl) {
+    return { success: false, message: 'Please provide a tweet URL' };
+  }
+
+  let context = null;
+  try {
+    context = await getBrowserContext();
+    const { page, success, error } = await navigateToTweet(context, tweetUrl);
+
+    if (!success) {
+      return { success: false, message: error || 'Navigation failed' };
+    }
+
+    const tweet = page.locator('article[data-testid="tweet"]').first();
+    const unretweetButton = tweet.locator('[data-testid="unretweet"]');
+    const retweetButton = tweet.locator('[data-testid="retweet"]');
+
+    // Check if already retweeted
+    const alreadyRetweeted = await unretweetButton.isVisible().catch(() => false);
+    if (alreadyRetweeted) {
+      return { success: true, message: 'Tweet already retweeted' };
+    }
+
+    await retweetButton.waitFor({ timeout: config.timeouts.elementWait });
+    await retweetButton.click();
+    await page.waitForTimeout(config.timeouts.afterClick);
+
+    // Click retweet confirm option
+    const retweetConfirm = page.locator('[data-testid="retweetConfirm"]');
+    await retweetConfirm.waitFor({ timeout: config.timeouts.elementWait });
+    await retweetConfirm.click();
+    await page.waitForTimeout(config.timeouts.afterClick * 2);
+
+    // Verify
+    const nowRetweeted = await unretweetButton.isVisible().catch(() => false);
+    if (nowRetweeted) {
+      return { success: true, message: 'Retweet successful' };
+    }
+
+    return { success: false, message: 'Retweet action completed but could not verify success' };
+
+  } finally {
+    if (context) await context.close();
+  }
+}
+
+runScript<RetweetInput>(retweet);

package/.claude/skills/x-integration/scripts/setup.ts

@@ -0,0 +1,87 @@
+#!/usr/bin/env npx tsx
+/**
+ * X Integration - Authentication Setup
+ * Usage: npx tsx setup.ts
+ *
+ * Interactive script - opens browser for manual login
+ */
+
+import { chromium } from 'playwright';
+import * as readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import { config, cleanupLockFiles } from '../lib/browser.js';
+
+async function setup(): Promise<void> {
+  console.log('=== X (Twitter) Authentication Setup ===\n');
+  console.log('This will open Chrome for you to log in to X.');
+  console.log('Your login session will be saved for automated interactions.\n');
+  console.log(`Chrome path: ${config.chromePath}`);
+  console.log(`Profile dir: ${config.browserDataDir}\n`);
+
+  // Ensure directories exist
+  fs.mkdirSync(path.dirname(config.authPath), { recursive: true });
+  fs.mkdirSync(config.browserDataDir, { recursive: true });
+
+  cleanupLockFiles();
+
+  console.log('Launching browser...\n');
+
+  const context = await chromium.launchPersistentContext(config.browserDataDir, {
+    executablePath: config.chromePath,
+    headless: false,
+    viewport: config.viewport,
+    args: config.chromeArgs.slice(0, 3), // Use first 3 args for setup (less restrictive)
+    ignoreDefaultArgs: config.chromeIgnoreDefaultArgs,
+  });
+
+  const page = context.pages()[0] || await context.newPage();
+
+  // Navigate to login page
+  await page.goto('https://x.com/login');
+
+  console.log('Please log in to X in the browser window.');
+  console.log('After you see your home feed, come back here and press Enter.\n');
+
+  // Wait for user to complete login
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  await new Promise<void>(resolve => {
+    rl.question('Press Enter when logged in... ', () => {
+      rl.close();
+      resolve();
+    });
+  });
+
+  // Verify login by navigating to home and checking for account button
+  console.log('\nVerifying login status...');
+  await page.goto('https://x.com/home');
+  await page.waitForTimeout(config.timeouts.pageLoad);
+
+  const isLoggedIn = await page.locator('[data-testid="SideNav_AccountSwitcher_Button"]').isVisible().catch(() => false);
+
+  if (isLoggedIn) {
+    // Save auth marker
+    fs.writeFileSync(config.authPath, JSON.stringify({
+      authenticated: true,
+      timestamp: new Date().toISOString()
+    }, null, 2));
+
+    console.log('\n✅ Authentication successful!');
+    console.log(`Session saved to: ${config.browserDataDir}`);
+    console.log('\nYou can now use X integration features.');
+  } else {
+    console.log('\n❌ Could not verify login status.');
+    console.log('Please try again and make sure you are logged in to X.');
+  }
+
+  await context.close();
+}
+
+setup().catch(err => {
+  console.error('Setup failed:', err.message);
+  process.exit(1);
+});

package/.env.example

@@ -0,0 +1 @@
+

package/.github/CODEOWNERS

@@ -0,0 +1,10 @@
+# Core code - maintainer only
+/src/ @gavrielc @gabi-simons
+/container/ @gavrielc @gabi-simons
+/groups/ @gavrielc @gabi-simons
+/launchd/ @gavrielc @gabi-simons
+/package.json @gavrielc @gabi-simons
+/package-lock.json @gavrielc @gabi-simons
+
+# Skills - open to contributors
+/.claude/skills/

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Type of Change
+
+- [ ] **Skill** - adds a new skill in `.claude/skills/`
+- [ ] **Fix** - bug fix or security fix to source code
+- [ ] **Simplification** - reduces or simplifies source code
+
+## Description
+
+
+## For Skills
+
+- [ ] I have not made any changes to source code
+- [ ] My skill contains instructions for Claude to follow (not pre-built code)
+- [ ] I tested this skill on a fresh clone

package/.github/workflows/bump-version.yml

@@ -0,0 +1,32 @@
+name: Bump version
+
+on:
+  push:
+    branches: [main]
+    paths: ['src/**', 'container/**']
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+
+      - name: Bump patch version
+        run: |
+          npm version patch --no-git-tag-version
+          git add package.json package-lock.json
+          git diff --cached --quiet && exit 0
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          VERSION=$(node -p "require('./package.json').version")
+          git commit -m "chore: bump version to $VERSION"
+          git pull --rebase
+          git push

package/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+
+      - name: Format check
+        run: npm run format:check
+
+      - name: Typecheck
+        run: npx tsc --noEmit
+
+      - name: Tests
+        run: npx vitest run

package/.github/workflows/merge-forward-skills.yml

@@ -0,0 +1,160 @@
+name: Merge-forward skill branches
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  issues: write
+
+jobs:
+  merge-forward:
+    if: github.repository == 'qwibitai/nanoclaw'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Merge main into each skill branch
+        id: merge
+        run: |
+          FAILED=""
+          SUCCEEDED=""
+
+          # List all remote skill branches
+          SKILL_BRANCHES=$(git branch -r --list 'origin/skill/*' | sed 's|origin/||' | xargs)
+
+          if [ -z "$SKILL_BRANCHES" ]; then
+            echo "No skill branches found."
+            exit 0
+          fi
+
+          for BRANCH in $SKILL_BRANCHES; do
+            SKILL_NAME=$(echo "$BRANCH" | sed 's|skill/||')
+            echo ""
+            echo "=== Processing $BRANCH ==="
+
+            # Checkout the skill branch
+            git checkout -B "$BRANCH" "origin/$BRANCH"
+
+            # Attempt merge
+            if ! git merge main --no-edit; then
+              echo "::warning::Merge conflict in $BRANCH"
+              git merge --abort
+              FAILED="$FAILED $SKILL_NAME"
+              continue
+            fi
+
+            # Check if there's anything new to push
+            if git diff --quiet "origin/$BRANCH"; then
+              echo "$BRANCH is already up to date with main."
+              SUCCEEDED="$SUCCEEDED $SKILL_NAME"
+              continue
+            fi
+
+            # Install deps and validate
+            npm ci
+
+            if ! npm run build; then
+              echo "::warning::Build failed for $BRANCH"
+              git reset --hard "origin/$BRANCH"
+              FAILED="$FAILED $SKILL_NAME"
+              continue
+            fi
+
+            if ! npm test 2>/dev/null; then
+              echo "::warning::Tests failed for $BRANCH"
+              git reset --hard "origin/$BRANCH"
+              FAILED="$FAILED $SKILL_NAME"
+              continue
+            fi
+
+            # Push the updated branch
+            git push origin "$BRANCH"
+            SUCCEEDED="$SUCCEEDED $SKILL_NAME"
+            echo "$BRANCH merged and pushed successfully."
+          done
+
+          echo ""
+          echo "=== Results ==="
+          echo "Succeeded: $SUCCEEDED"
+          echo "Failed: $FAILED"
+
+          # Export for issue creation
+          echo "failed=$FAILED" >> "$GITHUB_OUTPUT"
+          echo "succeeded=$SUCCEEDED" >> "$GITHUB_OUTPUT"
+
+      - name: Open issue for failed merges
+        if: steps.merge.outputs.failed != ''
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const failed = '${{ steps.merge.outputs.failed }}'.trim().split(/\s+/);
+            const sha = context.sha.substring(0, 7);
+            const body = [
+              `The merge-forward workflow failed to merge \`main\` (${sha}) into the following skill branches:`,
+              '',
+              ...failed.map(s => `- \`skill/${s}\`: merge conflict, build failure, or test failure`),
+              '',
+              'Please resolve manually:',
+              '```bash',
+              ...failed.map(s => [
+                `git checkout skill/${s}`,
+                `git merge main`,
+                `# resolve conflicts, then: git push`,
+                ''
+              ]).flat(),
+              '```',
+              '',
+              `Triggered by push to main: ${context.sha}`
+            ].join('\n');
+
+            await github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `Merge-forward failed for ${failed.length} skill branch(es) after ${sha}`,
+              body,
+              labels: ['skill-maintenance']
+            });
+
+      - name: Notify channel forks
+        if: always()
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.FORK_DISPATCH_TOKEN || secrets.GITHUB_TOKEN }}
+          script: |
+            const forks = [
+              'nanoclaw-whatsapp',
+              'nanoclaw-telegram',
+              'nanoclaw-discord',
+              'nanoclaw-slack',
+              'nanoclaw-gmail',
+              'nanoclaw-docker-sandboxes',
+            ];
+            const sha = context.sha.substring(0, 7);
+            for (const repo of forks) {
+              try {
+                await github.rest.repos.createDispatchEvent({
+                  owner: 'qwibitai',
+                  repo,
+                  event_type: 'upstream-main-updated',
+                  client_payload: { sha: context.sha },
+                });
+                console.log(`Notified ${repo}`);
+              } catch (e) {
+                console.log(`Failed to notify ${repo}: ${e.message}`);
+              }
+            }

package/.github/workflows/update-tokens.yml

@@ -0,0 +1,42 @@
+name: Update token count
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths: ['src/**', 'container/**', 'launchd/**', 'CLAUDE.md']
+
+jobs:
+  update-tokens:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - uses: ./repo-tokens
+        id: tokens
+        with:
+          include: 'src/**/*.ts container/agent-runner/src/**/*.ts container/Dockerfile container/build.sh launchd/com.nanoclaw.plist CLAUDE.md'
+          exclude: 'src/**/*.test.ts'
+          badge-path: 'repo-tokens/badge.svg'
+
+      - name: Commit if changed
+        run: |
+          git add README.md repo-tokens/badge.svg
+          git diff --cached --quiet && exit 0
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git commit -m "docs: update token count to ${{ steps.tokens.outputs.badge }}"
+          git pull --rebase
+          git push

package/.husky/pre-commit

@@ -0,0 +1 @@
+npm run format:fix

package/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "mcpServers": {}
+}

package/.nvmrc

@@ -0,0 +1 @@
+22

package/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}