DOCUMENTATION
Know what runs. Know where it runs.
Use this map to understand the packaged macOS application before building a flow. It separates deterministic execution, integrated authoring, evidence and optional model use.
- Packaged desktop app
- macOS · Apple silicon
- No public runner API
RUNTIME MAP
Author. Replay. Review.
-
01
Authorized origin
-
02
Deterministic timeline
-
03
Privacy-mode artifacts
-
04
Optional model boundary
OPERATING GUIDE
Controls are named exactly as they appear in the current desktop application for the selected interface language.
01 · QUICKSTART
Create one short flow. Make the result observable.
Choose a journey with a clear final state, use a controlled environment and confirm the first passing run before introducing deliberate drift.
-
1.1INSTALL
Prepare the desktop runtime
Confirm a supported Mac and keep the application under test reachable from that machine.
macOS · Apple silicon -
1.2FIRST FLOW
Record or author the journey
Fix the origin, provide encrypted credential references if needed and end with an assertion.
Observable outcome requiredOpen quickstart
02 · CORE CONCEPTS
Deterministic by default. Intelligence by selection.
The timeline owns execution. Ordinary actions replay predictably; agent authoring creates that timeline, while a selected AI step is an explicit runtime choice.
-
2.1EXECUTION
Local browser control
Sessions, steps and evidence remain owned by the desktop runtime.
Tested-app traffic still leaves the machineProduct overview -
2.2MODEL USE
A separate boundary
Configure no model, a provider key or the supported local authoring harness according to policy.
No silent fallbackBoundary reference
03 · EVIDENCE
Inspect the failure. Keep privacy mode visible.
A run can retain several evidence layers, each with different sensitivity. Apply the policy before the workflow reaches real customer data.
-
3.1ARTIFACTS
Screenshot, DOM, network, console
Use the smallest evidence set that answers why the result changed.
Manifest linked to run IDEvidence reference -
3.2TRACE
Explicit sensitive debug mode
Full trace capture stays off in privacy mode until deliberately enabled for an approved run.
Opt-in onlyPrivacy guide