experimental-ash 0.25.2 → 0.27.0

package/dist/src/internal/application/package.js

@@ -1,196 +1 @@
-import { existsSync, readFileSync, realpathSync } from "node:fs";
-import { createRequire } from "node:module";
-import { basename, dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { ASH_PACKAGE_NAME } from "#internal/package-name.js";
-let cachedPackageInfo;
-// The package build stamps the published version into `dist` so bundled
-// deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.25.2";
-const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
-const WORKFLOW_MODULE_ALIASES = {
-    "workflow/api": "src/compiled/@workflow/core/runtime.js",
-    "workflow/errors": "src/compiled/@workflow/errors/index.js",
-    "workflow/internal/private": "src/compiled/@workflow/core/private.js",
-    "workflow/runtime": "src/compiled/@workflow/core/runtime.js",
-};
-function resolveFallbackPackageVersion() {
-    return BUNDLED_FALLBACK_PACKAGE_VERSION === BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER
-        ? "0.0.0"
-        : BUNDLED_FALLBACK_PACKAGE_VERSION;
-}
-const FALLBACK_PACKAGE_INFO = {
-    name: ASH_PACKAGE_NAME,
-    version: resolveFallbackPackageVersion(),
-};
-function resolveCurrentModulePath() {
-    if (typeof __filename === "string") {
-        return __filename;
-    }
-    return resolveCurrentModulePathFromStack();
-}
-function resolveCurrentModulePathFromStack() {
-    const previousPrepareStackTrace = Error.prepareStackTrace;
-    try {
-        Error.prepareStackTrace = (_error, stack) => stack;
-        const stack = new Error().stack;
-        const currentFileName = stack?.[0]?.getFileName();
-        if (typeof currentFileName !== "string" || currentFileName.length === 0) {
-            throw new Error("Failed to resolve the current module path from the stack trace.");
-        }
-        return currentFileName.startsWith("file:") ? fileURLToPath(currentFileName) : currentFileName;
-    }
-    finally {
-        Error.prepareStackTrace = previousPrepareStackTrace;
-    }
-}
-const require = createRequire(resolveCurrentModulePath());
-function isBuildOutputPackageRoot(directoryPath) {
-    return (basename(directoryPath) === "dist" && existsSync(join(dirname(directoryPath), "package.json")));
-}
-function resolvePackageBuildRoot() {
-    let currentDirectory = dirname(realpathSync(resolveCurrentModulePath()));
-    while (true) {
-        if (isBuildOutputPackageRoot(currentDirectory)) {
-            return currentDirectory;
-        }
-        const parentDirectory = dirname(currentDirectory);
-        if (parentDirectory === currentDirectory) {
-            return null;
-        }
-        currentDirectory = parentDirectory;
-    }
-}
-function findNearestPackageRoot(startDirectory) {
-    let currentDirectory = startDirectory;
-    while (true) {
-        if (existsSync(join(currentDirectory, "package.json")) &&
-            !isBuildOutputPackageRoot(currentDirectory)) {
-            return currentDirectory;
-        }
-        const parentDirectory = dirname(currentDirectory);
-        if (parentDirectory === currentDirectory) {
-            throw new Error(`Failed to resolve package root from "${startDirectory}".`);
-        }
-        currentDirectory = parentDirectory;
-    }
-}
-/**
- * Resolves the installed Ash package root.
- */
-export function resolvePackageRoot() {
-    // Canonicalize the current module path so workspace symlinks such as
-    // app-local `node_modules/<package-name>` resolve back to the real package root.
-    return findNearestPackageRoot(dirname(realpathSync(resolveCurrentModulePath())));
-}
-function tryResolvePackageRoot() {
-    try {
-        return resolvePackageRoot();
-    }
-    catch {
-        return undefined;
-    }
-}
-function rewriteSourceFilePathForBuild(relativeSourcePath) {
-    return relativeSourcePath.replace(/\.[cm]?tsx?$/, ".js");
-}
-/**
- * Resolves one package-owned source file from the currently executing Ash installation.
- *
- * Source checkouts use `src/...` paths so local tests exercise live source files.
- * Installed or built package executions use `dist/src/...` so published builds do
- * not depend on unpublished TypeScript sources.
- */
-export function resolvePackageSourceFilePath(relativeSourcePath) {
-    const packageBuildRoot = resolvePackageBuildRoot();
-    if (packageBuildRoot !== null) {
-        return join(packageBuildRoot, rewriteSourceFilePathForBuild(relativeSourcePath));
-    }
-    return join(resolvePackageRoot(), relativeSourcePath);
-}
-/**
- * Resolves one package-owned source directory from the currently executing Ash installation.
- */
-export function resolvePackageSourceDirectoryPath(relativeSourcePath) {
-    const packageBuildRoot = resolvePackageBuildRoot();
-    if (packageBuildRoot !== null) {
-        return join(packageBuildRoot, relativeSourcePath);
-    }
-    return join(resolvePackageRoot(), relativeSourcePath);
-}
-function resolvePackageCompiledFilePath(relativeCompiledPath) {
-    const packageBuildRoot = resolvePackageBuildRoot();
-    if (packageBuildRoot !== null) {
-        return join(packageBuildRoot, relativeCompiledPath);
-    }
-    return join(resolvePackageRoot(), ".generated", "compiled", relativeCompiledPath.replace(/^src\/compiled\//, ""));
-}
-function normalizeInstalledPackageInfo(value) {
-    const packageJson = value;
-    if (typeof packageJson.name !== "string" || typeof packageJson.version !== "string") {
-        return undefined;
-    }
-    return {
-        name: packageJson.name,
-        version: packageJson.version,
-    };
-}
-function tryReadInstalledPackageInfo(packageJsonPath, expectedPackageName) {
-    const resolvedPackageInfo = normalizeInstalledPackageInfo(JSON.parse(readFileSync(packageJsonPath, "utf8")));
-    if (resolvedPackageInfo?.name !== expectedPackageName) {
-        return undefined;
-    }
-    return resolvedPackageInfo;
-}
-/**
- * Resolves the installed Ash package identity from package.json.
- */
-export function resolveInstalledPackageInfo() {
-    if (cachedPackageInfo) {
-        return cachedPackageInfo;
-    }
-    const packageRoot = tryResolvePackageRoot();
-    const packageRootInfo = packageRoot === undefined
-        ? undefined
-        : tryReadInstalledPackageInfo(join(packageRoot, "package.json"), ASH_PACKAGE_NAME);
-    if (packageRootInfo) {
-        cachedPackageInfo = packageRootInfo;
-        return cachedPackageInfo;
-    }
-    try {
-        const resolvedPackageJsonPath = require.resolve(`${ASH_PACKAGE_NAME}/package.json`);
-        const resolvedPackageInfo = tryReadInstalledPackageInfo(resolvedPackageJsonPath, ASH_PACKAGE_NAME);
-        if (resolvedPackageInfo) {
-            cachedPackageInfo = resolvedPackageInfo;
-            return cachedPackageInfo;
-        }
-    }
-    catch {
-        // Fall back to the package's development identity when the self package
-        // cannot be resolved from bundled runtime output.
-    }
-    cachedPackageInfo = {
-        ...FALLBACK_PACKAGE_INFO,
-    };
-    return cachedPackageInfo;
-}
-/**
- * Resolves a Workflow runtime module from Ash's narrowed Workflow dependencies.
- *
- * Older Workflow builder output still uses `workflow/*` specifiers. Ash maps
- * those historical specifiers to the smaller `@workflow/*` packages it actually
- * needs, plus an Ash-owned builtins module for response body step helpers.
- */
-export function resolveWorkflowModulePath(specifier) {
-    if (specifier === "workflow") {
-        return resolvePackageSourceFilePath("src/internal/workflow/index.ts");
-    }
-    if (specifier === "workflow/internal/builtins") {
-        return resolvePackageSourceFilePath("src/internal/workflow/builtins.ts");
-    }
-    const alias = WORKFLOW_MODULE_ALIASES[specifier];
-    if (alias !== undefined) {
-        return resolvePackageCompiledFilePath(alias);
-    }
-    return require.resolve(specifier);
-}
+import{createRequire}from"node:module";import{basename,dirname,join}from"node:path";import{existsSync,readFileSync,realpathSync}from"node:fs";import{ASH_PACKAGE_NAME}from"#internal/package-name.js";import{fileURLToPath}from"node:url";var cachedPackageInfo,BUNDLED_FALLBACK_PACKAGE_VERSION=`0.27.0`,BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER=`__ASH_PACKAGE_VERSION_PLACEHOLDER__`,WORKFLOW_MODULE_ALIASES={"workflow/api":`src/compiled/@workflow/core/runtime.js`,"workflow/errors":`src/compiled/@workflow/errors/index.js`,"workflow/internal/private":`src/compiled/@workflow/core/private.js`,"workflow/runtime":`src/compiled/@workflow/core/runtime.js`};function resolveFallbackPackageVersion(){return BUNDLED_FALLBACK_PACKAGE_VERSION===BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER?`0.0.0`:BUNDLED_FALLBACK_PACKAGE_VERSION}var FALLBACK_PACKAGE_INFO={name:ASH_PACKAGE_NAME,version:resolveFallbackPackageVersion()};function resolveCurrentModulePath(){return typeof __filename==`string`?__filename:resolveCurrentModulePathFromStack()}function resolveCurrentModulePathFromStack(){let e=Error.prepareStackTrace;try{Error.prepareStackTrace=(e,t)=>t;let e=Error().stack?.[0]?.getFileName();if(typeof e!=`string`||e.length===0)throw Error(`Failed to resolve the current module path from the stack trace.`);return e.startsWith(`file:`)?fileURLToPath(e):e}finally{Error.prepareStackTrace=e}}var require=createRequire(resolveCurrentModulePath());function isBuildOutputPackageRoot(e){return basename(e)===`dist`&&existsSync(join(dirname(e),`package.json`))}function resolvePackageBuildRoot(){let e=dirname(realpathSync(resolveCurrentModulePath()));for(;;){if(isBuildOutputPackageRoot(e))return e;let t=dirname(e);if(t===e)return null;e=t}}function findNearestPackageRoot(e){let t=e;for(;;){if(existsSync(join(t,`package.json`))&&!isBuildOutputPackageRoot(t))return t;let r=dirname(t);if(r===t)throw Error(`Failed to resolve package root from "${e}".`);t=r}}function resolvePackageRoot(){return findNearestPackageRoot(dirname(realpathSync(resolveCurrentModulePath())))}function tryResolvePackageRoot(){try{return resolvePackageRoot()}catch{return}}function rewriteSourceFilePathForBuild(e){return e.replace(/\.[cm]?tsx?$/,`.js`)}function resolvePackageSourceFilePath(e){let t=resolvePackageBuildRoot();return t===null?join(resolvePackageRoot(),e):join(t,rewriteSourceFilePathForBuild(e))}function resolvePackageSourceDirectoryPath(e){let t=resolvePackageBuildRoot();return join(t===null?resolvePackageRoot():t,e)}function resolvePackageCompiledFilePath(e){let t=resolvePackageBuildRoot();return t===null?join(resolvePackageRoot(),`.generated`,`compiled`,e.replace(/^src\/compiled\//,``)):join(t,e)}function normalizeInstalledPackageInfo(e){let t=e;if(!(typeof t.name!=`string`||typeof t.version!=`string`))return{name:t.name,version:t.version}}function tryReadInstalledPackageInfo(e,t){let n=normalizeInstalledPackageInfo(JSON.parse(readFileSync(e,`utf8`)));if(n?.name===t)return n}function resolveInstalledPackageInfo(){if(cachedPackageInfo)return cachedPackageInfo;let e=tryResolvePackageRoot(),t=e===void 0?void 0:tryReadInstalledPackageInfo(join(e,`package.json`),ASH_PACKAGE_NAME);if(t)return cachedPackageInfo=t,cachedPackageInfo;try{let e=tryReadInstalledPackageInfo(require.resolve(`${ASH_PACKAGE_NAME}/package.json`),ASH_PACKAGE_NAME);if(e)return cachedPackageInfo=e,cachedPackageInfo}catch{}return cachedPackageInfo={...FALLBACK_PACKAGE_INFO},cachedPackageInfo}function resolveWorkflowModulePath(e){if(e===`workflow`)return resolvePackageSourceFilePath(`src/internal/workflow/index.ts`);if(e===`workflow/internal/builtins`)return resolvePackageSourceFilePath(`src/internal/workflow/builtins.ts`);let t=WORKFLOW_MODULE_ALIASES[e];return t===void 0?require.resolve(e):resolvePackageCompiledFilePath(t)}export{resolveInstalledPackageInfo,resolvePackageRoot,resolvePackageSourceDirectoryPath,resolvePackageSourceFilePath,resolveWorkflowModulePath};

package/dist/src/internal/application/paths.js

@@ -1,117 +1 @@
-import { createHash } from "node:crypto";
-import { existsSync, readdirSync, readFileSync, rmSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { workflowEntryReference } from "#execution/workflow-runtime.js";
-import { resolveInstalledPackageInfo, resolvePackageRoot, resolvePackageSourceDirectoryPath, } from "#internal/application/package.js";
-/**
- * Resolves an application root from the current working directory.
- */
-export function resolveApplicationRoot(cwd = process.cwd()) {
-    return resolve(cwd);
-}
-function getWorkflowBuildCacheKey(appRoot) {
-    return createHash("sha256").update(appRoot).digest("hex").slice(0, 12);
-}
-function isVercelBuildEnvironment() {
-    return Boolean(process.env.VERCEL);
-}
-/**
- * Resolves the programmatic Nitro build directory for an app.
- */
-export function resolveNitroBuildDirectory(appRoot, surface = "all") {
-    const rootDirectory = join(appRoot, ".ash", "nitro");
-    if (surface === "all") {
-        return rootDirectory;
-    }
-    return join(rootDirectory, surface);
-}
-/**
- * Resolves the staged Nitro output directory for one isolated build surface.
- */
-export function resolveNitroSurfaceOutputDirectory(appRoot, surface) {
-    return join(appRoot, ".ash", "nitro-output", surface);
-}
-/**
- * Resolves the package-owned Workflow DevKit bundle directory for a target app.
- *
- * This directory is intentionally placed under the package root rather than the
- * application root so package-owned workflow caches are shared across generated
- * app roots without relying on app-local installed dependencies.
- *
- * Each application root receives a unique hash-keyed subdirectory so parallel
- * builds targeting different app roots never collide. The key is derived from
- * `appRoot` alone — version-keyed dirs are intentionally avoided so every code
- * path that resolves a cache directory converges on the same location and
- * `prepareAshVersionedCacheDirectory` remains the single source of truth for
- * version-based invalidation.
- */
-export function resolveWorkflowBuildDirectory(appRoot) {
-    const workflowCacheRoot = join(resolvePackageRoot(), ".ash", "workflow-cache");
-    pruneStaleWorkflowCacheSiblings(workflowCacheRoot);
-    return join(workflowCacheRoot, getWorkflowBuildCacheKey(appRoot));
-}
-/*
- * Defensive cleanup: removes legacy sibling cache directories whose recorded
- * ashVersion does not match the currently installed Ash. Earlier versions
- * keyed the cache directory by `appRoot + workflowId` (which embedded the
- * Ash version), so an upgrade left one or more orphaned directories on
- * disk. Without this sweep those directories can still be picked up by
- * downstream build steps and bake stale step IDs (e.g.
- * `step//experimental-ash@0.18.3//...`) into a freshly built dev bundle.
- */
-function pruneStaleWorkflowCacheSiblings(workflowCacheRoot) {
-    if (!existsSync(workflowCacheRoot)) {
-        return;
-    }
-    const currentVersion = resolveInstalledPackageInfo().version;
-    let entries;
-    try {
-        entries = readdirSync(workflowCacheRoot);
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        const entryPath = join(workflowCacheRoot, entry);
-        const metadataPath = join(entryPath, "ash-cache.json");
-        if (!existsSync(metadataPath)) {
-            continue;
-        }
-        try {
-            const parsed = JSON.parse(readFileSync(metadataPath, "utf8"));
-            if (typeof parsed.ashVersion === "string" && parsed.ashVersion !== currentVersion) {
-                rmSync(entryPath, { force: true, recursive: true });
-            }
-        }
-        catch {
-            // Best-effort cleanup; ignore corrupt metadata.
-        }
-    }
-}
-/**
- * Resolves the cache directory used for durable local sandbox snapshots.
- */
-export function resolveSandboxCacheDirectory(appRoot) {
-    return join(appRoot, ".ash", "sandbox-cache");
-}
-/**
- * Resolves the production Nitro output directory for an app.
- */
-export function resolveOutputDirectory(appRoot) {
-    if (isVercelBuildEnvironment()) {
-        return join(appRoot, ".vercel", "output");
-    }
-    return join(appRoot, ".output");
-}
-/**
- * Returns structured app information for diagnostics and CLI output.
- */
-export function getApplicationInfo(appRoot) {
-    return {
-        appRoot,
-        outputDir: resolveOutputDirectory(appRoot),
-        workflowId: workflowEntryReference.workflowId,
-        workflowBuildDir: resolveWorkflowBuildDirectory(appRoot),
-        workflowSourceDir: resolvePackageSourceDirectoryPath("src/execution"),
-    };
-}
+import{join,resolve}from"node:path";import{existsSync,readFileSync,readdirSync,rmSync}from"node:fs";import{resolveInstalledPackageInfo,resolvePackageRoot,resolvePackageSourceDirectoryPath}from"#internal/application/package.js";import{createHash}from"node:crypto";import{workflowEntryReference}from"#execution/workflow-runtime.js";function resolveApplicationRoot(e=process.cwd()){return resolve(e)}function getWorkflowBuildCacheKey(e){return createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function isVercelBuildEnvironment(){return!!process.env.VERCEL}function resolveNitroBuildDirectory(t,n=`all`){let r=join(t,`.ash`,`nitro`);return n===`all`?r:join(r,n)}function resolveNitroSurfaceOutputDirectory(t,n){return join(t,`.ash`,`nitro-output`,n)}function resolveWorkflowBuildDirectory(t){let n=join(resolvePackageRoot(),`.ash`,`workflow-cache`);return pruneStaleWorkflowCacheSiblings(n),join(n,getWorkflowBuildCacheKey(t))}function pruneStaleWorkflowCacheSiblings(t){if(!existsSync(t))return;let o=resolveInstalledPackageInfo().version,s;try{s=readdirSync(t)}catch{return}for(let i of s){let a=join(t,i),s=join(a,`ash-cache.json`);if(existsSync(s))try{let e=JSON.parse(readFileSync(s,`utf8`));typeof e.ashVersion==`string`&&e.ashVersion!==o&&rmSync(a,{force:!0,recursive:!0})}catch{}}}function resolveSandboxCacheDirectory(t){return join(t,`.ash`,`sandbox-cache`)}function resolveOutputDirectory(t){return isVercelBuildEnvironment()?join(t,`.vercel`,`output`):join(t,`.output`)}function getApplicationInfo(e){return{appRoot:e,outputDir:resolveOutputDirectory(e),workflowId:workflowEntryReference.workflowId,workflowBuildDir:resolveWorkflowBuildDirectory(e),workflowSourceDir:resolvePackageSourceDirectoryPath(`src/execution`)}}export{getApplicationInfo,resolveApplicationRoot,resolveNitroBuildDirectory,resolveNitroSurfaceOutputDirectory,resolveOutputDirectory,resolveSandboxCacheDirectory,resolveWorkflowBuildDirectory};

package/dist/src/internal/application/runtime-compiled-artifacts-source.js

@@ -1,11 +1 @@
-import { createDiskRuntimeCompiledArtifactsSource, } from "#runtime/compiled-artifacts-source.js";
-import { resolvePackageSourceFilePath } from "#internal/application/package.js";
-/**
- * Creates a disk-backed artifact source for dev/build flows that may need to
- * hydrate authored modules directly from source files.
- */
-export function createAuthoredSourceRuntimeCompiledArtifactsSource(appRoot) {
-    return createDiskRuntimeCompiledArtifactsSource(appRoot, {
-        moduleMapLoaderPath: resolvePackageSourceFilePath("src/internal/authored-module-map-loader.ts"),
-    });
-}
+import{resolvePackageSourceFilePath}from"#internal/application/package.js";import{createDiskRuntimeCompiledArtifactsSource}from"#runtime/compiled-artifacts-source.js";function createAuthoredSourceRuntimeCompiledArtifactsSource(e){return createDiskRuntimeCompiledArtifactsSource(e,{moduleMapLoaderPath:resolvePackageSourceFilePath(`src/internal/authored-module-map-loader.ts`)})}export{createAuthoredSourceRuntimeCompiledArtifactsSource};

package/dist/src/internal/attachments/data.js

@@ -1,127 +1 @@
-/**
- * Shared helpers for decoding AI SDK `FilePart.data` values into raw
- * bytes and inspecting their size without fetching remote resources.
- *
- * URL-shaped inputs that require IO return `null`; channel attachment
- * refs are resolved explicitly by the staging layer.
- */
-import { isAttachmentRefUrl, parseAttachmentRef } from "#internal/attachments/refs.js";
-/**
- * Converts any inline AI SDK `FilePart.data` value into raw bytes.
- *
- * Returns `null` for every URL-shaped input the caller is expected to
- * handle out-of-band, including `ash-attachment:` refs and remote URLs.
- */
-export async function fileDataToBytes(data) {
-    // Buffer extends Uint8Array — check it first so genuine Buffer inputs
-    // short-circuit to identity instead of an unnecessary copy.
-    if (typeof Buffer !== "undefined" && Buffer.isBuffer(data)) {
-        return data;
-    }
-    if (data instanceof Uint8Array) {
-        return Buffer.from(data);
-    }
-    if (data instanceof ArrayBuffer) {
-        return Buffer.from(new Uint8Array(data));
-    }
-    if (typeof data === "string") {
-        return decodeStringData(data);
-    }
-    if (data instanceof URL) {
-        if (data.protocol === "data:") {
-            return decodeStringData(data.href);
-        }
-        // Every other URL scheme (including ash-attachment: and http(s):)
-        // requires IO the caller must own.
-        return null;
-    }
-    return null;
-}
-/**
- * Returns the byte length of `FilePart.data` without performing any IO.
- */
-export function getKnownByteLength(data) {
-    if (typeof Buffer !== "undefined" && Buffer.isBuffer(data)) {
-        return data.byteLength;
-    }
-    if (data instanceof Uint8Array) {
-        return data.byteLength;
-    }
-    if (data instanceof ArrayBuffer) {
-        return data.byteLength;
-    }
-    if (typeof data === "string") {
-        return computeStringByteLength(data);
-    }
-    if (isAttachmentRefUrl(data)) {
-        const ref = parseAttachmentRef(data);
-        return ref.size ?? null;
-    }
-    if (data instanceof URL) {
-        if (data.protocol === "data:") {
-            return computeStringByteLength(data.href);
-        }
-        return null;
-    }
-    return null;
-}
-function decodeStringData(value) {
-    if (value.startsWith("data:")) {
-        const comma = value.indexOf(",");
-        if (comma === -1) {
-            return null;
-        }
-        const header = value.slice(5, comma);
-        const body = value.slice(comma + 1);
-        if (header.endsWith(";base64")) {
-            return Buffer.from(body, "base64");
-        }
-        return Buffer.from(decodeURIComponent(body), "utf8");
-    }
-    if (/^https?:\/\//.test(value)) {
-        return null;
-    }
-    // Bare strings are treated as base64 payloads, matching AI SDK's
-    // `DataContent` convention.
-    return Buffer.from(value, "base64");
-}
-function computeStringByteLength(value) {
-    if (value.startsWith("data:")) {
-        const comma = value.indexOf(",");
-        if (comma === -1) {
-            return null;
-        }
-        const header = value.slice(5, comma);
-        const body = value.slice(comma + 1);
-        if (header.endsWith(";base64")) {
-            return estimateBase64ByteLength(body);
-        }
-        // Percent-encoded UTF-8 payload — estimate by decoding; the bytes
-        // we care about are the final UTF-8 octets, not the percent-encoded
-        // string length.
-        try {
-            return Buffer.byteLength(decodeURIComponent(body), "utf8");
-        }
-        catch {
-            return Buffer.byteLength(body, "utf8");
-        }
-    }
-    if (/^https?:\/\//.test(value)) {
-        return null;
-    }
-    return estimateBase64ByteLength(value);
-}
-function estimateBase64ByteLength(base64) {
-    const trimmed = base64.trimEnd();
-    if (trimmed.length === 0) {
-        return 0;
-    }
-    let padding = 0;
-    if (trimmed.endsWith("==")) {
-        padding = 2;
-    }
-    else if (trimmed.endsWith("=")) {
-        padding = 1;
-    }
-    return Math.max(0, Math.floor((trimmed.length * 3) / 4) - padding);
-}
+import{isAttachmentRefUrl,parseAttachmentRef}from"#internal/attachments/refs.js";async function fileDataToBytes(e){return typeof Buffer<`u`&&Buffer.isBuffer(e)?e:e instanceof Uint8Array?Buffer.from(e):e instanceof ArrayBuffer?Buffer.from(new Uint8Array(e)):typeof e==`string`?decodeStringData(e):e instanceof URL&&e.protocol===`data:`?decodeStringData(e.href):null}function getKnownByteLength(n){return typeof Buffer<`u`&&Buffer.isBuffer(n)||n instanceof Uint8Array||n instanceof ArrayBuffer?n.byteLength:typeof n==`string`?computeStringByteLength(n):isAttachmentRefUrl(n)?parseAttachmentRef(n).size??null:n instanceof URL&&n.protocol===`data:`?computeStringByteLength(n.href):null}function decodeStringData(e){if(e.startsWith(`data:`)){let t=e.indexOf(`,`);if(t===-1)return null;let n=e.slice(5,t),r=e.slice(t+1);return n.endsWith(`;base64`)?Buffer.from(r,`base64`):Buffer.from(decodeURIComponent(r),`utf8`)}return/^https?:\/\//.test(e)?null:Buffer.from(e,`base64`)}function computeStringByteLength(e){if(e.startsWith(`data:`)){let t=e.indexOf(`,`);if(t===-1)return null;let n=e.slice(5,t),r=e.slice(t+1);if(n.endsWith(`;base64`))return estimateBase64ByteLength(r);try{return Buffer.byteLength(decodeURIComponent(r),`utf8`)}catch{return Buffer.byteLength(r,`utf8`)}}return/^https?:\/\//.test(e)?null:estimateBase64ByteLength(e)}function estimateBase64ByteLength(e){let t=e.trimEnd();if(t.length===0)return 0;let n=0;return t.endsWith(`==`)?n=2:t.endsWith(`=`)&&(n=1),Math.max(0,Math.floor(t.length*3/4)-n)}export{fileDataToBytes,getKnownByteLength};

package/dist/src/internal/attachments/errors.js

@@ -1,26 +1 @@
-/**
- * Error surfaced when an attachment resolver fails to produce bytes for
- * an {@link AttachmentRef}.
- *
- * Channels can inspect the `.kind` discriminator to decide whether to
- * drop the attachment and continue the turn (the default posture for
- * every kind today) or fail the whole delivery (future strict mode).
- * The original failure, when there is one, is preserved on `.cause` so
- * observability can surface the upstream error without losing context.
- */
-export class AshAttachmentError extends Error {
-    kind;
-    adapterKind;
-    cause;
-    constructor(input) {
-        super(input.message);
-        this.name = "AshAttachmentError";
-        this.kind = input.kind;
-        if (input.adapterKind !== undefined) {
-            this.adapterKind = input.adapterKind;
-        }
-        if (input.cause !== undefined) {
-            this.cause = input.cause;
-        }
-    }
-}
+var AshAttachmentError=class extends Error{kind;adapterKind;cause;constructor(e){super(e.message),this.name=`AshAttachmentError`,this.kind=e.kind,e.adapterKind!==void 0&&(this.adapterKind=e.adapterKind),e.cause!==void 0&&(this.cause=e.cause)}};export{AshAttachmentError};

package/dist/src/internal/attachments/refs.js

@@ -1,94 +1 @@
-/**
- * Opaque attachment references: the wire format a channel uses to carry
- * file identity across step boundaries without inlining the bytes.
- *
- * Refs are compact custom-scheme URLs:
- *
- * ```
- * ash-attachment:?v=1&p=<base64url-encoded JSON of { params, size? }>
- * ```
- */
-/**
- * Custom URL scheme used by every attachment ref. The trailing colon
- * is part of the scheme per WHATWG URL semantics.
- */
-export const ATTACHMENT_REF_SCHEME = "ash-attachment:";
-/**
- * Current wire format version. Decoders reject any other value so a
- * future format bump doesn't silently misparse.
- */
-export const ATTACHMENT_REF_WIRE_VERSION = "1";
-import { toErrorMessage } from "#shared/errors.js";
-const VERSION_QUERY_KEY = "v";
-const PAYLOAD_QUERY_KEY = "p";
-function isValidSize(value) {
-    return Number.isFinite(value) && Number.isInteger(value) && value >= 0;
-}
-/**
- * Encodes an {@link AttachmentRef} as a URL suitable for use as
- * `FilePart.data`.
- *
- * `TParams` links the encoded payload shape to the channel resolver.
- */
-export function encodeAttachmentRef(ref) {
-    if (ref.size !== undefined && !isValidSize(ref.size)) {
-        throw new RangeError(`AttachmentRef.size must be a non-negative integer. Received: ${String(ref.size)}.`);
-    }
-    const payload = ref.size === undefined ? { params: ref.params } : { params: ref.params, size: ref.size };
-    const encoded = Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
-    const url = new URL(ATTACHMENT_REF_SCHEME);
-    url.searchParams.set(VERSION_QUERY_KEY, ATTACHMENT_REF_WIRE_VERSION);
-    url.searchParams.set(PAYLOAD_QUERY_KEY, encoded);
-    return url;
-}
-/**
- * Parses an {@link AttachmentRef} back out of a URL.
- */
-export function parseAttachmentRef(url) {
-    if (url.protocol !== ATTACHMENT_REF_SCHEME) {
-        throw new Error(`AttachmentRef URL must use scheme "${ATTACHMENT_REF_SCHEME}". Got: "${url.protocol}".`);
-    }
-    const version = url.searchParams.get(VERSION_QUERY_KEY);
-    if (version !== ATTACHMENT_REF_WIRE_VERSION) {
-        throw new Error(`AttachmentRef wire format version must be "${ATTACHMENT_REF_WIRE_VERSION}". Got: ${version === null ? "missing" : JSON.stringify(version)}.`);
-    }
-    const encoded = url.searchParams.get(PAYLOAD_QUERY_KEY);
-    if (encoded === null || encoded === "") {
-        throw new Error('AttachmentRef URL is missing the required "p" payload query param.');
-    }
-    let payload;
-    try {
-        const json = Buffer.from(encoded, "base64url").toString("utf8");
-        payload = JSON.parse(json);
-    }
-    catch (cause) {
-        throw new Error(`AttachmentRef payload is not valid base64url-encoded JSON: ${toErrorMessage(cause)}`);
-    }
-    if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
-        throw new Error("AttachmentRef payload must decode to a JSON object.");
-    }
-    const record = payload;
-    if (!("params" in record)) {
-        throw new Error('AttachmentRef payload is missing the required "params" field.');
-    }
-    const params = record.params;
-    if (!("size" in record)) {
-        return { params };
-    }
-    const size = record.size;
-    if (typeof size !== "number" || !isValidSize(size)) {
-        throw new Error(`AttachmentRef payload "size" must be a non-negative integer. Got: ${JSON.stringify(size)}.`);
-    }
-    return { params, size };
-}
-/**
- * Cheap runtime check: does this value look like an attachment-ref URL?
- *
- * Accepts `URL` instances with the `ash-attachment:` scheme. Strings
- * are NOT accepted — the staging layer only checks URL-instance
- * `FilePart.data` values, matching the existing `data instanceof URL`
- * branch in `fileDataToBytes`.
- */
-export function isAttachmentRefUrl(value) {
-    return value instanceof URL && value.protocol === ATTACHMENT_REF_SCHEME;
-}
+import{toErrorMessage}from"#shared/errors.js";var ATTACHMENT_REF_SCHEME=`ash-attachment:`,ATTACHMENT_REF_WIRE_VERSION=`1`,VERSION_QUERY_KEY=`v`,PAYLOAD_QUERY_KEY=`p`;function isValidSize(e){return Number.isFinite(e)&&Number.isInteger(e)&&e>=0}function encodeAttachmentRef(e){if(e.size!==void 0&&!isValidSize(e.size))throw RangeError(`AttachmentRef.size must be a non-negative integer. Received: ${String(e.size)}.`);let n=e.size===void 0?{params:e.params}:{params:e.params,size:e.size},r=Buffer.from(JSON.stringify(n),`utf8`).toString(`base64url`),i=new URL(ATTACHMENT_REF_SCHEME);return i.searchParams.set(VERSION_QUERY_KEY,`1`),i.searchParams.set(PAYLOAD_QUERY_KEY,r),i}function parseAttachmentRef(n){if(n.protocol!==`ash-attachment:`)throw Error(`AttachmentRef URL must use scheme "${ATTACHMENT_REF_SCHEME}". Got: "${n.protocol}".`);let r=n.searchParams.get(VERSION_QUERY_KEY);if(r!==`1`)throw Error(`AttachmentRef wire format version must be "1". Got: ${r===null?`missing`:JSON.stringify(r)}.`);let i=n.searchParams.get(PAYLOAD_QUERY_KEY);if(i===null||i===``)throw Error(`AttachmentRef URL is missing the required "p" payload query param.`);let a;try{let e=Buffer.from(i,`base64url`).toString(`utf8`);a=JSON.parse(e)}catch(t){throw Error(`AttachmentRef payload is not valid base64url-encoded JSON: ${toErrorMessage(t)}`)}if(typeof a!=`object`||!a||Array.isArray(a))throw Error(`AttachmentRef payload must decode to a JSON object.`);let o=a;if(!(`params`in o))throw Error(`AttachmentRef payload is missing the required "params" field.`);let s=o.params;if(!(`size`in o))return{params:s};let c=o.size;if(typeof c!=`number`||!isValidSize(c))throw Error(`AttachmentRef payload "size" must be a non-negative integer. Got: ${JSON.stringify(c)}.`);return{params:s,size:c}}function isAttachmentRefUrl(e){return e instanceof URL&&e.protocol===`ash-attachment:`}export{ATTACHMENT_REF_SCHEME,ATTACHMENT_REF_WIRE_VERSION,encodeAttachmentRef,isAttachmentRefUrl,parseAttachmentRef};