@frankieai/server 0.1.0 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/control/app.ts"],"sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { Hono } from \"hono\";\nimport type { Context } from \"hono\";\nimport { parseFrankieConfig } from \"@frankieai/core\";\nimport { safeEqual } from \"../auth.js\";\nimport { toPublicTenant, type ControlStore, type TenantRecord } from \"./store.js\";\n\nexport interface ControlOptions {\n store: ControlStore;\n /** Bearer token that gates the admin API. A stand-in for real user auth. */\n adminToken?: string;\n logger?: (event: Record<string, unknown>) => void;\n}\n\n/**\n * The control plane: create a tenant, hand back its keys, and manage how its\n * product connects — bring an MCP, point at an OpenAPI spec, or stay\n * knowledge-only. The dashboard and the setup CLI are thin clients over this.\n *\n * Admin auth here is a single shared token — deliberately the simplest thing\n * that is not \"nothing\", and the seam where real per-user accounts go.\n */\nexport function createControlApp(options: ControlOptions): Hono {\n const { store } = options;\n const adminToken = options.adminToken ?? process.env[\"FRANKIE_ADMIN_TOKEN\"];\n const log = options.logger ?? ((event) => console.log(JSON.stringify({ ts: new Date().toISOString(), ...event })));\n\n const app = new Hono();\n\n app.use(\"/admin/*\", async (c, next) => {\n if (!adminToken) {\n return c.json({ error: \"Control plane is locked: set FRANKIE_ADMIN_TOKEN.\" }, 503);\n }\n const bearer = c.req.header(\"authorization\")?.replace(/^Bearer\\s+/i, \"\") ?? \"\";\n if (!safeEqual(bearer, adminToken)) {\n return c.json({ error: \"Unauthorized.\" }, 401);\n }\n await next();\n return;\n });\n\n /* ------------------------------ create ------------------------------ */\n\n /** The dashboard identifies the acting user with this header (e.g. \"github:42\"). */\n const ownerOf = (c: Context): string | undefined => c.req.header(\"x-frankie-owner\") || undefined;\n\n app.post(\"/admin/tenants\", async (c) => {\n const body = (await readJson<CreateTenantBody>(c)) ?? {};\n if (!body.name?.trim()) return c.json({ error: \"`name` is required.\" }, 400);\n const ownerId = ownerOf(c);\n\n // Ids are globally unique across owners, so two customers can both have an\n // \"Acme\" without colliding: take the clean slug, or suffix it if taken.\n let id = slug(body.name);\n if (await store.get(id)) id = `${id}-${randomBytes(3).toString(\"hex\")}`;\n\n const publishableKey = `pk_live_${randomBytes(12).toString(\"hex\")}`;\n const jwtSecret = randomBytes(36).toString(\"base64\");\n const sessionSecret = randomBytes(36).toString(\"base64\");\n\n let config;\n try {\n config = parseFrankieConfig({\n tenantId: id,\n branding: { name: body.name },\n agent: {\n ...(body.goal ? { systemPrompt: body.goal } : {}),\n ...(body.greeting ? { greeting: body.greeting } : {}),\n },\n auth: {\n publishableKey,\n allowedOrigins: body.allowedOrigins ?? [],\n ...(body.allowAnonymous ? { allowAnonymous: true } : {}),\n },\n });\n } catch (error) {\n return c.json({ error: `Invalid tenant: ${(error as Error).message}` }, 400);\n }\n\n const now = new Date().toISOString();\n const record: TenantRecord = {\n id,\n ...(ownerId ? { ownerId } : {}),\n config,\n jwtSecret,\n sessionSecret,\n createdAt: now,\n updatedAt: now,\n };\n await store.put(record);\n log({ level: \"info\", event: \"tenant_created\", tenant: id, ...(ownerId ? { owner: ownerId } : {}) });\n\n // The JWT secret is shown exactly once: the customer's backend signs user\n // tokens with it, and Frankie never needs to reveal it again.\n return c.json(\n {\n tenant: toPublicTenant(record),\n secrets: { publishableKey, jwtSecret },\n next: \"Set FRANKIE_JWT_SECRET to the jwtSecret on your backend, then run `frankie init`.\",\n },\n 201,\n );\n });\n\n /* ------------------------------- read ------------------------------- */\n\n // A tenant not owned by the caller is reported as absent, never as forbidden,\n // so one owner can't probe another's tenant ids.\n const own = async (c: Context): Promise<TenantRecord | null> => {\n const id = c.req.param(\"id\");\n const record = id ? await store.get(id) : null;\n if (!record) return null;\n const owner = ownerOf(c);\n if (owner && record.ownerId && record.ownerId !== owner) return null;\n return record;\n };\n\n app.get(\"/admin/tenants\", async (c) => {\n return c.json({ tenants: (await store.list(ownerOf(c))).map(toPublicTenant) });\n });\n\n app.get(\"/admin/tenants/:id\", async (c) => {\n const record = await own(c);\n if (!record) return c.json({ error: \"No such tenant.\" }, 404);\n return c.json({ tenant: toPublicTenant(record) });\n });\n\n /* ---------------------------- connection ---------------------------- */\n\n /** Set how the tenant's product connects: MCP servers, an OpenAPI source, or neither. */\n app.put(\"/admin/tenants/:id/connection\", async (c) => {\n const record = await own(c);\n if (!record) return c.json({ error: \"No such tenant.\" }, 404);\n\n const body = (await readJson<ConnectionBody>(c)) ?? {};\n let config;\n try {\n config = parseFrankieConfig({\n ...record.config,\n mcpServers: body.mcpServers ?? [],\n apis: body.apis ?? [],\n });\n } catch (error) {\n return c.json({ error: `Invalid connection: ${(error as Error).message}` }, 400);\n }\n\n const updated: TenantRecord = { ...record, config, updatedAt: new Date().toISOString() };\n await store.put(updated);\n log({ level: \"info\", event: \"tenant_connection_updated\", tenant: record.id });\n return c.json({ tenant: toPublicTenant(updated) });\n });\n\n /** Set the sites allowed to open a chat for this tenant. */\n app.put(\"/admin/tenants/:id/origins\", async (c) => {\n const record = await own(c);\n if (!record) return c.json({ error: \"No such tenant.\" }, 404);\n\n const body = (await readJson<{ allowedOrigins?: string[] }>(c)) ?? {};\n let config;\n try {\n config = parseFrankieConfig({\n ...record.config,\n auth: { ...record.config.auth, allowedOrigins: body.allowedOrigins ?? [] },\n });\n } catch (error) {\n return c.json({ error: `Invalid origins: ${(error as Error).message}` }, 400);\n }\n\n const updated: TenantRecord = { ...record, config, updatedAt: new Date().toISOString() };\n await store.put(updated);\n return c.json({ tenant: toPublicTenant(updated) });\n });\n\n // Surface the real cause of an unhandled failure (usually a database\n // connection error). The admin API is token-gated, so returning the message\n // is safe and makes the dashboard show what actually went wrong.\n app.onError((error, c) => {\n const message = error instanceof Error ? error.message : \"Internal error.\";\n log({ level: \"error\", event: \"control_error\", message });\n return c.json({ error: `Control plane error: ${message}` }, 500);\n });\n\n return app;\n}\n\n/* -------------------------------- types --------------------------------- */\n\ninterface CreateTenantBody {\n name?: string;\n allowedOrigins?: string[];\n goal?: string;\n greeting?: string;\n /** Let visitors chat without a host-signed token — for public onboarding pages. */\n allowAnonymous?: boolean;\n}\n\ninterface ConnectionBody {\n mcpServers?: unknown[];\n apis?: unknown[];\n}\n\n/* -------------------------------- helpers -------------------------------- */\n\nasync function readJson<T>(c: Context): Promise<T | null> {\n try {\n return (await c.req.json()) as T;\n } catch {\n return null;\n }\n}\n\nexport function slug(value: string): string {\n return (\n value\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, \"-\")\n .replace(/^-|-$/g, \"\")\n .slice(0, 40) || \"tenant\"\n );\n}\n"],"mappings":"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","names":[]}