@sync.so/mcp-server 0.1.4 → 0.2.0

package/dist/tools/generated-adapters.js

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+import { isImportInProgress, jobSettled, rawStatus } from './job-status.js';
+import { pollUntil, waitInput } from './job-wait.js';
+/**
+ * Agent-facing fixes for tools generated straight from the public OpenAPI spec. Each one
+ * keeps accepting the generated input, so callers holding the old tool list still work.
+ */
+// Tools whose project is the target itself: the caller names the project to read or
+// change, so the new-project intent guard (project-intent.ts) does not apply to them.
+export const projectTargetTools = new WeakSet();
+const PROJECT_PATH = /^\/v2\/projects\/\{id\}(?:\/|$)/;
+const IMPORT_RETRY_MS = 15_000;
+/** Every other tool calls the project `projectId`; generated project routes said `id`. */
+function withProjectIdAlias(tool) {
+    const { id, ...rest } = tool.inputSchema;
+    if (!id)
+        return tool;
+    const handler = tool.handler;
+    const adapted = {
+        ...tool,
+        inputSchema: {
+            projectId: z.string().optional().describe('Project ID (UUID).'),
+            ...rest,
+            id: z.string().optional().describe('Deprecated alias of projectId.'),
+        },
+        handler: async (args, context) => {
+            const { projectId, id: alias, ...fields } = args;
+            const project = projectId ?? alias;
+            if (project === undefined)
+                throw new Error('Pass projectId.');
+            if (alias !== undefined && projectId !== undefined && alias !== projectId)
+                throw new Error('projectId and id name different projects; pass projectId only.');
+            const result = await handler({ ...fields, id: project }, context);
+            if (result !== '')
+                return result;
+            // 204 responses: say what happened instead of an empty string.
+            return tool.name === 'projects_attach-asset'
+                ? { projectId: project, assetId: fields.assetId, attached: true }
+                : { projectId: project, ok: true };
+        },
+    };
+    projectTargetTools.add(adapted);
+    return adapted;
+}
+/** Transcription takes source URLs; every other workflow passes saved assets by id. */
+function withTranscriptionAsset(tool, http) {
+    const handler = tool.handler;
+    return {
+        ...tool,
+        description: `${tool.description} Pass assetId to transcribe a saved VIDEO or AUDIO asset instead of a source URL.`,
+        inputSchema: {
+            ...tool.inputSchema,
+            // An assetId replaces the source URL, so neither can stay required.
+            ...Object.fromEntries(['sourceVideoUrl', 'sourceAudioUrl']
+                .filter((key) => tool.inputSchema[key])
+                .map((key) => [key, tool.inputSchema[key].optional()])),
+            assetId: z
+                .uuid()
+                .optional()
+                .describe('Saved VIDEO or AUDIO asset to transcribe; replaces sourceVideoUrl/sourceAudioUrl.'),
+        },
+        handler: async (args, context) => {
+            const { assetId: rawAssetId, ...fields } = args;
+            const assetId = z.uuid().optional().parse(rawAssetId);
+            if (assetId === undefined)
+                return handler(fields, context);
+            if (fields.sourceVideoUrl !== undefined || fields.sourceAudioUrl !== undefined)
+                throw new Error('Pass assetId or a source URL, not both.');
+            const asset = z.object({ type: z.string(), url: z.string().min(1) }).parse(await http.request('get', `/v2/assets/${assetId}`, {
+                signal: context?.signal,
+            }));
+            if (asset.type !== 'VIDEO' && asset.type !== 'AUDIO')
+                throw new Error(`Asset ${assetId} is ${asset.type}; transcribe a VIDEO or AUDIO asset.`);
+            const source = asset.type === 'VIDEO' ? 'sourceVideoUrl' : 'sourceAudioUrl';
+            return handler({ ...fields, [source]: asset.url }, context);
+        },
+    };
+}
+function withJobWait(tool, label) {
+    const handler = tool.handler;
+    return {
+        ...tool,
+        description: `${tool.description} Pass wait: true to wait for the job on the server.`,
+        inputSchema: { ...tool.inputSchema, wait: waitInput },
+        handler: async ({ wait, ...args }, context) => {
+            const read = (signal = context?.signal) => handler(args, { ...context, signal });
+            if (wait !== true)
+                return read();
+            return pollUntil(read, jobSettled, context, {
+                describe: (job) => `${label} ${String(rawStatus(job) ?? 'pending').toLowerCase()}`,
+            });
+        },
+    };
+}
+export async function attemptImport(handler, args, context, signal = context?.signal) {
+    try {
+        return { asset: await handler(args, { ...context, signal }) };
+    }
+    catch (error) {
+        if (isImportInProgress(error))
+            return { pending: error };
+        throw error;
+    }
+}
+export const importWaitOptions = {
+    describe: (attempt) => {
+        const progress = 'pending' in attempt ? attempt.pending.importDetails?.progress : undefined;
+        return `importing${progress === undefined ? '' : ` ${progress}%`}`;
+    },
+    delayMs: (attempt) => 'pending' in attempt ? (attempt.pending.retryAfterMs ?? IMPORT_RETRY_MS) : undefined,
+};
+/** A social import answers 409 import_in_progress until the asset is saved. */
+function withImportWait(tool) {
+    const handler = tool.handler;
+    return {
+        ...tool,
+        description: `${tool.description} For a social link, pass wait: true to wait for the import on the server; a 409 import_in_progress then only means it is still downloading after about 50 seconds, so call again with the same input.`,
+        inputSchema: { ...tool.inputSchema, wait: waitInput },
+        handler: async ({ wait, ...args }, context) => {
+            if (wait !== true)
+                return handler(args, context);
+            const last = await pollUntil((signal) => attemptImport(handler, args, context, signal), (attempt) => 'asset' in attempt, context, importWaitOptions);
+            if ('pending' in last)
+                throw last.pending;
+            return last.asset;
+        },
+    };
+}
+export function adaptGeneratedTool(tool, operation, http) {
+    if (tool.resultFormat === 'mcp' || !operation)
+        return tool;
+    if (PROJECT_PATH.test(operation.path))
+        return withProjectIdAlias(tool);
+    if (operation.method === 'post' && operation.path === '/v2/transcriptions')
+        return withTranscriptionAsset(tool, http);
+    if (operation.method === 'get' && operation.path === '/v2/transcriptions/{id}')
+        return withJobWait(tool, 'transcription');
+    if (operation.method === 'get' && operation.path === '/v2/transcriptions/{id}/speaker-analysis')
+        return withJobWait(tool, 'speaker analysis');
+    if (operation.method === 'post' && operation.path === '/v2/assets')
+        return withImportWait(tool);
+    return tool;
+}

