@mediamonks/canopy-cli 0.7.29 → 0.7.30

package/dist/ai-fAvjdjVX.mjs

@@ -0,0 +1,54 @@
+import { d as withContext, l as apiRequest, r as reportErrors } from "./ui-CeupNHNa.mjs";
+import { defineCommand } from "citty";
+//#region src/ai.ts
+/**
+* canopy ai models — the site's AI model list (OpenSpec change
+* ai-model-catalog): the auto/* aliases with what they resolve to, the
+* default, available models with prices, and legacy models with their
+* replacements. Site-wide, so it needs no linked project; `--profile` picks
+* the site. Agents should check this before naming a model in code.
+*/
+function perMTok(n) {
+	return `$${Number.isInteger(n) ? n : n.toFixed(2).replace(/0$/, "")}`;
+}
+function renderModels(site) {
+	const lines = ["Aliases (prefer these over model ids)"];
+	for (const alias of site.aliases) {
+		const target = alias.resolvesTo ?? "— (no model on this site)";
+		const tag = alias.id === site.default ? "  (default)" : "";
+		lines.push(`  ${alias.id.padEnd(12)} → ${target}${tag}`);
+	}
+	lines.push("", "Models (USD per 1M tokens, in / out)");
+	if (site.models.length === 0) lines.push("  none — AI is not enabled on this site");
+	const width = Math.max(0, ...site.models.map((m) => m.id.length));
+	for (const model of site.models) lines.push(`  ${model.id.padEnd(width)}  ${perMTok(model.inputPerMTok)} / ${perMTok(model.outputPerMTok)}`);
+	if (site.legacy.length > 0) {
+		lines.push("", "Legacy (still answered, by the replacement)");
+		const legacyWidth = Math.max(...site.legacy.map((m) => m.id.length));
+		for (const model of site.legacy) lines.push(`  ${model.id.padEnd(legacyWidth)} → ${model.replacement}`);
+	}
+	return lines.join("\n");
+}
+const aiCommand = defineCommand({
+	meta: {
+		name: "ai",
+		description: "AI models available to projects on this site"
+	},
+	subCommands: { models: defineCommand({
+		meta: {
+			name: "models",
+			description: "List the AI models and auto/* aliases this site offers"
+		},
+		args: { json: {
+			type: "boolean",
+			description: "Print raw JSON (same shape as GET /control/v1/ai/models)",
+			default: false
+		} },
+		run: reportErrors("ai models", async ({ args }) => {
+			const site = await withContext(apiRequest("GET", "/ai/models"), { action: "list the site's AI models" });
+			console.log(args.json ? JSON.stringify(site, null, 2) : renderModels(site));
+		})
+	}) }
+});
+//#endregion
+export { aiCommand };

package/dist/docs/cli-ai.md

