@swmansion/argent 0.5.3 → 0.6.0-next.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.5.3",
+  "version": "0.6.0-next.2",
   "description": "MCP server for iOS Simulator control",
   "license": "Apache-2.0",
   "repository": {
@@ -13,12 +13,11 @@
     "argent-simulator-server": "bin/simulator-server"
   },
   "scripts": {
-    "build": "npm run build:mcp && npm run build:tools-bundle && npm run sync-readme",
-    "build:mcp": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "build": "npm run build:dispatcher && npm run build:bundles && npm run sync-readme",
+    "build:dispatcher": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "build:bundles": "node scripts/bundle-tools.cjs",
     "sync-readme": "node scripts/sync-readme.cjs",
     "prepack": "node scripts/sync-readme.cjs",
-    "build:tools-bundle": "node scripts/bundle-tools.cjs",
-    "dev": "node --loader ts-node/esm src/cli.ts mcp",
     "test": "vitest run",
     "test:watch": "vitest",
     "observe": "node scripts/observe.cjs",
@@ -40,18 +39,22 @@
     "scripts/postinstall.cjs"
   ],
   "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "@modelcontextprotocol/sdk": "^1.20.0",
-    "picocolors": "^1.1.1",
-    "semver": "^7.7.4",
-    "smol-toml": "^1.6.1",
-    "yaml": "^2.8.3"
+    "@modelcontextprotocol/sdk": "^1.20.0"
   },
   "devDependencies": {
+    "@argent/cli": "file:../argent-cli",
+    "@argent/installer": "file:../argent-installer",
+    "@argent/mcp": "file:../argent-mcp",
+    "@argent/tools-client": "file:../argent-tools-client",
+    "@clack/prompts": "^1.1.0",
     "@types/node": "^22.0.0",
     "@types/semver": "^7.7.1",
     "esbuild": "^0.27.3",
+    "picocolors": "^1.1.1",
+    "semver": "^7.7.4",
+    "smol-toml": "^1.6.1",
     "typescript": "^5.5.0",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "yaml": "^2.8.3"
   }
 }

package/skills/argent-react-native-profiler/SKILL.md

@@ -9,14 +9,15 @@ This skill is complementary to `argent-react-native-optimization`, not a replace
 
 ### React Profiler (Hermes / React commits)
 
-| Tool                              | Purpose                                                                                                       |
-| --------------------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `react-profiler-start`            | Start CPU sampling + inject React commit-capture hook. Optional: `sample_interval_us` (default 100).          |
-| `react-profiler-stop`             | Stop recording; stores cpuProfile + commitTree in session.                                                    |
-| `react-profiler-analyze`          | Run pipeline -> report with CPU-enriched hot commits, sorted by `totalRenderMs` DESC. Saves raw data to disk. |
-| `react-profiler-component-source` | AST lookup: file, line, memoization status, 50 lines of source for a component.                               |
-| `react-profiler-renders`          | Live fiber walk: render counts + durations per component (no profiling session required).                     |
-| `react-profiler-fiber-tree`       | Live fiber walk: full component hierarchy as JSON.                                                            |
+| Tool                              | Purpose                                                                                                                                                                                                                                                           |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `react-profiler-start`            | Start CPU sampling + inject React commit-capture hook. Optional: `sample_interval_us` (default 100).                                                                                                                                                              |
+| `react-profiler-stop`             | Stop recording; stores cpuProfile + commitTree in session.                                                                                                                                                                                                        |
+| `react-profiler-status`           | **Call if you were interrupted in the middle of the flow, never in another scenario** (debugger drop, Metro reload, pause, subagent handoff, any doubt). Returns `session_status: "active" \| "taken_over" \| "stopped" \| "no_react_runtime"`. Side-effect free. |
+| `react-profiler-analyze`          | Run pipeline -> report with CPU-enriched hot commits, sorted by `totalRenderMs` DESC. Saves raw data to disk.                                                                                                                                                     |
+| `react-profiler-component-source` | AST lookup: file, line, memoization status, 50 lines of source for a component.                                                                                                                                                                                   |
+| `react-profiler-renders`          | Live fiber walk: render counts + durations per component (no profiling session required).                                                                                                                                                                         |
+| `react-profiler-fiber-tree`       | Live fiber walk: full component hierarchy as JSON.                                                                                                                                                                                                                |
 
 ### Drill-Down Query Tools (call after analyze)
 
