elanous 0.2.0 → 0.2.4

package/skills/omni-digest/src/router.ts

@@ -0,0 +1,60 @@
+import type { SummaryFormat, OutputTarget, RouteDecision } from './types.js';
+
+export interface RouterInput {
+  intentText: string;
+  forceFormat?: string;
+  forceTargets?: string;
+}
+
+export function decideRoute(input: RouterInput): RouteDecision {
+  const text = (input.intentText || '').trim();
+  let format: SummaryFormat = 'rich-cards';
+  let targets: OutputTarget[] = ['obsidian'];
+  const reasons: string[] = [];
+
+  // "sum" 키워드 감지 → summarize CLI 우선 사용
+  // "sum full" → summarize CLI가 추출+요약 모두 수행 (Grok 스킵)
+  const summarizeFull = /\bsum\s+full\b/i.test(text);
+  const useSummarize = summarizeFull || /\bsum\b/i.test(text);
+  // enrichWithCrawl: 명시 요청 = 'force', 스마트 자동 판단 = 'smart', 비활성 = false
+  const enrichExplicit = /\bcrawl\b|보강|배경|컨텍스트|맥락|심화|deep\s*dive|enrich|풍부/i.test(text);
+  const enrichWithCrawl = enrichExplicit ? 'force' as const : 'smart' as const;
+
+  if (input.forceFormat) {
+    const valid: SummaryFormat[] = ['essential', 'rich', 'rich-cards'];
+    format = valid.includes(input.forceFormat as SummaryFormat) ? input.forceFormat as SummaryFormat : 'rich-cards';
+    reasons.push(`--format ${input.forceFormat}`);
+  }
+  if (input.forceTargets) {
+    const validT: OutputTarget[] = ['obsidian', 'markdown', 'web', 'web-deploy', 'pdf'];
+    targets = input.forceTargets.split(',').map(t => t.trim()).filter(t => validT.includes(t as OutputTarget)) as OutputTarget[];
+    if (targets.length === 0) targets = ['obsidian'];
+    reasons.push(`--target ${input.forceTargets}`);
+  }
+  if (input.forceFormat || input.forceTargets) {
+    if (summarizeFull) reasons.push('summarize CLI end-to-end');
+    else if (useSummarize) reasons.push('summarize CLI 우선');
+    return { format, targets, reason: reasons.join(', '), useSummarize, summarizeFull, enrichWithCrawl };
+  }
+
+  // Format detection
+  if (/상세|자세히|깊게|detailed|분석|심층|rich(?!\s*card)/i.test(text)) { format = 'rich'; reasons.push('심층 분석'); }
+  else if (/간단히|짧게|요약만|essential|brief|빠르게/i.test(text)) { format = 'essential'; reasons.push('간략 요약'); }
+  else { format = 'rich-cards'; reasons.push('기본 카드형'); }
+
+  // Target detection
+  const det: OutputTarget[] = [];
+  if (/ccv웹/i.test(text))                          { det.push('web-deploy'); reasons.push('ccv웹 배포'); }
+  else if (/cc웹|웹으로|웹페이지/i.test(text))        { det.push('web');        reasons.push('cc웹'); }
+  if (/pdf|PDF로/i.test(text))                       { det.push('pdf');        reasons.push('PDF'); }
+  if (/markdown|md로/i.test(text))                   { det.push('markdown');   reasons.push('마크다운'); }
+
+  const markdownOnly = det.length === 1 && det[0] === 'markdown';
+  if (det.length === 0 || (!markdownOnly && !det.includes('obsidian'))) det.unshift('obsidian');
+  targets = det;
+
+  if (summarizeFull) reasons.push('summarize CLI end-to-end');
+  else if (useSummarize) reasons.push('summarize CLI 우선');
+  if (enrichWithCrawl === 'force') reasons.push('omni-crawl 보강 (명시)');
+  return { format, targets, reason: reasons.join(', '), useSummarize, summarizeFull, enrichWithCrawl };
+}

package/skills/omni-digest/src/summarize.ts