@@ -0,0 +1,43 @@
+---
+title: canopy ai models
+description: List the AI models and auto/* aliases your site offers, with prices.
+---
+
+`canopy ai models` shows which AI models projects on your site can use. Run it before you name a model in code: only names on this list work.
+
+## Usage
+
+```bash
+canopy ai models [--json]
+```
+
+## Arguments & flags
+
+- `--json`: print the raw JSON instead of the formatted list. Default `false`.
+- `--profile <id>`: which site to ask, as with every command.
+
+## How it works
+
+The list belongs to the site, not to a project, so the command works from any directory. It prints three parts:
+
+- **Aliases.** `auto/low`, `auto/mid` and `auto/high`, each with the model it answers with right now. The default (`auto/low`) is marked. Aliases follow newer models as they arrive, so prefer them over fixed model ids.
+- **Models.** Every model you can name, with its price per million input and output tokens.
+- **Legacy.** Retired models that still work, and the model that now answers for each.
+
+It's read-only. With `--json`, the output is ready for scripts and agents.
+
+## Examples
+
+```bash
+canopy ai models
+```
+
+Shows the aliases, models and prices for your active site.
+
+```bash
+canopy ai models --json | jq -r '.aliases[] | "\(.id) \(.resolvesTo)"'
+```
+
+Prints what each alias answers with right now.
+
+See also [AI](https://docs.canopy.website/sdk/ai) for calling models from your project, and [AI access & usage](https://docs.canopy.website/platform/ai-usage) for budgets and spend.

package/dist/docs/cli.md

@@ -60,6 +60,8 @@ has a full page per command.
   `--snapshot <key>`. `--yes` skips the confirmation. **Destructive.**
 - `canopy usage` — AI spend and storage for the project (same data as the
   dashboard Usage tab). `--project <slug>` / `--json` for agents.
+- `canopy ai models` — the AI models and `auto/*` aliases this site offers,
+  with prices. Works from any directory; `--json` for agents.
 
 ## CI / deploy tokens
 

package/dist/docs/index.json

@@ -276,6 +276,11 @@
           "title": "canopy usage",
           "summary": "Show a project's AI spend, storage footprint, and deploy count from the terminal."
         },
+        {
+          "slug": "cli-ai",
+          "title": "canopy ai models",
+          "summary": "List the AI models and auto/* aliases your site offers, with prices."
+        },
         {
           "slug": "cli-feedback",
           "title": "canopy feedback",

package/dist/docs/platform-ai-usage.md

@@ -21,10 +21,12 @@ const reply = await canopy.ai.chat({
 
 - **No keys in your code.** Requests authenticate as the project; the
   platform holds the provider credentials.
-- **A curated model list.** Each site enables a set of models
-  (`provider/model`, e.g. `anthropic/claude-haiku-4-5`) with a sensible
-  default — ask for a model outside the list and the API tells you what _is_
-  available.
+- **Pick a tier, not a model.** Name `auto/low` (the default), `auto/mid`, or
+  `auto/high` and the platform answers with the best current model for it.
+  You can also name a specific model from the site's list. `canopy ai models`
+  and the Models section on your project's Usage tab show it, with prices.
+  Names that aren't on the list are refused, and retired models keep working,
+  answered by their replacement, until you switch.
 - **Streaming** via `canopy.ai.chatStream()` for chat-style UIs.
 - **Documents and images.** Messages can attach files — reference something
   in the project's [blob storage](https://docs.canopy.website/sdk/blob) by key, or inline base64 — see

package/dist/docs/sdk-ai.md

@@ -8,6 +8,29 @@ Every request authenticates as the project and is metered against hard
 per-project budgets — spend, limits, and how prompts are handled by the
 model providers are covered in [AI access & usage](https://docs.canopy.website/platform/ai-usage).
 
+## Picking a model
+
+Name a quality tier instead of a model id, and the platform answers with the
+best current model for it:
+
+- `auto/low` — fast and cheap. The **default** when you leave `model` out.
+- `auto/mid` — a good balance for most product features.
+- `auto/high` — the most capable model, for hard reasoning and long documents.
+
+Each alias moves to newer models as they arrive, without a code change. You
+can also name a specific model from the site's list. Run
+`canopy ai models` to see the aliases, what each answers with right now, and
+every model with its price:
+
+```bash
+canopy ai models
+```
+
+Only names on that list work: anything else is refused with a `400` that lists
+what is available. When a model is retired, calls naming it keep working,
+answered by its replacement: `res.model` names the model that answered, and
+the response carries a `deprecation` notice (below) until you switch.
+
 ## ai.chat(options)
 
 One-shot chat completion. Takes a `ChatOptions` object, resolves to a
@@ -19,7 +42,7 @@ const res = await canopy.ai.chat({
     { role: "system", content: "You are terse." },
     { role: "user", content: "Say hi in five words." },
   ],
-  model: "anthropic/claude-haiku-4-5", // optional
+  model: "auto/mid", // optional — defaults to auto/low
   temperature: 0.7, // optional, 0–2
   maxTokens: 256, // optional
 });
@@ -34,10 +57,10 @@ res.usage; // { inputTokens: number, outputTokens: number }
 - `messages` — required, non-empty array of `{ role, content }`. `role` is
   `"system" | "user" | "assistant"`; `content` is a non-empty string, or an
   array of content parts to attach documents and images (below).
-- `model` — optional `"{provider}/{model}"` id. Omit it and the platform's
-  default model answers. Ask for a model whose provider isn't enabled and the
-  call fails with a message listing what _is_ available; `ai.endpoint()`
-  returns the full curated list.
+- `model` — optional: an alias (`auto/low`, `auto/mid`, `auto/high`) or a
+  `"{provider}/{model}"` id from the site's list (`canopy ai models`). Omit it
+  and `auto/low` answers. A name that isn't on the list fails with a message
+  listing what _is_ available.
 - `temperature` — optional number between 0 and 2. Reasoning models (the
   GPT-5 family) only accept their default temperature, so the platform drops
   this setting for them rather than failing the call — it has effect on
@@ -52,7 +75,11 @@ res.usage; // { inputTokens: number, outputTokens: number }
 
 **`ChatResponse`:** `{ message, model, usage: { inputTokens, outputTokens } }`.
 `message.role` is `"assistant"` and `message.content` is always a plain
-string, whatever went in.
+string, whatever went in. `model` is the model that actually answered. When
+you named a retired model, the response also has
+`deprecation: { requested, replacement }`. Switch to the replacement or an
+alias. Streams and the endpoints below say the same with a `Deprecation:
+true` response header.
 
 ## Attaching documents and images
 
@@ -143,8 +170,10 @@ The compat endpoint speaks OpenAI's chat-completions dialect to every model —
 portable, but the lowest common denominator. When you want a provider's own
 protocol — Anthropic prompt caching, PDFs with citations, or OpenAI's
 Responses API — use the native base URLs from `endpoint()`. Requests pass
-through to the provider unchanged; auth, the model allowlist, the daily
-budget, and metering all still apply.
+through to the provider unchanged; auth, the model list, the daily budget,
+and metering all still apply. Aliases work here too: on the Anthropic endpoint
+`auto/mid` picks the best Claude model for that tier, on the OpenAI endpoint
+the best OpenAI one.
 
 ```ts
 import Anthropic from "@anthropic-ai/sdk";
@@ -152,7 +181,7 @@ import Anthropic from "@anthropic-ai/sdk";
 const { native } = await canopy.ai.endpoint();
 const anthropic = new Anthropic({ baseURL: native.anthropic, apiKey: "unused" });
 const msg = await anthropic.messages.create({
-  model: "claude-haiku-4-5", // bare or "anthropic/…" — must be on the curated list
+  model: "auto/mid", // an alias, or a model id from `canopy ai models` (bare or "anthropic/…")
   max_tokens: 1024,
   messages: [{ role: "user", content: "Hello" }],
 });
@@ -188,7 +217,9 @@ as the `message`. Two worth handling:
   or after a maintainer raises it). Everything else in your app keeps
   working.
 - **Invalid request** — status `400`, body contains `"invalid_chat"` and a
-  detail explaining which option was rejected.
+  detail explaining which option was rejected. A model that isn't on the
+  site's list lands here too, with the available aliases and models in the
+  detail.
 
 > **Note:** Budgets are enforced before every call, so a runaway loop becomes a capped bill — see [AI access
 > & usage](https://docs.canopy.website/platform/ai-usage) for how spend is tracked and displayed.

package/dist/{docs-ZQnhFSKT.mjs → docs-Dg0UJugG.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-DzU_2IJi.mjs";
+import { t as version } from "./package-CnS450Yc.mjs";
 import { n as siteConfig } from "./site-DM2J10CB.mjs";
 import { i as latestKnownVersion, r as compareSemver } from "./version-check-CcsA1QjI.mjs";
 import { r as reportErrors } from "./ui-CeupNHNa.mjs";

package/dist/{feedback-CNfUjjNw.mjs → feedback-Dvb6CdlP.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-DzU_2IJi.mjs";
+import { t as version } from "./package-CnS450Yc.mjs";
 import { a as projectDirArgs, c as resolveProject, d as tryResolveProject, n as siteConfig, u as tryReadCanopyJson } from "./site-DM2J10CB.mjs";
 import { c as apiDownload, l as apiRequest, r as reportErrors, t as formatDateTime, u as apiUpload } from "./ui-CeupNHNa.mjs";
 import { defineCommand } from "citty";

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "./package-DzU_2IJi.mjs";
+import { t as version } from "./package-CnS450Yc.mjs";
 import { r as siteHeaderLine, t as setInvocationProfile } from "./site-DM2J10CB.mjs";
 import { a as notifyOfUpdate, o as runRefresh } from "./version-check-CcsA1QjI.mjs";
 import { defineCommand, runMain } from "citty";
@@ -17,6 +17,7 @@ import { defineCommand, runMain } from "citty";
 *   db pull|snapshot|restore                                      [phase 2]
 *   logs [--follow]       read the project's worker logs          [phase 2]
 *   usage                 AI spend + storage for a project        [phase 1]
+*   ai models             the site's AI models and auto/* aliases
 *   open                  open the deployed project / dashboard   [phase 1]
 */
 if (process.env["CANOPY_UPDATE_REFRESH"] === "1") {
@@ -77,13 +78,14 @@ const main = defineCommand({
 		egress: () => import("./egress-Cn9zDfDT.mjs").then((m) => m.egressCommand),
 		secrets: () => import("./secrets-Bl3uOx4l.mjs").then((m) => m.secretsCommand),
 		schedule: () => import("./schedule-CLuksxSM.mjs").then((m) => m.scheduleCommand),
-		feedback: () => import("./feedback-CNfUjjNw.mjs").then((m) => m.feedbackCommand),
+		feedback: () => import("./feedback-Dvb6CdlP.mjs").then((m) => m.feedbackCommand),
 		db: () => import("./db-KTLn8J1u.mjs").then((m) => m.dbCommand),
 		usage: () => import("./usage-CV7TjTO8.mjs").then((m) => m.usageCommand),
+		ai: () => import("./ai-fAvjdjVX.mjs").then((m) => m.aiCommand),
 		open: () => import("./open-BJgd0R61.mjs").then((m) => m.openCommand),
-		docs: () => import("./docs-ZQnhFSKT.mjs").then((m) => m.docsCommand),
-		skill: () => import("./skill-CQ4a__Ga.mjs").then((m) => m.skillCommand),
-		upgrade: () => import("./upgrade-BzmIrnjs.mjs").then((m) => m.upgradeCommand),
+		docs: () => import("./docs-Dg0UJugG.mjs").then((m) => m.docsCommand),
+		skill: () => import("./skill-CuES7kPj.mjs").then((m) => m.skillCommand),
+		upgrade: () => import("./upgrade-C8YdSKKd.mjs").then((m) => m.upgradeCommand),
 		logs: () => import("./logs-D5RWqsWl.mjs").then((m) => m.logsCommand)
 	}
 });

