create-cf-open-agents-api 0.2.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,25 @@
+CF-Open-Agents-API
+Copyright 2026 inaridiy and contributors
+
+This project is licensed under Apache-2.0 (see LICENSE).
+
+The repository includes development guidance derived from the following projects.
+These files are not included in the npm package. License copies are kept alongside
+each installed skill; skills-lock.json retains installer provenance.
+
+Cloudflare skills — https://github.com/cloudflare/skills
+  License: Apache-2.0
+  Files: .agents/skills/durable-objects/, sandbox-next/,
+         workers-best-practices/, wrangler/
+  License verified at b052c32bab7dd493513260228a36c88294f343f1.
+  These installed copies include adaptations to this project's versions, testing
+  guidance and runtime conventions; they are not unmodified upstream releases.
+
+Effect-TS skills — https://github.com/Effect-TS/skills
+  License: MIT
+  Files: .agents/skills/effect-ts/
+  License verified at 2309e6f27d9955b434c0e3f394b945c136e89fd2.
+  The full copyright and permission notice is retained in that directory's LICENSE.
+
+Runtime dependencies are distributed separately under their own package licenses.
+No ownership of upstream trademarks or endorsement by their owners is implied.

package/README.md

@@ -0,0 +1,96 @@
+# create-cf-open-agents-api
+
+Adds the [CF-Open-Agents-API](https://github.com/inaridiy/CF-Open-Agents-API) to a Cloudflare Workers project you already have, or creates a new Worker for it. One run writes the bindings, the composition, the Docker image snapshot and the local secrets; a second command provisions the R2 buckets and production secrets.
+
+The library and this CLI are pre-release. Until they are on npm's `latest` tag, run them with the `@alpha` tag and see [Before the packages are published](#before-the-packages-are-published).
+
+## Add the API to an existing Workers project
+
+Run it in the directory that holds `wrangler.jsonc` (a Vite + `@cloudflare/vite-plugin` project, a Hono Worker, anything Wrangler deploys):
+
+```sh
+pnpm dlx create-cf-open-agents-api@alpha init
+pnpm install
+pnpm exec wrangler login
+pnpm dev            # or: pnpm exec wrangler dev — Docker must be running
+```
+
+`init` asks for the model provider (OpenAI, Anthropic, Workers AI or an OpenAI-compatible endpoint), the native runtimes to expose as presets (Codex, Claude Code, OpenCode), whether to add a Workers AI preset next to your provider and whether to enable programmatic tool calling. `--yes` takes every default. Then it writes, idempotently:
+
+| File                             | Change                                                                                                                                                                                                                                                                                                                                                                                      |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `wrangler.jsonc`                 | Comments kept. Adds `nodejs_compat` (and `enable_ctx_exports` for a compatibility date before 2025-11-17), the four SQLite Durable Objects and their migration, the two containers built from the snapshot, the `CHECKPOINTS` and `BACKUP_BUCKET` R2 buckets with `vars.BACKUP_BUCKET_NAME`, the `MODEL_GATEWAY` and `AGENTS` self Service Bindings, `CODE_LOADER`, and `ai` for Workers AI |
+| `src/agents.ts`                  | The composition: presets, the model gateway registry and `defineAgentWorker`. Sits next to your Wrangler entry (`--agents-file` moves it)                                                                                                                                                                                                                                                   |
+| your entry (`main`)              | One appended line re-exporting `Agents`, `Models`, `SessionDO`, `TenantCatalogDO`, `HarnessDO`, `SandboxDO` and `ContainerProxy`; your default export is untouched                                                                                                                                                                                                                          |
+| `.cf-open-agents-api/`           | The repository snapshot the two Dockerfiles build from (`docker/`, `packages/`, the lockfile). Git-ignored and restored by the `postinstall` hook                                                                                                                                                                                                                                           |
+| `.dev.vars`, `.dev.vars.example` | A random `API_TOKEN` (32+ characters), the provider key line and `LOCAL_BACKUPS=true` for local development                                                                                                                                                                                                                                                                                 |
+| `package.json`                   | `cf-open-agents-api` with its peers `effect`, `openai`, `ai`, `zod`, the provider package, this CLI as a devDependency and `postinstall: create-cf-open-agents-api vendor`. Other versions you already pinned are kept (`--force` overwrites)                                                                                                                                               |
+| `.gitignore`, `tsconfig.json`    | Ignore the snapshot and `.dev.vars`; exclude the snapshot from a broad `include`                                                                                                                                                                                                                                                                                                            |
+
+Your Worker reaches the API through the `AGENTS` binding, which points at this Worker's `Agents` entrypoint:
+
+```ts
+// Hono, in your entry
+app.all("/v1/*", (c) => c.env.AGENTS.fetch(c.req.raw));
+// or the typed RPC surface
+const session = await c.env.AGENTS.createSession("tenant", {
+  agent: { model: "coding" },
+  environment: { type: "openai_hosted" },
+});
+```
+
+Binding names are fixed by the library (`SESSIONS`, `CATALOG`, `HARNESS`, `SANDBOX`, `CHECKPOINTS`, `BACKUP_BUCKET`, `MODEL_GATEWAY`, `CODE_LOADER`, `AI`). An existing binding with one of these names but another class stops the run before anything is written. `wrangler.toml` is not supported; convert it to `wrangler.jsonc` first.
+
+## Create a new Worker
+
+In an empty directory `init` writes a minimal project (`package.json`, `tsconfig.json`, `wrangler.jsonc`, `src/index.ts` exporting `Agents` as the default export) and then applies the same changes. It is the repository's `examples/worker`, generated. `--public` sets `workers_dev: true`; the default keeps the API private to Service Bindings.
+
+```sh
+mkdir my-agents && cd my-agents
+pnpm dlx create-cf-open-agents-api@alpha init --yes
+pnpm install && pnpm exec wrangler login && pnpm dev
+curl -X POST http://localhost:8787/v1/agents/sessions \
+  -H "Authorization: Bearer $(grep ^API_TOKEN= .dev.vars | cut -d= -f2)" \
+  -H "Content-Type: application/json" -H "Idempotency-Key: first" \
+  -d '{"agent":{"model":"coding"},"environment":{"type":"openai_hosted"},"input":"Write /workspace/outputs/hello.txt"}'
+```
+
+## Commands
+
+| Command                      | Purpose                                                                                                                                                                                                                                                                                                                                           |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `init [directory]` (default) | Retrofit or create, as above. Flags: `--yes`, `--force`, `--dry-run`, `--dir`, `--name`, `--provider`, `--base-url`, `--model`, `--harnesses codex,claude-code,opencode`, `--workers-ai`, `--no-code-loader`, `--public`, `--agents-file`, `--install`, `--ref`, `--source`, `--library`, `--cli-package`                                         |
+| `setup [directory]`          | Production: `wrangler r2 bucket create` for both buckets (existing ones are skipped), then `wrangler secret bulk` with `API_TOKEN`, the provider key, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY` and `CLOUDFLARE_R2_ACCOUNT_ID` in one call. Values are prompted, or read from the environment with `--from-env`. `--dry-run` prints the commands |
+| `doctor [directory]`         | Checks only: Node 24, wrangler, a reachable Docker engine, `wrangler login`, the binding agreement rules (`MODEL_GATEWAY` and `AGENTS` point at this Worker, `BACKUP_BUCKET_NAME` equals the bucket, SQLite migrations, snapshot Dockerfiles), the snapshot version and the `.dev.vars` token length. `--json`, `--offline`                       |
+| `vendor [directory]`         | Refreshes `.cf-open-agents-api/` from the tag matching this CLI's version (`--ref` for another ref, `--source` for a local checkout). The `postinstall` hook runs it; `CF_OPEN_AGENTS_API_SKIP_VENDOR=1` skips it and `CF_OPEN_AGENTS_API_SOURCE` names a checkout                                                                                |
+
+Every command reports what it created, updated and skipped, and explains each decision in Notes. `--dry-run` computes the same plan without writing.
+
+## Production
+
+```sh
+pnpm dlx create-cf-open-agents-api@alpha doctor
+pnpm dlx create-cf-open-agents-api@alpha setup     # buckets and secrets
+pnpm exec wrangler deploy                          # builds and pushes both images; several minutes the first time
+```
+
+Containers need the Workers Paid plan. The R2 API token (`R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`) comes from the Cloudflare dashboard, R2 → Manage R2 API Tokens, with Object Read & Write on the workspaces bucket; `setup` tells you when it needs it. `LOCAL_BACKUPS` stays out of production.
+
+## Before the packages are published
+
+`init` pins `cf-open-agents-api` and this CLI to its own version; `pnpm install` needs them on npm. Until then, build both from a checkout and point the CLI at the tarballs:
+
+```sh
+git clone https://github.com/inaridiy/CF-Open-Agents-API.git && cd CF-Open-Agents-API
+pnpm install --frozen-lockfile && pnpm build
+pnpm --filter cf-open-agents-api pack --pack-destination /tmp/cfo
+pnpm --filter create-cf-open-agents-api pack --pack-destination /tmp/cfo
+node packages/create-cf-open-agents-api/dist/cli.js init <your-project> \
+  --source "$PWD" --library /tmp/cfo/cf-open-agents-api-0.2.0.tgz --cli-package /tmp/cfo/create-cf-open-agents-api-0.2.0.tgz
+```
+
+`--source` snapshots the checkout instead of downloading a tag archive; `--library` and `--cli-package` write `file:` dependencies.
+
+## Requirements
+
+Node 24, a package manager (pnpm, npm, yarn or bun; detected from the lockfile), `tar` on `PATH` for the archive download, Docker for local development and Wrangler 4.131 or newer. Windows is untested. Named Wrangler environments (`env.*`) are neither changed nor checked.

package/dist/answers.d.ts

@@ -0,0 +1,30 @@
+import type { Project } from "./project.js";
+import { type Harness, type Provider } from "./templates/agents.js";
+import type { Prompter } from "./ui.js";
+/** Flags that pre-answer questions; anything missing is asked or defaulted. */
+export interface InitPreferences {
+    name?: string;
+    provider?: Provider;
+    baseURL?: string;
+    model?: string;
+    harnesses?: readonly Harness[];
+    workersAi?: boolean;
+    codeLoader?: boolean;
+    publicRoute?: boolean;
+    install?: boolean;
+}
+export interface InitAnswers {
+    name: string;
+    provider: Provider;
+    baseURL?: string;
+    model?: string;
+    harnesses: Harness[];
+    workersAi: boolean;
+    codeLoader: boolean;
+    publicRoute: boolean;
+    install: boolean;
+}
+export declare function parseProvider(value: string): Provider;
+export declare function parseHarnesses(value: string): Harness[];
+/** Asks what the flags left open, in the order a first-time user needs. */
+export declare function collectAnswers(project: Project, configName: string | undefined, preferences: InitPreferences, prompter: Prompter): Promise<InitAnswers>;

package/dist/answers.js

@@ -0,0 +1,83 @@
+import { workerNameFrom } from "./project.js";
+import { HARNESSES, PROVIDERS } from "./templates/agents.js";
+const PROVIDER_CHOICES = [
+    {
+        value: "openai",
+        label: "OpenAI",
+        hint: "Codex natively, Claude Code and OpenCode through the AI SDK",
+    },
+    {
+        value: "anthropic",
+        label: "Anthropic",
+        hint: "Claude Code natively, Codex and OpenCode through the AI SDK",
+    },
+    {
+        value: "workers-ai",
+        label: "Workers AI",
+        hint: "no provider key; billed to your Cloudflare account",
+    },
+    {
+        value: "openai-compatible",
+        label: "OpenAI-compatible endpoint",
+        hint: "any Chat Completions URL",
+    },
+];
+const HARNESS_CHOICES = [
+    { value: "codex", label: "Codex" },
+    { value: "claude-code", label: "Claude Code" },
+    { value: "opencode", label: "OpenCode" },
+];
+export function parseProvider(value) {
+    if (PROVIDERS.includes(value))
+        return value;
+    throw new Error(`Unknown provider ${value}; expected one of ${PROVIDERS.join(", ")}`);
+}
+export function parseHarnesses(value) {
+    const names = value
+        .split(",")
+        .map((name) => name.trim())
+        .filter(Boolean);
+    const unknown = names.find((name) => !HARNESSES.includes(name));
+    if (unknown)
+        throw new Error(`Unknown harness ${unknown}; expected ${HARNESSES.join(", ")}`);
+    return HARNESSES.filter((harness) => names.includes(harness));
+}
+/** Asks what the flags left open, in the order a first-time user needs. */
+export async function collectAnswers(project, configName, preferences, prompter) {
+    const name = preferences.name ??
+        configName ??
+        (await prompter.text("Worker name", workerNameFrom(project.root)));
+    const provider = preferences.provider ?? (await prompter.select("Model provider", PROVIDER_CHOICES, "openai"));
+    const compatible = provider === "openai-compatible" ? await compatibleAnswers(preferences, prompter) : {};
+    const harnesses = preferences.harnesses ??
+        (await prompter.multiselect("Native runtimes to expose as presets", HARNESS_CHOICES, HARNESSES));
+    const workersAi = provider === "workers-ai"
+        ? false
+        : (preferences.workersAi ??
+            (await prompter.confirm("Also add a Workers AI preset (no provider key, billed to Cloudflare)?", false)));
+    const codeLoader = preferences.codeLoader ??
+        (await prompter.confirm("Enable programmatic tool calling (Dynamic Workers)?", true));
+    const publicRoute = project.mode === "standalone"
+        ? (preferences.publicRoute ??
+            (await prompter.confirm("Expose the HTTP API on workers.dev? (No = Service Binding only)", false)))
+        : false;
+    const install = preferences.install ?? (await prompter.confirm("Install dependencies now?", false));
+    return {
+        name,
+        provider,
+        ...compatible,
+        harnesses: harnesses.length > 0 ? [...harnesses] : [...HARNESSES],
+        workersAi,
+        codeLoader,
+        publicRoute,
+        install,
+    };
+}
+async function compatibleAnswers(preferences, prompter) {
+    return {
+        baseURL: preferences.baseURL ??
+            (await prompter.text("Chat Completions base URL", "https://api.example.com/v1")),
+        model: preferences.model ?? (await prompter.text("Model id", "model")),
+    };
+}
+//# sourceMappingURL=answers.js.map

package/dist/answers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.js","sourceRoot":"","sources":["../src/answers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAgB,SAAS,EAAiB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA4B1F,MAAM,gBAAgB,GAAG;IACvB;QACE,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,oDAAoD;KAC3D;IACD;QACE,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,0BAA0B;KACjC;CAC6E,CAAC;AACjF,MAAM,eAAe,GAAG;IACtB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC9C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACuB,CAAC;AAElE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAK,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAiB,CAAC;IAC/E,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,qBAAqB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,SAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,cAAc,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,UAA8B,EAC9B,WAA4B,EAC5B,QAAkB;IAElB,MAAM,IAAI,GACR,WAAW,CAAC,IAAI;QAChB,UAAU;QACV,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GACZ,WAAW,CAAC,QAAQ,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChG,MAAM,UAAU,GACd,QAAQ,KAAK,mBAAmB,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,SAAS,GACb,WAAW,CAAC,SAAS;QACrB,CAAC,MAAM,QAAQ,CAAC,WAAW,CACzB,sCAAsC,EACtC,eAAe,EACf,SAAS,CACV,CAAC,CAAC;IACL,MAAM,SAAS,GACb,QAAQ,KAAK,YAAY;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS;YACtB,CAAC,MAAM,QAAQ,CAAC,OAAO,CACrB,uEAAuE,EACvE,KAAK,CACN,CAAC,CAAC,CAAC;IACV,MAAM,UAAU,GACd,WAAW,CAAC,UAAU;QACtB,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,qDAAqD,EAAE,IAAI,CAAC,CAAC,CAAC;IACxF,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,KAAK,YAAY;QAC3B,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW;YACxB,CAAC,MAAM,QAAQ,CAAC,OAAO,CACrB,iEAAiE,EACjE,KAAK,CACN,CAAC,CAAC;QACL,CAAC,CAAC,KAAK,CAAC;IACZ,MAAM,OAAO,GACX,WAAW,CAAC,OAAO,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC,CAAC;IACtF,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,GAAG,UAAU;QACb,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACjE,SAAS;QACT,UAAU;QACV,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,WAA4B,EAC5B,QAAkB;IAElB,OAAO;QACL,OAAO,EACL,WAAW,CAAC,OAAO;YACnB,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,2BAA2B,EAAE,4BAA4B,CAAC,CAAC;QAClF,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { cli } from "gunshi";
+import { doctorCommand } from "./commands/doctor.js";
+import { initCommand } from "./commands/init.js";
+import { setupCommand } from "./commands/setup.js";
+import { vendorCommand } from "./commands/vendor.js";
+import { CliError } from "./plan.js";
+import { CLI_NAME, CLI_VERSION } from "./versions.js";
+async function main() {
+    await cli(process.argv.slice(2), initCommand, {
+        name: CLI_NAME,
+        version: CLI_VERSION,
+        description: "Set up the CF-Open-Agents-API in a Cloudflare Workers project",
+        subCommands: {
+            init: initCommand,
+            setup: setupCommand,
+            doctor: doctorCommand,
+            vendor: vendorCommand,
+        },
+        // The commands print their own intro; gunshi's header would repeat it on every run.
+        renderHeader: null,
+    });
+}
+main().catch((error) => {
+    if (error instanceof CliError)
+        console.error(`✖ ${error.message}`);
+    else
+        console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEtD,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE;QAC5C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,aAAa;SACtB;QACD,oFAAoF;QACpF,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;;QAC9D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,51 @@
+export declare const doctorCommand: {
+    examples?: string | import("gunshi").CommandExamplesFetcher<import("gunshi").DefaultGunshiParams> | undefined;
+    toKebab?: boolean;
+    internal?: boolean;
+    entry?: boolean;
+    rendering?: import("gunshi").RenderingOptions<import("gunshi").DefaultGunshiParams> | undefined;
+    subCommands?: Record<string, import("gunshi").SubCommandable> | Map<string, import("gunshi").SubCommandable>;
+    name: string;
+    description: string;
+    args: {
+        directory: {
+            type: "positional";
+            required: false;
+            description: string;
+        };
+        dir: {
+            type: "string";
+            description: string;
+        };
+        json: {
+            type: "boolean";
+            description: string;
+        };
+        offline: {
+            type: "boolean";
+            description: string;
+        };
+    };
+    run: (ctx: Readonly<import("gunshi").CommandContext<{
+        args: {
+            directory: {
+                type: "positional";
+                required: false;
+                description: string;
+            };
+            dir: {
+                type: "string";
+                description: string;
+            };
+            json: {
+                type: "boolean";
+                description: string;
+            };
+            offline: {
+                type: "boolean";
+                description: string;
+            };
+        };
+        extensions: {};
+    }>>) => void;
+};

package/dist/commands/doctor.js

@@ -0,0 +1,26 @@
+import { define } from "gunshi";
+import { renderReport, runDoctor } from "../doctor.js";
+export const doctorCommand = define({
+    name: "doctor",
+    description: "Check the toolchain, the Wrangler configuration and the local secrets without changing anything",
+    args: {
+        directory: {
+            type: "positional",
+            required: false,
+            description: "Project directory (default: current directory)",
+        },
+        dir: { type: "string", description: "Project directory, as an option" },
+        json: { type: "boolean", description: "Print the report as JSON" },
+        offline: { type: "boolean", description: "Skip the docker and wrangler checks" },
+    },
+    run: (ctx) => {
+        const report = runDoctor({
+            dir: ctx.values.dir ?? ctx.values.directory ?? process.cwd(),
+            offline: Boolean(ctx.values.offline),
+        });
+        console.log(ctx.values.json ? JSON.stringify(report, null, 2) : renderReport(report));
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,iGAAiG;IACnG,IAAI,EAAE;QACJ,SAAS,EAAE;YACT,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,gDAAgD;SAC9D;QACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;QACvE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAClE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE;KACjF;IACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,SAAS,CAAC;YACvB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE;YAC5D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;SACrC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}