parse-stack-next 5.0.1 → 5.1.0

data/docs/yard-template/default/fulldoc/html/css/full_list.css

@@ -0,0 +1,387 @@
+body {
+	margin: 0;
+	font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif;
+	font-size: 13px;
+	height: 101%;
+	overflow-x: hidden;
+	background: #fafafa;
+}
+
+h1 {
+	padding: 12px 10px;
+	padding-bottom: 0;
+	margin: 0;
+	font-size: 1.4em;
+}
+.clear {
+	clear: both;
+}
+.fixed_header {
+	position: fixed;
+	background: #fff;
+	width: 100%;
+	padding-bottom: 10px;
+	margin-top: 0;
+	top: 0;
+	z-index: 9999;
+	height: 70px;
+}
+#search {
+	position: absolute;
+	right: 5px;
+	top: 9px;
+	padding-left: 24px;
+}
+#noresults {
+	padding: 7px 12px;
+	background: #fff;
+}
+#content.insearch #search,
+#content.insearch #noresults {
+	background: url(data:image/gif;base64,R0lGODlhEAAQAPYAAP///wAAAPr6+pKSkoiIiO7u7sjIyNjY2J6engAAAI6OjsbGxjIyMlJSUuzs7KamppSUlPLy8oKCghwcHLKysqSkpJqamvT09Pj4+KioqM7OzkRERAwMDGBgYN7e3ujo6Ly8vCoqKjY2NkZGRtTU1MTExDw8PE5OTj4+PkhISNDQ0MrKylpaWrS0tOrq6nBwcKysrLi4uLq6ul5eXlxcXGJiYoaGhuDg4H5+fvz8/KKiohgYGCwsLFZWVgQEBFBQUMzMzDg4OFhYWBoaGvDw8NbW1pycnOLi4ubm5kBAQKqqqiQkJCAgIK6urnJyckpKSjQ0NGpqatLS0sDAwCYmJnx8fEJCQlRUVAoKCggICLCwsOTk5ExMTPb29ra2tmZmZmhoaNzc3KCgoBISEiIiIgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH/C05FVFNDQVBFMi4wAwEAAAAh/hpDcmVhdGVkIHdpdGggYWpheGxvYWQuaW5mbwAh+QQJCAAAACwAAAAAEAAQAAAHaIAAgoMgIiYlg4kACxIaACEJCSiKggYMCRselwkpghGJBJEcFgsjJyoAGBmfggcNEx0flBiKDhQFlIoCCA+5lAORFb4AJIihCRbDxQAFChAXw9HSqb60iREZ1omqrIPdJCTe0SWI09GBACH5BAkIAAAALAAAAAAQABAAAAdrgACCgwc0NTeDiYozCQkvOTo9GTmDKy8aFy+NOBA7CTswgywJDTIuEjYFIY0JNYMtKTEFiRU8Pjwygy4ws4owPyCKwsMAJSTEgiQlgsbIAMrO0dKDGMTViREZ14kYGRGK38nHguHEJcvTyIEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDAggPg4iJAAMJCRUAJRIqiRGCBI0WQEEJJkWDERkYAAUKEBc4Po1GiKKJHkJDNEeKig4URLS0ICImJZAkuQAhjSi/wQyNKcGDCyMnk8u5rYrTgqDVghgZlYjcACTA1sslvtHRgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCQARAtOUoQRGRiFD0kJUYWZhUhKT1OLhR8wBaaFBzQ1NwAlkIszCQkvsbOHL7Y4q4IuEjaqq0ZQD5+GEEsJTDCMmIUhtgk1lo6QFUwJVDKLiYJNUd6/hoEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4uen4ICCA+IkIsDCQkVACWmhwSpFqAABQoQF6ALTkWFnYMrVlhWvIKTlSAiJiVVPqlGhJkhqShHV1lCW4cMqSkAR1ofiwsjJyqGgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCSMhREZGIYYGY2ElYebi56fhyWQniSKAKKfpaCLFlAPhl0gXYNGEwkhGYREUywag1wJwSkHNDU3D0kJYIMZQwk8MjPBLx9eXwuETVEyAC/BOKsuEjYFhoEAIfkECQgAAAAsAAAAABAAEAAAB2eAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4ueICImip6CIQkJKJ4kigynKaqKCyMnKqSEK05StgAGQRxPYZaENqccFgIID4KXmQBhXFkzDgOnFYLNgltaSAAEpxa7BQoQF4aBACH5BAkIAAAALAAAAAAQABAAAAdogACCg4SFggJiPUqCJSWGgkZjCUwZACQkgxGEXAmdT4UYGZqCGWQ+IjKGGIUwPzGPhAc0NTewhDOdL7Ykji+dOLuOLhI2BbaFETICx4MlQitdqoUsCQ2vhKGjglNfU0SWmILaj43M5oEAOwAAAAAAAAAAAA==)
+		no-repeat center left;
+}
+#full_list {
+	padding: 0;
+	list-style: none;
+	margin-left: 0;
+	margin-top: 80px;
+	font-size: 1.1em;
+}
+#full_list ul {
+	padding: 0;
+}
+#full_list li {
+	padding: 0;
+	margin: 0;
+	list-style: none;
+}
+#full_list li .item {
+	padding: 5px 5px 5px 12px;
+}
+#content.insearch #noresults {
+	margin-left: 7px;
+}
+#full_list li {
+	color: #666;
+	cursor: normal;
+	white-space: nowrap;
+}
+#full_list li.collapsed ul {
+	display: none;
+}
+#full_list li a.toggle {
+	cursor: default;
+	position: relative;
+	left: -5px;
+	top: 4px;
+	text-indent: -999px;
+	width: 10px;
+	height: 9px;
+	margin-left: -10px;
+	display: block;
+	float: left;
+	background: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAASCAYAAABb0P4QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAK8AAACvABQqw0mAAAABx0RVh0U29mdHdhcmUAQWRvYmUgRmlyZXdvcmtzIENTM5jWRgMAAAAVdEVYdENyZWF0aW9uIFRpbWUAMy8xNC8wOeNZPpQAAAE2SURBVDiNrZTBccIwEEXfelIAHUA6CZ24BGaWO+FuzZAK4k6gg5QAdGAq+Bxs2Yqx7BzyL7Llp/VfzZeQhCTc/ezuGzKKnKSzpCxXJM8fwNXda3df5RZETlIt6YUzSQDs93sl8w3wBZxCCE10GM1OcWbWjB2mWgEH4Mfdyxm3PSepBHibgQE2wLe7r4HjEidpnXMYdQPKEMJcsZ4zs2POYQOcaPfwMVOo58zsAdMt18BuoVDPxUJRacELbXv3hUIX2vYmOUvi8C8ydz/ThjXrqKqqLbDIAdsCKBd+Wo7GWa7o9qzOQHVVVXeAbs+yHHCH4aTsaCOQqunmUy1yBUAXkdMIfMlgF5EXLo2OpV/c/Up7jG4hhHcYLgWzAZXUc2b2ixsfvc/RmNNfOXD3Q/oeL9axJE1yT9IOoUu6MGUkAAAAAElFTkSuQmCC)
+		no-repeat bottom left;
+}
+#full_list li.collapsed a.toggle {
+	cursor: default;
+	background-position: top left;
+}
+#full_list li.deprecated {
+	text-decoration: line-through;
+	font-style: italic;
+}
+#full_list li.odd {
+	background: #f0f0f0;
+}
+#full_list li.even {
+	background: #fafafa;
+}
+#full_list .item:hover {
+	background: #ddd;
+}
+#full_list li small:before {
+	content: "(";
+}
+#full_list li small:after {
+	content: ")";
+}
+#full_list li small.search_info {
+	display: none;
+}
+a,
+a:visited {
+	text-decoration: none;
+	color: #05a;
+}
+#full_list li.clicked > .item {
+	background: #05a;
+	color: #ccc;
+}
+#full_list li.clicked > .item a,
+#full_list li.clicked > .item a:visited {
+	color: #eee;
+}
+#full_list li.clicked > .item a.toggle {
+	opacity: 0.5;
+	background-position: bottom right;
+}
+#full_list li.collapsed.clicked a.toggle {
+	background-position: top right;
+}
+#search input {
+	border: 1px solid #bbb;
+	border-radius: 3px;
+}
+#full_list_nav {
+	margin-left: 10px;
+	font-size: 0.9em;
+	display: block;
+	color: #aaa;
+}
+#full_list_nav a,
+#nav a:visited {
+	color: #358;
+}
+#full_list_nav a:hover {
+	background: transparent;
+	color: #5af;
+}
+#full_list_nav span:after {
+	content: " | ";
+}
+#full_list_nav span:last-child:after {
+	content: "";
+}
+
+#content h1 {
+	margin-top: 0;
+}
+#full_list li small {
+	display: block;
+	font-size: 0.8em;
+}
+#full_list li small:before {
+	content: "";
+}
+#full_list li small:after {
+	content: "";
+}
+#full_list li small.search_info {
+	display: none;
+}
+#search {
+	width: 170px;
+	position: static;
+	margin: 3px;
+	margin-left: 10px;
+	font-size: 0.9em;
+	color: #666;
+	padding-left: 0;
+	padding-right: 24px;
+}
+#content.insearch #search {
+	background-position: center right;
+}
+#search input {
+	width: 110px;
+}
+
+#full_list.insearch ul {
+	display: block;
+}
+#full_list.insearch .item {
+	display: none;
+}
+#full_list.insearch .found {
+	display: block;
+	padding-left: 11px;
+}
+#full_list.insearch li a.toggle {
+	display: none;
+}
+#full_list.insearch li small.search_info {
+	display: block;
+}
+
+/* ============================================================
+ * parse-stack-next overlay (sidebar / class-list iframe)
+ * ============================================================ */
+
+:root {
+	--ps-bg:        #1E1F22;
+	--ps-bg-soft:   #2A2C30;
+	--ps-bg-hover:  #34373C;
+	--ps-fg:        #E6E8EB;
+	--ps-fg-muted:  #9CA3AF;
+	--ps-accent:    #E63946;
+	--ps-link:      #4FB8F4;
+	--ps-border:    #3A3D42;
+	--ps-font:      -apple-system, BlinkMacSystemFont, "Segoe UI", "Inter",
+	                Roboto, "Helvetica Neue", Arial, sans-serif;
+}
+
+body {
+	background: var(--ps-bg) !important;
+	color: var(--ps-fg);
+	font-family: var(--ps-font);
+	font-size: 13px;
+}
+
+h1 {
+	color: var(--ps-fg);
+	font-weight: 650;
+	letter-spacing: -0.01em;
+}
+
+.fixed_header {
+	background: var(--ps-bg-soft) !important;
+	border-bottom: 1px solid var(--ps-border);
+	box-shadow: 0 1px 3px rgba(0, 0, 0, .3);
+}
+
+#search input,
+#full_list_search input {
+	background: var(--ps-bg) !important;
+	color: var(--ps-fg) !important;
+	border: 1px solid var(--ps-border) !important;
+	border-radius: 4px;
+	padding: 4px 8px;
+	font-family: var(--ps-font);
+}
+
+#search input::placeholder { color: var(--ps-fg-muted); }
+
+#full_list li,
+#full_list li .item {
+	color: var(--ps-fg);
+	border: 0;
+}
+
+#full_list li.odd  { background: transparent; }
+#full_list li.even { background: rgba(255, 255, 255, .025); }
+
+#full_list li a,
+#full_list li .item a,
+#full_list li a:visited,
+#full_list li .item a:visited {
+	color: var(--ps-fg);
+}
+
+#full_list .item:hover,
+#full_list li:hover,
+#full_list li:hover .item {
+	background: var(--ps-bg-hover) !important;
+	color: var(--ps-fg);
+}
+
+#full_list li.clicked > .item,
+#full_list li.clicked > .item a,
+#full_list li.clicked > .item a:visited {
+	background: var(--ps-accent) !important;
+	color: #fff !important;
+	border-color: var(--ps-accent) !important;
+}
+
+#full_list li small  { color: var(--ps-fg-muted); }
+#full_list_nav       { color: var(--ps-fg-muted); }
+
+#full_list_nav a,
+#full_list_nav a:visited { color: var(--ps-link); }
+#full_list_nav a:hover   { color: var(--ps-accent); }
+
+#noresults {
+	background: var(--ps-bg-soft);
+	color: var(--ps-fg-muted);
+	border-radius: 4px;
+}
+
+::-webkit-scrollbar          { width: 8px; height: 8px; }
+::-webkit-scrollbar-track    { background: var(--ps-bg); }
+::-webkit-scrollbar-thumb    { background: #4a4d52; border-radius: 4px; }
+::-webkit-scrollbar-thumb:hover { background: var(--ps-link); }
+
+/* ============================================================
+ * Re-pin iframe-only layout values that common.css would otherwise
+ * stomp on.
+ *
+ * Both stylesheets are loaded inside the class-list iframe AND the
+ * main page. common.css generously styles tags like h1, #content,
+ * #header for the main page, where their layout role is "big page
+ * heading" / "main content column" / "top nav". Inside the iframe
+ * those same selectors mean "Class List" / "sidebar viewport" /
+ * "fixed top strip", and the sizes need to be drastically smaller.
+ * Re-pin them explicitly here so the iframe doesn't inherit the
+ * main-page proportions.
+ * ============================================================ */
+
+#full_list_header,
+body > #content > .fixed_header > h1,
+.fixed_header h1 {
+	font-size: 1.4em !important;
+	font-weight: 650;
+	padding: 12px 10px 4px !important;
+	margin: 0 !important;
+	border: 0 !important;
+	display: block !important;
+	color: var(--ps-fg);
+	letter-spacing: -0.01em;
+	line-height: 1.2;
+}
+
+/* Reserve clearance for the fixed_header. With the larger header
+ * font + the flex search row, the stock 80px margin isn't enough. */
+body > #content > #full_list {
+	margin-top: 120px !important;
+}
+
+/* The iframe's #content is just a passive scroll container, not the
+ * main-page article column. Wipe any main-page color/padding rules. */
+body > #content {
+	background: var(--ps-bg) !important;
+	color: var(--ps-fg);
+	padding: 0;
+	margin: 0;
+}
+
+/* Top nav strip: "Classes | Methods | Files" links. */
+#full_list_nav {
+	padding: 0 10px;
+	font-size: 0.85em;
+	color: var(--ps-fg-muted);
+}
+
+/* Search row inside the fixed header — keep it on one line. */
+.fixed_header #search {
+	display: flex;
+	align-items: center;
+	gap: 6px;
+	padding: 4px 10px 0;
+	width: auto;
+}
+
+.fixed_header #search label {
+	color: var(--ps-fg-muted);
+	font-size: 0.85em;
+}
+
+.fixed_header #search input {
+	flex: 1 1 auto;
+	min-width: 0;
+}
+
+/* Belt-and-braces: the fixed strip must be opaque and above the list. */
+.fixed_header {
+	background: var(--ps-bg-soft) !important;
+	z-index: 9999;
+	height: auto;
+	min-height: 70px;
+	padding-bottom: 8px;
+}
+
+/* The collapse toggle PNG is a dark-on-transparent sprite; invert it
+ * so the arrow shows on dark backgrounds. */
+#full_list li a.toggle {
+	filter: invert(0.85) hue-rotate(180deg) brightness(1.6);
+}