@@ -77,10 +78,13 @@ When profiling requires a specific interaction sequence (scroll a list, navigate
 
 ### Step 1: Start profiling
 
-Mind the react-native and ios-native profiler selection mentioned above when starting the session and start the tools. **Save `startedAtEpochMs` from the response** — you will need it later to compute annotation offsets. Every subsequent profiler/query call in this session must use the same `device_id`. Before beginning, define lightweight success criteria with the user: which metric matters most (e.g., `totalRenderMs`, specific commit duration, render count for a component) and what threshold would be meaningful. This anchors later evaluation. On success:
+Mind the react-native and ios-native profiler selection mentioned above when starting the session and start the tools. **Save `startedAtEpochMs` from the response** — you will need it for annotation offsets. Every subsequent profiler/query call in this session must use the same `device_id`. Before beginning, define lightweight success criteria with the user: which metric matters most (e.g., `totalRenderMs`, specific commit duration, render count for a component) and what threshold would be meaningful. This anchors later evaluation. On success:
 
 - if user asked you to perform the profiling, determine how to profile yourself using tools described in `argent-simulator-interact` skill.
 - if the user stated they wish to perform the interaction themselves — suggest what interaction to perform (e.g. "scroll the list", "switch tabs") and wait for their reply.
+  If you received information about **existing profiling session** being owned by another agent:
+- if session is marked as "stale", you may overtake it without prompting the user for allowance
+- if session is NOT "stale" - before taking action and terminating the other session, **stop and ask user what you should do**, explaining the situation.
 
 #### Annotate every interaction
 
@@ -88,8 +92,8 @@ After each `gesture-tap` or `gesture-swipe` call, record an annotation using the
 
 ### Step 2: Stop and collect
 
-Call `react-profiler-stop` **and** `ios-profiler-stop` in parallel. Only skip `ios-profiler-stop` if you did not start it in Step 1. Note `duration_ms`, `fiber_renders_captured`, `hook_installed`.
-If `hook_installed: false` or `fiber_renders_captured: 0`, warn the user — React commit data may be missing.
+Call `react-profiler-stop` **and** `ios-profiler-stop` in parallel. Only skip `ios-profiler-stop` if you did not start it in Step 1. Note `duration_ms` and `fiber_renders_captured`.
+If `fiber_renders_captured: 0`, warn the user — React commit data may be missing.
 
 ### Step 3: Analyze
 
@@ -151,7 +155,7 @@ If the user stated that they do not wish for changes, present the profiling repo
 - **Re-run after fixes**: Always re-profile after changes. Report honestly whether the metric improved, regressed, or stayed flat — do not assume improvement.
 - **`excluded` is informational**: Components in `animatedSubtrees` and `recyclerChildren` re-render by design.
 - **Strict Mode**: Double-invokes renders. The pipeline halves `normalizedRenderCount` automatically when detected.
-- **Debugger connection**: If interrupted, started profiling also closes. Check debugger status and restart the flow on errors.
+- **Debugger connection**: If interrupted, started profiling also closes. Before attempting recovery, call `react-profiler-status` — it tells you whether the session is `active`, `taken_over`, `stopped`, or `no_react_runtime`, so you can decide whether to stop, restart, or reconnect first.
 - **Confounders to watch for**:
   - Live API data may differ between runs (different payload sizes, content counts), which shifts render counts and durations independently of your fix. Note when data-dependent components show variance.
   - Profiler overhead inflates CPU measurements. If iOS Instruments shows `JSLexer`, `JSONEmitter`, or Hermes internals dominating the JS thread, that reflects profiler instrumentation cost — not app work. Discount those entries.

package/dist/auto-screenshot.d.ts

@@ -1,22 +0,0 @@
-/**
- * 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

@@ -1,79 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,6 +0,0 @@
-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

@@ -1,12 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

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