@hexabot-ai/agentic 3.1.2-alpha.10 → 3.1.2-alpha.12

package/dist/cjs/index.js

@@ -19,7 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTimeout = exports.sleep = exports.toSnakeCase = exports.isSnakeCaseName = exports.assertSnakeCaseName = exports.createDeferred = exports.mergeSettings = exports.evaluateValue = exports.evaluateMapping = exports.compileValue = exports.NonDeterministicWorkflowError = exports.StepType = exports.WorkflowRunner = exports.WorkflowEventEmitter = exports.Workflow = exports.compileWorkflow = exports.WORKFLOW_RUN_STATUSES = exports.EWorkflowRunStatus = exports.BaseWorkflowContext = exports.defineAction = exports.AbstractAction = void 0;
+exports.remapWorkflowDefinitionResourceRefs = exports.collectWorkflowDefinitionResourceRefs = exports.withTimeout = exports.sleep = exports.toSnakeCase = exports.isSnakeCaseName = exports.assertSnakeCaseName = exports.createDeferred = exports.mergeSettings = exports.evaluateValue = exports.evaluateMapping = exports.compileValue = exports.NonDeterministicWorkflowError = exports.StepType = exports.WorkflowRunner = exports.WorkflowEventEmitter = exports.Workflow = exports.compileWorkflow = exports.WORKFLOW_RUN_STATUSES = exports.EWorkflowRunStatus = exports.BaseWorkflowContext = exports.defineAction = exports.AbstractAction = void 0;
 var abstract_action_1 = require("./action/abstract-action");
 Object.defineProperty(exports, "AbstractAction", { enumerable: true, get: function () { return abstract_action_1.AbstractAction; } });
 var action_1 = require("./action/action");
@@ -52,3 +52,6 @@ Object.defineProperty(exports, "toSnakeCase", { enumerable: true, get: function
 var timeout_1 = require("./utils/timeout");
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return timeout_1.sleep; } });
 Object.defineProperty(exports, "withTimeout", { enumerable: true, get: function () { return timeout_1.withTimeout; } });
+var workflow_definition_resources_1 = require("./utils/workflow-definition-resources");
+Object.defineProperty(exports, "collectWorkflowDefinitionResourceRefs", { enumerable: true, get: function () { return workflow_definition_resources_1.collectWorkflowDefinitionResourceRefs; } });
+Object.defineProperty(exports, "remapWorkflowDefinitionResourceRefs", { enumerable: true, get: function () { return workflow_definition_resources_1.remapWorkflowDefinitionResourceRefs; } });

package/dist/cjs/utils/workflow-definition-resources.js

@@ -0,0 +1,73 @@
+"use strict";
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remapWorkflowDefinitionResourceRefs = exports.collectWorkflowDefinitionResourceRefs = void 0;
+const getSettingsRef = (definition, settingsKey) => {
+    const settings = definition.settings;
+    if (!settings || typeof settings !== 'object') {
+        return null;
+    }
+    const value = settings[settingsKey];
+    return typeof value === 'string' && value.trim() ? value : null;
+};
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+const collectWorkflowDefinitionResourceRefs = (definition, descriptors) => {
+    const result = Object.fromEntries(descriptors.map((descriptor) => [descriptor.kind, new Set()]));
+    for (const def of Object.values(definition.defs ?? {})) {
+        for (const descriptor of descriptors) {
+            if (def.kind !== descriptor.kind) {
+                continue;
+            }
+            const ref = getSettingsRef(def, descriptor.settingsKey);
+            if (ref) {
+                result[descriptor.kind].add(ref);
+            }
+        }
+    }
+    return Object.fromEntries(Object.entries(result).map(([kind, refs]) => [kind, Array.from(refs)]));
+};
+exports.collectWorkflowDefinitionResourceRefs = collectWorkflowDefinitionResourceRefs;
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+const remapWorkflowDefinitionResourceRefs = (definition, descriptors, idMaps) => {
+    let didChange = false;
+    const nextDefs = Object.fromEntries(Object.entries(definition.defs ?? {}).map(([defName, def]) => {
+        const descriptor = descriptors.find((item) => item.kind === def.kind);
+        if (!descriptor) {
+            return [defName, def];
+        }
+        const currentRef = getSettingsRef(def, descriptor.settingsKey);
+        const nextRef = currentRef
+            ? idMaps[descriptor.kind]?.[currentRef]
+            : undefined;
+        if (!currentRef || !nextRef || nextRef === currentRef) {
+            return [defName, def];
+        }
+        didChange = true;
+        return [
+            defName,
+            {
+                ...def,
+                settings: {
+                    ...(def.settings ?? {}),
+                    [descriptor.settingsKey]: nextRef,
+                },
+            },
+        ];
+    }));
+    if (!didChange) {
+        return definition;
+    }
+    return {
+        ...definition,
+        defs: nextDefs,
+    };
+};
+exports.remapWorkflowDefinitionResourceRefs = remapWorkflowDefinitionResourceRefs;

