@slatesvideo/shared 0.5.4 → 0.5.6

package/README.md

@@ -21,3 +21,16 @@ Prompting doctrine that applies to more than one model lives **once**, in `skill
 `npm run build` runs `sync-partials.mjs --check`, which fails with a diff if anything inside a marker block was hand-edited, if a skill references a partial that doesn't exist, if markers are unbalanced, or if a partial is referenced by nothing. Run `npm run sync-partials` to apply changes after editing a partial.
 
 **To change shared prompting doctrine: edit the partial.** Never edit between markers, never edit `partials.generated.ts`, and never hand-copy a shared rule into a new skill — a copy is a fork with a delay fuse. Per-model levers (a vendor's own official consistency mechanism, its caps and transport quirks) stay hand-authored, below the injected block, under a `### For <model> specifically` heading.
+
+## Portable Prompt Builder export
+
+The downloadable Claude `.skill` is generated at `exports/slates-prompt-builder/generated/`. Its model, character, and content-policy references come directly from the resolved production files in `skills/`; its routing table derives from `MODEL_FACTS`; the portable wrapper owns only export-specific scope and output behavior.
+
+```bash
+npm run sync-prompt-builder   # regenerate markdown, manifest, and deterministic .skill
+npm run typecheck             # fails if the committed export is stale
+```
+
+`scripts/build-prompt-builder.mjs --check` validates generated text content (normalizing LF/CRLF), keeps the archive byte-exact, opens it to verify its exact entry set, and enforces the runtime character contract (one sheet, the canonical `IDENTITY_PLATE_HEX`, flat/shadowless light, and the three-panel builder). Never edit `exports/slates-prompt-builder/generated/` directly.
+
+The repository verification workflow runs both typecheck and build on every pull request and push to `main`, so stale exports cannot merge through the normal GitHub path.

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { SlatesCloudClient, type SlatesUserInfo, type CreditsBalance, type Model
 export { SlatesDesktopClient, type DesktopHealth } from './clients/desktop.js';
 export { SKILLS } from './skills/content.js';
 export * as operations from './operations/index.js';
-export { ALL_OPERATIONS, VIDEO_MODELS, defaultContext, type Operation, type OperationContext, type OperationResult } from './operations/index.js';
+export { ALL_OPERATIONS, VIDEO_MODELS, AUDIO_MODELS, defaultContext, type Operation, type OperationContext, type OperationResult } from './operations/index.js';
 export { MODEL_FACTS, getModelFact, type ModelFact } from './prompts/model-facts.js';
 export { PROMPTING_TIPS, getPromptingTips, type PromptingTipsEntry, type PromptingTipCard, type PromptingTipsKey } from './prompts/prompting-tips.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,9 +3,9 @@ export { SlatesCloudClient } from './clients/cloud.js';
 export { SlatesDesktopClient } from './clients/desktop.js';
 export { SKILLS } from './skills/content.js';
 export * as operations from './operations/index.js';
-export { ALL_OPERATIONS, VIDEO_MODELS, defaultContext } from './operations/index.js';
+export { ALL_OPERATIONS, VIDEO_MODELS, AUDIO_MODELS, defaultContext } from './operations/index.js';
 // Model routing/prompting facts — the SSOT the desktop Studio Agent system
-// prompt derives its MODEL ROUTING doctrine from (kind: image vs video,
+// prompt derives its MODEL ROUTING doctrine from (kind: image | video | audio,
 // default/premium/niche notes). Edit model-facts.ts, never prose copies.
 export { MODEL_FACTS, getModelFact } from './prompts/model-facts.js';
 // Per-model prompting tips — the SSOT for the desktop "See prompting tips"

package/dist/operations/index.d.ts

@@ -32,6 +32,7 @@ export declare const estimateGenerationCost: Operation<{
     model: string;
     quantity?: number;
     duration?: number;
+    characters?: number;
     videoResolution?: '480p' | '720p' | '1080p' | '4k';
     resolution?: '1k' | '2k' | '3k' | '4k';
     quality?: 'medium' | 'high';
@@ -67,7 +68,7 @@ export declare const uploadReferenceImage: Operation<{
     projectId: string;
     filePath?: string;
     dataUrl?: string;
-    type?: 'image' | 'video';
+    type?: 'image' | 'video' | 'audio';
 }>;
 export declare const listFolders: Operation<{
     projectId: string;
@@ -80,6 +81,21 @@ export declare const moveAssetsToFolder: Operation<{
     assetIds: string[];
     folderId: string | null;
 }>;
+export declare const moveAssetsToProject: Operation<{
+    sourceProjectId: string;
+    assetIds: string[];
+    targetProjectId: string;
+}>;
+export declare const copyAssetsToProject: Operation<{
+    sourceProjectId: string;
+    assetIds: string[];
+    targetProjectId: string;
+}>;
+export declare const moveEntityToProject: Operation<{
+    kind: 'character' | 'environment' | 'style';
+    entityId: string;
+    targetProjectId: string;
+}>;
 export declare const listCharacters: Operation<{
     projectId: string;
 }>;
@@ -89,11 +105,7 @@ export declare const createCharacter: Operation<{
     description?: string;
     style?: string;
 }>;
-export declare const setCharacterTurnaround: Operation<{
-    characterId: string;
-    assetId: string | null;
-}>;
-export declare const setCharacterExpression: Operation<{
+export declare const setCharacterIdentity: Operation<{
     characterId: string;
     assetId: string | null;
 }>;
@@ -106,11 +118,10 @@ export declare const createEnvironment: Operation<{
     description?: string;
     style?: string;
 }>;
-export declare const generateCharacterSheets: Operation<{
+export declare const generateCharacterIdentity: Operation<{
     characterId: string;
     projectId: string;
     baseAssetId: string;
-    sheetTypes?: ('turnaround' | 'expression')[];
     userNotes?: string;
     model?: 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-pro' | 'gpt-image-2';
 }>;
@@ -187,6 +198,42 @@ export declare function videoCostKey(input: {
 }): string;
 export declare function klingEditCostKey(model: 'kling-v3.0-omni-edit' | 'kling-v3.0-omni-pro-edit', duration: number): string;
 export declare function omniFlashEditCostKey(duration: number): string;
+export declare const AUDIO_MODELS: readonly ["seed-audio", "eleven-v3", "eleven-sfx", "suno"];
+export type AudioModel = (typeof AUDIO_MODELS)[number];
+/**
+ * Per-surface bounds and defaults.
+ *
+ * 🚨 THESE FOUR NUMBERS PER SURFACE LIVE IN THREE REPOS. A change is a
+ * three-site edit, every time:
+ *   1. HERE (`audioCostKey`, the agent's pre-flight quote)
+ *   2. `slate/src/shared/pricing.ts` → MODEL_REGISTRY `audio.durationSeconds`
+ *      (min/max/default), read by `clampAudioDuration` + `audioCreditKey`
+ *   3. `slates-api/src/lib/audio-keys.ts` → the server's fail-closed bounds
+ * `slates-api/scripts/pricing-consistency-check.mjs` §4 asserts 1 and 2 agree
+ * at EVERY value including out-of-range ones; the gate check covers 3.
+ *
+ * The MINs used to be missing here, and the clamp floor was a hardcoded 1. That
+ * made `slates_estimate_generation_cost({model:'seed-audio', duration:2})`
+ * quote a real `seed-audio-2s` price for a generation the desktop would bill as
+ * 3s and the proxy would REJECT outright. Same for an omitted duration, which
+ * quoted `seed-audio-1s` against the desktop's `seed-audio-15s`.
+ */
+export declare const SEED_AUDIO_MIN_SECONDS = 3;
+export declare const SEED_AUDIO_MAX_SECONDS = 120;
+export declare const SEED_AUDIO_DEFAULT_SECONDS = 15;
+export declare const ELEVEN_SFX_MIN_SECONDS = 1;
+export declare const ELEVEN_SFX_MAX_SECONDS = 22;
+export declare const ELEVEN_SFX_DEFAULT_SECONDS = 4;
+export declare const ELEVEN_V3_MAX_CHARACTERS = 5000;
+export declare const SUNO_MIN_SECONDS = 10;
+export declare const SUNO_MAX_SECONDS = 360;
+export declare function audioCostKey(input: {
+    model: AudioModel;
+    /** seed-audio + eleven-sfx: the REQUESTED duration in seconds (ceiled). */
+    durationSeconds?: number;
+    /** eleven-v3: character count of the text to speak (ceiled to 100-char buckets). */
+    characters?: number;
+}): string;
 export declare const generateVideo: Operation<{
     prompt: string;
     model: string;
@@ -213,6 +260,34 @@ export declare const generateVideo: Operation<{
     background?: boolean;
     confirm?: boolean;
 }>;
+export declare const generateAudio: Operation<{
+    projectId: string;
+    model: AudioModel;
+    prompt: string;
+    durationSeconds?: number;
+    voice?: string;
+    stability?: number;
+    languageCode?: string;
+    speed?: number;
+    volume?: number;
+    pitch?: number;
+    multilingual?: boolean;
+    loop?: boolean;
+    promptInfluence?: number;
+    audioReferenceAssetIds?: string[];
+    imageReferenceAssetId?: string;
+    sunoModel?: 'V4' | 'V4_5' | 'V4_5PLUS' | 'V4_5ALL' | 'V5' | 'V5_5';
+    customMode?: boolean;
+    instrumental?: boolean;
+    style?: string;
+    title?: string;
+    negativeTags?: string;
+    vocalGender?: 'm' | 'f';
+    styleWeight?: number;
+    weirdnessConstraint?: number;
+    background?: boolean;
+    confirm?: boolean;
+}>;
 export declare const generateLipSync: Operation<{
     projectId: string;
     sourceAssetId: string;
@@ -377,7 +452,7 @@ export declare const updateEnvironment: Operation<{
     name?: string;
     description?: string;
     style?: string;
-    gridAssetId?: string | null;
+    referenceAssetId?: string | null;
 }>;
 export declare const deleteEnvironment: Operation<{
     environmentId: string;