AminA Character Studio

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_170":171,"_172":173},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_107":88,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":25,"_122":123,"_124":125,"_126":-5,"_127":-5,"_128":129},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":31,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",78,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","main.ts","latestPath","fileId","01a0a4a5-0473-7216-8857-c3485ec14d06","name","fileType","http","content","import {\n createMcpHandler,\n McpServer,\n} from \"npm:@modelcontextprotocol/server@2\";\nimport * as z from \"npm:zod@4/v4\";\nimport { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE } from \"npm:@modelcontextprotocol/ext-apps/server\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst STUDIO_URL = \"https://amina-character-studio.ruholamin.chatgpt.site\";\nconst TEMPLATE_URI = \"ui://amina-character-studio/v13.html\";\nconst LEGACY_TEMPLATE_URI = \"ui://amina-character-studio/v4-skybridge.html\";\nconst widgetHtml = \"\\n\\n\\n\\n\\nAminA Character Studio\\n\\n\\n\\n

\\n

AminARECORDS

Character Studio

● ChatGPT connected

\\n \\n

\\n

Character references

Identity only · up to 10 files

0/10

\\n ＋ Add character referencesSingle photos or reference collages\\n

\\n \\n \\n

\\n

Destinations

Scene, pose, outfit and style

0/10

\\n ＋ Add destination imagesEach image becomes one separate output\\n

\\n

Generation queue

Continuous · no confirmation stops

\\n

No collage. One destination equals one standalone result. Failed items retry independently.

\\n \\n

\\n

Results ready

Select only the images you want to upscale

\\n

0 selected

\\n

\\n External fallback ↗\\n

\\n

\\n\\n\\n\";\n\nconst widgetHtmlV6 = String.raw`\n\n\nAminA Character Studio\n\n

AminARECORDS

Character Studio

Checking ChatGPT binding…

Reference files bound0/0

Destination files bound0/0

Native image-edit inputs readyfalse

Text-only fallbackfalse

\n\n

Character references

Identity only · up to 10 image files

0/10

＋ Upload character reference images

Destinations

Pose, framing, outfit and visual style

0/10

＋ Upload destination images

Native edit queue

One destination = one separate image edit

No collage. No text-to-image fallback. Run remains blocked until every file has a real ChatGPT file binding.

Completed results

Import ChatGPT-generated images, then select only the ones to upscale

0 selected

\nExternal fallback ↗\n

