ugcinc 4.1.127 → 4.1.129

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("./client");
+const tools_1 = require("./tools");
+const skills_1 = require("./skills");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function parseEnvValue(content, name) {
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(`${name}=`)) {
+            let value = trimmed.slice(name.length + 1);
+            if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            return value;
+        }
+    }
+    return undefined;
+}
+function checkEnvFile(filePath, name) {
+    if (!fs.existsSync(filePath))
+        return undefined;
+    return parseEnvValue(fs.readFileSync(filePath, 'utf-8'), name);
+}
+function loadEnvVar(name) {
+    if (process.env[name])
+        return process.env[name];
+    let dir = process.cwd();
+    while (true) {
+        // Check .env in this directory
+        const value = checkEnvFile(path.join(dir, '.env'), name);
+        if (value)
+            return value;
+        // Check immediate child directories for .env files
+        if (fs.existsSync(dir)) {
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                if (entry.isDirectory() && !entry.name.startsWith('.') && !entry.name.startsWith('node_modules')) {
+                    const childValue = checkEnvFile(path.join(dir, entry.name, '.env'), name);
+                    if (childValue)
+                        return childValue;
+                }
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+function printUsage() {
+    console.log('Usage: ugcinc <command> [args]');
+    console.log('');
+    console.log('Commands:');
+    console.log('  init                         Set up Claude Code skills in your project');
+    console.log('  <tool_name> [json_params]    Run an API tool');
+    console.log('  --list                       List all available tools as JSON');
+    console.log('  --help                       Show this help message');
+    console.log('');
+    console.log('Environment variables:');
+    console.log('  UGC_API_KEY   (required for tools) Your UGC Inc API key');
+    console.log('  UGC_ORG_ID   (optional) Organization ID to scope requests');
+    console.log('');
+    console.log('Available tools:');
+    for (const tool of tools_1.allTools) {
+        console.log(`  ${tool.name.padEnd(30)} ${tool.description}`);
+    }
+}
+function runInit() {
+    const cwd = process.cwd();
+    const skillsDir = path.join(cwd, '.claude', 'skills');
+    let created = 0;
+    let skipped = 0;
+    for (const [skillPath, content] of Object.entries(skills_1.skillFiles)) {
+        const fullPath = path.join(skillsDir, skillPath);
+        const dir = path.dirname(fullPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        if (fs.existsSync(fullPath)) {
+            skipped++;
+            console.log(`  skip  ${skillPath} (already exists)`);
+        }
+        else {
+            fs.writeFileSync(fullPath, content);
+            created++;
+            console.log(`  create  ${skillPath}`);
+        }
+    }
+    console.log('');
+    console.log(`Done! Created ${created} skill files${skipped > 0 ? `, skipped ${skipped} existing` : ''}.`);
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Set your API key:  export UGC_API_KEY="your-api-key"');
+    console.log('  2. Try a command:     /accounts list my accounts');
+    console.log('');
+    console.log('Available skills:');
+    console.log('  /accounts     Manage accounts, warmup, and social profiles');
+    console.log('  /posts        Schedule, update, and manage posts');
+    console.log('  /media        Manage media library and social audio');
+    console.log('  /automations  Run and manage automation workflows');
+    console.log('  /stats        View account and post statistics');
+}
+async function runTool(toolName, rawParams) {
+    const tool = tools_1.toolRegistry[toolName];
+    if (!tool) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: `Unknown tool: ${toolName}`,
+            available: tools_1.allTools.map(t => t.name),
+        }));
+        process.exit(1);
+    }
+    const apiKey = loadEnvVar('UGC_API_KEY');
+    if (!apiKey) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: 'UGC_API_KEY not found in environment or any .env file in the directory tree',
+        }));
+        process.exit(1);
+    }
+    const orgId = loadEnvVar('UGC_ORG_ID');
+    const client = new client_1.UGCClient({ apiKey, orgId });
+    let params = undefined;
+    if (rawParams) {
+        const parseResult = tool.schema.safeParse(JSON.parse(rawParams));
+        if (!parseResult.success) {
+            console.error(JSON.stringify({
+                ok: false,
+                error: 'Invalid parameters',
+                details: parseResult.error.issues,
+            }));
+            process.exit(1);
+        }
+        params = parseResult.data;
+    }
+    else {
+        const parseResult = tool.schema.safeParse(undefined);
+        if (!parseResult.success) {
+            console.error(JSON.stringify({
+                ok: false,
+                error: 'This tool requires parameters',
+                details: parseResult.error.issues,
+            }));
+            process.exit(1);
+        }
+        params = parseResult.data;
+    }
+    const result = await tool.execute(client, params);
+    console.log(JSON.stringify(result, null, 2));
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printUsage();
+        process.exit(0);
+    }
+    if (args[0] === '--list') {
+        console.log(JSON.stringify(tools_1.allTools.map(t => ({
+            name: t.name,
+            description: t.description,
+        })), null, 2));
+        process.exit(0);
+    }
+    if (args[0] === 'init') {
+        runInit();
+        process.exit(0);
+    }
+    await runTool(args[0], args[1]);
+}
+main();

