@decaf-ts/integrations 0.3.8 → 0.3.10

package/lib/esm/secrets/vault/VaultSecretServiceConfig.js

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVmF1bHRTZWNyZXRTZXJ2aWNlQ29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NlY3JldHMvdmF1bHQvVmF1bHRTZWNyZXRTZXJ2aWNlQ29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL3NlY3JldHMvdmF1bHQvY29uZmlnXG4gKiBAc3VtbWFyeSBWYXVsdCBzZWNyZXQgc2VydmljZSBjb25maWd1cmF0aW9uLlxuICogQGRlc2NyaXB0aW9uIENvbmZpZ3VyYXRpb24gc2NoZW1hIGZvciB0aGUgSGFzaGlDb3JwIFZhdWx0IEtWIHYyIGludGVncmF0aW9uLlxuICovXG5pbXBvcnQgeyBTZWNyZXRTZXJ2aWNlQ29uZmlnIH0gZnJvbSBcIi4uLy4uL3NlY3JldHMvY29yZVwiO1xuXG5leHBvcnQgaW50ZXJmYWNlIFZhdWx0U2VjcmV0U2VydmljZUNvbmZpZyBleHRlbmRzIFNlY3JldFNlcnZpY2VDb25maWcge1xuICBwcm92aWRlcjogXCJoYXNoaWNvcnAtdmF1bHRcIjtcbiAgYWRkcmVzczogc3RyaW5nO1xuICB0b2tlbjogc3RyaW5nO1xuICBwYXRoOiBzdHJpbmc7XG4gIG5hbWVzcGFjZT86IHN0cmluZztcbn1cbiJdfQ==
+//# sourceMappingURL=VaultSecretServiceConfig.js.map

package/lib/esm/secrets/vault/VaultSecretServiceConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VaultSecretServiceConfig.js","sourceRoot":"","sources":["../../../../src/secrets/vault/VaultSecretServiceConfig.ts"],"names":[],"mappings":""}

package/lib/esm/secrets/vault/index.js

@@ -5,4 +5,4 @@
  */
 export * from "./VaultSecretService.js";
 export * from "./VaultSecretServiceConfig.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2VjcmV0cy92YXVsdC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsd0NBQXFDO0FBQ3JDLDhDQUEyQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvc2VjcmV0cy92YXVsdFxuICogQHN1bW1hcnkgSGFzaGlDb3JwIFZhdWx0IHNlY3JldCBzZXJ2aWNlIGV4cG9ydHMuXG4gKiBAZGVzY3JpcHRpb24gUmUtZXhwb3J0cyB0aGUgVmF1bHQgS1YgdjIgc2VydmljZSBhbmQgaXRzIGNvbmZpZ3VyYXRpb24uXG4gKi9cbmV4cG9ydCAqIGZyb20gXCIuL1ZhdWx0U2VjcmV0U2VydmljZVwiO1xuZXhwb3J0ICogZnJvbSBcIi4vVmF1bHRTZWNyZXRTZXJ2aWNlQ29uZmlnXCI7XG4iXX0=
+//# sourceMappingURL=index.js.map

package/lib/esm/secrets/vault/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/secrets/vault/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wCAAqC;AACrC,8CAA2C"}

package/lib/esm/shared/runtime.js

