@marlinjai/studio-mcp 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -869,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
@@ -928,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;
@@ -1056,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';
@@ -1201,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
@@ -1499,7 +1545,7 @@ declare function registerTools(server: McpServer, ctx: ToolContext): void;
  */
 
 declare const SERVER_NAME = "lumitra-studio";
-declare const SERVER_VERSION = "0.3.0";
+declare const SERVER_VERSION = "0.5.0";
 interface CreateServerOptions {
     config?: StudioConfig;
     env?: NodeJS.ProcessEnv;
@@ -2839,7 +2885,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).
  */
 
@@ -2859,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 };