@postplus/cli 0.1.40 → 0.1.41

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);
     }
@@ -456,6 +463,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 +1007,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
 

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.41",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",