@marlinjai/studio-mcp 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -33,6 +33,7 @@ declare const DocNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "multiview-to-3d": "multiview-to-3d";
         remesh: "remesh";
         texture: "texture";
+        rig: "rig";
         "text-to-audio": "text-to-audio";
         "text-to-speech": "text-to-speech";
         "speech-to-text": "speech-to-text";
@@ -121,6 +122,7 @@ declare const WorkflowDocumentSchema: z.ZodObject<{
             "multiview-to-3d": "multiview-to-3d";
             remesh: "remesh";
             texture: "texture";
+            rig: "rig";
             "text-to-audio": "text-to-audio";
             "text-to-speech": "text-to-speech";
             "speech-to-text": "speech-to-text";
@@ -249,6 +251,7 @@ declare const OpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "multiview-to-3d": "multiview-to-3d";
             remesh: "remesh";
             texture: "texture";
+            rig: "rig";
             "text-to-audio": "text-to-audio";
             "text-to-speech": "text-to-speech";
             "speech-to-text": "speech-to-text";
@@ -341,6 +344,7 @@ declare const OpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "multiview-to-3d": "multiview-to-3d";
             remesh: "remesh";
             texture: "texture";
+            rig: "rig";
             "text-to-audio": "text-to-audio";
             "text-to-speech": "text-to-speech";
             "speech-to-text": "speech-to-text";
@@ -543,6 +547,7 @@ declare const PatchSchema: z.ZodObject<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -635,6 +640,7 @@ declare const PatchSchema: z.ZodObject<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -852,7 +858,7 @@ interface ApplyError {
  * Pure: no database, no provider, no DOM.
  */
 
-type ProjectionIssueCode = "no_task_nodes" | "not_runnable" | "no_model" | "prompt_required" | "source_uploading" | "no_inputs" | "param_unmappable" | "param_type_conflict" | "integrity";
+type ProjectionIssueCode = "no_task_nodes" | "not_runnable" | "no_model" | "prompt_required" | "source_uploading" | "keyframe_positions" | "no_inputs" | "param_unmappable" | "param_type_conflict" | "integrity";
 interface ProjectionIssue {
     code: ProjectionIssueCode;
     /** The node the issue is about, when it is about one. */
@@ -863,11 +869,12 @@ interface ProjectionIssue {
 /**
  * Server configuration, resolved from the environment once at startup.
  *
- * `LUMITRA_STUDIO_API_KEY` is the bearer token. The legacy name
- * `LUMITRA_STUDIO_SERVICE_TOKEN` (the batch skill + lola-stories backend) is
- * accepted as a fallback so an existing cc.sh-injected environment works
- * unchanged. The token is held in memory only: nothing in this package ever
- * logs, echoes, or serializes it (see `redactSecret` in errors.ts).
+ * `LUMITRA_STUDIO_API_KEY` is the bearer token, and the only name read. The
+ * legacy name `LUMITRA_STUDIO_SERVICE_TOKEN` was a fallback until 0.4.0; the two
+ * names carried different keys on one machine, so there is now one. A legacy
+ * variable that is still set is named in the error, never read. The token is
+ * held in memory only: nothing in this package ever logs, echoes, or serializes
+ * it (see `redactSecret` in errors.ts).
  *
  * Placeholder handling: the Agent Plugins spec only guarantees expansion of
  * `${PLUGIN_ROOT}` / `${PLUGIN_DATA}` in a plugin's `.mcp.json`, so some
@@ -965,6 +972,9 @@ interface NodeRun {
         mime?: string | null;
         text?: string;
         json?: unknown;
+        assetId?: string | null;
+        /** A name for one of several results, e.g. a rig's animation clip preset. */
+        label?: string;
     }>;
     costUsd?: number | null;
     errorMessage?: string | null;
@@ -1047,7 +1057,11 @@ interface TenantUsageResponse {
     tenantId?: string;
     month: string;
     plan: string;
+    /** `null` = explicitly unlimited (only an operator-set plan can be). */
     capUsd: number | null;
+    /** `default`: no plan of its own, the default cap applies. `row`: an
+     * operator-set plan. Absent from a Studio older than 2026-09-23. */
+    capSource?: 'row' | 'default';
     rpm: number | null;
     /** Realized + in-flight estimated: the same total the quota guard checks
      * against and a 402 body's `usedUsd` reports. */
@@ -1198,6 +1212,25 @@ declare class StudioClient {
         jobId: string;
         kind: string;
     }>;
+    /**
+     * One 3D generation. `/api/generate` routes to its 3D branch on `?force=3d`
+     * (a prompt alone would be classified by its words); the model and its flags
+     * ride under `settings.model3d` and `settings.options3d`, an input image as
+     * `images[0]`.
+     */
+    generate3d(body: {
+        prompt: string;
+        images?: string[];
+        projectId?: string;
+        brandSlug?: string;
+        settings?: {
+            model3d?: string;
+            options3d?: Record<string, unknown>;
+        };
+    }): Promise<{
+        jobId: string;
+        kind: string;
+    }>;
     getJob(jobId: string): Promise<JobResponse>;
     listCharacters(): Promise<{
         characters: CharacterSummary[];
@@ -1214,6 +1247,11 @@ declare class StudioClient {
         descriptorPrompt: string;
         negativePrompt?: string;
         defaultModel?: string;
+        /** The likeness acknowledgement, confirmed by the human the agent acts
+         * for. The literal `true` in the type is the point: a call site with no
+         * confirmation to pass does not compile. The Studio answers 422
+         * `likeness_rights_confirmation_required` without it. */
+        likenessRightsConfirmed: true;
     }): Promise<{
         character: CharacterSummary;
     }>;
@@ -1316,6 +1354,10 @@ declare class StudioClient {
         budgetUsd?: number;
         /** Bypasses the $10 confirmation threshold for this one request. */
         confirm?: boolean;
+        /** The likeness acknowledgement. Required by the Studio when the recipe
+         * creates a character (422 `likeness_rights_confirmation_required`,
+         * before anything is spent); ignored by a recipe that creates none. */
+        likenessRightsConfirmed?: true;
     }): Promise<{
         runId: string;
         status: string;
@@ -1458,7 +1500,7 @@ declare function registerTools(server: McpServer, ctx: ToolContext): void;
  */
 
 declare const SERVER_NAME = "lumitra-studio";
-declare const SERVER_VERSION = "0.2.0";
+declare const SERVER_VERSION = "0.4.0";
 interface CreateServerOptions {
     config?: StudioConfig;
     env?: NodeJS.ProcessEnv;
@@ -1530,6 +1572,7 @@ declare const studioWorkflowCreate: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -1622,6 +1665,7 @@ declare const studioWorkflowCreate: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -1826,6 +1870,7 @@ declare const studioWorkflowApply: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -1918,6 +1963,7 @@ declare const studioWorkflowApply: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -2121,6 +2167,7 @@ declare const studioWorkflowValidate: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -2250,6 +2297,7 @@ declare const studioWorkflowValidate: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -2342,6 +2390,7 @@ declare const studioWorkflowValidate: ToolDef<{
                 "multiview-to-3d": "multiview-to-3d";
                 remesh: "remesh";
                 texture: "texture";
+                rig: "rig";
                 "text-to-audio": "text-to-audio";
                 "text-to-speech": "text-to-speech";
                 "speech-to-text": "speech-to-text";
@@ -2791,7 +2840,7 @@ declare function buildCharacterSwapDefinition(input: CharacterSwapInput): Workfl
  * `studio-mcp --http [--port 3939]`  Streamable HTTP transport on /mcp (remote / shared)
  *
  * Config: LUMITRA_STUDIO_BASE_URL (default https://studio.lumitra.co) and
- * LUMITRA_STUDIO_API_KEY (or legacy LUMITRA_STUDIO_SERVICE_TOKEN). The token is
+ * LUMITRA_STUDIO_API_KEY (the only key name read). The token is
  * never printed. All diagnostics go to stderr (stdout is the stdio transport).
  */