@@ -0,0 +1,87 @@
+/** Grok summarization — unified prompts for all source types + X-specific prompts absorbed from x-to-obsidian */
+
+import { env, requireEnv } from './env.js';
+import { compactText } from './util.js';
+import type { SummaryFormat, TweetMeta, Reply } from './types.js';
+
+/* ── Generic prompts (web, github, docs) ── */
+
+function genericPrompt(format: SummaryFormat, content: string, meta: { title: string; source: string; url?: string }): string {
+  const header = `[중요] 반드시 리포트 본문 시작 전에 아래 2줄을 정확히 출력하세요:
+GENRE: {주장르#세부장르} (Tech, Business, Crypto, 자기개발, 시사 중 택1, 세부장르 포함)
+KEYWORDS: {키워드1}, {키워드2}, {키워드3}`;
+  const footer = `[출처] ${meta.title} (${meta.source})\n${meta.url ? `URL: ${meta.url}` : ''}\n\n[콘텐츠]\n`;
+
+  if (format === 'essential') return `다음 콘텐츠의 간단 요약을 한국어 마크다운으로 작성.\n\n${header}\n\n[Sections]\n1. 🎯 한 줄 결론\n2. ✅ 핵심 포인트 5~8개 불릿\n3. SCQA 각 1줄\n4. 💡 시사점 3~5개\n\n[Style] 핵심 위주, 장황 X\n\n${footer}${compactText(content, 8000)}`;
+  if (format === 'rich') return `다음 콘텐츠의 심층 분석 리포트를 한국어 마크다운으로 작성.\n\n${header}\n\n[Sections]\n1. 🎯 한 줄 결론\n2. ✅ 한눈에 정리 5~8개\n3. 🟪/🟦 카드형 상세 8~16개 (각 3~6문단)\n4. 💡 이렇게 보면 됩니다\n5. ToC, SCQA(상세), Data & Evidence(표), Key Insights 7~10개, Practical Implications\n6. 심층 분석: 논지+근거, 취약점, 비교 포인트\n\n[Style] 밀도 높은 리포트, 표 적극 활용\n\n${footer}${compactText(content, 18000)}`;
+  // rich-cards (default)
+  return `다음 콘텐츠의 카드 스타일 한국어 마크다운 요약 작성. 원문을 안 읽어도 충분히 이해 가능해야.\n\n${header}\n\n[Sections]\n1. 🎯 한 줄 결론\n2. ✅ 한눈에 정리 5~8개\n3. 🟪/🟦 카드형 상세 6~12개 (각 2~5문단)\n4. 💡 이렇게 보면 됩니다\n5. ToC, SCQA, Key Insights, Practical Implications\n\n[Style] 디스코드 카드 스타일, 자연스럽고 상세\n\n${footer}${compactText(content, 16000)}`;
+}
+
+/* ── X post prompts ── */
+
+function xPostPrompt(format: SummaryFormat, meta: TweetMeta, repliesText: string, linksText: string): string {
+  const header = `[중요] 반드시 리포트 본문 시작 전에 아래 2줄을 정확히 출력하세요:
+GENRE: {주장르#세부장르} (Tech, Business, Crypto, 자기개발, 시사 중 택1, 세부장르 포함)
+KEYWORDS: {키워드1}, {키워드2}, {키워드3}`;
+  // 첨부 영상 전사문이 있으면 본문 다음으로 우선순위가 높은 1차 자료로 넣는다
+  const mediaBlock = meta.mediaTranscript
+    ? `\n\n[첨부 미디어 — 영상 전사·이미지·화면 설명 · 1차 자료, 본문과 동등하게 취급할 것]\n${compactText(meta.mediaTranscript, 12000)}`
+    : '';
+  const info = `[포스트 정보]\n- 작성자: ${meta.author}\n- 작성일: ${meta.createdAt}\n- 노출수: ${meta.viewCount} | 좋아요: ${meta.likeCount} | RT: ${meta.retweetCount} | 댓글수: ${meta.replyCount}\n\n[본문]\n${meta.text}${mediaBlock}\n\n[본문 링크]\n${linksText}\n\n[댓글 샘플]\n${repliesText}`;
+
+  if (format === 'essential') return `다음 X 포스트의 간단 요약.\n\n${header}\n\n[Sections] 🎯 한 줄 결론, ✅ 핵심 5~8개, SCQA 각 1줄, 💡 시사점 3~5개\n[Style] 핵심 위주\n\n${info}`;
+  if (format === 'rich') return `다음 X 포스트와 댓글의 심층 분석.\n\n${header}\n\n[Sections] 🎯 한 줄 결론, ✅ 한눈에 정리, 🟪/🟦 카드 8~16개(각 3~6문단), 💡 해석, ToC/SCQA/Comment Analysis/Data & Evidence/Key Insights/Practical Implications, 심층 분석\n[Style] 밀도 높은 리포트, 댓글 부족시 "데이터 제한" 명시\n\n${info}`;
+  return `다음 X 포스트와 댓글의 카드 스타일 요약. 원문+댓글 안 읽어도 이해 가능.\n\n${header}\n\n[Sections] 🎯 한 줄 결론, ✅ 한눈에 정리 5~8개, 🟪/🟦 카드 6~12개(각 2~5문단), 💡 이렇게 보면 됩니다, ToC/SCQA/Comment Analysis/Practical Implications\n[Style] 디스코드 카드, 댓글 부족시 "데이터 제한"\n\n${info}`;
+}
+
+/* ── X article prompt ── */
+
+function xArticlePrompt(format: SummaryFormat, content: string, authorHandle: string): string {
+  const header = `작성자: @${authorHandle}\n\n[중요] 반드시 리포트 본문 시작 전에 아래 2줄을 정확히 출력:\nGENRE: {주장르#세부장르}\nKEYWORDS: {키워드1}, {키워드2}, {키워드3}`;
+  if (format === 'essential') return `다음 X 아티클 간단 요약.\n\n${header}\n\n[Sections] Executive Summary 6~10불릿, SCQA 각 1줄, Key Insights 5개\n[Style] 핵심 위주\n\n[아티클 본문]\n${compactText(content, 10000)}`;
+  if (format === 'rich') return `다음 X 아티클 심층 분석.\n\n${header}\n\n[Sections] ToC, Executive Summary 7~10불릿, SCQA(상세), Detailed Analysis, Data & Evidence(표), Key Insights 7~10개, 심층 분석, Practical Implications\n[Style] 밀도 높은 리포트, 표 활용, 빠짐없이 커버\n\n[아티클 본문]\n${compactText(content, 18000)}`;
+  return `다음 X 아티클 상세 리포트.\n\n${header}\n\n[Sections] ToC, Executive Summary 5불릿, SCQA(불릿), Detailed Analysis(헤딩 다수), Data & Evidence, Key Insights 5~7불릿\n[Style] 간결/정확, 표 활용\n\n[아티클 본문]\n${compactText(content, 16000)}`;
+}
+
+/* ── Grok API caller ── */
+
+async function callGrok(prompt: string): Promise<string> {
+  const apiKey = requireEnv('XAI_API_KEY');
+  const model = env('GROK_MODEL', 'grok-4-1-fast-reasoning');
+  console.log(`  xAI 모델: ${model}`);
+  const res = await fetch('https://api.x.ai/v1/responses', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+    body: JSON.stringify({ model, input: [{ role: 'system', content: '콘텐츠를 심층 분석해 구조화된 한국어 요약을 생성하는 AI.' }, { role: 'user', content: prompt }], temperature: 0.3 }),
+  });
+  if (!res.ok) throw new Error(`Grok API ${res.status}: ${await res.text().catch(() => '')}`);
+  const data = await res.json();
+  for (const item of data.output || []) for (const c of item.content || []) if ((c.type === 'output_text' || c.type === 'text') && c.text) return c.text.trim();
+  throw new Error('요약 응답 파싱 실패');
+}
+
+/* ── Public API ── */
+
+export async function summarizeGeneric(content: string, title: string, source: string, url: string | undefined, format: SummaryFormat): Promise<string> {
+  return callGrok(genericPrompt(format, content, { title, source, url }));
+}
+
+export async function summarizeXPost(meta: TweetMeta, replies: Reply[], allRefLinks: string[], format: SummaryFormat): Promise<string> {
+  const repliesText = replies.length > 0 ? replies.map(r => `- ${r.author} (likes:${r.likes}): ${r.text}`).join('\n') : '- 댓글 없음';
+  const linksText = allRefLinks.length > 0 ? allRefLinks.map(u => `- ${u}`).join('\n') : '- 링크 없음';
+  return callGrok(xPostPrompt(format, meta, repliesText, linksText));
+}
+
+export async function summarizeXArticle(content: string, authorHandle: string, format: SummaryFormat): Promise<string> {
+  return callGrok(xArticlePrompt(format, content, authorHandle));
+}
+
+/* ── Genre/Keywords extractor ── */
+
+export function parseMetaFromSummary(text: string): { genre: string; keywords: string[]; body: string } {
+  let genre = 'General', keywords: string[] = [], body = text;
+  const gm = text.match(/^GENRE:\s*(.+)$/m);   if (gm) { genre = gm[1].trim(); body = body.replace(gm[0], ''); }
+  const km = text.match(/^KEYWORDS:\s*(.+)$/m); if (km) { keywords = km[1].split(',').map(k => k.trim()).filter(Boolean); body = body.replace(km[0], ''); }
+  return { genre, keywords, body: body.replace(/^\s*\n{2,}/g, '\n').trim() };
+}

