@uipath/maestro-builder-sdk 6.17.5 → 6.18.0

package/dist/registry/library-build/enrich.js

@@ -17,7 +17,7 @@ import { mapConcurrent } from "../concurrency.js";
 import { messageOf } from "../errors.js";
 import { normalizeFieldKeys, pick } from "./canonical.js";
 import { isDescribeObject, isDescribeOperation } from "./context.js";
-import { get, item, pyEquals, pyIter, pyOr, truthy } from "./py.js";
+import { get, item, pyEquals, pyIter, pyOr, pyTruthy } from "./py.js";
 /**
  * Registry `httpMethod` (e.g. `GETBYID`) → a guess at the `is resources`
  * operation name, for an entry whose canonical `operation.name` is empty.
@@ -40,10 +40,10 @@ export async function discoverOperationName(ctx, entry) {
     const connectorKey = item(item(entry, "connector"), "key");
     const objectName = item(operation, "objectName");
     const httpMethod = item(operation, "httpMethod");
-    if (!truthy(connectorKey) || !truthy(objectName))
+    if (!pyTruthy(connectorKey) || !pyTruthy(objectName))
         return null;
     const objData = await isDescribeObject(ctx, connectorKey, objectName);
-    if (!truthy(objData))
+    if (!pyTruthy(objData))
         return null;
     for (const op of pyIter(pyOr(pick(objData, "AvailableOperations", "availableOperations"), []))) {
         if (pyEquals(pick(op, "Method", "method"), httpMethod))
@@ -64,31 +64,31 @@ export function applyDescribe(entry, data) {
     const opData = pyOr(pick(data, "Operation", "operation"), {});
     // If the name was discovered via fallback, persist it now.
     const opResolvedName = pick(opData, "Name", "name");
-    if (!truthy(item(operation, "name")) && truthy(opResolvedName))
+    if (!pyTruthy(item(operation, "name")) && pyTruthy(opResolvedName))
         operation.name = opResolvedName;
     // Path with placeholders (supersedes the simple `path`).
     const opPath = pick(opData, "Path", "path");
-    if (truthy(opPath))
+    if (pyTruthy(opPath))
         operation.pathTemplate = opPath;
-    if (!truthy(get(operation, "objectDisplayName"))) {
+    if (!pyTruthy(get(operation, "objectDisplayName"))) {
         const displayName = pick(data, "DisplayName", "displayName");
-        if (truthy(displayName))
+        if (pyTruthy(displayName))
             operation.objectDisplayName = displayName;
     }
     const opCurated = pick(opData, "Curated", "curated");
-    if (truthy(opCurated) && !truthy(get(display, "operationLabel")))
+    if (pyTruthy(opCurated) && !pyTruthy(get(display, "operationLabel")))
         display.operationLabel = opCurated;
     // Parameters (path / query) — raw shape, camelCase keys.
     const params = pyOr(pick(data, "Parameters", "parameters"), []);
-    if (truthy(params))
+    if (pyTruthy(params))
         operation.parameters = normalizeFieldKeys(params);
     // Do not infer schema discovery from empty field lists: delete and file
     // operations legitimately expose neither. Connector metadata owns that flag.
     const requestFields = pyOr(pick(data, "RequestFields", "requestFields"), []);
     const responseFields = pyOr(pick(data, "ResponseFields", "responseFields"), []);
-    if (truthy(requestFields))
+    if (pyTruthy(requestFields))
         e.inputSchema = { fields: normalizeFieldKeys(requestFields) };
-    if (truthy(responseFields))
+    if (pyTruthy(responseFields))
         e.outputSchema = { fields: normalizeFieldKeys(responseFields) };
     return entry;
 }
@@ -111,16 +111,16 @@ export async function enrichEntry(ctx, entry) {
     const objectName = item(operation, "objectName");
     let opName = item(operation, "name");
     // Fallback: no operation name from the registry — discover via httpMethod.
-    if (!truthy(opName)) {
+    if (!pyTruthy(opName)) {
         opName = pyOr(await discoverOperationName(ctx, entry), HTTP_METHOD_TO_OPERATION.get(item(operation, "httpMethod")) ?? null);
     }
-    if (!truthy(opName))
+    if (!pyTruthy(opName))
         return entry; // nothing to do
     const failuresBefore = ctx.failedFieldDescribes.length;
     let data = await isDescribeOperation(ctx, connectorKey, objectName, opName);
-    if (!truthy(data)) {
+    if (!pyTruthy(data)) {
         const alt = await discoverOperationName(ctx, entry);
-        if (truthy(alt) && alt !== opName) {
+        if (pyTruthy(alt) && alt !== opName) {
             // The registry's verb did not name an operation the object has, so its
             // `-f` rejection is about a request that is now superseded: the CLI maps
             // `List` to GET, and Data Service `QueryEntityRecordsCurated` exposes
@@ -134,7 +134,7 @@ export async function enrichEntry(ctx, entry) {
             data = await isDescribeOperation(ctx, connectorKey, objectName, alt);
         }
     }
-    if (!truthy(data))
+    if (!pyTruthy(data))
         return entry; // connector might be a stub or recently removed
     return applyDescribe(entry, data);
 }
@@ -159,9 +159,9 @@ export async function enrichAll(ctx, entries) {
     let pathTemplateAdded = 0;
     let schemaAdded = 0;
     for (const e of enriched) {
-        if (truthy(get(get(e, "operation", {}), "pathTemplate")))
+        if (pyTruthy(get(get(e, "operation", {}), "pathTemplate")))
             pathTemplateAdded += 1;
-        if (truthy(get(get(e, "inputSchema", {}), "fields")) || truthy(get(get(e, "outputSchema", {}), "fields")))
+        if (pyTruthy(get(get(e, "inputSchema", {}), "fields")) || pyTruthy(get(get(e, "outputSchema", {}), "fields")))
             schemaAdded += 1;
     }
     ctx.reporter.info(`  pathTemplate added on ${pathTemplateAdded}/${entries.length}`);

package/dist/registry/library-build/events.js

@@ -22,7 +22,8 @@ import { failureReason } from "../uip/envelope.js";
 import { safeCacheName } from "../uip/response-cache.js";
 import { schemaCacheScope, writeCache } from "./context.js";
 import { objectsComeFromTheConnection } from "./generic-expand.js";
-import { codePointSlice, deepCopy, get, isRecord, item, pyIter, pyOr, truthy } from "./py.js";
+import { codePointSlice, get, isPyDict, item, pyIter, pyOr, pyTruthy } from "./py.js";
+import { jsonClone } from "../../core/json-file.js";
 /**
  * `Parameters[].type` on a `triggers objects` row routes the value into one of
  * three `--detail` buckets at emit time. Everything unrecognized is an event
@@ -87,7 +88,7 @@ async function runJson(client, argv, timeoutMs) {
 export async function triggersObjects(client, key, operation, connectionId, timeoutMs) {
     const payload = await runJson(client, isTriggersObjects(key, operation, connectionId), timeoutMs);
     let data = get(payload, "Data");
-    if (isRecord(data))
+    if (isPyDict(data))
         data = get(data, "items");
     return Array.isArray(data) ? data : [];
 }
@@ -102,7 +103,7 @@ function lowerKey(k) {
 }
 /** `_camelize`: lower-case the first letter of every key, recursively. */
 export function camelize(value) {
-    if (isRecord(value)) {
+    if (isPyDict(value)) {
         const out = {};
         for (const [k, v] of Object.entries(value))
             out[lowerKey(k)] = camelize(v);
@@ -122,23 +123,23 @@ function lowerTop(f) {
 /** `_is_hidden`: a hidden parameter that is safe to DROP — hidden and optional. */
 export function isHidden(low) {
     const raw = pyOr(get(low, "design"), {});
-    if (!isRecord(raw))
+    if (!isPyDict(raw))
         return false;
     const design = camelize(raw);
-    const hidden = truthy(pyOr(get(design, "isHidden"), get(design, "hidden")));
-    return hidden && !truthy(get(low, "required"));
+    const hidden = pyTruthy(pyOr(get(design, "isHidden"), get(design, "hidden")));
+    return hidden && !pyTruthy(get(low, "required"));
 }
 /** `_keep_hidden_marker`: flag a kept parameter the designer hides (necessarily a required one). */
 export function keepHiddenMarker(low, field) {
     const design = camelize(pyOr(get(low, "design"), {}));
-    if (isRecord(design) && truthy(pyOr(get(design, "isHidden"), get(design, "hidden"))))
+    if (isPyDict(design) && pyTruthy(pyOr(get(design, "isHidden"), get(design, "hidden"))))
         field.hidden = true;
     return field;
 }
 /** `(f.get("sortOrder") is None, f.get("sortOrder") or 0)`. */
 function sortOrderKey(f) {
     const so = get(f, "sortOrder");
-    return [so === null ? 1 : 0, truthy(so) ? so : 0];
+    return [so === null ? 1 : 0, pyTruthy(so) ? so : 0];
 }
 /**
  * `_with_cascade`: mark each parameter that another one has to resolve before
@@ -152,7 +153,7 @@ export function withCascade(fields) {
         const explicit = pyIter(pyOr(get(reference, "dependsOn"), []));
         const own = get(field, "name");
         const depends = sortedStrings([...names]
-            .filter((other) => truthy(other) && other !== own && (path.includes(`{${pyStr(other)}}`) || explicit.includes(other)))
+            .filter((other) => pyTruthy(other) && other !== own && (path.includes(`{${pyStr(other)}}`) || explicit.includes(other)))
             .map((other) => pyStr(other)));
         if (depends.length > 0) {
             field.dependsOn = depends;
@@ -175,11 +176,11 @@ export function withCascade(fields) {
 export function camelFields(fields) {
     const out = [];
     for (const f of pyIter(pyOr(fields, []))) {
-        if (!isRecord(f))
+        if (!isPyDict(f))
             continue;
         const low = lowerTop(f);
         const name = get(low, "name");
-        if (!truthy(name))
+        if (!pyTruthy(name))
             continue;
         if (isHidden(low))
             continue;
@@ -208,11 +209,11 @@ export function camelFields(fields) {
 export function normalizeBucketFields(parameters) {
     const out = [];
     for (const f of pyIter(pyOr(parameters, []))) {
-        if (!isRecord(f))
+        if (!isPyDict(f))
             continue;
         const low = lowerTop(f);
         const name = get(low, "name");
-        if (!truthy(name))
+        if (!pyTruthy(name))
             continue;
         if (isHidden(low))
             continue;
@@ -252,7 +253,7 @@ export function unionEventParameters(declared, objectParameters) {
             merged.set(field.name, field);
             continue;
         }
-        existing.required = truthy(get(existing, "required")) || truthy(get(field, "required"));
+        existing.required = pyTruthy(get(existing, "required")) || pyTruthy(get(field, "required"));
         existing.bucket = field.bucket;
         for (const k of ["displayName", "description", "reference", "sortOrder"]) {
             if (get(field, k) !== null && get(existing, k) === null)
@@ -306,7 +307,7 @@ export function mergeDescribeIntoNode(node, describe, objectParameters = null, o
     const out = { ...node };
     out.eventParameters = { fields: unionEventParameters(get(describe, "EventParameters"), objectParameters) };
     out.filterFields = { fields: camelFields(get(describe, "FilterFields")) };
-    if (truthy(get(describe, "OutputFields"))) {
+    if (pyTruthy(get(describe, "OutputFields"))) {
         out.outputResponseDefinition = { fields: camelFields(get(describe, "OutputFields")) };
     }
     Object.assign(out, resolveEventFacts(objectRow, describe));
@@ -322,8 +323,8 @@ export function eventFacts(node, objectRow) {
     const textBlocks = pyOr(get(pyOr(get(row, "Design"), {}), "TextBlocks"), get(pyOr(get(row, "design"), {}), "textBlocks"), []);
     return {
         eventMode: pyStr(pyOr(stated.eventMode ?? null, "polling")),
-        byoaConnection: truthy(stated.byoaConnection ?? false),
-        isWebhookUrlVisible: truthy(stated.isWebhookUrlVisible ?? false),
+        byoaConnection: pyTruthy(stated.byoaConnection ?? false),
+        isWebhookUrlVisible: pyTruthy(stated.isWebhookUrlVisible ?? false),
         textBlocks: pyIter(textBlocks).map(textBlockText),
     };
 }
@@ -338,7 +339,7 @@ export function eventFacts(node, objectRow) {
  * something plausible.
  */
 function textBlockText(block) {
-    if (isRecord(block)) {
+    if (isPyDict(block)) {
         const text = pyOr(get(block, "Text"), get(block, "text"));
         if (typeof text === "string")
             return text;
@@ -432,7 +433,7 @@ export async function describeCuratedEvents(ctx, entries) {
         const operation = item(entry, "operation");
         const eventOperation = pyOr(get(operation, "eventOperation"), "");
         const objectName = pyOr(get(operation, "objectName"), "");
-        if (!truthy(eventOperation) || !truthy(objectName))
+        if (!pyTruthy(eventOperation) || !pyTruthy(objectName))
             return [entry, null, null];
         const rows = await triggersObjectsCached(ctx, key, eventOperation);
         const obj = rows.find((r) => get(r, "Name") === objectName) ?? null;
@@ -440,7 +441,7 @@ export async function describeCuratedEvents(ctx, entries) {
     });
     let described = 0;
     for (const [entry, describe, obj] of results) {
-        if (!truthy(describe))
+        if (!pyTruthy(describe))
             continue;
         applyEventSchema(entry, describe, obj);
         described += 1;
@@ -453,7 +454,7 @@ export async function describeCuratedEvents(ctx, entries) {
  * nodeType deliberately; the object rides on `operation.objectName`.
  */
 export function makeExpandedEventEntry(template, obj, describe) {
-    const entry = deepCopy(template);
+    const entry = jsonClone(template);
     const objectName = pyOr(get(obj, "Name"), "");
     const objectDisplay = pyOr(get(obj, "DisplayName"), objectName);
     const operation = item(entry, "operation");
@@ -477,10 +478,10 @@ export async function expandGenericEvents(ctx, templates) {
     for (const template of templates) {
         const key = item(item(template, "connector"), "key");
         const operation = pyOr(get(item(template, "operation"), "eventOperation"), "");
-        if (!truthy(operation))
+        if (!pyTruthy(operation))
             continue;
         for (const obj of await triggersObjectsCached(ctx, key, operation)) {
-            if (truthy(get(obj, "Name")))
+            if (pyTruthy(get(obj, "Name")))
                 work.push([template, key, operation, obj]);
         }
     }
@@ -508,7 +509,7 @@ export async function resolveConnectorEvents(ctx, entries) {
             // UNKNOWN is not "static": expand only where the connector positively
             // says its objects do not come from the connection.
             const discovery = get(pyOr(get(e, "connector"), {}), "discovery");
-            if (!truthy(discovery)) {
+            if (!pyTruthy(discovery)) {
                 ctx.reporter.warn(`  WARN: ${item(e, "nodeType")} not expanded — no connector discovery metadata, so whether its ` +
                     "objects come from the connection is unknown");
             }

package/dist/registry/library-build/generic-expand.js

@@ -20,7 +20,8 @@ import { mapConcurrent } from "../concurrency.js";
 import { messageOf } from "../errors.js";
 import { isHttpPassthrough, normalizeFieldKeys, pick } from "./canonical.js";
 import { isDescribeObject, isDescribeOperation, isResourcesList } from "./context.js";
-import { deepCopy, get, item, pyIter, pyOr, truthy } from "./py.js";
+import { get, item, pyIter, pyOr, pyTruthy } from "./py.js";
+import { jsonClone } from "../../core/json-file.js";
 /**
  * `_generic_templates_by_op`: bucket Generic CRUD entries by IS operation
  * name per connector. Generic CRUD actions carry an `operation` verb
@@ -37,7 +38,7 @@ export function genericTemplatesByOp(genericEntries) {
         if (!opName)
             continue;
         const key = item(item(e, "connector"), "key");
-        if (!truthy(key))
+        if (!pyTruthy(key))
             continue;
         let byOp = out.get(key);
         if (!byOp) {
@@ -56,7 +57,7 @@ export function genericTemplatesByOp(genericEntries) {
  * discovery flag is copied, never inferred from field counts.
  */
 export function makeExpandedEntry(template, obj, op, opData) {
-    const entry = deepCopy(template);
+    const entry = jsonClone(template);
     const templateOperation = item(template, "operation");
     const objectName = pyOr(get(obj, "Name"), "");
     const objectDisplay = pyOr(get(obj, "DisplayName"), objectName);
@@ -75,16 +76,16 @@ export function makeExpandedEntry(template, obj, op, opData) {
     operation.sourceNodeType = item(template, "nodeType");
     const display = item(entry, "display");
     display.label = pyStrip(`${pyStr(opName)} ${pyStr(objectDisplay)}`);
-    if (truthy(opDescription))
+    if (pyTruthy(opDescription))
         display.description = opDescription;
     // Pull schema + path template from the per-operation describe payload.
-    if (truthy(opData)) {
+    if (pyTruthy(opData)) {
         const opInner = pyOr(pick(opData, "Operation", "operation"), {});
         const opInnerPath = pick(opInner, "Path", "path");
-        if (truthy(opInnerPath))
+        if (pyTruthy(opInnerPath))
             operation.pathTemplate = opInnerPath;
         const params = pyOr(pick(opData, "Parameters", "parameters"), []);
-        if (truthy(params))
+        if (pyTruthy(params))
             operation.parameters = normalizeFieldKeys(params);
         const requestFields = pyOr(pick(opData, "RequestFields", "requestFields"), []);
         const responseFields = pyOr(pick(opData, "ResponseFields", "responseFields"), []);
@@ -102,7 +103,7 @@ export function uniqueByName(objects) {
     const unique = new Map();
     for (const obj of pyIter(pyOr(objects, []))) {
         const objectName = get(obj, "Name");
-        if (truthy(objectName) && !unique.has(objectName))
+        if (pyTruthy(objectName) && !unique.has(objectName))
             unique.set(objectName, obj);
     }
     return unique;
@@ -117,7 +118,7 @@ export async function listGenericObjects(ctx, connectorKey, templatesByOp, objec
     const operationFilter = templatesByOp.size === 1 ? [...templatesByOp.keys()][0] : null;
     const objects = await isResourcesList(ctx, connectorKey, { operation: operationFilter });
     let unique = uniqueByName(objects);
-    if (truthy(objectNames) && !objectNames.every((name) => unique.has(name))) {
+    if (pyTruthy(objectNames) && !objectNames.every((name) => unique.has(name))) {
         const refreshed = uniqueByName(await isResourcesList(ctx, connectorKey, { operation: operationFilter, refresh: true }));
         // Keep the cached answer when the refresh failed outright, so a network
         // blip does not turn a working lookup into "not found".
@@ -141,24 +142,24 @@ export async function expandGenericForConnector(ctx, connectorKey, templatesByOp
     const out = [];
     for (const obj of objects) {
         const objectName = get(obj, "Name");
-        if (!truthy(objectName))
+        if (!pyTruthy(objectName))
             continue;
         if (objectNames !== undefined && !objectNames.includes(objectName))
             continue;
         const objData = await isDescribeObject(ctx, connectorKey, objectName);
-        if (!truthy(objData))
+        if (!pyTruthy(objData))
             continue;
         const available = pyOr(pick(objData, "AvailableOperations", "availableOperations"), []);
         for (const op of pyIter(available)) {
             const opName = pick(op, "Name", "name");
-            if (!truthy(opName))
+            if (!pyTruthy(opName))
                 continue;
             const pair = JSON.stringify([objectName, opName]);
             if (seenPairs.has(pair))
                 continue;
             seenPairs.add(pair);
             const template = templatesByOp.get(opName);
-            if (!truthy(template))
+            if (!pyTruthy(template))
                 continue;
             const opData = await isDescribeOperation(ctx, connectorKey, objectName, opName);
             out.push(makeExpandedEntry(template, obj, op, opData));
@@ -172,7 +173,7 @@ export async function expandGenericForConnector(ctx, connectorKey, templatesByOp
  */
 export function objectsComeFromTheConnection(entry) {
     const discovery = pyOr(get(pyOr(get(entry, "connector"), {}), "discovery"), {});
-    return truthy(pyOr(get(discovery, "hasObjectDiscovery"), get(discovery, "hasCustomObjectDiscovery")));
+    return pyTruthy(pyOr(get(discovery, "hasObjectDiscovery"), get(discovery, "hasCustomObjectDiscovery")));
 }
 /**
  * `as_discovery_entry`: recast a Generic CRUD template as the discovery entry
@@ -184,7 +185,7 @@ export function asDiscoveryEntry(entry) {
     operation.objectFromDiscovery = true;
     operation.objectName = "";
     const name = pyOr(get(operation, "name"), "");
-    if (truthy(name)) {
+    if (pyTruthy(name)) {
         item(entry, "display").label = name === "List" ? "List Records" : `${pyStr(name)} Record`;
     }
     return entry;
@@ -197,7 +198,7 @@ export function asDiscoveryEntry(entry) {
 export function disambiguateDiscoveryLabels(entries) {
     const groups = new Map();
     for (const entry of entries) {
-        if (!truthy(get(pyOr(get(entry, "operation"), {}), "objectFromDiscovery")))
+        if (!pyTruthy(get(pyOr(get(entry, "operation"), {}), "objectFromDiscovery")))
             continue;
         const key = JSON.stringify([
             get(pyOr(get(entry, "connector"), {}), "key"),
@@ -314,16 +315,16 @@ export async function expandAllGenerics(ctx, entries) {
             objData = undefined;
             ctx.reporter.warn(`  WARN: object describe failed for ${k}/${pyStr(item(obj, "Name"))}: ${messageOf(exc)}`);
         }
-        if (truthy(objData)) {
+        if (pyTruthy(objData)) {
             const available = pyOr(pick(objData, "AvailableOperations", "availableOperations"), []);
             const seenOpNames = new Set();
             for (const op of pyIter(available)) {
                 const opName = pick(op, "Name", "name");
-                if (!truthy(opName) || seenOpNames.has(opName))
+                if (!pyTruthy(opName) || seenOpNames.has(opName))
                     continue;
                 seenOpNames.add(opName);
                 const template = templates.get(k).get(opName);
-                if (truthy(template))
+                if (pyTruthy(template))
                     found.push([k, obj, op, template]);
             }
         }
@@ -356,7 +357,7 @@ export async function expandAllGenerics(ctx, entries) {
         return entry;
     });
     expanded.push(...results);
-    const schemaDynamic = expanded.filter((e) => truthy(get(item(e, "runtime"), "requiresConnectionForSchema"))).length;
+    const schemaDynamic = expanded.filter((e) => pyTruthy(get(item(e, "runtime"), "requiresConnectionForSchema"))).length;
     ctx.reporter.info(`  expanded ${expanded.length} entries from ${genericCrud.length} Generic CRUD actions`);
     ctx.reporter.info(`  schema-dynamic among expanded: ${schemaDynamic}/${expanded.length}`);
     return [curatedAndPassthrough, expanded];

package/dist/registry/library-build/plan.js

@@ -12,7 +12,7 @@ import { sortedByKeys } from "../compat/compare.js";
 import { pyStr } from "../compat/pystr.js";
 import { messageOf } from "../errors.js";
 import { SCHEMA_VERSION, actionIdFromNodeType } from "./canonical.js";
-import { get, isRecord, item, pyEquals, pyIter, pyOr, truthy } from "./py.js";
+import { get, isPyDict, item, pyEquals, pyIter, pyOr, pyTruthy } from "./py.js";
 export { actionIdFromNodeType };
 /** `_safe_path_segment`: sanitize a string for use as one path segment. */
 export function safePathSegment(s) {
@@ -42,7 +42,7 @@ export function entryRelpath(entry) {
         return `${connectorKey}/generic/${obj}/${op}@${version}`;
     }
     const actionId = actionIdFromNodeType(item(entry, "nodeType"));
-    if (get(operation, "activityType") === "GenericTrigger" && truthy(get(operation, "objectName"))) {
+    if (get(operation, "activityType") === "GenericTrigger" && pyTruthy(get(operation, "objectName"))) {
         const obj = safePathSegment(pyStr(item(operation, "objectName")));
         return `${connectorKey}/events/${obj}/${actionId}@${version}`;
     }
@@ -55,7 +55,7 @@ export function entryRelpath(entry) {
  * connector definition when absent (`setdefault`: a present `null` stays).
  */
 export function buildV1Definition(nodeData) {
-    if (!isRecord(nodeData))
+    if (!isPyDict(nodeData))
         throw new TypeError(`'${nodeData === null ? "NoneType" : typeof nodeData}' object has no attribute 'items'`);
     const keep = {};
     for (const [k, v] of Object.entries(nodeData)) {
@@ -150,18 +150,18 @@ export function planLibrary(entries, loadNode, opts = {}) {
         let v1def;
         try {
             const nodeData = typeof lookupKey === "string" ? loadNode(lookupKey) : undefined;
-            if (truthy(nodeData)) {
+            if (pyTruthy(nodeData)) {
                 v1def = buildV1Definition(nodeData);
                 // The entry's fields are the node's own plus whatever the parameters
                 // filled in — a superset of a verbatim projection — so prefer them
                 // whenever there are any. An expanded Generic node stamps even an
                 // empty list: its template's fields belong to the dispatch node.
                 const resolvedFields = pyOr(get(get(entry, "inputSchema", {}), "fields"), []);
-                if (expanded || truthy(resolvedFields)) {
+                if (expanded || pyTruthy(resolvedFields)) {
                     if (!("inputDefinition" in v1def))
                         v1def.inputDefinition = {};
                     const inputDefinition = v1def.inputDefinition;
-                    if (!isRecord(inputDefinition)) {
+                    if (!isPyDict(inputDefinition)) {
                         throw new TypeError(`'${inputDefinition === null ? "NoneType" : typeof inputDefinition}' object does not support item assignment`);
                     }
                     // Stamp onto a COPY. `buildV1Definition` is shallow, so this block is
@@ -177,7 +177,7 @@ export function planLibrary(entries, loadNode, opts = {}) {
                 // A per-object EVENT variant carries its own subscription vocabulary,
                 // and this sidecar is where the SDK reads one.
                 const eventSchema = pyOr(get(entry, "eventSchema"), {});
-                if (truthy(eventSchema)) {
+                if (pyTruthy(eventSchema)) {
                     v1def.eventParameters = { fields: pyOr(get(eventSchema, "eventParameters"), []) };
                     v1def.filterFields = { fields: pyOr(get(eventSchema, "filterFields"), []) };
                     for (const fact of ["eventMode", "byoaConnection", "isWebhookUrlVisible"]) {
@@ -207,7 +207,7 @@ export function planLibrary(entries, loadNode, opts = {}) {
         };
         // `registry search` reads only this index; emitted only when set, so every
         // other row stays byte-identical.
-        if (truthy(get(operation, "objectFromDiscovery")))
+        if (pyTruthy(get(operation, "objectFromDiscovery")))
             row.objectFromDiscovery = true;
         index.push(row);
     }

package/dist/registry/library-build/py.d.ts

@@ -8,13 +8,10 @@
  * to `dict.get`, and two dicts compare equal in any key order. The port spells
  * each rule once here so every call site can read like the line it replaces.
  */
+export { pyTruthy, pyOr } from "../compat/pyvalue.js";
 export type Dict = Record<string, unknown>;
-/** A plain JSON object: what `json.load` calls a dict. */
-export declare function isRecord(value: unknown): value is Dict;
-/** `bool(value)` for a JSON-shaped value. */
-export declare function truthy(value: unknown): boolean;
-/** `a or b or …`: the first truthy operand, else the last one. */
-export declare function pyOr<T>(...values: T[]): T;
+/** A plain JSON object: what `json.load` calls a dict (Map excluded — unlike core/node-envelope.ts's isRecord). */
+export declare function isPyDict(value: unknown): value is Dict;
 /**
  * `d.get(key, default)`. A present key answers its value even when that value
  * is `null`; an absent key answers `dflt`, which is `null` (Python's `None`)
@@ -33,10 +30,6 @@ export declare function pyIter(value: unknown): unknown[];
  * order; lists element by element; `True == 1` as in Python.
  */
 export declare function pyEquals(a: unknown, b: unknown): boolean;
-/** `json.loads(json.dumps(value))`: the generator's deep copy, JSON-shaped values only. */
-export declare function deepCopy<T>(value: T): T;
-/** `repr(str)`: single quotes unless the text holds one and no double quote. */
-export declare function pyReprStr(s: string): string;
 /** `repr(list_of_str)`: `['a', 'b']`. */
 export declare function pyReprStrList(items: readonly string[]): string;
 /** `s[start:end]` by code point. */

package/dist/registry/library-build/py.js

@@ -8,31 +8,12 @@
  * to `dict.get`, and two dicts compare equal in any key order. The port spells
  * each rule once here so every call site can read like the line it replaces.
  */
-/** A plain JSON object: what `json.load` calls a dict. */
-export function isRecord(value) {
+import { pyReprString } from "../compat/pystr.js";
+export { pyTruthy, pyOr } from "../compat/pyvalue.js";
+/** A plain JSON object: what `json.load` calls a dict (Map excluded — unlike core/node-envelope.ts's isRecord). */
+export function isPyDict(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Map);
 }
-/** `bool(value)` for a JSON-shaped value. */
-export function truthy(value) {
-    if (value === null || value === undefined || value === false || value === "")
-        return false;
-    if (typeof value === "number")
-        return value !== 0;
-    if (Array.isArray(value))
-        return value.length > 0;
-    if (value instanceof Map)
-        return value.size > 0;
-    if (typeof value === "object")
-        return Object.keys(value).length > 0;
-    return true;
-}
-/** `a or b or …`: the first truthy operand, else the last one. */
-export function pyOr(...values) {
-    for (const value of values)
-        if (truthy(value))
-            return value;
-    return values[values.length - 1];
-}
 /**
  * Does the dict itself hold `key`? — `key in d` for a Python dict.
  *
@@ -58,7 +39,7 @@ function hasKey(d, key) {
  * Calling `.get` on a non-dict raises in Python, and does here.
  */
 export function get(d, key, dflt = null) {
-    if (!isRecord(d)) {
+    if (!isPyDict(d)) {
         throw new TypeError(`'${pyTypeName(d)}' object has no attribute 'get'`);
     }
     if (!hasKey(d, key))
@@ -68,7 +49,7 @@ export function get(d, key, dflt = null) {
 }
 /** `d[key]`: raises on a missing key the way Python's `KeyError` does. */
 export function item(d, key) {
-    if (!isRecord(d)) {
+    if (!isPyDict(d)) {
         throw new TypeError(`'${pyTypeName(d)}' object is not subscriptable`);
     }
     if (!hasKey(d, key) || d[key] === undefined)
@@ -83,7 +64,7 @@ export function pyIter(value) {
         return [...value];
     if (value instanceof Map)
         return [...value.keys()];
-    if (isRecord(value))
+    if (isPyDict(value))
         return Object.keys(value);
     throw new TypeError(`'${pyTypeName(value)}' object is not iterable`);
 }
@@ -116,7 +97,7 @@ export function pyEquals(a, b) {
             return false;
         return a.every((item, i) => pyEquals(item, b[i]));
     }
-    if (isRecord(a) && isRecord(b)) {
+    if (isPyDict(a) && isPyDict(b)) {
         const keysA = Object.keys(a).filter((k) => a[k] !== undefined);
         const keysB = Object.keys(b).filter((k) => b[k] !== undefined);
         if (keysA.length !== keysB.length)
@@ -128,33 +109,9 @@ export function pyEquals(a, b) {
     }
     return false;
 }
-/** `json.loads(json.dumps(value))`: the generator's deep copy, JSON-shaped values only. */
-export function deepCopy(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-/** `repr(str)`: single quotes unless the text holds one and no double quote. */
-export function pyReprStr(s) {
-    const quote = s.includes("'") && !s.includes('"') ? '"' : "'";
-    let out = quote;
-    for (const ch of s) {
-        if (ch === "\\")
-            out += "\\\\";
-        else if (ch === quote)
-            out += `\\${quote}`;
-        else if (ch === "\n")
-            out += "\\n";
-        else if (ch === "\r")
-            out += "\\r";
-        else if (ch === "\t")
-            out += "\\t";
-        else
-            out += ch;
-    }
-    return out + quote;
-}
 /** `repr(list_of_str)`: `['a', 'b']`. */
 export function pyReprStrList(items) {
-    return `[${items.map(pyReprStr).join(", ")}]`;
+    return `[${items.map(pyReprString).join(", ")}]`;
 }
 /** `s[start:end]` by code point. */
 export function codePointSlice(s, start, end) {