adyou 0.3.0 → 0.4.0

package/dist/adapters/meta.d.ts

@@ -15,6 +15,8 @@ export declare class MetaConnector implements Connector {
     ensurePixel(name: string): Promise<string>;
     inventory(): Promise<InventoryRow[]>;
     private findByName;
+    /** 영상 업로드(multipart source) → 처리 완료(ready)까지 대기 → video_id. 🔴 크리에이티브는 video_status 가 ready 여야 만들 수 있다 */
+    private uploadVideo;
     private uploadImage;
     build(input: BuildInput): Promise<BuildResult>;
     preview(placements: Placement[]): Promise<{

package/dist/adapters/meta.js

@@ -2,7 +2,7 @@
 //   예산=계정 통화 최소 단위 · Advantage+ 오디언스에선 age_max 금지 · DCO 광고세트엔 광고 1개(컨셉=광고세트) · instagram_user_id · WITH_ISSUES 2446984는 조치 불필요
 //   앱 개발 모드면 크리에이티브 생성 100 오류 · 픽셀 트래픽 권한 밖 도메인은 이벤트 조용히 폐기(signals/config blockReason)
 import fs from 'node:fs';
-import { MediumError, nameTag, utm } from './types.js';
+import { abKey, MediumError, nameTag, utm } from './types.js';
 const G = 'https://graph.facebook.com/v23.0';
 const REQUIRED_SCOPES = ['ads_management', 'ads_read', 'business_management', 'pages_show_list', 'pages_read_engagement', 'pages_manage_ads'];
 const COUNTRY_INTERESTS = {};
@@ -145,6 +145,29 @@ export class MetaConnector {
         const d = await this.call('GET', `${this.c.adAccountId}/${edge}`, { fields: 'id,name,status', limit: 500, filtering: [{ field: 'name', operator: 'CONTAIN', value: name.slice(0, 60) }], ...extra });
         return d.data.find((x) => x.name === name) || null;
     }
+    /** 영상 업로드(multipart source) → 처리 완료(ready)까지 대기 → video_id. 🔴 크리에이티브는 video_status 가 ready 여야 만들 수 있다 */
+    async uploadVideo(file, title, log) {
+        const fd = new FormData();
+        fd.set('access_token', this.c.accessToken);
+        fd.set('title', title.slice(0, 200));
+        fd.set('source', new Blob([fs.readFileSync(file)], { type: 'video/mp4' }), 'ad.mp4');
+        const res = await fetch(`${G}/${this.c.adAccountId}/advideos`, { method: 'POST', body: fd, signal: AbortSignal.timeout(600_000) });
+        const d = (await res.json().catch(() => ({})));
+        if (!res.ok || d.error || !d.id)
+            throw this.wrap(d.error || { message: `영상 업로드 실패 ${res.status}` }, 'advideos');
+        const t0 = Date.now();
+        while (Date.now() - t0 < 10 * 60_000) {
+            const st = await this.call('GET', d.id, { fields: 'status' });
+            const vs = st.status?.video_status;
+            if (vs === 'ready')
+                return d.id;
+            if (vs === 'error')
+                throw new MediumError('meta', '메타가 영상을 처리하지 못했어요(코덱·길이 확인)');
+            await new Promise((r) => setTimeout(r, 5000));
+        }
+        log('  ⚠ 영상 처리 대기 10분 초과 — 그대로 진행');
+        return d.id;
+    }
     async uploadImage(file) {
         const d = await this.call('POST', `${this.c.adAccountId}/adimages`, { bytes: fs.readFileSync(file).toString('base64') });
         const first = Object.values(d.images)[0];
@@ -156,7 +179,7 @@ export class MetaConnector {
         const log = input.log || (() => { });
         const warnings = [];
         const placements = [...input.existing];
-        const has = (kind, concept) => placements.find((p) => p.medium === 'meta' && p.kind === kind && (concept ? p.concept === concept : true));
+        const has = (kind, concept, format = 'image') => placements.find((p) => p.medium === 'meta' && p.kind === kind && (concept ? p.concept === concept && (p.format || 'image') === format : true));
         const tag = nameTag(input.slug);
         if (!this.c.pageId)
             throw new MediumError('meta', '페이지 id가 없어요', '`adpilot connect meta --page <페이지 id>`');
@@ -181,43 +204,86 @@ export class MetaConnector {
         const targeting = { geo_locations: { countries: input.markets.map((m) => m.country.toUpperCase()) }, age_min: 18, targeting_automation: { advantage_audience: 1 }, ...(input.markets.length === 1 && input.markets[0].language ? { locales: undefined } : {}) };
         const domain = new URL(input.landingUrl).hostname;
         for (const c of input.concepts) {
-            const imgs = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both'));
-            if (!imgs.length) {
+            const imgs = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both') && (a.type || 'image') === 'image');
+            const vids = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both') && a.type === 'video');
+            if (!imgs.length && !vids.length) {
                 warnings.push(`${c.key}: 메타용 소재가 없어 건너뜀`);
                 continue;
             }
-            let adset = has('adset', c.key);
-            if (!adset) {
-                const name = `${tag} ${c.key} · ${input.markets.map((m) => m.country).join('+')} · DCO`;
-                const found = await this.findByName('adsets', name);
-                const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
-                adset = { medium: 'meta', kind: 'adset', concept: c.key, externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
-                placements.push(adset);
-                log(`  meta 광고세트 ${c.key} ${found ? '재사용' : '생성'} ${id}`);
-            }
-            let creative = has('creative', c.key);
-            if (!creative) {
-                const hashes = [];
-                for (const a of imgs.filter((x) => [1080].includes(x.w)))
-                    hashes.push(await this.uploadImage(a.file));
-                const name = `${tag} ${c.key} · DCO`;
-                const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
-                    name,
-                    object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
-                    asset_feed_spec: {
-                        images: hashes.map((h) => ({ hash: h })), bodies: c.bodies.slice(0, 5).map((t) => ({ text: t })), titles: c.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: c.descriptions.slice(0, 2).map((t) => ({ text: t })),
-                        link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, c.key), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_IMAGE'],
-                    },
-                });
-                creative = { medium: 'meta', kind: 'creative', concept: c.key, externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
-                placements.push(creative);
-                log(`  meta 크리에이티브 ${c.key} 생성 ${d.id} (이미지 ${hashes.length})`);
+            if (imgs.length) {
+                let adset = has('adset', c.key);
+                if (!adset) {
+                    const name = `${tag} ${c.key} · ${input.markets.map((m) => m.country).join('+')} · DCO`;
+                    const found = await this.findByName('adsets', name);
+                    const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
+                    adset = { medium: 'meta', kind: 'adset', concept: c.key, externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
+                    placements.push(adset);
+                    log(`  meta 광고세트 ${c.key} ${found ? '재사용' : '생성'} ${id}`);
+                }
+                let creative = has('creative', c.key);
+                if (!creative) {
+                    const hashes = [];
+                    for (const a of imgs.filter((x) => [1080].includes(x.w)))
+                        hashes.push(await this.uploadImage(a.file));
+                    const name = `${tag} ${c.key} · DCO`;
+                    const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
+                        name,
+                        object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
+                        asset_feed_spec: {
+                            images: hashes.map((h) => ({ hash: h })), bodies: c.bodies.slice(0, 5).map((t) => ({ text: t })), titles: c.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: c.descriptions.slice(0, 2).map((t) => ({ text: t })),
+                            link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, c.key), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_IMAGE'],
+                        },
+                    });
+                    creative = { medium: 'meta', kind: 'creative', concept: c.key, externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
+                    placements.push(creative);
+                    log(`  meta 크리에이티브 ${c.key} 생성 ${d.id} (이미지 ${hashes.length})`);
+                }
+                if (!has('ad', c.key)) {
+                    const name = `${tag} ${c.key}`;
+                    const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
+                    placements.push({ medium: 'meta', kind: 'ad', concept: c.key, externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
+                    log(`  meta 광고 ${c.key} 생성 ${d.id}`);
+                }
             }
-            if (!has('ad', c.key)) {
-                const name = `${tag} ${c.key}`;
-                const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
-                placements.push({ medium: 'meta', kind: 'ad', concept: c.key, externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
-                log(`  meta 광고 ${c.key} 생성 ${d.id}`);
+            // 영상 광고 — 컨셉마다 별도 DCO 광고세트(형태 A/B: 이미지 vs 영상) · 9:16 원본 + 파생 비율을 한 크리에이티브의 변형으로
+            if (vids.length) {
+                let adset = has('adset', c.key, 'video');
+                if (!adset) {
+                    const name = `${tag} ${c.key} · ${input.markets.map((m) => m.country).join('+')} · VIDEO`;
+                    const found = await this.findByName('adsets', name);
+                    const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
+                    adset = { medium: 'meta', kind: 'adset', concept: c.key, format: 'video', externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
+                    placements.push(adset);
+                    log(`  meta 영상 광고세트 ${c.key} ${found ? '재사용' : '생성'} ${id}`);
+                }
+                let creative = has('creative', c.key, 'video');
+                if (!creative) {
+                    const videos = [];
+                    for (const v of vids.slice(0, 3)) {
+                        const vid = await this.uploadVideo(v.file, `${tag} ${c.key} ${v.ratio}`, log);
+                        const thumb = imgs.find((a) => a.ratio === v.ratio && a.w === 1080) || imgs.find((a) => a.w === 1080);
+                        videos.push({ video_id: vid, ...(thumb ? { thumbnail_hash: await this.uploadImage(thumb.file) } : {}) });
+                        log(`  meta 영상 업로드 ${c.key} ${v.ratio} → ${vid}`);
+                    }
+                    const name = `${tag} ${c.key} · VIDEO · DCO`;
+                    const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
+                        name,
+                        object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
+                        asset_feed_spec: {
+                            videos, bodies: c.bodies.slice(0, 5).map((t) => ({ text: t })), titles: c.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: c.descriptions.slice(0, 2).map((t) => ({ text: t })),
+                            link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, abKey(c.key, 'video')), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_VIDEO'],
+                        },
+                    });
+                    creative = { medium: 'meta', kind: 'creative', concept: c.key, format: 'video', externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
+                    placements.push(creative);
+                    log(`  meta 영상 크리에이티브 ${c.key} 생성 ${d.id} (영상 ${videos.length})`);
+                }
+                if (!has('ad', c.key, 'video')) {
+                    const name = `${tag} ${c.key} · video`;
+                    const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
+                    placements.push({ medium: 'meta', kind: 'ad', concept: c.key, format: 'video', externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
+                    log(`  meta 영상 광고 ${c.key} 생성 ${d.id}`);
+                }
             }
         }
         return { placements, warnings };
@@ -229,7 +295,7 @@ export class MetaConnector {
                 try {
                     const d = await this.call('GET', `${ad.externalId}/previews`, { ad_format: fmt });
                     if (d.data[0]?.body)
-                        out.push({ concept: ad.concept, name: `Meta · ${fmt === 'INSTAGRAM_STANDARD' ? 'Instagram' : 'Facebook 피드'} · ${ad.concept}`, html: d.data[0].body });
+                        out.push({ concept: ad.concept, name: `Meta · ${fmt === 'INSTAGRAM_STANDARD' ? 'Instagram' : 'Facebook 피드'} · ${ad.concept}${ad.format === 'video' ? ' · 영상' : ''}`, html: d.data[0].body });
                 }
                 catch (e) {
                     out.push({ concept: ad.concept, name: `Meta · ${fmt}`, html: `<p>미리보기 실패: ${e instanceof Error ? e.message : e}</p>` });
@@ -257,7 +323,7 @@ export class MetaConnector {
         const acc = await this.account();
         const d = await this.call('GET', `${this.c.adAccountId}/insights`, { level: 'ad', fields: 'ad_id,ad_name,adset_id,spend,impressions,clicks,actions', time_range: { since: range.since, until: range.until }, time_increment: 1, filtering: [{ field: 'campaign.id', operator: 'IN', value: [camp.externalId] }], limit: 1000 });
         const conv = (acts) => (acts || []).filter((a) => ['purchase', 'lead', 'complete_registration', 'offsite_conversion.fb_pixel_purchase', 'offsite_conversion.fb_pixel_lead', 'offsite_conversion.fb_pixel_complete_registration'].includes(a.action_type)).reduce((n, a) => n + Number(a.value), 0);
-        return d.data.map((r) => ({ date: r.date_start, level: 'ad', id: r.ad_id, name: r.ad_name, concept: placements.find((p) => p.externalId === r.ad_id)?.concept, spend: Number(r.spend), impressions: Number(r.impressions), clicks: Number(r.clicks), conversions: conv(r.actions), currency: acc.currency }));
+        return d.data.map((r) => ({ date: r.date_start, level: 'ad', id: r.ad_id, name: r.ad_name, concept: placements.find((p) => p.externalId === r.ad_id)?.concept, format: placements.find((p) => p.externalId === r.ad_id)?.format || 'image', spend: Number(r.spend), impressions: Number(r.impressions), clicks: Number(r.clicks), conversions: conv(r.actions), currency: acc.currency }));
     }
     async policy(placements) {
         const out = [];

package/dist/adapters/mock.js

@@ -28,8 +28,8 @@ export class MockConnector {
         const st = this.load();
         const placements = [...input.existing];
         const tag = nameTag(input.slug);
-        const mk = (kind, concept) => { const existing = placements.find((p) => p.medium === this.medium && p.kind === kind && p.concept === concept); if (existing)
-            return existing; const p = { medium: this.medium, kind, concept, externalId: `${this.medium}_${kind}_${concept || 'root'}_${Math.random().toString(36).slice(2, 8)}`, name: `${tag} ${kind} ${concept || ''}`.trim(), status: 'PAUSED', createdAt: new Date().toISOString() }; placements.push(p); st.objects.push(p); return p; };
+        const mk = (kind, concept, format) => { const existing = placements.find((p) => p.medium === this.medium && p.kind === kind && p.concept === concept && (p.format || 'image') === (format || 'image')); if (existing)
+            return existing; const p = { medium: this.medium, kind, concept, ...(format ? { format } : {}), externalId: `${this.medium}_${kind}_${concept || 'root'}${format === 'video' ? '_video' : ''}_${Math.random().toString(36).slice(2, 8)}`, name: `${tag} ${kind} ${concept || ''}${format === 'video' ? ' · video' : ''}`.trim(), status: 'PAUSED', createdAt: new Date().toISOString() }; placements.push(p); st.objects.push(p); return p; };
         if (input.validateOnly) {
             st.calls.push('validate');
             this.save(st);
@@ -39,11 +39,21 @@ export class MockConnector {
         if (this.medium === 'google')
             mk('adgroup');
         for (const c of input.concepts) {
-            if (this.medium === 'meta') {
-                mk('adset', c.key);
-                mk('creative', c.key);
+            const imgs = input.assets.filter((a) => a.concept === c.key && (a.type || 'image') === 'image');
+            const vids = input.assets.filter((a) => a.concept === c.key && a.type === 'video');
+            if (imgs.length || !vids.length) {
+                if (this.medium === 'meta') {
+                    mk('adset', c.key);
+                    mk('creative', c.key);
+                }
+                mk('ad', c.key);
+            }
+            // 영상은 메타만(구글 디스플레이는 유튜브 영상만 받는다) · 컨셉별 형태 A/B
+            if (vids.length && this.medium === 'meta') {
+                mk('adset', c.key, 'video');
+                mk('creative', c.key, 'video');
+                mk('ad', c.key, 'video');
             }
-            mk('ad', c.key);
         }
         st.calls.push(`build budget=${input.dailyBudgetMinor} ${input.currency}`);
         this.save(st);
@@ -59,7 +69,7 @@ export class MockConnector {
         const d0 = new Date(range.since);
         const d1 = new Date(range.until);
         for (let d = new Date(d0); d <= d1; d.setDate(d.getDate() + 1))
-            ads.forEach((a, i) => { const imp = 1000 + i * 400; const clicks = Math.round(imp * (0.008 + i * 0.006)); out.push({ date: d.toISOString().slice(0, 10), level: 'ad', id: a.externalId, name: a.name, concept: a.concept, spend: this.currency === 'USD' ? 8 + i : 12000 + i * 1500, impressions: imp, clicks, conversions: i === 1 ? 3 : 1, currency: this.currency }); });
+            ads.forEach((a, i) => { const imp = 1000 + i * 400; const clicks = Math.round(imp * (0.008 + i * 0.006)); out.push({ date: d.toISOString().slice(0, 10), level: 'ad', id: a.externalId, name: a.name, concept: a.concept, format: a.format || 'image', spend: this.currency === 'USD' ? 8 + i : 12000 + i * 1500, impressions: imp, clicks, conversions: i === 1 ? 3 : 1, currency: this.currency }); });
         return out;
     }
     async policy(placements) { return placements.filter((p) => p.medium === this.medium && p.kind === 'ad').map((p) => ({ id: p.externalId, name: p.name, status: 'APPROVED', issues: [] })); }

package/dist/adapters/types.d.ts

@@ -44,6 +44,7 @@ export type MetricRow = {
     id: string;
     name: string;
     concept?: string;
+    format?: 'image' | 'video';
     spend: number;
     impressions: number;
     clicks: number;
@@ -98,3 +99,5 @@ export declare class MediumError extends Error {
 }
 export declare const utm: (url: string, medium: Medium, campaign: string, content: string) => string;
 export declare const nameTag: (slug: string) => string;
+/** A/B 키 — 컨셉(+영상이면 _video) · utm_content 와 광고 이름에 같이 쓴다 */
+export declare const abKey: (concept: string, format?: "image" | "video") => string;

package/dist/adapters/types.js

@@ -18,3 +18,5 @@ export const utm = (url, medium, campaign, content) => {
     return u.toString();
 };
 export const nameTag = (slug) => `[adp:${slug}]`;
+/** A/B 키 — 컨셉(+영상이면 _video) · utm_content 와 광고 이름에 같이 쓴다 */
+export const abKey = (concept, format) => (format === 'video' ? `${concept}_video` : concept);

package/dist/cli.js

@@ -104,10 +104,10 @@ program.command('brief <url>').description('사이트 읽고 브리프 만들기
         die(e);
     }
 });
-program.command('creatives').description('컨셉·카피 + 이미지 생성 + 12규격 합성 + 규격 검사').option('--concepts <n>', '컨셉 수', '3').option('--feedback <text>', '자연어 수정(「더 고급스럽게」) — 전부 다시 만든다').option('--images <folder>', '직접 준비한 배경 이미지 폴더').option('--no-images', '이미지 생성 없이 브랜드 그래디언트').option('--force', '다시 만들기').action(async (o) => {
+program.command('creatives').description('컨셉·카피 + 이미지 생성 + 12규격 합성 + 규격 검사').option('--concepts <n>', '컨셉 수', '3').option('--feedback <text>', '자연어 수정(「더 고급스럽게」) — 전부 다시 만든다').option('--images <folder>', '직접 준비한 배경 이미지 폴더').option('--no-images', '이미지 생성 없이 브랜드 그래디언트').option('--force', '다시 만들기').option('--mode <mode>', '소재 형태 auto|image|video|text').option('--video', '영상 소재도 만든다(9:16 8초 · Veo 3.1 · 소리 포함)').option('--video-seconds <n>', '영상 길이 8|15|30 (15/30 은 Seedance 2.5)').option('--requirements <text>', '요구사항·방향(참고 이미지는 --images 폴더)').action(async (o) => {
     try {
         const p = resolveProject(program.opts().project);
-        const { project, report } = await opCreatives(p, { count: Number(o.concepts), feedback: o.feedback, images: o.images, noImages: o.images === false, force: o.force, log });
+        const { project, report } = await opCreatives(p, { count: Number(o.concepts), feedback: o.feedback, images: o.images, noImages: o.images === false, force: o.force, mode: o.mode, video: o.video, videoSeconds: o.videoSeconds ? Number(o.videoSeconds) : undefined, requirements: o.requirements, log });
         log(`\n컨셉 ${project.concepts.length}개 · 소재 ${project.assets.filter((a) => a.concept !== '_logo').length}장`);
         for (const c of project.concepts)
             log(`  · ${c.name}(${c.key}) — ${c.headlines[0]}`);

package/dist/core/creatives/copy.d.ts

@@ -1,11 +1,20 @@
 import type { Brief, Concept, Goal } from '../state.js';
 import { wlen } from './specs.js';
-export declare function generateConcepts(brief: Brief, opts: {
+export type ConceptOpts = {
     goal: Goal;
     count: number;
     feedback?: string;
-    previous?: Concept[];
-}): Promise<Concept[]>;
+    previous?: Concept[]; /** guided: 광고주 요구사항·방향 */
+    requirements?: string; /** 참고 이미지 설명(있으면 비주얼을 그 제품·인물에 맞춘다) */
+    referenceNote?: string; /** manual: 광고주가 직접 쓴 문구 — 이걸 다듬어 규격에 맞추기만 한다 */
+    userCopy?: {
+        headlines?: string[];
+        bodies?: string[];
+        descriptions?: string[];
+    }; /** 영상 프롬프트·자막도 만들지 */
+    video?: boolean;
+};
+export declare function generateConcepts(brief: Brief, opts: ConceptOpts): Promise<Concept[]>;
 /** 매체별 카피 규격 검사 요약 */
 export declare function validateConcepts(concepts: Concept[]): {
     ok: boolean;

package/dist/core/creatives/copy.js

@@ -3,9 +3,10 @@ import { z } from 'zod';
 import { aiAvailable, completeJson } from '../llm.js';
 import { checkCopy, ctaFor, fit, GOOGLE_LIMITS, wlen } from './specs.js';
 const ConceptSchema = z.object({
-    key: z.string().regex(/^[a-z][a-z0-9_]{1,19}$/), name: z.string(), angle: z.string(),
-    headlines: z.array(z.string()).min(3).max(6), bodies: z.array(z.string()).min(2).max(6), descriptions: z.array(z.string()).min(1).max(3),
+    key: z.string().regex(/^[a-z][a-z0-9_]{1,19}$/), name: z.string().optional(), angle: z.string().optional(),
+    headlines: z.array(z.string()).min(1).max(8), bodies: z.array(z.string()).min(1).max(8), descriptions: z.array(z.string()).min(1).max(4),
     imagePrompt: z.string(), theme: z.enum(['dark', 'light']).default('dark'),
+    videoPrompt: z.string().optional(), videoLines: z.array(z.string()).optional(), videoVoice: z.string().optional().nullable(),
 });
 export async function generateConcepts(brief, opts) {
     const cta = ctaFor(opts.goal);
@@ -15,20 +16,38 @@ export async function generateConcepts(brief, opts) {
         schema: z.object({ concepts: z.array(ConceptSchema).min(1) }), maxTokens: 6000, timeoutMs: 120_000,
         system: `너는 퍼포먼스 광고 카피라이터이자 아트디렉터다. 브리프로 서로 다른 각도의 광고 컨셉 ${opts.count}개를 만든다(혜택·증거/사회적 증명·긴급/희소·비교/대안·감성 중에서 고르되 겹치지 않게).
 규칙:
-- 언어는 brief.language. 사실은 브리프(usp·offer)에 있는 것만. 과장·최상급(최고·1위·100%·보장·무조건)·클릭 유도 금지.
+- 언어: headlines·bodies·descriptions·videoLines·videoVoice·name·angle 전부 brief.language(${brief.language}) 하나로 — 다른 언어를 섞지 않는다(요구사항이 한국어로 적혀 있어도 출력 언어는 brief.language). 사실은 브리프(usp·offer)에 있는 것만. 과장·최상급(최고·1위·100%·보장·무조건)·클릭 유도 금지.
 - headlines: 짧은 제목 5개 — 각각 ${GOOGLE_LIMITS.headline}자(한글·전각은 2자로 셈 → 한글 15자) 이내. 첫 번째는 그 컨셉의 대표 문장.
 - bodies: 본문 5개 — 60~120자. 구체적 혜택·근거·누구를 위한 것인지. 존댓말(해요체).
 - descriptions: 설명 2개 — 각각 ${GOOGLE_LIMITS.description}자(한글 45자) 이내.
 - imagePrompt: 배경 비주얼 생성 프롬프트(영어). 글자·로고·UI 절대 없음. 헤드라인을 올릴 넉넉한 여백. 브랜드색 ${brief.palette.primary}. 실존 인물·타사 로고 금지.
 - theme: 어두운 배경(dark)이 어울리면 dark, 밝고 가벼우면 light.
-- key: 영문 소문자 짧은 식별자(예 benefit·proof·urgency).${opts.feedback ? `\n사용자 수정 요청: 「${opts.feedback}」 — 이 요청을 반영해 전부 다시 만든다.` : ''}`,
-        user: JSON.stringify({ brief, goal: opts.goal, cta, previous: opts.previous?.map((c) => ({ key: c.key, name: c.name, angle: c.angle, headline: c.headlines[0] })) }),
+- key: 영문 소문자 짧은 식별자(예 benefit·proof·urgency). name: 컨셉 이름(brief.language · 2~6단어). angle: 이 컨셉이 노리는 각도 한 문장.
+- 출력 JSON: {"concepts":[{key,name,angle,headlines[],bodies[],descriptions[],imagePrompt,theme,videoPrompt,videoLines[],videoVoice}]} — 모든 키를 빠짐없이.
+- videoPrompt: 8~15초 짧은 광고 영상 한 컷 연출 프롬프트(영어 · 피사체·동작·카메라·조명·분위기 · 실존 인물·타사 로고·화면 글자 없음 · "No on-screen text, no subtitles, no logos" 로 끝낸다). 소리(잔잔한 BGM·효과음)도 한 줄 지시. 첫 프레임은 imagePrompt 의 비주얼에서 자연스럽게 움직여 나간다고 가정.
+- videoLines: 영상에 얹을 화면 자막 2~3줄(brief.language · 각 18자 이내 · 훅 → 혜택 → 행동 순). videoVoice: 내레이션 한 문장(선택 · brief.language).${opts.requirements ? `\n광고주 요구사항(반드시 반영): 「${opts.requirements}」` : ''}${opts.referenceNote ? `\n참고 이미지: ${opts.referenceNote} — imagePrompt·videoPrompt 는 이 제품/인물이 주인공이 되게 쓴다("the product from the reference image" 처럼 지칭).` : ''}${opts.userCopy ? `\n광고주가 직접 쓴 문구(userCopy)가 있다 — 뜻·톤을 바꾸지 말고 규격(글자 수·정책)에만 맞춰 다듬어 headlines/bodies/descriptions 를 채운다. 컨셉은 그 문구를 나누어 담는다.` : ''}${opts.feedback ? `\n사용자 수정 요청: 「${opts.feedback}」 — 이 요청을 반영해 전부 다시 만든다.` : ''}`,
+        user: JSON.stringify({ brief, goal: opts.goal, cta, userCopy: opts.userCopy, previous: opts.previous?.map((c) => ({ key: c.key, name: c.name, angle: c.angle, headline: c.headlines[0] })) }),
     });
-    const concepts = out.concepts.slice(0, opts.count).map((c) => ({ ...c, cta: cta.meta, headlines: c.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), descriptions: c.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean), bodies: c.bodies.map((b) => b.trim()).filter(Boolean) }));
+    // 언어 가드 — 시장 언어가 한국어가 아닌데 한글이 섞이면(요구사항·브리프가 한국어라 자주 생김) 한 번 더 그 언어로만 다시 쓴다
+    const lang = (brief.language || 'ko').split('-')[0];
+    const hasHangul = (t) => /[가-힣]/.test(t);
+    const violates = (cs) => lang !== 'ko' && cs.some((c) => [...c.headlines, ...c.bodies, ...c.descriptions, ...(c.videoLines || []), c.videoVoice || ''].some(hasHangul));
+    if (violates(out.concepts) && !opts.feedback?.includes('LANGUAGE_FIX')) {
+        const fixed = await generateConcepts(brief, { ...opts, feedback: `LANGUAGE_FIX: 직전 답에 한국어가 섞였어요. headlines·bodies·descriptions·videoLines·videoVoice·name·angle 전부 ${brief.language} 로만 다시 써 주세요(브리프·요구사항이 한국어여도 출력은 ${brief.language}).` });
+        return fixed;
+    }
+    const concepts = out.concepts.slice(0, opts.count).map((c) => ({ ...c, name: (c.name || c.headlines[0] || c.key).trim(), angle: (c.angle || c.descriptions[0] || c.headlines[0] || '').trim(), cta: cta.meta, headlines: c.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean).slice(0, 6), descriptions: c.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean).slice(0, 3), bodies: c.bodies.map((b) => b.trim()).filter(Boolean).slice(0, 6), videoLines: (c.videoLines || []).map((l) => l.trim()).filter(Boolean).slice(0, 3), videoVoice: c.videoVoice || undefined }));
     return concepts;
 }
 function fallbackConcepts(brief, opts) {
     const cta = ctaFor(opts.goal);
+    const uc = opts.userCopy;
+    if (uc && (uc.headlines?.length || uc.bodies?.length)) {
+        const heads = (uc.headlines || []).map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean);
+        const bodies = (uc.bodies || []).map((b) => b.trim()).filter(Boolean);
+        const descs = (uc.descriptions || []).map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean);
+        return [{ key: 'mine', name: '내 문구', angle: '광고주가 직접 쓴 문구', cta: cta.meta, theme: 'dark', headlines: heads.length ? heads : [fit(brief.company, GOOGLE_LIMITS.headline)], bodies: bodies.length ? bodies : [brief.offer], descriptions: descs.length ? descs : [fit(brief.offer, GOOGLE_LIMITS.description)], imagePrompt: `Abstract premium background in ${brief.palette.primary}, soft gradients, no text`, videoPrompt: `Slow cinematic push-in on an abstract premium gradient scene in ${brief.palette.primary}, soft light, gentle ambient music. No on-screen text, no subtitles, no logos.`, videoLines: heads.slice(0, 3) }];
+    }
     const base = brief.usp.length ? brief.usp : [brief.offer];
     return base.slice(0, opts.count).map((u, i) => ({
         key: ['benefit', 'proof', 'urgency', 'compare', 'emotion'][i] || `c${i}`, name: `컨셉 ${i + 1}`, angle: u, cta: cta.meta, theme: 'dark',
@@ -36,6 +55,8 @@ function fallbackConcepts(brief, opts) {
         bodies: [`${brief.offer} ${brief.company}에서 확인해 보세요.`, `${u}. ${brief.company}.`],
         descriptions: [fit(brief.offer, GOOGLE_LIMITS.description)],
         imagePrompt: `Abstract premium background in ${brief.palette.primary} and deep navy, soft gradients, no text, no logos, generous empty space`,
+        videoPrompt: `Slow cinematic camera drift over an abstract premium scene in ${brief.palette.primary} and deep navy, soft volumetric light, calm ambient music. No on-screen text, no subtitles, no logos.`,
+        videoLines: [fit(u, 18), fit(brief.offer, 18), '지금 확인해 보세요'].filter(Boolean),
     }));
 }
 /** 매체별 카피 규격 검사 요약 */

package/dist/core/creatives/factory.d.ts

@@ -0,0 +1,22 @@
+import type { Brief, Concept, CreativeAsset } from '../state.js';
+import { type VideoJob, type VideoRatio } from './media.js';
+export type VideoAsset = CreativeAsset & {
+    type: 'video';
+    costKrw: number;
+    durationSec: number;
+    mime: 'video/mp4';
+};
+export type FactoryLog = (s: string) => void;
+/** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(기존 satori 트리 재사용) */
+export declare function renderEndCard(dir: string, brief: Brief, concept: Concept, ratio: VideoRatio): Promise<string | null>;
+/** 컨셉의 영상 소재 전부(계획된 비율·길이) — 실패한 건은 건너뛰고 로그 · 성공한 건마다 onAsset */
+export declare function produceConceptVideos(o: {
+    dir: string;
+    brief: Brief;
+    concept: Concept;
+    jobs: VideoJob[];
+    backgrounds: Record<string, string | null>;
+    refs?: string[];
+    log?: FactoryLog;
+    onAsset?: (a: VideoAsset) => void | Promise<void>;
+}): Promise<VideoAsset[]>;

package/dist/core/creatives/factory.js

@@ -0,0 +1,112 @@
+// 소재 공장 — 컨셉 하나의 영상 소재를 끝까지 만든다: 첫 프레임(같은 비율의 생성 배경) → 영상 생성(Veo/Seedance · 네이티브 소리) → 자막 번인(헤드라인 훅·혜택·CTA) → 엔드카드(로고·CTA 2초) → 파생 비율(4:5·1:1 무료 크롭).
+// CLI(ops.ts)와 웹(pipeline.ts)이 같은 함수를 부른다. 원가는 onAsset 으로 건별 통보(청구는 호출자 · ×1.1).
+import fs from 'node:fs';
+import path from 'node:path';
+import { DERIVED_RATIOS, VIDEO_DIMS } from './media.js';
+import { ctaLabel, renderConcept, renderOverlay } from './render.js';
+import { generateVideo } from './video.js';
+import { appendEndCard, burnCaptions, deriveRatio, hasFfmpeg, probe } from './videofx.js';
+/** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(기존 satori 트리 재사용) */
+export async function renderEndCard(dir, brief, concept, ratio) {
+    try {
+        const { w, h } = VIDEO_DIMS[ratio];
+        const out = await renderConcept(dir, brief, concept, {}, { force: false, only: [{ w, h, ratio, medium: 'meta', kind: 'poster' }] });
+        return out[0]?.file || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 컨셉의 영상 소재 전부(계획된 비율·길이) — 실패한 건은 건너뛰고 로그 · 성공한 건마다 onAsset */
+export async function produceConceptVideos(o) {
+    const log = o.log || (() => { });
+    const c = o.concept;
+    const out = [];
+    const ff = await hasFfmpeg();
+    if (!ff)
+        log('  ⚠ ffmpeg 가 없어 자막·엔드카드·비율 파생 없이 원본 영상만 써요');
+    const cta = ctaLabel(c.cta, o.brief.language);
+    for (const job of o.jobs) {
+        const base = path.join(o.dir, `${c.key}_video_${job.ratio}`);
+        const finalFile = `${base}.mp4`;
+        if (fs.existsSync(finalFile)) {
+            const p = ff ? await probe(finalFile) : { durationSec: job.durationSec, w: VIDEO_DIMS[job.ratio].w, h: VIDEO_DIMS[job.ratio].h };
+            out.push({ concept: c.key, w: VIDEO_DIMS[job.ratio].w, h: VIDEO_DIMS[job.ratio].h, ratio: job.ratio, file: finalFile, medium: 'meta', type: 'video', durationSec: Math.round(p.durationSec), mime: 'video/mp4', costKrw: 0, origin: 'ai' });
+            continue;
+        }
+        const firstFrame = o.backgrounds[job.ratio] || (job.ratio === '9x16' ? o.backgrounds['4x5'] : job.ratio === '16x9' ? o.backgrounds['1x1'] : null) || undefined;
+        const prompt = `${c.videoPrompt || `A cinematic 8-second product/brand advertisement scene inspired by: ${c.imagePrompt}. Slow, elegant camera movement.`}${job.audio ? ' Subtle ambient background music and light sound design that fits the mood.' : ' Silent, no music, no sound.'} No on-screen text, no subtitles, no captions, no logos, no watermark.`;
+        log(`「${c.name}」 영상 ${job.ratio.replace('x', ':')} ${job.durationSec}초 만드는 중… (${job.provider === 'veo' ? 'Veo 3.1' : 'Seedance 2.5'} · 첫 프레임 ${firstFrame ? '생성 배경' : '없음'})`);
+        let raw;
+        let costKrw = 0;
+        let durationSec = job.durationSec;
+        try {
+            const r = await generateVideo({ file: `${base}.raw.mp4`, prompt, ratio: job.ratio, durationSec: job.durationSec, model: job.model, resolution: job.resolution, audio: job.audio, firstFrame, refs: firstFrame ? undefined : o.refs, negative: 'text, subtitles, captions, letters, watermark, logo, blurry, distorted faces, extra fingers', log });
+            raw = r.file;
+            costKrw = r.costKrw;
+            durationSec = r.durationSec;
+            log(`  영상 생성 완료 · 원가 ₩${Math.round(costKrw).toLocaleString()}`);
+        }
+        catch (e) {
+            const ck = Number(e.costKrw || 0);
+            log(`  ❌ 영상 ${job.ratio} 실패 — ${e instanceof Error ? e.message.slice(0, 200) : e}${ck ? ` (원가 ₩${ck} 발생)` : ''}`);
+            if (ck > 0)
+                await o.onAsset?.({ concept: c.key, w: 0, h: 0, ratio: job.ratio, file: '', medium: 'meta', type: 'video', durationSec: 0, mime: 'video/mp4', costKrw: ck, origin: 'ai' });
+            continue;
+        }
+        let cur = raw;
+        if (ff) {
+            try {
+                if (job.captions && (c.videoLines?.length || c.headlines.length)) {
+                    const lines = (c.videoLines?.length ? c.videoLines : [c.headlines[0], c.bodies[0]?.slice(0, 22) || '']).filter(Boolean).slice(0, 3);
+                    const pr = await probe(cur);
+                    const seg = pr.durationSec / lines.length;
+                    const overlays = [];
+                    for (const [i, t] of lines.entries())
+                        overlays.push({ png: await renderOverlay(path.join(o.dir, `${c.key}_${job.ratio}_cap${i}.png`), pr.w, pr.h, t, { kind: 'line', primary: o.brief.palette.primary }), start: i * seg, end: (i + 1) * seg - (i === lines.length - 1 ? 0 : 0.12) });
+                    overlays.push({ png: await renderOverlay(path.join(o.dir, `${c.key}_${job.ratio}_cta.png`), pr.w, pr.h, cta, { kind: 'cta', primary: o.brief.palette.primary }), start: Math.max(0, pr.durationSec - seg), end: pr.durationSec + 1 });
+                    const withCap = `${base}.cap.mp4`;
+                    await burnCaptions(cur, withCap, { overlays });
+                    cur = withCap;
+                    log('  자막·행동 버튼 오버레이 ✓');
+                }
+                if (job.endCard) {
+                    const card = await renderEndCard(o.dir, o.brief, c, job.ratio);
+                    if (card) {
+                        const withEnd = `${base}.end.mp4`;
+                        await appendEndCard(cur, card, withEnd, 2);
+                        cur = withEnd;
+                        durationSec += 2;
+                        log('  엔드카드 ✓');
+                    }
+                }
+            }
+            catch (e) {
+                log(`  ⚠ 후처리 실패(원본 사용): ${e instanceof Error ? e.message.slice(0, 160) : e}`);
+            }
+        }
+        fs.copyFileSync(cur, finalFile);
+        const dims = VIDEO_DIMS[job.ratio];
+        const asset = { concept: c.key, w: dims.w, h: dims.h, ratio: job.ratio, file: finalFile, medium: 'meta', type: 'video', durationSec: Math.round(durationSec), mime: 'video/mp4', costKrw, origin: 'ai' };
+        out.push(asset);
+        await o.onAsset?.(asset);
+        if (ff)
+            for (const dr of DERIVED_RATIOS[job.ratio]) {
+                if (o.jobs.some((j) => j.ratio === dr))
+                    continue;
+                const df = path.join(o.dir, `${c.key}_video_${dr}.mp4`);
+                try {
+                    await deriveRatio(finalFile, df, dr);
+                    const d2 = VIDEO_DIMS[dr];
+                    const a2 = { concept: c.key, w: d2.w, h: d2.h, ratio: dr, file: df, medium: 'meta', type: 'video', durationSec: Math.round(durationSec), mime: 'video/mp4', costKrw: 0, origin: 'ai' };
+                    out.push(a2);
+                    await o.onAsset?.(a2);
+                    log(`  ${dr.replace('x', ':')} 파생 ✓ (무료)`);
+                }
+                catch (e) {
+                    log(`  ⚠ ${dr} 파생 실패: ${e instanceof Error ? e.message.slice(0, 120) : e}`);
+                }
+            }
+    }
+    return out;
+}

package/dist/core/creatives/images.d.ts

@@ -1,9 +1,38 @@
+export type ImageProvider = 'bizrouter' | 'openai';
 export declare function imageConfig(): {
     key: string;
     model: string;
+    base: string;
+    provider: ImageProvider;
 } | null;
 export declare function imagesAvailable(): boolean;
-/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). */
-export declare function generateBackgrounds(dir: string, conceptKey: string, prompt: string, ratios?: string[], log?: (s: string) => void): Promise<Record<string, string | null>>;
+export declare const isMockGen: () => boolean;
+export type ImageResult = {
+    file: string;
+    costKrw: number;
+    model: string;
+};
+/** 이미지 한 장 — 파일로 저장 · 원가(원) 반환. 실패는 예외(fatal 이면 재시도 없이) */
+export declare function generateImage(opts: {
+    file: string;
+    prompt: string;
+    ratio: string;
+    model?: string;
+    refs?: string[];
+    log?: (s: string) => void;
+    quality?: 'low' | 'medium' | 'high';
+}): Promise<ImageResult>;
+/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). 원가는 onAsset 으로 알린다. */
+export declare function generateBackgrounds(dir: string, conceptKey: string, prompt: string, ratios?: string[], log?: (s: string) => void, opts?: {
+    model?: string;
+    refs?: string[];
+    variant?: string;
+    onAsset?: (a: {
+        ratio: string;
+        file: string;
+        costKrw: number;
+        model: string;
+    }) => void | Promise<void>;
+}): Promise<Record<string, string | null>>;
 /** 사용자 이미지 폴더 → 비율별 배경 매핑(가장 가까운 비율) */
 export declare function userBackgrounds(folder: string, conceptKey: string): Record<string, string | null>;