[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_159":160,"_161":162},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_86":-7,"_87":88,"_29":-7,"_89":-5,"_15":90,"_91":92,"_93":94,"_95":96,"_97":98,"_99":-5,"_100":-5,"_101":-5,"_102":73,"_103":104,"_105":73,"_106":-5,"_107":-5,"_108":109},"routes/_app.x.$handle.$name.branches",{"_11":12,"_13":14,"_15":16,"_17":18},"handle","xkonti","name","gptApiFramework","project",{"_20":28,"_13":14,"_22":35,"_34":-5,"_36":37,"_38":39,"_40":39,"_41":-5,"_42":-5,"_43":44,"_45":-5,"_46":37,"_47":-5,"_48":-5,"_49":50,"_51":52,"_53":-5,"_54":-5,"_55":-5,"_56":-5,"_57":58,"_59":58,"_60":61,"_62":61,"_63":61,"_64":58,"_65":58,"_66":67,"_68":69,"_70":71,"_72":73},"branches",[19],{"_20":21,"_22":23,"_24":25,"_13":26,"_27":28,"_29":30,"_31":-5,"_32":-5,"_33":-5,"_34":-5},"id","4976529c-279c-11f0-9d52-569c3dd06744","createdAt",["D",1746221264932],"updatedAt",["D",1716959237147],"main","projectId","4976065c-279c-11f0-9d52-569c3dd06744","version",68,"forkedBranchId","forkedBranchVersion","lockfileKey","deletedAt",["D",1746221264932],"legacyEnvVars",true,"privacy","public","httpPrivacy","description","imageUrl","userId","c183ed03-e3c2-419d-bb34-16caedc74b26","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",2,"orgId","5e5de42a-e7ad-44f1-bdfc-fb2991b3e132","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_85":81},"org",{"_11":12,"_79":-5,"_80":81,"_43":44,"_82":83,"_84":73},"branch",{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_74":-5,"_75":-5,"_76":-5,"_77":14,"_78":12},"isOwned",false,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yVHI5VU1vZnR6eGE0c0FTaThzTEtZTUxNMVYuanBlZyJ9","tier","free","canRestrictVals","profileImageUrl","branchName","path","","adoptOrgId",{"_20":28,"_13":14,"_22":155,"_34":-5,"_36":37,"_38":39,"_40":39,"_41":-5,"_42":-5,"_43":44,"_45":-5,"_46":37,"_47":-5,"_48":-5,"_49":50,"_51":52,"_53":-5,"_54":-5,"_55":-5,"_56":-5,"_57":58,"_59":58,"_60":61,"_62":61,"_63":61,"_64":58,"_65":58,"_66":156,"_68":157,"_70":158,"_72":73},"tree",[146,147],"files",[146,147],"counts",{"_137":134,"_17":132,"_138":132,"_139":140,"_141":142},"contents",[110,111],"file","upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_20":129,"_13":130,"_114":131,"_116":-5,"_117":21,"_118":132,"_119":37,"_22":133,"_29":134,"_122":99,"_124":135,"_126":73,"_127":-5,"_87":136},{"_20":112,"_13":113,"_114":115,"_116":-5,"_117":21,"_118":30,"_119":37,"_22":120,"_29":121,"_122":123,"_124":125,"_126":73,"_127":-5,"_87":128},"4aebf230-279c-11f0-9d52-569c3dd06744","main.tsx","fileId","497909b0-279c-11f0-9d52-569c3dd06744","parentId","branchId","branchVersion","latest",["D",1716959237147],67,"fileType","script","content","import type { Context } from \"npm:hono@3\";\nimport { Hono } from \"npm:hono@3\";\nimport { z } from \"npm:zod\";\nimport { zodToJsonSchema } from \"npm:zod-to-json-schema\";\n\nexport type HttpVerb = \"get\" | \"post\" | \"put\" | \"delete\" | \"patch\";\n\n/**\n * Base interface for defining an endpoint.\n * This does not include request or response schemas.\n */\nexport interface EndpointDefBase {\n verb: HttpVerb;\n path: string;\n desc: string;\n operationId: string;\n}\n\n/**\n * Used o define an endpoint with request and response schemas\n * along with descriptions for each.\n */\nexport interface EndpointDefinition extends EndpointDefBase {\n requestSchema: z.Schema | null;\n requestDesc: string | null;\n responseSchema: z.Schema | null;\n responseDesc: string | null;\n}\n\n/**\n * Used to define an input-only endpoint with a request schema,\n * but no response schema.\n */\nexport interface InEndpointDefinition extends EndpointDefBase {\n requestSchema: TRequestSchema;\n}\n\n/**\n * Used to define an output-only endpoint with a response schema,\n * but no request schema.\n */\nexport interface OutEndpointDefinition extends EndpointDefBase {\n responseSchema: TResponseSchema;\n}\n\n/**\n * Used to define an input/output endpoint with both a request and\n * response schema.\n */\nexport interface InOutEndpointDefinition\n extends EndpointDefBase {\n requestSchema: TRequestSchema;\n responseSchema: TResponseSchema;\n}\n\n/**\n * The API info object that is used to describe the API to the GPT.\n */\nexport interface ApiInfo {\n /**\n * The URL of the API. This should match the URL of your Val.\n */\n url: string;\n\n /**\n * The name of the API. It gives the GPT an idea about the purpose of the API.\n */\n title: string;\n\n /**\n * A short description of the API. It gives the GPT an idea about the purpose of the API.\n */\n description: string;\n\n /**\n * The version of the API. Required by the OpenAPI spec.\n */\n version: string;\n\n /**\n * An optional function that returns the policy to be used available at `/privacypolicy`.\n */\n policyGetter?: (() => string) | (() => Promise);\n}\n\n/**\n * Returns the JSON schema for a Zod schema.\n * @param schema The Zod schema to convert.\n * @returns The generated JSON schema.\n */\nfunction getSchemaDesc(schema: z.Schema | null) {\n if (!schema) return null;\n return zodToJsonSchema(schema, {\n name: \"schema\",\n target: \"openApi3\",\n }).definitions?.schema ?? null;\n}\n\n/**\n * Describes the schema of an endpoint.\n */\ninterface EndpointSchema {\n description: string;\n operationId: string;\n requestBody?: {\n description: string;\n required: boolean;\n content: {\n [key: string]: {\n schema: ReturnType;\n };\n };\n } | null;\n responses: {\n [key: string]: {\n description: string;\n content: {\n [key: string]: {\n schema: ReturnType;\n };\n };\n };\n };\n}\n\n/**\n * Describes the paths of an OpenAPI spec.\n */\ntype Paths = {\n [key: string]: Partial<\n {\n [key in HttpVerb]: EndpointSchema;\n }\n >;\n};\n\n/**\n * Assembles the paths of an OpenAPI spec from endpoint definitions.\n * @param endpoints The endpoint definitions to use.\n * @returns The paths of the OpenAPI spec.\n */\nfunction getPathsDesc(endpoints: EndpointDefinition[]): Paths {\n const paths: Paths = {};\n for (const endpoint of endpoints) {\n // This is to allow multiple endpoints with the same path but different verbs\n if (!paths[endpoint.path]) {\n paths[endpoint.path] = {};\n }\n paths[endpoint.path][endpoint.verb] = {\n description: endpoint.desc,\n operationId: endpoint.operationId,\n requestBody: endpoint.requestSchema\n ? {\n description: endpoint.requestDesc ?? \"Request body\",\n required: true,\n content: {\n \"application/json\": {\n schema: getSchemaDesc(endpoint.requestSchema),\n },\n },\n }\n : undefined,\n responses: {\n \"200\": {\n description: endpoint.responseDesc ?? \"Success\",\n content: {\n \"application/json\": {\n schema: getSchemaDesc(endpoint.responseSchema),\n },\n },\n },\n },\n };\n }\n\n return paths;\n}\n\n/**\n * Generates an OpenAPI spec for the defined API.\n * @param url The URL of the API.\n * @param title The title of the API.\n * @param description The description of the API.\n * @param version The version of the API.\n * @param endpoints The endpoint definitions to use.\n * @returns The OpenAPI spec.\n */\nfunction getOpenApiSpec(\n url: string,\n title: string,\n description: string,\n version: string,\n endpoints: EndpointDefinition[],\n) {\n return {\n openapi: \"3.1.0\",\n info: {\n title,\n description,\n version,\n },\n servers: [\n {\n url,\n },\n ],\n paths: getPathsDesc(endpoints),\n };\n}\n\n/**\n * A class representing a GPT API. It provides methods for registering\n * endpoints and serving the API.\n */\nexport class GptApi {\n private app = new Hono();\n private info: ApiInfo;\n private endpoints: EndpointDefinition[] = [];\n\n /**\n * Creates a new GptApi instance.\n * @param info Configuration for the API.\n */\n constructor(info: ApiInfo) {\n this.info = info;\n this.app.get(\"/gpt/schema\", (ctx) => {\n const spec = getOpenApiSpec(\n this.info.url,\n this.info.title,\n this.info.description,\n this.info.version,\n this.endpoints,\n );\n return ctx.text(JSON.stringify(spec, null, 2));\n });\n\n if (info.policyGetter != null) {\n const policyGetter = info.policyGetter;\n this.app.get(\"/privacypolicy\", async (ctx) => {\n let content = await policyGetter();\n content = content.trim();\n if (content.endsWith(\"\")) {\n return ctx.html(content);\n }\n else {\n return ctx.text(content);\n }\n });\n }\n\n this.app.get(\"/\", (ctx) => {\n return ctx.text(`OpenAPI spec: ${this.info.url}/gpt/schema\\nPrivacy policy: ${this.info.url}/privacypolicy\\n`);\n });\n }\n\n /**\n * Register an endpoint that accepts JSON input and returns\n * only a status code.\n * @param endpointDef Definition of the endpoint.\n * @param handler Function that handles the request.\n */\n jsonToNothing(\n endpointDef: InEndpointDefinition,\n handler: (ctx: Context, reqBody: z.infer, apiKey: string | null) => Promise,\n ) {\n const handlerWrapper = async (ctx: Context) => {\n const requestBody = await ctx.req.json();\n\n // Validate request data\n const parsedRequestData = endpointDef.requestSchema.parse(requestBody) as z.infer;\n // TODO: Handle invalid data format\n\n const apiKey = this.extractApiKey(ctx);\n const statusCode = await handler(ctx, parsedRequestData, apiKey);\n return ctx.body(null, statusCode as StatusCode);\n };\n\n // Transform to EndpointDefinition\n const eDef = endpointDef as unknown as EndpointDefinition;\n eDef.requestDesc = endpointDef.requestSchema.description ?? \"Request body\";\n eDef.responseSchema = null;\n eDef.responseDesc = null;\n\n // TODO: Verify request schema is in place\n this.registerHandler(eDef, handlerWrapper);\n }\n\n /**\n * Register an endpoint that ignores all inputs and\n * returns a specific JSON response.\n * @param endpointDef Definition of the endpoint.\n * @param handler Function that handles the request.\n */\n nothingToJson(\n endpointDef: OutEndpointDefinition,\n handler: (ctx: Context, apiKey: string | null) => Promise>,\n ) {\n const handlerWrapper = async (ctx: Context) => {\n const apiKey = this.extractApiKey(ctx);\n const response = await handler(ctx, apiKey);\n\n // Validate response data\n const parsedResponseData = endpointDef.responseSchema.parse(response) as z.infer;\n\n return ctx.json(parsedResponseData);\n };\n\n // Transform to EndpointDefinition\n const eDef = endpointDef as unknown as EndpointDefinition;\n eDef.requestSchema = null;\n eDef.requestDesc = null;\n eDef.responseDesc = endpointDef.responseSchema.description ?? \"Response body\";\n\n // TODO: Verify response stuff is in place\n this.registerHandler(eDef, handlerWrapper);\n }\n\n /**\n * Register an endpoint that accepts a JSON request and\n * returns a specific JSON response.\n * @param endpointDef Definition of the endpoint.\n * @param handler Function that handles the request.\n */\n jsonToJson(\n endpointDef: InOutEndpointDefinition,\n handler: (\n ctx: Context,\n reqBody: z.infer,\n apiKey: string | null,\n ) => Promise>,\n ) {\n // TODO: Verify request and response is in place\n const handlerWrapper = async (ctx: Context) => {\n const requestBody = await ctx.req.json();\n\n // Validate request data\n const parsedRequestData = endpointDef.requestSchema.parse(requestBody) as z.infer;\n // TODO: Handle invalid data format\n\n const apiKey = this.extractApiKey(ctx);\n const response = await handler(ctx, parsedRequestData, apiKey);\n\n // Validate response data\n const parsedResponseData = endpointDef.responseSchema.parse(response) as z.infer;\n return ctx.json(parsedResponseData);\n };\n\n // Transform to EndpointDefinition\n const eDef = endpointDef as unknown as EndpointDefinition;\n eDef.requestDesc = endpointDef.requestSchema.description ?? \"Request body\";\n eDef.responseDesc = endpointDef.responseSchema.description ?? \"Response body\";\n this.registerHandler(eDef, handlerWrapper);\n }\n\n /**\n * Regusters a handler for a verb + path combo.\n * @param endpointDef Definition of the endpoint.\n * @param handler Function that handles the request.\n */\n private registerHandler(\n endpointDef: EndpointDefinition,\n handler: (ctx: Context) => Response | Promise,\n ) {\n this.endpoints.push(endpointDef);\n\n const verb = endpointDef.verb;\n const path = endpointDef.path;\n switch (verb) {\n case \"get\":\n this.app.get(path, handler);\n break;\n case \"post\":\n this.app.post(path, handler);\n break;\n case \"put\":\n this.app.put(path, handler);\n break;\n case \"delete\":\n this.app.delete(path, handler);\n break;\n case \"patch\":\n this.app.patch(path, handler);\n break;\n default:\n throw new Error(`HTTP verb ${verb} not supported`);\n }\n }\n\n /**\n * Returns a function that can be used to serve the API.\n * \n * @example ValTown usage:\n * ```ts\n * export default gptApi.serve();\n * ```\n * \n * @example Deno usage:\n * ```\n * const { fetch } = gptApi.serve();\n * export default { fetch };\n * ```\n */\n serve(): typeof Hono.prototype.fetch {\n return this.app.fetch;\n }\n\n /**\n * Extracts API key from Bearer Auth header.\n */\n private extractApiKey(ctx: Context): string | null {\n const authHeader = ctx.req.header(\"Authorization\");\n if (!authHeader || !authHeader.startsWith(\"Bearer \")) {\n return null;\n }\n\n const apiKey = authHeader.split(\" \")[1];\n return apiKey;\n }\n}","deleted","label",[113],"49790e4c-279c-11f0-9d52-569c3dd06744","README.md","49790ece-279c-11f0-9d52-569c3dd06744",1,["D",1703723966174],0,"Allows for automatic generation of Hono API compatible with GPTs. Endpoints' inputs and outputs need to be specified via types from which the Open API spec is generated automatically and available via `/gpt/schema` endpoint.\n\n> ⚠️ Breaking changes introduced in v23 & 24:\n> - `nothingToJson` doesn't take the generic `TResponse` anymore. The type is inferred from the endpoint definition. The endpoint definition doesn't need the `requestSchema`, `requestDesc` and `responseDesc` defined anymore. The descriptions are inferred from the schema description.\n> - `jsonToJson` doesn't take the generic `TRequest` and `TResponse` anymore. Types are inferred from the endpoint definition. The endpoint definition doesn't need the `requestDesc` and `responseDesc` defined anymore. The descriptions are inferred from the schema description.\n\nUsage example:\n\n```ts\nimport { GptApi } from \"https://esm.town/v/xkonti/gptApiFramework\";\nimport { z } from \"npm:zod\";\n\n/**\n * COMMON TYPES\n */\n\nconst ResponseCommandSchema = z.object({\n feedback: z.string().describe(\"Feedback regarding submitted action\"),\n command: z.string().describe(\"The command for the Mediator AI to follow strictly\"),\n data: z.string().optional().describe(\"Additional data related to the given command\"),\n}).describe(\"Contains feedback and further instructions to follow\");\n\n/**\n * INITIALIZE API\n */\n\nconst api = new GptApi({\n url: \"https://xkonti-planoverseerai.web.val.run\",\n title: \"Overseer AI API\",\n description: \"The API for interacting with the Overseer AI\",\n version: \"1.0.0\",\n policyGetter: async () => {\n const { markdownToPrettyPage } = await import(\"https://esm.town/v/xkonti/markdownToHtmlPage?v=5\");\n return await markdownToPrettyPage(\"# Privacy Policy\\n\\n## Section 1...\");\n },\n});\n\n/**\n * REQUIREMENTS GATHERING ENDPOINTS\n */\n\napi.nothingToJson({\n verb: \"POST\",\n path: \"/newproblem\",\n operationId: \"new-problem\",\n desc: \"Endpoint for informing Overseer AI about a new problem presented by the User\",\n responseSchema: ResponseCommandSchema,\n responseDesc: \"Instruction on how to proceed with the new problem\",\n}, async (ctx) => {\n return {\n feedback: \"User input downloaded. Problem analysis is required.\",\n command: await getPrompt(\"analyze-problem\"),\n data: \"\",\n };\n});\n\nexport default api.serve();\n```\n\nMigrated from folder: GPTs/ApiFramework/gptApiFramework",[130],"pulls","forks","envVars",{"_143":134,"_145":134},"connections",{"_143":134,"_144":134},"count","unfilledCount","emptyCount",{"_20":129,"_13":130,"_114":131,"_116":-5,"_117":21,"_118":132,"_119":37,"_22":152,"_29":134,"_122":99,"_124":135,"_126":73,"_127":-5,"_149":153,"_87":154},{"_20":112,"_13":113,"_114":115,"_116":-5,"_117":21,"_118":30,"_119":37,"_22":148,"_29":121,"_122":123,"_124":125,"_126":73,"_127":-5,"_149":150,"_87":151},["D",1716959237147],"children",[],[113],["D",1703723966174],[],[130],["D",1746221264932],{"_11":12,"_85":81},{"_11":12,"_79":-5,"_80":81,"_43":44,"_82":83,"_84":73},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_74":-5,"_75":-5,"_76":-5,"_77":14,"_78":12},"ctx",{"_66":-5,"_107":192,"_193":194,"_195":196,"_197":73,"_198":73,"_199":73,"_200":37,"_201":-5,"_202":-7,"_203":-7,"_204":134,"_205":73,"_206":73,"_207":-5,"_208":73,"_209":73,"_210":73,"_211":-5},"ENV",{"_163":164,"_165":166,"_167":26,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","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"]

Branches1

Branches
1