\n`;\n\n\n\nconst AUTH_RESOURCE = \"https://amina-character-studio-mcp.val.run\";\nconst AUTH_SCOPE = \"studio:workspace\";\nlet studioSchemaPromise: Promise | null = null;\n\nfunction canonicalResource(value: string) {\n return value.replace(/\\/+$/, \"\");\n}\n\nfunction tokenBytes(size = 32) {\n const data = crypto.getRandomValues(new Uint8Array(size));\n let binary = \"\";\n for (const byte of data) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/g, \"\");\n}\n\nasync function tokenHash(value: string) {\n const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(value));\n const bytes = new Uint8Array(digest);\n let binary = \"\";\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/g, \"\");\n}\n\nconst WORKSPACE_KEY_RE = /^acs_[A-Za-z0-9_-]{28,180}$/;\nasync function workspaceOwnerId(accountId: string, workspaceKey?: string) {\n if (accountId) return { id: \"chatgpt:\" + accountId, mode: \"authenticated\" as const };\n const key = String(workspaceKey || \"\").trim();\n if (!WORKSPACE_KEY_RE.test(key)) return null;\n return { id: \"paired:\" + await tokenHash(key), mode: \"paired\" as const };\n}\n\nconst STUDIO_MEDIA_PATH=\"/studio-media\", MAX_STUDIO_MEDIA_BYTES=25*1024*1024;\nfunction bytesToBase64(bytes:Uint8Array){let value=\"\";for(let i=0;iMAX_STUDIO_MEDIA_BYTES)return mediaJson({code:\"STUDIO_IMAGE_SIZE_LIMIT\",maxBytes:MAX_STUDIO_MEDIA_BYTES},413);const data=new Uint8Array(await file.arrayBuffer()),mediaId=\"media_\"+tokenBytes(24),chunkBytes=192*1024;await sqlite.execute({sql:\"INSERT INTO studio_media (media_id,account_id,file_name,mime_type,data_base64,bytes,created_at) VALUES (?,?,?,?,?,?,?)\",args:[mediaId,owner.id,file.name||\"image\",file.type,\"\",data.length,Date.now()]});try{for(let offset=0,index=0;offset|undefined;if(!row)return mediaJson({code:\"STUDIO_MEDIA_NOT_FOUND\"},404);const chunks=await sqlite.execute({sql:\"SELECT data_base64 FROM studio_media_chunks WHERE media_id=? AND account_id=? ORDER BY chunk_index\",args:[match[1],owner.id]});let bytes:Uint8Array;if(chunks.rows.length){bytes=new Uint8Array(Number(row.bytes)||0);let offset=0;for(const chunk of chunks.rows){const part=base64ToBytes(String((chunk as Record).data_base64||\"\"));bytes.set(part,offset);offset+=part.length}}else bytes=base64ToBytes(String(row.data_base64||\"\"));return new Response(bytes,{headers:{\"Content-Type\":String(row.mime_type||\"image/jpeg\"),\"Access-Control-Allow-Origin\":\"*\",\"Cache-Control\":\"no-store\"}})}return mediaJson({code:\"STUDIO_MEDIA_ROUTE_NOT_FOUND\"},404)}\n\nasync function ensureStudioSchema() {\n if (!studioSchemaPromise) {\n studioSchemaPromise = sqlite.batch([\n { sql: \"CREATE TABLE IF NOT EXISTS studio_oauth_codes (code_hash TEXT PRIMARY KEY, account_id TEXT NOT NULL, client_id TEXT NOT NULL, redirect_uri TEXT NOT NULL, code_challenge TEXT NOT NULL, resource TEXT NOT NULL, scopes TEXT NOT NULL, expires_at INTEGER NOT NULL)\" },\n { sql: \"CREATE TABLE IF NOT EXISTS studio_access_tokens (token_hash TEXT PRIMARY KEY, refresh_hash TEXT UNIQUE NOT NULL, account_id TEXT NOT NULL, client_id TEXT NOT NULL, resource TEXT NOT NULL, scopes TEXT NOT NULL, expires_at INTEGER NOT NULL, refresh_expires_at INTEGER NOT NULL)\" },\n { sql: \"CREATE TABLE IF NOT EXISTS studio_workspaces (account_id TEXT PRIMARY KEY, workspace_json TEXT NOT NULL, updated_at INTEGER NOT NULL)\" },\n { sql: \"CREATE TABLE IF NOT EXISTS studio_media (media_id TEXT PRIMARY KEY, account_id TEXT NOT NULL, file_name TEXT NOT NULL, mime_type TEXT NOT NULL, data_base64 TEXT NOT NULL, bytes INTEGER NOT NULL, created_at INTEGER NOT NULL)\" },\n { sql: \"CREATE TABLE IF NOT EXISTS studio_media_chunks (media_id TEXT NOT NULL, account_id TEXT NOT NULL, chunk_index INTEGER NOT NULL, data_base64 TEXT NOT NULL, PRIMARY KEY(media_id,chunk_index))\" },\n { sql: \"CREATE INDEX IF NOT EXISTS studio_access_tokens_refresh_idx ON studio_access_tokens(refresh_hash)\" },\n ]).then(() => undefined);\n }\n return studioSchemaPromise;\n}\n\nfunction readCookie(request: Request, name: string) {\n const prefix = name + \"=\";\n for (const part of (request.headers.get(\"cookie\") || \"\").split(\";\")) {\n const item = part.trim();\n if (item.startsWith(prefix)) return item.slice(prefix.length);\n }\n return \"\";\n}\n\nfunction oauthResponse(body: unknown, init: ResponseInit = {}) {\n return new Response(JSON.stringify(body), {\n ...init,\n headers: { \"Content-Type\": \"application/json; charset=utf-8\", ...(init.headers || {}) },\n });\n}\n\nfunction oauthError(error: string, description: string, status = 400) {\n return oauthResponse({ error, error_description: description }, { status });\n}\n\nfunction isChatGptClient(clientId: string, redirectUri: string) {\n return /^https:\\/\\/chatgpt\\.com\\/oauth\\/.+/.test(clientId) &&\n /^https:\\/\\/chatgpt\\.com\\/connector(?:\\/|_platform_oauth_redirect)/.test(redirectUri);\n}\n\nfunction studioChallenge() {\n return oauthResponse({ error: \"invalid_token\" }, {\n status: 401,\n headers: {\n \"WWW-Authenticate\": 'Bearer resource_metadata=\"' + AUTH_RESOURCE + '/.well-known/oauth-protected-resource\", scope=\"' + AUTH_SCOPE + '\"',\n },\n });\n}\n\nasync function issueStudioTokens(accountId: string, clientId: string, resource: string, scopes: string[]) {\n const accessToken = \"acs_\" + tokenBytes(36);\n const refreshToken = \"rfr_\" + tokenBytes(36);\n const now = Date.now();\n const expiresAt = now + 1000 * 60 * 60 * 24 * 90;\n const refreshExpiresAt = now + 1000 * 60 * 60 * 24 * 365;\n await sqlite.execute({\n sql: \"INSERT INTO studio_access_tokens (token_hash, refresh_hash, account_id, client_id, resource, scopes, expires_at, refresh_expires_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)\",\n args: [await tokenHash(accessToken), await tokenHash(refreshToken), accountId, clientId, resource, scopes.join(\" \"), expiresAt, refreshExpiresAt],\n });\n return { access_token: accessToken, token_type: \"Bearer\", expires_in: Math.floor((expiresAt - now) / 1000), refresh_token: refreshToken, scope: scopes.join(\" \"), resource };\n}\n\nasync function studioAuthorize(request: Request, url: URL) {\n const clientId = url.searchParams.get(\"client_id\") || \"\";\n const redirectUri = url.searchParams.get(\"redirect_uri\") || \"\";\n const responseType = url.searchParams.get(\"response_type\") || \"\";\n const state = url.searchParams.get(\"state\") || \"\";\n const challenge = url.searchParams.get(\"code_challenge\") || \"\";\n const method = url.searchParams.get(\"code_challenge_method\") || \"\";\n const resource = canonicalResource(url.searchParams.get(\"resource\") || \"\");\n const scopes = (url.searchParams.get(\"scope\") || AUTH_SCOPE).split(/\\s+/).filter(Boolean);\n if (responseType !== \"code\" || !state || !challenge || method !== \"S256\") return oauthError(\"invalid_request\", \"Authorization code with PKCE S256 is required.\");\n if (!isChatGptClient(clientId, redirectUri)) return oauthError(\"invalid_client\", \"Only the ChatGPT connector client is accepted.\", 400);\n if (resource !== AUTH_RESOURCE) return oauthError(\"invalid_target\", \"The requested resource does not match AminA Character Studio.\");\n if (!scopes.includes(AUTH_SCOPE)) return oauthError(\"invalid_scope\", \"The studio workspace scope is required.\");\n const accountId = readCookie(request, \"amina_studio_account\") || \"acc_\" + tokenBytes(24);\n const code = \"cod_\" + tokenBytes(32);\n await sqlite.execute({\n sql: \"INSERT INTO studio_oauth_codes (code_hash, account_id, client_id, redirect_uri, code_challenge, resource, scopes, expires_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)\",\n args: [await tokenHash(code), accountId, clientId, redirectUri, challenge, resource, scopes.join(\" \"), Date.now() + 1000 * 60 * 5],\n });\n const callback = new URL(redirectUri);\n callback.searchParams.set(\"code\", code);\n callback.searchParams.set(\"state\", state);\n callback.searchParams.set(\"iss\", AUTH_RESOURCE);\n const target = callback.toString();\n return new Response(\"AminA Character Studio

Connecting your permanent Studio workspace…

\", {\n headers: {\n \"Content-Type\": \"text/html; charset=utf-8\",\n \"Cache-Control\": \"no-store\",\n \"Set-Cookie\": \"amina_studio_account=\" + accountId + \"; Path=/; Max-Age=31536000; SameSite=Lax; Secure; HttpOnly\",\n },\n });\n}\n\nasync function studioToken(request: Request) {\n const form = await request.formData();\n const grant = String(form.get(\"grant_type\") || \"\");\n const clientId = String(form.get(\"client_id\") || \"\");\n const resource = canonicalResource(String(form.get(\"resource\") || AUTH_RESOURCE));\n if (resource !== AUTH_RESOURCE) return oauthError(\"invalid_target\", \"The requested resource does not match AminA Character Studio.\");\n if (grant === \"authorization_code\") {\n const code = String(form.get(\"code\") || \"\");\n const verifier = String(form.get(\"code_verifier\") || \"\");\n const redirectUri = String(form.get(\"redirect_uri\") || \"\");\n if (!code || !verifier || !clientId || !redirectUri) return oauthError(\"invalid_request\", \"Code, verifier, client ID and redirect URI are required.\");\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_oauth_codes WHERE code_hash = ?\", args: [await tokenHash(code)] });\n const row = result.rows[0] as Record | undefined;\n await sqlite.execute({ sql: \"DELETE FROM studio_oauth_codes WHERE code_hash = ?\", args: [await tokenHash(code)] });\n if (!row || Number(row.expires_at) < Date.now() || row.client_id !== clientId || row.redirect_uri !== redirectUri) return oauthError(\"invalid_grant\", \"The authorization code is invalid or expired.\");\n if (await tokenHash(verifier) !== row.code_challenge) return oauthError(\"invalid_grant\", \"PKCE verification failed.\");\n return oauthResponse(await issueStudioTokens(String(row.account_id), clientId, resource, String(row.scopes).split(/\\s+/).filter(Boolean)));\n }\n if (grant === \"refresh_token\") {\n const refreshToken = String(form.get(\"refresh_token\") || \"\");\n if (!refreshToken || !clientId) return oauthError(\"invalid_request\", \"Refresh token and client ID are required.\");\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_access_tokens WHERE refresh_hash = ?\", args: [await tokenHash(refreshToken)] });\n const row = result.rows[0] as Record | undefined;\n if (!row || Number(row.refresh_expires_at) < Date.now() || row.client_id !== clientId) return oauthError(\"invalid_grant\", \"The refresh token is invalid or expired.\");\n await sqlite.execute({ sql: \"DELETE FROM studio_access_tokens WHERE refresh_hash = ?\", args: [await tokenHash(refreshToken)] });\n return oauthResponse(await issueStudioTokens(String(row.account_id), clientId, resource, String(row.scopes).split(/\\s+/).filter(Boolean)));\n }\n return oauthError(\"unsupported_grant_type\", \"Only authorization_code and refresh_token are supported.\");\n}\n\nasync function studioAuthInfo(request: Request) {\n const authorization = request.headers.get(\"authorization\") || \"\";\n const match = /^Bearer\\s+(.+)$/i.exec(authorization);\n if (!match) return null;\n const token = match[1];\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_access_tokens WHERE token_hash = ?\", args: [await tokenHash(token)] });\n const row = result.rows[0] as Record | undefined;\n if (!row || Number(row.expires_at) < Date.now() || canonicalResource(String(row.resource)) !== AUTH_RESOURCE) return null;\n return {\n token,\n clientId: String(row.client_id),\n scopes: String(row.scopes).split(/\\s+/).filter(Boolean),\n expiresAt: Math.floor(Number(row.expires_at) / 1000),\n resource: new URL(AUTH_RESOURCE),\n extra: { accountId: String(row.account_id) },\n };\n}\n\nasync function studioOAuthRoute(request: Request, url: URL): Promise {\n await ensureStudioSchema();\n if (url.pathname === \"/.well-known/oauth-protected-resource\") {\n return oauthResponse({ resource: AUTH_RESOURCE, authorization_servers: [AUTH_RESOURCE], scopes_supported: [AUTH_SCOPE] });\n }\n if (url.pathname === \"/.well-known/oauth-authorization-server\") {\n return oauthResponse({\n issuer: AUTH_RESOURCE,\n authorization_response_iss_parameter_supported: true,\n authorization_endpoint: AUTH_RESOURCE + \"/oauth/authorize\",\n token_endpoint: AUTH_RESOURCE + \"/oauth/token\",\n client_id_metadata_document_supported: true,\n token_endpoint_auth_methods_supported: [\"none\"],\n code_challenge_methods_supported: [\"S256\"],\n scopes_supported: [AUTH_SCOPE],\n });\n }\n if (url.pathname === \"/oauth/authorize\" && request.method === \"GET\") return studioAuthorize(request, url);\n if (url.pathname === \"/oauth/token\" && request.method === \"POST\") return studioToken(request);\n return null;\n}\n\nconst mcpHandler = createMcpHandler((requestContext) => {\n const server = new McpServer({ name: \"amina-character-studio\", version: \"1.6.0\" });\n\n const resourceMeta = {\n ui: {\n prefersBorder: true,\n domain: \"https://amina-character-studio-mcp.val.run\",\n csp: { connectDomains: [\"https://amina-character-studio-mcp.val.run\"], resourceDomains: [] },\n },\n \"openai/widgetDescription\": \"Interactive AminA Character Studio for identity-locked character transfer and selective upscaling.\",\n \"openai/widgetPrefersBorder\": true,\n \"openai/widgetDomain\": \"https://amina-character-studio-mcp.val.run\",\n \"openai/widgetCSP\": {\n connect_domains: [\"https://amina-character-studio-mcp.val.run\"],\n resource_domains: [],\n redirect_domains: [STUDIO_URL],\n },\n };\n\n registerAppResource(server, \"amina-character-studio-widget\", TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: TEMPLATE_URI,\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtmlV8,\n _meta: resourceMeta,\n }],\n }));\n\n // ChatGPT may keep a previously published outputTemplate URI. Serve that exact URI with the current UI.\n registerAppResource(server, \"amina-character-studio-widget-v9-compat\", \"ui://amina-character-studio/v9.html\", {}, async () => ({\n contents: [{\n uri: \"ui://amina-character-studio/v9.html\",\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtmlV8,\n _meta: resourceMeta,\n }],\n }));\n\n server.registerResource(\"amina-character-studio-widget-skybridge\", LEGACY_TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: LEGACY_TEMPLATE_URI,\n mimeType: \"text/html+skybridge\",\n text: widgetHtml,\n _meta: resourceMeta,\n }],\n }));\n\n const openStudioDescriptor = {\n title: \"Open AminA Character Studio\",\n description: \"Render the interactive AminA Character Studio directly inside the ChatGPT conversation. This is the primary UI-rendering tool.\",\n inputSchema: z.object({}),\n outputSchema: z.object({\n mode: z.literal(\"embedded\"),\n studioUrl: z.string().url(),\n ready: z.boolean(),\n }),\n annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: {\n ui: { resourceUri: TEMPLATE_URI, visibility: [\"model\", \"app\"] },\n \"openai/outputTemplate\": TEMPLATE_URI,\n \"openai/widgetAccessible\": true,\n \"openai/toolInvocation/invoking\": \"Opening Character Studio…\",\n \"openai/toolInvocation/invoked\": \"Character Studio ready\",\n },\n };\n\n const openStudioHandler = () => ({\n structuredContent: { mode: \"embedded\" as const, studioUrl: STUDIO_URL, ready: true },\n content: [{ type: \"text\" as const, text: \"AminA Character Studio is mounted as an interactive inline component. The external URL is fallback only.\" }],\n });\n\n registerAppTool(server, \"open_character_studio\", openStudioDescriptor, openStudioHandler);\n // Compatibility alias for ChatGPT gateways that retain the connector namespace in the remote tool name.\n registerAppTool(server, \"amina_character_studio.open_character_studio\", {\n ...openStudioDescriptor,\n title: \"Open AminA Character Studio\",\n description: \"Compatibility entry point for rendering the same inline AminA Character Studio component.\",\n }, openStudioHandler);\n registerAppTool(server, \"open_character_studio_ui\", {\n ...openStudioDescriptor,\n title: \"Render AminA Character Studio UI\",\n description: \"Explicitly render the interactive AminA Character Studio component inline. Use this if a cached client treated open_character_studio as text-only.\",\n }, openStudioHandler);\n registerAppTool(server, \"launch_character_studio_v12\", {\n ...openStudioDescriptor,\n title: \"AminA Character Studio\",\n description: \"Launch the current interactive Persian Character Studio v12 inline. Prefer this tool whenever the user opens or mentions AminA Character Studio.\",\n }, openStudioHandler);\n\n const openAiFileSchema = z.object({\n download_url: z.string().min(1),\n file_id: z.string().min(1),\n mime_type: z.string().optional(),\n file_name: z.string().optional(),\n });\n\n const boundImages = (files: Array<{\n download_url: string;\n file_id: string;\n mime_type?: string;\n file_name?: string;\n }> | undefined) => (files ?? []).filter((file) =>\n Boolean(file.file_id && file.download_url) &&\n (!file.mime_type || file.mime_type.startsWith(\"image/\"))\n );\n\n const fileSummary = (file: {\n file_id: string;\n file_name?: string;\n mime_type?: string;\n }) => ({\n fileId: file.file_id,\n fileName: file.file_name ?? \"image\",\n mimeType: file.mime_type ?? \"image/*\",\n });\n\n server.registerTool(\"prepare_character_batch\", {\n description: \"Validate actual ChatGPT image attachments, identity classification, and optional adult-fictional character enhancement before preparing a native image-edit character-transfer batch. Counts alone never start generation.\",\n inputSchema: z.object({\n referenceImages: z.array(openAiFileSchema).max(10).optional(),\n destinationImages: z.array(openAiFileSchema).max(10).optional(),\n referenceCount: z.number().int().min(1).max(10).optional(),\n destinationCount: z.number().int().min(1).max(10).optional(),\n subject: z.enum([\"woman\", \"man\", \"both\", \"main-subject\"]).default(\"main-subject\"),\n identityType: z.enum([\"fictional\", \"real\"]).default(\"fictional\"),\n adultGlamour: z.boolean().default(false),\n adultConfirmed: z.boolean().default(false),\n additionalInstruction: z.string().max(2000).optional(),\n }),\n annotations: {\n readOnlyHint: true,\n destructiveHint: false,\n openWorldHint: false,\n idempotentHint: true,\n },\n _meta: {\n \"openai/fileParams\": [\"referenceImages\", \"destinationImages\"],\n \"openai/widgetAccessible\": true,\n },\n }, ({ referenceImages, destinationImages, referenceCount, destinationCount, subject, identityType, adultGlamour, adultConfirmed, additionalInstruction }) => {\n const refs = boundImages(referenceImages);\n const dests = boundImages(destinationImages);\n const refsDeclared = referenceImages?.length ?? 0;\n const destsDeclared = destinationImages?.length ?? 0;\n const refsExpected = referenceCount ?? refsDeclared;\n const destsExpected = destinationCount ?? destsDeclared;\n const imageInputsReady =\n refs.length > 0 &&\n dests.length > 0 &&\n refs.length === refsDeclared &&\n dests.length === destsDeclared &&\n refs.length === refsExpected &&\n dests.length === destsExpected;\n const enhancementConfigurationValid =\n !adultGlamour || (identityType === \"fictional\" && adultConfirmed);\n const inputsReady = imageInputsReady && enhancementConfigurationValid;\n\n const debug = {\n status: inputsReady\n ? \"CHARACTER_TRANSFER_INPUT_READY\"\n : imageInputsReady\n ? \"CHARACTER_ENHANCEMENT_CONFIGURATION_INVALID\"\n : \"CHARACTER_TRANSFER_INPUT_MISSING\",\n referenceFilesBound: refs.length,\n referenceFilesExpected: refsExpected,\n destinationFilesBound: dests.length,\n destinationFilesExpected: destsExpected,\n identityType,\n adultGlamourRequested: adultGlamour,\n adultGlamourActive: adultGlamour && enhancementConfigurationValid,\n nativeImageEditInputsReady: inputsReady,\n textOnlyFallback: false,\n };\n\n if (!inputsReady) {\n const configurationIssue = imageInputsReady && !enhancementConfigurationValid;\n return {\n isError: true,\n structuredContent: debug,\n content: [{\n type: \"text\",\n text: configurationIssue\n ? [\n \"CHARACTER_ENHANCEMENT_CONFIGURATION_INVALID:\",\n \"The optional character-enhancement preset requires an adult-confirmed fictional character.\",\n \"For real identities, leave the preset off; destination-preserving identity edit remains available.\",\n \"No image generation was started.\",\n ].join(\"\\n\")\n : [\n \"CHARACTER_TRANSFER_INPUT_MISSING:\",\n \"Reference and destination counts are present, but actual image attachments are not bound.\",\n \"Reference files bound: \" + refs.length + \"/\" + refsExpected,\n \"Destination files bound: \" + dests.length + \"/\" + destsExpected,\n \"Native image-edit inputs ready: false\",\n \"Text-only fallback: false\",\n \"No image generation was started.\",\n ].join(\"\\n\"),\n }],\n };\n }\n\n return {\n structuredContent: {\n ...debug,\n subject,\n identityType,\n characterEnhancement: {\n requested: adultGlamour,\n active: adultGlamour && enhancementConfigurationValid,\n scope: adultGlamour ? \"adult_fictional_non_explicit_destination_locked\" : \"off\",\n },\n referenceImages: refs.map(fileSummary),\n destinationImages: dests.map(fileSummary),\n generationPlan: dests.map((destination, index) => ({\n generation: index + 1,\n identitySources: refs.map((reference) => fileSummary(reference)),\n editTarget: fileSummary(destination),\n output: \"one_standalone_full_frame_image\",\n })),\n },\n content: [{\n type: \"text\",\n text: [\n \"CHARACTER_TRANSFER_INPUT_READY.\",\n \"Reference files bound: \" + refs.length + \"/\" + refsExpected,\n \"Destination files bound: \" + dests.length + \"/\" + destsExpected,\n \"Native image-edit inputs ready: true\",\n \"Text-only fallback: false\",\n \"Each destination is an edit target; every reference is identity-only.\",\n \"Identity classification: \" + identityType + \".\",\n adultGlamour ? \"Optional character enhancement: active for an adult fictional character; keep it non-explicit and destination-locked.\" : \"Optional character enhancement: off.\",\n \"Generate exactly \" + dests.length + \" separate full-frame edited outputs. Never create a collage, grid, dashboard, contact sheet, split screen, or storyboard.\",\n additionalInstruction ? \"Additional instruction: \" + additionalInstruction : \"Additional instruction: none.\",\n ].join(\"\\n\"),\n }],\n };\n });\n\n server.registerTool(\"prepare_upscale_batch\", {\n description: \"Validate selected actual ChatGPT image attachments and prepare a native 2x or 4x upscale batch. Counts alone never start enhancement.\",\n inputSchema: z.object({\n selectedImages: z.array(openAiFileSchema).max(10).optional(),\n selectedCount: z.number().int().min(1).max(10).optional(),\n factor: z.enum([\"2x\", \"4x\"]),\n }),\n annotations: {\n readOnlyHint: true,\n destructiveHint: false,\n openWorldHint: false,\n idempotentHint: true,\n },\n _meta: {\n \"openai/fileParams\": [\"selectedImages\"],\n \"openai/widgetAccessible\": true,\n },\n }, ({ selectedImages, selectedCount, factor }) => {\n const files = boundImages(selectedImages);\n const declared = selectedImages?.length ?? 0;\n const expected = selectedCount ?? declared;\n const inputsReady =\n files.length > 0 &&\n files.length === declared &&\n files.length === expected;\n\n const debug = {\n status: inputsReady ? \"UPSCALE_INPUT_READY\" : \"UPSCALE_INPUT_MISSING\",\n selectedFilesBound: files.length,\n selectedFilesExpected: expected,\n nativeImageEditInputsReady: inputsReady,\n textOnlyFallback: false,\n };\n\n if (!inputsReady) {\n return {\n isError: true,\n structuredContent: debug,\n content: [{\n type: \"text\",\n text: [\n \"UPSCALE_INPUT_MISSING:\",\n \"Selected result counts are present, but actual image attachments are not bound.\",\n \"Selected result files bound: \" + files.length + \"/\" + expected,\n \"Native image-edit inputs ready: false\",\n \"Text-only fallback: false\",\n \"No upscale was started.\",\n ].join(\"\\n\"),\n }],\n };\n }\n\n return {\n structuredContent: {\n ...debug,\n factor,\n selectedImages: files.map(fileSummary),\n },\n content: [{\n type: \"text\",\n text: [\n \"UPSCALE_INPUT_READY.\",\n \"Selected result files bound: \" + files.length + \"/\" + expected,\n \"Native image-edit inputs ready: true\",\n \"Text-only fallback: false\",\n \"Upscale only the selected completed results as one uninterrupted \" + factor + \" batch.\",\n \"Preserve identity, face, composition, natural skin texture, anatomy, styling, and destination constraints.\",\n \"Return each enhanced image as a separate file. Do not reshape, recombine, or regenerate scenes.\",\n ].join(\"\\n\"),\n }],\n };\n });\n\n\n const accountId = String(requestContext.authInfo?.extra?.accountId || \"\");\n const workspaceSchema = z.object({ workspaceKey: z.string().optional() });\n\n server.registerTool(\"load_character_workspace\", {\n description: \"Load a permanent AminA Character Studio workspace. It is scoped to the authenticated ChatGPT account when available, otherwise to the Studio pairing key.\",\n inputSchema: workspaceSchema,\n annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: { \"openai/widgetAccessible\": true },\n }, async ({ workspaceKey }) => {\n const owner = await workspaceOwnerId(accountId, workspaceKey);\n if (!owner) return { isError: true, structuredContent: { code: \"STUDIO_WORKSPACE_KEY_REQUIRED\" }, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_KEY_REQUIRED: A valid Studio pairing key is required before permanent workspace data can be loaded.\" }] };\n await ensureStudioSchema();\n const result = await sqlite.execute({ sql: \"SELECT workspace_json, updated_at FROM studio_workspaces WHERE account_id = ?\", args: [owner.id] });\n const row = result.rows[0] as Record | undefined;\n let workspace: unknown = null;\n if (row?.workspace_json) {\n try { workspace = JSON.parse(String(row.workspace_json)); } catch { workspace = null; }\n }\n return {\n structuredContent: { accountConnected: true, storageMode: owner.mode, workspace, updatedAt: row?.updated_at ? Number(row.updated_at) : null },\n content: [{ type: \"text\", text: workspace ? \"Permanent Studio workspace loaded.\" : \"No saved Studio workspace yet.\" }],\n };\n });\n\n server.registerTool(\"save_character_workspace\", {\n description: \"Persist the AminA Character Studio workspace using the authenticated account or its secure Studio pairing key.\",\n inputSchema: workspaceSchema.extend({ workspace: z.record(z.string(), z.unknown()) }),\n annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: { \"openai/widgetAccessible\": true },\n }, async ({ workspaceKey, workspace }) => {\n const owner = await workspaceOwnerId(accountId, workspaceKey);\n if (!owner) return { isError: true, structuredContent: { code: \"STUDIO_WORKSPACE_KEY_REQUIRED\" }, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_KEY_REQUIRED: A valid Studio pairing key is required before permanent workspace data can be saved.\" }] };\n const encoded = JSON.stringify(workspace);\n if (new TextEncoder().encode(encoded).byteLength > 500000) {\n return { isError: true, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_TOO_LARGE: The saved Studio workspace exceeds the 500 KB limit.\" }] };\n }\n await ensureStudioSchema();\n const updatedAt = Date.now();\n await sqlite.execute({\n sql: \"INSERT INTO studio_workspaces (account_id, workspace_json, updated_at) VALUES (?, ?, ?) ON CONFLICT(account_id) DO UPDATE SET workspace_json = excluded.workspace_json, updated_at = excluded.updated_at\",\n args: [owner.id, encoded, updatedAt],\n });\n return {\n structuredContent: { saved: true, accountConnected: true, storageMode: owner.mode, updatedAt },\n content: [{ type: \"text\", text: \"Permanent Studio workspace saved.\" }],\n };\n });\n\n return server;\n});\n\nasync function normalizeStudioToolCall(request: Request) {\n if (request.method !== \"POST\") return request;\n let payload: any;\n try { payload = JSON.parse(await request.clone().text()); } catch { return request; }\n const name = payload?.method === \"tools/call\" ? payload?.params?.name : \"\";\n const prefix = \"amina_character_studio.\";\n if (typeof name !== \"string\" || !name.startsWith(prefix)) return request;\n const canonical = name.slice(prefix.length);\n const allowed = new Set([\"open_character_studio\", \"open_character_studio_ui\", \"launch_character_studio_v12\", \"launch_character_studio_v13\", \"prepare_character_batch\", \"prepare_upscale_batch\", \"load_character_workspace\", \"save_character_workspace\"]);\n if (!allowed.has(canonical)) return request;\n payload.params.name = canonical;\n const headers = new Headers(request.headers);\n headers.set(\"content-type\", \"application/json\");\n return new Request(request.url, { method: request.method, headers, body: JSON.stringify(payload) });\n}\n\nexport default async function studioFetch(incomingRequest: Request) {\n const request = await normalizeStudioToolCall(incomingRequest);\n const url = new URL(request.url);\n const media = await studioMediaRoute(request, url);\n if (media) return media;\n const oauth = await studioOAuthRoute(request, url);\n if (oauth) return oauth;\n const authInfo = await studioAuthInfo(request);\n if (authInfo) return mcpHandler.fetch(request, { authInfo });\n return mcpHandler.fetch(request, {\n authInfo: {\n token: \"anonymous-legacy-connection\",\n clientId: \"anonymous-legacy-connection\",\n scopes: [AUTH_SCOPE],\n expiresAt: Math.floor(Date.now() / 1000) + 60 * 60,\n resource: new URL(AUTH_RESOURCE),\n extra: { accountId: \"\" },\n },\n });\n}\n\nconst widgetHtmlV8 = String.raw`\n\n\n\n\nAminA Character Studio\n\n\n\n