@@ -18,4 +18,4 @@ export function responseBodyAsText(value) {
         return String(value ?? "");
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVudGltZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zaGFyZWQvcnVudGltZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLFVBQVUsYUFBYSxDQUFJLEtBQWM7SUFDN0MsSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRO1FBQUUsT0FBTyxLQUFzQixDQUFDO0lBQzdELElBQUksQ0FBQztRQUNILE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQU0sQ0FBQztJQUNoQyxDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztBQUNILENBQUM7QUFFRCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsS0FBYztJQUMvQyxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVE7UUFBRSxPQUFPLEtBQUssQ0FBQztJQUM1QyxJQUFJLENBQUM7UUFDSCxPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3JDLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLE1BQU0sQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDLENBQUM7SUFDN0IsQ0FBQztBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgZnVuY3Rpb24gcGFyc2VKc29uQm9keTxUPih2YWx1ZTogdW5rbm93bik6IFQgfCB1bmRlZmluZWQge1xuICBpZiAodHlwZW9mIHZhbHVlICE9PSBcInN0cmluZ1wiKSByZXR1cm4gdmFsdWUgYXMgVCB8IHVuZGVmaW5lZDtcbiAgdHJ5IHtcbiAgICByZXR1cm4gSlNPTi5wYXJzZSh2YWx1ZSkgYXMgVDtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgfVxufVxuXG5leHBvcnQgZnVuY3Rpb24gcmVzcG9uc2VCb2R5QXNUZXh0KHZhbHVlOiB1bmtub3duKTogc3RyaW5nIHtcbiAgaWYgKHR5cGVvZiB2YWx1ZSA9PT0gXCJzdHJpbmdcIikgcmV0dXJuIHZhbHVlO1xuICB0cnkge1xuICAgIHJldHVybiBKU09OLnN0cmluZ2lmeSh2YWx1ZSA/PyBcIlwiKTtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIFN0cmluZyh2YWx1ZSA/PyBcIlwiKTtcbiAgfVxufVxuIl19
+//# sourceMappingURL=runtime.js.map

package/lib/esm/shared/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/shared/runtime.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAI,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAsB,CAAC;IAC7D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/lib/esm/utils.js

@@ -36,4 +36,4 @@ export async function execWithLogging(command, options, log, level = LogLevel.in
         });
     });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQUNILE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDckMsT0FBTyxFQUFVLFFBQVEsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ3JELE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUV4RCxNQUFNLENBQUMsS0FBSyxVQUFVLGVBQWUsQ0FDbkMsT0FBZSxFQUNmLE9BQXdCLEVBQ3hCLEdBQVcsRUFDWCxRQUFrQixRQUFRLENBQUMsSUFBSTtJQUUvQixHQUFHLENBQUMsS0FBSyxDQUFDLGNBQWMsT0FBTyxFQUFFLENBQUMsQ0FBQztJQUVuQyxPQUFPLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1FBQ3JDLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFFckMsTUFBTSxNQUFNLEdBQWEsRUFBRSxDQUFDO1FBQzVCLE1BQU0sTUFBTSxHQUFhLEVBQUUsQ0FBQztRQUU1QixLQUFLLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxJQUFZLEVBQUUsRUFBRTtZQUN4QyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ2xCLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUMxQixDQUFDLENBQUMsQ0FBQztRQUVILEtBQUssQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLE1BQU0sRUFBRSxDQUFDLElBQVksRUFBRSxFQUFFO1lBQ3hDLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7WUFDbEIsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUN6QixDQUFDLENBQUMsQ0FBQztRQUVILEtBQUssQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLENBQUMsSUFBWSxFQUFFLEVBQUU7WUFDakMsSUFBSSxJQUFJLEtBQUssQ0FBQyxFQUFFLENBQUM7Z0JBQ2YsR0FBRyxDQUFDLEtBQUssQ0FBQyxnQ0FBZ0MsQ0FBQyxDQUFDO2dCQUM1QyxPQUFPLENBQUMsRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUM7WUFDcEUsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLEdBQUcsQ0FBQyxRQUFRLENBQ1YsNEJBQTRCLElBQUksT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQzNELENBQUM7Z0JBQ0YsTUFBTSxDQUNKLElBQUksYUFBYSxDQUNmLDRCQUE0QixJQUFJLEtBQUssTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUN6RCxDQUNGLENBQUM7WUFDSixDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUM7UUFFSCxLQUFLLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxDQUFDLEdBQVUsRUFBRSxFQUFFO1lBQy9CLEdBQUcsQ0FBQyxRQUFRLENBQUMseUJBQXlCLEVBQUUsR0FBRyxDQUFDLENBQUM7WUFDN0MsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ2QsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL3V0aWxzXG4gKiBAc3VtbWFyeSBTaGFyZWQgaW50ZWdyYXRpb24gdXRpbGl0aWVzLlxuICogQGRlc2NyaXB0aW9uIFV0aWxpdHkgaGVscGVycyB1c2VkIGFjcm9zcyB0aGUgaW50ZWdyYXRpb25zIHBhY2thZ2UuXG4gKi9cbmltcG9ydCB7IGV4ZWMgfSBmcm9tIFwiY2hpbGRfcHJvY2Vzc1wiO1xuaW1wb3J0IHsgTG9nZ2VyLCBMb2dMZXZlbCB9IGZyb20gXCJAZGVjYWYtdHMvbG9nZ2luZ1wiO1xuaW1wb3J0IHsgSW50ZXJuYWxFcnJvciB9IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZXhlY1dpdGhMb2dnaW5nKFxuICBjb21tYW5kOiBzdHJpbmcsXG4gIG9wdGlvbnM6IHsgY3dkOiBzdHJpbmcgfSxcbiAgbG9nOiBMb2dnZXIsXG4gIGxldmVsOiBMb2dMZXZlbCA9IExvZ0xldmVsLmluZm9cbik6IFByb21pc2U8eyBzdGRvdXQ6IHN0cmluZzsgc3RkZXJyOiBzdHJpbmcgfT4ge1xuICBsb2cuZGVidWcoYEV4ZWN1dGluZzogJHtjb21tYW5kfWApO1xuXG4gIHJldHVybiBuZXcgUHJvbWlzZSgocmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgY29uc3QgY2hpbGQgPSBleGVjKGNvbW1hbmQsIG9wdGlvbnMpO1xuXG4gICAgY29uc3Qgc3Rkb3V0OiBzdHJpbmdbXSA9IFtdO1xuICAgIGNvbnN0IHN0ZGVycjogc3RyaW5nW10gPSBbXTtcblxuICAgIGNoaWxkLnN0ZG91dD8ub24oXCJkYXRhXCIsIChkYXRhOiBzdHJpbmcpID0+IHtcbiAgICAgIHN0ZG91dC5wdXNoKGRhdGEpO1xuICAgICAgbG9nW2xldmVsXShkYXRhLnRyaW0oKSk7XG4gICAgfSk7XG5cbiAgICBjaGlsZC5zdGRlcnI/Lm9uKFwiZGF0YVwiLCAoZGF0YTogc3RyaW5nKSA9PiB7XG4gICAgICBzdGRlcnIucHVzaChkYXRhKTtcbiAgICAgIGxvZy5kZWJ1ZyhkYXRhLnRyaW0oKSk7XG4gICAgfSk7XG5cbiAgICBjaGlsZC5vbihcImNsb3NlXCIsIChjb2RlOiBudW1iZXIpID0+IHtcbiAgICAgIGlmIChjb2RlID09PSAwKSB7XG4gICAgICAgIGxvZy5zaWxseShgQ29tbWFuZCBjb21wbGV0ZWQgc3VjY2Vzc2Z1bGx5YCk7XG4gICAgICAgIHJlc29sdmUoeyBzdGRvdXQ6IHN0ZG91dC5qb2luKFwiXFxuXCIpLCBzdGRlcnI6IHN0ZGVyci5qb2luKFwiXFxuXCIpIH0pO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgbG9nLmNyaXRpY2FsKFxuICAgICAgICAgIGBDb21tYW5kIGZhaWxlZCB3aXRoIGNvZGUgJHtjb2RlfTpcXG4gJHtzdGRlcnIuam9pbihcIlxcblwiKX1gXG4gICAgICAgICk7XG4gICAgICAgIHJlamVjdChcbiAgICAgICAgICBuZXcgSW50ZXJuYWxFcnJvcihcbiAgICAgICAgICAgIGBDb21tYW5kIGZhaWxlZCB3aXRoIGNvZGUgJHtjb2RlfTogJHtzdGRlcnIuam9pbihcIlxcblwiKX1gXG4gICAgICAgICAgKVxuICAgICAgICApO1xuICAgICAgfVxuICAgIH0pO1xuXG4gICAgY2hpbGQub24oXCJlcnJvclwiLCAoZXJyOiBFcnJvcikgPT4ge1xuICAgICAgbG9nLmNyaXRpY2FsKGBDb21tYW5kIGV4ZWN1dGlvbiBlcnJvcmAsIGVycik7XG4gICAgICByZWplY3QoZXJyKTtcbiAgICB9KTtcbiAgfSk7XG59XG4iXX0=