package/skills/omni-digest/src/types.ts

@@ -0,0 +1,124 @@
+/* ── Source detection ── */
+
+export type SourceType =
+  | 'x-post'
+  | 'x-article'
+  | 'youtube'
+  | 'web'
+  | 'github-repo'
+  | 'github-pr'
+  | 'github-issue'
+  | 'github-commit'
+  | 'local-file'
+  | 'unknown';
+
+export interface DetectedSource {
+  type: SourceType;
+  input: string;
+  owner?: string;
+  repo?: string;
+  ref?: string;
+  /** X URL parsed fields */
+  tweetId?: string;
+  articleId?: string;
+  authorHandle?: string;
+}
+
+/* ── Summary format ── */
+
+export type SummaryFormat =
+  | 'essential'     // 간단 요약
+  | 'rich'          // 심층 분석
+  | 'rich-cards';   // 상세 카드형 (기본)
+
+/* ── Output target ── */
+
+export type OutputTarget =
+  | 'obsidian'
+  | 'markdown'
+  | 'web'
+  | 'web-deploy'
+  | 'pdf';
+
+/* ── Route decision ── */
+
+export interface RouteDecision {
+  format: SummaryFormat;
+  targets: OutputTarget[];
+  reason: string;
+  /** "sum" 키워드 감지 시 summarize CLI 우선 사용 */
+  useSummarize: boolean;
+  /** "sum full" 키워드 시 summarize CLI가 추출+요약 모두 수행 (Grok 스킵) */
+  summarizeFull: boolean;
+  /** omni-crawl 컨텍스트 보강: 'force'=명시 요청, 'smart'=자동 판단(기본), false=비활성 */
+  enrichWithCrawl: 'force' | 'smart' | false;
+}
+
+/* ── X API types ── */
+
+/** 트윗에 첨부된 미디어 (video / animated_gif / photo) */
+export interface TweetMedia {
+  mediaKey: string;
+  type: 'video' | 'animated_gif' | 'photo';
+  /** 재생 길이 (ms) — video/gif만 */
+  durationMs?: number;
+  /** 최고 화질 MP4 직링크 (보관·재생용) — video/gif만 */
+  bestMp4Url?: string;
+  /**
+   * 최저 비트레이트 MP4 직링크 (STT 전용).
+   * 전사는 오디오만 쓰므로 4K를 받으면 수백 MB를 낭비한다 — 반드시 이쪽을 쓴다.
+   */
+  sttMp4Url?: string;
+  previewImageUrl?: string;
+}
+
+export interface TweetMeta {
+  text: string;
+  author: string;
+  authorHandle: string;
+  createdAt: string;
+  conversationId: string;
+  viewCount: string;
+  likeCount: string;
+  retweetCount: string;
+  replyCount: string;
+  bookmarkCount: string;
+  metrics: {
+    impression_count: number;
+    like_count: number;
+    retweet_count: number;
+    reply_count: number;
+    bookmark_count: number;
+  };
+  /** note_tweet(장문) 사용 여부 — true면 text가 280자 제한 없는 전문 */
+  isLongform: boolean;
+  /** 첨부 미디어 */
+  media: TweetMedia[];
+  /** 첨부 영상 STT 전사 결과 (transcribeTweetMedia 실행 시 채워짐) */
+  mediaTranscript?: string;
+}
+
+export interface Reply {
+  text: string;
+  author: string;
+  likes: number;
+  createdAt: string;
+}
+
+/* ── Digest result ── */
+
+export interface DigestResult {
+  markdown: string;
+  title: string;
+  source: DetectedSource;
+  savedPaths: string[];
+  signals: string[];
+}
+
+/* ── Sub-skill format mapping (for youtube-master delegation) ── */
+
+export const FORMAT_TO_SUBSKILL: Record<SummaryFormat, string> = {
+  essential: 'brief',
+  rich: 'detailed',
+  'rich-cards': 'cards',
+};

