@memberjunction/ai-agents 5.38.0 → 5.39.0

package/dist/pipeline/predicate.js

@@ -0,0 +1,306 @@
+/**
+ * @fileoverview Safe predicate language for the `where` operator. Grammar:
+ *
+ *   expr   := or
+ *   or     := and ( 'or' and )*
+ *   and    := not ( 'and' not )*
+ *   not    := 'not' not | primary
+ *   primary:= '(' expr ')' | comparison
+ *   comparison := path OP value
+ *   OP     := '==' | '!=' | '<=' | '>=' | '<' | '>'
+ *           | 'contains' | 'startsWith' | 'endsWith' | 'matches' | 'in'
+ *   value  := string | number | true | false | null | today | now | '[' value (',' value)* ']'
+ *
+ * Parsed with a hand-written recursive-descent parser — never `eval`'d. The `matches` operator
+ * compiles a user regex behind a ReDoS guard (length cap + star-height check; see {@link safeRegex});
+ * everything else is plain comparison. This is the security spine for LLM-authored filters.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import safeRegexCheck from 'safe-regex';
+import { getValue } from './path.js';
+/**
+ * Hard cap on the source length of a `matches` pattern. The pattern is LLM-authored, so this bounds
+ * the parsing surface; the real ReDoS defense is {@link safeRegex}'s star-height check below.
+ */
+const MAX_REGEX_PATTERN_LENGTH = 200;
+const SYMBOL_OPS = ['==', '!=', '<=', '>=', '<', '>'];
+const WORD_OPS = ['contains', 'startsWith', 'endsWith', 'matches', 'in'];
+const STOP_CHARS = new Set([' ', '\t', '\n', '=', '!', '<', '>', '(', ')', ',']);
+/** Parse a predicate string into an AST. Throws with a clear message on malformed input. */
+export function parsePredicate(src) {
+    const parser = new PredicateParser(src);
+    const ast = parser.ParseExpr();
+    parser.ExpectEnd();
+    return ast;
+}
+/** Evaluate a parsed predicate against one element. */
+export function evaluatePredicate(ast, element) {
+    switch (ast.kind) {
+        case 'and':
+            return ast.nodes.every((n) => evaluatePredicate(n, element));
+        case 'or':
+            return ast.nodes.some((n) => evaluatePredicate(n, element));
+        case 'not':
+            return !evaluatePredicate(ast.node, element);
+        case 'cmp':
+            return evaluateComparison(ast, element);
+    }
+}
+class PredicateParser {
+    constructor(s) {
+        this.s = s;
+        this.pos = 0;
+    }
+    ParseExpr() {
+        return this.parseOr();
+    }
+    ExpectEnd() {
+        this.ws();
+        if (this.pos < this.s.length) {
+            throw new Error(`Unexpected "${this.s.slice(this.pos)}" in predicate`);
+        }
+    }
+    parseOr() {
+        const nodes = [this.parseAnd()];
+        while (this.matchWord('or')) {
+            nodes.push(this.parseAnd());
+        }
+        return nodes.length === 1 ? nodes[0] : { kind: 'or', nodes };
+    }
+    parseAnd() {
+        const nodes = [this.parseNot()];
+        while (this.matchWord('and')) {
+            nodes.push(this.parseNot());
+        }
+        return nodes.length === 1 ? nodes[0] : { kind: 'and', nodes };
+    }
+    parseNot() {
+        if (this.matchWord('not')) {
+            return { kind: 'not', node: this.parseNot() };
+        }
+        return this.parsePrimary();
+    }
+    parsePrimary() {
+        this.ws();
+        if (this.s[this.pos] === '(') {
+            this.pos++;
+            const e = this.ParseExpr();
+            this.ws();
+            if (this.s[this.pos] !== ')') {
+                throw new Error('Unbalanced parentheses in predicate');
+            }
+            this.pos++;
+            return e;
+        }
+        return this.parseComparison();
+    }
+    parseComparison() {
+        const path = this.scanPath();
+        const op = this.scanOp();
+        const value = op === 'in' ? this.scanArray() : this.scanValue();
+        return { kind: 'cmp', path, op, value };
+    }
+    scanPath() {
+        this.ws();
+        const start = this.pos;
+        while (this.pos < this.s.length && !STOP_CHARS.has(this.s[this.pos])) {
+            this.pos++;
+        }
+        const path = this.s.slice(start, this.pos);
+        if (!path) {
+            throw new Error(`Expected a field name at position ${start} in predicate`);
+        }
+        return path;
+    }
+    scanOp() {
+        this.ws();
+        for (const op of SYMBOL_OPS) {
+            if (this.s.startsWith(op, this.pos)) {
+                this.pos += op.length;
+                return op;
+            }
+        }
+        for (const op of WORD_OPS) {
+            if (this.matchWord(op)) {
+                return op;
+            }
+        }
+        throw new Error(`Expected a comparison operator at position ${this.pos} in predicate`);
+    }
+    scanArray() {
+        this.ws();
+        if (this.s[this.pos] !== '[') {
+            throw new Error('"in" expects a [list] of values');
+        }
+        this.pos++;
+        const items = [];
+        this.ws();
+        if (this.s[this.pos] === ']') {
+            this.pos++;
+            return items;
+        }
+        do {
+            items.push(this.scanValue());
+            this.ws();
+        } while (this.s[this.pos] === ',' && ++this.pos);
+        this.ws();
+        if (this.s[this.pos] !== ']') {
+            throw new Error('Unterminated [list] in predicate');
+        }
+        this.pos++;
+        return items;
+    }
+    scanValue() {
+        this.ws();
+        const c = this.s[this.pos];
+        if (c === "'" || c === '"') {
+            return this.scanString(c);
+        }
+        if (c === '-' || (c >= '0' && c <= '9')) {
+            return this.scanNumber();
+        }
+        const word = this.scanWord();
+        if (word === '') {
+            throw new Error(`Expected a value at position ${this.pos} in predicate`);
+        }
+        switch (word.toLowerCase()) {
+            case 'true':
+                return true;
+            case 'false':
+                return false;
+            case 'null':
+                return null;
+            case 'today':
+                return new Date().toISOString().slice(0, 10);
+            case 'now':
+                return new Date().toISOString();
+            default:
+                return word; // lenient: an unquoted bareword is treated as a string
+        }
+    }
+    scanString(quote) {
+        this.pos++; // opening quote
+        const start = this.pos;
+        while (this.pos < this.s.length && this.s[this.pos] !== quote) {
+            this.pos++;
+        }
+        const str = this.s.slice(start, this.pos);
+        if (this.s[this.pos] !== quote) {
+            throw new Error('Unterminated string literal in predicate');
+        }
+        this.pos++; // closing quote
+        return str;
+    }
+    scanNumber() {
+        const start = this.pos;
+        if (this.s[this.pos] === '-') {
+            this.pos++;
+        }
+        while (this.pos < this.s.length && /[0-9.]/.test(this.s[this.pos])) {
+            this.pos++;
+        }
+        const n = Number(this.s.slice(start, this.pos));
+        if (!Number.isFinite(n)) {
+            throw new Error(`Invalid number at position ${start} in predicate`);
+        }
+        return n;
+    }
+    scanWord() {
+        const start = this.pos;
+        while (this.pos < this.s.length && !STOP_CHARS.has(this.s[this.pos]) && this.s[this.pos] !== ']') {
+            this.pos++;
+        }
+        return this.s.slice(start, this.pos);
+    }
+    ws() {
+        while (this.pos < this.s.length && /\s/.test(this.s[this.pos])) {
+            this.pos++;
+        }
+    }
+    /** Match a whole keyword (case-insensitive) followed by a word boundary; consume on success. */
+    matchWord(word) {
+        this.ws();
+        const slice = this.s.slice(this.pos, this.pos + word.length);
+        if (slice.toLowerCase() !== word.toLowerCase()) {
+            return false;
+        }
+        const after = this.s[this.pos + word.length];
+        if (after !== undefined && !STOP_CHARS.has(after) && after !== '[') {
+            return false; // part of a longer identifier
+        }
+        this.pos += word.length;
+        return true;
+    }
+}
+function evaluateComparison(cmp, element) {
+    const actual = getValue(element, cmp.path) ?? null;
+    switch (cmp.op) {
+        case '==':
+            return looseEquals(actual, cmp.value);
+        case '!=':
+            return !looseEquals(actual, cmp.value);
+        case '<':
+            return compare(actual, cmp.value) < 0;
+        case '>':
+            return compare(actual, cmp.value) > 0;
+        case '<=':
+            return compare(actual, cmp.value) <= 0;
+        case '>=':
+            return compare(actual, cmp.value) >= 0;
+        case 'contains':
+            return Array.isArray(actual)
+                ? actual.some((a) => looseEquals(a, cmp.value))
+                : String(actual).includes(String(cmp.value));
+        case 'startsWith':
+            return String(actual).startsWith(String(cmp.value));
+        case 'endsWith':
+            return String(actual).endsWith(String(cmp.value));
+        case 'matches':
+            return safeRegex(String(cmp.value)).test(String(actual));
+        case 'in':
+            return cmp.value.some((v) => looseEquals(actual, v));
+        default:
+            return false;
+    }
+}
+function looseEquals(a, b) {
+    if (a === b) {
+        return true;
+    }
+    return String(a) === String(b);
+}
+/** Numeric comparison when both sides are numeric; otherwise lexicographic on their string forms. */
+function compare(a, b) {
+    const na = Number(a);
+    const nb = Number(b);
+    if (Number.isFinite(na) && Number.isFinite(nb)) {
+        return na - nb;
+    }
+    const sa = String(a);
+    const sb = String(b);
+    return sa < sb ? -1 : sa > sb ? 1 : 0;
+}
+/**
+ * Compile an LLM-authored `matches` pattern into a RegExp, guarding against catastrophic
+ * backtracking (ReDoS). `new RegExp(pattern).test(longString)` runs synchronously on the event
+ * loop, so a pattern like `(a+)+$` against a long value can hang the whole Node process. We bound
+ * the pattern length and reject patterns whose star height > 1 (the structural source of
+ * exponential backtracking) via `safe-regex`. Both failure modes throw a clear, agent-facing
+ * message so the model can rephrase the filter rather than wedge the server.
+ */
+function safeRegex(pattern) {
+    if (pattern.length > MAX_REGEX_PATTERN_LENGTH) {
+        throw new Error(`Regex in "matches" is too long (${pattern.length} > ${MAX_REGEX_PATTERN_LENGTH} chars). Simplify the pattern or use contains/startsWith/endsWith.`);
+    }
+    if (!safeRegexCheck(pattern)) {
+        throw new Error(`Regex in "matches" was rejected as unsafe (risk of catastrophic backtracking, e.g. nested quantifiers like "(a+)+"). Rewrite it without nested/overlapping repetition, or use contains/startsWith/endsWith.`);
+    }
+    try {
+        return new RegExp(pattern);
+    }
+    catch (e) {
+        throw new Error(`Invalid regex in "matches": ${e.message}`);
+    }
+}
+//# sourceMappingURL=predicate.js.map

