@lunora/codegen 1.0.0-alpha.42 → 1.0.0-alpha.44

package/dist/index.mjs

@@ -1,29 +1,30 @@
 export { formatAdvisories, lintSchema } from './packem_shared/formatAdvisories-DRhEiJUz.mjs';
 export { CodegenDiagnosticError, diagnosticAt } from './packem_shared/CodegenDiagnosticError-DyQ5FwkM.mjs';
-export { default as discoverAuthApiCalls } from './packem_shared/discoverAuthApiCalls-WMx8L2FG.mjs';
+export { AGENTS_FILENAME, discoverAgents } from './packem_shared/AGENTS_FILENAME-BksnAJgx.mjs';
+export { default as discoverAuthApiCalls } from './packem_shared/discoverAuthApiCalls-Dx3K42rk.mjs';
 export { CONTAINERS_FILENAME, discoverContainers } from './packem_shared/CONTAINERS_FILENAME-DjpXMqhp.mjs';
-export { default as discoverCrons } from './packem_shared/discoverCrons-D-jrpm97.mjs';
-export { FLAGS_FILENAME, discoverFlags } from './packem_shared/FLAGS_FILENAME-fEZtzWXi.mjs';
-export { discoverFunctions } from './packem_shared/discoverFunctions-CZ91aenA.mjs';
-export { default as discoverHttpRoutes } from './packem_shared/discoverHttpRoutes-DNZLDCmm.mjs';
-export { default as discoverInserts } from './packem_shared/discoverInserts-DFRJhmCv.mjs';
-export { default as discoverMaskProcedures } from './packem_shared/discoverMaskProcedures-B5iFnZ-X.mjs';
-export { default as discoverMigrations } from './packem_shared/discoverMigrations-CdKtMlBc.mjs';
+export { default as discoverCrons } from './packem_shared/discoverCrons-_aosTRLr.mjs';
+export { FLAGS_FILENAME, discoverFlags } from './packem_shared/FLAGS_FILENAME-Dg4mKUuz.mjs';
+export { discoverFunctions } from './packem_shared/discoverFunctions-BJ-qR7Rg.mjs';
+export { default as discoverHttpRoutes } from './packem_shared/discoverHttpRoutes-daCzuTe8.mjs';
+export { default as discoverInserts } from './packem_shared/discoverInserts-DI4q5NxE.mjs';
+export { default as discoverMaskProcedures } from './packem_shared/discoverMaskProcedures-BcTOEKNU.mjs';
+export { default as discoverMigrations } from './packem_shared/discoverMigrations-VNUFvCwr.mjs';
 export { MUTATORS_FILENAME, discoverMutators } from './packem_shared/MUTATORS_FILENAME-BZOfUhlY.mjs';
-export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-C_PrQPkA.mjs';
-export { default as discoverQueries } from './packem_shared/discoverQueries-B8W9UPrt.mjs';
+export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-S0N2xLCq.mjs';
+export { default as discoverQueries } from './packem_shared/discoverQueries-CJnnnLpd.mjs';
 export { QUEUES_FILENAME, discoverQueues } from './packem_shared/QUEUES_FILENAME-Xv6Vy-Ku.mjs';
-export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-Bm7Rfnf4.mjs';
-export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-B4GL4ZKm.mjs';
+export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-pnpicWfz.mjs';
+export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-DppniPUH.mjs';
 export { default as discoverSchema } from './packem_shared/discoverSchema-DFWVgU5o.mjs';
 export { SHAPES_FILENAME, discoverShapes } from './packem_shared/SHAPES_FILENAME-DOhPGi-6.mjs';
-export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-nosjYcvN.mjs';
+export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-CnHl2rXD.mjs';
 export { WORKFLOWS_FILENAME, discoverWorkflows } from './packem_shared/WORKFLOWS_FILENAME-B2By8S4s.mjs';