package/skills/omni-digest/src/util.ts

@@ -0,0 +1,34 @@
+export function safeName(text: string): string {
+  const compact = String(text || 'untitled')
+    .replace(/[\\/:*?"<>|#^\[\]]/g, ' ')
+    .replace(/[^0-9A-Za-z가-힣\s_-]/g, ' ')
+    .replace(/\s+/g, '_')
+    .trim();
+  if (!compact) return 'untitled';
+  return compact.length <= 60 ? compact : compact.substring(0, 60).replace(/_$/, '');
+}
+
+export function dateStamp(d = new Date()): string {
+  return [d.getFullYear(), String(d.getMonth() + 1).padStart(2, '0'), String(d.getDate()).padStart(2, '0')].join('');
+}
+
+export function nowISO(): string {
+  const d = new Date();
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+}
+
+export function nowFull(): string {
+  const d = new Date();
+  return `${nowISO()} ${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}
+
+export function escapeQuotes(text: string): string {
+  return String(text || '').replace(/"/g, '\\"');
+}
+
+export function compactText(text: string, maxLen = 18000): string {
+  if (text.length <= maxLen) return text;
+  const headLen = Math.floor(maxLen * 0.65);
+  const tailLen = maxLen - headLen;
+  return text.slice(0, headLen) + '\n\n[...중간 생략...]\n\n' + text.slice(-tailLen);
+}

package/skills/omni-digest/src/visual.ts

@@ -0,0 +1,129 @@
+/**
+ * X 첨부 미디어의 «시각» 흡수 — 사진 · 영상 화면.
+ *
+ * 전사(media.ts)는 소리만 본다. 말 없는 모션그래픽·화면 데모·표 이미지는 전사가 «MUSIC» 한 줄로
+ * 끝나 내용이 통째로 빠졌다(2026-09-27 · 저장된 메시지 X 5편 실측). 여기서:
+ *   - 사진 → S3 → 노트에 삽입 ⊕ Grok 비전으로 «무엇이 보이나»(표·그래프·화면 글자까지)
+ *   - 영상 → 장면이 바뀌는 프레임(최대 8장) → S3 → 프레임 띠 ⊕ Grok 비전으로 «화면에서 무슨 일이»
+ * 설명 텍스트는 요약 프롬프트에도 넣어 요약이 시각 내용을 반영하게 한다. 실패는 전부 fail-soft(null).
+ */
+
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { env, requireEnv } from './env.js';
+import { downloadVideo } from './media.js';
+import type { TweetMedia } from './types.js';
+
+const MAX_FRAMES = 8;
+const MAX_VIDEO_MS_FOR_FRAMES = Number(env('OMNI_DIGEST_FRAMES_MAX_MS', String(10 * 60 * 1000)));
+
+export interface VisualAbsorb {
+  /** 노트 부록에 붙일 마크다운(이미지·프레임 띠 ⊕ 설명). */
+  markdown: string;
+  /** 요약 프롬프트에 넣을 설명 텍스트. */
+  promptText: string;
+}
+
+// 시각 흡수(이미지·영상 프레임 → 비전 설명)는 이미지를 «공개 URL» 로 올려야 한다 — 버킷은 사용자가 준다(기본값 없음).
+// 없으면 이 항목만 건너뛰고(아래 try/catch 가 줄 하나로 알린다) 본문 요약은 그대로 간다.
+function bucket(): string {
+  const b = env('AWS_S3_BUCKET', '');
+  if (!b) throw new Error('AWS_S3_BUCKET 미설정 — 시각 흡수 건너뜀(.env 에 공개 읽기 버킷을 주면 켜진다)');
+  return b;
+}
+
+function uploadToS3(localPath: string, key: string): string {
+  execFileSync('aws', ['s3', 'cp', localPath, `s3://${bucket()}/${key}`, '--quiet'], { timeout: 60_000, stdio: 'pipe', env: process.env });
+  return `https://${bucket()}.s3.amazonaws.com/${key}`;
+}
+
+async function download(url: string, path: string): Promise<void> {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`download ${res.status}`);
+  writeFileSync(path, Buffer.from(await res.arrayBuffer()));
+}
+
+/** Grok 비전 — 이미지 여러 장 ⊕ 지시. 응답 텍스트(한국어). */
+async function describeImages(imageUrls: string[], instruction: string): Promise<string> {
+  const apiKey = requireEnv('XAI_API_KEY');
+  const model = env('GROK_VISION_MODEL', env('GROK_MODEL', 'grok-4-1-fast-reasoning'));
+  const content = [
+    { type: 'input_text', text: instruction },
+    ...imageUrls.map((u) => ({ type: 'input_image', image_url: u, detail: 'high' })),
+  ];
+  const res = await fetch('https://api.x.ai/v1/responses', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+    body: JSON.stringify({ model, input: [{ role: 'user', content }], temperature: 0.2 }),
+  });
+  if (!res.ok) throw new Error(`Grok vision ${res.status}: ${(await res.text().catch(() => '')).slice(0, 200)}`);
+  const data = await res.json();
+  for (const item of data.output || []) for (const c of item.content || []) if ((c.type === 'output_text' || c.type === 'text') && c.text) return c.text.trim();
+  throw new Error('비전 응답 파싱 실패');
+}
+
+/** 장면 전환 프레임을 뽑는다(모자라면 균등 간격으로 채운다). */
+function extractFrames(videoPath: string, outdir: string, durationMs?: number): string[] {
+  execFileSync('ffmpeg', ['-v', 'error', '-y', '-i', videoPath, '-vf', "select='eq(n\\,0)+gt(scene\\,0.3)',scale='min(1280,iw)':-2",
+    '-fps_mode', 'vfr', '-frames:v', String(MAX_FRAMES), '-q:v', '3', join(outdir, 'scene_%02d.jpg')], { timeout: 180_000, stdio: 'pipe' });
+  let frames = readdirSync(outdir).filter((f) => f.startsWith('scene_')).sort();
+  if (frames.length < 4 && durationMs && durationMs > 0) {
+    const n = Math.min(6, MAX_FRAMES);
+    const fps = (n / (durationMs / 1000)).toFixed(4);
+    execFileSync('ffmpeg', ['-v', 'error', '-y', '-i', videoPath, '-vf', `fps=${fps},scale='min(1280,iw)':-2`, '-frames:v', String(n), '-q:v', '3',
+      join(outdir, 'even_%02d.jpg')], { timeout: 180_000, stdio: 'pipe' });
+    frames = readdirSync(outdir).filter((f) => f.startsWith('even_')).sort();
+  }
+  return frames.map((f) => join(outdir, f));
+}
+
+const PHOTO_INSTRUCTION = '이 이미지(X 게시물 첨부)에 무엇이 보이는지 한국어로 정확히 설명하라. 표·그래프·벤치마크면 수치와 항목을 빠짐없이 옮기고, 화면 캡처면 화면의 글자·버튼·구성을 옮겨라. 추측은 «추정»이라고 표시. 5~12줄.';
+const FRAMES_INSTRUCTION = '다음은 X 게시물 첨부 영상에서 시간 순서로 뽑은 프레임이다. 영상에서 화면에 무슨 일이 일어나는지 한국어로 설명하라 — 장면 흐름, 화면 속 글자·UI·코드·도구 이름, 보여 주려는 결과물. 소리는 모른다. 프레임 번호를 붙여 6~15줄.';
+
+export async function absorbTweetVisuals(media: TweetMedia[], opts: { tweetId: string; log?: (s: string) => void }): Promise<VisualAbsorb | null> {
+  const log = opts.log ?? ((s: string) => console.log(s));
+  const md: string[] = [];
+  const prompt: string[] = [];
+  const work = mkdtempSync(join(tmpdir(), `omni-visual-${opts.tweetId}-`));
+  try {
+    const photos = media.filter((m) => m.type === 'photo' && m.previewImageUrl);
+    for (const [i, p] of photos.entries()) {
+      try {
+        const local = join(work, `photo_${i + 1}.jpg`);
+        await download(`${p.previewImageUrl}${p.previewImageUrl!.includes('?') ? '' : '?name=large'}`, local);
+        const url = uploadToS3(local, `x/media/${opts.tweetId}/photo_${i + 1}.jpg`);
+        const desc = await describeImages([url], PHOTO_INSTRUCTION);
+        md.push(`## 이미지 ${i + 1}\n![이미지 ${i + 1}](${url})\n\n${desc}`);
+        prompt.push(`[첨부 이미지 ${i + 1} 설명]\n${desc}`);
+        log(`  [시각] 이미지 ${i + 1} 흡수`);
+      } catch (e) { log(`  [시각] 이미지 ${i + 1} 실패: ${String(e).slice(0, 120)}`); }
+    }
+    const videos = media.filter((m) => (m.type === 'video' || m.type === 'animated_gif') && (m.bestMp4Url || m.sttMp4Url));
+    for (const [i, v] of videos.entries()) {
+      if (v.durationMs && v.durationMs > MAX_VIDEO_MS_FOR_FRAMES) { log(`  [시각] 영상 ${i + 1} 길어서 프레임 생략`); continue; }
+      try {
+        const dir = join(work, `v${i + 1}`);
+        execFileSync('mkdir', ['-p', dir]);
+        const path = await downloadVideo((v.bestMp4Url || v.sttMp4Url)!, dir);
+        const frames = extractFrames(path, dir, v.durationMs);
+        if (!frames.length) continue;
+        const urls = frames.map((f, j) => uploadToS3(f, `x/media/${opts.tweetId}/v${i + 1}_f${String(j + 1).padStart(2, '0')}.jpg`));
+        const desc = await describeImages(urls, FRAMES_INSTRUCTION);
+        md.push(`## 영상 ${i + 1} 화면 (${urls.length}프레임)\n${urls.map((u, j) => `![프레임 ${j + 1}](${u})`).join(' ')}\n\n${desc}`);
+        prompt.push(`[첨부 영상 ${i + 1} 화면 설명 — 프레임 ${urls.length}장 기반]\n${desc}`);
+        log(`  [시각] 영상 ${i + 1} 프레임 ${urls.length}장 흡수`);
+      } catch (e) { log(`  [시각] 영상 ${i + 1} 실패: ${String(e).slice(0, 120)}`); }
+    }
+  } finally {
+    try { rmSync(work, { recursive: true, force: true }); } catch { /* */ }
+  }
+  if (!md.length) return null;
+  return { markdown: `# 첨부 미디어 (시각)\n\n${md.join('\n\n')}`, promptText: prompt.join('\n\n') };
+}
+
+/** 시험·재흡수용 — 로컬 이미지 한 장을 읽어 data URL 로. */
+export function dataUrl(path: string): string {
+  return `data:image/jpeg;base64,${readFileSync(path).toString('base64')}`;
+}