package/dist/tools/generation-context.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { HttpClient } from '../http-client.js';
+/** Optional for released clients: absence must preserve the original fingerprint. */
+export declare const generationContextSchema: z.ZodObject<{
+    workflow: z.ZodEnum<{
+        edit_dialogue: "edit_dialogue";
+        image_to_video: "image_to_video";
+        lipsync: "lipsync";
+        translate_and_dub: "translate_and_dub";
+    }>;
+    parentGenerationId: z.ZodUUID;
+}, z.core.$strict>;
+export declare function generationContextHeaders(http: HttpClient, args: Record<string, unknown>, workflows: readonly z.infer<typeof generationContextSchema>['workflow'][], signal?: AbortSignal): Promise<Record<string, string>>;
+//# sourceMappingURL=generation-context.d.ts.map

package/dist/tools/generation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-context.d.ts","sourceRoot":"","sources":["../../src/tools/generation-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qFAAqF;AACrF,eAAO,MAAM,uBAAuB;;;;;;;;kBAKzB,CAAC;AAEZ,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC,UAAU,CAAC,EAAE,EACzE,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA8BjC"}

package/dist/tools/generation-context.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/** Optional for released clients: absence must preserve the original fingerprint. */
+export const generationContextSchema = z
+    .object({
+    workflow: z.enum(['lipsync', 'translate_and_dub', 'image_to_video', 'edit_dialogue']),
+    parentGenerationId: z.uuid(),
+})
+    .strict();
+export async function generationContextHeaders(http, args, workflows, signal) {
+    if (args.continuation === undefined)
+        return {};
+    const context = generationContextSchema.parse(args.continuation);
+    const projectId = z.uuid().parse(args.projectId);
+    if (!workflows.includes(context.workflow))
+        throw new Error('The continuation workflow does not match this action.');
+    // Authorize the lineage headers without reading the parent's media/settings.
+    // Unrelated deleted sources must not block the API's same-key replay. The API
+    // authorizes the submitted inputs on new admission; continuation reads still
+    // check source access before returning media to the embedded view.
+    const project = z
+        .object({ id: z.uuid() })
+        .parse(await http.request('get', `/v2/projects/${projectId}`, { signal }));
+    if (project.id !== projectId)
+        throw new Error('Could not verify project access.');
+    const page = z
+        .object({ items: z.array(z.object({ id: z.uuid(), projectId: z.uuid() })).length(1) })
+        .parse(await http.request('get', '/v2/generations/list', {
+        query: { projectId, ids: context.parentGenerationId, limit: '1' },
+        signal,
+    }));
+    const parent = page.items[0];
+    if (parent.id !== context.parentGenerationId || parent.projectId !== projectId)
+        throw new Error('The generation does not belong to this project.');
+    signal?.throwIfAborted();
+    return {
+        'x-sync-workflow': context.workflow,
+        'x-sync-parent-generation-id': context.parentGenerationId,
+    };
+}

