AminA Character Studio

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_178":179,"_180":181},"routes/_app.x.$handle.$name",{"_96":95,"_32":44,"_105":84,"_27":106,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":118,"_119":120,"_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",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":25,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":31,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":77,"_78":79,"_80":81,"_82":25},"version",4,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","main.ts","latestPath","fileId","01a0a4ce-0e3e-7033-86bd-712002284b81","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\";\n\nconst STUDIO_URL = \"https://amina-character-studio.ruholamin.chatgpt.site\";\nconst TEMPLATE_URI = \"ui://amina-character-studio/v5.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 handler = createMcpHandler(() => {\n const server = new McpServer({ name: \"amina-character-studio\", version: \"1.3.0\" });\n\n const resourceMeta = {\n ui: {\n prefersBorder: true,\n domain: \"https://amina-character-studio-plugin.val.run\",\n csp: { connectDomains: [], 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-plugin.val.run\",\n \"openai/widgetCSP\": {\n connect_domains: [],\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: widgetHtml,\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 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\n server.registerTool(\"prepare_character_batch\", {\n description: \"Prepare an uninterrupted identity-locked character transfer batch using images attached in the current ChatGPT conversation.\",\n inputSchema: z.object({\n referenceCount: z.number().int().min(1).max(10),\n destinationCount: z.number().int().min(1).max(10),\n subject: z.enum([\"woman\", \"man\", \"both\", \"main-subject\"]).default(\"main-subject\"),\n additionalInstruction: z.string().max(2000).optional(),\n }),\n }, ({ referenceCount, destinationCount, subject, additionalInstruction }) => ({\n content: [{ type: \"text\", text: [\n \"AMINA CHARACTER BATCH READY.\",\n \"References: \" + referenceCount + \"; destinations: \" + destinationCount + \"; subject mapping: \" + subject + \".\",\n \"Use the attached reference files only to lock identity. A reference file may itself be a collage.\",\n \"Use each destination for pose, framing, camera angle, gaze, expression, outfit and coverage, lighting, environment, occlusion, body presentation, and visual medium.\",\n \"Generate exactly \" + destinationCount + \" independent full-frame outputs: one destination equals one separate result.\",\n \"Never create a collage, grid, montage, contact sheet, split screen, or storyboard.\",\n \"Run one continuous batch without confirmation stops. Retry only a failed item and continue the remaining items.\",\n \"Match the destination medium. For photographs use maximum-quality photorealistic natural texture; for illustrations render the locked identity in that same style.\",\n \"Keep anatomy and posture plausible and natural.\",\n additionalInstruction ? \"Additional instruction: \" + additionalInstruction : \"Additional instruction: none.\",\n \"Use the native image generation/editing capability available in this ChatGPT session; do not request an API key for this workflow.\",\n \"Visual workspace: \" + STUDIO_URL,\n ].join(\"\\n\") }],\n }));\n\n server.registerTool(\"prepare_upscale_batch\", {\n description: \"Prepare a separate 2x or 4x upscale batch for only the completed results selected by the user.\",\n inputSchema: z.object({\n selectedCount: z.number().int().min(1).max(10),\n factor: z.enum([\"2x\", \"4x\"]),\n }),\n }, ({ selectedCount, factor }) => ({\n content: [{ type: \"text\", text: [\n \"UPSCALE BATCH READY: \" + selectedCount + \" selected result(s), \" + factor + \".\",\n \"Upscale only the selected completed results as one uninterrupted batch.\",\n \"Return each enhanced image as a separate file.\",\n \"Preserve identity, face, composition, skin texture, anatomy, styling, and destination constraints.\",\n \"Enhance resolution and natural detail only; do not reshape, recombine, or regenerate the scene.\",\n ].join(\"\\n\") }],\n }));\n\n return server;\n});\n\nexport default handler.fetch;","createdAt",["D",1789475977484],"branchVersion","branchId","6c2c6b1e-833b-49ef-86ee-377558e10bc5","id","b013bd07-9441-4335-bf4d-3f3af6e81956","amina-character-studio-plugin",["D",1789471362559],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","AminA Character Studio inline MCP app","imageUrl","6bc8f6e0-3727-4cbc-8f9c-2f9aeae69fe5","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","01a03ebf-08c8-77b5-b4dd-c31c30a28471","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_96":95,"_104":100},"org",{"_96":95,"_97":98,"_99":100,"_18":54,"_101":102,"_103":25},"branch",{"_13":83,"_32":84,"_42":41,"_85":43,"_86":87,"_88":83,"_89":49,"_90":91,"_92":62,"_93":44,"_94":95},"isOwned",5,"main","projectId","forkedBranchId","f939d1fe-d3f8-4622-a5b1-592e879513ae","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","dc114f61-c059-4b89-844f-52938e231c8e","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",{"_42":43,"_32":44,"_37":174,"_46":-5,"_47":25,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":31,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":175,"_78":176,"_80":177,"_82":25},"tree",[165,166],"files",[165,166],"counts",{"_155":60,"_156":151,"_157":60,"_158":159,"_160":161},"contents",[139,140],"upstreamProject",{"_42":91,"_32":136,"_51":137,"_53":-5,"_48":49,"_76":138},"upstreamBranch",{"_42":87,"_37":130,"_131":132,"_32":84,"_85":91,"_13":133,"_86":-5,"_88":-5,"_134":135,"_46":-5,"_82":25,"_48":49,"_94":95,"_61":62,"_93":136},"emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},["D",1789468673039],"updatedAt",["D",1789550553221],80,"lockfileKey","1789550553430-esm.town_v_aminfarhang_amina-character-studio-mcp@80-main","amina-character-studio-mcp","AminA Character Studio MCP connector",{"_96":95,"_104":100},{"_42":148,"_32":149,"_30":150,"_142":-5,"_40":41,"_39":151,"_143":125,"_37":152,"_13":60,"_33":20,"_35":153,"_24":25,"_146":-5,"_27":154},{"_42":141,"_32":28,"_30":31,"_142":-5,"_40":41,"_39":14,"_143":25,"_37":144,"_13":145,"_33":34,"_35":36,"_24":25,"_146":44,"_27":147},"4d969eb8-6475-402e-b297-a6b5e9f8ee16","parentId","latest",["D",1789475977484],3,"label",[28],"71540e14-6f1c-474f-a3f4-0b8707d6b4f6","README.md","01a0a4ce-0e3e-7033-86bd-6ee0de657ed0",1,["D",1789471362559],"# 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.",[149],"pulls","branches","forks","envVars",{"_162":60,"_164":60},"connections",{"_162":60,"_163":60},"count","unfilledCount","emptyCount",{"_42":148,"_32":149,"_30":150,"_142":-5,"_40":41,"_39":151,"_143":125,"_37":171,"_13":60,"_33":20,"_35":153,"_24":25,"_146":-5,"_168":172,"_27":173},{"_42":141,"_32":28,"_30":31,"_142":-5,"_40":41,"_39":14,"_143":25,"_37":167,"_13":145,"_33":34,"_35":36,"_24":25,"_146":44,"_168":169,"_27":170},["D",1789475977484],"children",[],[28],["D",1789471362559],[],[149],["D",1789471362559],{"_96":95,"_104":100},{"_96":95,"_97":98,"_99":100,"_18":54,"_101":102,"_103":25},{"_13":83,"_32":84,"_42":41,"_85":43,"_86":87,"_88":83,"_89":49,"_90":91,"_92":62,"_93":44,"_94":95},"ctx",{"_76":-5,"_127":211,"_212":213,"_214":215,"_216":25,"_217":25,"_218":25,"_219":125,"_220":-5,"_221":-7,"_222":-7,"_223":60,"_224":25,"_225":25,"_226":-5,"_227":25,"_228":25,"_229":25,"_230":-5},"ENV",{"_182":183,"_184":185,"_186":84,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210},"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 · v4