experimental-ash 0.26.0 → 0.28.0

package/dist/src/internal/nitro/routes/channel-dispatch.js

@@ -1,74 +1 @@
-import { createCrossChannelReceiveFn, toCrossChannelTargets, } from "#channel/cross-channel-receive.js";
-import { createSendFn } from "#channel/send.js";
-import { createGetSessionFn } from "#channel/session.js";
-import { resolveNitroChannelRuntimeBundle } from "#internal/nitro/routes/runtime-stack.js";
-/**
- * Dispatches one channel request identified by `routeKey`.
- *
- * Each channel route is mounted as its own virtual Nitro handler with the
- * route key and artifacts config baked in. Nitro's router matches the URL
- * and populates `event.context.params`, so no custom URL matching is
- * needed — the handler looks up the channel by its `(method, urlPath)` key
- * directly. When routes register background work through `ctx.waitUntil`,
- * Nitro forwards that work to `event.waitUntil()` so webhook
- * acknowledgements can return immediately.
- *
- * Two dispatch shapes: authored channels (`defineChannel` and its
- * wrappers) carry a `handler` field and receive `RouteHandlerArgs` with
- * `send`, `getSession`, etc. Framework-internal channels (the
- * connection callback route) build `ResolvedChannelDefinition` directly
- * with just `fetch` and receive a `RouteContext` carrying `agent`.
- */
-export async function dispatchChannelRequest(event, routeKey, config) {
-    const bundle = await resolveNitroChannelRuntimeBundle(config);
-    const matchedChannel = bundle.channels.find((channel) => `${channel.method.toUpperCase()} ${channel.urlPath}` === routeKey);
-    if (matchedChannel === undefined) {
-        return Response.json({ error: "No matching channel for this request.", ok: false }, { status: 404 });
-    }
-    const requestIp = extractSocketIp(event);
-    const backgroundTasks = [];
-    const rawParams = event.context.params ?? {};
-    const params = {};
-    for (const [key, value] of Object.entries(rawParams)) {
-        params[key] = decodeURIComponent(value);
-    }
-    const waitUntil = (task) => {
-        backgroundTasks.push(task);
-    };
-    let response;
-    if (matchedChannel.handler) {
-        // Authored CompiledChannel route — build RouteHandlerArgs.
-        const adapter = matchedChannel.adapter ?? { kind: "channel" };
-        const send = createSendFn(bundle.runtime, adapter, matchedChannel.name);
-        const getSession = createGetSessionFn(bundle.runtime);
-        const receive = createCrossChannelReceiveFn(bundle.runtime, toCrossChannelTargets(bundle.channels));
-        const args = {
-            send,
-            getSession,
-            receive,
-            params,
-            waitUntil,
-            requestIp,
-        };
-        response = await matchedChannel.handler(event.req, args);
-    }
-    else {
-        // Framework-internal fetch-only channel (e.g. the connection
-        // callback route). Build a RouteContext with the agent handle.
-        const ctx = {
-            agent: bundle.runtime,
-            waitUntil,
-            params,
-            requestIp,
-        };
-        response = await matchedChannel.fetch(event.req, ctx);
-    }
-    if (backgroundTasks.length > 0) {
-        event.waitUntil(Promise.allSettled(backgroundTasks));
-    }
-    return response;
-}
-function extractSocketIp(event) {
-    const ip = event.req.ip;
-    return typeof ip === "string" && ip.length > 0 ? ip : null;
-}
+import{createGetSessionFn}from"#channel/session.js";import{createSendFn}from"#channel/send.js";import{createCrossChannelReceiveFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{resolveNitroChannelRuntimeBundle}from"#internal/nitro/routes/runtime-stack.js";async function dispatchChannelRequest(r,i,a){let o=await resolveNitroChannelRuntimeBundle(a),s=o.channels.find(e=>`${e.method.toUpperCase()} ${e.urlPath}`===i);if(s===void 0)return Response.json({error:`No matching channel for this request.`,ok:!1},{status:404});let c=extractSocketIp(r),l=[],u=r.context.params??{},d={};for(let[e,t]of Object.entries(u))d[e]=decodeURIComponent(t);let waitUntil=e=>{l.push(e)},f;if(s.handler){let n=s.adapter??{kind:`channel`},i={send:createSendFn(o.runtime,n,s.name),getSession:createGetSessionFn(o.runtime),receive:createCrossChannelReceiveFn(o.runtime,toCrossChannelTargets(o.channels)),params:d,waitUntil,requestIp:c};f=await s.handler(r.req,i)}else{let e={agent:o.runtime,waitUntil,params:d,requestIp:c};f=await s.fetch(r.req,e)}return l.length>0&&r.waitUntil(Promise.allSettled(l)),f}function extractSocketIp(e){let t=e.req.ip;return typeof t==`string`&&t.length>0?t:null}export{dispatchChannelRequest};

package/dist/src/internal/nitro/routes/health.js

@@ -1,17 +1 @@
-import { workflowEntryReference } from "#execution/workflow-runtime.js";
-/**
- * Nitro route for Ash's health endpoint.
- *
- * The health endpoint is intentionally always-public so platform load
- * balancers and uptime monitors can probe it without credentials.
- * Channels that need authenticated health probes should author their own
- * channel file with the verifier helpers from
- * `experimental-ash/channels/auth`.
- */
-export default async (_event) => {
-    return Response.json({
-        ok: true,
-        status: "ready",
-        workflowId: workflowEntryReference.workflowId,
-    });
-};
+import{workflowEntryReference}from"#execution/workflow-runtime.js";var health_default=async e=>Response.json({ok:!0,status:`ready`,workflowId:workflowEntryReference.workflowId});export{health_default as default};

package/dist/src/internal/nitro/routes/index.js

@@ -1,31 +1,4 @@
-/**
- * Public docs URL surfaced from the barebones home page. Kept in source
- * so the deployment output is a fully static, build-time-baked HTML
- * response that performs no runtime resolution.
- */
-const ASH_DOCS_URL = "https://ash.labs.vercel.dev/";
-const DEPLOYMENT_URL_PLACEHOLDER = "{{DEPLOYMENT_URL}}";
-/**
- * Barebones HTML served at `GET /`.
- *
- * Reveals no information about the deployed agent — no name, no model,
- * no instructions, no list of skills or schedules, no API endpoint paths.
- * This is intentional: the root URL of a deployment is reachable by
- * anyone on the public internet, and the deployment must not advertise
- * its agent's configuration to unauthenticated callers. Inspection JSON
- * (model id, instructions preview, skills, etc.) lives behind default
- * Vercel OIDC auth on `/ash/v1/info`.
- *
- * The page also loads zero external assets — no fonts, no scripts, no
- * images, no analytics beacons — so it cannot leak the deployment's
- * origin to a third party simply by being visited.
- *
- * `{{DEPLOYMENT_URL}}` is the only request-time substitution: the page
- * echoes the visitor's own request origin back into the `$ ash dev …`
- * hint so they can copy-paste it without typing the URL by hand. We
- * don't read any other request state.
- */
-const HOME_PAGE_HTML_TEMPLATE = `<!doctype html>
+var ASH_DOCS_URL=`https://ash.labs.vercel.dev/`,DEPLOYMENT_URL_PLACEHOLDER=`{{DEPLOYMENT_URL}}`,HOME_PAGE_HTML_TEMPLATE=`<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8">
@@ -175,64 +148,4 @@ const HOME_PAGE_HTML_TEMPLATE = `<!doctype html>
 </main>
 </body>
 </html>
-`;
-function escapeHtml(value) {
-    return value
-        .replaceAll("&", "&amp;")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;")
-        .replaceAll("'", "&#39;");
-}
-function pickFirstForwardedValue(value) {
-    if (value === null) {
-        return undefined;
-    }
-    const first = value.split(",")[0]?.trim();
-    if (first === undefined || first.length === 0) {
-        return undefined;
-    }
-    return first;
-}
-/**
- * Resolves the public origin a visitor is using to reach the deployment.
- *
- * Prefers the `x-forwarded-host` / `x-forwarded-proto` headers set by
- * Vercel's edge so the rendered URL matches the address the visitor
- * actually typed (including custom domains), then falls back to the
- * `host` header, then to `request.url` for local `ash dev` runs that
- * skip the proxy chain. Comma-separated forwarded values are split and
- * the first hop is used — that is the public-facing entry, the rest are
- * internal forwarder hostnames.
- */
-function resolveDeploymentUrl(request) {
-    const headers = request.headers;
-    const requestUrl = new URL(request.url);
-    const forwardedHost = pickFirstForwardedValue(headers.get("x-forwarded-host"));
-    const forwardedProto = pickFirstForwardedValue(headers.get("x-forwarded-proto"));
-    const host = forwardedHost ?? headers.get("host") ?? requestUrl.host;
-    const proto = forwardedProto ?? requestUrl.protocol.replace(/:$/, "");
-    return `${proto}://${host}`;
-}
-/**
- * Builds the barebones home page response for one request. Exposed
- * for tests so callers can supply a real {@link Request}; production
- * traffic flows through the Nitro {@link H3Event} default export.
- */
-export function buildHomePageResponse(request) {
-    const deploymentUrl = resolveDeploymentUrl(request);
-    const html = HOME_PAGE_HTML_TEMPLATE.replace(DEPLOYMENT_URL_PLACEHOLDER, escapeHtml(deploymentUrl));
-    return new Response(html, {
-        headers: {
-            "cache-control": "no-store",
-            "content-type": "text/html; charset=utf-8",
-        },
-    });
-}
-/**
- * Nitro route handler for `GET /`. Adapts the Nitro event shape into
- * {@link buildHomePageResponse}.
- */
-export default function handleHomePageRequest(event) {
-    return buildHomePageResponse(event.req);
-}
+`;function escapeHtml(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`"`,`&quot;`).replaceAll(`'`,`&#39;`)}function pickFirstForwardedValue(e){if(e===null)return;let t=e.split(`,`)[0]?.trim();if(!(t===void 0||t.length===0))return t}function resolveDeploymentUrl(e){let t=e.headers,n=new URL(e.url),r=pickFirstForwardedValue(t.get(`x-forwarded-host`)),i=pickFirstForwardedValue(t.get(`x-forwarded-proto`)),a=r??t.get(`host`)??n.host;return`${i??n.protocol.replace(/:$/,``)}://${a}`}function buildHomePageResponse(e){let r=resolveDeploymentUrl(e),i=HOME_PAGE_HTML_TEMPLATE.replace(DEPLOYMENT_URL_PLACEHOLDER,escapeHtml(r));return new Response(i,{headers:{"cache-control":`no-store`,"content-type":`text/html; charset=utf-8`}})}function handleHomePageRequest(e){return buildHomePageResponse(e.req)}export{buildHomePageResponse,handleHomePageRequest as default};

package/dist/src/internal/nitro/routes/info.js

@@ -1,50 +1 @@
-import { buildAgentInfoResponse } from "#internal/nitro/routes/agent-info/build-agent-info-response.js";
-import { loadAgentInfoData, resolveAgentInfoCompiledArtifactsSource, } from "#internal/nitro/routes/agent-info/load-agent-info-data.js";
-import { createUnauthorizedResponse, none, vercelOidc, } from "#public/channels/auth.js";
-/**
- * Resolves the default auth strategy for the agent info endpoint.
- *
- * Mirrors {@link resolveFrameworkAshAuth} (session/stream routes): on
- * Vercel deployments require a valid Vercel OIDC bearer (the always-on
- * same-project bypass lets internal callers in automatically); off
- * Vercel (`ash dev`) accept anonymous requests so local inspection
- * tools and curl-based probes work without setup.
- */
-function resolveAgentInfoAuth() {
-    if (process.env.VERCEL) {
-        return vercelOidc();
-    }
-    return none();
-}
-async function createAgentInfoPayload(input) {
-    const data = await loadAgentInfoData({
-        compiledArtifactsSource: resolveAgentInfoCompiledArtifactsSource({
-            appRoot: input.appRoot,
-        }),
-    });
-    return buildAgentInfoResponse(data);
-}
-/**
- * Builds the package-owned JSON inspection response for the current
- * agent (model id, instructions preview, skills, schedules, subagents,
- * tools, sandbox, endpoint catalog).
- *
- * The route is gated by {@link resolveAgentInfoAuth} so the deployed URL
- * does not expose agent metadata to anonymous callers. The same-project
- * bypass on `vercelOidc()` keeps the route reachable to in-deployment
- * callers (`apps/nextjs-ash`-style consumers) without any additional
- * setup.
- */
-export async function handleAgentInfoRequest(input, request) {
-    const auth = resolveAgentInfoAuth();
-    const result = await auth(request);
-    if (result === null) {
-        return createUnauthorizedResponse({ challenges: [{ scheme: "Bearer" }] });
-    }
-    return new Response(JSON.stringify(await createAgentInfoPayload(input)), {
-        headers: {
-            "cache-control": "no-store",
-            "content-type": "application/json; charset=utf-8",
-        },
-    });
-}
+import{buildAgentInfoResponse}from"#internal/nitro/routes/agent-info/build-agent-info-response.js";import{loadAgentInfoData,resolveAgentInfoCompiledArtifactsSource}from"#internal/nitro/routes/agent-info/load-agent-info-data.js";import{createUnauthorizedResponse,none,vercelOidc}from"#public/channels/auth.js";function resolveAgentInfoAuth(){return process.env.VERCEL?vercelOidc():none()}async function createAgentInfoPayload(n){return buildAgentInfoResponse(await loadAgentInfoData({compiledArtifactsSource:resolveAgentInfoCompiledArtifactsSource({appRoot:n.appRoot})}))}async function handleAgentInfoRequest(e,t){return await resolveAgentInfoAuth()(t)===null?createUnauthorizedResponse({challenges:[{scheme:`Bearer`}]}):new Response(JSON.stringify(await createAgentInfoPayload(e)),{headers:{"cache-control":`no-store`,"content-type":`application/json; charset=utf-8`}})}export{handleAgentInfoRequest};

package/dist/src/internal/nitro/routes/runtime-artifacts.js

@@ -1,24 +1 @@
-import { createBundledRuntimeCompiledArtifactsSource, createDiskRuntimeCompiledArtifactsSource, } from "#runtime/compiled-artifacts-source.js";
-import { readBundledCompiledArtifacts } from "#runtime/loaders/bundled-artifacts.js";
-/**
- * Resolves the compiled-artifact source available to package-owned Nitro
- * routes.
- */
-export function resolveNitroCompiledArtifactsSource(config) {
-    const { appRoot, dev: isDevelopment } = config;
-    if (isDevelopment && appRoot !== undefined) {
-        if (config.moduleMapLoaderPath === undefined) {
-            throw new Error('Ash Nitro development routes require "moduleMapLoaderPath" in the artifacts config.');
-        }
-        return createDiskRuntimeCompiledArtifactsSource(appRoot, {
-            moduleMapLoaderPath: config.moduleMapLoaderPath,
-        });
-    }
-    if (readBundledCompiledArtifacts() !== null) {
-        return createBundledRuntimeCompiledArtifactsSource();
-    }
-    if (appRoot !== undefined) {
-        return createDiskRuntimeCompiledArtifactsSource(appRoot);
-    }
-    throw new Error("Ash Nitro route requires bundled artifacts or an Ash Nitro runtime configuration app root.");
-}
+import{createBundledRuntimeCompiledArtifactsSource,createDiskRuntimeCompiledArtifactsSource}from"#runtime/compiled-artifacts-source.js";import{readBundledCompiledArtifacts}from"#runtime/loaders/bundled-artifacts.js";function resolveNitroCompiledArtifactsSource(e){let{appRoot:t,dev:n}=e;if(n&&t!==void 0){if(e.moduleMapLoaderPath===void 0)throw Error(`Ash Nitro development routes require "moduleMapLoaderPath" in the artifacts config.`);return createDiskRuntimeCompiledArtifactsSource(t,{moduleMapLoaderPath:e.moduleMapLoaderPath})}if(readBundledCompiledArtifacts()!==null)return createBundledRuntimeCompiledArtifactsSource();if(t!==void 0)return createDiskRuntimeCompiledArtifactsSource(t);throw Error(`Ash Nitro route requires bundled artifacts or an Ash Nitro runtime configuration app root.`)}export{resolveNitroCompiledArtifactsSource};

package/dist/src/internal/nitro/routes/runtime-stack.js

@@ -1,23 +1 @@
-import { createWorkflowRuntime } from "#execution/workflow-runtime.js";
-import { getCompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
-import { resolveNitroCompiledArtifactsSource, } from "#internal/nitro/routes/runtime-artifacts.js";
-/**
- * Resolves the per-request channel bundle: the agent's resolved channels
- * (already merged with framework defaults by `resolve-agent-graph.ts`)
- * and a fresh workflow runtime.
- *
- * No singleton caching is needed — session state lives inside the
- * workflow's durable execution and the channel set is recomputed from the
- * compiled bundle on each request.
- */
-export async function resolveNitroChannelRuntimeBundle(config) {
-    const compiledArtifactsSource = resolveNitroCompiledArtifactsSource(config);
-    const bundle = await getCompiledRuntimeAgentBundle({
-        compiledArtifactsSource,
-    });
-    const runtime = createWorkflowRuntime({ compiledArtifactsSource });
-    return {
-        channels: bundle.graph.root.channels,
-        runtime,
-    };
-}
+import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{resolveNitroCompiledArtifactsSource}from"#internal/nitro/routes/runtime-artifacts.js";async function resolveNitroChannelRuntimeBundle(e){let t=resolveNitroCompiledArtifactsSource(e),n=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:t}),r=createWorkflowRuntime({compiledArtifactsSource:t});return{channels:n.graph.root.channels,runtime:r}}export{resolveNitroChannelRuntimeBundle};

