@nodetool-ai/runtime 0.7.0-rc.22 → 0.8.1

package/dist/image-codec.js

@@ -0,0 +1,273 @@
+/**
+ * Image codec helpers for the raw-RGBA in-flight format.
+ *
+ * GPU image ops emit `ImageRef`s whose `data` is raw straight-alpha RGBA8
+ * (marked by `mimeType === RAW_RGBA_MIME`) so adjacent GPU ops skip the codec.
+ * Any boundary that needs portable bytes (client, storage, file save, the
+ * Python bridge) lazily encodes them to PNG via these helpers. Everything else
+ * must go through the shared decode/encode paths rather than assume `data` is
+ * already an encoded image.
+ */
+import { importHidden } from "@nodetool-ai/config";
+import { isRawRgbaImage } from "@nodetool-ai/protocol";
+let _sharpPromise = null;
+/**
+ * Actionable error for a missing/broken `sharp` native addon, thrown by the
+ * raw-RGBA → PNG encoder when {@link loadSharp} resolves null and no Canvas
+ * fallback applies.
+ */
+export const SHARP_UNAVAILABLE_MESSAGE = "The 'sharp' image codec is unavailable. It is a native addon that must be " +
+    "installed for this runtime (run `npm install sharp` in the server install, " +
+    "or reinstall it for your platform/arch — e.g. musl or a serverless target). " +
+    "Raw-RGBA images cannot be encoded to PNG here without sharp or a Canvas.";
+/**
+ * Lazily load `sharp`. Resolves `null` — never throws an opaque module-load
+ * error — off Node (browser/edge) or when the Node native addon can't load
+ * (musl, unbundled serverless, ABI mismatch, partial install). A rejected
+ * attempt is never cached, so a fixed install is picked up on the next call.
+ * Callers handle `null` with a Canvas fallback or a clear, actionable error.
+ */
+async function loadSharp() {
+    if (!_sharpPromise) {
+        // The attempt rejects when the import throws (broken addon: musl, ABI
+        // mismatch, partial install) so the `.catch` below can drop it from the
+        // cache and a later, fixed install is picked up. A legitimate off-Node
+        // `null` resolves and is cached — there is nothing to retry there.
+        const attempt = (async () => {
+            const mod = await importHidden("sharp");
+            if (!mod)
+                return null;
+            return "default" in mod ? mod.default : mod;
+        })();
+        _sharpPromise = attempt;
+        attempt.catch(() => {
+            if (_sharpPromise === attempt)
+                _sharpPromise = null;
+        });
+    }
+    // Never surface an opaque module-load error to callers; a broken addon is
+    // reported as `null` (caller falls back to Canvas or a clear, actionable
+    // error). The cache reset above already happened on the rejected attempt.
+    return _sharpPromise.catch(() => null);
+}
+/** Encode raw straight-alpha RGBA8 pixels to PNG bytes. */
+export async function encodeRawRgbaToPng(data, width, height) {
+    const sharp = await loadSharp();
+    if (!sharp) {
+        // No sharp (off Node, or a Node target where the addon won't load). Use
+        // OffscreenCanvas when the runtime exposes one (a bundled browser/edge or a
+        // Node build with Canvas); otherwise fail with a clear, actionable error.
+        if (typeof OffscreenCanvas !== "undefined") {
+            const canvas = new OffscreenCanvas(width, height);
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                throw new Error("OffscreenCanvas 2D context unavailable");
+            ctx.putImageData(new ImageData(new Uint8ClampedArray(data), width, height), 0, 0);
+            const blob = await canvas.convertToBlob({ type: "image/png" });
+            return new Uint8Array(await blob.arrayBuffer());
+        }
+        throw new Error(SHARP_UNAVAILABLE_MESSAGE);
+    }
+    const png = await sharp(Buffer.from(data.buffer, data.byteOffset, data.byteLength), { raw: { width, height, channels: 4 } })
+        .png()
+        .toBuffer();
+    return new Uint8Array(png);
+}
+/**
+ * If `ref` is a raw-RGBA image, return an equivalent ImageRef with `data`
+ * encoded to PNG and `mimeType` set to `image/png`; otherwise return it
+ * unchanged. Use at any boundary that must hand out a portable image.
+ */
+export async function encodeRawImageRef(ref) {
+    if (!isRawRgbaImage(ref))
+        return ref;
+    const png = await encodeRawRgbaToPng(ref.data, ref.width, ref.height);
+    return { ...ref, data: png, mimeType: "image/png" };
+}
+/**
+ * Where an SVG can name a resource: an `href` / `xlink:href` attribute, and a
+ * CSS `url()`. Used to *split* the markup, so each piece that follows is where
+ * one value begins.
+ *
+ * Splitting rather than matching the values is the whole point, and it took
+ * two CodeQL findings to arrive at. A regex that matches a value restarts at
+ * the next candidate when it fails, and a value scan that runs to the end of
+ * the document on each of n candidates is quadratic: `"url(" + 2000 spaces`
+ * never finished against the first version, and `"url(".repeat(400_000)`
+ * took 15s against the second. Pieces, by contrast, partition the document —
+ * bounded work per piece sums to linear however many openers there are.
+ */
+const REFERENCE_OPENER = /(url\(|(?:xlink:)?href\s*=\s*)/i;
+/** Longest value the screen reads. Past this it is not a URL anyone meant. */
+const MAX_REFERENCE_VALUE = 2048;
+const isSpace = (ch) => ch === " " || ch === "\t" || ch === "\n" || ch === "\r" || ch === "\f";
+/** Characters that end a reference value in either syntax. */
+const VALUE_END = new Set([")", '"', "'", ">", " ", "\t", "\n", "\r", "\f"]);
+/**
+ * Read the value out of the text following an opener.
+ *
+ * Truncating at {@link MAX_REFERENCE_VALUE} is safe in the direction that
+ * matters: the value is only tested for a `#` or `data:` prefix, and a
+ * truncated value keeps its prefix — so a long `data:` payload still reads as
+ * internal, and anything else still reads as external.
+ */
+function referenceValue(piece) {
+    let i = 0;
+    while (i < piece.length && isSpace(piece[i]))
+        i++;
+    if (piece[i] === '"' || piece[i] === "'")
+        i++;
+    const start = i;
+    const limit = Math.min(piece.length, start + MAX_REFERENCE_VALUE);
+    while (i < limit && !VALUE_END.has(piece[i]))
+        i++;
+    return piece.slice(start, i);
+}
+/**
+ * Whether a reference points outside the document. A fragment (`#id`) and a
+ * `data:` payload are self-contained; an empty value names nothing.
+ */
+function isExternalReference(value) {
+    if (!value)
+        return false;
+    if (value.startsWith("#"))
+        return false;
+    return !value.slice(0, 5).toLowerCase().startsWith("data:");
+}
+/** The first reference in this markup that points outside it, if any. */
+function firstExternalReference(markup) {
+    // One capture group, so `split` interleaves: text, opener, text, opener, …
+    // Every even index from 2 up is the text a value starts in.
+    const parts = markup.split(REFERENCE_OPENER);
+    for (let i = 2; i < parts.length; i += 2) {
+        const value = referenceValue(parts[i]);
+        if (isExternalReference(value))
+            return value;
+    }
+    return null;
+}
+/** Largest SVG this rasterizer will hand to the decoder. */
+const MAX_SVG_BYTES = 8 * 1024 * 1024;
+/** Longest side an SVG is rendered at when the caller names no `minSide`. */
+const SVG_FALLBACK_SIDE = 1024;
+/** Ceiling on the raster an SVG is rendered into, whatever `minSide` asks for. */
+const MAX_SVG_RASTER_SIDE = 4096;
+/**
+ * Rasterize SVG markup to PNG bytes.
+ *
+ * Vector sources reach the raster paths (a vision provider's image block, a
+ * crop, a downscale) only through here. Two rules the caller does not have to
+ * know about:
+ *
+ * - **No external references.** The decoder behind `sharp` is librsvg, which
+ *   resolves `href` and `url()` against the process's own filesystem and
+ *   network. Since the markup here is written by a model or uploaded by
+ *   whoever, a document that reaches outward is refused by name rather than
+ *   rendered — the error tells the caller to inline the resource.
+ * - **A usable size.** An SVG that declares `width="24"` renders to a 24px
+ *   PNG, which is not something a model can read. `minSide` scales the render
+ *   up so the result is worth looking at, defaulting to
+ *   {@link SVG_FALLBACK_SIDE}.
+ */
+export async function rasterizeSvg(bytes, opts = {}) {
+    if (bytes.byteLength > MAX_SVG_BYTES) {
+        throw new Error(`SVG is ${bytes.byteLength} bytes, over the ${MAX_SVG_BYTES}-byte limit for rasterization.`);
+    }
+    const markup = new TextDecoder("utf-8", { fatal: false }).decode(bytes);
+    const external = firstExternalReference(markup);
+    if (external !== null) {
+        throw new Error(`Refusing to render an SVG that references "${external}". ` +
+            `The renderer would fetch it from this host's filesystem or network. ` +
+            `Inline the resource as a data: URI, or drop the reference.`);
+    }
+    const sharp = await loadSharp();
+    if (!sharp) {
+        throw new Error(SHARP_UNAVAILABLE_MESSAGE);
+    }
+    const buffer = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const intrinsic = await sharp(buffer).metadata();
+    const srcSide = Math.max(intrinsic.width ?? 0, intrinsic.height ?? 0);
+    const targetSide = Math.min(opts.minSide ?? SVG_FALLBACK_SIDE, MAX_SVG_RASTER_SIDE);
+    // librsvg scales the whole render by DPI, so a density is how an SVG is asked
+    // for more pixels than it declares; 72 is the 1:1 baseline. The density is
+    // left unbounded because what it produces is not: the render lands at
+    // `targetSide` however few units the document declares, so a `width="0.01"`
+    // document costs the same pixels as any other.
+    const density = srcSide > 0 && srcSide < targetSide
+        ? Math.ceil((72 * targetSide) / srcSide)
+        : 72;
+    let pipeline = sharp(buffer, { density, failOn: "none" });
+    if (opts.maxSide && opts.maxSide > 0) {
+        pipeline = pipeline.resize({
+            width: opts.maxSide,
+            height: opts.maxSide,
+            fit: "inside",
+            withoutEnlargement: true
+        });
+    }
+    const { data, info } = await pipeline
+        .png()
+        .toBuffer({ resolveWithObject: true });
+    return { data: new Uint8Array(data), width: info.width, height: info.height };
+}
+/**
+ * Decode encoded image bytes (PNG/JPEG/WebP/…), optionally crop to a pixel
+ * `region` and/or downscale so the longest side fits `maxSide`, then re-encode
+ * to PNG. Used by the `view_image` tool to load only the pixels an agent asks
+ * for — a region crop and a "low" detail downscale both cut the token cost of
+ * the image the model actually sees.
+ *
+ * Coordinates are clamped to the image bounds, so an over-large or partly
+ * out-of-frame region yields the overlapping area rather than an error. When
+ * `sharp` is unavailable (off Node, or a broken native addon) the original
+ * bytes are returned unchanged with `width`/`height` 0 — the caller still gets
+ * a viewable full image, just uncropped. In that pass-through case the returned
+ * `mimeType` is `opts.sourceMime` (the caller's known format) so the bytes are
+ * never mislabeled; it falls back to `image/png` only when the caller didn't
+ * provide one.
+ */
+export async function extractImageRegion(bytes, opts = {}) {
+    const sharp = await loadSharp();
+    if (!sharp) {
+        // No re-encode happened — keep the true source mime rather than claiming
+        // PNG for what may be JPEG/WebP/GIF bytes (which a vision provider rejects).
+        return {
+            data: bytes,
+            mimeType: opts.sourceMime || "image/png",
+            width: 0,
+            height: 0
+        };
+    }
+    let pipeline = sharp(Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength), {
+        failOn: "none"
+    });
+    const meta = await pipeline.metadata();
+    const srcW = meta.width ?? 0;
+    const srcH = meta.height ?? 0;
+    const region = opts.region;
+    if (region) {
+        const left = Math.max(0, Math.min(Math.floor(region.x), Math.max(0, srcW - 1)));
+        const top = Math.max(0, Math.min(Math.floor(region.y), Math.max(0, srcH - 1)));
+        const maxW = srcW ? srcW - left : Math.floor(region.width);
+        const maxH = srcH ? srcH - top : Math.floor(region.height);
+        const width = Math.max(1, Math.min(Math.floor(region.width), maxW));
+        const height = Math.max(1, Math.min(Math.floor(region.height), maxH));
+        pipeline = pipeline.extract({ left, top, width, height });
+    }
+    if (opts.maxSide && opts.maxSide > 0) {
+        pipeline = pipeline.resize({
+            width: opts.maxSide,
+            height: opts.maxSide,
+            fit: "inside",
+            withoutEnlargement: true
+        });
+    }
+    const { data, info } = await pipeline.png().toBuffer({ resolveWithObject: true });
+    return {
+        data: new Uint8Array(data),
+        mimeType: "image/png",
+        width: info.width,
+        height: info.height
+    };
+}
+//# sourceMappingURL=image-codec.js.map

