@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/dist/{lower-_-iT4HYs.d.ts → lower-CpsMFOFX.d.ts}

@@ -1,6 +1,6 @@
 import { S as SourceFile } from './hash-CZkTXPCX.js';
-import { b as WorkflowDefinition, W as WorkflowInterface } from './types-BGoPzgcl.js';
-import { C as ConnectionResolver } from './assemble-DWgaXHd-.js';
+import { W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-V7jEEUaL.js';
+import { d as ConnectionResolver, a as CollectedDurableWorkflow } from './collect-6NIEufHd.js';
 import { E as EsbuildApi, L as LowerError } from './lower-types-DQNBfWQn.js';
 
 /** One vendored package: its version and its files (paths relative to the package root). */
@@ -20,6 +20,12 @@ interface BuildBundleOptions {
     maxSourceBytes?: number;
     /** Largest bundle, in UTF-8 bytes. Default 1.5 MiB (4 MiB with vendored deps). */
     maxBundleBytes?: number;
+    /**
+     * `external` also returns a source map of the bundle (C-SOURCEMAP) in
+     * `map`. The bundle bytes, and so `buildId`, are the same as without it:
+     * no `sourceMappingURL` comment is added.
+     */
+    sourcemap?: 'external';
 }
 interface BuiltBundle {
     /** The ES module. */
@@ -33,6 +39,18 @@ interface BuiltBundle {
      */
     sourceHash: string;
     entries: string[];
+    /**
+     * The project modules (`workflows/order.ts`) and vendored files
+     * (`node_modules/<package>/<path>`) the bundle contains, sorted.
+     */
+    modules: string[];
+    /**
+     * With `sourcemap: 'external'`: the source map (version 3 JSON) of the
+     * bundle. Sources are named like build messages (`workflows/order.ts`,
+     * `node_modules/<package>/<path>`, `@fluidgrids/workflows`); the map holds
+     * no source contents, which the source archive already has.
+     */
+    map?: string;
 }
 /** Node built-in module names (without the `node:` prefix). */
 declare const NODE_BUILTINS: ReadonlySet<string>;
@@ -87,7 +105,7 @@ interface LowerOptions {
 }
 /** A problem `lower()` found in tier-2 sources without running them. */
 interface LowerIssue {
-    code: 'durable.phaseC' | 'durable.activityTypeNotAllowed';
+    code: 'durable.phaseC' | 'durable.activityTypeNotAllowed' | 'durable.localActivityTimeout' | 'durable.activityImplInBundle';
     message: string;
     module: string;
 }
@@ -108,22 +126,52 @@ interface LowerResult {
     durableExports: Record<string, {
         interface: WorkflowInterface;
         taskQueue: string;
+        config?: WorkflowConfig;
     }>;
     /** Findings in tier-2 sources (Phase C features, refused activity node types). */
     issues: LowerIssue[];
+    /**
+     * Runtime features the bundle uses (C-FEATURES), sorted; written as
+     * `code.features` when not empty. The service refuses a feature its
+     * workspace flags do not enable.
+     */
+    features: string[];
 }
 /**
  * Bundle a project. Exported so services can compute `buildId` without
  * evaluating; `buildBundle()` is the full form (vendored packages, limits).
  */
 declare function bundleProject(files: ReadonlyMap<string, string>, entries: readonly string[], esbuild: EsbuildApi): Promise<string>;
+/** The `code.exports.workflows` key of a dynamic workflow (11 §2.29). */
+declare const DYNAMIC_EXPORT = "*";
+/**
+ * Find user local activities (not run yet), refused activity node types and
+ * local-activity timeouts over the cap in the modules a tier-2 workflow may
+ * run (see {@link durableScanModules}), without running them. The runtime and
+ * the service refuse them as well; this reports them before a push. The
+ * Phase C features (queries, updates, user activities, search attributes,
+ * dynamic workflows, interceptors and sinks) are no longer findings: they are
+ * written to `code.features` and gated by the service (C-FEATURES).
+ *
+ * With `bundled` (the modules `buildBundle` put into the bundle), a
+ * user-activity implementation in one of them is reported as
+ * `durable.activityImplInBundle`: it belongs on a worker (CWD9).
+ */
+declare function scanDurableSources(files: ReadonlyMap<string, string>, modules: Iterable<string>, bundled?: readonly string[]): LowerIssue[];
+/**
+ * The modules a tier-2 workflow may run code from: every source module of a
+ * project that declares one (the declaring modules and every helper they may
+ * import), sorted. A project without tier-2 workflows has none.
+ */
+declare function durableScanModules(files: ReadonlyMap<string, string>, durable: readonly Pick<CollectedDurableWorkflow, 'module'>[]): string[];
 /**
- * Find Phase C features and refused activity node types in the modules that
- * declare tier-2 functions, without running them. The runtime and the service
- * refuse both as well; this reports them before a push.
+ * The runtime features (C-FEATURES) of a bundle: what the call sites of every
+ * module a tier-2 workflow may run show (project helpers and vendored
+ * packages included), and what its declarations' options use, sorted and
+ * without duplicates.
  */
-declare function scanDurableSources(files: ReadonlyMap<string, string>, modules: Iterable<string>): LowerIssue[];
+declare function durableFeatures(files: ReadonlyMap<string, string>, durable: readonly CollectedDurableWorkflow[], deps?: VendoredDeps): string[];
 /** Lower TypeScript sources (tier 1 and tier 2) to IR v2. */
 declare function lower(files: readonly SourceFile[] | Readonly<Record<string, string>>, options?: LowerOptions): Promise<LowerResult>;
 
-export { type BuildBundleOptions as B, DeterminismViolationError as D, type Evaluator as E, type LowerIssue as L, NODE_BUILTINS as N, type VendoredDeps as V, type VendoredPackage as a, type BuiltBundle as b, ESBUILD_VERSION as c, EVALUATION_GLOBAL as d, type LowerOptions as e, type LowerResult as f, type LoweredWorkflow as g, buildBundle as h, bundleProject as i, bundleSourceHash as j, defaultEntries as k, lower as l, splitSpecifier as m, resolvePackageEntry as r, scanDurableSources as s };
+export { type BuildBundleOptions as B, DYNAMIC_EXPORT as D, type Evaluator as E, type LowerIssue as L, NODE_BUILTINS as N, type VendoredDeps as V, type VendoredPackage as a, type BuiltBundle as b, DeterminismViolationError as c, ESBUILD_VERSION as d, EVALUATION_GLOBAL as e, type LowerOptions as f, type LowerResult as g, type LoweredWorkflow as h, buildBundle as i, bundleProject as j, bundleSourceHash as k, defaultEntries as l, durableFeatures as m, durableScanModules as n, lower as o, splitSpecifier as p, resolvePackageEntry as r, scanDurableSources as s };

package/dist/{manifest-C8N6HDYl.d.ts → manifest-D-I_twys.d.ts}

@@ -1,4 +1,4 @@
-import { J as JsonObject } from './types-BGoPzgcl.js';
+import { J as JsonObject } from './types-V7jEEUaL.js';
 
 /** One input or output field. Output fields may also be a bare type name. */
 interface ManifestField {

package/dist/{manifest-0OLw0i7k.d.cts → manifest-DahBQVM8.d.cts}

@@ -1,4 +1,4 @@
-import { J as JsonObject } from './types-BGoPzgcl.cjs';
+import { J as JsonObject } from './types-V7jEEUaL.cjs';
 
 /** One input or output field. Output fields may also be a bare type name. */
 interface ManifestField {

package/dist/node-evaluator-DGQDPSPI.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var chunkTCTE7DX5_cjs = require('./chunk-TCTE7DX5.cjs');
+require('./chunk-ODZ2IAR2.cjs');
+require('./chunk-3U2NU7YC.cjs');
+require('./chunk-IQPXHQQQ.cjs');
+require('./chunk-54FLQNUM.cjs');
+require('./chunk-G4UEPUGO.cjs');
+require('./chunk-GVTZMA5C.cjs');
+require('./chunk-QKZL3ONM.cjs');
+require('./chunk-TBDXTV22.cjs');
+require('./chunk-SAENRNBJ.cjs');
+require('./chunk-VA4OFR72.cjs');
+require('./chunk-FR7KYWRO.cjs');
+require('./chunk-A5SXCA62.cjs');
+require('./chunk-TYF56RGB.cjs');
+require('./chunk-Z2Y65YOY.cjs');
+
+
+
+Object.defineProperty(exports, "createNodeVmEvaluator", {
+  enumerable: true,
+  get: function () { return chunkTCTE7DX5_cjs.createNodeVmEvaluator; }
+});

package/dist/node-evaluator-LEEVD7H7.js

@@ -0,0 +1,14 @@
+export { createNodeVmEvaluator } from './chunk-HCM7ZC7Q.js';
+import './chunk-5MFVJM76.js';
+import './chunk-6OLN6BMB.js';
+import './chunk-SR7TR5KX.js';
+import './chunk-NWQ5WRLE.js';
+import './chunk-5LUIDMF4.js';
+import './chunk-JZ4TOOLN.js';
+import './chunk-E2VK7J2C.js';
+import './chunk-7AAZGVKD.js';
+import './chunk-PMCM2OH4.js';
+import './chunk-C4F5KJTI.js';
+import './chunk-LNUQE6D6.js';
+import './chunk-AC6ZEXVR.js';
+import './chunk-5HIVIV53.js';

package/dist/payload-fields-BVRQn2yH.d.cts

@@ -0,0 +1,122 @@
+import { a as Json } from './types-V7jEEUaL.cjs';
+import { s as CommandType, ac as RunEventType } from './types-Bv2i4cBX.cjs';
+
+/**
+ * Payload fields and the encoded payload form (C-CMD-C, PLAN-C §3.2, 11 §2.9,
+ * §2.30). Pure data, no I/O: it runs inside the isolate as well.
+ *
+ * `PAYLOAD_FIELDS` names, per event type and per command type, the JSON
+ * pointers (relative to the event payload or the command) whose values are
+ * user payloads: activity args and results, workflow input and output, signal
+ * and update payloads, the memo and side-effect values. Two mechanisms use
+ * exactly these pointers and nothing else (CWD14):
+ *
+ * - a self-hosted worker's payload codec encodes them before anything
+ *   crosses the bridge, and decodes them on the way back;
+ * - the service's at-rest KMS envelope (`kms/envelope`) encrypts them in
+ *   stored events.
+ *
+ * Failures nest through `cause` (11 §2.30), so they are not listed as plain
+ * pointers: `FAILURE_FIELDS` and `COMMAND_FAILURE_FIELDS` point at failure
+ * objects, and the user payload of a failure is its `details` at every level
+ * of the `cause` chain. {@link mapEventPayloads} and
+ * {@link mapCommandPayloads} apply both lists and are what codecs and the
+ * envelope should call.
+ *
+ * Identifiers (ids, names, node types, task queues), failures other than
+ * their `details`, and search attributes stay in clear text, so the service can
+ * still match, index and query them. The lists are published as
+ * `schema/payload-fields.json` for the Python SDK.
+ */
+
+/** The key that marks an encoded payload (`{"$fgp":1, encoding, metadata, data}`). */
+declare const ENCODED_PAYLOAD_MARKER = "$fgp";
+/** The version of the encoded payload form. */
+declare const ENCODED_PAYLOAD_VERSION = 1;
+/**
+ * Payload encodings (11 §2.30). `json/plain` values are never wrapped; every
+ * other encoding is carried as an {@link EncodedPayload}. A worker's payload
+ * converter may name its own encoding (for example `binary/protobuf`); the
+ * engine treats any encoding other than `json/plain` as opaque.
+ */
+declare const PAYLOAD_ENCODINGS: readonly ["json/plain", "binary/plain", "binary/encrypted", "kms/envelope"];
+type KnownPayloadEncoding = (typeof PAYLOAD_ENCODINGS)[number];
+/**
+ * A payload that is not plain JSON: bytes in base64 with their encoding and
+ * string metadata (content type, key id, codec name). The engine, the canvas
+ * and workflow code treat it as an opaque JSON value; only the codec that wrote
+ * it (a worker's codec or the codec server, or the service for `kms/envelope`)
+ * reads `data`.
+ */
+interface EncodedPayload {
+    $fgp: 1;
+    encoding: string;
+    metadata?: Record<string, string>;
+    /** Base64 (RFC 4648, with padding). */
+    data: string;
+}
+/** True when `value` is an {@link EncodedPayload}: exactly its keys, each well formed. */
+declare function isEncodedPayload(value: unknown): value is EncodedPayload;
+/** The encoding of a payload value: its own for an encoded payload, else `json/plain`. */
+declare function payloadEncodingOf(value: Json | undefined): string;
+/**
+ * Plain payload pointers per event type (relative to the event payload).
+ * Types not listed carry none. Failures are in {@link FAILURE_FIELDS}.
+ */
+declare const PAYLOAD_FIELDS: Readonly<Partial<Record<RunEventType, readonly string[]>>>;
+/**
+ * Failure pointers per event type (relative to the event payload): every
+ * property of the run-event schema that holds a failure. The payload of a
+ * failure is its `details`, and the `details` of each `cause` below it.
+ */
+declare const FAILURE_FIELDS: Readonly<Partial<Record<RunEventType, readonly string[]>>>;
+/** Plain payload pointers per command type (relative to the command). Types not listed carry none. */
+declare const COMMAND_PAYLOAD_FIELDS: Readonly<Partial<Record<CommandType, readonly string[]>>>;
+/** Failure pointers per command type (relative to the command); see {@link FAILURE_FIELDS}. */
+declare const COMMAND_FAILURE_FIELDS: Readonly<Partial<Record<CommandType, readonly string[]>>>;
+/** The payload pointers of a failure object (relative to it), at every level of its cause chain. */
+declare const FAILURE_PAYLOAD_FIELDS: readonly string[];
+/** The pointer of a failure's cause (relative to the failure); the rule applies to it again. */
+declare const FAILURE_CAUSE_FIELD = "/cause";
+/** The format tag of `schema/payload-fields.json`. */
+declare const PAYLOAD_FIELDS_FORMAT = "fluidgrids.payload-fields";
+/** `schema/payload-fields.json`: the pointers and the encoded form, for other SDKs. */
+declare const PAYLOAD_FIELDS_DOCUMENT: {
+    readonly format: "fluidgrids.payload-fields";
+    readonly formatVersion: 2;
+    readonly description: "JSON pointers of user payloads per event type (relative to the payload) and per command type (relative to the command). `events` and `commands` are plain payload pointers. `eventFailures` and `commandFailures` point at failure objects: the payloads of a failure are the `failure.payloads` pointers relative to it, and the same rule applies again to the failure at `failure.cause` (recursively, to the end of the cause chain). Payload codecs and the at-rest envelope apply to these pointers only; everything else stays in clear text. A value that is not plain JSON is carried as {\"$fgp\": 1, \"encoding\", \"metadata\"?, \"data\" (base64)}.";
+    readonly encodedMarker: "$fgp";
+    readonly encodedVersion: 1;
+    readonly encodings: readonly ["json/plain", "binary/plain", "binary/encrypted", "kms/envelope"];
+    readonly events: Readonly<Partial<Record<"WORKFLOW_STARTED" | "WORKFLOW_TASK_SCHEDULED" | "WORKFLOW_TASK_STARTED" | "WORKFLOW_TASK_COMPLETED" | "WORKFLOW_TASK_FAILED" | "WORKFLOW_TASK_TIMED_OUT" | "ACTIVITY_SCHEDULED" | "ACTIVITY_STARTED" | "ACTIVITY_HEARTBEAT" | "ACTIVITY_COMPLETED" | "ACTIVITY_FAILED" | "ACTIVITY_TIMED_OUT" | "ACTIVITY_CANCEL_REQUESTED" | "ACTIVITY_CANCELLED" | "ACTIVITY_PAUSED" | "ACTIVITY_UNPAUSED" | "ACTIVITY_RESET" | "ACTIVITY_OPTIONS_UPDATED" | "TIMER_STARTED" | "TIMER_FIRED" | "TIMER_CANCELLED" | "SIGNAL_RECEIVED" | "UPDATE_ADMITTED" | "UPDATE_ACCEPTED" | "UPDATE_COMPLETED" | "CHILD_RUN_INITIATED" | "CHILD_RUN_STARTED" | "CHILD_RUN_COMPLETED" | "CHILD_RUN_FAILED" | "CHILD_RUN_CANCELLED" | "CHILD_RUN_TERMINATED" | "CHILD_RUN_TIMED_OUT" | "EXTERNAL_RUN_CANCEL_REQUESTED" | "EXTERNAL_RUN_CANCEL_RESOLVED" | "EXTERNAL_RUN_SIGNALED" | "SIDE_EFFECT_RECORDED" | "LOCAL_ACTIVITY_COMPLETED" | "LOCAL_ACTIVITY_FAILED" | "SEARCH_ATTRIBUTES_UPSERTED" | "CONTEXT_UPSERTED" | "MARKER_RECORDED" | "WORKFLOW_CANCEL_REQUESTED" | "WORKFLOW_RESET" | "VERSIONING_OVERRIDE_SET" | "WORKFLOW_COMPLETED" | "WORKFLOW_FAILED" | "WORKFLOW_CANCELLED" | "WORKFLOW_TERMINATED" | "WORKFLOW_TIMED_OUT" | "WORKFLOW_CONTINUED_AS_NEW", readonly string[]>>>;
+    readonly commands: Readonly<Partial<Record<"SCHEDULE_ACTIVITY" | "REQUEST_CANCEL_ACTIVITY" | "START_TIMER" | "CANCEL_TIMER" | "START_CHILD_RUN" | "SIGNAL_RUN" | "RECORD_SIDE_EFFECT" | "RECORD_MARKER" | "COMPLETE_WORKFLOW" | "FAIL_WORKFLOW" | "CANCEL_WORKFLOW" | "UPSERT_CONTEXT" | "RECORD_LOCAL_ACTIVITY" | "CONTINUE_AS_NEW" | "REQUEST_CANCEL_EXTERNAL_RUN" | "UPSERT_SEARCH_ATTRIBUTES" | "ACCEPT_UPDATE" | "REJECT_UPDATE" | "COMPLETE_UPDATE", readonly string[]>>>;
+    readonly eventFailures: Readonly<Partial<Record<"WORKFLOW_STARTED" | "WORKFLOW_TASK_SCHEDULED" | "WORKFLOW_TASK_STARTED" | "WORKFLOW_TASK_COMPLETED" | "WORKFLOW_TASK_FAILED" | "WORKFLOW_TASK_TIMED_OUT" | "ACTIVITY_SCHEDULED" | "ACTIVITY_STARTED" | "ACTIVITY_HEARTBEAT" | "ACTIVITY_COMPLETED" | "ACTIVITY_FAILED" | "ACTIVITY_TIMED_OUT" | "ACTIVITY_CANCEL_REQUESTED" | "ACTIVITY_CANCELLED" | "ACTIVITY_PAUSED" | "ACTIVITY_UNPAUSED" | "ACTIVITY_RESET" | "ACTIVITY_OPTIONS_UPDATED" | "TIMER_STARTED" | "TIMER_FIRED" | "TIMER_CANCELLED" | "SIGNAL_RECEIVED" | "UPDATE_ADMITTED" | "UPDATE_ACCEPTED" | "UPDATE_COMPLETED" | "CHILD_RUN_INITIATED" | "CHILD_RUN_STARTED" | "CHILD_RUN_COMPLETED" | "CHILD_RUN_FAILED" | "CHILD_RUN_CANCELLED" | "CHILD_RUN_TERMINATED" | "CHILD_RUN_TIMED_OUT" | "EXTERNAL_RUN_CANCEL_REQUESTED" | "EXTERNAL_RUN_CANCEL_RESOLVED" | "EXTERNAL_RUN_SIGNALED" | "SIDE_EFFECT_RECORDED" | "LOCAL_ACTIVITY_COMPLETED" | "LOCAL_ACTIVITY_FAILED" | "SEARCH_ATTRIBUTES_UPSERTED" | "CONTEXT_UPSERTED" | "MARKER_RECORDED" | "WORKFLOW_CANCEL_REQUESTED" | "WORKFLOW_RESET" | "VERSIONING_OVERRIDE_SET" | "WORKFLOW_COMPLETED" | "WORKFLOW_FAILED" | "WORKFLOW_CANCELLED" | "WORKFLOW_TERMINATED" | "WORKFLOW_TIMED_OUT" | "WORKFLOW_CONTINUED_AS_NEW", readonly string[]>>>;
+    readonly commandFailures: Readonly<Partial<Record<"SCHEDULE_ACTIVITY" | "REQUEST_CANCEL_ACTIVITY" | "START_TIMER" | "CANCEL_TIMER" | "START_CHILD_RUN" | "SIGNAL_RUN" | "RECORD_SIDE_EFFECT" | "RECORD_MARKER" | "COMPLETE_WORKFLOW" | "FAIL_WORKFLOW" | "CANCEL_WORKFLOW" | "UPSERT_CONTEXT" | "RECORD_LOCAL_ACTIVITY" | "CONTINUE_AS_NEW" | "REQUEST_CANCEL_EXTERNAL_RUN" | "UPSERT_SEARCH_ATTRIBUTES" | "ACCEPT_UPDATE" | "REJECT_UPDATE" | "COMPLETE_UPDATE", readonly string[]>>>;
+    readonly failure: {
+        readonly payloads: readonly string[];
+        readonly cause: "/cause";
+    };
+};
+/**
+ * Apply `fn` to the value at each payload pointer of `record` that is present,
+ * and to the payloads of each failure at `failures` (its `details` at every
+ * level of its `cause` chain), returning a copy (the input is not changed).
+ * `fn` receives the pointer of the value it is given.
+ */
+declare function mapPayloadFields<T extends Record<string, Json | undefined>>(record: T, pointers: readonly string[], fn: (value: Json, pointer: string) => Json, failures?: readonly string[]): T;
+/**
+ * Apply `fn` to every user payload of an event payload of type `type`: the
+ * {@link PAYLOAD_FIELDS} pointers and the failures of {@link FAILURE_FIELDS}.
+ * This is the call a payload codec or the at-rest envelope makes per event.
+ */
+declare function mapEventPayloads<T extends Record<string, Json | undefined>>(type: RunEventType, payload: T, fn: (value: Json, pointer: string) => Json): T;
+/**
+ * Apply `fn` to every user payload of a command: the
+ * {@link COMMAND_PAYLOAD_FIELDS} pointers and the failures of
+ * {@link COMMAND_FAILURE_FIELDS}.
+ */
+declare function mapCommandPayloads<T extends {
+    type: CommandType;
+}>(command: T, fn: (value: Json, pointer: string) => Json): T;
+
+export { COMMAND_FAILURE_FIELDS as C, ENCODED_PAYLOAD_MARKER as E, FAILURE_CAUSE_FIELD as F, type KnownPayloadEncoding as K, PAYLOAD_ENCODINGS as P, COMMAND_PAYLOAD_FIELDS as a, ENCODED_PAYLOAD_VERSION as b, type EncodedPayload as c, FAILURE_FIELDS as d, FAILURE_PAYLOAD_FIELDS as e, PAYLOAD_FIELDS as f, PAYLOAD_FIELDS_DOCUMENT as g, PAYLOAD_FIELDS_FORMAT as h, isEncodedPayload as i, mapEventPayloads as j, mapPayloadFields as k, mapCommandPayloads as m, payloadEncodingOf as p };

package/dist/payload-fields-oOBWxDiG.d.ts

@@ -0,0 +1,122 @@
+import { a as Json } from './types-V7jEEUaL.js';
+import { s as CommandType, ac as RunEventType } from './types-DGx-b9eq.js';
+
+/**
+ * Payload fields and the encoded payload form (C-CMD-C, PLAN-C §3.2, 11 §2.9,
+ * §2.30). Pure data, no I/O: it runs inside the isolate as well.
+ *
+ * `PAYLOAD_FIELDS` names, per event type and per command type, the JSON
+ * pointers (relative to the event payload or the command) whose values are
+ * user payloads: activity args and results, workflow input and output, signal
+ * and update payloads, the memo and side-effect values. Two mechanisms use
+ * exactly these pointers and nothing else (CWD14):
+ *
+ * - a self-hosted worker's payload codec encodes them before anything
+ *   crosses the bridge, and decodes them on the way back;
+ * - the service's at-rest KMS envelope (`kms/envelope`) encrypts them in
+ *   stored events.
+ *
+ * Failures nest through `cause` (11 §2.30), so they are not listed as plain
+ * pointers: `FAILURE_FIELDS` and `COMMAND_FAILURE_FIELDS` point at failure
+ * objects, and the user payload of a failure is its `details` at every level
+ * of the `cause` chain. {@link mapEventPayloads} and
+ * {@link mapCommandPayloads} apply both lists and are what codecs and the
+ * envelope should call.
+ *
+ * Identifiers (ids, names, node types, task queues), failures other than
+ * their `details`, and search attributes stay in clear text, so the service can
+ * still match, index and query them. The lists are published as
+ * `schema/payload-fields.json` for the Python SDK.
+ */
+
+/** The key that marks an encoded payload (`{"$fgp":1, encoding, metadata, data}`). */
+declare const ENCODED_PAYLOAD_MARKER = "$fgp";
+/** The version of the encoded payload form. */
+declare const ENCODED_PAYLOAD_VERSION = 1;
+/**
+ * Payload encodings (11 §2.30). `json/plain` values are never wrapped; every
+ * other encoding is carried as an {@link EncodedPayload}. A worker's payload
+ * converter may name its own encoding (for example `binary/protobuf`); the
+ * engine treats any encoding other than `json/plain` as opaque.
+ */
+declare const PAYLOAD_ENCODINGS: readonly ["json/plain", "binary/plain", "binary/encrypted", "kms/envelope"];
+type KnownPayloadEncoding = (typeof PAYLOAD_ENCODINGS)[number];
+/**
+ * A payload that is not plain JSON: bytes in base64 with their encoding and
+ * string metadata (content type, key id, codec name). The engine, the canvas
+ * and workflow code treat it as an opaque JSON value; only the codec that wrote
+ * it (a worker's codec or the codec server, or the service for `kms/envelope`)
+ * reads `data`.
+ */
+interface EncodedPayload {
+    $fgp: 1;
+    encoding: string;
+    metadata?: Record<string, string>;
+    /** Base64 (RFC 4648, with padding). */
+    data: string;
+}
+/** True when `value` is an {@link EncodedPayload}: exactly its keys, each well formed. */
+declare function isEncodedPayload(value: unknown): value is EncodedPayload;
+/** The encoding of a payload value: its own for an encoded payload, else `json/plain`. */
+declare function payloadEncodingOf(value: Json | undefined): string;
+/**
+ * Plain payload pointers per event type (relative to the event payload).
+ * Types not listed carry none. Failures are in {@link FAILURE_FIELDS}.
+ */
+declare const PAYLOAD_FIELDS: Readonly<Partial<Record<RunEventType, readonly string[]>>>;
+/**
+ * Failure pointers per event type (relative to the event payload): every
+ * property of the run-event schema that holds a failure. The payload of a
+ * failure is its `details`, and the `details` of each `cause` below it.
+ */
+declare const FAILURE_FIELDS: Readonly<Partial<Record<RunEventType, readonly string[]>>>;
+/** Plain payload pointers per command type (relative to the command). Types not listed carry none. */
+declare const COMMAND_PAYLOAD_FIELDS: Readonly<Partial<Record<CommandType, readonly string[]>>>;
+/** Failure pointers per command type (relative to the command); see {@link FAILURE_FIELDS}. */
+declare const COMMAND_FAILURE_FIELDS: Readonly<Partial<Record<CommandType, readonly string[]>>>;
+/** The payload pointers of a failure object (relative to it), at every level of its cause chain. */
+declare const FAILURE_PAYLOAD_FIELDS: readonly string[];
+/** The pointer of a failure's cause (relative to the failure); the rule applies to it again. */
+declare const FAILURE_CAUSE_FIELD = "/cause";
+/** The format tag of `schema/payload-fields.json`. */
+declare const PAYLOAD_FIELDS_FORMAT = "fluidgrids.payload-fields";
+/** `schema/payload-fields.json`: the pointers and the encoded form, for other SDKs. */
+declare const PAYLOAD_FIELDS_DOCUMENT: {
+    readonly format: "fluidgrids.payload-fields";
+    readonly formatVersion: 2;
+    readonly description: "JSON pointers of user payloads per event type (relative to the payload) and per command type (relative to the command). `events` and `commands` are plain payload pointers. `eventFailures` and `commandFailures` point at failure objects: the payloads of a failure are the `failure.payloads` pointers relative to it, and the same rule applies again to the failure at `failure.cause` (recursively, to the end of the cause chain). Payload codecs and the at-rest envelope apply to these pointers only; everything else stays in clear text. A value that is not plain JSON is carried as {\"$fgp\": 1, \"encoding\", \"metadata\"?, \"data\" (base64)}.";
+    readonly encodedMarker: "$fgp";
+    readonly encodedVersion: 1;
+    readonly encodings: readonly ["json/plain", "binary/plain", "binary/encrypted", "kms/envelope"];
+    readonly events: Readonly<Partial<Record<"WORKFLOW_STARTED" | "WORKFLOW_TASK_SCHEDULED" | "WORKFLOW_TASK_STARTED" | "WORKFLOW_TASK_COMPLETED" | "WORKFLOW_TASK_FAILED" | "WORKFLOW_TASK_TIMED_OUT" | "ACTIVITY_SCHEDULED" | "ACTIVITY_STARTED" | "ACTIVITY_HEARTBEAT" | "ACTIVITY_COMPLETED" | "ACTIVITY_FAILED" | "ACTIVITY_TIMED_OUT" | "ACTIVITY_CANCEL_REQUESTED" | "ACTIVITY_CANCELLED" | "ACTIVITY_PAUSED" | "ACTIVITY_UNPAUSED" | "ACTIVITY_RESET" | "ACTIVITY_OPTIONS_UPDATED" | "TIMER_STARTED" | "TIMER_FIRED" | "TIMER_CANCELLED" | "SIGNAL_RECEIVED" | "UPDATE_ADMITTED" | "UPDATE_ACCEPTED" | "UPDATE_COMPLETED" | "CHILD_RUN_INITIATED" | "CHILD_RUN_STARTED" | "CHILD_RUN_COMPLETED" | "CHILD_RUN_FAILED" | "CHILD_RUN_CANCELLED" | "CHILD_RUN_TERMINATED" | "CHILD_RUN_TIMED_OUT" | "EXTERNAL_RUN_CANCEL_REQUESTED" | "EXTERNAL_RUN_CANCEL_RESOLVED" | "EXTERNAL_RUN_SIGNALED" | "SIDE_EFFECT_RECORDED" | "LOCAL_ACTIVITY_COMPLETED" | "LOCAL_ACTIVITY_FAILED" | "SEARCH_ATTRIBUTES_UPSERTED" | "CONTEXT_UPSERTED" | "MARKER_RECORDED" | "WORKFLOW_CANCEL_REQUESTED" | "WORKFLOW_RESET" | "VERSIONING_OVERRIDE_SET" | "WORKFLOW_COMPLETED" | "WORKFLOW_FAILED" | "WORKFLOW_CANCELLED" | "WORKFLOW_TERMINATED" | "WORKFLOW_TIMED_OUT" | "WORKFLOW_CONTINUED_AS_NEW", readonly string[]>>>;
+    readonly commands: Readonly<Partial<Record<"SCHEDULE_ACTIVITY" | "REQUEST_CANCEL_ACTIVITY" | "START_TIMER" | "CANCEL_TIMER" | "START_CHILD_RUN" | "SIGNAL_RUN" | "RECORD_SIDE_EFFECT" | "RECORD_MARKER" | "COMPLETE_WORKFLOW" | "FAIL_WORKFLOW" | "CANCEL_WORKFLOW" | "UPSERT_CONTEXT" | "RECORD_LOCAL_ACTIVITY" | "CONTINUE_AS_NEW" | "REQUEST_CANCEL_EXTERNAL_RUN" | "UPSERT_SEARCH_ATTRIBUTES" | "ACCEPT_UPDATE" | "REJECT_UPDATE" | "COMPLETE_UPDATE", readonly string[]>>>;
+    readonly eventFailures: Readonly<Partial<Record<"WORKFLOW_STARTED" | "WORKFLOW_TASK_SCHEDULED" | "WORKFLOW_TASK_STARTED" | "WORKFLOW_TASK_COMPLETED" | "WORKFLOW_TASK_FAILED" | "WORKFLOW_TASK_TIMED_OUT" | "ACTIVITY_SCHEDULED" | "ACTIVITY_STARTED" | "ACTIVITY_HEARTBEAT" | "ACTIVITY_COMPLETED" | "ACTIVITY_FAILED" | "ACTIVITY_TIMED_OUT" | "ACTIVITY_CANCEL_REQUESTED" | "ACTIVITY_CANCELLED" | "ACTIVITY_PAUSED" | "ACTIVITY_UNPAUSED" | "ACTIVITY_RESET" | "ACTIVITY_OPTIONS_UPDATED" | "TIMER_STARTED" | "TIMER_FIRED" | "TIMER_CANCELLED" | "SIGNAL_RECEIVED" | "UPDATE_ADMITTED" | "UPDATE_ACCEPTED" | "UPDATE_COMPLETED" | "CHILD_RUN_INITIATED" | "CHILD_RUN_STARTED" | "CHILD_RUN_COMPLETED" | "CHILD_RUN_FAILED" | "CHILD_RUN_CANCELLED" | "CHILD_RUN_TERMINATED" | "CHILD_RUN_TIMED_OUT" | "EXTERNAL_RUN_CANCEL_REQUESTED" | "EXTERNAL_RUN_CANCEL_RESOLVED" | "EXTERNAL_RUN_SIGNALED" | "SIDE_EFFECT_RECORDED" | "LOCAL_ACTIVITY_COMPLETED" | "LOCAL_ACTIVITY_FAILED" | "SEARCH_ATTRIBUTES_UPSERTED" | "CONTEXT_UPSERTED" | "MARKER_RECORDED" | "WORKFLOW_CANCEL_REQUESTED" | "WORKFLOW_RESET" | "VERSIONING_OVERRIDE_SET" | "WORKFLOW_COMPLETED" | "WORKFLOW_FAILED" | "WORKFLOW_CANCELLED" | "WORKFLOW_TERMINATED" | "WORKFLOW_TIMED_OUT" | "WORKFLOW_CONTINUED_AS_NEW", readonly string[]>>>;
+    readonly commandFailures: Readonly<Partial<Record<"SCHEDULE_ACTIVITY" | "REQUEST_CANCEL_ACTIVITY" | "START_TIMER" | "CANCEL_TIMER" | "START_CHILD_RUN" | "SIGNAL_RUN" | "RECORD_SIDE_EFFECT" | "RECORD_MARKER" | "COMPLETE_WORKFLOW" | "FAIL_WORKFLOW" | "CANCEL_WORKFLOW" | "UPSERT_CONTEXT" | "RECORD_LOCAL_ACTIVITY" | "CONTINUE_AS_NEW" | "REQUEST_CANCEL_EXTERNAL_RUN" | "UPSERT_SEARCH_ATTRIBUTES" | "ACCEPT_UPDATE" | "REJECT_UPDATE" | "COMPLETE_UPDATE", readonly string[]>>>;
+    readonly failure: {
+        readonly payloads: readonly string[];
+        readonly cause: "/cause";
+    };
+};
+/**
+ * Apply `fn` to the value at each payload pointer of `record` that is present,
+ * and to the payloads of each failure at `failures` (its `details` at every
+ * level of its `cause` chain), returning a copy (the input is not changed).
+ * `fn` receives the pointer of the value it is given.
+ */
+declare function mapPayloadFields<T extends Record<string, Json | undefined>>(record: T, pointers: readonly string[], fn: (value: Json, pointer: string) => Json, failures?: readonly string[]): T;
+/**
+ * Apply `fn` to every user payload of an event payload of type `type`: the
+ * {@link PAYLOAD_FIELDS} pointers and the failures of {@link FAILURE_FIELDS}.
+ * This is the call a payload codec or the at-rest envelope makes per event.
+ */
+declare function mapEventPayloads<T extends Record<string, Json | undefined>>(type: RunEventType, payload: T, fn: (value: Json, pointer: string) => Json): T;
+/**
+ * Apply `fn` to every user payload of a command: the
+ * {@link COMMAND_PAYLOAD_FIELDS} pointers and the failures of
+ * {@link COMMAND_FAILURE_FIELDS}.
+ */
+declare function mapCommandPayloads<T extends {
+    type: CommandType;
+}>(command: T, fn: (value: Json, pointer: string) => Json): T;
+
+export { COMMAND_FAILURE_FIELDS as C, ENCODED_PAYLOAD_MARKER as E, FAILURE_CAUSE_FIELD as F, type KnownPayloadEncoding as K, PAYLOAD_ENCODINGS as P, COMMAND_PAYLOAD_FIELDS as a, ENCODED_PAYLOAD_VERSION as b, type EncodedPayload as c, FAILURE_FIELDS as d, FAILURE_PAYLOAD_FIELDS as e, PAYLOAD_FIELDS as f, PAYLOAD_FIELDS_DOCUMENT as g, PAYLOAD_FIELDS_FORMAT as h, isEncodedPayload as i, mapEventPayloads as j, mapPayloadFields as k, mapCommandPayloads as m, payloadEncodingOf as p };