@temporalio/common 1.12.2 → 1.13.0

package/lib/priority.js

@@ -6,7 +6,11 @@ exports.compilePriority = compilePriority;
  * Turn a proto compatible Priority into a TS Priority
  */
 function decodePriority(priority) {
-    return { priorityKey: priority?.priorityKey ?? undefined };
+    return {
+        priorityKey: priority?.priorityKey ?? undefined,
+        fairnessKey: priority?.fairnessKey ?? undefined,
+        fairnessWeight: priority?.fairnessWeight ?? undefined,
+    };
 }
 /**
  * Turn a TS Priority into a proto compatible Priority
@@ -22,6 +26,8 @@ function compilePriority(priority) {
     }
     return {
         priorityKey: priority.priorityKey ?? 0,
+        fairnessKey: priority.fairnessKey ?? '',
+        fairnessWeight: priority.fairnessWeight ?? 0,
     };
 }
 //# sourceMappingURL=priority.js.map

package/lib/priority.js.map

@@ -1 +1 @@
-{"version":3,"file":"priority.js","sourceRoot":"","sources":["../src/priority.ts"],"names":[],"mappings":";;AAiCA,wCAEC;AAKD,0CAaC;AAvBD;;GAEG;AACH,SAAgB,cAAc,CAAC,QAAkD;IAC/E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,QAAkB;IAChD,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,QAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../src/priority.ts"],"names":[],"mappings":";;AA4DA,wCAMC;AAKD,0CAeC;AA7BD;;GAEG;AACH,SAAgB,cAAc,CAAC,QAAkD;IAC/E,OAAO;QACL,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,SAAS;QAC/C,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,SAAS;QAC/C,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,SAAS;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,QAAkB;IAChD,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,QAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;QACtC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,cAAc,EAAE,QAAQ,CAAC,cAAc,IAAI,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/lib/proto-utils.d.ts

@@ -23,6 +23,14 @@ export declare function historyFromJSON(history: unknown): History;
  * string that adheres to the same norm as JSON history files produced by other Temporal tools.
  */
 export declare function historyToJSON(history: History): string;
+/**
+ * toProto3JSON doesn't correctly handle some of our "bytes" fields, passing them untouched to the
+ * output, after which JSON.stringify() would convert them to an array of numbers. As a workaround,
+ * recursively walk the object and convert all Buffer instances to base64 strings. Note this only
+ * works on proto3-json-serializer v2.0.0. v2.0.2 throws an error before we even get the chance
+ * to fix the buffers. See https://github.com/googleapis/proto3-json-serializer-nodejs/issues/103.
+ */
+export declare function fixBuffers<T>(e: T): T;
 /**
  * Convert from protobuf payload to JSON
  */

package/lib/proto-utils.js

@@ -25,6 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.historyFromJSON = historyFromJSON;
 exports.historyToJSON = historyToJSON;
+exports.fixBuffers = fixBuffers;
 exports.payloadToJSON = payloadToJSON;
 exports.JSONToPayload = JSONToPayload;
 const proto3_json_serializer_1 = require("proto3-json-serializer");
