@junejs/server 1.0.0-dev.14 → 1.0.0-dev.19

package/dist/build.js

@@ -1,8 +1,9 @@
+import { jsxTransform } from "./tsconfig-jsx.js";
 import { deno, staticSite, vercel, workers } from "./adapter.js";
+import { generateAgentModule } from "./agent-compile.js";
 import { findMiddlewareFile } from "./router.js";
 import { resolveBoundary } from "./segment.js";
 import { buildModuleCss, registerCssModules, rolldownCssModulesPlugin } from "./css-modules.js";
-import { jsxTransform } from "./tsconfig-jsx.js";
 import { CLIENT_SCRIPT_URL, bundleClientToFile, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
 import { STYLES_URL, cssTargets, findGlobalCss, globalCssUsesTailwind, minifyCss, processCss } from "./css.js";
@@ -262,6 +263,12 @@ async function buildManifest(appRoot) {
 		const mod = await import(pathToFileURL(extraFile).href);
 		if (typeof mod.default === "function") extra = mod.default;
 	}
+	let agentName;
+	const agentDir = join(appDir, frozen.agent.runtime.dir);
+	if (frozen.agent.runtime.enabled && existsSync(agentDir)) {
+		const cfgFile = join(agentDir, "agent.ts");
+		agentName = (existsSync(cfgFile) ? (await import(pathToFileURL(cfgFile).href)).default : void 0)?.name ?? basename(agentDir);
+	}
 	return {
 		routes,
 		dynamicRoutes,
@@ -271,6 +278,7 @@ async function buildManifest(appRoot) {
 		loadings,
 		document: frozen.document,
 		agent: frozen.agent,
+		agentName,
 		i18n: frozen.i18n,
 		earlyHints: frozen.earlyHints,
 		extra
@@ -317,6 +325,24 @@ async function juneBuild(appRoot, options = {}) {
 		} : void 0 },
 		config: fullConfig
 	});
