@farm.js/core 0.1.61 → 0.1.62

package/dist/agent-runtime.cjs

@@ -1,23 +1,24 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkCBJJH36Acjs = require('./chunk-CBJJH36A.cjs');
-require('./chunk-G643DQCH.cjs');
-require('./chunk-Z2HLU4IX.cjs');
-require('./chunk-LSKZMJMP.cjs');
-require('./chunk-SVRTJOUF.cjs');
-require('./chunk-KIIMAWOJ.cjs');
-require('./chunk-UQZ4AYTH.cjs');
-require('./chunk-KNBBQHO2.cjs');
-require('./chunk-NZKJGRB3.cjs');
-require('./chunk-S3A45T7F.cjs');
-require('./chunk-DVM4FKZL.cjs');
-require('./chunk-US2QVW3E.cjs');
-require('./chunk-BIDYX3SL.cjs');
-require('./chunk-I57LW5VZ.cjs');
-require('./chunk-NO3WWW3N.cjs');
-
-
-var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+var _chunkI32V5CZLcjs = require('./chunk-I32V5CZL.cjs');
+require('./chunk-DUIP64BF.cjs');
+require('./chunk-ZOYKJBP5.cjs');
+require('./chunk-ZXK2EYQW.cjs');
+require('./chunk-5DX3O6TT.cjs');
+require('./chunk-ITV4QQL2.cjs');
+require('./chunk-FEFCISOX.cjs');
+require('./chunk-YIHRZBD7.cjs');
+require('./chunk-2OF5RPVU.cjs');
+require('./chunk-CFG4QERR.cjs');
+require('./chunk-JYT7AN37.cjs');
+require('./chunk-HA7YRO53.cjs');
+require('./chunk-PMJSG4JS.cjs');
+require('./chunk-6XQSPIN6.cjs');
+require('./chunk-6CTFVBAT.cjs');
+require('./chunk-OWQV6MLM.cjs');
+require('./chunk-D22BUQKW.cjs');
+require('./chunk-YTVSWXEZ.cjs');
+require('./chunk-BTZ5O6VM.cjs');
 
 // src/agent-runtime.ts
 var _child_process = require('child_process');
@@ -63,7 +64,7 @@ function createAgentRuntimeIntegration(options) {
     provider,
     routePrefix,
     routePrefixes,
-    getOrigin: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => _nullishCoalesce(state.origin, () => ( resolveConfiguredOrigin(options.origin, originEnv))), "getOrigin")
+    getOrigin: () => _nullishCoalesce(state.origin, () => ( resolveConfiguredOrigin(options.origin, originEnv)))
   };
   const runtimePlugin = {
     name: `farm:agent-runtime:${provider}`,
@@ -96,7 +97,7 @@ function createAgentRuntimeIntegration(options) {
       });
     }
   };
