experimental-ash 0.61.0 → 0.63.0

package/dist/src/public/definitions/connections/protocol.js

@@ -0,0 +1 @@
+const PROTOCOL_KEY=Symbol.for(`experimental-ash.connection-protocol`);function stampConnectionProtocol(e,t){Object.defineProperty(e,PROTOCOL_KEY,{configurable:!0,value:t})}function readConnectionProtocol(e){if(typeof e==`object`&&e&&PROTOCOL_KEY in e){let t=e[PROTOCOL_KEY];if(t!==void 0)return t}return`mcp`}export{readConnectionProtocol,stampConnectionProtocol};

package/dist/src/public/next/index.d.ts

@@ -53,15 +53,15 @@ export interface WithAshOptions {
      */
     readonly ashBuildCommand?: string;
     /**
-     * Set to `false` to skip creating or updating `vercel.json`.
+     * Set to `false` to skip creating or updating Vercel Build Output config.
      *
-     * By default `withAsh` ensures `vercel.json` contains `experimentalServices`
-     * for the Next.js app and Ash app.
+     * By default `withAsh` ensures `.vercel/output/config.json` contains
+     * `experimentalServices` for the Next.js app and Ash app.
      */
-    readonly configureVercelJson?: boolean;
+    readonly configureVercelOutput?: boolean;
     /**
      * Private Vercel service prefix for the Ash deployment. This must match the
-     * Ash service's `routePrefix` in `vercel.json`.
+     * Ash service's mount in Vercel Build Output config.
      */
     readonly servicePrefix?: string;
 }
