[{"_1":2,"_293":-5,"_294":-5},"loaderData",{"_3":4,"_95":96,"_259":260,"_292":-5},"root",{"_5":6,"_34":35,"_62":63,"_93":94},"ctx",{"_7":8,"_19":20,"_21":-5,"_22":23,"_24":25,"_26":27,"_28":27,"_29":27,"_30":31,"_32":33},"auth",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5},"sessionClaims","sessionId","sessionStatus","userId","actor","orgId","orgRole","orgSlug","orgPermissions","factorVerificationAge","environmentVariableKeys",[],"user","preferences_keybindings","default","preferences_theme","light","preferences_fixers",false,"preferences_copilot","preferences_selection_ai","preferences_model","claude-3-5-haiku-20241022","notification_count",0,"ENV",{"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":59,"_60":61},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","VAL_RUNTIME_NAME","prod","RENDER_GIT_COMMIT","31051805bc0faf27eb1ddcea20d3924383f1820f","RENDER_GIT_BRANCH","main","CLERK_PUBLISHABLE_KEY","pk_live_Y2xlcmsudmFsLnRvd24k","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/","API_URL","https://api.val.town","WORKER_FINGERPRINT","fd7e47ba602df66e0f857b45e802b861","clerkState",{"_64":65},"__internal_clerk_state",{"_66":67,"_68":45,"_69":70,"_71":70,"_72":27,"_73":70,"_74":70,"_75":70,"_76":70,"_77":70,"_78":70,"_79":70,"_80":70,"_81":82,"_91":27,"_92":27},"__clerk_ssr_state",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5},"__publishableKey","__proxyUrl","","__domain","__isSatellite","__signInUrl","__signUpUrl","__afterSignInUrl","__afterSignUpUrl","__signInForceRedirectUrl","__signUpForceRedirectUrl","__signInFallbackRedirectUrl","__signUpFallbackRedirectUrl","__clerk_debug",{"_83":27,"_84":70,"_85":86,"_87":70,"_88":45,"_89":27,"_90":70},"isSignedIn","proxyUrl","reason","session-token-and-uat-missing","message","publishableKey","isSatellite","domain","__telemetryDisabled","__telemetryDebug","remixVersion",2,"routes/_app.v.$handle.$name",{"_97":98,"_99":100,"_98":101,"_205":-5,"_206":-5,"_207":208,"_137":138,"_146":147,"_104":105,"_102":103,"_123":-7,"_52":53,"_258":27},"type","val","author","c183ed03-e3c2-419d-bb34-16caedc74b26",{"_102":103,"_99":100,"_104":105,"_106":107,"_108":-5,"_109":110,"_111":112,"_113":114,"_115":116,"_117":27,"_118":116,"_119":120,"_121":122,"_123":124,"_125":27,"_126":94,"_127":128,"_129":130,"_131":94,"_132":133,"_134":33,"_135":-5,"_21":136,"_141":-5,"_142":-5,"_143":-7,"_144":145,"_146":147,"_148":149},"name","gptApiFramework","valNameId","a6204be3-87ba-4cd6-bf97-af43908129c8","parentFolderId","93346128-e1dd-42e9-b859-8055ec2c82eb","isOwned","privacy","public","readme","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```","valType","script","currentVersion","51bec264-1d79-11ef-83de-cab58f78796a","legacyPrivate","id","code","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}","createdAt",["D",1716959237147],"version",67,"currentUserHasLiked","likeCount","forkCount",1,"referenceCount",47,"dependencyCount","commentCount",9,"prCount","mergedPr",{"_137":138,"_139":140},"handle","xkonti","profileImageUrl","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yVHI5VU1vZnR6eGE0c0FTaThzTEtZTUxNMVYuanBlZyJ9","forkedVal","fileId","interval","slug","xkonti/gptApiFramework","description","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. ⚠️ Breaking changes introduced in v23 & 24: 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. 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. Usage example: import { 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();","versions",[150,153,157,161,165,169,173,177,181,185,189,193,197,201],{"_123":124,"_151":-5,"_121":152,"_118":116},"prId",["D",1716959237147],{"_123":154,"_151":-5,"_121":155,"_118":156},36,["D",1716926726489],"9fe21668-1d2d-11ef-ae5e-cab58f78796a",{"_123":158,"_151":-5,"_121":159,"_118":160},32,["D",1716925910129],"b94b760a-1d2b-11ef-8945-cab58f78796a",{"_123":162,"_151":-5,"_121":163,"_118":164},29,["D",1716099294886],"1c372714-15a7-11ef-b59d-cab58f78796a",{"_123":166,"_151":-5,"_121":167,"_118":168},28,["D",1715983910415],"75b635e0-149a-11ef-bbf0-cab58f78796a",{"_123":170,"_151":-5,"_121":171,"_118":172},27,["D",1715982974680],"47f86a94-1498-11ef-8156-cab58f78796a",{"_123":174,"_151":-5,"_121":175,"_118":176},26,["D",1715980954500],"93d96454-1493-11ef-931c-cab58f78796a",{"_123":178,"_151":-5,"_121":179,"_118":180},25,["D",1715921151041],"5635af44-1408-11ef-b354-cab58f78796a",{"_123":182,"_151":-5,"_121":183,"_118":184},24,["D",1715920435944],"abfa865e-1406-11ef-a7ab-cab58f78796a",{"_123":186,"_151":-5,"_121":187,"_118":188},23,["D",1715918169319],"64f6f670-1401-11ef-8826-cab58f78796a",{"_123":190,"_151":-5,"_121":191,"_118":192},18,["D",1715753348769],"a442f6a2-1281-11ef-83fe-cab58f78796a",{"_123":194,"_151":-5,"_121":195,"_118":196},17,["D",1715752944927],"b38d9320-1280-11ef-afe1-cab58f78796a",{"_123":198,"_151":-5,"_121":199,"_118":200},16,["D",1715752145160],"d6dab7f6-127e-11ef-aa9b-cab58f78796a",{"_123":202,"_151":-5,"_121":203,"_118":204},15,["D",1705128177643],"fcc13ea0-b1de-11ee-9c5b-325518e2651b","recentThread","breadcrumbs","comments",[209,218,223,228,233,238,243,248,253],{"_118":210,"_211":212,"_121":213,"_214":-5,"_215":27,"_216":27,"_21":217},"c86da5d2-1401-11ef-b438-cab58f78796a","body","Version 23 changelog:\n⚠️ Breaking changes:\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` defined anymore.\n- `jsonToJson` doesn't take the generic `TRequest` and `TResponse` anymore. Types are inferred from the endpoint definition.\n\nOther changes:\n- Added `jsonToNothing` that accepts an input, but can respond only with an HTTP code.",["D",1715918336192],"updatedAt","canDelete","canEdit",{"_137":138,"_139":140},{"_118":219,"_211":220,"_121":221,"_214":-5,"_215":27,"_216":27,"_21":222},"53dbd90e-1407-11ef-a65f-cab58f78796a","## Version 24 changelog\n\n⚠️ Breaking change: `jsonToNothing`, `nothingToJson` and `jsonToJson` don't accept the request/response descriptions. The descriptions are automatically extracted from request/response schemas.",["D",1715920717601],{"_137":138,"_139":140},{"_118":224,"_211":225,"_121":226,"_214":-5,"_215":27,"_216":27,"_21":227},"97769d92-1408-11ef-bf9d-cab58f78796a","## Version 25 changelog\n\nThe `dto` in request handlers has been renamed to `reqBody`.",["D",1715921260519],{"_137":138,"_139":140},{"_118":229,"_211":230,"_121":231,"_214":-5,"_215":27,"_216":27,"_21":232},"d906b108-1493-11ef-9be4-cab58f78796a","## Version 26 changelog\n\nAdded config option `policyGetter` which takes a function that returns the privacy policy. This will automatically create an API endpoint `/policy` that will return it on demand. The policy getter is a function so that the policy can be imported on-demand.",["D",1715981070561],{"_137":138,"_139":140},{"_118":234,"_211":235,"_121":236,"_214":-5,"_215":27,"_216":27,"_21":237},"656065fe-1499-11ef-9199-cab58f78796a","## Version 27 changelog\n\nThe `policyGetter` can be an async function now. This supports passing it functions like this:\n```ts\n... ,\npolicyGetter: async () => {\n const { policy } = await import(\"https://esm.town/v/user/val\");\n return policy;\n},\n```",["D",1715983453513],{"_137":138,"_139":140},{"_118":239,"_211":240,"_121":241,"_214":-5,"_215":27,"_216":27,"_21":242},"eb78cac8-15a7-11ef-8f6d-cab58f78796a","## Version 29 changelog\n\nIf the provided privacy policy ends with ``, the `/privacypolicy` endpoint will return it as HTML content instead of plaintext.",["D",1716099642605],{"_137":138,"_139":140},{"_118":244,"_211":245,"_121":246,"_214":-5,"_215":27,"_216":27,"_21":247},"068c822e-1d2c-11ef-bda4-cab58f78796a","## Version 32 changelog\n\n- Merged schema builder into the Val\n- Improved TypeScript type definitions\n- Http verbs are now lowercase",["D",1716926039740],{"_137":138,"_139":140},{"_118":249,"_211":250,"_121":251,"_214":-5,"_215":27,"_216":27,"_21":252},"e6082790-1d2d-11ef-a1bf-cab58f78796a","## Version 36 changelog\n\n- Added a default GET for `/` path that deisplays URLs of privacy policy and OpenAPI spec",["D",1716926844179],{"_137":138,"_139":140},{"_118":254,"_211":255,"_121":256,"_214":-5,"_215":27,"_216":27,"_21":257},"865211dc-1d7b-11ef-9f94-cab58f78796a","## Version 67 changelog\n\n- Improved documentation",["D",1716960184347],{"_137":138,"_139":140},"isOwner","routes/_app.v.$handle.$name.forks",{"_261":262,"_288":128,"_289":145,"_290":33,"_98":291},"forksList",[263],{"_104":264,"_265":266},"b6f20270-be12-11ee-9470-325518e2651b","initialData",{"_102":103,"_99":267,"_104":264,"_106":-5,"_108":-5,"_109":110,"_111":268,"_113":114,"_115":269,"_117":27,"_118":269,"_119":270,"_121":271,"_123":128,"_125":27,"_126":33,"_129":128,"_131":128,"_132":33,"_127":33,"_134":33,"_135":-5,"_21":272,"_141":275,"_143":-7,"_146":277,"_278":-5,"_144":279,"_148":280},"70d9da4f-815a-47a2-bc28-b50a8a437440","Allows for automatic generation of Hono API comatible 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\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\nexport type ResponseCommand = z.infer;\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});\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 requestSchema: null,\n requestDesc: null,\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```","d5b3c5ae-be12-11ee-a381-325518e2651b","import { EndpointDefinition, getOpenApiSpec } from \"https://esm.town/v/xkonti/gptApiSchemaBuilder\";\nimport { Hono } from \"npm:hono@3\";\nimport { z } from \"npm:zod\";\n\nexport interface ApiInfo {\n url: string;\n title: string;\n description: string;\n version: string;\n}\n\nexport class GptApi {\n app = new Hono();\n info: ApiInfo;\n endpoints: EndpointDefinition[] = [];\n\n constructor(info: ApiInfo) {\n this.info = info;\n this.app.get(\"/gpt/schema\", async (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\n /**\n * Register endpoint that ignores all inputs and returns a specific JSON response.\n */\n nothingToJson(\n endpointDef: EndpointDefinition,\n handler: (ctx) => Promise,\n ) {\n endpointDef.requestDesc = null;\n endpointDef.requestSchema = null;\n\n const handlerWrapper = async (ctx) => {\n const response = await handler(ctx);\n return ctx.json(response);\n };\n\n // TODO: Verify response stuff is in place\n this.registerHandler(endpointDef, handlerWrapper);\n }\n\n /**\n * Register endpoint that accepts a JSON DTO and returns a specific JSON response.\n */\n jsonToJson(\n endpointDef: EndpointDefinition,\n handler: (ctx, dto: TRequest) => Promise,\n ) {\n // TODO: Verify request and response is in place\n const handlerWrapper = async (ctx) => {\n const data = await ctx.req.json() as TRequest;\n // TODO: Handle invalid data format\n const response = await handler(ctx, data);\n return ctx.json(response);\n };\n\n this.registerHandler(endpointDef, handlerWrapper);\n }\n\n // Registers a handler for a verb + path combo.\n registerHandler(\n endpointDef: EndpointDefinition,\n handler: (ctx) => any,\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 * Usage: `export default gptApi.serve();`\n */\n serve() {\n return this.app.fetch;\n }\n}",["D",1706469859907],{"_137":273,"_139":274},"vlad","https://secure.gravatar.com/avatar/04c08796b992ab05dea8989ce42be299.jpg?s=200&d=identicon",{"_118":204,"_137":138,"_102":103,"_123":202,"_276":-5},"prDisabledHint","Allows for automatic generation of Hono API comatible 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. Usage example: import { 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\nexport type ResponseCommand = z.infer;\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});\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 requestSchema: null,\n requestDesc: null,\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();","latestEvaluation","vlad/gptApiFramework",[281,285],{"_121":282,"_123":128,"_283":284},["D",1706469859907],"n","1",{"_121":286,"_123":33,"_283":287},["D",1706469808314],"2","forksCount","valname","page",{"_118":116,"_102":103,"_137":138,"_12":100,"_123":124,"_104":105,"_142":-5,"_119":120,"_109":110,"_117":27,"_144":145},"routes/_app","actionData","errors"]