@smthrs/flow 0.0.0-stage → 1.0.0-rc.4

package/dist/cjs/Action/TypeId.js

@@ -0,0 +1,25 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var TypeId_exports = {};
+__export(TypeId_exports, {
+  TypeId: () => TypeId
+});
+module.exports = __toCommonJS(TypeId_exports);
+const TypeId = "@smthrs/flow/Action";
+//# sourceMappingURL=TypeId.js.map

package/dist/cjs/Action/TypeId.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Action/TypeId.ts"],
+  "sourcesContent": ["// Deep reviewed and polished by a human on 2026-08-10.\n\n/**\n * Runtime identity shared by action interfaces and constructors.\n *\n * @private\n * @since 0.1.0\n */\nexport const TypeId = \"@smthrs/flow/Action\"\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,MAAM,SAAS;",
+  "names": []
+}

package/dist/cjs/Action/UncanonicalIdempotencyKey.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Defines the `UncanonicalIdempotencyKey` action failure.
+ *
+ * The `_tag` string was settled under `@smthrs/flow/` for 1.0.0-rc.0. The RC
+ * makes no compatibility promise to 0.x journals, and the tag freezes when
+ * the RC ships.
+ *
+ * @since 0.1.0
+ */
+import * as Schema from "effect/Schema";
+declare const UncanonicalIdempotencyKey_base: Schema.Class<UncanonicalIdempotencyKey, Schema.TaggedStruct<"@smthrs/flow/UncanonicalIdempotencyKey", {
+    readonly code: Schema.withConstructorDefault<Schema.Literal<"uncanonical_idempotency_key">>;
+    readonly actionName: Schema.String;
+    /** Stable reason identifying an RFC 8785 canonicalization failure. */
+    readonly reason: Schema.String;
+    /** The path of the offending value inside the declared identity. */
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A caller-declared object-form `idempotencyKey` carried material canonical
+ * serialization rejects. The declaration can be fixed, and the error is
+ * non-retryable: the same declaration
+ * derives the same rejection on every attempt, so the body never runs.
+ *
+ * @category errors
+ * @since 0.1.0
+ */
+export declare class UncanonicalIdempotencyKey extends UncanonicalIdempotencyKey_base {
+}
+export {};
+//# sourceMappingURL=UncanonicalIdempotencyKey.d.ts.map

package/dist/cjs/Action/UncanonicalIdempotencyKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UncanonicalIdempotencyKey.d.ts","sourceRoot":"","sources":["../../../src/Action/UncanonicalIdempotencyKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;;;;IAkBnC,sEAAsE;;IAEtE,oEAAoE;;;;AAlBxE;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,8BAa9C;CAAG"}

package/dist/cjs/Action/UncanonicalIdempotencyKey.js

@@ -0,0 +1,51 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var UncanonicalIdempotencyKey_exports = {};
+__export(UncanonicalIdempotencyKey_exports, {
+  UncanonicalIdempotencyKey: () => UncanonicalIdempotencyKey
+});
+module.exports = __toCommonJS(UncanonicalIdempotencyKey_exports);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Schema = __toESM(require("effect/Schema"), 1);
+class UncanonicalIdempotencyKey extends Schema.TaggedError()(
+  "@smthrs/flow/UncanonicalIdempotencyKey",
+  {
+    code: Schema.Literal("uncanonical_idempotency_key").pipe(
+      Schema.withConstructorDefault(Effect.succeed("uncanonical_idempotency_key"))
+    ),
+    actionName: Schema.String,
+    /** Stable reason identifying an RFC 8785 canonicalization failure. */
+    reason: Schema.String,
+    /** The path of the offending value inside the declared identity. */
+    path: Schema.String,
+    message: Schema.String
+  }
+) {
+}
+//# sourceMappingURL=UncanonicalIdempotencyKey.js.map

package/dist/cjs/Action/UncanonicalIdempotencyKey.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Action/UncanonicalIdempotencyKey.ts"],
+  "sourcesContent": ["/**\n * Defines the `UncanonicalIdempotencyKey` action failure.\n *\n * The `_tag` string was settled under `@smthrs/flow/` for 1.0.0-rc.0. The RC\n * makes no compatibility promise to 0.x journals, and the tag freezes when\n * the RC ships.\n *\n * @since 0.1.0\n */\n\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\n\n/**\n * A caller-declared object-form `idempotencyKey` carried material canonical\n * serialization rejects. The declaration can be fixed, and the error is\n * non-retryable: the same declaration\n * derives the same rejection on every attempt, so the body never runs.\n *\n * @category errors\n * @since 0.1.0\n */\nexport class UncanonicalIdempotencyKey extends Schema.TaggedError<UncanonicalIdempotencyKey>()(\n  \"@smthrs/flow/UncanonicalIdempotencyKey\",\n  {\n    code: Schema.Literal(\"uncanonical_idempotency_key\").pipe(\n      Schema.withConstructorDefault(Effect.succeed(\"uncanonical_idempotency_key\"))\n    ),\n    actionName: Schema.String,\n    /** Stable reason identifying an RFC 8785 canonicalization failure. */\n    reason: Schema.String,\n    /** The path of the offending value inside the declared identity. */\n    path: Schema.String,\n    message: Schema.String\n  }\n) {}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,aAAwB;AACxB,aAAwB;AAWjB,MAAM,kCAAkC,OAAO,YAAuC;AAAA,EAC3F;AAAA,EACA;AAAA,IACE,MAAM,OAAO,QAAQ,6BAA6B,EAAE;AAAA,MAClD,OAAO,uBAAuB,OAAO,QAAQ,6BAA6B,CAAC;AAAA,IAC7E;AAAA,IACA,YAAY,OAAO;AAAA;AAAA,IAEnB,QAAQ,OAAO;AAAA;AAAA,IAEf,MAAM,OAAO;AAAA,IACb,SAAS,OAAO;AAAA,EAClB;AACF,EAAE;AAAC;",
+  "names": []
+}

package/dist/cjs/Action/idempotencyKey.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Derives run-local keys for internal durable operations.
+ *
+ * @since 0.1.0
+ */
+import type * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import { FlowInstance } from "../FlowRuntime/FlowInstance.ts";
+/**
+ * Computes a run-local invocation key for an internal durable operation.
+ *
+ * The caller name separates durable declarations that share a parent scope.
+ *
+ * @category idempotency
+ * @since 0.1.0
+ */
+export declare const idempotencyKey: (name: string, options?: {
+    readonly includeAttempt?: boolean | undefined;
+    readonly parentScope?: string | undefined;
+} | undefined) => Effect.Effect<string, never, FlowInstance | Crypto.Crypto>;
+//# sourceMappingURL=idempotencyKey.d.ts.map

package/dist/cjs/Action/idempotencyKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.d.ts","sourceRoot":"","sources":["../../../src/Action/idempotencyKey.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAI7D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C,GAAG,SAAS,KACV,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAsC1D,CAAA"}

package/dist/cjs/Action/idempotencyKey.js

@@ -0,0 +1,59 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var idempotencyKey_exports = {};
+__export(idempotencyKey_exports, {
+  idempotencyKey: () => idempotencyKey
+});
+module.exports = __toCommonJS(idempotencyKey_exports);
+var Effect = __toESM(require("effect/Effect"), 1);
+var import_FlowInstance = require("../FlowRuntime/FlowInstance.js");
+var import_Context = require("./Context.js");
+var StepIdentity = __toESM(require("./StepIdentity.js"), 1);
+const idempotencyKey = (
+  // Untraced because action-key allocation is on every action attempt.
+  Effect.fnUntraced(function* (name, options) {
+    const instance = yield* import_FlowInstance.FlowInstance;
+    const attempt = yield* import_Context.CurrentAttempt;
+    const parentScope = options?.parentScope !== void 0 ? options.parentScope : options?.includeAttempt ? `attempt:${attempt}` : void 0;
+    const scope = yield* StepIdentity.allocationScope({
+      kind: "internal",
+      name,
+      idempotency: parentScope
+    }).pipe(Effect.orDie);
+    const ordinal = instance.actionState.nextOrdinal(scope);
+    const identityScope = JSON.stringify([name, parentScope ?? null]);
+    return yield* StepIdentity.invocationKey({
+      runId: instance.executionId,
+      ordinal,
+      tier: "unsealed",
+      parentScope: identityScope
+    }).pipe(Effect.orDie);
+  })
+);
+//# sourceMappingURL=idempotencyKey.js.map

package/dist/cjs/Action/idempotencyKey.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Action/idempotencyKey.ts"],
+  "sourcesContent": ["// Deep reviewed and polished by a human on 2026-08-10.\n\n/**\n * Derives run-local keys for internal durable operations.\n *\n * @since 0.1.0\n */\n\nimport type * as Crypto from \"effect/Crypto\"\nimport * as Effect from \"effect/Effect\"\nimport { FlowInstance } from \"../FlowRuntime/FlowInstance.ts\"\nimport { CurrentAttempt } from \"./Context.ts\"\nimport * as StepIdentity from \"./StepIdentity.ts\"\n\n/**\n * Computes a run-local invocation key for an internal durable operation.\n *\n * The caller name separates durable declarations that share a parent scope.\n *\n * @category idempotency\n * @since 0.1.0\n */\nexport const idempotencyKey: (\n  name: string,\n  options?: {\n    readonly includeAttempt?: boolean | undefined\n    readonly parentScope?: string | undefined\n  } | undefined\n) => Effect.Effect<string, never, FlowInstance | Crypto.Crypto> =\n  // Untraced because action-key allocation is on every action attempt.\n  Effect.fnUntraced(function*(name: string, options?: {\n    readonly includeAttempt?: boolean | undefined\n    readonly parentScope?: string | undefined\n  }) {\n    const instance = yield* FlowInstance\n    const attempt = yield* CurrentAttempt\n    // Internal durable operations are scoped by the caller's declaration name\n    // and declared `parentScope` through the canonical `StepIdentity` derivation (issue\n    // #98): a run-global counter numbered concurrent offers in fiber-arrival\n    // order, so a replay with a permuted interleaving handed one payload's\n    // ordinal to another and its await watched a deferred nothing resolves.\n    // With the counter scoped per declared parent, each scope numbers its\n    // own allocations deterministically; only allocations *within* one\n    // scope remain arrival-ordered \u2014 they carry no input that orders them\n    // by.\n    const parentScope = options?.parentScope !== undefined\n      ? options.parentScope\n      : options?.includeAttempt\n      ? `attempt:${attempt}`\n      : undefined\n    // String (or absent) idempotency input keeps the derivation total\n    // (issue #151): schema decoding preserves typed identity failures while\n    // injected cryptography keeps key construction platform-independent.\n    const scope = yield* StepIdentity.allocationScope({\n      kind: \"internal\",\n      name,\n      idempotency: parentScope\n    }).pipe(Effect.orDie)\n    const ordinal = instance.actionState.nextOrdinal(scope)\n    const identityScope = JSON.stringify([name, parentScope ?? null])\n    return yield* StepIdentity.invocationKey({\n      runId: instance.executionId,\n      ordinal,\n      tier: \"unsealed\",\n      parentScope: identityScope\n    }).pipe(Effect.orDie)\n  })\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,aAAwB;AACxB,0BAA6B;AAC7B,qBAA+B;AAC/B,mBAA8B;AAUvB,MAAM;AAAA;AAAA,EAQX,OAAO,WAAW,WAAU,MAAc,SAGvC;AACD,UAAM,WAAW,OAAO;AACxB,UAAM,UAAU,OAAO;AAUvB,UAAM,cAAc,SAAS,gBAAgB,SACzC,QAAQ,cACR,SAAS,iBACT,WAAW,OAAO,KAClB;AAIJ,UAAM,QAAQ,OAAO,aAAa,gBAAgB;AAAA,MAChD,MAAM;AAAA,MACN;AAAA,MACA,aAAa;AAAA,IACf,CAAC,EAAE,KAAK,OAAO,KAAK;AACpB,UAAM,UAAU,SAAS,YAAY,YAAY,KAAK;AACtD,UAAM,gBAAgB,KAAK,UAAU,CAAC,MAAM,eAAe,IAAI,CAAC;AAChE,WAAO,OAAO,aAAa,cAAc;AAAA,MACvC,OAAO,SAAS;AAAA,MAChB;AAAA,MACA,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC,EAAE,KAAK,OAAO,KAAK;AAAA,EACtB,CAAC;AAAA;",
+  "names": []
+}

package/dist/cjs/Action/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Durable actions, identity, boundaries, retries, and runtime context.
+ *
+ * @since 0.1.0
+ */
+export * from "./Action.ts";
+export * from "./AttemptTimedOut.ts";
+export * from "./BoundaryMode.ts";
+export * from "./CacheEnvironment.ts";
+export * from "./ConcurrentKeylessDispatch.ts";
+export * from "./Context.ts";
+export * from "./DuplicateImplementation.ts";
+export * from "./FileBoundary.ts";
+export * as Filegroup from "./Filegroup.ts";
+export * from "./FileInput.ts";
+export * as Glob from "./Glob.ts";
+export * from "./idempotencyKey.ts";
+export * from "./Implementations.ts";
+export * from "./ImplementationVersionMismatch.ts";
+export * from "./InfraInterrupt.ts";
+export * from "./InfraInterruptRetriesExhausted.ts";
+export * from "./IrreversibleRetryRequiresIdempotencyKey.ts";
+export * from "./make.ts";
+export * from "./raceAll.ts";
+export * from "./retry.ts";
+export * from "./StepIdentity.ts";
+export * as TreeArtifact from "./TreeArtifact.ts";
+export * from "./UncanonicalIdempotencyKey.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/Action/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Action/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,cAAc,CAAA;AAC5B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,mBAAmB,CAAA;AACjC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,cAAc,gBAAgB,CAAA;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oCAAoC,CAAA;AAClD,cAAc,qBAAqB,CAAA;AACnC,cAAc,qCAAqC,CAAA;AACnD,cAAc,8CAA8C,CAAA;AAC5D,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,cAAc,gCAAgC,CAAA"}