package/dist/pipeline/predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../src/pipeline/predicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,cAAc,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC;;;GAGG;AACH,MAAM,wBAAwB,GAAG,GAAG,CAAC;AASrC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACtD,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEjF,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,GAAW;IACtC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAC/B,MAAM,CAAC,SAAS,EAAE,CAAC;IACnB,OAAO,GAAG,CAAC;AACf,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,GAAkB,EAAE,OAAkB;IACpE,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,KAAK;YACN,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,KAAK,IAAI;YACL,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,KAAK,KAAK;YACN,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,KAAK,KAAK;YACN,OAAO,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACL,CAAC;AAED,MAAM,eAAe;IAEjB,YAA6B,CAAS;QAAT,MAAC,GAAD,CAAC,CAAQ;QAD9B,QAAG,GAAG,CAAC,CAAC;IACyB,CAAC;IAEnC,SAAS;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEM,SAAS;QACZ,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;IAEO,OAAO;QACX,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjE,CAAC;IAEO,QAAQ;QACZ,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAClE,CAAC;IAEO,QAAQ;QACZ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC/B,CAAC;IAEO,YAAY;QAChB,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAClC,CAAC;IAEO,eAAe;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAEO,QAAQ;QACZ,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,eAAe,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,MAAM;QACV,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC;gBACtB,OAAO,EAAE,CAAC;YACd,CAAC;QACL,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACd,CAAC;QACL,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3F,CAAC;IAEO,SAAS;QACb,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,GAAgB,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,GAAG,CAAC;YACA,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,EAAE,EAAE,CAAC;QACd,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;QACjD,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,SAAS;QACb,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QAC7E,CAAC;QACD,QAAQ,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,KAAK,MAAM;gBACP,OAAO,IAAI,CAAC;YAChB,KAAK,OAAO;gBACR,OAAO,KAAK,CAAC;YACjB,KAAK,MAAM;gBACP,OAAO,IAAI,CAAC;YAChB,KAAK,OAAO;gBACR,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,KAAK,KAAK;gBACN,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACpC;gBACI,OAAO,IAAI,CAAC,CAAC,uDAAuD;QAC5E,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,KAAa;QAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,gBAAgB;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,gBAAgB;QAC5B,OAAO,GAAG,CAAC;IACf,CAAC;IAEO,UAAU;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,eAAe,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,CAAC;IACb,CAAC;IAEO,QAAQ;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC/F,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAEO,EAAE;QACN,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;IACL,CAAC;IAED,gGAAgG;IACxF,SAAS,CAAC,IAAY;QAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC,CAAC,8BAA8B;QAChD,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED,SAAS,kBAAkB,CAAC,GAAe,EAAE,OAAkB;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACnD,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,KAAK,IAAI;YACL,OAAO,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,CAAC;QACvD,KAAK,IAAI;YACL,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,CAAC;QACxD,KAAK,GAAG;YACJ,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,GAAG,CAAC,CAAC;QACvD,KAAK,GAAG;YACJ,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,GAAG,CAAC,CAAC;QACvD,KAAK,IAAI;YACL,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,IAAI,CAAC,CAAC;QACxD,KAAK,IAAI;YACL,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAkB,CAAC,IAAI,CAAC,CAAC;QACxD,KAAK,UAAU;YACX,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,KAAkB,CAAC,CAAC;gBAC5D,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,KAAK,YAAY;YACb,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,KAAK,UAAU;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,KAAK,SAAS;YACV,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,KAAK,IAAI;YACL,OAAQ,GAAG,CAAC,KAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E;YACI,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,CAAY,EAAE,CAAY;IAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,qGAAqG;AACrG,SAAS,OAAO,CAAC,CAAY,EAAE,CAAY;IACvC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,OAAe;IAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACX,mCAAmC,OAAO,CAAC,MAAM,MAAM,wBAAwB,oEAAoE,CACtJ,CAAC;IACN,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACX,6MAA6M,CAChN,CAAC;IACN,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+BAAgC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;AACL,CAAC"}