@@ -72,7 +72,7 @@ export interface WithAshOptions {
  * In development, `withAsh` starts `ash dev --no-repl --port 0` for the Ash
  * app and rewrites Ash protocol endpoints to that local URL. In production on
  * Vercel, it rewrites to the private Ash service prefix configured in
- * `vercel.json`. Outside Vercel production, it serves an existing
+ * `.vercel/output/config.json`. Outside Vercel production, it serves an existing
  * `.output/server/index.mjs` Ash build on a stable local port when present;
  * otherwise set `ASH_NEXT_PRODUCTION_ORIGIN` to the origin that serves the Ash
  * service namespace.

package/dist/src/public/next/index.js

@@ -1 +1 @@
-import{resolveAshDestinationPrefix}from"./server.js";import{ensureAshVercelJson}from"./vercel-json.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{isAbsolute,resolve}from"node:path";const ASH_NEXT_SERVICE_PREFIX=`/_ash_internal/ash`,ASH_NEXT_PRODUCTION_PORT_ENV=`ASH_NEXT_PRODUCTION_PORT`,ASH_PROXY_REWRITE_SOURCES=[`${ASH_ROUTE_PREFIX}/:path+`];function resolveApplicationRoot(e){return e===void 0||e.length===0?process.cwd():isAbsolute(e)?e:resolve(process.cwd(),e)}function normalizeRoutePrefix(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/\/+$/,``);if(t.length===0)throw Error(`Ash Next.js service prefix cannot resolve to the root route.`);return t}function joinRoutePrefix(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function normalizeOrigin(e){return new URL(e.trim()).origin}function readLocalProductionPort(){let e=process.env[ASH_NEXT_PRODUCTION_PORT_ENV];if(e===void 0||e.trim().length===0)return 4274;let t=Number.parseInt(e,10);if(String(t)!==e.trim()||t<1||t>65535)throw Error(`${ASH_NEXT_PRODUCTION_PORT_ENV} must be an integer between 1 and 65535.`);return t}function resolveProductionDestination(e){if(process.env.VERCEL)return{destinationPrefix:e};let t=process.env.ASH_NEXT_PRODUCTION_ORIGIN;if(t!==void 0&&t.trim().length>0)return{destinationPrefix:joinRoutePrefix(normalizeOrigin(t),e)};let n=`http://127.0.0.1:${String(readLocalProductionPort())}`;return{destinationPrefix:n,localServerOrigin:n}}function createAshRewriteRules(e){return ASH_PROXY_REWRITE_SOURCES.map(t=>({destination:joinRoutePrefix(e,t),source:t}))}async function resolveExistingRewrites(e){return await e?.()}function mergeRewriteRules(e,t){return e===void 0?{beforeFiles:t}:isRewriteSections(e)?{...e,beforeFiles:[...t,...e.beforeFiles??[]]}:{afterFiles:e,beforeFiles:t}}function isRewriteSections(e){return!Array.isArray(e)}async function resolveNextConfig(e,t,n){return typeof e==`function`?await e(t,n):e}function withAsh(n,r={}){let i=process.cwd(),a=resolveApplicationRoot(r.ashRoot),o=normalizeRoutePrefix(r.servicePrefix??`/_ash_internal/ash`),s=r.configureVercelJson!==!1;return async function(c,l){let u=await resolveNextConfig(n,c,l),d=u.rewrites,f=resolveProductionDestination((s?await ensureAshVercelJson({appRoot:a,ashBuildCommand:r.ashBuildCommand??`ash build`,nextRoot:i,servicePrefix:o}):{servicePrefix:o}).servicePrefix);return{...u,async rewrites(){let[t,n]=await Promise.all([resolveExistingRewrites(d),resolveAshDestinationPrefix({appRoot:a,phase:c,productionDestinationPrefix:f.destinationPrefix,productionServerOrigin:f.localServerOrigin})]);return mergeRewriteRules(t,createAshRewriteRules(n))}}}}export{ASH_NEXT_SERVICE_PREFIX,withAsh};
+import{resolveAshDestinationPrefix}from"./server.js";import{ensureAshVercelOutputConfig}from"./vercel-output-config.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{isAbsolute,resolve}from"node:path";const ASH_NEXT_SERVICE_PREFIX=`/_ash_internal/ash`,ASH_NEXT_PRODUCTION_PORT_ENV=`ASH_NEXT_PRODUCTION_PORT`,ASH_PROXY_REWRITE_SOURCES=[`${ASH_ROUTE_PREFIX}/:path+`];function resolveApplicationRoot(e){return e===void 0||e.length===0?process.cwd():isAbsolute(e)?e:resolve(process.cwd(),e)}function normalizeRoutePrefix(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/\/+$/,``);if(t.length===0)throw Error(`Ash Next.js service prefix cannot resolve to the root route.`);return t}function joinRoutePrefix(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function normalizeOrigin(e){return new URL(e.trim()).origin}function readLocalProductionPort(){let e=process.env[ASH_NEXT_PRODUCTION_PORT_ENV];if(e===void 0||e.trim().length===0)return 4274;let t=Number.parseInt(e,10);if(String(t)!==e.trim()||t<1||t>65535)throw Error(`${ASH_NEXT_PRODUCTION_PORT_ENV} must be an integer between 1 and 65535.`);return t}function resolveProductionDestination(e){if(process.env.VERCEL)return{destinationPrefix:e};let t=process.env.ASH_NEXT_PRODUCTION_ORIGIN;if(t!==void 0&&t.trim().length>0)return{destinationPrefix:joinRoutePrefix(normalizeOrigin(t),e)};let n=`http://127.0.0.1:${String(readLocalProductionPort())}`;return{destinationPrefix:n,localServerOrigin:n}}function createAshRewriteRules(e){return ASH_PROXY_REWRITE_SOURCES.map(t=>({destination:joinRoutePrefix(e,t),source:t}))}async function resolveExistingRewrites(e){return await e?.()}function mergeRewriteRules(e,t){return e===void 0?{beforeFiles:t}:isRewriteSections(e)?{...e,beforeFiles:[...t,...e.beforeFiles??[]]}:{afterFiles:e,beforeFiles:t}}function isRewriteSections(e){return!Array.isArray(e)}async function resolveNextConfig(e,t,n){return typeof e==`function`?await e(t,n):e}function withAsh(n,r={}){let i=process.cwd(),a=resolveApplicationRoot(r.ashRoot),o=normalizeRoutePrefix(r.servicePrefix??`/_ash_internal/ash`),s=r.configureVercelOutput!==!1;return async function(c,l){let u=await resolveNextConfig(n,c,l),d=u.rewrites,f=resolveProductionDestination((s?await ensureAshVercelOutputConfig({appRoot:a,ashBuildCommand:r.ashBuildCommand??`ash build`,nextRoot:i,servicePrefix:o}):{servicePrefix:o}).servicePrefix);return{...u,async rewrites(){let[t,n]=await Promise.all([resolveExistingRewrites(d),resolveAshDestinationPrefix({appRoot:a,phase:c,productionDestinationPrefix:f.destinationPrefix,productionServerOrigin:f.localServerOrigin})]);return mergeRewriteRules(t,createAshRewriteRules(n))}}}}export{ASH_NEXT_SERVICE_PREFIX,withAsh};

package/dist/src/public/next/{vercel-json.d.ts → vercel-output-config.d.ts}

@@ -1,9 +1,9 @@
-export interface EnsureVercelJsonResult {
+export interface EnsureVercelOutputConfigResult {
     readonly servicePrefix: string;
 }
-export declare function ensureAshVercelJson(input: {
+export declare function ensureAshVercelOutputConfig(input: {
     readonly appRoot: string;
     readonly ashBuildCommand: string;
     readonly nextRoot: string;
     readonly servicePrefix: string;
-}): Promise<EnsureVercelJsonResult>;
+}): Promise<EnsureVercelOutputConfigResult>;

package/dist/src/public/next/vercel-output-config.js

@@ -0,0 +1 @@
+import{dirname,join,relative}from"node:path";import{mkdir,readFile,writeFile}from"node:fs/promises";import{findClosestLinkedVercelDirectory,findClosestVercelOutputDirectory}from"#shared/vercel-output-directory.js";const VERCEL_JSON_FILE_NAME=`vercel.json`,VERCEL_OUTPUT_CONFIG_FILE_NAME=`.vercel/output/config.json`;function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function hasServices(e){return e!==void 0&&Object.keys(e).length>0}function resolveRelativeEntrypoint(e,t){let r=relative(e,t);return r.length===0?`.`:r.replaceAll(`\\`,`/`)}async function resolveVercelOutputConfigLocation(n){let r=await findClosestLinkedVercelDirectory(n),i=r===void 0?n:dirname(r),a=await findClosestVercelOutputDirectory(n);return a===void 0?r===void 0?{outputConfigPath:join(n,VERCEL_OUTPUT_CONFIG_FILE_NAME),projectRoot:i}:{outputConfigPath:join(r,`output`,`config.json`),projectRoot:i}:{outputConfigPath:join(a,`config.json`),projectRoot:i}}function normalizeVercelServicesConfig(e,t){if(!isRecord(e))throw Error(`${t} must contain a JSON object.`);let n=e.experimentalServices;if(n!==void 0&&!isRecord(n))throw Error(`${t} experimentalServices must be a JSON object.`);return e}async function readVercelServicesConfig(e,t){try{return normalizeVercelServicesConfig(JSON.parse(await readFile(e,`utf8`)),t)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return{};throw e}}function findServiceByFramework(e,t){return Object.values(e).find(e=>e.framework===t)}function resolveServicePrefix(e){if(e!==void 0){if(typeof e.routePrefix==`string`&&e.routePrefix.trim().length>0)return e.routePrefix.trim();if(typeof e.mount==`string`&&e.mount.trim().length>0)return e.mount.trim();if(isRecord(e.mount)&&typeof e.mount.path==`string`&&e.mount.path.trim().length>0)return e.mount.path.trim()}}function resolveConfiguredServicePrefix(e){return resolveServicePrefix(findServiceByFramework(e.services,`ash`))??e.servicePrefix}function assertRootServicesAreComplete(e){let t=findServiceByFramework(e.services,`ash`),n=findServiceByFramework(e.services,`nextjs`);if(t!==void 0&&n!==void 0)return resolveServicePrefix(t)??e.servicePrefix;throw Error(`${VERCEL_JSON_FILE_NAME} already defines experimentalServices, so withAsh cannot add generated services through ${VERCEL_OUTPUT_CONFIG_FILE_NAME}. Add both the Next.js and Ash services to ${VERCEL_JSON_FILE_NAME}, or remove experimentalServices from ${VERCEL_JSON_FILE_NAME}.`)}async function ensureAshVercelOutputConfig(n){let{outputConfigPath:i,projectRoot:o}=await resolveVercelOutputConfigLocation(n.nextRoot),s=(await readVercelServicesConfig(join(o,VERCEL_JSON_FILE_NAME),VERCEL_JSON_FILE_NAME)).experimentalServices;if(hasServices(s))return{servicePrefix:assertRootServicesAreComplete({services:s,servicePrefix:n.servicePrefix})};let c=await readVercelServicesConfig(i,VERCEL_OUTPUT_CONFIG_FILE_NAME),l=resolveRelativeEntrypoint(n.nextRoot,n.appRoot),u=c.experimentalServices??{},d=findServiceByFramework(u,`ash`),f=findServiceByFramework(u,`nextjs`),p=resolveConfiguredServicePrefix({services:u,servicePrefix:n.servicePrefix}),m={...u};f===void 0&&(m.web={entrypoint:`.`,framework:`nextjs`,mount:`/`,type:`web`}),d===void 0&&(m.ash={buildCommand:n.ashBuildCommand,entrypoint:l,framework:`ash`,mount:p,type:`web`});let h={...c,version:3,experimentalServices:m};return JSON.stringify(c)!==JSON.stringify(h)&&(await mkdir(dirname(i),{recursive:!0}),await writeFile(i,`${JSON.stringify(h,null,2)}\n`)),{servicePrefix:p}}export{ensureAshVercelOutputConfig};

package/dist/src/public/nuxt/dev-server.d.ts

@@ -0,0 +1,24 @@
+import { type ChildProcess } from "node:child_process";
+export declare const ASH_BASE_URL_ENV = "ASH_BASE_URL";
+export interface AshProcessHandle {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+}
+export interface AshDevServerRegistry {
+    readonly appRoot: string;
+    readonly origin: string;
+    readonly pid: number | null;
+    readonly updatedAt: string;
+}
+/**
+ * Parse and validate a persisted dev-server registry record. Returns
+ * `undefined` for anything that is not a well-formed registry so callers fall
+ * back to spawning a fresh server.
+ */
+export declare function normalizeDevServerRegistry(value: unknown): AshDevServerRegistry | undefined;
+/**
+ * Resolve a shared Ash dev server for {@link appRoot}, reusing a healthy
+ * registered server when one exists and otherwise spawning a new one behind a
+ * cross-process lock so concurrent Nuxt processes don't each boot Ash.
+ */
+export declare function resolveSharedAshDevServer(appRoot: string): Promise<AshProcessHandle>;

package/dist/src/public/nuxt/dev-server.js

@@ -0,0 +1 @@
+import{joinRoutePrefix,normalizeOrigin}from"./routing.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{join}from"node:path";import{mkdir,open,readFile,rm,stat,writeFile}from"node:fs/promises";import{spawn}from"node:child_process";import{resolvePackageRoot}from"#internal/application/package.js";const ASH_BASE_URL_ENV=`ASH_BASE_URL`,DEFAULT_SERVER_READY_TIMEOUT_MS=3e4,DEV_SERVER_REGISTRY_TIMEOUT_MS=3e4,LOCAL_SERVER_URL_PATTERN=/https?:\/\/(?:\[[^\]\s]+\]|[^\s/:[\]]+)(?::\d+)?/;function isNodeErrorWithCode(e,t){return e instanceof Error&&`code`in e&&e.code===t}function delay(e){return new Promise(t=>setTimeout(t,e))}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function resolveAshCacheDirectory(e){return join(e,`.ash`)}function resolveAshDevServerRegistryPath(e){return join(resolveAshCacheDirectory(e),`nuxt-dev-server.json`)}function resolveAshDevServerLockPath(e){return join(resolveAshCacheDirectory(e),`nuxt-dev-server.lock`)}function normalizeDevServerRegistry(e){if(isRecord(e)&&!(typeof e.appRoot!=`string`||typeof e.origin!=`string`||typeof e.updatedAt!=`string`)&&!(e.pid!==null&&typeof e.pid!=`number`))try{return{appRoot:e.appRoot,origin:normalizeOrigin(e.origin),pid:e.pid,updatedAt:e.updatedAt}}catch{return}}async function isAshServerHealthy(t){let r=new AbortController,i=setTimeout(()=>r.abort(),1e3);try{return(await fetch(joinRoutePrefix(t,`${ASH_ROUTE_PREFIX}/health`),{signal:r.signal})).ok}catch{return!1}finally{clearTimeout(i)}}async function readUsableAshDevServerRegistry(e){try{let t=normalizeDevServerRegistry(JSON.parse(await readFile(resolveAshDevServerRegistryPath(e),`utf8`)));return t===void 0||t.appRoot!==e||!await isAshServerHealthy(t.origin)?void 0:t.origin}catch(e){if(isNodeErrorWithCode(e,`ENOENT`))return;throw e}}async function writeAshDevServerRegistry(e,t){await mkdir(resolveAshCacheDirectory(e),{recursive:!0}),await writeFile(resolveAshDevServerRegistryPath(e),`${JSON.stringify({appRoot:e,origin:t.origin,pid:t.process?.pid??null,updatedAt:new Date().toISOString()},null,2)}\n`)}async function removeStaleAshDevServerLock(e){try{let t=await stat(e);Date.now()-t.mtimeMs>3e4&&await rm(e,{force:!0})}catch(e){if(!isNodeErrorWithCode(e,`ENOENT`))throw e}}async function acquireAshDevServerLock(e){let t=resolveAshCacheDirectory(e),n=resolveAshDevServerLockPath(e),r=Date.now()+DEV_SERVER_REGISTRY_TIMEOUT_MS;for(await mkdir(t,{recursive:!0});;)try{let e=await open(n,`wx`);return await e.writeFile(`${String(process.pid)}\n`),await e.close(),async()=>{await rm(n,{force:!0})}}catch(t){if(!isNodeErrorWithCode(t,`EEXIST`))throw t;if(await readUsableAshDevServerRegistry(e)!==void 0)return async()=>{};if(await removeStaleAshDevServerLock(n),Date.now()>r)throw Error(`Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another Nuxt process to start Ash.`);await delay(100)}}function createAshBinaryPath(){return join(resolvePackageRoot(),`bin`,`ash.js`)}function startServerProcess(e){return new Promise((n,r)=>{let i=spawn(e.command,e.args,{cwd:e.cwd,env:{...process.env,...e.env},stdio:[`ignore`,`pipe`,`pipe`]}),a=setTimeout(()=>{i.kill(),r(Error(`Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for Ash to print its server URL.`))},DEFAULT_SERVER_READY_TIMEOUT_MS),cleanup=()=>{clearTimeout(a),i.off(`error`,handleError),i.off(`exit`,handleEarlyExit)},handleError=e=>{cleanup(),r(e)},handleEarlyExit=(e,t)=>{cleanup(),r(Error(`Ash server process exited before printing its server URL (code ${String(e)}, signal ${String(t)}).`))},o=!1,handleOutput=e=>{if(o)return;let r=LOCAL_SERVER_URL_PATTERN.exec(e.toString(`utf8`));r!==null&&(o=!0,cleanup(),n({origin:normalizeOrigin(r[0]),process:i}))};i.once(`error`,handleError),i.once(`exit`,handleEarlyExit),i.stdout.on(`data`,e=>{process.stdout.write(e),handleOutput(e)}),i.stderr.on(`data`,e=>{process.stderr.write(e),handleOutput(e)})})}function installProcessShutdown(e){let t=e.process;if(t===void 0)return e;let close=()=>{process.off(`beforeExit`,close),process.off(`exit`,close),t.killed||t.kill()};return process.once(`beforeExit`,close),process.once(`exit`,close),e}function startAshDevServer(e){return startServerProcess({args:[createAshBinaryPath(),`dev`,`--no-repl`,`--port`,`0`],command:process.execPath,cwd:e}).then(e=>(process.env[ASH_BASE_URL_ENV]=e.origin,installProcessShutdown(e)))}async function resolveSharedAshDevServer(e){let t=await readUsableAshDevServerRegistry(e);if(t!==void 0)return process.env[ASH_BASE_URL_ENV]=t,{origin:t};let n=await acquireAshDevServerLock(e);try{let t=await readUsableAshDevServerRegistry(e);if(t!==void 0)return process.env[ASH_BASE_URL_ENV]=t,{origin:t};let n=await startAshDevServer(e);return await writeAshDevServerRegistry(e,n),n}finally{await n()}}export{ASH_BASE_URL_ENV,normalizeDevServerRegistry,resolveSharedAshDevServer};

package/dist/src/public/nuxt/index.d.ts

@@ -0,0 +1 @@
+export { default, ASH_NUXT_SERVICE_PREFIX, type AshNuxtModuleOptions } from "./module.js";

package/dist/src/public/nuxt/index.js

@@ -0,0 +1 @@
+import{ASH_NUXT_SERVICE_PREFIX}from"./routing.js";import module_default from"./module.js";export{ASH_NUXT_SERVICE_PREFIX,module_default as default};

package/dist/src/public/nuxt/module.d.ts

@@ -0,0 +1,31 @@
+import { ASH_NUXT_SERVICE_PREFIX } from "./routing.js";
+export { ASH_NUXT_SERVICE_PREFIX };
+/**
+ * Options for the Ash Nuxt module.
+ */
+export interface AshNuxtModuleOptions {
+    /**
+     * Path to the Ash application root, relative to the Nuxt project root
+     * unless absolute. Defaults to the Nuxt project root.
+     */
+    ashRoot?: string;
+    /**
+     * Build command for the generated Ash Vercel service.
+     * Defaults to `"ash build"`.
+     */
+    ashBuildCommand?: string;
+    /**
+     * Set to `false` to skip creating or updating `vercel.json`.
+     *
+     * By default the module ensures `vercel.json` contains
+     * `experimentalServices` for the Nuxt app and Ash app.
+     */
+    configureVercelJson?: boolean;
+    /**
+     * Private Vercel service prefix for the Ash deployment. Must match the
+     * Ash service's `routePrefix` in `vercel.json`.
+     */
+    servicePrefix?: string;
+}
+declare const _default: import("nuxt/schema").NuxtModule<AshNuxtModuleOptions, AshNuxtModuleOptions, false>;
+export default _default;

package/dist/src/public/nuxt/module.js

@@ -0,0 +1 @@
+import{ASH_NUXT_SERVICE_PREFIX,createAshVercelRewriteRoute,joinRoutePrefix,normalizeOrigin,normalizeRoutePrefix,resolveProductionTarget}from"./routing.js";import{ASH_BASE_URL_ENV,resolveSharedAshDevServer}from"./dev-server.js";import{ensureAshVercelJson}from"./vercel-json.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{isAbsolute,resolve}from"node:path";import{addImports,defineNuxtModule,extendRouteRules}from"@nuxt/kit";function resolveApplicationRoot(e,t){return t===void 0||t.length===0?e:isAbsolute(t)?t:resolve(e,t)}async function resolveAshProxyTarget(e){if(!e.dev)return resolveProductionTarget(e.servicePrefix);let t=process.env[ASH_BASE_URL_ENV]?.trim();if(t&&t.length>0)return joinRoutePrefix(normalizeOrigin(t),ASH_ROUTE_PREFIX);let i=await resolveSharedAshDevServer(e.appRoot);return i.process!==void 0&&e.onDevServerSpawned?.(i.process),joinRoutePrefix(i.origin,ASH_ROUTE_PREFIX)}var module_default=defineNuxtModule({meta:{name:`experimental-ash`,configKey:`ash`,compatibility:{nuxt:`>=4.0.0`}},defaults:{},async setup(e,n){let r=n.options.rootDir,a=resolveApplicationRoot(r,e.ashRoot),o=normalizeRoutePrefix(e.servicePrefix??`/_ash_internal/ash`),s=e.configureVercelJson!==!1;if(addImports({name:`useAshAgent`,from:`experimental-ash/vue`}),!n.options.dev&&process.env.VERCEL){let e=createAshVercelRewriteRoute(o),r=n.options.nitro,i=r.vercel?.config;r.vercel={...r.vercel,config:{version:3,...i,routes:[e,...i?.routes??[]]}}}else n.hook(`modules:done`,async()=>{let e=await resolveAshProxyTarget({appRoot:a,dev:n.options.dev,servicePrefix:o,onDevServerSpawned:e=>{n.hook(`close`,()=>{e.killed||e.kill()})}});extendRouteRules(`${ASH_ROUTE_PREFIX}/**`,{proxy:`${e}/**`})});s&&await ensureAshVercelJson({appRoot:a,ashBuildCommand:e.ashBuildCommand??`ash build`,nuxtRoot:r,servicePrefix:o})}});export{ASH_NUXT_SERVICE_PREFIX,module_default as default};

package/dist/src/public/nuxt/routing.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Private route namespace used when a Vercel deployment hosts Ash as a
+ * separate experimental service behind the Nuxt app.
+ */
+export declare const ASH_NUXT_SERVICE_PREFIX = "/_ash_internal/ash";
+/**
+ * Normalize a user-supplied service prefix into a leading-slash, no-trailing-
+ * slash route. Throws when the prefix resolves to the root route, which would
+ * collide with the Nuxt web service.
+ */
+export declare function normalizeRoutePrefix(prefix: string): string;
+/**
+ * Join a route prefix and a path with exactly one separating slash.
+ */
+export declare function joinRoutePrefix(prefix: string, path: string): string;
+/**
+ * Reduce an origin string to its canonical `protocol://host[:port]` form.
+ */
+export declare function normalizeOrigin(origin: string): string;
+/**
+ * Resolve the local production port the module proxies to when an Ash service
+ * runs alongside a non-Vercel Nuxt deployment. Defaults to
+ * {@link DEFAULT_ASH_NUXT_PRODUCTION_PORT}.
+ */
+export declare function readLocalProductionPort(): number;
+/**
+ * An edge-level Vercel rewrite expressed in Build Output API v3 form.
+ */
+export interface AshVercelRewriteRoute {
+    readonly src: string;
+    readonly dest: string;
+    /**
+     * Re-run route matching against the rewritten `dest`. Required so the
+     * rewritten Ash service path is routed to the sibling Ash service instead of
+     * being resolved inside the host service's own filesystem (which 404s).
+     */
+    readonly check: true;
+}
+/**
+ * Build the edge-level Vercel rewrite that forwards Ash transport requests
+ * (`/ash/v1/**`) to the Ash service prefix (`/_ash_internal/ash/ash/v1/**`).
+ *
+ * Mirrors the Next.js integration's `beforeFiles` rewrite. A Nitro runtime
+ * `proxy` route rule cannot reach a sibling Vercel service — the proxied
+ * request loops back into the Nuxt function and 404s — so production routing
+ * must happen at the edge via the build output config instead.
+ */
+export declare function createAshVercelRewriteRoute(servicePrefix: string): AshVercelRewriteRoute;
+/**
+ * Resolve the proxy destination for Ash routes in production.
+ *
+ * On Vercel the destination is the private service prefix. Off Vercel it is an
+ * explicit origin override (`ASH_NUXT_PRODUCTION_ORIGIN`) or a local port.
+ */
+export declare function resolveProductionTarget(servicePrefix: string): string;

package/dist/src/public/nuxt/routing.js

@@ -0,0 +1 @@
+import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";const ASH_NUXT_SERVICE_PREFIX=`/_ash_internal/ash`,ASH_NUXT_PRODUCTION_PORT_ENV=`ASH_NUXT_PRODUCTION_PORT`;function normalizeRoutePrefix(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/\/+$/,``);if(t.length===0)throw Error(`Ash Nuxt service prefix cannot resolve to the root route.`);return t}function joinRoutePrefix(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function normalizeOrigin(e){return new URL(e.trim()).origin}function readLocalProductionPort(){let e=process.env[ASH_NUXT_PRODUCTION_PORT_ENV];if(e===void 0||e.trim().length===0)return 4274;let t=Number.parseInt(e,10);if(String(t)!==e.trim()||t<1||t>65535)throw Error(`${ASH_NUXT_PRODUCTION_PORT_ENV} must be an integer between 1 and 65535.`);return t}function createAshVercelRewriteRoute(t){let n=joinRoutePrefix(t,ASH_ROUTE_PREFIX);return{src:`^${ASH_ROUTE_PREFIX}/(.*)$`,dest:`${n}/$1`,check:!0}}function resolveProductionTarget(t){if(process.env.VERCEL)return joinRoutePrefix(t,ASH_ROUTE_PREFIX);let n=process.env.ASH_NUXT_PRODUCTION_ORIGIN;return n!==void 0&&n.trim().length>0?joinRoutePrefix(normalizeOrigin(n),ASH_ROUTE_PREFIX):joinRoutePrefix(`http://127.0.0.1:${String(readLocalProductionPort())}`,ASH_ROUTE_PREFIX)}export{ASH_NUXT_SERVICE_PREFIX,createAshVercelRewriteRoute,joinRoutePrefix,normalizeOrigin,normalizeRoutePrefix,readLocalProductionPort,resolveProductionTarget};

package/dist/src/public/nuxt/vercel-json.d.ts

@@ -0,0 +1,17 @@
+export interface EnsureVercelJsonResult {
+    readonly servicePrefix: string;
+}
+/**
+ * Ensure `vercel.json` declares the Nuxt web service and the Ash agent
+ * service so a Vercel deployment ships both from one project.
+ *
+ * Existing services are preserved untouched; an already-configured Ash
+ * service's `routePrefix` wins over {@link input.servicePrefix}. The file is
+ * only rewritten when the resulting config differs from what is on disk.
+ */
+export declare function ensureAshVercelJson(input: {
+    readonly appRoot: string;
+    readonly ashBuildCommand: string;
+    readonly nuxtRoot: string;
+    readonly servicePrefix: string;
+}): Promise<EnsureVercelJsonResult>;

package/dist/src/public/{next → nuxt}/vercel-json.js

@@ -1 +1 @@
-import{join,relative}from"node:path";import{readFile,writeFile}from"node:fs/promises";const VERCEL_JSON_FILE_NAME=`vercel.json`;function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function resolveRelativeEntrypoint(e,n){let r=relative(e,n);return r.length===0?`.`:r.replaceAll(`\\`,`/`)}function normalizeVercelJsonConfig(e){if(!isRecord(e))throw Error(`${VERCEL_JSON_FILE_NAME} must contain a JSON object.`);let t=e.experimentalServices;if(t!==void 0&&!isRecord(t))throw Error(`${VERCEL_JSON_FILE_NAME} experimentalServices must be a JSON object.`);return e}async function readVercelJsonConfig(e){try{return normalizeVercelJsonConfig(JSON.parse(await readFile(e,`utf8`)))}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return{};throw e}}function findServiceByFramework(e,t){return Object.values(e).find(e=>e.framework===t)}async function ensureAshVercelJson(t){let n=join(t.nextRoot,VERCEL_JSON_FILE_NAME),i=await readVercelJsonConfig(n),a=resolveRelativeEntrypoint(t.nextRoot,t.appRoot),o=i.experimentalServices??{},s=findServiceByFramework(o,`ash`),c=findServiceByFramework(o,`nextjs`),l=s?.routePrefix??t.servicePrefix,u={...o};c===void 0&&(u.web={entrypoint:`.`,framework:`nextjs`,routePrefix:`/`}),s===void 0&&(u.ash={buildCommand:t.ashBuildCommand,entrypoint:a,framework:`ash`,routePrefix:l});let d={...i,$schema:i.$schema??`https://openapi.vercel.sh/vercel.json`,experimentalServices:u};return JSON.stringify(i)!==JSON.stringify(d)&&await writeFile(n,`${JSON.stringify(d,null,2)}\n`),{servicePrefix:l}}export{ensureAshVercelJson};
+import{join,relative}from"node:path";import{readFile,writeFile}from"node:fs/promises";const VERCEL_JSON_FILE_NAME=`vercel.json`;function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function resolveRelativeEntrypoint(e,n){let r=relative(e,n);return r.length===0?`.`:r.replaceAll(`\\`,`/`)}function normalizeVercelJsonConfig(e){if(!isRecord(e))throw Error(`${VERCEL_JSON_FILE_NAME} must contain a JSON object.`);let t=e.experimentalServices;if(t!==void 0&&!isRecord(t))throw Error(`${VERCEL_JSON_FILE_NAME} experimentalServices must be a JSON object.`);return e}async function readVercelJsonConfig(e){try{return normalizeVercelJsonConfig(JSON.parse(await readFile(e,`utf8`)))}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return{};throw e}}function findServiceByFramework(e,t){return Object.values(e).find(e=>e.framework===t)}async function ensureAshVercelJson(t){let n=join(t.nuxtRoot,VERCEL_JSON_FILE_NAME),i=await readVercelJsonConfig(n),a=resolveRelativeEntrypoint(t.nuxtRoot,t.appRoot),o=i.experimentalServices??{},s=findServiceByFramework(o,`ash`),c=findServiceByFramework(o,`nuxtjs`),l=s?.routePrefix??t.servicePrefix,u={...o};c===void 0&&(u.web={entrypoint:`.`,framework:`nuxtjs`,routePrefix:`/`}),s===void 0&&(u.ash={buildCommand:t.ashBuildCommand,entrypoint:a,framework:`ash`,routePrefix:l});let d={...i,$schema:i.$schema??`https://openapi.vercel.sh/vercel.json`,experimentalServices:u};return JSON.stringify(i)!==JSON.stringify(d)&&await writeFile(n,`${JSON.stringify(d,null,2)}\n`),{servicePrefix:l}}export{ensureAshVercelJson};