AminACHARACTER STUDIO

Character Studio

Checking ChatGPT bridge…

Reference bindings0/0

Destination bindings0/0

Native edit inputsfalse

Session checkpointSaving…

کد همگام‌سازی

\n\n\n

وضعیت زنده

آماده است؛ هنوز هیچ درخواست تولیدی ارسال نشده.

آماده

تکمیل شده0 / 0

زمان واقعی—

درخواست‌ها0

ETA میزبان—

\n\n

مرجع کاراکترِ قفل‌شده

هویت فقط · تا ۱۰ تصویر/کلاژ

0/10

\n ＋ آپلود مرجع کاراکتر\n

\n \n

\n \n Enhance کاراکترپروفایل بزرگسالِ فیکشنال با حال‌وهوای ادیتوریال؛ قفل مقصد حفظ می‌شود.\n

\n \n

\n\n

تصاویر مقصد

ژست، کادر، لباس و استایل از مقصد

0/10

\n ＋ آپلود تصویر مقصد\n

هر مقصد یک خروجی مستقل می‌سازد؛ هیچ contact sheet یا کلاژی در صف ساخته نمی‌شود.

\n\n

صف ویرایش

یک درخواست، بدون تکرار خودکار

دکمه فقط وقتی فعال می‌شود که همهٔ فایل‌ها واقعاً به ChatGPT bind شده باشند. تا اجرای فعلی تمام نشده، درخواست تکراری ارسال نمی‌شود.