package/dist/tools/generation-continuation.d.ts

@@ -0,0 +1,4 @@
+import type { HttpClient } from '../http-client.js';
+import type { McpToolDefinition } from './generator.js';
+export declare function createGenerationContinuationTool(http: HttpClient): McpToolDefinition;
+//# sourceMappingURL=generation-continuation.d.ts.map

package/dist/tools/generation-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-continuation.d.ts","sourceRoot":"","sources":["../../src/tools/generation-continuation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwFxD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CA4CpF"}

package/dist/tools/generation-continuation.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { modelOptionsSchema } from './model-options.js';
+// Narrow projection of Studio's InternalGenerationSchema. Provider state and
+// arbitrary generation metadata never cross the embedded-app boundary.
+const mediaUrl = z.url({ protocol: /^https?$/ });
+const face = modelOptionsSchema.shape.active_speaker_detection
+    .unwrap()
+    .options[1].strip()
+    .extend({
+    frame_number: z.number().finite().optional(),
+    bounding_boxes: z.array(z.array(z.number().finite()).nullable()).optional(),
+    bounding_boxes_url: mediaUrl.optional(),
+});
+const options = modelOptionsSchema.strip().extend({
+    active_speaker_detection: z.union([z.boolean(), face]).optional(),
+    model_mode: z.string().optional(),
+});
+const audioRange = z.object({
+    refId: z.string(),
+    startTime: z.number().finite().optional(),
+    endTime: z.number().finite().optional(),
+});
+const generation = z.object({
+    id: z.uuid(),
+    projectId: z.uuid(),
+    status: z.enum(['PENDING', 'PROCESSING', 'COMPLETED', 'FAILED', 'REJECTED']),
+    workflow: z
+        .enum([
+        'lipsync',
+        'translate_and_dub',
+        'image_to_video',
+        'edit_dialogue',
+        'change_appearance',
+        'timeline',
+        'assistant',
+    ])
+        .nullish(),
+    modelName: z.string().min(1),
+    options,
+    inputs: z.array(z.object({
+        type: z.enum(['video', 'image', 'audio', 'text']),
+        assetId: z.uuid().optional(),
+        url: mediaUrl.optional(),
+        refId: z.string().optional(),
+        generatedBy: z.literal('tts').optional(),
+        provider: z
+            .object({
+            name: z.string(),
+            script: z.string(),
+            voiceId: z.string(),
+            stability: z.number().min(0).max(1).optional(),
+            similarityBoost: z.number().min(0).max(1).optional(),
+        })
+            .optional(),
+        trim_secs: z.array(z.number().finite()).optional(),
+        segments_secs: z.array(z.array(z.number().finite())).optional(),
+        segments_frames: z.array(z.array(z.number().finite())).optional(),
+    })),
+    segments: z
+        .array(z.object({
+        startTime: z.number().finite().optional(),
+        endTime: z.number().finite().optional(),
+        startFrame: z.number().finite().optional(),
+        endFrame: z.number().finite().optional(),
+        audioInput: audioRange.optional(),
+        optionsOverride: options.optional(),
+    }))
+        .nullish(),
+    speakers: z
+        .array(z.object({
+        id: z.string(),
+        audio: audioRange,
+        face: face.omit({ auto_detect: true }),
+    }))
+        .nullish(),
+    outputMediaUrl: mediaUrl.nullish(),
+    parentGenerationId: z.uuid().nullish(),
+    dialogueEditJobId: z.uuid().nullish(),
+    renderedFromAssetId: z.uuid().nullish(),
+});
+export function createGenerationContinuationTool(http) {
+    const input = z.object({ projectId: z.uuid(), id: z.uuid() }).strict();
+    return {
+        name: 'generations_get-continuation',
+        title: 'Read generation continuation inputs',
+        description: 'Read one accessible generation and its original inputs through the same Studio API. Rechecks project and referenced asset access. Does not create a draft, asset, transcription, preview or generation. Use the shared Studio continuation policy to choose source versus completed output.',
+        inputSchema: input.shape,
+        outputSchema: { submissionContextVersion: z.literal(1), generation },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: async (args, context) => {
+            const { projectId, id } = input.parse(args);
+            const signal = context?.signal;
+            const project = z
+                .object({ id: z.uuid() })
+                .parse(await http.request('get', `/v2/projects/${projectId}`, { signal }));
+            if (project.id !== projectId)
+                throw new Error('Could not verify project access.');
+            const page = z.object({ items: generation.array().length(1) }).parse(await http.request('get', '/v2/generations/list', {
+                query: { projectId, ids: id, limit: '1' },
+                signal,
+            }));
+            const selected = page.items[0];
+            if (selected.id !== id || selected.projectId !== projectId)
+                throw new Error('The generation does not belong to this project.');
+            for (const assetId of new Set([
+                ...selected.inputs.flatMap((item) => (item.assetId ? [item.assetId] : [])),
+                ...(selected.renderedFromAssetId ? [selected.renderedFromAssetId] : []),
+            ])) {
+                signal?.throwIfAborted();
+                const asset = z
+                    .object({ id: z.uuid() })
+                    .parse(await http.request('get', `/v2/assets/${assetId}`, { signal }));
+                if (asset.id !== assetId)
+                    throw new Error('Could not verify source asset access.');
+            }
+            return { submissionContextVersion: 1, generation: selected };
+        },
+    };
+}

