create-ironclaws 1.0.0

package/template/setup-agents.sh

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+# setup-agents.sh — Register all NanoClaw agents from agents.yaml.
+#
+# Reads agents.yaml and registers every agent whose channel ID env var is set.
+# Skips agents with no channel ID — safe to re-run at any time (idempotent).
+#
+# Usage:
+#   # Register all agents you have channel IDs for:
+#   ALERT_CHANNEL_ID=C... DEPS_CHANNEL_ID=C... ./setup-agents.sh
+#
+#   # Register just one new agent (others already registered, will be re-registered safely):
+#   EXPENSE_CHANNEL_ID=C... ./setup-agents.sh
+#
+# To add a new agent: add an entry in agents.yaml, set its channel ID env var, run this.
+# No new scripts needed.
+#
+# Channel IDs: right-click channel in Slack → View channel details → scroll to bottom.
+# DM IDs: open DM in Slack, check URL (starts with D...).
+
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+if ! command -v python3 &>/dev/null; then
+  echo "ERROR: python3 required to parse agents.yaml"
+  exit 1
+fi
+
+# Parse agents.yaml with Python (no yq dependency needed)
+AGENTS=$(python3 - << 'PYEOF'
+import yaml, os, sys, json
+
+with open("agents.yaml") as f:
+    config = yaml.safe_load(f)
+
+for agent in config.get("agents", []):
+    channel_env = agent.get("channel_env", "")
+    channel_id = os.environ.get(channel_env, "").strip()
+
+    if not channel_id:
+        continue  # Skip agents with no channel ID set
+
+    print(json.dumps({
+        "folder":           agent["folder"],
+        "name":             agent["name"],
+        "trigger":          agent.get("trigger", "@Argus"),
+        "channel_id":       channel_id,
+        "requires_trigger": agent.get("requires_trigger", False),
+        "is_main":          agent.get("is_main", False),
+        "onecli_id":        agent.get("onecli_id", ""),
+        "onecli_secrets":   agent.get("onecli_secrets", []),
+    }))
+PYEOF
+)
+
+if [ -z "$AGENTS" ]; then
+  echo "No agents to register — set at least one channel ID env var."
+  echo ""
+  echo "Example:"
+  echo "  ALERT_CHANNEL_ID=C... ./setup-agents.sh"
+  echo ""
+  echo "Available agents (from agents.yaml):"
+  python3 -c "
+import yaml
+with open('agents.yaml') as f:
+    config = yaml.safe_load(f)
+for a in config.get('agents', []):
+    print(f\"  {a['folder']:30s} → {a['channel_env']}\")
+"
+  exit 0
+fi
+
+REGISTERED=0
+SKIPPED=0
+
+while IFS= read -r agent_json; do
+  FOLDER=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['folder'])")
+  NAME=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['name'])")
+  TRIGGER=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['trigger'])")
+  CHANNEL_ID=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['channel_id'])")
+  IS_MAIN=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print('true' if d['is_main'] else 'false')")
+  ONECLI_ID=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['onecli_id'])")
+  ONECLI_SECRETS=$(echo "$agent_json" | python3 -c "import json,sys; d=json.load(sys.stdin); print(' '.join(d['onecli_secrets']))")
+
+  echo "Registering ${NAME} (${FOLDER}) → slack:${CHANNEL_ID}..."
+
+  # Build register command
+  REGISTER_ARGS=(
+    --jid "slack:${CHANNEL_ID}"
+    --name "${NAME}"
+    --trigger "${TRIGGER}"
+    --folder "${FOLDER}"
+    --channel slack
+    --no-trigger-required
+  )
+  [ "$IS_MAIN" = "true" ] && REGISTER_ARGS+=(--is-main)
+
+  npx tsx setup/index.ts --step register -- "${REGISTER_ARGS[@]}"
+
+  # Register in OneCLI if docker is available (VM setup)
+  if command -v docker &>/dev/null && docker ps &>/dev/null 2>&1; then
+    RAND_TOKEN=$(openssl rand -hex 20)
+    EXISTING=$(docker exec onecli-postgres-1 psql -U onecli -d onecli -t -c \
+      "SELECT COUNT(*) FROM agents WHERE name='${FOLDER}';" 2>/dev/null | tr -d ' \n' || echo "0")
+
+    if [ "$EXISTING" = "0" ]; then
+      AGENT_ID="${ONECLI_ID:-nanoclaw-${FOLDER}}"
+      # Try new schema (account_id) first, fall back to old schema (project_id)
+      docker exec onecli-postgres-1 psql -U onecli -d onecli -c \
+        "INSERT INTO agents (id, name, access_token, identifier, secret_mode, account_id, created_at, updated_at)
+         SELECT '${AGENT_ID}', '${FOLDER}', 'aoc_${RAND_TOKEN}', '${FOLDER}', 'selective', id, NOW(), NOW()
+         FROM accounts LIMIT 1
+         ON CONFLICT (id) DO NOTHING;" > /dev/null 2>&1 || \
+      docker exec onecli-postgres-1 psql -U onecli -d onecli -c \
+        "INSERT INTO agents (id, name, access_token, identifier, secret_mode, project_id, created_at, updated_at)
+         VALUES ('${AGENT_ID}', '${FOLDER}', 'aoc_${RAND_TOKEN}', '${FOLDER}', 'selective',
+                 (SELECT id FROM projects LIMIT 1), NOW(), NOW())
+         ON CONFLICT (id) DO NOTHING;" > /dev/null 2>&1 || true
+    fi
+
+    # Link OneCLI secrets
+    for secret in $ONECLI_SECRETS; do
+      docker exec onecli-postgres-1 psql -U onecli -d onecli -c "
+        INSERT INTO agent_secrets (agent_id, secret_id, created_at, updated_at)
+        SELECT a.id, s.id, NOW(), NOW()
+        FROM agents a, secrets s
+        WHERE a.name = '${FOLDER}' AND s.name = '${secret}'
+        ON CONFLICT DO NOTHING;" > /dev/null 2>&1 || true
+    done
+  fi
+
+  REGISTERED=$((REGISTERED + 1))
+
+done <<< "$AGENTS"
+
+echo ""
+echo "Done. Registered ${REGISTERED} agent(s)."
+if [ $SKIPPED -gt 0 ]; then
+  echo "Skipped ${SKIPPED} agent(s) (no channel ID set)."
+fi
+echo ""
+echo "Next: restart NanoClaw to pick up the new registrations."

