@farm.js/agent 0.1.0-beta.0 → 0.1.0-beta.2

package/README.md

@@ -1,13 +1,24 @@
 # @farm.js/agent
 
-Durable agents for Farm.js, served and built by [agent-unit](https://github.com/farming-labs/agent-unit)
+Durable agents for Farm.js, built and run by
+[agent-unit](https://github.com/farming-labs/agent-unit). The integration serves the agents in
+`src/agents` as runs that can pause for a person's approval, survive restarts and redeploys, and
+resume without repeating a model call or a side effect.
 
-See [Stability and Support](https://farmjs.dev/docs/stability) for what this package guarantees.
+This package is in beta. See [Stability and Support](https://farmjs.dev/docs/stability).
+
+## Install
 
 ```bash
-npm install @farm.js/agent agent-unit
+pnpm add @farm.js/agent agent-unit
 ```
 
+`agent-unit` is a dependency of this package. Add it to the app as well, because agent files import
+`defineAgent` from it and clients import `agent-unit/client`. `@farm.js/core` is a peer dependency,
+and the package needs Node.js 22.13 or newer.
+
+## Configure
+
 ```ts
 // farm.config.ts
 import { agent } from "@farm.js/agent";
@@ -15,9 +26,125 @@ import { defineConfig } from "@farm.js/core";
 
 export default defineConfig({
   integrations: {
-    agent: agent({ storage: { driver: "redis", url: process.env.REDIS_URL } }),
+    agent: agent({
+      storage: { driver: "redis", url: process.env.REDIS_URL },
+    }),
+  },
+});
+```
+
+`farm dev` serves the agents from source and reloads them on change. `farm build` builds them into
+the server for the app's deploy target, with run storage and a scheduled sweep that wakes sleeping
+runs and recovers stalled ones. Settings evaluate where the server runs, so a value read from
+`process.env` is never written into the build.
+
+## Write an agent
+
+Each file in `src/agents` is an agent named after the file:
+
+```ts
+// src/agents/refund.ts
+import { defineAgent } from "agent-unit";
+
+export default defineAgent(async (input: { orderId: string }, run) => {
+  const order = await run.step("look up order", async () => ({ id: input.orderId, total: 42 }));
+  const { approved } = await run.interrupt<{ approved: boolean }>("approve-refund", order);
+  return approved ? `refunded ${order.id}` : `kept ${order.id}`;
+});
+```
+
+`run.step` runs once and is replayed from the run's journal afterwards. `run.interrupt` pauses the
+run until an answer arrives. Agents written with the AI SDK, Mastra, LangGraph, or the OpenAI
+Agents SDK work as a default export too; the framework is detected from `package.json`.
+
+## Call the agents
+
+The API is mounted at `basePath`, `/api/agent` by default, as ordinary API routes, so the app's
+middleware and integration guards run first in development and in every deploy target.
+
+| Request                                  | Does                                                                   |
+| ---------------------------------------- | ---------------------------------------------------------------------- |
+| `POST /api/agent/agents/:name/runs`      | Starts a run with `{ input }`. `Accept: text/event-stream` streams it. |
+| `GET /api/agent/runs/:id`                | Reads a run: its status, pending interrupt, and output.                |
+| `GET /api/agent/runs/:id/events`         | Streams its events, from `?after=` or `Last-Event-ID`.                 |
+| `POST /api/agent/runs/:id/resume`        | Answers the interrupt with `{ answer }`.                               |
+| `GET /api/agent/runs?status=interrupted` | Lists runs, for an approvals inbox.                                    |
+| `GET /api/agent/manifest.json`           | Lists the agents.                                                      |
+| `POST /api/agent/mcp`                    | The agents as MCP tools.                                               |
+
+```ts
+import { createAgentClient } from "agent-unit/client";
+
+const agents = createAgentClient({ baseUrl: "/api/agent" });
+
+for await (const event of agents.run("refund", { orderId: "o_1" })) {
+  if (event.type === "RUN_INTERRUPTED") console.log("needs approval", event.interrupt.payload);
+}
+```
+
+The integration owns every path under `basePath`; `farm dev` refuses to start when an API route in
+`src/app` sits under it.
+
+## Authorize requests
+
+Every request reaches `authorize` before the agents. Return `false` to answer `401`, or a
+`Response` to answer with. The second argument says what the request does:
+`{ action, agent, runId, threadId }`.
+
+```ts
+agent({
+  authorize: (request) =>
+    request.headers.get("authorization") === `Bearer ${process.env.AGENT_TOKEN}`,
+});
+```
+
+Set `authorize`, or a middleware guard on `basePath`, before anyone else can reach the app. Without
+one, any caller can list, read, answer, and start runs. A guard should let agent-unit's internal
+continue and sweep requests through; they carry `AGENT_UNIT_SECRET` as a bearer token, which
+agent-unit checks itself.
+
+## Options
+
+| Option      | Default              | Description                                                  |
+| ----------- | -------------------- | ------------------------------------------------------------ |
+| `basePath`  | `/api/agent`         | Where the API is mounted. Must be under `/api`.              |
+| `agentsDir` | `agents` in `srcDir` | The folder of agent files, relative to the app root.         |
+| `agents`    |                      | Agents as an object, instead of the folder.                  |
+| `framework` | detected             | `"ai-sdk"`, `"mastra"`, `"langgraph"`, or `"openai-agents"`. |
+| `storage`   | disk on Node         | Run storage, as an unstorage driver config.                  |
+| `presets`   |                      | Settings per deploy target, over the top-level ones.         |
+| `authorize` |                      | Decides every request.                                       |
+| `name`      | package name         | The name in the manifest, MCP, and A2A card.                 |
+| `tasks`     |                      | Scheduled tasks run by the target's scheduler.               |
+| `budget`    | per target           | How long a run works before it yields and continues.         |
+| `retention` | kept                 | How long finished runs are kept.                             |
+| `sweep`     | every minute         | The sweep's cron schedule, or `false`.                       |
+| `adapters`  |                      | Adapters for other agent frameworks.                         |
+
+Without `storage`, a Node server keeps runs on disk in `.data/agent-unit`, and targets without a
+durable disk keep them in memory. Use a shared driver in production, per target if needed:
+
+```ts
+agent({
+  storage: { driver: "fs-lite", base: ".data/agents" },
+  presets: {
+    vercel: { storage: { driver: "upstash" } },
+    "cloudflare-module": { storage: { driver: "cloudflare-kv-binding", binding: "AGENTS" } },
   },
 });
 ```
 
-See the [durable agents guide](https://farmjs.dev/docs/integrations/agent) for agents, the API, storage, and deploy targets.
+`@farm.js/agent/config` is the module agent-unit reads these settings from inside the built
+server; apps do not import it.
+
+## Documentation
+
+- [Durable agents](https://farmjs.dev/docs/integrations/agent)
+- [Agent frameworks](https://farmjs.dev/docs/integrations/agent-frameworks), for chat routes that
+  do not need durable runs
+
+The [`examples/agent`](https://github.com/farming-labs/farm.js/tree/main/examples/agent) app runs an
+approval agent end to end.
+
+Report issues and find examples in the
+[Farm.js repository](https://github.com/farming-labs/farm.js).

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { AgentFramework } from 'agent-unit';
  * Nitro and Workers settings, which belong in farm.config.
  */
 interface AgentOptions extends Omit<AgentUnitConfig, "server" | "preset" | "runtime" | "cloudflare" | "nitro"> {
-    /** Where the agent API is mounted. It owns every path under it. Default `/api/agent`. */
+    /** Where the agent API is mounted, under `/api`. It owns every path under it. Default `/api/agent`. */
     basePath?: string;
     /** The folder of agent files, relative to the app root. Default `agents` in `srcDir`. */
     agentsDir?: string;
@@ -28,7 +28,79 @@ declare function agent(options?: AgentOptions): _farm_js_core.DefinedIntegration
     category: "agent";
     type: string;
     instance: AgentInstance;
-    plugins: _farm_js_core.FarmPlugin<undefined, Record<string, never>, unknown, undefined, unknown, false, _farm_js_core.PluginRoutes>[];
+    plugins: _farm_js_core.FarmPlugin<undefined, Record<string, never>, unknown, undefined, unknown, false, (_farm_js_core.RouteDefinition<`/${string}`, "POST", {
+        __types: {
+            body: unknown;
+            inputBody: never;
+            query: never;
+            inputQuery: never;
+            headers: never;
+            inputHeaders: never;
+            response: unknown;
+            errors: never;
+        };
+        __path?: string;
+        __method?: string;
+        __openapi?: _farm_js_core.EndpointOpenAPIMetadata;
+        __mcp?: _farm_js_core.EndpointMCPOptions;
+    } & ((options?: {
+        body?: undefined;
+        query?: undefined;
+        headers?: undefined;
+    } | undefined) => Promise<unknown>) & {
+        __types: {
+            params: {};
+            inputHeaders: never;
+        };
+    }> | _farm_js_core.RouteDefinition<`/${string}`, "GET", {
+        __types: {
+            body: unknown;
+            inputBody: never;
+            query: never;
+            inputQuery: never;
+            headers: never;
+            inputHeaders: never;
+            response: unknown;
+            errors: never;
+        };
+        __path?: string;
+        __method?: string;
+        __openapi?: _farm_js_core.EndpointOpenAPIMetadata;
+        __mcp?: _farm_js_core.EndpointMCPOptions;
+    } & ((options?: {
+        body?: undefined;
+        query?: undefined;
+        headers?: undefined;
+    } | undefined) => Promise<unknown>) & {
+        __types: {
+            params: {};
+            inputHeaders: never;
+        };
+    }> | _farm_js_core.RouteDefinition<`/${string}`, "DELETE", {
+        __types: {
+            body: unknown;
+            inputBody: never;
+            query: never;
+            inputQuery: never;
+            headers: never;
+            inputHeaders: never;
+            response: unknown;
+            errors: never;
+        };
+        __path?: string;
+        __method?: string;
+        __openapi?: _farm_js_core.EndpointOpenAPIMetadata;
+        __mcp?: _farm_js_core.EndpointMCPOptions;
+    } & ((options?: {
+        body?: undefined;
+        query?: undefined;
+        headers?: undefined;
+    } | undefined) => Promise<unknown>) & {
+        __types: {
+            params: {};
+            inputHeaders: never;
+        };
+    }>)[]>[];
 }, _farm_js_core.FarmSchema | undefined>;
 
 export { type AgentInstance, type AgentOptions, agent };

package/dist/index.js

@@ -8,58 +8,108 @@ function registerAgentUnitConfig(config) {
 }
 
 // src/plugin.ts
+import { writeFileSync } from "fs";
 import path from "path";
-import { Readable } from "stream";
 import { fileURLToPath } from "url";
 import { definePlugin } from "@farm.js/core/plugin";
 var loadBuildOnly = (specifier) => import(
   /* @vite-ignore */
   specifier
 );
+var AGENT_SERVER = /* @__PURE__ */ Symbol.for("farm.agent.server");
+var METHODS = ["get", "post", "delete"];
 function isUnder(pathname, basePath) {
   return basePath === "/" || pathname === basePath || pathname.startsWith(`${basePath}/`);
 }
+var SERVER_MODULE = `// Generated by @farm.js/agent. Do not edit.
+import { AsyncLocalStorage } from "node:async_hooks";
+import { getUnit } from "./runtime.mjs";
+
+const hostWaitUntil = new AsyncLocalStorage();
+
+globalThis[Symbol.for("farm.agent.server")] = {
+  handle(request) {
+    const waitUntil = hostWaitUntil.getStore();
+    return getUnit().handler(request, waitUntil ? { waitUntil } : {});
+  },
+};
+
+export default function farmAgentHost(event, next) {
+  const req = event.req;
+  return typeof req.waitUntil === "function"
+    ? hostWaitUntil.run((promise) => req.waitUntil(promise), next)
+    : next();
+}
+`;
+var CRON_GUARD_MODULE = `// Generated by @farm.js/agent. Do not edit.
+import { isCronRequestAuthorized } from "@farm.js/core/cron";
+
+export default function farmAgentCronGuard(event, next) {
+  if (isCronRequestAuthorized(event.req)) return next();
+  return Response.json({ error: "Unauthorized cron request." }, { status: 401 });
+}
+`;
+function guardVercelCron(nitro, dir) {
+  const preset = String(nitro.options.preset ?? "");
+  if (!preset.startsWith("vercel")) return;
+  if (!nitro.options.experimental?.tasks) return;
+  if (Object.keys(nitro.options.scheduledTasks ?? {}).length === 0) return;
+  const route = nitro.options.vercel?.cronHandlerRoute || "/_vercel/cron";
+  const guard = path.posix.join(dir, "farm-cron-guard.mjs");
+  writeFileSync(guard, CRON_GUARD_MODULE);
+  nitro.options.handlers.unshift(
+    { route, handler: guard, middleware: true, lazy: false },
+    { route: `${route}/**`, handler: guard, middleware: true, lazy: false }
+  );
+  if (!process.env.CRON_SECRET) {
+    nitro.logger.warn(
+      `@farm.js/agent: Vercel Cron runs the agent sweep and tasks at ${route}, which rejects every call without CRON_SECRET. Set CRON_SECRET in the Vercel project's environment variables, or the scheduled runs answer 401.`
+    );
+  }
+}
 function createAgentPlugin(config) {
   const { basePath } = config;
   let root;
   let agentsDir = config.agentsDir ?? "agents";
+  let isDev = false;
   let devHandler;
+  const buildConfig = () => ({ ...config, agentsDir });
+  const startDev = () => devHandler ??= loadBuildOnly("agent-unit/build").then(
+    ({ createDevHandler }) => createDevHandler({ root: root ?? process.cwd(), config: buildConfig() })
+  );
   const closeDev = async () => {
     const pending = devHandler;
     devHandler = void 0;
     await (await pending?.catch(() => void 0))?.close();
   };
-  const buildConfig = () => ({ ...config, agentsDir });
-  const devPlugin = {
-    name: "farm:agent-dev",
-    apply: "serve",
-    // Ahead of Farm's API middleware, which answers 404 for API paths it does not route.
-    enforce: "pre",
-    // Vite runs this again on every restart, while the agents keep running in one dev handler.
-    configureServer(server) {
-      devHandler ??= loadBuildOnly("agent-unit/build").then(
-        ({ createDevHandler }) => createDevHandler({ root: root ?? process.cwd(), config: buildConfig() })
+  const handle = async (request) => {
+    if (isDev) return (await startDev()).fetch(request);
+    const server = globalThis[AGENT_SERVER];
+    if (!server) {
+      throw new Error(
+        "@farm.js/agent: this server was built without the agents. Build it with `farm build`, which adds them."
       );
-      const handler = devHandler;
-      server.middlewares.use((req, res, next) => {
-        if (!isUnder((req.url ?? "/").split("?")[0], basePath)) return next();
-        void serveDev(handler, req, res).catch(next);
-      });
     }
+    return server.handle(request);
   };
   return definePlugin({
     name: "farm:agent",
     configure(farmConfig, context) {
       root = path.resolve(farmConfig.root ?? process.cwd());
       agentsDir = config.agentsDir ?? path.posix.join(farmConfig.srcDir ?? "src", "agents");
-      if (!context.isDev) return;
-      const vite = farmConfig.vite ?? {};
-      return { ...farmConfig, vite: { ...vite, plugins: [devPlugin, ...vite.plugins ?? []] } };
+      isDev = context.isDev;
     },
+    // Ordinary API routes, so a request passes Farm's middleware, runtime.before and integration
+    // guards before it reaches the agents, in development and in every production target.
+    routes: ({ route }) => METHODS.flatMap(
+      (method) => [basePath, `${basePath}/[...path]`].map(
+        (pattern) => route[method](pattern, { handler: (request) => handle(request) })
+      )
+    ),
     router: {
       // agent-unit answers every path under basePath, so an app route there would never be reached.
       discovered(route) {
-        if (route.kind !== "api" || !isUnder(route.path, basePath)) return;
+        if (route.kind !== "api" || !route.filePath || !isUnder(route.path, basePath)) return;
         throw new Error(
           `@farm.js/agent: ${route.filePath} is served at ${route.path}, which the agent API owns (basePath "${basePath}"). Move the route, or set another basePath.`
         );
@@ -67,21 +117,49 @@ function createAgentPlugin(config) {
     },
     build: {
       // agent-unit builds the agents into Farm's Nitro output for its preset: their framework
-      // adapters, storage, the sweep and `tasks` as scheduled tasks.
+      // adapters, storage, the sweep and `tasks` as scheduled tasks. Its own handler for basePath
+      // would answer before Farm's, so Farm's routes serve the API instead.
       async configure(nitroConfig) {
         const { agentUnit } = await loadBuildOnly("agent-unit/nitro");
-        const module = agentUnit({
+        const unit = agentUnit({
           root: root ?? process.cwd(),
           basePath,
           config: buildConfig(),
           // The module agent-unit's engine reads its config from in the built server.
           configFile: fileURLToPath(new URL("./config.js", import.meta.url))
         });
+        const module = {
+          name: unit.name,
+          async setup(nitro) {
+            const before = nitro.options.handlers.length;
+            await unit.setup(nitro);
+            const added = nitro.options.handlers.splice(before);
+            const entry = added.find((handler) => handler.handler.endsWith("entry.mjs"))?.handler;
+            if (!entry) {
+              throw new Error(
+                "@farm.js/agent: agent-unit's Nitro module did not mount its handler. Install the agent-unit version @farm.js/agent supports."
+              );
+            }
+            nitro.options.handlers.push(...added.filter((handler) => handler.handler !== entry));
+            const server = path.posix.join(
+              path.posix.dirname(entry.replaceAll("\\", "/")),
+              "farm-server.mjs"
+            );
+            writeFileSync(server, SERVER_MODULE);
+            guardVercelCron(nitro, path.posix.dirname(server));
+            nitro.options.handlers.push(
+              { route: basePath, handler: server, middleware: true, lazy: false },
+              { route: `${basePath}/**`, handler: server, middleware: true, lazy: false }
+            );
+          }
+        };
         return { ...nitroConfig, modules: [...nitroConfig.modules ?? [], module] };
       }
     },
     dev: {
       server(_viteServer, { lifecycle }) {
+        void startDev().catch(() => {
+        });
         lifecycle.onShutdown(closeDev);
       }
     },
@@ -90,33 +168,6 @@ function createAgentPlugin(config) {
     }
   });
 }
-async function serveDev(handler, req, res) {
-  const { sendWebResponse } = await loadBuildOnly("@farm.js/core/server");
-  const response = await (await handler).fetch(toWebRequest(req, res));
-  await sendWebResponse(res, response);
-}
-function toWebRequest(req, res) {
-  const protocol = req.socket.encrypted ? "https" : "http";
-  const url = new URL(req.url ?? "/", `${protocol}://${req.headers.host ?? "localhost"}`);
-  const headers = new Headers();
-  for (let index = 0; index < req.rawHeaders.length; index += 2) {
-    const name = req.rawHeaders[index];
-    if (!name.startsWith(":")) headers.append(name, req.rawHeaders[index + 1]);
-  }
-  const controller = new AbortController();
-  res.once("close", () => {
-    if (!res.writableFinished) controller.abort();
-  });
-  const method = req.method ?? "GET";
-  const hasBody = method !== "GET" && method !== "HEAD";
-  return new Request(url, {
-    method,
-    headers,
-    signal: controller.signal,
-    body: hasBody ? Readable.toWeb(req) : void 0,
-    ...hasBody ? { duplex: "half" } : {}
-  });
-}
 
 // src/index.ts
 var DEFAULT_BASE_PATH = "/api/agent";
@@ -124,7 +175,11 @@ function normalizeBasePath(value) {
   if (!value.startsWith("/")) {
     throw new Error(`@farm.js/agent: basePath must start with "/", got "${value}".`);
   }
-  return value.replace(/\/+$/, "") || "/";
+  const basePath = value.replace(/\/+$/, "");
+  if (basePath !== "/api" && !basePath.startsWith("/api/")) {
+    throw new Error(`@farm.js/agent: basePath must be under /api, got "${value}".`);
+  }
+  return basePath;
 }
 function agent(options = {}) {
   const basePath = normalizeBasePath(options.basePath ?? DEFAULT_BASE_PATH);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/plugin.ts"],"sourcesContent":["import { defineIntegration } from \"@farm.js/core\";\nimport type { AgentFramework, AgentUnitConfig } from \"agent-unit\";\n\nimport { registerAgentUnitConfig } from \"./config.js\";\nimport { createAgentPlugin } from \"./plugin.js\";\n\nexport type { AgentFramework };\n\n/**\n * agent-unit's settings, minus what Farm owns: the host (`deploy.target`), the server and the\n * Nitro and Workers settings, which belong in farm.config.\n */\nexport interface AgentOptions extends Omit<\n  AgentUnitConfig,\n  \"server\" | \"preset\" | \"runtime\" | \"cloudflare\" | \"nitro\"\n> {\n  /** Where the agent API is mounted. It owns every path under it. Default `/api/agent`. */\n  basePath?: string;\n  /** The folder of agent files, relative to the app root. Default `agents` in `srcDir`. */\n  agentsDir?: string;\n}\n\nexport interface AgentInstance {\n  readonly basePath: string;\n  readonly framework?: AgentFramework;\n}\n\nconst DEFAULT_BASE_PATH = \"/api/agent\";\n\nfunction normalizeBasePath(value: string): string {\n  if (!value.startsWith(\"/\")) {\n    throw new Error(`@farm.js/agent: basePath must start with \"/\", got \"${value}\".`);\n  }\n  return value.replace(/\\/+$/, \"\") || \"/\";\n}\n\n/**\n * Durable agents in a Farm app: the agents in `src/agents`, written with the AI SDK, Mastra,\n * LangGraph, the OpenAI Agents SDK or agent-unit's `defineAgent`, served under `basePath` in\n * `farm dev` and built by agent-unit into every deployment target.\n *\n * @example\n * integrations: { agent: agent({ framework: \"ai-sdk\", storage: { driver: \"redis\", url: process.env.REDIS_URL } }) }\n */\nexport function agent(options: AgentOptions = {}) {\n  const basePath = normalizeBasePath(options.basePath ?? DEFAULT_BASE_PATH);\n  const config: AgentUnitConfig & { basePath: string } = { ...options, basePath };\n  const instance: AgentInstance = { basePath, framework: options.framework };\n  // agent-unit's engine reads it from the server that evaluates farm.config (see ./config).\n  registerAgentUnitConfig(config);\n\n  return defineIntegration({\n    category: \"agent\",\n    type: \"agent-unit\",\n    instance,\n    plugins: [createAgentPlugin(config)],\n  });\n}\n","import type { AgentUnitConfig } from \"agent-unit\";\n\nconst AGENT_UNIT_CONFIG = Symbol.for(\"farm.agent.config\");\n\ntype ConfigHolder = { [AGENT_UNIT_CONFIG]?: AgentUnitConfig };\n\n/** @internal Called by `agent()` as farm.config evaluates, in Farm's process and in the server. */\nexport function registerAgentUnitConfig(config: AgentUnitConfig): void {\n  (globalThis as ConfigHolder)[AGENT_UNIT_CONFIG] = config;\n}\n\n/**\n * The agent-unit config of the app's `agent()` integration. agent-unit's engine reads it when it is\n * first used: by then Farm's server has evaluated farm.config, so settings such as storage URLs and\n * `authorize` come from where the server runs.\n */\nexport default function agentUnitConfig(): AgentUnitConfig {\n  const config = (globalThis as ConfigHolder)[AGENT_UNIT_CONFIG];\n  if (!config) {\n    throw new Error(\n      \"@farm.js/agent: the server has not evaluated farm.config, so the agent() settings are missing. Mount agent() under `integrations` in farm.config.\",\n    );\n  }\n  return config;\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport path from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport type { TLSSocket } from \"node:tls\";\nimport { fileURLToPath } from \"node:url\";\nimport { definePlugin } from \"@farm.js/core/plugin\";\nimport type { AgentUnitConfig } from \"agent-unit\";\nimport type { DevHandler } from \"agent-unit/build\";\nimport type { Plugin as VitePlugin } from \"vite\";\n\n// agent-unit's build and dev servers load only in Farm's own process. Farm bundles farm.config into\n// the production server, and a bundler follows literal imports, so these must not be literal.\nconst loadBuildOnly = <T>(specifier: string): Promise<T> => import(/* @vite-ignore */ specifier);\n\nexport function isUnder(pathname: string, basePath: string): boolean {\n  return basePath === \"/\" || pathname === basePath || pathname.startsWith(`${basePath}/`);\n}\n\n/** Serves the agents in `farm dev` and builds them into the production server. */\nexport function createAgentPlugin(config: AgentUnitConfig & { basePath: string }) {\n  const { basePath } = config;\n  // Set by `configure`, in Farm's process: farm.config also evaluates inside the server, where a\n  // Worker has no working directory.\n  let root: string | undefined;\n  let agentsDir = config.agentsDir ?? \"agents\";\n  let devHandler: Promise<DevHandler> | undefined;\n\n  const closeDev = async () => {\n    const pending = devHandler;\n    devHandler = undefined;\n    await (await pending?.catch(() => undefined))?.close();\n  };\n  const buildConfig = (): AgentUnitConfig => ({ ...config, agentsDir });\n\n  const devPlugin: VitePlugin = {\n    name: \"farm:agent-dev\",\n    apply: \"serve\",\n    // Ahead of Farm's API middleware, which answers 404 for API paths it does not route.\n    enforce: \"pre\",\n    // Vite runs this again on every restart, while the agents keep running in one dev handler.\n    configureServer(server) {\n      devHandler ??= loadBuildOnly<typeof import(\"agent-unit/build\")>(\"agent-unit/build\").then(\n        ({ createDevHandler }) =>\n          createDevHandler({ root: root ?? process.cwd(), config: buildConfig() }),\n      );\n      const handler = devHandler;\n      server.middlewares.use((req, res, next) => {\n        if (!isUnder((req.url ?? \"/\").split(\"?\")[0]!, basePath)) return next();\n        void serveDev(handler, req, res).catch(next);\n      });\n    },\n  };\n\n  return definePlugin({\n    name: \"farm:agent\",\n    configure(farmConfig, context) {\n      root = path.resolve(farmConfig.root ?? process.cwd());\n      agentsDir = config.agentsDir ?? path.posix.join(farmConfig.srcDir ?? \"src\", \"agents\");\n      if (!context.isDev) return;\n      const vite = farmConfig.vite ?? {};\n      return { ...farmConfig, vite: { ...vite, plugins: [devPlugin, ...(vite.plugins ?? [])] } };\n    },\n    router: {\n      // agent-unit answers every path under basePath, so an app route there would never be reached.\n      discovered(route) {\n        if (route.kind !== \"api\" || !isUnder(route.path, basePath)) return;\n        throw new Error(\n          `@farm.js/agent: ${route.filePath} is served at ${route.path}, which the agent API owns (basePath \"${basePath}\"). Move the route, or set another basePath.`,\n        );\n      },\n    },\n    build: {\n      // agent-unit builds the agents into Farm's Nitro output for its preset: their framework\n      // adapters, storage, the sweep and `tasks` as scheduled tasks.\n      async configure(nitroConfig) {\n        const { agentUnit } =\n          await loadBuildOnly<typeof import(\"agent-unit/nitro\")>(\"agent-unit/nitro\");\n        const module = agentUnit({\n          root: root ?? process.cwd(),\n          basePath,\n          config: buildConfig(),\n          // The module agent-unit's engine reads its config from in the built server.\n          configFile: fileURLToPath(new URL(\"./config.js\", import.meta.url)),\n        });\n        return { ...nitroConfig, modules: [...(nitroConfig.modules ?? []), module] };\n      },\n    },\n    dev: {\n      server(_viteServer, { lifecycle }) {\n        lifecycle.onShutdown(closeDev);\n      },\n    },\n    runtime: {\n      close: closeDev,\n    },\n  });\n}\n\nasync function serveDev(\n  handler: Promise<DevHandler>,\n  req: IncomingMessage,\n  res: ServerResponse,\n): Promise<void> {\n  const { sendWebResponse } =\n    await loadBuildOnly<typeof import(\"@farm.js/core/server\")>(\"@farm.js/core/server\");\n  const response = await (await handler).fetch(toWebRequest(req, res));\n  await sendWebResponse(res, response);\n}\n\nfunction toWebRequest(req: IncomingMessage, res: ServerResponse): Request {\n  const protocol = (req.socket as TLSSocket).encrypted ? \"https\" : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${req.headers.host ?? \"localhost\"}`);\n  const headers = new Headers();\n  for (let index = 0; index < req.rawHeaders.length; index += 2) {\n    const name = req.rawHeaders[index]!;\n    if (!name.startsWith(\":\")) headers.append(name, req.rawHeaders[index + 1]!);\n  }\n  // A client that leaves an event stream ends the run's subscription, not the run.\n  const controller = new AbortController();\n  res.once(\"close\", () => {\n    if (!res.writableFinished) controller.abort();\n  });\n  const method = req.method ?? \"GET\";\n  const hasBody = method !== \"GET\" && method !== \"HEAD\";\n  return new Request(url, {\n    method,\n    headers,\n    signal: controller.signal,\n    body: hasBody ? (Readable.toWeb(req) as ReadableStream<Uint8Array>) : undefined,\n    ...(hasBody ? { duplex: \"half\" } : {}),\n  } as RequestInit);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/plugin.ts"],"sourcesContent":["import { defineIntegration } from \"@farm.js/core\";\nimport type { AgentFramework, AgentUnitConfig } from \"agent-unit\";\n\nimport { registerAgentUnitConfig } from \"./config.js\";\nimport { createAgentPlugin } from \"./plugin.js\";\n\nexport type { AgentFramework };\n\n/**\n * agent-unit's settings, minus what Farm owns: the host (`deploy.target`), the server and the\n * Nitro and Workers settings, which belong in farm.config.\n */\nexport interface AgentOptions extends Omit<\n  AgentUnitConfig,\n  \"server\" | \"preset\" | \"runtime\" | \"cloudflare\" | \"nitro\"\n> {\n  /** Where the agent API is mounted, under `/api`. It owns every path under it. Default `/api/agent`. */\n  basePath?: string;\n  /** The folder of agent files, relative to the app root. Default `agents` in `srcDir`. */\n  agentsDir?: string;\n}\n\nexport interface AgentInstance {\n  readonly basePath: string;\n  readonly framework?: AgentFramework;\n}\n\nconst DEFAULT_BASE_PATH = \"/api/agent\";\n\nfunction normalizeBasePath(value: string): string {\n  if (!value.startsWith(\"/\")) {\n    throw new Error(`@farm.js/agent: basePath must start with \"/\", got \"${value}\".`);\n  }\n  const basePath = value.replace(/\\/+$/, \"\");\n  // The agents are API routes, so Farm's middleware and guards run for them.\n  if (basePath !== \"/api\" && !basePath.startsWith(\"/api/\")) {\n    throw new Error(`@farm.js/agent: basePath must be under /api, got \"${value}\".`);\n  }\n  return basePath;\n}\n\n/**\n * Durable agents in a Farm app: the agents in `src/agents`, written with the AI SDK, Mastra,\n * LangGraph, the OpenAI Agents SDK or agent-unit's `defineAgent`, served under `basePath` in\n * `farm dev` and built by agent-unit into every deployment target.\n *\n * @example\n * integrations: { agent: agent({ framework: \"ai-sdk\", storage: { driver: \"redis\", url: process.env.REDIS_URL } }) }\n */\nexport function agent(options: AgentOptions = {}) {\n  const basePath = normalizeBasePath(options.basePath ?? DEFAULT_BASE_PATH);\n  const config: AgentUnitConfig & { basePath: string } = { ...options, basePath };\n  const instance: AgentInstance = { basePath, framework: options.framework };\n  // agent-unit's engine reads it from the server that evaluates farm.config (see ./config).\n  registerAgentUnitConfig(config);\n\n  return defineIntegration({\n    category: \"agent\",\n    type: \"agent-unit\",\n    instance,\n    plugins: [createAgentPlugin(config)],\n  });\n}\n","import type { AgentUnitConfig } from \"agent-unit\";\n\nconst AGENT_UNIT_CONFIG = Symbol.for(\"farm.agent.config\");\n\ntype ConfigHolder = { [AGENT_UNIT_CONFIG]?: AgentUnitConfig };\n\n/** @internal Called by `agent()` as farm.config evaluates, in Farm's process and in the server. */\nexport function registerAgentUnitConfig(config: AgentUnitConfig): void {\n  (globalThis as ConfigHolder)[AGENT_UNIT_CONFIG] = config;\n}\n\n/**\n * The agent-unit config of the app's `agent()` integration. agent-unit's engine reads it when it is\n * first used: by then Farm's server has evaluated farm.config, so settings such as storage URLs and\n * `authorize` come from where the server runs.\n */\nexport default function agentUnitConfig(): AgentUnitConfig {\n  const config = (globalThis as ConfigHolder)[AGENT_UNIT_CONFIG];\n  if (!config) {\n    throw new Error(\n      \"@farm.js/agent: the server has not evaluated farm.config, so the agent() settings are missing. Mount agent() under `integrations` in farm.config.\",\n    );\n  }\n  return config;\n}\n","import { writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { definePlugin } from \"@farm.js/core/plugin\";\nimport type { AgentUnitConfig } from \"agent-unit\";\nimport type { DevHandler } from \"agent-unit/build\";\nimport type { agentUnit } from \"agent-unit/nitro\";\n\ntype Nitro = Parameters<NonNullable<ReturnType<typeof agentUnit>[\"setup\"]>>[0];\n\n// agent-unit's build and dev servers load only in Farm's own process. Farm bundles farm.config into\n// the production server, and a bundler follows literal imports, so these must not be literal.\nconst loadBuildOnly = <T>(specifier: string): Promise<T> => import(/* @vite-ignore */ specifier);\n\n/** Set by the built server's agent module (see SERVER_MODULE): agent-unit's engine. */\nconst AGENT_SERVER = Symbol.for(\"farm.agent.server\");\ntype AgentServer = { handle(request: Request): Promise<Response> };\ntype ServerHolder = { [AGENT_SERVER]?: AgentServer };\n\n// Every method agent-unit answers: the run API, MCP and the internal continue and sweep endpoints.\nconst METHODS = [\"get\", \"post\", \"delete\"] as const;\n\nexport function isUnder(pathname: string, basePath: string): boolean {\n  return basePath === \"/\" || pathname === basePath || pathname.startsWith(`${basePath}/`);\n}\n\n// The built server's agent module, next to agent-unit's runtime. It hands the engine to the routes\n// below, and as Nitro middleware on the agent paths it passes on the host's waitUntil, which only\n// hosts that keep work alive after the response have, as agent-unit's own entry does.\nconst SERVER_MODULE = `// Generated by @farm.js/agent. Do not edit.\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport { getUnit } from \"./runtime.mjs\";\n\nconst hostWaitUntil = new AsyncLocalStorage();\n\nglobalThis[Symbol.for(\"farm.agent.server\")] = {\n  handle(request) {\n    const waitUntil = hostWaitUntil.getStore();\n    return getUnit().handler(request, waitUntil ? { waitUntil } : {});\n  },\n};\n\nexport default function farmAgentHost(event, next) {\n  const req = event.req;\n  return typeof req.waitUntil === \"function\"\n    ? hostWaitUntil.run((promise) => req.waitUntil(promise), next)\n    : next();\n}\n`;\n\n// Nitro's Vercel preset runs scheduled tasks from a public cron route that checks CRON_SECRET only\n// when it is set. As Nitro middleware on that route, this module rejects every call without the\n// secret, the way Farm's own cron routes do.\nconst CRON_GUARD_MODULE = `// Generated by @farm.js/agent. Do not edit.\nimport { isCronRequestAuthorized } from \"@farm.js/core/cron\";\n\nexport default function farmAgentCronGuard(event, next) {\n  if (isCronRequestAuthorized(event.req)) return next();\n  return Response.json({ error: \"Unauthorized cron request.\" }, { status: 401 });\n}\n`;\n\n/** Guards Nitro's Vercel cron route when agent-unit has scheduled the sweep or the app's tasks. */\nfunction guardVercelCron(nitro: Nitro, dir: string): void {\n  const preset = String(nitro.options.preset ?? \"\");\n  if (!preset.startsWith(\"vercel\")) return;\n  if (!nitro.options.experimental?.tasks) return;\n  if (Object.keys(nitro.options.scheduledTasks ?? {}).length === 0) return;\n\n  const route = nitro.options.vercel?.cronHandlerRoute || \"/_vercel/cron\";\n  const guard = path.posix.join(dir, \"farm-cron-guard.mjs\");\n  writeFileSync(guard, CRON_GUARD_MODULE);\n  nitro.options.handlers.unshift(\n    { route, handler: guard, middleware: true, lazy: false },\n    { route: `${route}/**`, handler: guard, middleware: true, lazy: false },\n  );\n  if (!process.env.CRON_SECRET) {\n    nitro.logger.warn(\n      `@farm.js/agent: Vercel Cron runs the agent sweep and tasks at ${route}, which rejects every call without CRON_SECRET. Set CRON_SECRET in the Vercel project's environment variables, or the scheduled runs answer 401.`,\n    );\n  }\n}\n\n/**\n * Serves the agents in `farm dev` and builds them into the production server, as API routes under\n * `basePath`: Farm's middleware, plugin guards and integration guards run for them as for any route.\n */\nexport function createAgentPlugin(config: AgentUnitConfig & { basePath: string }) {\n  const { basePath } = config;\n  // Set by `configure`, in Farm's process: farm.config also evaluates inside the server, where a\n  // Worker has no working directory.\n  let root: string | undefined;\n  let agentsDir = config.agentsDir ?? \"agents\";\n  let isDev = false;\n  let devHandler: Promise<DevHandler> | undefined;\n\n  const buildConfig = (): AgentUnitConfig => ({ ...config, agentsDir });\n  const startDev = () =>\n    (devHandler ??= loadBuildOnly<typeof import(\"agent-unit/build\")>(\"agent-unit/build\").then(\n      ({ createDevHandler }) =>\n        createDevHandler({ root: root ?? process.cwd(), config: buildConfig() }),\n    ));\n  const closeDev = async () => {\n    const pending = devHandler;\n    devHandler = undefined;\n    await (await pending?.catch(() => undefined))?.close();\n  };\n\n  const handle = async (request: Request): Promise<Response> => {\n    // A dev server runs the agents from source, kept across Vite restarts.\n    if (isDev) return (await startDev()).fetch(request);\n    const server = (globalThis as ServerHolder)[AGENT_SERVER];\n    if (!server) {\n      throw new Error(\n        \"@farm.js/agent: this server was built without the agents. Build it with `farm build`, which adds them.\",\n      );\n    }\n    return server.handle(request);\n  };\n\n  return definePlugin({\n    name: \"farm:agent\",\n    configure(farmConfig, context) {\n      root = path.resolve(farmConfig.root ?? process.cwd());\n      agentsDir = config.agentsDir ?? path.posix.join(farmConfig.srcDir ?? \"src\", \"agents\");\n      isDev = context.isDev;\n    },\n    // Ordinary API routes, so a request passes Farm's middleware, runtime.before and integration\n    // guards before it reaches the agents, in development and in every production target.\n    routes: ({ route }) =>\n      METHODS.flatMap((method) =>\n        [basePath, `${basePath}/[...path]`].map((pattern) =>\n          route[method](pattern, { handler: (request) => handle(request) }),\n        ),\n      ),\n    router: {\n      // agent-unit answers every path under basePath, so an app route there would never be reached.\n      discovered(route) {\n        if (route.kind !== \"api\" || !route.filePath || !isUnder(route.path, basePath)) return;\n        throw new Error(\n          `@farm.js/agent: ${route.filePath} is served at ${route.path}, which the agent API owns (basePath \"${basePath}\"). Move the route, or set another basePath.`,\n        );\n      },\n    },\n    build: {\n      // agent-unit builds the agents into Farm's Nitro output for its preset: their framework\n      // adapters, storage, the sweep and `tasks` as scheduled tasks. Its own handler for basePath\n      // would answer before Farm's, so Farm's routes serve the API instead.\n      async configure(nitroConfig) {\n        const { agentUnit } =\n          await loadBuildOnly<typeof import(\"agent-unit/nitro\")>(\"agent-unit/nitro\");\n        const unit = agentUnit({\n          root: root ?? process.cwd(),\n          basePath,\n          config: buildConfig(),\n          // The module agent-unit's engine reads its config from in the built server.\n          configFile: fileURLToPath(new URL(\"./config.js\", import.meta.url)),\n        });\n        const module: typeof unit = {\n          name: unit.name,\n          async setup(nitro) {\n            const before = nitro.options.handlers.length;\n            await unit.setup!(nitro);\n            const added = nitro.options.handlers.splice(before);\n            const entry = added.find((handler) => handler.handler.endsWith(\"entry.mjs\"))?.handler;\n            if (!entry) {\n              throw new Error(\n                \"@farm.js/agent: agent-unit's Nitro module did not mount its handler. Install the agent-unit version @farm.js/agent supports.\",\n              );\n            }\n            nitro.options.handlers.push(...added.filter((handler) => handler.handler !== entry));\n            // Nitro writes handler paths into generated imports, so keep them in forward-slash\n            // form; a Windows `D:\\…` path would lose its backslashes there.\n            const server = path.posix.join(\n              path.posix.dirname(entry.replaceAll(\"\\\\\", \"/\")),\n              \"farm-server.mjs\",\n            );\n            writeFileSync(server, SERVER_MODULE);\n            guardVercelCron(nitro, path.posix.dirname(server));\n            nitro.options.handlers.push(\n              { route: basePath, handler: server, middleware: true, lazy: false },\n              { route: `${basePath}/**`, handler: server, middleware: true, lazy: false },\n            );\n          },\n        };\n        return { ...nitroConfig, modules: [...(nitroConfig.modules ?? []), module] };\n      },\n    },\n    dev: {\n      server(_viteServer, { lifecycle }) {\n        void startDev().catch(() => {});\n        lifecycle.onShutdown(closeDev);\n      },\n    },\n    runtime: {\n      close: closeDev,\n    },\n  });\n}\n"],"mappings":";AAAA,SAAS,yBAAyB;;;ACElC,IAAM,oBAAoB,uBAAO,IAAI,mBAAmB;AAKjD,SAAS,wBAAwB,QAA+B;AACrE,EAAC,WAA4B,iBAAiB,IAAI;AACpD;;;ACTA,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAS7B,IAAM,gBAAgB,CAAI,cAAkC;AAAA;AAAA,EAA0B;AAAA;AAGtF,IAAM,eAAe,uBAAO,IAAI,mBAAmB;AAKnD,IAAM,UAAU,CAAC,OAAO,QAAQ,QAAQ;AAEjC,SAAS,QAAQ,UAAkB,UAA2B;AACnE,SAAO,aAAa,OAAO,aAAa,YAAY,SAAS,WAAW,GAAG,QAAQ,GAAG;AACxF;AAKA,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBtB,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAU1B,SAAS,gBAAgB,OAAc,KAAmB;AACxD,QAAM,SAAS,OAAO,MAAM,QAAQ,UAAU,EAAE;AAChD,MAAI,CAAC,OAAO,WAAW,QAAQ,EAAG;AAClC,MAAI,CAAC,MAAM,QAAQ,cAAc,MAAO;AACxC,MAAI,OAAO,KAAK,MAAM,QAAQ,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAG;AAElE,QAAM,QAAQ,MAAM,QAAQ,QAAQ,oBAAoB;AACxD,QAAM,QAAQ,KAAK,MAAM,KAAK,KAAK,qBAAqB;AACxD,gBAAc,OAAO,iBAAiB;AACtC,QAAM,QAAQ,SAAS;AAAA,IACrB,EAAE,OAAO,SAAS,OAAO,YAAY,MAAM,MAAM,MAAM;AAAA,IACvD,EAAE,OAAO,GAAG,KAAK,OAAO,SAAS,OAAO,YAAY,MAAM,MAAM,MAAM;AAAA,EACxE;AACA,MAAI,CAAC,QAAQ,IAAI,aAAa;AAC5B,UAAM,OAAO;AAAA,MACX,iEAAiE,KAAK;AAAA,IACxE;AAAA,EACF;AACF;AAMO,SAAS,kBAAkB,QAAgD;AAChF,QAAM,EAAE,SAAS,IAAI;AAGrB,MAAI;AACJ,MAAI,YAAY,OAAO,aAAa;AACpC,MAAI,QAAQ;AACZ,MAAI;AAEJ,QAAM,cAAc,OAAwB,EAAE,GAAG,QAAQ,UAAU;AACnE,QAAM,WAAW,MACd,eAAe,cAAiD,kBAAkB,EAAE;AAAA,IACnF,CAAC,EAAE,iBAAiB,MAClB,iBAAiB,EAAE,MAAM,QAAQ,QAAQ,IAAI,GAAG,QAAQ,YAAY,EAAE,CAAC;AAAA,EAC3E;AACF,QAAM,WAAW,YAAY;AAC3B,UAAM,UAAU;AAChB,iBAAa;AACb,WAAO,MAAM,SAAS,MAAM,MAAM,MAAS,IAAI,MAAM;AAAA,EACvD;AAEA,QAAM,SAAS,OAAO,YAAwC;AAE5D,QAAI,MAAO,SAAQ,MAAM,SAAS,GAAG,MAAM,OAAO;AAClD,UAAM,SAAU,WAA4B,YAAY;AACxD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,WAAO,OAAO,OAAO,OAAO;AAAA,EAC9B;AAEA,SAAO,aAAa;AAAA,IAClB,MAAM;AAAA,IACN,UAAU,YAAY,SAAS;AAC7B,aAAO,KAAK,QAAQ,WAAW,QAAQ,QAAQ,IAAI,CAAC;AACpD,kBAAY,OAAO,aAAa,KAAK,MAAM,KAAK,WAAW,UAAU,OAAO,QAAQ;AACpF,cAAQ,QAAQ;AAAA,IAClB;AAAA;AAAA;AAAA,IAGA,QAAQ,CAAC,EAAE,MAAM,MACf,QAAQ;AAAA,MAAQ,CAAC,WACf,CAAC,UAAU,GAAG,QAAQ,YAAY,EAAE;AAAA,QAAI,CAAC,YACvC,MAAM,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,YAAY,OAAO,OAAO,EAAE,CAAC;AAAA,MAClE;AAAA,IACF;AAAA,IACF,QAAQ;AAAA;AAAA,MAEN,WAAW,OAAO;AAChB,YAAI,MAAM,SAAS,SAAS,CAAC,MAAM,YAAY,CAAC,QAAQ,MAAM,MAAM,QAAQ,EAAG;AAC/E,cAAM,IAAI;AAAA,UACR,mBAAmB,MAAM,QAAQ,iBAAiB,MAAM,IAAI,yCAAyC,QAAQ;AAAA,QAC/G;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO;AAAA;AAAA;AAAA;AAAA,MAIL,MAAM,UAAU,aAAa;AAC3B,cAAM,EAAE,UAAU,IAChB,MAAM,cAAiD,kBAAkB;AAC3E,cAAM,OAAO,UAAU;AAAA,UACrB,MAAM,QAAQ,QAAQ,IAAI;AAAA,UAC1B;AAAA,UACA,QAAQ,YAAY;AAAA;AAAA,UAEpB,YAAY,cAAc,IAAI,IAAI,eAAe,YAAY,GAAG,CAAC;AAAA,QACnE,CAAC;AACD,cAAM,SAAsB;AAAA,UAC1B,MAAM,KAAK;AAAA,UACX,MAAM,MAAM,OAAO;AACjB,kBAAM,SAAS,MAAM,QAAQ,SAAS;AACtC,kBAAM,KAAK,MAAO,KAAK;AACvB,kBAAM,QAAQ,MAAM,QAAQ,SAAS,OAAO,MAAM;AAClD,kBAAM,QAAQ,MAAM,KAAK,CAAC,YAAY,QAAQ,QAAQ,SAAS,WAAW,CAAC,GAAG;AAC9E,gBAAI,CAAC,OAAO;AACV,oBAAM,IAAI;AAAA,gBACR;AAAA,cACF;AAAA,YACF;AACA,kBAAM,QAAQ,SAAS,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,QAAQ,YAAY,KAAK,CAAC;AAGnF,kBAAM,SAAS,KAAK,MAAM;AAAA,cACxB,KAAK,MAAM,QAAQ,MAAM,WAAW,MAAM,GAAG,CAAC;AAAA,cAC9C;AAAA,YACF;AACA,0BAAc,QAAQ,aAAa;AACnC,4BAAgB,OAAO,KAAK,MAAM,QAAQ,MAAM,CAAC;AACjD,kBAAM,QAAQ,SAAS;AAAA,cACrB,EAAE,OAAO,UAAU,SAAS,QAAQ,YAAY,MAAM,MAAM,MAAM;AAAA,cAClE,EAAE,OAAO,GAAG,QAAQ,OAAO,SAAS,QAAQ,YAAY,MAAM,MAAM,MAAM;AAAA,YAC5E;AAAA,UACF;AAAA,QACF;AACA,eAAO,EAAE,GAAG,aAAa,SAAS,CAAC,GAAI,YAAY,WAAW,CAAC,GAAI,MAAM,EAAE;AAAA,MAC7E;AAAA,IACF;AAAA,IACA,KAAK;AAAA,MACH,OAAO,aAAa,EAAE,UAAU,GAAG;AACjC,aAAK,SAAS,EAAE,MAAM,MAAM;AAAA,QAAC,CAAC;AAC9B,kBAAU,WAAW,QAAQ;AAAA,MAC/B;AAAA,IACF;AAAA,IACA,SAAS;AAAA,MACP,OAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;;;AF3KA,IAAM,oBAAoB;AAE1B,SAAS,kBAAkB,OAAuB;AAChD,MAAI,CAAC,MAAM,WAAW,GAAG,GAAG;AAC1B,UAAM,IAAI,MAAM,sDAAsD,KAAK,IAAI;AAAA,EACjF;AACA,QAAM,WAAW,MAAM,QAAQ,QAAQ,EAAE;AAEzC,MAAI,aAAa,UAAU,CAAC,SAAS,WAAW,OAAO,GAAG;AACxD,UAAM,IAAI,MAAM,qDAAqD,KAAK,IAAI;AAAA,EAChF;AACA,SAAO;AACT;AAUO,SAAS,MAAM,UAAwB,CAAC,GAAG;AAChD,QAAM,WAAW,kBAAkB,QAAQ,YAAY,iBAAiB;AACxE,QAAM,SAAiD,EAAE,GAAG,SAAS,SAAS;AAC9E,QAAM,WAA0B,EAAE,UAAU,WAAW,QAAQ,UAAU;AAEzE,0BAAwB,MAAM;AAE9B,SAAO,kBAAkB;AAAA,IACvB,UAAU;AAAA,IACV,MAAM;AAAA,IACN;AAAA,IACA,SAAS,CAAC,kBAAkB,MAAM,CAAC;AAAA,EACrC,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/agent",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.2",
   "description": "Durable agents for Farm.js, served and built by agent-unit",
   "keywords": [
     "agent-unit",
@@ -44,10 +44,10 @@
     "typescript": "^5.3.3",
     "vite": "8.3.4",
     "vitest": "5.0.5",
-    "@farm.js/core": "0.1.48"
+    "@farm.js/core": "0.1.51-beta.2"
   },
   "peerDependencies": {
-    "@farm.js/core": ">=0.1.48 <0.2.0"
+    "@farm.js/core": ">=0.1.50 <0.2.0"
   },
   "engines": {
     "node": ">=22.13.0"