package/dist/src/public/sveltekit/dev-server.d.ts

@@ -0,0 +1,24 @@
+import { type ChildProcess } from "node:child_process";
+export declare const ASH_BASE_URL_ENV = "ASH_BASE_URL";
+export interface AshProcessHandle {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+}
+export interface AshDevServerRegistry {
+    readonly appRoot: string;
+    readonly origin: string;
+    readonly pid: number | null;
+    readonly updatedAt: string;
+}
+/**
+ * Parse and validate a persisted dev-server registry record. Returns
+ * `undefined` for anything that is not a well-formed registry so callers fall
+ * back to spawning a fresh server.
+ */
+export declare function normalizeDevServerRegistry(value: unknown): AshDevServerRegistry | undefined;
+/**
+ * Resolve a shared Ash dev server for {@link appRoot}, reusing a healthy
+ * registered server when one exists and otherwise spawning a new one behind a
+ * cross-process lock so concurrent SvelteKit processes don't each boot Ash.
+ */
+export declare function resolveSharedAshDevServer(appRoot: string): Promise<AshProcessHandle>;

package/dist/src/public/sveltekit/dev-server.js

@@ -0,0 +1 @@
+import{joinRoutePrefix,normalizeOrigin}from"./routing.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{join}from"node:path";import{mkdir,open,readFile,rm,stat,writeFile}from"node:fs/promises";import{spawn}from"node:child_process";import{resolvePackageRoot}from"#internal/application/package.js";const ASH_BASE_URL_ENV=`ASH_BASE_URL`,DEFAULT_SERVER_READY_TIMEOUT_MS=3e4,DEV_SERVER_REGISTRY_TIMEOUT_MS=3e4,LOCAL_SERVER_URL_PATTERN=/https?:\/\/(?:\[[^\]\s]+\]|[^\s/:[\]]+)(?::\d+)?/;function isNodeErrorWithCode(e,t){return e instanceof Error&&`code`in e&&e.code===t}function delay(e){return new Promise(t=>setTimeout(t,e))}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function resolveAshCacheDirectory(e){return join(e,`.ash`)}function resolveAshDevServerRegistryPath(e){return join(resolveAshCacheDirectory(e),`sveltekit-dev-server.json`)}function resolveAshDevServerLockPath(e){return join(resolveAshCacheDirectory(e),`sveltekit-dev-server.lock`)}function normalizeDevServerRegistry(e){if(isRecord(e)&&!(typeof e.appRoot!=`string`||typeof e.origin!=`string`||typeof e.updatedAt!=`string`)&&!(e.pid!==null&&typeof e.pid!=`number`))try{return{appRoot:e.appRoot,origin:normalizeOrigin(e.origin),pid:e.pid,updatedAt:e.updatedAt}}catch{return}}async function isAshServerHealthy(t){let r=new AbortController,i=setTimeout(()=>r.abort(),1e3);try{return(await fetch(joinRoutePrefix(t,`${ASH_ROUTE_PREFIX}/health`),{signal:r.signal})).ok}catch{return!1}finally{clearTimeout(i)}}async function readUsableAshDevServerRegistry(e){try{let t=normalizeDevServerRegistry(JSON.parse(await readFile(resolveAshDevServerRegistryPath(e),`utf8`)));return t===void 0||t.appRoot!==e||!await isAshServerHealthy(t.origin)?void 0:t.origin}catch(e){if(isNodeErrorWithCode(e,`ENOENT`))return;throw e}}async function writeAshDevServerRegistry(e,t){await mkdir(resolveAshCacheDirectory(e),{recursive:!0}),await writeFile(resolveAshDevServerRegistryPath(e),`${JSON.stringify({appRoot:e,origin:t.origin,pid:t.process?.pid??null,updatedAt:new Date().toISOString()},null,2)}\n`)}async function removeStaleAshDevServerLock(e){try{let t=await stat(e);Date.now()-t.mtimeMs>3e4&&await rm(e,{force:!0})}catch(e){if(!isNodeErrorWithCode(e,`ENOENT`))throw e}}async function acquireAshDevServerLock(e){let t=resolveAshCacheDirectory(e),n=resolveAshDevServerLockPath(e),r=Date.now()+DEV_SERVER_REGISTRY_TIMEOUT_MS;for(await mkdir(t,{recursive:!0});;)try{let e=await open(n,`wx`);return await e.writeFile(`${String(process.pid)}\n`),await e.close(),async()=>{await rm(n,{force:!0})}}catch(t){if(!isNodeErrorWithCode(t,`EEXIST`))throw t;if(await readUsableAshDevServerRegistry(e)!==void 0)return async()=>{};if(await removeStaleAshDevServerLock(n),Date.now()>r)throw Error(`Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another SvelteKit process to start Ash.`);await delay(100)}}function createAshBinaryPath(){return join(resolvePackageRoot(),`bin`,`ash.js`)}function startServerProcess(e){return new Promise((n,r)=>{let i=spawn(e.command,e.args,{cwd:e.cwd,env:{...process.env,...e.env},stdio:[`ignore`,`pipe`,`pipe`]}),a=setTimeout(()=>{i.kill(),r(Error(`Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for Ash to print its server URL.`))},DEFAULT_SERVER_READY_TIMEOUT_MS),cleanup=()=>{clearTimeout(a),i.off(`error`,handleError),i.off(`exit`,handleEarlyExit)},handleError=e=>{cleanup(),r(e)},handleEarlyExit=(e,t)=>{cleanup(),r(Error(`Ash server process exited before printing its server URL (code ${String(e)}, signal ${String(t)}).`))},o=!1,handleOutput=e=>{if(o)return;let r=LOCAL_SERVER_URL_PATTERN.exec(e.toString(`utf8`));r!==null&&(o=!0,cleanup(),n({origin:normalizeOrigin(r[0]),process:i}))};i.once(`error`,handleError),i.once(`exit`,handleEarlyExit),i.stdout.on(`data`,e=>{process.stdout.write(e),handleOutput(e)}),i.stderr.on(`data`,e=>{process.stderr.write(e),handleOutput(e)})})}function installProcessShutdown(e){let t=e.process;if(t===void 0)return e;let close=()=>{process.off(`beforeExit`,close),process.off(`exit`,close),t.killed||t.kill()};return process.once(`beforeExit`,close),process.once(`exit`,close),e}function startAshDevServer(e){return startServerProcess({args:[createAshBinaryPath(),`dev`,`--no-repl`,`--port`,`0`],command:process.execPath,cwd:e}).then(e=>(process.env[ASH_BASE_URL_ENV]=e.origin,installProcessShutdown(e)))}async function resolveSharedAshDevServer(e){let t=await readUsableAshDevServerRegistry(e);if(t!==void 0)return process.env[ASH_BASE_URL_ENV]=t,{origin:t};let n=await acquireAshDevServerLock(e);try{let t=await readUsableAshDevServerRegistry(e);if(t!==void 0)return process.env[ASH_BASE_URL_ENV]=t,{origin:t};let n=await startAshDevServer(e);return await writeAshDevServerRegistry(e,n),n}finally{await n()}}export{ASH_BASE_URL_ENV,normalizeDevServerRegistry,resolveSharedAshDevServer};

