docs: seed AGENTS.md

Author: caffeine-ci-generic-rw[bot]

AGENTS.md

@@ -0,0 +1,27 @@
+# AGENTS.md
+
+Generated Motoko client library for (a curated subset of) the OpenAI REST API, distributed as the `openai-client` mops package.
+
+## Generated code — do not hand-edit
+
+This entire repository is produced by the OpenAPI Generator (`MotokoClientCodegen`); see `.openapi-generator/FILES` for the exact list of generated paths. Do not hand-edit generated files — changes are lost on regeneration. Files listed in `.openapi-generator-ignore` are exempt from overwrite. The generator version is pinned in `.openapi-generator/VERSION`.
+
+## Layout
+
+- `src/Apis/` — one Motoko module per included API (Audio, Chat, Completions, Embeddings, Files, Images, Models, Moderations).
+- `src/Models/` — request/response types referenced by the APIs.
+- `src/Config.mo` — shared `Config` type and `defaultConfig`.
+
+Note: `README.md` lists more APIs/Models than exist under `src/`; only the curated subset in `src/` is actually shipped (the `files` field of `mops.toml` is the source of truth for published files).
+
+## Toolchain & build
+
+- Package manager: [mops](https://mops.one). Dependencies and the pinned Motoko compiler version (`[toolchain] moc`) are declared in `mops.toml`; `mops.lock` pins resolved versions.
+- Install dependencies with `mops install` before compiling. `.mops/` (git-ignored) is the local dependency cache and must not be committed.
+- There are no build, test, lint, or format scripts defined in this repository (no Makefile, no CI workflows, no package scripts). Do not invent one; compile against `moc`/mops as the consuming Internet Computer project requires.
+
+## Usage conventions
+
+- Import modules as `mo:openai-client/Apis/<Name>` and `mo:openai-client/Config`.
+- Configure via record update on `defaultConfig`, e.g. `{ defaultConfig with auth = ?#bearer "..." }`; auth supports `#bearer`, `#apiKey`, and `#basicAuth`.
+- API calls perform HTTP outcalls and require cycles; `defaultConfig.cycles` defaults to `30_000_000_000`.

CLAUDE.md

@@ -0,0 +1 @@
+See @AGENTS.md