data/lib/parse/agent/tools.rb

@@ -469,6 +469,35 @@ module Parse
             },
             required: ["class_name", "pipeline"],
           },
+          output_schema: {
+            type: "object",
+            properties: {
+              class_name:      { type: "string" },
+              pipeline_stages: { type: "integer", minimum: 0 },
+              result_count:    { type: "integer", minimum: 0 },
+              # `route` is :mongo_direct or :parse_server but serializes
+              # to a Symbol-shaped String in JSON envelopes; declare it
+              # permissively as string.
+              route:           { type: "string", description: "Routing tag: 'mongo_direct' or 'parse_server'." },
+              # Aggregation result rows are class-shape-dependent and may
+              # be the output of arbitrary $project / $group / $lookup
+              # stages. Object envelopes with open property sets are the
+              # honest representation.
+              results: {
+                type: "array",
+                items: { type: "object", additionalProperties: true },
+              },
+              pointer_classes: {
+                type: "object",
+                additionalProperties: { type: "string" },
+                description: "Optional. Field-name → Parse-class-name map when compact_pointers is on.",
+              },
+              auto_limited: { type: "boolean" },
+              auto_limit:   { type: "integer", minimum: 1 },
+              hint:         { type: "string" },
+            },
+            required: %w[class_name pipeline_stages result_count route results],
+          },
         },
 
         explain_query: {
@@ -753,6 +782,25 @@ module Parse
             },
             required: ["class_name"],
           },
