{"_id":"@byeongsu-hong/tauri-agent-plugin","name":"@byeongsu-hong/tauri-agent-plugin","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.2":{"name":"@byeongsu-hong/tauri-agent-plugin","version":"0.0.2","description":"Agent-facing control surface for live Tauri apps using compact semantic trees.","type":"module","packageManager":"bun@1.3.14","license":"MIT OR Apache-2.0","sideEffects":false,"engines":{"node":">=18"},"keywords":["tauri","agent","debugger","automation","mcp","webview","accessibility","semantic-tree"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/byeongsu-hong/tauri-agent-plugin.git"},"main":"./dist-js/index.cjs","module":"./dist-js/index.js","types":"./dist-js/index.d.ts","exports":{".":{"types":"./dist-js/index.d.ts","import":"./dist-js/index.js","require":"./dist-js/index.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"},"./mcp":{"types":"./dist-js/mcp.d.ts","import":"./dist-js/mcp.js","require":"./dist-js/mcp.cjs"}},"bin":{"tauri-agent":"dist-cli/tauri-agent.js","tauri-agent-mcp":"dist-cli/tauri-agent-mcp.js"},"scripts":{"build":"tsup","test":"vitest run","typecheck":"tsc --noEmit","check":"bun run typecheck && bun run test && bun run build","check:rust":"cargo fmt --all -- --check && cargo clippy --all-targets -- -D warnings && cargo test","prepublishOnly":"bun run check"},"dependencies":{"@tauri-apps/api":"^2.11.1","commander":"^14.0.0"},"peerDependencies":{"jsdom":"^26.1.0"},"peerDependenciesMeta":{"jsdom":{"optional":true}},"devDependencies":{"@types/jsdom":"^21.1.7","@types/node":"^24.0.0","jsdom":"^26.1.0","tsup":"^8.5.0","typescript":"^5.8.3","vitest":"^3.2.4"},"gitHead":"fc773cc18e85ac4deef0c450736af323d841b9f7","_id":"@byeongsu-hong/tauri-agent-plugin@0.0.2","bugs":{"url":"https://github.com/byeongsu-hong/tauri-agent-plugin/issues"},"homepage":"https://github.com/byeongsu-hong/tauri-agent-plugin#readme","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-qeOr5hHU40mG8de+6VKwRYWbuTz0nkKepYDy146bFI9yxz3c/h86MWb80I/B0OyCqb6Th54nPj6UadJcuRMKNA==","shasum":"dda4eddca3086b19f8729b8d48ada7372bd0e954","tarball":"https://registry.npmjs.org/@byeongsu-hong/tauri-agent-plugin/-/tauri-agent-plugin-0.0.2.tgz","fileCount":91,"unpackedSize":1884305,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDArUYDlWyKNT+1iFbEaB+Faq+m8tBYQgWkjBnRQ743QwIgL0zxgihrKwLuYGu3YqZRrYCBvLs3czaTsKw7JZSh0Fc="}]},"_npmUser":{"name":"byeong-su","email":"hong@byeongsu.dev"},"directories":{},"maintainers":[{"name":"byeong-su","email":"hong@byeongsu.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tauri-agent-plugin_0.0.2_1783780514129_0.3339284946152341"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T14:35:14.018Z","0.0.2":"2026-07-11T14:35:14.321Z","modified":"2026-07-11T14:35:14.490Z"},"maintainers":[{"name":"byeong-su","email":"hong@byeongsu.dev"}],"description":"Agent-facing control surface for live Tauri apps using compact semantic trees.","homepage":"https://github.com/byeongsu-hong/tauri-agent-plugin#readme","keywords":["tauri","agent","debugger","automation","mcp","webview","accessibility","semantic-tree"],"repository":{"type":"git","url":"git+https://github.com/byeongsu-hong/tauri-agent-plugin.git"},"bugs":{"url":"https://github.com/byeongsu-hong/tauri-agent-plugin/issues"},"license":"MIT OR Apache-2.0","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_agent_plugin::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-agent-plugin'\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 imports 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","_rev":"1-21b035cecf60383c62bf5f57b12fa519"}