@lunora/codegen 1.0.0-alpha.41 → 1.0.0-alpha.43

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/GENERATED_HEADER-B-FzJ297.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-DtherCpQ.mjs';
+import './paths-BRd6JHuF.mjs';

package/dist/packem_shared/{OPENRPC_VERSION-DxbqafcJ.mjs → OPENRPC_VERSION-DqTYxQ22.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-CFz-9dcD.mjs';
+import { G as GENERATED_HEADER } from './emit-DtherCpQ.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-C1yHg38Z.mjs → SCHEMA_SNAPSHOT_FILENAME-BbF69nj9.mjs}

@@ -5,11 +5,12 @@ 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 { discoverAgents } from './AGENTS_FILENAME-BksnAJgx.mjs';
 import discoverAuthApiCalls from './discoverAuthApiCalls-WMx8L2FG.mjs';
 import { discoverContainers } from './CONTAINERS_FILENAME-DjpXMqhp.mjs';
-import discoverCrons from './discoverCrons-D-jrpm97.mjs';
+import discoverCrons from './discoverCrons-DJJ3ZE5F.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-CFz-9dcD.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-DtherCpQ.mjs';
 import { discoverFlagKeys } from './FLAGS_FILENAME-fEZtzWXi.mjs';
 import discoverHttpRoutes from './discoverHttpRoutes-DNZLDCmm.mjs';
 import discoverInserts from './discoverInserts-DFRJhmCv.mjs';
@@ -27,9 +28,9 @@ import { discoverShapes } from './SHAPES_FILENAME-DOhPGi-6.mjs';
 import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-nosjYcvN.mjs';
 import { e as enclosingExportName$2 } from './discover-ast-CT6BgBr4.mjs';
 import { discoverWorkflows } from './WORKFLOWS_FILENAME-B2By8S4s.mjs';
-import { emitApp } from './emitApp-D8rVuM__.mjs';
-import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-_mwWOc2N.mjs';
-import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-DxbqafcJ.mjs';
+import { emitApp } from './emitApp-D7daY94X.mjs';
+import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-BrN41JMl.mjs';
+import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-DqTYxQ22.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, 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-_mwWOc2N.mjs → buildOpenApiDocument-BrN41JMl.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-CFz-9dcD.mjs';
+import { G as GENERATED_HEADER } from './emit-DtherCpQ.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/{discoverCrons-D-jrpm97.mjs → discoverCrons-DJJ3ZE5F.mjs}

@@ -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);
       }