package/dist/src/public/sveltekit/index.d.ts

@@ -0,0 +1,39 @@
+import type { Plugin } from "vite";
+import { ASH_SVELTEKIT_SERVICE_PREFIX } from "./routing.js";
+export { ASH_SVELTEKIT_SERVICE_PREFIX };
+/**
+ * Options for the Ash SvelteKit Vite plugin.
+ */
+export interface AshSvelteKitPluginOptions {
+    /**
+     * Path to the Ash application root, relative to the SvelteKit project root
+     * unless absolute. Defaults to the SvelteKit project root.
+     */
+    readonly ashRoot?: string;
+    /**
+     * Build command for the generated Ash Vercel service.
+     * Defaults to `"ash build"`.
+     */
+    readonly ashBuildCommand?: string;
+    /**
+     * Set to `false` to skip creating or updating `vercel.json`.
+     *
+     * By default the plugin ensures `vercel.json` contains `experimentalServices`
+     * for the SvelteKit app and Ash app.
+     */
+    readonly configureVercelJson?: boolean;
+    /**
+     * Private Vercel service prefix for the Ash deployment. Must match the
+     * Ash service's `routePrefix` in `vercel.json`.
+     */
+    readonly servicePrefix?: string;
+}
+/**
+ * Vite plugin for running an Ash agent alongside a SvelteKit app.
+ *
+ * In development and local preview, `ashSvelteKit` starts
+ * `ash dev --no-repl --port 0` for the Ash app and proxies Ash protocol
+ * endpoints to that local URL. During builds it can ensure `vercel.json`
+ * deploys the SvelteKit app and Ash agent as sibling Vercel services.
+ */
+export declare function ashSvelteKit(options?: AshSvelteKitPluginOptions): Plugin;

