felo-ai 0.2.47 → 0.2.49

package/felo-superAgent/scripts/run_style_library.mjs

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+
+const DEFAULT_API_BASE = 'https://openapi.felo.ai';
+const DEFAULT_TIMEOUT_SEC = 60;
+
+const VALID_CATEGORIES = ['TWITTER', 'INSTAGRAM', 'LEMON8', 'NOTECOM', 'WEBSITE', 'IMAGE'];
+
+function usage() {
+  console.error(
+    [
+      'Usage:',
+      '  node felo-superAgent/scripts/run_style_library.mjs --category <category> [options]',
+      '',
+      'Options:',
+      '  --category <category>        Style category (required)',
+      `                               One of: ${VALID_CATEGORIES.join(', ')}`,
+      '  --accept-language <lang>     Language for labels/tags (e.g. en, zh-Hans, ja). Default: en',
+      '  --json                       Output raw JSON',
+      '  --timeout <seconds>          Request timeout, default 60',
+      '  --help                       Show this help',
+    ].join('\n')
+  );
+}
+
+function parseArgs(argv) {
+  const out = {
+    category: '',
+    acceptLanguage: 'en',
+    json: false,
+    timeoutSec: DEFAULT_TIMEOUT_SEC,
+    help: false,
+  };
+
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') {
+      out.help = true;
+    } else if (a === '--json' || a === '-j') {
+      out.json = true;
+    } else if (a === '--category' || a === '-c') {
+      out.category = (argv[++i] || '').trim().toUpperCase();
+    } else if (a === '--accept-language') {
+      out.acceptLanguage = (argv[++i] || 'en').trim();
+    } else if (a === '--timeout' || a === '-t') {
+      const n = parseInt(argv[++i] || '', 10);
+      if (Number.isFinite(n) && n > 0) out.timeoutSec = n;
+    }
+  }
+
+  return out;
+}
+
+function getMessage(payload) {
+  return payload?.message || payload?.error || payload?.msg || payload?.code || 'Unknown error';
+}
+
+function isApiError(payload) {
+  const status = payload?.status;
+  const code = payload?.code;
+  if (typeof status === 'string' && status.toLowerCase() === 'error') return true;
+  if (typeof code === 'string' && code && code.toUpperCase() !== 'OK') return true;
+  return false;
+}
+
+/**
+ * Pick the best matching value from a multilingual map object.
+ * Falls back through: exact match → base language (e.g. "zh" for "zh-Hans") → "en" → first available.
+ * Returns an array (may be empty).
+ */
+function pickLangValue(map, lang) {
+  if (!map || typeof map !== 'object') return [];
+  if (map[lang]) return map[lang];
+  // Try base language (e.g. "zh" from "zh-Hans")
+  const base = lang.split('-')[0];
+  if (base !== lang && map[base]) return map[base];
+  // Fallback to English
+  if (map['en']) return map['en'];
+  // Last resort: first available key
+  const first = Object.values(map)[0];
+  return Array.isArray(first) ? first : [];
+}
+
+/**
+ * Format a single style entry into the brand_style_requirement string.
+ * Fields included (null/empty fields are omitted):
+ *   Style name: <name>
+ *   Style labels: <label1, label2>   (from content.labels, language-aware)
+ *   Style DNA: <styleDna>            (from content.styleDna, TWITTER type)
+ *   Cover file ID: <coverFileId>     (omitted if null/empty)
+ */
+function formatStyle(s, lang) {
+  const lines = [];
+
+  // Style name (always present)
+  lines.push(`Style name: ${s.name ?? ''}`);
+
+  const content = s.content ?? {};
+
+  // Style labels — multilingual map (content.labels for TWITTER, content.tags for others)
+  const labelsMap = content.labels ?? content.tags ?? null;
+  if (labelsMap) {
+    const labelArr = pickLangValue(labelsMap, lang);
+    if (labelArr.length > 0) {
+      lines.push(`Style labels: ${labelArr.join(', ')}`);
+    }
+  }
+
+  // Style DNA (TWITTER type)
+  if (typeof content.styleDna === 'string' && content.styleDna.trim()) {
+    lines.push(`Style DNA: ${content.styleDna.trim()}`);
+  }
+
+  // Cover file ID — omit if null/empty
+  const coverId = s.coverFileId ?? s.cover_file_id ?? null;
+  if (coverId) {
+    lines.push(`Cover file ID: ${coverId}`);
+  }
+
+  return lines.join('\n');
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help) {
+    usage();
+    process.exit(0);
+  }
+
+  if (!args.category) {
+    console.error('Error: --category is required');
+    usage();
+    process.exit(1);
+  }
+
+  if (!VALID_CATEGORIES.includes(args.category)) {
+    console.error(`Error: invalid category "${args.category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+    process.exit(1);
+  }
+
+  const apiKey = process.env.FELO_API_KEY?.trim();
+  if (!apiKey) {
+    console.error(
+      'ERROR: FELO_API_KEY not set\n\n' +
+      'To use this script, set FELO_API_KEY:\n' +
+      '  export FELO_API_KEY="your-api-key-here"\n' +
+      'Get your API key from https://felo.ai (Settings -> API Keys).'
+    );
+    process.exit(1);
+  }
+
+  const apiBase = (process.env.FELO_API_BASE?.trim() || DEFAULT_API_BASE).replace(/\/$/, '');
+  const timeoutMs = args.timeoutSec * 1000;
+
+  const params = new URLSearchParams();
+  params.set('category', args.category);
+  const url = `${apiBase}/v2/brand/style-library/list?${params.toString()}`;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const res = await fetch(url, {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+      },
+      signal: controller.signal,
+    });
+
+    let data = {};
+    try {
+      data = await res.json();
+    } catch {
+      data = {};
+    }
+
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}: ${getMessage(data)}`);
+    }
+    if (isApiError(data)) {
+      throw new Error(getMessage(data));
+    }
+
+    const list = data?.data?.list ?? [];
+
+    if (args.json) {
+      console.log(JSON.stringify(data?.data ?? {}, null, 2));
+    } else {
+      if (list.length === 0) {
+        console.log('(No styles found)');
+      } else {
+        // User styles first, then recommended styles
+        const userStyles = list.filter((s) => !s.recommended);
+        const recommendedStyles = list.filter((s) => s.recommended);
+        const allFormatted = [...userStyles, ...recommendedStyles].map((s) => formatStyle(s, args.acceptLanguage));
+        console.log(allFormatted.join('\n\n'));
+      }
+    }
+  } catch (err) {
+    if (err?.name === 'AbortError') {
+      console.error(`Error: Request timed out after ${timeoutMs / 1000}s`);
+    } else {
+      console.error(`Error: ${err?.message || err}`);
+    }
+    process.exit(1);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+main();

package/felo-twitter-writer/README.md

@@ -3,11 +3,12 @@
 Dual-mode Twitter/X writing tool powered by [Felo SuperAgent](https://openapi.felo.ai/docs/api-reference/v2/superagent.html).
 
 **Mode 1** — Fetch tweets from any X account and extract a writing style DNA document.
-**Mode 2** — Compose tweets, threads, or X long-form posts based on a style DNA and topic.
+**Mode 2** — Compose tweets, threads, or X long-form posts, optionally guided by a brand style from your style library.
 
 ## Features
 
-- **Style DNA extraction** — analyze an account's tone, sentence structure, hooks, hashtag strategy, and more
+- **Style DNA extraction** — analyze an account's tone, sentence structure, hooks, hashtag strategy, emoji usage, and more
+- **Brand style selection** — before writing, fetches your TWITTER style library and lets you pick a style; the chosen style is passed to SuperAgent via `--ext` for more accurate output
 - **Tweet creation** — single tweets, threads, or X long-form posts, default 3 versions
 - **Style imitation** — write in the voice of any public X account
 - **Iterative editing** — refine generated content via follow-up conversation
@@ -16,7 +17,7 @@ Dual-mode Twitter/X writing tool powered by [Felo SuperAgent](https://openapi.fe
 
 ## Prerequisites
 
-- [`felo-superAgent`](../felo-superAgent/) skill available
+- [`felo-superAgent`](../felo-superAgent/) skill available (provides `run_superagent.mjs` and `run_style_library.mjs`)
 - [`felo-x-search`](../felo-x-search/) skill available
 - [`felo-livedoc`](../felo-livedoc/) skill available
 
@@ -48,12 +49,11 @@ set FELO_API_KEY=your-api-key-here
 node felo-x-search/scripts/run_x_search.mjs --id "elonmusk" --user --tweets --limit 30
 node felo-x-search/scripts/run_x_search.mjs --id "elonmusk" --user
 
-# Step 2: Get your live_doc_id (list existing, or create one if empty)
+# Step 2: Get your live_doc_id
 node felo-livedoc/scripts/run_livedoc.mjs list --json
 # node felo-livedoc/scripts/run_livedoc.mjs create --name "Twitter Writer" --json
 
 # Step 3: Pass tweets to SuperAgent for style analysis
-# First call in session (no thread_short_id yet):
 node felo-superAgent/scripts/run_superagent.mjs \
   --query "/twitter-writer Analyze the following tweets from @elonmusk and extract a writing style DNA document covering tone, sentence structure, opening hooks, hashtag strategy, and emoji usage.\n\nBio: [BIO]\n\nTweets:\n[TWEETS]" \
   --live-doc-id "LIVE_DOC_ID" \
@@ -61,26 +61,130 @@ node felo-superAgent/scripts/run_superagent.mjs \
   --accept-language en
 ```
 
-### 3) Mode 2 — Create content
+### 3) Mode 2 — Create content with brand style
 
 ```bash
-# New conversation (no thread_short_id in session)
+# Step 1: Fetch your TWITTER style library
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
+# Output example:
+#   Style name: darioamodei
+#   Style labels: Thoughtful long-form essays
+#   Style DNA: # Dario Amodei (@DarioAmodei) Tweet Writing Style DNA
+#   ...
+
+# Step 2: Pass the chosen style via --ext (full Style DNA, do NOT truncate)
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "/twitter-writer Write 3 versions of a tweet about AI trends in an engaging, punchy style." \
+  --query "/twitter-writer Write 3 versions of a tweet about AI trends." \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
+  --ext '{"brand_style_requirement":"Style name: darioamodei\nStyle labels: Thoughtful long-form essays\nStyle DNA: # Dario Amodei...(full content)"}' \
   --accept-language en
 
-# Follow-up after Mode 1 (thread_short_id already exists — pass --thread-id from previous [state] output)
+# Follow-up (thread already exists — no --ext needed)
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "/twitter-writer Based on the style DNA above, write 3 tweets about startups. Keep each under 280 characters." \
+  --query "/twitter-writer Make the second version more concise." \
   --thread-id "THREAD_SHORT_ID" \
   --live-doc-id "LIVE_DOC_ID" \
   --accept-language en
 ```
 
-## When to use (Agent)
+## Style Library
 
-Trigger keywords: `write a tweet`, `twitter thread`, `style DNA`, `imitate tweet style`, `tweet in the style of`, `X account analysis`, `ghostwrite tweets`, `how does [account] write`, `ツイートを書く`, `ツイートスタイル分析`, `スタイルDNA`, `ツイートを模倣`, `〇〇風のツイートを書く`, `ツイートを代筆`, `Xアカウント分析`, `/felo-twitter-writer`.
+The style library (`run_style_library.mjs`) returns your saved TWITTER writing styles. Each entry contains:
 
-See [SKILL.md](SKILL.md) for full agent instructions.
+| Field | Source | Notes |
+|---|---|---|
+| `Style name` | `name` | Always present |
+| `Style labels` | `content.labels[lang]` | Language-aware, comma-separated; omitted if absent |
+| `Style DNA` | `content.styleDna` | Full text — pass completely, never truncate |
+| `Cover file ID` | `coverFileId` | Omitted if null |
+
+User-created styles appear before recommended styles.
+
+```bash
+# List styles in English
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
+
+# List styles in Chinese
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language zh-Hans
+
+# Raw JSON output
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --json
+```
+
+## Using with Claude Code
+
+### Installation
+
+```bash
+# Via ClawHub
+clawhub install felo-twitter-writer
+
+# Manual
+cp -r felo-twitter-writer ~/.claude/skills/
+cp -r felo-superAgent ~/.claude/skills/
+cp -r felo-x-search ~/.claude/skills/
+cp -r felo-livedoc ~/.claude/skills/
+```
+
+### Triggering the skill
+
+Claude Code automatically triggers this skill when it detects tweet-writing or style-analysis intent. You can also invoke it explicitly:
+
+```
+/felo-twitter-writer Analyze @paulg's tweet style and extract a style DNA document
+/felo-twitter-writer Write 3 tweets about AI trends
+/felo-twitter-writer Write a Twitter thread about why most startups fail
+/felo-twitter-writer Write a tweet about AI in the style of @darioamodei
+```
+
+### What Claude does automatically
+
+When you ask Claude to write tweets (Mode 2, new conversation):
+
+1. **Fetches your TWITTER style library** — runs `run_style_library.mjs --category TWITTER`
+2. **Presents style options** — shows names grouped as "Your styles" / "Recommended styles" plus a "No preference" option
+3. **Waits for your choice** — then calls SuperAgent with the full style block in `--ext`
+4. **Streams the result** — answer appears in real time; follow-ups reuse the thread without re-fetching styles
+
+If the style library is empty, Claude skips the selection step silently and proceeds without `--ext`.
+
+### Example conversation
+
+```
+You:    Write a Twitter thread about why most startups fail
+
+Claude: Here are the available Twitter writing styles — choosing one will make
+        the output more accurate:
+
+        [Your styles]
+        1. My Bold Voice
+
+        [Recommended styles]
+        2. darioamodei
+
+        0. No preference — use default style
+
+You:    1
+
+Claude: [streams the thread in "My Bold Voice" style in real time]
+
+You:    Make the hook tweet more provocative
+
+Claude: [follow-up — no style re-selection needed]
+```
+
+## Trigger keywords
+
+English: `write a tweet`, `draft a tweet`, `twitter thread`, `X article`, `style DNA`, `imitate tweet style`, `tweet in the style of`, `write like [account]`, `X account analysis`, `ghostwrite tweets`, `how does [account] write`
+
+Japanese: `ツイートを書く`, `ツイートスタイル分析`, `スタイルDNA`, `ツイートを模倣`, `Xアカウント分析`, `〇〇風のツイートを書く`, `ツイートを代筆`
+
+Explicit command: `/felo-twitter-writer`
+
+## References
+
+- [SKILL.md](SKILL.md) — full agent instructions and decision logic
+- [felo-superAgent README](../felo-superAgent/README.md) — SuperAgent usage and style library script
+- [Felo Open Platform](https://openapi.felo.ai/docs/)
+- [Get API Key](https://felo.ai) (Settings → API Keys)