@marlinjai/studio-mcp 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -929,12 +929,41 @@ interface JobResponse {
         [k: string]: unknown;
     }>;
 }
+/**
+ * How many images a job will really make for the count that was asked for.
+ * Mirrors `CandidatePlan` in the Studio's `src/lib/jobs/candidates.ts`.
+ */
+interface CandidatePlan {
+    /** How many candidates the request asked for (one when it named none). */
+    requested: number;
+    /** How many images to expect. */
+    rendered: number;
+    /** For an automatic route whose fallback renders more: the most the job can render. */
+    mayRender?: number;
+}
+/** `POST /api/generate` for an image job. `candidates` and `notice` are absent
+ * from a Studio older than 2026-10-11; `notice` is present only when fewer
+ * images will be made than were asked for. */
+interface GenerateImageResponse {
+    jobId: string;
+    kind: string;
+    candidates?: CandidatePlan;
+    notice?: string;
+}
 interface CharacterSummary {
+    /** Unique within the key's company, not across companies. */
     slug: string;
     name: string;
     descriptorPrompt: string;
     negativePrompt?: string | null;
     defaultModel?: string | null;
+    /** True when the character's owner shared it with every company. */
+    shared?: boolean;
+    /**
+     * False for a character another company shared: usable in generations,
+     * never editable (uploads, edits and deletes answer 403).
+     */
+    owned?: boolean;
 }
 interface CharacterReference {
     id: string;
@@ -1057,8 +1086,18 @@ interface TenantUsageResponse {
     tenantId?: string;
     month: string;
     plan: string;
-    /** `null` = explicitly unlimited (only an operator-set plan can be). */
+    /** `null` = no monthly cap: an operator-set unlimited plan, or a company on
+     * prepaid credits, whose balance is the cap (see `credits`). */
     capUsd: number | null;
+    /** A company on prepaid credits: its balance, its daily limit (null: none)
+     * and what left the balance today, all in US dollars of credit. Null for a
+     * company not on credits; absent from a Studio older than 2026-10-10. */
+    credits?: {
+        balanceUsd: number;
+        dailyLimitUsd: number | null;
+        usedTodayUsd: number;
+        dailyResetsAt: string;
+    } | 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';
@@ -1202,16 +1241,22 @@ declare class StudioClient {
     listProjects(): Promise<{
         projects: ProjectSummary[];
     }>;
+    /**
+     * One image job. `brandSlug` is optional: without it the image is generated
+     * with no brand. A `brandSlug` or `characterSlug` the key's company cannot
+     * use is refused with 404 `input_not_found` before anything is spent (since
+     * 2026-10-11; it used to generate without the brand). `projectId` chooses the
+     * project; without it the job lands in the project named after the brand, or
+     * in `default`.
+     */
     generate(body: {
-        brandSlug: string;
+        brandSlug?: string;
         brandMode?: string;
         prompt: string;
         characterSlug?: string;
+        projectId?: string;
         settings?: Record<string, unknown>;
-    }): Promise<{
-        jobId: string;
-        kind: string;
-    }>;
+    }): Promise<GenerateImageResponse>;
     /**
      * 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
@@ -1500,7 +1545,7 @@ declare function registerTools(server: McpServer, ctx: ToolContext): void;
  */
 
 declare const SERVER_NAME = "lumitra-studio";
-declare const SERVER_VERSION = "0.4.0";
+declare const SERVER_VERSION = "0.5.0";
 interface CreateServerOptions {
     config?: StudioConfig;
     env?: NodeJS.ProcessEnv;
@@ -2860,4 +2905,4 @@ declare function parseArgs(argv: string[]): CliArgs;
 declare function createHttpHandler(): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
 declare function main(argv?: string[]): Promise<void>;
 
-export { type AllTenantsUsageResponse, type Binding, CHARACTER_SHEET_DEFINITION, CHARACTER_SHEET_NODES, type CharacterReference, type CharacterSummary, type CharacterSwapInput, ConfigError, ContractError, type CreateServerOptions, DEFAULT_BASE_URL, DEFAULT_MOTION_PROMPT, DEFAULT_SWAP_EDIT_MODEL, DEFAULT_SWAP_PROMPT, DEFAULT_SWAP_VIDEO_MODEL, DEFAULT_TIMEOUT_MS, type DocumentSummary, type FetchLike, type JobResponse, type JobStatus, type JudgeCandidate, MINT_REFERENCE_CATEGORIES, type NodeResultResponse, type NodeRun, type NodeStatus, type NodeSummary, type NodeTypesResponse, type PollOptions, PollTimeoutError, type ProjectSummary, type Projection, type RemovedNode, type RunResponse, type RunStartResponse, type RunStatus, SERVER_NAME, SERVER_VERSION, SUMMARY_TEXT_CHARS, SWAP_SCOPES, type SpendLedger, StudioApiError, StudioClient, type StudioClientOptions, type StudioConfig, type StudioMcp, type SummaryMeta, type SwapPromptOptions, type SwapScope, TOOLS, TOOL_NAMES, type TaskDescriptor, type TenantSpendSummary, type TenantUsageResponse, type ToolContext, type ToolDef, ToolInputError, type ToolResult, type TurnaroundView, type UploadFile, type UsageByModel, type UsageResponse, WORKFLOW_TOOLS, type WorkflowApplyResponse, type WorkflowCreateResponse, type WorkflowDefinition, type WorkflowDocumentResponse, type WorkflowNode, type WorkflowValidateResponse, affectedNodes, buildCharacterSheetParams, buildCharacterSwapDefinition, categoryForNode, characterSheetDefinition, composeSwapPrompt, createHttpHandler, createStudioMcpServer, extensionForMime, filenameFromUrl, invokeTool, main, mimeForFilename, parseArgs, parseDocument, parseOps, pollUntil, projectionOf, redactSecret, registerTools, resolveConfig, seedFacePrompt, studioWorkflowApply, studioWorkflowCreate, studioWorkflowDescribe, studioWorkflowGet, studioWorkflowScreenshot, studioWorkflowValidate, summarizeDocument, summarizeNode, touchedNodeIds, turnaroundViewPrompt, waitForJob, waitForRun };
+export { type AllTenantsUsageResponse, type Binding, CHARACTER_SHEET_DEFINITION, CHARACTER_SHEET_NODES, type CandidatePlan, type CharacterReference, type CharacterSummary, type CharacterSwapInput, ConfigError, ContractError, type CreateServerOptions, DEFAULT_BASE_URL, DEFAULT_MOTION_PROMPT, DEFAULT_SWAP_EDIT_MODEL, DEFAULT_SWAP_PROMPT, DEFAULT_SWAP_VIDEO_MODEL, DEFAULT_TIMEOUT_MS, type DocumentSummary, type FetchLike, type GenerateImageResponse, type JobResponse, type JobStatus, type JudgeCandidate, MINT_REFERENCE_CATEGORIES, type NodeResultResponse, type NodeRun, type NodeStatus, type NodeSummary, type NodeTypesResponse, type PollOptions, PollTimeoutError, type ProjectSummary, type Projection, type RemovedNode, type RunResponse, type RunStartResponse, type RunStatus, SERVER_NAME, SERVER_VERSION, SUMMARY_TEXT_CHARS, SWAP_SCOPES, type SpendLedger, StudioApiError, StudioClient, type StudioClientOptions, type StudioConfig, type StudioMcp, type SummaryMeta, type SwapPromptOptions, type SwapScope, TOOLS, TOOL_NAMES, type TaskDescriptor, type TenantSpendSummary, type TenantUsageResponse, type ToolContext, type ToolDef, ToolInputError, type ToolResult, type TurnaroundView, type UploadFile, type UsageByModel, type UsageResponse, WORKFLOW_TOOLS, type WorkflowApplyResponse, type WorkflowCreateResponse, type WorkflowDefinition, type WorkflowDocumentResponse, type WorkflowNode, type WorkflowValidateResponse, affectedNodes, buildCharacterSheetParams, buildCharacterSwapDefinition, categoryForNode, characterSheetDefinition, composeSwapPrompt, createHttpHandler, createStudioMcpServer, extensionForMime, filenameFromUrl, invokeTool, main, mimeForFilename, parseArgs, parseDocument, parseOps, pollUntil, projectionOf, redactSecret, registerTools, resolveConfig, seedFacePrompt, studioWorkflowApply, studioWorkflowCreate, studioWorkflowDescribe, studioWorkflowGet, studioWorkflowScreenshot, studioWorkflowValidate, summarizeDocument, summarizeNode, touchedNodeIds, turnaroundViewPrompt, waitForJob, waitForRun };