package/dist/{package-DzU_2IJi.mjs → package-CnS450Yc.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.7.29";
+var version = "0.7.30";
 //#endregion
 export { version as t };

package/dist/skill/canopy/SKILL.md

@@ -98,6 +98,9 @@ and never go stale.
 - Roll back: `canopy rollback`
 - Open the live site: `canopy open`
 - Manage data: `canopy db pull | snapshot | snapshots | restore | migrate`
+- Use AI (`canopy.ai`): run `canopy ai models` before naming a model in code.
+  Prefer the aliases `auto/low` (default) / `auto/mid` / `auto/high` over
+  hard-coded ids — model ids outside that list are refused.
 - Work bug reports & feedback: `canopy feedback list | show | comment | status | report`
   — see [Working feedback reports](#working-feedback-reports-issues) below
 - CI credentials: `canopy token create | list | revoke`

package/dist/{skill-CQ4a__Ga.mjs → skill-CuES7kPj.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-DzU_2IJi.mjs";
+import { t as version } from "./package-CnS450Yc.mjs";
 import { r as reportErrors } from "./ui-CeupNHNa.mjs";
 import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";

package/dist/{upgrade-BzmIrnjs.mjs → upgrade-C8YdSKKd.mjs}

@@ -112,7 +112,7 @@ const upgradeCommand = defineCommand({
 		const spec = `${PACKAGE_NAME}@${args.version ?? "latest"}`;
 		const command = pmCommand(pm);
 		const cmd = installArgs(pm, spec);
-		const { skillInstalled } = await import("./skill-CQ4a__Ga.mjs");
+		const { skillInstalled } = await import("./skill-CuES7kPj.mjs");
 		const { homedir } = await import("node:os");
 		const refreshGlobal = skillInstalled(homedir());
 		const refreshRepo = process.cwd() !== homedir() && skillInstalled(process.cwd());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediamonks/canopy-cli",
-  "version": "0.7.29",
+  "version": "0.7.30",
   "description": "Canopy CLI — create, develop and deploy Canopy projects.",
   "bin": {
     "canopy": "./dist/index.mjs"
@@ -20,7 +20,7 @@
     "esbuild": "^0.28.1",
     "hono": "^4.8.0",
     "vite-server": "npm:vite@^7",
-    "@mediamonks/canopy": "0.0.9",
+    "@mediamonks/canopy": "0.0.10",
     "@mediamonks/canopy-data-plane": "0.0.4"
   },
   "devDependencies": {