+//# sourceMappingURL=utils.js.map

package/lib/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAU,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,OAAwB,EACxB,GAAW,EACX,QAAkB,QAAQ,CAAC,IAAI;IAE/B,GAAG,CAAC,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IAEnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAErC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE;YACjC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,QAAQ,CACV,4BAA4B,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;gBACF,MAAM,CACJ,IAAI,aAAa,CACf,4BAA4B,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzD,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC/B,GAAG,CAAC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/types/graph/engine/constants.d.cts

@@ -0,0 +1,59 @@
+/**
+ * @module integrations/graph/engine/constants
+ * @summary Graph execution engine-private constants and enums.
+ * @description Engine-only constants, default limits, and enumerations.
+ * Frontend-safe enums (`GraphExecutionStatus`, `GraphExecutionEventType`)
+ * live in `../shared/constants`; engine modules import shared symbols from
+ * there and engine-private symbols from here.
+ */
+/**
+ * Boundary identifier used as the node id for workflow-level input/output ports.
+ */
+export declare const GRAPH_WORKFLOW_BOUNDARY = "$workflow";
+/**
+ * Default concurrency for parallel node execution within a layer.
+ */
+export declare const GRAPH_DEFAULT_CONCURRENCY = 4;
+/**
+ * Default maximum iterations for `while` and `until` loop nodes.
+ */
+export declare const GRAPH_DEFAULT_MAX_LOOP_ITERATIONS = 100;
+/**
+ * Default maximum iterations for `foreach` loop nodes.
+ */
+export declare const GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS = 1000;
+/**
+ * Metadata key under which pinning information is stored on a graph node.
+ */
+export declare const GRAPH_PINNING_METADATA_KEY = "graph.pinnable";
+/**
+ * Pinning strategy determining when values are pinned.
+ */
+export declare enum GraphPinningStrategy {
+    MANUAL = "manual",
+    AUTOMATIC = "automatic",
+    DISABLED = "disabled"
+}
+/**
+ * Built-in condition types supported by the loop condition evaluator.
+ */
+export declare enum GraphConditionType {
+    TRUTHY = "truthy",
+    FALSY = "falsy",
+    EQUALS = "equals",
+    NOT_EQUALS = "notEquals",
+    GREATER_THAN = "greaterThan",
+    GREATER_THAN_OR_EQUAL = "greaterThanOrEqual",
+    LESS_THAN = "lessThan",
+    LESS_THAN_OR_EQUAL = "lessThanOrEqual",
+    EXISTS = "exists",
+    CUSTOM = "custom"
+}
+/**
+ * Loop node kinds recognised by the engine.
+ */
+export declare const GRAPH_LOOP_KIND: {
+    readonly FOREACH: "core.loop.foreach";
+    readonly WHILE: "core.loop.while";
+    readonly UNTIL: "core.loop.until";
+};