\n \n

\n\n

بانک کاراکتر

مرجع‌های قفل‌شده را ذخیره، انتخاب، اضافه یا حذف کن

＋ افزودن عکس به انتخاب

یک کاراکتر را انتخاب کن، عکس‌هایش فقط با شماره نشان داده می‌شوند و هیچ‌کدام از اسلات‌های فعلی خودبه‌خود پاک نمی‌شوند.

\n\n

نتیجه‌های کامل‌شده

فقط خروجی‌هایی را که می‌خواهی آپ‌اسکیل شوند انتخاب کن

0 انتخاب

\nبازکردن نسخهٔ بیرونی در صورت نیاز ↗\n

\n\n\n`;\n","import {\n createMcpHandler,\n McpServer,\n} from \"npm:@modelcontextprotocol/server@2\";\nimport * as z from \"npm:zod@4/v4\";\nimport { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE } from \"npm:@modelcontextprotocol/ext-apps/server\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst STUDIO_URL = \"https://amina-character-studio.ruholamin.chatgpt.site\";\nconst TEMPLATE_URI = \"ui://amina-character-studio/v13.html\";\nconst LEGACY_TEMPLATE_URI = \"ui://amina-character-studio/v4-skybridge.html\";\nconst widgetHtml = \"\\n\\n\\n\\n\\nAminA Character Studio\\n\\n\\n\\n

\\n

AminARECORDS

Character Studio

● ChatGPT connected

\\n \\n

\\n

Character references

Identity only · up to 10 files

0/10

\\n ＋ Add character referencesSingle photos or reference collages\\n

\\n \\n \\n

\\n

Destinations

Scene, pose, outfit and style

0/10

\\n ＋ Add destination imagesEach image becomes one separate output\\n

\\n

Generation queue

Continuous · no confirmation stops

\\n

No collage. One destination equals one standalone result. Failed items retry independently.

\\n \\n

\\n

Results ready

Select only the images you want to upscale

\\n

0 selected

\\n

\\n External fallback ↗\\n

\\n

\\n\\n\\n\";\n\nconst widgetHtmlV6 = String.raw`\n\n\nAminA Character Studio\n\n