+          output_schema: {
+            type: "object",
+            properties: {
+              class_name: { type: "string" },
+              # `format` is one of csv|markdown|table; same shape as the
+              # input enum.
+              format:  { type: "string", enum: %w[csv markdown table] },
+              headers: { type: "array", items: { type: "string" } },
+              row_count: { type: "integer", minimum: 0 },
+              # The serialized output is the formatted CSV / Markdown /
+              # text-table string itself — clients render it as-is.
+              output:  { type: "string" },
+              truncated:      { type: "boolean" },
+              available_rows: { type: "integer", minimum: 0 },
+              row_cap:        { type: "integer", minimum: 1 },
+              hint:           { type: "string" },
+            },
+            required: %w[class_name format headers row_count output],
+          },
         },
 
         atlas_text_search: {
@@ -799,6 +847,50 @@ module Parse
             },
             required: %w[class_name query],
           },
+          output_schema: {
+            type: "object",
+            properties: {
+              class_name: { type: "string" },
+              count:      { type: "integer", minimum: 0 },
+              # Each row is a Parse object projected through the class's
+              # agent_fields allowlist, with an Atlas-supplied `score`
+              # numeric and an optional `highlights` array when the
+              # caller passes highlight_field:. The row shape is class-
+              # dependent so additionalProperties is open.
+              results: {
+                type: "array",
+                items: {
+                  type: "object",
+                  properties: {
+                    score: { type: "number" },
+                    highlights: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          path: { type: "string" },
+                          texts: {
+                            type: "array",
+                            items: {
+                              type: "object",
+                              properties: {
+                                value: { type: "string" },
+                                type:  { type: "string", description: "'hit' or 'text' per Atlas spec." },
+                              },
+                              required: %w[value],
+                            },
+                          },
+                        },
+                        required: %w[path],
+                      },
+                    },
+                  },
+                  additionalProperties: true,
+                },
+              },
+            },
+            required: %w[class_name count results],
+          },
         },
 
         atlas_autocomplete: {
@@ -838,6 +930,25 @@ module Parse
             },
             required: %w[class_name query field],
           },