package/lib/types/graph/engine/constants.d.mts

@@ -0,0 +1,59 @@
+/**
+ * @module integrations/graph/engine/constants
+ * @summary Graph execution engine-private constants and enums.
+ * @description Engine-only constants, default limits, and enumerations.
+ * Frontend-safe enums (`GraphExecutionStatus`, `GraphExecutionEventType`)
+ * live in `../shared/constants`; engine modules import shared symbols from
+ * there and engine-private symbols from here.
+ */
+/**
+ * Boundary identifier used as the node id for workflow-level input/output ports.
+ */
+export declare const GRAPH_WORKFLOW_BOUNDARY = "$workflow";
+/**
+ * Default concurrency for parallel node execution within a layer.
+ */
+export declare const GRAPH_DEFAULT_CONCURRENCY = 4;
+/**
+ * Default maximum iterations for `while` and `until` loop nodes.
+ */
+export declare const GRAPH_DEFAULT_MAX_LOOP_ITERATIONS = 100;
+/**
+ * Default maximum iterations for `foreach` loop nodes.
+ */
+export declare const GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS = 1000;
+/**
+ * Metadata key under which pinning information is stored on a graph node.
+ */
+export declare const GRAPH_PINNING_METADATA_KEY = "graph.pinnable";
+/**
+ * Pinning strategy determining when values are pinned.
+ */
+export declare enum GraphPinningStrategy {
+    MANUAL = "manual",
+    AUTOMATIC = "automatic",
+    DISABLED = "disabled"
+}
+/**
+ * Built-in condition types supported by the loop condition evaluator.
+ */
+export declare enum GraphConditionType {
+    TRUTHY = "truthy",
+    FALSY = "falsy",
+    EQUALS = "equals",
+    NOT_EQUALS = "notEquals",
+    GREATER_THAN = "greaterThan",
+    GREATER_THAN_OR_EQUAL = "greaterThanOrEqual",
+    LESS_THAN = "lessThan",
+    LESS_THAN_OR_EQUAL = "lessThanOrEqual",
+    EXISTS = "exists",
+    CUSTOM = "custom"
+}
+/**
+ * Loop node kinds recognised by the engine.
+ */
+export declare const GRAPH_LOOP_KIND: {
+    readonly FOREACH: "core.loop.foreach";
+    readonly WHILE: "core.loop.while";
+    readonly UNTIL: "core.loop.until";
+};

