@postplus/cli 0.1.40 → 0.1.42

package/build/doctor.js

@@ -389,8 +389,15 @@ function collectHostedRequirementKeys(requirements) {
         ...requirements.sourceKeys,
     ]);
 }
+// Capability families whose sub-keys are intentionally NOT expressible as catalog
+// requirement keys: a skill requires the bare family capability, and any released
+// sub-key readiness row satisfies it. social-publishing operations and
+// public-content-discovery tools (e.g. web-search) both have no requirement-key
+// binding, so requiring the family must match the whole family. Without this,
+// `public-content-discovery:web-search` readiness is filtered out for skills that
+// require `public-content-discovery`, producing a false "readiness check missing".
 function isWholeFamilyHostedCapability(prefix) {
-    return prefix === 'social-publishing';
+    return prefix === 'public-content-discovery' || prefix === 'social-publishing';
 }
 function requiresSocialPublishingPlan(requirements) {
     return requirements.hostedCapabilities.includes('social-publishing');

package/build/generated/hosted-execution-manifest.generated.js

@@ -441,6 +441,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -518,6 +522,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -576,6 +584,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -634,6 +646,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -692,6 +708,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -758,6 +778,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -824,6 +848,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -890,6 +918,10 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": "--output-format",
                             "type": "string",
+                            "enumValues": [
+                                "png",
+                                "jpeg"
+                            ],
                             "default": "png",
                             "required": false
                         },
@@ -1308,7 +1340,6 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "flag": null,
                             "type": "string",
                             "enumValues": [
-                                "480p",
                                 "720p",
                                 "1080p"
                             ],
@@ -1467,7 +1498,6 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "flag": null,
                             "type": "string",
                             "enumValues": [
-                                "480p",
                                 "720p",
                                 "1080p"
                             ],
@@ -2388,6 +2418,19 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": null,
                             "type": "string",
+                            "enumValues": [
+                                "auto",
+                                "Chinese",
+                                "English",
+                                "German",
+                                "Italian",
+                                "Portuguese",
+                                "Spanish",
+                                "Japanese",
+                                "Korean",
+                                "French",
+                                "Russian"
+                            ],
                             "default": "auto",
                             "required": false
                         },
@@ -2448,6 +2491,19 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "class": "default",
                             "flag": null,
                             "type": "string",
+                            "enumValues": [
+                                "auto",
+                                "Chinese",
+                                "English",
+                                "German",
+                                "Italian",
+                                "Portuguese",
+                                "Spanish",
+                                "Japanese",
+                                "Korean",
+                                "French",
+                                "Russian"
+                            ],
                             "default": "auto",
                             "required": false
                         },

package/build/hosted-domain-commands.js