@@ -113,29 +114,33 @@ function historyFromJSON(history) {
  * string that adheres to the same norm as JSON history files produced by other Temporal tools.
  */
 function historyToJSON(history) {
-    // toProto3JSON doesn't correctly handle some of our "bytes" fields, passing them untouched to the
-    // output, after which JSON.stringify() would convert them to an array of numbers. As a workaround,
-    // recursively walk the object and convert all Buffer instances to base64 strings. Note this only
-    // works on proto3-json-serializer v2.0.0. v2.0.2 throws an error before we even get the chance
-    // to fix the buffers. See https://github.com/googleapis/proto3-json-serializer-nodejs/issues/103.
-    function fixBuffers(e) {
-        if (e && typeof e === 'object') {
-            if (e instanceof Buffer)
-                return e.toString('base64');
-            if (Array.isArray(e))
-                return e.map(fixBuffers);
-            return Object.fromEntries(Object.entries(e).map(([k, v]) => [k, fixBuffers(v)]));
-        }
-        return e;
-    }
     const protoJson = (0, proto3_json_serializer_1.toProto3JSON)(proto.temporal.api.history.v1.History.fromObject(history));
     return JSON.stringify(fixBuffers(protoJson), null, 2);
 }
+/**
+ * toProto3JSON doesn't correctly handle some of our "bytes" fields, passing them untouched to the
+ * output, after which JSON.stringify() would convert them to an array of numbers. As a workaround,
+ * recursively walk the object and convert all Buffer instances to base64 strings. Note this only
+ * works on proto3-json-serializer v2.0.0. v2.0.2 throws an error before we even get the chance
+ * to fix the buffers. See https://github.com/googleapis/proto3-json-serializer-nodejs/issues/103.
+ */
+function fixBuffers(e) {
+    if (e && typeof e === 'object') {
+        if (e instanceof Buffer)
+            return e.toString('base64');
+        if (e instanceof Uint8Array)
+            return Buffer.from(e).toString('base64');
+        if (Array.isArray(e))
+            return e.map(fixBuffers);
+        return Object.fromEntries(Object.entries(e).map(([k, v]) => [k, fixBuffers(v)]));
+    }
+    return e;
+}
 /**
  * Convert from protobuf payload to JSON
  */
 function payloadToJSON(payload) {
-    return (0, proto3_json_serializer_1.toProto3JSON)(patched.temporal.api.common.v1.Payload.create(payload));
+    return fixBuffers((0, proto3_json_serializer_1.toProto3JSON)(patched.temporal.api.common.v1.Payload.create(payload)));
 }
 /**
  * Convert from JSON to protobuf payload

package/lib/proto-utils.js.map

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

package/lib/user-metadata.d.ts

@@ -1,6 +1,5 @@
-import { temporal } from '@temporalio/proto';
+import type { temporal } from '@temporalio/proto';
 import { PayloadConverter } from './converter/payload-converter';
-import { LoadedDataConverter } from './converter/data-converter';
 /**
  * User metadata that can be attached to workflow commands.
  */
@@ -11,5 +10,3 @@ export interface UserMetadata {
     staticDetails?: string;
 }
 export declare function userMetadataToPayload(payloadConverter: PayloadConverter, staticSummary: string | undefined, staticDetails: string | undefined): temporal.api.sdk.v1.IUserMetadata | undefined;
-export declare function encodeUserMetadata(dataConverter: LoadedDataConverter, staticSummary: string | undefined, staticDetails: string | undefined): Promise<temporal.api.sdk.v1.IUserMetadata | undefined>;
-export declare function decodeUserMetadata(dataConverter: LoadedDataConverter, metadata: temporal.api.sdk.v1.IUserMetadata | undefined | null): Promise<UserMetadata>;

package/lib/user-metadata.js

@@ -1,10 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.userMetadataToPayload = userMetadataToPayload;
-exports.encodeUserMetadata = encodeUserMetadata;
-exports.decodeUserMetadata = decodeUserMetadata;
 const payload_converter_1 = require("./converter/payload-converter");
-const internal_non_workflow_1 = require("./internal-non-workflow");
 function userMetadataToPayload(payloadConverter, staticSummary, staticDetails) {
     if (staticSummary == null && staticDetails == null)
         return undefined;
@@ -14,22 +11,4 @@ function userMetadataToPayload(payloadConverter, staticSummary, staticDetails) {
         return undefined;
     return { summary, details };
 }
-async function encodeUserMetadata(dataConverter, staticSummary, staticDetails) {
-    if (staticSummary == null && staticDetails == null)
-        return undefined;
-    const { payloadConverter, payloadCodecs } = dataConverter;
-    const summary = await (0, internal_non_workflow_1.encodeOptionalSingle)(payloadCodecs, (0, payload_converter_1.convertOptionalToPayload)(payloadConverter, staticSummary));
-    const details = await (0, internal_non_workflow_1.encodeOptionalSingle)(payloadCodecs, (0, payload_converter_1.convertOptionalToPayload)(payloadConverter, staticDetails));
-    if (summary == null && details == null)
-        return undefined;
-    return { summary, details };
-}
-async function decodeUserMetadata(dataConverter, metadata) {
-    const res = { staticSummary: undefined, staticDetails: undefined };
-    if (metadata == null)
-        return res;
-    const staticSummary = (await (0, internal_non_workflow_1.decodeOptionalSinglePayload)(dataConverter, metadata.summary)) ?? undefined;
-    const staticDetails = (await (0, internal_non_workflow_1.decodeOptionalSinglePayload)(dataConverter, metadata.details)) ?? undefined;
-    return { staticSummary, staticDetails };
-}
 //# sourceMappingURL=user-metadata.js.map

package/lib/user-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-metadata.js","sourceRoot":"","sources":["../src/user-metadata.ts"],"names":[],"mappings":";;AAeA,sDAaC;AAED,gDAcC;AAED,gDAWC;AAxDD,qEAA2F;AAE3F,mEAA4F;AAY5F,SAAgB,qBAAqB,CACnC,gBAAkC,EAClC,aAAiC,EACjC,aAAiC;IAEjC,IAAI,aAAa,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAE1E,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,aAAkC,EAClC,aAAiC,EACjC,aAAiC;IAEjC,IAAI,aAAa,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAErE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,IAAA,4CAAoB,EAAC,aAAa,EAAE,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC;IACrH,MAAM,OAAO,GAAG,MAAM,IAAA,4CAAoB,EAAC,aAAa,EAAE,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC;IAErH,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,aAAkC,EAClC,QAA8D;IAE9D,MAAM,GAAG,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IACnE,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAEjC,MAAM,aAAa,GAAG,CAAC,MAAM,IAAA,mDAA2B,EAAS,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC;IAChH,MAAM,aAAa,GAAG,CAAC,MAAM,IAAA,mDAA2B,EAAS,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC;IAEhH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"user-metadata.js","sourceRoot":"","sources":["../src/user-metadata.ts"],"names":[],"mappings":";;AAaA,sDAaC;AAzBD,qEAA2F;AAY3F,SAAgB,qBAAqB,CACnC,gBAAkC,EAClC,aAAiC,EACjC,aAAiC;IAEjC,IAAI,aAAa,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAA,4CAAwB,EAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAE1E,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/lib/workflow-options.d.ts

@@ -143,14 +143,14 @@ export interface BaseWorkflowOptions {
      * General fixed details for this workflow execution that may appear in UI/CLI.
      * This can be in Temporal markdown format and can span multiple lines.
      *
-     * @experimental User metadata is a new API and suspectible to change.
+     * @experimental User metadata is a new API and susceptible to change.
      */
     staticDetails?: string;
     /**
      * A single-line fixed summary for this workflow execution that may appear in the UI/CLI.
      * This can be in single-line Temporal markdown format.
      *
-     * @experimental User metadata is a new API and suspectible to change.
+     * @experimental User metadata is a new API and susceptible to change.
      */
     staticSummary?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporalio/common",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Common library for code that's used across the Client, Worker, and/or Workflow",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -12,9 +12,10 @@
   "author": "Temporal Technologies Inc. <sdk@temporal.io>",
   "license": "MIT",
   "dependencies": {
-    "@temporalio/proto": "1.12.2",
+    "@temporalio/proto": "1.13.0",
     "long": "^5.2.3",
-    "ms": "^3.0.0-canary.1",
+    "ms": "3.0.0-canary.1",
+    "nexus-rpc": "^0.0.1",
     "proto3-json-serializer": "^2.0.0"
   },
   "devDependencies": {
@@ -39,5 +40,5 @@
     "src",
     "lib"
   ],
-  "gitHead": "98393e00b714b8d44a3dc25714d313d3366f4c50"
+  "gitHead": "cf7c1e7d70f0c775f1382fd335b8bd721495f8cc"
 }

package/src/activity-cancellation-details.ts

@@ -0,0 +1,52 @@
+import type { coresdk } from '@temporalio/proto';
+
+// ts-prune-ignore-next
+export interface ActivityCancellationDetailsHolder {
+  details?: ActivityCancellationDetails;
+}
+
+export interface ActivityCancellationDetailsOptions {
+  notFound?: boolean;
+  cancelRequested?: boolean;
+  paused?: boolean;
+  timedOut?: boolean;
+  workerShutdown?: boolean;
+  reset?: boolean;
+}
+
+/**
+ * Provides the reasons for the activity's cancellation. Cancellation details are set once and do not change once set.
+ */
+export class ActivityCancellationDetails {
+  readonly notFound: boolean;
+  readonly cancelRequested: boolean;
+  readonly paused: boolean;
+  readonly timedOut: boolean;
+  readonly workerShutdown: boolean;
+  readonly reset: boolean;
+
+  public constructor(options: ActivityCancellationDetailsOptions = {}) {
+    this.notFound = options.notFound ?? false;
+    this.cancelRequested = options.cancelRequested ?? false;
+    this.paused = options.paused ?? false;
+    this.timedOut = options.timedOut ?? false;
+    this.workerShutdown = options.workerShutdown ?? false;
+    this.reset = options.reset ?? false;
+  }
+
+  static fromProto(
+    proto: coresdk.activity_task.IActivityCancellationDetails | null | undefined
+  ): ActivityCancellationDetails {
+    if (proto == null) {
+      return new ActivityCancellationDetails();
+    }
+    return new ActivityCancellationDetails({
+      notFound: proto.isNotFound ?? false,
+      cancelRequested: proto.isCancelled ?? false,
+      paused: proto.isPaused ?? false,
+      timedOut: proto.isTimedOut ?? false,
+      workerShutdown: proto.isWorkerShutdown ?? false,
+      reset: proto.isReset ?? false,
+    });
+  }
+}

package/src/activity-options.ts

@@ -129,7 +129,7 @@ export interface ActivityOptions {
    * A fixed, single-line summary for this workflow execution that may appear in the UI/CLI.
    * This can be in single-line Temporal markdown format.
    *
-   * @experimental User metadata is a new API and suspectible to change.
+   * @experimental User metadata is a new API and susceptible to change.
    */
   summary?: string;
 
@@ -206,7 +206,7 @@ export interface LocalActivityOptions {
    * A fixed, single-line summary for this workflow execution that may appear in the UI/CLI.
    * This can be in single-line Temporal markdown format.
    *
-   * @experimental User metadata is a new API and suspectible to change.
+   * @experimental User metadata is a new API and susceptible to change.
    */
   summary?: string;
 }

package/src/converter/failure-converter.ts

@@ -1,3 +1,6 @@
+import * as nexus from 'nexus-rpc';
+import Long from 'long';
+import type { temporal } from '@temporalio/proto';
 import {
   ActivityFailure,
   ApplicationFailure,
@@ -10,16 +13,42 @@ import {
   encodeRetryState,
   encodeTimeoutType,
   FAILURE_SOURCE,
+  NexusOperationFailure,
   ProtoFailure,
   ServerFailure,
   TemporalFailure,
   TerminatedFailure,
   TimeoutFailure,
 } from '../failure';
+import { makeProtoEnumConverters } from '../internal-workflow';
 import { isError } from '../type-helpers';
 import { msOptionalToTs } from '../time';
 import { arrayFromPayloads, fromPayloadsAtIndex, PayloadConverter, toPayloads } from './payload-converter';
 
+// Can't import proto enums into the workflow sandbox, use this helper type and enum converter instead.
+const NexusHandlerErrorRetryBehavior = {
+  RETRYABLE: 'RETRYABLE',
+  NON_RETRYABLE: 'NON_RETRYABLE',
+} as const;
+
+type NexusHandlerErrorRetryBehavior =
+  (typeof NexusHandlerErrorRetryBehavior)[keyof typeof NexusHandlerErrorRetryBehavior];
+
+const [encodeNexusHandlerErrorRetryBehavior, decodeNexusHandlerErrorRetryBehavior] = makeProtoEnumConverters<
+  temporal.api.enums.v1.NexusHandlerErrorRetryBehavior,
+  typeof temporal.api.enums.v1.NexusHandlerErrorRetryBehavior,
+  keyof typeof temporal.api.enums.v1.NexusHandlerErrorRetryBehavior,
+  typeof NexusHandlerErrorRetryBehavior,
+  'NEXUS_HANDLER_ERROR_RETRY_BEHAVIOR_'
+>(
+  {
+    UNSPECIFIED: 0,
+    [NexusHandlerErrorRetryBehavior.RETRYABLE]: 1,
+    [NexusHandlerErrorRetryBehavior.NON_RETRYABLE]: 2,
+  } as const,
+  'NEXUS_HANDLER_ERROR_RETRY_BEHAVIOR_'
+);
+
 function combineRegExp(...regexps: RegExp[]): RegExp {
   return new RegExp(regexps.map((x) => `(?:${x.source})`).join('|'));
 }
@@ -30,6 +59,8 @@ function combineRegExp(...regexps: RegExp[]): RegExp {
 const CUTOFF_STACK_PATTERNS = combineRegExp(
   /** Activity execution */
   /\s+at Activity\.execute \(.*[\\/]worker[\\/](?:src|lib)[\\/]activity\.[jt]s:\d+:\d+\)/,
+  /** Nexus execution */
+  /\s+at( async)? NexusHandler\.invokeUserCode \(.*[\\/]worker[\\/](?:src|lib)[\\/]nexus[\\/]index\.[jt]s:\d+:\d+\)/,
   /** Workflow activation */
   /\s+at Activator\.\S+NextHandler \(.*[\\/]workflow[\\/](?:src|lib)[\\/]internals\.[jt]s:\d+:\d+\)/,
   /** Workflow run anything in context */
@@ -122,7 +153,7 @@ export class DefaultFailureConverter implements FailureConverter {
    *
    * Does not set common properties, that is done in {@link failureToError}.
    */
-  failureToErrorInner(failure: ProtoFailure, payloadConverter: PayloadConverter): TemporalFailure {
+  failureToErrorInner(failure: ProtoFailure, payloadConverter: PayloadConverter): Error {
     if (failure.applicationFailureInfo) {
       return new ApplicationFailure(
         failure.message ?? undefined,
@@ -196,6 +227,41 @@ export class DefaultFailureConverter implements FailureConverter {
         this.optionalFailureToOptionalError(failure.cause, payloadConverter)
       );
     }
+    if (failure.nexusHandlerFailureInfo) {
+      let retryableOverride: boolean | undefined = undefined;
+      const retryBehavior = decodeNexusHandlerErrorRetryBehavior(failure.nexusHandlerFailureInfo.retryBehavior);
+      switch (retryBehavior) {
+        case 'RETRYABLE':
+          retryableOverride = true;
+          break;
+        case 'NON_RETRYABLE':
+          retryableOverride = false;
+          break;
+      }
+
+      return new nexus.HandlerError(
+        (failure.nexusHandlerFailureInfo.type as nexus.HandlerErrorType) ?? 'INTERNAL',
+        // TODO(nexus/error): Maybe set a default message here, once we've decided on error handling.
+        failure.message ?? undefined,
+        {
+          cause: this.optionalFailureToOptionalError(failure.cause, payloadConverter),
+          retryableOverride,
+        }
+      );
+    }
+    if (failure.nexusOperationExecutionFailureInfo) {
+      return new NexusOperationFailure(
+        // TODO(nexus/error): Maybe set a default message here, once we've decided on error handling.
+        failure.message ?? undefined,
+        failure.nexusOperationExecutionFailureInfo.scheduledEventId?.toNumber(),
+        // We assume these will always be set or gracefully set to empty strings.
+        failure.nexusOperationExecutionFailureInfo.endpoint ?? '',
+        failure.nexusOperationExecutionFailureInfo.service ?? '',
+        failure.nexusOperationExecutionFailureInfo.operation ?? '',
+        failure.nexusOperationExecutionFailureInfo.operationToken ?? undefined,
+        this.optionalFailureToOptionalError(failure.cause, payloadConverter)
+      );
+    }
     return new TemporalFailure(
       failure.message ?? undefined,
       this.optionalFailureToOptionalError(failure.cause, payloadConverter)
@@ -220,7 +286,9 @@ export class DefaultFailureConverter implements FailureConverter {
     }
     const err = this.failureToErrorInner(failure, payloadConverter);
     err.stack = failure.stackTrace ?? '';
-    err.failure = failure;
+    if (err instanceof TemporalFailure) {
+      err.failure = failure;
+    }
     return err;
   }
 
@@ -236,8 +304,11 @@ export class DefaultFailureConverter implements FailureConverter {
   }
 
   errorToFailureInner(err: unknown, payloadConverter: PayloadConverter): ProtoFailure {
-    if (err instanceof TemporalFailure) {
-      if (err.failure) return err.failure;
+    // TODO(nexus/error): If we decide not to have a NexusHandlerFailure, we could still attach the
+    //                    failure proto to the Nexus HandlerError object, by using a private symbol
+    //                    property. To be considered once we have a decision on error handling.
+    if (err instanceof TemporalFailure || err instanceof nexus.HandlerError) {
+      if (err instanceof TemporalFailure && err.failure) return err.failure;
       const base = {
         message: err.message,
         stackTrace: cutoffStackTrace(err.stack),
@@ -315,6 +386,39 @@ export class DefaultFailureConverter implements FailureConverter {
           terminatedFailureInfo: {},
         };
       }
+      if (err instanceof nexus.HandlerError) {
+        let retryBehavior: temporal.api.enums.v1.NexusHandlerErrorRetryBehavior | undefined = undefined;
+        switch (err.retryableOverride) {
+          case true:
+            retryBehavior = encodeNexusHandlerErrorRetryBehavior('RETRYABLE');
+            break;
+          case false:
+            retryBehavior = encodeNexusHandlerErrorRetryBehavior('NON_RETRYABLE');
+            break;
+        }
+
+        return {
+          // TODO(nexus/error): Maybe set a default message here, once we've decided on error handling.
+          ...base,
+          nexusHandlerFailureInfo: {
+            type: err.type,
+            retryBehavior,
+          },
+        };
+      }
+      if (err instanceof NexusOperationFailure) {
+        return {
+          // TODO(nexus/error): Maybe set a default message here, once we've decided on error handling.
+          ...base,
+          nexusOperationExecutionFailureInfo: {
+            scheduledEventId: err.scheduledEventId ? Long.fromNumber(err.scheduledEventId) : undefined,
+            endpoint: err.endpoint,
+            service: err.service,
+            operation: err.operation,
+            operationToken: err.operationToken,
+          },
+        };
+      }
       // Just a TemporalFailure
       return base;
     }

package/src/failure.ts

@@ -379,6 +379,28 @@ export class ChildWorkflowFailure extends TemporalFailure {
   }
 }
 
+/**
+ * Thrown when a Nexus Operation executed inside a Workflow fails.
+ *
+ * @experimental Nexus support in Temporal SDK is experimental.
+ */
+@SymbolBasedInstanceOfError('NexusOperationFailure')
+export class NexusOperationFailure extends TemporalFailure {
+  public constructor(
+    message: string | undefined,
+    public readonly scheduledEventId: number | undefined,
+    public readonly endpoint: string,
+    public readonly service: string,
+    public readonly operation: string,
+    public readonly operationToken: string | undefined,
+    cause?: Error
+  ) {
+    super(message, cause);
+  }
+}
+
+// TODO(nexus/error): Maybe add a NexusHandlerFailure class here, once we've decided on error handling.
+
 /**
  * This exception is thrown in the following cases:
  *  - Workflow with the same Workflow ID is currently running and the {@link WorkflowOptions.workflowIdConflictPolicy} is `WORKFLOW_ID_CONFLICT_POLICY_FAIL`

package/src/index.ts

@@ -8,6 +8,7 @@ import * as encoding from './encoding';
 import * as helpers from './type-helpers';
 
 export * from './activity-options';
+export { ActivityCancellationDetailsOptions, ActivityCancellationDetails } from './activity-cancellation-details';
 export * from './converter/data-converter';
 export * from './converter/failure-converter';
 export * from './converter/payload-codec';

package/src/internal-non-workflow/codec-helpers.ts

@@ -1,9 +1,16 @@
+import type { temporal } from '@temporalio/proto';
 import { Payload } from '../interfaces';
-import { arrayFromPayloads, fromPayloadsAtIndex, PayloadConverter, toPayloads } from '../converter/payload-converter';
+import {
+  arrayFromPayloads,
+  convertOptionalToPayload,
+  fromPayloadsAtIndex,
+  toPayloads,
+} from '../converter/payload-converter';
 import { PayloadConverterError } from '../errors';
 import { PayloadCodec } from '../converter/payload-codec';
 import { ProtoFailure } from '../failure';
 import { LoadedDataConverter } from '../converter/data-converter';
+import { UserMetadata } from '../user-metadata';
 import { DecodedPayload, DecodedProtoFailure, EncodedPayload, EncodedProtoFailure } from './codec-types';
 
 /**
@@ -359,3 +366,32 @@ export function noopDecodeMap<K extends string>(
 ): Record<K, DecodedPayload> | null | undefined {
   return map as Record<K, DecodedPayload> | null | undefined;
 }
+
+export async function encodeUserMetadata(
+  dataConverter: LoadedDataConverter,
+  staticSummary: string | undefined,
+  staticDetails: string | undefined
+): Promise<temporal.api.sdk.v1.IUserMetadata | undefined> {
+  if (staticSummary == null && staticDetails == null) return undefined;
+
+  const { payloadConverter, payloadCodecs } = dataConverter;
+  const summary = await encodeOptionalSingle(payloadCodecs, convertOptionalToPayload(payloadConverter, staticSummary));
+  const details = await encodeOptionalSingle(payloadCodecs, convertOptionalToPayload(payloadConverter, staticDetails));
+
+  if (summary == null && details == null) return undefined;
+
+  return { summary, details };
+}
+
+export async function decodeUserMetadata(
+  dataConverter: LoadedDataConverter,
+  metadata: temporal.api.sdk.v1.IUserMetadata | undefined | null
+): Promise<UserMetadata> {
+  const res = { staticSummary: undefined, staticDetails: undefined };
+  if (metadata == null) return res;
+
+  const staticSummary = (await decodeOptionalSinglePayload<string>(dataConverter, metadata.summary)) ?? undefined;
+  const staticDetails = (await decodeOptionalSinglePayload<string>(dataConverter, metadata.details)) ?? undefined;
+
+  return { staticSummary, staticDetails };
+}

package/src/internal-non-workflow/codec-types.ts

@@ -23,7 +23,7 @@ export type ReplaceNested<T, ToReplace, ReplaceWith> = T extends (...args: any[]
   ? T
   : [keyof T] extends [never]
     ? T
-    : T extends Record<string, string> // Special exception for nexusHeader.
+    : T extends Record<string, string> // Special exception for Nexus Headers.
       ? T
       : T extends { [k: string]: ToReplace }
         ? {

package/src/logger.ts

@@ -38,6 +38,12 @@ export enum SdkComponent {
    */
   activity = 'activity',
 
+  /**
+   * Component name for messages emited from a Nexus Operation Handler, using the Nexus context logger.
+   * The SDK itself never publishes messages with this component name.
+   */
+  nexus = 'nexus',
+
   /**
    * Component name for messages emited from a Temporal Worker instance.
    *

package/src/priority.ts

@@ -11,7 +11,8 @@ import type { temporal } from '@temporalio/proto';
  * calling workflow, then use the default (documented on the field).
  * The overall semantics of Priority are:
  * 1. First, consider "priority_key": lower number goes first.
- * (more will be added here later)
+ * 2. Then, consider fairness: the fairness mechanism attempts to dispatch tasks for a given key in
+ *    proportion to its weight.
  */
 export interface Priority {
   /**
@@ -26,13 +27,43 @@ export interface Priority {
    * The default priority is (min+max)/2. With the default max of 5 and min of 1, that comes out to 3.
    */
   priorityKey?: number;
+
+  /**
+   * FairnessKey is a short string that's used as a key for a fairness
+   * balancing mechanism. It may correspond to a tenant id, or to a fixed
+   * string like "high" or "low". The default is the empty string.
+   *
+   * The fairness mechanism attempts to dispatch tasks for a given key in
+   * proportion to its weight. For example, using a thousand distinct tenant
+   * ids, each with a weight of 1.0 (the default) will result in each tenant
+   * getting a roughly equal share of task dispatch throughput.
+   *
+   * Fairness keys are limited to 64 bytes.
+   */
+  fairnessKey?: string;
+
+  /**
+   * FairnessWeight for a task can come from multiple sources for
+   * flexibility. From highest to lowest precedence:
+   * 1. Weights for a small set of keys can be overridden in task queue
+   *    configuration with an API.
+   * 2. It can be attached to the workflow/activity in this field.
+   * 3. The default weight of 1.0 will be used.
+   *
+   * Weight values are clamped to the range [0.001, 1000].
+   */
+  fairnessWeight?: number;
 }
 
 /**
  * Turn a proto compatible Priority into a TS Priority
  */
 export function decodePriority(priority?: temporal.api.common.v1.IPriority | null): Priority {
-  return { priorityKey: priority?.priorityKey ?? undefined };
+  return {
+    priorityKey: priority?.priorityKey ?? undefined,
+    fairnessKey: priority?.fairnessKey ?? undefined,
+    fairnessWeight: priority?.fairnessWeight ?? undefined,
+  };
 }
 
 /**
@@ -50,5 +81,7 @@ export function compilePriority(priority: Priority): temporal.api.common.v1.IPri
 
   return {
     priorityKey: priority.priorityKey ?? 0,
+    fairnessKey: priority.fairnessKey ?? '',
+    fairnessWeight: priority.fairnessWeight ?? 0,
   };
 }