feat(deploy/cf): expose env on photon instances + auto-bind Workers AI

  
  Plumbs the Worker's env onto the photon instance as this.env so a
  photon can reach CF bindings (Workers AI, KV, R2, queues) directly.
  Photons that want to stay portable can branch on
  (this as any).env?.AI and fall back to a non-CF path on the local
  daemon (where env is undefined).
  
  Auto-includes the [ai] binding in every generated wrangler.toml so
  photons can call env.AI.run for embeddings, classification, or small
  LLMs without extra setup. Free tier covers thousands of calls/day;
  photons that do not use it pay nothing for the binding being declared.

Author: Arul-

templates/cloudflare/worker.ts.template

@@ -354,6 +354,18 @@ function withCfCapabilities(
     configurable: false,
   });
 
+  // Worker env exposed to the photon for direct binding access — Workers AI
+  // (`env.AI.run('@cf/...', ...)`), KV, R2, queues, secrets. Photons that
+  // want to stay CF-portable should branch on `(this as any).env?.AI` and
+  // fall back to a non-CF path on the local daemon (where `env` is
+  // undefined). Non-enumerable so it doesn't leak into JSON output.
+  Object.defineProperty(instance, 'env', {
+    value: env,
+    writable: false,
+    enumerable: false,
+    configurable: false,
+  });
+
   // Human/LLM-in-the-loop primitives. Each one wraps an MCP server-initiated
   // request (sampling/createMessage, elicitation/create), pushed over the
   // active tool call's SSE response stream and awaited on a Promise keyed by

templates/cloudflare/wrangler.toml.template

@@ -7,6 +7,13 @@ main = "src/worker.ts"
 compatibility_date = "2024-09-23"
 compatibility_flags = ["nodejs_compat"]
 __OBSERVABILITY__
+# Workers AI binding — gives every photon access to CF's edge inference
+# (embeddings, classification, small LLMs) via `(this as any).env.AI.run(...)`.
+# Free tier covers thousands of calls/day; charges only kick in at scale.
+# Photons that don't use it pay nothing for having the binding declared.
+[ai]
+binding = "AI"
+
 # Durable Objects backing every photon class bundled into this Worker. The
 # host photon is always bound to `PHOTON`; each `@photons` sibling gets
 # its own `PHOTON_<NAME>` binding so `this.call('sibling.method', args)`