package/dist/cjs/Action/index.js

@@ -0,0 +1,60 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Action_exports = {};
+__export(Action_exports, {
+  Filegroup: () => Filegroup,
+  Glob: () => Glob,
+  TreeArtifact: () => TreeArtifact
+});
+module.exports = __toCommonJS(Action_exports);
+__reExport(Action_exports, require("./Action.js"), module.exports);
+__reExport(Action_exports, require("./AttemptTimedOut.js"), module.exports);
+__reExport(Action_exports, require("./BoundaryMode.js"), module.exports);
+__reExport(Action_exports, require("./CacheEnvironment.js"), module.exports);
+__reExport(Action_exports, require("./ConcurrentKeylessDispatch.js"), module.exports);
+__reExport(Action_exports, require("./Context.js"), module.exports);
+__reExport(Action_exports, require("./DuplicateImplementation.js"), module.exports);
+__reExport(Action_exports, require("./FileBoundary.js"), module.exports);
+var Filegroup = __toESM(require("./Filegroup.js"), 1);
+__reExport(Action_exports, require("./FileInput.js"), module.exports);
+var Glob = __toESM(require("./Glob.js"), 1);
+__reExport(Action_exports, require("./idempotencyKey.js"), module.exports);
+__reExport(Action_exports, require("./Implementations.js"), module.exports);
+__reExport(Action_exports, require("./ImplementationVersionMismatch.js"), module.exports);
+__reExport(Action_exports, require("./InfraInterrupt.js"), module.exports);
+__reExport(Action_exports, require("./InfraInterruptRetriesExhausted.js"), module.exports);
+__reExport(Action_exports, require("./IrreversibleRetryRequiresIdempotencyKey.js"), module.exports);
+__reExport(Action_exports, require("./make.js"), module.exports);
+__reExport(Action_exports, require("./raceAll.js"), module.exports);
+__reExport(Action_exports, require("./retry.js"), module.exports);
+__reExport(Action_exports, require("./StepIdentity.js"), module.exports);
+var TreeArtifact = __toESM(require("./TreeArtifact.js"), 1);
+__reExport(Action_exports, require("./UncanonicalIdempotencyKey.js"), module.exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/Action/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Action/index.ts"],
+  "sourcesContent": ["// Deep reviewed and polished by a human on 2026-08-10.\n\n/**\n * Durable actions, identity, boundaries, retries, and runtime context.\n *\n * @since 0.1.0\n */\n\nexport * from \"./Action.ts\"\nexport * from \"./AttemptTimedOut.ts\"\nexport * from \"./BoundaryMode.ts\"\nexport * from \"./CacheEnvironment.ts\"\nexport * from \"./ConcurrentKeylessDispatch.ts\"\nexport * from \"./Context.ts\"\nexport * from \"./DuplicateImplementation.ts\"\nexport * from \"./FileBoundary.ts\"\nexport * as Filegroup from \"./Filegroup.ts\"\nexport * from \"./FileInput.ts\"\nexport * as Glob from \"./Glob.ts\"\nexport * from \"./idempotencyKey.ts\"\nexport * from \"./Implementations.ts\"\nexport * from \"./ImplementationVersionMismatch.ts\"\nexport * from \"./InfraInterrupt.ts\"\nexport * from \"./InfraInterruptRetriesExhausted.ts\"\nexport * from \"./IrreversibleRetryRequiresIdempotencyKey.ts\"\nexport * from \"./make.ts\"\nexport * from \"./raceAll.ts\"\nexport * from \"./retry.ts\"\nexport * from \"./StepIdentity.ts\"\nexport * as TreeArtifact from \"./TreeArtifact.ts\"\nexport * from \"./UncanonicalIdempotencyKey.ts\"\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,2BAAc,wBARd;AASA,2BAAc,iCATd;AAUA,2BAAc,8BAVd;AAWA,2BAAc,kCAXd;AAYA,2BAAc,2CAZd;AAaA,2BAAc,yBAbd;AAcA,2BAAc,yCAdd;AAeA,2BAAc,8BAfd;AAgBA,gBAA2B;AAC3B,2BAAc,2BAjBd;AAkBA,WAAsB;AACtB,2BAAc,gCAnBd;AAoBA,2BAAc,iCApBd;AAqBA,2BAAc,+CArBd;AAsBA,2BAAc,gCAtBd;AAuBA,2BAAc,gDAvBd;AAwBA,2BAAc,yDAxBd;AAyBA,2BAAc,sBAzBd;AA0BA,2BAAc,yBA1Bd;AA2BA,2BAAc,uBA3Bd;AA4BA,2BAAc,8BA5Bd;AA6BA,mBAA8B;AAC9B,2BAAc,2CA9Bd;",
+  "names": []
+}

package/dist/cjs/Action/make.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Constructs executable durable action values.
+ *
+ * @since 0.1.0
+ */
+import type * as Effects from "@smthrs/plan/Effects";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type * as Schedule from "effect/Schedule";
+import * as Schema from "effect/Schema";
+import type { Scope } from "effect/Scope";
+import type * as Flow from "../Flow/Flow.ts";
+import { FlowInstance } from "../FlowRuntime/FlowInstance.ts";
+import { FlowRuntime } from "../FlowRuntime/FlowRuntime.ts";
+import type * as RetryPolicy from "../RetryPolicy.ts";
+import type { Action, Declared, IdempotencyKey, Tier } from "./Action.ts";
+import { FileBoundary } from "./FileBoundary.ts";
+/**
+ * The options of a declared action, shared by {@link make}'s declared form and
+ * {@link makeSystem}.
+ */
+interface DeclaredOptions<Payload extends Schema.Struct.Fields | Flow.AnyStructSchema, Success extends Schema.Top, Error extends Schema.Top> {
+    readonly payload: Payload;
+    /**
+     * Native declaration whose source location this reconstructed action retains.
+     * A source with no recorded location preserves that absence. This affects
+     * diagnostics only, never identity; calls still refer to the new declaration.
+     */
+    readonly declaredFrom?: object | undefined;
+    readonly implementationVersion?: string | undefined;
+    readonly success?: Success | undefined;
+    readonly error?: Error | undefined;
+    /**
+     * The capability ceiling this action dispatches under, as string literals.
+     *
+     * It is the same ceiling {@link module:Flow/Annotations.Capabilities}
+     * carries, and declaring it here is what makes it READABLE without importing
+     * the module, exactly as `Flow.make`'s option is: a catalog projects a
+     * discovered declaration's authority from the source text of this literal,
+     * and an annotation built at run time is invisible to that projection.
+     *
+     * {@link module:Graph.build} records a `capability_outside_grant` refusal for
+     * every capability named here that the calling flow does not hold. The
+     * refusal is advisory: execution intersects this ceiling with every caller ceiling.
+     */
+    readonly capabilities?: ReadonlyArray<string> | undefined;
+    /**
+     * The effect envelope this action dispatches under, as a literal.
+     *
+     * It is the same declaration {@link module:Flow/Annotations.EffectEnvelope}
+     * carries, declared here for the same reason `capabilities` is.
+     *
+     * An action is a leaf, so this envelope encloses nothing; it is checked
+     * against the envelope the calling flow granted, and
+     * {@link module:Graph.build} refuses a dispatch that reads or writes outside
+     * that grant, loosens `hermetic` to `expected`, or raises the tier. `reads`
+     * and `writes` are normalized to sorted, duplicate-free arrays.
+     */
+    readonly effects?: Effects.MakeOptions | undefined;
+    readonly tier?: Tier | undefined;
+    readonly idempotencyKey?: IdempotencyKey | ((payload: (Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload)["Type"]) => IdempotencyKey) | undefined;
+    readonly nondeterministic?: true | undefined;
+    readonly retryPolicy?: RetryPolicy.RetryPolicy | undefined;
+    /**
+     * Milliseconds one attempt may run. A longer attempt is interrupted and
+     * fails with {@link module:AttemptTimedOut.AttemptTimedOut}, which
+     * `retryPolicy` retries like any other attempt failure.
+     */
+    readonly attemptTimeoutMs?: number | undefined;
+    /**
+     * Milliseconds one attempt may go without calling
+     * {@link module:Context.heartbeat}, measured from the attempt's start and
+     * then from each heartbeat. A missed heartbeat fails the attempt like
+     * `attemptTimeoutMs`.
+     */
+    readonly heartbeatTimeoutMs?: number | undefined;
+    readonly interruptRetryPolicy?: Schedule.Schedule<any, unknown> | undefined;
+    readonly fileBoundary?: FileBoundary | ((payload: (Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload)["Type"]) => FileBoundary) | undefined;
+    readonly annotations?: Context.Context<never> | undefined;
+}
+/**
+ * Creates either an inline executable action or a named action
+ * declaration, selected by whether the first argument is a string.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export declare const make: {
+    <const Tag extends string, Payload extends Schema.Struct.Fields | Flow.AnyStructSchema, Success extends Schema.Top = Schema.Void, Error extends Schema.Top = Schema.Never>(tag: Tag, options: DeclaredOptions<Payload, Success, Error>): Declared<Tag, Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload, Success, Error>;
+    <R, Success extends Schema.Constraint = Schema.Void, Error extends Schema.Constraint = Schema.Never>(options: {
+        readonly name: string;
+        readonly implementationVersion?: string | undefined;
+        readonly success?: Success | undefined;
+        readonly error?: Error | undefined;
+        readonly execute: Effect.Effect<Success["Type"], Error["Type"], R>;
+        readonly tier?: Tier | undefined;
+        readonly idempotencyKey?: IdempotencyKey | undefined;
+        readonly nondeterministic?: true | undefined;
+        readonly metadata?: unknown;
+        readonly fileBoundary?: FileBoundary | undefined;
+        readonly interruptRetryPolicy?: Schedule.Schedule<any, unknown> | undefined;
+        readonly retryPolicy?: RetryPolicy.RetryPolicy | undefined;
+        readonly attemptTimeoutMs?: number | undefined;
+        readonly heartbeatTimeoutMs?: number | undefined;
+        readonly annotations?: Context.Context<never> | undefined;
+    }): Action<Success, Error, Exclude<R, FlowInstance | FlowRuntime | Scope>>;
+};
+/**
+ * Declares a SYSTEM action: one whose implementation ships with the engine
+ * rather than with the composition that calls it.
+ *
+ * It is {@link make}'s declared form in every respect except the requirement.
+ * A system declaration mints none, so `.call()` records a node that demands
+ * nothing and a body using {@link module:Sleep} or {@link module:WaitFor} does
+ * not push a layer obligation onto its callers. That is the whole difference,
+ * and it is a deliberate hole in the compile-time enforcement: the engine owns
+ * these implementations, so an author cannot be the one who forgot them.
+ *
+ * Everything else is unchanged — the layer still registers with the runtime and
+ * still files itself in {@link module:Implementations.Implementations}, so a
+ * driver resolves a system action by tag exactly like any other.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export declare const makeSystem: <const Tag extends string, Payload extends Schema.Struct.Fields | Flow.AnyStructSchema, Success extends Schema.Top = Schema.Void, Error extends Schema.Top = Schema.Never>(tag: Tag, options: DeclaredOptions<Payload, Success, Error>) => Declared<Tag, Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload, Success, Error, never>;
+export {};
+//# sourceMappingURL=make.d.ts.map

package/dist/cjs/Action/make.d.ts.map

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