package/dist/src/internal/nitro/routes/schedule-task.js

@@ -1,57 +1 @@
-import { expectScheduleRun, ScheduleDispatcher } from "#channel/schedule.js";
-import { createWorkflowRuntime } from "#execution/workflow-runtime.js";
-import { loadResolvedModuleExport } from "#runtime/resolve-helpers.js";
-import { loadResolvedCompiledScheduleByTaskName } from "#runtime/schedules/resolve-schedule.js";
-import { getCompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
-import { resolveNitroCompiledArtifactsSource } from "#internal/nitro/routes/runtime-artifacts.js";
-/**
- * Dispatches one Ash authored schedule via the execution engine.
- *
- * Fire-and-forget: the workflow runtime owns terminal completion and
- * its own failure observability. The task return value reports which
- * session ids the handler started so Nitro / dev tools can correlate.
- */
-export async function dispatchScheduleTask(taskName, config) {
-    const compiledArtifactsSource = resolveNitroCompiledArtifactsSource(config);
-    const schedule = await loadResolvedCompiledScheduleByTaskName(taskName, {
-        compiledArtifactsSource,
-    });
-    const bundle = await getCompiledRuntimeAgentBundle({ compiledArtifactsSource });
-    const runtime = createWorkflowRuntime({ compiledArtifactsSource });
-    const dispatcher = new ScheduleDispatcher({
-        runtime,
-        channels: bundle.graph.root.channels,
-    });
-    const dispatchInput = { scheduleId: schedule.name };
-    if (schedule.hasRun) {
-        dispatchInput.run = await loadScheduleRun(schedule, bundle.moduleMap);
-    }
-    if (schedule.markdown !== undefined) {
-        dispatchInput.markdown = schedule.markdown;
-    }
-    const result = await dispatcher.trigger(dispatchInput);
-    if (result.waitUntilTasks.length > 0) {
-        await Promise.allSettled(result.waitUntilTasks);
-    }
-    return {
-        scheduleId: schedule.name,
-        sessionIds: result.sessions.map((session) => session.id),
-    };
-}
-async function loadScheduleRun(schedule, moduleMap) {
-    if (schedule.sourceKind !== "module") {
-        throw new Error(`Schedule "${schedule.name}" claims hasRun but is not a module-backed schedule.`);
-    }
-    const moduleSchedule = schedule;
-    const exportValue = await loadResolvedModuleExport({
-        definition: {
-            exportName: moduleSchedule.exportName,
-            logicalPath: moduleSchedule.logicalPath,
-            sourceId: moduleSchedule.sourceId,
-        },
-        kindLabel: "schedule",
-        moduleMap,
-        nodeId: undefined,
-    });
-    return expectScheduleRun(exportValue, moduleSchedule.logicalPath, moduleSchedule.exportName);
-}
+import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{loadResolvedCompiledScheduleByTaskName}from"#runtime/schedules/resolve-schedule.js";import{resolveNitroCompiledArtifactsSource}from"#internal/nitro/routes/runtime-artifacts.js";import{ScheduleDispatcher,expectScheduleRun}from"#channel/schedule.js";import{loadResolvedModuleExport}from"#runtime/resolve-helpers.js";async function dispatchScheduleTask(r,i){let a=resolveNitroCompiledArtifactsSource(i),o=await loadResolvedCompiledScheduleByTaskName(r,{compiledArtifactsSource:a}),s=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:a}),c=new ScheduleDispatcher({runtime:createWorkflowRuntime({compiledArtifactsSource:a}),channels:s.graph.root.channels}),l={scheduleId:o.name};o.hasRun&&(l.run=await loadScheduleRun(o,s.moduleMap)),o.markdown!==void 0&&(l.markdown=o.markdown);let u=await c.trigger(l);return u.waitUntilTasks.length>0&&await Promise.allSettled(u.waitUntilTasks),{scheduleId:o.name,sessionIds:u.sessions.map(e=>e.id)}}async function loadScheduleRun(e,t){if(e.sourceKind!==`module`)throw Error(`Schedule "${e.name}" claims hasRun but is not a module-backed schedule.`);let n=e;return expectScheduleRun(await loadResolvedModuleExport({definition:{exportName:n.exportName,logicalPath:n.logicalPath,sourceId:n.sourceId},kindLabel:`schedule`,moduleMap:t,nodeId:void 0}),n.logicalPath,n.exportName)}export{dispatchScheduleTask};