package/dist/tools/generation-costs.d.ts

@@ -0,0 +1,6 @@
+import type { HttpClient } from '../http-client.js';
+import type { ParsedOperation } from '../openapi/types.js';
+import type { McpToolDefinition } from './generator.js';
+export declare function generationCostsOperation(operation: ParsedOperation): boolean;
+export declare function createGenerationCostsTools(operations: ParsedOperation[], http: HttpClient): McpToolDefinition[];
+//# sourceMappingURL=generation-costs.d.ts.map

package/dist/tools/generation-costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-costs.d.ts","sourceRoot":"","sources":["../../src/tools/generation-costs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAmCxD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAM5E;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,EAAE,EAC7B,IAAI,EAAE,UAAU,GACf,iBAAiB,EAAE,CA8BrB"}

package/dist/tools/generation-costs.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+const money = z.string().regex(/^\d+\.\d{5}$/);
+const component = z.object({
+    type: z.enum(['lipsync', 'dubbing', 'speech_synthesis']),
+    operationId: z.uuid().nullable(),
+    status: z.enum(['recorded', 'pending', 'unavailable', 'not_charged']),
+    amountUsd: money.nullable(),
+    credits: z.string().regex(/^\d+$/).nullable(),
+    valueBasis: z.enum(['credit_face_value', 'metered_usage', 'none']).nullable(),
+    quantity: z.number().nonnegative().nullable(),
+    unit: z.enum(['frames', 'seconds']),
+    unitRateUsd: money.nullable(),
+    source: z.enum(['credit_ledger', 'recorded_usage', 'billing_context']).nullable(),
+    reason: z.string().nullable(),
+});
+const receipt = z.object({
+    generationId: z.uuid(),
+    generationStatus: z.string(),
+    currency: z.literal('USD'),
+    availability: z.enum(['complete', 'pending', 'partial', 'unavailable']),
+    totalCostUsd: money.nullable(),
+    knownSubtotalUsd: money,
+    retryAfterSeconds: z.number().int().positive().nullable(),
+    components: z.array(component),
+    excludedCosts: z.array(z.string()),
+});
+const input = z
+    .object({
+    generationId: z
+        .uuid()
+        .describe('Existing Sync generation ID returned by generation creation or history tools.'),
+})
+    .strict();
+export function generationCostsOperation(operation) {
+    return (operation.operationId === 'GenerateController_getGenerationCosts' &&
+        operation.method === 'get' &&
+        operation.path === '/v2/generate/{id}/costs');
+}
+export function createGenerationCostsTools(operations, http) {
+    if (!operations.some(generationCostsOperation))
+        return [];
+    return [
+        {
+            name: 'generations_get-costs',
+            title: 'View actual generation costs',
+            description: 'Read recorded costs for a past Sync generation, with dubbing and lip sync listed separately. Use for what a generation actually cost, not a preflight estimate. Credit amounts express credit face value, not a card payment. Pending or unavailable components have no known total. Does not generate media or change billing.',
+            inputSchema: input.shape,
+            outputSchema: receipt.shape,
+            annotations: {
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+            meta: { ui: { visibility: ['model', 'app'] }, 'openai/widgetAccessible': true },
+            handler: async (args, context) => {
+                const { generationId } = input.parse(args);
+                const result = receipt.parse(await http.request('get', `/v2/generate/${generationId}/costs`, {
+                    signal: context?.signal,
+                }));
+                if (result.generationId.toLowerCase() !== generationId.toLowerCase())
+                    throw new Error('Sync returned costs for a different generation.');
+                return result;
+            },
+        },
+    ];
+}

package/dist/tools/generation-output.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from './generator.js';
+export declare function withGenerationOutputAliases(tool: McpToolDefinition): McpToolDefinition;
+//# sourceMappingURL=generation-output.d.ts.map

package/dist/tools/generation-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-output.d.ts","sourceRoot":"","sources":["../../src/tools/generation-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA8BxD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAgBtF"}

package/dist/tools/generation-output.js

@@ -0,0 +1,39 @@
+const RESULT_URL = ['outputMediaUrl', 'outputUrl'];
+const DURATION = ['outputMediaLength', 'outputDuration'];
+// Raw generation lists from GET /v2/generations, without an output schema.
+const GENERATION_LIST_TOOLS = new Set(['generations_list', 'projects_list-generations']);
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function withAliases(value, aliases = [RESULT_URL]) {
+    if (!isRecord(value))
+        return value;
+    const result = { ...value };
+    for (const [apiName, legacyName] of aliases) {
+        if (!(apiName in value) && !(legacyName in value))
+            continue;
+        const field = apiName in value ? value[apiName] : value[legacyName];
+        result[apiName] = field;
+        result[legacyName] = field;
+    }
+    return result;
+}
+export function withGenerationOutputAliases(tool) {
+    if (tool.resultFormat === 'mcp')
+        return tool;
+    const schema = tool.outputSchema;
+    const list = GENERATION_LIST_TOOLS.has(tool.name);
+    if (!list && !(schema && 'outputMediaUrl' in schema && 'outputUrl' in schema))
+        return tool;
+    const aliases = schema && 'outputMediaLength' in schema ? [RESULT_URL, DURATION] : [RESULT_URL];
+    const handler = tool.handler;
+    return {
+        ...tool,
+        handler: async (args, context) => {
+            const result = await handler(args, context);
+            return list && Array.isArray(result)
+                ? result.map((item) => withAliases(item))
+                : withAliases(result, aliases);
+        },
+    };
+}

package/dist/tools/generator.d.ts

@@ -1,12 +1,45 @@
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/server';
 import { z } from 'zod';
+import type { ClientProfile } from '../client-profile.js';
 import type { HttpClient } from '../http-client.js';
 import type { ParsedOperation } from '../openapi/types.js';
-export type McpToolDefinition = {
+type McpToolBaseDefinition = {
     name: string;
+    title?: string;
     description: string;
     inputSchema: Record<string, z.ZodType>;
-    handler: (args: Record<string, unknown>) => Promise<unknown>;
+    outputSchema?: Record<string, z.ZodType>;
+    annotations?: ToolAnnotations;
+    meta?: Record<string, unknown>;
 };
+export type ToolRequestContext = {
+    _meta?: Record<string, unknown>;
+    signal?: AbortSignal;
+    clientProfile?: ClientProfile;
+    clientName?: string;
+    progress?: (progress: number, message?: string) => Promise<void>;
+    toolListChanged?: () => void;
+};
+type JsonMcpToolDefinition = McpToolBaseDefinition & {
+    resultFormat?: 'json';
+    handler: (args: Record<string, unknown>, context?: ToolRequestContext) => Promise<unknown>;
+};
+type RawMcpToolDefinition = McpToolBaseDefinition & {
+    resultFormat: 'mcp';
+    handler: (args: Record<string, unknown>, context?: ToolRequestContext) => Promise<CallToolResult>;
+};
+export type McpToolDefinition = JsonMcpToolDefinition | RawMcpToolDefinition;
 export declare function generateTools(operations: ParsedOperation[], httpClient: HttpClient): McpToolDefinition[];
+/**
+ * Behaviour hints required by the ChatGPT and Claude app/connector directories
+ * (missing/incorrect annotations are a top review-rejection cause). Derived
+ * from the HTTP verb: reads are read-only; writes modify external Sync state,
+ * so they are destructive and open-world.
+ */
+export declare function deriveAnnotations(method: string, toolName?: string): ToolAnnotations;
+/** "AssetsController_getAll" → "assets_get-all", the name before tool-names.ts renames it. */
+export declare function derivedToolName(operationId: string): string;
+/** "AssetsController_getAll" → "assets_list". */
 export declare function operationIdToToolName(operationId: string): string;
+export {};
 //# sourceMappingURL=generator.d.ts.map

package/dist/tools/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/tools/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,UAAU,EAAE,eAAe,EAAE,EAC7B,UAAU,EAAE,UAAU,GACrB,iBAAiB,EAAE,CAErB;AAuBD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQjE"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/tools/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKvE,KAAK,qBAAqB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,eAAe,CAAC;IAG9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,qBAAqB,GAAG,qBAAqB,GAAG;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5F,CAAC;AAEF,KAAK,oBAAoB,GAAG,qBAAqB,GAAG;IAClD,YAAY,EAAE,KAAK,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnG,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AA4B7E,wBAAgB,aAAa,CAC3B,UAAU,EAAE,eAAe,EAAE,EAC7B,UAAU,EAAE,UAAU,GACrB,iBAAiB,EAAE,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAYpF;AA6FD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE"}