@mediamonks/canopy-cli 0.7.18 → 0.7.20

package/dist/{db-BAaqh_2O.mjs → db-TaSLpQZ5.mjs}

@@ -1,6 +1,6 @@
 import { c as resolveProject, o as projectFlagArgs } from "./site-BFaWfSVu.mjs";
-import { a as unwrap, d as withContext, i as requireTty, r as reportErrors, s as apiDataRequest } from "./ui-DLZNEen6.mjs";
-import { n as migrateProject, r as readMigrationFiles, t as describeMigrateResult } from "./migrations-kKKDlR_H.mjs";
+import { a as unwrap, d as withContext, i as requireTty, r as reportErrors, s as apiDataRequest } from "./ui--atbZ-TM.mjs";
+import { n as migrateProject, r as readMigrationFiles, t as describeMigrateResult } from "./migrations-Bg9FEGFh.mjs";
 import { defineCommand } from "citty";
 import { readFileSync, writeFileSync } from "node:fs";
 import * as p from "@clack/prompts";

package/dist/{deploy-DID3xhMJ.mjs → deploy-DCggsLD7.mjs}

@@ -1,6 +1,6 @@
 import { a as projectDirArgs, c as resolveProject, l as stagingUrl, n as siteConfig, o as projectFlagArgs, s as projectUrl, u as tryReadCanopyJson } from "./site-BFaWfSVu.mjs";
