@mindstudio-ai/agent 0.1.58 → 0.1.60

package/dist/index.js

@@ -275,7 +275,7 @@ function serializeParam(val) {
 function serializeColumnParam(val, columnName, columns) {
   const col = columns.find((c) => c.name === columnName);
   if (col?.type === "user" && typeof val === "string") {
-    return `@@user@@${val}`;
+    return val.startsWith(USER_PREFIX) ? val : `${USER_PREFIX}${val}`;
   }
   return serializeParam(val);
 }
@@ -293,7 +293,7 @@ function deserializeRow(row, columns) {
   const result = {};
   for (const [key, value] of Object.entries(row)) {
     const col = columns.find((c) => c.name === key);
-    if (col?.type === "user" && typeof value === "string" && value.startsWith(USER_PREFIX)) {
+    if (typeof value === "string" && value.startsWith(USER_PREFIX)) {
       result[key] = value.slice(USER_PREFIX.length);
     } else if (col?.type === "json" && typeof value === "string") {
       try {
@@ -396,16 +396,16 @@ function stripSystemColumns(data) {
 }
 
 // src/db/predicate.ts
-function compilePredicate(fn) {
+function compilePredicate(fn, bindings) {
   try {
     const source = fn.toString();
-    const paramName = extractParamName(source);
-    if (!paramName) return { type: "js", fn, reason: "could not extract parameter name" };
+    const names = extractParamNames(source);
+    if (!names) return { type: "js", fn, reason: "could not extract parameter name" };
     const body = extractBody(source);
     if (!body) return { type: "js", fn, reason: "could not extract function body" };
     const tokens = tokenize(body);
     if (tokens.length === 0) return { type: "js", fn, reason: "empty token stream" };
-    const parser = new Parser(tokens, paramName, fn);
+    const parser = new Parser(tokens, names.row, names.bindings, bindings, fn);
     const ast = parser.parseExpression();
     if (!ast) return { type: "js", fn, reason: "could not parse expression" };
     if (parser.pos < tokens.length) return { type: "js", fn, reason: "unexpected tokens after expression" };
@@ -416,11 +416,44 @@ function compilePredicate(fn) {
     return { type: "js", fn, reason: `compilation error: ${err?.message || "unknown"}` };
   }
 }
-function extractParamName(source) {
-  const match = source.match(
-    /^\s*(?:\(?\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*(?::[^)]*?)?\)?\s*=>)/
-  );
-  return match?.[1] ?? null;
+function extractParamNames(source) {
+  const arrowIdx = source.indexOf("=>");
+  if (arrowIdx === -1) return null;
+  let paramList = source.slice(0, arrowIdx).trim();
+  if (paramList.startsWith("(") && paramList.endsWith(")")) {
+    paramList = paramList.slice(1, -1).trim();
+  }
+  if (paramList.length === 0) return null;
+  const parts = splitParams(paramList);
+  if (parts.length === 0 || parts.length > 2) return null;
+  const row = stripTypeAnnotation(parts[0]);
+  if (!row) return null;
+  if (parts.length === 1) return { row };
+  const bindings = stripTypeAnnotation(parts[1]);
+  if (!bindings) return null;
+  return { row, bindings };
+}
+function splitParams(input) {
+  const parts = [];
+  let depth = 0;
+  let current = "";
+  for (const ch of input) {
+    if (ch === "<" || ch === "(") depth++;
+    else if (ch === ">" || ch === ")") depth--;
+    if (ch === "," && depth === 0) {
+      parts.push(current.trim());
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current.trim()) parts.push(current.trim());
+  return parts;
+}
+function stripTypeAnnotation(part) {
+  const colonIdx = part.indexOf(":");
+  const name = (colonIdx === -1 ? part : part.slice(0, colonIdx)).trim();
+  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : null;
 }
 function extractBody(source) {
   const arrowIdx = source.indexOf("=>");
@@ -531,9 +564,11 @@ function tokenize(expr) {
   return tokens;
 }
 var Parser = class {
-  constructor(tokens, paramName, originalFn) {
+  constructor(tokens, paramName, bindingsName, bindingsValue, originalFn) {
     this.tokens = tokens;
     this.paramName = paramName;
+    this.bindingsName = bindingsName;
+    this.bindingsValue = bindingsValue;
     this.originalFn = originalFn;
   }
   pos = 0;
@@ -630,6 +665,9 @@ var Parser = class {
     if (this.match("identifier", this.paramName)) {
       return this.parseFieldExpression();
     }
+    if (this.bindingsName && this.match("identifier", this.bindingsName)) {
+      return this.parseBindingsArrayIncludes();
+    }
     if (this.match("identifier")) {
       return this.parseNonParamExpression();
     }
@@ -666,6 +704,7 @@ var Parser = class {
     if (!this.match("identifier")) return null;
     const parts = [this.advance().value];
     while (this.match("dot") && this.tokens[this.pos + 1]?.type === "identifier") {
+      if (this.tokens[this.pos + 2]?.type === "lparen") break;
       this.advance();
       parts.push(this.advance().value);
     }
@@ -750,6 +789,68 @@ var Parser = class {
     if (ident === "true" || ident === "false") return null;
     return null;
   }
+  /**
+   * Parse `$.ids.includes(o.field)` → IN expression with resolved values.
+   * The bindings identifier has been peeked but not consumed.
+   *
+   * Falls back (returns null) if the resolved bindings value isn't an array,
+   * or if the path doesn't exist on the bindings object.
+   */
+  parseBindingsArrayIncludes() {
+    const bound = this.tryResolveBindingsValue();
+    if (bound === PARSE_FAILED) return null;
+    if (!Array.isArray(bound)) return null;
+    if (!this.eat("dot")) return null;
+    if (!this.match("identifier", "includes")) return null;
+    this.advance();
+    if (!this.eat("lparen")) return null;
+    if (!this.match("identifier", this.paramName)) return null;
+    this.advance();
+    const field = this.parseFieldPath();
+    if (!field) return null;
+    if (!this.eat("rparen")) return null;
+    return { kind: "in", field, values: bound };
+  }
+  /**
+   * If the current token is the bindings parameter name, walk a dotted path
+   * (`$.foo.bar`) and resolve the value from the bindings object. Returns
+   * the resolved value or `PARSE_FAILED`.
+   *
+   * Stops walking before a method call (e.g. doesn't consume `.includes` in
+   * `$.ids.includes(...)`) so the caller can dispatch on what follows.
+   *
+   * Restores `pos` on failure so callers can fall through cleanly.
+   */
+  tryResolveBindingsValue() {
+    if (!this.bindingsName) return PARSE_FAILED;
+    if (!this.match("identifier", this.bindingsName)) return PARSE_FAILED;
+    if (this.bindingsValue == null) return PARSE_FAILED;
+    const startPos = this.pos;
+    this.advance();
+    const path = [];
+    while (this.match("dot") && this.tokens[this.pos + 1]?.type === "identifier") {
+      if (this.tokens[this.pos + 2]?.type === "lparen") break;
+      this.advance();
+      path.push(this.advance().value);
+    }
+    if (path.length === 0) {
+      this.pos = startPos;
+      return PARSE_FAILED;
+    }
+    let value = this.bindingsValue;
+    for (const key of path) {
+      if (value == null || typeof value !== "object") {
+        this.pos = startPos;
+        return PARSE_FAILED;
+      }
+      value = value[key];
+    }
+    if (value === void 0) {
+      this.pos = startPos;
+      return PARSE_FAILED;
+    }
+    return value;
+  }
   /**
    * Parse a literal value or closure variable reference.
    *
@@ -784,6 +885,10 @@ var Parser = class {
         this.advance();
         return void 0;
       }
+      if (this.bindingsName && t.value === this.bindingsName) {
+        const bound = this.tryResolveBindingsValue();
+        if (bound !== PARSE_FAILED) return bound;
+      }
       return this.resolveClosureVariable();
     }
     if (t.type === "operator" && t.value === "-") {
@@ -918,11 +1023,10 @@ var Query = class _Query {
       rawWhereParams: this._rawWhereParams
     });
   }
-  // -------------------------------------------------------------------------
-  // Chain methods
-  // -------------------------------------------------------------------------
-  filter(predicate) {
-    return this._clone({ predicates: [...this._predicates, predicate] });
+  filter(predicate, bindings) {
+    return this._clone({
+      predicates: [...this._predicates, { fn: predicate, bindings }]
+    });
   }
   sortBy(accessor) {
     return this._clone({ sortAccessor: accessor });
@@ -979,7 +1083,7 @@ var Query = class _Query {
     if (this._predicates.length === 0) return true;
     const allRows = await this._fetchAllRows();
     return allRows.every(
-      (row) => this._predicates.every((pred) => pred(row))
+      (row) => this._predicates.every((p) => p.fn(row, p.bindings))
     );
   }
   min(accessor) {
@@ -1067,7 +1171,7 @@ var Query = class _Query {
     if (compiled.query) {
       return compiled.postProcess ? compiled.postProcess(rows) : rows;
     }
-    let filtered = compiled.predicates ? rows.filter((row) => compiled.predicates.every((pred) => pred(row))) : rows;
+    let filtered = compiled.predicates ? rows.filter((row) => compiled.predicates.every((p) => p.fn(row, p.bindings))) : rows;
     if (compiled.sortAccessor) {
       const accessor = compiled.sortAccessor;
       const reversed = compiled.reversed ?? false;
@@ -1157,7 +1261,7 @@ var Query = class _Query {
     if (this._predicates.length === 0) {
       return { allSql: true, sqlWhere: "", compiled: [] };
     }
-    const compiled = this._predicates.map((pred) => compilePredicate(pred));
+    const compiled = this._predicates.map((p) => compilePredicate(p.fn, p.bindings));
     const allSql = compiled.every((c) => c.type === "sql");
     let sqlWhere = "";
     if (allSql) {
@@ -1176,7 +1280,7 @@ var Query = class _Query {
       );
     }
     return allRows.filter(
-      (row) => this._predicates.every((pred) => pred(row))
+      (row) => this._predicates.every((p) => p.fn(row, p.bindings))
     );
   }
   async _fetchAllRows() {
@@ -1296,21 +1400,18 @@ var Table = class {
       postProcess: (rows) => rows[0] ?? null
     });
   }
-  /** Find the first row matching a predicate. Returns null if none match. */
-  findOne(predicate) {
-    return this.filter(predicate).first();
+  findOne(predicate, bindings) {
+    return this.filter(predicate, bindings).first();
   }
-  count(predicate) {
-    if (predicate) return this.filter(predicate).count();
+  count(predicate, bindings) {
+    if (predicate) return this.filter(predicate, bindings).count();
     return this.toArray().count();
   }
-  /** True if any row matches the predicate. */
-  some(predicate) {
-    return this.filter(predicate).some();
+  some(predicate, bindings) {
+    return this.filter(predicate, bindings).some();
   }
-  /** True if all rows match the predicate. */
-  async every(predicate) {
-    return this.filter(predicate).every();
+  async every(predicate, bindings) {
+    return this.filter(predicate, bindings).every();
   }
   /** True if the table has zero rows. */
   async isEmpty() {
@@ -1335,9 +1436,8 @@ var Table = class {
   toArray() {
     return new Query(this._config);
   }
-  /** Filter rows by a predicate. Returns a chainable Query. */
-  filter(predicate) {
-    return new Query(this._config).filter(predicate);
+  filter(predicate, bindings) {
+    return new Query(this._config).filter(predicate, bindings);
   }
   /** Sort rows by a field. Returns a chainable Query. */
   sortBy(accessor) {
@@ -1419,11 +1519,8 @@ var Table = class {
       deleted: results[0].changes > 0
     }));
   }
-  /**
-   * Remove all rows matching a predicate. Returns the count removed.
-   */
-  removeAll(predicate) {
-    const compiled = compilePredicate(predicate);
+  removeAll(predicate, bindings) {
+    const compiled = compilePredicate(predicate, bindings);
     if (compiled.type === "sql") {
       const query = buildDelete(this._config.tableName, compiled.where);
       return new Mutation(this._config, [query], (results) => results[0].changes);
@@ -1440,7 +1537,7 @@ var Table = class {
           this._config.columns
         )
       );
-      const matching = allRows.filter((row) => predicate(row));
+      const matching = allRows.filter((row) => predicate(row, bindings));
       if (matching.length === 0) return 0;
       const deleteQueries = matching.filter((row) => row.id).map((row) => buildDelete(this._config.tableName, `id = ?`, [row.id]));
       if (deleteQueries.length > 0) {
@@ -1592,6 +1689,8 @@ function createDb(databases, executeBatch, authConfig, syncRoles) {
     minutes: (n) => n * 6e4,
     ago: (ms) => Date.now() - ms,
     fromNow: (ms) => Date.now() + ms,
+    // --- User references ---
+    userRef: (id) => id.startsWith(USER_PREFIX) ? id.slice(USER_PREFIX.length) : id,
     // --- Batch execution ---
     batch: ((...operations) => {
       return (async () => {
@@ -2160,13 +2259,6 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "mediaUrl": { "type": "string", "description": "URL of the audio or video file to analyze" } }, "required": ["mediaUrl"] },
     outputSchema: { "type": "object", "properties": { "metadata": { "type": "string", "description": "JSON string containing the media file metadata" } }, "required": ["metadata"] }
   },
-  "httpRequest": {
-    stepType: "httpRequest",
-    description: "Make an HTTP request to an external endpoint and return the response.",
-    usageNotes: "- Supports GET, POST, PATCH, DELETE, and PUT methods.\n- Body can be raw JSON/text, URL-encoded form data, or multipart form data.",
-    inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "The request URL" }, "method": { "type": "string", "description": "HTTP method (GET, POST, PATCH, DELETE, or PUT)" }, "headers": { "type": "object", "properties": {}, "required": [], "description": "Custom request headers as key-value pairs" }, "queryParams": { "type": "object", "properties": {}, "required": [], "description": "Query string parameters as key-value pairs" }, "body": { "type": "string", "description": "Raw request body (used for JSON or custom content types)" }, "bodyItems": { "type": "object", "properties": {}, "required": [], "description": "Key-value body items (used for form data or URL-encoded content types)" }, "contentType": { "enum": ["none", "application/json", "application/x-www-form-urlencoded", "multipart/form-data", "custom"], "type": "string", "description": "The content type for the request body" }, "customContentType": { "type": "string", "description": 'Custom Content-Type header value (used when contentType is "custom")' }, "testData": { "type": "object", "properties": {}, "required": [], "description": "Test data for debug/preview mode" } }, "required": ["url", "method", "headers", "queryParams", "body", "bodyItems", "contentType", "customContentType"], "description": "HTTP request configuration" },
-    outputSchema: { "type": "object", "properties": { "ok": { "type": "boolean", "description": "Whether the HTTP response status code is in the 2xx range" }, "status": { "type": "number", "description": "HTTP response status code" }, "statusText": { "type": "string", "description": "HTTP response status text" }, "response": { "type": "string", "description": "Response body as a string" } }, "required": ["ok", "status", "statusText", "response"] }
-  },
   "hubspotCreateCompany": {
     stepType: "hubspotCreateCompany",
     description: "Create a new company or update an existing one in HubSpot. Matches by domain.",
@@ -3272,9 +3364,6 @@ function applyStepMethods(AgentClass) {
   proto.getMediaMetadata = function(step, options) {
     return this.executeStep("getMediaMetadata", step, options);
   };
-  proto.httpRequest = function(step, options) {
-    return this.executeStep("httpRequest", step, options);
-  };
   proto.hubspotCreateCompany = function(step, options) {
     return this.executeStep("hubspotCreateCompany", step, options);
   };
@@ -3626,7 +3715,11 @@ var MindStudioAgent = class {
   get _currentHttpConfig() {
     const rctx = getRequestContext();
     if (rctx?.remoteHostname) {
-      return { ...this._httpConfig, baseUrl: rctx.remoteHostname, token: this._token };
+      return {
+        ...this._httpConfig,
+        baseUrl: rctx.remoteHostname,
+        token: this._token
+      };
     }
     return this._httpConfig;
   }
@@ -3642,7 +3735,11 @@ var MindStudioAgent = class {
   _getContext() {
     const rctx = getRequestContext();
     if (rctx?.auth && rctx?.databases) {
-      return { auth: rctx.auth, databases: rctx.databases, authConfig: rctx.authConfig };
+      return {
+        auth: rctx.auth,
+        databases: rctx.databases,
+        authConfig: rctx.authConfig
+      };
     }
     return this._context;
   }
@@ -3705,7 +3802,8 @@ var MindStudioAgent = class {
       const res = await fetch(pollUrl, {
         headers: { "User-Agent": "@mindstudio-ai/agent" }
       });
-      if (res.status === 502 || res.status === 503 || res.status === 504) continue;
+      if (res.status === 502 || res.status === 503 || res.status === 504)
+        continue;
       if (res.status === 404) {
         throw new MindStudioError(
           `[${stepType}] Execution token expired.`,
@@ -3802,7 +3900,9 @@ var MindStudioAgent = class {
           const errMsg = (typeof body2.error === "string" ? body2.error : void 0) ?? (typeof body2.message === "string" ? body2.message : void 0) ?? (typeof body2.details === "string" ? body2.details : void 0);
           if (errMsg) message = errMsg;
           else if (body2.error || body2.message || body2.details) {
-            message = JSON.stringify(body2.error ?? body2.message ?? body2.details);
+            message = JSON.stringify(
+              body2.error ?? body2.message ?? body2.details
+            );
           }
           if (body2.code) code = body2.code;
         } catch {
@@ -3811,7 +3911,12 @@ var MindStudioAgent = class {
         }
       } catch {
       }
-      throw new MindStudioError(`[${stepType}] ${message}`, code, res.status, details);
+      throw new MindStudioError(
+        `[${stepType}] ${message}`,
+        code,
+        res.status,
+        details
+      );
     }
     const headers = res.headers;
     try {
@@ -3943,7 +4048,10 @@ var MindStudioAgent = class {
   async executeStepBatch(steps, options) {
     const threadId = options?.threadId ?? (this._reuseThreadId && !getRequestContext() ? this._threadId : void 0);
     const { data: asyncData } = await request(this._currentHttpConfig, "POST", "/steps/execute-batch-async", {
-      steps: steps.map((s) => ({ ...s, stepType: resolveStepType2(s.stepType) })),
+      steps: steps.map((s) => ({
+        ...s,
+        stepType: resolveStepType2(s.stepType)
+      })),
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId }
     });
@@ -3955,7 +4063,8 @@ var MindStudioAgent = class {
       const res = await fetch(pollUrl, {
         headers: { "User-Agent": "@mindstudio-ai/agent" }
       });
-      if (res.status === 502 || res.status === 503 || res.status === 504) continue;
+      if (res.status === 502 || res.status === 503 || res.status === 504)
+        continue;
       if (res.status === 404) {
         throw new MindStudioError(
           "Batch poll token not found or expired.",
@@ -4119,7 +4228,8 @@ var MindStudioAgent = class {
       const res = await fetch(pollUrl, {
         headers: { "User-Agent": "@mindstudio-ai/agent" }
       });
-      if (res.status === 502 || res.status === 503 || res.status === 504) continue;
+      if (res.status === 502 || res.status === 503 || res.status === 504)
+        continue;
       if (res.status === 404) {
         throw new MindStudioError(
           "Poll token not found or expired.",
@@ -4235,6 +4345,15 @@ var MindStudioAgent = class {
     );
     return data;
   }
+  /** List packaged workflows available to the organization. */
+  async listPackagedWorkflows() {
+    const { data } = await request(
+      this._currentHttpConfig,
+      "GET",
+      "/helpers/packaged-workflows"
+    );
+    return data;
+  }
   // -------------------------------------------------------------------------
   // Helper methods — cost estimation
   // -------------------------------------------------------------------------
@@ -4465,7 +4584,9 @@ var MindStudioAgent = class {
           const errMsg = (typeof body.error === "string" ? body.error : void 0) ?? (typeof body.message === "string" ? body.message : void 0) ?? (typeof body.details === "string" ? body.details : void 0);
           if (errMsg) message = errMsg;
           else if (body.error || body.message || body.details) {
-            message = JSON.stringify(body.error ?? body.message ?? body.details);
+            message = JSON.stringify(
+              body.error ?? body.message ?? body.details
+            );
           }
           if (body.code) code = body.code;
         } catch {
@@ -4473,11 +4594,7 @@ var MindStudioAgent = class {
         }
       } catch {
       }
-      throw new MindStudioError(
-        `[db] ${message}`,
-        code,
-        res.status
-      );
+      throw new MindStudioError(`[db] ${message}`, code, res.status);
     }
     const data = await res.json();
     return data.results;
@@ -4572,6 +4689,7 @@ var MindStudioAgent = class {
       minutes: (n) => n * 6e4,
       ago: (ms) => Date.now() - ms,
       fromNow: (ms) => Date.now() + ms,
+      userRef: (id) => id.startsWith("@@user@@") ? id.slice("@@user@@".length) : id,
       // Batch needs context — hydrate first, then delegate to real db
       batch: ((...queries) => {
         return (async () => {
@@ -4686,9 +4804,14 @@ var MindStudioAgent = class {
   }
   /** Update the profile picture of the authenticated user/agent. */
   async changeProfilePicture(url) {
-    await request(this._currentHttpConfig, "POST", "/account/change-profile-picture", {
-      url
-    });
+    await request(
+      this._currentHttpConfig,
+      "POST",
+      "/account/change-profile-picture",
+      {
+        url
+      }
+    );
   }
   /**
    * Upload a file to the MindStudio CDN.
@@ -4744,8 +4867,7 @@ function resolveToken(provided, config) {
   if (provided) return { token: provided, authType: "apiKey" };
   if (process.env.MINDSTUDIO_API_KEY)
     return { token: process.env.MINDSTUDIO_API_KEY, authType: "apiKey" };
-  if (config?.apiKey)
-    return { token: config.apiKey, authType: "apiKey" };
+  if (config?.apiKey) return { token: config.apiKey, authType: "apiKey" };
   throw new MindStudioError(
     "No API key provided. Run `mindstudio login`, pass `apiKey` to the constructor, or set the MINDSTUDIO_API_KEY environment variable.",
     "missing_api_key",
@@ -4818,7 +4940,6 @@ var monacoSnippets = {
   "getGoogleDriveFile": { fields: [["fileId", "string"]], outputKeys: ["url", "name", "mimeType", "size"] },
   "getGoogleSheetInfo": { fields: [["documentId", "string"]], outputKeys: ["title", "sheets"] },
   "getMediaMetadata": { fields: [["mediaUrl", "string"]], outputKeys: ["metadata"] },
-  "httpRequest": { fields: [["url", "string"], ["method", "string"], ["headers", "object"], ["queryParams", "object"], ["body", "string"], ["bodyItems", "object"], ["contentType", ["none", "application/json", "application/x-www-form-urlencoded", "multipart/form-data", "custom"]], ["customContentType", "string"]], outputKeys: ["ok", "status", "statusText", "response"] },
   "hubspotCreateCompany": { fields: [["company", "object"], ["enabledProperties", "array"]], outputKeys: ["companyId"] },
   "hubspotCreateContact": { fields: [["contact", "object"], ["enabledProperties", "array"], ["companyDomain", "string"]], outputKeys: ["contactId"] },
   "hubspotGetCompany": { fields: [["searchBy", ["domain", "id"]], ["companyDomain", "string"], ["companyId", "string"], ["additionalProperties", "array"]], outputKeys: ["company"] },