package/dist/src/public/sveltekit/index.js

@@ -0,0 +1 @@
+import{ASH_SVELTEKIT_SERVICE_PREFIX,normalizeOrigin,normalizeRoutePrefix}from"./routing.js";import{ASH_BASE_URL_ENV,resolveSharedAshDevServer}from"./dev-server.js";import{ensureAshVercelJson}from"./vercel-json.js";import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{isAbsolute,resolve}from"node:path";function resolveApplicationRoot(e,t){return t===void 0||t.length===0?e:isAbsolute(t)?t:resolve(e,t)}function mergeProxyConfig(e,t){return{...e,[ASH_ROUTE_PREFIX]:{changeOrigin:!0,target:t}}}async function resolveAshDevProxyTarget(e){let n=process.env[ASH_BASE_URL_ENV]?.trim();return n&&n.length>0?normalizeOrigin(n):(await resolveSharedAshDevServer(e)).origin}function ashSvelteKit(e={}){let t=process.cwd(),r=resolveApplicationRoot(t,e.ashRoot),i=normalizeRoutePrefix(e.servicePrefix??`/_ash_internal/ash`),a=e.configureVercelJson!==!1;return{name:`experimental-ash:sveltekit`,async config(n,o){if(t=n.root===void 0?process.cwd():resolve(process.cwd(),n.root),r=resolveApplicationRoot(t,e.ashRoot),a&&o.command===`build`&&await ensureAshVercelJson({appRoot:r,ashBuildCommand:e.ashBuildCommand??`ash build`,servicePrefix:i,svelteKitRoot:t}),o.command!==`serve`)return{};let s=await resolveAshDevProxyTarget(r);return o.isPreview?{preview:{proxy:mergeProxyConfig(n.preview?.proxy,s)}}:{server:{proxy:mergeProxyConfig(n.server?.proxy,s)}}}}}export{ASH_SVELTEKIT_SERVICE_PREFIX,ashSvelteKit};

package/dist/src/public/sveltekit/routing.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Private route namespace used when a Vercel deployment hosts Ash as a
+ * separate experimental service behind the SvelteKit app.
+ */
+export declare const ASH_SVELTEKIT_SERVICE_PREFIX = "/_ash_internal/ash";
+/**
+ * Normalize a user-supplied service prefix into a leading-slash, no-trailing-
+ * slash route. Throws when the prefix resolves to the root route, which would
+ * collide with the SvelteKit web service.
+ */
+export declare function normalizeRoutePrefix(prefix: string): string;
+/**
+ * Join a route prefix and a path with exactly one separating slash.
+ */
+export declare function joinRoutePrefix(prefix: string, path: string): string;
+/**
+ * Reduce an origin string to its canonical `protocol://host[:port]` form.
+ */
+export declare function normalizeOrigin(origin: string): string;
+/**
+ * A Vercel rewrite that forwards Ash transport requests (`/ash/v1/**`) to the
+ * private Ash service prefix (`/_ash_internal/ash/ash/v1/**`).
+ */
+export interface AshVercelRewrite {
+    readonly destination: string;
+    readonly source: string;
+}
+/**
+ * Build the Vercel rewrite that forwards browser Ash transport requests to the
+ * sibling Ash service.
+ */
+export declare function createAshVercelRewrite(servicePrefix: string): AshVercelRewrite;

package/dist/src/public/sveltekit/routing.js

@@ -0,0 +1 @@
+import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";const ASH_SVELTEKIT_SERVICE_PREFIX=`/_ash_internal/ash`;function normalizeRoutePrefix(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/\/+$/,``);if(t.length===0)throw Error(`Ash SvelteKit service prefix cannot resolve to the root route.`);return t}function joinRoutePrefix(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function normalizeOrigin(e){return new URL(e.trim()).origin}function createAshVercelRewrite(t){return{destination:`${joinRoutePrefix(t,ASH_ROUTE_PREFIX)}/:path*`,source:`${ASH_ROUTE_PREFIX}/:path*`}}export{ASH_SVELTEKIT_SERVICE_PREFIX,createAshVercelRewrite,joinRoutePrefix,normalizeOrigin,normalizeRoutePrefix};

package/dist/src/public/sveltekit/vercel-json.d.ts

@@ -0,0 +1,17 @@
+export interface EnsureVercelJsonResult {
+    readonly servicePrefix: string;
+}
+/**
+ * Ensure `vercel.json` declares the SvelteKit web service and the Ash agent
+ * service so a Vercel deployment ships both from one project.
+ *
+ * Existing services are preserved untouched; an already-configured Ash
+ * service's `routePrefix` wins over {@link input.servicePrefix}. The file is
+ * only rewritten when the resulting config differs from what is on disk.
+ */
+export declare function ensureAshVercelJson(input: {
+    readonly appRoot: string;
+    readonly ashBuildCommand: string;
+    readonly servicePrefix: string;
+    readonly svelteKitRoot: string;
+}): Promise<EnsureVercelJsonResult>;