package/dist/src/internal/nitro/routes/workflow-data.js

@@ -1,141 +1 @@
-import { WorkflowRunNotFoundError, WorkflowWorldError } from "#compiled/@workflow/errors/index.js";
-import { getWorld } from "#compiled/@workflow/core/runtime.js";
-/**
- * Error raised when one requested workflow run cannot be found.
- */
-export class WorkflowRunMissingError extends Error {
-    runId;
-    constructor(runId) {
-        super(`Workflow run "${runId}" not found.`);
-        this.name = "WorkflowRunMissingError";
-        this.runId = runId;
-    }
-}
-function toPaginationOptions(query) {
-    const pagination = {};
-    if (typeof query.cursor === "string" && query.cursor.length > 0) {
-        pagination.cursor = query.cursor;
-    }
-    if (typeof query.limit === "number") {
-        pagination.limit = query.limit;
-    }
-    if (query.sortOrder === "asc" || query.sortOrder === "desc") {
-        pagination.sortOrder = query.sortOrder;
-    }
-    if (pagination.cursor === undefined &&
-        pagination.limit === undefined &&
-        pagination.sortOrder === undefined) {
-        return undefined;
-    }
-    return pagination;
-}
-function isRunNotFoundError(error) {
-    if (WorkflowRunNotFoundError.is(error)) {
-        return true;
-    }
-    // Fallback: some world implementations throw a generic WorkflowWorldError
-    // with HTTP status 404 instead of the typed WorkflowRunNotFoundError. This
-    // can happen when instanceof checks fail across module boundaries.
-    if (WorkflowWorldError.is(error) && error.status === 404) {
-        return true;
-    }
-    return false;
-}
-async function ensureWorkflowRunExists(world, runId) {
-    try {
-        await world.runs.get(runId, {
-            resolveData: "none",
-        });
-    }
-    catch (error) {
-        if (isRunNotFoundError(error)) {
-            throw new WorkflowRunMissingError(runId);
-        }
-        throw error;
-    }
-}
-/**
- * Lists workflow runs with data-resolution disabled so payload blobs are not exposed.
- */
-export async function listWorkflowRuns(query) {
-    const world = await getWorld();
-    const pagination = toPaginationOptions(query);
-    const params = {
-        resolveData: "none",
-    };
-    if (typeof query.workflowName === "string" && query.workflowName.length > 0) {
-        params.workflowName = query.workflowName;
-    }
-    if (typeof query.status === "string" && query.status.length > 0) {
-        params.status = query.status;
-    }
-    if (pagination !== undefined) {
-        params.pagination = pagination;
-    }
-    return await world.runs.list(params);
-}
-/**
- * Returns one workflow run summary by id with data-resolution disabled.
- */
-export async function getWorkflowRun(runId) {
-    const world = await getWorld();
-    try {
-        return await world.runs.get(runId, {
-            resolveData: "none",
-        });
-    }
-    catch (error) {
-        if (isRunNotFoundError(error)) {
-            throw new WorkflowRunMissingError(runId);
-        }
-        throw error;
-    }
-}
-/**
- * Lists steps for one workflow run with data-resolution disabled.
- */
-export async function listWorkflowRunSteps(runId, query) {
-    const world = await getWorld();
-    const pagination = toPaginationOptions(query);
-    await ensureWorkflowRunExists(world, runId);
-    const params = {
-        resolveData: "none",
-        runId,
-    };
-    if (pagination !== undefined) {
-        params.pagination = pagination;
-    }
-    try {
-        return await world.steps.list(params);
-    }
-    catch (error) {
-        if (isRunNotFoundError(error)) {
-            throw new WorkflowRunMissingError(runId);
-        }
-        throw error;
-    }
-}
-/**
- * Lists events for one workflow run with data-resolution disabled.
- */
-export async function listWorkflowRunEvents(runId, query) {
-    const world = await getWorld();
-    const pagination = toPaginationOptions(query);
-    await ensureWorkflowRunExists(world, runId);
-    const params = {
-        resolveData: "none",
-        runId,
-    };
-    if (pagination !== undefined) {
-        params.pagination = pagination;
-    }
-    try {
-        return await world.events.list(params);
-    }
-    catch (error) {
-        if (isRunNotFoundError(error)) {
-            throw new WorkflowRunMissingError(runId);
-        }
-        throw error;
-    }
-}
+import{getWorld}from"#compiled/@workflow/core/runtime.js";import{WorkflowRunNotFoundError,WorkflowWorldError}from"#compiled/@workflow/errors/index.js";var WorkflowRunMissingError=class extends Error{runId;constructor(e){super(`Workflow run "${e}" not found.`),this.name=`WorkflowRunMissingError`,this.runId=e}};function toPaginationOptions(e){let t={};if(typeof e.cursor==`string`&&e.cursor.length>0&&(t.cursor=e.cursor),typeof e.limit==`number`&&(t.limit=e.limit),(e.sortOrder===`asc`||e.sortOrder===`desc`)&&(t.sortOrder=e.sortOrder),!(t.cursor===void 0&&t.limit===void 0&&t.sortOrder===void 0))return t}function isRunNotFoundError(e){return!!(WorkflowRunNotFoundError.is(e)||WorkflowWorldError.is(e)&&e.status===404)}async function ensureWorkflowRunExists(e,t){try{await e.runs.get(t,{resolveData:`none`})}catch(e){throw isRunNotFoundError(e)?new WorkflowRunMissingError(t):e}}async function listWorkflowRuns(t){let n=await getWorld(),r=toPaginationOptions(t),i={resolveData:`none`};return typeof t.workflowName==`string`&&t.workflowName.length>0&&(i.workflowName=t.workflowName),typeof t.status==`string`&&t.status.length>0&&(i.status=t.status),r!==void 0&&(i.pagination=r),await n.runs.list(i)}async function getWorkflowRun(t){let n=await getWorld();try{return await n.runs.get(t,{resolveData:`none`})}catch(e){throw isRunNotFoundError(e)?new WorkflowRunMissingError(t):e}}async function listWorkflowRunSteps(t,n){let r=await getWorld(),i=toPaginationOptions(n);await ensureWorkflowRunExists(r,t);let a={resolveData:`none`,runId:t};i!==void 0&&(a.pagination=i);try{return await r.steps.list(a)}catch(e){throw isRunNotFoundError(e)?new WorkflowRunMissingError(t):e}}async function listWorkflowRunEvents(t,n){let r=await getWorld(),i=toPaginationOptions(n);await ensureWorkflowRunExists(r,t);let a={resolveData:`none`,runId:t};i!==void 0&&(a.pagination=i);try{return await r.events.list(a)}catch(e){throw isRunNotFoundError(e)?new WorkflowRunMissingError(t):e}}export{WorkflowRunMissingError,getWorkflowRun,listWorkflowRunEvents,listWorkflowRunSteps,listWorkflowRuns};

