@swmansion/argent 0.5.1

package/LICENSE

@@ -0,0 +1,195 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or in addition to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly prevent it,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Software Mansion S.A.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+---
+
+ADDITIONAL TERMS: PROPRIETARY BINARY COMPONENTS
+
+The following files included in this package are NOT governed by the Apache
+License, Version 2.0 above:
+
+  bin/simulator-server
+  bin/ax-service
+  dylibs/libArgentInjectionBootstrap.dylib
+  dylibs/libKeyboardPatch.dylib
+  dylibs/libNativeDevtoolsIos.dylib
+
+These files are the proprietary intellectual property of Software Mansion S.A.
+and are licensed solely for use in conjunction with this package.
+Decompiling, reverse engineering, disassembling, or redistributing these files
+outside the scope of this project without explicit written permission from
+Software Mansion S.A. is strictly prohibited.

package/README.md

@@ -0,0 +1,103 @@
+<br/>
+<p align="center">
+  <a href="https://argent.swmansion.com">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/software-mansion/argent/blob/main/assets/banner_dark_mode.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://github.com/software-mansion/argent/blob/main/assets/banner_white_mode.png">
+      <img alt="banner" src="https://github.com/software-mansion/argent/blob/main/assets/banner_dark_mode.png" width="80%">
+    </picture>
+  </a>
+</p>
+<br/>
+
+**[Argent](https://argent.swmansion.com)** is an **agentic toolkit** that gives your AI assistant direct access to iOS Simulators. Ask it to tap a button, run a profiler or reproduce an issue manually - all from within your CLI, without switching context.
+
+```bash
+npx @swmansion/argent init
+```
+
+## Capabilities
+
+- **Autonomous iOS development** - Allow your agent to work with iOS apps on its own - let it build, open, interact with the app and debug it. Ask for reproducing issues, testing features manually, profiling your app and much more, without ever interrupting your work.
+- **UI interaction** - Give your agent full control toolkit - tapping, swiping, pinching, typing, gestures, hardware buttons and all other gears included. Let it navigate your app exactly as a user would, without lifting a finger.
+- **Profiling with batteries included** - Argent can perform and analyze both React-Native and Xcode Instruments profiling sessions. Get comprehensive summaries and ask to optimise your app where you find fit.
+- **Debugging and diagnostics** - Let your agent inspect logs, capture crash reports, and reproduce failing states on the simulator, so you can jump straight to the fix.
+- **React Native out of the box** - Argent works with React Native apps natively, so your agent can build, launch, and iterate on your RN project the same way it would any iOS app - no extra setup required.
+
+> **Tip:** Once installed, ask your assistant _"What can Argent do?"_ - it will walk you through all capabilities available.
+
+<br/>
+<p align="center">
+  <img src="https://github.com/software-mansion/argent/blob/main/assets/showcase.gif" alt="argent showcase video gif" width="100%" />
+</p>
+
+---
+
+## Installation
+
+#### Prerequisites
+
+- macOS with **Xcode** installed
+- **Node.js 18** or later
+
+#### Run `init` in your project
+
+From your project root:
+
+```bash
+npx @swmansion/argent init
+```
+
+This command triggers an installation wizard which:
+
+- Installs `@swmansion/argent` globally
+- Detects your editor and registers the MCP server
+- Copies skills, rules, and agent definitions into your workspace
+
+#### Prefer a manual install?
+
+```bash
+npm install -g @swmansion/argent
+argent init
+```
+
+## CLI Reference
+
+| Command            | Description                                                 |
+| ------------------ | ----------------------------------------------------------- |
+| `argent init`      | Install globally and configure MCP in the current workspace |
+| `argent install`   | Alias for `init` command                                    |
+| `argent update`    | Pull the latest version and refresh workspace configuration |
+| `argent remove`    | Unregister the MCP server and uninstall the package         |
+| `argent uninstall` | Alias for `remove` command                                  |
+| `argent mcp`       | Start MCP server instance, used internally by agent         |
+
+## Supported Editors
+
+`argent init` auto-detects and configures MCP for:
+
+| Editor      | Config location                                               |
+| ----------- | ------------------------------------------------------------- |
+| Claude Code | `.mcp.json` (project) or `~/.claude.json` (global)            |
+| Cursor      | `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
+| VS Code     | `.vscode/mcp.json`                                            |
+| Windsurf    | `.windsurf/mcp.json`                                          |
+| Zed         | `.zed/settings.json`                                          |
+| Gemini CLI  | `.gemini/settings.json`                                       |
+| Codex CLI   | `.codex/config.yaml`                                          |
+
+## License
+
+Argent uses a mixed licensing model.
+
+**Source code** is released under the [Apache License 2.0](LICENSE).
+
+**Proprietary binaries** (the `bin/simulator-server` and `bin/ax-service` executables and the `.dylib` files in `native-devtools-ios`) are the intellectual property of Software Mansion S.A. and are licensed solely for use within this project. Decompiling, reverse-engineering, or redistributing them without explicit written permission is prohibited.
+
+By using Argent, you acknowledge and agree to this structure. See [LICENSE](https://github.com/software-mansion/argent/blob/main/LICENSE.txt) for full details.
+
+## Argent is created by Software Mansion
+
+Since 2012 [Software Mansion](https://swmansion.com) is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – [Hire us](https://swmansion.com/contact/projects?utm_source=argent&utm_medium=readme).
+
+[![swm](https://logo.swmansion.com/logo?color=white&variant=desktop&width=150&tag=argent-github "Software Mansion")](https://swmansion.com)

package/agents/argent-environment-inspector.md

@@ -0,0 +1,106 @@
+---
+name: argent-environment-inspector
+description: >
+  Inspects a mobile app project's environment and returns structured JSON covering
+  project type, platform support, build and startup commands, bundler config, env
+  resolution, key packages, QA/feedback-loop tooling, and Argent-specific workflow
+  commands. Works on any project — determines whether it is React Native, Expo,
+  Flutter, native iOS/Android, or another stack, and provides environment context
+  regardless. Has deeper React Native introspection via gather-workspace-data but
+  also reports useful information for non-RN projects.
+  Use proactively at session start when required to gather the environment information.
+  If subagent delegation is not available, run the steps in the main thread instead.
+  The main agent is responsible for persisting the result to project memory.
+model: haiku
+---
+
+You are the **environment-inspector** subagent. Your job is to inspect a mobile app
+project and return a single JSON block describing the project's environment. You do
+not write files — the main agent handles persistence.
+
+**Your first task is to determine what kind of project this is.**. The project could be, for example:
+
+- React Native (bare CLI or Expo)
+- Flutter / Dart
+- Native iOS (Swift / Objective-C with Xcode)
+- Native Android (Kotlin / Java with Gradle)
+- A web app, a monorepo containing multiple apps, or something else entirely
+
+Provide useful environment context regardless of the project type. You have
+deep introspection tools at your disposal - `gather-workspace-data`, which provides heuristical
+context about the workspace structure. If any of the information is not retrieved from the tool,
+but required by the main agent, fill it in by manual inspection of the project.
+
+## Execution steps
+
+1. **Call `gather-workspace-data`** with the project's workspace path.
+   This is always your first action. It returns a structured snapshot of
+   `package.json`, metro/babel config text, `app.json`, `eas.json`, `tsconfig`,
+   platform directories, lockfile type, `.env` key names, CLI tool versions,
+   `scripts/` listing, husky hooks, CI config, Makefile targets, and config
+   file existence.
+
+2. **Determine the project type.** From the snapshot, classify the project:
+   - `react-native` in `package.json` dependencies → React Native project
+   - `expo` in dependencies or `app.json` with `expo` key → Expo project
+   - `pubspec.yaml` present → Flutter project
+   - `ios/*.xcodeproj` or `ios/*.xcworkspace` without `react-native` → native iOS
+   - `android/build.gradle` without `react-native` → native Android
+   - None of the above → classify based on what you find (web app, library, etc.)
+
+3. **Explore beyond the snapshot.** Use Read, Glob, Grep, and Bash to fill
+   gaps the snapshot does not cover:
+   - Non-obvious `scripts/` directory contents and what each script does.
+   - CI workflow files (`.github/workflows/*.yml`) to understand what "passing" means.
+   - Custom Makefile or Fastfile targets.
+   - `package.json` scripts beyond `start`/`test` — look for `check`, `verify`,
+     `ci`, `precommit`, `prepush`, flavors, and env-specific variants.
+   - `.husky/` hook contents to understand pre-commit/pre-push validation.
+   - `lint-staged` config to understand what runs on commit.
+   - Monorepo indicators: `workspaces` in root `package.json`, `turbo.json`,
+     `nx.json`, `lerna.json`.
+   - README or CONTRIBUTING docs that describe build/run/test workflows.
+   - Storybook config (`.storybook/`), Detox config (`.detoxrc.js`), Maestro
+     flows (`.maestro/`).
+   - For Flutter: `pubspec.yaml`, `analysis_options.yaml`, `lib/` structure.
+   - For native iOS: Xcode project/workspace, schemes, `Podfile`, `Package.swift`.
+   - For native Android: `build.gradle`, `settings.gradle`, flavor configs.
+
+4. **Populate every field** in the output schema below. Use `null` for
+   genuinely unknown values or fields that do not apply to this project type.
+   Prefer concrete commands over generic ones (e.g. `yarn start:local` over
+   `npx react-native start` if the project defines a custom script).
+
+5. **Return the JSON block** — no prose, no markdown fences, no
+   explanation. The main agent parses your entire response as JSON.
+
+## Output schema
+
+Return a JSON object with these top-level fields:
+
+| Field                                 | Type         | Description                                                                                   |
+| ------------------------------------- | ------------ | --------------------------------------------------------------------------------------------- |
+| `project_type`                        | string       | `react-native`, `expo`, `flutter`, `native-ios`, `native-android`, `web`, `monorepo`, `other` |
+| `project_type_details`                | string       | Short human-readable stack summary                                                            |
+| `is_react_native`                     | bool         | `react-native` in deps                                                                        |
+| `is_ios` / `is_android`               | bool         | Platform directories exist                                                                    |
+| `is_expo` / `is_web` / `is_flutter`   | bool         | Framework detection flags                                                                     |
+| `is_native_ios` / `is_native_android` | bool         | Native without cross-platform framework                                                       |
+| `startup_commands`                    | array        | `[{ command, context }]` — concrete dev server start commands                                 |
+| `build_commands`                      | array        | `[{ command, platform, context }]` — build commands per platform                              |
+| `argent_workflow`                     | object       | `{ start_dev_server, build_ios, build_android, notes }` — exact commands for Argent           |
+| `configs`                             | object       | Paths to metro, babel, app, tsconfig, pubspec, xcode, gradle configs (`null` if absent)       |
+| `metro_port`                          | number\|null | From config or default 8081; `null` for non-RN                                                |
+| `env_resolution`                      | object       | `{ env_files, strategy, notes }`                                                              |
+| `key_packages`                        | object       | Major dependencies with versions                                                              |
+| `package_json`                        | object       | `{ name, version, scripts_summary }`                                                          |
+| `bundler`                             | string\|null | `metro`, `webpack`, etc.                                                                      |
+| `terminal_tools`                      | object       | `{ package_manager, pod_available, expo_cli, eas_cli }`                                       |
+| `cloud_build`                         | object       | `{ eas, eas_profiles }` or other CI/CD                                                        |
+| `quality_control`                     | object       | Linting, formatting, type checking, unit tests, e2e tests, feedback loop tools                |
+| `additional_notes`                    | string       | Anything relevant not covered above                                                           |
+| `needs_user_input`                    | bool         | True if critical info is missing                                                              |
+| `missing_information`                 | array        | List of things you couldn't determine                                                         |
+| `inspected_at`                        | string       | ISO 8601 timestamp                                                                            |
+
+For the `quality_control` field structure, see `references/quality-control-checklist.md`.

package/agents/references/quality-control-checklist.md

@@ -0,0 +1,45 @@
+## Quality control checklist
+
+The `quality_control` field in the output JSON must follow this structure:
+
+```json
+{
+  "linting": { "eslint": bool, "eslint_config": "path", "run_command": "cmd", "fix_command": "cmd" },
+  "formatting": { "prettier": bool, "prettier_config": "path", "run_command": "cmd" },
+  "type_checking": { "typescript": bool, "strict_mode": bool, "run_command": "cmd" },
+  "unit_tests": { "jest": bool, "jest_config": "path", "run_command": "cmd", "watch_command": "cmd", "coverage_command": "cmd" },
+  "e2e_tests": { "detox": bool, "maestro": bool, "xctest": bool, "flutter_integration_test": bool },
+  "feedback_loop_tools": { "metro_hot_reload": bool, "flutter_hot_reload": bool, "react_devtools": bool, "flipper": bool, "storybook": bool, "notes": "string" }
+}
+```
+
+Look for these beyond the obvious lint/test configs, regardless of project type:
+
+**Immediate feedback tools (agent can trigger during a task):**
+
+- `tsc --noEmit` — instant type error feedback after edits (TypeScript projects)
+- `eslint --fix` / `swiftlint` / `ktlint` — auto-fixable lint errors
+- `jest --testPathPattern <file>` — single test file (JS/TS projects)
+- `dart analyze` — static analysis (Flutter projects)
+- `flutter test <file>` — single test file (Flutter projects)
+- `yarn test --watch` / `flutter test --watch` — reactive test runner
+- Metro hot reload (via `debugger-reload-metro` Argent tool, RN only)
+- Flutter hot reload / hot restart
+
+**Slower validation tools (agent runs at end of a task):**
+
+- Full test suite run (`jest`, `flutter test`, `xcodebuild test`, `gradle test`)
+- E2E: Detox, Maestro, XCUITest, Espresso, Flutter integration tests
+- `eas build --local` / `flutter build` / `xcodebuild` for native validation
+
+**Indicators to check (all project types):**
+
+- `scripts/` directory at project root — often contains custom validation scripts
+- `Makefile` / `Fastfile` targets — look for `lint`, `test`, `typecheck`, `check`, `validate`
+- `package.json` scripts named `check`, `verify`, `ci`, `precommit`, `prepush`
+- `.husky/` directory — which hooks run and what they execute
+- `lint-staged` config — what runs on commit
+- CI config files — the CI steps are ground truth for what "passing" means
+- `Podfile` / `Package.swift` — iOS dependency management
+- `build.gradle` / `settings.gradle` — Android build config and flavor definitions
+- `pubspec.yaml` / `analysis_options.yaml` — Flutter project config and lint rules

package/dist/auto-screenshot.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Auto-screenshot configuration and helpers.
+ *
+ * After a successful simulator interaction tool call, the MCP layer
+ * automatically captures a screenshot and appends it to the response.
+ * All tunables live in this module so they can be tested in isolation.
+ */
+export declare const AUTO_SCREENSHOT_TOOLS: Set<string>;
+/**
+ * Per-tool delay (ms) before capturing the screenshot.
+ * +1 000 ms over baseline research values to cover slow devices/transitions.
+ */
+export declare const AUTO_SCREENSHOT_DELAY_MS_BY_TOOL: Record<string, number>;
+export declare function autoScreenshotEnabled(): boolean;
+export declare function getUdidFromArgs(args: unknown): string | undefined;
+/**
+ * Strip known MCP prefix so the allow-list matches canonical names.
+ * Cursor sends `mcp__argent__tap`; we need `tap`.
+ */
+export declare function normalizeToolName(name: string): string;
+export declare function shouldAutoScreenshot(toolName: string): boolean;
+export declare function getAutoScreenshotDelayMs(toolName: string): number;

package/dist/auto-screenshot.js

@@ -0,0 +1,79 @@
+/**
+ * Auto-screenshot configuration and helpers.
+ *
+ * After a successful simulator interaction tool call, the MCP layer
+ * automatically captures a screenshot and appends it to the response.
+ * All tunables live in this module so they can be tested in isolation.
+ */
+export const AUTO_SCREENSHOT_TOOLS = new Set([
+    "gesture-tap",
+    "gesture-swipe",
+    "gesture-custom",
+    "gesture-pinch",
+    "gesture-rotate",
+    "button",
+    "keyboard",
+    "rotate",
+    "launch-app",
+    "restart-app",
+    "open-url",
+    "describe",
+    "run-sequence",
+]);
+/**
+ * Per-tool delay (ms) before capturing the screenshot.
+ * +1 000 ms over baseline research values to cover slow devices/transitions.
+ */
+export const AUTO_SCREENSHOT_DELAY_MS_BY_TOOL = {
+    "launch-app": 3000,
+    "restart-app": 3000,
+    "open-url": 2000,
+    "gesture-swipe": 1500,
+    "gesture-custom": 1500,
+    "gesture-tap": 1500,
+    "gesture-pinch": 1500,
+    "gesture-rotate": 1500,
+    "run-sequence": 15000,
+    "button": 1500,
+    "rotate": 1000,
+    "keyboard": 300,
+    "describe": 100,
+};
+const DEFAULT_DELAY_MS = 1400;
+export function autoScreenshotEnabled() {
+    const v = process.env.ARGENT_AUTO_SCREENSHOT;
+    return v === undefined || v === "" || v === "1" || v.toLowerCase() === "true";
+}
+export function getUdidFromArgs(args) {
+    if (args &&
+        typeof args === "object" &&
+        "udid" in args &&
+        typeof args.udid === "string") {
+        return args.udid;
+    }
+    return undefined;
+}
+/**
+ * Strip known MCP prefix so the allow-list matches canonical names.
+ * Cursor sends `mcp__argent__tap`; we need `tap`.
+ */
+export function normalizeToolName(name) {
+    const idx = name.lastIndexOf("__");
+    return idx === -1 ? name : name.slice(idx + 2);
+}
+export function shouldAutoScreenshot(toolName) {
+    const canonical = normalizeToolName(toolName);
+    return canonical !== "screenshot" && AUTO_SCREENSHOT_TOOLS.has(canonical);
+}
+export function getAutoScreenshotDelayMs(toolName) {
+    const canonical = normalizeToolName(toolName);
+    const base = AUTO_SCREENSHOT_DELAY_MS_BY_TOOL[canonical] ?? DEFAULT_DELAY_MS;
+    const envOverride = process.env.ARGENT_AUTO_SCREENSHOT_DELAY_MS;
+    if (envOverride) {
+        const envMs = parseInt(envOverride, 10);
+        if (!Number.isNaN(envMs))
+            return Math.max(base, envMs);
+    }
+    return base;
+}
+//# sourceMappingURL=auto-screenshot.js.map

package/dist/auto-screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-screenshot.js","sourceRoot":"","sources":["../src/auto-screenshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,UAAU;IACV,UAAU;IACV,cAAc;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2B;IACtE,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,KAAK;IACrB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,GAAG;IACf,UAAU,EAAE,GAAG;CAChB,CAAC;AAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,qBAAqB;IACnC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC7C,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IACE,IAAI;QACJ,OAAO,IAAI,KAAK,QAAQ;QACxB,MAAM,IAAI,IAAI;QACd,OAAQ,IAA0B,CAAC,IAAI,KAAK,QAAQ,EACpD,CAAC;QACD,OAAQ,IAAyB,CAAC,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,SAAS,KAAK,YAAY,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,gCAAgC,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC;IAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;IAChE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const PACKAGE_NAME = "@swmansion/argent";
+export declare const NPM_REGISTRY = "https://registry.npmjs.org";
+export declare const MCP_SERVER_KEY = "argent";
+export declare const MCP_BINARY_NAME = "argent";
+export declare const PERMISSION_RULE = "mcp__argent";
+export declare const CURSOR_ALLOWLIST_PATTERN = "argent:*";

package/dist/cli/constants.js

@@ -0,0 +1,12 @@
+// Configurable constants for the argent CLI.
+// Change these if the npm package name, registry, or MCP key changes.
+export const PACKAGE_NAME = "@swmansion/argent";
+// Used ONLY for single-package queries (e.g. `npm view`), never for install
+// commands. Install relies on the user's scoped registry in ~/.npmrc so that
+// third-party dependencies resolve from npmjs.org normally.
+export const NPM_REGISTRY = "https://registry.npmjs.org";
+export const MCP_SERVER_KEY = "argent";
+export const MCP_BINARY_NAME = "argent";
+export const PERMISSION_RULE = "mcp__argent";
+export const CURSOR_ALLOWLIST_PATTERN = "argent:*";
+//# sourceMappingURL=constants.js.map

package/dist/cli/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,sEAAsE;AAEtE,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEhD,4EAA4E;AAC5E,6EAA6E;AAC7E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,2 @@
+export declare function init(args: string[]): Promise<void>;
+export declare function printBanner(): void;