package/lib/types/graph/{execution → engine/execution}/GraphExecutionResult.d.cts

@@ -5,7 +5,7 @@
  */
 import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.cts";
 import type { GraphExecutionResult, GraphExecutionValues } from "../types.d.cts";
-import type { GraphExecutionStatus } from "../constants.d.cts";
+import type { GraphExecutionStatus } from "../../shared/constants.d.cts";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
 /**
  * Builds a {@link GraphExecutionResult} from a completed frame.

package/lib/types/graph/{execution → engine/execution}/GraphExecutionResult.d.mts

@@ -5,7 +5,7 @@
  */
 import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.mts";
 import type { GraphExecutionResult, GraphExecutionValues } from "../types.d.mts";
-import type { GraphExecutionStatus } from "../constants.d.mts";
+import type { GraphExecutionStatus } from "../../shared/constants.d.mts";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
 /**
  * Builds a {@link GraphExecutionResult} from a completed frame.

package/lib/types/graph/engine/index.d.cts

@@ -0,0 +1,61 @@
+/**
+ * @module integrations/graph/engine
+ * @summary Graph execution engine (backend-only).
+ * @description Reference interpreter for Decaf graph workflows. Executes
+ * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
+ * through Decaf's Observable pipeline, supports structured loops, configurable
+ * value stores, and pinnable/cacheable nodes.
+ *
+ * Re-exports `../shared` so backend consumers have a single import surface.
+ */
+export * from "../shared/index.d.cts";
+export * from "./constants.d.cts";
+export * from "./types.d.cts";
+export * from "./decorators.d.cts";
+export * from "./errors/GraphExecutionError.d.cts";
+export * from "./errors/GraphCycleError.d.cts";
+export * from "./errors/GraphInputError.d.cts";
+export * from "./errors/GraphLoopLimitError.d.cts";
+export * from "./errors/GraphPinningError.d.cts";
+export * from "./errors/GraphPortError.d.cts";
+export * from "./errors/GraphStoreError.d.cts";
+export * from "./errors/GraphTopologyError.d.cts";
+export * from "./events/GraphExecutionEvent.d.cts";
+export * from "./events/GraphExecutionObserver.d.cts";
+export * from "./events/GraphExecutionEventEmitter.d.cts";
+export * from "./events/GraphExecutionEventFactory.d.cts";
+export * from "./execution/GraphExecutionContext.d.cts";
+export * from "./execution/GraphNodeExecutor.d.cts";
+export * from "./execution/GraphExecutionFrame.d.cts";
+export * from "./execution/GraphExecutionResult.d.cts";
+export * from "./execution/GraphExecutionEngine.d.cts";
+export * from "./execution/CodeSandboxEvaluator.d.cts";
+export * from "./execution/SwitchGraphNodeExecutor.d.cts";
+export * from "./registry/GraphNodeExecutorRegistry.d.cts";
+export * from "./registry/GraphNodeExecutorResolver.d.cts";
+export * from "./store/GraphValueKey.d.cts";
+export * from "./store/GraphCachedValue.d.cts";
+export * from "./store/GraphValueStoreAdapter.d.cts";
+export * from "./store/InMemoryGraphValueStoreAdapter.d.cts";
+export * from "./store/GraphValueStore.d.cts";
+export * from "./planning/GraphExecutionPlanNode.d.cts";
+export * from "./planning/GraphExecutionPlanEdge.d.cts";
+export * from "./planning/GraphExecutionPlanLayer.d.cts";
+export * from "./planning/GraphExecutionPlan.d.cts";
+export * from "./planning/GraphRelationResolver.d.cts";
+export * from "./planning/GraphExecutionPlanner.d.cts";
+export * from "./planning/GraphTopology.d.cts";
+export * from "./validation/GraphDefinitionValidator.d.cts";
+export * from "./validation/GraphPortSchemaResolver.d.cts";
+export * from "./validation/GraphValueValidator.d.cts";
+export * from "./loops/GraphConditionEvaluator.d.cts";
+export * from "./loops/ConditionExpressionEvaluator.d.cts";
+export * from "./loops/GraphLoopExecutionContext.d.cts";
+export * from "./loops/ForeachGraphNodeExecutor.d.cts";
+export * from "./loops/WhileGraphNodeExecutor.d.cts";
+export * from "./loops/UntilGraphNodeExecutor.d.cts";
+export * from "./pinning/GraphPinningMetadata.d.cts";
+export * from "./pinning/GraphPinningPolicy.d.cts";
+export * from "./pinning/GraphPinningDependencyResolver.d.cts";
+export * from "./pinning/GraphPinningService.d.cts";
+export * from "./snapshots/GraphExecutionSnapshotMapper.d.cts";

