tauri-agent-tools 0.5.1 → 0.6.0

package/dist/schemas/interact.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+// === Interaction Results ===
+export const InteractionResultSchema = z.object({
+    success: z.boolean(),
+    selector: z.string().optional(),
+    tagName: z.string().optional(),
+    error: z.string().optional(),
+});
+export const ClickResultSchema = InteractionResultSchema.extend({
+    text: z.string().optional(),
+});
+export const TypeResultSchema = InteractionResultSchema.extend({
+    value: z.string().optional(),
+});
+export const ScrollResultSchema = z.object({
+    success: z.boolean(),
+    scrollX: z.number().optional(),
+    scrollY: z.number().optional(),
+    error: z.string().optional(),
+});
+export const SelectResultSchema = InteractionResultSchema.extend({
+    value: z.string().optional(),
+    checked: z.boolean().optional(),
+});
+export const InvokeResultSchema = z.object({
+    success: z.boolean(),
+    command: z.string(),
+    result: z.unknown().optional(),
+    error: z.string().optional(),
+});
+//# sourceMappingURL=interact.js.map

package/dist/schemas/interact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.js","sourceRoot":"","sources":["../../src/schemas/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8BAA8B;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/examples/tauri-bridge/src/dev_bridge.rs

@@ -15,6 +15,8 @@ use tracing_subscriber::util::SubscriberInitExt;
 struct EvalRequest {
     js: String,
     token: String,
+    #[serde(default)]
+    window: Option<String>,
 }
 
 #[derive(Deserialize)]
@@ -41,6 +43,32 @@ struct LogResponse {
     entries: Vec<LogEntry>,
 }
 
+#[derive(Deserialize)]
+struct DescribeRequest {
+    token: String,
+}
+
+#[derive(Serialize, Default)]
+struct DescribeResponse {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    app: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pid: Option<u32>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    windows: Option<Vec<String>>,
+    capabilities: Vec<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    surfaces: Option<HashMap<String, String>>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    exports: Option<HashMap<String, String>>,
+}
+
+#[derive(Serialize)]
+struct VersionResponse {
+    version: String,
+    endpoints: Vec<String>,
+}
+
 #[derive(Serialize)]
 struct TokenFile {
     port: u16,
@@ -295,7 +323,24 @@ pub fn start_bridge(app: &AppHandle) -> Result<(u16, Arc<LogBuffer>), String> {
             let is_post = request.method().as_str() == "POST";
             let url = request.url().to_string();
 
-            if !is_post || (url != "/eval" && url != "/logs") {
+            // Handle GET /version (no auth needed)
+            if url == "/version" && request.method().as_str() == "GET" {
+                let resp = VersionResponse {
+                    version: "0.6.0".to_string(),
+                    endpoints: vec![
+                        "/eval".to_string(),
+                        "/logs".to_string(),
+                        "/describe".to_string(),
+                        "/version".to_string(),
+                    ],
+                };
+                let json = serde_json::to_string(&resp).unwrap();
+                let header = Header::from_bytes("Content-Type", "application/json").unwrap();
+                let _ = request.respond(Response::from_string(json).with_header(header));
+                continue;
+            }
+
+            if !is_post || (url != "/eval" && url != "/logs" && url != "/describe") {
                 let _ = request.respond(Response::from_string("Not found").with_status_code(404));
                 continue;
             }
@@ -333,6 +378,46 @@ pub fn start_bridge(app: &AppHandle) -> Result<(u16, Arc<LogBuffer>), String> {
                 continue;
             }
 
+            // Handle /describe endpoint
+            if url == "/describe" {
+                let desc_req: DescribeRequest = match serde_json::from_str(&body) {
+                    Ok(r) => r,
+                    Err(_) => {
+                        let _ = request
+                            .respond(Response::from_string("Invalid JSON").with_status_code(400));
+                        continue;
+                    }
+                };
+
+                if desc_req.token != expected_token {
+                    let _ = request
+                        .respond(Response::from_string("Unauthorized").with_status_code(401));
+                    continue;
+                }
+
+                let windows: Vec<String> = app_handle
+                    .webview_windows()
+                    .keys()
+                    .cloned()
+                    .collect();
+
+                let resp = DescribeResponse {
+                    pid: Some(std::process::id()),
+                    windows: Some(windows),
+                    capabilities: vec![
+                        "eval".to_string(),
+                        "logs".to_string(),
+                        "describe".to_string(),
+                    ],
+                    ..Default::default()
+                };
+
+                let json = serde_json::to_string(&resp).unwrap();
+                let header = Header::from_bytes("Content-Type", "application/json").unwrap();
+                let _ = request.respond(Response::from_string(json).with_header(header));
+                continue;
+            }
+
             // Handle /eval endpoint
             let eval_req: EvalRequest = match serde_json::from_str(&body) {
                 Ok(r) => r,
@@ -353,7 +438,8 @@ pub fn start_bridge(app: &AppHandle) -> Result<(u16, Arc<LogBuffer>), String> {
             // Evaluate JS in webview via callback pattern
             let request_id = uuid::Uuid::new_v4().to_string();
 
-            if let Some(window) = app_handle.get_webview_window("main") {
+            let window_label = eval_req.window.as_deref().unwrap_or("main");
+            if let Some(window) = app_handle.get_webview_window(window_label) {
                 // Build JS that evaluates the expression, then calls back into Rust
                 // via __TAURI__.core.invoke() to deliver the result.
                 let callback_js = format!(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-agent-tools",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Agent-driven inspection toolkit for Tauri desktop apps",
   "type": "module",
   "bin": {

package/rust-bridge/README.md

@@ -82,19 +82,21 @@ tauri-agent-tools eval "document.title"
 1. Bridge starts an HTTP server on a random localhost port
 2. A token file with `{ port, token, pid }` is written to `/tmp/`
 3. `tauri-agent-tools` discovers the token file and authenticates via the token
-4. Requests are `POST /eval { js, token }` (JS evaluation) or `POST /logs { token }` (Rust log retrieval)
-5. For `/eval`, the bridge injects JS into the webview
+4. The bridge exposes four endpoints: `POST /eval` (JS evaluation), `POST /logs` (Rust log retrieval), `POST /describe` (bridge metadata), and `GET /version` (unauthenticated health check)
+5. `/eval` accepts an optional `window` field to target specific webview windows (defaults to `"main"`)
 6. The injected JS evaluates the expression, then calls back into Rust via `window.__TAURI__.core.invoke("__dev_bridge_result", { id, value })` to deliver the result
 7. The HTTP handler thread waits for the result (up to 5 seconds) and returns it as JSON
-8. For `/logs`, the bridge drains its ring buffer of captured `tracing` events and returns them as JSON
-9. The token file is cleaned up when the app exits
+8. `/logs` drains the ring buffer of captured `tracing` events and returns them as JSON
+9. `/describe` returns PID, window labels, and capabilities
+10. The token file is cleaned up when the app exits
 
 ## Security
 
 - **Localhost only** — the bridge binds to `127.0.0.1`
 - **Token authenticated** — every request requires a random 32-char token
 - **Development only** — wrapped in `cfg!(debug_assertions)`, stripped in release builds
-- **Read-only** — `tauri-agent-tools` only reads DOM state, never injects input
+- **Inspection is read-only** — inspection commands only read DOM state
+- **Interaction is debug-only** — interaction commands use eval-based DOM dispatch, sandboxed to the webview
 
 ## Agent-Assisted Setup