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

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,34 @@
+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. 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.PluginRoutes>[];
+}, _farm_js_core.FarmSchema | undefined>;
+
+export { type AgentInstance, type AgentOptions, agent };

package/dist/index.js

@@ -0,0 +1,144 @@
+// 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 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
+);
+function isUnder(pathname, basePath) {
+  return basePath === "/" || pathname === basePath || pathname.startsWith(`${basePath}/`);
+}
+function createAgentPlugin(config) {
+  const { basePath } = config;
+  let root;
+  let agentsDir = config.agentsDir ?? "agents";
+  let devHandler;
+  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 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 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 ?? []] } };
+    },
+    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;
+        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.
+      async configure(nitroConfig) {
+        const { agentUnit } = await loadBuildOnly("agent-unit/nitro");
+        const module = 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))
+        });
+        return { ...nitroConfig, modules: [...nitroConfig.modules ?? [], module] };
+      }
+    },
+    dev: {
+      server(_viteServer, { lifecycle }) {
+        lifecycle.onShutdown(closeDev);
+      }
+    },
+    runtime: {
+      close: closeDev
+    }
+  });
+}
+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";
+function normalizeBasePath(value) {
+  if (!value.startsWith("/")) {
+    throw new Error(`@farm.js/agent: basePath must start with "/", got "${value}".`);
+  }
+  return value.replace(/\/+$/, "") || "/";
+}
+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. 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":[]}

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.0",
+  "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.48"
+  },
+  "peerDependencies": {
+    "@farm.js/core": ">=0.1.48 <0.2.0"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
 }