@postplus/cli 0.1.45 → 0.1.47

package/build/authed-cloud-request.d.ts

@@ -0,0 +1,39 @@
+export type AuthedCloudRequestAuth = {
+    apiBaseUrl: string;
+    cliSessionToken: string;
+};
+export type AuthedCloudRequestInput = {
+    auth: AuthedCloudRequestAuth;
+    pathName: string;
+    method?: 'GET' | 'POST';
+    /**
+     * Parsed JSON body. When provided the request sends `content-type:
+     * application/json` and the serialized body; when omitted neither is sent.
+     */
+    body?: unknown;
+    skillName?: string | null;
+    /**
+     * In-process override for the skills release id header. When provided (the
+     * hosted-lib path) it is stamped verbatim and the disk config is NOT read for
+     * the release id; when omitted (the bin path) the release id comes from
+     * `readLocalConfig()` as before.
+     */
+    skillsReleaseId?: string | null;
+    timeoutMs?: number;
+    /**
+     * Optional once-only 401 refresh. When provided, a `401` response triggers a
+     * single retry: `refreshAuth()` returns fresh credentials and the request is
+     * re-issued once with them. When omitted, the first response is returned
+     * verbatim (the caller keeps its own `!ok` interpretation either way).
+     */
+    retryOn401?: () => Promise<AuthedCloudRequestAuth>;
+};
+/**
+ * Single transport envelope for every authenticated PostPlus Cloud request:
+ * canonical header set (`accept` + compatibility headers + `Bearer` token +
+ * optional `content-type`), `AbortSignal.timeout`, and an optional once-only
+ * 401-refresh-retry. It returns the raw `Response` so each caller keeps its own
+ * `!ok` interpretation — this is a narrow transport primitive, not a request
+ * framework.
+ */
+export declare function sendAuthedCloudRequest(input: AuthedCloudRequestInput): Promise<Response>;

package/build/authed-cloud-request.js

