@rozenite/storage-plugin 1.4.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @rozenite/storage-plugin
 
+## 1.5.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @rozenite/agent-bridge@1.5.1
+  - @rozenite/plugin-bridge@1.5.1
+
+## 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
+
 ## 1.4.0
 
 ### Minor Changes

package/README.md

@@ -72,6 +72,6 @@ createAsyncStorageAdapter({
 ## Notes
 
 - Unsupported value types are disabled in UI create/edit flows.
-- Type support is enforced in UI, runtime and MCP tools.
+- Type support is enforced in UI, runtime and Agent tools.
 - Storages without subscriptions automatically use internal polling updates.
 - Per-storage blacklists are supported through adapter configuration.

package/dist/rozenite.json

@@ -1 +1 @@
-{"name":"@rozenite/storage-plugin","version":"1.4.0","description":"Generic Storage Inspector for Rozenite.","panels":[{"name":"Storage","source":"/panel.html"}]}
+{"name":"@rozenite/storage-plugin","version":"1.5.0","description":"Generic Storage Inspector for Rozenite.","panels":[{"name":"Storage","source":"/panel.html"}]}

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

@@ -0,0 +1,2 @@
+import { StorageView } from './storage-view';
+export declare const useStorageAgentTools: (views: StorageView[]) => void;

package/dist/useRozeniteStoragePlugin.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("@rozenite/plugin-bridge"),g=require("react"),S=require("./types.cjs"),b=1500,d=e=>e.kind==="async",y=e=>e.type==="buffer"?`${e.type}:${e.value.join(",")}`:`${e.type}:${String(e.value)}`,m=e=>new Map(e.map(t=>[t.key,t])),p=(e,t)=>e.blacklist?(e.blacklist.lastIndex=0,e.blacklist.test(t)):!1,$=(e,t,r)=>{if(!S.supportsType(e,t))throw new Error(`Type "${t}" is not supported by storage "${r.storageId}" in adapter "${r.adapterId}".`)},f=async e=>(d(e),e.getAllKeys()),w=async(e,t)=>(d(e),e.get(t)),v=async(e,t)=>{if(d(e)){await e.set(t);return}e.set(t)},E=async(e,t)=>{if(d(e)){await e.delete(t);return}e.delete(t)},I=async e=>{const t=await e();return m(t)},P=(e,t,r)=>{t.forEach((i,c)=>{const u=e.get(c);if(!u){r.onSet(i);return}y(u)!==y(i)&&r.onSet(i)}),e.forEach((i,c)=>{t.has(c)||r.onDelete(c)})},z=async(e,t)=>{let r=await I(e);const i=setInterval(async()=>{try{const c=await I(e);P(r,c,t),r=c}catch{}},b);return{remove:()=>{clearInterval(i)}}},M=(e,t)=>{const r=t.storage,i={adapterId:e.id,storageId:t.id},c=async o=>{if(!p(t,o))return w(r,o)},u=async()=>{const o=await f(r);return(await Promise.all(o.filter(s=>!p(t,s)).map(s=>w(r,s)))).filter(s=>!!s)};return{id:S.getStorageViewId(i),target:i,adapterName:e.name,storageName:t.name,capabilities:t.capabilities,get:c,set:async o=>{$(t.capabilities,o.type,i),await v(r,o)},delete:async o=>{await E(r,o)},getAllKeys:async()=>(await f(r)).filter(a=>!p(t,a)),getAllEntries:u,watch:async({onSet:o,onDelete:a})=>r.subscribe?r.subscribe(async s=>{try{const n=await c(s);if(!n){a(s);return}o(n)}catch{}}):z(u,{onSet:o,onDelete:a})}},R=e=>e.flatMap(t=>t.storages.map(r=>M(t,r))),A=({storages:e})=>{const t=g.useMemo(()=>R(e),[e]),r=h.useRozeniteDevToolsClient({pluginId:"@rozenite/storage-plugin"});return g.useEffect(()=>{if(!r)return;const i=async a=>{const s=a?t.filter(n=>n.id===a):t;for(const n of s)try{const l=await n.getAllEntries();r.send("snapshot",{type:"snapshot",target:n.target,adapterName:n.adapterName,storageName:n.storageName,capabilities:n.capabilities,entries:l})}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to snapshot ${n.target.adapterId}/${n.target.storageId}.`,l)}};i();const c=[];let u=!1;Promise.all(t.map(async a=>{try{const s=await a.watch({onSet:n=>{r.send("set-entry",{type:"set-entry",target:a.target,entry:n})},onDelete:n=>{r.send("delete-entry",{type:"delete-entry",target:a.target,key:n})}});if(u){s.remove();return}c.push(s)}catch(s){console.warn(`[Rozenite] Storage Plugin: Failed to attach watcher for ${a.target.adapterId}/${a.target.storageId}.`,s)}}));const o=[r.onMessage("set-entry",async({target:a,entry:s})=>{const n=t.find(l=>l.target.adapterId===a.adapterId&&l.target.storageId===a.storageId);if(!n){console.warn(`[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`);return}try{await n.set(s)}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to set entry in ${a.adapterId}/${a.storageId}.`,l)}}),r.onMessage("delete-entry",async({target:a,key:s})=>{const n=t.find(l=>l.target.adapterId===a.adapterId&&l.target.storageId===a.storageId);if(!n){console.warn(`[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`);return}try{await n.delete(s)}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to delete entry in ${a.adapterId}/${a.storageId}.`,l)}}),r.onMessage("get-snapshot",async({target:a})=>{if(a==="all"){await i();return}await i(`${a.adapterId}:${a.storageId}`)})];return()=>{u=!0,c.forEach(a=>a.remove()),o.forEach(a=>a.remove())}},[r,t]),r};exports.useRozeniteStoragePlugin=A;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("@rozenite/plugin-bridge"),m=require("react"),$=require("./types.cjs"),p=require("@rozenite/agent-bridge"),P=1500,f=e=>e.kind==="async",I=e=>e.type==="buffer"?`${e.type}:${e.value.join(",")}`:`${e.type}:${String(e.value)}`,T=e=>new Map(e.map(t=>[t.key,t])),h=(e,t)=>e.blacklist?(e.blacklist.lastIndex=0,e.blacklist.test(t)):!1,R=(e,t,r)=>{if(!$.supportsType(e,t))throw new Error(`Type "${t}" is not supported by storage "${r.storageId}" in adapter "${r.adapterId}".`)},w=async e=>(f(e),e.getAllKeys()),b=async(e,t)=>(f(e),e.get(t)),A=async(e,t)=>{if(f(e)){await e.set(t);return}e.set(t)},z=async(e,t)=>{if(f(e)){await e.delete(t);return}e.delete(t)},S=async e=>{const t=await e();return T(t)},M=(e,t,r)=>{t.forEach((s,n)=>{const o=e.get(n);if(!o){r.onSet(s);return}I(o)!==I(s)&&r.onSet(s)}),e.forEach((s,n)=>{t.has(n)||r.onDelete(n)})},k=async(e,t)=>{let r=await S(e);const s=setInterval(async()=>{try{const n=await S(e);M(r,n,t),r=n}catch{}},P);return{remove:()=>{clearInterval(s)}}},x=(e,t)=>{const r=t.storage,s={adapterId:e.id,storageId:t.id},n=async d=>{if(!h(t,d))return b(r,d)},o=async()=>{const d=await w(r);return(await Promise.all(d.filter(c=>!h(t,c)).map(c=>b(r,c)))).filter(c=>!!c)};return{id:$.getStorageViewId(s),target:s,adapterName:e.name,storageName:t.name,capabilities:t.capabilities,get:n,set:async d=>{R(t.capabilities,d.type,s),await A(r,d)},delete:async d=>{await z(r,d)},getAllKeys:async()=>(await w(r)).filter(a=>!h(t,a)),getAllEntries:o,watch:async({onSet:d,onDelete:a})=>r.subscribe?r.subscribe(async c=>{try{const i=await n(c);if(!i){a(c);return}d(i)}catch{}}):k(o,{onSet:d,onDelete:a})}},j=e=>e.flatMap(t=>t.storages.map(r=>x(t,r))),g="@rozenite/storage-plugin",y={adapterId:{type:"string",description:"Storage adapter ID. Required when multiple adapters are configured."},storageId:{type:"string",description:"Storage node ID within the adapter. Required when multiple storages are configured."}},q={name:"list-storages",description:"List all storage adapters and their storage nodes currently available on the device, including supported entry types and entry counts.",inputSchema:{type:"object",properties:{}}},K={name:"list-entries",description:"List keys in a storage. This call intentionally does not return entry values to keep responses token-efficient.",inputSchema:{type:"object",properties:{...y,offset:{type:"number",description:"Pagination offset. Defaults to 0."},limit:{type:"number",description:"Pagination size. Defaults to 100."}}}},N={name:"read-entry",description:"Read a single storage entry value by key.",inputSchema:{type:"object",properties:{...y,key:{type:"string",description:"Entry key."}},required:["key"]}},V={name:"create-entry",description:"Create a new storage entry. Fails if the key already exists.",inputSchema:{type:"object",properties:{...y,key:{type:"string",description:"Entry key."},type:{type:"string",enum:["string","number","boolean","buffer"],description:"Entry value type. Must be one of the supported types for the target storage (see list-storages)."},value:{description:"Entry value matching the provided type."}},required:["key","type","value"]}},F={name:"edit-entry",description:"Edit an existing storage entry. Fails if the key does not exist.",inputSchema:{type:"object",properties:{...y,key:{type:"string",description:"Entry key."},type:{type:"string",enum:["string","number","boolean","buffer"],description:"Entry value type. Must be one of the supported types for the target storage (see list-storages)."},value:{description:"Entry value matching the provided type."}},required:["key","type","value"]}},D={name:"remove-entry",description:"Remove a storage entry by key.",inputSchema:{type:"object",properties:{...y,key:{type:"string",description:"Entry key."}},required:["key"]}},E=(e,t)=>{if(e==="string"){if(typeof t!="string")throw new Error("Expected string value for type=string");return t}if(e==="number"){if(typeof t!="number"||Number.isNaN(t))throw new Error("Expected number value for type=number");return t}if(e==="boolean"){if(typeof t!="boolean")throw new Error("Expected boolean value for type=boolean");return t}if(!Array.isArray(t)||!t.every(r=>Number.isInteger(r)))throw new Error("Expected number[] value for type=buffer");return t},u=e=>`${e.target.adapterId}/${e.target.storageId}`,L=e=>{const t=m.useCallback((r,s)=>{if(e.length===0)throw new Error("No storages are registered.");if(r!==void 0||s!==void 0){const n=e.find(o=>(r===void 0||o.target.adapterId===r)&&(s===void 0||o.target.storageId===s));if(!n){const o=[r&&`adapterId="${r}"`,s&&`storageId="${s}"`].filter(Boolean).join(", ");throw new Error(`No storage matched ${o}. Available: ${e.map(u).join(", ")}`)}return n}if(e.length>1)throw new Error(`Multiple storages detected. Provide adapterId and/or storageId. Available: ${e.map(u).join(", ")}`);return e[0]},[e]);p.useRozenitePluginAgentTool({pluginId:g,tool:q,handler:async()=>({storages:await Promise.all(e.map(async r=>({adapterId:r.target.adapterId,storageId:r.target.storageId,adapterName:r.adapterName,storageName:r.storageName,supportedTypes:r.capabilities.supportedTypes,entryCount:(await r.getAllKeys()).length})))})}),p.useRozenitePluginAgentTool({pluginId:g,tool:K,handler:async({adapterId:r,storageId:s,offset:n=0,limit:o=100})=>{const d=t(r,s),a=await d.getAllKeys(),c=Math.max(0,Math.floor(n)),i=Math.max(1,Math.floor(o)),l=a.slice(c,c+i);return{adapterId:d.target.adapterId,storageId:d.target.storageId,total:a.length,offset:c,limit:i,keys:l}}}),p.useRozenitePluginAgentTool({pluginId:g,tool:N,handler:async({adapterId:r,storageId:s,key:n})=>{const o=t(r,s),d=await o.get(n);if(!d)throw new Error(`Key "${n}" not found in storage "${u(o)}".`);return{adapterId:o.target.adapterId,storageId:o.target.storageId,entry:d}}}),p.useRozenitePluginAgentTool({pluginId:g,tool:V,handler:async({adapterId:r,storageId:s,key:n,type:o,value:d})=>{const a=t(r,s);if(await a.get(n))throw new Error(`Key "${n}" already exists in storage "${u(a)}". Use edit-entry instead.`);const i=E(o,d);return await a.set({key:n,type:o,value:i}),{adapterId:a.target.adapterId,storageId:a.target.storageId,created:!0,key:n}}}),p.useRozenitePluginAgentTool({pluginId:g,tool:F,handler:async({adapterId:r,storageId:s,key:n,type:o,value:d})=>{const a=t(r,s);if(!await a.get(n))throw new Error(`Key "${n}" not found in storage "${u(a)}". Use create-entry instead.`);const i=E(o,d);return await a.set({key:n,type:o,value:i}),{adapterId:a.target.adapterId,storageId:a.target.storageId,edited:!0,key:n}}}),p.useRozenitePluginAgentTool({pluginId:g,tool:D,handler:async({adapterId:r,storageId:s,key:n})=>{const o=t(r,s),d=!!await o.get(n);return await o.delete(n),{adapterId:o.target.adapterId,storageId:o.target.storageId,removed:d,key:n}}})},C=({storages:e})=>{const t=m.useMemo(()=>j(e),[e]);L(t);const r=v.useRozeniteDevToolsClient({pluginId:"@rozenite/storage-plugin"});return m.useEffect(()=>{if(!r)return;const s=async a=>{const c=a?t.filter(i=>i.id===a):t;for(const i of c)try{const l=await i.getAllEntries();r.send("snapshot",{type:"snapshot",target:i.target,adapterName:i.adapterName,storageName:i.storageName,capabilities:i.capabilities,entries:l})}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to snapshot ${i.target.adapterId}/${i.target.storageId}.`,l)}};s();const n=[];let o=!1;Promise.all(t.map(async a=>{try{const c=await a.watch({onSet:i=>{r.send("set-entry",{type:"set-entry",target:a.target,entry:i})},onDelete:i=>{r.send("delete-entry",{type:"delete-entry",target:a.target,key:i})}});if(o){c.remove();return}n.push(c)}catch(c){console.warn(`[Rozenite] Storage Plugin: Failed to attach watcher for ${a.target.adapterId}/${a.target.storageId}.`,c)}}));const d=[r.onMessage("set-entry",async({target:a,entry:c})=>{const i=t.find(l=>l.target.adapterId===a.adapterId&&l.target.storageId===a.storageId);if(!i){console.warn(`[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`);return}try{await i.set(c)}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to set entry in ${a.adapterId}/${a.storageId}.`,l)}}),r.onMessage("delete-entry",async({target:a,key:c})=>{const i=t.find(l=>l.target.adapterId===a.adapterId&&l.target.storageId===a.storageId);if(!i){console.warn(`[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`);return}try{await i.delete(c)}catch(l){console.warn(`[Rozenite] Storage Plugin: Failed to delete entry in ${a.adapterId}/${a.storageId}.`,l)}}),r.onMessage("get-snapshot",async({target:a})=>{if(a==="all"){await s();return}await s(`${a.adapterId}:${a.storageId}`)})];return()=>{o=!0,n.forEach(a=>a.remove()),d.forEach(a=>a.remove())}},[r,t]),r};exports.useRozeniteStoragePlugin=C;

package/dist/useRozeniteStoragePlugin.js

@@ -1,212 +1,443 @@
-import { useRozeniteDevToolsClient as I } from "@rozenite/plugin-bridge";
-import { useMemo as h, useEffect as S } from "react";
-import { g as m, s as b } from "./types.js";
-const $ = 1500, d = (t) => t.kind === "async", g = (t) => t.type === "buffer" ? `${t.type}:${t.value.join(",")}` : `${t.type}:${String(t.value)}`, v = (t) => new Map(t.map((e) => [e.key, e])), u = (t, e) => t.blacklist ? (t.blacklist.lastIndex = 0, t.blacklist.test(e)) : !1, E = (t, e, r) => {
-  if (!b(t, e))
+import { useRozeniteDevToolsClient as S } from "@rozenite/plugin-bridge";
+import { useCallback as $, useMemo as v, useEffect as P } from "react";
+import { g as T, s as k } from "./types.js";
+import { useRozenitePluginAgentTool as l } from "@rozenite/agent-bridge";
+const x = 1500, f = (e) => e.kind === "async", m = (e) => e.type === "buffer" ? `${e.type}:${e.value.join(",")}` : `${e.type}:${String(e.value)}`, M = (e) => new Map(e.map((t) => [t.key, t])), h = (e, t) => e.blacklist ? (e.blacklist.lastIndex = 0, e.blacklist.test(t)) : !1, A = (e, t, r) => {
+  if (!k(e, t))
     throw new Error(
-      `Type "${e}" is not supported by storage "${r.storageId}" in adapter "${r.adapterId}".`
+      `Type "${t}" is not supported by storage "${r.storageId}" in adapter "${r.adapterId}".`
     );
-}, f = async (t) => (d(t), t.getAllKeys()), y = async (t, e) => (d(t), t.get(e)), P = async (t, e) => {
-  if (d(t)) {
-    await t.set(e);
+}, I = async (e) => (f(e), e.getAllKeys()), w = async (e, t) => (f(e), e.get(t)), R = async (e, t) => {
+  if (f(e)) {
+    await e.set(t);
     return;
   }
-  t.set(e);
-}, z = async (t, e) => {
-  if (d(t)) {
-    await t.delete(e);
+  e.set(t);
+}, z = async (e, t) => {
+  if (f(e)) {
+    await e.delete(t);
     return;
   }
-  t.delete(e);
-}, w = async (t) => {
-  const e = await t();
-  return v(e);
-}, M = (t, e, r) => {
-  e.forEach((i, c) => {
-    const p = t.get(c);
-    if (!p) {
-      r.onSet(i);
+  e.delete(t);
+}, b = async (e) => {
+  const t = await e();
+  return M(t);
+}, K = (e, t, r) => {
+  t.forEach((s, n) => {
+    const o = e.get(n);
+    if (!o) {
+      r.onSet(s);
       return;
     }
-    g(p) !== g(i) && r.onSet(i);
-  }), t.forEach((i, c) => {
-    e.has(c) || r.onDelete(c);
+    m(o) !== m(s) && r.onSet(s);
+  }), e.forEach((s, n) => {
+    t.has(n) || r.onDelete(n);
   });
-}, R = async (t, e) => {
-  let r = await w(t);
-  const i = setInterval(async () => {
+}, N = async (e, t) => {
+  let r = await b(e);
+  const s = setInterval(async () => {
     try {
-      const c = await w(t);
-      M(r, c, e), r = c;
+      const n = await b(e);
+      K(r, n, t), r = n;
     } catch {
     }
-  }, $);
+  }, x);
   return {
     remove: () => {
-      clearInterval(i);
+      clearInterval(s);
     }
   };
-}, A = (t, e) => {
-  const r = e.storage, i = {
-    adapterId: t.id,
-    storageId: e.id
-  }, c = async (o) => {
-    if (!u(e, o))
-      return y(r, o);
-  }, p = async () => {
-    const o = await f(r);
+}, j = (e, t) => {
+  const r = t.storage, s = {
+    adapterId: e.id,
+    storageId: t.id
+  }, n = async (d) => {
+    if (!h(t, d))
+      return w(r, d);
+  }, o = async () => {
+    const d = await I(r);
     return (await Promise.all(
-      o.filter((s) => !u(e, s)).map((s) => y(r, s))
-    )).filter((s) => !!s);
+      d.filter((c) => !h(t, c)).map((c) => w(r, c))
+    )).filter((c) => !!c);
   };
   return {
-    id: m(i),
-    target: i,
-    adapterName: t.name,
-    storageName: e.name,
-    capabilities: e.capabilities,
-    get: c,
-    set: async (o) => {
-      E(e.capabilities, o.type, i), await P(r, o);
+    id: T(s),
+    target: s,
+    adapterName: e.name,
+    storageName: t.name,
+    capabilities: t.capabilities,
+    get: n,
+    set: async (d) => {
+      A(t.capabilities, d.type, s), await R(r, d);
     },
-    delete: async (o) => {
-      await z(r, o);
+    delete: async (d) => {
+      await z(r, d);
     },
-    getAllKeys: async () => (await f(r)).filter((a) => !u(e, a)),
-    getAllEntries: p,
-    watch: async ({ onSet: o, onDelete: a }) => r.subscribe ? r.subscribe(async (s) => {
+    getAllKeys: async () => (await I(r)).filter((a) => !h(t, a)),
+    getAllEntries: o,
+    watch: async ({ onSet: d, onDelete: a }) => r.subscribe ? r.subscribe(async (c) => {
       try {
-        const n = await c(s);
-        if (!n) {
-          a(s);
+        const i = await n(c);
+        if (!i) {
+          a(c);
           return;
         }
-        o(n);
+        d(i);
       } catch {
       }
-    }) : R(p, { onSet: o, onDelete: a })
+    }) : N(o, { onSet: d, onDelete: a })
   };
-}, F = (t) => t.flatMap(
-  (e) => e.storages.map((r) => A(e, r))
-), k = ({
-  storages: t
+}, V = (e) => e.flatMap(
+  (t) => t.storages.map((r) => j(t, r))
+), g = "@rozenite/storage-plugin", y = {
+  adapterId: {
+    type: "string",
+    description: "Storage adapter ID. Required when multiple adapters are configured."
+  },
+  storageId: {
+    type: "string",
+    description: "Storage node ID within the adapter. Required when multiple storages are configured."
+  }
+}, F = {
+  name: "list-storages",
+  description: "List all storage adapters and their storage nodes currently available on the device, including supported entry types and entry counts.",
+  inputSchema: { type: "object", properties: {} }
+}, q = {
+  name: "list-entries",
+  description: "List keys in a storage. This call intentionally does not return entry values to keep responses token-efficient.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ...y,
+      offset: {
+        type: "number",
+        description: "Pagination offset. Defaults to 0."
+      },
+      limit: {
+        type: "number",
+        description: "Pagination size. Defaults to 100."
+      }
+    }
+  }
+}, D = {
+  name: "read-entry",
+  description: "Read a single storage entry value by key.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ...y,
+      key: { type: "string", description: "Entry key." }
+    },
+    required: ["key"]
+  }
+}, L = {
+  name: "create-entry",
+  description: "Create a new storage entry. Fails if the key already exists.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ...y,
+      key: { type: "string", description: "Entry key." },
+      type: {
+        type: "string",
+        enum: ["string", "number", "boolean", "buffer"],
+        description: "Entry value type. Must be one of the supported types for the target storage (see list-storages)."
+      },
+      value: {
+        description: "Entry value matching the provided type."
+      }
+    },
+    required: ["key", "type", "value"]
+  }
+}, C = {
+  name: "edit-entry",
+  description: "Edit an existing storage entry. Fails if the key does not exist.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ...y,
+      key: { type: "string", description: "Entry key." },
+      type: {
+        type: "string",
+        enum: ["string", "number", "boolean", "buffer"],
+        description: "Entry value type. Must be one of the supported types for the target storage (see list-storages)."
+      },
+      value: {
+        description: "Entry value matching the provided type."
+      }
+    },
+    required: ["key", "type", "value"]
+  }
+}, _ = {
+  name: "remove-entry",
+  description: "Remove a storage entry by key.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      ...y,
+      key: { type: "string", description: "Entry key." }
+    },
+    required: ["key"]
+  }
+}, E = (e, t) => {
+  if (e === "string") {
+    if (typeof t != "string")
+      throw new Error("Expected string value for type=string");
+    return t;
+  }
+  if (e === "number") {
+    if (typeof t != "number" || Number.isNaN(t))
+      throw new Error("Expected number value for type=number");
+    return t;
+  }
+  if (e === "boolean") {
+    if (typeof t != "boolean")
+      throw new Error("Expected boolean value for type=boolean");
+    return t;
+  }
+  if (!Array.isArray(t) || !t.every((r) => Number.isInteger(r)))
+    throw new Error("Expected number[] value for type=buffer");
+  return t;
+}, u = (e) => `${e.target.adapterId}/${e.target.storageId}`, O = (e) => {
+  const t = $(
+    (r, s) => {
+      if (e.length === 0)
+        throw new Error("No storages are registered.");
+      if (r !== void 0 || s !== void 0) {
+        const n = e.find(
+          (o) => (r === void 0 || o.target.adapterId === r) && (s === void 0 || o.target.storageId === s)
+        );
+        if (!n) {
+          const o = [
+            r && `adapterId="${r}"`,
+            s && `storageId="${s}"`
+          ].filter(Boolean).join(", ");
+          throw new Error(
+            `No storage matched ${o}. Available: ${e.map(u).join(", ")}`
+          );
+        }
+        return n;
+      }
+      if (e.length > 1)
+        throw new Error(
+          `Multiple storages detected. Provide adapterId and/or storageId. Available: ${e.map(u).join(", ")}`
+        );
+      return e[0];
+    },
+    [e]
+  );
+  l({
+    pluginId: g,
+    tool: F,
+    handler: async () => ({
+      storages: await Promise.all(
+        e.map(async (r) => ({
+          adapterId: r.target.adapterId,
+          storageId: r.target.storageId,
+          adapterName: r.adapterName,
+          storageName: r.storageName,
+          supportedTypes: r.capabilities.supportedTypes,
+          entryCount: (await r.getAllKeys()).length
+        }))
+      )
+    })
+  }), l({
+    pluginId: g,
+    tool: q,
+    handler: async ({ adapterId: r, storageId: s, offset: n = 0, limit: o = 100 }) => {
+      const d = t(r, s), a = await d.getAllKeys(), c = Math.max(0, Math.floor(n)), i = Math.max(1, Math.floor(o)), p = a.slice(c, c + i);
+      return {
+        adapterId: d.target.adapterId,
+        storageId: d.target.storageId,
+        total: a.length,
+        offset: c,
+        limit: i,
+        keys: p
+      };
+    }
+  }), l({
+    pluginId: g,
+    tool: D,
+    handler: async ({ adapterId: r, storageId: s, key: n }) => {
+      const o = t(r, s), d = await o.get(n);
+      if (!d)
+        throw new Error(
+          `Key "${n}" not found in storage "${u(o)}".`
+        );
+      return {
+        adapterId: o.target.adapterId,
+        storageId: o.target.storageId,
+        entry: d
+      };
+    }
+  }), l({
+    pluginId: g,
+    tool: L,
+    handler: async ({ adapterId: r, storageId: s, key: n, type: o, value: d }) => {
+      const a = t(r, s);
+      if (await a.get(n))
+        throw new Error(
+          `Key "${n}" already exists in storage "${u(a)}". Use edit-entry instead.`
+        );
+      const i = E(o, d);
+      return await a.set({ key: n, type: o, value: i }), {
+        adapterId: a.target.adapterId,
+        storageId: a.target.storageId,
+        created: !0,
+        key: n
+      };
+    }
+  }), l({
+    pluginId: g,
+    tool: C,
+    handler: async ({ adapterId: r, storageId: s, key: n, type: o, value: d }) => {
+      const a = t(r, s);
+      if (!await a.get(n))
+        throw new Error(
+          `Key "${n}" not found in storage "${u(a)}". Use create-entry instead.`
+        );
+      const i = E(o, d);
+      return await a.set({ key: n, type: o, value: i }), {
+        adapterId: a.target.adapterId,
+        storageId: a.target.storageId,
+        edited: !0,
+        key: n
+      };
+    }
+  }), l({
+    pluginId: g,
+    tool: _,
+    handler: async ({ adapterId: r, storageId: s, key: n }) => {
+      const o = t(r, s), d = !!await o.get(n);
+      return await o.delete(n), {
+        adapterId: o.target.adapterId,
+        storageId: o.target.storageId,
+        removed: d,
+        key: n
+      };
+    }
+  });
+}, J = ({
+  storages: e
 }) => {
-  const e = h(() => F(t), [t]), r = I({
+  const t = v(() => V(e), [e]);
+  O(t);
+  const r = S({
     pluginId: "@rozenite/storage-plugin"
   });
-  return S(() => {
+  return P(() => {
     if (!r)
       return;
-    const i = async (a) => {
-      const s = a ? e.filter((n) => n.id === a) : e;
-      for (const n of s)
+    const s = async (a) => {
+      const c = a ? t.filter((i) => i.id === a) : t;
+      for (const i of c)
         try {
-          const l = await n.getAllEntries();
+          const p = await i.getAllEntries();
           r.send("snapshot", {
             type: "snapshot",
-            target: n.target,
-            adapterName: n.adapterName,
-            storageName: n.storageName,
-            capabilities: n.capabilities,
-            entries: l
+            target: i.target,
+            adapterName: i.adapterName,
+            storageName: i.storageName,
+            capabilities: i.capabilities,
+            entries: p
           });
-        } catch (l) {
+        } catch (p) {
           console.warn(
-            `[Rozenite] Storage Plugin: Failed to snapshot ${n.target.adapterId}/${n.target.storageId}.`,
-            l
+            `[Rozenite] Storage Plugin: Failed to snapshot ${i.target.adapterId}/${i.target.storageId}.`,
+            p
           );
         }
     };
-    i();
-    const c = [];
-    let p = !1;
+    s();
+    const n = [];
+    let o = !1;
     Promise.all(
-      e.map(async (a) => {
+      t.map(async (a) => {
         try {
-          const s = await a.watch({
-            onSet: (n) => {
+          const c = await a.watch({
+            onSet: (i) => {
               r.send("set-entry", {
                 type: "set-entry",
                 target: a.target,
-                entry: n
+                entry: i
               });
             },
-            onDelete: (n) => {
+            onDelete: (i) => {
               r.send("delete-entry", {
                 type: "delete-entry",
                 target: a.target,
-                key: n
+                key: i
               });
             }
           });
-          if (p) {
-            s.remove();
+          if (o) {
+            c.remove();
             return;
           }
-          c.push(s);
-        } catch (s) {
+          n.push(c);
+        } catch (c) {
           console.warn(
             `[Rozenite] Storage Plugin: Failed to attach watcher for ${a.target.adapterId}/${a.target.storageId}.`,
-            s
+            c
           );
         }
       })
     );
-    const o = [
-      r.onMessage("set-entry", async ({ target: a, entry: s }) => {
-        const n = e.find(
-          (l) => l.target.adapterId === a.adapterId && l.target.storageId === a.storageId
+    const d = [
+      r.onMessage("set-entry", async ({ target: a, entry: c }) => {
+        const i = t.find(
+          (p) => p.target.adapterId === a.adapterId && p.target.storageId === a.storageId
         );
-        if (!n) {
+        if (!i) {
           console.warn(
             `[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`
           );
           return;
         }
         try {
-          await n.set(s);
-        } catch (l) {
+          await i.set(c);
+        } catch (p) {
           console.warn(
             `[Rozenite] Storage Plugin: Failed to set entry in ${a.adapterId}/${a.storageId}.`,
-            l
+            p
           );
         }
       }),
       r.onMessage(
         "delete-entry",
-        async ({ target: a, key: s }) => {
-          const n = e.find(
-            (l) => l.target.adapterId === a.adapterId && l.target.storageId === a.storageId
+        async ({ target: a, key: c }) => {
+          const i = t.find(
+            (p) => p.target.adapterId === a.adapterId && p.target.storageId === a.storageId
           );
-          if (!n) {
+          if (!i) {
             console.warn(
               `[Rozenite] Storage Plugin: Storage target not found for ${a.adapterId}/${a.storageId}`
             );
             return;
           }
           try {
-            await n.delete(s);
-          } catch (l) {
+            await i.delete(c);
+          } catch (p) {
             console.warn(
               `[Rozenite] Storage Plugin: Failed to delete entry in ${a.adapterId}/${a.storageId}.`,
-              l
+              p
             );
           }
         }
       ),
       r.onMessage("get-snapshot", async ({ target: a }) => {
         if (a === "all") {
-          await i();
+          await s();
           return;
         }
-        await i(`${a.adapterId}:${a.storageId}`);
+        await s(`${a.adapterId}:${a.storageId}`);
       })
     ];
     return () => {
-      p = !0, c.forEach((a) => a.remove()), o.forEach((a) => a.remove());
+      o = !0, n.forEach((a) => a.remove()), d.forEach((a) => a.remove());
     };
-  }, [r, e]), r;
+  }, [r, t]), r;
 };
 export {
-  k as useRozeniteStoragePlugin
+  J as useRozeniteStoragePlugin
 };

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@rozenite/storage-plugin",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Generic Storage Inspector for Rozenite.",
   "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/plugin-bridge": "1.5.1",
+    "@rozenite/agent-bridge": "1.5.1"
   },
   "devDependencies": {
     "@tanstack/react-table": "^8.21.3",
@@ -28,8 +29,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/vite-plugin": "1.5.1",
+    "rozenite": "1.5.1"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "*",

package/src/react-native/useRozeniteStoragePlugin.ts

@@ -8,6 +8,7 @@ import type {
 } from '../shared/messaging';
 import type { StorageAdapter } from '../shared/types';
 import { createStorageViews } from './storage-view';
+import { useStorageAgentTools } from './useStorageAgentTools';
 
 export type RozeniteStoragePluginOptions = {
   storages: StorageAdapter[];
@@ -18,6 +19,8 @@ export const useRozeniteStoragePlugin = ({
 }: RozeniteStoragePluginOptions) => {
   const views = useMemo(() => createStorageViews(storages), [storages]);
 
+  useStorageAgentTools(views);
+
   const client = useRozeniteDevToolsClient<StorageEventMap>({
     pluginId: '@rozenite/storage-plugin',
   });

package/src/react-native/useStorageAgentTools.ts

@@ -0,0 +1,332 @@
+import { useCallback } from 'react';
+import { useRozenitePluginAgentTool, type AgentTool } from '@rozenite/agent-bridge';
+import type { StorageEntry, StorageEntryType, StorageEntryValue } from '../shared/types';
+import type { StorageView } from './storage-view';
+
+type StorageInput = { adapterId?: string; storageId?: string };
+type KeyInput = StorageInput & { key: string };
+type SetInput = StorageInput & {
+  key: string;
+  type: StorageEntryType;
+  value: unknown;
+};
+type ListEntriesInput = StorageInput & {
+  offset?: number;
+  limit?: number;
+};
+
+const toolPrefix = '@rozenite/storage-plugin';
+const sharedStorageProperties = {
+  adapterId: {
+    type: 'string',
+    description:
+      'Storage adapter ID. Required when multiple adapters are configured.',
+  },
+  storageId: {
+    type: 'string',
+    description:
+      'Storage node ID within the adapter. Required when multiple storages are configured.',
+  },
+} as const;
+
+const listStoragesTool: AgentTool = {
+  name: 'list-storages',
+  description:
+    'List all storage adapters and their storage nodes currently available on the device, including supported entry types and entry counts.',
+  inputSchema: { type: 'object', properties: {} },
+};
+
+const listEntriesTool: AgentTool = {
+  name: 'list-entries',
+  description:
+    'List keys in a storage. This call intentionally does not return entry values to keep responses token-efficient.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ...sharedStorageProperties,
+      offset: {
+        type: 'number',
+        description: 'Pagination offset. Defaults to 0.',
+      },
+      limit: {
+        type: 'number',
+        description: 'Pagination size. Defaults to 100.',
+      },
+    },
+  },
+};
+
+const readEntryTool: AgentTool = {
+  name: 'read-entry',
+  description: 'Read a single storage entry value by key.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ...sharedStorageProperties,
+      key: { type: 'string', description: 'Entry key.' },
+    },
+    required: ['key'],
+  },
+};
+
+const createEntryTool: AgentTool = {
+  name: 'create-entry',
+  description: 'Create a new storage entry. Fails if the key already exists.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ...sharedStorageProperties,
+      key: { type: 'string', description: 'Entry key.' },
+      type: {
+        type: 'string',
+        enum: ['string', 'number', 'boolean', 'buffer'],
+        description:
+          'Entry value type. Must be one of the supported types for the target storage (see list-storages).',
+      },
+      value: {
+        description: 'Entry value matching the provided type.',
+      },
+    },
+    required: ['key', 'type', 'value'],
+  },
+};
+
+const editEntryTool: AgentTool = {
+  name: 'edit-entry',
+  description: 'Edit an existing storage entry. Fails if the key does not exist.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ...sharedStorageProperties,
+      key: { type: 'string', description: 'Entry key.' },
+      type: {
+        type: 'string',
+        enum: ['string', 'number', 'boolean', 'buffer'],
+        description:
+          'Entry value type. Must be one of the supported types for the target storage (see list-storages).',
+      },
+      value: {
+        description: 'Entry value matching the provided type.',
+      },
+    },
+    required: ['key', 'type', 'value'],
+  },
+};
+
+const removeEntryTool: AgentTool = {
+  name: 'remove-entry',
+  description: 'Remove a storage entry by key.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ...sharedStorageProperties,
+      key: { type: 'string', description: 'Entry key.' },
+    },
+    required: ['key'],
+  },
+};
+
+const parseValueForType = (
+  type: StorageEntryType,
+  value: unknown
+): StorageEntryValue => {
+  if (type === 'string') {
+    if (typeof value !== 'string') {
+      throw new Error('Expected string value for type=string');
+    }
+    return value;
+  }
+
+  if (type === 'number') {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+      throw new Error('Expected number value for type=number');
+    }
+    return value;
+  }
+
+  if (type === 'boolean') {
+    if (typeof value !== 'boolean') {
+      throw new Error('Expected boolean value for type=boolean');
+    }
+    return value;
+  }
+
+  if (!Array.isArray(value) || !value.every((item) => Number.isInteger(item))) {
+    throw new Error('Expected number[] value for type=buffer');
+  }
+
+  return value as number[];
+};
+
+const formatViewRef = (view: StorageView) =>
+  `${view.target.adapterId}/${view.target.storageId}`;
+
+export const useStorageAgentTools = (views: StorageView[]) => {
+  const resolveStorage = useCallback(
+    (adapterId?: string, storageId?: string) => {
+      if (views.length === 0) {
+        throw new Error('No storages are registered.');
+      }
+
+      if (adapterId !== undefined || storageId !== undefined) {
+        const selected = views.find(
+          (view) =>
+            (adapterId === undefined || view.target.adapterId === adapterId) &&
+            (storageId === undefined || view.target.storageId === storageId)
+        );
+
+        if (!selected) {
+          const qualifier = [
+            adapterId && `adapterId="${adapterId}"`,
+            storageId && `storageId="${storageId}"`,
+          ]
+            .filter(Boolean)
+            .join(', ');
+          throw new Error(
+            `No storage matched ${qualifier}. Available: ${views.map(formatViewRef).join(', ')}`
+          );
+        }
+
+        return selected;
+      }
+
+      if (views.length > 1) {
+        throw new Error(
+          `Multiple storages detected. Provide adapterId and/or storageId. Available: ${views.map(formatViewRef).join(', ')}`
+        );
+      }
+
+      return views[0];
+    },
+    [views]
+  );
+
+  useRozenitePluginAgentTool({
+    pluginId: toolPrefix,
+    tool: listStoragesTool,
+    handler: async () => ({
+      storages: await Promise.all(
+        views.map(async (view) => ({
+          adapterId: view.target.adapterId,
+          storageId: view.target.storageId,
+          adapterName: view.adapterName,
+          storageName: view.storageName,
+          supportedTypes: view.capabilities.supportedTypes,
+          entryCount: (await view.getAllKeys()).length,
+        }))
+      ),
+    }),
+  });
+
+  useRozenitePluginAgentTool<ListEntriesInput>({
+    pluginId: toolPrefix,
+    tool: listEntriesTool,
+    handler: async ({ adapterId, storageId, offset = 0, limit = 100 }) => {
+      const view = resolveStorage(adapterId, storageId);
+      const allKeys = await view.getAllKeys();
+      const safeOffset = Math.max(0, Math.floor(offset));
+      const safeLimit = Math.max(1, Math.floor(limit));
+      const keys = allKeys.slice(safeOffset, safeOffset + safeLimit);
+
+      return {
+        adapterId: view.target.adapterId,
+        storageId: view.target.storageId,
+        total: allKeys.length,
+        offset: safeOffset,
+        limit: safeLimit,
+        keys,
+      };
+    },
+  });
+
+  useRozenitePluginAgentTool<
+    KeyInput,
+    { adapterId: string; storageId: string; entry: StorageEntry }
+  >({
+    pluginId: toolPrefix,
+    tool: readEntryTool,
+    handler: async ({ adapterId, storageId, key }) => {
+      const view = resolveStorage(adapterId, storageId);
+      const entry = await view.get(key);
+
+      if (!entry) {
+        throw new Error(
+          `Key "${key}" not found in storage "${formatViewRef(view)}".`
+        );
+      }
+
+      return {
+        adapterId: view.target.adapterId,
+        storageId: view.target.storageId,
+        entry,
+      };
+    },
+  });
+
+  useRozenitePluginAgentTool<SetInput>({
+    pluginId: toolPrefix,
+    tool: createEntryTool,
+    handler: async ({ adapterId, storageId, key, type, value }) => {
+      const view = resolveStorage(adapterId, storageId);
+      const existing = await view.get(key);
+
+      if (existing) {
+        throw new Error(
+          `Key "${key}" already exists in storage "${formatViewRef(view)}". Use edit-entry instead.`
+        );
+      }
+
+      const parsedValue = parseValueForType(type, value);
+      await view.set({ key, type, value: parsedValue } as StorageEntry);
+
+      return {
+        adapterId: view.target.adapterId,
+        storageId: view.target.storageId,
+        created: true,
+        key,
+      };
+    },
+  });
+
+  useRozenitePluginAgentTool<SetInput>({
+    pluginId: toolPrefix,
+    tool: editEntryTool,
+    handler: async ({ adapterId, storageId, key, type, value }) => {
+      const view = resolveStorage(adapterId, storageId);
+      const existing = await view.get(key);
+
+      if (!existing) {
+        throw new Error(
+          `Key "${key}" not found in storage "${formatViewRef(view)}". Use create-entry instead.`
+        );
+      }
+
+      const parsedValue = parseValueForType(type, value);
+      await view.set({ key, type, value: parsedValue } as StorageEntry);
+
+      return {
+        adapterId: view.target.adapterId,
+        storageId: view.target.storageId,
+        edited: true,
+        key,
+      };
+    },
+  });
+
+  useRozenitePluginAgentTool<KeyInput>({
+    pluginId: toolPrefix,
+    tool: removeEntryTool,
+    handler: async ({ adapterId, storageId, key }) => {
+      const view = resolveStorage(adapterId, storageId);
+      const existed = !!(await view.get(key));
+      await view.delete(key);
+
+      return {
+        adapterId: view.target.adapterId,
+        storageId: view.target.storageId,
+        removed: existed,
+        key,
+      };
+    },
+  });
+};