+          output_schema: {
+            type: "object",
+            properties: {
+              class_name: { type: "string" },
+              field:      { type: "string" },
+              # `suggestions` is the list of distinct field values that
+              # matched the autocomplete query (deduped, ordered by Atlas
+              # ranking). Strings only — autocomplete operates on text.
+              suggestions: { type: "array", items: { type: "string" } },
+              count:       { type: "integer", minimum: 0 },
+              # Full matching Parse objects, projected through the class
+              # agent_fields allowlist.
+              results: {
+                type: "array",
+                items: { type: "object", additionalProperties: true },
+              },
+            },
+            required: %w[class_name field suggestions count results],
+          },
         },
 
         atlas_faceted_search: {
@@ -876,6 +987,40 @@ module Parse
             },
             required: %w[class_name facets],
           },
+          output_schema: {
+            type: "object",
+            properties: {
+              class_name:  { type: "string" },
+              # $searchMeta lower-bound count. May be approximate for very
+              # large corpora — Atlas documents this; downstream clients
+              # should treat it as informative, not a precise total.
+              total_count: { type: "integer", minimum: 0 },
+              # Facets is a Map<facet_name, { buckets: [{_id, count}] }>.
+              # Bucket _id is heterogeneous (String for string facets,
+              # Number/Date for numeric/date facets), so additionalProperties:true
+              # on the bucket entry keeps the contract honest without
+              # bloating the schema with per-type variants.
+              facets: {
+                type: "object",
+                additionalProperties: {
+                  type: "object",
+                  properties: {
+                    buckets: {
+                      type: "array",
+                      items: { type: "object", additionalProperties: true },
+                    },
+                  },
+                  required: %w[buckets],
+                },
+              },
+              count:   { type: "integer", minimum: 0 },
+              results: {
+                type: "array",
+                items: { type: "object", additionalProperties: true },
+              },
+            },
+            required: %w[class_name total_count facets count results],
+          },
         },
       }.freeze
 