package/dist/pipeline/providers/action-provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Exposes a MemberJunction Action as a pipeline capability. Execution is supplied as a
+ * `runner` closure by the agent (which owns the action engine + resolved action entity), so this
+ * file never imports base-agent. Emits the action's result as a STRUCTURED value.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { ActionResult } from '@memberjunction/actions-base';
+import { PipeValue, PipelineInvocable, PipelineStepResult } from '../pipeline.types.js';
+/** Runs one already-resolved Action with the given params and returns its full result. */
+export type PipelineActionRunner = (params: Record<string, unknown>) => Promise<ActionResult>;
+export declare class ActionInvocable implements PipelineInvocable {
+    readonly toolName: string;
+    private readonly runner;
+    readonly providerKind: "Action";
+    /** Actions ignore the raw upstream `input` (the executor injects `pipeInto`/templates into params). */
+    readonly isSource = true;
+    constructor(toolName: string, runner: PipelineActionRunner);
+    invoke(_input: PipeValue, params: Record<string, unknown>): Promise<PipelineStepResult>;
+}
+//# sourceMappingURL=action-provider.d.ts.map

package/dist/pipeline/providers/action-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-provider.d.ts","sourceRoot":"","sources":["../../../src/pipeline/providers/action-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,0FAA0F;AAC1F,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAE9F,qBAAa,eAAgB,YAAW,iBAAiB;aAMjC,QAAQ,EAAE,MAAM;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAN3B,SAAgB,YAAY,EAAG,QAAQ,CAAU;IACjD,uGAAuG;IACvG,SAAgB,QAAQ,QAAQ;gBAGZ,QAAQ,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB;IAGpC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAYvG"}