package/dist/image-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-codec.js","sourceRoot":"","sources":["../src/image-codec.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,18 +1,68 @@
 /**
  * @nodetool-ai/runtime – Public API
  */
-export { ProcessingContext, MemoryCache, InMemoryStorageAdapter, FileStorageAdapter, S3StorageAdapter, resolveWorkspacePath, type AssetOutputMode, type CacheAdapter, type S3Client, type StorageAdapter } from "./context.js";
+export { ProcessingContext, ACTIVE_MODEL_CONTEXT_KEY, type ActiveModelSelection, MemoryCache, resolveWorkspacePath, setDefaultModelInterfaces, getDefaultModelInterfaces, mediaResolverFor, type AssetOutputMode, type CacheAdapter, type AssetInfoEntry, type FolderAssetEntry, type ProcessingContextModelInterfaces, type EntityUpsertArgs, type GenerationRequest, type GenerationResult, type GenerationRunOptions, type GenerationLifecycleHooks, GenerationAlreadyAcceptedError, type InjectedTool, type StorageAdapter, type StorageEntry, type StorageListResult, type StorageStat } from "./context.js";
+export { WorkspacePathError, WorkspaceNotLocalError, observeWorkspace, type Workspace, type WorkspaceChange, type WorkspaceEntry, type WorkspaceStat } from "./workspace.js";
+export { StorageWorkspace, createWorkspace, createLocalWorkspace } from "./storage-workspace.js";
+export { PrefixedStorageAdapter } from "./prefixed-storage-adapter.js";
+export type { SandboxModuleCatalog } from "./sandbox-module-catalog.js";
+export { getProcessSandboxModuleCatalog, refuseSandboxDelivery, setProcessSandboxModuleCatalog } from "./sandbox-module-catalog.js";
+export { AgentMemory, memoryKeys, type MemoryEntry, type MemoryFilter, type MemoryKind, type MemoryListener } from "./agent-memory.js";
 export * from "./providers/index.js";