-  return _chunkCBJJH36Acjs.defineIntegration.call(void 0, {
+  return _chunkI32V5CZLcjs.defineIntegration.call(void 0, {
     category: "agent",
     type: provider,
     serverRuntime: options.serverRuntime,
@@ -140,7 +141,6 @@ function createAgentRuntimeIntegration(options) {
     plugins: [runtimePlugin, ...options.plugins || []]
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, createAgentRuntimeIntegration, "createAgentRuntimeIntegration");
 function applyAgentRuntimeViteProxy(config, input) {
   const origin = normalizeAgentOrigin(input.origin);
   const routePrefix = normalizeAgentRoutePrefix(input.routePrefix);
@@ -168,7 +168,6 @@ function applyAgentRuntimeViteProxy(config, input) {
     }
   };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, applyAgentRuntimeViteProxy, "applyAgentRuntimeViteProxy");
 function rejectCrossSiteAgentDevRequest(request, response) {
   if (isAllowedAgentDevRequest(request, response === void 0)) return void 0;
   const body = "Cross-site request to the agent runtime was blocked";
@@ -188,7 +187,6 @@ ${body}`
   }
   return request.url || "/";
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, rejectCrossSiteAgentDevRequest, "rejectCrossSiteAgentDevRequest");
 function isAllowedAgentDevRequest(request, upgrade) {
   const fetchSite = _optionalChain([readSingleHeader, 'call', _4 => _4(request.headers["sec-fetch-site"]), 'optionalAccess', _5 => _5.toLowerCase, 'call', _6 => _6()]);
   const origin = readSingleHeader(request.headers.origin);
@@ -211,15 +209,15 @@ function isAllowedAgentDevRequest(request, upgrade) {
   ];
   return hosts.some((host) => _optionalChain([host, 'optionalAccess', _14 => _14.trim, 'call', _15 => _15(), 'access', _16 => _16.toLowerCase, 'call', _17 => _17()]) === originHost);
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, isAllowedAgentDevRequest, "isAllowedAgentDevRequest");
 function readSingleHeader(value) {
   return Array.isArray(value) ? value[0] : value;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, readSingleHeader, "readSingleHeader");
 async function proxyAgentRuntimeRequest(request, origin, options = {}) {
   const upstreamOrigin = normalizeAgentOrigin(origin);
   const incomingUrl = new URL(request.url);
-  const targetUrl = new URL(`${incomingUrl.pathname}${incomingUrl.search}`, upstreamOrigin);
+  const targetUrl = new URL(upstreamOrigin);
+  targetUrl.pathname = incomingUrl.pathname;
+  targetUrl.search = incomingUrl.search;
   const headers = createProxyRequestHeaders(request.headers, incomingUrl);
   const method = request.method.toUpperCase();
   const init = {
@@ -271,7 +269,6 @@ async function proxyAgentRuntimeRequest(request, origin, options = {}) {
     );
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, proxyAgentRuntimeRequest, "proxyAgentRuntimeRequest");
 async function startManagedAgentRuntime(options) {
   const timeoutMs = _nullishCoalesce(options.timeoutMs, () => ( 3e4));
   const stopTimeoutMs = _nullishCoalesce(options.stopTimeoutMs, () => ( 2e3));
@@ -289,14 +286,14 @@ async function startManagedAgentRuntime(options) {
   });
   const origin = await new Promise((resolveOrigin, reject) => {
     let timer;
-    const finish = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => {
+    const finish = () => {
       if (settled) return;
       settled = true;
       clearTimeout(timer);
       child.off("error", onError);
       child.off("exit", onExit);
-    }, "finish");
-    const succeed = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (candidate) => {
+    };
+    const succeed = async (candidate) => {
       if (settled || checkingReadiness) return;
       checkingReadiness = true;
       try {
@@ -309,25 +306,25 @@ async function startManagedAgentRuntime(options) {
         terminateChild(child);
         reject(error);
       }
-    }, "succeed");
+    };
     timer = setTimeout(() => {
       finish();
       terminateChild(child);
       reject(new Error(`${options.label} did not become ready within ${timeoutMs}ms.`));
     }, timeoutMs);
-    const onError = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (error) => {
+    const onError = (error) => {
       finish();
       reject(error);
-    }, "onError");
-    const onExit = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (code, signal) => {
+    };
+    const onExit = (code, signal) => {
       finish();
       reject(
         new Error(
           `${options.label} exited before it was ready (code ${String(code)}, signal ${String(signal)}).`
         )
       );
-    }, "onExit");
-    const onData = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (chunk, stream) => {
+    };
+    const onData = (chunk, stream) => {
       const text = chunk.toString("utf8");
       output = `${output}${text}`.slice(-16384);
       emitProcessOutput(text, stream, options.onOutput);
@@ -337,7 +334,7 @@ async function startManagedAgentRuntime(options) {
           void succeed(candidate);
         }
       }
-    }, "onData");
+    };
     child.once("error", onError);
     child.once("exit", onExit);
     _optionalChain([child, 'access', _28 => _28.stdout, 'optionalAccess', _29 => _29.on, 'call', _30 => _30("data", (chunk) => onData(chunk, "stdout"))]);
@@ -362,7 +359,6 @@ async function startManagedAgentRuntime(options) {
     }
   };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, startManagedAgentRuntime, "startManagedAgentRuntime");
 async function findAvailableAgentRuntimePort(host = "127.0.0.1") {
   return await new Promise((resolvePort, reject) => {
     const server = _net.createServer.call(void 0, );
@@ -383,7 +379,6 @@ async function findAvailableAgentRuntimePort(host = "127.0.0.1") {
     });
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, findAvailableAgentRuntimePort, "findAvailableAgentRuntimePort");
 async function resolveProjectPackageBin(projectRoot, packageName, binName) {
   const root = _path.resolve.call(void 0, projectRoot);
   const projectRequire = _module.createRequire.call(void 0, _path.join.call(void 0, root, "package.json"));
@@ -409,7 +404,6 @@ async function resolveProjectPackageBin(projectRoot, packageName, binName) {
   }
   return binaryPath;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, resolveProjectPackageBin, "resolveProjectPackageBin");
 function normalizeAgentOrigin(value) {
   const input = value.trim();
   if (!input) {
@@ -427,7 +421,6 @@ function normalizeAgentOrigin(value) {
   }
   return url.origin;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeAgentOrigin, "normalizeAgentOrigin");
 function normalizeAgentRoutePrefix(value) {
   const normalized = `/${value.trim()}`.replace(/\/{2,}/g, "/");
   if (normalized === "/") {
@@ -435,7 +428,6 @@ function normalizeAgentRoutePrefix(value) {
   }
   return normalized.replace(/\/$/, "");
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeAgentRoutePrefix, "normalizeAgentRoutePrefix");
 function normalizeProviderName(value) {
   const provider = value.trim();
   if (!provider || !/^[a-z0-9][a-z0-9._-]*$/i.test(provider)) {
@@ -443,12 +435,10 @@ function normalizeProviderName(value) {
   }
   return provider;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeProviderName, "normalizeProviderName");
 function normalizeOriginEnv(value) {
   if (!value) return [];
   return (Array.isArray(value) ? value : [value]).map((entry) => entry.trim()).filter(Boolean);
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeOriginEnv, "normalizeOriginEnv");
 function resolveConfiguredOrigin(configuredOrigin, envNames) {
   if (configuredOrigin) {
     return normalizeAgentOrigin(configuredOrigin);
@@ -461,7 +451,6 @@ function resolveConfiguredOrigin(configuredOrigin, envNames) {
   }
   return void 0;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, resolveConfiguredOrigin, "resolveConfiguredOrigin");
 function createProxyRequestHeaders(input, incomingUrl) {
   const headers = new Headers(input);
   removeHopByHopHeaders(headers);
@@ -477,7 +466,6 @@ function createProxyRequestHeaders(input, incomingUrl) {
   headers.set("x-forwarded-proto", incomingUrl.protocol.replace(":", ""));
   return headers;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, createProxyRequestHeaders, "createProxyRequestHeaders");
 function removeHopByHopHeaders(headers) {
   const connectionOptions = _nullishCoalesce(_optionalChain([headers, 'access', _38 => _38.get, 'call', _39 => _39("connection"), 'optionalAccess', _40 => _40.split, 'call', _41 => _41(",")]), () => ( []));
   for (const option of connectionOptions) {
@@ -490,7 +478,6 @@ function removeHopByHopHeaders(headers) {
     headers.delete(header);
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, removeHopByHopHeaders, "removeHopByHopHeaders");
 async function detectZstdDecoding(body) {
   const reader = body.getReader();
   const consumed = [];
@@ -530,7 +517,6 @@ async function detectZstdDecoding(body) {
   });
   return { decoded, body: rebuilt };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, detectZstdDecoding, "detectZstdDecoding");
 function concatUint8(chunks) {
   if (chunks.length === 0) return new Uint8Array(0);
   if (chunks.length === 1) return chunks[0];
@@ -543,7 +529,6 @@ function concatUint8(chunks) {
   }
   return merged;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, concatUint8, "concatUint8");
 function startsWithZstdFrameMagic(buffer) {
   if (buffer.byteLength < ZSTD_FRAME_MAGIC.byteLength) return false;
   let isStandardFrame = true;
@@ -556,7 +541,6 @@ function startsWithZstdFrameMagic(buffer) {
   if (isStandardFrame) return true;
   return buffer[0] >= 80 && buffer[0] <= 95 && buffer[1] === 42 && buffer[2] === 77 && buffer[3] === 24;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, startsWithZstdFrameMagic, "startsWithZstdFrameMagic");
 function rewriteProxyLocation(headers, upstreamOrigin, incomingOrigin) {
   const location = headers.get("location");
   if (!location) return;
@@ -568,11 +552,9 @@ function rewriteProxyLocation(headers, upstreamOrigin, incomingOrigin) {
   } catch (e4) {
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, rewriteProxyLocation, "rewriteProxyLocation");
 function isAbortError(error) {
   return error instanceof Error && error.name === "AbortError";
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, isAbortError, "isAbortError");
 async function waitForAgentRuntime(origin, healthPath, timeoutMs, child) {
   const deadline = Date.now() + timeoutMs;
   const healthUrl = new URL(healthPath || "/", origin);
@@ -596,7 +578,6 @@ async function waitForAgentRuntime(origin, healthPath, timeoutMs, child) {
   }
   throw new Error(`Agent runtime at ${origin} did not answer before the startup timeout.`);
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, waitForAgentRuntime, "waitForAgentRuntime");
 function emitProcessOutput(text, stream, onOutput) {
   if (!onOutput) return;
   for (const line of text.split(/\r?\n/)) {
@@ -604,13 +585,11 @@ function emitProcessOutput(text, stream, onOutput) {
     if (value) onOutput(value, stream);
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, emitProcessOutput, "emitProcessOutput");
 function terminateChild(child) {
   if (child.exitCode === null && child.signalCode === null) {
     child.kill("SIGTERM");
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, terminateChild, "terminateChild");
 async function waitForChildExit(child, timeoutMs) {
   if (child.exitCode !== null || child.signalCode !== null) return true;
   return await new Promise((resolveExit) => {
@@ -618,18 +597,16 @@ async function waitForChildExit(child, timeoutMs) {
       child.off("exit", onExit);
       resolveExit(false);
     }, timeoutMs);
-    const onExit = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => {
+    const onExit = () => {
       clearTimeout(timer);
       resolveExit(true);
-    }, "onExit");
+    };
     child.once("exit", onExit);
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, waitForChildExit, "waitForChildExit");
 function delay(ms) {
   return new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, delay, "delay");
 
 
 

package/dist/agent-runtime.d.mts

@@ -0,0 +1,105 @@
+import { ChildProcess } from 'node:child_process';
+import { B as BundleResultPayload, F as FarmPlugin, a as FarmIntegration } from './client-plugins.d-CWyYBxXf.mjs';
+import './lifecycle.d-C2aLBOwu.mjs';
+import './route.d-BaVH3V0w.mjs';
+import './endpoint.d-BkMSCRf6.mjs';
+import './cache.mjs';
+import './renderer.mjs';
+import './deployment.mjs';
+import 'http';
+import './server-fn.mjs';
+import './server-fn-error.d-DrcH9cc1.mjs';
+import './server-query.mjs';
+import './types.d-BnIqOn9w.mjs';
+import 'db0';
+import 'unstorage';
+import './schema.mjs';
+import 'react';
+import '@farming-labs/orm';
+import '@farming-labs/docs';
+import './observability.d-B2363jB6.mjs';
+import '@opentelemetry/api';
+import 'vite';
+import './workflows.d-CRMzQZ3k.mjs';
+import './cron.mjs';
+import './env.mjs';
+import './server-action-security.mjs';
+import './layers.d-CcS42OGR.mjs';
+import 'rolldown/utils';
+import 'rolldown';
+import './image-config.d-CeDgNyX4.mjs';
+import './types.d-C41ePjvP.mjs';
+import './config.d-qt-mE8O5.mjs';
+import './types.d-DQnyD3VD.mjs';
+import './font.mjs';
+
+interface FarmAgentRuntimeInstance {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+    getOrigin(): string | undefined;
+}
+interface FarmManagedAgentRuntime {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+    stop(): Promise<void>;
+}
+interface FarmAgentRuntimeStartContext {
+    readonly root: string;
+    readonly log: {
+        info(message: string, meta?: Record<string, unknown>): void;
+        warn(message: string, meta?: Record<string, unknown>): void;
+        error(message: string, meta?: Record<string, unknown>): void;
+    };
+}
+interface FarmAgentRuntimeBuildContext extends BundleResultPayload {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+}
+interface FarmAgentRuntimeIntegrationOptions {
+    provider: string;
+    routePrefix: string;
+    /** Whether Farm's production server must dispatch this runtime's proxy routes. */
+    serverRuntime?: boolean;
+    additionalRoutePrefixes?: readonly string[];
+    origin?: string;
+    originEnv?: string | readonly string[];
+    webSockets?: boolean;
+    startDev?(context: FarmAgentRuntimeStartContext): Promise<FarmManagedAgentRuntime>;
+    afterBuild?(context: FarmAgentRuntimeBuildContext): Promise<void> | void;
+    plugins?: readonly FarmPlugin[];
+    instance?: Record<string, unknown>;
+}
+interface FarmManagedProcessOptions {
+    command: string;
+    args?: readonly string[];
+    cwd: string;
+    env?: Record<string, string | undefined>;
+    label: string;
+    origin?: string;
+    resolveOrigin?(output: string): string | undefined;
+    healthPath?: string;
+    timeoutMs?: number;
+    stopTimeoutMs?: number;
+    onOutput?(line: string, stream: "stdout" | "stderr"): void;
+}
+interface FarmAgentProxyOptions {
+    fetch?: typeof globalThis.fetch;
+}
+declare function createAgentRuntimeIntegration(options: FarmAgentRuntimeIntegrationOptions): FarmIntegration;
+declare function applyAgentRuntimeViteProxy(config: {
+    vite?: Record<string, any>;
+}, input: {
+    origin: string;
+    routePrefix: string;
+    webSockets?: boolean;
+}): void;
+declare function proxyAgentRuntimeRequest(request: Request, origin: string, options?: FarmAgentProxyOptions): Promise<Response>;
+declare function startManagedAgentRuntime(options: FarmManagedProcessOptions): Promise<FarmManagedAgentRuntime>;
+declare function findAvailableAgentRuntimePort(host?: string): Promise<number>;
+declare function resolveProjectPackageBin(projectRoot: string, packageName: string, binName?: string): Promise<string>;
+declare function normalizeAgentOrigin(value: string): string;
+declare function normalizeAgentRoutePrefix(value: string): string;
+
+export { type FarmAgentProxyOptions, type FarmAgentRuntimeBuildContext, type FarmAgentRuntimeInstance, type FarmAgentRuntimeIntegrationOptions, type FarmAgentRuntimeStartContext, type FarmManagedAgentRuntime, type FarmManagedProcessOptions, applyAgentRuntimeViteProxy, createAgentRuntimeIntegration, findAvailableAgentRuntimePort, normalizeAgentOrigin, normalizeAgentRoutePrefix, proxyAgentRuntimeRequest, resolveProjectPackageBin, startManagedAgentRuntime };

package/dist/agent-runtime.d.ts

@@ -0,0 +1,105 @@
+import { ChildProcess } from 'node:child_process';
+import { B as BundleResultPayload, F as FarmPlugin, a as FarmIntegration } from './client-plugins.d-BcqIy4au.js';
+import './lifecycle.d-C2aLBOwu.js';
+import './route.d-DBTEqifW.js';
+import './endpoint.d-BgHn0lhl.js';
+import './cache.js';
+import './renderer.js';
+import './deployment.js';
+import 'http';
+import './server-fn.js';
+import './server-fn-error.d-DrcH9cc1.js';
+import './server-query.js';
+import './types.d-BnIqOn9w.js';
+import 'db0';
+import 'unstorage';
+import './schema.js';
+import 'react';
+import '@farming-labs/orm';
+import '@farming-labs/docs';
+import './observability.d-B2363jB6.js';
+import '@opentelemetry/api';
+import 'vite';
+import './workflows.d-CRMzQZ3k.js';
+import './cron.js';
+import './env.js';
+import './server-action-security.js';
+import './layers.d-CcS42OGR.js';
+import 'rolldown/utils';
+import 'rolldown';
+import './image-config.d-CeDgNyX4.js';
+import './types.d-C41ePjvP.js';
+import './config.d-qt-mE8O5.js';
+import './types.d-DQnyD3VD.js';
+import './font.js';
+
+interface FarmAgentRuntimeInstance {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+    getOrigin(): string | undefined;
+}
+interface FarmManagedAgentRuntime {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+    stop(): Promise<void>;
+}
+interface FarmAgentRuntimeStartContext {
+    readonly root: string;
+    readonly log: {
+        info(message: string, meta?: Record<string, unknown>): void;
+        warn(message: string, meta?: Record<string, unknown>): void;
+        error(message: string, meta?: Record<string, unknown>): void;
+    };
+}
+interface FarmAgentRuntimeBuildContext extends BundleResultPayload {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+}
+interface FarmAgentRuntimeIntegrationOptions {
+    provider: string;
+    routePrefix: string;
+    /** Whether Farm's production server must dispatch this runtime's proxy routes. */
+    serverRuntime?: boolean;
+    additionalRoutePrefixes?: readonly string[];
+    origin?: string;
+    originEnv?: string | readonly string[];
+    webSockets?: boolean;
+    startDev?(context: FarmAgentRuntimeStartContext): Promise<FarmManagedAgentRuntime>;
+    afterBuild?(context: FarmAgentRuntimeBuildContext): Promise<void> | void;
+    plugins?: readonly FarmPlugin[];
+    instance?: Record<string, unknown>;
+}
+interface FarmManagedProcessOptions {
+    command: string;
+    args?: readonly string[];
+    cwd: string;
+    env?: Record<string, string | undefined>;
+    label: string;
+    origin?: string;
+    resolveOrigin?(output: string): string | undefined;
+    healthPath?: string;
+    timeoutMs?: number;
+    stopTimeoutMs?: number;
+    onOutput?(line: string, stream: "stdout" | "stderr"): void;
+}
+interface FarmAgentProxyOptions {
+    fetch?: typeof globalThis.fetch;
+}
+declare function createAgentRuntimeIntegration(options: FarmAgentRuntimeIntegrationOptions): FarmIntegration;
+declare function applyAgentRuntimeViteProxy(config: {
+    vite?: Record<string, any>;
+}, input: {
+    origin: string;
+    routePrefix: string;
+    webSockets?: boolean;
+}): void;
+declare function proxyAgentRuntimeRequest(request: Request, origin: string, options?: FarmAgentProxyOptions): Promise<Response>;
+declare function startManagedAgentRuntime(options: FarmManagedProcessOptions): Promise<FarmManagedAgentRuntime>;
+declare function findAvailableAgentRuntimePort(host?: string): Promise<number>;
+declare function resolveProjectPackageBin(projectRoot: string, packageName: string, binName?: string): Promise<string>;
+declare function normalizeAgentOrigin(value: string): string;
+declare function normalizeAgentRoutePrefix(value: string): string;
+
+export { type FarmAgentProxyOptions, type FarmAgentRuntimeBuildContext, type FarmAgentRuntimeInstance, type FarmAgentRuntimeIntegrationOptions, type FarmAgentRuntimeStartContext, type FarmManagedAgentRuntime, type FarmManagedProcessOptions, applyAgentRuntimeViteProxy, createAgentRuntimeIntegration, findAvailableAgentRuntimePort, normalizeAgentOrigin, normalizeAgentRoutePrefix, proxyAgentRuntimeRequest, resolveProjectPackageBin, startManagedAgentRuntime };