package/dist/pipeline/providers/action-provider.js

@@ -0,0 +1,24 @@
+import { structureActionResult } from './serialize.js';
+export class ActionInvocable {
+    constructor(toolName, runner) {
+        this.toolName = toolName;
+        this.runner = runner;
+        this.providerKind = 'Action';
+        /** Actions ignore the raw upstream `input` (the executor injects `pipeInto`/templates into params). */
+        this.isSource = true;
+    }
+    async invoke(_input, params) {
+        try {
+            const result = await this.runner(params);
+            const logRef = { providerKind: 'Action', actionExecutionLogId: result.LogEntry?.ID };
+            if (!result.Success) {
+                return { output: null, success: false, error: result.Message ?? `Action "${this.toolName}" failed.`, logRef };
+            }
+            return { output: structureActionResult(result), success: true, logRef };
+        }
+        catch (e) {
+            return { output: null, success: false, error: e.message, logRef: { providerKind: 'Action' } };
+        }
+    }
+}
+//# sourceMappingURL=action-provider.js.map

package/dist/pipeline/providers/action-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-provider.js","sourceRoot":"","sources":["../../../src/pipeline/providers/action-provider.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKpD,MAAM,OAAO,eAAe;IAKxB,YACoB,QAAgB,EACf,MAA4B;QAD7B,aAAQ,GAAR,QAAQ,CAAQ;QACf,WAAM,GAAN,MAAM,CAAsB;QANjC,iBAAY,GAAG,QAAiB,CAAC;QACjD,uGAAuG;QACvF,aAAQ,GAAG,IAAI,CAAC;IAK7B,CAAC;IAEG,KAAK,CAAC,MAAM,CAAC,MAAiB,EAAE,MAA+B;QAClE,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,EAAE,YAAY,EAAE,QAAiB,EAAE,oBAAoB,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC9F,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,WAAW,IAAI,CAAC,QAAQ,WAAW,EAAE,MAAM,EAAE,CAAC;YAClH,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC7G,CAAC;IACL,CAAC;CACJ"}