-export { initTelemetry, getTracer, type TelemetryOptions } from "./telemetry.js";
+export { initTelemetry, shutdownTelemetry, getTracer, type TelemetryOptions } from "./telemetry.js";
 export { spanToRecord, JsonlFileSpanExporter, StdoutSpanExporter, type TraceRecord, type StdoutFormat } from "./trace-exporters.js";
-export { withAgentSpan, withAgentSpanGen, withWorkflowSpan, withNodeSpan, withSpanGen, setLastUsage, consumeLastUsage, peekLastUsage, createUsageSlot, type AgentSpanKind, type LlmUsage } from "./tracing-helpers.js";
+export { withAgentSpan, withAgentSpanGen, withSpan, withWorkflowSpan, withNodeSpan, withSpanGen, setLastUsage, consumeLastUsage, peekLastUsage, createUsageSlot, type AgentSpanKind, type LlmUsage } from "./tracing-helpers.js";
+export { RecoverableNodeError, isRecoverableNodeError } from "./recoverable-node-error.js";
+export { createInvocationAccount, inInvocationAccount, recordInvocationCost, recordInvocationAsset, currentInvocationAccount, type InvocationAccount } from "./invocation-account.js";
+export { recordGenerationReceipt, recordGenerationProviderResult, recordGenerationReceiptAsync, recordGenerationBindingAsync, runWithGenerationReceipt, currentGenerationReceipt, currentGenerationProviderRequestOptions, isAuthoritativeProviderTerminalError, GenerationScopeError, type GenerationReceiptScopeOptions, type GenerationProviderRequestOptions } from "./generation-receipt.js";
+export { HIGGSFIELD_BASE, HiggsfieldApiError, higgsfieldSubmit, higgsfieldGetStatus, higgsfieldGetStatusByRequestId, higgsfieldAwaitResult, higgsfieldCancel, higgsfieldCancelByRequestId, higgsfieldEstimate, higgsfieldCreateUploadUrl, higgsfieldUploadMedia, higgsfieldOutputUrls, higgsfieldDownloadResult } from "./providers/higgsfield-transport.js";
+export type { HiggsfieldCredentials, HiggsfieldStatus, HiggsfieldSubmission, HiggsfieldUpload, HiggsfieldEstimate } from "./providers/higgsfield-transport.js";
+export { generationRegistry, type GenerationOutcome, type CompletedGeneration } from "./generation-registry.js";
+export { redactGenerationParams } from "./redact-params.js";
+export { CostCappedTurnBudget, CompositeTurnBudget, createRunBudget, createDeadline, createSemaphore, createCounter, isRunBudget, budgetFromContext, RUN_BUDGET_CONTEXT_KEY, BUDGET_EXHAUSTION_KINDS, TURN_REFUSALS, type TurnBudget, type TurnReservation, type TurnReservationHandle, type CostCappedTurnBudgetOptions, type CompositeTurnBudgetOptions, type CreateRunBudgetOptions, type RunBudget, type RunTurnBudget, type BudgetExhaustion, type BudgetExhaustionKind, type TurnRefusal, type Deadline, type Semaphore, type Release, type Counter } from "./turn-budget.js";
 export { packContext, type PackedContext } from "./context-packer.js";
