@usenaive-sdk/cli 0.2.0 → 0.2.2

package/dist/commands/social.js

@@ -0,0 +1,402 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const socialCmd = new Command("social")
+    .description("Social media — connect accounts, create posts, view analytics (via bundle.social)")
+    .addHelpText("after", `
+Subcommands:
+  naive social status                  Check activation + connected accounts
+  naive social activate                Activate social media for your company
+  naive social connect                 Get OAuth URL for a platform
+  naive social portal                  Get multi-platform portal URL
+  naive social accounts                List connected accounts
+  naive social label <id> --label ...  Set a label on an account
+  naive social disconnect <id>         Disconnect an account
+  naive social sync                    Sync accounts from bundle.social
+  naive social upload --url <url>      Upload media from URL
+  naive social posts                   List posts
+  naive social post <content>          Create a post (draft by default)
+  naive social get <id>                Get post details
+  naive social edit <id>               Edit a draft post
+  naive social delete <id>             Delete a post
+  naive social publish <id>            Publish a draft
+  naive social analytics <id>          Get post analytics
+  naive social comments <id>           Get post comments
+  naive social account-analytics <id>  Get account analytics
+
+Supported Platforms:
+  TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE,
+  THREADS, PINTEREST, REDDIT, BLUESKY
+
+Platform Tips:
+  YouTube: --youtube-type SHORT (vertical, <3min) or VIDEO (landscape)
+  TikTok:  privacy auto-set to PUBLIC_TO_EVERYONE
+  Instagram: defaults to Reel type for video posts
+  Twitter: auto-truncated to 280 chars
+  Reddit:  pass --platform-data '{"REDDIT":{"sr":"subreddit"}}' for subreddit
+
+Cost:
+  - Publishing a post: 1 credit
+  - Drafts, analytics, account management: free
+`);
+socialCmd
+    .command("status")
+    .description("Check social media activation status and connected accounts")
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/social/status");
+    handleApiError("social.status", resp);
+    agentOutput({
+        action: "social.status",
+        result: resp.data,
+        next_steps: [
+            ...(resp.data.activated
+                ? [{ command: "naive social accounts", description: "List connected accounts" }]
+                : [{ command: "naive social activate", description: "Activate social media" }]),
+        ],
+        hints: [resp.data.activated ? "Social media is active" : "Social media is not yet activated"],
+    });
+});
+socialCmd
+    .command("activate")
+    .description("Activate social media integration for your company")
+    .action(async () => {
+    const resp = await apiRequest("POST", "/v1/social/activate");
+    handleApiError("social.activate", resp);
+    agentOutput({
+        action: "social.activate",
+        result: resp.data,
+        next_steps: [
+            { command: 'naive social connect --platform twitter --redirect-url https://example.com', description: "Connect a social account" },
+            { command: "naive social portal --redirect-url https://example.com", description: "Open multi-platform connect portal" },
+        ],
+        hints: ["Social media activated. Connect accounts to start posting."],
+    });
+});
+socialCmd
+    .command("connect")
+    .description("Get OAuth URL to connect a social media account")
+    .requiredOption("--platform <platform>", "Platform: TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE, THREADS, PINTEREST, REDDIT, BLUESKY")
+    .option("--redirect-url <url>", "URL to redirect after connection", "https://usenaive.ai/developers")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/social/connect", {
+        platform: opts.platform.toUpperCase(),
+        redirect_url: opts.redirectUrl,
+    });
+    handleApiError("social.connect", resp);
+    agentOutput({
+        action: "social.connect",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social sync", description: "Sync accounts after connecting" },
+            { command: "naive social accounts", description: "List connected accounts" },
+        ],
+        hints: [
+            `Open this URL to connect your ${opts.platform.toUpperCase()} account:`,
+            resp.data.url,
+            "After connecting, run 'naive social sync' to refresh accounts.",
+        ],
+    });
+});
+socialCmd
+    .command("portal")
+    .description("Get a portal URL to connect multiple social media platforms at once")
+    .option("--redirect-url <url>", "URL to redirect after connection", "https://usenaive.ai/developers")
+    .option("--platforms <list>", "Comma-separated platform list to show")
+    .action(async (opts) => {
+    const body = { redirect_url: opts.redirectUrl };
+    if (opts.platforms)
+        body.platforms = opts.platforms.split(",").map((p) => p.trim().toUpperCase());
+    const resp = await apiRequest("POST", "/v1/social/portal", body);
+    handleApiError("social.portal", resp);
+    agentOutput({
+        action: "social.portal",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social sync", description: "Sync accounts after connecting" },
+        ],
+        hints: [
+            "Open this URL to connect multiple social accounts:",
+            resp.data.url,
+        ],
+    });
+});
+socialCmd
+    .command("accounts")
+    .description("List connected social media accounts")
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/social/accounts");
+    handleApiError("social.accounts", resp);
+    agentOutput({
+        action: "social.accounts",
+        result: resp.data,
+        next_steps: [
+            { command: 'naive social post "Hello!" --platforms twitter', description: "Create a post" },
+            { command: 'naive social connect --platform <platform> --redirect-url <url>', description: "Connect more accounts" },
+        ],
+        hints: [`${(resp.data.accounts ?? []).length} connected account(s)`],
+    });
+});
+socialCmd
+    .command("label <account-id>")
+    .description("Set a label on a social media account")
+    .requiredOption("--label <label>", "Label text to set")
+    .action(async (accountId, opts) => {
+    const resp = await apiRequest("POST", `/v1/social/accounts/${accountId}/label`, { label: opts.label });
+    handleApiError("social.label", resp);
+    agentOutput({
+        action: "social.label",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social accounts", description: "List accounts" },
+        ],
+        hints: [`Label set to "${opts.label}"`],
+    });
+});
+socialCmd
+    .command("disconnect <account-id>")
+    .description("Disconnect a social media account")
+    .action(async (accountId) => {
+    const resp = await apiRequest("DELETE", `/v1/social/accounts/${accountId}`);
+    handleApiError("social.disconnect", resp);
+    agentOutput({
+        action: "social.disconnect",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social accounts", description: "List remaining accounts" },
+        ],
+        hints: ["Account disconnected"],
+    });
+});
+socialCmd
+    .command("sync")
+    .description("Sync social accounts from bundle.social")
+    .action(async () => {
+    const resp = await apiRequest("POST", "/v1/social/sync");
+    handleApiError("social.sync", resp);
+    agentOutput({
+        action: "social.sync",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social accounts", description: "View synced accounts" },
+        ],
+        hints: [`Synced ${resp.data.synced ?? 0} account(s)`],
+    });
+});
+socialCmd
+    .command("upload")
+    .description("Upload media from a URL for use in social posts")
+    .requiredOption("--url <url>", "Public URL of the media file")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/social/upload", { url: opts.url });
+    handleApiError("social.upload", resp);
+    agentOutput({
+        action: "social.upload",
+        result: resp.data,
+        next_steps: [
+            { command: 'naive social post "content" --platforms youtube --media-url <url>', description: "Create a post with media" },
+        ],
+        hints: ["Media uploaded. Use the upload ID or pass media_urls when creating posts (auto-upload)."],
+    });
+});
+socialCmd
+    .command("posts")
+    .description("List social media posts")
+    .option("--status <status>", "Filter by status: draft, scheduled, published, failed")
+    .option("--limit <n>", "Max results", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.status)
+        params.set("status", opts.status);
+    params.set("limit", opts.limit);
+    params.set("offset", opts.offset);
+    const resp = await apiRequest("GET", `/v1/social/posts?${params}`);
+    handleApiError("social.posts", resp);
+    agentOutput({
+        action: "social.posts",
+        result: resp.data,
+        next_steps: [
+            { command: 'naive social post "content" --platforms twitter', description: "Create a new post" },
+        ],
+        hints: [`${resp.data.count ?? 0} post(s) returned`],
+    });
+});
+socialCmd
+    .command("post [content]")
+    .description("Create a social media post (draft by default, use --publish to publish immediately)")
+    .requiredOption("--platforms <list>", "Comma-separated platforms: twitter,linkedin,youtube,...")
+    .option("--publish", "Publish immediately (default: create as draft)")
+    .option("--media-url <url>", "Media URL (auto-uploaded for video/image platforms)")
+    .option("--youtube-type <type>", "YouTube type: SHORT (vertical, <3min) or VIDEO (landscape)")
+    .option("--platform-data <json>", "Per-platform overrides as JSON")
+    .option("--title <title>", "Post title (auto-generated from content if omitted)")
+    .option("--account-ids <ids>", "Comma-separated account UUIDs to post from")
+    .option("--schedule-at <datetime>", "ISO 8601 datetime to schedule the post")
+    .action(async (content, opts) => {
+    if (!content) {
+        console.error(JSON.stringify({
+            success: false,
+            action: "social.post",
+            error: { code: "missing_argument", message: "Provide the post content as a positional argument" },
+            recovery_steps: [
+                { command: 'naive social post "Your content here" --platforms twitter,linkedin --publish', description: "Create and publish a post" },
+                { command: 'naive social post "Your content here" --platforms twitter,linkedin', description: "Create a draft" },
+            ],
+        }, null, 2));
+        process.exit(1);
+    }
+    const body = {
+        content,
+        platforms: opts.platforms.split(",").map((p) => p.trim().toUpperCase()),
+        publish_now: !!(opts.publish || opts.scheduleAt),
+    };
+    if (opts.title)
+        body.title = opts.title;
+    if (opts.mediaUrl)
+        body.media_urls = [opts.mediaUrl];
+    if (opts.youtubeType)
+        body.youtube_type = opts.youtubeType.toUpperCase();
+    if (opts.platformData)
+        body.platform_data = JSON.parse(opts.platformData);
+    if (opts.accountIds)
+        body.account_ids = opts.accountIds.split(",").map((id) => id.trim());
+    if (opts.scheduleAt)
+        body.scheduled_at = opts.scheduleAt;
+    const resp = await apiRequest("POST", "/v1/social/posts", body);
+    handleApiError("social.post", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "social.post",
+        result: resp.data,
+        next_steps: [
+            ...(data.status === "draft"
+                ? [{ command: `naive social publish ${data.id}`, description: "Publish this draft" }]
+                : [{ command: `naive social get ${data.id}`, description: "Check post status" }]),
+            { command: `naive social analytics ${data.id}`, description: "View post analytics (after publishing)" },
+        ],
+        hints: [
+            data.status === "draft"
+                ? "Draft created. Use 'naive social publish' to publish, or re-run with --publish."
+                : `Post ${data.status === "publishing" ? "queued for publishing" : "scheduled"}. 1 credit deducted.`,
+        ],
+        related_commands: ["naive social posts", "naive social analytics"],
+    });
+});
+socialCmd
+    .command("get <post-id>")
+    .description("Get details of a social media post")
+    .action(async (postId) => {
+    const resp = await apiRequest("GET", `/v1/social/posts/${postId}`);
+    handleApiError("social.get", resp);
+    agentOutput({
+        action: "social.get",
+        result: resp.data,
+        next_steps: [
+            { command: `naive social analytics ${postId}`, description: "View analytics" },
+            { command: `naive social comments ${postId}`, description: "View comments" },
+        ],
+        hints: [`Post status: ${resp.data.status}`],
+    });
+});
+socialCmd
+    .command("edit <post-id>")
+    .description("Edit a draft social media post")
+    .option("--content <text>", "Updated content")
+    .option("--platforms <list>", "Updated comma-separated platform list")
+    .option("--platform-data <json>", "Updated per-platform overrides as JSON")
+    .action(async (postId, opts) => {
+    const body = {};
+    if (opts.content)
+        body.content = opts.content;
+    if (opts.platforms)
+        body.platforms = opts.platforms.split(",").map((p) => p.trim().toUpperCase());
+    if (opts.platformData)
+        body.platform_data = JSON.parse(opts.platformData);
+    const resp = await apiRequest("PATCH", `/v1/social/posts/${postId}`, body);
+    handleApiError("social.edit", resp);
+    agentOutput({
+        action: "social.edit",
+        result: resp.data,
+        next_steps: [
+            { command: `naive social publish ${postId}`, description: "Publish the updated draft" },
+        ],
+        hints: ["Draft updated"],
+    });
+});
+socialCmd
+    .command("delete <post-id>")
+    .description("Delete a social media post")
+    .action(async (postId) => {
+    const resp = await apiRequest("DELETE", `/v1/social/posts/${postId}`);
+    handleApiError("social.delete", resp);
+    agentOutput({
+        action: "social.delete",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social posts", description: "View remaining posts" },
+        ],
+        hints: ["Post deleted"],
+    });
+});
+socialCmd
+    .command("publish <post-id>")
+    .description("Publish a draft social media post (costs 1 credit)")
+    .action(async (postId) => {
+    const resp = await apiRequest("POST", `/v1/social/posts/${postId}/publish`);
+    handleApiError("social.publish", resp);
+    agentOutput({
+        action: "social.publish",
+        result: resp.data,
+        next_steps: [
+            { command: `naive social get ${postId}`, description: "Check post status" },
+            { command: `naive social analytics ${postId}`, description: "View analytics" },
+        ],
+        hints: ["Post published (1 credit deducted)"],
+    });
+});
+socialCmd
+    .command("analytics <post-id>")
+    .description("Get analytics for a published social media post")
+    .action(async (postId) => {
+    const resp = await apiRequest("GET", `/v1/social/posts/${postId}/analytics`);
+    handleApiError("social.analytics", resp);
+    agentOutput({
+        action: "social.analytics",
+        result: resp.data,
+        next_steps: [
+            { command: `naive social comments ${postId}`, description: "View comments" },
+        ],
+        hints: ["Post analytics retrieved"],
+    });
+});
+socialCmd
+    .command("comments <post-id>")
+    .description("Get comments on a published social media post")
+    .action(async (postId) => {
+    const resp = await apiRequest("GET", `/v1/social/posts/${postId}/comments`);
+    handleApiError("social.comments", resp);
+    agentOutput({
+        action: "social.comments",
+        result: resp.data,
+        next_steps: [
+            { command: `naive social analytics ${postId}`, description: "View analytics" },
+        ],
+        hints: ["Post comments retrieved"],
+    });
+});
+socialCmd
+    .command("account-analytics <account-id>")
+    .description("Get analytics for a connected social media account")
+    .action(async (accountId) => {
+    const resp = await apiRequest("GET", `/v1/social/accounts/${accountId}/analytics`);
+    handleApiError("social.account-analytics", resp);
+    agentOutput({
+        action: "social.account-analytics",
+        result: resp.data,
+        next_steps: [
+            { command: "naive social accounts", description: "List all accounts" },
+        ],
+        hints: ["Account analytics retrieved"],
+    });
+});
+//# sourceMappingURL=social.js.map