package/dist/pipeline/providers/artifact-tool-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Exposes an artifact tool as a pipeline capability. The target artifact is selected at
+ * call time via a `params.artifactId`. Execution is a `runner` closure bound to the agent's
+ * ArtifactToolManager. Emits the tool's `data` as a STRUCTURED value.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { ArtifactToolResult } from '@memberjunction/ai-core-plus';
+import { PipeValue, PipelineInvocable, PipelineStepResult } from '../pipeline.types.js';
+/** Runs one artifact tool (resolving the target artifact from `params.artifactId`). */
+export type PipelineArtifactRunner = (toolName: string, params: Record<string, unknown>) => Promise<ArtifactToolResult>;
+export declare class ArtifactToolInvocable implements PipelineInvocable {
+    readonly toolName: string;
+    private readonly runner;
+    readonly providerKind: "ArtifactTool";
+    readonly isSource = true;
+    constructor(toolName: string, runner: PipelineArtifactRunner);
+    invoke(_input: PipeValue, params: Record<string, unknown>): Promise<PipelineStepResult>;
+}
+//# sourceMappingURL=artifact-tool-provider.d.ts.map

package/dist/pipeline/providers/artifact-tool-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tool-provider.d.ts","sourceRoot":"","sources":["../../../src/pipeline/providers/artifact-tool-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,uFAAuF;AACvF,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAExH,qBAAa,qBAAsB,YAAW,iBAAiB;aAKvC,QAAQ,EAAE,MAAM;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL3B,SAAgB,YAAY,EAAG,cAAc,CAAU;IACvD,SAAgB,QAAQ,QAAQ;gBAGZ,QAAQ,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB;IAGtC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAgBvG"}