@@ -3474,7 +3619,14 @@ module Parse
             class_name: class_name,
             pipeline_stages: pipeline.size,
             result_count: results.size,
-            route: use_mongo_direct ? :mongo_direct : :parse_server,
+            # Coerce to String here so the value lands in
+            # `structuredContent` as a String (matching the
+            # advertised output_schema `type: "string"`). Without the
+            # `.to_s`, MCP clients validating structuredContent see a
+            # Ruby Symbol pre-serialization and fail the type check;
+            # downstream JSON serialization would convert it but the
+            # client-side validator runs before that.
+            route: (use_mongo_direct ? :mongo_direct : :parse_server).to_s,
             results: results,
           }
           result[:pointer_classes] = pointer_map if pointer_map.any?

data/lib/parse/cache/redis.rb

@@ -118,6 +118,59 @@ module Parse
         @pool.increment(key, amount, options)
       end
 
+      # Lua compare-and-delete: delete `key` only if its current value
+      # equals `expected`. Atomic on the Redis server (the GET, the
+      # compare, and the DEL are one script invocation), which closes the
+      # check-then-delete race in a naive GET-then-DEL release where the
+      # lease can expire and be re-acquired by another holder between the
+      # two commands.
+      LOCK_RELEASE_SCRIPT = <<~LUA
+        if redis.call('get', KEYS[1]) == ARGV[1] then
+          return redis.call('del', KEYS[1])
+        else
+          return 0
+        end
+      LUA
+
+      # Atomically acquire a lock: SET key=owner only if absent, with a
+      # native expiry. Used by {Parse::LockBackend} for {Parse::Lock} and
+      # {Parse::CreateLock}. Deliberately bypasses Moneta's `create` —
+      # `Moneta.new(:Redis)` marshals BOTH keys and values, so a raw-Redis
+      # compare-and-delete on the marshaled blob would be fragile and
+      # coupled to Moneta's serializer config. Routing acquire AND release
+      # through plain-string raw Redis here keeps one consistent encoding
+      # across both ends of the lock and makes the keys human-inspectable
+      # in Redis (`parse-stack:lock:v1:<digest>`). Lock keys are
+      # short-lived (TTL ≤ 30s) so there is no migration concern when a
+      # deploy flips between the Moneta-encoded and raw-encoded paths.
+      #
+      # @param key [String] plain-string lock key.
+      # @param owner [String] unique-per-acquisition owner token.
+      # @param ttl [Integer] seconds until the key self-clears.
+      # @return [Boolean] true when the key was set (lock acquired).
+      def lock_acquire(key, owner, ttl)
+        @pool.pool.with do |store|
+          redis = backend_client(store)
+          # redis-rb returns "OK" on success, nil when NX fails.
+          !!redis.set(key, owner, nx: true, ex: ttl)
+        end
+      end
+
+      # Atomically release a lock via compare-and-delete. Only the holder
+      # whose `owner` token still matches the stored value deletes the
+      # key — a holder whose lease already expired and was re-acquired by
+      # someone else is a no-op, never a cross-holder delete.
+      #
+      # @param key [String] plain-string lock key.
+      # @param owner [String] the owner token from {#lock_acquire}.
+      # @return [Boolean] true when this owner's key was deleted.
+      def lock_release(key, owner)
+        @pool.pool.with do |store|
+          redis = backend_client(store)
+          redis.eval(LOCK_RELEASE_SCRIPT, keys: [key], argv: [owner]).to_i == 1
+        end
+      end
+
       # Clear cached entries belonging to this wrapper. Required for
       # `Parse::Client#clear_cache!` compatibility.
       #