package/dist/commands/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../../src/commands/social.ts"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const statusCmd: Command;

package/dist/commands/status.js

@@ -0,0 +1,47 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const statusCmd = new Command("status")
+    .description("Show full agent status: identity, credits, tier, and resource summary")
+    .addHelpText("after", `
+Examples:
+  $ naive status
+
+What this does:
+  Returns a comprehensive status overview:
+  - Agent identity (name, ID)
+  - Company context (name, ID)
+  - Credit balance and billing tier
+  - Resource counts (inboxes, active jobs, etc.)
+  - API connectivity confirmation
+
+Use this to:
+  - Verify the CLI is properly configured and authenticated
+  - Check remaining credits before starting a task
+  - Get a quick overview of available resources
+  - Confirm which company you're operating under
+`)
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/status");
+    handleApiError("status", resp);
+    const data = resp.data;
+    const lowCredits = data.credits?.balance < 10;
+    agentOutput({
+        action: "status",
+        result: resp.data,
+        next_steps: [
+            ...(lowCredits
+                ? [{ command: "# Add credits at https://usenaive.ai/billing", description: "Your credit balance is low", when: "Balance below 10 credits" }]
+                : []),
+            { command: "naive usage", description: "See detailed credit usage history" },
+            { command: "naive identity", description: "View full resource details" },
+            { command: "naive jobs --status processing", description: "Check active async jobs" },
+        ],
+        hints: [
+            `Balance: ${data.credits?.balance ?? "?"} credits (${data.credits?.tier ?? "free"} tier)`,
+            ...(lowCredits ? ["WARNING: Low credit balance. Some operations may fail."] : []),
+        ],
+        related_commands: ["naive whoami", "naive usage", "naive identity", "naive jobs"],
+    });
+});
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC3C,WAAW,CAAC,uEAAuE,CAAC;KACpF,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;CAiBvB,CAAC;KACC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACnD,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAKjB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,CAAC;IAE9C,WAAW,CAAC;QACV,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,UAAU,EAAE;YACV,GAAG,CAAC,UAAU;gBACZ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,WAAW,EAAE,4BAA4B,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBAC5I,CAAC,CAAC,EAAE,CAAC;YACP,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mCAAmC,EAAE;YAC5E,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACxE,EAAE,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,yBAAyB,EAAE;SACtF;QACD,KAAK,EAAE;YACL,YAAY,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,GAAG,aAAa,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,MAAM,QAAQ;YACzF,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAClF;QACD,gBAAgB,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,CAAC;KAClF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/usage.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const usageCmd: Command;