package/dist/skills.d.ts

@@ -0,0 +1 @@
+export declare const skillFiles: Record<string, string>;

package/dist/skills.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillFiles = void 0;
+const run = 'npx ugcinc';
+exports.skillFiles = {
+    'accounts/SKILL.md': `---
+name: accounts
+description: Manage UGC Inc accounts - list, update, create, warmup, and social profiles. Use when the user wants to see their accounts, change account settings, or create new ones.
+allowed-tools: Bash, Read
+---
+
+You manage UGC Inc accounts through the CLI. Run tools with:
+\`\`\`bash
+${run} <tool_name> '<json_params>'
+\`\`\`
+
+Requires \`UGC_API_KEY\` env var. Set \`UGC_ORG_ID\` to scope to a specific organization.
+
+## Tools
+
+### list_accounts
+List accounts with optional filters.
+\`\`\`bash
+${run} list_accounts
+${run} list_accounts '{"tag":"fitness"}'
+${run} list_accounts '{"status":"warmed","org_group":"team-a"}'
+\`\`\`
+Filters: \`tag\`, \`org_group\`, \`user_group\`, \`status\` (uninitialized|pending|initialized|setup|warming|warmed|needs_replacement|replacing|failed|deleted)
+
+### get_account_status
+Get tasks/warmup progress for accounts.
+\`\`\`bash
+${run} get_account_status '{"accountIds":["id1","id2"]}'
+${run} get_account_status '{"includeCompleted":true}'
+\`\`\`
+
+### update_account_info
+Update metadata (tags, groups, keywords, warmup version, etc).
+\`\`\`bash
+${run} update_account_info '{"updates":[{"accountId":"id","tag":"new-tag","keywords":"kw1,kw2","warmupVersion":"v2_smart"}]}'
+\`\`\`
+
+### update_account_socials
+Update social profile (username, bio, avatar, nickname). Applied within 24h. Rate limited.
+\`\`\`bash
+${run} update_account_socials '{"updates":[{"accountId":"id","bio":"new bio","nickName":"New Name"}]}'
+\`\`\`
+
+### niche_switch
+Switch account niche. Updates keywords + description and resets warmup automatically.
+\`\`\`bash
+${run} niche_switch '{"updates":[{"accountId":"id","keywords":["fitness","gym"],"description":"Fitness content"}]}'
+\`\`\`
+
+### delete_account_posts
+Delete ALL posts from accounts (creates a task that deletes them from the platform).
+\`\`\`bash
+${run} delete_account_posts '{"accountIds":["id1","id2"]}'
+\`\`\`
+
+### reset_warmup
+Reset warmup activity. Default resets counts; \`delete_activity:true\` deletes all warmup tasks.
+\`\`\`bash
+${run} reset_warmup '{"accountId":"id"}'
+${run} reset_warmup '{"accountId":"id","delete_activity":true}'
+\`\`\`
+
+### create_accounts
+Create new account seats (updates billing).
+\`\`\`bash
+${run} create_accounts '{"accounts":[{"tier":"basic","platform":"tiktok","keywords":"fitness,gym","description":"Fitness niche"}]}'
+\`\`\`
+
+## Workflow tips
+- When the user wants to see their accounts, start with \`list_accounts\` filtered by relevant criteria
+- For large account lists, summarize key info: username, status, tag, follower count
+- When updating multiple accounts, batch them into one \`update_account_info\` call
+- After niche switches, let the user know warmup was automatically reset
+- If $ARGUMENTS is provided, interpret it as a natural language request
+`,
+    'posts/SKILL.md': `---
+name: posts
+description: Schedule, update, and manage UGC Inc posts - video and slideshow creation, status checks, retries. Use when the user wants to create, edit, or manage their social media posts.
+allowed-tools: Bash, Read
+---
+
+You manage UGC Inc posts through the CLI. Run tools with:
+\`\`\`bash
+${run} <tool_name> '<json_params>'
+\`\`\`
+
+Requires \`UGC_API_KEY\` env var. Set \`UGC_ORG_ID\` to scope to a specific organization.
+
+## Tools
+
+### list_posts
+List posts with optional filters.
+\`\`\`bash
+${run} list_posts
+${run} list_posts '{"accountIds":["id1"]}'
+${run} list_posts '{"startDate":"2024-01-01","endDate":"2024-02-01"}'
+\`\`\`
+
+### create_video_post
+Schedule a video post. Set \`accountId\` to \`null\` for auto-selection.
+\`\`\`bash
+${run} create_video_post '{"accountId":"id","videoUrl":"https://...","caption":"My video!"}'
+${run} create_video_post '{"accountId":null,"videoUrl":"https://...","caption":"Auto-select","tag":"fitness"}'
+${run} create_video_post '{"accountId":"id","videoUrl":"https://...","postTime":"2024-01-15T15:00:00Z"}'
+\`\`\`
+Auto-selection: set \`accountId\` to \`null\`, optionally filter by \`tag\`/\`org_group\`/\`user_group\`. Use \`strict:true\` to require exact time.
+
+### create_slideshow_post
+Schedule a slideshow/carousel post.
+\`\`\`bash
+${run} create_slideshow_post '{"accountId":"id","imageUrls":["url1","url2","url3"],"caption":"Slideshow!","title":"My Title"}'
+\`\`\`
+
+### get_post_status
+Check post status. Returns platform URL when complete.
+\`\`\`bash
+${run} get_post_status '{"postId":"id"}'
+\`\`\`
+
+### update_post
+Update a scheduled or failed post. Failed posts reset to "scheduled".
+\`\`\`bash
+${run} update_post '{"postId":"id","caption":"updated caption","postTime":"2024-01-16T12:00:00Z"}'
+\`\`\`
+
+### delete_posts
+Delete posts. Unpublished = immediate. Published = triggers platform deletion flow.
+\`\`\`bash
+${run} delete_posts '{"postIds":["id1","id2"]}'
+\`\`\`
+
+### retry_posts
+Retry failed posts.
+\`\`\`bash
+${run} retry_posts '{"postIds":["id1"]}'
+\`\`\`
+
+## Workflow tips
+- Post times are ISO 8601 (e.g. \`2024-01-15T15:00:00Z\`)
+- When creating posts, if the user doesn't specify an account, use auto-selection (\`accountId: null\`)
+- After creating a post, tell the user the post ID and scheduled time
+- For failed posts, check status first to understand the error before retrying
+- If $ARGUMENTS is provided, interpret it as a natural language request
+`,
+    'media/SKILL.md': `---
+name: media
+description: Manage UGC Inc media library - list, import, and organize videos, images, audio, and text. Use when the user wants to upload media, import audio, or manage their library.
+allowed-tools: Bash, Read
+---
+
+You manage UGC Inc media through the CLI. Run tools with:
+\`\`\`bash
+${run} <tool_name> '<json_params>'
+\`\`\`
+
+Requires \`UGC_API_KEY\` env var. Set \`UGC_ORG_ID\` to scope to a specific organization.
+
+## Tools
+
+### list_media
+List all media (user media + social audio).
+\`\`\`bash
+${run} list_media
+${run} list_media '{"tag":"campaign-1"}'
+${run} list_media '{"ids":["id1","id2"]}'
+\`\`\`
+
+### list_social_audio
+List social audio only.
+\`\`\`bash
+${run} list_social_audio
+${run} list_social_audio '{"tag":"trending"}'
+\`\`\`
+
+### create_media_from_urls
+Import media from URLs (videos, images already hosted somewhere).
+\`\`\`bash
+${run} create_media_from_urls '{"urls":["https://example.com/video.mp4"],"tag":"imported"}'
+${run} create_media_from_urls '{"urls":["url1","url2"],"names":["Video 1","Video 2"]}'
+\`\`\`
+
+### import_text
+Import text content as media.
+\`\`\`bash
+${run} import_text '{"texts":[{"content":"Hello world","name":"greeting","tag":"captions"}]}'
+\`\`\`
+
+### create_social_audio
+Extract audio from a TikTok or Instagram URL.
+\`\`\`bash
+${run} create_social_audio '{"url":"https://www.tiktok.com/@user/video/123","tag":"trending"}'
+\`\`\`
+
+### delete_media
+Delete media items (also removes from storage).
+\`\`\`bash
+${run} delete_media '{"ids":["id1","id2"]}'
+\`\`\`
+
+## Workflow tips
+- Media types: video, image, audio, text, social_audio
+- When importing audio from TikTok/Instagram, use \`create_social_audio\` not \`create_media_from_urls\`
+- Tags help organize media - suggest tagging when importing
+- If $ARGUMENTS is provided, interpret it as a natural language request
+`,
+    'automations/SKILL.md': `---
+name: automations
+description: Run and manage UGC Inc automation workflows - list templates, trigger runs, check status, manage scheduling. Use when the user wants to run, check, or manage their automations.
+allowed-tools: Bash, Read
+---
+
+You manage UGC Inc automations through the CLI. Run tools with:
+\`\`\`bash
+${run} <tool_name> '<json_params>'
+\`\`\`
+
+Requires \`UGC_API_KEY\` env var. Set \`UGC_ORG_ID\` to scope to a specific organization.
+
+## Tools
+
+### list_automations
+List all automation templates. Requires orgId.
+\`\`\`bash
+${run} list_automations '{"orgId":"org-id"}'
+\`\`\`
+
+### get_automation
+Get a specific template with full workflow definition.
+\`\`\`bash
+${run} get_automation '{"templateId":"id"}'
+\`\`\`
+
+### run_automation
+Run an automation. Optionally provide variable inputs.
+\`\`\`bash
+${run} run_automation '{"templateId":"id","orgId":"org-id"}'
+${run} run_automation '{"templateId":"id","orgId":"org-id","variableInputs":{"node-id":"value"}}'
+\`\`\`
+
+### get_automation_status
+Get run status with executor nodes and data flow edges.
+\`\`\`bash
+${run} get_automation_status '{"runId":"id"}'
+\`\`\`
+
+### list_automation_runs
+List runs for a specific template.
+\`\`\`bash
+${run} list_automation_runs '{"templateId":"id","limit":10}'
+\`\`\`
+
+### list_all_automation_runs
+List all runs across all templates.
+\`\`\`bash
+${run} list_all_automation_runs '{"limit":10}'
+${run} list_all_automation_runs '{"reviewStatus":"pending_review"}'
+\`\`\`
+
+### stop_automation
+Stop a running automation.
+\`\`\`bash
+${run} stop_automation '{"runId":"id"}'
+\`\`\`
+
+### publish_automation
+Enable recurrence scheduling.
+\`\`\`bash
+${run} publish_automation '{"templateId":"id"}'
+\`\`\`
+
+### unpublish_automation
+Disable recurrence scheduling.
+\`\`\`bash
+${run} unpublish_automation '{"templateId":"id"}'
+\`\`\`
+
+### run_automation_once
+Run once immediately (also updates recurrence schedule if published).
+\`\`\`bash
+${run} run_automation_once '{"templateId":"id"}'
+\`\`\`
+
+### get_automation_logs
+Get execution logs for a run.
+\`\`\`bash
+${run} get_automation_logs '{"runId":"id"}'
+\`\`\`
+
+## Workflow tips
+- Always list automations first to get template IDs and names
+- After running, use \`get_automation_status\` to monitor progress
+- For recurring automations, check \`publish_automation\` / \`unpublish_automation\`
+- Summarize run status: show completed/total nodes, any failures
+- If $ARGUMENTS is provided, interpret it as a natural language request
+`,
+    'stats/SKILL.md': `---
+name: stats
+description: View UGC Inc statistics - account performance, post metrics, top performers, daily trends. Use when the user asks about performance, analytics, growth, or wants to see their numbers.
+allowed-tools: Bash, Read
+---
+
+You query UGC Inc statistics through the CLI. Run tools with:
+\`\`\`bash
+${run} <tool_name> '<json_params>'
+\`\`\`
+
+Requires \`UGC_API_KEY\` env var. Set \`UGC_ORG_ID\` to scope to a specific organization.
+
+## Tools
+
+### get_account_stats
+Get account stats (followers, following, views, likes). Without date range = latest per account.
+\`\`\`bash
+${run} get_account_stats
+${run} get_account_stats '{"tag":"fitness"}'
+${run} get_account_stats '{"startDate":"2024-01-01","endDate":"2024-01-31"}'
+\`\`\`
+
+### get_post_stats
+Get post stats (views, likes, comments, shares). Without date range = latest per post.
+\`\`\`bash
+${run} get_post_stats
+${run} get_post_stats '{"postIds":["id1","id2"]}'
+\`\`\`
+
+### get_daily_stats
+Get daily aggregated dashboard stats. Returns one row per day with all metrics.
+\`\`\`bash
+${run} get_daily_stats '{"startDate":"2024-01-01","endDate":"2024-01-31"}'
+${run} get_daily_stats '{"startDate":"2024-01-01","endDate":"2024-01-31","tag":"fitness"}'
+\`\`\`
+
+### get_top_accounts
+Get top N accounts by a metric.
+\`\`\`bash
+${run} get_top_accounts '{"metric":"followers","limit":5}'
+${run} get_top_accounts '{"metric":"views","limit":10,"tag":"fitness"}'
+\`\`\`
+Metrics: \`followers\`, \`following\`, \`views\`, \`likes\`
+
+### get_top_posts
+Get top N posts by a metric.
+\`\`\`bash
+${run} get_top_posts '{"metric":"views","limit":5}'
+${run} get_top_posts '{"metric":"likes","limit":10}'
+\`\`\`
+Metrics: \`views\`, \`likes\`, \`comments\`, \`shares\`
+
+### refresh_stats
+Refresh live stats from TikTok/Instagram. Rate limited to once per hour.
+\`\`\`bash
+${run} refresh_stats
+${run} refresh_stats '{"org_group":"team-a"}'
+\`\`\`
+
+## Additional tools (tasks, comments, org)
+
+### list_tasks / retry_tasks / delete_tasks
+\`\`\`bash
+${run} list_tasks '{"accountIds":["id"],"taskType":"warmup_scroll"}'
+${run} retry_tasks '{"taskIds":["id1"]}'
+${run} delete_tasks '{"taskIds":["id1"]}'
+\`\`\`
+
+### create_comment / list_comments
+\`\`\`bash
+${run} create_comment '{"accountId":"id","postUrl":"https://tiktok.com/...","commentText":"Great!"}'
+${run} list_comments '{"accountIds":["id"]}'
+\`\`\`
+
+### list_api_keys / list_integration_keys / upsert_integration_key
+\`\`\`bash
+${run} list_api_keys
+${run} list_integration_keys
+${run} upsert_integration_key '{"provider":"openai","key":"sk-..."}'
+\`\`\`
+
+## Workflow tips
+- When the user asks "how are things going", show top accounts + recent daily stats
+- Default to last 7 days if no date range specified
+- Present stats in a readable table format
+- For top accounts/posts, default to limit 5 unless asked otherwise
+- Mention when stats were last refreshed and offer to refresh if stale
+- If $ARGUMENTS is provided, interpret it as a natural language request
+`,
+};

package/dist/tools/accounts.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from './types';
+export declare const accountTools: ToolDefinition[];