package/dist/esm/index.js

@@ -14,3 +14,4 @@ export { compileValue, evaluateMapping, evaluateValue, mergeSettings, } from './
 export { createDeferred } from './utils/deferred';
 export { assertSnakeCaseName, isSnakeCaseName, toSnakeCase, } from './utils/naming';
 export { sleep, withTimeout } from './utils/timeout';
+export { collectWorkflowDefinitionResourceRefs, remapWorkflowDefinitionResourceRefs, } from './utils/workflow-definition-resources';

package/dist/esm/utils/workflow-definition-resources.js

@@ -0,0 +1,68 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+const getSettingsRef = (definition, settingsKey) => {
+    const settings = definition.settings;
+    if (!settings || typeof settings !== 'object') {
+        return null;
+    }
+    const value = settings[settingsKey];
+    return typeof value === 'string' && value.trim() ? value : null;
+};
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+export const collectWorkflowDefinitionResourceRefs = (definition, descriptors) => {
+    const result = Object.fromEntries(descriptors.map((descriptor) => [descriptor.kind, new Set()]));
+    for (const def of Object.values(definition.defs ?? {})) {
+        for (const descriptor of descriptors) {
+            if (def.kind !== descriptor.kind) {
+                continue;
+            }
+            const ref = getSettingsRef(def, descriptor.settingsKey);
+            if (ref) {
+                result[descriptor.kind].add(ref);
+            }
+        }
+    }
+    return Object.fromEntries(Object.entries(result).map(([kind, refs]) => [kind, Array.from(refs)]));
+};
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+export const remapWorkflowDefinitionResourceRefs = (definition, descriptors, idMaps) => {
+    let didChange = false;
+    const nextDefs = Object.fromEntries(Object.entries(definition.defs ?? {}).map(([defName, def]) => {
+        const descriptor = descriptors.find((item) => item.kind === def.kind);
+        if (!descriptor) {
+            return [defName, def];
+        }
+        const currentRef = getSettingsRef(def, descriptor.settingsKey);
+        const nextRef = currentRef
+            ? idMaps[descriptor.kind]?.[currentRef]
+            : undefined;
+        if (!currentRef || !nextRef || nextRef === currentRef) {
+            return [defName, def];
+        }
+        didChange = true;
+        return [
+            defName,
+            {
+                ...def,
+                settings: {
+                    ...(def.settings ?? {}),
+                    [descriptor.settingsKey]: nextRef,
+                },
+            },
+        ];
+    }));
+    if (!didChange) {
+        return definition;
+    }
+    return {
+        ...definition,
+        defs: nextDefs,
+    };
+};

package/dist/types/index.d.ts

@@ -15,4 +15,5 @@ export { createDeferred } from './utils/deferred';
 export type { Deferred } from './utils/deferred';
 export { assertSnakeCaseName, isSnakeCaseName, toSnakeCase, } from './utils/naming';
 export { sleep, withTimeout } from './utils/timeout';
+export { collectWorkflowDefinitionResourceRefs, remapWorkflowDefinitionResourceRefs, type WorkflowDefinitionResourceDescriptor, type WorkflowDefinitionResourceIdMaps, type WorkflowDefinitionResourceRefs, } from './utils/workflow-definition-resources';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,qCAAqC,EACrC,mCAAmC,EACnC,KAAK,oCAAoC,EACzC,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,GACpC,MAAM,uCAAuC,CAAC"}