+	const agentDir = join(appDir, frozen.agent.runtime.dir);
+	let agentModule = null;
+	if (frozen.agent.runtime.enabled) {
+		const generated = generateAgentModule(agentDir);
+		if (generated && adapter.capabilities.durableObjects) agentModule = generated;
+		else if (generated) console.warn(`[june build] app/${frozen.agent.runtime.dir}/ found, but the ${adapter.name}() target has no Durable Objects — the durable agent is not mounted.`);
+	}
+	if (agentModule) {
+		const sdkResolvable = (fromDir) => {
+			for (let d = resolve(fromDir);;) {
+				if (existsSync(join(d, "node_modules", "@anthropic-ai", "sdk", "package.json"))) return true;
+				const parent = dirname(d);
+				if (parent === d) return false;
+				d = parent;
+			}
+		};
+		if (!sdkResolvable(appRoot)) throw new Error(`app/${frozen.agent.runtime.dir}/ mounts a durable agent whose model is Claude — add the SDK to the app so it bundles for workerd: bun add @anthropic-ai/sdk`);
+	}
 	const cssOut = await processCss(appDir, { minify: true });
 	let cssAsset = null;
 	if (cssOut !== null) {
@@ -407,7 +433,8 @@ async function juneBuild(appRoot, options = {}) {
 		imports.push(`import { turso } from "@junejs/server/db";`);
 		imports.push(`import { memoizeResources } from "@junejs/server/resources";`);
 	} else if (hasResources) imports.push(`import { bindWorkerResources } from "@junejs/server/resources";`);
-	const resourcesField = tursoDb ? `\n  resources: memoizeResources({ db: turso() }),` : hasResources ? `\n  resources: bindWorkerResources(${JSON.stringify(resourceFlags)}),` : "";
+	const resourcesExpr = tursoDb ? `memoizeResources({ db: turso() })` : hasResources ? `bindWorkerResources(${JSON.stringify(resourceFlags)})` : null;
+	const resourcesField = resourcesExpr ? `\n  resources: ${resourcesExpr},` : "";
 	const dataLayerModule = fullConfig.dataLayer?.module;
 	if (dataLayerModule) imports.push(`import { installDataLayer } from ${JSON.stringify(dataLayerModule)};`);
 	const dataLayerBoot = dataLayerModule ? "\ninstallDataLayer();\n" : "";
@@ -417,10 +444,40 @@ async function juneBuild(appRoot, options = {}) {
 		imports.push(`import { services as __appServices } from ${JSON.stringify(spec)};`);
 	}
 	const servicesField = servicesModule ? `\n  services: __appServices,` : "";
+	if (agentModule) {
+		imports.push(`import __agentModule from ${JSON.stringify(importPath(genDir, agentModule.file))};`);
+		imports.push(`import { assembleDurable } from "@junejs/core/agent-config";`);
+		imports.push(`import { anthropic } from "@junejs/core/agent-models";`);
+		imports.push(`import { AgentDurableObject } from "@junejs/server/agent-durable";`);
+		imports.push(`import { DurableObject } from "cloudflare:workers";`);
+		imports.push(`import Anthropic from "@anthropic-ai/sdk";`);
+	}
+	const agentPreamble = agentModule ? `\nconst __agentDef = assembleDurable(__agentModule);\n` : "";
+	const agentNameField = agentModule ? `\n  agentName: __agentModule.config.name,\n  agentChannels: __agentDef.channels,` : "";
+	const doClass = agentModule ? `
+// The durable agent: one Durable Object per session, the compiled agent/
+// directory as its definition — adapted tools (+ read_skill when skills exist),
+// the assembled system prompt, channel factories resolved with the DO's own
+// env, and the app's declared resources opened from THIS isolate's env (lazily,
+// at the first turn — the same ambient db a tool sees in native dev). Model:
+// Anthropic over a statically bundled client (workerd cannot resolve a bare
+// import at runtime), keyed by the ANTHROPIC_API_KEY secret — a missing secret
+// surfaces as the SDK's own clear construction error on the first agent request.
+export class JuneAgentDO extends DurableObject {
+  #agent = new AgentDurableObject(this.ctx, {
+    ...__agentDef,
+    model: anthropic({ model: __agentModule.config.model, client: new Anthropic({ apiKey: (this.env as { ANTHROPIC_API_KEY?: string }).ANTHROPIC_API_KEY }) }),
+    env: this.env,${resourcesExpr ? `\n    resources: ${resourcesExpr},` : ""}${servicesModule ? "\n    services: __appServices(this.env)," : ""}
+  });
+  fetch(req: Request): Promise<Response> {
+    return this.#agent.fetch(req);
+  }
+}
+` : "";
 	const entry = `// AUTO-GENERATED by \`june build\` — do not edit. Regenerate: june build .
 ${adapterEntry.imports.join("\n")}
 ${imports.join("\n")}
-${dataLayerBoot}
+${dataLayerBoot}${agentPreamble}
 const pipeline = createWorker({
   routes: {
 ${statics.join("\n")}
@@ -435,12 +492,12 @@ ${chains.join("\n")}
 ${loadings.join("\n")}
   },
   document: ${JSON.stringify(frozen.document, null, 2).replace(/\n/g, "\n  ")},
-  agent: ${JSON.stringify(frozen.agent)},${frozen.i18n ? `\n  i18n: ${JSON.stringify(frozen.i18n)},` : ""}
+  agent: ${JSON.stringify(frozen.agent)},${agentNameField}${frozen.i18n ? `\n  i18n: ${JSON.stringify(frozen.i18n)},` : ""}
   earlyHints: ${JSON.stringify(frozen.earlyHints)},${builtExtraFile ? "\n  extra," : ""}${resourcesField}${servicesField}
 });
 
 ${adapterEntry.wrap("pipeline")}
-`;
+${doClass}`;
 	const entryFile = join(genDir, "worker-entry.tsx");
 	await writeFile(entryFile, entry);
 	const { rolldown } = await import("rolldown");
@@ -455,6 +512,7 @@ ${adapterEntry.wrap("pipeline")}
 		plugins: [rolldownCssModulesPlugin(cssModuleMaps)],
 		external: (id) => {
 			if (isBunSpecifier(id)) return true;
+			if (id.startsWith("cloudflare:")) return true;
 			if (/\.(wasm|ttf|otf|woff2?|png|jpe?g|avif|webp)$/.test(id)) return true;
 			return [...adapter.buildExternal ?? [], ...options.external ?? frozen.buildExternal].some((e) => id === e || id.startsWith(`${e}/`));
 		},
@@ -561,10 +619,16 @@ ${adapterEntry.wrap("pipeline")}
 	}
 	const pkgPath = join(appRoot, "package.json");
 	const defaultName = workerName((existsSync(pkgPath) ? JSON.parse(await Bun.file(pkgPath).text()).name : void 0) ?? basename(appRoot));
-	const plan = resourcesCfg?.db && resourcesCfg.db.kind !== "turso" ? { db: {
-		binding: "DB",
-		databaseName: `${defaultName}-db`
-	} } : {};
+	const plan = {
+		...resourcesCfg?.db && resourcesCfg.db.kind !== "turso" ? { db: {
+			binding: "DB",
+			databaseName: `${defaultName}-db`
+		} } : {},
+		...agentModule ? { agent: {
+			binding: "AGENT",
+			className: "JuneAgentDO"
+		} } : {}
+	};
 	await adapter.emit({
 		appRoot,
 		outDir,
@@ -576,6 +640,7 @@ ${adapterEntry.wrap("pipeline")}
 		publicFiles
 	});
 	if (plan.db) console.log(`  ↳ d1 binding "${plan.db.binding}" emitted — set database_id in wrangler.jsonc (wrangler d1 create ${plan.db.databaseName})`);
+	if (plan.agent) console.log(`  ↳ durable agent mounted (${plan.agent.className} → env.${plan.agent.binding}; chat at ${frozen.agent.runtime.chat.path})`);
 	return {
 		outFile,
 		routes: routes.filter((r) => !r.dynamic).map((r) => r.path),

package/dist/client-bundle.js

@@ -1,5 +1,5 @@
-import { rolldownCssModulesPlugin } from "./css-modules.js";
 import { jsxTransform } from "./tsconfig-jsx.js";
+import { rolldownCssModulesPlugin } from "./css-modules.js";
 import { existsSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { AdapterCapabilities, AdapterEmitContext, AdapterEntry, JuneAdapter, ResourcePlan, deno, staticSite, vercel, workers } from "./adapter.js";
+import { AGENT_MODULE_FILE, AgentDirScan, emitAgentModule, findAgentDir, generateAgentModule, scanAgentDir } from "./agent-compile.js";
 import { CreateAppOptions, JuneApp, createApp } from "./app.js";
 import { R2Bucket, localBlob, r2 } from "./blob.js";
 import { a as Pipeline, d as createPipeline, n as LayoutComponent, o as PipelineConfig, s as Resolved, u as RouteResolver } from "./pipeline-cCR6MGNK.js";
@@ -24,4 +25,4 @@ import { Negotiated, negotiate } from "./negotiate.js";
 import { blob, currentServices, db, kv } from "@junejs/db";
 import { ServicesConfig, defineServices } from "@junejs/core/config";
 import { I18nConfig, LOCALE_COOKIE, LocaleConfig, LocaleMatch, dirForLang, localeDir, localeHref, matchPinnedLocale, negotiateLocale, parseAcceptLanguage, resolveRequestLocale } from "@junejs/core/i18n";
-export { type AdapterCapabilities, type AdapterEmitContext, type AdapterEntry, type BuildResult, type ContentEntry, type CreateAppOptions, type D1Database, type D1Exec, type DeployResult, type DevServer, type DevServerOptions, type I18nConfig, type JuneAdapter, type JuneApp, type JuneDb, type JuneHost, LOCALE_COOKIE, type LayoutComponent, type LocaleConfig, type LocaleMatch, type MatchOptions, type MigrateResult, type Migration, type Negotiated, type Pipeline, type PipelineConfig, type R2Bucket, type Resolved, type ResourceFlags, type ResourcePlan, type RouteMatch, type RouteResolver, type RouteTreeMatch, type RunResult, type SegmentMatch, type ServeHandle, type ServicesConfig, type SpawnedModule, type WorkerEnv, type WorkerManifest, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };
+export { AGENT_MODULE_FILE, type AdapterCapabilities, type AdapterEmitContext, type AdapterEntry, type AgentDirScan, type BuildResult, type ContentEntry, type CreateAppOptions, type D1Database, type D1Exec, type DeployResult, type DevServer, type DevServerOptions, type I18nConfig, type JuneAdapter, type JuneApp, type JuneDb, type JuneHost, LOCALE_COOKIE, type LayoutComponent, type LocaleConfig, type LocaleMatch, type MatchOptions, type MigrateResult, type Migration, type Negotiated, type Pipeline, type PipelineConfig, type R2Bucket, type Resolved, type ResourceFlags, type ResourcePlan, type RouteMatch, type RouteResolver, type RouteTreeMatch, type RunResult, type SegmentMatch, type ServeHandle, type ServicesConfig, type SpawnedModule, type WorkerEnv, type WorkerManifest, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, emitAgentModule, entry, findAgentDir, freezeConfig, generateAgentModule, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanAgentDir, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };

package/dist/index.js

@@ -1,4 +1,5 @@
 import { deno, staticSite, vercel, workers } from "./adapter.js";
+import { AGENT_MODULE_FILE, emitAgentModule, findAgentDir, generateAgentModule, scanAgentDir } from "./agent-compile.js";
 import { listRoutes, matchRoute, matchRouteTree, resolveNotFound } from "./router.js";
 import { negotiate } from "./negotiate.js";
 import { createPipeline } from "./pipeline.js";
@@ -24,4 +25,4 @@ import { memoryKv, redisKv } from "./kv.js";
 import { blob, currentServices, db, kv } from "@junejs/db";
 import { defineServices } from "@junejs/core/config";
 import { LOCALE_COOKIE, dirForLang, localeDir, localeHref, matchPinnedLocale, negotiateLocale, parseAcceptLanguage, resolveRequestLocale } from "@junejs/core/i18n";
-export { LOCALE_COOKIE, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };
+export { AGENT_MODULE_FILE, LOCALE_COOKIE, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, emitAgentModule, entry, findAgentDir, freezeConfig, generateAgentModule, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanAgentDir, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };

package/dist/tsconfig-jsx.d.ts

@@ -1,4 +1,5 @@
 //#region src/tsconfig-jsx.d.ts
+declare const stripJsonc: (s: string) => string;
 /** Read the app's tsconfig.json and return compilerOptions.jsxImportSource.
  *  Follows one level of `extends` so apps that inherit from a base tsconfig
  *  (e.g. "@kurajs/docs/tsconfig.kura.json") are handled correctly.
@@ -12,4 +13,4 @@ declare function jsxTransform(appRoot: string): Promise<{
   importSource?: string;
 }>;
 //#endregion
-export { appJsxImportSource, jsxTransform };
+export { appJsxImportSource, jsxTransform, stripJsonc };

package/dist/tsconfig-jsx.js

@@ -32,4 +32,4 @@ async function jsxTransform(appRoot) {
 	};
 }
 //#endregion
-export { appJsxImportSource, jsxTransform };
+export { appJsxImportSource, jsxTransform, stripJsonc };

package/dist/worker.d.ts

@@ -1,4 +1,5 @@
 import { l as ResourceHandler, n as LayoutComponent, r as LoadingComponent, t as ExtraHandler } from "./pipeline-cCR6MGNK.js";
+import { Channel, ChannelFactory } from "@junejs/core/agent-config";
 import { BrandedRoute } from "@junejs/core/route";
 import { AgentConfig } from "@junejs/core/config";
 import React from "react";
@@ -6,6 +7,9 @@ import { DocumentConfig } from "@junejs/core/document";
 import { I18nConfig } from "@junejs/core/i18n";
 import { Resources } from "@junejs/core/resources";
 //#region src/worker.d.ts
+type WorkerExecutionContext = {
+  waitUntil?(p: Promise<unknown>): void;
+};
 type WorkerManifest = {
   routes: Record<string, BrandedRoute>;
   dynamicRoutes?: Array<{
@@ -25,6 +29,7 @@ type WorkerManifest = {
   document: DocumentConfig;
   agent: AgentConfig;
   agentName?: string;
+  agentChannels?: (Channel | ChannelFactory)[];
   i18n?: I18nConfig;
   earlyHints?: string[];
   htmlCacheControl?: string;
@@ -36,7 +41,7 @@ type WorkerManifest = {
   services?: (env?: unknown) => unknown;
 };
 declare function createWorker(manifest: WorkerManifest): {
-  fetch(request: Request, env?: unknown): Promise<Response>;
+  fetch(request: Request, env?: unknown, ctx?: WorkerExecutionContext): Promise<Response>;
 };
 type AssetEnv = {
   ASSETS?: {
@@ -44,13 +49,13 @@ type AssetEnv = {
   };
 };
 type FetchPipeline = {
-  fetch(request: Request, env?: unknown): Promise<Response>;
+  fetch(request: Request, env?: unknown, ctx?: WorkerExecutionContext): Promise<Response>;
 };
 declare function withAssets(pipeline: FetchPipeline, opts?: {
   link?: string | null;
 }): {
-  fetch(request: Request, env?: AssetEnv): Promise<Response>;
+  fetch(request: Request, env?: AssetEnv, ctx?: WorkerExecutionContext): Promise<Response>;
 };
 declare function withDenoAssets(pipeline: FetchPipeline): (request: Request) => Promise<Response>;
 //#endregion
-export { WorkerManifest, createWorker, withAssets, withDenoAssets };
+export { WorkerExecutionContext, WorkerManifest, createWorker, withAssets, withDenoAssets };

package/dist/worker.js

@@ -1,4 +1,4 @@
-import { durableAgentSurface } from "./agent-durable.js";
+import { durableAgentSurface, durableChannelSurface } from "./agent-durable.js";
 import { createPipeline } from "./pipeline.js";
 import { RESERVED_PREFIX, contentTypeFor, safeRelativePath } from "./static-files.js";
 //#region src/worker.ts
@@ -61,15 +61,30 @@ function createWorker(manifest) {
 	const loadingFor = (key) => manifest.loadings?.[key];
 	const boundaryFor = (key) => manifest.layoutBoundaries?.[key] ?? null;
 	let currentEnv;
+	const requestLocals = /* @__PURE__ */ new WeakMap();
 	const provider = manifest.resources;
 	const servicesProvider = manifest.services;
 	let servicesCache;
 	const agentSurface = manifest.agent.runtime.enabled && manifest.agentName ? (() => {
-		const route = durableAgentSurface(() => currentEnv?.AGENT, {
-			agentName: manifest.agentName,
-			chatPath: manifest.agent.runtime.chat.path
-		});
-		return (req) => route(req);
+		const agentName = manifest.agentName;
+		const wantChannels = manifest.agent.runtime.channels !== false && (manifest.agentChannels?.length ?? 0) > 0;
+		return async (req) => {
+			const locals = requestLocals.get(req);
+			const ns = () => (locals?.env)?.AGENT;
+			const chatRes = await durableAgentSurface(ns, {
+				agentName,
+				chatPath: manifest.agent.runtime.chat.path
+			})(req);
+			if (chatRes) return chatRes;
+			if (!wantChannels) return null;
+			return durableChannelSurface(ns, {
+				agentName,
+				channels: manifest.agentChannels,
+				env: locals?.env,
+				services: servicesProvider,
+				waitUntil: locals?.ctx?.waitUntil?.bind(locals.ctx)
+			})(req);
+		};
 	})() : void 0;
 	const pipeline = createPipeline({
 		docConfig: manifest.document,
@@ -130,14 +145,18 @@ function createWorker(manifest) {
 			return null;
 		}
 	});
-	return { fetch(request, env) {
+	return { fetch(request, env, ctx) {
 		currentEnv = env;
+		requestLocals.set(request, {
+			env,
+			ctx
+		});
 		return pipeline.fetch(request);
 	} };
 }
 const estimateTokens = (s) => String(Math.ceil(s.length / 4));
 function withAssets(pipeline, opts = {}) {
-	return { async fetch(request, env) {
+	return { async fetch(request, env, ctx) {
 		const assets = env?.ASSETS;
 		const url = new URL(request.url);
 		const isPagePath = !/\.[a-z0-9]+$/i.test(url.pathname);
@@ -177,7 +196,7 @@ function withAssets(pipeline, opts = {}) {
 				return a;
 			}
 		}
-		return pipeline.fetch(request, env);
+		return pipeline.fetch(request, env, ctx);
 	} };
 }
 function withDenoAssets(pipeline) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/server",
-  "version": "1.0.0-dev.14",
+  "version": "1.0.0-dev.19",
   "description": "June host adapters + dev server. Host-coupled; depends on the pure @junejs/core contract layer.",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,12 @@
       "types": "./dist/agent-discover.d.ts",
       "default": "./dist/agent-discover.js"
     },
+    "./agent-compile": {
+      "source": "./src/agent-compile.ts",
+      "bun": "./src/agent-compile.ts",
+      "types": "./dist/agent-compile.d.ts",
+      "default": "./dist/agent-compile.js"
+    },
     "./db": {
       "source": "./src/db.ts",
       "bun": "./src/db.ts",
@@ -132,13 +138,14 @@
     "rolldown": "^1.1.0"
   },
   "peerDependencies": {
-    "@junejs/core": ">=0.2.0-dev.32",
+    "@junejs/core": ">=0.2.0-dev.36",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-server-dom-webpack": "19.2.7",
     "pg": "^8.0.0",
     "mysql2": "^3.0.0",
-    "@libsql/client": "^0.14.0 || ^0.15.0 || ^0.16.0 || ^0.17.0"
+    "@libsql/client": "^0.14.0 || ^0.15.0 || ^0.16.0 || ^0.17.0",
+    "@anthropic-ai/sdk": ">=0.60.0"
   },
   "peerDependenciesMeta": {
     "react-server-dom-webpack": {
@@ -152,6 +159,9 @@
     },
     "@libsql/client": {
       "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
     }
   },
   "repository": {

package/src/adapter.ts

@@ -7,10 +7,11 @@
 // `workers()` is the zero-config default (this file, no import). Other targets
 // are explicit `deploy: { adapter: vercel() }` from their own package.
 import { existsSync } from "node:fs";
-import { cp, copyFile, mkdir, readdir, rm, writeFile } from "node:fs/promises";
+import { cp, copyFile, mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
 
 import type { JuneConfig } from "@junejs/core/config";
+import { stripJsonc } from "./tsconfig-jsx";
 
 export type AdapterCapabilities = {
   runtime: "edge" | "node" | "serverless" | "native" | "static";
@@ -20,6 +21,9 @@ export type AdapterCapabilities = {
   persistentConnections: boolean;
   // Who serves prerendered static files: the platform CDN, the server, or none.
   assets: "platform" | "server" | "none";
+  // Durable Objects (the per-session agent actor). Only workers() today; the
+  // build skips the durable-agent mount (with a notice) when absent.
+  durableObjects?: boolean;
 };
 
 // What the adapter contributes to the generated worker entry: extra imports and
@@ -37,6 +41,11 @@ export type ResourcePlan = {
   // A declared `db` → a D1 binding named `binding`. The runtime provider
   // (bindWorkerResources) reads env[binding]; keep in sync (default "DB").
   db?: { binding: string; databaseName: string };
+  // A durable agent (an app/agent directory on a DO-capable target) → the DO
+  // namespace binding createWorker reads (env.AGENT) and the class the
+  // generated entry exports. workers() emits durable_objects + the SQLite-class
+  // migration from it.
+  agent?: { binding: string; className: string };
 };
 
 export type AdapterEmitContext = {
@@ -77,13 +86,60 @@ export interface JuneAdapter {
   emit(ctx: AdapterEmitContext): Promise<void>;
 }
 
+// Whether an app-owned wrangler config actually BINDS the generated DO class
+// under the binding name createWorker reads (env.AGENT) — not merely mentions
+// the class (a migrations entry does that too, and a binding under another
+// name never reaches the chat route). JSONC is parsed for the real
+// durable_objects.bindings entry; TOML is scanned per
+// [[durable_objects.bindings]] table with comments stripped, so a
+// commented-out binding never counts. The TOML scan covers wrangler's
+// canonical table form; an exotic inline-table config may draw a spurious
+// (advisory) warning, never a suppressed one. Pure — unit-tested directly.
+export function hasDurableBinding(text: string, file: string, binding: string, className: string): boolean {
+  if (file.endsWith(".toml")) {
+    // Strip comments: '#' to end of line, unless inside a double-quoted string.
+    const lines = text.split("\n").map((line) => {
+      let inString = false;
+      for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === '"' && line[i - 1] !== "\\") inString = !inString;
+        else if (ch === "#" && !inString) return line.slice(0, i);
+      }
+      return line;
+    });
+    let inBindings = false;
+    let name: string | undefined;
+    let cls: string | undefined;
+    const matches = () => name === binding && cls === className;
+    for (const line of lines) {
+      const t = line.trim();
+      if (t.startsWith("[")) {
+        if (inBindings && matches()) return true; // the table that just ended bound it
+        inBindings = /^\[\[\s*durable_objects\.bindings\s*\]\]$/.test(t);
+        name = cls = undefined;
+        continue;
+      }
+      if (!inBindings) continue;
+      const kv = t.match(/^(name|class_name)\s*=\s*"([^"]*)"/);
+      if (kv) kv[1] === "name" ? (name = kv[2]) : (cls = kv[2]);
+    }
+    return inBindings && matches();
+  }
+  try {
+    const parsed = JSON.parse(stripJsonc(text)) as { durable_objects?: { bindings?: { name?: string; class_name?: string }[] } };
+    return (parsed.durable_objects?.bindings ?? []).some((b) => b.name === binding && b.class_name === className);
+  } catch {
+    return text.includes(className); // unparsable — loose fallback, never crash the build
+  }
+}
+
 // The built-in default. Reproduces exactly what build.ts emitted inline:
 // withAssets(pipeline) as the entry, and a wrangler.jsonc with the assets
 // binding (run_worker_first) + optional custom domain.
 export function workers(opts?: { name?: string; domain?: string }): JuneAdapter {
   return {
     name: "workers",
-    capabilities: { runtime: "edge", persistentConnections: true, assets: "platform" },
+    capabilities: { runtime: "edge", persistentConnections: true, assets: "platform", durableObjects: true },
     conditions: ["source", "workerd", "edge", "import", "default"],
     // workers-og is a workerd-native WASM package: rolldown cannot bundle its
     // .wasm assets (wrangler's own bundler applies the CompiledWasm rule). Mark
@@ -100,7 +156,23 @@ export function workers(opts?: { name?: string; domain?: string }): JuneAdapter
 
     async emit({ appRoot, outDir, hasAssets, config, plan, defaultName }) {
       // An app that manages its own wrangler config wins — don't overwrite it.
-      if (existsSync(join(appRoot, "wrangler.toml")) || existsSync(join(appRoot, "wrangler.jsonc"))) {
+      // But a durable agent NEEDS its DO binding: warn when the app-owned config
+      // doesn't BIND the generated class under the name createWorker reads
+      // (hasDurableBinding above — a migrations-only mention, a binding under
+      // another name, or a commented-out table must all still warn), instead of
+      // silently shipping a worker whose chat surface 404s.
+      const own = ["wrangler.toml", "wrangler.jsonc"].map((f) => join(appRoot, f)).find(existsSync);
+      if (own) {
+        if (plan.agent) {
+          const cls = plan.agent.className;
+          const bound = hasDurableBinding(await readFile(own, "utf8"), own, plan.agent.binding, cls);
+          if (!bound) {
+            const snippet = own.endsWith(".toml")
+              ? `[[durable_objects.bindings]]\nname = "${plan.agent.binding}"\nclass_name = "${cls}"\n\n[[migrations]]\ntag = "v1"\nnew_sqlite_classes = ["${cls}"]`
+              : `"durable_objects": { "bindings": [{ "name": "${plan.agent.binding}", "class_name": "${cls}" }] },\n"migrations": [{ "tag": "v1", "new_sqlite_classes": ["${cls}"] }]`;
+            console.warn(`[june build] durable agent built, but ${basename(own)} doesn't bind it — add:\n${snippet}`);
+          }
+        }
         return;
       }
       const deployCfg = config.deploy;
@@ -133,6 +205,15 @@ export function workers(opts?: { name?: string; domain?: string }): JuneAdapter
                   ],
                 }
               : {}),
+            // The durable agent: one SQLite-backed DO class = the per-session
+            // AgentSession actor (its ctx.storage.sql is the durable loop's
+            // synchronous store). The binding name is what createWorker reads.
+            ...(plan.agent
+              ? {
+                  durable_objects: { bindings: [{ name: plan.agent.binding, class_name: plan.agent.className }] },
+                  migrations: [{ tag: "v1", new_sqlite_classes: [plan.agent.className] }],
+                }
+              : {}),
             // config deploy.domain → a Workers custom domain; without it the
             // regenerated file would silently drop a hand-attached domain.
             ...(opts?.domain ?? deployCfg?.domain