io.github.GeroPalombo/swipium

• sessionIdstringrequired
• forceboolean
• reasonstring“What it documents (shown in qa_report).”
• inlineboolean“Also return the image inline (the result then has no structuredContent).”

• sessionIdstringrequired
• actionstringrequired
• targetobject“tap/type/clear (required); swipe: optional start point.”
• textstring“type (required)”
• modestring“type: replace (default) clears first.”
• submitboolean“type: press enter after.”
• directionstring“swipe/scroll (required)”
• untilVisibleobject“scroll: stop once visible (checked before the first swipe).”
• maxScrollsnumber“scroll: max swipes (default 8).”
• keystring“press (required)”
• urlstring“open_url (required)”
• durationMsnumber“tap: press duration (coordinate taps default ~100ms).”
• ignoreOverlayboolean“tap: tap even if an overlay/keyboard covers the target.”
• forobject“wait: {settled:true} (default), or until an element (ref/text/id/selector) is visible; gone:true waits until it is not.”
• timeoutMsnumber“wait: max ms (default 8000, max 50000; larger values are clamped); others: settle-wait cap.”
• observestring“diff (default after a snapshot): elements added/removed; full: capped list; none: verdicts only.”

• sessionIdstringrequired
• strategystring“default "auto"”
• targetRefstring“@eN to check obstruction before/after”

• sessionIdstringrequired
• jobIdstringrequired

• sessionIdstringrequired
• workflowstringrequired“e.g.”
• outcomestringrequired
• categorystring“Default for outcome:"fail" is app_bug; use mcp_limitation for tool problems.”
• reasonstring
• missingPreconditionstring“e.g.”
• requiredStatestring
• recommendedSetupstring
• artifactUrisarray
• verifiedVisuallyboolean“The pass was confirmed from an attached screenshot.”

• sessionIdstringrequired
• modestringrequired
• assertionstring“assert: what you visually confirmed.”
• passboolean“assert: default true; false if the expected result is NOT visible.”
• reasonstring“assert: extra detail.”
• namestring“baseline/diff: baseline name, [A-Za-z0-9._-]{1,64}.”
• querystring“find_text: text to find.”
• templatestring“find_image: project PNG or swipium:// URI.”
• thresholdnumber“diff: max changed fraction to pass (default 0.02).”
• minScorenumber“find_image: min match score 0..1 (default 0.85).”
• minConfidencenumber“find_text: min OCR confidence 0..1 (default 0.8).”
• tapboolean“find_text/find_image: tap the found point.”
• forceboolean“Capture even if a secure field may be visible.”
• consentIdstring
• approveboolean

• modestring
• sessionIdstring“Required for run.”
• projectRootstring“plan: absolute app root for flow names.”
• flowstring“Flow name under .swipium/flows, or a .yaml path.”
• flowYamlstring“Inline flow YAML.”
• variablesobject“run: ${VAR} values (over session inputs and SWIPIUM_* env); secret-like names are redacted.”
• repeatinteger“run: repeat N times to classify flakes.”
• consentIdstring“run: consent for mutating / OCR steps.”
• approveboolean
• backendstring“plan: only this backend (default all five).”
• appiumobject“plan: Appium session hints.”

• targetstringrequired
• modestring“generate (default) or plan (read-only preview).”
• sessionIdstring“Required except for target:"appium".”
• namestring“Asset name (default from the app id).”
• saveboolean“Write files (default: suite/appium true, others false).”
• budgetProfilestring“flow”
• compileboolean“suite: compile to runnable Flow V2 (default true).”
• replaystring“suite: replay gate (default dry_run; fresh_state needs stateProfile).”
• stateProfilestring“suite: for replay:"fresh_state".”
• formatstring“testcases (default both)”
• projectRootstring“appium: plan/bootstrap without a session.”
• bootstrapboolean or string“appium: record actions first when none exist.”
• featurestring“appium: focus for plan/bootstrap.”
• devicestring“appium: device to bootstrap on.”
• languagestring“appium (default auto-detected)”
• platformstring“appium”
• backendstring“appium plan: preferred backend.”
• integrateIntoProjectboolean“appium: write into the project (consent-gated, never overwrites).”
• includeCiboolean“appium: also emit ci.example.yml.”
• candidateOnlyboolean“appium: brittle locators do not fail validation.”
• brittleThresholdnumber“appium: max brittle-locator % (default 40).”
• consentIdstring“suite fresh_state / appium project write.”
• approveboolean

