@crvouga/mockingbird-service-llamacloud 0.2.0 → 1.0.1

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.
package/CHANGELOG.md CHANGED
@@ -1,6 +1,19 @@
1
1
  # Changelog — @crvouga/mockingbird-service-llamacloud
2
2
 
3
- ## 0.2.0 (2026-09-24)
3
+ ## 1.0.1 (2026-09-26)
4
+
5
+ ### Fixes and improvements
6
+
7
+ - take the rejected-request byte count from content-length, never by reading the body ([a0e5fb2](https://github.com/crvouga/mockingbird/commit/a0e5fb2fc80ab725c3552b612f3f091fd6c857fb))
8
+ - reject a present body by media type, and log what a rejected request sent ([12e351a](https://github.com/crvouga/mockingbird/commit/12e351aba53cfb7b41e31a7809419455fc2902eb))
9
+
10
+ ## 1.0.0 (2026-09-24)
11
+
12
+ ### ⚠️ Breaking changes
13
+
14
+ - vendor branding for every service; purge internal mocks and consumer names ([f689534](https://github.com/crvouga/mockingbird/commit/f6895343543550dafcb7d76b426cae7635e03226))
15
+
16
+ ## 0.2.0 (2026-09-23)
4
17
 
5
18
  ### Features
6
19
 
package/README.md CHANGED
@@ -24,7 +24,7 @@ any Fetch server.
24
24
  ## Usage
25
25
 
26
26
  ```bash
27
- npx mockingbird-llamacloud serve --port 8805 --index geviti-member-kb-v1 --project Default
27
+ npx mockingbird-llamacloud serve --port 8805 --index acme-member-kb-v1 --project Default
28
28
  ```
29
29
 
30
30
  Point the app at it:
@@ -32,12 +32,12 @@ Point the app at it:
32
32
  | Consumer | Setting |
33
33
  | --- | --- |
34
34
  | 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 |
35
- | Makor chat (`llama_cloud_services`) | `LLAMA_CLOUD_BASE_URL=http://127.0.0.1:8805` (no `/api/v1`; verified below, no code change needed) |
35
+ | Python chat service (`llama_cloud_services`) | `LLAMA_CLOUD_BASE_URL=http://127.0.0.1:8805` (no `/api/v1`; verified below, no code change needed) |
36
36
 
37
37
  ```ts
38
38
  import { createRuntime } from "@crvouga/mockingbird-service-llamacloud"
39
39
 
40
- const llama = createRuntime({ pipelines: [{ name: "geviti-member-kb-v1", projectName: "Default" }] })
40
+ const llama = createRuntime({ pipelines: [{ name: "acme-member-kb-v1", projectName: "Default" }] })
41
41
  const admin = (path: string, body: unknown) =>
42
42
  llama.fetch(
43
43
  new Request(`http://llamacloud.test/__admin${path}`, {
@@ -89,12 +89,12 @@ Node metadata is sent under both `metadata` (read by our backend) and `extra_inf
89
89
  official client model's field name). Without live credentials, which of the two the real API
90
90
  sends is unverified.
91
91
 
92
- ### Makor chat SDK: verified call sequence
92
+ ### Python chat SDK: verified call sequence
93
93
 
94
94
  The catalog listed this as unverified. It has now been checked against the installed SDK:
95
95
  llama-cloud-services **0.6.88**, llama-cloud **0.1.45** and llama-index-core **0.14.10**, the
96
- versions pinned in `apps/makor-ecosystem/uv.lock`. The wheels were read, and
97
- `llamacloud.sdk.test.ts` runs the real Makor `LlamaCloudClient` file on the real SDK against the
96
+ versions the consumer app's Python chat service pins. The wheels were read, and
97
+ `llamacloud.sdk.test.ts` runs that service's real `LlamaCloudClient` file on the real SDK against the
98
98
  served mock. `LlamaCloudIndex(name, project_name=…, api_key=…)` followed by
99
99
  `.as_retriever(similarity_top_k=5).aretrieve(q)` makes these calls:
100
100
 
@@ -107,13 +107,13 @@ served mock. `LlamaCloudIndex(name, project_name=…, api_key=…)` followed by
107
107
  4. `POST /api/v1/pipelines/{id}/retrieve {query, dense_similarity_top_k: 5}`.
108
108
 
109
109
  The base URL comes from `base_url` or `LLAMA_CLOUD_BASE_URL`, falling back to
110
- `https://api.cloud.llamaindex.ai` (`llama_index.core.ingestion.api_utils.get_client`). Makor
111
- passes no `base_url`, so setting the environment variable is enough. The SDK's pydantic models
110
+ `https://api.cloud.llamaindex.ai` (`llama_index.core.ingestion.api_utils.get_client`). The
111
+ client passes no `base_url`, so setting the environment variable is enough. The SDK's pydantic models
112
112
  are strict: `Pipeline.status` must be `CREATED` or `DELETING`, and `embedding_config` is
113
113
  required. The mock satisfies both, and the SDK test fails if a shape drifts.
114
114
 
115
- **Discrepancy:** Makor's `llamacloud_project_name` defaults to `"default"` (lowercase). The
116
- backend's default is `"Default"`. Project lookup is exact, so Makor needs
115
+ **Discrepancy:** the Python client's `llamacloud_project_name` defaults to `"default"` (lowercase). The
116
+ backend's default is `"Default"`. Project lookup is exact, so it needs
117
117
  `LLAMACLOUD_PROJECT_NAME=Default`, or a seeded `default` project. Otherwise the client degrades
118
118
  to empty results, which the acceptance tests cover.
119
119
 
@@ -122,7 +122,8 @@ To run the SDK test:
122
122
  ```bash
123
123
  uv venv /tmp/llama && VIRTUAL_ENV=/tmp/llama uv pip install \
124
124
  llama-cloud-services==0.6.88 llama-cloud==0.1.45 llama-index-core==0.14.10
125
- MOCKINGBIRD_LLAMACLOUD_PYTHON=/tmp/llama/bin/python bun test llamacloud.sdk
125
+ MOCKINGBIRD_LLAMACLOUD_PYTHON=/tmp/llama/bin/python \
126
+ MOCKINGBIRD_LLAMACLOUD_PY_CLIENT=/path/to/llamacloud_client.py bun test llamacloud.sdk
126
127
  ```
127
128
 
128
129
  ### Admin (beyond the standard contract)
@@ -157,7 +158,7 @@ Neither consumer can add headers, so a namespace can be chosen three ways:
157
158
  - a `/ns/<name>` prefix on the base URL;
158
159
  - the API key: `PUT /__admin/credentials {"credentials": {"<LLAMACLOUD_API_KEY>": "<namespace>"}}`.
159
160
 
160
- Each namespace starts with the seeded pipelines, by default `geviti-member-kb-v1` in project
161
+ Each namespace starts with the seeded pipelines, by default `acme-member-kb-v1` in project
161
162
  `Default`. The request journal records operation ids, statuses and pipeline and document ids. It
162
163
  never records queries, document text or titles.
163
164
 
@@ -179,7 +180,7 @@ never records queries, document text or titles.
179
180
  | `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets). Options: `pipelines`, `settings`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
180
181
  | `LLAMACLOUD_PRESETS` | object | Every named fault preset. |
181
182
  | `LLAMACLOUD_NAMESPACE` | string | The service name, `"llamacloud"`. |
182
- | `DEFAULT_PIPELINES`, `DEFAULT_PIPELINE_NAME`, `DEFAULT_PROJECT_NAME`, `DEFAULT_SETTINGS` | values | The seed: `geviti-member-kb-v1` in `Default`, top-k 5, any key. |
183
+ | `DEFAULT_PIPELINES`, `DEFAULT_PIPELINE_NAME`, `DEFAULT_PROJECT_NAME`, `DEFAULT_SETTINGS` | values | The seed: `acme-member-kb-v1` in `Default`, top-k 5, any key. |
183
184
  | `rank`, `terms` | functions | The default term-overlap ranking and its tokenizer. |
184
185
  | `uuidFrom` | function | The stable UUID derivation used for project, pipeline and document ids. |
185
186
  | `document`, `operationIds`, `supportedOperationIds` | values | The vendored OpenAPI contract and its operation ids. |
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  createRuntime
3
- } from "./chunk-UP32DVYJ.js";
3
+ } from "./chunk-F7C2JOIW.js";
4
4
 
5
5
  // ../../adapters/node/dist/cli.js
6
6
  import { readFile } from "node:fs/promises";
@@ -208,7 +208,9 @@ var formatLog = (format) => {
208
208
  const ns = entry.namespace === "default" ? "" : ` [${entry.namespace}]`;
209
209
  const fault = entry.faultId ? ` fault=${entry.faultId}` : "";
210
210
  const adopted = entry.adopted ? " adopted" : "";
211
- console.log(`${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}`);
211
+ const received = entry.request ? ` received=${entry.request.bodyBytes === null ? "?" : `${entry.request.bodyBytes}B`} ct=${entry.request.contentType ?? "-"}${entry.request.transferEncoding ? ` te=${entry.request.transferEncoding}` : ""}` : "";
212
+ const issues = entry.issues?.length ? ` issues=${entry.issues.slice(0, 3).map((issue) => `${issue.path || "$"}: ${issue.message}`).join("; ")}${entry.issues.length > 3 ? ` (+${entry.issues.length - 3})` : ""}` : "";
213
+ console.log(`${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}${received}${issues}`);
212
214
  };
213
215
  };
214
216
  var asString = (value) => typeof value === "string" ? value : void 0;
@@ -318,7 +320,7 @@ var serveTarget = {
318
320
  index: {
319
321
  type: "string",
320
322
  value: "<name[,name\u2026]>",
321
- description: "Pipelines (indexes) to create in the Default project (the app's LLAMACLOUD_INDEX_NAME); default geviti-member-kb-v1"
323
+ description: "Pipelines (indexes) to create in the Default project (the app's LLAMACLOUD_INDEX_NAME); default acme-member-kb-v1"
322
324
  },
323
325
  project: {
324
326
  type: "string",
@@ -338,7 +340,7 @@ var serveTarget = {
338
340
  return createRuntime({
339
341
  ...index ? {
340
342
  pipelines: index.split(",").map((name) => name.trim()).filter(Boolean).map((name) => ({ name, ...project ? { projectName: project } : {} }))
341
- } : project ? { pipelines: [{ name: "geviti-member-kb-v1", projectName: project }] } : {},
343
+ } : project ? { pipelines: [{ name: "acme-member-kb-v1", projectName: project }] } : {},
342
344
  ...key ? { settings: { apiKeys: [key] } } : {},
343
345
  ...common.adminKey !== void 0 ? { adminKey: common.adminKey } : {},
344
346
  ...common.seed !== void 0 ? { seed: common.seed } : {},
@@ -347,7 +349,7 @@ var serveTarget = {
347
349
  },
348
350
  banner: () => [
349
351
  "auth: Authorization: Bearer <LLAMACLOUD_API_KEY>",
350
- "backend: LLAMACLOUD_BASE_URL=<this>/api/v1; Makor chat SDK: LLAMA_CLOUD_BASE_URL=<this>",
352
+ "backend: LLAMACLOUD_BASE_URL=<this>/api/v1; Python chat SDK: LLAMA_CLOUD_BASE_URL=<this>",
351
353
  "namespaces: x-mockingbird-namespace, /ns/<name>/\u2026, or PUT /__admin/credentials {<api key>: <ns>}"
352
354
  ]
353
355
  };
@@ -359,4 +361,4 @@ export {
359
361
  createServer2 as createServer,
360
362
  serveTarget
361
363
  };
362
- //# sourceMappingURL=chunk-J2WKZZ5I.js.map
364
+ //# sourceMappingURL=chunk-AET7XWKD.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../adapters/node/src/cli.ts", "../../../adapters/node/src/serve.ts", "../../../adapters/node/src/listen.ts", "../src/server.ts"],
4
+ "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 // A rejection says what arrived (never the body) and why the service refused it.\n const received = entry.request\n ? ` received=${entry.request.bodyBytes === null ? \"?\" : `${entry.request.bodyBytes}B`} ct=${entry.request.contentType ?? \"-\"}${\n entry.request.transferEncoding ? ` te=${entry.request.transferEncoding}` : \"\"\n }`\n : \"\"\n const issues = entry.issues?.length\n ? ` issues=${entry.issues\n .slice(0, 3)\n .map((issue) => `${issue.path || \"$\"}: ${issue.message}`)\n .join(\"; \")}${entry.issues.length > 3 ? ` (+${entry.issues.length - 3})` : \"\"}`\n : \"\"\n console.log(\n `${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}${received}${issues}`,\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 acme-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: \"acme-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; Python 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"],
5
+ "mappings": "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",
6
+ "names": ["createServer"]
7
+ }
@@ -1347,6 +1347,90 @@ var operationMetadata = (operation) => {
1347
1347
 
1348
1348
  // ../core/dist/service.js
1349
1349
  import { Hono } from "hono";
1350
+
1351
+ // ../core/dist/validation.js
1352
+ var requestBodyOf = (context) => {
1353
+ const requestBody = context.operation.operation.requestBody;
1354
+ return requestBody ? deref(context.document, requestBody) : void 0;
1355
+ };
1356
+ var mediaTypeMatches = (accepted, actual) => {
1357
+ const pattern = mediaTypeOf(accepted) ?? accepted.toLowerCase();
1358
+ if (pattern === actual || pattern === "*/*")
1359
+ return true;
1360
+ const [type, subtype] = pattern.split("/");
1361
+ const [actualType, actualSubtype] = actual.split("/");
1362
+ if (type !== actualType && type !== "*")
1363
+ return false;
1364
+ if (subtype === void 0 || subtype === "*")
1365
+ return true;
1366
+ if (subtype.startsWith("*+"))
1367
+ return actualSubtype?.endsWith(subtype.slice(1)) === true;
1368
+ return false;
1369
+ };
1370
+ var acceptedKeyFor = (content, mediaType) => {
1371
+ if (!content || mediaType === void 0)
1372
+ return void 0;
1373
+ const keys = Object.keys(content);
1374
+ return keys.find((key) => mediaTypeOf(key) === mediaType) ?? keys.find((key) => mediaTypeMatches(key, mediaType));
1375
+ };
1376
+ var unsupportedMediaType = (context, options = {}) => {
1377
+ if (context.body.kind === "empty" && options.includeEmpty !== true)
1378
+ return void 0;
1379
+ const content = requestBodyOf(context)?.content;
1380
+ if (!content || Object.keys(content).length === 0)
1381
+ return void 0;
1382
+ const mediaType = mediaTypeOf(context.request.headers.get("content-type"));
1383
+ if (acceptedKeyFor(content, mediaType) !== void 0)
1384
+ return void 0;
1385
+ return { mediaType: mediaType ?? null, accepted: Object.keys(content) };
1386
+ };
1387
+ var recorded = /* @__PURE__ */ new WeakMap();
1388
+ var recordedIssues = (request) => recorded.get(request);
1389
+ var bodyIssues = (context, contentType = "application/json") => {
1390
+ const issues = findBodyIssues(context, contentType);
1391
+ if (issues.length > 0)
1392
+ recorded.set(context.request, issues);
1393
+ return issues;
1394
+ };
1395
+ var findBodyIssues = (context, contentType) => {
1396
+ const resolved = requestBodyOf(context);
1397
+ if (!resolved)
1398
+ return [];
1399
+ const unsupported = unsupportedMediaType(context);
1400
+ if (unsupported) {
1401
+ return [
1402
+ {
1403
+ path: "",
1404
+ kind: "media_type",
1405
+ message: unsupported.mediaType === null ? "request body has no content-type" : `request body media type ${unsupported.mediaType} is not supported`
1406
+ }
1407
+ ];
1408
+ }
1409
+ const key = acceptedKeyFor(resolved.content, mediaTypeOf(context.request.headers.get("content-type"))) ?? contentType;
1410
+ const schema = resolved.content?.[key]?.schema;
1411
+ if (!schema)
1412
+ return [];
1413
+ if (context.body.kind === "invalid") {
1414
+ return [
1415
+ {
1416
+ path: "",
1417
+ kind: "syntax",
1418
+ message: `request body is not valid ${context.body.mediaType}`
1419
+ }
1420
+ ];
1421
+ }
1422
+ const value = context.body.kind === "json" || context.body.kind === "form" || context.body.kind === "text" ? context.body.value : void 0;
1423
+ if (value === void 0) {
1424
+ return resolved.required && context.body.kind === "empty" ? [{ path: "", kind: "required", message: "request body is required" }] : [];
1425
+ }
1426
+ return validateValue(context.document, resolveSchema(context.document, schema), value).map((issue) => ({ path: issue.path.join("."), kind: "schema", message: issue.message }));
1427
+ };
1428
+
1429
+ // ../core/dist/service.js
1430
+ var withIssues = (request, response) => {
1431
+ const issues = response.status >= 400 ? recordedIssues(request) : void 0;
1432
+ return issues && issues.length > 0 ? annotateResponse(response, { issues }) : response;
1433
+ };
1350
1434
  var defineOperations = (handlers) => handlers;
1351
1435
  var OperationRegistryError = class extends Error {
1352
1436
  problems;
@@ -1432,9 +1516,7 @@ var createService = (options) => {
1432
1516
  now
1433
1517
  };
1434
1518
  const short = await options.before?.(context);
1435
- if (short)
1436
- return short;
1437
- return handler(context);
1519
+ return withIssues(request, short ?? await handler(context));
1438
1520
  };
1439
1521
  app.on(operation.method.toUpperCase(), honoPath(operation.path), route);
1440
1522
  }
@@ -1471,7 +1553,7 @@ var restoreNamespace = (sqlite, namespace, snapshot) => {
1471
1553
  };
1472
1554
 
1473
1555
  // ../core/dist/version.js
1474
- var PACKAGE_VERSION = true ? "0.2.0" : UNRELEASED_VERSION;
1556
+ var PACKAGE_VERSION = true ? "1.0.1" : UNRELEASED_VERSION;
1475
1557
 
1476
1558
  // ../core/dist/webhooks.js
1477
1559
  var json2 = (status, body) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" } });
@@ -1911,8 +1993,15 @@ var createRuntime = (options) => {
1911
1993
  const started = monotonicNow();
1912
1994
  const url = new URL(request.url);
1913
1995
  const operationId = operationIdFor(request, url.pathname);
1996
+ const contentLength = request.headers.get("content-length");
1997
+ const received = {
1998
+ contentType: request.headers.get("content-type"),
1999
+ bodyBytes: contentLength !== null && /^\d+$/.test(contentLength) ? Number(contentLength) : null,
2000
+ transferEncoding: request.headers.get("transfer-encoding")
2001
+ };
1914
2002
  const log = (status, faultId, response2) => {
1915
2003
  const noted = response2 ? responseNotes(response2) : void 0;
2004
+ const rejected = status >= 400 && faultId === void 0;
1916
2005
  const entry = {
1917
2006
  service: options.name,
1918
2007
  namespace,
@@ -1924,7 +2013,9 @@ var createRuntime = (options) => {
1924
2013
  unmatched: options.document !== void 0 && operationId === void 0,
1925
2014
  ...faultId !== void 0 ? { faultId } : {},
1926
2015
  ...noted?.ids && Object.keys(noted.ids).length > 0 ? { ids: noted.ids } : {},
1927
- ...noted?.adopted ? { adopted: true } : {}
2016
+ ...noted?.adopted ? { adopted: true } : {},
2017
+ ...rejected ? { request: { ...received } } : {},
2018
+ ...rejected && noted?.issues && noted.issues.length > 0 ? { issues: noted.issues.map((issue) => ({ ...issue })) } : {}
1928
2019
  };
1929
2020
  metrics.record(entry);
1930
2021
  journal.record({ ...entry, at: new Date(clock.now()).toISOString() });
@@ -2131,27 +2222,8 @@ var presetRoutes = (presets, runtime) => ({
2131
2222
  }
2132
2223
  });
2133
2224
 
2134
- // ../core/dist/validation.js
2135
- var bodyIssues = (context, contentType = "application/json") => {
2136
- const requestBody = context.operation.operation.requestBody;
2137
- if (!requestBody)
2138
- return [];
2139
- const resolved = deref(context.document, requestBody);
2140
- const schema = resolved.content?.[contentType]?.schema;
2141
- if (!schema)
2142
- return [];
2143
- const value = context.body.kind === "json" || context.body.kind === "form" ? context.body.value : void 0;
2144
- if (context.body.kind === "invalid") {
2145
- return [{ path: "", message: `request body is not valid ${context.body.mediaType}` }];
2146
- }
2147
- if (value === void 0) {
2148
- return resolved.required ? [{ path: "", message: "request body is required" }] : [];
2149
- }
2150
- return validateValue(context.document, resolveSchema(context.document, schema), value).map((issue) => ({ path: issue.path.join("."), message: issue.message }));
2151
- };
2152
-
2153
2225
  // src/generated/openapi.ts
2154
- var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"LlamaCloud platform API (Mockingbird subset)","description":"Stateful mock subset of the LlamaCloud (LlamaIndex managed index) platform API: project and\\npipeline lookup, pipeline retrieval, and pipeline documents (list, get, create, upsert,\\ndelete). Covers both of our consumers: the backend's plain-\`fetch\` knowledge adapter and the\\nMakor chat service's \`llama_cloud_services.LlamaCloudIndex(...).as_retriever().aretrieve()\`.\\n","version":"1","x-mockingbird-upstream":{"note":"Hand-authored from the wire shapes of the official Python client (llama-cloud 0.1.45, the Fern-generated client that llama-cloud-services 0.6.88 drives) and our backend adapter (llamacloud-knowledge.adapter.ts). Response models are trimmed to the fields those clients require or read."}},"servers":[{"url":"https://api.cloud.llamaindex.ai"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/projects":{"get":{"operationId":"ListProjects","description":"The SDK's project lookup (\`resolve_project\` by \`project_name\`).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Matching projects","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/projects/{project_id}":{"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"project","missing":"00000000-0000-4000-8000-00000000dead"}}}],"get":{"operationId":"GetProject","description":"The retriever's project lookup by id (\`as_retriever\` passes \`project_id\`).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"The project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/pipelines":{"get":{"operationId":"SearchPipelines","description":"Our backend lists by \`project_name\` and picks \`name == LLAMACLOUD_INDEX_NAME\`; the SDK searches by \`project_id\` + \`pipeline_name\` + \`pipeline_type=MANAGED\`.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_id","in":"query","schema":{"type":"string","maxLength":64,"x-mockingbird-resource-ref":{"type":"project","missing":"00000000-0000-4000-8000-00000000dead"}}},{"name":"project_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"pipeline_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"pipeline_type","in":"query","schema":{"type":"string","enum":["PLAYGROUND","MANAGED"]}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Matching pipelines","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Pipeline"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/pipelines/{pipeline_id}":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"get":{"operationId":"GetPipeline","description":"The retriever's pipeline lookup by id.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"200":{"description":"The pipeline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pipeline"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/pipelines/{pipeline_id}/retrieve":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"post":{"operationId":"RunSearch","description":"Retrieval. Answered from a scripted rule (\`PUT /__admin/retrieval\`) whose \`contains\` matches the query, else a deterministic term-overlap ranking over the stored documents.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_id","in":"query","schema":{"type":"string","maxLength":64}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveParams"}}}},"responses":{"200":{"description":"Retrieval results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveResults"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}},"/api/v1/pipelines/{pipeline_id}/documents":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"get":{"operationId":"ListPipelineDocuments","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"skip","in":"query","schema":{"type":"integer","minimum":0,"maximum":1000}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"The pipeline's documents, oldest first","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}},"post":{"operationId":"CreateBatchPipelineDocuments","description":"Insert documents (the SDK's \`insert\`); an id that already exists is replaced.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocumentBatch"}}}},"responses":{"200":{"description":"The stored documents","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}},"put":{"operationId":"UpsertBatchPipelineDocuments","description":"Upsert by id (our backend uses the article slug as the id).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocumentBatch"}}}},"responses":{"200":{"description":"The stored documents","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}},"/api/v1/pipelines/{pipeline_id}/documents/{document_id}":{"parameters":[{"$ref":"#/components/parameters/PipelineId"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"document","missing":"missing-document"}}}],"get":{"operationId":"GetPipelineDocument","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"200":{"description":"The document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocument"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"DeletePipelineDocument","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"PipelineId":{"name":"pipeline_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"pipeline","missing":"00000000-0000-4000-8000-0000000beef0"}}}},"responses":{"Unauthorized":{"description":"Missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detail"}}}},"NotFound":{"description":"Unknown resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detail"}}}},"ValidationFailed":{"description":"FastAPI validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"schemas":{"Detail":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string"}}},"HTTPValidationError":{"type":"object","required":["detail"],"properties":{"detail":{"type":"array","items":{"type":"object","required":["loc","msg","type"],"properties":{"loc":{"type":"array","items":{"type":["string","integer"]}},"msg":{"type":"string"},"type":{"type":"string"}}}}}},"Project":{"type":"object","required":["id","name","organization_id"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"project","identity":true}},"name":{"type":"string"},"organization_id":{"type":"string"},"is_default":{"type":"boolean"},"ad_hoc_eval_dataset_id":{"type":["string","null"]},"created_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}},"updated_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}}}},"Pipeline":{"type":"object","required":["id","name","project_id","embedding_config"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"pipeline","identity":true}},"name":{"type":"string"},"project_id":{"type":"string"},"pipeline_type":{"type":"string","enum":["PLAYGROUND","MANAGED"]},"embedding_config":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"component":{"type":"object"}}},"status":{"type":"string","enum":["CREATED","DELETING"]},"created_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}},"updated_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}}}},"CloudDocumentCreate":{"type":"object","required":["text","metadata"],"properties":{"id":{"type":"string","minLength":1,"maxLength":80},"text":{"type":"string","maxLength":4000},"metadata":{"type":"object","maxProperties":8,"additionalProperties":true,"properties":{"file_name":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":200},"slug":{"type":"string","maxLength":80},"contentType":{"type":"string","maxLength":40},"sourceUrl":{"type":["string","null"],"maxLength":400},"updatedAt":{"type":"string","maxLength":40}}},"excluded_embed_metadata_keys":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":40}},"excluded_llm_metadata_keys":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":40}},"page_positions":{"type":["array","null"],"maxItems":8,"items":{"type":"integer"}}}},"CloudDocumentBatch":{"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/CloudDocumentCreate"}},"CloudDocument":{"type":"object","required":["id","text","metadata"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"document","identity":true}},"text":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"excluded_embed_metadata_keys":{"type":"array","items":{"type":"string"}},"excluded_llm_metadata_keys":{"type":"array","items":{"type":"string"}},"page_positions":{"type":["array","null"],"items":{"type":"integer"}},"status_metadata":{"type":["object","null"]}}},"RetrieveParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":400},"dense_similarity_top_k":{"type":"integer","minimum":1,"maximum":100},"sparse_similarity_top_k":{"type":"integer","minimum":1,"maximum":100},"enable_reranking":{"type":"boolean"},"rerank_top_n":{"type":"integer","minimum":1,"maximum":100},"alpha":{"type":"number","minimum":0,"maximum":1},"retrieval_mode":{"type":"string","enum":["chunks","files_via_metadata","files_via_content","auto_routed"]},"files_top_k":{"type":"integer","minimum":1,"maximum":100},"retrieve_image_nodes":{"type":"boolean"},"retrieve_page_screenshot_nodes":{"type":"boolean"},"retrieve_page_figure_nodes":{"type":"boolean"},"class_name":{"type":"string","maxLength":40},"dense_similarity_cutoff":{"type":["number","null"]},"search_filters":{"type":["object","null"]},"search_filters_inference_schema":{"type":["object","null"]}}},"TextNodeWithScore":{"type":"object","required":["node","score"],"properties":{"node":{"type":"object","required":["id_","text","metadata"],"properties":{"id_":{"type":"string"},"text":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"extra_info":{"type":"object","additionalProperties":true},"class_name":{"type":"string"},"mimetype":{"type":"string"},"start_char_idx":{"type":["integer","null"]},"end_char_idx":{"type":["integer","null"]},"excluded_embed_metadata_keys":{"type":"array","items":{"type":"string"}},"excluded_llm_metadata_keys":{"type":"array","items":{"type":"string"}},"relationships":{"type":"object"},"text_template":{"type":"string"},"metadata_template":{"type":"string"},"metadata_seperator":{"type":"string"}}},"score":{"type":["number","null"]},"class_name":{"type":"string"}}},"RetrieveResults":{"type":"object","required":["pipeline_id","retrieval_nodes"],"properties":{"pipeline_id":{"type":"string"},"retrieval_nodes":{"type":"array","items":{"$ref":"#/components/schemas/TextNodeWithScore"}},"image_nodes":{"type":"array","items":{"type":"object"}},"page_figure_nodes":{"type":"array","items":{"type":"object"}},"retrieval_latency":{"type":"object","additionalProperties":{"type":"number"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"inferred_search_filters":{"type":["object","null"]},"class_name":{"type":"string"}}}}}}`);
2226
+ var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"LlamaCloud platform API (Mockingbird subset)","description":"Stateful mock subset of the LlamaCloud (LlamaIndex managed index) platform API: project and\\npipeline lookup, pipeline retrieval, and pipeline documents (list, get, create, upsert,\\ndelete). Covers both of our consumers: the backend's plain-\`fetch\` knowledge adapter and the\\nPython chat service's \`llama_cloud_services.LlamaCloudIndex(...).as_retriever().aretrieve()\`.\\n","version":"1","x-mockingbird-upstream":{"note":"Hand-authored from the wire shapes of the official Python client (llama-cloud 0.1.45, the Fern-generated client that llama-cloud-services 0.6.88 drives) and our backend adapter (llamacloud-knowledge.adapter.ts). Response models are trimmed to the fields those clients require or read."}},"servers":[{"url":"https://api.cloud.llamaindex.ai"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/projects":{"get":{"operationId":"ListProjects","description":"The SDK's project lookup (\`resolve_project\` by \`project_name\`).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Matching projects","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/projects/{project_id}":{"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"project","missing":"00000000-0000-4000-8000-00000000dead"}}}],"get":{"operationId":"GetProject","description":"The retriever's project lookup by id (\`as_retriever\` passes \`project_id\`).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"The project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/pipelines":{"get":{"operationId":"SearchPipelines","description":"Our backend lists by \`project_name\` and picks \`name == LLAMACLOUD_INDEX_NAME\`; the SDK searches by \`project_id\` + \`pipeline_name\` + \`pipeline_type=MANAGED\`.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_id","in":"query","schema":{"type":"string","maxLength":64,"x-mockingbird-resource-ref":{"type":"project","missing":"00000000-0000-4000-8000-00000000dead"}}},{"name":"project_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"pipeline_name","in":"query","schema":{"type":"string","maxLength":64}},{"name":"pipeline_type","in":"query","schema":{"type":"string","enum":["PLAYGROUND","MANAGED"]}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Matching pipelines","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Pipeline"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/pipelines/{pipeline_id}":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"get":{"operationId":"GetPipeline","description":"The retriever's pipeline lookup by id.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"200":{"description":"The pipeline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pipeline"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/pipelines/{pipeline_id}/retrieve":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"post":{"operationId":"RunSearch","description":"Retrieval. Answered from a scripted rule (\`PUT /__admin/retrieval\`) whose \`contains\` matches the query, else a deterministic term-overlap ranking over the stored documents.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"project_id","in":"query","schema":{"type":"string","maxLength":64}},{"name":"organization_id","in":"query","schema":{"type":"string","maxLength":64}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveParams"}}}},"responses":{"200":{"description":"Retrieval results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveResults"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}},"/api/v1/pipelines/{pipeline_id}/documents":{"parameters":[{"$ref":"#/components/parameters/PipelineId"}],"get":{"operationId":"ListPipelineDocuments","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"skip","in":"query","schema":{"type":"integer","minimum":0,"maximum":1000}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"The pipeline's documents, oldest first","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}},"post":{"operationId":"CreateBatchPipelineDocuments","description":"Insert documents (the SDK's \`insert\`); an id that already exists is replaced.","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocumentBatch"}}}},"responses":{"200":{"description":"The stored documents","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}},"put":{"operationId":"UpsertBatchPipelineDocuments","description":"Upsert by id (our backend uses the article slug as the id).","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocumentBatch"}}}},"responses":{"200":{"description":"The stored documents","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CloudDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}},"/api/v1/pipelines/{pipeline_id}/documents/{document_id}":{"parameters":[{"$ref":"#/components/parameters/PipelineId"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"document","missing":"missing-document"}}}],"get":{"operationId":"GetPipelineDocument","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"200":{"description":"The document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudDocument"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"DeletePipelineDocument","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"PipelineId":{"name":"pipeline_id","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"pipeline","missing":"00000000-0000-4000-8000-0000000beef0"}}}},"responses":{"Unauthorized":{"description":"Missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detail"}}}},"NotFound":{"description":"Unknown resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detail"}}}},"ValidationFailed":{"description":"FastAPI validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"schemas":{"Detail":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string"}}},"HTTPValidationError":{"type":"object","required":["detail"],"properties":{"detail":{"type":"array","items":{"type":"object","required":["loc","msg","type"],"properties":{"loc":{"type":"array","items":{"type":["string","integer"]}},"msg":{"type":"string"},"type":{"type":"string"}}}}}},"Project":{"type":"object","required":["id","name","organization_id"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"project","identity":true}},"name":{"type":"string"},"organization_id":{"type":"string"},"is_default":{"type":"boolean"},"ad_hoc_eval_dataset_id":{"type":["string","null"]},"created_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}},"updated_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}}}},"Pipeline":{"type":"object","required":["id","name","project_id","embedding_config"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"pipeline","identity":true}},"name":{"type":"string"},"project_id":{"type":"string"},"pipeline_type":{"type":"string","enum":["PLAYGROUND","MANAGED"]},"embedding_config":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"component":{"type":"object"}}},"status":{"type":"string","enum":["CREATED","DELETING"]},"created_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}},"updated_at":{"type":"string","x-mockingbird-volatile":{"kind":"timestamp"}}}},"CloudDocumentCreate":{"type":"object","required":["text","metadata"],"properties":{"id":{"type":"string","minLength":1,"maxLength":80},"text":{"type":"string","maxLength":4000},"metadata":{"type":"object","maxProperties":8,"additionalProperties":true,"properties":{"file_name":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":200},"slug":{"type":"string","maxLength":80},"contentType":{"type":"string","maxLength":40},"sourceUrl":{"type":["string","null"],"maxLength":400},"updatedAt":{"type":"string","maxLength":40}}},"excluded_embed_metadata_keys":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":40}},"excluded_llm_metadata_keys":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":40}},"page_positions":{"type":["array","null"],"maxItems":8,"items":{"type":"integer"}}}},"CloudDocumentBatch":{"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/CloudDocumentCreate"}},"CloudDocument":{"type":"object","required":["id","text","metadata"],"properties":{"id":{"type":"string","x-mockingbird-resource":{"type":"document","identity":true}},"text":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"excluded_embed_metadata_keys":{"type":"array","items":{"type":"string"}},"excluded_llm_metadata_keys":{"type":"array","items":{"type":"string"}},"page_positions":{"type":["array","null"],"items":{"type":"integer"}},"status_metadata":{"type":["object","null"]}}},"RetrieveParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":400},"dense_similarity_top_k":{"type":"integer","minimum":1,"maximum":100},"sparse_similarity_top_k":{"type":"integer","minimum":1,"maximum":100},"enable_reranking":{"type":"boolean"},"rerank_top_n":{"type":"integer","minimum":1,"maximum":100},"alpha":{"type":"number","minimum":0,"maximum":1},"retrieval_mode":{"type":"string","enum":["chunks","files_via_metadata","files_via_content","auto_routed"]},"files_top_k":{"type":"integer","minimum":1,"maximum":100},"retrieve_image_nodes":{"type":"boolean"},"retrieve_page_screenshot_nodes":{"type":"boolean"},"retrieve_page_figure_nodes":{"type":"boolean"},"class_name":{"type":"string","maxLength":40},"dense_similarity_cutoff":{"type":["number","null"]},"search_filters":{"type":["object","null"]},"search_filters_inference_schema":{"type":["object","null"]}}},"TextNodeWithScore":{"type":"object","required":["node","score"],"properties":{"node":{"type":"object","required":["id_","text","metadata"],"properties":{"id_":{"type":"string"},"text":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"extra_info":{"type":"object","additionalProperties":true},"class_name":{"type":"string"},"mimetype":{"type":"string"},"start_char_idx":{"type":["integer","null"]},"end_char_idx":{"type":["integer","null"]},"excluded_embed_metadata_keys":{"type":"array","items":{"type":"string"}},"excluded_llm_metadata_keys":{"type":"array","items":{"type":"string"}},"relationships":{"type":"object"},"text_template":{"type":"string"},"metadata_template":{"type":"string"},"metadata_seperator":{"type":"string"}}},"score":{"type":["number","null"]},"class_name":{"type":"string"}}},"RetrieveResults":{"type":"object","required":["pipeline_id","retrieval_nodes"],"properties":{"pipeline_id":{"type":"string"},"retrieval_nodes":{"type":"array","items":{"$ref":"#/components/schemas/TextNodeWithScore"}},"image_nodes":{"type":"array","items":{"type":"object"}},"page_figure_nodes":{"type":"array","items":{"type":"object"}},"retrieval_latency":{"type":"object","additionalProperties":{"type":"number"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"inferred_search_filters":{"type":["object","null"]},"class_name":{"type":"string"}}}}}}`);
2155
2227
  var operationIds = ["ListProjects", "GetProject", "SearchPipelines", "GetPipeline", "RunSearch", "ListPipelineDocuments", "UpsertBatchPipelineDocuments", "CreateBatchPipelineDocuments", "GetPipelineDocument", "DeletePipelineDocument"];
2156
2228
  var supportedOperationIds = ["ListProjects", "GetProject", "SearchPipelines", "GetPipeline", "RunSearch", "ListPipelineDocuments", "UpsertBatchPipelineDocuments", "CreateBatchPipelineDocuments", "GetPipelineDocument", "DeletePipelineDocument"];
2157
2229
 
@@ -2214,7 +2286,7 @@ var scriptedNode = (node, index) => ({
2214
2286
  // src/state.ts
2215
2287
  var DEFAULT_SETTINGS = { apiKeys: [], defaultTopK: 5 };
2216
2288
  var DEFAULT_PROJECT_NAME = "Default";
2217
- var DEFAULT_PIPELINE_NAME = "geviti-member-kb-v1";
2289
+ var DEFAULT_PIPELINE_NAME = "acme-member-kb-v1";
2218
2290
  var DEFAULT_PIPELINES = [
2219
2291
  { name: DEFAULT_PIPELINE_NAME, projectName: DEFAULT_PROJECT_NAME }
2220
2292
  ];
@@ -2693,4 +2765,4 @@ export {
2693
2765
  LLAMACLOUD_NAMESPACE,
2694
2766
  LlamaCloudAPI
2695
2767
  };
2696
- //# sourceMappingURL=chunk-UP32DVYJ.js.map
2768
+ //# sourceMappingURL=chunk-F7C2JOIW.js.map