package/template/src/channels/index.ts

@@ -0,0 +1,13 @@
+// Channel self-registration barrel file.
+// Each import triggers the channel module's registerChannel() call.
+
+// discord
+
+// gmail
+
+// slack
+import './slack.js';
+
+// telegram
+
+// whatsapp

package/template/src/channels/registry.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+
+import {
+  registerChannel,
+  getChannelFactory,
+  getRegisteredChannelNames,
+} from './registry.js';
+
+// The registry is module-level state, so we need a fresh module per test.
+// We use dynamic import with cache-busting to isolate tests.
+// However, since vitest runs each file in its own context and we control
+// registration order, we can test the public API directly.
+
+describe('channel registry', () => {
+  // Note: registry is shared module state across tests in this file.
+  // Tests are ordered to account for cumulative registrations.
+
+  it('getChannelFactory returns undefined for unknown channel', () => {
+    expect(getChannelFactory('nonexistent')).toBeUndefined();
+  });
+
+  it('registerChannel and getChannelFactory round-trip', () => {
+    const factory = () => null;
+    registerChannel('test-channel', factory);
+    expect(getChannelFactory('test-channel')).toBe(factory);
+  });
+
+  it('getRegisteredChannelNames includes registered channels', () => {
+    registerChannel('another-channel', () => null);
+    const names = getRegisteredChannelNames();
+    expect(names).toContain('test-channel');
+    expect(names).toContain('another-channel');
+  });
+
+  it('later registration overwrites earlier one', () => {
+    const factory1 = () => null;
+    const factory2 = () => null;
+    registerChannel('overwrite-test', factory1);
+    registerChannel('overwrite-test', factory2);
+    expect(getChannelFactory('overwrite-test')).toBe(factory2);
+  });
+});

package/template/src/channels/registry.ts

@@ -0,0 +1,28 @@
+import {
+  Channel,
+  OnInboundMessage,
+  OnChatMetadata,
+  RegisteredGroup,
+} from '../types.js';
+
+export interface ChannelOpts {
+  onMessage: OnInboundMessage;
+  onChatMetadata: OnChatMetadata;
+  registeredGroups: () => Record<string, RegisteredGroup>;
+}
+
+export type ChannelFactory = (opts: ChannelOpts) => Channel | null;
+
+const registry = new Map<string, ChannelFactory>();
+
+export function registerChannel(name: string, factory: ChannelFactory): void {
+  registry.set(name, factory);
+}
+
+export function getChannelFactory(name: string): ChannelFactory | undefined {
+  return registry.get(name);
+}
+
+export function getRegisteredChannelNames(): string[] {
+  return [...registry.keys()];
+}