data/lib/parse/client/caching.rb

@@ -143,6 +143,19 @@ module Parse
           @cache_key = "mk:#{@cache_key}" # prefix for master key requests
         end
 
+        # Optional ambient cache-tenant scope from `Parse.with_cache_tenant`.
+        # When present, composes between the configured namespace and the
+        # token/mk prefix as `T:<tenant>:` so a SCAN-delete over
+        # `<namespace>:T:<tenant>:*` evicts exactly one tenant, and
+        # `<namespace>:*` still evicts the whole namespace cleanly. The
+        # `T:` discriminator makes tenant prefixes unambiguously
+        # distinguishable from session-token hex prefixes (32-char hex)
+        # and from `mk:`, so legacy cache entries written before the
+        # tenant feature don't accidentally re-hydrate into a tenanted
+        # request and vice versa.
+        @cache_tenant = Parse.respond_to?(:current_cache_tenant) ? Parse.current_cache_tenant : nil
+        @cache_key = "T:#{@cache_tenant}:#{@cache_key}" if @cache_tenant
+
         # Namespace outermost so a SCAN over `<namespace>:*` evicts a whole
         # tenant/app cleanly without touching another app's entries.
         @cache_key = "#{@namespace}:#{@cache_key}" if @namespace
@@ -277,7 +290,11 @@ module Parse
       # @!visibility private
       def instrument_cache(event, **extra)
         return unless defined?(ActiveSupport::Notifications)
-        payload = { event: event, namespace: @namespace }.merge!(extra)
+        payload = {
+          event: event,
+          namespace: @namespace,
+          cache_tenant: @cache_tenant,
+        }.merge!(extra)
         ActiveSupport::Notifications.instrument("parse.cache.#{event}", payload)
       end