@farm.js/agent 0.0.0-stage → 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Farm.js Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @farm.js/agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Durable agents for Farm.js, served and built by [agent-unit](https://github.com/farming-labs/agent-unit)
+
+See [Stability and Support](https://farmjs.dev/docs/stability) for what this package guarantees.
+
+```bash
+npm install @farm.js/agent agent-unit
+```
+
+```ts
+// farm.config.ts
+import { agent } from "@farm.js/agent";
+import { defineConfig } from "@farm.js/core";
+
+export default defineConfig({
+  integrations: {
+    agent: agent({ storage: { driver: "redis", url: process.env.REDIS_URL } }),
+  },
+});
+```
+
+See the [durable agents guide](https://farmjs.dev/docs/integrations/agent) for agents, the API, storage, and deploy targets.

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import { AgentUnitConfig } from 'agent-unit';
+
+/** @internal Called by `agent()` as farm.config evaluates, in Farm's process and in the server. */
+declare function registerAgentUnitConfig(config: AgentUnitConfig): void;
+/**
+ * The agent-unit config of the app's `agent()` integration. agent-unit's engine reads it when it is
+ * first used: by then Farm's server has evaluated farm.config, so settings such as storage URLs and
+ * `authorize` come from where the server runs.
+ */
+declare function agentUnitConfig(): AgentUnitConfig;
+
+export { agentUnitConfig as default, registerAgentUnitConfig };

package/dist/config.js

@@ -0,0 +1,19 @@
+// src/config.ts
+var AGENT_UNIT_CONFIG = /* @__PURE__ */ Symbol.for("farm.agent.config");
+function registerAgentUnitConfig(config) {
+  globalThis[AGENT_UNIT_CONFIG] = config;
+}
+function agentUnitConfig() {
+  const config = globalThis[AGENT_UNIT_CONFIG];
+  if (!config) {
+    throw new Error(
+      "@farm.js/agent: the server has not evaluated farm.config, so the agent() settings are missing. Mount agent() under `integrations` in farm.config."
+    );
+  }
+  return config;
+}
+export {
+  agentUnitConfig as default,
+  registerAgentUnitConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["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"],"mappings":";AAEA,IAAM,oBAAoB,uBAAO,IAAI,mBAAmB;AAKjD,SAAS,wBAAwB,QAA+B;AACrE,EAAC,WAA4B,iBAAiB,IAAI;AACpD;AAOe,SAAR,kBAAoD;AACzD,QAAM,SAAU,WAA4B,iBAAiB;AAC7D,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import * as _farm_js_core from '@farm.js/core';
+import { AgentFramework, AgentUnitConfig } from 'agent-unit';
+export { AgentFramework } from 'agent-unit';
+
+/**
+ * agent-unit's settings, minus what Farm owns: the host (`deploy.target`), the server and the
+ * 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, 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;
+}
+interface AgentInstance {
+    readonly basePath: string;
+    readonly framework?: AgentFramework;
+}
+/**
+ * Durable agents in a Farm app: the agents in `src/agents`, written with the AI SDK, Mastra,
+ * LangGraph, the OpenAI Agents SDK or agent-unit's `defineAgent`, served under `basePath` in
+ * `farm dev` and built by agent-unit into every deployment target.
+ *
+ * @example
+ * integrations: { agent: agent({ framework: "ai-sdk", storage: { driver: "redis", url: process.env.REDIS_URL } }) }
+ */
+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.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

@@ -0,0 +1,172 @@
+// src/index.ts
+import { defineIntegration } from "@farm.js/core";
+
+// src/config.ts
+var AGENT_UNIT_CONFIG = /* @__PURE__ */ Symbol.for("farm.agent.config");
+function registerAgentUnitConfig(config) {
+  globalThis[AGENT_UNIT_CONFIG] = config;
+}
+
+// src/plugin.ts
+import { writeFileSync } from "fs";
+import path from "path";
+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();
+}
+`;
+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 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."
+      );
+    }
+    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");
+      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" || !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.`
+        );
+      }
+    },
+    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. 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 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);
+            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);
+      }
+    },
+    runtime: {
+      close: closeDev
+    }
+  });
+}
+
+// src/index.ts
+var DEFAULT_BASE_PATH = "/api/agent";
+function normalizeBasePath(value) {
+  if (!value.startsWith("/")) {
+    throw new Error(`@farm.js/agent: basePath must start with "/", got "${value}".`);
+  }
+  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);
+  const config = { ...options, basePath };
+  const instance = { basePath, framework: options.framework };
+  registerAgentUnitConfig(config);
+  return defineIntegration({
+    category: "agent",
+    type: "agent-unit",
+    instance,
+    plugins: [createAgentPlugin(config)]
+  });
+}
+export {
+  agent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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, 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\";\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/**\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            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":"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","names":[]}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@farm.js/agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-beta.1",
+  "description": "Durable agents for Farm.js, served and built by agent-unit",
+  "keywords": [
+    "agent-unit",
+    "agents",
+    "ai-sdk",
+    "farmjs",
+    "mastra"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farming-labs/farm.js",
+    "directory": "packages/farm-agent"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "agent-unit": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.3",
+    "vite": "8.3.4",
+    "vitest": "5.0.5",
+    "@farm.js/core": "0.1.50"
+  },
+  "peerDependencies": {
+    "@farm.js/core": ">=0.1.50 <0.2.0"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
 }