+export { resolveEntities, type EntityLibraryContext } from "./entities.js";
+export { isZodSchema, parseWithTypeCoercion, zodToJsonSchema, type JsonSchema, type ZodOrJsonSchema } from "@nodetool-ai/protocol/zod-schema";
+export { VariableChannel } from "./variable-channel.js";
+export { countTokens, truncateToTokens } from "./token-counter.js";
 export { PythonStdioBridge, type PythonBridgeOptions, type PythonNodeMetadata, type ExecuteResult, type ProgressEvent, type PythonWorkerLoadError, type PythonWorkerStatus } from "./python-stdio-bridge.js";
+import { PythonBridgeBase } from "./python-bridge-base.js";
+export { PythonBridgeBase };
+export type { UnifiedModelLike, ExecuteIdentity, JobBoundary, PythonJobLifecycle, ModelEvictRequest, ModelEvictResult, ModelDownloadRequest, ModelDownloadUpdate, ComfyStatusInfo, ComfyEvent, ComfyExecuteOptions, ComfyExecuteResult, ComfyModelDownloadRequest, ComfyModelDownloadUpdate, ComfyModelInfo, BlenderExecuteJob, BlenderStatusInfo, BlenderEvent, BlenderExecuteOptions, BlenderExecuteResult } from "./python-bridge-types.js";
+export { WebsocketPythonBridge, type WebsocketPythonBridgeOptions } from "./python-websocket-bridge.js";
+export { createPythonBridge, onPythonBridgeCreated } from "./python-bridge-factory.js";
+export type { PythonBridgeObserver } from "./python-bridge-factory.js";
+export { encodeFrame, FrameDecoder, FrameSizeError, DEFAULT_MAX_BRIDGE_FRAME_SIZE, type FrameDecoderOptions } from "./python-bridge-framing.js";
+export { SwappableBridge } from "./swappable-python-bridge.js";
+/**
+ * Transport-agnostic public handle for a Python worker bridge. An interface
+ * (not the concrete base) so both the stdio/WebSocket bridges and the
+ * {@link SwappableBridge} wrapper satisfy it — consumers hold one stable
+ * reference whose behavior follows the active worker.
+ */
+export type { PythonBridge } from "./python-bridge-types.js";
 export { BRIDGE_PROTOCOL_VERSION, MIN_NODETOOL_CORE_VERSION } from "@nodetool-ai/protocol/bridge-protocol";