• sessionIdstringrequired
• launchboolean“Launch first (default true with an appId).”
• runFlowsboolean“Run saved .swipium/flows (default true).”
• variablesobject“${VAR} values for flows (over stored inputs, SWIPIUM_* env).”

• sessionIdstringrequired
• formatstring
• baselinestring“Baseline report.json path; adds comparison links.”
• trendRootstring“Project root with run history; adds trends/flakes.”

• sessionIdstring“Reuse a session.”
• projectRootstring
• modestring“execute (default, job) | plan (no side effects) | interactive (until the first question).”
• goalstring“Default: smoke, then a suite ("smoke" is fastest).”
• goalTextstring“reproduce_bug: the bug/flow to focus on.”
• fastSmokeboolean“Launch + smoke only, no suite (ignored with goal/generateSuite).”
• platformstring“Force a platform (default inferred).”
• devicestring
• preferRealDeviceboolean“Out of scope: returns PHYSICAL_DEVICE_UNSUPPORTED.”
• allowOutsideRootboolean
• buildIfNeededboolean“Build from source when no artifact exists (default true).”
• generateSuiteboolean“execute: also generate a POM suite from the run.”
• exploreboolean“execute: run guided exploration after the smoke.”
• stopOnNeedsInputboolean“execute: ask for login/test data instead of testing pre-login only.”
• waitForCompletionboolean“execute: block until done (or timeoutMs).”
• timeoutMsinteger“waitForCompletion window (default 45000, max 50000; SWIPIUM_MAX_WAIT_MS raises both; larger values are clamped); still running after it > state:"running" + job…”
• consentIdstring
• approveboolean
• responseModestring“compact = summary + URIs only; kept as the session default for later calls.”

• sessionIdstringrequired
• appstring“Simulator .app path (absolute or project-relative).”
• bundleIdstring
• devicestring“Simulator UDID or exact name (ignoring case).”
• launchboolean
• attachWdastring“auto (default): attach WDA if reachable, else visual-only; required: fail if it cannot attach; skip: visual-only.”
• allowLaunchWithoutMetroboolean“Launch a debug RN/Expo .app (no embedded main.jsbundle) without a serving Metro (it will RedBox).”
• consentIdstring
• approveboolean

• sessionIdstring
• projectRootstring
• suitestring“Suite file relative to .swipium/ (default suites/smoke.yaml).”
• forceboolean“Overwrite .swipium/flows/<slug>.yaml even when it was edited by hand since the last compile (default: keep it, write <slug>.yaml.new).”

• sessionIdstringrequired
• goalstring“Focus, e.g.”
• depthinteger“Default 3.”
• maxActionsinteger“Default 20.”
• maxScreensinteger“Default 12.”
• maxDurationMsinteger“Default 360000.”
• strategystring“crawl (default) | task_planner (infer QA tasks first) | hybrid.”
• safeModestring“strict (default) | balanced | dry_run_destructive (list candidates, no taps) | approved_destructive_candidate (one candidate, consent-gated).”
• destructiveCandidateobject“approved_destructive_candidate: the candidate from a dry_run_destructive run.”
• confirmHighImpactboolean“Required for payment/send/permission/delete candidates.”
• generateSuiteboolean“Also write + compile a POM suite from promoted paths.”
• includeTextEntryboolean“Type into fields that have a value source (default false).”
• stopOnAuthboolean“needs_input at an auth wall without credentials (default true).”
• accountCycleboolean“Allow logout on a disposable generated account (needs allowGeneratedData).”
• allowGeneratedDataboolean“Allow generated test data (test/staging).”
• consentIdstring
• approveboolean

• sessionIdstringrequired
• modestring
• untilstring“continue: one_step (default) | until_gate (paywall/OTP/permission) | until_home.”
• allowGeneratedAccountboolean“Override the policy on creating a throwaway account.”
• testDataPolicyPathstring“Test-data policy JSON (default .swipium/test-data-policy.json).”
• maxStepsnumber“continue: step cap.”
• maxDurationMsnumber“continue: time cap in ms.”

