Structured Web Knowledge API

\n \n \n \n`;\n return new Response(html, { status: 200, headers: { \"content-type\": \"text/html; charset=utf-8\" } });\n }\n\n if (method === \"GET\" && path === \"/mcp\") {\n return text(\"Method Not Allowed\", 405);\n }\n\n return text(\"Not Found\", 404);\n } catch (e: any) {\n // Let errors bubble with full context\n throw e;\n }\n}\n",[],[150,169,176],[150,169],{"_105":186,"_98":187,"_151":188,"_153":152,"_154":136,"_155":189,"_157":158,"_107":190,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":191,"_101":201},"dd4ea608-74c3-11f0-9285-0224a6c84d84","services","dd4ea6b2-74c3-11f0-9285-0224a6c84d84",4,["D",1754704502881],[192],{"_105":193,"_98":194,"_151":195,"_153":188,"_154":136,"_155":196,"_157":158,"_107":197,"_102":29,"_160":180,"_162":198,"_163":25,"_164":-5,"_165":199,"_101":200},"dd674c4e-74c3-11f0-b6be-0224a6c84d84","aimlapi.ts","dd674d02-74c3-11f0-b6be-0224a6c84d84",7,["D",1754704503030],"// AIMLAPI client (OpenAI-compatible) for Bagoodex Web Search\n// Server-only module: do not import in client code\n\nexport interface AimlChatMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: string;\n name?: string;\n}\n\nexport interface AimlChatRequest {\n model: string; // e.g., \"bagoodex/bagoodex-search-v1\"\n messages: AimlChatMessage[];\n max_tokens?: number;\n temperature?: number;\n stream?: boolean;\n // Schema control: guided_json etc are supported by AIMLAPI\n guided_json?: unknown;\n ip?: string; // personalization\n}\n\nexport async function aimlChat(req: AimlChatRequest, apiKey: string): Promise {\n const res = await fetch(\"https://api.aimlapi.com/v1/chat/completions\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${apiKey}`,\n },\n body: JSON.stringify(req),\n });\n if (!res.ok) {\n const text = await res.text().catch(() => \"\");\n throw new Error(`AIMLAPI error ${res.status}: ${text}`);\n }\n return await res.json();\n}\n",[],[150,187,194],[150,187],{"_105":203,"_98":204,"_151":205,"_153":152,"_154":136,"_155":206,"_157":158,"_107":207,"_102":156,"_160":208,"_162":209,"_163":25,"_164":-5,"_165":210,"_101":211},"8ed5da74-74c7-11f0-a82f-0224a6c84d84","index.http.ts","dd6bcfbc-74c3-11f0-8fd7-0224a6c84d84",11,["D",1754706089169],"http","import handle from \"./routes/mcp.ts\";\n\nexport default handle; // Entry point for HTTP val\n",[],[150,204],{"_105":213,"_98":214,"_151":215,"_153":152,"_154":136,"_155":216,"_157":158,"_107":217,"_102":29,"_160":218,"_162":219,"_163":25,"_164":-5,"_165":220,"_101":221},"dd5c4470-74c3-11f0-b558-0224a6c84d84","openapi.yaml","dd5c456a-74c3-11f0-b558-0224a6c84d84",5,["D",1754704502969],"file","openapi: 3.1.0\ninfo:\n title: Mike Web - Structured Web Knowledge API\n version: \"0.1.0\"\n description: |\n HTTP REST API mirror for the MCP tool `structured_web_knowledge`.\n Performs real-time web search via AIMLAPI Bagoodex and returns a structured KnowledgePack.\nservers:\n - url: https://mike-web.web.val.run\n description: Val Town deployment URL (replace with your val's URL)\nsecurity:\n - bearerAuth: []\ntags:\n - name: knowledge\npaths:\n /api/knowledge:\n post:\n tags: [knowledge]\n summary: Create a structured knowledge pack from a web query\n description: |\n Returns structured entities, claims, relations (triples), and cited sources.\n Requires Authorization: Bearer . Optional Origin allowlist enforcement.\n operationId: createKnowledgePack\n security:\n - bearerAuth: []\n requestBody:\n required: true\n content:\n application/json:\n schema:\n $ref: '#/components/schemas/KnowledgeToolInput'\n responses:\n \"200\":\n description: OK\n content:\n application/json:\n schema:\n $ref: '#/components/schemas/KnowledgePack'\n \"400\":\n description: Invalid request or upstream formatting error\n content:\n application/json:\n schema:\n type: object\n properties:\n error:\n type: string\n \"401\":\n description: Unauthorized (missing/invalid Bearer token)\n \"403\":\n description: Forbidden origin\n \"500\":\n description: Internal server error\ncomponents:\n securitySchemes:\n bearerAuth:\n type: http\n scheme: bearer\n bearerFormat: JWT\n schemas:\n TimeRange:\n type: string\n enum: [any, year, month, week, day]\n KnowledgeToolInput:\n type: object\n properties:\n query:\n type: string\n minLength: 1\n description: User query to search the web\n timeRange:\n $ref: '#/components/schemas/TimeRange'\n maxSources:\n type: integer\n minimum: 1\n maximum: 15\n default: 6\n ip:\n type: string\n description: Optional IP for location-aware personalization\n domainAllowlist:\n type: array\n description: Prefer or constrain sources to these domains/site directives (e.g., \"site:graphlit.com\")\n items:\n type: string\n cacheTtlSeconds:\n type: integer\n minimum: 60\n maximum: 86400\n description: Override server TTL for this request\n skipCache:\n type: boolean\n description: Bypass cache and force refresh\n required: [query]\n additionalProperties: true\n KnowledgeEntity:\n type: object\n properties:\n id: { type: string }\n name: { type: string }\n type: { type: string }\n description: { type: string }\n sameAs:\n type: array\n items: { type: string }\n required: [id, name, type]\n additionalProperties: false\n KnowledgeClaim:\n type: object\n properties:\n id: { type: string }\n text: { type: string }\n confidence:\n type: number\n minimum: 0\n maximum: 1\n sourceIds:\n type: array\n items: { type: string }\n required: [id, text, confidence, sourceIds]\n additionalProperties: false\n KnowledgeRelation:\n type: object\n properties:\n subjectId: { type: string }\n predicate: { type: string }\n objectId: { type: string }\n objectText: { type: string }\n required: [subjectId, predicate]\n additionalProperties: false\n KnowledgeSource:\n type: object\n properties:\n id: { type: string }\n title: { type: string }\n url: { type: string, format: uri }\n site: { type: string }\n author: { type: string }\n publishedAt: { type: string }\n snippet: { type: string }\n required: [id, title, url]\n additionalProperties: false\n KnowledgePack:\n type: object\n properties:\n topic: { type: string }\n summary: { type: string }\n outline:\n type: array\n items: { type: string }\n entities:\n type: array\n items: { $ref: '#/components/schemas/KnowledgeEntity' }\n claims:\n type: array\n items: { $ref: '#/components/schemas/KnowledgeClaim' }\n relations:\n type: array\n items: { $ref: '#/components/schemas/KnowledgeRelation' }\n sources:\n type: array\n items: { $ref: '#/components/schemas/KnowledgeSource' }\n generatedAt:\n type: string\n description: ISO timestamp when the pack was generated\n required: [topic, summary, outline, entities, claims, relations, sources, generatedAt]\n additionalProperties: false\n",[],[150,214],[150],{"_105":224,"_98":225,"_151":226,"_153":-5,"_154":136,"_155":179,"_157":158,"_107":227,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":228,"_101":238},"dd2d4bac-74c3-11f0-9285-0224a6c84d84","shared","dd2d4c6a-74c3-11f0-9285-0224a6c84d84",["D",1754704502656],[229],{"_105":230,"_98":231,"_151":232,"_153":226,"_154":136,"_155":233,"_157":158,"_107":234,"_102":29,"_160":180,"_162":235,"_163":25,"_164":-5,"_165":236,"_101":237},"dd697596-74c3-11f0-b558-0224a6c84d84","types.ts","dd69762c-74c3-11f0-b558-0224a6c84d84",8,["D",1754704503026],"// Shared types safe for both client and server (no Deno usage)\n\nexport type TimeRange = \"any\" | \"year\" | \"month\" | \"week\" | \"day\";\n\nexport interface KnowledgeToolInput {\n query: string;\n timeRange?: TimeRange;\n maxSources?: number; // default 6, clamp 1-15\n ip?: string; // personalization\n domainAllowlist?: string[]; // e.g., [\"site:graphlit.com\"]\n cacheTtlSeconds?: number; // optional override\n skipCache?: boolean;\n}\n\nexport interface KnowledgeEntity {\n id: string;\n name: string;\n type: string;\n description?: string;\n sameAs?: string[];\n}\n\nexport interface KnowledgeClaim {\n id: string;\n text: string;\n confidence: number; // 0..1\n sourceIds: string[]; // link to sources by id\n}\n\nexport interface KnowledgeRelation {\n subjectId: string;\n predicate: string;\n objectId?: string;\n objectText?: string;\n}\n\nexport interface KnowledgeSource {\n id: string;\n title: string;\n url: string;\n site?: string;\n author?: string;\n publishedAt?: string; // ISO\n snippet?: string;\n}\n\nexport interface KnowledgePack {\n topic: string;\n summary: string;\n outline: string[];\n entities: KnowledgeEntity[];\n claims: KnowledgeClaim[];\n relations: KnowledgeRelation[]; // simple triples\n sources: KnowledgeSource[];\n generatedAt: string; // ISO timestamp\n}\n",[],[225,231],[225],"files",[148,167,174,185,192,202,212,223,229],"counts",{"_243":29,"_244":156,"_245":29,"_246":179},"pulls","branches","forks","envVars","contents",[249,252],{"_105":149,"_98":150,"_151":152,"_153":-5,"_154":136,"_155":156,"_157":158,"_107":250,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_101":251},["D",1754704502543],[150],{"_105":224,"_98":225,"_151":226,"_153":-5,"_154":136,"_155":179,"_157":158,"_107":253,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_101":254},["D",1754704502656],[225],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","routes/_app.x.$handle.$name._index",{"_96":97,"_98":99,"_100":-7,"_102":-7,"_103":261,"_247":265,"_270":-7,"_271":-5,"_272":-5,"_239":273,"_301":302},{"_105":106,"_98":99,"_107":262,"_109":-5,"_110":25,"_111":112,"_113":71,"_114":-5,"_12":115,"_116":-5,"_117":25,"_118":-5,"_119":29,"_14":120,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_19":263,"_133":264,"_145":25},["D",1754704148156],{"_96":97,"_131":132},{"_102":135,"_98":40,"_105":136,"_137":106,"_138":-5,"_139":-5,"_140":-5,"_141":-5,"_142":-5,"_143":99,"_144":97},[266,268],{"_105":149,"_98":150,"_151":152,"_153":-5,"_154":136,"_155":156,"_157":158,"_107":250,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_101":267},[150],{"_105":224,"_98":225,"_151":226,"_153":-5,"_154":136,"_155":179,"_157":158,"_107":253,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_101":269},[225],"readme","upstream","pull",[274,276,278,282,284,288,291,295,297],{"_105":149,"_98":150,"_151":152,"_153":-5,"_154":136,"_155":156,"_157":158,"_107":159,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":275,"_101":294},[276,282,288,291],{"_105":168,"_98":169,"_151":170,"_153":152,"_154":136,"_155":171,"_157":158,"_107":172,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":277,"_101":281},[278],{"_105":175,"_98":176,"_151":177,"_153":170,"_154":136,"_155":135,"_157":158,"_107":178,"_102":179,"_160":180,"_162":181,"_163":25,"_164":-5,"_165":279,"_101":280},[],[150,169,176],[150,169],{"_105":186,"_98":187,"_151":188,"_153":152,"_154":136,"_155":189,"_157":158,"_107":190,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":283,"_101":287},[284],{"_105":193,"_98":194,"_151":195,"_153":188,"_154":136,"_155":196,"_157":158,"_107":197,"_102":29,"_160":180,"_162":198,"_163":25,"_164":-5,"_165":285,"_101":286},[],[150,187,194],[150,187],{"_105":203,"_98":204,"_151":205,"_153":152,"_154":136,"_155":206,"_157":158,"_107":207,"_102":156,"_160":208,"_162":209,"_163":25,"_164":-5,"_165":289,"_101":290},[],[150,204],{"_105":213,"_98":214,"_151":215,"_153":152,"_154":136,"_155":216,"_157":158,"_107":217,"_102":29,"_160":218,"_162":219,"_163":25,"_164":-5,"_165":292,"_101":293},[],[150,214],[150],{"_105":224,"_98":225,"_151":226,"_153":-5,"_154":136,"_155":179,"_157":158,"_107":227,"_102":29,"_160":161,"_162":-5,"_163":25,"_164":-5,"_165":296,"_101":300},[297],{"_105":230,"_98":231,"_151":232,"_153":226,"_154":136,"_155":233,"_157":158,"_107":234,"_102":29,"_160":180,"_162":235,"_163":25,"_164":-5,"_165":298,"_101":299},[],[225,231],[225],"previews",[288],"routes/_app","actionData","errors"]