+export { encodeRawRgbaToPng, encodeRawImageRef, extractImageRegion, rasterizeSvg } from "./image-codec.js";
+export type { ImageRegion } from "./image-codec.js";
 export { PythonNodeExecutor } from "./python-node-executor.js";
-export { type NodeExecutor, type StreamingInputs, type StreamingOutputs } from "./node-executor.js";
-export { executeComfy } from "./comfy-executor.js";
-export type { ComfyExecutorResult, ComfyImage, ComfyProgressEvent, ComfyExecutionHandle } from "./comfy-executor.js";
+export { connectPythonBridgeForGraph, resolvePythonNodeExecutor } from "./python-graph-resolver.js";
+export { loadMediaRefBytes, type MediaRefValue } from "./media-ref-bytes.js";
+export { fetchExternalMedia, privateMediaFetchAllowed } from "./external-media-fetch.js";
+export { assetRefToPromptToken, classifyAssetToken, classifyTextToken, expandAssetReferences, expandEntityRefs, expandEntitiesForGeneration, findAssetRefs, findImageAssetRefs, findTextAssetRefs, inlineTextAssetRefs, stripAssetRefs, mapPromptAssetsToInputs, type AssetMediaKind, type PromptAssetRef, type TextAssetRef, type PromptAssetTextField, type PromptAssetInputField, type InjectedAssetRef, type EntityRefResolver, type ExpandedEntityPrompt } from "./prompt-asset-refs.js";
+export { logPythonWorkerStderr } from "./python-worker-stderr.js";
+export { type NodeExecutor, type StreamingInputs, type StreamingOutputs, type MessageEnvelopeLike, type TriggerEvent } from "./node-executor.js";
+export { createFakeContext, stubGlobalFetch, type FakeContextHandle, type FakeContextOptions } from "./testing.js";
+export { executeComfy, uploadComfyFile } from "./comfy-executor.js";
+export { executeBlender, BlenderExecutorError } from "./blender-executor.js";
+export type { BlenderWorkerJob, BlenderExecutorOptions, BlenderExecutorStats, BlenderExecutorResult } from "./blender-executor.js";
+export type { ComfyExecutorResult, ComfyImage, ComfyFileOutput, ComfyNodeOutputs, ComfyProgressEvent, ComfyExecutionHandle } from "./comfy-executor.js";
+export { runHostBinary, HostBinaryMissingError, MAX_CAPTURED_BYTES, MAX_ARTIFACT_BYTES, maxConcurrentHostBinaries, mimeFromFilename, clampTimeoutSeconds, type HostBinaryResult, type RunHostBinaryOptions } from "./host-binaries.js";
 export { RECOMMENDED_MODELS } from "./recommended-models.js";
 export type { RecommendedUnifiedModel } from "./recommended-models.js";
+export { clearProviderCache, getProviderCacheVersion } from "./provider-cache.js";
+export { registerCostReconciler, getCostReconciler } from "./cost-reconciler.js";
+export type { CostReconciler, CostReconcileInput, ReconciledCost } from "./cost-reconciler.js";
+export * from "./google/index.js";
+export { PERMISSION_GATE_CONTEXT_KEY, decidePermission, headlessDenialReason, headlessGate } from "./permission-gate.js";
+export type { ApprovalDecision, ApprovalRequest, PermissionCategory, PermissionDecision, PermissionGateAction, PermissionGateClock, PermissionGateOptions, PermissionGateVerdict, PermissionMode, RequestApproval } from "./permission-gate.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,SAAS,EACT,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,19 +1,58 @@
 /**
  * @nodetool-ai/runtime – Public API
  */