package/dist/src/internal/nitro/routes/workflow-route-helpers.js

@@ -1,137 +1 @@
-import { ASH_ROUTE_PREFIX } from "#protocol/routes.js";
-export const WORKFLOW_RUNS_API_ROUTE_PATH = `${ASH_ROUTE_PREFIX}/runs`;
-export const WORKFLOW_RUN_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/runs/:runId`;
-export const WORKFLOW_RUN_STEPS_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/runs/:runId/steps`;
-export const WORKFLOW_RUN_EVENTS_ROUTE_PATTERN = `${ASH_ROUTE_PREFIX}/runs/:runId/events`;
-const MAX_PAGE_LIMIT = 1000;
-const WORKFLOW_RUN_STATUSES = ["pending", "running", "completed", "failed", "cancelled"];
-function createWorkflowApiResponse(payload, status) {
-    return new Response(JSON.stringify(payload), {
-        headers: {
-            "cache-control": "no-store",
-            "content-type": "application/json; charset=utf-8",
-        },
-        status,
-    });
-}
-/**
- * Builds the common success response envelope for workflow inspection routes.
- */
-export function createWorkflowApiSuccessResponse(payload) {
-    return createWorkflowApiResponse({
-        ok: true,
-        ...payload,
-    }, 200);
-}
-/**
- * Builds a consistent 400 response for workflow inspection routes.
- */
-export function createWorkflowApiBadRequestResponse(message) {
-    return createWorkflowApiResponse({
-        error: message,
-        ok: false,
-    }, 400);
-}
-/**
- * Builds a consistent 404 response for workflow inspection routes.
- */
-export function createWorkflowApiNotFoundResponse(message) {
-    return createWorkflowApiResponse({
-        error: message,
-        ok: false,
-    }, 404);
-}
-/**
- * Builds a consistent 500 response for workflow inspection routes.
- */
-export function createWorkflowApiInternalErrorResponse() {
-    return createWorkflowApiResponse({
-        error: "Failed to load workflow data.",
-        ok: false,
-    }, 500);
-}
-function isWorkflowRunStatus(value) {
-    return WORKFLOW_RUN_STATUSES.some((status) => status === value);
-}
-function parsePaginationFromSearchParams(searchParams) {
-    const pagination = {};
-    const cursor = searchParams.get("cursor");
-    if (typeof cursor === "string" && cursor.length > 0) {
-        pagination.cursor = cursor;
-    }
-    const rawLimit = searchParams.get("limit");
-    if (rawLimit !== null) {
-        const parsedLimit = Number.parseInt(rawLimit, 10);
-        if (!Number.isSafeInteger(parsedLimit) || parsedLimit < 1 || parsedLimit > MAX_PAGE_LIMIT) {
-            return createWorkflowApiBadRequestResponse(`Expected "limit" to be an integer between 1 and ${MAX_PAGE_LIMIT}.`);
-        }
-        pagination.limit = parsedLimit;
-    }
-    const rawSortOrder = searchParams.get("sortOrder");
-    if (rawSortOrder !== null) {
-        if (rawSortOrder !== "asc" && rawSortOrder !== "desc") {
-            return createWorkflowApiBadRequestResponse('Expected "sortOrder" to be "asc" or "desc".');
-        }
-        pagination.sortOrder = rawSortOrder;
-    }
-    return pagination;
-}
-/**
- * Parses pagination query parameters from one workflow inspection request.
- */
-export function parsePaginationQuery(request) {
-    const searchParams = new URL(request.url).searchParams;
-    return parsePaginationFromSearchParams(searchParams);
-}
-/**
- * Parses list-runs query parameters from one workflow inspection request.
- */
-export function parseWorkflowRunsQuery(request) {
-    const searchParams = new URL(request.url).searchParams;
-    const pagination = parsePaginationFromSearchParams(searchParams);
-    if (pagination instanceof Response) {
-        return pagination;
-    }
-    const query = {
-        cursor: pagination.cursor,
-        limit: pagination.limit,
-        sortOrder: pagination.sortOrder,
-    };
-    const rawStatus = searchParams.get("status");
-    if (rawStatus !== null) {
-        if (!isWorkflowRunStatus(rawStatus)) {
-            return createWorkflowApiBadRequestResponse(`Expected "status" to be one of: ${WORKFLOW_RUN_STATUSES.join(", ")}.`);
-        }
-        query.status = rawStatus;
-    }
-    const workflowName = searchParams.get("workflowName");
-    if (typeof workflowName === "string" && workflowName.length > 0) {
-        query.workflowName = workflowName;
-    }
-    return query;
-}
-/**
- * Resolves `runId` from one Nitro route event.
- */
-export function resolveRunIdFromNitroEvent(event) {
-    const eventWithParams = event;
-    const routeRunId = eventWithParams.context?.params?.runId;
-    if (typeof routeRunId === "string" && routeRunId.length > 0) {
-        return routeRunId;
-    }
-    const path = new URL(event.req.url).pathname;
-    const pathMatch = path.match(/^\/ash\/v1\/runs\/([^/]+)(?:\/.*)?$/);
-    if (pathMatch === null) {
-        return null;
-    }
-    const encodedRunId = pathMatch[1];
-    if (typeof encodedRunId !== "string" || encodedRunId.length === 0) {
-        return null;
-    }
-    try {
-        return decodeURIComponent(encodedRunId);
-    }
-    catch {
-        return null;
-    }
-}
+import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";var WORKFLOW_RUNS_API_ROUTE_PATH=`${ASH_ROUTE_PREFIX}/runs`,WORKFLOW_RUN_ROUTE_PATTERN=`${ASH_ROUTE_PREFIX}/runs/:runId`,WORKFLOW_RUN_STEPS_ROUTE_PATTERN=`${ASH_ROUTE_PREFIX}/runs/:runId/steps`,WORKFLOW_RUN_EVENTS_ROUTE_PATTERN=`${ASH_ROUTE_PREFIX}/runs/:runId/events`,MAX_PAGE_LIMIT=1e3,WORKFLOW_RUN_STATUSES=[`pending`,`running`,`completed`,`failed`,`cancelled`];function createWorkflowApiResponse(e,t){return new Response(JSON.stringify(e),{headers:{"cache-control":`no-store`,"content-type":`application/json; charset=utf-8`},status:t})}function createWorkflowApiSuccessResponse(e){return createWorkflowApiResponse({ok:!0,...e},200)}function createWorkflowApiBadRequestResponse(e){return createWorkflowApiResponse({error:e,ok:!1},400)}function createWorkflowApiNotFoundResponse(e){return createWorkflowApiResponse({error:e,ok:!1},404)}function createWorkflowApiInternalErrorResponse(){return createWorkflowApiResponse({error:`Failed to load workflow data.`,ok:!1},500)}function isWorkflowRunStatus(e){return WORKFLOW_RUN_STATUSES.some(t=>t===e)}function parsePaginationFromSearchParams(e){let t={},n=e.get(`cursor`);typeof n==`string`&&n.length>0&&(t.cursor=n);let r=e.get(`limit`);if(r!==null){let e=Number.parseInt(r,10);if(!Number.isSafeInteger(e)||e<1||e>MAX_PAGE_LIMIT)return createWorkflowApiBadRequestResponse(`Expected "limit" to be an integer between 1 and ${MAX_PAGE_LIMIT}.`);t.limit=e}let i=e.get(`sortOrder`);if(i!==null){if(i!==`asc`&&i!==`desc`)return createWorkflowApiBadRequestResponse(`Expected "sortOrder" to be "asc" or "desc".`);t.sortOrder=i}return t}function parsePaginationQuery(e){let t=new URL(e.url).searchParams;return parsePaginationFromSearchParams(t)}function parseWorkflowRunsQuery(e){let t=new URL(e.url).searchParams,n=parsePaginationFromSearchParams(t);if(n instanceof Response)return n;let r={cursor:n.cursor,limit:n.limit,sortOrder:n.sortOrder},i=t.get(`status`);if(i!==null){if(!isWorkflowRunStatus(i))return createWorkflowApiBadRequestResponse(`Expected "status" to be one of: ${WORKFLOW_RUN_STATUSES.join(`, `)}.`);r.status=i}let a=t.get(`workflowName`);return typeof a==`string`&&a.length>0&&(r.workflowName=a),r}function resolveRunIdFromNitroEvent(e){let t=e.context?.params?.runId;if(typeof t==`string`&&t.length>0)return t;let n=new URL(e.req.url).pathname.match(/^\/ash\/v1\/runs\/([^/]+)(?:\/.*)?$/);if(n===null)return null;let r=n[1];if(typeof r!=`string`||r.length===0)return null;try{return decodeURIComponent(r)}catch{return null}}export{WORKFLOW_RUNS_API_ROUTE_PATH,WORKFLOW_RUN_EVENTS_ROUTE_PATTERN,WORKFLOW_RUN_ROUTE_PATTERN,WORKFLOW_RUN_STEPS_ROUTE_PATTERN,createWorkflowApiBadRequestResponse,createWorkflowApiInternalErrorResponse,createWorkflowApiNotFoundResponse,createWorkflowApiSuccessResponse,parsePaginationQuery,parseWorkflowRunsQuery,resolveRunIdFromNitroEvent};