@postplus/cli 0.1.45 → 0.1.46

package/build/client-compatibility.js

@@ -2,6 +2,10 @@ import { readFile } from 'node:fs/promises';
 import { readLocalConfig, updateLocalConfig } from './local-state.js';
 export const POSTPLUS_CLIENT_CONTRACT_VERSION = 2;
 export const POSTPLUS_CLIENT_RUNTIME = 'postplus-cli';
+// Single source for the CLI self-update command. Lives here (the upgrade-error
+// formatter's home) so update-check.ts can import it without a cycle —
+// update-check already depends on this module for readCurrentCliVersion.
+export const POSTPLUS_CLI_UPDATE_COMMAND = 'npm install -g @postplus/cli@latest';
 export const POSTPLUS_CLIENT_COMPATIBILITY_HEADERS = {
     cliVersion: 'x-postplus-cli-version',
     contractVersion: 'x-postplus-client-contract-version',
@@ -50,8 +54,7 @@ export function formatPostPlusClientUpgradeError(payload) {
     const record = payload && typeof payload === 'object' && !Array.isArray(payload)
         ? payload
         : {};
-    const cliCommand = record.compatibility?.upgrade?.cli?.command ??
-        'npm install -g @postplus/cli@latest';
+    const cliCommand = record.compatibility?.upgrade?.cli?.command ?? POSTPLUS_CLI_UPDATE_COMMAND;
     const skillsCommand = record.compatibility?.upgrade?.skills?.command ?? 'postplus update';
     const restart = record.compatibility?.upgrade?.restartAgentSession
         ? ' Then restart your agent session.'

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

@@ -169,7 +169,8 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                 "image-seedream-v5-lite-text",
                 "image-seedream-v5-lite-sequential",
                 "image-seedream-v5-lite-edit",
-                "image-seedream-v5-lite-edit-sequential"
+                "image-seedream-v5-lite-edit-sequential",
+                "image-higgsfield-soul-text"
             ],
             "endpoints": [
                 {
@@ -1123,6 +1124,85 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                     "billingDimensions": [
                         "billableUnitCount"
                     ]
+                },
+                {
+                    "endpointKey": "image-higgsfield-soul-text",
+                    "provider": "higgsfield",
+                    "providerModelPath": "higgsfield-ai/soul/standard",
+                    "fields": [
+                        {
+                            "name": "prompt",
+                            "class": "intent",
+                            "flag": "--prompt",
+                            "type": "string",
+                            "required": true
+                        },
+                        {
+                            "name": "width_and_height",
+                            "class": "intent",
+                            "flag": "--width-and-height",
+                            "type": "string",
+                            "required": true
+                        },
+                        {
+                            "name": "quality",
+                            "class": "default",
+                            "flag": "--quality",
+                            "type": "string",
+                            "enumValues": [
+                                "720p",
+                                "1080p"
+                            ],
+                            "canonicalize": "lowercase",
+                            "default": "720p",
+                            "required": false
+                        },
+                        {
+                            "name": "style_id",
+                            "class": "intent",
+                            "flag": "--style-id",
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "style_strength",
+                            "class": "intent",
+                            "flag": "--style-strength",
+                            "type": "number",
+                            "required": false
+                        },
+                        {
+                            "name": "seed",
+                            "class": "intent",
+                            "flag": "--seed",
+                            "type": "number",
+                            "required": false
+                        },
+                        {
+                            "name": "enhance_prompt",
+                            "class": "intent",
+                            "flag": "--enhance-prompt",
+                            "type": "boolean",
+                            "required": false
+                        },
+                        {
+                            "name": "operationId",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "quoteConfirmationToken",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        }
+                    ],
+                    "billingDimensions": [
+                        "quality"
+                    ]
                 }
             ]
         }
@@ -1323,6 +1403,30 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                             "repeatable": true,
                             "required": false
                         },