package/dist/types/utils/workflow-definition-resources.d.ts

@@ -0,0 +1,16 @@
+import type { WorkflowDefinition } from '../dsl.types';
+export type WorkflowDefinitionResourceDescriptor = {
+    kind: string;
+    settingsKey: string;
+};
+export type WorkflowDefinitionResourceRefs = Record<string, string[]>;
+export type WorkflowDefinitionResourceIdMaps = Record<string, Record<string, string>>;
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+export declare const collectWorkflowDefinitionResourceRefs: (definition: WorkflowDefinition, descriptors: WorkflowDefinitionResourceDescriptor[]) => WorkflowDefinitionResourceRefs;
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+export declare const remapWorkflowDefinitionResourceRefs: (definition: WorkflowDefinition, descriptors: WorkflowDefinitionResourceDescriptor[], idMaps: WorkflowDefinitionResourceIdMaps) => WorkflowDefinition;
+//# sourceMappingURL=workflow-definition-resources.d.ts.map

package/dist/types/utils/workflow-definition-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definition-resources.d.ts","sourceRoot":"","sources":["../../../src/utils/workflow-definition-resources.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtE,MAAM,MAAM,gCAAgC,GAAG,MAAM,CACnD,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACvB,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,qCAAqC,GAChD,YAAY,kBAAkB,EAC9B,aAAa,oCAAoC,EAAE,KAClD,8BAqBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC,GAC9C,YAAY,kBAAkB,EAC9B,aAAa,oCAAoC,EAAE,EACnD,QAAQ,gCAAgC,KACvC,kBAwCF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexabot-ai/agentic",
-  "version": "3.1.2-alpha.10",
+  "version": "3.1.2-alpha.12",
   "description": "Schemas and utilities for the Hexabot agentic workflow DSL.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/__tests__/workflow-definition-resources.test.ts

@@ -0,0 +1,97 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import type { WorkflowDefinition } from '../dsl.types';
+import {
+  collectWorkflowDefinitionResourceRefs,
+  remapWorkflowDefinitionResourceRefs,
+  type WorkflowDefinitionResourceDescriptor,
+} from '../utils/workflow-definition-resources';
+
+const descriptors: WorkflowDefinitionResourceDescriptor[] = [
+  { kind: 'memory', settingsKey: 'definition_id' },
+  { kind: 'mcp', settingsKey: 'server_id' },
+];
+const definition: WorkflowDefinition = {
+  defs: {
+    profile_memory: {
+      kind: 'memory',
+      settings: {
+        definition_id: 'memory-1',
+      },
+    },
+    duplicate_profile_memory: {
+      kind: 'memory',
+      settings: {
+        definition_id: 'memory-1',
+      },
+    },
+    search_mcp: {
+      kind: 'mcp',
+      settings: {
+        server_id: 'mcp-1',
+      },
+    },
+    greet: {
+      kind: 'task',
+      action: 'send_message',
+      bindings: {
+        memory: ['profile_memory'],
+        mcp: ['search_mcp'],
+      },
+    },
+  },
+  flow: [{ do: 'greet' }],
+  outputs: { result: '=$output.greet' },
+};
+
+describe('workflow definition resource helpers', () => {
+  it('collects unique resource references by descriptor kind', () => {
+    expect(
+      collectWorkflowDefinitionResourceRefs(definition, descriptors),
+    ).toEqual({
+      memory: ['memory-1'],
+      mcp: ['mcp-1'],
+    });
+  });
+
+  it('remaps resource references without mutating the original definition', () => {
+    const updated = remapWorkflowDefinitionResourceRefs(
+      definition,
+      descriptors,
+      {
+        memory: { 'memory-1': 'memory-local' },
+        mcp: { 'mcp-1': 'mcp-local' },
+      },
+    );
+
+    expect(updated).not.toBe(definition);
+    expect(updated.defs.profile_memory.settings).toEqual({
+      definition_id: 'memory-local',
+    });
+    expect(updated.defs.duplicate_profile_memory.settings).toEqual({
+      definition_id: 'memory-local',
+    });
+    expect(updated.defs.search_mcp.settings).toEqual({
+      server_id: 'mcp-local',
+    });
+    expect(definition.defs.profile_memory.settings).toEqual({
+      definition_id: 'memory-1',
+    });
+    expect(definition.defs.search_mcp.settings).toEqual({
+      server_id: 'mcp-1',
+    });
+  });
+
+  it('returns the original definition when no refs change', () => {
+    expect(
+      remapWorkflowDefinitionResourceRefs(definition, descriptors, {
+        memory: {},
+        mcp: {},
+      }),
+    ).toBe(definition);
+  });
+});