package/dist/pipeline/providers/artifact-tool-provider.js

@@ -0,0 +1,27 @@
+import { structureArtifactData } from './serialize.js';
+export class ArtifactToolInvocable {
+    constructor(toolName, runner) {
+        this.toolName = toolName;
+        this.runner = runner;
+        this.providerKind = 'ArtifactTool';
+        this.isSource = true;
+    }
+    async invoke(_input, params) {
+        try {
+            const result = await this.runner(this.toolName, params);
+            if (!result.success) {
+                return {
+                    output: null,
+                    success: false,
+                    error: result.errorMessage ?? `Artifact tool "${this.toolName}" failed.`,
+                    logRef: { providerKind: 'ArtifactTool' },
+                };
+            }
+            return { output: structureArtifactData(result.data), success: true, logRef: { providerKind: 'ArtifactTool' } };
+        }
+        catch (e) {
+            return { output: null, success: false, error: e.message, logRef: { providerKind: 'ArtifactTool' } };
+        }
+    }
+}
+//# sourceMappingURL=artifact-tool-provider.js.map

package/dist/pipeline/providers/artifact-tool-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tool-provider.js","sourceRoot":"","sources":["../../../src/pipeline/providers/artifact-tool-provider.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKpD,MAAM,OAAO,qBAAqB;IAI9B,YACoB,QAAgB,EACf,MAA8B;QAD/B,aAAQ,GAAR,QAAQ,CAAQ;QACf,WAAM,GAAN,MAAM,CAAwB;QALnC,iBAAY,GAAG,cAAuB,CAAC;QACvC,aAAQ,GAAG,IAAI,CAAC;IAK7B,CAAC;IAEG,KAAK,CAAC,MAAM,CAAC,MAAiB,EAAE,MAA+B;QAClE,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;oBACH,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,kBAAkB,IAAI,CAAC,QAAQ,WAAW;oBACxE,MAAM,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE;iBAC3C,CAAC;YACN,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,CAAC;QACnH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,CAAC;QACnH,CAAC;IACL,CAAC;CACJ"}

package/dist/pipeline/providers/serialize.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Adapters that turn each capability's native result into a structured {@link PipeValue}.
+ * The whole point of the object model: do NOT stringify here — emit the structure so downstream
+ * operators can bind to properties.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { ActionResult } from '@memberjunction/actions-base';
+import { PipeValue } from '../pipeline.types.js';
+/**
+ * Structure an Action's output as a value: one output param → its value; many → an object keyed by
+ * name; none → the Message. String values that are clearly JSON are parsed so structured operators
+ * work on real action payloads (e.g. a RunView that returns its rows as a JSON string).
+ */
+export declare function structureActionResult(result: ActionResult): PipeValue;
+/**
+ * Structure arbitrary artifact-tool `data` as a value. `get_full` returns a
+ * `{ content, encoding, sizeBytes }` envelope — unwrap it to the real content (parsing JSON text)
+ * so a `get_full` source composes directly with the operators (`where`/`select`/…). Other tools
+ * return their data directly.
+ */
+export declare function structureArtifactData(data: unknown): PipeValue;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/pipeline/providers/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/pipeline/providers/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAYrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAa9D"}