package/skills/omni-digest/src/x-api.ts

@@ -0,0 +1,151 @@
+/** X(Twitter) API — absorbed from x-to-obsidian */
+
+import { requireEnv } from './env.js';
+import type { TweetMeta, TweetMedia, Reply } from './types.js';
+
+async function xApiFetch(url: string): Promise<any> {
+  const token = requireEnv('BEARER_TOKEN');
+  const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  if (!res.ok) {
+    if (res.status === 401) throw new Error('Bearer Token이 유효하지 않습니다.');
+    if (res.status === 429) throw new Error('API 요청 한도 초과.');
+    throw new Error(`X API error: ${res.status}`);
+  }
+  return res.json();
+}
+
+/** media.variants 중 MP4만 비트레이트 오름차순으로 정렬 (HLS 등은 제외) */
+function sortedMp4s(variants: any[] = []): any[] {
+  return variants
+    .filter(v => v.content_type === 'video/mp4' && v.url)
+    .sort((a, b) => (a.bit_rate || 0) - (b.bit_rate || 0));
+}
+
+function parseMedia(includes: any): TweetMedia[] {
+  return (includes?.media || []).map((m: any): TweetMedia => {
+    const isVideo = m.type === 'video' || m.type === 'animated_gif';
+    const mp4s = isVideo ? sortedMp4s(m.variants) : [];
+    return {
+      mediaKey: m.media_key,
+      type: m.type,
+      durationMs: m.duration_ms,
+      // 최고 화질은 보관용, 최저 화질은 STT용 (4K 4분이면 1GB에 육박한다)
+      bestMp4Url: mp4s.length ? mp4s[mp4s.length - 1].url : undefined,
+      sttMp4Url: mp4s.length ? mp4s[0].url : undefined,
+      previewImageUrl: m.preview_image_url || m.url,
+    };
+  });
+}
+
+export async function fetchTweetMeta(tweetId: string): Promise<TweetMeta> {
+  // note_tweet = 280자 초과 장문 전문 / media.* = 첨부 영상 직링크
+  const url = `https://api.x.com/2/tweets/${tweetId}`
+    + `?tweet.fields=created_at,public_metrics,text,author_id,conversation_id,note_tweet`
+    + `&expansions=author_id,attachments.media_keys`
+    + `&user.fields=username,name`
+    + `&media.fields=type,duration_ms,variants,preview_image_url,url,media_key`;
+  const data = await xApiFetch(url);
+  if (!data.data) throw new Error('트윗 정보를 찾을 수 없습니다.');
+  const tweet = data.data;
+  const user = data.includes?.users?.[0];
+  const m = tweet.public_metrics || {};
+
+  // 장문 트윗이면 note_tweet.text가 전문 (tweet.text는 280자에서 잘림)
+  const noteText: string = tweet.note_tweet?.text || '';
+  const shortText: string = tweet.text || '';
+  const isLongform = noteText.length > shortText.length;
+
+  return {
+    text: isLongform ? noteText : shortText,
+    isLongform,
+    media: parseMedia(data.includes),
+    author: `${user?.name || 'Unknown'} (@${user?.username || 'unknown'})`,
+    authorHandle: user?.username || 'unknown',
+    createdAt: tweet.created_at ? tweet.created_at.split('T')[0] : 'N/A',
+    conversationId: tweet.conversation_id || tweetId,
+    viewCount: m.impression_count ? Number(m.impression_count).toLocaleString() : 'N/A',
+    likeCount: m.like_count ? Number(m.like_count).toLocaleString() : 'N/A',
+    retweetCount: m.retweet_count ? Number(m.retweet_count).toLocaleString() : 'N/A',
+    replyCount: m.reply_count ? Number(m.reply_count).toLocaleString() : 'N/A',
+    bookmarkCount: m.bookmark_count ? Number(m.bookmark_count).toLocaleString() : 'N/A',
+    metrics: { impression_count: m.impression_count || 0, like_count: m.like_count || 0, retweet_count: m.retweet_count || 0, reply_count: m.reply_count || 0, bookmark_count: m.bookmark_count || 0 },
+  };
+}
+
+export async function fetchReplies(conversationId: string): Promise<Reply[]> {
+  try {
+    const url = `https://api.x.com/2/tweets/search/recent?query=conversation_id:${conversationId}&tweet.fields=text,public_metrics,author_id,created_at&expansions=author_id&user.fields=username,name&max_results=30`;
+    const data = await xApiFetch(url);
+    if (!data.data?.length) return [];
+    const users: Record<string, string> = {};
+    for (const u of data.includes?.users || []) users[u.id] = `${u.name} (@${u.username})`;
+    return data.data
+      .filter((r: any) => r.id !== conversationId)
+      .map((r: any) => ({ text: r.text, author: users[r.author_id] || 'Unknown', likes: r.public_metrics?.like_count || 0, createdAt: r.created_at?.split('T')[0] || 'N/A' }))
+      .sort((a: Reply, b: Reply) => b.likes - a.likes)
+      .slice(0, 20);
+  } catch { return []; }
+}
+
+async function resolveUrl(u: string): Promise<string> {
+  try { return (await fetch(u, { method: 'HEAD', redirect: 'follow' })).url || u; } catch { return u; }
+}
+
+function normalizeXUrl(url: string): string {
+  try { const u = new URL(url); u.search = ''; u.hash = ''; return u.toString(); } catch { return url; }
+}
+
+export function isXInternalUrl(url: string): boolean {
+  return /https?:\/\/(?:x\.com|twitter\.com)\/[^\s/]+\/(?:status|article)\/\d+/.test(url);
+}
+
+export function extractXInternalUrls(text: string): string[] {
+  return [...new Set((text.match(/https?:\/\/(?:x\.com|twitter\.com)\/[^\s/]+\/(?:status|article)\/\d+/g) || []).map(normalizeXUrl))];
+}
+
+export async function extractLinks(text: string): Promise<string[]> {
+  const tco = text.match(/https?:\/\/t\.co\/\w+/g) || [];
+  if (!tco.length) return [];
+  return [...new Set((await Promise.all(tco.map(resolveUrl))).map(normalizeXUrl))];
+}
+
+export async function fetchArticleContent(articleUrl: string): Promise<string> {
+  const res = await fetch(`https://r.jina.ai/${articleUrl}`, { headers: { Accept: 'text/markdown', 'X-Return-Format': 'markdown' } });
+  if (!res.ok) throw new Error(`Jina Reader error: ${res.status}`);
+  const text = await res.text();
+  if (!text || text.trim().length < 50) throw new Error('아티클 본문이 너무 짧음');
+  return text.trim();
+}
+
+export function looksLikeOnlyUrls(text: string): boolean {
+  return text.replace(/https?:\/\/\S+/g, ' ').replace(/\s+/g, ' ').trim().length < 8;
+}
+
+export function guessHeadingFromSummary(body: string, fallback = 'X Post'): string {
+  const exec = body.match(/^#{1,6}\s*(\d+\.)?\s*Executive Summary\b[\s\S]*?\n[-•]\s*(.+)$/mi);
+  if (exec?.[2]) return exec[2].replace(/[*_`]/g, '').trim().substring(0, 80);
+  // rich-cards 절 표지(「1. 🎯 한 줄 결론」·「✅ 한눈에 정리」…)는 제목이 아니다 — 「한 줄 결론」이면 그 «다음» 문장이 제목(2026-09-26: 노트 이름이 `_한_줄_결론` 이 됐다).
+  const label = /^(\d+\.\s*)?[^\p{L}\p{N}]*(한\s?줄\s?결론|한눈에\s?정리|상세\s?카드|핵심|참조\s?링크|원문)/u;
+  let wantNext = false;
+  for (const line of body.split('\n')) {
+    const c = line.replace(/^#+\s*/, '').replace(/\*\*/g, '').trim();
+    if (!c || /^(table of contents|executive summary|scqa|comment analysis)$/i.test(c)) continue;
+    if (/^[-*]\s*\[.+\]\(#.+\)\s*$/.test(c) || /^https?:\/\//.test(c)) continue;
+    if (label.test(c)) { wantNext = /한\s?줄\s?결론/.test(c); continue; }
+    if (!wantNext && /^[-*•]\s/.test(c)) continue;
+    return c.replace(/[*_`]/g, '').trim().substring(0, 80);
+  }
+  return fallback;
+}
+
+export function insertRefLinksAfterToc(body: string, refBlock: string): string {
+  const lines = body.split('\n');
+  const ref = refBlock.trim();
+  if (!ref) return body;
+  const tocIdx = lines.findIndex(l => /^#{1,6}\s*(\d+\.)?\s*table of contents\b/i.test(l.trim()));
+  if (tocIdx === -1) return [ref, '', ...lines].join('\n');
+  let next = -1;
+  for (let i = tocIdx + 1; i < lines.length; i++) { if (/^#{1,6}\s+/.test(lines[i].trim())) { next = i; break; } }
+  if (next === -1) return [...lines, '', ref].join('\n');
+  return [...lines.slice(0, next), '', ref, '', ...lines.slice(next)].join('\n');
+}

package/skills/omni-digest/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "."
+  },
+  "include": ["src/**/*.ts", "scripts/**/*.ts"]
+}

package/src/a2a/agent-card.ts

@@ -0,0 +1,29 @@
+import { packageVersion } from '../version/code-revision.js';
+
+/** The public A2A discovery document. The bearer scheme describes the protected RPC endpoint; discovery itself is public. */
+export function createAgentCard(serverUrl: string) {
+  return {
+    protocolVersion: '0.3.0',
+    name: 'elanous',
+    description: 'A self-healing agent for delegated work, research, and coding.',
+    url: serverUrl,
+    version: packageVersion(),
+    capabilities: {
+      streaming: false,
+      pushNotifications: false,
+      stateTransitionHistory: false,
+    },
+    defaultInputModes: ['text/plain'],
+    defaultOutputModes: ['text/plain'],
+    skills: [{
+      id: 'delegate',
+      name: 'Delegate to elanous',
+      description: 'Delegate a task to elanous for research, coding, or other agent work.',
+      tags: ['delegate', 'research', 'coding'],
+    }],
+    securitySchemes: {
+      bearerAuth: { type: 'http', scheme: 'bearer' },
+    },
+    security: [{ bearerAuth: [] }],
+  };
+}