package/lib/types/graph/engine/index.d.mts

@@ -0,0 +1,61 @@
+/**
+ * @module integrations/graph/engine
+ * @summary Graph execution engine (backend-only).
+ * @description Reference interpreter for Decaf graph workflows. Executes
+ * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
+ * through Decaf's Observable pipeline, supports structured loops, configurable
+ * value stores, and pinnable/cacheable nodes.
+ *
+ * Re-exports `../shared` so backend consumers have a single import surface.
+ */
+export * from "../shared/index.d.mts";
+export * from "./constants.d.mts";
+export * from "./types.d.mts";
+export * from "./decorators.d.mts";
+export * from "./errors/GraphExecutionError.d.mts";
+export * from "./errors/GraphCycleError.d.mts";
+export * from "./errors/GraphInputError.d.mts";
+export * from "./errors/GraphLoopLimitError.d.mts";
+export * from "./errors/GraphPinningError.d.mts";
+export * from "./errors/GraphPortError.d.mts";
+export * from "./errors/GraphStoreError.d.mts";
+export * from "./errors/GraphTopologyError.d.mts";
+export * from "./events/GraphExecutionEvent.d.mts";
+export * from "./events/GraphExecutionObserver.d.mts";
+export * from "./events/GraphExecutionEventEmitter.d.mts";
+export * from "./events/GraphExecutionEventFactory.d.mts";
+export * from "./execution/GraphExecutionContext.d.mts";
+export * from "./execution/GraphNodeExecutor.d.mts";
+export * from "./execution/GraphExecutionFrame.d.mts";
+export * from "./execution/GraphExecutionResult.d.mts";
+export * from "./execution/GraphExecutionEngine.d.mts";
+export * from "./execution/CodeSandboxEvaluator.d.mts";
+export * from "./execution/SwitchGraphNodeExecutor.d.mts";
+export * from "./registry/GraphNodeExecutorRegistry.d.mts";
+export * from "./registry/GraphNodeExecutorResolver.d.mts";
+export * from "./store/GraphValueKey.d.mts";
+export * from "./store/GraphCachedValue.d.mts";
+export * from "./store/GraphValueStoreAdapter.d.mts";
+export * from "./store/InMemoryGraphValueStoreAdapter.d.mts";
+export * from "./store/GraphValueStore.d.mts";
+export * from "./planning/GraphExecutionPlanNode.d.mts";
+export * from "./planning/GraphExecutionPlanEdge.d.mts";
+export * from "./planning/GraphExecutionPlanLayer.d.mts";
+export * from "./planning/GraphExecutionPlan.d.mts";
+export * from "./planning/GraphRelationResolver.d.mts";
+export * from "./planning/GraphExecutionPlanner.d.mts";
+export * from "./planning/GraphTopology.d.mts";
+export * from "./validation/GraphDefinitionValidator.d.mts";
+export * from "./validation/GraphPortSchemaResolver.d.mts";
+export * from "./validation/GraphValueValidator.d.mts";
+export * from "./loops/GraphConditionEvaluator.d.mts";
+export * from "./loops/ConditionExpressionEvaluator.d.mts";
+export * from "./loops/GraphLoopExecutionContext.d.mts";
+export * from "./loops/ForeachGraphNodeExecutor.d.mts";
+export * from "./loops/WhileGraphNodeExecutor.d.mts";
+export * from "./loops/UntilGraphNodeExecutor.d.mts";
+export * from "./pinning/GraphPinningMetadata.d.mts";
+export * from "./pinning/GraphPinningPolicy.d.mts";
+export * from "./pinning/GraphPinningDependencyResolver.d.mts";
+export * from "./pinning/GraphPinningService.d.mts";
+export * from "./snapshots/GraphExecutionSnapshotMapper.d.mts";

