orchajs 0.20.1 → 0.20.2

package/README.md

@@ -808,13 +808,29 @@ module.exports = {
 };
 ```
 
-Running `orcha build` separately is not enough: it creates
-`.orcha/dist/bundle.js`, but does not rewrite imports in already-built
-handlers.
+For an unbundled production application built with plain `tsc` or
+`serverless-plugin-typescript`, run:
 
-Production CI should package the same way as deployment and verify that:
+```bash
+npx orcha build
+```
+
+Package `.orcha/dist/manifest.json` with the application. AWS Lambda is
+detected automatically; other unbundled environments should set
+`NODE_ENV=production` or `ORCHA_USE_BUILD=1`. The normal `orchajs` import and
+`orcha.init()` call then load the compiled manifest synchronously, so the
+`orcha/` agent source folders do not need to be deployed.
+
+This compatibility path still deploys the regular `orchajs` runtime and its
+dependencies. Use the esbuild integration above when deployment size matters;
+it replaces the package import with `.orcha/dist/bundle.js` and removes
+compiler-only code.
+
+Bundled production CI should package the same way as deployment and verify
+that:
 
-- the build generated `.orcha/dist/bundle.js`;
+- the build generated `.orcha/dist/bundle.js` and
+  `.orcha/dist/manifest.json`;
 - bundled handlers contain no unresolved bare `orchajs` import or require;
 - the deployment archive does not contain `node_modules/orchajs`.
 

package/dist/compiler/build-project.js

@@ -15,6 +15,7 @@ export async function buildProject(options = {}) {
     const registryBundlePath = resolve(temporaryDirectory, "registry.mjs");
     const productionEntryPath = resolve(temporaryDirectory, "production-entry.mjs");
     const outputPath = resolve(projectRoot, ".orcha/dist/bundle.js");
+    const manifestPath = resolve(projectRoot, ".orcha/dist/manifest.json");
     await mkdir(temporaryDirectory, { recursive: true });
     await mkdir(dirname(outputPath), { recursive: true });
     try {
@@ -102,6 +103,7 @@ export async function buildProject(options = {}) {
                 : {}),
             logLevel: "silent",
         });
+        await writeFile(manifestPath, `${JSON.stringify(compiledBundle)}\n`, "utf8");
         return outputPath;
     }
     finally {

package/dist/orcha.js

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { compileRegistry } from "./compiler/compile.js";
 import { generateProviderResponse } from "./providers/index.js";
@@ -8,13 +9,50 @@ setSandboxRuntimeLoader(async () => {
     return import(modulePath);
 });
 export const orcha = createOrcha((configuration) => {
-    if (process.env.NODE_ENV === "production" &&
-        process.env.ORCHA_COMPILING !== "1") {
-        throw new Error("ORCHA_PRODUCTION_BUNDLE_MISSING: configure the Orcha integration in your application build.");
-    }
     const projectRoot = resolve(configuration.root ??
         process.env.ORCHA_PROJECT_ROOT ??
         process.cwd());
+    if (process.env.ORCHA_COMPILING !== "1" &&
+        isPrecompiledRuntime()) {
+        return loadCompiledManifest(projectRoot, configuration);
+    }
     const registryRoot = resolve(projectRoot, "orcha");
     return compileRegistry(configuration.agents, registryRoot, configuration.actions?.runtime ?? "native");
 }, generateProviderResponse);
+function isPrecompiledRuntime() {
+    return (process.env.ORCHA_USE_BUILD === "1" ||
+        process.env.NODE_ENV === "production" ||
+        process.env.AWS_LAMBDA_FUNCTION_NAME !== undefined ||
+        process.env.AWS_EXECUTION_ENV?.startsWith("AWS_Lambda_") === true);
+}
+function loadCompiledManifest(projectRoot, configuration) {
+    const manifestPath = resolve(projectRoot, ".orcha/dist/manifest.json");
+    if (!existsSync(manifestPath)) {
+        throw new Error(`ORCHA_PRODUCTION_BUNDLE_MISSING: "${manifestPath}" was not found. Run "npx orcha build" before packaging, include ".orcha/dist" in the deployment, or configure the Orcha build integration.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Orcha could not read the compiled manifest at "${manifestPath}". Run "npx orcha build" again.`, { cause: error });
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        !("schemaVersion" in parsed) ||
+        parsed.schemaVersion !== 1 ||
+        !("agents" in parsed) ||
+        typeof parsed.agents !== "object" ||
+        parsed.agents === null ||
+        Array.isArray(parsed.agents)) {
+        throw new Error(`Orcha compiled manifest "${manifestPath}" is invalid. Run "npx orcha build" again.`);
+    }
+    const bundle = parsed;
+    const registeredAgents = Object.keys(configuration.agents).sort();
+    const compiledAgents = Object.keys(bundle.agents).sort();
+    if (registeredAgents.length !== compiledAgents.length ||
+        registeredAgents.some((name, index) => name !== compiledAgents[index])) {
+        throw new Error(`Orcha compiled manifest does not match the registered agents. Run "npx orcha build" again. Expected [${registeredAgents.join(", ")}], found [${compiledAgents.join(", ")}].`);
+    }
+    return bundle;
+}

package/dist-cjs/compiler/build-project.js

@@ -42,6 +42,10 @@ async function buildProject(options = {}) {
     "production-entry.mjs"
   );
   const outputPath = (0, import_path.resolve)(projectRoot, ".orcha/dist/bundle.js");
+  const manifestPath = (0, import_path.resolve)(
+    projectRoot,
+    ".orcha/dist/manifest.json"
+  );
   await (0, import_promises.mkdir)(temporaryDirectory, { recursive: true });
   await (0, import_promises.mkdir)((0, import_path.dirname)(outputPath), { recursive: true });
   try {
@@ -134,6 +138,12 @@ async function buildProject(options = {}) {
       } : {},
       logLevel: "silent"
     });
+    await (0, import_promises.writeFile)(
+      manifestPath,
+      `${JSON.stringify(compiledBundle)}
+`,
+      "utf8"
+    );
     return outputPath;
   } finally {
     await (0, import_promises.rm)(temporaryDirectory, {

package/dist-cjs/orcha.js

@@ -22,6 +22,7 @@ __export(orcha_exports, {
   orcha: () => orcha
 });
 module.exports = __toCommonJS(orcha_exports);
+var import_fs = require("fs");
 var import_path = require("path");
 var import_compile = require("./compiler/compile.js");
 var import_providers = require("./providers/index.js");
@@ -33,14 +34,12 @@ var import_create_orcha = require("./runtime/create-orcha.js");
 });
 const orcha = (0, import_create_orcha.createOrcha)(
   (configuration) => {
-    if (process.env.NODE_ENV === "production" && process.env.ORCHA_COMPILING !== "1") {
-      throw new Error(
-        "ORCHA_PRODUCTION_BUNDLE_MISSING: configure the Orcha integration in your application build."
-      );
-    }
     const projectRoot = (0, import_path.resolve)(
       configuration.root ?? process.env.ORCHA_PROJECT_ROOT ?? process.cwd()
     );
+    if (process.env.ORCHA_COMPILING !== "1" && isPrecompiledRuntime()) {
+      return loadCompiledManifest(projectRoot, configuration);
+    }
     const registryRoot = (0, import_path.resolve)(projectRoot, "orcha");
     return (0, import_compile.compileRegistry)(
       configuration.agents,
@@ -50,6 +49,45 @@ const orcha = (0, import_create_orcha.createOrcha)(
   },
   import_providers.generateProviderResponse
 );
+function isPrecompiledRuntime() {
+  return process.env.ORCHA_USE_BUILD === "1" || process.env.NODE_ENV === "production" || process.env.AWS_LAMBDA_FUNCTION_NAME !== void 0 || process.env.AWS_EXECUTION_ENV?.startsWith("AWS_Lambda_") === true;
+}
+function loadCompiledManifest(projectRoot, configuration) {
+  const manifestPath = (0, import_path.resolve)(
+    projectRoot,
+    ".orcha/dist/manifest.json"
+  );
+  if (!(0, import_fs.existsSync)(manifestPath)) {
+    throw new Error(
+      `ORCHA_PRODUCTION_BUNDLE_MISSING: "${manifestPath}" was not found. Run "npx orcha build" before packaging, include ".orcha/dist" in the deployment, or configure the Orcha build integration.`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse((0, import_fs.readFileSync)(manifestPath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `Orcha could not read the compiled manifest at "${manifestPath}". Run "npx orcha build" again.`,
+      { cause: error }
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null || !("schemaVersion" in parsed) || parsed.schemaVersion !== 1 || !("agents" in parsed) || typeof parsed.agents !== "object" || parsed.agents === null || Array.isArray(parsed.agents)) {
+    throw new Error(
+      `Orcha compiled manifest "${manifestPath}" is invalid. Run "npx orcha build" again.`
+    );
+  }
+  const bundle = parsed;
+  const registeredAgents = Object.keys(configuration.agents).sort();
+  const compiledAgents = Object.keys(bundle.agents).sort();
+  if (registeredAgents.length !== compiledAgents.length || registeredAgents.some(
+    (name, index) => name !== compiledAgents[index]
+  )) {
+    throw new Error(
+      `Orcha compiled manifest does not match the registered agents. Run "npx orcha build" again. Expected [${registeredAgents.join(", ")}], found [${compiledAgents.join(", ")}].`
+    );
+  }
+  return bundle;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   orcha

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchajs",
-  "version": "0.20.1",
+  "version": "0.20.2",
   "description": "A filesystem-convention, stateful agent framework for JavaScript.",
   "license": "MIT",
   "repository": {