+                        {
+                            "name": "reference_audios",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "media-url",
+                            "repeatable": true,
+                            "required": false
+                        },
+                        {
+                            "name": "enable_web_search",
+                            "class": "default",
+                            "flag": null,
+                            "type": "boolean",
+                            "default": false,
+                            "required": false
+                        },
+                        {
+                            "name": "generate_audio",
+                            "class": "default",
+                            "flag": null,
+                            "type": "boolean",
+                            "default": true,
+                            "required": false
+                        },
                         {
                             "name": "operationId",
                             "class": "runner-managed",

package/build/generated/hosted-field-validation-core.generated.js

@@ -0,0 +1,84 @@
+// GENERATED from apps/web/lib/server/postplus-cli/hosted-field-validation-core.ts.
+// Do not edit by hand. Run `pnpm hosted-execution-manifest:sync` to regenerate.
+// Verbatim projection so the canonicalize + enum/range field-validation algorithm stays
+// byte-identical to the Web boundary (the CLI submodule cannot import apps/web TS).
+// k-tier normalization for image resolution ("4K" -> "4k").
+export function canonicalizeImageResolution(value) {
+    const trimmed = value.trim();
+    const tier = trimmed.match(/^(\d+(?:\.\d+)?)\s*k$/iu);
+    return tier ? `${tier[1]}k` : trimmed;
+}
+export function canonicalizeLowercaseToken(value) {
+    return value.trim().toLowerCase();
+}
+// Which canonicalization a field uses is decided by the schema `canonicalize` hint —
+// the single source both surfaces read — never re-guessed from the field name.
+export function canonicalizeModelledFieldValue(field, value) {
+    switch (field.canonicalize) {
+        case 'image-resolution-tier':
+            return canonicalizeImageResolution(value);
+        case 'lowercase':
+            return canonicalizeLowercaseToken(value);
+        default:
+            return value;
+    }
+}
+function formatReceivedValue(raw) {
+    return typeof raw === 'string' ? `"${raw}"` : String(raw);
+}
+function assertModelledNumberFieldValue(endpointKey, field, raw, createError) {
+    const enumValues = field.enumValues && field.enumValues.length > 0 ? field.enumValues : null;
+    const constraint = enumValues
+        ? `must be one of ${enumValues.join(', ')}`
+        : `must be an integer from ${field.min} to ${field.max}`;
+    if (typeof raw !== 'number' || !Number.isFinite(raw)) {
+        throw createError(`${endpointKey} ${field.name} ${constraint}; received ${formatReceivedValue(raw)}.`);
+    }
+    if (enumValues) {
+        if (!enumValues.includes(String(raw))) {
+            throw createError(`${endpointKey} ${field.name} ${constraint}; received ${raw}.`);
+        }
+        return;
+    }
+    if (field.min === undefined || field.max === undefined) {
+        return;
+    }
+    if (!(Number.isInteger(raw) && raw >= field.min && raw <= field.max)) {
+        throw createError(`${endpointKey} ${field.name} ${constraint}; received ${raw}.`);
+    }
+}
+// Validates every advertised enum / numeric-range field present in the input against
+// the field contract. Skips runner-managed fields (no caller input), fields with
+// neither an enum nor a range, and fields the input omits. The string value is
+// canonicalized with the schema hint before the enum membership check, so a mixed-case
+// "720P"/"4K" still matches the lowercase registry enum while "english" still fails the
+// Title-cased language enum. The error factory is injected: the Web boundary passes its
+// typed invalid_request error, the CLI early validator passes a plain Error.
+export function assertModelledFieldValuesInRange(endpointKey, fields, input, createError) {
+    for (const field of fields) {
+        if (field.class === 'runner-managed') {
+            continue;
+        }
+        const enumValues = field.enumValues && field.enumValues.length > 0 ? field.enumValues : null;
+        const hasRange = field.min !== undefined && field.max !== undefined;
+        if (!enumValues && !hasRange) {
+            continue;
+        }
+        if (!Object.hasOwn(input, field.name)) {
+            continue;
+        }
+        if (field.type === 'number') {
+            assertModelledNumberFieldValue(endpointKey, field, input[field.name], createError);
+            continue;
+        }
+        const raw = input[field.name];
+        if (typeof raw !== 'string' || !raw.trim()) {
+            continue;
+        }
+        const value = raw.trim();
+        if (enumValues &&
+            !enumValues.includes(canonicalizeModelledFieldValue(field, value))) {
+            throw createError(`${endpointKey} ${field.name} must be one of ${enumValues.join(', ')}; received "${value}".`);
+        }
+    }
+}

package/build/hosted-domain-commands.js

@@ -7,7 +7,7 @@ import { sendAuthedCloudRequest } from './authed-cloud-request.js';
 import { formatPostPlusCompatibilityError } from './client-compatibility.js';
 import { assertModelledFieldValuesInRange } from './hosted-field-validation.js';
 import { buildVerbTargetIndex, } from './hosted-manifest-index.js';
-import { buildHostedRequestSchemaReport, buildMediaGenerationRequestDimensions, } from './hosted-request-schemas.js';
+import { buildHostedRequestSchemaReport } from './hosted-request-schemas.js';
 import { readLargeCreditQuoteConfirmationChallenge, } from './quote-confirmation.js';
 // Manifest-driven verb grammar indexes (SSOT projected from apps/web +
 // public-skill-metadata via the generated manifest). The verb/flag grammar,
@@ -492,6 +492,9 @@ Usage:
 // Shared submit path for both surfaces: wrap the media input, derive billing
 // dimensions from endpointKey + input, and POST to the Web boundary.
 function submitMediaGenerationRequest(params) {
+    // Billing dimensions are derived solely at the Web boundary from
+    // (endpointKey, input); the CLI sends only the payload. The Web request schema
+    // rejects any caller-supplied `requestDimensions` (single source of truth).
     const body = {
         capability: params.capability,
         endpointKey: params.endpointKey,
@@ -499,7 +502,6 @@ function submitMediaGenerationRequest(params) {
         operation: 'request',
         operationId: params.operationId,
         quoteConfirmationToken: params.quoteConfirmationToken ?? undefined,
-        requestDimensions: buildMediaGenerationRequestDimensions(params.endpointKey, params.input),
     };
     return runHostedCommand({
         request: () => postHostedJson({

package/build/hosted-field-validation.js

@@ -1,93 +1,13 @@
-// Schema-driven early field validation (issue #475). Mirrors the Web boundary's
-// assertModelledFieldValuesInRange: every enum / numeric-range field an endpoint
-// advertises in the generated execution manifest — the same EnvelopeFieldSpec the
-// Web validator reads — is checked here BEFORE the request is posted, so the agent
-// gets an immediate field-level error (e.g. seedance resolution "999p") instead of
-// waiting for the round-trip. The Web boundary stays the AUTHORITATIVE gate; this is
-// only pre-submit feedback.
-//
-// Casing-faithfulness is the reason this cannot be a CLI-side island: the per-field
-// canonicalization rule is read from the manifest `canonicalize` hint, the SAME
-// single source the Web validator reads, so "720P" / "4K" pass and "english" /
-// "999p" fail exactly as they do on the boundary. The two canonicalize functions
-// below are stable 3-line algorithms; WHICH field uses WHICH is decided by the
-// schema hint, never re-guessed here.
-// k-tier normalization for image resolution ("4K" -> "4k"). Mirrors the Web
-// canonicalizeImageResolution exactly.
-function canonicalizeImageResolution(value) {
-    const trimmed = value.trim();
-    const tier = trimmed.match(/^(\d+(?:\.\d+)?)\s*k$/iu);
-    return tier ? `${tier[1]}k` : trimmed;
-}
-function canonicalizeLowercaseToken(value) {
-    return value.trim().toLowerCase();
-}
-function canonicalizeModelledFieldValue(field, value) {
-    switch (field.canonicalize) {
-        case 'image-resolution-tier':
-            return canonicalizeImageResolution(value);
-        case 'lowercase':
-            return canonicalizeLowercaseToken(value);
-        default:
-            return value;
-    }
-}
-function isIntegerInRange(min, max, value) {
-    return Number.isInteger(value) && value >= min && value <= max;
-}
-function formatReceivedValue(raw) {
-    return typeof raw === 'string' ? `"${raw}"` : String(raw);
-}
-function assertModelledNumberFieldValue(endpointKey, field, raw) {
-    const enumValues = field.enumValues && field.enumValues.length > 0 ? field.enumValues : null;
-    const constraint = enumValues
-        ? `must be one of ${enumValues.join(', ')}`
-        : `must be an integer from ${field.min} to ${field.max}`;
-    if (typeof raw !== 'number' || !Number.isFinite(raw)) {
-        throw new Error(`${endpointKey} ${field.name} ${constraint}; received ${formatReceivedValue(raw)}.`);
-    }
-    if (enumValues) {
-        if (!enumValues.includes(String(raw))) {
-            throw new Error(`${endpointKey} ${field.name} ${constraint}; received ${raw}.`);
-        }
-        return;
-    }
-    if (field.min === undefined || field.max === undefined) {
-        return;
-    }
-    if (!isIntegerInRange(field.min, field.max, raw)) {
-        throw new Error(`${endpointKey} ${field.name} ${constraint}; received ${raw}.`);
-    }
-}
-// Validates every advertised enum / numeric-range field present in the input against
-// the manifest contract. Skips runner-managed fields (no caller input), fields with
-// neither an enum nor a range, and fields the input omits — exactly mirroring the Web
-// boundary so a value the CLI accepts the boundary also accepts, and vice versa.
+// Schema-driven early field validation (issue #475). The canonicalize + enum/range
+// algorithm is the SSOT `hosted-field-validation-core`, authored in apps/web and
+// projected VERBATIM into ./generated by the hosted-execution-manifest codegen — the CLI
+// submodule cannot import apps/web TS, and a hand-copy here would let the casing / range
+// rules drift from the Web boundary. This module only injects the CLI's plain-Error
+// factory and keeps the established (endpointKey, fields, input) signature its callers
+// use. The Web boundary stays the AUTHORITATIVE gate; this is pre-submit feedback so the
+// agent gets an immediate field-level error (e.g. seedance resolution "999p") instead of
+// waiting for the round-trip.
+import { assertModelledFieldValuesInRange as assertModelledFieldValuesInRangeCore } from './generated/hosted-field-validation-core.generated.js';
 export function assertModelledFieldValuesInRange(endpointKey, fields, input) {
-    for (const field of fields) {
-        if (field.class === 'runner-managed') {
-            continue;
-        }
-        const enumValues = field.enumValues && field.enumValues.length > 0 ? field.enumValues : null;
-        const hasRange = field.min !== undefined && field.max !== undefined;
-        if (!enumValues && !hasRange) {
-            continue;
-        }
-        if (!Object.hasOwn(input, field.name)) {
-            continue;
-        }
-        if (field.type === 'number') {
-            assertModelledNumberFieldValue(endpointKey, field, input[field.name]);
-            continue;
-        }
-        const raw = input[field.name];
-        if (typeof raw !== 'string' || !raw.trim()) {
-            continue;
-        }
-        const value = raw.trim();
-        if (enumValues &&
-            !enumValues.includes(canonicalizeModelledFieldValue(field, value))) {
-            throw new Error(`${endpointKey} ${field.name} must be one of ${enumValues.join(', ')}; received "${value}".`);
-        }
-    }
+    assertModelledFieldValuesInRangeCore(endpointKey, fields, input, (message) => new Error(message));
 }

package/build/hosted-request-schemas.js

@@ -1,4 +1,3 @@
-import { Buffer } from 'node:buffer';
 import { findMediaEndpoint, manifestTargetKeys, } from './hosted-manifest-index.js';
 const JSON_OBJECT_SCHEMA = {
     additionalProperties: true,
@@ -211,113 +210,6 @@ function requireMediaEndpoint(endpointKey) {
     }
     return endpoint;
 }
-const MANIFEST_FIELD_DEFAULTS = buildManifestFieldDefaults();
-const MANIFEST_DERIVED_DIMENSIONS = buildManifestDerivedDimensions();
-function buildManifestFieldDefaults() {
-    const index = new Map();
-    for (const key of manifestTargetKeys('media', 'media-generation')) {
-        const endpoint = findMediaEndpoint(key);
-        if (!endpoint) {
-            continue;
-        }
-        const byField = new Map();
-        for (const field of endpoint.fields) {
-            if (field.default !== undefined) {
-                byField.set(field.name, field.default);
-            }
-        }
-        index.set(key, byField);
-    }
-    return index;
-}
-function manifestFieldDefault(endpointKey, fieldName) {
-    return MANIFEST_FIELD_DEFAULTS.get(endpointKey)?.get(fieldName);
-}
-function buildManifestDerivedDimensions() {
-    const index = new Map();
-    for (const key of manifestTargetKeys('media', 'media-generation')) {
-        const endpoint = findMediaEndpoint(key);
-        if (!endpoint) {
-            continue;
-        }
-        const derived = endpoint.fields.flatMap((field) => field.class === 'runner-managed' && field.derivedFrom
-            ? [{ fieldName: field.name, sourceName: field.derivedFrom }]
-            : []);
-        if (derived.length > 0) {
-            index.set(key, derived);
-        }
-    }
-    return index;
-}
-export function buildMediaGenerationRequestDimensions(endpointKey, input) {
-    const dimensions = {
-        billableUnitCount: 1,
-        operationKey: endpointKey,
-    };
-    for (const derived of MANIFEST_DERIVED_DIMENSIONS.get(endpointKey) ?? []) {
-        const value = input[derived.sourceName] ??
-            manifestFieldDefault(endpointKey, derived.sourceName);
-        if (value !== undefined) {
-            dimensions[derived.fieldName] = value;
-        }
-    }
-    if (endpointKey.startsWith('image-')) {
-        const resolution = typeof input.resolution === 'string' && input.resolution.trim()
-            ? input.resolution.trim()
-            : manifestFieldDefault(endpointKey, 'resolution');
-        const quality = typeof input.quality === 'string' && input.quality.trim()
-            ? input.quality.trim()
-            : manifestFieldDefault(endpointKey, 'quality');
-        if (typeof resolution === 'string') {
-            dimensions.imageSize = resolution;
-        }
-        if (typeof quality === 'string') {
-            dimensions.quality = quality;
-        }
-    }
-    if (endpointKey.startsWith('video-')) {
-        const manifestResolution = manifestFieldDefault(endpointKey, 'resolution');
-        const duration = readPositiveNumber(input.duration) ??
-            readPositiveNumber(manifestFieldDefault(endpointKey, 'duration')) ??
-            5;
-        const resolution = typeof input.resolution === 'string' && input.resolution.trim()
-            ? input.resolution.trim()
-            : typeof manifestResolution === 'string'
-                ? manifestResolution
-                : '720p';
-        dimensions.audioMode =
-            endpointKey.startsWith('video-kling-v3-0-') && input.sound !== true
-                ? 'off'
-                : 'on';
-        dimensions.duration = Math.ceil(duration);
-        dimensions.requestBytes = Buffer.byteLength(JSON.stringify(input));
-        dimensions.resolution = resolution;
-        if (endpointKey.startsWith('video-seedance-2-')) {
-            const referenceVideoCount = Array.isArray(input.reference_videos)
-                ? input.reference_videos.length
-                : 0;
-            dimensions.referenceVideoCount = referenceVideoCount;
-            dimensions.referenceVideoMode =
-                referenceVideoCount > 0
-                    ? 'with_reference_videos'
-                    : 'without_reference_videos';
-        }
-        if (endpointKey === 'video-kling-v2-6-pro-motion-control') {
-            dimensions.characterOrientation =
-                typeof input.character_orientation === 'string'
-                    ? input.character_orientation
-                    : 'image';
-            dimensions.motionControlMode = 'reference_motion_transfer';
-        }
-    }
-    return dimensions;
-}
-function readPositiveNumber(value) {
-    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
-        return null;
-    }
-    return value;
-}
 function buildPublishSchemaReport() {
     const operations = manifestTargetKeys('publish', 'social-publishing');
     return {

package/build/update-check.js

@@ -1,6 +1,6 @@
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
-import { readCurrentCliVersion } from './client-compatibility.js';
+import { POSTPLUS_CLI_UPDATE_COMMAND, readCurrentCliVersion, } from './client-compatibility.js';
 import { runInteractiveCommand as runDefaultInteractiveCommand, } from './command-runner.js';
 import { getPostPlusConfigDir, readManagedSkillBaseline, } from './local-state.js';
 import { POSTPLUS_SKILLS_REPO, loadPublicSkillCatalog, } from './skill-catalog.js';
@@ -8,7 +8,6 @@ const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_CHECK_CACHE_FILE = 'update-check.json';
 const NPM_PACKAGE_NAME = '@postplus/cli';
 const NPM_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(NPM_PACKAGE_NAME)}/latest`;
-export const POSTPLUS_CLI_UPDATE_COMMAND = 'npm install -g @postplus/cli@latest';
 const POSTPLUS_CLI_UPDATE_ARGS = ['install', '-g', '@postplus/cli@latest'];
 export async function generateUpdateStatusReport(input = {}, dependencies = {
     fetchFn: fetch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",
@@ -18,6 +18,7 @@
     "build/doctor.js",
     "build/hosted-domain-commands.js",
     "build/generated/hosted-execution-manifest.generated.js",
+    "build/generated/hosted-field-validation-core.generated.js",
     "build/hosted-field-validation.js",
     "build/hosted-manifest-index.js",
     "build/hosted-release.js",