@amaster.ai/pi-video-gen 0.1.2-beta.48

package/dist/config.js

@@ -0,0 +1,305 @@
+import { resolve } from 'node:path';
+import { loadPiSettings } from '@amaster.ai/pi-shared/settings';
+import { providerLabel, VideoGenError } from './errors.js';
+import { ARK_DEFAULT_BASE_URL } from './providers/ark.js';
+import { DASHSCOPE_DEFAULT_BASE_URL } from './providers/dashscope.js';
+import { KLING_DEFAULT_BASE_URL } from './providers/kling.js';
+import { BUILT_IN_VIDEO_MODELS, findBuiltInModel } from './providers/models.js';
+import { OPENROUTER_DEFAULT_BASE_URL } from './providers/openrouter.js';
+const SETTINGS_KEY = 'pi-video-gen';
+/**
+ * Keys a project-level settings file may set. Everything else — notably
+ * `providers.*.baseUrl/apiKey` and `ffmpegPath` — is accepted ONLY from the
+ * global and agent-dir layers, even when the project is trusted: a malicious
+ * repo must not be able to redirect paid API traffic (and the key that comes
+ * with it) to an attacker endpoint, or swap the ffmpeg binary.
+ */
+const PROJECT_ALLOWED_KEYS = new Set(['outputDir', 'defaultModel', 'rateLimit', 'concurrency']);
+// Single source of truth: each adapter owns its default endpoint. `newapi`
+// is absent ON PURPOSE — it is a self-hosted relay with no public default, so
+// a missing baseUrl is a configuration error (see requireBaseUrl).
+const PROVIDER_DEFAULT_BASE_URLS = {
+    ark: ARK_DEFAULT_BASE_URL,
+    kling: KLING_DEFAULT_BASE_URL,
+    dashscope: DASHSCOPE_DEFAULT_BASE_URL,
+    openrouter: OPENROUTER_DEFAULT_BASE_URL,
+};
+/** Resolve the effective base URL, failing clearly when the style mandates one. */
+function requireBaseUrl(style, configured, settingsPath) {
+    const baseUrl = configured ?? PROVIDER_DEFAULT_BASE_URLS[style];
+    if (!baseUrl) {
+        throw new VideoGenError(`${providerLabel(style)} is a self-hosted relay with no default endpoint. Set "${settingsPath}" to your server address (e.g. "https://newapi.example.com") in global or agent-dir Pi settings, then retry.`, `config: ${style} requires baseUrl`);
+    }
+    return baseUrl;
+}
+function settingsSection(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new VideoGenError(`${path} must be an object in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+    return value;
+}
+function positiveInteger(value, path) {
+    if (value !== undefined &&
+        (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0)) {
+        throw new VideoGenError(`${path} must be a positive integer in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+}
+function nonNegativeInteger(value, path) {
+    if (value !== undefined &&
+        (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)) {
+        throw new VideoGenError(`${path} must be a non-negative integer in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+}
+function optionalString(value, path) {
+    if (value !== undefined && (typeof value !== 'string' || value.trim() === '')) {
+        throw new VideoGenError(`${path} must be a non-empty string in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+}
+function stringArray(value, path) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((item) => typeof item !== 'string' || item.trim() === '')) {
+        throw new VideoGenError(`${path} must be a non-empty array of strings in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+}
+function optionalHttpUrl(value, path) {
+    optionalString(value, path);
+    if (value === undefined)
+        return;
+    try {
+        const url = new URL(value);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            throw new Error();
+    }
+    catch {
+        throw new VideoGenError(`${path} must be an http(s) URL in pi-video-gen settings.`, `config: invalid ${path}`);
+    }
+}
+function validateCapabilities(value, path) {
+    if (value === undefined)
+        return;
+    const caps = settingsSection(value, path);
+    nonNegativeInteger(caps.maxReferenceImages, `${path}.maxReferenceImages`);
+    if (caps.durations !== undefined) {
+        if (!Array.isArray(caps.durations) ||
+            caps.durations.length !== 2 ||
+            caps.durations.some((item) => typeof item !== 'number' || !Number.isSafeInteger(item)) ||
+            caps.durations[0] <= 0 ||
+            caps.durations[1] < caps.durations[0]) {
+            throw new VideoGenError(`${path}.durations must be an increasing [min, max] pair of positive integers.`, `config: invalid ${path}.durations`);
+        }
+    }
+    if (caps.resolutions !== undefined)
+        stringArray(caps.resolutions, `${path}.resolutions`);
+    if (caps.aspectRatios !== undefined)
+        stringArray(caps.aspectRatios, `${path}.aspectRatios`);
+    for (const key of ['nativeAudio', 'supportsFirstLastFrame']) {
+        if (caps[key] !== undefined && typeof caps[key] !== 'boolean') {
+            throw new VideoGenError(`${path}.${key} must be a boolean in pi-video-gen settings.`, `config: invalid ${path}.${key}`);
+        }
+    }
+}
+const WIRE_FORMATS = ['ark', 'kling', 'dashscope', 'openrouter', 'newapi'];
+function validateCustomProviders(value) {
+    if (value === undefined)
+        return;
+    const cps = settingsSection(value, 'customProviders');
+    for (const [name, cp] of Object.entries(cps)) {
+        const section = settingsSection(cp, `customProviders.${name}`);
+        const api = section.api;
+        if (typeof api !== 'string' || !WIRE_FORMATS.includes(api)) {
+            throw new VideoGenError(`customProviders.${name}.api must be one of ${WIRE_FORMATS.join(', ')} in pi-video-gen settings.`, `config: invalid customProviders.${name}.api`);
+        }
+        if (section.models !== undefined && !Array.isArray(section.models)) {
+            throw new VideoGenError(`customProviders.${name}.models must be an array in pi-video-gen settings.`, `config: invalid customProviders.${name}.models`);
+        }
+        optionalHttpUrl(section.baseUrl, `customProviders.${name}.baseUrl`);
+        optionalString(section.apiKey, `customProviders.${name}.apiKey`);
+        optionalString(section.name, `customProviders.${name}.name`);
+        for (const [index, rawModel] of section.models?.entries() ?? []) {
+            const path = `customProviders.${name}.models[${index}]`;
+            if (typeof rawModel === 'string') {
+                optionalString(rawModel, path);
+                continue;
+            }
+            const model = settingsSection(rawModel, path);
+            optionalString(model.id, `${path}.id`);
+            if (typeof model.id !== 'string') {
+                throw new VideoGenError(`${path}.id must be a non-empty string.`, `config: invalid ${path}.id`);
+            }
+            optionalString(model.alias, `${path}.alias`);
+            optionalString(model.name, `${path}.name`);
+            optionalString(model.defaultResolution, `${path}.defaultResolution`);
+            optionalString(model.defaultAspectRatio, `${path}.defaultAspectRatio`);
+            positiveInteger(model.defaultDurationSec, `${path}.defaultDurationSec`);
+            validateCapabilities(model.capabilities, `${path}.capabilities`);
+            const caps = model.capabilities;
+            if (model.defaultResolution !== undefined &&
+                Array.isArray(caps?.resolutions) &&
+                !caps.resolutions.includes(model.defaultResolution)) {
+                throw new VideoGenError(`${path}.defaultResolution must appear in capabilities.resolutions.`, `config: invalid ${path}.defaultResolution`);
+            }
+            if (model.defaultAspectRatio !== undefined &&
+                Array.isArray(caps?.aspectRatios) &&
+                !caps.aspectRatios.includes(model.defaultAspectRatio)) {
+                throw new VideoGenError(`${path}.defaultAspectRatio must appear in capabilities.aspectRatios.`, `config: invalid ${path}.defaultAspectRatio`);
+            }
+            if (typeof model.defaultDurationSec === 'number' &&
+                Array.isArray(caps?.durations) &&
+                (model.defaultDurationSec < caps.durations[0] ||
+                    model.defaultDurationSec > caps.durations[1])) {
+                throw new VideoGenError(`${path}.defaultDurationSec must be within capabilities.durations.`, `config: invalid ${path}.defaultDurationSec`);
+            }
+        }
+    }
+}
+function validateRuntimeSettings(settings) {
+    settingsSection(settings, 'pi-video-gen');
+    optionalString(settings.defaultModel, 'defaultModel');
+    optionalString(settings.outputDir, 'outputDir');
+    optionalString(settings.ffmpegPath, 'ffmpegPath');
+    const providers = settingsSection(settings.providers, 'providers');
+    for (const style of WIRE_FORMATS) {
+        const provider = settingsSection(providers?.[style], `providers.${style}`);
+        optionalString(provider?.apiKey, `providers.${style}.apiKey`);
+        optionalHttpUrl(provider?.baseUrl, `providers.${style}.baseUrl`);
+    }
+    const rateLimit = settingsSection(settings.rateLimit, 'rateLimit');
+    const concurrency = settingsSection(settings.concurrency, 'concurrency');
+    positiveInteger(rateLimit?.maxRequestsPerMinute, 'rateLimit.maxRequestsPerMinute');
+    positiveInteger(rateLimit?.maxRequestsPerDay, 'rateLimit.maxRequestsPerDay');
+    positiveInteger(concurrency?.clips, 'concurrency.clips');
+    validateCustomProviders(settings.customProviders);
+    return settings;
+}
+/**
+ * Load `pi-video-gen` settings with the trust boundary applied:
+ * - untrusted project ⇒ the project layer is ignored entirely;
+ * - trusted project ⇒ only PROJECT_ALLOWED_KEYS are honored from the project
+ *   layer; sensitive keys there are stripped (and reported once to stderr).
+ */
+export function loadVideoGenSettings(cwd, projectTrusted) {
+    const base = loadPiSettings(SETTINGS_KEY, {
+        cwd,
+        projectTrusted: false,
+    });
+    if (!projectTrusted)
+        return validateRuntimeSettings(base);
+    const merged = loadPiSettings(SETTINGS_KEY, {
+        cwd,
+        projectTrusted: true,
+        strictProjectSettings: true,
+    });
+    const allowed = {};
+    for (const key of PROJECT_ALLOWED_KEYS) {
+        if (merged[key] !== base[key]) {
+            allowed[key] = merged[key];
+        }
+    }
+    return validateRuntimeSettings({ ...base, ...allowed });
+}
+/** Resolve the provider section for a wire format against built-in defaults. */
+export function resolveProvider(settings, style) {
+    const section = settings.providers?.[style] ?? {};
+    return {
+        style,
+        apiKey: section.apiKey,
+        apiKeyPath: `pi-video-gen.providers.${style}.apiKey`,
+        baseUrl: requireBaseUrl(style, section.baseUrl, `pi-video-gen.providers.${style}.baseUrl`),
+    };
+}
+/**
+ * Conservative capabilities for custom models declared as a bare string (or
+ * with a partial capabilities object): text-to-video + first frame only, no
+ * audio, no last-frame interpolation, 720p/16:9. Declare full capabilities in
+ * the custom model object to lift these.
+ */
+const CONSERVATIVE_CUSTOM_CAPABILITIES = {
+    maxReferenceImages: 1,
+    durations: [4, 15],
+    resolutions: ['720p'],
+    aspectRatios: ['16:9'],
+    nativeAudio: false,
+    supportsFirstLastFrame: false,
+};
+function resolveCustomModel(settings, wanted) {
+    const needle = wanted.trim().toLowerCase();
+    for (const [providerName, cp] of Object.entries(settings.customProviders ?? {})) {
+        for (const m of cp.models ?? []) {
+            const model = typeof m === 'string' ? { id: m } : m;
+            const matches = model.id.toLowerCase() === needle ||
+                (model.alias != null && model.alias.toLowerCase() === needle);
+            if (!matches)
+                continue;
+            const capabilities = { ...CONSERVATIVE_CUSTOM_CAPABILITIES, ...(model.capabilities ?? {}) };
+            return {
+                entry: {
+                    id: model.id,
+                    aliases: model.alias ? [model.alias] : [],
+                    provider: cp.api,
+                    capabilities,
+                    defaultResolution: model.defaultResolution ?? capabilities.resolutions[0],
+                    defaultAspectRatio: model.defaultAspectRatio ?? capabilities.aspectRatios[0],
+                    defaultDurationSec: model.defaultDurationSec ?? capabilities.durations[0],
+                },
+                remoteId: model.id,
+                provider: {
+                    style: cp.api,
+                    apiKey: cp.apiKey,
+                    apiKeyPath: `pi-video-gen.customProviders.${providerName}.apiKey`,
+                    baseUrl: requireBaseUrl(cp.api, cp.baseUrl, `pi-video-gen.customProviders.${providerName}.baseUrl`),
+                },
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a model id/alias (defaulting to settings.defaultModel, then
+ * 'seedance'). Built-in registry wins over custom provider models on conflict.
+ */
+export function resolveModel(settings, modelId) {
+    const wanted = modelId ?? settings.defaultModel ?? 'seedance';
+    const entry = findBuiltInModel(wanted);
+    if (entry) {
+        return {
+            entry,
+            remoteId: entry.remoteId ?? entry.id,
+            provider: resolveProvider(settings, entry.provider),
+        };
+    }
+    return resolveCustomModel(settings, wanted);
+}
+/** Registry view for the video_capabilities tool / `/video-gen models`. */
+export function listModelRegistry(settings) {
+    const wanted = settings.defaultModel ?? 'seedance';
+    const active = resolveModel(settings, wanted);
+    return {
+        activeId: active?.entry.id ?? wanted,
+        activeResolved: active != null,
+        models: [
+            ...BUILT_IN_VIDEO_MODELS.map((m) => ({
+                id: m.id,
+                aliases: m.aliases,
+                provider: m.provider,
+                keyReady: resolveProvider(settings, m.provider).apiKey != null,
+            })),
+            ...Object.entries(settings.customProviders ?? {}).flatMap(([providerName, cp]) => (cp.models ?? []).map((m) => {
+                const model = typeof m === 'string' ? { id: m } : m;
+                return {
+                    id: model.id,
+                    aliases: model.alias ? [model.alias] : [],
+                    provider: `${providerName}(${cp.api})`,
+                    keyReady: cp.apiKey != null,
+                };
+            })),
+        ],
+    };
+}
+/** Job root directory (absolute). */
+export function resolveOutputDir(settings, cwd) {
+    return resolve(cwd, settings.outputDir ?? '.video-gen');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,50 @@
+import type { VideoApiStyle } from './types.js';
+/**
+ * Trust boundary for the whole extension, modeled on pi-image-gen's errors.ts.
+ * Raw provider bodies — and plain `fs`/`fetch` errors, which embed absolute
+ * paths, errno strings, or signed `?token=…` URLs — must reach NEITHER the
+ * user/LLM surface NOR a log. Every EXPECTED failure is thrown as a
+ * `VideoGenError`, the only value whose text is vetted body-free, carrying two
+ * curated views: `message` (LLM-facing) and `logSummary` (stderr-facing).
+ */
+export declare class VideoGenError extends Error {
+    readonly logSummary: string;
+    constructor(message: string, logSummary: string);
+}
+/**
+ * Marker for "the submit may (or may not) have created a paid remote task".
+ * Render orchestration must NOT auto-resubmit on this — the shot is parked in
+ * an `ambiguous` state until the user confirms the provider side is clean.
+ */
+export declare class AmbiguousSubmitError extends VideoGenError {
+}
+/** Marker for inspect failures that are safe and useful to retry locally. */
+export declare class RetryableProviderError extends VideoGenError {
+}
+/** Marker for a remote task that reached a definitive terminal failure. */
+export declare class RemoteTaskFailedError extends VideoGenError {
+    readonly providerMessage: string;
+    constructor(message: string, logSummary: string, providerMessage: string);
+}
+/** Marker for a persisted task handle the provider definitively cannot find. */
+export declare class RemoteTaskNotFoundError extends VideoGenError {
+}
+/** stderr sink: a VideoGenError's curated summary, else a fixed label. */
+export declare function toLogSummary(error: unknown): string;
+/** user/LLM sink: a VideoGenError's vetted message, else a fixed sentence. */
+export declare function errorMessageForUser(error: unknown): string;
+/**
+ * Reduce a URL to `scheme://host/path`, dropping the query (where signed
+ * credentials live), the fragment, and any userinfo.
+ */
+export declare function redactUrl(raw: string): string;
+/** Return a filename without leaking POSIX or Windows parent directories. */
+export declare function safeBasename(path: string): string;
+export declare function providerLabel(style: VideoApiStyle): string;
+/** Missing-API-key error naming the exact settings path / env var to fix. */
+export declare function missingKeyError(style: VideoApiStyle, envVar: string, apiKeyPath?: string): VideoGenError;
+/** HTTP status error with NO response body attached (bodies may carry secrets). */
+export declare function httpStatusError(style: VideoApiStyle, action: string, status: number): VideoGenError;
+/** Network-level failure (no HTTP status). Message stays free of error.message paths. */
+export declare function networkError(style: VideoApiStyle, action: string): VideoGenError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKhD;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAE1D,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,2EAA2E;AAC3E,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM;CAIzE;AAED,gFAAgF;AAChF,qBAAa,uBAAwB,SAAQ,aAAa;CAAG;AAE7D,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,SAA2C,GACpD,aAAa,CAKf;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,aAAa,CAiBf;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAKhF"}

package/dist/errors.js

@@ -0,0 +1,99 @@
+/**
+ * Trust boundary for the whole extension, modeled on pi-image-gen's errors.ts.
+ * Raw provider bodies — and plain `fs`/`fetch` errors, which embed absolute
+ * paths, errno strings, or signed `?token=…` URLs — must reach NEITHER the
+ * user/LLM surface NOR a log. Every EXPECTED failure is thrown as a
+ * `VideoGenError`, the only value whose text is vetted body-free, carrying two
+ * curated views: `message` (LLM-facing) and `logSummary` (stderr-facing).
+ */
+export class VideoGenError extends Error {
+    logSummary;
+    constructor(message, logSummary) {
+        super(message);
+        this.name = 'VideoGenError';
+        this.logSummary = logSummary.split(/[\r\n]/, 1)[0] || 'video generation failed';
+    }
+}
+/**
+ * Marker for "the submit may (or may not) have created a paid remote task".
+ * Render orchestration must NOT auto-resubmit on this — the shot is parked in
+ * an `ambiguous` state until the user confirms the provider side is clean.
+ */
+export class AmbiguousSubmitError extends VideoGenError {
+}
+/** Marker for inspect failures that are safe and useful to retry locally. */
+export class RetryableProviderError extends VideoGenError {
+}
+/** Marker for a remote task that reached a definitive terminal failure. */
+export class RemoteTaskFailedError extends VideoGenError {
+    providerMessage;
+    constructor(message, logSummary, providerMessage) {
+        super(message, logSummary);
+        this.providerMessage = providerMessage;
+    }
+}
+/** Marker for a persisted task handle the provider definitively cannot find. */
+export class RemoteTaskNotFoundError extends VideoGenError {
+}
+/** stderr sink: a VideoGenError's curated summary, else a fixed label. */
+export function toLogSummary(error) {
+    if (error instanceof VideoGenError)
+        return error.logSummary;
+    return error instanceof Error ? 'unexpected error' : 'unexpected non-error throw';
+}
+/** user/LLM sink: a VideoGenError's vetted message, else a fixed sentence. */
+export function errorMessageForUser(error) {
+    if (error instanceof VideoGenError)
+        return error.message;
+    return 'Video generation failed unexpectedly. Retry once; if it persists, report a pi-video-gen bug.';
+}
+/**
+ * Reduce a URL to `scheme://host/path`, dropping the query (where signed
+ * credentials live), the fragment, and any userinfo.
+ */
+export function redactUrl(raw) {
+    try {
+        const u = new URL(raw);
+        return `${u.protocol}//${u.host}${u.pathname}`;
+    }
+    catch {
+        return '<url>';
+    }
+}
+/** Return a filename without leaking POSIX or Windows parent directories. */
+export function safeBasename(path) {
+    return path.split(/[\\/]/).pop() || 'file';
+}
+const PROVIDER_LABELS = {
+    ark: 'Volcengine Ark',
+    kling: 'Kling',
+    dashscope: 'DashScope',
+    openrouter: 'OpenRouter',
+    newapi: 'NewAPI',
+};
+export function providerLabel(style) {
+    return PROVIDER_LABELS[style];
+}
+/** Missing-API-key error naming the exact settings path / env var to fix. */
+export function missingKeyError(style, envVar, apiKeyPath = `pi-video-gen.providers.${style}.apiKey`) {
+    return new VideoGenError(`No API key configured for ${providerLabel(style)}. Set "${apiKeyPath}" in global or agent-dir Pi settings — "${`$\{${envVar}}`}" interpolation is supported — then retry.`, `${providerLabel(style)}: missing api key`);
+}
+/** HTTP status error with NO response body attached (bodies may carry secrets). */
+export function httpStatusError(style, action, status) {
+    const hint = status === 401 || status === 403
+        ? ' Check the API key.'
+        : status === 429
+            ? ' Rate limited — lower concurrency or wait.'
+            : '';
+    const ErrorType = action === 'inspect' && status === 404
+        ? RemoteTaskNotFoundError
+        : status === 429 || status >= 500
+            ? RetryableProviderError
+            : VideoGenError;
+    return new ErrorType(`${providerLabel(style)} ${action} failed with HTTP ${status}.${hint}`, `${providerLabel(style)} ${action} HTTP ${status}`);
+}
+/** Network-level failure (no HTTP status). Message stays free of error.message paths. */
+export function networkError(style, action) {
+    return new RetryableProviderError(`${providerLabel(style)} ${action} failed: network error. Check connectivity and retry.`, `${providerLabel(style)} ${action} network error`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/ffmpeg.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ffmpeg resolution and video assembly.
+ *
+ * Resolution order: `pi-video-gen.ffmpegPath` (sensitive — global / agent-dir
+ * settings only) → `FFMPEG_PATH` env → platform-specific optional npm package
+ * → `ffmpeg-static` in node_modules (dev fallback) → `ffmpeg` on PATH. The
+ * doctor reports which source resolved.
+ */
+export type FfmpegSource = 'settings' | 'env' | 'bundled' | 'path';
+export type FfmpegResolution = {
+    path: string;
+    source: FfmpegSource;
+    runnable: boolean;
+};
+/**
+ * Resolve ffprobe as the SIBLING of the resolved ffmpeg (same directory),
+ * falling back to `ffprobe` on PATH. Platform packages ship both binaries.
+ */
+/**
+ * Resolve the GPL ffmpeg variant (with libx264) as the sibling of the
+ * resolved ffmpeg named `ffmpeg-gpl`. Required for h264 output — the LGPL
+ * build intentionally has no x264 encoder.
+ */
+export declare function resolveGplFfmpeg(settingsPath?: string | undefined): FfmpegResolution;
+export declare function resolveFfprobe(settingsPath?: string | undefined): FfmpegResolution;
+export declare function resolveFfmpeg(settingsPath?: string | undefined): FfmpegResolution;
+export type StreamInfo = {
+    videoCodec: string;
+    width: number;
+    height: number;
+    fps: string;
+    timebase: string;
+    pixFmt: string;
+    audioLayout: string;
+    /** Extra incompatibility vectors beyond the first video track. */
+    streamCount: number;
+    audioSampleRate: string;
+    audioTimebase: string;
+    subtitleCodec: string;
+    streamSignatures: string[];
+};
+/** Probe a media file's stream signature for strict-copy compatibility checks. */
+export declare function probeStreams(ffprobePath: string, filePath: string, signal?: AbortSignal): Promise<StreamInfo>;
+/** ffprobe the container duration of a media file, in seconds. */
+export declare function probeDuration(ffprobePath: string, filePath: string, signal?: AbortSignal): Promise<number>;
+/** Probe the first video stream's duration (container audio may be longer). */
+export declare function probeVideoDuration(ffprobePath: string, filePath: string, signal?: AbortSignal): Promise<number>;
+/** Public ffmpeg runner used by the timeline pipeline (arbitrary arg lists). */
+export declare function runFfmpegCommand(ffmpegPath: string, args: string[], signal?: AbortSignal): Promise<void>;
+/**
+ * Concatenate shot clips into the final video. Tries the lossless concat
+ * demuxer (`-c copy`) first — same-codec clips join in seconds without
+ * re-encoding; falls back to an mpeg4 re-encode when codecs/params differ
+ * (mpeg4 is LGPL-clean — libx264 would REQUIRE a GPL build of ffmpeg).
+ */
+export declare function concatVideos(opts: {
+    inputs: string[];
+    outputPath: string;
+    ffmpegPath: string;
+    signal?: AbortSignal | undefined;
+    /** C0 compose: copy ONLY — report failure instead of re-encoding. */
+    strictCopy?: boolean | undefined;
+}): Promise<void>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../src/ffmpeg.ts"],"names":[],"mappings":"AAiCA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAYpF;AAED,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAYlF;AAED,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAejF;AAwBD,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AA8DF,kFAAkF;AAClF,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAED,kEAAkE;AAClE,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhB"}