-export { ProcessingContext, MemoryCache, InMemoryStorageAdapter, FileStorageAdapter, S3StorageAdapter, resolveWorkspacePath } from "./context.js";
+export { ProcessingContext, ACTIVE_MODEL_CONTEXT_KEY, MemoryCache, resolveWorkspacePath, setDefaultModelInterfaces, getDefaultModelInterfaces, mediaResolverFor, GenerationAlreadyAcceptedError } from "./context.js";
+// The run's workspace, as an interface over any storage backend. Importing
+// `storage-workspace.js` here also installs the factory ProcessingContext uses
+// to build a workspace from a plain `workspaceDir`.
+export { WorkspacePathError, WorkspaceNotLocalError, observeWorkspace } from "./workspace.js";
+export { StorageWorkspace, createWorkspace, createLocalWorkspace } from "./storage-workspace.js";
+export { PrefixedStorageAdapter } from "./prefixed-storage-adapter.js";
+export { getProcessSandboxModuleCatalog, refuseSandboxDelivery, setProcessSandboxModuleCatalog } from "./sandbox-module-catalog.js";
+export { AgentMemory, memoryKeys } from "./agent-memory.js";
 export * from "./providers/index.js";
-export { initTelemetry, getTracer } from "./telemetry.js";
+export { initTelemetry, shutdownTelemetry, getTracer } from "./telemetry.js";
 export { spanToRecord, JsonlFileSpanExporter, StdoutSpanExporter } from "./trace-exporters.js";
-export { withAgentSpan, withAgentSpanGen, withWorkflowSpan, withNodeSpan, withSpanGen, setLastUsage, consumeLastUsage, peekLastUsage, createUsageSlot } from "./tracing-helpers.js";
+export { withAgentSpan, withAgentSpanGen, withSpan, withWorkflowSpan, withNodeSpan, withSpanGen, setLastUsage, consumeLastUsage, peekLastUsage, createUsageSlot } from "./tracing-helpers.js";
+export { RecoverableNodeError, isRecoverableNodeError } from "./recoverable-node-error.js";
+export { createInvocationAccount, inInvocationAccount, recordInvocationCost, recordInvocationAsset, currentInvocationAccount } from "./invocation-account.js";
+export { recordGenerationReceipt, recordGenerationProviderResult, recordGenerationReceiptAsync, recordGenerationBindingAsync, runWithGenerationReceipt, currentGenerationReceipt, currentGenerationProviderRequestOptions, isAuthoritativeProviderTerminalError, GenerationScopeError } from "./generation-receipt.js";
+export { HIGGSFIELD_BASE, HiggsfieldApiError, higgsfieldSubmit, higgsfieldGetStatus, higgsfieldGetStatusByRequestId, higgsfieldAwaitResult, higgsfieldCancel, higgsfieldCancelByRequestId, higgsfieldEstimate, higgsfieldCreateUploadUrl, higgsfieldUploadMedia, higgsfieldOutputUrls, higgsfieldDownloadResult } from "./providers/higgsfield-transport.js";
+export { generationRegistry } from "./generation-registry.js";
+export { redactGenerationParams } from "./redact-params.js";
+export { CostCappedTurnBudget, CompositeTurnBudget, createRunBudget, createDeadline, createSemaphore, createCounter, isRunBudget, budgetFromContext, RUN_BUDGET_CONTEXT_KEY, BUDGET_EXHAUSTION_KINDS, TURN_REFUSALS } from "./turn-budget.js";
 export { packContext } from "./context-packer.js";
+export { resolveEntities } from "./entities.js";
+// Public API re-export — the source of truth lives in @nodetool-ai/protocol
+export { isZodSchema, parseWithTypeCoercion, zodToJsonSchema } from "@nodetool-ai/protocol/zod-schema";
+export { VariableChannel } from "./variable-channel.js";
+export { countTokens, truncateToTokens } from "./token-counter.js";
 export { PythonStdioBridge } from "./python-stdio-bridge.js";
+import { PythonBridgeBase } from "./python-bridge-base.js";
+export { PythonBridgeBase };
+export { WebsocketPythonBridge } from "./python-websocket-bridge.js";
+export { createPythonBridge, onPythonBridgeCreated } from "./python-bridge-factory.js";
+export { encodeFrame, FrameDecoder, FrameSizeError, DEFAULT_MAX_BRIDGE_FRAME_SIZE } from "./python-bridge-framing.js";
+export { SwappableBridge } from "./swappable-python-bridge.js";
 // Public API re-export — the source of truth lives in @nodetool-ai/protocol
 // so the Electron main bundle (which can't pull in the runtime barrel) and
 // any other thin consumer can read these constants without dragging the
 // providers in. Internal callers should import from protocol directly.
 export { BRIDGE_PROTOCOL_VERSION, MIN_NODETOOL_CORE_VERSION } from "@nodetool-ai/protocol/bridge-protocol";