package/src/index.ts

@@ -114,3 +114,11 @@ export {
 } from './utils/naming';
 
 export { sleep, withTimeout } from './utils/timeout';
+
+export {
+  collectWorkflowDefinitionResourceRefs,
+  remapWorkflowDefinitionResourceRefs,
+  type WorkflowDefinitionResourceDescriptor,
+  type WorkflowDefinitionResourceIdMaps,
+  type WorkflowDefinitionResourceRefs,
+} from './utils/workflow-definition-resources';

package/src/utils/workflow-definition-resources.ts

@@ -0,0 +1,111 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import type { DefDefinition, WorkflowDefinition } from '../dsl.types';
+
+export type WorkflowDefinitionResourceDescriptor = {
+  kind: string;
+  settingsKey: string;
+};
+
+export type WorkflowDefinitionResourceRefs = Record<string, string[]>;
+
+export type WorkflowDefinitionResourceIdMaps = Record<
+  string,
+  Record<string, string>
+>;
+
+const getSettingsRef = (
+  definition: DefDefinition,
+  settingsKey: string,
+): string | null => {
+  const settings = definition.settings;
+  if (!settings || typeof settings !== 'object') {
+    return null;
+  }
+
+  const value = (settings as Record<string, unknown>)[settingsKey];
+
+  return typeof value === 'string' && value.trim() ? value : null;
+};
+
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+export const collectWorkflowDefinitionResourceRefs = (
+  definition: WorkflowDefinition,
+  descriptors: WorkflowDefinitionResourceDescriptor[],
+): WorkflowDefinitionResourceRefs => {
+  const result = Object.fromEntries(
+    descriptors.map((descriptor) => [descriptor.kind, new Set<string>()]),
+  ) as Record<string, Set<string>>;
+
+  for (const def of Object.values(definition.defs ?? {})) {
+    for (const descriptor of descriptors) {
+      if (def.kind !== descriptor.kind) {
+        continue;
+      }
+
+      const ref = getSettingsRef(def, descriptor.settingsKey);
+      if (ref) {
+        result[descriptor.kind].add(ref);
+      }
+    }
+  }
+
+  return Object.fromEntries(
+    Object.entries(result).map(([kind, refs]) => [kind, Array.from(refs)]),
+  );
+};
+
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+export const remapWorkflowDefinitionResourceRefs = (
+  definition: WorkflowDefinition,
+  descriptors: WorkflowDefinitionResourceDescriptor[],
+  idMaps: WorkflowDefinitionResourceIdMaps,
+): WorkflowDefinition => {
+  let didChange = false;
+  const nextDefs = Object.fromEntries(
+    Object.entries(definition.defs ?? {}).map(([defName, def]) => {
+      const descriptor = descriptors.find((item) => item.kind === def.kind);
+      if (!descriptor) {
+        return [defName, def];
+      }
+
+      const currentRef = getSettingsRef(def, descriptor.settingsKey);
+      const nextRef = currentRef
+        ? idMaps[descriptor.kind]?.[currentRef]
+        : undefined;
+      if (!currentRef || !nextRef || nextRef === currentRef) {
+        return [defName, def];
+      }
+
+      didChange = true;
+
+      return [
+        defName,
+        {
+          ...def,
+          settings: {
+            ...(def.settings ?? {}),
+            [descriptor.settingsKey]: nextRef,
+          },
+        },
+      ];
+    }),
+  ) as WorkflowDefinition['defs'];
+
+  if (!didChange) {
+    return definition;
+  }
+
+  return {
+    ...definition,
+    defs: nextDefs,
+  };
+};