@postplus/cli 0.1.34 → 0.1.36

package/build/hosted-schema-catalog.js

@@ -0,0 +1,307 @@
+// Generated from the PostPlus Cloud hosted catalog release gate.
+// Keep keys in sync with apps/web hosted capability and collection catalogs.
+export const RESEARCH_COLLECTION_HINTS = {
+    'amazon-asins': {
+        asins: ['B0C1234567'],
+        country: 'US',
+    },
+    'amazon-bestsellers': {
+        categoryUrl: 'https://www.amazon.com/Best-Sellers/zgbs',
+        maxItems: 5,
+    },
+    'amazon-free-products': {
+        keyword: 'portable blender',
+        maxItems: 5,
+    },
+    'amazon-products': {
+        country: 'US',
+        keyword: 'portable blender',
+        maxItems: 5,
+    },
+    'amazon-reviews': {
+        asin: 'B0C1234567',
+        country: 'US',
+        maxReviews: 10,
+    },
+    'amazon-reviews-v2': {
+        asin: 'B0C1234567',
+        domainCode: 'com',
+        maxReviews: 10,
+    },
+    'google-trends-fast': {
+        queries: ['portable blender'],
+    },
+    'instagram-comments': {
+        directUrls: ['https://www.instagram.com/p/example/'],
+        resultsLimit: 5,
+    },
+    'instagram-email-search': {
+        Country: 'www',
+        Email_Type: '0',
+        Keyword: 'skincare creator',
+        Limit: '10',
+        social_network: 'instagram.com/',
+    },
+    'instagram-hashtags': {
+        hashtags: ['desksetup'],
+        resultsLimit: 3,
+    },
+    'instagram-posts': {
+        resultsLimit: 3,
+        username: ['openai'],
+    },
+    'instagram-profiles': {
+        resultsLimit: 3,
+        usernames: ['instagram'],
+    },
+    'instagram-search': {
+        searchLimit: 3,
+        searchTerms: ['skincare routine'],
+        searchType: 'user',
+    },
+    'tiktok-ads-top': {
+        include_analytics: true,
+        limit: 1,
+    },
+    'tiktok-comments': {
+        postURLs: ['https://www.tiktok.com/@example/video/1234567890'],
+        resultsPerPage: 5,
+    },
+    'tiktok-profiles': {
+        usernames: ['tiktok'],
+    },
+    'tiktok-related-videos': {
+        maxItems: 3,
+        postURLs: ['https://www.tiktok.com/@example/video/1234567890'],
+    },
+    'tiktok-users': {
+        maxItems: 5,
+        searchQueries: ['skincare creator'],
+    },
+    'tiktok-videos': {
+        maxItems: 3,
+        proxyCountryCode: 'US',
+        queries: ['portable blender'],
+        searchSection: '/video',
+    },
+    'youtube-channel-summary': {
+        channels: ['@Google'],
+        includeChannelInfo: true,
+        includeVideos: false,
+        maxVideosPerChannel: 0,
+    },
+    'youtube-comments': {
+        maxComments: 10,
+        startUrls: ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'],
+    },
+    'youtube-video-download': {
+        urls: ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'],
+    },
+    'x-posts': {
+        maxItems: 5,
+        searchTerms: ['product launch'],
+    },
+    'x-profiles': {
+        handles: ['OpenAI'],
+    },
+};
+export const PUBLIC_CONTENT_SOURCE_HINTS = {
+    'facebook-group-posts': [
+        {
+            url: 'https://www.facebook.com/groups/example',
+        },
+    ],
+    'facebook-post-by-url': [
+        {
+            url: 'https://www.facebook.com/openai/posts/example',
+        },
+    ],
+    'facebook-profile-posts': [
+        {
+            url: 'https://www.facebook.com/openai',
+        },
+    ],
+    'youtube-videos': [
+        {
+            url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+        },
+    ],
+};
+export const PUBLIC_CONTENT_DISCOVERY_TOOL_HINTS = {
+    'web-search': {
+        limit: 5,
+        query: 'portable blender reviews',
+    },
+};
+export const MEDIA_ENDPOINT_HINTS = {
+    'image-gpt-image-2-edit': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        quality: 'medium',
+        size: '1024x1024',
+    },
+    'image-gpt-image-2-text': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        quality: 'medium',
+        size: '1024x1024',
+    },
+    'image-nano-banana-2-edit': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        quality: 'medium',
+        size: '1024x1024',
+    },
+    'image-nano-banana-2-text': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        quality: 'medium',
+        size: '1024x1024',
+    },
+    'image-nano-banana-pro-edit-1k': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        resolution: '1k',
+    },
+    'image-nano-banana-pro-edit-2k': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        resolution: '2k',
+    },
+    'image-nano-banana-pro-edit-4k': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        resolution: '4k',
+    },
+    'image-nano-banana-pro-text-1k': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        resolution: '1k',
+    },
+    'image-nano-banana-pro-text-2k': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        resolution: '2k',
+    },
+    'image-nano-banana-pro-text-4k': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        resolution: '4k',
+    },
+    'image-seedream-v5-lite-edit': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Edit the reference into a clean product-style vertical image.',
+        size: '1024x1024',
+    },
+    'image-seedream-v5-lite-edit-sequential': {
+        inputUrls: ['https://example.com/reference-image.png'],
+        prompt: 'Create a coherent sequence of edited product reference images.',
+        size: '1024x1024',
+    },
+    'image-seedream-v5-lite-sequential': {
+        aspect_ratio: '9:16',
+        prompt: 'Create a coherent sequence of vertical product images.',
+        size: '1024x1024',
+    },
+    'image-seedream-v5-lite-text': {
+        aspect_ratio: '9:16',
+        prompt: 'A realistic vertical product image on a clean white desk.',
+        size: '1024x1024',
+    },
+    'transcription-whisper': {
+        audio: 'https://example.com/input-audio.mp3',
+        language: 'en',
+        response_format: 'verbose_json',
+        timestamp_granularities: ['segment'],
+    },
+    'transcription-whisper-turbo': {
+        audio: 'https://example.com/input-audio.mp3',
+        language: 'en',
+        response_format: 'verbose_json',
+        timestamp_granularities: ['segment'],
+    },
+    'transcription-whisper-with-video': {
+        language: 'en',
+        response_format: 'verbose_json',
+        timestamp_granularities: ['segment'],
+        video: 'https://example.com/input-video.mp4',
+    },
+    'video-infinitetalk': {
+        audio: 'https://example.com/voiceover.wav',
+        image: 'https://example.com/persona.png',
+        prompt: 'Talking-head delivery in a natural vertical social ad style.',
+    },
+    'video-kling-v2-6-pro-motion-control': {
+        character_orientation: 'image',
+        image: 'https://example.com/subject.png',
+        video: 'https://example.com/reference-motion.mp4',
+    },
+    'video-kling-v3-0-pro-image': {
+        duration: 5,
+        image: 'https://example.com/start-frame.png',
+        prompt: 'Animate the product in a clean realistic vertical scene.',
+        sound: false,
+    },
+    'video-kling-v3-0-pro-text': {
+        aspect_ratio: '9:16',
+        duration: 5,
+        prompt: 'A realistic vertical short-form product reveal.',
+        sound: false,
+    },
+    'video-kling-v3-0-std-image': {
+        duration: 5,
+        image: 'https://example.com/start-frame.png',
+        prompt: 'Animate the product in a clean realistic vertical scene.',
+        sound: false,
+    },
+    'video-kling-v3-0-std-text': {
+        aspect_ratio: '9:16',
+        duration: 5,
+        prompt: 'A realistic vertical short-form product reveal.',
+        sound: false,
+    },
+    'video-seedance-2-image': {
+        duration: 5,
+        image: 'https://example.com/start-frame.png',
+        prompt: 'A realistic vertical short-form product reveal.',
+        resolution: '720p',
+    },
+    'video-seedance-2-image-turbo': {
+        duration: 5,
+        image: 'https://example.com/start-frame.png',
+        prompt: 'A realistic vertical short-form product reveal.',
+        resolution: '720p',
+    },
+    'video-seedance-2-text': {
+        duration: 5,
+        prompt: 'A realistic vertical short-form product reveal.',
+        resolution: '720p',
+    },
+    'video-seedance-2-text-turbo': {
+        duration: 5,
+        prompt: 'A realistic vertical short-form product reveal.',
+        resolution: '720p',
+    },
+    'voice-qwen3-clone': {
+        reference_audio: 'https://example.com/reference-voice.wav',
+        text: 'Short voiceover line to synthesize.',
+    },
+    'voice-qwen3-design': {
+        language: 'en',
+        text: 'Short voiceover line to synthesize.',
+        voiceDescription: 'Warm, clear, natural creator voice.',
+    },
+};
+export const VIDEO_ANALYSIS_MODEL_HINTS = {
+    'gemini-video-analysis': {
+        contents: [
+            {
+                parts: [
+                    {
+                        text: 'Analyze this short video and return concise creative observations.',
+                    },
+                ],
+            },
+        ],
+    },
+};

