@crvouga/mockingbird-service-llamacloud 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog — @crvouga/mockingbird-service-llamacloud
+
+## 0.1.0 (2026-09-22)
+
+Initial release.

package/README.md

@@ -0,0 +1,188 @@
+# @crvouga/mockingbird-service-llamacloud
+
+Stateful mock of the **LlamaCloud** platform API (LlamaIndex's managed indexes) for test suites:
+project and pipeline lookup, pipeline documents (list, get, insert, upsert, delete), and
+retrieval. Retrieval is deterministic: a scripted answer when a test sets one, otherwise a
+term-overlap ranking over the documents in the pipeline. The chat knowledge tools
+(`search_health_knowledge`, `search_faq`) and the EMR chatbot-admin knowledge CRUD run against
+it with no vendor account, no embeddings and no nondeterminism.
+
+- Operation coverage: [SUPPORT.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/llamacloud/SUPPORT.md)
+- The contract (`openapi.yaml`) is hand-authored from the official Python client's wire models
+  (llama-cloud 0.1.45) and our backend adapter.
+
+## Install
+
+```bash
+npm install -D @crvouga/mockingbird-service-llamacloud
+```
+
+ESM only. Node >= 22 or Bun >= 1.2. No native dependencies. Serve it with
+`npx mockingbird-llamacloud serve`, `createServer` from `./server` (Node), or `createRuntime` with
+any Fetch server.
+
+## Usage
+
+```bash
+npx mockingbird-llamacloud serve --port 8805 --index geviti-member-kb-v1 --project Default
+```
+
+Point the app at it:
+
+| Consumer | Setting |
+| --- | --- |
+| Backend `LlamaCloudKnowledgeAdapter` | `LLAMACLOUD_BASE_URL=http://127.0.0.1:8805/api/v1` (seam **G-L1**: the adapter hardcodes `https://api.cloud.llamaindex.ai/api/v1` today), plus `LLAMACLOUD_API_KEY` (any value) and `LLAMACLOUD_INDEX_NAME` / `LLAMACLOUD_PROJECT_NAME` matching a seeded pipeline |
+| Makor chat (`llama_cloud_services`) | `LLAMA_CLOUD_BASE_URL=http://127.0.0.1:8805` (no `/api/v1`; verified below, no code change needed) |
+
+```ts
+import { createRuntime } from "@crvouga/mockingbird-service-llamacloud"
+
+const llama = createRuntime({ pipelines: [{ name: "geviti-member-kb-v1", projectName: "Default" }] })
+const admin = (path: string, body: unknown) =>
+  llama.fetch(
+    new Request(`http://llamacloud.test/__admin${path}`, {
+      method: "PUT",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+    }),
+  )
+
+// Script what the chat tool retrieves for queries mentioning "apob"…
+await admin("/retrieval", {
+  match: { contains: "apob" },
+  nodes: [{ text: "ApoB counts atherogenic particles.", score: 0.92, metadata: { file_name: "apob.md" } }],
+})
+// …anything else is ranked by term overlap over the documents the app upserted.
+```
+
+### Routes
+
+All under `Authorization: Bearer <key>` (any non-empty key unless `apiKeys` is set). Errors are
+FastAPI-shaped: `{"detail": "…"}`, and 422 `{"detail": [{loc, msg, type}]}`.
+
+| Route | Behaviour |
+| --- | --- |
+| `GET /api/v1/projects?project_name=` | Projects with that exact name (`[]` when none). |
+| `GET /api/v1/projects/{id}` | One project, or 404. |
+| `GET /api/v1/pipelines?project_name=&project_id=&pipeline_name=&pipeline_type=` | Pipelines matching every filter given: `[{id, name, project_id, pipeline_type: "MANAGED", embedding_config, status: "CREATED", …}]`. The backend filters by `project_name` and picks `name == LLAMACLOUD_INDEX_NAME`. |
+| `GET /api/v1/pipelines/{id}` | One pipeline, or 404. |
+| `POST /api/v1/pipelines/{id}/retrieve` | `{query, dense_similarity_top_k?, …}` → `{pipeline_id, retrieval_nodes: [{node: {id_, text, metadata, extra_info, …}, score}], …}`. Top-k defaults to 5. |
+| `GET /api/v1/pipelines/{id}/documents?skip=&limit=` | `[{id, text, metadata, …}]`, oldest first. |
+| `PUT /api/v1/pipelines/{id}/documents` | Upsert `[{id?, text, metadata}]` by id (the backend uses the slug); a missing id gets a UUID. Answers the stored documents. |
+| `POST /api/v1/pipelines/{id}/documents` | Same as PUT (the SDK's `insert`). |
+| `GET /api/v1/pipelines/{id}/documents/{docId}` | One document, or 404. |
+| `DELETE /api/v1/pipelines/{id}/documents/{docId}` | 204, or 404 for an unknown document. |
+
+### Retrieval
+
+1. **Scripted.** `PUT /__admin/retrieval {match: {contains?, pipeline?}, nodes: [{text, score?, metadata?}]}`
+   adds a rule. The most recently added rule whose `contains` appears in the query
+   (case-insensitive) and whose `pipeline` (id or name) matches answers its `nodes` verbatim,
+   truncated to top-k. A node without a score gets 1, 0.9, 0.8, … Node ids are `scripted_<n>`.
+2. **Default: term overlap.** Terms are lower-cased alphanumeric words of 2+ characters minus
+   common stopwords. A document's score is the share of the query's distinct terms found in its
+   text or `metadata.title`, rounded to 4 places. Non-matching documents are dropped and ties
+   keep insertion order. Each document is one node (`id_: "<docId>_0"`), and its metadata gains
+   `document_id` and `pipeline_id`, the fields the backend reads.
+
+Node metadata is sent under both `metadata` (read by our backend) and `extra_info` (the
+official client model's field name). Without live credentials, which of the two the real API
+sends is unverified.
+
+### Makor chat SDK: verified call sequence
+
+The catalog listed this as unverified. It has now been checked against the installed SDK:
+llama-cloud-services **0.6.88**, llama-cloud **0.1.45** and llama-index-core **0.14.10**, the
+versions pinned in `apps/makor-ecosystem/uv.lock`. The wheels were read, and
+`llamacloud.sdk.test.ts` runs the real Makor `LlamaCloudClient` file on the real SDK against the
+served mock. `LlamaCloudIndex(name, project_name=…, api_key=…)` followed by
+`.as_retriever(similarity_top_k=5).aretrieve(q)` makes these calls:
+
+1. `GET /api/v1/projects?project_name=<name>`: `resolve_project`. No match raises
+   `No project found with name …`, and more than one match raises too.
+2. `GET /api/v1/pipelines?project_id=<id>&pipeline_name=<index>&pipeline_type=MANAGED`:
+   `resolve_pipeline`. No match raises `Unknown index name …`.
+3. `GET /api/v1/pipelines/{id}`, then `GET /api/v1/projects/{project_id}`: `as_retriever()`
+   builds a `LlamaCloudRetriever(project_id=…, pipeline_id=…)`, which resolves both again by id.
+4. `POST /api/v1/pipelines/{id}/retrieve {query, dense_similarity_top_k: 5}`.
+
+The base URL comes from `base_url` or `LLAMA_CLOUD_BASE_URL`, falling back to
+`https://api.cloud.llamaindex.ai` (`llama_index.core.ingestion.api_utils.get_client`). Makor
+passes no `base_url`, so setting the environment variable is enough. The SDK's pydantic models
+are strict: `Pipeline.status` must be `CREATED` or `DELETING`, and `embedding_config` is
+required. The mock satisfies both, and the SDK test fails if a shape drifts.
+
+**Discrepancy:** Makor's `llamacloud_project_name` defaults to `"default"` (lowercase). The
+backend's default is `"Default"`. Project lookup is exact, so Makor needs
+`LLAMACLOUD_PROJECT_NAME=Default`, or a seeded `default` project. Otherwise the client degrades
+to empty results, which the acceptance tests cover.
+
+To run the SDK test:
+
+```bash
+uv venv /tmp/llama && VIRTUAL_ENV=/tmp/llama uv pip install \
+  llama-cloud-services==0.6.88 llama-cloud==0.1.45 llama-index-core==0.14.10
+MOCKINGBIRD_LLAMACLOUD_PYTHON=/tmp/llama/bin/python bun test llamacloud.sdk
+```
+
+### Admin (beyond the standard contract)
+
+| Route | Effect |
+| --- | --- |
+| `GET /__admin/pipelines` | The namespace's projects and pipelines. |
+| `PUT /__admin/pipelines` | `{name, projectName?}` creates a managed pipeline, and its project if needed. The ids are stable UUIDs derived from the namespace and names. |
+| `GET /__admin/pipelines/:pipeline/documents` | A pipeline's documents, by id or name. |
+| `GET /__admin/retrieval` | The scripted rules, newest first. |
+| `PUT /__admin/retrieval` | Add one rule, or replace them all with `{rules: [...]}` (the first listed wins). |
+| `DELETE /__admin/retrieval` | Clear the rules. |
+| `GET/PUT /__admin/settings` | `{apiKeys?: string[], defaultTopK?: number}` for the calling namespace. |
+
+Fault presets (`POST /__admin/faults {"preset": "<name>", "count"?: n}`; `GET /__admin/faults/presets`):
+
+| Preset | Effect |
+| --- | --- |
+| `index_missing` | Pipeline search answers `[]`. |
+| `retrieval_empty` | Retrieval answers no nodes. |
+| `documents_unexpected_shape` | The document list answers an object instead of an array. |
+| `unauthorized` | Every call answers 401. |
+| `rate_limited` | Every call answers 429. |
+| `server_error` | Every call answers 500. |
+| `slow_retrieval` | Retrieval is delayed by 3 s, or by `latencyMs` when given. |
+
+### Namespaces
+
+Neither consumer can add headers, so a namespace can be chosen three ways:
+
+- the `x-mockingbird-namespace` header;
+- a `/ns/<name>` prefix on the base URL;
+- the API key: `PUT /__admin/credentials {"credentials": {"<LLAMACLOUD_API_KEY>": "<namespace>"}}`.
+
+Each namespace starts with the seeded pipelines, by default `geviti-member-kb-v1` in project
+`Default`. The request journal records operation ids, statuses and pipeline and document ids. It
+never records queries, document text or titles.
+
+### Deliberately not modelled
+
+- Real retrieval quality: no embeddings, chunking, hybrid search, reranking, metadata filters,
+  image or page-figure nodes, or `retrieval_mode` routing. A document is always one node.
+- Pipeline ingestion status and sync jobs. Upserted documents can be retrieved immediately.
+- File uploads (`/api/v1/files`, `pipeline_files`), data sources, parsing (LlamaParse) and
+  extraction.
+- Creating projects or pipelines through the API. Use the seed or `PUT /__admin/pipelines`.
+- Organizations beyond one per namespace.
+
+## API
+
+| Export | Kind | Description |
+| --- | --- | --- |
+| `LlamaCloudAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `documents(pipeline)`, `addRule(rule)`, `rules()`, `clearRules()`, `state`. Options: `sqlite`, `now`, `namespace`, `pipelines`, `settings`. |
+| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets). Options: `pipelines`, `settings`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `LLAMACLOUD_PRESETS` | object | Every named fault preset. |
+| `LLAMACLOUD_NAMESPACE` | string | The service name, `"llamacloud"`. |
+| `DEFAULT_PIPELINES`, `DEFAULT_PIPELINE_NAME`, `DEFAULT_PROJECT_NAME`, `DEFAULT_SETTINGS` | values | The seed: `geviti-member-kb-v1` in `Default`, top-k 5, any key. |
+| `rank`, `terms` | functions | The default term-overlap ranking and its tokenizer. |
+| `uuidFrom` | function | The stable UUID derivation used for project, pipeline and document ids. |
+| `document`, `operationIds`, `supportedOperationIds` | values | The vendored OpenAPI contract and its operation ids. |
+| `createServer`, `serveTarget`, `DEFAULT_PORT` (`./server`) | Node | Serve over `node:http`; the `serve` CLI target (`--index`, `--project`, `--api-key`); port 8805. |
+
+Part of [mockingbird](https://github.com/crvouga/mockingbird).

package/dist/chunk-J2WKZZ5I.js

@@ -0,0 +1,362 @@
+import {
+  createRuntime
+} from "./chunk-UP32DVYJ.js";
+
+// ../../adapters/node/dist/cli.js
+import { readFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+
+// ../../adapters/node/dist/serve.js
+import { createServer } from "node:http";
+var serve = async (api, options = {}) => {
+  const server = createServer(async (req, res) => {
+    const chunks = [];
+    for await (const chunk of req) {
+      chunks.push(Buffer.from(chunk));
+    }
+    const body = Buffer.concat(chunks);
+    const address = server.address();
+    const port = typeof address === "object" && address !== null ? address.port : void 0;
+    const base = `http://${req.headers.host ?? `localhost:${port ?? 80}`}`;
+    const raw = req.url ?? "/";
+    const url = new URL(raw.replace(/^\/+/, "/"), base);
+    const method = req.method ?? "GET";
+    const init = { method, headers: req.headers };
+    if (method !== "GET" && method !== "HEAD" && body.length > 0) {
+      init.body = body;
+    }
+    const aborted = new AbortController();
+    res.once("close", () => {
+      if (!res.writableFinished)
+        aborted.abort();
+    });
+    init.signal = aborted.signal;
+    const request = new Request(url, init);
+    let response;
+    try {
+      response = await api.fetch(request);
+    } catch (error) {
+      if (error.code === "MOCKINGBIRD_DROP") {
+        req.socket.destroy();
+        return;
+      }
+      res.writeHead(500, { "content-type": "application/json" });
+      res.end(JSON.stringify({
+        error: {
+          type: "mockingbird_internal",
+          message: error instanceof Error ? error.message : String(error)
+        }
+      }));
+      return;
+    }
+    const headers = Object.fromEntries(response.headers);
+    const cookies = response.headers.getSetCookie();
+    if (cookies.length > 0)
+      headers["set-cookie"] = cookies;
+    if (!response.body) {
+      res.writeHead(response.status, headers);
+      res.end();
+      return;
+    }
+    res.writeHead(response.status, headers);
+    res.flushHeaders();
+    const reader = response.body.getReader();
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        if (!res.write(value))
+          await new Promise((resolve) => res.once("drain", resolve));
+      }
+      res.end();
+    } catch {
+      res.destroy();
+    } finally {
+      reader.releaseLock();
+    }
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(options.port ?? 0, options.host, resolve);
+  });
+  return server;
+};
+
+// ../../adapters/node/dist/listen.js
+var listen = async (api, options = {}) => {
+  const host = options.host ?? "127.0.0.1";
+  const server = await serve(api, { port: options.port ?? 0, host });
+  const address = server.address();
+  const port = typeof address === "object" && address !== null ? address.port : options.port ?? 0;
+  const shown = host.includes(":") ? `[${host}]` : host;
+  return {
+    url: `http://${shown}:${port}`,
+    port,
+    host,
+    server,
+    close: () => new Promise((resolve, reject) => {
+      server.close((error) => {
+        if (error && error.code !== "ERR_SERVER_NOT_RUNNING")
+          reject(error);
+        else
+          resolve();
+      });
+      server.closeAllConnections?.();
+    })
+  };
+};
+
+// ../../adapters/node/dist/cli.js
+var optionHelp = (options) => Object.entries(options).map(([name, option]) => {
+  const flag = `--${name}${option.type === "string" ? ` ${option.value ?? "<value>"}` : ""}`;
+  const fallback = option.default !== void 0 ? ` (default: ${String(option.default)})` : "";
+  return `  ${flag.padEnd(30)} ${option.description}${fallback}`;
+});
+var help = (spec) => [
+  `${spec.bin} \u2014 ${spec.description}`,
+  "",
+  "Usage:",
+  `  ${spec.bin} <command> [options]`,
+  "",
+  "Commands:",
+  ...Object.entries(spec.commands).map(([name, c]) => `  ${name.padEnd(30)} ${c.summary}`),
+  "",
+  `Run \`${spec.bin} <command> --help\` for a command's options.`
+].join("\n");
+var commandHelp = (spec, name, command) => [
+  `${spec.bin} ${name} \u2014 ${command.summary}`,
+  "",
+  "Usage:",
+  `  ${command.usage ?? `${spec.bin} ${name} [options]`}`,
+  ...command.options ? ["", "Options:", ...optionHelp(command.options)] : []
+].join("\n");
+var runCli = async (spec, argv) => {
+  const pair = argv.length >= 2 ? `${argv[0]} ${argv[1]}` : void 0;
+  const words = pair !== void 0 && spec.commands[pair] ? 2 : 1;
+  const name = words === 2 ? pair : argv[0];
+  const rest = argv.slice(words);
+  if (name === void 0 || name === "--help" || name === "-h" || name === "help") {
+    console.log(help(spec));
+    return 0;
+  }
+  const command = spec.commands[name];
+  if (!command) {
+    console.error(`${spec.bin}: unknown command ${JSON.stringify(name)}
+
+${help(spec)}`);
+    return 2;
+  }
+  if (rest.includes("--help") || rest.includes("-h")) {
+    console.log(commandHelp(spec, name, command));
+    return 0;
+  }
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: Object.fromEntries(Object.entries(command.options ?? {}).map(([key, option]) => [
+        key,
+        {
+          type: option.type,
+          ...option.default !== void 0 ? { default: option.default } : {}
+        }
+      ]))
+    });
+  } catch (error) {
+    console.error(`${spec.bin} ${name}: ${error instanceof Error ? error.message : String(error)}
+
+${commandHelp(spec, name, command)}`);
+    return 2;
+  }
+  return command.run(parsed.values, parsed.positionals);
+};
+var COMMON_SERVE_OPTIONS = {
+  port: { type: "string", value: "<port>", description: "Port to listen on" },
+  host: { type: "string", value: "<host>", description: "Interface to bind", default: "127.0.0.1" },
+  "admin-key": {
+    type: "string",
+    value: "<key>",
+    description: "Require x-mockingbird-admin-key on /__admin/* (env MOCKINGBIRD_ADMIN_KEY)"
+  },
+  seed: { type: "string", value: "<seed>", description: "Seed for every random choice" },
+  log: {
+    type: "string",
+    value: "<pretty|json|off>",
+    description: "Request log format",
+    default: "pretty"
+  },
+  "log-requests": {
+    type: "boolean",
+    description: "One JSON line per request: namespace, operationId, status, ids touched (never bodies). Same as --log json"
+  },
+  config: {
+    type: "string",
+    value: "<file>",
+    description: "Serve every service in a mockingbird.json config instead"
+  }
+};
+var formatLog = (format) => {
+  if (format === "off")
+    return void 0;
+  if (format === "json")
+    return (entry) => console.log(JSON.stringify(entry));
+  return (entry) => {
+    const op = entry.operationId ?? (entry.unmatched ? "UNMATCHED" : "-");
+    const ns = entry.namespace === "default" ? "" : ` [${entry.namespace}]`;
+    const fault = entry.faultId ? ` fault=${entry.faultId}` : "";
+    const adopted = entry.adopted ? " adopted" : "";
+    console.log(`${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}`);
+  };
+};
+var asString = (value) => typeof value === "string" ? value : void 0;
+var loadTarget = async (name, own) => {
+  if (name === own.name)
+    return own;
+  const specifier = `@crvouga/mockingbird-service-${name}/server`;
+  try {
+    const mod = await import(specifier);
+    if (!mod.serveTarget)
+      throw new Error(`${specifier} exports no serveTarget`);
+    return mod.serveTarget;
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(`cannot load service "${name}": ${reason}. Install @crvouga/mockingbird-service-${name}.`);
+  }
+};
+var start = async (target, values, config) => {
+  const runtime = await target.create(values, {
+    adminKey: config.adminKey,
+    seed: config.seed,
+    onLog: formatLog(config.log)
+  });
+  const listening = await listen(runtime, { port: config.port, host: config.host });
+  console.log(`${target.name} mock listening on ${listening.url}`);
+  console.log(`${target.name} health: GET ${listening.url}/health`);
+  console.log(`${target.name} admin: ${listening.url}/__admin (${config.adminKey ? "x-mockingbird-admin-key required" : "open \u2014 pass --admin-key to lock"})`);
+  for (const line of target.banner?.(runtime) ?? [])
+    console.log(`${target.name} ${line}`);
+  return listening;
+};
+var untilSignal = async (servers) => new Promise((resolve) => {
+  const stop = async () => {
+    await Promise.allSettled(servers.map((s) => s.close()));
+    resolve(0);
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+});
+var serveCommand = (target) => ({
+  summary: `Serve the ${target.name} mock over HTTP`,
+  options: { ...COMMON_SERVE_OPTIONS, ...target.options },
+  async run(values) {
+    const log = values["log-requests"] === true ? "json" : asString(values.log) ?? "pretty";
+    if (!["pretty", "json", "off"].includes(log)) {
+      console.error(`--log must be pretty, json or off (got ${log})`);
+      return 2;
+    }
+    const configPath = asString(values.config);
+    if (configPath !== void 0) {
+      const config = JSON.parse(await readFile(configPath, "utf8"));
+      const servers = [];
+      try {
+        for (const [name, entry] of Object.entries(config.services ?? {})) {
+          const each = await loadTarget(name, target);
+          servers.push(await start(each, entry.options ?? {}, {
+            port: entry.port ?? each.defaultPort,
+            host: entry.host ?? "127.0.0.1",
+            ...entry.adminKey !== void 0 ? { adminKey: entry.adminKey } : {},
+            ...entry.seed !== void 0 ? { seed: entry.seed } : {},
+            log: config.log ?? log
+          }));
+        }
+      } catch (error) {
+        await Promise.allSettled(servers.map((s) => s.close()));
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+      }
+      return untilSignal(servers);
+    }
+    const port = asString(values.port);
+    const adminKey = asString(values["admin-key"]) ?? process.env.MOCKINGBIRD_ADMIN_KEY;
+    const seed = asString(values.seed);
+    let listening;
+    try {
+      listening = await start(target, values, {
+        port: port === void 0 ? target.defaultPort : Number.parseInt(port, 10),
+        host: asString(values.host) ?? "127.0.0.1",
+        ...adminKey !== void 0 ? { adminKey } : {},
+        ...seed !== void 0 ? { seed } : {},
+        log
+      });
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : String(error));
+      return 1;
+    }
+    return untilSignal([listening]);
+  }
+});
+
+// src/server.ts
+var DEFAULT_PORT = 8805;
+var createServer2 = async (options = {}) => {
+  const { port, host, ...rest } = options;
+  const runtime = createRuntime(rest);
+  const listening = await listen(runtime, {
+    port: port ?? 0,
+    ...host !== void 0 ? { host } : {}
+  });
+  return { ...listening, runtime };
+};
+var text = (value) => typeof value === "string" ? value : void 0;
+var serveTarget = {
+  name: "llamacloud",
+  defaultPort: DEFAULT_PORT,
+  options: {
+    index: {
+      type: "string",
+      value: "<name[,name\u2026]>",
+      description: "Pipelines (indexes) to create in the Default project (the app's LLAMACLOUD_INDEX_NAME); default geviti-member-kb-v1"
+    },
+    project: {
+      type: "string",
+      value: "<name>",
+      description: "Project those pipelines live in (the app's LLAMACLOUD_PROJECT_NAME); default Default"
+    },
+    "api-key": {
+      type: "string",
+      value: "<key>",
+      description: "Accept only this bearer key (default: any non-empty key)"
+    }
+  },
+  create: (values, common) => {
+    const index = text(values.index);
+    const project = text(values.project);
+    const key = text(values["api-key"]);
+    return createRuntime({
+      ...index ? {
+        pipelines: index.split(",").map((name) => name.trim()).filter(Boolean).map((name) => ({ name, ...project ? { projectName: project } : {} }))
+      } : project ? { pipelines: [{ name: "geviti-member-kb-v1", projectName: project }] } : {},
+      ...key ? { settings: { apiKeys: [key] } } : {},
+      ...common.adminKey !== void 0 ? { adminKey: common.adminKey } : {},
+      ...common.seed !== void 0 ? { seed: common.seed } : {},
+      ...common.onLog ? { onLog: common.onLog } : {}
+    });
+  },
+  banner: () => [
+    "auth: Authorization: Bearer <LLAMACLOUD_API_KEY>",
+    "backend: LLAMACLOUD_BASE_URL=<this>/api/v1; Makor chat SDK: LLAMA_CLOUD_BASE_URL=<this>",
+    "namespaces: x-mockingbird-namespace, /ns/<name>/\u2026, or PUT /__admin/credentials {<api key>: <ns>}"
+  ]
+};
+
+export {
+  runCli,
+  serveCommand,
+  DEFAULT_PORT,
+  createServer2 as createServer,
+  serveTarget
+};
+//# sourceMappingURL=chunk-J2WKZZ5I.js.map