+export { encodeRawRgbaToPng, encodeRawImageRef, extractImageRegion, rasterizeSvg } from "./image-codec.js";
 export { PythonNodeExecutor } from "./python-node-executor.js";
-export { executeComfy } from "./comfy-executor.js";
+export { connectPythonBridgeForGraph, resolvePythonNodeExecutor } from "./python-graph-resolver.js";
+export { loadMediaRefBytes } from "./media-ref-bytes.js";
+export { fetchExternalMedia, privateMediaFetchAllowed } from "./external-media-fetch.js";
+export { assetRefToPromptToken, classifyAssetToken, classifyTextToken, expandAssetReferences, expandEntityRefs, expandEntitiesForGeneration, findAssetRefs, findImageAssetRefs, findTextAssetRefs, inlineTextAssetRefs, stripAssetRefs, mapPromptAssetsToInputs } from "./prompt-asset-refs.js";
+export { logPythonWorkerStderr } from "./python-worker-stderr.js";
+export { createFakeContext, stubGlobalFetch } from "./testing.js";
+export { executeComfy, uploadComfyFile } from "./comfy-executor.js";
+export { executeBlender, BlenderExecutorError } from "./blender-executor.js";
+export { runHostBinary, HostBinaryMissingError, MAX_CAPTURED_BYTES, MAX_ARTIFACT_BYTES, maxConcurrentHostBinaries, mimeFromFilename, clampTimeoutSeconds } from "./host-binaries.js";
 export { RECOMMENDED_MODELS } from "./recommended-models.js";
+export { clearProviderCache, getProviderCacheVersion } from "./provider-cache.js";
+export { registerCostReconciler, getCostReconciler } from "./cost-reconciler.js";
+export * from "./google/index.js";
+export { PERMISSION_GATE_CONTEXT_KEY, decidePermission, headlessDenialReason, headlessGate } from "./permission-gate.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,cAAc,CAAC;AAEtB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,SAAS,EAEV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EAGhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EACL,iBAAiB,EAOlB,MAAM,0BAA0B,CAAC;AAClC,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,uEAAuE;AACvE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EAExB,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAWhB,8BAA8B,EAM/B,MAAM,cAAc,CAAC;AAEtB,2EAA2E;AAC3E,+EAA+E;AAC/E,oDAAoD;AACpD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAKjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,8BAA8B,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,WAAW,EACX,UAAU,EAKX,MAAM,mBAAmB,CAAC;AAE3B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EAEV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EAGhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,uCAAuC,EACvC,oCAAoC,EACpC,oBAAoB,EAGrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,qBAAqB,EACrB,gBAAgB,EAChB,2BAA2B,EAC3B,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,qCAAqC,CAAC;AAQ7C,OAAO,EACL,kBAAkB,EAGnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EAgBd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,eAAe,EAA6B,MAAM,eAAe,CAAC;AAC3E,4EAA4E;AAC5E,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,eAAe,EAGhB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,iBAAiB,EAOlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAuB5B,OAAO,EACL,qBAAqB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,6BAA6B,EAE9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQ/D,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,uEAAuE;AACvE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAsB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EASxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAQlE,OAAO,EACL,iBAAiB,EACjB,eAAe,EAGhB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAe7E,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAM9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACb,MAAM,sBAAsB,CAAC"}

package/dist/invocation-account.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Invocation-scoped cost and asset accounting.
+ *
+ * The supervisor may only offer `retry` for an invocation that spent nothing
+ * and wrote nothing (docs/workflow-supervisor-design.md §5.3). Answering that
+ * needs per-invocation numbers, and a stack on the shared `ProcessingContext`
+ * cannot supply them: every actor holds the same context and actors complete
+ * out of order, so push/pop would credit actor A's charge to actor B whenever
+ * A finishes first — precisely the corruption that would re-expose retry after
+ * a billed call.
+ *
+ * So the scope travels with the invocation's async execution instead. Cost and
+ * asset hooks write to whichever account is on the async stack; concurrent
+ * invocations each have their own, in any completion order.
+ */
+export interface InvocationAccount {
+    /** Provider charges (USD) recorded while this invocation ran. */
+    costUsd: number;
+    /** True once the invocation created an asset. */
+    createdAssets: boolean;
+}
+export declare function createInvocationAccount(): InvocationAccount;
+/**
+ * Run `fn` inside `account`. The caller owns the account so it can read what
+ * the invocation spent even when `fn` throws — which is the case retry safety
+ * turns on.
+ */
+export declare function inInvocationAccount<T>(account: InvocationAccount, fn: () => Promise<T>): Promise<T>;
+/**
+ * Charge the invocation currently on the async stack, if any.
+ *
+ * A non-finite amount means a provider reported something we cannot add up —
+ * and "cannot add up" must not read as "free", or the invocation would look
+ * cost-free and re-earn a retry after a real charge. It is recorded as a
+ * nominal charge instead: the number is meaningless, the fact of spending is
+ * not. `costUsd` stays finite so the escalation record remains JSON-safe.
+ */
+export declare function recordInvocationCost(usd: number | undefined | null): void;
+/** Mark the invocation currently on the async stack as having written an asset. */
+export declare function recordInvocationAsset(): void;
+/** The account for the invocation currently on the async stack, if any. */
+export declare function currentInvocationAccount(): InvocationAccount | undefined;
+//# sourceMappingURL=invocation-account.d.ts.map