package/lib/types/graph/{loops → engine/loops}/ConditionExpressionEvaluator.d.cts

@@ -5,7 +5,7 @@
  * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
  * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
  */
-import type { ConditionExpression } from "../types.d.cts";
+import type { ConditionExpression } from "../../shared/types.d.cts";
 /**
  * Evaluates a {@link ConditionExpression} against the given state.
  *

package/lib/types/graph/{loops → engine/loops}/ConditionExpressionEvaluator.d.mts

@@ -5,7 +5,7 @@
  * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
  * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
  */
-import type { ConditionExpression } from "../types.d.mts";
+import type { ConditionExpression } from "../../shared/types.d.mts";
 /**
  * Evaluates a {@link ConditionExpression} against the given state.
  *

package/lib/types/graph/{loops → engine/loops}/GraphConditionEvaluator.d.cts

@@ -5,7 +5,8 @@
  * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
  * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
  */
-import type { ConditionExpression, GraphConditionDefinition } from "../types.d.cts";
+import type { GraphConditionDefinition } from "../types.d.cts";
+import type { ConditionExpression } from "../../shared/types.d.cts";
 /**
  * Evaluates loop conditions using built-in comparison types or the
  * `ConditionExpression` DSL.

package/lib/types/graph/{loops → engine/loops}/GraphConditionEvaluator.d.mts

@@ -5,7 +5,8 @@
  * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
  * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
  */
-import type { ConditionExpression, GraphConditionDefinition } from "../types.d.mts";
+import type { GraphConditionDefinition } from "../types.d.mts";
+import type { ConditionExpression } from "../../shared/types.d.mts";
 /**
  * Evaluates loop conditions using built-in comparison types or the
  * `ConditionExpression` DSL.

package/lib/types/graph/{types.d.cts → engine/types.d.cts}

@@ -1,10 +1,17 @@
 /**
- * @module integrations/graph/types
+ * @module integrations/graph/engine/types
  * @summary Graph execution engine core types.
- * @description Type aliases and interfaces shared across the graph execution engine.
- */
-import type { GraphNodeDefinition, GraphPortDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEventType, GraphExecutionStatus } from "./constants.d.cts";
+ * @description Engine-private type aliases and interfaces. Frontend-safe
+ * types (`ExprValue`, `ConditionExpression`, `CodeCondition`,
+ * `SwitchCaseCondition`, `SwitchCase`, `SwitchNodeMetadata`,
+ * `NodeMetadataChange`, `GraphExecutionEvent`, `GraphExecutionErrorPayload`)
+ * live in `../shared/types`; engine modules import shared symbols from there
+ * and engine-private symbols from here.
+ */
+import type { GraphNodeDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionStatus } from "../shared/constants.d.cts";
+import type { GraphExecutionErrorPayload, GraphExecutionEvent } from "../shared/types.d.cts";
+export type { GraphExecutionErrorPayload, GraphExecutionEvent, } from "../shared/types.d.cts";
 /**
  * Unique identifier for a single graph execution run.
  */