-import { a as unwrap, c as apiDownload, d as withContext, l as apiRequest, r as reportErrors, s as apiDataRequest, t as formatDateTime } from "./ui-DLZNEen6.mjs";
-import { n as migrateProject, r as readMigrationFiles, t as describeMigrateResult } from "./migrations-kKKDlR_H.mjs";
+import { a as unwrap, c as apiDownload, d as withContext, l as apiRequest, r as reportErrors, s as apiDataRequest, t as formatDateTime } from "./ui--atbZ-TM.mjs";
+import { n as migrateProject, r as readMigrationFiles, t as describeMigrateResult } from "./migrations-Bg9FEGFh.mjs";
 import { defineCommand } from "citty";
 import { mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";

package/dist/dev-DjkK-50R.mjs

@@ -0,0 +1,2 @@
+import { t as devCommand } from "./dev-DtEwiNYi.mjs";
+export { devCommand };

package/dist/{dev-CjaomJ2D.mjs → dev-DtEwiNYi.mjs}

@@ -1,6 +1,6 @@
 import { a as projectDirArgs, c as resolveProject, i as projectDialect, n as siteConfig, u as tryReadCanopyJson } from "./site-BFaWfSVu.mjs";
-import { d as withContext, l as apiRequest, o as ApiError, r as reportErrors, t as formatDateTime } from "./ui-DLZNEen6.mjs";
-import { r as readMigrationFiles } from "./migrations-kKKDlR_H.mjs";
+import { d as withContext, l as apiRequest, o as ApiError, r as reportErrors, t as formatDateTime } from "./ui--atbZ-TM.mjs";
+import { r as readMigrationFiles } from "./migrations-Bg9FEGFh.mjs";
 import { createRequire } from "node:module";
 import { defineCommand } from "citty";
 import { existsSync } from "node:fs";
@@ -165,7 +165,7 @@ async function devRemote(flags, slug) {
 async function devLocal(flags, slug) {
 	let dump;
 	if (flags.pull) {
-		const { fetchProjectDump } = await import("./local-dAQdVFEK.mjs");
+		const { fetchProjectDump } = await import("./local-CKRZur_5.mjs");
 		console.log(`Pulling a fresh export of ${slug}${flags.staging ? " [staging]" : ""}…`);
 		dump = await fetchProjectDump(slug, flags.staging ? "staging" : "live");
 	}
@@ -180,7 +180,7 @@ async function devLocal(flags, slug) {
 		const reason = err instanceof ApiError ? err.explain().why : String(err);
 		console.log(`Note: ai/services will be unavailable — could not reach the platform (${reason}).`);
 	}
-	const { createSandbox } = await import("./local-dAQdVFEK.mjs");
+	const { createSandbox } = await import("./local-CKRZur_5.mjs");
 	const sandbox = await createSandbox({
 		slug,
 		persistDir: join(flags.dir, ".canopy", "local"),

package/dist/docs/index.json

@@ -80,7 +80,7 @@
         {
           "slug": "notifications",
           "title": "Slack notifications",
-          "summary": "Canopy DMs you about your reports and projects — replies, new reports, blocked fetches, budget hits, failing schedules."
+          "summary": "Canopy DMs you about your reports and projects — replies, new reports, blocked fetches, budget hits, failing schedules — and answers questions when you ask."
         },
         {
           "slug": "static-serving",
@@ -296,7 +296,7 @@
         {
           "slug": "sdk",
           "title": "Using the SDK",
-          "summary": "One typed client for auth, data, files, AI, and services — no keys, no connection strings, the platform authenticates for you."
+          "summary": "One typed client for auth, data, files, AI, email, and services — no keys, no connection strings, the platform authenticates for you."
         },
         {
           "slug": "sdk-auth",
@@ -318,6 +318,11 @@
           "title": "AI",
           "summary": "Metered LLM access through the project's budget-capped gateway key — chat, streaming, and an OpenAI-compatible endpoint."
         },
+        {
+          "slug": "sdk-email",
+          "title": "Email",
+          "summary": "Send email from your project without a mail server or an API key — Monks recipients only, with a per-project daily quota and a sent log."
+        },
         {
           "slug": "sdk-google",
           "title": "Google",

package/dist/docs/notifications.md

@@ -1,6 +1,6 @@
 ---
 title: Slack notifications
-description: Canopy DMs you about your reports and projects — replies, new reports, blocked fetches, budget hits, failing schedules.
+description: Canopy DMs you about your reports and projects — replies, new reports, blocked fetches, budget hits, failing schedules — and answers questions when you ask.
 ---
 
 Canopy sends you Slack DMs when something on the platform needs your
@@ -38,6 +38,19 @@ the categories on or off. To silence one noisy project entirely, use **Mute
 project** on its Settings tab — personal to you, and your own reports
 elsewhere keep notifying.
 
+## Asking Canopy things
+
+The same bot answers questions. DM **Canopy** in Slack — or mention
+**@Canopy** in a channel — and ask in plain language: "what projects do I
+have?", "why is my fetch to that API failing?", "how do I roll back a bad
+deploy?". It looks at your projects (only the ones you can already see) and
+at these docs, and answers with links to the right guide.
+
+It can only read. It never deploys, changes settings, or touches your data —
+for that it points you at the dashboard or the CLI. In a channel that's
+linked to a project, it already knows which project you mean; replying in a
+report's notification thread, it knows which report.
+
 ## If DMs don't arrive
 
 The bot finds you by your work email. If your Slack account uses a different

package/dist/docs/sdk-email.md

@@ -0,0 +1,114 @@
+---
+title: Email
+description: Send email from your project without a mail server or an API key — Monks recipients only, with a per-project daily quota and a sent log.
+---
+
+`canopy.email` sends transactional email — a digest, a notification, a
+"your request was approved" — from your project code. There is no mail
+server to run, no provider account to open, no API key in your project, and
+no DNS to configure. The platform sends on your behalf and keeps a log of
+what went out.
+
+Two rules are enforced by the platform, not by your code:
+
+- **Monks recipients only.** Every address must be an `@monks.com` one.
+  Anything else is refused before the message is sent.
+- **A daily quota per project**, 100 emails by default. Each recipient
+  counts as one. Ask an admin if your project genuinely needs more.
+
+## email.send(options)
+
+Resolves once the platform has accepted the message:
+
+```ts
+await canopy.email.send({
+  to: "someone@monks.com",
+  subject: "Weekly digest",
+  text: "Three new entries this week.",
+});
+```
+
+**`EmailSendOptions`:**
+
+- `to` — required. One address, or an array of up to 10.
+- `subject` — required, up to 200 characters.
+- `text` — required. The plain-text body. Always sent, even alongside
+  `html`: some clients show only this, and it helps you stay out of spam
+  folders.
+- `html` — optional HTML body. `text` and `html` together are capped at
+  256 KB.
+- `replyTo` — optional. Follows the same recipient rule as `to`, so replies
+  cannot be routed off to an outside address.
+
+**Returns** `{ delivered, queued, bounced }` — three arrays of addresses.
+`delivered` is accepted for delivery, `queued` will be retried, and
+`bounced` will never arrive (a wrong address, usually).
+
+Attachments are not supported. Link to something in your app instead.
+
+## Who the email comes from
+
+Your project sends as itself: the From address is your project's slug at the
+platform's mail domain, with your project's name attached — so a recipient
+can tell at a glance which app is writing to them, and replies do not land
+in a shared inbox.
+
+Set `replyTo` when you want answers to reach a real person or team.
+
+## Sending from the backend
+
+The most useful sends have nobody signed in — a nightly digest, a
+[scheduled](https://docs.canopy.website/platform/schedules) summary. Email works there too: call it from
+a worker route or a scheduled handler and it authenticates as the project
+itself.
+
+```ts
+export default {
+  async scheduled(event, env) {
+    const canopy = createCanopy({ fetch: env.CANOPY.fetch.bind(env.CANOPY) });
+    const entries = await recentEntries(env.DB);
+
+    await canopy.email.send({
+      to: "team@monks.com",
+      subject: `Digest · ${entries.length} new entries`,
+      text: entries.map((e) => `· ${e.title}`).join("\n"),
+    });
+  },
+};
+```
+
+## Seeing what was sent
+
+Your project's **Usage** tab in the dashboard shows how much of today's
+quota you have used and the recent sends — when, to whom, the subject, and
+whether it went out. Message bodies are never stored.
+
+## When it fails
+
+Every failure is a `CanopyError` with a status you can branch on:
+
+- **400** — the recipient isn't a Monks address, or the request broke one of
+  the limits above (too many recipients, subject too long, missing `text`).
+- **429** — the project used its daily quota. It resets at UTC midnight.
+- **501** — email isn't set up on this Canopy site.
+- **502** — the platform accepted the request but the send failed downstream.
+
+```ts
+import { CanopyError } from "@mediamonks/canopy";
+
+try {
+  await canopy.email.send({ to, subject, text });
+} catch (err) {
+  if (err instanceof CanopyError && err.status === 429) {
+    // Out of quota for today — queue it, or tell the user.
+  }
+}
+```
+
+## What this is not
+
+This is transactional email for a small internal audience. It is not a
+newsletter platform: there are no mailing lists, no subscriber management,
+and no unsubscribe handling — if you send something people can opt into,
+you own that list and that opt-out inside your own app. A project that
+outgrows "email some Monks" should graduate to a dedicated email provider.

package/dist/docs/sdk.md

@@ -1,11 +1,11 @@
 ---
 title: Using the SDK
-description: One typed client for auth, data, files, AI, and services — no keys, no connection strings, the platform authenticates for you.
+description: One typed client for auth, data, files, AI, email, and services — no keys, no connection strings, the platform authenticates for you.
 ---
 
 `@mediamonks/canopy` is a thin, typed client over the platform's project API.
-One `createCanopy()` call gives you six modules — `auth`, `db`, `blob`, `ai`,
-`google`, and `services` — and that is the entire surface. There are no API keys,
+One `createCanopy()` call gives you seven modules — `auth`, `db`, `blob`, `ai`,
+`email`, `google`, and `services` — and that is the entire surface. There are no API keys,
 connection strings, or environment variables to manage: every call rides the
 session the platform already established before your code ran.
 
@@ -35,7 +35,7 @@ import { createCanopy } from "/_api/data/v1/sdk.js";
 import { createCanopy } from "@mediamonks/canopy";
 
 const canopy = createCanopy();
-// canopy.auth, canopy.db, canopy.blob, canopy.ai, canopy.google, canopy.services
+// canopy.auth, canopy.db, canopy.blob, canopy.ai, canopy.email, canopy.google, canopy.services
 ```
 
 | Option    | Type           | Default        | What it does                                                                                                          |

package/dist/{docs-DP_p_mmy.mjs → docs-C2D7__Iz.mjs}

@@ -1,7 +1,7 @@
-import { t as version } from "./package-x-_qF58q.mjs";
+import { t as version } from "./package-B-aXVcQu.mjs";
 import { n as siteConfig } from "./site-BFaWfSVu.mjs";
 import { i as latestKnownVersion, r as compareSemver } from "./version-check-CcsA1QjI.mjs";
-import { r as reportErrors } from "./ui-DLZNEen6.mjs";
+import { r as reportErrors } from "./ui--atbZ-TM.mjs";
 import { defineCommand } from "citty";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/{egress-DDM-_7Yo.mjs → egress-BhbQfjjV.mjs}

@@ -1,5 +1,5 @@
 import { a as projectDirArgs, c as resolveProject } from "./site-BFaWfSVu.mjs";
-import { a as unwrap, i as requireTty, l as apiRequest, r as reportErrors, t as formatDateTime } from "./ui-DLZNEen6.mjs";
+import { a as unwrap, i as requireTty, l as apiRequest, r as reportErrors, t as formatDateTime } from "./ui--atbZ-TM.mjs";
 import { defineCommand } from "citty";
 import * as p from "@clack/prompts";
 //#region src/egress.ts

package/dist/{feedback-DX99gDFp.mjs → feedback-BvkCjS-g.mjs}

@@ -1,6 +1,6 @@
-import { t as version } from "./package-x-_qF58q.mjs";
+import { t as version } from "./package-B-aXVcQu.mjs";
 import { a as projectDirArgs, c as resolveProject, d as tryResolveProject, n as siteConfig, u as tryReadCanopyJson } from "./site-BFaWfSVu.mjs";
-import { c as apiDownload, l as apiRequest, r as reportErrors, t as formatDateTime, u as apiUpload } from "./ui-DLZNEen6.mjs";
+import { c as apiDownload, l as apiRequest, r as reportErrors, t as formatDateTime, u as apiUpload } from "./ui--atbZ-TM.mjs";
 import { defineCommand } from "citty";
 import { basename, extname, join } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "./package-x-_qF58q.mjs";
+import { t as version } from "./package-B-aXVcQu.mjs";
 import { r as siteHeaderLine, t as setInvocationProfile } from "./site-BFaWfSVu.mjs";
 import { a as notifyOfUpdate, o as runRefresh } from "./version-check-CcsA1QjI.mjs";
 import { defineCommand, runMain } from "citty";
@@ -60,30 +60,30 @@ const main = defineCommand({
 		description: "canopy — create and deploy vibecoded projects"
 	},
 	subCommands: {
-		login: () => import("./login-CU0pev0k.mjs").then((m) => m.loginCommand),
-		whoami: () => import("./login-CU0pev0k.mjs").then((m) => m.whoamiCommand),
-		logout: () => import("./login-CU0pev0k.mjs").then((m) => m.logoutCommand),
-		create: () => import("./projects-TE1PVwMy.mjs").then((m) => m.createCommand),
-		init: () => import("./projects-TE1PVwMy.mjs").then((m) => m.initCommand),
-		projects: () => import("./projects-TE1PVwMy.mjs").then((m) => m.projectsCommand),
-		delete: () => import("./projects-TE1PVwMy.mjs").then((m) => m.deleteCommand),
-		dev: () => import("./dev-A2doKMCS.mjs").then((m) => m.devCommand),
-		deploy: () => import("./deploy-DID3xhMJ.mjs").then((m) => m.deployCommand),
-		promote: () => import("./deploy-DID3xhMJ.mjs").then((m) => m.promoteCommand),
-		staging: () => import("./staging-Cw-Rzbsj.mjs").then((m) => m.stagingCommand),
-		rollback: () => import("./deploy-DID3xhMJ.mjs").then((m) => m.rollbackCommand),
-		download: () => import("./deploy-DID3xhMJ.mjs").then((m) => m.downloadCommand),
-		token: () => import("./token-BqxRIRkT.mjs").then((m) => m.tokenCommand),
-		egress: () => import("./egress-DDM-_7Yo.mjs").then((m) => m.egressCommand),
-		schedule: () => import("./schedule-Blldchmj.mjs").then((m) => m.scheduleCommand),
-		feedback: () => import("./feedback-DX99gDFp.mjs").then((m) => m.feedbackCommand),
-		db: () => import("./db-BAaqh_2O.mjs").then((m) => m.dbCommand),
-		usage: () => import("./usage-2cGnpSVc.mjs").then((m) => m.usageCommand),
-		open: () => import("./open-B5XHmEmv.mjs").then((m) => m.openCommand),
-		docs: () => import("./docs-DP_p_mmy.mjs").then((m) => m.docsCommand),
-		skill: () => import("./skill-CSFhZmBk.mjs").then((m) => m.skillCommand),
-		upgrade: () => import("./upgrade-DcU4YMr_.mjs").then((m) => m.upgradeCommand),
-		logs: () => import("./logs-D60VRbHZ.mjs").then((m) => m.logsCommand)
+		login: () => import("./login-D-Ac_kFW.mjs").then((m) => m.loginCommand),
+		whoami: () => import("./login-D-Ac_kFW.mjs").then((m) => m.whoamiCommand),
+		logout: () => import("./login-D-Ac_kFW.mjs").then((m) => m.logoutCommand),
+		create: () => import("./projects-1r5387ui.mjs").then((m) => m.createCommand),
+		init: () => import("./projects-1r5387ui.mjs").then((m) => m.initCommand),
+		projects: () => import("./projects-1r5387ui.mjs").then((m) => m.projectsCommand),
+		delete: () => import("./projects-1r5387ui.mjs").then((m) => m.deleteCommand),
+		dev: () => import("./dev-DjkK-50R.mjs").then((m) => m.devCommand),
+		deploy: () => import("./deploy-DCggsLD7.mjs").then((m) => m.deployCommand),
+		promote: () => import("./deploy-DCggsLD7.mjs").then((m) => m.promoteCommand),
+		staging: () => import("./staging-CdpV2YHB.mjs").then((m) => m.stagingCommand),
+		rollback: () => import("./deploy-DCggsLD7.mjs").then((m) => m.rollbackCommand),
+		download: () => import("./deploy-DCggsLD7.mjs").then((m) => m.downloadCommand),
+		token: () => import("./token-C8Bmzwfl.mjs").then((m) => m.tokenCommand),
+		egress: () => import("./egress-BhbQfjjV.mjs").then((m) => m.egressCommand),
+		schedule: () => import("./schedule-DK_Cv6Xf.mjs").then((m) => m.scheduleCommand),
+		feedback: () => import("./feedback-BvkCjS-g.mjs").then((m) => m.feedbackCommand),
+		db: () => import("./db-TaSLpQZ5.mjs").then((m) => m.dbCommand),
+		usage: () => import("./usage-CRpVLLi6.mjs").then((m) => m.usageCommand),
+		open: () => import("./open-D7f1wNn3.mjs").then((m) => m.openCommand),
+		docs: () => import("./docs-C2D7__Iz.mjs").then((m) => m.docsCommand),
+		skill: () => import("./skill-CqiSkac0.mjs").then((m) => m.skillCommand),
+		upgrade: () => import("./upgrade-CpUCVTrN.mjs").then((m) => m.upgradeCommand),
+		logs: () => import("./logs-Beqz--Df.mjs").then((m) => m.logsCommand)
 	}
 });
 if (process.argv[2] !== "upgrade") notifyOfUpdate(version);

package/dist/{local-dAQdVFEK.mjs → local-CKRZur_5.mjs}

@@ -1,6 +1,6 @@
-import { s as apiDataRequest } from "./ui-DLZNEen6.mjs";
+import { s as apiDataRequest } from "./ui--atbZ-TM.mjs";
 import { n as META_COLUMNS, r as blobRouter, t as dbRouter } from "./src-Bu4Ze32I.mjs";
-import { n as rewriteApiPath } from "./dev-CjaomJ2D.mjs";
+import { n as rewriteApiPath } from "./dev-DtEwiNYi.mjs";
 import { createRequire } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, sep } from "node:path";