package/dist/pipeline/providers/serialize.js

@@ -0,0 +1,99 @@
+/**
+ * Structure an Action's output as a value: one output param → its value; many → an object keyed by
+ * name; none → the Message. String values that are clearly JSON are parsed so structured operators
+ * work on real action payloads (e.g. a RunView that returns its rows as a JSON string).
+ */
+export function structureActionResult(result) {
+    const outputs = (result.Params ?? []).filter((p) => p.Type === 'Output');
+    if (outputs.length === 1) {
+        return coerceMaybeJson(outputs[0].Value);
+    }
+    if (outputs.length > 1) {
+        return outputs.reduce((acc, p) => {
+            acc[p.Name] = coerceMaybeJson(p.Value);
+            return acc;
+        }, {});
+    }
+    return result.Message ?? null;
+}
+/**
+ * Structure arbitrary artifact-tool `data` as a value. `get_full` returns a
+ * `{ content, encoding, sizeBytes }` envelope — unwrap it to the real content (parsing JSON text)
+ * so a `get_full` source composes directly with the operators (`where`/`select`/…). Other tools
+ * return their data directly.
+ */
+export function structureArtifactData(data) {
+    if (isGetFullEnvelope(data)) {
+        const env = data;
+        if (typeof env.content === 'string' && env.encoding !== 'base64') {
+            return coerceMaybeJson(env.content);
+        }
+        return env.content; // base64/binary — leave as-is
+    }
+    const rows = unwrapRowsEnvelope(data);
+    if (rows !== undefined) {
+        return rows;
+    }
+    return coerceMaybeJson(data);
+}
+/**
+ * Tabular artifact tools (`get_rows` on CSV / Excel / Data Snapshot / Search Result Set) wrap their
+ * rows in an envelope — `{ rows: [...], total, ... }`. Object-aware operators (`where`/`select`/
+ * `distinct`/`sort`) need a bare array, so unwrap to the rows array directly: the agent shouldn't
+ * have to know the envelope shape and lead every tabular pipeline with `{ "jsonpath": "$.rows[*]" }`.
+ *
+ * Pagination metadata (`total`/`totalRows`/`truncated`) is intentionally dropped from the pipe — the
+ * agent controls paging via the tool's own `start`/`count` params, not by reading it back mid-flow.
+ *
+ * Returns `undefined` (not unwrapped) when `data` isn't a rows-envelope, so the caller falls through.
+ */
+function unwrapRowsEnvelope(data) {
+    if (data !== null &&
+        typeof data === 'object' &&
+        !Array.isArray(data) &&
+        Array.isArray(data.rows)) {
+        return data.rows;
+    }
+    return undefined;
+}
+function isGetFullEnvelope(d) {
+    return (d !== null &&
+        typeof d === 'object' &&
+        !Array.isArray(d) &&
+        'content' in d &&
+        'sizeBytes' in d);
+}
+/**
+ * Pass values through; parse strings that are *clearly* a JSON object/array so structured operators
+ * can bind to them (e.g. an Action that returns its rows as a JSON string).
+ *
+ * Deliberately conservative: we only attempt a parse when the trimmed string both opens AND closes
+ * with matching JSON delimiters (`{…}` / `[…]`) AND the parse yields an object/array. This avoids
+ * mis-parsing prose like `"[Note: see attached]"` or `"{TBD}"` (a leading bracket alone isn't enough),
+ * and never coerces a bare JSON scalar (`"42"`, `"true"`) — those stay strings. A string that isn't
+ * unambiguously a JSON container is returned verbatim.
+ *
+ * Known nuance: an Action returning structured data vs. the same data as a JSON string still converge
+ * here by design (that's the point — operators shouldn't care which). What we will NOT do is guess at
+ * partial/ambiguous text.
+ */
+function coerceMaybeJson(v) {
+    if (typeof v !== 'string') {
+        return v;
+    }
+    const t = v.trim();
+    const looksLikeContainer = (t.startsWith('{') && t.endsWith('}')) || (t.startsWith('[') && t.endsWith(']'));
+    if (!looksLikeContainer) {
+        return v;
+    }
+    try {
+        const parsed = JSON.parse(t);
+        // Only treat it as structured if it actually parsed to an object/array — never a coincidental
+        // scalar — otherwise hand back the original string untouched.
+        return parsed !== null && typeof parsed === 'object' ? parsed : v;
+    }
+    catch {
+        return v;
+    }
+}
+//# sourceMappingURL=serialize.js.map