@@ -19,6 +19,9 @@ export async function sendAuthedCloudRequest(input) {
 async function issueAuthedCloudRequest(auth, input) {
     const compatibilityHeaders = await buildPostPlusClientCompatibilityHeaders({
         skillName: input.skillName ?? null,
+        ...(input.skillsReleaseId !== undefined
+            ? { skillsReleaseId: input.skillsReleaseId }
+            : {}),
     });
     const hasBody = input.body !== undefined;
     const headers = {

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',
@@ -10,16 +14,19 @@ export const POSTPLUS_CLIENT_COMPATIBILITY_HEADERS = {
     skillName: 'x-postplus-skill-name',
 };
 export async function buildPostPlusClientCompatibilityHeaders(input = {}) {
+    const hasReleaseIdOverride = input.skillsReleaseId !== undefined;
     const [cliVersion, config] = await Promise.all([
         readCurrentCliVersion(),
-        readLocalConfig(),
+        hasReleaseIdOverride ? Promise.resolve(null) : readLocalConfig(),
     ]);
     const headers = {
         [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.cliVersion]: cliVersion,
         [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.contractVersion]: String(POSTPLUS_CLIENT_CONTRACT_VERSION),
         [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.runtime]: POSTPLUS_CLIENT_RUNTIME,
     };
-    const skillsReleaseId = config?.managedSkills?.releaseId?.trim();
+    const skillsReleaseId = hasReleaseIdOverride
+        ? input.skillsReleaseId?.trim()
+        : config?.managedSkills?.releaseId?.trim();
     const skillName = input.skillName?.trim();
     if (skillsReleaseId) {
         headers[POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.skillsReleaseId] =
@@ -50,8 +57,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,82 @@ 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": "aspect_ratio",
+                            "class": "default",
+                            "flag": "--aspect-ratio",
+                            "type": "string",
+                            "enumValues": [
+                                "9:16",
+                                "16:9",
+                                "4:3",
+                                "3:4",
+                                "1:1",
+                                "2:3",
+                                "3:2"
+                            ],
+                            "default": "1:1",
+                            "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": [
+                        "billableUnitCount"
+                    ]
                 }
             ]
         }
@@ -1181,6 +1258,8 @@ export const HOSTED_EXECUTION_MANIFESTS = {
             "capability": "media-generation",
             "endpointKeys": [
                 "video-seedance-2-image",
+                "video-seedance-2-mini-image",
+                "video-seedance-2-mini-text",
                 "video-seedance-2-text"
             ],
             "endpoints": [
@@ -1256,6 +1335,200 @@ export const HOSTED_EXECUTION_MANIFESTS = {
                         "referenceVideoMode"
                     ]
                 },
+                {
+                    "endpointKey": "video-seedance-2-mini-image",
+                    "provider": "wavespeed",
+                    "providerModelPath": "bytedance/seedance-2.0-mini/image-to-video",
+                    "fields": [
+                        {
+                            "name": "prompt",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "string",
+                            "required": true
+                        },
+                        {
+                            "name": "image",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "media-url",
+                            "required": true
+                        },
+                        {
+                            "name": "resolution",
+                            "class": "default",
+                            "flag": null,
+                            "type": "string",
+                            "enumValues": [
+                                "480p",
+                                "720p",
+                                "1080p",
+                                "4k"
+                            ],
+                            "canonicalize": "lowercase",
+                            "default": "720p",
+                            "required": false
+                        },
+                        {
+                            "name": "duration",
+                            "class": "default",
+                            "flag": null,
+                            "type": "number",
+                            "default": 5,
+                            "required": false,
+                            "min": 4,
+                            "max": 15
+                        },
+                        {
+                            "name": "operationId",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "quoteConfirmationToken",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "requestDimensions",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        }
+                    ],
+                    "billingDimensions": [
+                        "duration",
+                        "resolution",
+                        "referenceVideoCount",
+                        "referenceVideoMode"
+                    ]
+                },
+                {
+                    "endpointKey": "video-seedance-2-mini-text",
+                    "provider": "wavespeed",
+                    "providerModelPath": "bytedance/seedance-2.0-mini/text-to-video",
+                    "fields": [
+                        {
+                            "name": "prompt",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "string",
+                            "required": true
+                        },
+                        {
+                            "name": "resolution",
+                            "class": "default",
+                            "flag": null,
+                            "type": "string",
+                            "enumValues": [
+                                "480p",
+                                "720p",
+                                "1080p",
+                                "4k"
+                            ],
+                            "canonicalize": "lowercase",
+                            "default": "720p",
+                            "required": false
+                        },
+                        {
+                            "name": "aspect_ratio",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "string",
+                            "enumValues": [
+                                "21:9",
+                                "16:9",
+                                "4:3",
+                                "1:1",
+                                "3:4",
+                                "9:16"
+                            ],
+                            "required": false
+                        },
+                        {
+                            "name": "duration",
+                            "class": "default",
+                            "flag": null,
+                            "type": "number",
+                            "default": 5,
+                            "required": false,
+                            "min": 4,
+                            "max": 15
+                        },
+                        {
+                            "name": "reference_images",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "media-url",
+                            "repeatable": true,
+                            "required": false
+                        },
+                        {
+                            "name": "reference_videos",
+                            "class": "intent",
+                            "flag": null,
+                            "type": "media-url",
+                            "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",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "quoteConfirmationToken",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        },
+                        {
+                            "name": "requestDimensions",
+                            "class": "runner-managed",
+                            "flag": null,
+                            "type": "string",
+                            "required": false
+                        }
+                    ],
+                    "billingDimensions": [
+                        "duration",
+                        "resolution",
+                        "referenceVideoCount",
+                        "referenceVideoMode"
+                    ]
+                },
                 {
                     "endpointKey": "video-seedance-2-text",
                     "provider": "wavespeed",
@@ -1323,6 +1596,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.d.ts

@@ -0,0 +1,14 @@
+import { type AuthedCloudRequestAuth } from './authed-cloud-request.js';
+import { type HostedDomain } from './hosted-manifest-index.js';
+export type HostedRequestContext = {
+    auth: AuthedCloudRequestAuth;
+    skillsReleaseId?: string;
+    /**
+     * The request-json envelope injected in place of a `--request <file>` read.
+     * Surfaces that need a body assert it is present and the right shape (object vs
+     * array) exactly as the file-read path validated the parsed file contents.
+     */
+    requestJson?: Record<string, unknown> | unknown[];
+};
+export declare function runHostedDomainCommand(domain: HostedDomain, args: string[], context?: HostedRequestContext): Promise<number | unknown>;
+export declare function runMediaFileCommand(args: string[], context?: HostedRequestContext): Promise<number | unknown>;