@rozenite/controls-plugin 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @rozenite/controls-plugin
+
+## 1.5.0
+
+### Minor Changes
+
+- [#190](https://github.com/callstackincubator/rozenite/pull/190) [`5ae53a4`](https://github.com/callstackincubator/rozenite/commit/5ae53a4b509adbd8536ea24812f7ca523a95b625) Thanks [@V3RON](https://github.com/V3RON)! - Added Rozenite for Agents support to the Controls, MMKV, React Navigation, and Storage plugins.
+
+### Patch Changes
+
+- Updated dependencies [[`5ae53a4`](https://github.com/callstackincubator/rozenite/commit/5ae53a4b509adbd8536ea24812f7ca523a95b625)]:
+  - @rozenite/agent-bridge@1.5.0
+  - @rozenite/plugin-bridge@1.5.0

package/dist/rozenite.json

@@ -1 +1 @@
-{"name":"@rozenite/controls-plugin","version":"0.0.0","description":"Device-owned controls for Rozenite.","panels":[{"name":"Controls","source":"/panel.html"}]}
+{"name":"@rozenite/controls-plugin","version":"1.5.0","description":"A Rozenite plugin for exposing app-defined controls directly in React Native DevTools.","panels":[{"name":"Controls","source":"/panel.html"}]}

package/dist/src/react-native/useControlsAgentTools.d.ts

@@ -0,0 +1,2 @@
+import { ControlsSection } from '../shared/types';
+export declare const useControlsAgentTools: (sections: ControlsSection[]) => void;

package/dist/useRozeniteControlsPlugin.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const $=require("@rozenite/plugin-bridge"),i=require("react"),g=(e,t)=>e?e(t):{valid:!0},R=e=>e.type==="text"?e:e.type==="toggle"?{id:e.id,type:e.type,title:e.title,value:e.value,description:e.description,disabled:e.disabled}:e.type==="button"?{id:e.id,type:e.type,title:e.title,actionLabel:e.actionLabel,description:e.description,disabled:e.disabled}:e.type==="select"?{id:e.id,type:e.type,title:e.title,value:e.value,options:e.options,description:e.description,disabled:e.disabled}:{id:e.id,type:e.type,title:e.title,value:e.value,placeholder:e.placeholder,applyLabel:e.applyLabel,description:e.description,disabled:e.disabled},U=e=>e.map(t=>({id:t.id,title:t.title,description:t.description,items:t.items.map(R)})),P=e=>{const t=new Map;return e.forEach(u=>{u.items.forEach(n=>{const l=`${u.id}:${n.id}`;n.type==="toggle"&&t.set(l,{type:"toggle",validate:n.validate,onUpdate:n.onUpdate}),n.type==="button"&&t.set(l,{type:"button",onPress:n.onPress}),n.type==="select"&&t.set(l,{type:"select",validate:n.validate,onUpdate:n.onUpdate}),n.type==="input"&&t.set(l,{type:"input",validate:n.validate,onUpdate:n.onUpdate})})}),t},f=(e,t)=>`${e}:${t}`,z=({sections:e})=>{const t=$.useRozeniteDevToolsClient({pluginId:"@rozenite/controls-plugin"}),u=i.useMemo(()=>U(e),[e]),n=i.useMemo(()=>P(e),[e]),l=i.useRef(n);return i.useEffect(()=>{l.current=n},[n]),i.useEffect(()=>{t&&t.send("snapshot",{type:"snapshot",sections:u})},[t,u]),i.useEffect(()=>{if(!t)return;const v=async({requestId:s,sectionId:r,itemId:o,value:p})=>{const d=f(r,o),a=l.current.get(d);if(!a||a.type==="button"){t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:"Update target not found."});return}try{if(a.type==="toggle"){if(typeof p!="boolean"){t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:"Invalid toggle value."});return}const y=g(a.validate,p);if(!y.valid){t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:y.message});return}await a.onUpdate(p),t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"ok"});return}if(typeof p!="string"){t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:`Invalid ${a.type} value.`});return}const c=g(a.validate,p);if(!c.valid){t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:c.message});return}await a.onUpdate(p),t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"ok"})}catch(c){console.warn(`[Rozenite] Controls Plugin: Update failed for ${r}/${o}.`,c),t.send("update-result",{type:"update-result",requestId:s,sectionId:r,itemId:o,status:"error",message:"Update failed on the device."})}},b=async({sectionId:s,itemId:r,action:o})=>{if(o!=="press"){console.warn(`[Rozenite] Controls Plugin: Unsupported action "${o}" for ${s}/${r}.`);return}const p=f(s,r),d=l.current.get(p);if(!d){console.warn(`[Rozenite] Controls Plugin: Action target not found for ${s}/${r}.`);return}try{if(d.type!=="button"){console.warn(`[Rozenite] Controls Plugin: Invalid press action payload for ${s}/${r}.`);return}await d.onPress()}catch(a){console.warn(`[Rozenite] Controls Plugin: Action failed for ${s}/${r}.`,a)}},h=[t.onMessage("get-snapshot",()=>{t.send("snapshot",{type:"snapshot",sections:u})}),t.onMessage("update-request",s=>{v(s)}),t.onMessage("invoke-action",s=>{b(s)})];return()=>{h.forEach(s=>s.remove())}},[t,u]),t};exports.useRozeniteControlsPlugin=z;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("@rozenite/plugin-bridge"),c=require("react"),f=require("@rozenite/agent-bridge"),w=(o,t)=>o?o(t):{valid:!0},U=o=>o.type==="text"?o:o.type==="toggle"?{id:o.id,type:o.type,title:o.title,value:o.value,description:o.description,disabled:o.disabled}:o.type==="button"?{id:o.id,type:o.type,title:o.title,actionLabel:o.actionLabel,description:o.description,disabled:o.disabled}:o.type==="select"?{id:o.id,type:o.type,title:o.title,value:o.value,options:o.options,description:o.description,disabled:o.disabled}:{id:o.id,type:o.type,title:o.title,value:o.value,placeholder:o.placeholder,applyLabel:o.applyLabel,description:o.description,disabled:o.disabled},P=o=>o.map(t=>({id:t.id,title:t.title,description:t.description,items:t.items.map(U)})),z=o=>{const t=new Map;return o.forEach(n=>{n.items.forEach(e=>{const i=`${n.id}:${e.id}`;e.type==="toggle"&&t.set(i,{type:"toggle",validate:e.validate,onUpdate:e.onUpdate}),e.type==="button"&&t.set(i,{type:"button",onPress:e.onPress}),e.type==="select"&&t.set(i,{type:"select",validate:e.validate,onUpdate:e.onUpdate}),e.type==="input"&&t.set(i,{type:"input",validate:e.validate,onUpdate:e.onUpdate})})}),t},$=(o,t)=>`${o}:${t}`,b="@rozenite/controls-plugin",S={name:"list-sections",description:"List all controls sections with their item IDs, types, and titles. Does not include values — call get-item for that.",inputSchema:{type:"object",properties:{}}},A={name:"get-item",description:"Get full details of a single controls item including its current value. For select items this includes available options.",inputSchema:{type:"object",properties:{sectionId:{type:"string",description:"Section ID."},itemId:{type:"string",description:"Item ID."}},required:["sectionId","itemId"]}},T={name:"set-value",description:"Update the value of a toggle, select, or input item. Runs the validate callback when present. Fails for text (read-only) and button items.",inputSchema:{type:"object",properties:{sectionId:{type:"string",description:"Section ID."},itemId:{type:"string",description:"Item ID."},value:{description:"New value. Boolean for toggle items, string for select/input items."}},required:["sectionId","itemId","value"]}},C={name:"press-button",description:"Trigger a button item's action. Fails if the item is not a button or is disabled.",inputSchema:{type:"object",properties:{sectionId:{type:"string",description:"Section ID."},itemId:{type:"string",description:"Item ID."}},required:["sectionId","itemId"]}},v=(o,t,n)=>{const e=o.find(s=>s.id===t);if(!e){const s=o.map(u=>u.id).join(", ");throw new Error(`Section "${t}" not found. Available: ${s||"(none)"}`)}const i=e.items.find(s=>s.id===n);if(!i){const s=e.items.map(u=>u.id).join(", ");throw new Error(`Item "${n}" not found in section "${t}". Available: ${s||"(none)"}`)}return{section:e,item:i}},D=o=>{f.useRozenitePluginAgentTool({pluginId:b,tool:S,handler:()=>({sections:o.map(t=>({id:t.id,title:t.title,description:t.description,items:t.items.map(n=>({id:n.id,type:n.type,title:n.title,disabled:"disabled"in n?n.disabled:void 0}))}))})}),f.useRozenitePluginAgentTool({pluginId:b,tool:A,handler:({sectionId:t,itemId:n})=>{const{item:e}=v(o,t,n);return e.type==="text"?{sectionId:t,item:{id:e.id,type:e.type,title:e.title,value:e.value,description:e.description}}:e.type==="toggle"?{sectionId:t,item:{id:e.id,type:e.type,title:e.title,value:e.value,description:e.description,disabled:e.disabled}}:e.type==="button"?{sectionId:t,item:{id:e.id,type:e.type,title:e.title,actionLabel:e.actionLabel,description:e.description,disabled:e.disabled}}:e.type==="select"?{sectionId:t,item:{id:e.id,type:e.type,title:e.title,value:e.value,options:e.options,description:e.description,disabled:e.disabled}}:{sectionId:t,item:{id:e.id,type:e.type,title:e.title,value:e.value,placeholder:e.placeholder,applyLabel:e.applyLabel,description:e.description,disabled:e.disabled}}}}),f.useRozenitePluginAgentTool({pluginId:b,tool:T,handler:async({sectionId:t,itemId:n,value:e})=>{const{item:i}=v(o,t,n);if(i.type==="text")throw new Error(`Item "${n}" is a read-only text item and cannot be updated.`);if(i.type==="button")throw new Error(`Item "${n}" is a button. Use press-button to trigger its action.`);if(i.disabled)throw new Error(`Item "${n}" is disabled.`);if(i.type==="toggle"){if(typeof e!="boolean")throw new Error(`Expected boolean value for toggle item "${n}".`);if(i.validate){const s=i.validate(e);if(!s.valid)throw new Error(s.message)}return await i.onUpdate(e),{applied:!0,sectionId:t,itemId:n}}if(typeof e!="string")throw new Error(`Expected string value for ${i.type} item "${n}".`);if(i.type==="select"){const s=i.options.map(u=>u.value);if(!s.includes(e))throw new Error(`Invalid option "${e}" for item "${n}". Valid options: ${s.join(", ")}`)}if(i.validate){const s=i.validate(e);if(!s.valid)throw new Error(s.message)}return await i.onUpdate(e),{applied:!0,sectionId:t,itemId:n}}}),f.useRozenitePluginAgentTool({pluginId:b,tool:C,handler:async({sectionId:t,itemId:n})=>{const{item:e}=v(o,t,n);if(e.type!=="button")throw new Error(`Item "${n}" is not a button (type: ${e.type}). Use set-value to update its value.`);if(e.disabled)throw new Error(`Button "${n}" is disabled.`);return await e.onPress(),{pressed:!0,sectionId:t,itemId:n}}})},L=({sections:o})=>{const t=R.useRozeniteDevToolsClient({pluginId:"@rozenite/controls-plugin"});D(o);const n=c.useMemo(()=>P(o),[o]),e=c.useMemo(()=>z(o),[o]),i=c.useRef(e);return c.useEffect(()=>{i.current=e},[e]),c.useEffect(()=>{t&&t.send("snapshot",{type:"snapshot",sections:n})},[t,n]),c.useEffect(()=>{if(!t)return;const s=async({requestId:r,sectionId:a,itemId:l,value:d})=>{const y=$(a,l),p=i.current.get(y);if(!p||p.type==="button"){t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:"Update target not found."});return}try{if(p.type==="toggle"){if(typeof d!="boolean"){t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:"Invalid toggle value."});return}const h=w(p.validate,d);if(!h.valid){t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:h.message});return}await p.onUpdate(d),t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"ok"});return}if(typeof d!="string"){t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:`Invalid ${p.type} value.`});return}const g=w(p.validate,d);if(!g.valid){t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:g.message});return}await p.onUpdate(d),t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"ok"})}catch(g){console.warn(`[Rozenite] Controls Plugin: Update failed for ${a}/${l}.`,g),t.send("update-result",{type:"update-result",requestId:r,sectionId:a,itemId:l,status:"error",message:"Update failed on the device."})}},u=async({sectionId:r,itemId:a,action:l})=>{if(l!=="press"){console.warn(`[Rozenite] Controls Plugin: Unsupported action "${l}" for ${r}/${a}.`);return}const d=$(r,a),y=i.current.get(d);if(!y){console.warn(`[Rozenite] Controls Plugin: Action target not found for ${r}/${a}.`);return}try{if(y.type!=="button"){console.warn(`[Rozenite] Controls Plugin: Invalid press action payload for ${r}/${a}.`);return}await y.onPress()}catch(p){console.warn(`[Rozenite] Controls Plugin: Action failed for ${r}/${a}.`,p)}},E=[t.onMessage("get-snapshot",()=>{t.send("snapshot",{type:"snapshot",sections:n})}),t.onMessage("update-request",r=>{s(r)}),t.onMessage("invoke-action",r=>{u(r)})];return()=>{E.forEach(r=>r.remove())}},[t,n]),t};exports.useRozeniteControlsPlugin=L;