package/dist/invocation-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-account.d.ts","sourceRoot":"","sources":["../src/invocation-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAKzE;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI,iBAAiB,GAAG,SAAS,CAExE"}

package/dist/invocation-account.js

@@ -0,0 +1,60 @@
+/**
+ * Invocation-scoped cost and asset accounting.
+ *
+ * The supervisor may only offer `retry` for an invocation that spent nothing
+ * and wrote nothing (docs/workflow-supervisor-design.md §5.3). Answering that
+ * needs per-invocation numbers, and a stack on the shared `ProcessingContext`
+ * cannot supply them: every actor holds the same context and actors complete
+ * out of order, so push/pop would credit actor A's charge to actor B whenever
+ * A finishes first — precisely the corruption that would re-expose retry after
+ * a billed call.
+ *
+ * So the scope travels with the invocation's async execution instead. Cost and
+ * asset hooks write to whichever account is on the async stack; concurrent
+ * invocations each have their own, in any completion order.
+ */
+// Lazily resolved so this module still loads in browser/Edge bundles. There the
+// fallback holder has no per-context isolation, and concurrent invocations
+// would share one account — acceptable only because the supervisor that reads
+// these numbers runs in the kernel, which is Node-only.
+import { AsyncLocalStorage } from "./async-local-storage.js";
+const store = new AsyncLocalStorage();
+export function createInvocationAccount() {
+    return { costUsd: 0, createdAssets: false };
+}
+/**
+ * Run `fn` inside `account`. The caller owns the account so it can read what
+ * the invocation spent even when `fn` throws — which is the case retry safety
+ * turns on.
+ */
+export function inInvocationAccount(account, fn) {
+    return store.run(account, fn);
+}
+/**
+ * Charge the invocation currently on the async stack, if any.
+ *
+ * A non-finite amount means a provider reported something we cannot add up —
+ * and "cannot add up" must not read as "free", or the invocation would look
+ * cost-free and re-earn a retry after a real charge. It is recorded as a
+ * nominal charge instead: the number is meaningless, the fact of spending is
+ * not. `costUsd` stays finite so the escalation record remains JSON-safe.
+ */
+export function recordInvocationCost(usd) {
+    if (usd === undefined || usd === null)
+        return;
+    const account = store.getStore();
+    if (!account)
+        return;
+    account.costUsd += Number.isFinite(usd) ? usd : Number.MIN_VALUE;
+}
+/** Mark the invocation currently on the async stack as having written an asset. */
+export function recordInvocationAsset() {
+    const account = store.getStore();
+    if (account)
+        account.createdAssets = true;
+}
+/** The account for the invocation currently on the async stack, if any. */
+export function currentInvocationAccount() {
+    return store.getStore();
+}
+//# sourceMappingURL=invocation-account.js.map

package/dist/invocation-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-account.js","sourceRoot":"","sources":["../src/invocation-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,wDAAwD;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAS7D,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAEzD,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA0B,EAC1B,EAAoB;IAEpB,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAA8B;IACjE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,OAAO;QAAE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;AAC5C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/media-ref-bytes.d.ts

@@ -0,0 +1,19 @@
+import type { ProcessingContext } from "./context.js";
+/** Encode bytes → base64 without requiring the `Buffer` global. */
+export declare function encodeBase64(bytes: Uint8Array): string;
+/** Minimal media ref shape for byte resolution (Python bridge + TS nodes). */
+export type MediaRefValue = {
+    uri?: string;
+    type?: string;
+    asset_id?: string | null;
+    data?: unknown;
+    width?: number;
+    height?: number;
+};
+export declare function isAbsoluteFilePath(uri: string): boolean;
+/**
+ * Resolve bytes for an image/audio/video/model ref.
+ * Shared by the Python bridge and TS nodes (e.g. Save Image).
+ */
+export declare function loadMediaRefBytes(value: MediaRefValue, context?: ProcessingContext): Promise<Uint8Array | null>;
+//# sourceMappingURL=media-ref-bytes.d.ts.map

package/dist/media-ref-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-ref-bytes.d.ts","sourceRoot":"","sources":["../src/media-ref-bytes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAoCtD,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAUtD;AAUD,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AASF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIvD;AAgDD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoF5B"}