@@ -43,37 +50,6 @@ export interface GraphExecutionOptions {
     writeThroughCache?: boolean;
     metadata?: Record<string, unknown>;
 }
-/**
- * Serialized error payload included in execution events and results.
- */
-export interface GraphExecutionErrorPayload {
-    name: string;
-    message: string;
-    stack?: string;
-    code?: string;
-    details?: unknown;
-}
-/**
- * A single event emitted during graph execution.
- */
-export interface GraphExecutionEvent {
-    id: string;
-    sequence: number;
-    runId: GraphRunId;
-    parentRunId?: GraphRunId;
-    workflowId: GraphWorkflowId;
-    type: GraphExecutionEventType;
-    timestamp: Date;
-    nodeId?: GraphNodeId;
-    edgeId?: string;
-    port?: GraphPortName;
-    iteration?: number;
-    path: string[];
-    status?: GraphExecutionStatus;
-    payload?: unknown;
-    error?: GraphExecutionErrorPayload;
-    metadata?: Record<string, unknown>;
-}
 /**
  * Result of executing a single node.
  */
@@ -146,118 +122,6 @@ export interface GraphConditionDefinition {
     evaluator?: string;
     metadata?: Record<string, unknown>;
 }
-/**
- * A value reference inside a {@link ConditionExpression}.
- *
- * - `{ const: x }` — a literal constant.
- * - `{ path: "a.b" }` — a dotted path resolved against the current loop state.
- * - `{ step: "nodeId", path: "out" }` — a cross-node reference (resolved from
- *   the execution state in v1; reserved for future multi-step evaluation).
- */
-export type ExprValue = {
-    const: unknown;
-} | {
-    path: string;
-} | {
-    step: string;
-    path: string;
-};
-/**
- * Declarative, serializable condition expression DSL (ALFRED-5 §8 / DECAF-32 §22.3).
- *
- * The engine's {@link GraphConditionEvaluator} recognises this DSL when the
- * condition object carries an `op` field and dispatches to the
- * {@link ConditionExpressionEvaluator}.
- */
-export type ConditionExpression = {
-    op: "eq";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "neq";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "gt";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "gte";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "lt";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "lte";
-    left: ExprValue;
-    right: ExprValue;
-} | {
-    op: "and";
-    conditions: ConditionExpression[];
-} | {
-    op: "or";
-    conditions: ConditionExpression[];
-} | {
-    op: "not";
-    condition: ConditionExpression;
-} | {
-    op: "exists";
-    value: ExprValue;
-};
-/**
- * A code-based condition evaluated in a restricted VM sandbox (§22.4).
- *
- * The engine does NOT implement the sandbox directly — a pluggable
- * {@link CodeSandboxEvaluator} must be registered for code conditions to work.
- * The code must follow the same restrictions as the Code Node (§22.4):
- * no system API access, placeholder syntax for workflow data references.
- */
-export interface CodeCondition {
-    type: "code";
-    code: string;
-    language?: "javascript" | "typescript";
-}
-/**
- * A condition on a Switch case — either a declarative
- * {@link ConditionExpression} (graphical mode) or a {@link CodeCondition}
- * (code mode).
- */
-export type SwitchCaseCondition = ConditionExpression | CodeCondition;
-/**
- * A single case in a Switch node.
- *
- * Each case pairs a condition with a dedicated output port. When the
- * condition evaluates to `true`, the input is routed to `outputPort`.
- */
-export interface SwitchCase {
-    id: string;
-    label: string;
-    condition: SwitchCaseCondition;
-    outputPort: string;
-}
-/**
- * Metadata for a Switch node, stored in `metadata.switch`.
- */
-export interface SwitchNodeMetadata {
-    cases: SwitchCase[];
-    defaultPort?: string;
-}
-/**
- * The result of applying a metadata change to a node. Each concrete node
- * class that overrides `GraphNode.applyMetadata()` returns this so the
- * renderer can update the diagram model — the node owns its ports, its
- * size, and any data patches.
- */
-export interface NodeMetadataChange {
-    ports: GraphPortDefinition[];
-    size: {
-        width: number;
-        height: number;
-    };
-    dataPatch: Record<string, unknown>;
-}
 /**
  * Pinning metadata attached to a node via `@pinnable()`.
  */