package/build/index.js

@@ -7,6 +7,7 @@ import { formatAuthValidateReport, validateRemoteAuth, } from './auth-validate.j
 import { clearAuthState, formatAuthStatusReport, generateAuthStatusReport, } from './auth.js';
 import { readCurrentCliVersion } from './client-compatibility.js';
 import { formatDoctorReport, generateDoctorReport } from './doctor.js';
+import { runHostedDomainCommand } from './hosted-domain-commands.js';
 import { assertConfigFilePermissions } from './local-state.js';
 import { readLargeCreditQuoteConfirmationChallenge, resolveLargeCreditQuoteConfirmation, } from './quote-confirmation.js';
 import { POSTPLUS_SKILLS_CURRENT_DIRECTORY_INSTALL_COMMAND, POSTPLUS_SKILLS_INSTALL_COMMAND, formatPostPlusSkillsInstallCommand, loadPublicSkillCatalog, } from './skill-catalog.js';
@@ -42,6 +43,14 @@ Usage:
   postplus auth validate [--json]
   postplus auth logout [--json]
   postplus doctor [--skill <skill-id>] [--json]
+  postplus research schema [--collection-key <key>] [--json]
+  postplus research collect --skill <skill-id> --collection-key <key> --input <hosted-envelope.json> [--output <result.json>]
+  postplus media schema [--endpoint <endpoint-key>] [--json]
+  postplus media capability --request <hosted-capability-request.json> [--output <result.json>]
+  postplus publish schema [--json]
+  postplus publish capability --request <hosted-capability-request.json> [--output <result.json>]
+  postplus mobile schema [--json]
+  postplus mobile capability --request <hosted-capability-request.json> [--output <result.json>]
   postplus quote confirm --json --challenge-file <path>
   postplus skills verify [--json]
   postplus studio init|open|status   Open bundled Local Studio
