{"_id":"@byeongsu-hong/tauri-plugin-agent","_rev":"3-59bd8dda332ed148a0c245d2c2c682e5","name":"@byeongsu-hong/tauri-plugin-agent","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@byeongsu-hong/tauri-plugin-agent","version":"0.0.1","keywords":["tauri","agent","debugger","automation","mcp","webview","accessibility","semantic-tree"],"license":"MIT OR Apache-2.0","_id":"@byeongsu-hong/tauri-plugin-agent@0.0.1","maintainers":[{"name":"byeong-su","email":"hong@byeongsu.dev"}],"homepage":"https://github.com/byeongsu-hong/tauri-agent-plugin#readme","bugs":{"url":"https://github.com/byeongsu-hong/tauri-agent-plugin/issues"},"bin":{"tauri-agent":"dist-cli/tauri-agent.js","tauri-agent-mcp":"dist-cli/tauri-agent-mcp.js"},"dist":{"shasum":"193ecb644059a1ccf0b4e2c0dec4226c9c4727b6","tarball":"https://registry.npmjs.org/@byeongsu-hong/tauri-plugin-agent/-/tauri-plugin-agent-0.0.1.tgz","fileCount":126,"integrity":"sha512-dcHI+9AEdLnOR8H/01tYpavxm9ae+a6QHMCKQVQ1cYZGhE2RLRsWJS1qo76Ww4aMJaYrEHW5V9R7InTudfm3hw==","signatures":[{"sig":"MEUCIQD1czX3NbTEfde//hcxjgAz89NULI9LxxLdIa9+aL+M7QIgNmXMH7BA7wH6ThDAbEqc7J+fxUPaVBN74SrYL4DYY40=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5455121},"main":"./dist-js/index.cjs","type":"module","types":"./dist-js/index.d.ts","module":"./dist-js/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist-js/index.d.ts","import":"./dist-js/index.js","require":"./dist-js/index.cjs"},"./mcp":{"types":"./dist-js/mcp.d.ts","import":"./dist-js/mcp.js","require":"./dist-js/mcp.cjs"},"./daemon":{"types":"./dist-js/daemon.d.ts","import":"./dist-js/daemon.js","require":"./dist-js/daemon.cjs"},"./protocol":{"types":"./dist-js/protocol.d.ts","import":"./dist-js/protocol.js","require":"./dist-js/protocol.cjs"}},"gitHead":"64fe69be1956cb842744d88d7adf41da54c1087a","scripts":{"test":"vitest run","build":"tsup","check":"bun run typecheck && bun run test && bun run build","typecheck":"tsc --noEmit","check:rust":"cargo fmt --all -- --check && cargo clippy --all-targets -- -D warnings && cargo test","prepublishOnly":"bun run check"},"_npmUser":{"name":"byeong-su","email":"hong@byeongsu.dev"},"repository":{"url":"git+https://github.com/byeongsu-hong/tauri-agent-plugin.git","type":"git"},"_npmVersion":"11.16.0","description":"Agent-facing control surface for live Tauri apps using compact semantic trees.","directories":{},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"commander":"^14.0.0","@tauri-apps/api":"^2.11.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"tsup":"^8.5.0","jsdom":"^26.1.0","vitest":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.0.0","@types/jsdom":"^21.1.7"},"peerDependencies":{"jsdom":"^26.1.0"},"peerDependenciesMeta":{"jsdom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/tauri-plugin-agent_0.0.1_1783499035106_0.5153729330179826","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@byeongsu-hong/tauri-plugin-agent","version":"0.0.2","keywords":["tauri","agent","debugger","automation","mcp","webview","accessibility","semantic-tree"],"license":"MIT OR Apache-2.0","_id":"@byeongsu-hong/tauri-plugin-agent@0.0.2","maintainers":[{"name":"byeong-su","email":"hong@byeongsu.dev"}],"homepage":"https://github.com/byeongsu-hong/tauri-agent-plugin#readme","bugs":{"url":"https://github.com/byeongsu-hong/tauri-agent-plugin/issues"},"bin":{"tauri-agent":"dist-cli/tauri-agent.js","tauri-agent-mcp":"dist-cli/tauri-agent-mcp.js"},"dist":{"shasum":"de3ab02c442cbd554a8ecf781ea570b1538eb297","tarball":"https://registry.npmjs.org/@byeongsu-hong/tauri-plugin-agent/-/tauri-plugin-agent-0.0.2.tgz","fileCount":91,"integrity":"sha512-5I42d88DqE33hWUq/n9tQBaaTIsUa41Zz7rxYf0W+PbS/sKPaY/lLU4HfS7w3hIothHZu3KRT1ToZ8+kTWrKcA==","signatures":[{"sig":"MEUCIB6uo1z1KGrvxskBEUSY+H4/mspBw4715ECp2GBWkLHRAiEAsw7pQ6NyQSchSrzbaJfchyzqOCHXF/vHOYoIUb20/Gw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1883941},"main":"./dist-js/index.cjs","type":"module","types":"./dist-js/index.d.ts","module":"./dist-js/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist-js/index.d.ts","import":"./dist-js/index.js","require":"./dist-js/index.cjs"},"./mcp":{"types":"./dist-js/mcp.d.ts","import":"./dist-js/mcp.js","require":"./dist-js/mcp.cjs"},"./daemon":{"types":"./dist-js/daemon.d.ts","import":"./dist-js/daemon.js","require":"./dist-js/daemon.cjs"},"./protocol":{"types":"./dist-js/protocol.d.ts","import":"./dist-js/protocol.js","require":"./dist-js/protocol.cjs"}},"gitHead":"d9e77d5600abeae66fbd70389dbaaa961351ab76","scripts":{"test":"vitest run","build":"tsup","check":"bun run typecheck && bun run test && bun run build","typecheck":"tsc --noEmit","check:rust":"cargo fmt --all -- --check && cargo clippy --all-targets -- -D warnings && cargo test","prepublishOnly":"bun run check"},"_npmUser":{"name":"byeong-su","email":"hong@byeongsu.dev"},"repository":{"url":"git+https://github.com/byeongsu-hong/tauri-agent-plugin.git","type":"git"},"_npmVersion":"11.16.0","description":"Agent-facing control surface for live Tauri apps using compact semantic trees.","directories":{},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"commander":"^14.0.0","@tauri-apps/api":"^2.11.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"tsup":"^8.5.0","jsdom":"^26.1.0","vitest":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.0.0","@types/jsdom":"^21.1.7"},"peerDependencies":{"jsdom":"^26.1.0"},"peerDependenciesMeta":{"jsdom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/tauri-plugin-agent_0.0.2_1783778063068_0.7210277538434138","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @byeongsu-hong/tauri-agent-plugin; use the matching version there."}},"time":{"created":"2026-07-08T08:23:54.875Z","modified":"2026-07-11T14:35:23.778Z","0.0.1":"2026-07-08T08:23:55.328Z","0.0.2":"2026-07-11T13:54:23.282Z"},"bugs":{"url":"https://github.com/byeongsu-hong/tauri-agent-plugin/issues"},"license":"MIT OR Apache-2.0","homepage":"https://github.com/byeongsu-hong/tauri-agent-plugin#readme","keywords":["tauri","agent","debugger","automation","mcp","webview","accessibility","semantic-tree"],"repository":{"url":"git+https://github.com/byeongsu-hong/tauri-agent-plugin.git","type":"git"},"description":"Agent-facing control surface for live Tauri apps using compact semantic trees.","maintainers":[{"name":"byeong-su","email":"hong@byeongsu.dev"}],"readme":"# tauri-agent\n\nHeadless agent debugger for Tauri apps.\n\n`tauri-agent` is a protocol-first control surface for agents that need to\ninspect, drive, and debug live Tauri applications. One JSON-RPC 2.0 method set —\nsemantic tree snapshots, `@ref` actions, input synthesis, screenshots, logs /\nevents / network / IPC capture, dialogs, waiters, and recording — reachable from\na CLI, an MCP server, guest helpers, and Rust commands, all routing into a\nsingle bridge inside the instrumented webview.\n\n```bash\n# drive a running app the CLI discovers by app id\ntauri-agent tree  --app dev.byeongsu.tauri-agent.fixture\ntauri-agent find  --role button --name Forge --app dev.byeongsu.tauri-agent.fixture\ntauri-agent click @3 --app dev.byeongsu.tauri-agent.fixture\n```\n\n## Quickstart\n\n1. **Register the plugin** in `src-tauri`:\n\n   ```rust\n   tauri::Builder::default()\n     .plugin(tauri_plugin_agent::init())\n     .run(tauri::generate_context!())?;\n   ```\n\n2. **Grant the permission** in `src-tauri/capabilities/*.json`\n   (`{ \"permissions\": [\"core:default\", \"agent:default\"] }`).\n\n3. **Install the guest instrumentation** in your frontend — bridge commands hang\n   until it runs:\n\n   ```ts\n   import { WebviewAgentInstrumentation } from '@byeongsu-hong/tauri-plugin-agent'\n   new WebviewAgentInstrumentation({ windowLabel: 'main' }).install()\n   ```\n\n4. **Enable the inline server** in `tauri.conf.json` for out-of-process control.\n\n5. **Verify:** `tauri-agent attach --app <your.app.identifier>`.\n\nFull walkthrough → **[docs/adopting.md](./docs/adopting.md)**.\n\n## Documentation\n\n- **[docs/adopting.md](./docs/adopting.md)** — wire the plugin into your app,\n  inline server, VNC advertising, the fixture, fresh-clone build order.\n- **[docs/commands.md](./docs/commands.md)** — every method: CLI form, MCP tool,\n  and bridge behavior in one table.\n- **[docs/architecture.md](./docs/architecture.md)** — components, request flow,\n  transports, the two surfaces, screenshot support matrix, multi-webview.\n- **[docs/security.md](./docs/security.md)** — token auth, loopback/release\n  gating, the permission model, error taxonomy.\n- **[permissions/autogenerated/reference.md](./permissions/autogenerated/reference.md)**\n  — the generated permission reference.\n\n## MCP\n\n```bash\ntauri-agent-mcp\n```\n\nExposes the protocol as `tauri_<method>` stdio tools, each accepting the same\nconnection inputs as the CLI (`app`, `port`/`host`, or `html`/`fromHtml`). See\n[docs/commands.md](./docs/commands.md).\n\n## Develop\n\n```bash\nbun install\nbun run build      # produces dist-js (the fixture links against it)\nbun run check      # typecheck + vitest + build\nbun run check:rust # cargo fmt --check + clippy -D warnings + test\n```\n\nThe `examples/fixture-app` is the first real live-bridge target and ships a\nheadless `--self-test` mode exercised in CI.\n\n## License\n\nMIT OR Apache-2.0.\n","readmeFilename":"README.md"}