package/dist/src/public/sveltekit/vercel-json.js

@@ -0,0 +1 @@
+import{createAshVercelRewrite}from"./routing.js";import{join,relative}from"node:path";import{readFile,writeFile}from"node:fs/promises";const VERCEL_JSON_FILE_NAME=`vercel.json`;function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function resolveRelativeEntrypoint(e,t){let r=relative(e,t);return r.length===0?`.`:r.replaceAll(`\\`,`/`)}function normalizeVercelJsonConfig(e){if(!isRecord(e))throw Error(`${VERCEL_JSON_FILE_NAME} must contain a JSON object.`);let t=e.experimentalServices;if(t!==void 0&&!isRecord(t))throw Error(`${VERCEL_JSON_FILE_NAME} experimentalServices must be a JSON object.`);let n=e.rewrites;if(n!==void 0&&!Array.isArray(n))throw Error(`${VERCEL_JSON_FILE_NAME} rewrites must be an array.`);return e}async function readVercelJsonConfig(e){try{return normalizeVercelJsonConfig(JSON.parse(await readFile(e,`utf8`)))}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return{};throw e}}function findServiceByFramework(e,t){return Object.values(e).find(e=>e.framework===t)}function hasRewrite(e,t){return e.some(e=>e.source===t.source&&e.destination===t.destination)}async function ensureAshVercelJson(n){let r=join(n.svelteKitRoot,VERCEL_JSON_FILE_NAME),i=await readVercelJsonConfig(r),a=resolveRelativeEntrypoint(n.svelteKitRoot,n.appRoot),o=i.experimentalServices??{},s=findServiceByFramework(o,`ash`),c=findServiceByFramework(o,`sveltekit`),l=s?.routePrefix??n.servicePrefix,u={...o};c===void 0&&(u.web={entrypoint:`.`,framework:`sveltekit`,routePrefix:`/`}),s===void 0&&(u.ash={buildCommand:n.ashBuildCommand,entrypoint:a,framework:`ash`,routePrefix:l});let d=createAshVercelRewrite(l),f=i.rewrites??[],p={...i,$schema:i.$schema??`https://openapi.vercel.sh/vercel.json`,experimentalServices:u,rewrites:hasRewrite(f,d)?f:[d,...f]};return JSON.stringify(i)!==JSON.stringify(p)&&await writeFile(r,`${JSON.stringify(p,null,2)}\n`),{servicePrefix:l}}export{ensureAshVercelJson};

package/dist/src/react/use-ash-agent.d.ts

@@ -1,36 +1,15 @@
+import { type AshAgentStoreCallbacks, type AshAgentStoreSnapshot, type AshAgentStoreStatus, type PrepareSend } from "#client/ash-agent-store.js";
 import type { AshAgentReducer } from "#client/reducer.js";
 import type { ClientSession } from "#client/session.js";
 import { type AshMessageData } from "#client/message-reducer.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { ClientAuth, HeadersValue, SendMessageOptions, SendTurnInput, SessionState } from "#client/types.js";
-export type UseAshAgentStatus = "error" | "ready" | "streaming" | "submitted";
-/**
- * Prepares one outbound turn immediately before the client sends it.
- *
- * Use this to attach fresh, one-turn client state such as page context via
- * `clientContext`.
- */
-export type PrepareSend = (input: SendTurnInput) => SendTurnInput | Promise<SendTurnInput>;
+export type { PrepareSend };
+export type UseAshAgentStatus = AshAgentStoreStatus;
 /**
  * Current projected state for an Ash agent session.
  */
-export interface UseAshAgentSnapshot<TData> {
-    readonly data: TData;
-    readonly error: Error | undefined;
-    readonly events: readonly HandleMessageStreamEvent[];
-    readonly session: SessionState;
-    readonly status: UseAshAgentStatus;
-}
-/**
- * Lifecycle callbacks invoked while `useAshAgent` processes a turn.
- */
-interface UseAshAgentCallbacks<TData> {
-    readonly onError?: (error: Error) => void;
-    readonly onEvent?: (event: HandleMessageStreamEvent) => void;
-    readonly onFinish?: (snapshot: UseAshAgentSnapshot<TData>) => void;
-    readonly onSessionChange?: (session: SessionState) => void;
-    readonly prepareSend?: PrepareSend;
-}
+export type UseAshAgentSnapshot<TData> = AshAgentStoreSnapshot<TData>;
 /**
  * Snapshot plus commands returned by `useAshAgent`.
  */