package/dist/pipeline/providers/serialize.js.map

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

package/dist/pipeline/template.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview `{{ path }}` templating for `tool` stage params. Resolves against a scope of named
+ * bindings: `$` is the current upstream value, plus any `map` element binding (e.g. `row`) or `let`
+ * binding. Paths use the shared field-path grammar (no eval).
+ *
+ * - A param whose value is exactly one `{{ path }}` resolves to the RAW value (object/number/array).
+ * - A param with embedded `{{ path }}` inside other text does string interpolation (coerced to text).
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { PipeValue } from './pipeline.types.js';
+/** Binding scope: `$` = current upstream value; other keys = map/let bindings. */
+export type TemplateScope = Record<string, PipeValue>;
+/** Recursively resolve templates in a tool's `with` params object. */
+export declare function resolveParams(params: Record<string, unknown>, scope: TemplateScope): Record<string, unknown>;
+/** Resolve a scoped path like `row.Email` or `$.Results[0].Name`. Throws on an unknown binding. */
+export declare function resolvePath(path: string, scope: TemplateScope): PipeValue | undefined;
+//# sourceMappingURL=template.d.ts.map

package/dist/pipeline/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/pipeline/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAKtD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5G;AAuBD,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,CAiBrF"}

package/dist/pipeline/template.js

@@ -0,0 +1,47 @@
+import { getValue } from './path.js';
+import { valueToText } from './coerce.js';
+const WHOLE = /^\s*\{\{\s*([^}]+?)\s*\}\}\s*$/;
+const EMBEDDED = /\{\{\s*([^}]+?)\s*\}\}/g;
+/** Recursively resolve templates in a tool's `with` params object. */
+export function resolveParams(params, scope) {
+    return resolveValue(params, scope);
+}
+function resolveValue(value, scope) {
+    if (typeof value === 'string') {
+        return resolveString(value, scope);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveValue(v, scope));
+    }
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolveValue(v, scope)]));
+    }
+    return value;
+}
+function resolveString(s, scope) {
+    const whole = WHOLE.exec(s);
+    if (whole) {
+        return resolvePath(whole[1], scope); // raw value
+    }
+    return s.replace(EMBEDDED, (_m, path) => valueToText(resolvePath(path, scope) ?? null));
+}
+/** Resolve a scoped path like `row.Email` or `$.Results[0].Name`. Throws on an unknown binding. */
+export function resolvePath(path, scope) {
+    const trimmed = path.trim();
+    const varMatch = /^[A-Za-z_$][A-Za-z0-9_]*/.exec(trimmed);
+    if (!varMatch) {
+        throw new Error(`Invalid template path "{{${path}}}"`);
+    }
+    const varName = varMatch[0];
+    if (!(varName in scope)) {
+        const available = Object.keys(scope).join(', ');
+        throw new Error(`Unknown binding "${varName}" in {{${path}}}. Available: ${available}`);
+    }
+    const root = scope[varName];
+    let rest = trimmed.slice(varName.length);
+    if (rest.startsWith('.')) {
+        rest = rest.slice(1);
+    }
+    return rest === '' ? root : getValue(root, rest);
+}
+//# sourceMappingURL=template.js.map

package/dist/pipeline/template.js.map

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