@rozek/nanoclaw 1.2.17

package/repo-tokens/badge.svg

@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="97" height="20" role="img" aria-label="40.6k tokens, 20% of context window">
+  <title>40.6k tokens, 20% of context window</title>
+  <linearGradient id="s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="r">
+    <rect width="97" height="20" rx="3" fill="#fff"/>
+  </clipPath>
+  <a xlink:href="https://github.com/qwibitai/nanoclaw/tree/main/repo-tokens">
+    <g clip-path="url(#r)">
+      <rect width="52" height="20" fill="#555"/>
+      <rect x="52" width="45" height="20" fill="#4c1"/>
+      <rect width="97" height="20" fill="url(#s)"/>
+      <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+        <text aria-hidden="true" x="26" y="15" fill="#010101" fill-opacity=".3">tokens</text>
+        <text x="26" y="14">tokens</text>
+        <text aria-hidden="true" x="74" y="15" fill="#010101" fill-opacity=".3">40.6k</text>
+        <text x="74" y="14">40.6k</text>
+      </g>
+    </g>
+  </a>
+</svg>

package/repo-tokens/examples/green.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="97" height="20" role="img" aria-label="12.4k tokens">
+  <title>12.4k tokens</title>
+  <linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient>
+  <clipPath id="r"><rect width="97" height="20" rx="3"/></clipPath>
+  <g clip-path="url(#r)">
+    <rect width="52" height="20" fill="#555"/>
+    <rect x="52" width="45" height="20" fill="#4c1"/>
+    <rect width="97" height="20" fill="url(#s)"/>
+    <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+      <text x="26" y="15" fill="#010101" fill-opacity=".3">tokens</text><text x="26" y="14">tokens</text>
+      <text x="74" y="15" fill="#010101" fill-opacity=".3">12.4k</text><text x="74" y="14">12.4k</text>
+    </g>
+  </g>
+</svg>

package/repo-tokens/examples/red.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="90" height="20" role="img" aria-label="158k tokens">
+  <title>158k tokens</title>
+  <linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient>
+  <clipPath id="r"><rect width="90" height="20" rx="3"/></clipPath>
+  <g clip-path="url(#r)">
+    <rect width="52" height="20" fill="#555"/>
+    <rect x="52" width="38" height="20" fill="#e05d44"/>
+    <rect width="90" height="20" fill="url(#s)"/>
+    <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+      <text x="26" y="15" fill="#010101" fill-opacity=".3">tokens</text><text x="26" y="14">tokens</text>
+      <text x="71" y="15" fill="#010101" fill-opacity=".3">158k</text><text x="71" y="14">158k</text>
+    </g>
+  </g>
+</svg>

package/repo-tokens/examples/yellow-green.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="97" height="20" role="img" aria-label="74.8k tokens">
+  <title>74.8k tokens</title>
+  <linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient>
+  <clipPath id="r"><rect width="97" height="20" rx="3"/></clipPath>
+  <g clip-path="url(#r)">
+    <rect width="52" height="20" fill="#555"/>
+    <rect x="52" width="45" height="20" fill="#97ca00"/>
+    <rect width="97" height="20" fill="url(#s)"/>
+    <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+      <text x="26" y="15" fill="#010101" fill-opacity=".3">tokens</text><text x="26" y="14">tokens</text>
+      <text x="74" y="15" fill="#010101" fill-opacity=".3">74.8k</text><text x="74" y="14">74.8k</text>
+    </g>
+  </g>
+</svg>

package/repo-tokens/examples/yellow.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="90" height="20" role="img" aria-label="120k tokens">
+  <title>120k tokens</title>
+  <linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient>
+  <clipPath id="r"><rect width="90" height="20" rx="3"/></clipPath>
+  <g clip-path="url(#r)">
+    <rect width="52" height="20" fill="#555"/>
+    <rect x="52" width="38" height="20" fill="#dfb317"/>
+    <rect width="90" height="20" fill="url(#s)"/>
+    <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+      <text x="26" y="15" fill="#010101" fill-opacity=".3">tokens</text><text x="26" y="14">tokens</text>
+      <text x="71" y="15" fill="#010101" fill-opacity=".3">120k</text><text x="71" y="14">120k</text>
+    </g>
+  </g>
+</svg>

package/scripts/run-migrations.ts