@@ -59,6 +59,13 @@ export async function runHostedDomainCommand(domain, args) {
     if (subcommand === 'schema') {
         return runHostedSchema(domain, rest);
     }
+    // Poll a pending async media-generation run by handle. This is a hand-coded
+    // branch (not a manifest verb) because a status poll has no endpointKey/field
+    // contract to project — exactly like the `research collect --run-handle`
+    // polling branch. It must be checked before the manifest verb dispatch.
+    if (domain === 'media' && subcommand === 'poll') {
+        return runMediaPoll(rest);
+    }
     if (domain === 'media' && subcommand && MEDIA_VERB_ENDPOINTS.has(subcommand)) {
         return runMediaVerb(subcommand, rest);
     }
@@ -237,8 +244,11 @@ function requireResolvedEndpoint(resolved, verb, endpointKey) {
 // video-analysis verb (request-json surface). The agent authors an opaque Gemini
 // request object (contents + generationConfig) in `--request <file>`; capability,
 // operation, and modelKey come from the verb + positional, so the body posts
-// EXACTLY the locked Web contract. There is no field classification and no
-// estimatedUsage — the payload is forwarded verbatim as the Gemini request.
+// EXACTLY the locked Web contract. There is no field classification; the payload
+// is forwarded verbatim as the Gemini request. The optional `--video-seconds`
+// flag is the one runner-supplied hint: when provided it is sent as
+// `estimatedUsage.videoSeconds` so the Web boundary can route eligible short
+// videos through its preflight/routing path (omit it to use the default route).
 async function runVideoAnalysisVerb(args) {
     const { modelKey, resolved, verb } = args;
     const flags = parseFlags(args.args, new Set(['json']));
@@ -249,6 +259,7 @@ async function runVideoAnalysisVerb(args) {
         'quote-confirmation-token',
         'request',
         'skill',
+        'video-seconds',
     ]);
     for (const key of [...flags.values.keys(), ...flags.booleans]) {
         if (!allowedKeys.has(key)) {
@@ -262,11 +273,26 @@ async function runVideoAnalysisVerb(args) {
         throw new Error(`media ${verb} ${modelKey} --request must be a JSON object of Gemini request payload.`);
     }
     const payload = raw;
+    // Optional runner-supplied hint: the source video duration. When provided it is
+    // forwarded as estimatedUsage.videoSeconds so the Web boundary's video-analysis
+    // routing/preflight can consider eligible short videos; omitting it leaves the
+    // request on the default route. The CLI does not probe the media itself (no
+    // ffprobe in the open-source runner) — it only passes a value the caller knows.
+    const videoSecondsFlag = flags.values.get('video-seconds') ?? null;
+    let estimatedUsage;
+    if (videoSecondsFlag !== null) {
+        const parsed = Number(videoSecondsFlag);
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            throw new Error(`media ${verb} --video-seconds must be a positive number of seconds.`);
+        }
+        estimatedUsage = { videoSeconds: parsed };
+    }
     const body = {
         capability: 'video-analysis',
         operation: 'analyze',
         modelKey,
         payload,
+        ...(estimatedUsage ? { estimatedUsage } : {}),
         operationId: flags.values.get('hosted-operation-id') ??
             `postplus-cli:media:video-analysis:analyze:${randomUUID()}`,
         quoteConfirmationToken: flags.values.get('quote-confirmation-token') ?? undefined,
@@ -456,6 +482,36 @@ function submitMediaGenerationRequest(params) {
         outputPath: params.outputPath,
     });
 }
+// Poll a pending media-generation run: `postplus media poll --handle <run-id>`.
+// A media `create`/`transcribe`/`analyze` submit returns an async run handle
+// (`output.data.id`, also surfaced as `output.data.urls.get`) while the provider
+// job is still processing. This resumes that run by handle against the
+// media-generation `operation: 'status'` boundary. It is read-only and
+// billing-idempotent: the Web boundary finds the run by handle and settlement
+// reuses the submit's operationId, so polling never re-reserves or re-charges.
+// The body carries only the status quadruple; submit-only fields (input,
+// requestDimensions, quoteConfirmationToken) are never sent. Mirrors the
+// `research collect --run-handle` polling branch.
+async function runMediaPoll(args) {
+    const flags = parseFlags(args, new Set(['json']));
+    const handle = requireFlag(flags, 'handle');
+    const outputPath = flags.values.get('output') ?? null;
+    return runHostedCommand({
+        request: () => postHostedJson({
+            body: {
+                capability: 'media-generation',
+                handle,
+                operation: 'status',
+                operationId: `postplus-cli:media:media-generation:status:${randomUUID()}`,
+            },
+            pathName: '/api/postplus-cli/hosted/capability',
+            skillName: null,
+        }),
+        errorInputLabel: 'media-poll-handle',
+        json: flags.booleans.has('json'),
+        outputPath,
+    });
+}
 function buildMediaVerbInput(input) {
     const record = {};
     for (const field of input.fields) {
@@ -970,7 +1026,8 @@ function printDomainVerbHelp(domain) {
     const verbUsage = domain === 'media'
         ? [...MEDIA_VERB_ENDPOINTS.keys()]
             .map((verb) => `  postplus media ${verb} <endpoint-key> --<intent/default flags> [--json] [--output <result.json>]\n`)
-            .join('')
+            .join('') +
+            '  postplus media poll --handle <run-id> [--json] [--output <result.json>]\n'
         : '  postplus publish <operation> --request <input.json> [--json] [--output <result.json>]\n';
     process.stdout.write(`PostPlus CLI - ${domain} commands
 
@@ -990,10 +1047,13 @@ function printMediaEndpointHelp(domain, verb, targetKey, resolved) {
 
   Surface: request-json (opaque Gemini request payload)
   Usage:
-    postplus ${domain} ${verb} ${targetKey} --request <input.json> [--json] [--output <result.json>]
+    postplus ${domain} ${verb} ${targetKey} --request <input.json> [--video-seconds <n>] [--json] [--output <result.json>]
 
   --request <file>  A JSON object authored verbatim as the Gemini request
                     (contents + optional generationConfig) under "payload".
+  --video-seconds <n>  Optional source video duration in seconds. Supplying it
+                    lets the hosted boundary route eligible short videos through
+                    its preflight path; omit it to use the default route.
   Runner-managed (minted by the CLI; never in the body): operationId, quoteConfirmationToken
 `);
         return;

package/build/index.js

@@ -48,6 +48,7 @@ Usage:
   postplus research scrape <source-key> --request <input-array.json> [--skill <skill-id>] [--output <result.json>]
   postplus media schema [--endpoint <endpoint-key>] [--json]
   postplus media <verb> <endpoint-key> --request <input.json> | --<flags> [--output <result.json>]
+  postplus media poll --handle <run-id> [--json] [--output <result.json>]
   postplus media-file upload --input-file <path> [--mime <type>] [--skill <skill-id>] [--output <result.json>]
   postplus publish schema [--json]
   postplus publish <operation> --request <input.json> [--output <result.json>]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",