-export { G as GENERATED_HEADER, e as emitApi, a as emitCollections, b as emitContainers, c as emitCrons, d as emitDataModel, f as emitDrizzleSchema, g as emitFunctions, h as emitServer, i as emitShard, j as emitVectors, k as emitWorkflows, l as emitWranglerCronTriggers } from './packem_shared/emit-31Yg1Ee5.mjs';
-export { emitApp } from './packem_shared/emitApp-DCP7Pr6M.mjs';
-export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-bg-NnLka.mjs';
-export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-CzhfvCIQ.mjs';
-export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-Cl1EBMdR.mjs';
+export { G as GENERATED_HEADER, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './packem_shared/emit-C_29WVlW.mjs';
+export { emitApp } from './packem_shared/emitApp-C9oljiZd.mjs';
+export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-saZ_-kl4.mjs';
+export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-Cyttekkt.mjs';
+export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-CMjGZSa1.mjs';
 export { SCHEMA_SNAPSHOT_VERSION, SchemaSnapshotParseError, buildSchemaSnapshot, diffSchemaSnapshots, evaluateSchemaDrift, parseSchemaSnapshot, serializeSchemaSnapshot } from './packem_shared/SCHEMA_SNAPSHOT_VERSION-D0ARY6rL.mjs';
 export { schemaFromIr } from './packem_shared/schemaFromIr-DTYsLBaA.mjs';
 export { LUNORA_ERROR_CODES, validatorIrToJsonSchema } from './packem_shared/LUNORA_ERROR_CODES-DvTLozCu.mjs';

package/dist/packem_shared/AGENTS_FILENAME-BksnAJgx.mjs

@@ -0,0 +1,116 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { agentDefaultName, agentClassName, agentBindingName, voiceBindingName, voiceClassName } from '@lunora/agent/naming';
+import { SyntaxKind, Node } from 'ts-morph';
+import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
+
+const AGENTS_FILENAME = "agents.ts";
+const isDefineAgent = (identifier) => {
+  const symbol = identifier.getSymbol();
+  if (!symbol) {
+    return identifier.getText() === "defineAgent";
+  }
+  for (const declaration of symbol.getDeclarations()) {
+    if (!Node.isImportSpecifier(declaration)) {
+      continue;
+    }
+    if (declaration.getImportDeclaration().getModuleSpecifierValue() !== "@lunora/agent") {
+      return false;
+    }
+    return declaration.getNameNode().getText() === "defineAgent";
+  }
+  return false;
+};
+const stringProperty = (expression, exportName, property) => {
+  if (Node.isStringLiteral(expression) || Node.isNoSubstitutionTemplateLiteral(expression)) {
+    return expression.getLiteralValue();
+  }
+  throw diagnosticAt(
+    expression,
+    `agent "${exportName}": \`${property}\` must be a static string literal — it is deploy configuration codegen writes into wrangler.jsonc`
+  );
+};
+const booleanProperty = (expression, exportName, property) => {
+  if (expression.getKind() === SyntaxKind.TrueKeyword) {
+    return true;
+  }
+  if (expression.getKind() === SyntaxKind.FalseKeyword) {
+    return false;
+  }
+  throw diagnosticAt(
+    expression,
+    `agent "${exportName}": \`${property}\` must be a static boolean literal — it is deploy configuration codegen writes into the ctx.agents wiring spec`
+  );
+};
+const agentFromCall = (call, exportName) => {
+  const argument = call.getArguments()[0];
+  if (!argument || !Node.isObjectLiteralExpression(argument)) {
+    throw diagnosticAt(call, `agent "${exportName}": defineAgent must be passed an inline object literal`);
+  }
+  const ir = {
+    bindingName: agentBindingName(exportName),
+    className: agentClassName(exportName),
+    exportName,
+    name: agentDefaultName(exportName)
+  };
+  const nameProperty = argument.getProperty("name");
+  if (nameProperty && Node.isPropertyAssignment(nameProperty)) {
+    ir.name = stringProperty(nameProperty.getInitializerOrThrow(), exportName, "name");
+  }
+  const publicRunProperty = argument.getProperty("publicRun");
+  if (publicRunProperty && Node.isPropertyAssignment(publicRunProperty) && booleanProperty(publicRunProperty.getInitializerOrThrow(), exportName, "publicRun")) {
+    ir.publicRun = true;
+  }
+  const voiceProperty = argument.getProperty("voice");
+  if (voiceProperty && Node.isPropertyAssignment(voiceProperty)) {
+    const voiceInitializer = voiceProperty.getInitializerOrThrow();
+    if (!Node.isObjectLiteralExpression(voiceInitializer)) {
+      throw diagnosticAt(
+        voiceInitializer,
+        `agent "${exportName}": \`voice\` must be an inline object literal — its presence tells codegen to emit the voice-session Durable Object`
+      );
+    }
+    ir.voice = true;
+    ir.voiceBindingName = voiceBindingName(exportName);
+    ir.voiceClassName = voiceClassName(exportName);
+  }
+  if (argument.getProperty("onEmail")) {
+    ir.onEmail = true;
+  }
+  return ir;
+};
+const agentsFromSource = (source) => {
+  const agents = [];
+  for (const declaration of source.getVariableDeclarations()) {
+    if (!declaration.isExported()) {
+      continue;
+    }
+    const initializer = declaration.getInitializer();
+    if (initializer?.getKind() !== SyntaxKind.CallExpression) {
+      continue;
+    }
+    const call = initializer;
+    const callee = call.getExpression();
+    if (!Node.isIdentifier(callee) || !isDefineAgent(callee)) {
+      continue;
+    }
+    const nameNode = declaration.getNameNode();
+    if (!Node.isIdentifier(nameNode)) {
+      throw diagnosticAt(nameNode, "defineAgent exports must be plain named exports (no destructuring)");
+    }
+    agents.push(agentFromCall(call, nameNode.getText()));
+  }
+  return agents;
+};
+const discoverAgents = (project, lunoraDirectory) => {
+  const agentsPath = join(lunoraDirectory, AGENTS_FILENAME);
+  if (!existsSync(agentsPath)) {
+    return [];
+  }
+  const source = project.getSourceFile(agentsPath) ?? project.addSourceFileAtPath(agentsPath);
+  const agents = agentsFromSource(source);
+  agents.sort((a, b) => a.exportName.localeCompare(b.exportName));
+  return agents;
+};
+
+export { AGENTS_FILENAME, discoverAgents };

package/dist/packem_shared/{FLAGS_FILENAME-fEZtzWXi.mjs → FLAGS_FILENAME-Dg4mKUuz.mjs}

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const FLAGS_FILENAME = "flags.ts";
 const FLAG_TYPES = /* @__PURE__ */ new Set(["boolean", "number", "object", "string"]);

package/dist/packem_shared/GENERATED_HEADER-7W9f2IG3.mjs

@@ -0,0 +1,4 @@
+import '@lunora/agent/component';
+import '@lunora/errors';
+export { G as GENERATED_HEADER, n as buildStorageColumns, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, o as emitQueues, p as emitSeed, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './emit-C_29WVlW.mjs';
+import './paths-BRd6JHuF.mjs';

package/dist/packem_shared/{OPENRPC_VERSION-CzhfvCIQ.mjs → OPENRPC_VERSION-Cyttekkt.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-31Yg1Ee5.mjs';
+import { G as GENERATED_HEADER } from './emit-C_29WVlW.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { argsObjectSchema, LUNORA_ERROR_CODES } from './LUNORA_ERROR_CODES-DvTLozCu.mjs';
 

package/dist/packem_shared/{SCHEMA_SNAPSHOT_FILENAME-Cl1EBMdR.mjs → SCHEMA_SNAPSHOT_FILENAME-CMjGZSa1.mjs}

@@ -4,32 +4,33 @@ import { performance } from 'node:perf_hooks';
 import { LunoraError } from '@lunora/errors';
 import { Node, SyntaxKind, Project } from 'ts-morph';
 import { lintSchema } from './formatAdvisories-DRhEiJUz.mjs';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall, inlineHandler as inlineHandler$1, procedureHandler, chainUsesWrappedCall, isDatabaseAccessor, chainHasStep, discoverFunctions } from './discoverFunctions-CZ91aenA.mjs';
-import discoverAuthApiCalls from './discoverAuthApiCalls-WMx8L2FG.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall, inlineHandler as inlineHandler$1, procedureHandler, chainUsesWrappedCall, isDatabaseAccessor, chainHasStep, discoverFunctions } from './discoverFunctions-BJ-qR7Rg.mjs';
+import { discoverAgents } from './AGENTS_FILENAME-BksnAJgx.mjs';
+import discoverAuthApiCalls from './discoverAuthApiCalls-Dx3K42rk.mjs';
 import { discoverContainers } from './CONTAINERS_FILENAME-DjpXMqhp.mjs';
-import discoverCrons from './discoverCrons-D-jrpm97.mjs';
+import discoverCrons from './discoverCrons-_aosTRLr.mjs';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { C as CAPABILITIES, m as buildStorageColumns, d as emitDataModel, e as emitApi, h as emitServer, g as emitFunctions, i as emitShard, a as emitCollections, b as emitContainers, k as emitWorkflows, n as emitQueues, c as emitCrons, j as emitVectors, f as emitDrizzleSchema, o as emitSeed, l as emitWranglerCronTriggers } from './emit-31Yg1Ee5.mjs';
-import { discoverFlagKeys } from './FLAGS_FILENAME-fEZtzWXi.mjs';
-import discoverHttpRoutes from './discoverHttpRoutes-DNZLDCmm.mjs';
-import discoverInserts from './discoverInserts-DFRJhmCv.mjs';
-import discoverMaskProcedures, { discoverMaskStrategies, discoverMaskMetadata } from './discoverMaskProcedures-B5iFnZ-X.mjs';
-import discoverMigrations from './discoverMigrations-CdKtMlBc.mjs';
+import { C as CAPABILITIES, n as buildStorageColumns, f as emitDataModel, a as emitApi, i as emitServer, h as emitFunctions, j as emitShard, b as emitCollections, c as emitContainers, l as emitWorkflows, e as emitAgents, o as emitQueues, d as emitCrons, k as emitVectors, g as emitDrizzleSchema, p as emitSeed, m as emitWranglerCronTriggers } from './emit-C_29WVlW.mjs';
+import { discoverFlagKeys } from './FLAGS_FILENAME-Dg4mKUuz.mjs';
+import discoverHttpRoutes from './discoverHttpRoutes-daCzuTe8.mjs';
+import discoverInserts from './discoverInserts-DI4q5NxE.mjs';
+import discoverMaskProcedures, { discoverMaskStrategies, discoverMaskMetadata } from './discoverMaskProcedures-BcTOEKNU.mjs';
+import discoverMigrations from './discoverMigrations-VNUFvCwr.mjs';
 import { MUTATORS_FILENAME, isDefineMutatorCallee, discoverMutators } from './MUTATORS_FILENAME-BZOfUhlY.mjs';
-import discoverNondeterministicCalls from './discoverNondeterministicCalls-C_PrQPkA.mjs';
-import discoverQueries from './discoverQueries-B8W9UPrt.mjs';
+import discoverNondeterministicCalls from './discoverNondeterministicCalls-S0N2xLCq.mjs';
+import discoverQueries from './discoverQueries-CJnnnLpd.mjs';
 import { discoverQueues } from './QUEUES_FILENAME-Xv6Vy-Ku.mjs';
-import discoverR2sqlCalls from './discoverR2sqlCalls-Bm7Rfnf4.mjs';
-import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-B4GL4ZKm.mjs';
+import discoverR2sqlCalls from './discoverR2sqlCalls-pnpicWfz.mjs';
+import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-DppniPUH.mjs';
 import discoverSchema from './discoverSchema-DFWVgU5o.mjs';
 import { secretKindOf, redact } from './redact-oTmsol5A.mjs';
 import { discoverShapes } from './SHAPES_FILENAME-DOhPGi-6.mjs';
-import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-nosjYcvN.mjs';
+import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-CnHl2rXD.mjs';
 import { e as enclosingExportName$2 } from './discover-ast-CT6BgBr4.mjs';
 import { discoverWorkflows } from './WORKFLOWS_FILENAME-B2By8S4s.mjs';
-import { emitApp } from './emitApp-DCP7Pr6M.mjs';
-import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-bg-NnLka.mjs';
-import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-CzhfvCIQ.mjs';
+import { emitApp } from './emitApp-C9oljiZd.mjs';
+import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-saZ_-kl4.mjs';
+import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-Cyttekkt.mjs';
 import { buildSchemaSnapshot, serializeSchemaSnapshot } from './SCHEMA_SNAPSHOT_VERSION-D0ARY6rL.mjs';
 
 const HTTP_VERBS$1 = /* @__PURE__ */ new Set(["delete", "get", "head", "options", "patch", "post", "put"]);
@@ -2698,6 +2699,41 @@ const discoverRelationLoads = (project, lunoraDirectory) => {
   return rows;
 };
 
+const SANDBOX_MODULE_SPECIFIERS = /* @__PURE__ */ new Set(["@lunora/agent", "@lunora/agent/sandbox"]);
+const scanImportDeclaration = (declaration) => {
+  const found = { usesSandboxBrowser: false, usesSandboxContainer: false };
+  if (!SANDBOX_MODULE_SPECIFIERS.has(declaration.getModuleSpecifierValue()) || declaration.isTypeOnly()) {
+    return found;
+  }
+  for (const named of declaration.getNamedImports()) {
+    if (named.isTypeOnly()) {
+      continue;
+    }
+    const name = named.getNameNode().getText();
+    if (name === "browserTool") {
+      found.usesSandboxBrowser = true;
+    } else if (name === "containerTool") {
+      found.usesSandboxContainer = true;
+    }
+  }
+  return found;
+};
+const discoverSandboxUsage = (project, lunoraDirectory) => {
+  const usage = { usesSandboxBrowser: false, usesSandboxContainer: false };
+  for (const filePath of listLunoraSourceFiles(lunoraDirectory)) {
+    const sourceFile = project.getSourceFile(filePath) ?? project.addSourceFileAtPath(filePath);
+    for (const declaration of sourceFile.getImportDeclarations()) {
+      const found = scanImportDeclaration(declaration);
+      usage.usesSandboxBrowser ||= found.usesSandboxBrowser;
+      usage.usesSandboxContainer ||= found.usesSandboxContainer;
+    }
+    if (usage.usesSandboxBrowser && usage.usesSandboxContainer) {
+      break;
+    }
+  }
+  return usage;
+};
+
 const literalValueOf = (node) => {
   if (Node.isStringLiteral(node) || Node.isNoSubstitutionTemplateLiteral(node)) {
     return node.getLiteralText();
@@ -3166,7 +3202,8 @@ const runCodegen = (options) => {
   const env = discoverEnv(project, lunoraDirectory);
   const workflows = discoverWorkflows(project, lunoraDirectory);
   const queues = discoverQueues(project, lunoraDirectory);
-  const crons = discoverCrons(project, lunoraDirectory, workflows);
+  const agents = discoverAgents(project, lunoraDirectory);
+  const crons = discoverCrons(project, lunoraDirectory, workflows, agents);
   const containers = discoverContainers(project, lunoraDirectory);
   const advisories = options.lint === false ? [] : lintSchema({
     adminRoutes: discoverAdminRoutes(project, lunoraDirectory),
@@ -3229,7 +3266,9 @@ const runCodegen = (options) => {
   const hasFlags = existsSync(join(lunoraDirectory, "flags.ts"));
   const flagKeys = hasFlags ? discoverFlagKeys(project, lunoraDirectory) : [];
   const hasHyperdrive = featureUsage.hyperdrive;
-  const hasBrowser = featureUsage.browser;
+  const sandboxUsage = discoverSandboxUsage(project, lunoraDirectory);
+  const usesSandbox = sandboxUsage.usesSandboxBrowser || sandboxUsage.usesSandboxContainer;
+  const hasBrowser = featureUsage.browser || sandboxUsage.usesSandboxBrowser;
   const hasImages = featureUsage.images;
   const hasAnalytics = featureUsage.analytics;
   const hasPipelines = featureUsage.pipelines;
@@ -3249,8 +3288,9 @@ const runCodegen = (options) => {
   const useUmbrella = dependencies.has("lunorash");
   const emitStartedAt = timingEnabled ? performance.now() : 0;
   const dataModelContent = emitDataModel(schema, useUmbrella);
-  const apiContent = emitApi(functions, workflows, useUmbrella);
+  const apiContent = emitApi({ agents, functions, httpRoutes, useUmbrella, workflows });
   const serverContent = emitServer({
+    agents,
     containers,
     env,
     hasAccessFacade,
@@ -3272,9 +3312,10 @@ const runCodegen = (options) => {
     useUmbrella,
     workflows
   });
-  const functionsContent = emitFunctions(functions, migrations, useUmbrella, mutators, shapes);
+  const functionsContent = emitFunctions({ agents, functions, migrations, mutators, shapes, useUmbrella, usesSandbox });
   const shardContent = emitShard({
     advisories,
+    agents,
     containers,
     env,
     flagKeys,
@@ -3304,6 +3345,7 @@ const runCodegen = (options) => {
   const collectionsContent = emitCollections(shapes, dependencies.has("@lunora/db"), useUmbrella);
   const containersContent = emitContainers(containers, schema.jurisdiction);
   const workflowsContent = emitWorkflows(workflows);
+  const agentsContent = emitAgents(agents);
   const queuesContent = emitQueues(queues);
   const cronsContent = emitCrons(crons);
   const vectorsContent = emitVectors(schema.vectorIndexes);
@@ -3313,6 +3355,13 @@ const runCodegen = (options) => {
   const wantsOpenApi = apiSpec === "openapi" || apiSpec === "both";
   const wantsOpenRpc = apiSpec === "openrpc" || apiSpec === "both";
   const appContent = emitApp({
+    // Inbound-email agents (`defineAgent({ onEmail })`) → wire the worker's
+    // top-level `email()` handler to each agent's `AGENT_*` Workflow binding so
+    // received mail starts a durable run. Empty for email-free (and agent-free)
+    // projects, so the emitted app.ts stays byte-identical.
+    emailAgents: agents.filter((agent) => agent.onEmail === true).map((agent) => {
+      return { bindingName: agent.bindingName, exportName: agent.exportName };
+    }),
     hasAccess: dependencies.has("@lunora/cloudflare-access"),
     hasAi,
     hasAnalytics,
@@ -3349,6 +3398,13 @@ const runCodegen = (options) => {
     // Schema `.jurisdiction("…")` → pin the generated worker's DOs to the region.
     jurisdiction: schema.jurisdiction,
     useUmbrella,
+    // Voice-enabled agents (`defineAgent({ voice: … })`) → wire the worker's
+    // `/_lunora/voice/<exportName>` route to each agent's `VOICE_*` DO
+    // namespace. Empty for voice-free (and agent-free) projects, so the
+    // emitted app.ts stays byte-identical.
+    voiceAgents: agents.filter((agent) => agent.voice === true && agent.voiceBindingName !== void 0).map((agent) => {
+      return { bindingName: agent.voiceBindingName, exportName: agent.exportName };
+    }),
     wantsOpenApi,
     wantsOpenRpc
   });
@@ -3384,6 +3440,7 @@ const runCodegen = (options) => {
     writeIfChanged(join(outputDirectory, "drizzle.shard.ts"), drizzleFiles.shard);
     writeIfPresent(join(outputDirectory, "containers.ts"), containersContent);
     writeIfPresent(join(outputDirectory, "workflows.ts"), workflowsContent);
+    writeIfPresent(join(outputDirectory, "agents.ts"), agentsContent);
     writeIfPresent(join(outputDirectory, "queues.ts"), queuesContent);
     writeIfPresent(join(outputDirectory, "seed.ts"), seedContent);
     writeIfPresent(join(outputDirectory, "collections.ts"), collectionsContent);
@@ -3404,9 +3461,11 @@ const runCodegen = (options) => {
   }
   return {
     advisories,
+    agents,
     containers,
     cronTriggers: emitWranglerCronTriggers(crons),
     generated: {
+      agents: agentsContent,
       api: apiContent,
       app: appContent,
       collections: collectionsContent,

package/dist/packem_shared/{buildOpenApiDocument-bg-NnLka.mjs → buildOpenApiDocument-saZ_-kl4.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-31Yg1Ee5.mjs';
+import { G as GENERATED_HEADER } from './emit-C_29WVlW.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { LUNORA_ERROR_CODES, objectSchema, argsObjectSchema, validatorIrToJsonSchema } from './LUNORA_ERROR_CODES-DvTLozCu.mjs';
 

package/dist/packem_shared/{discoverAuthApiCalls-WMx8L2FG.mjs → discoverAuthApiCalls-Dx3K42rk.mjs}

@@ -1,7 +1,7 @@
 import { relative, sep } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
 import { T as TS_EXTENSION_RE, e as enclosingExportName } from './discover-ast-CT6BgBr4.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isAuthApiCall = (call) => {
   const callee = call.getExpression();

package/dist/packem_shared/{discoverCrons-D-jrpm97.mjs → discoverCrons-_aosTRLr.mjs}

@@ -2,7 +2,7 @@ import { LunoraError } from '@lunora/errors';
 import { isValidCronExpression, compileCronSchedule, CRON_SCHEDULE_KINDS } from '@lunora/scheduler';
 import { SyntaxKind, Node } from 'ts-morph';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 
 const CRON_METHODS = /* @__PURE__ */ new Set([...CRON_SCHEDULE_KINDS, "cron"]);
@@ -128,24 +128,38 @@ const functionPathFromArgument = (call, index, jobName) => {
 const workflowTarget = (workflow) => {
   return { workflow: { binding: workflow.bindingName, exportName: workflow.exportName } };
 };
-const resolveTarget = (call, index, jobName, workflowsByName) => {
+const agentTarget = (agent) => {
+  return { workflow: { binding: agent.bindingName, exportName: agent.exportName } };
+};
+const resolveReferenceAccess = (argument, receiverName, byName, jobName, kind, build) => {
+  const receiver = argument.getExpression();
+  if (!Node.isIdentifier(receiver) || receiver.getText() !== receiverName) {
+    return void 0;
+  }
+  const definition = byName.get(argument.getName());
+  if (definition) {
+    return build(definition);
+  }
+  throw diagnosticAt(
+    argument,
+    `Cron job "${jobName}" targets ${receiverName}.${argument.getName()}, but no such ${kind} is declared in lunora/${kind}s.ts.`,
+    {
+      code: "CRON_NON_STATIC_FN",
+      name: "LunoraError",
+      status: 500
+    }
+  );
+};
+const resolveTarget = (call, index, jobName, workflowsByName, agentsByName) => {
   const argument = call.getArguments()[index];
   if (argument && Node.isPropertyAccessExpression(argument)) {
-    const receiver = argument.getExpression();
-    if (Node.isIdentifier(receiver) && receiver.getText() === "workflows") {
-      const workflow = workflowsByName.get(argument.getName());
-      if (workflow) {
-        return workflowTarget(workflow);
-      }
-      throw diagnosticAt(
-        argument,
-        `Cron job "${jobName}" targets workflows.${argument.getName()}, but no such workflow is declared in lunora/workflows.ts.`,
-        {
-          code: "CRON_NON_STATIC_FN",
-          name: "LunoraError",
-          status: 500
-        }
-      );
+    const workflowReference = resolveReferenceAccess(argument, "workflows", workflowsByName, jobName, "workflow", workflowTarget);
+    if (workflowReference) {
+      return workflowReference;
+    }
+    const agentReference = resolveReferenceAccess(argument, "agents", agentsByName, jobName, "agent", agentTarget);
+    if (agentReference) {
+      return agentReference;
     }
     return { functionPath: functionPathFromArgument(call, index, jobName) };
   }
@@ -166,7 +180,7 @@ const resolveTarget = (call, index, jobName, workflowsByName) => {
   }
   return { functionPath: functionPathFromArgument(call, index, jobName) };
 };
-const cronFromCall = (call, callee, builderNames, workflowsByName) => {
+const cronFromCall = (call, callee, builderNames, workflowsByName, agentsByName) => {
   const method = callee.getName();
   if (!CRON_METHODS.has(method)) {
     return void 0;
@@ -211,7 +225,7 @@ const cronFromCall = (call, callee, builderNames, workflowsByName) => {
     }
     cron = compileCronSchedule(method, objectLiteralValue(scheduleArgument, name));
   }
-  const target = resolveTarget(call, 2, name, workflowsByName);
+  const target = resolveTarget(call, 2, name, workflowsByName, agentsByName);
   const argumentsNode = call.getArguments()[3];
   const args = argumentsNode && Node.isObjectLiteralExpression(argumentsNode) ? objectLiteralValue(argumentsNode, name) : {};
   return { args, cron, name, ...target };
@@ -227,10 +241,11 @@ const assertUniqueNames = (crons) => {
     seen.add(cron.name);
   }
 };
-const discoverCrons = (project, lunoraDirectory, workflows = []) => {
+const discoverCrons = (project, lunoraDirectory, workflows = [], agents = []) => {
   const filePaths = listLunoraSourceFiles(lunoraDirectory);
   const crons = [];
   const workflowsByName = new Map(workflows.map((workflow) => [workflow.exportName, workflow]));
+  const agentsByName = new Map(agents.map((agent) => [agent.exportName, agent]));
   for (const filePath of filePaths) {
     const source = project.getSourceFile(filePath) ?? project.addSourceFileAtPath(filePath);
     const builderNames = collectCronBuilderNames(source);
@@ -242,7 +257,7 @@ const discoverCrons = (project, lunoraDirectory, workflows = []) => {
       if (!Node.isPropertyAccessExpression(callee)) {
         continue;
       }
-      const cron = cronFromCall(call, callee, builderNames, workflowsByName);
+      const cron = cronFromCall(call, callee, builderNames, workflowsByName, agentsByName);
       if (cron) {
         crons.push(cron);
       }

package/dist/packem_shared/{discoverFunctions-CZ91aenA.mjs → discoverFunctions-BJ-qR7Rg.mjs}

@@ -515,4 +515,4 @@ const discoverFunctions = (project, lunoraDirectory) => {
   return functions;
 };
 
-export { chainHasStep, chainUsesWrappedCall, classifyProcedureCall, discoverFunctions, inlineHandler, isDatabaseAccessor, listLunoraSourceFiles, lunoraRelativePath, procedureHandler };
+export { chainHasStep, chainUsesWrappedCall, classifyProcedureCall, discoverFunctions, inlineHandler, isDatabaseAccessor, listLunoraSourceFiles, lunoraRelativePath, procedureHandler, unwrapHandlerReturn };

package/dist/packem_shared/{discoverHttpRoutes-DNZLDCmm.mjs → discoverHttpRoutes-daCzuTe8.mjs}

@@ -1,6 +1,6 @@
 import { relative, sep } from 'node:path';
 import { Node } from 'ts-morph';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, unwrapHandlerReturn } from './discoverFunctions-BJ-qR7Rg.mjs';
 import { p as parseValidator, a as parseObjectShape } from './parse-validator-BSJo1HGP.mjs';
 
 const TS_EXTENSION_RE = /\.ts$/u;
@@ -72,6 +72,13 @@ const walkRouteChain = (terminalCall, terminalStep) => {
   state.path = root.path;
   return state;
 };
+const chunkTypeFromStreamTerminal = (call) => {
+  const handler = call.getArguments()[0];
+  if (!handler || !(Node.isArrowFunction(handler) || Node.isFunctionExpression(handler))) {
+    return "unknown";
+  }
+  return unwrapHandlerReturn(handler);
+};
 const routeFromTerminal = (call, callee, exportName, filePath) => {
   const step = callee.getName();
   if (!TERMINAL_STEPS.has(step)) {
@@ -90,6 +97,7 @@ const routeFromTerminal = (call, callee, exportName, filePath) => {
     path: state.path,
     searchParams: state.searchParams,
     stream: state.stream,
+    ...state.stream ? { chunkType: chunkTypeFromStreamTerminal(call) } : {},
     ...state.output ? { output: state.output } : {}
   };
 };

package/dist/packem_shared/{discoverInserts-DFRJhmCv.mjs → discoverInserts-DI4q5NxE.mjs}

@@ -1,6 +1,6 @@
 import { SyntaxKind, Node } from 'ts-morph';
 import { e as enclosingExportName } from './discover-ast-CT6BgBr4.mjs';
-import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isDatabaseInsertCall = (call) => {
   const callee = call.getExpression();

package/dist/packem_shared/{discoverMaskProcedures-B5iFnZ-X.mjs → discoverMaskProcedures-BcTOEKNU.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isMaskCall = (node) => {
   if (!Node.isCallExpression(node)) {

package/dist/packem_shared/{discoverMigrations-CdKtMlBc.mjs → discoverMigrations-VNUFvCwr.mjs}

@@ -1,7 +1,7 @@
 import { relative, sep } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const TS_EXTENSION_RE = /\.ts$/u;
 const isDefineMigration = (identifier) => {

package/dist/packem_shared/{discoverNondeterministicCalls-C_PrQPkA.mjs → discoverNondeterministicCalls-S0N2xLCq.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const PROPERTY_CALLS = {
   "crypto.getRandomValues": "crypto.getRandomValues",

package/dist/packem_shared/{discoverQueries-B8W9UPrt.mjs → discoverQueries-CJnnnLpd.mjs}

@@ -1,5 +1,5 @@
 import { SyntaxKind, Node } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const INDEX_METHODS = /* @__PURE__ */ new Set(["withIndex", "withSearchIndex"]);
 const isDatabaseQueryCall = (call) => {

package/dist/packem_shared/{discoverR2sqlCalls-Bm7Rfnf4.mjs → discoverR2sqlCalls-pnpicWfz.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const handlerOf = (call, receiver) => {
   if (receiver) {

package/dist/packem_shared/{discoverRlsMetadata-B4GL4ZKm.mjs → discoverRlsMetadata-DppniPUH.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isRlsCall = (node) => {
   if (!Node.isCallExpression(node)) {

package/dist/packem_shared/{discoverStorageRulesMetadata-nosjYcvN.mjs → discoverStorageRulesMetadata-CnHl2rXD.mjs}

@@ -1,5 +1,5 @@
 import { Node } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const STORAGE_OPERATIONS = /* @__PURE__ */ new Set(["delete", "list", "read", "write"]);
 const isStorageRulesCall = (node) => {