@@ -0,0 +1,105 @@
+#!/usr/bin/env tsx
+import { execFileSync, execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+
+function compareSemver(a: string, b: string): number {
+  const partsA = a.split('.').map(Number);
+  const partsB = b.split('.').map(Number);
+  for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+    const diff = (partsA[i] || 0) - (partsB[i] || 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+
+// Resolve tsx binary once to avoid npx race conditions across migrations
+function resolveTsx(): string {
+  // Check local node_modules first
+  const local = path.resolve('node_modules/.bin/tsx');
+  if (fs.existsSync(local)) return local;
+  // Fall back to whichever tsx is in PATH
+  try {
+    return execSync('which tsx', { encoding: 'utf-8' }).trim();
+  } catch {
+    return 'npx'; // last resort
+  }
+}
+
+const tsxBin = resolveTsx();
+
+const fromVersion = process.argv[2];
+const toVersion = process.argv[3];
+const newCorePath = process.argv[4];
+
+if (!fromVersion || !toVersion || !newCorePath) {
+  console.error(
+    'Usage: tsx scripts/run-migrations.ts <from-version> <to-version> <new-core-path>',
+  );
+  process.exit(1);
+}
+
+interface MigrationResult {
+  version: string;
+  success: boolean;
+  error?: string;
+}
+
+const results: MigrationResult[] = [];
+
+// Look for migrations in the new core
+const migrationsDir = path.join(newCorePath, 'migrations');
+
+if (!fs.existsSync(migrationsDir)) {
+  console.log(JSON.stringify({ migrationsRun: 0, results: [] }, null, 2));
+  process.exit(0);
+}
+
+// Discover migration directories (version-named)
+const entries = fs.readdirSync(migrationsDir, { withFileTypes: true });
+const migrationVersions = entries
+  .filter((e) => e.isDirectory() && /^\d+\.\d+\.\d+$/.test(e.name))
+  .map((e) => e.name)
+  .filter(
+    (v) =>
+      compareSemver(v, fromVersion) > 0 && compareSemver(v, toVersion) <= 0,
+  )
+  .sort(compareSemver);
+
+const projectRoot = process.cwd();
+
+for (const version of migrationVersions) {
+  const migrationIndex = path.join(migrationsDir, version, 'index.ts');
+  if (!fs.existsSync(migrationIndex)) {
+    results.push({
+      version,
+      success: false,
+      error: `Migration ${version}/index.ts not found`,
+    });
+    continue;
+  }
+
+  try {
+    const tsxArgs = tsxBin.endsWith('npx')
+      ? ['tsx', migrationIndex, projectRoot]
+      : [migrationIndex, projectRoot];
+    execFileSync(tsxBin, tsxArgs, {
+      stdio: 'pipe',
+      cwd: projectRoot,
+      timeout: 120_000,
+    });
+    results.push({ version, success: true });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    results.push({ version, success: false, error: message });
+  }
+}
+
+console.log(
+  JSON.stringify({ migrationsRun: results.length, results }, null, 2),
+);
+
+// Exit with error if any migration failed
+if (results.some((r) => !r.success)) {
+  process.exit(1);
+}

package/setup/container.ts

@@ -0,0 +1,144 @@
+/**
+ * Step: container — Build container image and verify with test run.
+ * Replaces 03-setup-container.sh
+ */
+import { execSync } from 'child_process';
+import path from 'path';
+
+import { logger } from '../src/logger.js';
+import { commandExists } from './platform.js';
+import { emitStatus } from './status.js';
+
+function parseArgs(args: string[]): { runtime: string } {
+  let runtime = '';
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--runtime' && args[i + 1]) {
+      runtime = args[i + 1];
+      i++;
+    }
+  }
+  return { runtime };
+}
+
+export async function run(args: string[]): Promise<void> {
+  const projectRoot = process.cwd();
+  const { runtime } = parseArgs(args);
+  const image = 'nanoclaw-agent:latest';
+  const logFile = path.join(projectRoot, 'logs', 'setup.log');
+
+  if (!runtime) {
+    emitStatus('SETUP_CONTAINER', {
+      RUNTIME: 'unknown',
+      IMAGE: image,
+      BUILD_OK: false,
+      TEST_OK: false,
+      STATUS: 'failed',
+      ERROR: 'missing_runtime_flag',
+      LOG: 'logs/setup.log',
+    });
+    process.exit(4);
+  }
+
+  // Validate runtime availability
+  if (runtime === 'apple-container' && !commandExists('container')) {
+    emitStatus('SETUP_CONTAINER', {
+      RUNTIME: runtime,
+      IMAGE: image,
+      BUILD_OK: false,
+      TEST_OK: false,
+      STATUS: 'failed',
+      ERROR: 'runtime_not_available',
+      LOG: 'logs/setup.log',
+    });
+    process.exit(2);
+  }
+
+  if (runtime === 'docker') {
+    if (!commandExists('docker')) {
+      emitStatus('SETUP_CONTAINER', {
+        RUNTIME: runtime,
+        IMAGE: image,
+        BUILD_OK: false,
+        TEST_OK: false,
+        STATUS: 'failed',
+        ERROR: 'runtime_not_available',
+        LOG: 'logs/setup.log',
+      });
+      process.exit(2);
+    }
+    try {
+      execSync('docker info', { stdio: 'ignore' });
+    } catch {
+      emitStatus('SETUP_CONTAINER', {
+        RUNTIME: runtime,
+        IMAGE: image,
+        BUILD_OK: false,
+        TEST_OK: false,
+        STATUS: 'failed',
+        ERROR: 'runtime_not_available',
+        LOG: 'logs/setup.log',
+      });
+      process.exit(2);
+    }
+  }
+
+  if (!['apple-container', 'docker'].includes(runtime)) {
+    emitStatus('SETUP_CONTAINER', {
+      RUNTIME: runtime,
+      IMAGE: image,
+      BUILD_OK: false,
+      TEST_OK: false,
+      STATUS: 'failed',
+      ERROR: 'unknown_runtime',
+      LOG: 'logs/setup.log',
+    });
+    process.exit(4);
+  }
+
+  const buildCmd =
+    runtime === 'apple-container' ? 'container build' : 'docker build';
+  const runCmd = runtime === 'apple-container' ? 'container' : 'docker';
+
+  // Build
+  let buildOk = false;
+  logger.info({ runtime }, 'Building container');
+  try {
+    execSync(`${buildCmd} -t ${image} .`, {
+      cwd: path.join(projectRoot, 'container'),
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    buildOk = true;
+    logger.info('Container build succeeded');
+  } catch (err) {
+    logger.error({ err }, 'Container build failed');
+  }
+
+  // Test
+  let testOk = false;
+  if (buildOk) {
+    logger.info('Testing container');
+    try {
+      const output = execSync(
+        `echo '{}' | ${runCmd} run -i --rm --entrypoint /bin/echo ${image} "Container OK"`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] },
+      );
+      testOk = output.includes('Container OK');
+      logger.info({ testOk }, 'Container test result');
+    } catch {
+      logger.error('Container test failed');
+    }
+  }
+
+  const status = buildOk && testOk ? 'success' : 'failed';
+
+  emitStatus('SETUP_CONTAINER', {
+    RUNTIME: runtime,
+    IMAGE: image,
+    BUILD_OK: buildOk,
+    TEST_OK: testOk,
+    STATUS: status,
+    LOG: 'logs/setup.log',
+  });
+
+  if (status === 'failed') process.exit(1);
+}

package/setup/environment.test.ts

@@ -0,0 +1,121 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import fs from 'fs';
+
+import Database from 'better-sqlite3';
+
+/**
+ * Tests for the environment check step.
+ *
+ * Verifies: config detection, Docker/AC detection, DB queries.
+ */
+
+describe('environment detection', () => {
+  it('detects platform correctly', async () => {
+    const { getPlatform } = await import('./platform.js');
+    const platform = getPlatform();
+    expect(['macos', 'linux', 'unknown']).toContain(platform);
+  });
+});
+
+describe('registered groups DB query', () => {
+  let db: Database.Database;
+
+  beforeEach(() => {
+    db = new Database(':memory:');
+    db.exec(`CREATE TABLE IF NOT EXISTS registered_groups (
+      jid TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      folder TEXT NOT NULL UNIQUE,
+      trigger_pattern TEXT NOT NULL,
+      added_at TEXT NOT NULL,
+      container_config TEXT,
+      requires_trigger INTEGER DEFAULT 1
+    )`);
+  });
+
+  it('returns 0 for empty table', () => {
+    const row = db
+      .prepare('SELECT COUNT(*) as count FROM registered_groups')
+      .get() as { count: number };
+    expect(row.count).toBe(0);
+  });
+
+  it('returns correct count after inserts', () => {
+    db.prepare(
+      `INSERT INTO registered_groups (jid, name, folder, trigger_pattern, added_at, requires_trigger)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+    ).run(
+      '123@g.us',
+      'Group 1',
+      'group-1',
+      '@Andy',
+      '2024-01-01T00:00:00.000Z',
+      1,
+    );
+
+    db.prepare(
+      `INSERT INTO registered_groups (jid, name, folder, trigger_pattern, added_at, requires_trigger)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+    ).run(
+      '456@g.us',
+      'Group 2',
+      'group-2',
+      '@Andy',
+      '2024-01-01T00:00:00.000Z',
+      1,
+    );
+
+    const row = db
+      .prepare('SELECT COUNT(*) as count FROM registered_groups')
+      .get() as { count: number };
+    expect(row.count).toBe(2);
+  });
+});
+
+describe('credentials detection', () => {
+  it('detects ANTHROPIC_API_KEY in env content', () => {
+    const content =
+      'SOME_KEY=value\nANTHROPIC_API_KEY=sk-ant-test123\nOTHER=foo';
+    const hasCredentials =
+      /^(CLAUDE_CODE_OAUTH_TOKEN|ANTHROPIC_API_KEY)=/m.test(content);
+    expect(hasCredentials).toBe(true);
+  });
+
+  it('detects CLAUDE_CODE_OAUTH_TOKEN in env content', () => {
+    const content = 'CLAUDE_CODE_OAUTH_TOKEN=token123';
+    const hasCredentials =
+      /^(CLAUDE_CODE_OAUTH_TOKEN|ANTHROPIC_API_KEY)=/m.test(content);
+    expect(hasCredentials).toBe(true);
+  });
+
+  it('returns false when no credentials', () => {
+    const content = 'ASSISTANT_NAME="Andy"\nOTHER=foo';
+    const hasCredentials =
+      /^(CLAUDE_CODE_OAUTH_TOKEN|ANTHROPIC_API_KEY)=/m.test(content);
+    expect(hasCredentials).toBe(false);
+  });
+});
+
+describe('Docker detection logic', () => {
+  it('commandExists returns boolean', async () => {
+    const { commandExists } = await import('./platform.js');
+    expect(typeof commandExists('docker')).toBe('boolean');
+    expect(typeof commandExists('nonexistent_binary_xyz')).toBe('boolean');
+  });
+});
+
+describe('channel auth detection', () => {
+  it('detects non-empty auth directory', () => {
+    const hasAuth = (authDir: string) => {
+      try {
+        return fs.existsSync(authDir) && fs.readdirSync(authDir).length > 0;
+      } catch {
+        return false;
+      }
+    };
+
+    // Non-existent directory
+    expect(hasAuth('/tmp/nonexistent_auth_dir_xyz')).toBe(false);
+  });
+});
+

package/setup/environment.ts

@@ -0,0 +1,94 @@
+/**
+ * Step: environment — Detect OS, Node, container runtimes, existing config.
+ * Replaces 01-check-environment.sh
+ */
+import fs from 'fs';
+import path from 'path';
+
+import Database from 'better-sqlite3';
+
+import { STORE_DIR } from '../src/config.js';
+import { logger } from '../src/logger.js';
+import { commandExists, getPlatform, isHeadless, isWSL } from './platform.js';
+import { emitStatus } from './status.js';
+
+export async function run(_args: string[]): Promise<void> {
+  const projectRoot = process.cwd();
+
+  logger.info('Starting environment check');
+
+  const platform = getPlatform();
+  const wsl = isWSL();
+  const headless = isHeadless();
+
+  // Check Apple Container
+  let appleContainer: 'installed' | 'not_found' = 'not_found';
+  if (commandExists('container')) {
+    appleContainer = 'installed';
+  }
+
+  // Check Docker
+  let docker: 'running' | 'installed_not_running' | 'not_found' = 'not_found';
+  if (commandExists('docker')) {
+    try {
+      const { execSync } = await import('child_process');
+      execSync('docker info', { stdio: 'ignore' });
+      docker = 'running';
+    } catch {
+      docker = 'installed_not_running';
+    }
+  }
+
+  // Check existing config
+  const hasEnv = fs.existsSync(path.join(projectRoot, '.env'));
+
+  const authDir = path.join(projectRoot, 'store', 'auth');
+  const hasAuth = fs.existsSync(authDir) && fs.readdirSync(authDir).length > 0;
+
+  let hasRegisteredGroups = false;
+  // Check JSON file first (pre-migration)
+  if (fs.existsSync(path.join(projectRoot, 'data', 'registered_groups.json'))) {
+    hasRegisteredGroups = true;
+  } else {
+    // Check SQLite directly using better-sqlite3 (no sqlite3 CLI needed)
+    const dbPath = path.join(STORE_DIR, 'messages.db');
+    if (fs.existsSync(dbPath)) {
+      try {
+        const db = new Database(dbPath, { readonly: true });
+        const row = db
+          .prepare('SELECT COUNT(*) as count FROM registered_groups')
+          .get() as { count: number };
+        if (row.count > 0) hasRegisteredGroups = true;
+        db.close();
+      } catch {
+        // Table might not exist yet
+      }
+    }
+  }
+
+  logger.info(
+    {
+      platform,
+      wsl,
+      appleContainer,
+      docker,
+      hasEnv,
+      hasAuth,
+      hasRegisteredGroups,
+    },
+    'Environment check complete',
+  );
+
+  emitStatus('CHECK_ENVIRONMENT', {
+    PLATFORM: platform,
+    IS_WSL: wsl,
+    IS_HEADLESS: headless,
+    APPLE_CONTAINER: appleContainer,
+    DOCKER: docker,
+    HAS_ENV: hasEnv,
+    HAS_AUTH: hasAuth,
+    HAS_REGISTERED_GROUPS: hasRegisteredGroups,
+    STATUS: 'success',
+    LOG: 'logs/setup.log',
+  });
+}