package/dist/commands/usage.js

@@ -0,0 +1,62 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const usageCmd = new Command("usage")
+    .description("Show credit usage history with transaction details")
+    .option("--days <n>", "Number of days to look back (default: 30)", "30")
+    .option("--limit <n>", "Maximum number of transactions to return (default: 50)", "50")
+    .addHelpText("after", `
+Examples:
+  $ naive usage
+  $ naive usage --days 7
+  $ naive usage --days 1 --limit 100
+
+What this does:
+  Returns a list of credit transactions showing:
+  - Transaction type (deduction, addition, refund)
+  - Amount and running balance
+  - Operation that triggered it (e.g., "image_generation", "email_send")
+  - Timestamp
+  - Reference ID (for idempotency/audit)
+
+Use this to:
+  - Audit what's consuming credits
+  - Identify expensive operations
+  - Verify credits were deducted correctly after async job completion
+  - Check if a refund was issued for a failed job
+
+Credit costs reference:
+  Fixed-price operations:
+  - Web search: 0.01 credits
+  - URL extraction: 0.02 credits
+  - Email send: 1.0 credits
+  - Stock photo search: free (0 credits)
+  - Deep research: 1.0–5.0 credits (depth-dependent)
+
+  Dynamic-price operations (fal.ai — model-dependent):
+  - Image generation: varies (GET /v1/images/pricing to preview)
+  - Video generation: varies (GET /v1/video/pricing to preview)
+  - Pricing: based on fal.ai model costs, at $0.50 per credit
+`)
+    .action(async (opts) => {
+    const resp = await apiRequest("GET", `/v1/usage?days=${opts.days}&limit=${opts.limit}`);
+    handleApiError("usage", resp);
+    const data = resp.data;
+    const count = data.transactions?.length ?? 0;
+    agentOutput({
+        action: "usage",
+        result: resp.data,
+        next_steps: [
+            { command: "naive status", description: "See current balance summary" },
+            { command: "naive usage --days 1", description: "Narrow to today's usage only" },
+            { command: "naive jobs", description: "Check pending jobs (credits deducted on completion)" },
+        ],
+        hints: [
+            `Showing ${count} transactions from the last ${opts.days} days`,
+            "Async jobs (image/video generation) deduct credits only on completion, not at submission",
+            "Failed async jobs do not deduct credits",
+        ],
+        related_commands: ["naive status", "naive jobs"],
+    });
+});
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KACzC,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,YAAY,EAAE,2CAA2C,EAAE,IAAI,CAAC;KACvE,MAAM,CAAC,aAAa,EAAE,wDAAwD,EAAE,IAAI,CAAC;KACrF,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvB,CAAC;KACC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACxF,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAiE,CAAC;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC;IAE7C,WAAW,CAAC;QACV,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,UAAU,EAAE;YACV,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,8BAA8B,EAAE;YAChF,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,qDAAqD,EAAE;SAC9F;QACD,KAAK,EAAE;YACL,WAAW,KAAK,+BAA+B,IAAI,CAAC,IAAI,OAAO;YAC/D,0FAA0F;YAC1F,yCAAyC;SAC1C;QACD,gBAAgB,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;KACjD,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/video.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const videoCmd: Command;