AminARECORDS

Character Studio

Checking ChatGPT binding…

Reference files bound0/0

Destination files bound0/0

Native image-edit inputs readyfalse

Text-only fallbackfalse

\n\n

Character references

Identity only · up to 10 image files

0/10

＋ Upload character reference images

Destinations

Pose, framing, outfit and visual style

0/10

＋ Upload destination images

Native edit queue

One destination = one separate image edit

No collage. No text-to-image fallback. Run remains blocked until every file has a real ChatGPT file binding.

Completed results

Import ChatGPT-generated images, then select only the ones to upscale

0 selected

\nExternal fallback ↗\n

Connecting your permanent Studio workspace…

\", {\n headers: {\n \"Content-Type\": \"text/html; charset=utf-8\",\n \"Cache-Control\": \"no-store\",\n \"Set-Cookie\": \"amina_studio_account=\" + accountId + \"; Path=/; Max-Age=31536000; SameSite=Lax; Secure; HttpOnly\",\n },\n });\n}\n\nasync function studioToken(request: Request) {\n const form = await request.formData();\n const grant = String(form.get(\"grant_type\") || \"\");\n const clientId = String(form.get(\"client_id\") || \"\");\n const resource = canonicalResource(String(form.get(\"resource\") || AUTH_RESOURCE));\n if (resource !== AUTH_RESOURCE) return oauthError(\"invalid_target\", \"The requested resource does not match AminA Character Studio.\");\n if (grant === \"authorization_code\") {\n const code = String(form.get(\"code\") || \"\");\n const verifier = String(form.get(\"code_verifier\") || \"\");\n const redirectUri = String(form.get(\"redirect_uri\") || \"\");\n if (!code || !verifier || !clientId || !redirectUri) return oauthError(\"invalid_request\", \"Code, verifier, client ID and redirect URI are required.\");\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_oauth_codes WHERE code_hash = ?\", args: [await tokenHash(code)] });\n const row = result.rows[0] as Record | undefined;\n await sqlite.execute({ sql: \"DELETE FROM studio_oauth_codes WHERE code_hash = ?\", args: [await tokenHash(code)] });\n if (!row || Number(row.expires_at) < Date.now() || row.client_id !== clientId || row.redirect_uri !== redirectUri) return oauthError(\"invalid_grant\", \"The authorization code is invalid or expired.\");\n if (await tokenHash(verifier) !== row.code_challenge) return oauthError(\"invalid_grant\", \"PKCE verification failed.\");\n return oauthResponse(await issueStudioTokens(String(row.account_id), clientId, resource, String(row.scopes).split(/\\s+/).filter(Boolean)));\n }\n if (grant === \"refresh_token\") {\n const refreshToken = String(form.get(\"refresh_token\") || \"\");\n if (!refreshToken || !clientId) return oauthError(\"invalid_request\", \"Refresh token and client ID are required.\");\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_access_tokens WHERE refresh_hash = ?\", args: [await tokenHash(refreshToken)] });\n const row = result.rows[0] as Record | undefined;\n if (!row || Number(row.refresh_expires_at) < Date.now() || row.client_id !== clientId) return oauthError(\"invalid_grant\", \"The refresh token is invalid or expired.\");\n await sqlite.execute({ sql: \"DELETE FROM studio_access_tokens WHERE refresh_hash = ?\", args: [await tokenHash(refreshToken)] });\n return oauthResponse(await issueStudioTokens(String(row.account_id), clientId, resource, String(row.scopes).split(/\\s+/).filter(Boolean)));\n }\n return oauthError(\"unsupported_grant_type\", \"Only authorization_code and refresh_token are supported.\");\n}\n\nasync function studioAuthInfo(request: Request) {\n const authorization = request.headers.get(\"authorization\") || \"\";\n const match = /^Bearer\\s+(.+)$/i.exec(authorization);\n if (!match) return null;\n const token = match[1];\n const result = await sqlite.execute({ sql: \"SELECT * FROM studio_access_tokens WHERE token_hash = ?\", args: [await tokenHash(token)] });\n const row = result.rows[0] as Record | undefined;\n if (!row || Number(row.expires_at) < Date.now() || canonicalResource(String(row.resource)) !== AUTH_RESOURCE) return null;\n return {\n token,\n clientId: String(row.client_id),\n scopes: String(row.scopes).split(/\\s+/).filter(Boolean),\n expiresAt: Math.floor(Number(row.expires_at) / 1000),\n resource: new URL(AUTH_RESOURCE),\n extra: { accountId: String(row.account_id) },\n };\n}\n\nasync function studioOAuthRoute(request: Request, url: URL): Promise {\n await ensureStudioSchema();\n if (url.pathname === \"/.well-known/oauth-protected-resource\") {\n return oauthResponse({ resource: AUTH_RESOURCE, authorization_servers: [AUTH_RESOURCE], scopes_supported: [AUTH_SCOPE] });\n }\n if (url.pathname === \"/.well-known/oauth-authorization-server\") {\n return oauthResponse({\n issuer: AUTH_RESOURCE,\n authorization_response_iss_parameter_supported: true,\n authorization_endpoint: AUTH_RESOURCE + \"/oauth/authorize\",\n token_endpoint: AUTH_RESOURCE + \"/oauth/token\",\n client_id_metadata_document_supported: true,\n token_endpoint_auth_methods_supported: [\"none\"],\n code_challenge_methods_supported: [\"S256\"],\n scopes_supported: [AUTH_SCOPE],\n });\n }\n if (url.pathname === \"/oauth/authorize\" && request.method === \"GET\") return studioAuthorize(request, url);\n if (url.pathname === \"/oauth/token\" && request.method === \"POST\") return studioToken(request);\n return null;\n}\n\nconst mcpHandler = createMcpHandler((requestContext) => {\n const server = new McpServer({ name: \"amina-character-studio\", version: \"1.6.0\" });\n\n const resourceMeta = {\n ui: {\n prefersBorder: true,\n domain: \"https://amina-character-studio-mcp.val.run\",\n csp: { connectDomains: [\"https://amina-character-studio-mcp.val.run\"], resourceDomains: [] },\n },\n \"openai/widgetDescription\": \"Interactive AminA Character Studio for identity-locked character transfer and selective upscaling.\",\n \"openai/widgetPrefersBorder\": true,\n \"openai/widgetDomain\": \"https://amina-character-studio-mcp.val.run\",\n \"openai/widgetCSP\": {\n connect_domains: [\"https://amina-character-studio-mcp.val.run\"],\n resource_domains: [],\n redirect_domains: [STUDIO_URL],\n },\n };\n\n registerAppResource(server, \"amina-character-studio-widget\", TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: TEMPLATE_URI,\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtmlV8,\n _meta: resourceMeta,\n }],\n }));\n\n // ChatGPT may keep a previously published outputTemplate URI. Serve those exact URIs with the current UI.\n registerAppResource(server, \"amina-character-studio-widget-v12-compat\", \"ui://amina-character-studio/v12.html\", {}, async () => ({\n contents: [{\n uri: \"ui://amina-character-studio/v12.html\",\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtmlV8,\n _meta: resourceMeta,\n }],\n }));\n\n registerAppResource(server, \"amina-character-studio-widget-v9-compat\", \"ui://amina-character-studio/v9.html\", {}, async () => ({\n contents: [{\n uri: \"ui://amina-character-studio/v9.html\",\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtmlV8,\n _meta: resourceMeta,\n }],\n }));\n\n server.registerResource(\"amina-character-studio-widget-skybridge\", LEGACY_TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: LEGACY_TEMPLATE_URI,\n mimeType: \"text/html+skybridge\",\n text: widgetHtml,\n _meta: resourceMeta,\n }],\n }));\n\n const openStudioDescriptor = {\n title: \"Open AminA Character Studio\",\n description: \"Render the interactive AminA Character Studio directly inside the ChatGPT conversation. This is the primary UI-rendering tool.\",\n inputSchema: z.object({}),\n outputSchema: z.object({\n mode: z.literal(\"embedded\"),\n studioUrl: z.string().url(),\n ready: z.boolean(),\n }),\n annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: {\n ui: { resourceUri: TEMPLATE_URI, visibility: [\"model\", \"app\"] },\n \"openai/outputTemplate\": TEMPLATE_URI,\n \"openai/widgetAccessible\": true,\n \"openai/toolInvocation/invoking\": \"Opening Character Studio…\",\n \"openai/toolInvocation/invoked\": \"Character Studio ready\",\n },\n };\n\n const openStudioHandler = () => ({\n structuredContent: { mode: \"embedded\" as const, studioUrl: STUDIO_URL, ready: true },\n content: [{ type: \"text\" as const, text: \"AminA Character Studio is mounted as an interactive inline component. The external URL is fallback only.\" }],\n });\n\n registerAppTool(server, \"open_character_studio\", openStudioDescriptor, openStudioHandler);\n // Compatibility alias for ChatGPT gateways that retain the connector namespace in the remote tool name.\n registerAppTool(server, \"amina_character_studio.open_character_studio\", {\n ...openStudioDescriptor,\n title: \"Open AminA Character Studio\",\n description: \"Compatibility entry point for rendering the same inline AminA Character Studio component.\",\n }, openStudioHandler);\n registerAppTool(server, \"open_character_studio_ui\", {\n ...openStudioDescriptor,\n title: \"Render AminA Character Studio UI\",\n description: \"Explicitly render the interactive AminA Character Studio component inline. Use this if a cached client treated open_character_studio as text-only.\",\n }, openStudioHandler);\n registerAppTool(server, \"launch_character_studio_v12\", {\n ...openStudioDescriptor,\n title: \"AminA Character Studio\",\n description: \"Launch the current interactive Persian Character Studio v12 inline. Prefer this tool whenever the user opens or mentions AminA Character Studio.\",\n }, openStudioHandler);\n\n const openAiFileSchema = z.object({\n download_url: z.string().min(1),\n file_id: z.string().min(1),\n mime_type: z.string().optional(),\n file_name: z.string().optional(),\n });\n\n const boundImages = (files: Array<{\n download_url: string;\n file_id: string;\n mime_type?: string;\n file_name?: string;\n }> | undefined) => (files ?? []).filter((file) =>\n Boolean(file.file_id && file.download_url) &&\n (!file.mime_type || file.mime_type.startsWith(\"image/\"))\n );\n\n const fileSummary = (file: {\n file_id: string;\n file_name?: string;\n mime_type?: string;\n }) => ({\n fileId: file.file_id,\n fileName: file.file_name ?? \"image\",\n mimeType: file.mime_type ?? \"image/*\",\n });\n\n server.registerTool(\"prepare_character_batch\", {\n description: \"Validate actual ChatGPT image attachments, identity classification, and optional adult-fictional character enhancement before preparing a native image-edit character-transfer batch. Counts alone never start generation.\",\n inputSchema: z.object({\n referenceImages: z.array(openAiFileSchema).max(10).optional(),\n destinationImages: z.array(openAiFileSchema).max(10).optional(),\n referenceCount: z.number().int().min(1).max(10).optional(),\n destinationCount: z.number().int().min(1).max(10).optional(),\n subject: z.enum([\"woman\", \"man\", \"both\", \"main-subject\"]).default(\"main-subject\"),\n identityType: z.enum([\"fictional\", \"real\"]).default(\"fictional\"),\n adultGlamour: z.boolean().default(false),\n adultConfirmed: z.boolean().default(false),\n additionalInstruction: z.string().max(2000).optional(),\n }),\n annotations: {\n readOnlyHint: true,\n destructiveHint: false,\n openWorldHint: false,\n idempotentHint: true,\n },\n _meta: {\n \"openai/fileParams\": [\"referenceImages\", \"destinationImages\"],\n \"openai/widgetAccessible\": true,\n },\n }, ({ referenceImages, destinationImages, referenceCount, destinationCount, subject, identityType, adultGlamour, adultConfirmed, additionalInstruction }) => {\n const refs = boundImages(referenceImages);\n const dests = boundImages(destinationImages);\n const refsDeclared = referenceImages?.length ?? 0;\n const destsDeclared = destinationImages?.length ?? 0;\n const refsExpected = referenceCount ?? refsDeclared;\n const destsExpected = destinationCount ?? destsDeclared;\n const imageInputsReady =\n refs.length > 0 &&\n dests.length > 0 &&\n refs.length === refsDeclared &&\n dests.length === destsDeclared &&\n refs.length === refsExpected &&\n dests.length === destsExpected;\n const enhancementConfigurationValid =\n !adultGlamour || (identityType === \"fictional\" && adultConfirmed);\n const inputsReady = imageInputsReady && enhancementConfigurationValid;\n\n const debug = {\n status: inputsReady\n ? \"CHARACTER_TRANSFER_INPUT_READY\"\n : imageInputsReady\n ? \"CHARACTER_ENHANCEMENT_CONFIGURATION_INVALID\"\n : \"CHARACTER_TRANSFER_INPUT_MISSING\",\n referenceFilesBound: refs.length,\n referenceFilesExpected: refsExpected,\n destinationFilesBound: dests.length,\n destinationFilesExpected: destsExpected,\n identityType,\n adultGlamourRequested: adultGlamour,\n adultGlamourActive: adultGlamour && enhancementConfigurationValid,\n nativeImageEditInputsReady: inputsReady,\n textOnlyFallback: false,\n };\n\n if (!inputsReady) {\n const configurationIssue = imageInputsReady && !enhancementConfigurationValid;\n return {\n isError: true,\n structuredContent: debug,\n content: [{\n type: \"text\",\n text: configurationIssue\n ? [\n \"CHARACTER_ENHANCEMENT_CONFIGURATION_INVALID:\",\n \"The optional character-enhancement preset requires an adult-confirmed fictional character.\",\n \"For real identities, leave the preset off; destination-preserving identity edit remains available.\",\n \"No image generation was started.\",\n ].join(\"\\n\")\n : [\n \"CHARACTER_TRANSFER_INPUT_MISSING:\",\n \"Reference and destination counts are present, but actual image attachments are not bound.\",\n \"Reference files bound: \" + refs.length + \"/\" + refsExpected,\n \"Destination files bound: \" + dests.length + \"/\" + destsExpected,\n \"Native image-edit inputs ready: false\",\n \"Text-only fallback: false\",\n \"No image generation was started.\",\n ].join(\"\\n\"),\n }],\n };\n }\n\n return {\n structuredContent: {\n ...debug,\n subject,\n identityType,\n characterEnhancement: {\n requested: adultGlamour,\n active: adultGlamour && enhancementConfigurationValid,\n scope: adultGlamour ? \"adult_fictional_non_explicit_destination_locked\" : \"off\",\n },\n referenceImages: refs.map(fileSummary),\n destinationImages: dests.map(fileSummary),\n generationPlan: dests.map((destination, index) => ({\n generation: index + 1,\n identitySources: refs.map((reference) => fileSummary(reference)),\n editTarget: fileSummary(destination),\n output: \"one_standalone_full_frame_image\",\n })),\n },\n content: [{\n type: \"text\",\n text: [\n \"CHARACTER_TRANSFER_INPUT_READY.\",\n \"Reference files bound: \" + refs.length + \"/\" + refsExpected,\n \"Destination files bound: \" + dests.length + \"/\" + destsExpected,\n \"Native image-edit inputs ready: true\",\n \"Text-only fallback: false\",\n \"Each destination is an edit target; every reference is identity-only.\",\n \"Identity classification: \" + identityType + \".\",\n adultGlamour ? \"Optional character enhancement: active for an adult fictional character; keep it non-explicit and destination-locked.\" : \"Optional character enhancement: off.\",\n \"Generate exactly \" + dests.length + \" separate full-frame edited outputs. Never create a collage, grid, dashboard, contact sheet, split screen, or storyboard.\",\n additionalInstruction ? \"Additional instruction: \" + additionalInstruction : \"Additional instruction: none.\",\n ].join(\"\\n\"),\n }],\n };\n });\n\n server.registerTool(\"prepare_upscale_batch\", {\n description: \"Validate selected actual ChatGPT image attachments and prepare a native 2x or 4x upscale batch. Counts alone never start enhancement.\",\n inputSchema: z.object({\n selectedImages: z.array(openAiFileSchema).max(10).optional(),\n selectedCount: z.number().int().min(1).max(10).optional(),\n factor: z.enum([\"2x\", \"4x\"]),\n }),\n annotations: {\n readOnlyHint: true,\n destructiveHint: false,\n openWorldHint: false,\n idempotentHint: true,\n },\n _meta: {\n \"openai/fileParams\": [\"selectedImages\"],\n \"openai/widgetAccessible\": true,\n },\n }, ({ selectedImages, selectedCount, factor }) => {\n const files = boundImages(selectedImages);\n const declared = selectedImages?.length ?? 0;\n const expected = selectedCount ?? declared;\n const inputsReady =\n files.length > 0 &&\n files.length === declared &&\n files.length === expected;\n\n const debug = {\n status: inputsReady ? \"UPSCALE_INPUT_READY\" : \"UPSCALE_INPUT_MISSING\",\n selectedFilesBound: files.length,\n selectedFilesExpected: expected,\n nativeImageEditInputsReady: inputsReady,\n textOnlyFallback: false,\n };\n\n if (!inputsReady) {\n return {\n isError: true,\n structuredContent: debug,\n content: [{\n type: \"text\",\n text: [\n \"UPSCALE_INPUT_MISSING:\",\n \"Selected result counts are present, but actual image attachments are not bound.\",\n \"Selected result files bound: \" + files.length + \"/\" + expected,\n \"Native image-edit inputs ready: false\",\n \"Text-only fallback: false\",\n \"No upscale was started.\",\n ].join(\"\\n\"),\n }],\n };\n }\n\n return {\n structuredContent: {\n ...debug,\n factor,\n selectedImages: files.map(fileSummary),\n },\n content: [{\n type: \"text\",\n text: [\n \"UPSCALE_INPUT_READY.\",\n \"Selected result files bound: \" + files.length + \"/\" + expected,\n \"Native image-edit inputs ready: true\",\n \"Text-only fallback: false\",\n \"Upscale only the selected completed results as one uninterrupted \" + factor + \" batch.\",\n \"Preserve identity, face, composition, natural skin texture, anatomy, styling, and destination constraints.\",\n \"Return each enhanced image as a separate file. Do not reshape, recombine, or regenerate scenes.\",\n ].join(\"\\n\"),\n }],\n };\n });\n\n\n const accountId = String(requestContext.authInfo?.extra?.accountId || \"\");\n const workspaceSchema = z.object({ workspaceKey: z.string().optional() });\n\n server.registerTool(\"load_character_workspace\", {\n description: \"Load a permanent AminA Character Studio workspace. It is scoped to the authenticated ChatGPT account when available, otherwise to the Studio pairing key.\",\n inputSchema: workspaceSchema,\n annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: { \"openai/widgetAccessible\": true },\n }, async ({ workspaceKey }) => {\n const owner = await workspaceOwnerId(accountId, workspaceKey);\n if (!owner) return { isError: true, structuredContent: { code: \"STUDIO_WORKSPACE_KEY_REQUIRED\" }, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_KEY_REQUIRED: A valid Studio pairing key is required before permanent workspace data can be loaded.\" }] };\n await ensureStudioSchema();\n const result = await sqlite.execute({ sql: \"SELECT workspace_json, updated_at FROM studio_workspaces WHERE account_id = ?\", args: [owner.id] });\n const row = result.rows[0] as Record | undefined;\n let workspace: unknown = null;\n if (row?.workspace_json) {\n try { workspace = JSON.parse(String(row.workspace_json)); } catch { workspace = null; }\n }\n return {\n structuredContent: { accountConnected: true, storageMode: owner.mode, workspace, updatedAt: row?.updated_at ? Number(row.updated_at) : null },\n content: [{ type: \"text\", text: workspace ? \"Permanent Studio workspace loaded.\" : \"No saved Studio workspace yet.\" }],\n };\n });\n\n server.registerTool(\"save_character_workspace\", {\n description: \"Persist the AminA Character Studio workspace using the authenticated account or its secure Studio pairing key.\",\n inputSchema: workspaceSchema.extend({ workspace: z.record(z.string(), z.unknown()) }),\n annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: { \"openai/widgetAccessible\": true },\n }, async ({ workspaceKey, workspace }) => {\n const owner = await workspaceOwnerId(accountId, workspaceKey);\n if (!owner) return { isError: true, structuredContent: { code: \"STUDIO_WORKSPACE_KEY_REQUIRED\" }, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_KEY_REQUIRED: A valid Studio pairing key is required before permanent workspace data can be saved.\" }] };\n const encoded = JSON.stringify(workspace);\n if (new TextEncoder().encode(encoded).byteLength > 500000) {\n return { isError: true, content: [{ type: \"text\", text: \"STUDIO_WORKSPACE_TOO_LARGE: The saved Studio workspace exceeds the 500 KB limit.\" }] };\n }\n await ensureStudioSchema();\n const updatedAt = Date.now();\n await sqlite.execute({\n sql: \"INSERT INTO studio_workspaces (account_id, workspace_json, updated_at) VALUES (?, ?, ?) ON CONFLICT(account_id) DO UPDATE SET workspace_json = excluded.workspace_json, updated_at = excluded.updated_at\",\n args: [owner.id, encoded, updatedAt],\n });\n return {\n structuredContent: { saved: true, accountConnected: true, storageMode: owner.mode, updatedAt },\n content: [{ type: \"text\", text: \"Permanent Studio workspace saved.\" }],\n };\n });\n\n return server;\n});\n\nasync function normalizeStudioToolCall(request: Request) {\n if (request.method !== \"POST\") return request;\n let payload: any;\n try { payload = JSON.parse(await request.clone().text()); } catch { return request; }\n const name = payload?.method === \"tools/call\" ? payload?.params?.name : \"\";\n const prefix = \"amina_character_studio.\";\n if (typeof name !== \"string\" || !name.startsWith(prefix)) return request;\n const canonical = name.slice(prefix.length);\n const allowed = new Set([\"open_character_studio\", \"open_character_studio_ui\", \"launch_character_studio_v12\", \"launch_character_studio_v13\", \"prepare_character_batch\", \"prepare_upscale_batch\", \"load_character_workspace\", \"save_character_workspace\"]);\n if (!allowed.has(canonical)) return request;\n payload.params.name = canonical;\n const headers = new Headers(request.headers);\n headers.set(\"content-type\", \"application/json\");\n return new Request(request.url, { method: request.method, headers, body: JSON.stringify(payload) });\n}\n\nexport default async function studioFetch(incomingRequest: Request) {\n const request = await normalizeStudioToolCall(incomingRequest);\n const url = new URL(request.url);\n const media = await studioMediaRoute(request, url);\n if (media) return media;\n const oauth = await studioOAuthRoute(request, url);\n if (oauth) return oauth;\n const authInfo = await studioAuthInfo(request);\n if (authInfo) return mcpHandler.fetch(request, { authInfo });\n return mcpHandler.fetch(request, {\n authInfo: {\n token: \"anonymous-legacy-connection\",\n clientId: \"anonymous-legacy-connection\",\n scopes: [AUTH_SCOPE],\n expiresAt: Math.floor(Date.now() / 1000) + 60 * 60,\n resource: new URL(AUTH_RESOURCE),\n extra: { accountId: \"\" },\n },\n });\n}\n\nconst widgetHtmlV8 = String.raw`\n\n\n\n\nAminA Character Studio\n\n\n\n

