eve
Version:
Filesystem-first framework for durable backend AI agents that run anywhere.
31 lines (30 loc) • 1.49 kB
TypeScript
/**
* Workflow metadata is deployment-specific, so on Vercel it can point at
* the generated deployment URL. Production callbacks need the stable
* project production URL instead so other services can post back through
* the same trusted source configuration users set up for the production
* agent.
*/
export declare function resolveVercelProductionCallbackBaseUrl(): string | null;
/**
* Resolves the base URL used for framework-owned workflow callbacks.
*
* Workflow metadata falls back to port 3000 when its optional local port
* discovery is unavailable. eve already configures the local world with the
* active dev-server origin, so prefer that value before the metadata fallback.
*
* When {@link EVE_PUBLIC_ROUTE_PREFIX_ENV} is set (baked into deployed
* Vercel workflow functions for named multi-agent mounts), the prefix is
* appended so callbacks built from this base resolve to the agent's public
* `<prefix>/eve/v1/*` mount instead of the bare `/eve/v1/*` path the origin
* does not serve.
*/
export declare function resolveWorkflowCallbackBaseUrl(metadataUrl: string): string;
/**
* Builds a framework-owned callback URL from a resolved callback base URL.
*
* `callbackPath` is appended to the full base URL rather than resolved
* against it: the base may carry a public route prefix path, which
* `new URL(path, base)` would drop for absolute paths.
*/
export declare function createWorkflowCallbackUrl(baseUrl: string, callbackPath: string): string;