@@ -229,6 +238,9 @@ function parseQuoteConfirmOptions(args) {
 function writeJson(value) {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 }
+function isHelpArg(value) {
+    return value === 'help' || value === '--help' || value === '-h';
+}
 function parseDiagnosticOptions(args) {
     const options = {
         json: false,
@@ -351,6 +363,18 @@ async function main() {
         case 'doctor':
             process.exitCode = await runDoctor(parseDiagnosticOptions(rest));
             return;
+        case 'research':
+            process.exitCode = await runHostedDomainCommand('research', rest);
+            return;
+        case 'media':
+            process.exitCode = await runHostedDomainCommand('media', rest);
+            return;
+        case 'publish':
+            process.exitCode = await runHostedDomainCommand('publish', rest);
+            return;
+        case 'mobile':
+            process.exitCode = await runHostedDomainCommand('mobile', rest);
+            return;
         case 'quote':
             process.exitCode = await runQuoteCommand(rest);
             return;
@@ -380,6 +404,17 @@ async function main() {
             const [subcommand, ...authRest] = rest;
             switch (subcommand) {
                 case 'login':
+                    if (authRest.some(isHelpArg)) {
+                        printAuthHelp();
+                        process.exitCode = 0;
+                        return;
+                    }
+                    if (authRest.length > 0) {
+                        process.stderr.write(`Unknown auth login option: ${authRest[0]}\n\n`);
+                        printAuthHelp();
+                        process.exitCode = 1;
+                        return;
+                    }
                     process.exitCode = await runAuthLogin();
                     return;
                 case 'refresh':

package/build/skill-catalog.js

@@ -16,7 +16,6 @@ const POSTPLUS_SKILLS_AGENT_ARGS = POSTPLUS_SKILLS_AGENT_TARGETS.join(' ');
 export const POSTPLUS_SKILLS_INSTALL_COMMAND = formatPostPlusSkillsInstallCommand();
 export const POSTPLUS_SKILLS_CURRENT_DIRECTORY_INSTALL_COMMAND = formatPostPlusSkillsInstallCommand(POSTPLUS_SKILLS_REPO, 'current-directory');
 export const POSTPLUS_SKILLS_LIST_COMMAND = formatPostPlusSkillsListCommand();
-const POSTPLUS_SKILLS_INDEX_URL = 'https://raw.githubusercontent.com/PostPlusAI/postplus-skills/main/skills/INDEX.md';
 const POSTPLUS_SKILLS_CATALOG_URL = 'https://raw.githubusercontent.com/PostPlusAI/postplus-skills/main/skills/catalog.json';
 export const PUBLIC_SKILL_REQUIREMENT_KEYS = [
     'accountConnections',
@@ -45,7 +44,6 @@ export async function loadPublicSkillCatalog(fetchFn = fetch, env = process.env)
     return {
         ...catalog,
         catalogUrl,
-        indexUrl: POSTPLUS_SKILLS_INDEX_URL,
         installCommand: formatPostPlusSkillsInstallCommand(skillsSource),
         listCommand: formatPostPlusSkillsListCommand(skillsSource),
         source: skillsSource,
@@ -59,7 +57,7 @@ export function resolvePostPlusSkillsCatalogUrl(env = process.env) {
 }
 export function formatPostPlusSkillsInstallCommand(source = POSTPLUS_SKILLS_REPO, scope = 'global') {
     const scopeArgs = scope === 'global' ? ' --global' : '';
-    return `npx -y skills add ${source}${scopeArgs} --full-depth --skill '*' --agent ${POSTPLUS_SKILLS_AGENT_ARGS} --yes`;
+    return `for agent in ${POSTPLUS_SKILLS_AGENT_ARGS}; do npx -y skills add ${source}${scopeArgs} --full-depth --skill '*' --agent "$agent" --yes; done`;
 }
 export function formatPostPlusSkillsListCommand(source = POSTPLUS_SKILLS_REPO) {
     return `npx -y skills add ${source} --list --full-depth`;

package/build/skill-management.js

@@ -17,14 +17,18 @@ export async function runPostPlusSkillUpdate(dependencies = {
     if (skillNames.length === 0) {
         throw new Error('PostPlus public skill catalog has no released skills.');
     }
-    const updateExitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUpdateArgs(skillNames, options.scope));
-    if (updateExitCode !== 0) {
-        return updateExitCode;
+    for (const agentTarget of POSTPLUS_SKILLS_AGENT_TARGETS) {
+        const updateExitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUpdateArgs(skillNames, options.scope, agentTarget));
+        if (updateExitCode !== 0) {
+            return updateExitCode;
+        }
     }
     if (retiredSkillNames.length > 0) {
-        const removeExitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUninstallArgs(retiredSkillNames, options.scope));
-        if (removeExitCode !== 0) {
-            return removeExitCode;
+        for (const agentTarget of POSTPLUS_SKILLS_AGENT_TARGETS) {
+            const removeExitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUninstallArgs(retiredSkillNames, options.scope, agentTarget));
+            if (removeExitCode !== 0) {
+                return removeExitCode;
+            }
         }
     }
     await writeManagedSkillBaseline({
@@ -45,12 +49,15 @@ export async function runPostPlusSkillUninstall(dependencies = {
     if (allKnownSkillNames.length === 0) {
         throw new Error('PostPlus public skill catalog has no released skills.');
     }
-    const exitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUninstallArgs(allKnownSkillNames, options.scope));
-    if (exitCode === 0) {
-        await clearManagedSkillBaseline();
-        await clearUpdateCheckCache();
+    for (const agentTarget of POSTPLUS_SKILLS_AGENT_TARGETS) {
+        const exitCode = await dependencies.runInteractiveCommand('npx', buildPostPlusSkillUninstallArgs(allKnownSkillNames, options.scope, agentTarget));
+        if (exitCode !== 0) {
+            return exitCode;
+        }
     }
-    return exitCode;
+    await clearManagedSkillBaseline();
+    await clearUpdateCheckCache();
+    return 0;
 }
 export async function generateSkillInstallStatusReport(dependencies = {
     runCommand,
@@ -210,7 +217,7 @@ export function formatSkillBaselineVerifyReport(report) {
     }
     return lines.join('\n');
 }
-export function buildPostPlusSkillUpdateArgs(skillNames, scope = 'global') {
+export function buildPostPlusSkillUpdateArgs(skillNames, scope = 'global', agentTarget) {
     if (skillNames.length === 0) {
         throw new Error('PostPlus public skill catalog has no released skills.');
     }
@@ -224,18 +231,18 @@ export function buildPostPlusSkillUpdateArgs(skillNames, scope = 'global') {
         '--skill',
         '*',
         '--agent',
-        ...POSTPLUS_SKILLS_AGENT_TARGETS,
+        ...(agentTarget ? [agentTarget] : POSTPLUS_SKILLS_AGENT_TARGETS),
         '--yes',
     ];
 }
-export function buildPostPlusSkillUninstallArgs(skillNames, scope = 'global') {
+export function buildPostPlusSkillUninstallArgs(skillNames, scope = 'global', agentTarget) {
     return [
         ...NPX_SKILLS,
         'remove',
         ...skillNames,
         ...buildSkillScopeArgs(scope),
         '--agent',
-        ...POSTPLUS_SKILLS_AGENT_TARGETS,
+        ...(agentTarget ? [agentTarget] : POSTPLUS_SKILLS_AGENT_TARGETS),
         '--yes',
     ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",
@@ -15,7 +15,10 @@
     "build/client-compatibility.js",
     "build/command-runner.js",
     "build/doctor.js",
+    "build/hosted-domain-commands.js",
     "build/hosted-release.js",
+    "build/hosted-schema-catalog.js",
+    "build/hosted-request-schemas.js",
     "build/index.js",
     "build/local-dependencies.js",
     "build/local-state.js",
@@ -42,7 +45,7 @@
     "postplus": "build/index.js"
   },
   "scripts": {
-    "build": "node ./scripts/clean-build.mjs && tsc",
+    "build": "node ./scripts/clean-build.mjs && tsc && node ./scripts/finalize-build.mjs",
     "clean": "rm -rf .turbo node_modules build",
     "release:package": "node ./scripts/package-release.mjs",
     "start": "tsx src/index.ts",