package/dist/chunk-J2WKZZ5I.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../adapters/node/src/cli.ts", "../../../adapters/node/src/serve.ts", "../../../adapters/node/src/listen.ts", "../src/server.ts"],
+  "sourcesContent": ["import { readFile } from \"node:fs/promises\"\nimport { type ParseArgsConfig, parseArgs } from \"node:util\"\nimport type { RequestLog, ServiceInstance, ServiceRuntime } from \"@crvouga/mockingbird-service\"\nimport { type Listening, listen } from \"./listen.js\"\n\nexport type CliOption = {\n  type: \"string\" | \"boolean\"\n  description: string\n  /** Shown in help; the value placeholder, e.g. `<port>`. */\n  value?: string\n  default?: string | boolean\n}\n\nexport type CliValues = Record<string, string | boolean | undefined>\n\nexport type CliCommand = {\n  summary: string\n  usage?: string\n  options?: Record<string, CliOption>\n  /** Resolves to an exit code; a server command resolves only when it stops. */\n  run(values: CliValues, positionals: string[]): Promise<number>\n}\n\nexport type CliSpec = {\n  bin: string\n  description: string\n  commands: Record<string, CliCommand>\n}\n\nconst optionHelp = (options: Record<string, CliOption>): string[] =>\n  Object.entries(options).map(([name, option]) => {\n    const flag = `--${name}${option.type === \"string\" ? ` ${option.value ?? \"<value>\"}` : \"\"}`\n    const fallback = option.default !== undefined ? ` (default: ${String(option.default)})` : \"\"\n    return `  ${flag.padEnd(30)} ${option.description}${fallback}`\n  })\n\nconst help = (spec: CliSpec): string =>\n  [\n    `${spec.bin} \u2014 ${spec.description}`,\n    \"\",\n    \"Usage:\",\n    `  ${spec.bin} <command> [options]`,\n    \"\",\n    \"Commands:\",\n    ...Object.entries(spec.commands).map(([name, c]) => `  ${name.padEnd(30)} ${c.summary}`),\n    \"\",\n    `Run \\`${spec.bin} <command> --help\\` for a command's options.`,\n  ].join(\"\\n\")\n\nconst commandHelp = (spec: CliSpec, name: string, command: CliCommand): string =>\n  [\n    `${spec.bin} ${name} \u2014 ${command.summary}`,\n    \"\",\n    \"Usage:\",\n    `  ${command.usage ?? `${spec.bin} ${name} [options]`}`,\n    ...(command.options ? [\"\", \"Options:\", ...optionHelp(command.options)] : []),\n  ].join(\"\\n\")\n\n/** Parse `argv` against `spec` and run the chosen command. Resolves to an exit code. */\nexport const runCli = async (spec: CliSpec, argv: string[]): Promise<number> => {\n  // Two-word commands (`corpus pull`) win over one-word ones.\n  const pair = argv.length >= 2 ? `${argv[0]} ${argv[1]}` : undefined\n  const words = pair !== undefined && spec.commands[pair] ? 2 : 1\n  const name = words === 2 ? pair : argv[0]\n  const rest = argv.slice(words)\n  if (name === undefined || name === \"--help\" || name === \"-h\" || name === \"help\") {\n    console.log(help(spec))\n    return 0\n  }\n  const command = spec.commands[name]\n  if (!command) {\n    console.error(`${spec.bin}: unknown command ${JSON.stringify(name)}\\n\\n${help(spec)}`)\n    return 2\n  }\n  if (rest.includes(\"--help\") || rest.includes(\"-h\")) {\n    console.log(commandHelp(spec, name, command))\n    return 0\n  }\n  let parsed: { values: CliValues; positionals: string[] }\n  try {\n    parsed = parseArgs({\n      args: rest,\n      allowPositionals: true,\n      strict: true,\n      options: Object.fromEntries(\n        Object.entries(command.options ?? {}).map(([key, option]) => [\n          key,\n          {\n            type: option.type,\n            ...(option.default !== undefined ? { default: option.default } : {}),\n          },\n        ]),\n      ) as ParseArgsConfig[\"options\"],\n    }) as { values: CliValues; positionals: string[] }\n  } catch (error) {\n    console.error(\n      `${spec.bin} ${name}: ${error instanceof Error ? error.message : String(error)}\\n\\n${commandHelp(spec, name, command)}`,\n    )\n    return 2\n  }\n  return command.run(parsed.values, parsed.positionals)\n}\n\n// \u2500\u2500 serve \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type LogFormat = \"pretty\" | \"json\" | \"off\"\n\nexport type CommonServeOptions = {\n  adminKey: string | undefined\n  seed: string | undefined\n  onLog: ((entry: RequestLog) => void) | undefined\n}\n\n/**\n * What a service contributes to `serve`: how to build its runtime from CLI flags,\n * and what to say at startup. Every service's `./server` entry exports one as\n * `serveTarget`, which is also how `serve --config` finds services by name.\n */\nexport type ServeTarget = {\n  name: string\n  defaultPort: number\n  /** Serve flags beyond the common ones. */\n  options?: Record<string, CliOption>\n  create(\n    values: CliValues,\n    common: CommonServeOptions,\n  ): Promise<ServiceRuntime<ServiceInstance>> | ServiceRuntime<ServiceInstance>\n  /** Startup lines after the listen address, e.g. the loaded corpus version. */\n  banner?(runtime: ServiceRuntime<ServiceInstance>): string[]\n}\n\nconst COMMON_SERVE_OPTIONS: Record<string, CliOption> = {\n  port: { type: \"string\", value: \"<port>\", description: \"Port to listen on\" },\n  host: { type: \"string\", value: \"<host>\", description: \"Interface to bind\", default: \"127.0.0.1\" },\n  \"admin-key\": {\n    type: \"string\",\n    value: \"<key>\",\n    description: \"Require x-mockingbird-admin-key on /__admin/* (env MOCKINGBIRD_ADMIN_KEY)\",\n  },\n  seed: { type: \"string\", value: \"<seed>\", description: \"Seed for every random choice\" },\n  log: {\n    type: \"string\",\n    value: \"<pretty|json|off>\",\n    description: \"Request log format\",\n    default: \"pretty\",\n  },\n  \"log-requests\": {\n    type: \"boolean\",\n    description:\n      \"One JSON line per request: namespace, operationId, status, ids touched (never bodies). Same as --log json\",\n  },\n  config: {\n    type: \"string\",\n    value: \"<file>\",\n    description: \"Serve every service in a mockingbird.json config instead\",\n  },\n}\n\nconst formatLog = (format: LogFormat) => {\n  if (format === \"off\") return undefined\n  if (format === \"json\") return (entry: RequestLog) => console.log(JSON.stringify(entry))\n  return (entry: RequestLog) => {\n    const op = entry.operationId ?? (entry.unmatched ? \"UNMATCHED\" : \"-\")\n    const ns = entry.namespace === \"default\" ? \"\" : ` [${entry.namespace}]`\n    const fault = entry.faultId ? ` fault=${entry.faultId}` : \"\"\n    const adopted = entry.adopted ? \" adopted\" : \"\"\n    console.log(\n      `${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}`,\n    )\n  }\n}\n\nconst asString = (value: string | boolean | undefined): string | undefined =>\n  typeof value === \"string\" ? value : undefined\n\n/** A service entry in `mockingbird.json`. */\nexport type ConfigService = {\n  port?: number\n  host?: string\n  adminKey?: string\n  seed?: string\n  /** Service-specific serve flags, by long name: `{ \"webhook-url\": \"\u2026\" }`. */\n  options?: Record<string, string | boolean>\n}\n\nexport type MockingbirdConfig = {\n  /** Keyed by service name: `junction` loads `@crvouga/mockingbird-service-junction`. */\n  services: Record<string, ConfigService>\n  log?: LogFormat\n}\n\nconst loadTarget = async (name: string, own: ServeTarget): Promise<ServeTarget> => {\n  if (name === own.name) return own\n  const specifier = `@crvouga/mockingbird-service-${name}/server`\n  try {\n    const mod = (await import(specifier)) as { serveTarget?: ServeTarget }\n    if (!mod.serveTarget) throw new Error(`${specifier} exports no serveTarget`)\n    return mod.serveTarget\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error)\n    throw new Error(\n      `cannot load service \"${name}\": ${reason}. Install @crvouga/mockingbird-service-${name}.`,\n    )\n  }\n}\n\nconst start = async (\n  target: ServeTarget,\n  values: CliValues,\n  config: { port: number; host: string; adminKey?: string; seed?: string; log: LogFormat },\n): Promise<Listening> => {\n  const runtime = await target.create(values, {\n    adminKey: config.adminKey,\n    seed: config.seed,\n    onLog: formatLog(config.log),\n  })\n  const listening = await listen(runtime, { port: config.port, host: config.host })\n  console.log(`${target.name} mock listening on ${listening.url}`)\n  console.log(`${target.name} health: GET ${listening.url}/health`)\n  console.log(\n    `${target.name} admin: ${listening.url}/__admin (${config.adminKey ? \"x-mockingbird-admin-key required\" : \"open \u2014 pass --admin-key to lock\"})`,\n  )\n  for (const line of target.banner?.(runtime) ?? []) console.log(`${target.name} ${line}`)\n  return listening\n}\n\nconst untilSignal = async (servers: Listening[]): Promise<number> =>\n  new Promise((resolve) => {\n    const stop = async () => {\n      await Promise.allSettled(servers.map((s) => s.close()))\n      resolve(0)\n    }\n    process.once(\"SIGINT\", stop)\n    process.once(\"SIGTERM\", stop)\n  })\n\n/** The standard `serve` command for a service, including multi-service `--config`. */\nexport const serveCommand = (target: ServeTarget): CliCommand => ({\n  summary: `Serve the ${target.name} mock over HTTP`,\n  options: { ...COMMON_SERVE_OPTIONS, ...target.options },\n  async run(values) {\n    const log = (\n      values[\"log-requests\"] === true ? \"json\" : (asString(values.log) ?? \"pretty\")\n    ) as LogFormat\n    if (![\"pretty\", \"json\", \"off\"].includes(log)) {\n      console.error(`--log must be pretty, json or off (got ${log})`)\n      return 2\n    }\n    const configPath = asString(values.config)\n    if (configPath !== undefined) {\n      const config = JSON.parse(await readFile(configPath, \"utf8\")) as MockingbirdConfig\n      const servers: Listening[] = []\n      try {\n        for (const [name, entry] of Object.entries(config.services ?? {})) {\n          const each = await loadTarget(name, target)\n          servers.push(\n            await start(each, entry.options ?? {}, {\n              port: entry.port ?? each.defaultPort,\n              host: entry.host ?? \"127.0.0.1\",\n              ...(entry.adminKey !== undefined ? { adminKey: entry.adminKey } : {}),\n              ...(entry.seed !== undefined ? { seed: entry.seed } : {}),\n              log: config.log ?? log,\n            }),\n          )\n        }\n      } catch (error) {\n        await Promise.allSettled(servers.map((s) => s.close()))\n        console.error(error instanceof Error ? error.message : String(error))\n        return 1\n      }\n      return untilSignal(servers)\n    }\n    const port = asString(values.port)\n    const adminKey = asString(values[\"admin-key\"]) ?? process.env.MOCKINGBIRD_ADMIN_KEY\n    const seed = asString(values.seed)\n    let listening: Listening\n    try {\n      listening = await start(target, values, {\n        port: port === undefined ? target.defaultPort : Number.parseInt(port, 10),\n        host: asString(values.host) ?? \"127.0.0.1\",\n        ...(adminKey !== undefined ? { adminKey } : {}),\n        ...(seed !== undefined ? { seed } : {}),\n        log,\n      })\n    } catch (error) {\n      console.error(error instanceof Error ? error.message : String(error))\n      return 1\n    }\n    return untilSignal([listening])\n  },\n})\n", "import { createServer } from \"node:http\"\nimport type { FetchAPI } from \"@crvouga/mockingbird-core\"\n\n/** Options for {@link serve}. */\nexport type NodeServeOptions = {\n  port?: number\n  host?: string\n}\n\n/**\n * Serve any Mockingbird {@link FetchAPI} over `node:http`.\n * Port defaults to `0`, so the OS assigns an ephemeral port (read from `server.address()`).\n */\nexport const serve = async (api: FetchAPI, options: NodeServeOptions = {}) => {\n  const server = createServer(async (req, res) => {\n    const chunks: Buffer[] = []\n    for await (const chunk of req) {\n      chunks.push(Buffer.from(chunk))\n    }\n    const body = Buffer.concat(chunks)\n    const address = server.address()\n    const port = typeof address === \"object\" && address !== null ? address.port : undefined\n    const base = `http://${req.headers.host ?? `localhost:${port ?? 80}`}`\n    const raw = req.url ?? \"/\"\n    const url = new URL(raw.replace(/^\\/+/, \"/\"), base)\n    const method = req.method ?? \"GET\"\n    const init: RequestInit = { method, headers: req.headers as Record<string, string> }\n    if (method !== \"GET\" && method !== \"HEAD\" && body.length > 0) {\n      init.body = body\n    }\n    const aborted = new AbortController()\n    res.once(\"close\", () => {\n      if (!res.writableFinished) aborted.abort()\n    })\n    init.signal = aborted.signal\n    const request = new Request(url, init)\n    let response: Response\n    try {\n      response = await api.fetch(request)\n    } catch (error) {\n      // A `drop` fault: destroy the socket so the client sees the connection die.\n      if ((error as { code?: string }).code === \"MOCKINGBIRD_DROP\") {\n        req.socket.destroy()\n        return\n      }\n      res.writeHead(500, { \"content-type\": \"application/json\" })\n      res.end(\n        JSON.stringify({\n          error: {\n            type: \"mockingbird_internal\",\n            message: error instanceof Error ? error.message : String(error),\n          },\n        }),\n      )\n      return\n    }\n    // Headers#entries() joins repeated headers; Set-Cookie must stay one header per cookie.\n    const headers: Record<string, string | string[]> = Object.fromEntries(response.headers)\n    const cookies = response.headers.getSetCookie()\n    if (cookies.length > 0) headers[\"set-cookie\"] = cookies\n    if (!response.body) {\n      res.writeHead(response.status, headers)\n      res.end()\n      return\n    }\n    // Stream the body chunk by chunk: event streams and long-polls must not be buffered.\n    res.writeHead(response.status, headers)\n    res.flushHeaders()\n    const reader = response.body.getReader()\n    try {\n      for (;;) {\n        const { done, value } = await reader.read()\n        if (done) break\n        if (!res.write(value)) await new Promise<void>((resolve) => res.once(\"drain\", resolve))\n      }\n      res.end()\n    } catch {\n      res.destroy()\n    } finally {\n      reader.releaseLock()\n    }\n  })\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject)\n    server.listen(options.port ?? 0, options.host, resolve)\n  })\n  return server\n}\n", "import type { Server } from \"node:http\"\nimport type { FetchAPI } from \"@crvouga/mockingbird-core\"\nimport { serve } from \"./serve.js\"\n\nexport type ListenOptions = {\n  /** Default `0`: the OS picks a free port. */\n  port?: number\n  /** Default `127.0.0.1`: a mock should not be reachable off the machine by accident. */\n  host?: string\n}\n\n/** A running server, with the address it actually bound. */\nexport type Listening = {\n  url: string\n  port: number\n  host: string\n  server: Server\n  close(): Promise<void>\n}\n\nexport const listen = async (api: FetchAPI, options: ListenOptions = {}): Promise<Listening> => {\n  const host = options.host ?? \"127.0.0.1\"\n  const server = await serve(api, { port: options.port ?? 0, host })\n  const address = server.address()\n  const port = typeof address === \"object\" && address !== null ? address.port : (options.port ?? 0)\n  const shown = host.includes(\":\") ? `[${host}]` : host\n  return {\n    url: `http://${shown}:${port}`,\n    port,\n    host,\n    server,\n    close: () =>\n      new Promise<void>((resolve, reject) => {\n        // Stop accepting first, then drop keep-alive sockets so close() can finish.\n        server.close((error) => {\n          if (error && (error as { code?: string }).code !== \"ERR_SERVER_NOT_RUNNING\") reject(error)\n          else resolve()\n        })\n        server.closeAllConnections?.()\n      }),\n  }\n}\n", "/// <reference types=\"node\" />\nimport { type Listening, listen, type ServeTarget } from \"@crvouga/mockingbird-adapter-node\"\nimport { createRuntime, type LlamaCloudRuntime, type LlamaCloudRuntimeOptions } from \"./runtime.js\"\n\n/** Port `mockingbird-llamacloud serve` listens on when none is given. */\nexport const DEFAULT_PORT = 8805\n\nexport type LlamaCloudServerOptions = LlamaCloudRuntimeOptions & {\n  /** Default `0`: the OS picks a free port. */\n  port?: number\n  /** Default `127.0.0.1`. */\n  host?: string\n}\n\nexport type LlamaCloudServer = Listening & { runtime: LlamaCloudRuntime }\n\n/** Serve the LlamaCloud mock over `node:http`. */\nexport const createServer = async (\n  options: LlamaCloudServerOptions = {},\n): Promise<LlamaCloudServer> => {\n  const { port, host, ...rest } = options\n  const runtime = createRuntime(rest)\n  const listening = await listen(runtime, {\n    port: port ?? 0,\n    ...(host !== undefined ? { host } : {}),\n  })\n  return { ...listening, runtime }\n}\n\nconst text = (value: string | boolean | undefined) =>\n  typeof value === \"string\" ? value : undefined\n\n/** How `serve` (and `serve --config`) builds the LlamaCloud mock from flags. */\nexport const serveTarget: ServeTarget = {\n  name: \"llamacloud\",\n  defaultPort: DEFAULT_PORT,\n  options: {\n    index: {\n      type: \"string\",\n      value: \"<name[,name\u2026]>\",\n      description:\n        \"Pipelines (indexes) to create in the Default project (the app's LLAMACLOUD_INDEX_NAME); default geviti-member-kb-v1\",\n    },\n    project: {\n      type: \"string\",\n      value: \"<name>\",\n      description:\n        \"Project those pipelines live in (the app's LLAMACLOUD_PROJECT_NAME); default Default\",\n    },\n    \"api-key\": {\n      type: \"string\",\n      value: \"<key>\",\n      description: \"Accept only this bearer key (default: any non-empty key)\",\n    },\n  },\n  create: (values, common) => {\n    const index = text(values.index)\n    const project = text(values.project)\n    const key = text(values[\"api-key\"])\n    return createRuntime({\n      ...(index\n        ? {\n            pipelines: index\n              .split(\",\")\n              .map((name) => name.trim())\n              .filter(Boolean)\n              .map((name) => ({ name, ...(project ? { projectName: project } : {}) })),\n          }\n        : project\n          ? { pipelines: [{ name: \"geviti-member-kb-v1\", projectName: project }] }\n          : {}),\n      ...(key ? { settings: { apiKeys: [key] } } : {}),\n      ...(common.adminKey !== undefined ? { adminKey: common.adminKey } : {}),\n      ...(common.seed !== undefined ? { seed: common.seed } : {}),\n      ...(common.onLog ? { onLog: common.onLog } : {}),\n    })\n  },\n  banner: () => [\n    \"auth: Authorization: Bearer <LLAMACLOUD_API_KEY>\",\n    \"backend: LLAMACLOUD_BASE_URL=<this>/api/v1; Makor chat SDK: LLAMA_CLOUD_BASE_URL=<this>\",\n    \"namespaces: x-mockingbird-namespace, /ns/<name>/\u2026, or PUT /__admin/credentials {<api key>: <ns>}\",\n  ],\n}\n"],
+  "mappings": ";;;;;AAAA,SAAS,gBAAgB;AACzB,SAA+B,iBAAiB;;;ACDhD,SAAS,oBAAoB;AAatB,IAAM,QAAQ,OAAO,KAAe,UAA4B,CAAA,MAAM;AAC3E,QAAM,SAAS,aAAa,OAAO,KAAK,QAAO;AAC7C,UAAM,SAAmB,CAAA;AACzB,qBAAiB,SAAS,KAAK;AAC7B,aAAO,KAAK,OAAO,KAAK,KAAK,CAAC;IAChC;AACA,UAAM,OAAO,OAAO,OAAO,MAAM;AACjC,UAAM,UAAU,OAAO,QAAO;AAC9B,UAAM,OAAO,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO;AAC9E,UAAM,OAAO,UAAU,IAAI,QAAQ,QAAQ,aAAa,QAAQ,EAAE,EAAE;AACpE,UAAM,MAAM,IAAI,OAAO;AACvB,UAAM,MAAM,IAAI,IAAI,IAAI,QAAQ,QAAQ,GAAG,GAAG,IAAI;AAClD,UAAM,SAAS,IAAI,UAAU;AAC7B,UAAM,OAAoB,EAAE,QAAQ,SAAS,IAAI,QAAiC;AAClF,QAAI,WAAW,SAAS,WAAW,UAAU,KAAK,SAAS,GAAG;AAC5D,WAAK,OAAO;IACd;AACA,UAAM,UAAU,IAAI,gBAAe;AACnC,QAAI,KAAK,SAAS,MAAK;AACrB,UAAI,CAAC,IAAI;AAAkB,gBAAQ,MAAK;IAC1C,CAAC;AACD,SAAK,SAAS,QAAQ;AACtB,UAAM,UAAU,IAAI,QAAQ,KAAK,IAAI;AACrC,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,IAAI,MAAM,OAAO;IACpC,SAAS,OAAO;AAEd,UAAK,MAA4B,SAAS,oBAAoB;AAC5D,YAAI,OAAO,QAAO;AAClB;MACF;AACA,UAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAkB,CAAE;AACzD,UAAI,IACF,KAAK,UAAU;QACb,OAAO;UACL,MAAM;UACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;OAEjE,CAAC;AAEJ;IACF;AAEA,UAAM,UAA6C,OAAO,YAAY,SAAS,OAAO;AACtF,UAAM,UAAU,SAAS,QAAQ,aAAY;AAC7C,QAAI,QAAQ,SAAS;AAAG,cAAQ,YAAY,IAAI;AAChD,QAAI,CAAC,SAAS,MAAM;AAClB,UAAI,UAAU,SAAS,QAAQ,OAAO;AACtC,UAAI,IAAG;AACP;IACF;AAEA,QAAI,UAAU,SAAS,QAAQ,OAAO;AACtC,QAAI,aAAY;AAChB,UAAM,SAAS,SAAS,KAAK,UAAS;AACtC,QAAI;AACF,iBAAS;AACP,cAAM,EAAE,MAAM,MAAK,IAAK,MAAM,OAAO,KAAI;AACzC,YAAI;AAAM;AACV,YAAI,CAAC,IAAI,MAAM,KAAK;AAAG,gBAAM,IAAI,QAAc,CAAC,YAAY,IAAI,KAAK,SAAS,OAAO,CAAC;MACxF;AACA,UAAI,IAAG;IACT,QAAQ;AACN,UAAI,QAAO;IACb;AACE,aAAO,YAAW;IACpB;EACF,CAAC;AACD,QAAM,IAAI,QAAc,CAAC,SAAS,WAAU;AAC1C,WAAO,KAAK,SAAS,MAAM;AAC3B,WAAO,OAAO,QAAQ,QAAQ,GAAG,QAAQ,MAAM,OAAO;EACxD,CAAC;AACD,SAAO;AACT;;;ACnEO,IAAM,SAAS,OAAO,KAAe,UAAyB,CAAA,MAA0B;AAC7F,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,SAAS,MAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,QAAQ,GAAG,KAAI,CAAE;AACjE,QAAM,UAAU,OAAO,QAAO;AAC9B,QAAM,OAAO,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAQ,QAAQ,QAAQ;AAC/F,QAAM,QAAQ,KAAK,SAAS,GAAG,IAAI,IAAI,IAAI,MAAM;AACjD,SAAO;IACL,KAAK,UAAU,KAAK,IAAI,IAAI;IAC5B;IACA;IACA;IACA,OAAO,MACL,IAAI,QAAc,CAAC,SAAS,WAAU;AAEpC,aAAO,MAAM,CAAC,UAAS;AACrB,YAAI,SAAU,MAA4B,SAAS;AAA0B,iBAAO,KAAK;;AACpF,kBAAO;MACd,CAAC;AACD,aAAO,sBAAqB;IAC9B,CAAC;;AAEP;;;AFZA,IAAM,aAAa,CAAC,YAClB,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,MAAM,MAAK;AAC7C,QAAM,OAAO,KAAK,IAAI,GAAG,OAAO,SAAS,WAAW,IAAI,OAAO,SAAS,SAAS,KAAK,EAAE;AACxF,QAAM,WAAW,OAAO,YAAY,SAAY,cAAc,OAAO,OAAO,OAAO,CAAC,MAAM;AAC1F,SAAO,KAAK,KAAK,OAAO,EAAE,CAAC,IAAI,OAAO,WAAW,GAAG,QAAQ;AAC9D,CAAC;AAEH,IAAM,OAAO,CAAC,SACZ;EACE,GAAG,KAAK,GAAG,WAAM,KAAK,WAAW;EACjC;EACA;EACA,KAAK,KAAK,GAAG;EACb;EACA;EACA,GAAG,OAAO,QAAQ,KAAK,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE;EACvF;EACA,SAAS,KAAK,GAAG;EACjB,KAAK,IAAI;AAEb,IAAM,cAAc,CAAC,MAAe,MAAc,YAChD;EACE,GAAG,KAAK,GAAG,IAAI,IAAI,WAAM,QAAQ,OAAO;EACxC;EACA;EACA,KAAK,QAAQ,SAAS,GAAG,KAAK,GAAG,IAAI,IAAI,YAAY;EACrD,GAAI,QAAQ,UAAU,CAAC,IAAI,YAAY,GAAG,WAAW,QAAQ,OAAO,CAAC,IAAI,CAAA;EACzE,KAAK,IAAI;AAGN,IAAM,SAAS,OAAO,MAAe,SAAmC;AAE7E,QAAM,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK;AAC1D,QAAM,QAAQ,SAAS,UAAa,KAAK,SAAS,IAAI,IAAI,IAAI;AAC9D,QAAM,OAAO,UAAU,IAAI,OAAO,KAAK,CAAC;AACxC,QAAM,OAAO,KAAK,MAAM,KAAK;AAC7B,MAAI,SAAS,UAAa,SAAS,YAAY,SAAS,QAAQ,SAAS,QAAQ;AAC/E,YAAQ,IAAI,KAAK,IAAI,CAAC;AACtB,WAAO;EACT;AACA,QAAM,UAAU,KAAK,SAAS,IAAI;AAClC,MAAI,CAAC,SAAS;AACZ,YAAQ,MAAM,GAAG,KAAK,GAAG,qBAAqB,KAAK,UAAU,IAAI,CAAC;;EAAO,KAAK,IAAI,CAAC,EAAE;AACrF,WAAO;EACT;AACA,MAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;AAClD,YAAQ,IAAI,YAAY,MAAM,MAAM,OAAO,CAAC;AAC5C,WAAO;EACT;AACA,MAAI;AACJ,MAAI;AACF,aAAS,UAAU;MACjB,MAAM;MACN,kBAAkB;MAClB,QAAQ;MACR,SAAS,OAAO,YACd,OAAO,QAAQ,QAAQ,WAAW,CAAA,CAAE,EAAE,IAAI,CAAC,CAAC,KAAK,MAAM,MAAM;QAC3D;QACA;UACE,MAAM,OAAO;UACb,GAAI,OAAO,YAAY,SAAY,EAAE,SAAS,OAAO,QAAO,IAAK,CAAA;;OAEpE,CAAC;KAEL;EACH,SAAS,OAAO;AACd,YAAQ,MACN,GAAG,KAAK,GAAG,IAAI,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;;EAAO,YAAY,MAAM,MAAM,OAAO,CAAC,EAAE;AAEzH,WAAO;EACT;AACA,SAAO,QAAQ,IAAI,OAAO,QAAQ,OAAO,WAAW;AACtD;AA8BA,IAAM,uBAAkD;EACtD,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,oBAAmB;EACzE,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,qBAAqB,SAAS,YAAW;EAC/F,aAAa;IACX,MAAM;IACN,OAAO;IACP,aAAa;;EAEf,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,+BAA8B;EACpF,KAAK;IACH,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;;EAEX,gBAAgB;IACd,MAAM;IACN,aACE;;EAEJ,QAAQ;IACN,MAAM;IACN,OAAO;IACP,aAAa;;;AAIjB,IAAM,YAAY,CAAC,WAAqB;AACtC,MAAI,WAAW;AAAO,WAAO;AAC7B,MAAI,WAAW;AAAQ,WAAO,CAAC,UAAsB,QAAQ,IAAI,KAAK,UAAU,KAAK,CAAC;AACtF,SAAO,CAAC,UAAqB;AAC3B,UAAM,KAAK,MAAM,gBAAgB,MAAM,YAAY,cAAc;AACjE,UAAM,KAAK,MAAM,cAAc,YAAY,KAAK,KAAK,MAAM,SAAS;AACpE,UAAM,QAAQ,MAAM,UAAU,UAAU,MAAM,OAAO,KAAK;AAC1D,UAAM,UAAU,MAAM,UAAU,aAAa;AAC7C,YAAQ,IACN,GAAG,MAAM,OAAO,IAAI,MAAM,MAAM,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,UAAU,KAAK,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE;EAEvH;AACF;AAEA,IAAM,WAAW,CAAC,UAChB,OAAO,UAAU,WAAW,QAAQ;AAkBtC,IAAM,aAAa,OAAO,MAAc,QAA0C;AAChF,MAAI,SAAS,IAAI;AAAM,WAAO;AAC9B,QAAM,YAAY,gCAAgC,IAAI;AACtD,MAAI;AACF,UAAM,MAAO,MAAM,OAAO;AAC1B,QAAI,CAAC,IAAI;AAAa,YAAM,IAAI,MAAM,GAAG,SAAS,yBAAyB;AAC3E,WAAO,IAAI;EACb,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,IAAI,MACR,wBAAwB,IAAI,MAAM,MAAM,0CAA0C,IAAI,GAAG;EAE7F;AACF;AAEA,IAAM,QAAQ,OACZ,QACA,QACA,WACsB;AACtB,QAAM,UAAU,MAAM,OAAO,OAAO,QAAQ;IAC1C,UAAU,OAAO;IACjB,MAAM,OAAO;IACb,OAAO,UAAU,OAAO,GAAG;GAC5B;AACD,QAAM,YAAY,MAAM,OAAO,SAAS,EAAE,MAAM,OAAO,MAAM,MAAM,OAAO,KAAI,CAAE;AAChF,UAAQ,IAAI,GAAG,OAAO,IAAI,sBAAsB,UAAU,GAAG,EAAE;AAC/D,UAAQ,IAAI,GAAG,OAAO,IAAI,gBAAgB,UAAU,GAAG,SAAS;AAChE,UAAQ,IACN,GAAG,OAAO,IAAI,WAAW,UAAU,GAAG,aAAa,OAAO,WAAW,qCAAqC,sCAAiC,GAAG;AAEhJ,aAAW,QAAQ,OAAO,SAAS,OAAO,KAAK,CAAA;AAAI,YAAQ,IAAI,GAAG,OAAO,IAAI,IAAI,IAAI,EAAE;AACvF,SAAO;AACT;AAEA,IAAM,cAAc,OAAO,YACzB,IAAI,QAAQ,CAAC,YAAW;AACtB,QAAM,OAAO,YAAW;AACtB,UAAM,QAAQ,WAAW,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAK,CAAE,CAAC;AACtD,YAAQ,CAAC;EACX;AACA,UAAQ,KAAK,UAAU,IAAI;AAC3B,UAAQ,KAAK,WAAW,IAAI;AAC9B,CAAC;AAGI,IAAM,eAAe,CAAC,YAAqC;EAChE,SAAS,aAAa,OAAO,IAAI;EACjC,SAAS,EAAE,GAAG,sBAAsB,GAAG,OAAO,QAAO;EACrD,MAAM,IAAI,QAAM;AACd,UAAM,MACJ,OAAO,cAAc,MAAM,OAAO,SAAU,SAAS,OAAO,GAAG,KAAK;AAEtE,QAAI,CAAC,CAAC,UAAU,QAAQ,KAAK,EAAE,SAAS,GAAG,GAAG;AAC5C,cAAQ,MAAM,0CAA0C,GAAG,GAAG;AAC9D,aAAO;IACT;AACA,UAAM,aAAa,SAAS,OAAO,MAAM;AACzC,QAAI,eAAe,QAAW;AAC5B,YAAM,SAAS,KAAK,MAAM,MAAM,SAAS,YAAY,MAAM,CAAC;AAC5D,YAAM,UAAuB,CAAA;AAC7B,UAAI;AACF,mBAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,YAAY,CAAA,CAAE,GAAG;AACjE,gBAAM,OAAO,MAAM,WAAW,MAAM,MAAM;AAC1C,kBAAQ,KACN,MAAM,MAAM,MAAM,MAAM,WAAW,CAAA,GAAI;YACrC,MAAM,MAAM,QAAQ,KAAK;YACzB,MAAM,MAAM,QAAQ;YACpB,GAAI,MAAM,aAAa,SAAY,EAAE,UAAU,MAAM,SAAQ,IAAK,CAAA;YAClE,GAAI,MAAM,SAAS,SAAY,EAAE,MAAM,MAAM,KAAI,IAAK,CAAA;YACtD,KAAK,OAAO,OAAO;WACpB,CAAC;QAEN;MACF,SAAS,OAAO;AACd,cAAM,QAAQ,WAAW,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAK,CAAE,CAAC;AACtD,gBAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AACpE,eAAO;MACT;AACA,aAAO,YAAY,OAAO;IAC5B;AACA,UAAM,OAAO,SAAS,OAAO,IAAI;AACjC,UAAM,WAAW,SAAS,OAAO,WAAW,CAAC,KAAK,QAAQ,IAAI;AAC9D,UAAM,OAAO,SAAS,OAAO,IAAI;AACjC,QAAI;AACJ,QAAI;AACF,kBAAY,MAAM,MAAM,QAAQ,QAAQ;QACtC,MAAM,SAAS,SAAY,OAAO,cAAc,OAAO,SAAS,MAAM,EAAE;QACxE,MAAM,SAAS,OAAO,IAAI,KAAK;QAC/B,GAAI,aAAa,SAAY,EAAE,SAAQ,IAAK,CAAA;QAC5C,GAAI,SAAS,SAAY,EAAE,KAAI,IAAK,CAAA;QACpC;OACD;IACH,SAAS,OAAO;AACd,cAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AACpE,aAAO;IACT;AACA,WAAO,YAAY,CAAC,SAAS,CAAC;EAChC;;;;AG5RK,IAAM,eAAe;AAYrB,IAAMA,gBAAe,OAC1B,UAAmC,CAAC,MACN;AAC9B,QAAM,EAAE,MAAM,MAAM,GAAG,KAAK,IAAI;AAChC,QAAM,UAAU,cAAc,IAAI;AAClC,QAAM,YAAY,MAAM,OAAO,SAAS;AAAA,IACtC,MAAM,QAAQ;AAAA,IACd,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,EACvC,CAAC;AACD,SAAO,EAAE,GAAG,WAAW,QAAQ;AACjC;AAEA,IAAM,OAAO,CAAC,UACZ,OAAO,UAAU,WAAW,QAAQ;AAG/B,IAAM,cAA2B;AAAA,EACtC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,SAAS;AAAA,IACP,OAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ,CAAC,QAAQ,WAAW;AAC1B,UAAM,QAAQ,KAAK,OAAO,KAAK;AAC/B,UAAM,UAAU,KAAK,OAAO,OAAO;AACnC,UAAM,MAAM,KAAK,OAAO,SAAS,CAAC;AAClC,WAAO,cAAc;AAAA,MACnB,GAAI,QACA;AAAA,QACE,WAAW,MACR,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,OAAO,EACd,IAAI,CAAC,UAAU,EAAE,MAAM,GAAI,UAAU,EAAE,aAAa,QAAQ,IAAI,CAAC,EAAG,EAAE;AAAA,MAC3E,IACA,UACE,EAAE,WAAW,CAAC,EAAE,MAAM,uBAAuB,aAAa,QAAQ,CAAC,EAAE,IACrE,CAAC;AAAA,MACP,GAAI,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC;AAAA,MAC9C,GAAI,OAAO,aAAa,SAAY,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;AAAA,MACrE,GAAI,OAAO,SAAS,SAAY,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MACzD,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,IAChD,CAAC;AAAA,EACH;AAAA,EACA,QAAQ,MAAM;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": ["createServer"]
+}