@pinepaper.studio/mcp-server 1.6.15 → 1.6.17

package/dist/tools/handlers/beats.d.ts

@@ -0,0 +1,64 @@
+/**
+ * pinepaper_beat_cuts (plan B2): music → audio_beats analysis → a beat grid →
+ * cut points on beats or bars, and optionally a clip split at each one.
+ *
+ * Orchestrated here through the real tools (audio_beats analyze, media
+ * split), so their checks apply: large sources are staged, ids resolve,
+ * a refused split is named.
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { type HandlerOptions } from '../handlers.js';
+export declare const BeatCutsArgsSchema: z.ZodEffects<z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    beats: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    bpm: z.ZodOptional<z.ZodNumber>;
+    bpmHint: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    every: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["beat", "bar"]>, z.ZodNumber]>>;
+    beatsPerBar: z.ZodOptional<z.ZodNumber>;
+    range: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    clipId: z.ZodOptional<z.ZodString>;
+    includeOnsets: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    every?: number | "bar" | "beat" | undefined;
+    source?: string | undefined;
+    beats?: number[] | undefined;
+    range?: [number, number] | undefined;
+    bpm?: number | undefined;
+    bpmHint?: [number, number] | undefined;
+    includeOnsets?: boolean | undefined;
+    beatsPerBar?: number | undefined;
+    clipId?: string | undefined;
+}, {
+    every?: number | "bar" | "beat" | undefined;
+    source?: string | undefined;
+    beats?: number[] | undefined;
+    range?: [number, number] | undefined;
+    bpm?: number | undefined;
+    bpmHint?: [number, number] | undefined;
+    includeOnsets?: boolean | undefined;
+    beatsPerBar?: number | undefined;
+    clipId?: string | undefined;
+}>, {
+    every?: number | "bar" | "beat" | undefined;
+    source?: string | undefined;
+    beats?: number[] | undefined;
+    range?: [number, number] | undefined;
+    bpm?: number | undefined;
+    bpmHint?: [number, number] | undefined;
+    includeOnsets?: boolean | undefined;
+    beatsPerBar?: number | undefined;
+    clipId?: string | undefined;
+}, {
+    every?: number | "bar" | "beat" | undefined;
+    source?: string | undefined;
+    beats?: number[] | undefined;
+    range?: [number, number] | undefined;
+    bpm?: number | undefined;
+    bpmHint?: [number, number] | undefined;
+    includeOnsets?: boolean | undefined;
+    beatsPerBar?: number | undefined;
+    clipId?: string | undefined;
+}>;
+export declare const beatHandlers: Record<string, (args: Record<string, unknown>, options: HandlerOptions) => Promise<CallToolResult>>;
+//# sourceMappingURL=beats.d.ts.map

package/dist/tools/handlers/beats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beats.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/beats.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiD,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIpG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU2F,CAAC;AAO3H,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CA2D5H,CAAC"}

package/dist/tools/handlers/beats.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { errorResult, getExecutionMode, handleToolCall } from '../handlers.js';
+import { ErrorCodes } from '../../types/schemas.js';
+import { beatGrid, cutPoints, tempoCandidates } from '../../utils/beats.js';
+export const BeatCutsArgsSchema = z.object({
+    source: z.string().min(1).optional(),
+    beats: z.array(z.number().min(0)).optional(),
+    bpm: z.number().positive().max(400).optional(),
+    bpmHint: z.tuple([z.number().positive(), z.number().positive()]).optional(),
+    every: z.union([z.enum(['beat', 'bar']), z.number().int().min(1).max(64)]).optional(),
+    beatsPerBar: z.number().int().min(1).max(16).optional(),
+    range: z.tuple([z.number().min(0), z.number().min(0)]).optional(),
+    clipId: z.string().min(1).optional(),
+    includeOnsets: z.boolean().optional(),
+}).refine((v) => !!(v.source || v.beats), { message: 'give source (music to analyse) or beats (times you already have)' });
+const firstJson = (r) => {
+    const c = r.content?.[0];
+    try {
+        return c && 'text' in c ? JSON.parse(c.text) : null;
+    }
+    catch {
+        return null;
+    }
+};
+export const beatHandlers = {
+    'pinepaper_beat_cuts': async (args, options) => {
+        const a = BeatCutsArgsSchema.parse(args);
+        let beats = a.beats ? [...a.beats].sort((x, y) => x - y) : null;
+        let bpm = a.bpm ?? null;
+        let grid = null;
+        if (!beats) {
+            if ((options.executionMode ?? getExecutionMode()) === 'code' || !options.executeInBrowser) {
+                return errorResult(ErrorCodes.VALIDATION_ERROR, 'beat_cuts analyses the music in the studio, so it needs a live studio — or pass beats (times in seconds) you already have.');
+            }
+            const analysed = await handleToolCall('pinepaper_audio_beats', { action: 'analyze', source: a.source }, options);
+            const body = firstJson(analysed);
+            const r = body?.result ?? body;
+            if (analysed.isError || !r || r.success === false || !Array.isArray(r.onsets) || !(r.bpm > 0)) {
+                return errorResult(ErrorCodes.EXECUTION_ERROR, `the music could not be analysed: ${(r && r.error) || JSON.stringify(body).slice(0, 300)}`);
+            }
+            const duration = Number(r.duration) || Math.max(...r.onsets, 0);
+            // The studio's tempo can lock onto a related one (a 120 track read as
+            // 162 = 4:3). Its usual confusions are scored against the onsets and
+            // the best is used — or the caller's bpm, or the best inside bpmHint.
+            const candidates = tempoCandidates(r.onsets, r.bpm, duration, a.bpmHint);
+            const chosen = a.bpm ?? candidates[0]?.bpm ?? r.bpm;
+            const g = beatGrid(r.onsets, chosen, duration);
+            beats = g.beats;
+            bpm = g.bpm;
+            const conf = candidates.find((c) => c.bpm === Math.round(chosen * 10) / 10)?.confidence ?? null;
+            grid = { bpm: g.bpm, phase: g.phase, period: Math.round(g.period * 1000) / 1000, confidence: conf, detected: { bpm: r.bpm, confidence: r.confidence }, duration: r.duration,
+                candidates: candidates.slice(0, 4), ...(a.includeOnsets ? { onsets: r.onsets } : {}), ...(a.bpm ? { bpmFrom: 'caller' } : a.bpmHint ? { bpmFrom: 'bpmHint' } : { bpmFrom: 'best candidate' }) };
+            if (!a.bpm && (conf === null || conf < 0.4)) {
+                grid.lowConfidence = true;
+                grid.warning = `the tempo is uncertain (confidence ${conf ?? 'unknown'} at ${g.bpm} bpm; the studio detected ${r.bpm} at ${r.confidence}). If you know it, pass bpm (or bpmHint: [min, max]); the candidates above are the likely alternatives.`;
+            }
+        }
+        const cuts = cutPoints(beats, a.every ?? 'beat', a.beatsPerBar ?? 4, a.range);
+        const out = { success: true, every: a.every ?? 'beat', ...(bpm ? { bpm } : {}), ...(grid ? { grid } : {}), cuts, count: cuts.length };
+        // Split a clip at each cut, in order: each split leaves the rest of the clip
+        // on the right-hand piece, which is where the next cut falls.
+        if (a.clipId && cuts.length) {
+            const pieces = [a.clipId];
+            let current = a.clipId;
+            const refused = [];
+            for (const at of cuts) {
+                const r = await handleToolCall('pinepaper_media', { action: 'split', id: current, at }, options);
+                const body = firstJson(r);
+                const res = body?.result ?? body;
+                if (r.isError || !res || res.success === false) {
+                    const e = res?.error;
+                    refused.push({ at, reason: typeof e === 'string' ? e : (e?.message ?? JSON.stringify(e ?? 'refused')) });
+                    continue;
+                }
+                current = res.rightId ?? current;
+                pieces.push(current);
+            }
+            out.split = { clipId: a.clipId, pieces, made: pieces.length - 1, ...(refused.length ? { skipped: refused, note: 'cuts outside the clip (before its start or after its end) are skipped.' } : {}) };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(out, null, 2) }] };
+    },
+};
+//# sourceMappingURL=beats.js.map

package/dist/tools/handlers/beats.js.map

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

package/dist/tools/handlers/camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrF,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAoF7B,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAsCxD,CAAC"}
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrF,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAoF7B,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAuDxD,CAAC"}

package/dist/tools/handlers/camera.js

@@ -85,6 +85,17 @@ async function dispatchCameraAction(args, options) {
 export const cameraHandlers = {
     pinepaper_camera_animate: async (args, options) => {
         const keyframes = args.keyframes;
+        // The handler takes its args unparsed, so a missing keyframes array
+        // reached JSON.parse(JSON.stringify(undefined)) and came back as a raw
+        // SyntaxError (external review, 1.6.15). Checked here and named.
+        if (!Array.isArray(keyframes) || keyframes.length === 0) {
+            return errorResult(ErrorCodes.INVALID_INPUT, 'keyframes is required: a non-empty array of { time (seconds), zoom?, center?: [x, y], pitch?, yaw?, easing? }. '
+                + 'For a single move without keyframes use pinepaper_camera (zoom / pan / move_to), or pinepaper_camera_director for a shot list.');
+        }
+        const badKey = keyframes.findIndex((k) => !k || typeof k !== 'object' || typeof k.time !== 'number' || !Number.isFinite(k.time) || k.time < 0);
+        if (badKey >= 0) {
+            return errorResult(ErrorCodes.INVALID_INPUT, `keyframes[${badKey}] needs a numeric time (seconds, >= 0); got ${JSON.stringify(keyframes[badKey])}.`);
+        }
         // Optional (retest): omitted, the camera runs to its last keyframe. The
         // last key's time is passed rather than nothing, so every studio does the
         // same — a newer engine infers it, an older one clamped at 2 s.

package/dist/tools/handlers/camera.js.map

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

package/dist/tools/handlers/generate.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Generated media through the PinePaper cloud (fal models behind one door):
+ * pinepaper_generate_estimate (free) and pinepaper_generate (charged).
+ *
+ * This is the one place the local server calls the hosted API. It needs a
+ * service-account key (PINEPAPER_API_KEY, `pp_sa_…`) with the render:create
+ * scope, and the org must have the ai-media feature — an internal beta, so a
+ * 403 is the ordinary answer for most keys and is said as such.
+ *
+ * The job shape is the cloud's (/v1/generate → 202 {job}, poll
+ * /v1/generate/{id}), shared by stills now and video next; video only needs a
+ * longer poll, so the timeout is a parameter, not a per-model constant.
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { type HandlerOptions } from '../handlers.js';
+export declare const GenerateEstimateArgsSchema: z.ZodEffects<z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    useCase: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodString;
+        aspect: z.ZodOptional<z.ZodEnum<["16:9", "9:16", "1:1", "4:5"]>>;
+        n: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        negativePrompt: z.ZodOptional<z.ZodString>;
+        imageUrls: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<["headline", "subhead", "caption", "cta", "label"]>>;
+            font: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }, {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }>, "many">>;
+        allowText: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    }, {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    }>>;
+    listModels: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    input?: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    } | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    listModels?: boolean | undefined;
+}, {
+    input?: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    } | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    listModels?: boolean | undefined;
+}>, {
+    input?: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    } | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    listModels?: boolean | undefined;
+}, {
+    input?: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    } | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    listModels?: boolean | undefined;
+}>;
+export declare const GenerateArgsSchema: z.ZodEffects<z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    useCase: z.ZodOptional<z.ZodString>;
+    input: z.ZodObject<{
+        prompt: z.ZodString;
+        aspect: z.ZodOptional<z.ZodEnum<["16:9", "9:16", "1:1", "4:5"]>>;
+        n: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        negativePrompt: z.ZodOptional<z.ZodString>;
+        imageUrls: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<["headline", "subhead", "caption", "cta", "label"]>>;
+            font: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }, {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }>, "many">>;
+        allowText: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    }, {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    }>;
+    brief: z.ZodOptional<z.ZodString>;
+    designRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+    }, {
+        id: string;
+        kind: string;
+    }>>;
+    place: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["cover", "contain"]>]>>;
+    timeoutSec: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    input: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    };
+    place?: boolean | "contain" | "cover" | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    brief?: string | undefined;
+    designRef?: {
+        id: string;
+        kind: string;
+    } | undefined;
+    timeoutSec?: number | undefined;
+}, {
+    input: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    };
+    place?: boolean | "contain" | "cover" | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    brief?: string | undefined;
+    designRef?: {
+        id: string;
+        kind: string;
+    } | undefined;
+    timeoutSec?: number | undefined;
+}>, {
+    input: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    };
+    place?: boolean | "contain" | "cover" | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    brief?: string | undefined;
+    designRef?: {
+        id: string;
+        kind: string;
+    } | undefined;
+    timeoutSec?: number | undefined;
+}, {
+    input: {
+        prompt: string;
+        text?: {
+            content: string;
+            font?: string | undefined;
+            role?: "label" | "headline" | "subhead" | "caption" | "cta" | undefined;
+        }[] | undefined;
+        seconds?: number | undefined;
+        seed?: number | undefined;
+        n?: number | undefined;
+        aspect?: "1:1" | "16:9" | "9:16" | "4:5" | undefined;
+        negativePrompt?: string | undefined;
+        imageUrls?: string[] | undefined;
+        allowText?: boolean | undefined;
+    };
+    place?: boolean | "contain" | "cover" | undefined;
+    model?: string | undefined;
+    useCase?: string | undefined;
+    brief?: string | undefined;
+    designRef?: {
+        id: string;
+        kind: string;
+    } | undefined;
+    timeoutSec?: number | undefined;
+}>;
+/** Injectable for tests: the network and the clock. */
+export declare const generateDeps: {
+    fetch: (url: string, init?: RequestInit) => Promise<Response>;
+    sleep: (ms: number) => Promise<void>;
+    now: () => number;
+};
+export declare const generateHandlers: Record<string, (args: Record<string, unknown>, options: HandlerOptions) => Promise<CallToolResult>>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/tools/handlers/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA6BlF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKyI,CAAC;AAEjL,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQkG,CAAC;AAElI,uDAAuD;AACvD,eAAO,MAAM,YAAY;iBACV,MAAM,SAAS,WAAW;gBAC3B,MAAM;;CAEnB,CAAC;AAoGF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CAqGhI,CAAC"}