• sessionIdstringrequired
• kindstringrequired“The needs_input kind (e.g.”
• valuesobject“Field name > value.”
• secretFieldsarray“Secret keys (default: password/otp/token-like names).”

• projectRootstring“Default: the session or resolved project root.”
• sessionIdstring“Adds its latest exploration graph.”
• modestring“static_only | runtime_merge | full (default).”
• includeCodeIndexboolean“Persist a code symbol index (default true).”
• forceRescanboolean“Re-scan even if the map is current.”

• projectRootstring
• sessionIdstring
• notestring“A free-text user note added with user_note provenance.”
• testCasesarray
• automationSuiteobject
• environmentstring“App environment, e.g.”
• featureCoverageobject

• projectRootstring
• sessionIdstring
• modestring
• statestring“history filter.”
• categorystring“history filter; log: category hint.”
• severitystring“history filter; log: severity hint.”
• platformstring“history filter; log: platform observed on.”
• sincestring“history/metrics: ISO start.”
• includeSuppressedboolean“history/metrics: include suppressed issues.”
• issueIdstring“Transition key (from history).”
• fingerprintstring“Alternative transition key.”
• titlestring“log (required): what was observed.”
• summarystring“log: one-line summary.”
• failureCodestring“log: typed code, e.g.”
• evidenceUrisarray“log/verify_fixed: swipium:// evidence URIs.”
• fixedInCommitstring“mark_fixed”
• fixedInVersionstring“mark_fixed”
• howFixedstring“mark_fixed (quoted on recurrence)”
• fixedBystring“mark_fixed”
• reportUristring“verify_fixed evidence”
• testCaseIdstring“verify_fixed evidence”
• auditCheckIdstring“verify_fixed evidence”
• suppressionReasonstring“suppress”
• suppressedUntilstring“suppress: ISO expiry.”
• unsuppressboolean“suppress: lift an existing suppression now.”

and 3 more not listed here.

• sessionIdstring
• projectRootstring
• sourcestringrequired
• sourceUristring
• casesarray“Canonical or partial cases (normalized).”
• mergeModestring

• sessionIdstring
• projectRootstring
• featurestring“Functionality label (default: the recorded flow name).”
• creativitystring“How far beyond the happy path (default standard).”
• creativityLevelstring“Deprecated alias of creativity.”
• includeManualOnlyboolean

• sessionIdstring
• projectRootstring
• formatstringrequired
• saveboolean

• sessionIdstringrequired
• flowstring“Flow name/path under .swipium/flows.”
• flowYamlstring“Inline flow YAML.”
• failedStepintegerrequired“Zero-based failed step index from qa_flow_run.failedAtStep.”
• applyboolean“Patch the flow file when safe (default false).”

• sessionIdstring“Prepared session (else bootstrap from projectRoot).”
• projectRootstring
• featurestringrequired“The feature to test, in natural language.”
• modestring“execute (default, job) | plan (read-only) | interactive (until the first question).”
• platformstring
• devicestring“Device/simulator to bootstrap on.”
• consentIdstring“Bootstrap consent (boot/install/launch).”
• approveboolean
• creativitystring
• allowAdversarialboolean
• maxScreensnumber“Default 8.”
• maxActionsnumber“Default 20.”
• timeoutMsnumber“Ignored (kept for compatibility): the run is bounded by maxScreens / maxActions; poll qa_job_status.”
• generateCasesboolean“Generate test cases (default true).”
• includeCodeboolean
• limitnumber

• modestring
• sessionIdstring“Required for run (stores the build log).”
• projectRootstring“plan: resolve the project without a session.”
• platformstringrequired
• variantstring
• timeoutMsnumber“run: per-step timeout (default 1200000).”
• consentIdstring“run”
• approveboolean“run”

• sessionIdstringrequired
• aabstring“Default: the best .aab in the project.”
• forceboolean“Rebuild even if cached.”
• connectedDeviceboolean“Device-specific APK set (--connected-device).”
• installboolean“With connectedDevice: install-apks on the device (consent-gated).”
• devicestring“adb serial (default: session device, else SWIPIUM_DEVICE, else the only one).”
• consentIdstring
• approveboolean