package/dist/useRozeniteControlsPlugin.js

@@ -1,226 +1,420 @@
 import { useRozeniteDevToolsClient as R } from "@rozenite/plugin-bridge";
-import { useMemo as f, useRef as U, useEffect as y } from "react";
-const g = (e, t) => e ? e(t) : { valid: !0 }, w = (e) => e.type === "text" ? e : e.type === "toggle" ? {
-  id: e.id,
-  type: e.type,
-  title: e.title,
-  value: e.value,
-  description: e.description,
-  disabled: e.disabled
-} : e.type === "button" ? {
-  id: e.id,
-  type: e.type,
-  title: e.title,
-  actionLabel: e.actionLabel,
-  description: e.description,
-  disabled: e.disabled
-} : e.type === "select" ? {
-  id: e.id,
-  type: e.type,
-  title: e.title,
-  value: e.value,
-  options: e.options,
-  description: e.description,
-  disabled: e.disabled
+import { useMemo as w, useRef as z, useEffect as b } from "react";
+import { useRozenitePluginAgentTool as f } from "@rozenite/agent-bridge";
+const $ = (o, e) => o ? o(e) : { valid: !0 }, P = (o) => o.type === "text" ? o : o.type === "toggle" ? {
+  id: o.id,
+  type: o.type,
+  title: o.title,
+  value: o.value,
+  description: o.description,
+  disabled: o.disabled
+} : o.type === "button" ? {
+  id: o.id,
+  type: o.type,
+  title: o.title,
+  actionLabel: o.actionLabel,
+  description: o.description,
+  disabled: o.disabled
+} : o.type === "select" ? {
+  id: o.id,
+  type: o.type,
+  title: o.title,
+  value: o.value,
+  options: o.options,
+  description: o.description,
+  disabled: o.disabled
 } : {
+  id: o.id,
+  type: o.type,
+  title: o.title,
+  value: o.value,
+  placeholder: o.placeholder,
+  applyLabel: o.applyLabel,
+  description: o.description,
+  disabled: o.disabled
+}, S = (o) => o.map((e) => ({
   id: e.id,
-  type: e.type,
   title: e.title,
-  value: e.value,
-  placeholder: e.placeholder,
-  applyLabel: e.applyLabel,
   description: e.description,
-  disabled: e.disabled
-}, z = (e) => e.map((t) => ({
-  id: t.id,
-  title: t.title,
-  description: t.description,
-  items: t.items.map(w)
-})), P = (e) => {
-  const t = /* @__PURE__ */ new Map();
-  return e.forEach((u) => {
-    u.items.forEach((n) => {
-      const p = `${u.id}:${n.id}`;
-      n.type === "toggle" && t.set(p, {
+  items: e.items.map(P)
+})), m = (o) => {
+  const e = /* @__PURE__ */ new Map();
+  return o.forEach((n) => {
+    n.items.forEach((t) => {
+      const r = `${n.id}:${t.id}`;
+      t.type === "toggle" && e.set(r, {
         type: "toggle",
-        validate: n.validate,
-        onUpdate: n.onUpdate
-      }), n.type === "button" && t.set(p, {
+        validate: t.validate,
+        onUpdate: t.onUpdate
+      }), t.type === "button" && e.set(r, {
         type: "button",
-        onPress: n.onPress
-      }), n.type === "select" && t.set(p, {
+        onPress: t.onPress
+      }), t.type === "select" && e.set(r, {
         type: "select",
-        validate: n.validate,
-        onUpdate: n.onUpdate
-      }), n.type === "input" && t.set(p, {
+        validate: t.validate,
+        onUpdate: t.onUpdate
+      }), t.type === "input" && e.set(r, {
         type: "input",
-        validate: n.validate,
-        onUpdate: n.onUpdate
+        validate: t.validate,
+        onUpdate: t.onUpdate
       });
     });
-  }), t;
-}, v = (e, t) => `${e}:${t}`, A = ({
-  sections: e
+  }), e;
+}, E = (o, e) => `${o}:${e}`, g = "@rozenite/controls-plugin", A = {
+  name: "list-sections",
+  description: "List all controls sections with their item IDs, types, and titles. Does not include values — call get-item for that.",
+  inputSchema: { type: "object", properties: {} }
+}, D = {
+  name: "get-item",
+  description: "Get full details of a single controls item including its current value. For select items this includes available options.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      sectionId: { type: "string", description: "Section ID." },
+      itemId: { type: "string", description: "Item ID." }
+    },
+    required: ["sectionId", "itemId"]
+  }
+}, L = {
+  name: "set-value",
+  description: "Update the value of a toggle, select, or input item. Runs the validate callback when present. Fails for text (read-only) and button items.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      sectionId: { type: "string", description: "Section ID." },
+      itemId: { type: "string", description: "Item ID." },
+      value: {
+        description: "New value. Boolean for toggle items, string for select/input items."
+      }
+    },
+    required: ["sectionId", "itemId", "value"]
+  }
+}, k = {
+  name: "press-button",
+  description: "Trigger a button item's action. Fails if the item is not a button or is disabled.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      sectionId: { type: "string", description: "Section ID." },
+      itemId: { type: "string", description: "Item ID." }
+    },
+    required: ["sectionId", "itemId"]
+  }
+}, v = (o, e, n) => {
+  const t = o.find((s) => s.id === e);
+  if (!t) {
+    const s = o.map((u) => u.id).join(", ");
+    throw new Error(
+      `Section "${e}" not found. Available: ${s || "(none)"}`
+    );
+  }
+  const r = t.items.find((s) => s.id === n);
+  if (!r) {
+    const s = t.items.map((u) => u.id).join(", ");
+    throw new Error(
+      `Item "${n}" not found in section "${e}". Available: ${s || "(none)"}`
+    );
+  }
+  return { section: t, item: r };
+}, x = (o) => {
+  f({
+    pluginId: g,
+    tool: A,
+    handler: () => ({
+      sections: o.map((e) => ({
+        id: e.id,
+        title: e.title,
+        description: e.description,
+        items: e.items.map((n) => ({
+          id: n.id,
+          type: n.type,
+          title: n.title,
+          disabled: "disabled" in n ? n.disabled : void 0
+        }))
+      }))
+    })
+  }), f({
+    pluginId: g,
+    tool: D,
+    handler: ({ sectionId: e, itemId: n }) => {
+      const { item: t } = v(o, e, n);
+      return t.type === "text" ? {
+        sectionId: e,
+        item: {
+          id: t.id,
+          type: t.type,
+          title: t.title,
+          value: t.value,
+          description: t.description
+        }
+      } : t.type === "toggle" ? {
+        sectionId: e,
+        item: {
+          id: t.id,
+          type: t.type,
+          title: t.title,
+          value: t.value,
+          description: t.description,
+          disabled: t.disabled
+        }
+      } : t.type === "button" ? {
+        sectionId: e,
+        item: {
+          id: t.id,
+          type: t.type,
+          title: t.title,
+          actionLabel: t.actionLabel,
+          description: t.description,
+          disabled: t.disabled
+        }
+      } : t.type === "select" ? {
+        sectionId: e,
+        item: {
+          id: t.id,
+          type: t.type,
+          title: t.title,
+          value: t.value,
+          options: t.options,
+          description: t.description,
+          disabled: t.disabled
+        }
+      } : {
+        sectionId: e,
+        item: {
+          id: t.id,
+          type: t.type,
+          title: t.title,
+          value: t.value,
+          placeholder: t.placeholder,
+          applyLabel: t.applyLabel,
+          description: t.description,
+          disabled: t.disabled
+        }
+      };
+    }
+  }), f({
+    pluginId: g,
+    tool: L,
+    handler: async ({ sectionId: e, itemId: n, value: t }) => {
+      const { item: r } = v(o, e, n);
+      if (r.type === "text")
+        throw new Error(
+          `Item "${n}" is a read-only text item and cannot be updated.`
+        );
+      if (r.type === "button")
+        throw new Error(
+          `Item "${n}" is a button. Use press-button to trigger its action.`
+        );
+      if (r.disabled)
+        throw new Error(`Item "${n}" is disabled.`);
+      if (r.type === "toggle") {
+        if (typeof t != "boolean")
+          throw new Error(
+            `Expected boolean value for toggle item "${n}".`
+          );
+        if (r.validate) {
+          const s = r.validate(t);
+          if (!s.valid)
+            throw new Error(s.message);
+        }
+        return await r.onUpdate(t), { applied: !0, sectionId: e, itemId: n };
+      }
+      if (typeof t != "string")
+        throw new Error(
+          `Expected string value for ${r.type} item "${n}".`
+        );
+      if (r.type === "select") {
+        const s = r.options.map((u) => u.value);
+        if (!s.includes(t))
+          throw new Error(
+            `Invalid option "${t}" for item "${n}". Valid options: ${s.join(", ")}`
+          );
+      }
+      if (r.validate) {
+        const s = r.validate(t);
+        if (!s.valid)
+          throw new Error(s.message);
+      }
+      return await r.onUpdate(t), { applied: !0, sectionId: e, itemId: n };
+    }
+  }), f({
+    pluginId: g,
+    tool: k,
+    handler: async ({ sectionId: e, itemId: n }) => {
+      const { item: t } = v(o, e, n);
+      if (t.type !== "button")
+        throw new Error(
+          `Item "${n}" is not a button (type: ${t.type}). Use set-value to update its value.`
+        );
+      if (t.disabled)
+        throw new Error(`Button "${n}" is disabled.`);
+      return await t.onPress(), { pressed: !0, sectionId: e, itemId: n };
+    }
+  });
+}, M = ({
+  sections: o
 }) => {
-  const t = R({
+  const e = R({
     pluginId: "@rozenite/controls-plugin"
-  }), u = f(() => z(e), [e]), n = f(() => P(e), [e]), p = U(n);
-  return y(() => {
-    p.current = n;
-  }, [n]), y(() => {
-    t && t.send("snapshot", {
+  });
+  x(o);
+  const n = w(() => S(o), [o]), t = w(() => m(o), [o]), r = z(t);
+  return b(() => {
+    r.current = t;
+  }, [t]), b(() => {
+    e && e.send("snapshot", {
       type: "snapshot",
-      sections: u
+      sections: n
     });
-  }, [t, u]), y(() => {
-    if (!t)
+  }, [e, n]), b(() => {
+    if (!e)
       return;
-    const b = async ({
-      requestId: s,
-      sectionId: r,
-      itemId: o,
-      value: l
+    const s = async ({
+      requestId: i,
+      sectionId: a,
+      itemId: l,
+      value: d
     }) => {
-      const d = v(r, o), a = p.current.get(d);
-      if (!a || a.type === "button") {
-        t.send("update-result", {
+      const c = E(a, l), p = r.current.get(c);
+      if (!p || p.type === "button") {
+        e.send("update-result", {
           type: "update-result",
-          requestId: s,
-          sectionId: r,
-          itemId: o,
+          requestId: i,
+          sectionId: a,
+          itemId: l,
           status: "error",
           message: "Update target not found."
         });
         return;
       }
       try {
-        if (a.type === "toggle") {
-          if (typeof l != "boolean") {
-            t.send("update-result", {
+        if (p.type === "toggle") {
+          if (typeof d != "boolean") {
+            e.send("update-result", {
               type: "update-result",
-              requestId: s,
-              sectionId: r,
-              itemId: o,
+              requestId: i,
+              sectionId: a,
+              itemId: l,
               status: "error",
               message: "Invalid toggle value."
             });
             return;
           }
-          const c = g(a.validate, l);
-          if (!c.valid) {
-            t.send("update-result", {
+          const h = $(p.validate, d);
+          if (!h.valid) {
+            e.send("update-result", {
               type: "update-result",
-              requestId: s,
-              sectionId: r,
-              itemId: o,
+              requestId: i,
+              sectionId: a,
+              itemId: l,
               status: "error",
-              message: c.message
+              message: h.message
             });
             return;
           }
-          await a.onUpdate(l), t.send("update-result", {
+          await p.onUpdate(d), e.send("update-result", {
             type: "update-result",
-            requestId: s,
-            sectionId: r,
-            itemId: o,
+            requestId: i,
+            sectionId: a,
+            itemId: l,
             status: "ok"
           });
           return;
         }
-        if (typeof l != "string") {
-          t.send("update-result", {
+        if (typeof d != "string") {
+          e.send("update-result", {
             type: "update-result",
-            requestId: s,
-            sectionId: r,
-            itemId: o,
+            requestId: i,
+            sectionId: a,
+            itemId: l,
             status: "error",
-            message: `Invalid ${a.type} value.`
+            message: `Invalid ${p.type} value.`
           });
           return;
         }
-        const i = g(a.validate, l);
-        if (!i.valid) {
-          t.send("update-result", {
+        const y = $(p.validate, d);
+        if (!y.valid) {
+          e.send("update-result", {
             type: "update-result",
-            requestId: s,
-            sectionId: r,
-            itemId: o,
+            requestId: i,
+            sectionId: a,
+            itemId: l,
             status: "error",
-            message: i.message
+            message: y.message
           });
           return;
         }
-        await a.onUpdate(l), t.send("update-result", {
+        await p.onUpdate(d), e.send("update-result", {
           type: "update-result",
-          requestId: s,
-          sectionId: r,
-          itemId: o,
+          requestId: i,
+          sectionId: a,
+          itemId: l,
           status: "ok"
         });
-      } catch (i) {
+      } catch (y) {
         console.warn(
-          `[Rozenite] Controls Plugin: Update failed for ${r}/${o}.`,
-          i
-        ), t.send("update-result", {
+          `[Rozenite] Controls Plugin: Update failed for ${a}/${l}.`,
+          y
+        ), e.send("update-result", {
           type: "update-result",
-          requestId: s,
-          sectionId: r,
-          itemId: o,
+          requestId: i,
+          sectionId: a,
+          itemId: l,
           status: "error",
           message: "Update failed on the device."
         });
       }
-    }, h = async ({
-      sectionId: s,
-      itemId: r,
-      action: o
+    }, u = async ({
+      sectionId: i,
+      itemId: a,
+      action: l
     }) => {
-      if (o !== "press") {
+      if (l !== "press") {
         console.warn(
-          `[Rozenite] Controls Plugin: Unsupported action "${o}" for ${s}/${r}.`
+          `[Rozenite] Controls Plugin: Unsupported action "${l}" for ${i}/${a}.`
         );
         return;
       }
-      const l = v(s, r), d = p.current.get(l);
-      if (!d) {
+      const d = E(i, a), c = r.current.get(d);
+      if (!c) {
         console.warn(
-          `[Rozenite] Controls Plugin: Action target not found for ${s}/${r}.`
+          `[Rozenite] Controls Plugin: Action target not found for ${i}/${a}.`
         );
         return;
       }
       try {
-        if (d.type !== "button") {
+        if (c.type !== "button") {
           console.warn(
-            `[Rozenite] Controls Plugin: Invalid press action payload for ${s}/${r}.`
+            `[Rozenite] Controls Plugin: Invalid press action payload for ${i}/${a}.`
           );
           return;
         }
-        await d.onPress();
-      } catch (a) {
+        await c.onPress();
+      } catch (p) {
         console.warn(
-          `[Rozenite] Controls Plugin: Action failed for ${s}/${r}.`,
-          a
+          `[Rozenite] Controls Plugin: Action failed for ${i}/${a}.`,
+          p
         );
       }
-    }, $ = [
-      t.onMessage("get-snapshot", () => {
-        t.send("snapshot", {
+    }, U = [
+      e.onMessage("get-snapshot", () => {
+        e.send("snapshot", {
           type: "snapshot",
-          sections: u
+          sections: n
         });
       }),
-      t.onMessage("update-request", (s) => {
-        b(s);
+      e.onMessage("update-request", (i) => {
+        s(i);
       }),
-      t.onMessage("invoke-action", (s) => {
-        h(s);
+      e.onMessage("invoke-action", (i) => {
+        u(i);
       })
     ];
     return () => {
-      $.forEach((s) => s.remove());
+      U.forEach((i) => i.remove());
     };
-  }, [t, u]), t;
+  }, [e, n]), e;
 };
 export {
-  A as useRozeniteControlsPlugin
+  M as useRozeniteControlsPlugin
 };

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@rozenite/controls-plugin",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A Rozenite plugin for exposing app-defined controls directly in React Native DevTools.",
   "type": "module",
   "main": "./dist/react-native.cjs",
   "module": "./dist/react-native.js",
   "types": "./dist/react-native.d.ts",
   "dependencies": {
-    "@rozenite/plugin-bridge": "1.4.0"
+    "@rozenite/agent-bridge": "1.5.0",
+    "@rozenite/plugin-bridge": "1.5.0"
   },
   "devDependencies": {
     "@types/react": "~19.2.2",
+    "@types/react-dom": "~19.1.7",
     "autoprefixer": "^10.4.21",
     "postcss": "^8.5.6",
     "react": "19.2.0",
@@ -21,8 +23,8 @@
     "tailwindcss-animate": "^1.0.7",
     "typescript": "~5.9.3",
     "vite": "^7.3.1",
-    "@rozenite/vite-plugin": "1.4.0",
-    "rozenite": "1.4.0"
+    "rozenite": "1.5.0",
+    "@rozenite/vite-plugin": "1.5.0"
   },
   "peerDependencies": {
     "react": "*",

package/src/react-native/useControlsAgentTools.ts

@@ -0,0 +1,277 @@
+import { useRozenitePluginAgentTool, type AgentTool } from '@rozenite/agent-bridge';
+import type { ControlsSection } from '../shared/types';
+
+type SectionItemInput = {
+  sectionId: string;
+  itemId: string;
+};
+
+type SetValueInput = SectionItemInput & {
+  value: boolean | string;
+};
+
+const pluginId = '@rozenite/controls-plugin';
+
+const listSectionsTool: AgentTool = {
+  name: 'list-sections',
+  description:
+    'List all controls sections with their item IDs, types, and titles. Does not include values — call get-item for that.',
+  inputSchema: { type: 'object', properties: {} },
+};
+
+const getItemTool: AgentTool = {
+  name: 'get-item',
+  description:
+    'Get full details of a single controls item including its current value. For select items this includes available options.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      sectionId: { type: 'string', description: 'Section ID.' },
+      itemId: { type: 'string', description: 'Item ID.' },
+    },
+    required: ['sectionId', 'itemId'],
+  },
+};
+
+const setValueTool: AgentTool = {
+  name: 'set-value',
+  description:
+    'Update the value of a toggle, select, or input item. Runs the validate callback when present. Fails for text (read-only) and button items.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      sectionId: { type: 'string', description: 'Section ID.' },
+      itemId: { type: 'string', description: 'Item ID.' },
+      value: {
+        description:
+          'New value. Boolean for toggle items, string for select/input items.',
+      },
+    },
+    required: ['sectionId', 'itemId', 'value'],
+  },
+};
+
+const pressButtonTool: AgentTool = {
+  name: 'press-button',
+  description: "Trigger a button item's action. Fails if the item is not a button or is disabled.",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      sectionId: { type: 'string', description: 'Section ID.' },
+      itemId: { type: 'string', description: 'Item ID.' },
+    },
+    required: ['sectionId', 'itemId'],
+  },
+};
+
+const resolveItem = (
+  sections: ControlsSection[],
+  sectionId: string,
+  itemId: string
+) => {
+  const section = sections.find((s) => s.id === sectionId);
+
+  if (!section) {
+    const available = sections.map((s) => s.id).join(', ');
+    throw new Error(
+      `Section "${sectionId}" not found. Available: ${available || '(none)'}`
+    );
+  }
+
+  const item = section.items.find((i) => i.id === itemId);
+
+  if (!item) {
+    const available = section.items.map((i) => i.id).join(', ');
+    throw new Error(
+      `Item "${itemId}" not found in section "${sectionId}". Available: ${available || '(none)'}`
+    );
+  }
+
+  return { section, item };
+};
+
+export const useControlsAgentTools = (sections: ControlsSection[]) => {
+  useRozenitePluginAgentTool({
+    pluginId,
+    tool: listSectionsTool,
+    handler: () => ({
+      sections: sections.map((section) => ({
+        id: section.id,
+        title: section.title,
+        description: section.description,
+        items: section.items.map((item) => ({
+          id: item.id,
+          type: item.type,
+          title: item.title,
+          disabled: 'disabled' in item ? item.disabled : undefined,
+        })),
+      })),
+    }),
+  });
+
+  useRozenitePluginAgentTool<SectionItemInput>({
+    pluginId,
+    tool: getItemTool,
+    handler: ({ sectionId, itemId }) => {
+      const { item } = resolveItem(sections, sectionId, itemId);
+
+      if (item.type === 'text') {
+        return {
+          sectionId,
+          item: {
+            id: item.id,
+            type: item.type,
+            title: item.title,
+            value: item.value,
+            description: item.description,
+          },
+        };
+      }
+
+      if (item.type === 'toggle') {
+        return {
+          sectionId,
+          item: {
+            id: item.id,
+            type: item.type,
+            title: item.title,
+            value: item.value,
+            description: item.description,
+            disabled: item.disabled,
+          },
+        };
+      }
+
+      if (item.type === 'button') {
+        return {
+          sectionId,
+          item: {
+            id: item.id,
+            type: item.type,
+            title: item.title,
+            actionLabel: item.actionLabel,
+            description: item.description,
+            disabled: item.disabled,
+          },
+        };
+      }
+
+      if (item.type === 'select') {
+        return {
+          sectionId,
+          item: {
+            id: item.id,
+            type: item.type,
+            title: item.title,
+            value: item.value,
+            options: item.options,
+            description: item.description,
+            disabled: item.disabled,
+          },
+        };
+      }
+
+      return {
+        sectionId,
+        item: {
+          id: item.id,
+          type: item.type,
+          title: item.title,
+          value: item.value,
+          placeholder: item.placeholder,
+          applyLabel: item.applyLabel,
+          description: item.description,
+          disabled: item.disabled,
+        },
+      };
+    },
+  });
+
+  useRozenitePluginAgentTool<SetValueInput>({
+    pluginId,
+    tool: setValueTool,
+    handler: async ({ sectionId, itemId, value }) => {
+      const { item } = resolveItem(sections, sectionId, itemId);
+
+      if (item.type === 'text') {
+        throw new Error(
+          `Item "${itemId}" is a read-only text item and cannot be updated.`
+        );
+      }
+
+      if (item.type === 'button') {
+        throw new Error(
+          `Item "${itemId}" is a button. Use press-button to trigger its action.`
+        );
+      }
+
+      if (item.disabled) {
+        throw new Error(`Item "${itemId}" is disabled.`);
+      }
+
+      if (item.type === 'toggle') {
+        if (typeof value !== 'boolean') {
+          throw new Error(
+            `Expected boolean value for toggle item "${itemId}".`
+          );
+        }
+
+        if (item.validate) {
+          const result = item.validate(value);
+          if (!result.valid) {
+            throw new Error(result.message);
+          }
+        }
+
+        await item.onUpdate(value);
+        return { applied: true, sectionId, itemId };
+      }
+
+      if (typeof value !== 'string') {
+        throw new Error(
+          `Expected string value for ${item.type} item "${itemId}".`
+        );
+      }
+
+      if (item.type === 'select') {
+        const validOptions = item.options.map((o) => o.value);
+        if (!validOptions.includes(value)) {
+          throw new Error(
+            `Invalid option "${value}" for item "${itemId}". Valid options: ${validOptions.join(', ')}`
+          );
+        }
+      }
+
+      if (item.validate) {
+        const result = item.validate(value);
+        if (!result.valid) {
+          throw new Error(result.message);
+        }
+      }
+
+      await item.onUpdate(value);
+      return { applied: true, sectionId, itemId };
+    },
+  });
+
+  useRozenitePluginAgentTool<SectionItemInput>({
+    pluginId,
+    tool: pressButtonTool,
+    handler: async ({ sectionId, itemId }) => {
+      const { item } = resolveItem(sections, sectionId, itemId);
+
+      if (item.type !== 'button') {
+        throw new Error(
+          `Item "${itemId}" is not a button (type: ${item.type}). Use set-value to update its value.`
+        );
+      }
+
+      if (item.disabled) {
+        throw new Error(`Button "${itemId}" is disabled.`);
+      }
+
+      await item.onPress();
+      return { pressed: true, sectionId, itemId };
+    },
+  });
+};

package/src/react-native/useRozeniteControlsPlugin.ts

@@ -12,6 +12,7 @@ import {
   serializeSections,
   validateValue,
 } from '../shared/serialization';
+import { useControlsAgentTools } from './useControlsAgentTools';
 
 export const useRozeniteControlsPlugin = ({
   sections,
@@ -20,6 +21,8 @@ export const useRozeniteControlsPlugin = ({
     pluginId: '@rozenite/controls-plugin',
   });
 
+  useControlsAgentTools(sections);
+
   const snapshot = useMemo(() => serializeSections(sections), [sections]);
   const actionRegistry = useMemo(() => buildActionRegistry(sections), [sections]);
   const actionRegistryRef = useRef(actionRegistry);

package/.turbo/turbo-build.log

@@ -1,16 +0,0 @@
-
-
-> @rozenite/controls-plugin@0.0.0 build /Users/szymon.chmal/Projects/rn-devtools/packages/controls-plugin
-> rozenite build
-
-┌  Rozenite
-[?25l│
-
-◒  Cleaning output directory◐  Cleaning output directory◇  Output directory cleaned
-[?25h[?25l│
-◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels◓  Building panels◑  Building panels◒  Building panels◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels.◓  Building panels.◑  Building panels.◒  Building panels.◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels..◓  Building panels..◑  Building panels..◒  Building panels..◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels...◑  Building panels...◒  Building panels...◐  Building panels...◓  Building panels◇  Panels built
-[?25h[?25l│
-◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point...◐  Building React Native entry point...◓  Building React Native entry point...◑  Building React Native entry point...◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point◐  Building React Native entry point◓  Building React Native entry point◑  Building React Native entry point◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point.◐  Building React Native entry point.◓  Building React Native entry point.◑  Building React Native entry point.◒  Building React Native entry point..◐  Building React Native entry point..◓  Building React Native entry point..◑  Building React Native entry point..◒  Building React Native entry point..◐  Building React Native entry point..◇  React Native entry point built
-[?25h│
-└  Plugin built successfully
-

package/.turbo/turbo-lint.log

@@ -1,4 +0,0 @@
-
-> @rozenite/controls-plugin@0.0.0 lint /Users/szymon.chmal/Projects/rn-devtools/packages/controls-plugin
-> eslint .
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @rozenite/controls-plugin@0.0.0 typecheck /Users/szymon.chmal/Projects/rn-devtools/packages/controls-plugin
-> tsc -p tsconfig.json --noEmit
-