@@ -52,7 +31,7 @@ export interface UseAshAgentHelpers<TData> extends UseAshAgentSnapshot<TData> {
  * values to `auth` or `headers`; the underlying client resolves those before
  * each HTTP request.
  */
-export interface UseAshAgentOptions<TData> extends UseAshAgentCallbacks<TData> {
+export interface UseAshAgentOptions<TData> extends AshAgentStoreCallbacks<TData> {
     readonly auth?: ClientAuth;
     readonly headers?: HeadersValue;
     /**
@@ -85,4 +64,3 @@ export declare function useAshAgent(options?: UseAshAgentOptions<AshMessageData>
 export declare function useAshAgent<TData>(options: UseAshAgentOptions<TData> & {
     readonly reducer: AshAgentReducer<TData>;
 }): UseAshAgentHelpers<TData>;
-export {};

package/dist/src/react/use-ash-agent.js

@@ -1,2 +1 @@
-import{toError}from"#shared/errors.js";import{Client}from"#client/client.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{useCallback,useMemo,useRef,useSyncExternalStore}from"react";function useAshAgent(e={}){let t=useRef(void 0);if(!t.current){let r=e.reducer??defaultMessageReducer();t.current=new UseAshAgentStore({auth:e.auth,headers:e.headers,host:e.host,initialEvents:e.initialEvents,initialSession:e.initialSession,maxReconnectAttempts:e.maxReconnectAttempts,optimistic:e.optimistic,reducer:r,session:e.session})}let s=t.current;s.setCallbacks({onError:e.onError,onEvent:e.onEvent,onFinish:e.onFinish,onSessionChange:e.onSessionChange,prepareSend:e.prepareSend});let c=useSyncExternalStore(useCallback(e=>s.subscribe(e),[s]),()=>s.snapshot,()=>s.snapshot),l=useCallback(()=>s.reset(),[s]),u=useCallback((e,t)=>s.send(e,t),[s]),d=useCallback((e,t)=>s.sendMessage(e,t),[s]),f=useCallback(()=>s.stop(),[s]);return useMemo(()=>({...c,reset:l,send:u,sendMessage:d,stop:f}),[l,u,d,c,f])}var UseAshAgentStore=class{#e;#t;#n;#r=new Set;#i;#a={};#o;#s;#c;#l=0;#u;#d;#f;#p;#m=`ready`;constructor(e){this.#e=e.session?void 0:()=>new Client({auth:e.auth,headers:e.headers,host:e.host??``,maxReconnectAttempts:e.maxReconnectAttempts}).session(e.initialSession),this.#c=[...e.initialEvents??[]],this.#d=[...this.#c],this.#t=e.optimistic??!0,this.#n=e.reducer,this.#f=e.session??this.#h(),this.#o=this.#E(this.#d),this.#p=this.#D()}get snapshot(){return this.#p}setCallbacks(e){this.#a=e}subscribe(e){return this.#r.add(e),()=>{this.#r.delete(e)}}async sendMessage(e,t){await this.send({message:e},t)}async send(t,n){if(this.#m===`streaming`||this.#m===`submitted`)throw Error(`Ash session is already processing a turn.`);let r=this.#g(),i=new AbortController;this.#i=i,this.#s=void 0,this.#m=`submitted`,this.#O();try{let e=await this.#a.prepareSend?.(t)??t;if(!this.#v(r))return;this.#y(e),this.#b(e),this.#O();let a=await this.#f.send(e,{...n,signal:createAbortSignal(n?.signal,i.signal)}),o=!1;for await(let e of a){if(!this.#v(r))return;o||(o=!0,this.#m=`streaming`),this.#c=[...this.#c,e],this.#x(e),this.#a.onEvent?.(e),this.#S(e),this.#O()}if(!this.#v(r))return;this.#m=this.#s===void 0?`ready`:`error`}catch(t){if(!this.#v(r))return;isAbortError(t)?(this.#m=`ready`,this.#C(toError(t))):(this.#s=toError(t),this.#m=`error`,this.#C(this.#s),this.#a.onError?.(this.#s))}finally{this.#v(r)&&(this.#i=void 0,this.#a.onSessionChange?.(this.#f.state),this.#O(),this.#a.onFinish?.(this.#p))}}stop(){this.#i?.abort()}reset(){this.#_(),this.stop(),this.#i=void 0,this.#f=this.#e?.()??this.#f,this.#c=[],this.#u=void 0,this.#d=[],this.#o=this.#n.initial(),this.#s=void 0,this.#m=`ready`,this.#a.onSessionChange?.(this.#f.state),this.#O()}#h(){if(!this.#e)throw Error(`Cannot create an owned Ash session from an external session.`);return this.#e()}#g(){return this.#l+=1,this.#l}#_(){this.#l+=1}#v(e){return this.#l===e}#y(e){if(!this.#t||e.message===void 0)return;let t=createSubmissionId(),n={createdAt:Date.now(),id:t,message:summarizeUserContent(e.message)};this.#u=n,this.#w({data:{createdAt:n.createdAt,message:n.message,submissionId:n.id},type:`client.message.submitted`})}#b(e){e.inputResponses===void 0||e.inputResponses.length===0||this.#w({data:{createdAt:Date.now(),responses:e.inputResponses},type:`client.input.responded`})}#x(e){if(e.type===`message.received`&&this.#u!==void 0){let t=this.#u.id;this.#u=void 0,this.#T(e=>e.type===`client.message.submitted`&&e.data.submissionId===t,e);return}this.#w(e)}#S(e){let t=toTerminalStreamFailureError(e);t!==void 0&&(this.#m=`error`,this.#C(t),this.#s===void 0&&(this.#s=t,this.#a.onError?.(t)))}#C(e){let t=this.#u;t!==void 0&&(this.#u=void 0,this.#T(e=>e.type===`client.message.submitted`&&e.data.submissionId===t.id,{data:{createdAt:t.createdAt,error:{message:e.message},message:t.message,submissionId:t.id},type:`client.message.failed`}))}#w(e){this.#d=[...this.#d,e],this.#o=this.#n.reduce(this.#o,e)}#T(e,t){let n=!1;this.#d=this.#d.map(r=>!n&&e(r)?(n=!0,t):r),n||(this.#d=[...this.#d,t]),this.#o=this.#E(this.#d)}#E(e){let t=this.#n.initial();for(let n of e)t=this.#n.reduce(t,n);return t}#D(){return{data:this.#o,error:this.#s,events:this.#c,session:this.#f.state,status:this.#m}}#O(){this.#p=this.#D();for(let e of this.#r)e()}};let submissionSequence=0;function createSubmissionId(){let e=globalThis.crypto?.randomUUID;return e===void 0?(submissionSequence+=1,`submission_${submissionSequence.toString()}`):e.call(globalThis.crypto)}function createAbortSignal(e,t){return e?AbortSignal.any([e,t]):t}function summarizeUserContent(e){if(typeof e==`string`)return e;let t=[];for(let n of e){if(n.type===`text`){t.push(n.text);continue}n.type===`file`&&t.push(n.filename?`[file: ${n.filename}]`:`[file]`)}return t.join(`
-`)}function isAbortError(e){return e instanceof Error&&e.name===`AbortError`}function toTerminalStreamFailureError(e){if(e.type!==`session.failed`)return;let t=Error(e.data.message);return t.name=e.data.code,t}export{useAshAgent};
+import{AshAgentStore}from"#client/ash-agent-store.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{useCallback,useMemo,useRef,useSyncExternalStore}from"react";function useAshAgent(r={}){let i=useRef(void 0);if(!i.current){let n=r.reducer??defaultMessageReducer();i.current=new AshAgentStore({auth:r.auth,headers:r.headers,host:r.host,initialEvents:r.initialEvents,initialSession:r.initialSession,maxReconnectAttempts:r.maxReconnectAttempts,optimistic:r.optimistic,reducer:n,session:r.session})}let a=i.current;a.setCallbacks({onError:r.onError,onEvent:r.onEvent,onFinish:r.onFinish,onSessionChange:r.onSessionChange,prepareSend:r.prepareSend});let o=useSyncExternalStore(useCallback(e=>a.subscribe(e),[a]),()=>a.snapshot,()=>a.snapshot),s=useCallback(()=>a.reset(),[a]),c=useCallback((e,t)=>a.send(e,t),[a]),l=useCallback((e,t)=>a.sendMessage(e,t),[a]),u=useCallback(()=>a.stop(),[a]);return useMemo(()=>({...o,reset:s,send:c,sendMessage:l,stop:u}),[s,c,l,o,u])}export{useAshAgent};

package/dist/src/runtime/connections/openapi-client.d.ts

@@ -0,0 +1,43 @@
+import { type ToolSet } from "ai";
+import type { ResolvedConnectionDefinition } from "#runtime/types.js";
+import { type OpenApiOperation } from "#runtime/connections/openapi-operations.js";
+import type { ConnectionClient, ConnectionToolMetadata } from "#runtime/connections/types.js";
+interface OpenApiToolCache {
+    readonly metadata: readonly ConnectionToolMetadata[];
+    readonly operations: ReadonlyMap<string, OpenApiOperation>;
+    readonly tools: ToolSet;
+    readonly baseUrl: string;
+}
+/**
+ * Result of executing an OpenAPI operation. Returned to the model as the
+ * tool result so it can react to the status and body of any response,
+ * including non-2xx responses.
+ */
+export interface OpenApiToolResult {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: unknown;
+}
+/**
+ * A {@link ConnectionClient} that turns an OpenAPI 3.x document into
+ * connection tools.
+ *
+ * Created lazily per-connection per-session. On first use it loads the
+ * document (fetching it when `spec` is a URL), dereferences local
+ * `$ref` pointers, and maps each operation to a tool whose name is the
+ * operation's `operationId`. Tool calls reconstruct the HTTP request —
+ * substituting path parameters, appending query parameters, attaching
+ * resolved auth and headers — and return the response as a serializable
+ * `{ status, statusText, body }`.
+ */
+export declare class OpenApiConnectionClient implements ConnectionClient {
+    #private;
+    constructor(connection: ResolvedConnectionDefinition);
+    /** Loads and parses the OpenAPI document, sharing one in-flight load. */
+    connect(): Promise<OpenApiToolCache>;
+    getToolMetadata(): Promise<readonly ConnectionToolMetadata[]>;
+    getTools(): Promise<ToolSet>;
+    executeTool(toolName: string, args: unknown): Promise<OpenApiToolResult>;
+    close(): Promise<void>;
+}
+export {};

package/dist/src/runtime/connections/openapi-client.js

@@ -0,0 +1 @@
+import{isObject}from"#shared/guards.js";import{jsonSchema,tool}from"ai";import{passesToolFilter,resolveHeaders}from"#runtime/connections/mcp-client.js";import{HTTP_METHODS,operationDescription,operationName,uniqueName}from"#runtime/connections/openapi-operations.js";import{buildInputSchema,deref,derefSchema,isArray}from"#runtime/connections/openapi-schema.js";import{applySecurity,resolveSecurity}from"#runtime/connections/openapi-security.js";import{extractServerUrl,parseSpecDocument}from"#runtime/connections/openapi-spec.js";var OpenApiConnectionClient=class{#e;#t;#n;constructor(e){this.#n=e}async connect(){return this.#r()}async getToolMetadata(){return(await this.#r()).metadata}async getTools(){return(await this.#r()).tools}async executeTool(t,n){let r=await this.#r(),i=r.operations.get(t);if(i===void 0)throw Error(`Tool "${t}" not found in connection "${this.#n.connectionName}".`);return this.#u(i,r.baseUrl,isObject(n)?n:{})}async close(){this.#e=void 0,this.#t=void 0}async#r(){if(this.#t!==void 0)return this.#t;if(this.#e!==void 0)return this.#e;this.#e=this.#i();try{return this.#t=await this.#e,this.#t}catch(e){throw this.#e=void 0,e}}async#i(){let i=await this.#o(),a=this.#a(i),o=this.#s(i),s=this.#n.tools,c=s===void 0?o:o.filter(e=>passesToolFilter(e.toolName,s)),l=[],u=new Map,d={};for(let r of c)u.set(r.toolName,r),l.push({description:r.description,inputSchema:r.inputSchema,name:r.toolName}),d[r.toolName]=tool({description:r.description,inputSchema:jsonSchema(r.inputSchema),execute:async t=>this.#u(r,a,isObject(t)?t:{})});return{metadata:l,operations:u,tools:d,baseUrl:a}}#a(e){let t=this.#n.url;if(typeof t==`string`&&t.trim().length>0)return t;let n=extractServerUrl(e,this.#n.spec);if(n!==void 0)return n;throw Error(`OpenAPI connection "${this.#n.connectionName}" has no base URL: set "baseUrl" or ensure the document declares an absolute "servers" entry.`)}async#o(){let t=this.#n.spec;if(t===void 0)throw Error(`OpenAPI connection "${this.#n.connectionName}" is missing its "spec" source.`);if(typeof t!=`string`)return t;let n;try{n=await fetch(t,{headers:{accept:`application/json, application/yaml, text/yaml, */*`}})}catch(e){throw Error(`OpenAPI connection "${this.#n.connectionName}" failed to fetch its spec from "${t}": ${String(e)}`)}if(!n.ok)throw Error(`OpenAPI connection "${this.#n.connectionName}" failed to fetch its spec from "${t}": HTTP ${n.status}.`);let r=await n.text(),i;try{i=parseSpecDocument(r)}catch(e){throw Error(`OpenAPI connection "${this.#n.connectionName}" spec at "${t}" could not be parsed as JSON or YAML: ${String(e)}`)}if(!isObject(i))throw Error(`OpenAPI connection "${this.#n.connectionName}" spec at "${t}" is not an OpenAPI document object.`);return i}#s(t){let n=t.paths;if(!isObject(n))return[];let r=[],i=new Set;for(let[u,d]of Object.entries(n)){if(!isObject(d))continue;let n=isArray(d.parameters)?d.parameters:[];for(let f of HTTP_METHODS){let a=d[f];if(!isObject(a))continue;let p=uniqueName(operationName(a,f,u),i),m=isArray(a.parameters)?a.parameters:[],h=this.#c(t,[...n,...m]),g=this.#l(t,a.requestBody);r.push({toolName:p,method:f,pathTemplate:u,description:operationDescription(a),parameters:h,requestBody:g,inputSchema:buildInputSchema(h,g),security:resolveSecurity(t,a)})}}return r}#c(t,n){let r=[];for(let i of n){let n=isObject(i)?deref(t,i):i;if(!isObject(n))continue;let a=n.in;if(a!==`path`&&a!==`query`&&a!==`header`&&a!==`cookie`||typeof n.name!=`string`)continue;let o=isObject(n.schema)?derefSchema(t,n.schema):{};r.push({name:n.name,location:a,required:n.required===!0||a===`path`,schema:o,description:typeof n.description==`string`?n.description:void 0})}return r}#l(t,n){if(!isObject(n))return;let r=deref(t,n);if(!isObject(r)||!isObject(r.content))return;let i=r.content,a=`application/json`in i?`application/json`:Object.keys(i)[0];if(a===void 0)return;let o=i[a],s=isObject(o)&&isObject(o.schema)?derefSchema(t,o.schema):{};return{required:r.required===!0,contentType:a,schema:s}}async#u(e,t,n){let r=await resolveHeaders(this.#n),a=e.pathTemplate,o=new URLSearchParams,s=[];for(let t of e.parameters){let e=n[t.name];e!=null&&(t.location===`path`?a=a.replace(`{${t.name}}`,encodeURIComponent(String(e))):t.location===`query`?appendQuery(o,t.name,e):t.location===`cookie`?s.push(`${t.name}=${encodeURIComponent(String(e))}`):r[t.name]=String(e))}if(applySecurity(e.security,this.#n,r,o,s),s.length>0){let e=r.cookie??r.Cookie;delete r.Cookie,r.cookie=[e,...s].filter(e=>!!e).join(`; `)}let c=new URL(joinPath(t,a));c.search=o.toString();let l;e.requestBody!==void 0&&n.body!==void 0&&(l=JSON.stringify(n.body),r[`content-type`]=e.requestBody.contentType);let u=await fetch(c,{method:e.method.toUpperCase(),headers:r,body:l});return{status:u.status,statusText:u.statusText,body:await readResponseBody(u)}}};function appendQuery(e,t,n){if(isArray(n)){for(let r of n)e.append(t,String(r));return}e.append(t,String(n))}function joinPath(e,t){return`${e.endsWith(`/`)?e.slice(0,-1):e}${t.startsWith(`/`)?t:`/${t}`}`}async function readResponseBody(e){let t=await e.text();if(t.length===0)return null;if((e.headers.get(`content-type`)??``).includes(`application/json`))try{return JSON.parse(t)}catch{return t}return t}export{OpenApiConnectionClient};

package/dist/src/runtime/connections/openapi-operations.d.ts

@@ -0,0 +1,30 @@
+import type { OpenApiParameter, OpenApiRequestBody } from "#runtime/connections/openapi-schema.js";
+import type { SecurityPlacement } from "#runtime/connections/openapi-security.js";
+/** HTTP methods OpenAPI defines operations for. */
+export declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "patch", "head", "options"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+/** Internal descriptor for one resolved OpenAPI operation. */
+export interface OpenApiOperation {
+    readonly toolName: string;
+    readonly method: HttpMethod;
+    readonly pathTemplate: string;
+    readonly description: string;
+    readonly parameters: readonly OpenApiParameter[];
+    readonly requestBody: OpenApiRequestBody | undefined;
+    readonly inputSchema: Record<string, unknown>;
+    readonly security: SecurityPlacement | undefined;
+}
+/**
+ * Derives a tool name for an operation that is legal for model providers.
+ *
+ * Provider tool-name rules (Anthropic, OpenAI) only permit
+ * `[a-zA-Z0-9_-]`, so an `operationId` is sanitized rather than used
+ * verbatim — characters like dots or slashes (common in real specs)
+ * would otherwise be rejected and break the whole connection. Operations
+ * without an `operationId` get a deterministic `<method>_<path>` name.
+ */
+export declare function operationName(operation: Record<string, unknown>, method: HttpMethod, pathTemplate: string): string;
+/** Disambiguates a tool name against names already used in the same connection. */
+export declare function uniqueName(name: string, used: Set<string>): string;
+/** Picks a human description for an operation, preferring `summary` over `description`. */
+export declare function operationDescription(operation: Record<string, unknown>): string;

package/dist/src/runtime/connections/openapi-operations.js

@@ -0,0 +1 @@
+const HTTP_METHODS=[`get`,`put`,`post`,`delete`,`patch`,`head`,`options`];function operationName(e,t,n){if(typeof e.operationId==`string`&&e.operationId.length>0){let t=sanitizeToolName(e.operationId);if(t.length>0)return t}return sanitizeToolName(`${t}_${n.replace(/[{}]/g,``).replace(/[^a-zA-Z0-9]+/g,`_`).replace(/^_+|_+$/g,``)}`)}function sanitizeToolName(e){return e.replace(/[^a-zA-Z0-9_-]+/g,`_`).replace(/^[_-]+|[_-]+$/g,``).slice(0,64)}function uniqueName(e,t){let n=e,r=2;for(;t.has(n);)n=`${e}_${r}`,r+=1;return t.add(n),n}function operationDescription(e){return typeof e.summary==`string`&&e.summary.length>0?e.summary:typeof e.description==`string`?e.description:``}export{HTTP_METHODS,operationDescription,operationName,uniqueName};

package/dist/src/runtime/connections/openapi-schema.d.ts

@@ -0,0 +1,39 @@
+/** A path, query, header, or cookie parameter resolved from an operation. */
+export interface OpenApiParameter {
+    readonly name: string;
+    readonly location: "path" | "query" | "header" | "cookie";
+    readonly required: boolean;
+    readonly schema: Record<string, unknown>;
+    readonly description?: string;
+}
+/** A request body resolved from an operation. */
+export interface OpenApiRequestBody {
+    readonly required: boolean;
+    readonly contentType: string;
+    readonly schema: Record<string, unknown>;
+}
+/**
+ * Builds the combined JSON Schema the model fills in: each path, query,
+ * and header parameter becomes a top-level property; the request body
+ * (when present) is nested under `body`.
+ */
+export declare function buildInputSchema(parameters: readonly OpenApiParameter[], requestBody: OpenApiRequestBody | undefined): Record<string, unknown>;
+/** Resolves a single `$ref` node one hop; returns the node unchanged otherwise. */
+export declare function deref(document: Record<string, unknown>, node: Record<string, unknown>): unknown;
+/**
+ * Deeply resolves local `$ref` pointers in a JSON Schema, truncating
+ * `$ref` cycles and over-deep nesting so the result stays finite and
+ * serializable.
+ *
+ * Truncation only ever happens at an **object** node — which is always a
+ * schema position — by replacing it with an empty schema (`{}`). Scalars
+ * (`type` strings, `required` entries, `enum` values) pass through
+ * unchanged and arrays are always preserved as arrays, so array-valued
+ * keywords like `oneOf`/`anyOf`/`allOf` and `type: [..., "null"]` keep
+ * their shape. This keeps the output valid JSON Schema (draft 2020-12)
+ * for strict model providers, while the depth bound prevents recursive
+ * specs (e.g. Notion blocks) from expanding without limit.
+ */
+export declare function derefSchema(document: Record<string, unknown>, node: unknown, depth?: number, seen?: ReadonlySet<string>): unknown;
+/** Narrows `unknown` to a readonly array, used pervasively when duck-typing spec nodes. */
+export declare function isArray(value: unknown): value is readonly unknown[];

package/dist/src/runtime/connections/openapi-schema.js

@@ -0,0 +1 @@
+import{isObject}from"#shared/guards.js";function buildInputSchema(e,t){let n={},r=[];for(let t of e)n[t.name]=t.description===void 0?t.schema:{...t.schema,description:t.description},t.required&&r.push(t.name);t!==void 0&&(n.body=t.schema,t.required&&r.push(`body`));let i={type:`object`,properties:n};return r.length>0&&(i.required=r),i}function deref(e,t){return typeof t.$ref==`string`?resolveRef(e,t.$ref)??{}:t}function derefSchema(t,n,r=0,i=new Set){if(isArray(n))return n.map(e=>derefSchema(t,e,r+1,i));if(!isObject(n))return n;if(r>12)return{};if(typeof n.$ref==`string`){if(i.has(n.$ref))return{};let e=resolveRef(t,n.$ref);return e===void 0?{}:derefSchema(t,e,r+1,new Set([...i,n.$ref]))}let a={};for(let[e,o]of Object.entries(n))a[e]=derefSchema(t,o,r+1,i);return normalizeSchemaType(a),normalizeNullable(a),a}const VALID_JSON_SCHEMA_TYPES=new Set([`string`,`number`,`integer`,`boolean`,`object`,`array`,`null`]);function normalizeSchemaType(e){let n=e.type;if(typeof n==`string`&&!VALID_JSON_SCHEMA_TYPES.has(n))delete e.type;else if(isArray(n)){let r=n.filter(e=>typeof e==`string`&&VALID_JSON_SCHEMA_TYPES.has(e));r.length===0?delete e.type:e.type=r}}function normalizeNullable(e){if(!(`nullable`in e))return;let t=e.nullable===!0;if(delete e.nullable,!t)return;let n=e.type;typeof n==`string`?n!==`null`&&(e.type=[n,`null`]):isArray(n)?n.includes(`null`)||(e.type=[...n,`null`]):isArray(e.enum)&&!e.enum.includes(null)&&(e.enum=[...e.enum,null])}function resolveRef(t,n){if(!n.startsWith(`#/`))return;let r=n.slice(2).split(`/`).map(e=>e.replace(/~1/g,`/`).replace(/~0/g,`~`)),i=t;for(let t of r){if(!isObject(i))return;i=i[t]}return i}function isArray(e){return Array.isArray(e)}export{buildInputSchema,deref,derefSchema,isArray};