clawcupid-agent 0.0.1

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { execa } from 'execa';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ZipFile } from 'yazl';
+function usage() {
+    console.log('Usage: clawcupid-agent <install|pack> [--out <path>]');
+    process.exit(1);
+}
+async function ensureOpenclaw() {
+    try {
+        await execa('openclaw', ['--version'], { stdio: 'ignore' });
+    }
+    catch {
+        throw new Error('openclaw CLI not found. Install OpenClaw first.');
+    }
+}
+async function addDir(zip, dir, prefix) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const e of entries) {
+        const abs = path.join(dir, e.name);
+        const rel = prefix ? `${prefix}/${e.name}` : e.name;
+        if (e.isDirectory()) {
+            await addDir(zip, abs, rel);
+        }
+        else if (e.isFile()) {
+            zip.addFile(abs, rel);
+        }
+    }
+}
+async function packSkill(outPath) {
+    const zip = new ZipFile();
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const skillDir = path.resolve(__dirname, '..', 'skill');
+    // Skill zip must contain a root folder named after the skill
+    await addDir(zip, skillDir, 'clawcupid-agent');
+    await fs.mkdir(path.dirname(outPath), { recursive: true });
+    const writeStream = (await import('node:fs')).createWriteStream(outPath);
+    const done = new Promise((resolve, reject) => {
+        writeStream.on('close', () => resolve());
+        writeStream.on('error', reject);
+    });
+    zip.outputStream.pipe(writeStream);
+    zip.end();
+    await done;
+}
+function getFlag(args, name) {
+    const i = args.indexOf(name);
+    if (i === -1)
+        return undefined;
+    return args[i + 1];
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const cmd = args[0];
+    if (!cmd)
+        usage();
+    if (cmd === 'pack') {
+        const out = getFlag(args, '--out') ?? path.join(process.cwd(), 'clawcupid-agent.skill');
+        await packSkill(out);
+        console.log('Packed:', out);
+        return;
+    }
+    if (cmd === 'install') {
+        await ensureOpenclaw();
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'clawcupid-agent-'));
+        const skillPath = path.join(tmp, 'clawcupid-agent.skill');
+        await packSkill(skillPath);
+        // Install into OpenClaw
+        await execa('openclaw', ['hub', 'install', skillPath], { stdio: 'inherit' });
+        await execa('openclaw', ['gateway', 'restart'], { stdio: 'inherit' });
+        console.log('Installed clawcupid-agent skill.');
+        console.log('Next: in Telegram, say: clawcupid install');
+        return;
+    }
+    usage();
+}
+main().catch((err) => {
+    console.error(String(err?.message ?? err));
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "clawcupid-agent",
+  "version": "0.0.1",
+  "description": "ClawCupid agent skill installer for OpenClaw (installs local .skill via openclaw hub install).",
+  "type": "module",
+  "bin": {
+    "clawcupid-agent": "dist/cli.js"
+  },
+  "files": [
+    "dist/**",
+    "skill/**"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "echo 'no lint yet'",
+    "test": "echo 'no tests yet'"
+  },
+  "dependencies": {
+    "execa": "^9.6.0",
+    "yazl": "^3.3.1"
+  },
+  "devDependencies": {
+    "@types/yazl": "^3.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: clawcupid-agent
+description: "ClawCupid 사용자 에이전트 스킬. 사용자가 Clawdbot(텔레그램 등)에서 'clawcupid link <CODE>'로 채널(to/chatId)을 ClawCupid 서버에 연결(바인딩)하고, 이후 큐피드 프로필 수집/매칭/미션 진행을 대화형으로 운영한다. 'clawcupid link', '큐피드', '매칭 서비스 시작', '미션', '커플 1일차/7일차', '동의 링크' 요청이 나오면 사용."
+---
+
+# ClawCupid Agent 운영 규칙
+
+## 0) 기본 전제
+- 사용자는 **개인 PC의 Clawdbot Gateway**를 운용하고, Telegram 연동이 되어 있음.
+- ClawCupid 서버는 tailnet을 통해 사용자 Gateway의 `/hooks/agent`를 호출해 메시지를 발송한다.
+- 버튼 액션은 최소화한다. **최후 수락/연락처 공개 동의는 웹 링크에서만** 진행한다.
+
+## 1) 필수 커맨드: `clawcupid link <CODE>`
+목적: 사용자의 현재 대화 채널을 ClawCupid 계정에 연결한다.
+
+### 1.1 사용자 입력 파싱
+- 사용자가 보낸 메시지가 아래 형식이면 링크로 처리한다.
+  - `clawcupid link <CODE>`
+- `<CODE>` 예시: `CC-...` (서버가 발급한 1회용 코드)
+
+### 1.2 서버 등록(POST)
+- 기본 API: `process.env.CLAWCUPID_API` (없으면 사용자가 제공한 가이드 URL을 사용)
+- 엔드포인트: `POST /api/callback/channel/register`
+- payload:
+  - `code`: <CODE>
+  - `command`: "clawcupid link"
+  - `channel`: "telegram" (또는 현재 채널명)
+  - `to`: **현재 대화의 to/chatId**
+
+### 1.2.1 Telegram DM에서 `to(chatId)` 얻는 규칙(MVP)
+- Clawdbot이 사용자 메시지 앞에 붙이는 메타 라인(예: `... id:118032563 ...`)이 포함되는 경우가 많다.
+- Telegram DM에서는 보통 `to(chatId) == 사용자 telegram id`이므로, 아래 우선순위로 추출한다:
+  1) 사용자의 원문 메시지(메타 포함)에서 `id:<digits>` 패턴 추출 → `to`로 사용
+  2) 추출 실패 시 사용자에게 “텔레그램 ID(숫자)”를 1회만 물어보고 저장(추후 자동화)
+
+실행은 스크립트 사용을 우선한다.
+- `scripts/register_channel.mjs`
+
+예시(에이전트가 exec로 실행):
+- raw 파싱 자동:
+  - `node skills/clawcupid-agent/scripts/register_channel.mjs --api <API> --raw "<사용자 메시지 원문>"`
+- 명시 지정:
+  - `node skills/clawcupid-agent/scripts/register_channel.mjs --api <API> --code <CODE> --channel telegram --to <chatId>`
+
+### 1.3 사용자에게 응답
+- 성공 시:
+  - `[ClawCupid] linked. 이제 “큐피드에게 매칭 서비스 시작한다고 얘기해줘” 라고 말해 주세요.`
+- 실패 시:
+  - 코드 만료/오류를 짧게 설명하고, 웹에서 코드를 재발급받게 안내한다.
+
+## 2) 1단계: 프로필 수집(대화형)
+사용자가 “큐피드 시작/매칭 시작”류를 말하면, 다음을 순서대로 수집한다(최소):
+- 불리는 이름
+- regionCode (나라-도시)
+- timezone (IANA TZ, 예: Asia/Seoul)
+- 나이
+- 나이 허용 범위(min/max)
+- 불호(dealbreakers) 1~3개
+
+각 답변은 서버 API로 저장한다(엔드포인트는 서버 구현에 맞춰 호출).
+
+## 3) 2단계: 미션 루프(요약)
+- Day1: 매칭 성사 즉시 시작 (Mission1 발송)
+- Day2~Day7: 사용자 타임존 기준 10:00 또는 지정 시간
+- 미션 1~5는 순차적으로 연속 입력 가능
+- 피드백은 미션 단위로 동기화(양쪽 답변 완료 후 공개→피드백)
+- 미완료 시 유예(리마인드)
+
+## 4) 7일 완료: 최후 수락(웹)
+- 텔레그램에서 동의 버튼을 쓰지 않는다.
+- 사용자에게 1회성 웹 링크를 제공하고, 웹에서 지난 로그를 전체 열람 후 동의한다.

package/skill/scripts/register_channel.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Register current chat destination (to/chatId) to ClawCupid server for `clawcupid link <CODE>`.
+ *
+ * Designed to be called by an agent via exec.
+ *
+ * Usage (explicit):
+ *   node register_channel.mjs --api http://127.0.0.1:3001 --code CC-xxx --channel telegram --to 118032563
+ *
+ * Usage (auto-parse from raw message text):
+ *   node register_channel.mjs --api http://127.0.0.1:3001 --raw "... id:118032563 ... clawcupid link CC-xxx"
+ */
+
+const args = process.argv.slice(2);
+const get = (k) => {
+  const i = args.indexOf(k);
+  if (i === -1) return undefined;
+  return args[i + 1];
+};
+
+const api = get('--api') || process.env.CLAWCUPID_API || 'http://127.0.0.1:3001';
+const raw = get('--raw');
+let code = get('--code');
+let channel = get('--channel') || 'telegram';
+let to = get('--to');
+
+if (raw) {
+  // Extract telegram id from meta: "id:118032563"
+  const mId = /\bid\s*:\s*(\d{5,})\b/.exec(raw);
+  if (mId) to = to ?? mId[1];
+
+  // Extract code from command: "clawcupid link CC-xxxx"
+  const mCode = /\bclawcupid\s+link\s+(CC-[A-Za-z0-9_-]{4,})\b/i.exec(raw);
+  if (mCode) code = code ?? mCode[1];
+
+  // Channel: best-effort
+  const mCh = /\bchannel\s*=\s*(telegram|whatsapp|signal|discord|slack|imessage)\b/i.exec(raw);
+  if (mCh) channel = channel ?? mCh[1].toLowerCase();
+}
+
+if (!code) {
+  console.error('Missing --code (or failed to parse from --raw)');
+  process.exit(2);
+}
+
+const payload = {
+  channel,
+  to,
+  code,
+  command: 'clawcupid link',
+  ts: Math.floor(Date.now() / 1000),
+};
+
+const res = await fetch(`${api}/api/callback/channel/register`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify(payload),
+});
+
+const text = await res.text();
+if (!res.ok) {
+  console.error('Failed:', res.status, text);
+  process.exit(1);
+}
+
+console.log('OK', text);