AminACHARACTER STUDIO

Character Studio

Checking ChatGPT bridge…

Reference bindings0/0

Destination bindings0/0

Native edit inputsfalse

Session checkpointSaving…

کد همگام‌سازی

\n\n\n

وضعیت زنده

آماده است؛ هنوز هیچ درخواست تولیدی ارسال نشده.

آماده

تکمیل شده0 / 0

زمان واقعی—

درخواست‌ها0

ETA میزبان—

\n\n

مرجع کاراکترِ قفل‌شده

هویت فقط · تا ۱۰ تصویر/کلاژ

0/10

\n ＋ آپلود مرجع کاراکتر\n

\n \n

\n \n Enhance کاراکترپروفایل بزرگسالِ فیکشنال با حال‌وهوای ادیتوریال؛ قفل مقصد حفظ می‌شود.\n

\n \n

\n\n

تصاویر مقصد

ژست، کادر، لباس و استایل از مقصد

0/10

\n ＋ آپلود تصویر مقصد\n

هر مقصد یک خروجی مستقل می‌سازد؛ هیچ contact sheet یا کلاژی در صف ساخته نمی‌شود.

\n\n

صف ویرایش

یک درخواست، بدون تکرار خودکار

\n \n

\n\n

بانک کاراکتر

مرجع‌های قفل‌شده را ذخیره، انتخاب، اضافه یا حذف کن

＋ افزودن عکس به انتخاب

\n\n

نتیجه‌های کامل‌شده

فقط خروجی‌هایی را که می‌خواهی آپ‌اسکیل شوند انتخاب کن

0 انتخاب

\nبازکردن نسخهٔ بیرونی در صورت نیاز ↗\n

\n\n\n`;\n","createdAt",["D",1789550340408],"branchVersion","branchId","f939d1fe-d3f8-4622-a5b1-592e879513ae","id","dc114f61-c059-4b89-844f-52938e231c8e","amina-character-studio-mcp",["D",1789468673039],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","AminA Character Studio MCP connector","imageUrl","6bc8f6e0-3727-4cbc-8f9c-2f9aeae69fe5","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","01a03ebf-08c8-77b5-b4dd-c31c30a28471","tursoName","dc114f61c0594b89844f52938e231c8e","tursoHostname","dc114f61c0594b89844f52938e231c8e-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789522252250],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":55,"_103":104,"_105":25},"branch",{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"isOwned",80,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","aminfarhang","handle","displayName","Amin Farhang","avatar","https://lh3.googleusercontent.com/a/ACg8ocKps617N1S-6o5-02GdgzyG_1AxQNZEtCK_Yne1OA9Ob8Fx4BY=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":165,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":31,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":166,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":167,"_82":168,"_84":169,"_86":25},"tree",[156,157],"files",[156,157],"counts",{"_146":61,"_147":142,"_148":142,"_149":150,"_151":152},"contents",[130,131],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_43":139,"_32":140,"_30":141,"_133":-5,"_41":42,"_40":142,"_134":125,"_38":143,"_13":61,"_33":20,"_35":144,"_24":25,"_137":-5,"_27":145},{"_43":132,"_32":28,"_30":31,"_133":-5,"_41":42,"_40":14,"_134":25,"_38":135,"_13":136,"_33":34,"_35":37,"_24":25,"_137":45,"_27":138},"74f382ab-1454-4f5d-b470-4e05bc15d709","parentId","latest",["D",1789550340408],77,"label",[28],"d00db12b-de67-47df-8cab-9f5e6f95aa9a","README.md","01a0a4a5-0473-7216-8857-bcb8ae9dc552",1,["D",1789468673039],"# MCP server\n\n_In video form:\n[How to build an MCP server in 1 minute](https://youtu.be/sO6-Wl5fy7g?si=oc7s9bVIVFHxHJh2)_\n\nA minimal MCP server with one example tool (that gets the current time in a\ngiven timezone).\n\nRemix this val to create your own MCP server on Val\nTown—[**_just like the MCP Core Maintainer team!_**](https://blog.val.town/mcp-core-maintainers)\n\nThis MCP server (<50 LOC in [`main.ts`](./main.ts)) is live on\n[mcp-time.val.run](https://mcp-time.val.run) if you'd like to test it\n([playground.ai.cloudflare.com](https://playground.ai.cloudflare.com) is a great\nplace to test an MCP server quickly). It's built on the v2 TypeScript SDK,\ncompatible with “MCP 2.0” (technically, the\n[2026-07-28 spec](https://modelcontextprotocol.io/specification/2026-07-28)). It\nalso supports the legacy spec, for MCP clients that haven't upgraded yet.",[140],"pulls","branches","forks","envVars",{"_153":61,"_155":61},"connections",{"_153":61,"_154":61},"count","unfilledCount","emptyCount",{"_43":139,"_32":140,"_30":141,"_133":-5,"_41":42,"_40":142,"_134":125,"_38":162,"_13":61,"_33":20,"_35":144,"_24":25,"_137":-5,"_159":163,"_27":164},{"_43":132,"_32":28,"_30":31,"_133":-5,"_41":42,"_40":14,"_134":25,"_38":158,"_13":136,"_33":34,"_35":37,"_24":25,"_137":45,"_159":160,"_27":161},["D",1789550340408],"children",[],[28],["D",1789468673039],[],[140],["D",1789468673039],["D",1789522252250],{"_98":97,"_106":102},{"_98":97,"_99":100,"_101":102,"_18":55,"_103":104,"_105":25},{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"ctx",{"_80":-5,"_127":203,"_204":205,"_206":207,"_208":25,"_209":25,"_210":25,"_211":125,"_212":-5,"_213":-7,"_214":-7,"_215":61,"_216":25,"_217":25,"_218":-5,"_219":25,"_220":25,"_221":25,"_222":-5},"ENV",{"_174":175,"_176":177,"_178":88,"_179":180,"_181":182,"_183":184,"_185":186,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v78